gracefulerrors 0.1.0

package/README.md

@@ -0,0 +1,199 @@
+# gracefulerrors
+
+gracefulerrors is a TypeScript library for turning technical errors into consistent user-facing experiences. It provides a framework-agnostic core engine, a React SDK, and a Sonner adapter.
+
+## Features
+
+- Normalize raw errors into a shared internal format
+- Route errors to `toast`, `modal`, `inline`, or `silent`
+- Register typed error codes with per-code UI behavior
+- Dedupe, queue, and limit concurrent notifications
+- Integrate with React through a provider, hooks, and an error boundary
+- Render with Sonner or a custom adapter
+
+## Installation
+
+```bash
+npm install gracefulerrors
+```
+
+If you use the React SDK or the Sonner adapter, install the matching peer dependencies in your app:
+
+```bash
+npm install react react-dom sonner
+```
+
+## Quick Start
+
+```ts
+import { createErrorEngine } from 'gracefulerrors'
+
+type AppCode = 'AUTH_FAILED' | 'PAYMENT_FAILED'
+
+const engine = createErrorEngine<AppCode>({
+  registry: {
+    AUTH_FAILED: {
+      ui: 'toast',
+      uiOptions: {
+        severity: 'error',
+      },
+      message: 'Your session expired. Please sign in again.',
+    },
+    PAYMENT_FAILED: {
+      ui: 'modal',
+      message: 'Payment could not be processed.',
+    },
+  },
+  fallback: {
+    ui: 'toast',
+    message: 'Something went wrong.',
+  },
+})
+
+engine.handle({
+  code: 'AUTH_FAILED',
+  message: '401 Unauthorized',
+})
+```
+
+## Fetch Wrapper
+
+`createFetch` wraps the native `fetch` and forwards failures to the engine.
+
+```ts
+import { createErrorEngine, createFetch } from 'gracefulerrors'
+
+const engine = createErrorEngine({
+  registry: {
+    NETWORK_ERROR: { ui: 'toast', message: 'Network error' },
+  },
+})
+
+const apiFetch = createFetch(engine, { mode: 'handle' })
+
+const response = await apiFetch('/api/profile')
+```
+
+Supported modes:
+
+- `throw` returns the original failure after notifying the engine
+- `handle` swallows handled failures and returns `undefined`
+- `silent` leaves non-OK responses and thrown errors to the caller without notifying the engine
+
+## React Integration
+
+```tsx
+import { ErrorEngineProvider, useErrorEngine } from 'gracefulerrors/react'
+import { createErrorEngine } from 'gracefulerrors'
+
+const engine = createErrorEngine({
+  registry: {
+    NETWORK_ERROR: { ui: 'toast', message: 'Network error' },
+  },
+})
+
+function SaveButton() {
+  const errorEngine = useErrorEngine()
+
+  return (
+    <button
+      onClick={() => {
+        errorEngine?.handle({ code: 'NETWORK_ERROR', message: 'Request failed' })
+      }}
+    >
+      Save
+    </button>
+  )
+}
+
+export function App() {
+  return (
+    <ErrorEngineProvider engine={engine}>
+      <SaveButton />
+    </ErrorEngineProvider>
+  )
+}
+```
+
+`gracefulerrors/react` also exports:
+
+- `useFieldError(field)` for inline error state
+- `ErrorBoundaryWithEngine` for catching runtime errors and forwarding them to the engine
+
+## Sonner Adapter
+
+```tsx
+import { SonnerToaster, createSonnerAdapter } from 'gracefulerrors/sonner'
+import { createErrorEngine } from 'gracefulerrors'
+
+const engine = createErrorEngine({
+  registry: {
+    SERVER_ERROR: {
+      ui: 'toast',
+      severity: 'error',
+      message: 'Server error. Please try again.',
+    },
+  },
+  renderer: createSonnerAdapter(),
+})
+
+export function Root() {
+  return (
+    <>
+      <SonnerToaster />
+      {/* your app */}
+    </>
+  )
+}
+```
+
+## Public API
+
+Main entry:
+
+- `createErrorEngine`
+- `createFetch`
+- `mergeRegistries`
+- `builtInNormalizer`
+
+Type exports are available from the root package as well.
+
+Additional entry points:
+
+- `gracefulerrors/react`
+- `gracefulerrors/sonner`
+- `gracefulerrors/internal` for internal testing and low-level integration only
+
+## Configuration Highlights
+
+Common engine options include:
+
+- `registry`: typed error-to-UI mapping
+- `fallback`: default UI choice when no registry entry matches
+- `normalizer` / `normalizers`: custom normalization pipeline
+- `fingerprint`: dedupe key strategy
+- `dedupeWindow`: deduplication window in milliseconds
+- `maxConcurrent` and `maxQueue`: notification throughput control
+- `aggregation`: group bursts of the same UI type
+- `routingStrategy`: dynamic override before registry resolution
+- `transform`: post-normalization shaping or suppression
+- `onError`, `onNormalized`, `onRouted`, `onFallback`, `onSuppressed`, `onDropped`: lifecycle hooks
+- `renderer`: custom rendering adapter
+
+## Package Notes
+
+- Package format: ESM and CJS via conditional exports
+- Runtime peers: `react`, `react-dom`, and `sonner` are optional peer dependencies
+- Current version: `0.1.0`
+
+## Development
+
+```bash
+npm run build
+npm run lint
+npm run typecheck
+```
+
+## License
+
+MIT

