Structuring Domain Error Subclasses for Granular Boundary Handling

export class ApplicationError extends Error {
  public readonly timestamp: number = Date.now();
  constructor(message: string, public readonly code: string) {
    super(message);
    this.name = this.constructor.name;
    Object.setPrototypeOf(this, new.target.prototype);
  }
}
 
export class PaymentGatewayTimeoutError extends ApplicationError {
  constructor(public readonly transactionId: string, public readonly retryAfterMs: number) {
    super(`Payment gateway timed out for transaction ${transactionId}`, 'ERR_PAYMENT_TIMEOUT');
  }
}
 
export function resolveErrorRecovery(err: unknown): { fallbackUi: string; canRetry: boolean } {
  if (err instanceof PaymentGatewayTimeoutError) {
    return { fallbackUi: 'GatewayBusyPrompt', canRetry: err.retryAfterMs < 5000 };
  }
  if (err instanceof ApplicationError) {
    return { fallbackUi: 'GenericDomainErrorBanner', canRetry: false };
  }
  return { fallbackUi: 'CriticalCrashScreen', canRetry: false };
}