/** * Structured ACME protocol error with RFC 8555 fields. * Provides type URN, subproblems, Retry-After, and retryability classification. */ export class AcmeError extends Error { public readonly status: number; public readonly type: string; public readonly detail: string; public readonly subproblems: Array<{ type: string; detail: string; identifier?: { type: string; value: string } }>; public readonly url: string; public readonly retryAfter: number; constructor(options: { message?: string; status: number; type?: string; detail?: string; subproblems?: Array<{ type: string; detail: string; identifier?: { type: string; value: string } }>; url?: string; retryAfter?: number; }) { const type = options.type || ''; const detail = options.detail || ''; const url = options.url || ''; const msg = options.message || `ACME error: ${type || 'unknown'} (HTTP ${options.status}) at ${url || 'unknown'} - ${detail || 'no detail'}`; super(msg); this.name = 'AcmeError'; this.status = options.status; this.type = type; this.detail = detail; this.subproblems = options.subproblems || []; this.url = url; this.retryAfter = options.retryAfter || 0; } /** * True for HTTP 429 or ACME rateLimited type URN */ get isRateLimited(): boolean { return this.status === 429 || this.type === 'urn:ietf:params:acme:error:rateLimited'; } /** * True for transient/retryable errors: 429, 503, 5xx, badNonce. * False for definitive client errors: 400 (non-badNonce), 403, 404, 409. */ get isRetryable(): boolean { if (this.type === 'urn:ietf:params:acme:error:badNonce') return true; if (this.status === 429 || this.status === 503) return true; if (this.status >= 500) return true; return false; } }