package/dist/adapters/sonner.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+var sonner = require('sonner');
+var client = require('react-dom/client');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/adapters/sonner.tsx
+function resolveMessage(entry, error) {
+  if (typeof entry.message === "function") return entry.message(error);
+  return entry.message;
+}
+function ModalDialog({
+  message,
+  dismissible,
+  onDismiss
+}) {
+  react.useEffect(() => {
+    const handleKeyDown = (e) => {
+      if (e.key === "Escape") onDismiss();
+    };
+    document.addEventListener("keydown", handleKeyDown);
+    return () => document.removeEventListener("keydown", handleKeyDown);
+  }, [onDismiss]);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        inset: 0,
+        backgroundColor: "rgba(0,0,0,0.5)",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        zIndex: 9999
+      },
+      onClick: dismissible ? onDismiss : void 0,
+      children: /* @__PURE__ */ jsxRuntime.jsxs(
+        "div",
+        {
+          style: {
+            background: "white",
+            borderRadius: 8,
+            padding: 24,
+            minWidth: 300,
+            maxWidth: 500
+          },
+          onClick: (e) => e.stopPropagation(),
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsx("p", { style: { margin: "0 0 16px" }, children: message }),
+            /* @__PURE__ */ jsxRuntime.jsx("button", { onClick: onDismiss, children: "Dismiss" })
+          ]
+        }
+      )
+    }
+  );
+}
+function createSonnerAdapter() {
+  const activeToastIds = /* @__PURE__ */ new Map();
+  function render(intent, lifecycle) {
+    switch (intent.ui) {
+      case "toast": {
+        const message = resolveMessage(intent.entry, intent.error) ?? intent.error.message ?? "An error occurred";
+        const opts = intent.entry.uiOptions ?? {};
+        const severity = opts.severity ?? "error";
+        const severityMap = {
+          error: sonner.toast.error,
+          warning: sonner.toast.warning,
+          info: sonner.toast.info,
+          success: sonner.toast.success
+        };
+        const toastFn = severityMap[severity] ?? sonner.toast.error;
+        const id = toastFn(message, {
+          position: opts.position ?? "top-right",
+          icon: opts.icon,
+          duration: opts.duration ?? 4e3
+        });
+        activeToastIds.set(intent.error.code, id);
+        break;
+      }
+      case "modal": {
+        const message = resolveMessage(intent.entry, intent.error) ?? intent.error.message ?? "An error occurred";
+        const opts = intent.entry.uiOptions ?? {};
+        const dismissible = opts.dismissible !== false;
+        const container = document.createElement("div");
+        document.body.appendChild(container);
+        const root = client.createRoot(container);
+        const dismiss = () => {
+          root.unmount();
+          if (document.body.contains(container)) {
+            document.body.removeChild(container);
+          }
+          lifecycle.onDismiss?.();
+        };
+        root.render(
+          /* @__PURE__ */ jsxRuntime.jsx(ModalDialog, { message, dismissible, onDismiss: dismiss })
+        );
+        break;
+      }
+      case "inline":
+        return;
+      case "silent":
+        return;
+    }
+  }
+  function clear(code) {
+    const id = activeToastIds.get(code);
+    if (id !== void 0) {
+      sonner.toast.dismiss(id);
+      activeToastIds.delete(code);
+    }
+  }
+  function clearAll() {
+    sonner.toast.dismiss();
+    activeToastIds.clear();
+  }
+  return { render, clear, clearAll };
+}
+
+Object.defineProperty(exports, "SonnerToaster", {
+  enumerable: true,
+  get: function () { return sonner.Toaster; }
+});
+exports.createSonnerAdapter = createSonnerAdapter;
+//# sourceMappingURL=sonner.cjs.map
+//# sourceMappingURL=sonner.cjs.map

