gracefulerrors 0.1.0

package/dist/index.js

@@ -0,0 +1,481 @@
+// src/normalizer.ts
+function mapNativeError(raw) {
+  if (raw instanceof TypeError) {
+    return { code: "NETWORK_ERROR", message: raw.message, raw };
+  }
+  if (raw instanceof DOMException && raw.name === "NetworkError") {
+    return { code: "NETWORK_ERROR", message: raw.message, raw };
+  }
+  const code = "GRACEFULERRORS_UNKNOWN";
+  return { code, message: raw.message, raw };
+}
+function isAxiosError(raw) {
+  if (raw == null || typeof raw !== "object") return false;
+  const r = raw;
+  return r["isAxiosError"] === true || r["response"] !== void 0 && r["config"] !== void 0;
+}
+function isStructuredError(raw) {
+  if (raw == null || typeof raw !== "object") return false;
+  const r = raw;
+  return typeof r["code"] === "string";
+}
+function builtInNormalizer(raw, _current) {
+  if (raw instanceof Error && raw.name === "AbortError") {
+    return null;
+  }
+  if (raw instanceof Response && !raw.ok) {
+    const status = raw.status;
+    const code = `HTTP_${status}`;
+    return { code, status, message: raw.statusText, raw };
+  }
+  if (isAxiosError(raw)) {
+    const response = raw.response;
+    const status = response?.status;
+    const data = response?.data;
+    let code = status != null ? `HTTP_${status}` : "GRACEFULERRORS_UNKNOWN";
+    let message;
+    if (data != null && typeof data === "object") {
+      const d = data;
+      if (typeof d["code"] === "string") code = d["code"];
+      if (typeof d["message"] === "string") message = d["message"];
+    }
+    return { code, status, message, raw };
+  }
+  if (isStructuredError(raw)) {
+    const { code, status, message, context } = raw;
+    return { code, status, message, context, raw };
+  }
+  if (raw instanceof Error) {
+    return mapNativeError(raw);
+  }
+  return null;
+}
+function mergeAppError(current, partial) {
+  if (current === null) {
+    return partial;
+  }
+  const merged = { ...current };
+  if (partial.code !== void 0) merged.code = partial.code;
+  if (partial.status !== void 0) merged.status = partial.status;
+  if (partial.message !== void 0) merged.message = partial.message;
+  if (partial.context !== void 0) {
+    merged.context = { ...current.context, ...partial.context };
+  }
+  return merged;
+}
+function runNormalizerPipeline(raw, customNormalizers, builtIn, onError) {
+  let current = null;
+  for (const normalizer of customNormalizers) {
+    try {
+      const result = normalizer(raw, current);
+      if (result !== null) {
+        current = mergeAppError(current, result);
+      }
+    } catch (err) {
+      onError?.(err);
+    }
+  }
+  try {
+    const result = builtIn(raw, current);
+    if (result !== null) {
+      current = mergeAppError(current, result);
+    }
+  } catch (err) {
+    onError?.(err);
+  }
+  if (current === null) {
+    return { code: "GRACEFULERRORS_UNHANDLED", raw };
+  }
+  if (!current.code) {
+    return { ...current, code: "GRACEFULERRORS_UNKNOWN" };
+  }
+  return current;
+}
+
+// src/state-manager.ts
+function createStateManager(config) {
+  const maxConcurrent = config.maxConcurrent ?? 3;
+  const maxQueue = config.maxQueue;
+  const dedupeWindow = config.dedupeWindow ?? 300;
+  const { onDropped } = config;
+  const activeSlots = /* @__PURE__ */ new Map();
+  const queue = [];
+  const dedupeMap = /* @__PURE__ */ new Map();
+  const ttlTimers = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  function notify(event) {
+    for (const listener of listeners) {
+      try {
+        listener(event);
+      } catch (err) {
+        if (process.env["NODE_ENV"] !== "production") {
+          console.error("[gracefulerrors] StateManager listener threw:", err);
+        }
+      }
+    }
+  }
+  function promoteFromQueue() {
+    if (queue.length > 0 && activeSlots.size < maxConcurrent) {
+      const next = queue.shift();
+      activateSlot(next, next._pendingAction);
+    }
+  }
+  function activateSlot(slot, action) {
+    slot.state = "ACTIVE";
+    activeSlots.set(slot.fingerprint, slot);
+    const ttl = slot.ttl;
+    if (ttl != null && ttl > 0) {
+      const timer = setTimeout(() => {
+        if (activeSlots.has(slot.fingerprint)) {
+          activeSlots.delete(slot.fingerprint);
+          ttlTimers.delete(slot.fingerprint);
+          onDropped?.(slot.error, "ttl_expired");
+          promoteFromQueue();
+        }
+      }, ttl);
+      ttlTimers.set(slot.fingerprint, timer);
+    }
+    notify({ type: "ERROR_ADDED", error: slot.error, action });
+  }
+  function canHandle(fingerprint) {
+    const lastSeen = dedupeMap.get(fingerprint);
+    if (lastSeen === void 0) return true;
+    return Date.now() - lastSeen >= dedupeWindow;
+  }
+  function enqueue(slot) {
+    if (!canHandle(slot.fingerprint)) {
+      onDropped?.(slot.error, "dedupe");
+      return "rejected";
+    }
+    dedupeMap.set(slot.fingerprint, Date.now());
+    if (activeSlots.size < maxConcurrent) {
+      activateSlot(slot, slot._pendingAction);
+      return "active";
+    }
+    if (maxQueue !== void 0 && queue.length >= maxQueue) {
+      onDropped?.(slot.error, "queue_overflow");
+      return "rejected";
+    }
+    slot.state = "QUEUED";
+    queue.push(slot);
+    return "queued";
+  }
+  function release(code) {
+    let targetFingerprint;
+    for (const [fingerprint, slot] of activeSlots) {
+      if (slot.error.code === code) {
+        targetFingerprint = fingerprint;
+        break;
+      }
+    }
+    if (targetFingerprint !== void 0) {
+      const slot = activeSlots.get(targetFingerprint);
+      slot.state = "EXPIRED";
+      activeSlots.delete(targetFingerprint);
+      const timer = ttlTimers.get(targetFingerprint);
+      if (timer !== void 0) {
+        clearTimeout(timer);
+        ttlTimers.delete(targetFingerprint);
+      }
+      notify({ type: "ERROR_CLEARED", code });
+      promoteFromQueue();
+      return;
+    }
+    const queueIdx = queue.findIndex((slot) => slot.error.code === code);
+    if (queueIdx !== -1) {
+      const slot = queue[queueIdx];
+      slot.state = "EXPIRED";
+      queue.splice(queueIdx, 1);
+      notify({ type: "ERROR_CLEARED", code });
+    }
+  }
+  function getActiveSlots() {
+    return Array.from(activeSlots.values());
+  }
+  function getQueueLength() {
+    return queue.length;
+  }
+  function clearAll() {
+    for (const timer of ttlTimers.values()) {
+      clearTimeout(timer);
+    }
+    ttlTimers.clear();
+    activeSlots.clear();
+    queue.length = 0;
+    notify({ type: "ALL_CLEARED" });
+  }
+  function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  }
+  return { canHandle, enqueue, release, getActiveSlots, getQueueLength, clearAll, subscribe };
+}
+
+// src/registry.ts
+function lookupEntry(registry, code) {
+  return registry[code];
+}
+function mergeRegistries(base, override) {
+  return { ...base, ...override };
+}
+
+// src/router.ts
+function createUIRouter() {
+  function route(error, registry, config) {
+    const entry = lookupEntry(registry, error.code);
+    if (entry == null && config.requireRegistry) {
+      throw new Error(`[gracefulerrors] Registry entry required for code: ${error.code}`);
+    }
+    const routingContext = config.routingContext ?? {
+      activeCount: 0,
+      queueLength: 0
+    };
+    let strategyResult;
+    if (config.routingStrategy) {
+      try {
+        strategyResult = config.routingStrategy(error, entry, routingContext);
+      } catch (err) {
+        if (process.env["NODE_ENV"] !== "production") {
+          console.error("[gracefulerrors] routingStrategy threw:", err);
+        }
+        strategyResult = null;
+      }
+    }
+    if (strategyResult != null) {
+      return strategyResult;
+    }
+    if (entry != null) {
+      return entry.ui;
+    }
+    const allowFallback = config.allowFallback !== false;
+    if (allowFallback && config.fallback) {
+      return config.fallback.ui;
+    }
+    return "toast";
+  }
+  return { route };
+}
+
+// src/engine.ts
+function isSuppressionDecision(result) {
+  return result !== null && typeof result === "object" && "suppress" in result && result.suppress === true;
+}
+function safeCall(fn, ...args) {
+  if (!fn) return;
+  try {
+    fn(...args);
+  } catch (err) {
+    if (process.env["NODE_ENV"] !== "production") {
+      console.error("[gracefulerrors] Hook threw:", err);
+    }
+  }
+}
+function safeTransform(fn, error) {
+  if (!fn) return null;
+  try {
+    return fn(error, { raw: error.raw });
+  } catch (err) {
+    if (process.env["NODE_ENV"] !== "production") {
+      console.error("[gracefulerrors] transform threw:", err);
+    }
+    return null;
+  }
+}
+function defaultFingerprint(error) {
+  return `${error.code}:${error.status ?? ""}:${error.context?.field ?? ""}`;
+}
+function buildFallbackEntry(action, config) {
+  return { ui: action, message: config.fallback?.message ?? "An error occurred" };
+}
+function debugTrace(debug, trace) {
+  const shouldTrace = debug === true || typeof debug === "object" && debug !== null && debug.trace === true;
+  if (shouldTrace && process.env["NODE_ENV"] !== "production") {
+    console.log("[gracefulerrors trace]", trace);
+  }
+}
+function noOpNormalizer(_raw, current) {
+  return current;
+}
+function createErrorEngine(config) {
+  let customNormalizers;
+  let resolvedBuiltIn;
+  if (config.normalizer && config.normalizers) {
+    if (process.env["NODE_ENV"] === "development") {
+      console.warn(
+        "[gracefulerrors] Both normalizer and normalizers provided. normalizer takes precedence and normalizers is ignored."
+      );
+    }
+    customNormalizers = [config.normalizer];
+    resolvedBuiltIn = noOpNormalizer;
+  } else if (config.normalizer) {
+    customNormalizers = [config.normalizer];
+    resolvedBuiltIn = noOpNormalizer;
+  } else if (config.normalizers) {
+    customNormalizers = config.normalizers;
+    resolvedBuiltIn = builtInNormalizer;
+  } else {
+    customNormalizers = [];
+    resolvedBuiltIn = builtInNormalizer;
+  }
+  const stateManager = createStateManager({
+    maxConcurrent: config.maxConcurrent,
+    maxQueue: config.maxQueue,
+    dedupeWindow: config.dedupeWindow,
+    onDropped: config.onDropped
+  });
+  const router = createUIRouter();
+  const aggregationMap = /* @__PURE__ */ new Map();
+  function handle(raw) {
+    safeCall(config.onError, raw);
+    const normalized = runNormalizerPipeline(
+      raw,
+      customNormalizers,
+      resolvedBuiltIn,
+      config.onError
+    );
+    safeCall(config.onNormalized, normalized);
+    if (config.onErrorAsync) {
+      Promise.resolve(config.onErrorAsync(normalized)).catch((err) => {
+        if (process.env["NODE_ENV"] === "development") {
+          console.error("[gracefulerrors] onErrorAsync rejected:", err);
+        }
+      });
+    }
+    const transformResult = safeTransform(config.transform, normalized);
+    let current = normalized;
+    if (transformResult !== null) {
+      if (isSuppressionDecision(transformResult)) {
+        safeCall(config.onSuppressed, normalized, transformResult.reason);
+        return { handled: false, error: normalized, uiAction: null };
+      }
+      current = transformResult;
+    }
+    const fingerprint = config.fingerprint ? config.fingerprint(current) : defaultFingerprint(current);
+    const entry = lookupEntry(config.registry, current.code);
+    if (!entry && config.requireRegistry) {
+      safeCall(config.onFallback, current);
+      throw new Error(`[gracefulerrors] Registry entry required for code: ${current.code}`);
+    }
+    const routingContext = {
+      activeCount: stateManager.getActiveSlots().length,
+      queueLength: stateManager.getQueueLength()
+    };
+    const action = router.route(
+      current,
+      config.registry,
+      {
+        fallback: config.fallback,
+        requireRegistry: config.requireRegistry,
+        allowFallback: config.allowFallback,
+        routingStrategy: config.routingStrategy,
+        routingContext
+      }
+    );
+    if (!entry && !config.requireRegistry) {
+      safeCall(config.onFallback, current);
+    }
+    safeCall(config.onRouted, current, action);
+    const aggConfig = config.aggregation;
+    if (aggConfig) {
+      const aggEnabled = aggConfig === true || typeof aggConfig === "object" && aggConfig.enabled;
+      if (aggEnabled) {
+        const aggWindow = typeof aggConfig === "object" && aggConfig.window != null ? aggConfig.window : 300;
+        const aggKey = action;
+        const lastAgg = aggregationMap.get(aggKey);
+        const now = Date.now();
+        if (lastAgg !== void 0 && now - lastAgg < aggWindow) {
+          return { handled: false, error: current, uiAction: null };
+        }
+        aggregationMap.set(aggKey, now);
+      }
+    }
+    const slot = {
+      error: current,
+      state: "ACTIVE",
+      fingerprint,
+      ttl: entry?.ttl,
+      _pendingAction: action
+    };
+    const placement = stateManager.enqueue(slot);
+    if (placement === "rejected") {
+      return { handled: false, error: current, uiAction: null };
+    }
+    if (config.renderer && action !== "silent" && action !== "inline") {
+      const intent = {
+        ui: action,
+        error: current,
+        entry: entry ?? buildFallbackEntry(action, config)
+      };
+      let onDismiss;
+      if (action === "modal") {
+        let dismissTimeoutId;
+        if (config.modalDismissTimeoutMs != null && process.env["NODE_ENV"] !== "production") {
+          dismissTimeoutId = setTimeout(() => {
+            console.warn(
+              `[gracefulerrors] Modal for "${String(current.code)}" was not dismissed within ${config.modalDismissTimeoutMs}ms. Ensure your adapter calls onDismiss().`
+            );
+          }, config.modalDismissTimeoutMs);
+        }
+        onDismiss = () => {
+          if (dismissTimeoutId !== void 0) clearTimeout(dismissTimeoutId);
+          stateManager.release(current.code);
+        };
+      }
+      config.renderer.render(intent, { onDismiss });
+    }
+    debugTrace(config.debug, { raw, normalized: current, action, entry, placement });
+    return {
+      handled: true,
+      error: current,
+      uiAction: action === "silent" ? null : action
+    };
+  }
+  function clear(code) {
+    stateManager.release(code);
+    config.renderer?.clear(code);
+  }
+  function clearAll() {
+    stateManager.clearAll();
+    config.renderer?.clearAll();
+  }
+  function subscribe(listener) {
+    return stateManager.subscribe(listener);
+  }
+  return { handle, clear, clearAll, subscribe };
+}
+function createFetch(engine, options = {}) {
+  const mode = options.mode ?? "throw";
+  return async function(input, init) {
+    try {
+      const response = await fetch(input, init);
+      if (!response.ok) {
+        if (mode === "silent") return response;
+        let errorPayload = response;
+        try {
+          const body = await response.clone().json();
+          if (body != null && typeof body === "object") {
+            errorPayload = { status: response.status, ...body };
+          }
+        } catch {
+        }
+        engine.handle(errorPayload);
+        if (mode === "handle") return void 0;
+        throw response;
+      }
+      return response;
+    } catch (error) {
+      if (error != null && error.name === "AbortError") throw error;
+      if (error instanceof Response) throw error;
+      if (mode === "silent") throw error;
+      engine.handle(error);
+      if (mode === "handle") return void 0;
+      throw error;
+    }
+  };
+}
+
+export { builtInNormalizer, createErrorEngine, createFetch, mergeRegistries };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/normalizer.ts","../src/state-manager.ts","../src/registry.ts","../src/router.ts","../src/engine.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { AppError, Normalizer, SystemErrorCode } from './types'\n\n// Native JS error → stable code mapping\nfunction mapNativeError(raw: Error): AppError {\n  if (raw instanceof TypeError) {\n    return { code: 'NETWORK_ERROR', message: raw.message, raw }\n  }\n  if (raw instanceof DOMException && raw.name === 'NetworkError') {\n    return { code: 'NETWORK_ERROR', message: raw.message, raw }\n  }\n  const code: SystemErrorCode = 'GRACEFULERRORS_UNKNOWN'\n  return { code, message: raw.message, raw }\n}\n\n// Detect Axios-like error\nfunction isAxiosError(raw: unknown): raw is {\n  isAxiosError?: boolean\n  response?: { status?: number; data?: unknown }\n  config?: unknown\n  message?: string\n} {\n  if (raw == null || typeof raw !== 'object') return false\n  const r = raw as Record<string, unknown>\n  return r['isAxiosError'] === true || (r['response'] !== undefined && r['config'] !== undefined)\n}\n\n// Detect structured custom error\nfunction isStructuredError(raw: unknown): raw is { code: string; status?: number; message?: string; context?: Record<string, unknown> } {\n  if (raw == null || typeof raw !== 'object') return false\n  const r = raw as Record<string, unknown>\n  return typeof r['code'] === 'string'\n}\n\nexport function builtInNormalizer(raw: unknown, _current: AppError | null): AppError | null {\n  // AbortError — pass-through, never an AppError\n  if (raw instanceof Error && raw.name === 'AbortError') {\n    return null\n  }\n\n  // HTTP Response (4xx/5xx)\n  if (raw instanceof Response && !raw.ok) {\n    const status = raw.status\n    // Body may have been consumed — use sync fallback\n    const code = `HTTP_${status}`\n    return { code, status, message: raw.statusText, raw }\n  }\n\n  // Axios error\n  if (isAxiosError(raw)) {\n    const response = raw.response\n    const status = response?.status\n    const data = response?.data\n    let code: string = status != null ? `HTTP_${status}` : 'GRACEFULERRORS_UNKNOWN'\n    let message: string | undefined\n\n    if (data != null && typeof data === 'object') {\n      const d = data as Record<string, unknown>\n      if (typeof d['code'] === 'string') code = d['code']\n      if (typeof d['message'] === 'string') message = d['message']\n    }\n\n    return { code, status, message, raw }\n  }\n\n  // Structured custom error — plain object with { code: string }\n  if (isStructuredError(raw)) {\n    const { code, status, message, context } = raw\n    return { code, status, message, context, raw }\n  }\n\n  // Native JS errors\n  if (raw instanceof Error) {\n    return mapNativeError(raw)\n  }\n\n  // Unknown\n  return null\n}\n\nexport function mergeAppError<TCode extends string, TField extends string = string>(\n  current: AppError<TCode, TField> | null,\n  partial: AppError<TCode, TField>\n): AppError<TCode, TField> {\n  if (current === null) {\n    return partial\n  }\n\n  const merged: AppError<TCode, TField> = { ...current }\n\n  // Later defined scalar fields win; undefined never overwrites an existing value\n  if (partial.code !== undefined) merged.code = partial.code\n  if (partial.status !== undefined) merged.status = partial.status\n  if (partial.message !== undefined) merged.message = partial.message\n\n  // context is shallow-merged with later keys winning\n  if (partial.context !== undefined) {\n    merged.context = { ...current.context, ...partial.context }\n  }\n\n  // raw remains the original input (never overwritten)\n  // (already set from current)\n\n  return merged\n}\n\nexport function runNormalizerPipeline<TCode extends string, TField extends string>(\n  raw: unknown,\n  customNormalizers: Normalizer<TCode, TField>[],\n  builtIn: Normalizer<TCode, TField>,\n  onError?: (raw: unknown) => void\n): AppError<TCode, TField> {\n  let current: AppError<TCode, TField> | null = null\n\n  // Run each custom normalizer\n  for (const normalizer of customNormalizers) {\n    try {\n      const result = normalizer(raw, current)\n      if (result !== null) {\n        current = mergeAppError(current, result)\n      }\n    } catch (err) {\n      onError?.(err)\n    }\n  }\n\n  // Run built-in normalizer\n  try {\n    const result = builtIn(raw, current)\n    if (result !== null) {\n      current = mergeAppError(current, result as AppError<TCode, TField>)\n    }\n  } catch (err) {\n    onError?.(err)\n  }\n\n  // If final current is null → synthesize GRACEFULERRORS_UNHANDLED\n  if (current === null) {\n    return { code: 'GRACEFULERRORS_UNHANDLED' as TCode, raw } as AppError<TCode, TField>\n  }\n\n  // If final current has no code → assign GRACEFULERRORS_UNKNOWN\n  if (!current.code) {\n    return { ...current, code: 'GRACEFULERRORS_UNKNOWN' as TCode }\n  }\n\n  return current\n}\n","import type { AppError, ErrorSlot, ErrorStateManager, StateListener, UIAction } from './types'\n\nexport interface StateManagerConfig<TCode extends string> {\n  maxConcurrent?: number   // default: 3\n  maxQueue?: number        // default: unbounded\n  dedupeWindow?: number    // ms, default: 300\n  onDropped?: (error: AppError<TCode>, reason: 'dedupe' | 'ttl_expired' | 'queue_overflow') => void\n}\n\nexport function createStateManager<TCode extends string>(\n  config: StateManagerConfig<TCode>\n): ErrorStateManager<TCode> {\n  const maxConcurrent = config.maxConcurrent ?? 3\n  const maxQueue = config.maxQueue\n  const dedupeWindow = config.dedupeWindow ?? 300\n  const { onDropped } = config\n\n  type InternalSlot = ErrorSlot<TCode> & { ttl?: number; _pendingAction?: UIAction }\n\n  const activeSlots = new Map<string, InternalSlot>()\n  const queue: InternalSlot[] = []\n  const dedupeMap = new Map<string, number>()\n  const ttlTimers = new Map<string, ReturnType<typeof setTimeout>>()\n  const listeners = new Set<StateListener<TCode>>()\n\n  function notify(event: Parameters<StateListener<TCode>>[0]): void {\n    for (const listener of listeners) {\n      try {\n        listener(event)\n      } catch (err) {\n        if (process.env['NODE_ENV'] !== 'production') {\n          console.error('[gracefulerrors] StateManager listener threw:', err)\n        }\n      }\n    }\n  }\n\n  function promoteFromQueue(): void {\n    if (queue.length > 0 && activeSlots.size < maxConcurrent) {\n      const next = queue.shift()!\n      activateSlot(next, next._pendingAction as UIAction)\n    }\n  }\n\n  function activateSlot(slot: InternalSlot, action: UIAction): void {\n    slot.state = 'ACTIVE'\n    activeSlots.set(slot.fingerprint, slot)\n\n    // Start TTL timer if configured\n    const ttl = slot.ttl\n    if (ttl != null && ttl > 0) {\n      const timer = setTimeout(() => {\n        if (activeSlots.has(slot.fingerprint)) {\n          activeSlots.delete(slot.fingerprint)\n          ttlTimers.delete(slot.fingerprint)\n          onDropped?.(slot.error, 'ttl_expired')\n          promoteFromQueue()\n        }\n      }, ttl)\n      ttlTimers.set(slot.fingerprint, timer)\n    }\n\n    notify({ type: 'ERROR_ADDED', error: slot.error, action })\n  }\n\n  function canHandle(fingerprint: string): boolean {\n    const lastSeen = dedupeMap.get(fingerprint)\n    if (lastSeen === undefined) return true\n    return Date.now() - lastSeen >= dedupeWindow\n  }\n\n  function enqueue(slot: InternalSlot): 'active' | 'queued' | 'rejected' {\n    if (!canHandle(slot.fingerprint)) {\n      onDropped?.(slot.error, 'dedupe')\n      return 'rejected'\n    }\n\n    dedupeMap.set(slot.fingerprint, Date.now())\n\n    if (activeSlots.size < maxConcurrent) {\n      activateSlot(slot, slot._pendingAction as UIAction)\n      return 'active'\n    }\n\n    if (maxQueue !== undefined && queue.length >= maxQueue) {\n      onDropped?.(slot.error, 'queue_overflow')\n      return 'rejected'\n    }\n\n    slot.state = 'QUEUED'\n    queue.push(slot)\n    return 'queued'\n  }\n\n  function release(code: TCode): void {\n    // Check active slots first\n    let targetFingerprint: string | undefined\n\n    for (const [fingerprint, slot] of activeSlots) {\n      if (slot.error.code === code) {\n        targetFingerprint = fingerprint\n        break\n      }\n    }\n\n    if (targetFingerprint !== undefined) {\n      const slot = activeSlots.get(targetFingerprint)!\n      slot.state = 'EXPIRED'\n      activeSlots.delete(targetFingerprint)\n\n      const timer = ttlTimers.get(targetFingerprint)\n      if (timer !== undefined) {\n        clearTimeout(timer)\n        ttlTimers.delete(targetFingerprint)\n      }\n\n      notify({ type: 'ERROR_CLEARED', code })\n      promoteFromQueue()\n      return\n    }\n\n    // Check queue — spec: QUEUED | clear() → EXPIRED | remove from queue\n    const queueIdx = queue.findIndex((slot) => slot.error.code === code)\n    if (queueIdx !== -1) {\n      const slot = queue[queueIdx]!\n      slot.state = 'EXPIRED'\n      queue.splice(queueIdx, 1)\n      notify({ type: 'ERROR_CLEARED', code })\n    }\n  }\n\n  function getActiveSlots(): ErrorSlot<TCode>[] {\n    return Array.from(activeSlots.values())\n  }\n\n  function getQueueLength(): number {\n    return queue.length\n  }\n\n  function clearAll(): void {\n    for (const timer of ttlTimers.values()) {\n      clearTimeout(timer)\n    }\n    ttlTimers.clear()\n    activeSlots.clear()\n    queue.length = 0\n    notify({ type: 'ALL_CLEARED' })\n  }\n\n  function subscribe(listener: StateListener<TCode>): () => void {\n    listeners.add(listener)\n    return () => { listeners.delete(listener) }\n  }\n\n  return { canHandle, enqueue, release, getActiveSlots, getQueueLength, clearAll, subscribe }\n}\n\nexport type { ErrorStateManager, StateListener }\n","import type { AppError, ErrorRegistry, ErrorRegistryEntry, ErrorRegistryEntryFull } from './types'\n\nexport function lookupEntry<TCode extends string>(\n  registry: ErrorRegistry<TCode>,\n  code: TCode | string\n): ErrorRegistryEntryFull<TCode> | undefined {\n  return (registry as Record<string, ErrorRegistryEntryFull<TCode> | undefined>)[code]\n}\n\nexport function resolveMessage<TCode extends string>(\n  entry: ErrorRegistryEntry<TCode>,\n  error: AppError<TCode>\n): string | undefined {\n  if (entry.message === undefined) return undefined\n  if (typeof entry.message === 'function') return entry.message(error)\n  return entry.message\n}\n\nexport function mergeRegistries<TBase extends string, TExtended extends string>(\n  base: ErrorRegistry<TBase>,\n  override: ErrorRegistry<TExtended>\n): ErrorRegistry<TBase | TExtended> {\n  return { ...base, ...override } as ErrorRegistry<TBase | TExtended>\n}\n\nexport type { ErrorRegistry, ErrorRegistryEntry, ErrorRegistryEntryFull }\n","import type { AppError, ErrorEngineConfig, ErrorRegistry, UIAction, UIRouter } from './types'\nimport { lookupEntry } from './registry'\n\nexport function createUIRouter<TCode extends string, TField extends string = string>(): UIRouter<TCode, TField> {\n  function route(\n    error: AppError<TCode, TField>,\n    registry: ErrorRegistry<TCode>,\n    config: Pick<ErrorEngineConfig<TCode, TField>, 'fallback' | 'requireRegistry' | 'allowFallback' | 'routingStrategy'> & {\n      routingContext?: { activeCount: number; queueLength: number }\n    }\n  ): UIAction | null {\n    const entry = lookupEntry(registry, error.code)\n\n    if (entry == null && config.requireRegistry) {\n      throw new Error(`[gracefulerrors] Registry entry required for code: ${error.code}`)\n    }\n\n    const routingContext = (config as { routingContext?: { activeCount: number; queueLength: number } }).routingContext ?? {\n      activeCount: 0,\n      queueLength: 0,\n    }\n\n    let strategyResult: UIAction | null | undefined\n    if (config.routingStrategy) {\n      try {\n        strategyResult = config.routingStrategy(error, entry, routingContext)\n      } catch (err) {\n        if (process.env['NODE_ENV'] !== 'production') {\n          console.error('[gracefulerrors] routingStrategy threw:', err)\n        }\n        strategyResult = null\n      }\n    }\n\n    // routingStrategy returns non-null → use it (overrides registry)\n    if (strategyResult != null) {\n      return strategyResult\n    }\n\n    // Registry entry exists → use its ui\n    if (entry != null) {\n      return entry.ui\n    }\n\n    // No match — apply fallback logic\n    // allowFallback defaults to true\n    const allowFallback = config.allowFallback !== false\n\n    if (allowFallback && config.fallback) {\n      return config.fallback.ui\n    }\n\n    return 'toast'\n  }\n\n  return { route }\n}\n\nexport type { UIRouter }\n","import { runNormalizerPipeline, builtInNormalizer } from './normalizer'\nimport { createStateManager } from './state-manager'\nimport type { StateManagerConfig } from './state-manager'\nimport { createUIRouter } from './router'\nimport { lookupEntry } from './registry'\nimport type {\n  AppError,\n  ErrorEngineConfig,\n  ErrorEngine,\n  HandleResult,\n  UIAction,\n  RenderIntent,\n  ErrorSlot,\n  ErrorRegistryEntryFull,\n  Normalizer,\n  SuppressionDecision,\n  TransformResult,\n  StateListener,\n} from './types'\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nfunction isSuppressionDecision(result: TransformResult): result is SuppressionDecision {\n  return (\n    result !== null &&\n    typeof result === 'object' &&\n    'suppress' in result &&\n    (result as SuppressionDecision).suppress === true\n  )\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction safeCall(fn: ((...args: any[]) => any) | undefined, ...args: any[]): void {\n  if (!fn) return\n  try {\n    fn(...args)\n  } catch (err) {\n    if (process.env['NODE_ENV'] !== 'production') {\n      console.error('[gracefulerrors] Hook threw:', err)\n    }\n  }\n}\n\nfunction safeTransform<TCode extends string, TField extends string>(\n  fn: ErrorEngineConfig<TCode, TField>['transform'],\n  error: AppError<TCode, TField>\n): TransformResult<TCode, TField> {\n  if (!fn) return null\n  try {\n    return fn(error, { raw: error.raw })\n  } catch (err) {\n    if (process.env['NODE_ENV'] !== 'production') {\n      console.error('[gracefulerrors] transform threw:', err)\n    }\n    return null\n  }\n}\n\nfunction defaultFingerprint(error: AppError): string {\n  return `${error.code}:${error.status ?? ''}:${error.context?.field ?? ''}`\n}\n\nfunction buildFallbackEntry<TCode extends string, TField extends string = string>(\n  action: UIAction,\n  config: ErrorEngineConfig<TCode, TField>\n): ErrorRegistryEntryFull<TCode> {\n  return { ui: action as never, message: config.fallback?.message ?? 'An error occurred' }\n}\n\nfunction debugTrace(\n  debug: ErrorEngineConfig['debug'],\n  trace: Record<string, unknown>\n): void {\n  const shouldTrace =\n    debug === true || (typeof debug === 'object' && debug !== null && debug.trace === true)\n  if (shouldTrace && process.env['NODE_ENV'] !== 'production') {\n    console.log('[gracefulerrors trace]', trace)\n  }\n}\n\nfunction noOpNormalizer<C extends string, F extends string>(_raw: unknown, current: AppError<C, F> | null): AppError<C, F> | null {\n  return current\n}\n\n// ---------------------------------------------------------------------------\n// createErrorEngine\n// ---------------------------------------------------------------------------\n\nexport function createErrorEngine<TCode extends string = string, TField extends string = string>(\n  config: ErrorEngineConfig<TCode, TField>\n): ErrorEngine<TCode> {\n  // ---- Init: resolve normalizer pipeline ----\n  let customNormalizers: Normalizer<TCode, TField>[]\n  let resolvedBuiltIn: Normalizer<TCode, TField>\n\n  if (config.normalizer && config.normalizers) {\n    if (process.env['NODE_ENV'] === 'development') {\n      console.warn(\n        '[gracefulerrors] Both normalizer and normalizers provided. normalizer takes precedence and normalizers is ignored.'\n      )\n    }\n    customNormalizers = [config.normalizer]\n    resolvedBuiltIn = noOpNormalizer\n  } else if (config.normalizer) {\n    customNormalizers = [config.normalizer]\n    resolvedBuiltIn = noOpNormalizer\n  } else if (config.normalizers) {\n    customNormalizers = config.normalizers\n    resolvedBuiltIn = builtInNormalizer as unknown as Normalizer<TCode, TField>\n  } else {\n    customNormalizers = []\n    resolvedBuiltIn = builtInNormalizer as unknown as Normalizer<TCode, TField>\n  }\n\n  // ---- Init: state manager ----\n  const stateManager = createStateManager<TCode>({\n    maxConcurrent: config.maxConcurrent,\n    maxQueue: config.maxQueue,\n    dedupeWindow: config.dedupeWindow,\n    onDropped: config.onDropped as StateManagerConfig<TCode>['onDropped'],\n  })\n\n  // ---- Init: router ----\n  const router = createUIRouter<TCode, TField>()\n\n  // ---- Init: aggregation ----\n  const aggregationMap = new Map<string, number>()\n\n  // ---------------------------------------------------------------------------\n  // handle\n  // ---------------------------------------------------------------------------\n\n  function handle(raw: unknown): HandleResult<TCode> {\n    // Step 1: onError — always first, even if normalization will fail\n    safeCall(config.onError, raw)\n\n    // Step 2: normalize\n    const normalized = runNormalizerPipeline(\n      raw,\n      customNormalizers,\n      resolvedBuiltIn,\n      config.onError\n    ) as AppError<TCode, TField>\n\n    // Step 3: onNormalized + fire-and-forget async side-effect\n    safeCall(config.onNormalized, normalized)\n\n    if (config.onErrorAsync) {\n      Promise.resolve(config.onErrorAsync(normalized)).catch((err) => {\n        if (process.env['NODE_ENV'] === 'development') {\n          console.error('[gracefulerrors] onErrorAsync rejected:', err)\n        }\n      })\n    }\n\n    // Step 4: transform\n    const transformResult = safeTransform(config.transform, normalized)\n\n    // Step 5: suppression or apply transform\n    let current: AppError<TCode, TField> = normalized\n\n    if (transformResult !== null) {\n      if (isSuppressionDecision(transformResult)) {\n        safeCall(config.onSuppressed, normalized, transformResult.reason)\n        return { handled: false, error: normalized, uiAction: null }\n      }\n      current = transformResult as AppError<TCode, TField>\n    }\n\n    // Step 6: fingerprint\n    const fingerprint = config.fingerprint\n      ? config.fingerprint(current as AppError<TCode, TField>)\n      : defaultFingerprint(current)\n\n    // Step 7: registry lookup + route\n    const entry = lookupEntry(config.registry, current.code)\n\n    if (!entry && config.requireRegistry) {\n      safeCall(config.onFallback, current)\n      throw new Error(`[gracefulerrors] Registry entry required for code: ${current.code}`)\n    }\n\n    const routingContext = {\n      activeCount: stateManager.getActiveSlots().length,\n      queueLength: stateManager.getQueueLength(),\n    }\n\n    const action = router.route(\n      current,\n      config.registry,\n      {\n        fallback: config.fallback,\n        requireRegistry: config.requireRegistry,\n        allowFallback: config.allowFallback,\n        routingStrategy: config.routingStrategy,\n        routingContext,\n      } as Parameters<typeof router.route>[2]\n    ) as UIAction\n\n    // Step 8: onFallback (no match, no requireRegistry) + onRouted\n    if (!entry && !config.requireRegistry) {\n      safeCall(config.onFallback, current)\n    }\n    safeCall(config.onRouted, current, action)\n\n    // Step 8.5: aggregation check\n    const aggConfig = config.aggregation\n    if (aggConfig) {\n      const aggEnabled =\n        aggConfig === true ||\n        (typeof aggConfig === 'object' && aggConfig.enabled)\n      if (aggEnabled) {\n        const aggWindow =\n          typeof aggConfig === 'object' && aggConfig.window != null\n            ? aggConfig.window\n            : 300\n        const aggKey = action\n        const lastAgg = aggregationMap.get(aggKey)\n        const now = Date.now()\n        if (lastAgg !== undefined && now - lastAgg < aggWindow) {\n          return { handled: false, error: current, uiAction: null }\n        }\n        aggregationMap.set(aggKey, now)\n      }\n    }\n\n    // Step 9: enqueue into state manager\n    const slot = {\n      error: current,\n      state: 'ACTIVE' as const,\n      fingerprint,\n      ttl: entry?.ttl,\n      _pendingAction: action,\n    } as ErrorSlot<TCode> & { ttl?: number; _pendingAction: UIAction }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const placement = stateManager.enqueue(slot as any)\n\n    if (placement === 'rejected') {\n      return { handled: false, error: current, uiAction: null }\n    }\n\n    // Step 10: renderer\n    if (config.renderer && action !== 'silent' && action !== 'inline') {\n      const intent: RenderIntent<TCode> = {\n        ui: action,\n        error: current,\n        entry: entry ?? buildFallbackEntry(action, config),\n      }\n\n      let onDismiss: (() => void) | undefined\n      if (action === 'modal') {\n        let dismissTimeoutId: ReturnType<typeof setTimeout> | undefined\n        if (config.modalDismissTimeoutMs != null && process.env['NODE_ENV'] !== 'production') {\n          dismissTimeoutId = setTimeout(() => {\n            console.warn(\n              `[gracefulerrors] Modal for \"${String(current.code)}\" was not dismissed within ${config.modalDismissTimeoutMs}ms. Ensure your adapter calls onDismiss().`\n            )\n          }, config.modalDismissTimeoutMs)\n        }\n        onDismiss = () => {\n          if (dismissTimeoutId !== undefined) clearTimeout(dismissTimeoutId)\n          stateManager.release(current.code as TCode)\n        }\n      }\n\n      config.renderer.render(intent, { onDismiss })\n    }\n\n    // Step 11: debug trace\n    debugTrace(config.debug, { raw, normalized: current, action, entry, placement })\n\n    // Step 12: return\n    return {\n      handled: true,\n      error: current,\n      uiAction: action === 'silent' ? null : action,\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // clear / clearAll\n  // ---------------------------------------------------------------------------\n\n  function clear(code: TCode): void {\n    stateManager.release(code)\n    config.renderer?.clear(code)\n  }\n\n  function clearAll(): void {\n    stateManager.clearAll()\n    config.renderer?.clearAll()\n  }\n\n  function subscribe(listener: StateListener<TCode>): () => void {\n    return stateManager.subscribe(listener)\n  }\n\n  return { handle, clear, clearAll, subscribe }\n}\n\n// ---------------------------------------------------------------------------\n// createFetch\n// ---------------------------------------------------------------------------\n\nexport function createFetch(\n  engine: ErrorEngine,\n  options: { mode?: 'throw' | 'handle' | 'silent' } = {}\n): (input: RequestInfo | URL, init?: RequestInit) => Promise<Response | undefined> {\n  const mode = options.mode ?? 'throw'\n\n  return async function (\n    input: RequestInfo | URL,\n    init?: RequestInit\n  ): Promise<Response | undefined> {\n    try {\n      const response = await fetch(input, init)\n\n      if (!response.ok) {\n        if (mode === 'silent') return response\n        let errorPayload: unknown = response\n        try {\n          const body = await response.clone().json()\n          if (body != null && typeof body === 'object') {\n            errorPayload = { status: response.status, ...(body as object) }\n          }\n        } catch {\n          // body is not JSON — fall back to raw Response\n        }\n        engine.handle(errorPayload)\n        if (mode === 'handle') return undefined\n        throw response\n      }\n\n      return response\n    } catch (error) {\n      // AbortError → pass-through, never forwarded to engine\n      // DOMException may not extend Error in all environments — check name directly\n      if (error != null && (error as Error).name === 'AbortError') throw error\n\n      // Re-thrown Response (4xx/5xx from the !response.ok branch above)\n      if (error instanceof Response) throw error\n\n      if (mode === 'silent') throw error\n\n      engine.handle(error)\n\n      if (mode === 'handle') return undefined\n      throw error\n    }\n  }\n}\n\nexport type { ErrorEngine, ErrorEngineConfig, HandleResult }\n"]}