package/dist/adapters/sonner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/sonner.tsx"],"names":["useEffect","jsx","jsxs","toast","createRoot"],"mappings":"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","file":"sonner.cjs","sourcesContent":["import { toast, Toaster } from 'sonner'\nimport { createRoot } from 'react-dom/client'\nimport { useEffect } from 'react'\nimport type { RendererAdapter, RenderIntent, ErrorRegistryEntryFull, AppError } from '../types'\n\nfunction resolveMessage<TCode extends string = string>(entry: ErrorRegistryEntryFull<TCode>, error: AppError<TCode>): string | undefined {\n  if (typeof entry.message === 'function') return entry.message(error)\n  return entry.message\n}\n\n// ---------------------------------------------------------------------------\n// Modal component\n// ---------------------------------------------------------------------------\n\nfunction ModalDialog({\n  message,\n  dismissible,\n  onDismiss,\n}: {\n  message: string\n  dismissible: boolean\n  onDismiss: () => void\n}) {\n  useEffect(() => {\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key === 'Escape') onDismiss()\n    }\n    document.addEventListener('keydown', handleKeyDown)\n    return () => document.removeEventListener('keydown', handleKeyDown)\n  }, [onDismiss])\n\n  return (\n    <div\n      style={{\n        position: 'fixed',\n        inset: 0,\n        backgroundColor: 'rgba(0,0,0,0.5)',\n        display: 'flex',\n        alignItems: 'center',\n        justifyContent: 'center',\n        zIndex: 9999,\n      }}\n      onClick={dismissible ? onDismiss : undefined}\n    >\n      <div\n        style={{\n          background: 'white',\n          borderRadius: 8,\n          padding: 24,\n          minWidth: 300,\n          maxWidth: 500,\n        }}\n        onClick={e => e.stopPropagation()}\n      >\n        <p style={{ margin: '0 0 16px' }}>{message}</p>\n        <button onClick={onDismiss}>Dismiss</button>\n      </div>\n    </div>\n  )\n}\n\n// ---------------------------------------------------------------------------\n// createSonnerAdapter\n// ---------------------------------------------------------------------------\n\nexport function createSonnerAdapter(): RendererAdapter {\n  const activeToastIds = new Map<string, string | number>()\n\n  function render<TCode extends string = string>(intent: RenderIntent<TCode>, lifecycle: { onDismiss?: () => void }): void {\n    switch (intent.ui) {\n      case 'toast': {\n        const message =\n          resolveMessage(intent.entry, intent.error) ??\n          intent.error.message ??\n          'An error occurred'\n\n        type ToastOpts = {\n          position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center'\n          severity?: 'info' | 'warning' | 'error' | 'success'\n          icon?: string\n          duration?: number\n        }\n        const opts = (intent.entry.uiOptions ?? {}) as ToastOpts\n        const severity = opts.severity ?? 'error'\n\n        const severityMap: Record<string, typeof toast.error> = {\n          error: toast.error,\n          warning: toast.warning,\n          info: toast.info,\n          success: toast.success,\n        }\n        const toastFn = severityMap[severity] ?? toast.error\n\n        const id = toastFn(message, {\n          position: opts.position ?? 'top-right',\n          icon: opts.icon,\n          duration: opts.duration ?? 4000,\n        })\n\n        activeToastIds.set(intent.error.code as string, id)\n        break\n      }\n\n      case 'modal': {\n        const message =\n          resolveMessage(intent.entry, intent.error) ??\n          intent.error.message ??\n          'An error occurred'\n        const opts = intent.entry.uiOptions ?? {}\n        const dismissible = (opts as { dismissible?: boolean }).dismissible !== false\n\n        const container = document.createElement('div')\n        document.body.appendChild(container)\n        const root = createRoot(container)\n\n        const dismiss = () => {\n          root.unmount()\n          if (document.body.contains(container)) {\n            document.body.removeChild(container)\n          }\n          lifecycle.onDismiss?.()\n        }\n\n        root.render(\n          <ModalDialog message={message} dismissible={dismissible} onDismiss={dismiss} />\n        )\n        break\n      }\n\n      case 'inline':\n        return\n\n      case 'silent':\n        return\n    }\n  }\n\n  function clear(code: string): void {\n    const id = activeToastIds.get(code)\n    if (id !== undefined) {\n      toast.dismiss(id)\n      activeToastIds.delete(code)\n    }\n  }\n\n  function clearAll(): void {\n    toast.dismiss()\n    activeToastIds.clear()\n  }\n\n  return { render, clear, clearAll }\n}\n\nexport { Toaster as SonnerToaster }\n"]}

package/dist/adapters/sonner.d.cts

@@ -0,0 +1,6 @@
+export { Toaster as SonnerToaster } from 'sonner';
+import { e as RendererAdapter } from '../types-CsPmpcbL.cjs';
+
+declare function createSonnerAdapter(): RendererAdapter;
+
+export { createSonnerAdapter };

package/dist/adapters/sonner.d.ts

@@ -0,0 +1,6 @@
+export { Toaster as SonnerToaster } from 'sonner';
+import { e as RendererAdapter } from '../types-CsPmpcbL.js';
+
+declare function createSonnerAdapter(): RendererAdapter;
+
+export { createSonnerAdapter };

package/dist/adapters/sonner.js

@@ -0,0 +1,121 @@
+import { toast } from 'sonner';
+export { Toaster as SonnerToaster } from 'sonner';
+import { createRoot } from 'react-dom/client';
+import { useEffect } from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/adapters/sonner.tsx
+function resolveMessage(entry, error) {
+  if (typeof entry.message === "function") return entry.message(error);
+  return entry.message;
+}
+function ModalDialog({
+  message,
+  dismissible,
+  onDismiss
+}) {
+  useEffect(() => {
+    const handleKeyDown = (e) => {
+      if (e.key === "Escape") onDismiss();
+    };
+    document.addEventListener("keydown", handleKeyDown);
+    return () => document.removeEventListener("keydown", handleKeyDown);
+  }, [onDismiss]);
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        inset: 0,
+        backgroundColor: "rgba(0,0,0,0.5)",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        zIndex: 9999
+      },
+      onClick: dismissible ? onDismiss : void 0,
+      children: /* @__PURE__ */ jsxs(
+        "div",
+        {
+          style: {
+            background: "white",
+            borderRadius: 8,
+            padding: 24,
+            minWidth: 300,
+            maxWidth: 500
+          },
+          onClick: (e) => e.stopPropagation(),
+          children: [
+            /* @__PURE__ */ jsx("p", { style: { margin: "0 0 16px" }, children: message }),
+            /* @__PURE__ */ jsx("button", { onClick: onDismiss, children: "Dismiss" })
+          ]
+        }
+      )
+    }
+  );
+}
+function createSonnerAdapter() {
+  const activeToastIds = /* @__PURE__ */ new Map();
+  function render(intent, lifecycle) {
+    switch (intent.ui) {
+      case "toast": {
+        const message = resolveMessage(intent.entry, intent.error) ?? intent.error.message ?? "An error occurred";
+        const opts = intent.entry.uiOptions ?? {};
+        const severity = opts.severity ?? "error";
+        const severityMap = {
+          error: toast.error,
+          warning: toast.warning,
+          info: toast.info,
+          success: toast.success
+        };
+        const toastFn = severityMap[severity] ?? toast.error;
+        const id = toastFn(message, {
+          position: opts.position ?? "top-right",
+          icon: opts.icon,
+          duration: opts.duration ?? 4e3
+        });
+        activeToastIds.set(intent.error.code, id);
+        break;
+      }
+      case "modal": {
+        const message = resolveMessage(intent.entry, intent.error) ?? intent.error.message ?? "An error occurred";
+        const opts = intent.entry.uiOptions ?? {};
+        const dismissible = opts.dismissible !== false;
+        const container = document.createElement("div");
+        document.body.appendChild(container);
+        const root = createRoot(container);
+        const dismiss = () => {
+          root.unmount();
+          if (document.body.contains(container)) {
+            document.body.removeChild(container);
+          }
+          lifecycle.onDismiss?.();
+        };
+        root.render(
+          /* @__PURE__ */ jsx(ModalDialog, { message, dismissible, onDismiss: dismiss })
+        );
+        break;
+      }
+      case "inline":
+        return;
+      case "silent":
+        return;
+    }
+  }
+  function clear(code) {
+    const id = activeToastIds.get(code);
+    if (id !== void 0) {
+      toast.dismiss(id);
+      activeToastIds.delete(code);
+    }
+  }
+  function clearAll() {
+    toast.dismiss();
+    activeToastIds.clear();
+  }
+  return { render, clear, clearAll };
+}
+
+export { createSonnerAdapter };
+//# sourceMappingURL=sonner.js.map
+//# sourceMappingURL=sonner.js.map

package/dist/adapters/sonner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/sonner.tsx"],"names":[],"mappings":"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","file":"sonner.js","sourcesContent":["import { toast, Toaster } from 'sonner'\nimport { createRoot } from 'react-dom/client'\nimport { useEffect } from 'react'\nimport type { RendererAdapter, RenderIntent, ErrorRegistryEntryFull, AppError } from '../types'\n\nfunction resolveMessage<TCode extends string = string>(entry: ErrorRegistryEntryFull<TCode>, error: AppError<TCode>): string | undefined {\n  if (typeof entry.message === 'function') return entry.message(error)\n  return entry.message\n}\n\n// ---------------------------------------------------------------------------\n// Modal component\n// ---------------------------------------------------------------------------\n\nfunction ModalDialog({\n  message,\n  dismissible,\n  onDismiss,\n}: {\n  message: string\n  dismissible: boolean\n  onDismiss: () => void\n}) {\n  useEffect(() => {\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key === 'Escape') onDismiss()\n    }\n    document.addEventListener('keydown', handleKeyDown)\n    return () => document.removeEventListener('keydown', handleKeyDown)\n  }, [onDismiss])\n\n  return (\n    <div\n      style={{\n        position: 'fixed',\n        inset: 0,\n        backgroundColor: 'rgba(0,0,0,0.5)',\n        display: 'flex',\n        alignItems: 'center',\n        justifyContent: 'center',\n        zIndex: 9999,\n      }}\n      onClick={dismissible ? onDismiss : undefined}\n    >\n      <div\n        style={{\n          background: 'white',\n          borderRadius: 8,\n          padding: 24,\n          minWidth: 300,\n          maxWidth: 500,\n        }}\n        onClick={e => e.stopPropagation()}\n      >\n        <p style={{ margin: '0 0 16px' }}>{message}</p>\n        <button onClick={onDismiss}>Dismiss</button>\n      </div>\n    </div>\n  )\n}\n\n// ---------------------------------------------------------------------------\n// createSonnerAdapter\n// ---------------------------------------------------------------------------\n\nexport function createSonnerAdapter(): RendererAdapter {\n  const activeToastIds = new Map<string, string | number>()\n\n  function render<TCode extends string = string>(intent: RenderIntent<TCode>, lifecycle: { onDismiss?: () => void }): void {\n    switch (intent.ui) {\n      case 'toast': {\n        const message =\n          resolveMessage(intent.entry, intent.error) ??\n          intent.error.message ??\n          'An error occurred'\n\n        type ToastOpts = {\n          position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center'\n          severity?: 'info' | 'warning' | 'error' | 'success'\n          icon?: string\n          duration?: number\n        }\n        const opts = (intent.entry.uiOptions ?? {}) as ToastOpts\n        const severity = opts.severity ?? 'error'\n\n        const severityMap: Record<string, typeof toast.error> = {\n          error: toast.error,\n          warning: toast.warning,\n          info: toast.info,\n          success: toast.success,\n        }\n        const toastFn = severityMap[severity] ?? toast.error\n\n        const id = toastFn(message, {\n          position: opts.position ?? 'top-right',\n          icon: opts.icon,\n          duration: opts.duration ?? 4000,\n        })\n\n        activeToastIds.set(intent.error.code as string, id)\n        break\n      }\n\n      case 'modal': {\n        const message =\n          resolveMessage(intent.entry, intent.error) ??\n          intent.error.message ??\n          'An error occurred'\n        const opts = intent.entry.uiOptions ?? {}\n        const dismissible = (opts as { dismissible?: boolean }).dismissible !== false\n\n        const container = document.createElement('div')\n        document.body.appendChild(container)\n        const root = createRoot(container)\n\n        const dismiss = () => {\n          root.unmount()\n          if (document.body.contains(container)) {\n            document.body.removeChild(container)\n          }\n          lifecycle.onDismiss?.()\n        }\n\n        root.render(\n          <ModalDialog message={message} dismissible={dismissible} onDismiss={dismiss} />\n        )\n        break\n      }\n\n      case 'inline':\n        return\n\n      case 'silent':\n        return\n    }\n  }\n\n  function clear(code: string): void {\n    const id = activeToastIds.get(code)\n    if (id !== undefined) {\n      toast.dismiss(id)\n      activeToastIds.delete(code)\n    }\n  }\n\n  function clearAll(): void {\n    toast.dismiss()\n    activeToastIds.clear()\n  }\n\n  return { render, clear, clearAll }\n}\n\nexport { Toaster as SonnerToaster }\n"]}