evlog 2.15.0 → 2.17.0

package/dist/http-6umVAKDW.mjs

@@ -0,0 +1,82 @@
+import { n as version } from "./package-v_MmOZeA.mjs";
+//#region src/shared/http.ts
+/**
+* Minimal HTTP transport for drain adapters: abort-based timeouts, exponential
+* backoff on `5xx` / network errors, response bodies truncated in error messages.
+*
+* Identifies every outgoing request as coming from evlog via:
+* - `User-Agent: evlog/<version>` (Node / server runtimes only — browsers strip this)
+* - `X-Evlog-Source: <source>` when {@link HttpPostOptions.source} is set
+*/
+/** Build-time evlog package version, e.g. `2.16.0`. */
+const EVLOG_VERSION = version;
+/** Default `User-Agent` value injected into outgoing drain requests. */
+const EVLOG_USER_AGENT = `evlog/${EVLOG_VERSION}`;
+function hasHeader(headers, target) {
+	const lower = target.toLowerCase();
+	for (const key of Object.keys(headers)) if (key.toLowerCase() === lower) return true;
+	return false;
+}
+/**
+* Returns a copy of `headers` with evlog identity headers injected when
+* absent. Caller-provided values always win.
+*
+* @internal Exposed for tests. Use {@link httpPost} from drains.
+*/
+function withEvlogIdentityHeaders(headers, { userAgent, source } = {}) {
+	const out = { ...headers };
+	if (userAgent !== false && !hasHeader(out, "user-agent")) out["User-Agent"] = typeof userAgent === "string" && userAgent.length > 0 ? userAgent : EVLOG_USER_AGENT;
+	if (source && !hasHeader(out, "x-evlog-source")) out["X-Evlog-Source"] = source;
+	return out;
+}
+function isRetryable(error) {
+	if (error instanceof DOMException && error.name === "AbortError") return true;
+	if (error instanceof TypeError) return true;
+	if (error instanceof Error) {
+		const match = error.message.match(/API error: (\d+)/);
+		if (match) return Number.parseInt(match[1]) >= 500;
+	}
+	return false;
+}
+/**
+* POST a body with timeout + retry. Throws label-prefixed errors with a
+* truncated response body. Safe to call from any drain `send()`.
+*/
+async function httpPost({ url, headers, body, timeout, label, retries = 2, userAgent, source }) {
+	const normalizedRetries = Number.isFinite(retries) && retries >= 0 ? Math.floor(retries) : 2;
+	const finalHeaders = withEvlogIdentityHeaders(headers, {
+		userAgent,
+		source
+	});
+	let lastError;
+	for (let attempt = 0; attempt <= normalizedRetries; attempt++) {
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), timeout);
+		try {
+			const response = await fetch(url, {
+				method: "POST",
+				headers: finalHeaders,
+				body,
+				signal: controller.signal
+			});
+			if (!response.ok) {
+				const text = await response.text().catch(() => "Unknown error");
+				const safeText = text.length > 200 ? `${text.slice(0, 200)}...[truncated]` : text;
+				throw new Error(`${label} API error: ${response.status} ${response.statusText} - ${safeText}`);
+			}
+			clearTimeout(timeoutId);
+			return;
+		} catch (error) {
+			clearTimeout(timeoutId);
+			if (error instanceof DOMException && error.name === "AbortError") lastError = /* @__PURE__ */ new Error(`${label} request timed out after ${timeout}ms`);
+			else lastError = error;
+			if (!isRetryable(error) || attempt === normalizedRetries) throw lastError;
+			await new Promise((r) => setTimeout(r, 200 * 2 ** attempt));
+		}
+	}
+	throw lastError;
+}
+//#endregion
+export { withEvlogIdentityHeaders as i, EVLOG_VERSION as n, httpPost as r, EVLOG_USER_AGENT as t };
+
+//# sourceMappingURL=http-6umVAKDW.mjs.map

package/dist/http-6umVAKDW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-6umVAKDW.mjs","names":["PKG_VERSION"],"sources":["../src/shared/http.ts"],"sourcesContent":["/**\n * Minimal HTTP transport for drain adapters: abort-based timeouts, exponential\n * backoff on `5xx` / network errors, response bodies truncated in error messages.\n *\n * Identifies every outgoing request as coming from evlog via:\n * - `User-Agent: evlog/<version>` (Node / server runtimes only — browsers strip this)\n * - `X-Evlog-Source: <source>` when {@link HttpPostOptions.source} is set\n */\n\nimport { version as PKG_VERSION } from '../../package.json'\n\n/** Build-time evlog package version, e.g. `2.16.0`. */\nexport const EVLOG_VERSION: string = PKG_VERSION\n\n/** Default `User-Agent` value injected into outgoing drain requests. */\nexport const EVLOG_USER_AGENT = `evlog/${EVLOG_VERSION}`\n\nexport interface HttpPostOptions {\n  url: string\n  /** Caller is responsible for `Content-Type`. */\n  headers: Record<string, string>\n  /** Pre-serialized request body. */\n  body: string\n  /** Abort the request after this many milliseconds. */\n  timeout: number\n  /** Prefix used in error messages. */\n  label: string\n  /**\n   * Retries network errors, aborts, and `5xx` responses with exponential backoff.\n   * @default 2\n   */\n  retries?: number\n  /**\n   * Override the default `User-Agent: evlog/<version>` header. Pass `false` or\n   * an empty string to suppress it entirely (e.g. when the underlying transport\n   * forbids overriding `User-Agent`).\n   */\n  userAgent?: string | false\n  /**\n   * When set, sends `X-Evlog-Source: <source>` so the receiving system can\n   * distinguish evlog traffic from other clients. Typically the adapter name\n   * (`axiom`, `datadog`, ...) or `client` for browser-originated drains.\n   */\n  source?: string\n}\n\nfunction hasHeader(headers: Record<string, string>, target: string): boolean {\n  const lower = target.toLowerCase()\n  for (const key of Object.keys(headers)) {\n    if (key.toLowerCase() === lower) return true\n  }\n  return false\n}\n\n/**\n * Returns a copy of `headers` with evlog identity headers injected when\n * absent. Caller-provided values always win.\n *\n * @internal Exposed for tests. Use {@link httpPost} from drains.\n */\nexport function withEvlogIdentityHeaders(\n  headers: Record<string, string>,\n  { userAgent, source }: { userAgent?: string | false; source?: string } = {},\n): Record<string, string> {\n  const out = { ...headers }\n  if (userAgent !== false && !hasHeader(out, 'user-agent')) {\n    const ua = typeof userAgent === 'string' && userAgent.length > 0 ? userAgent : EVLOG_USER_AGENT\n    out['User-Agent'] = ua\n  }\n  if (source && !hasHeader(out, 'x-evlog-source')) {\n    out['X-Evlog-Source'] = source\n  }\n  return out\n}\n\nfunction isRetryable(error: unknown): boolean {\n  if (error instanceof DOMException && error.name === 'AbortError') return true\n  if (error instanceof TypeError) return true\n  if (error instanceof Error) {\n    const match = error.message.match(/API error: (\\d+)/)\n    if (match) return Number.parseInt(match[1]) >= 500\n  }\n  return false\n}\n\n/**\n * POST a body with timeout + retry. Throws label-prefixed errors with a\n * truncated response body. Safe to call from any drain `send()`.\n */\nexport async function httpPost({ url, headers, body, timeout, label, retries = 2, userAgent, source }: HttpPostOptions): Promise<void> {\n  const normalizedRetries = Number.isFinite(retries) && retries >= 0 ? Math.floor(retries) : 2\n  const finalHeaders = withEvlogIdentityHeaders(headers, { userAgent, source })\n\n  let lastError: Error | undefined\n\n  for (let attempt = 0; attempt <= normalizedRetries; attempt++) {\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: finalHeaders,\n        body,\n        signal: controller.signal,\n      })\n\n      if (!response.ok) {\n        const text = await response.text().catch(() => 'Unknown error')\n        const safeText = text.length > 200 ? `${text.slice(0, 200)}...[truncated]` : text\n        throw new Error(`${label} API error: ${response.status} ${response.statusText} - ${safeText}`)\n      }\n\n      clearTimeout(timeoutId)\n      return\n    } catch (error) {\n      clearTimeout(timeoutId)\n\n      if (error instanceof DOMException && error.name === 'AbortError') {\n        lastError = new Error(`${label} request timed out after ${timeout}ms`)\n      } else {\n        lastError = error as Error\n      }\n\n      if (!isRetryable(error) || attempt === normalizedRetries) {\n        throw lastError\n      }\n\n      await new Promise<void>(r => setTimeout(r, 200 * 2 ** attempt))\n    }\n  }\n\n  throw lastError!\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAa,gBAAwBA;;AAGrC,MAAa,mBAAmB,SAAS;AA+BzC,SAAS,UAAU,SAAiC,QAAyB;CAC3E,MAAM,QAAQ,OAAO,aAAa;AAClC,MAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,IAAI,aAAa,KAAK,MAAO,QAAO;AAE1C,QAAO;;;;;;;;AAST,SAAgB,yBACd,SACA,EAAE,WAAW,WAA4D,EAAE,EACnD;CACxB,MAAM,MAAM,EAAE,GAAG,SAAS;AAC1B,KAAI,cAAc,SAAS,CAAC,UAAU,KAAK,aAAa,CAEtD,KAAI,gBADO,OAAO,cAAc,YAAY,UAAU,SAAS,IAAI,YAAY;AAGjF,KAAI,UAAU,CAAC,UAAU,KAAK,iBAAiB,CAC7C,KAAI,oBAAoB;AAE1B,QAAO;;AAGT,SAAS,YAAY,OAAyB;AAC5C,KAAI,iBAAiB,gBAAgB,MAAM,SAAS,aAAc,QAAO;AACzE,KAAI,iBAAiB,UAAW,QAAO;AACvC,KAAI,iBAAiB,OAAO;EAC1B,MAAM,QAAQ,MAAM,QAAQ,MAAM,mBAAmB;AACrD,MAAI,MAAO,QAAO,OAAO,SAAS,MAAM,GAAG,IAAI;;AAEjD,QAAO;;;;;;AAOT,eAAsB,SAAS,EAAE,KAAK,SAAS,MAAM,SAAS,OAAO,UAAU,GAAG,WAAW,UAA0C;CACrI,MAAM,oBAAoB,OAAO,SAAS,QAAQ,IAAI,WAAW,IAAI,KAAK,MAAM,QAAQ,GAAG;CAC3F,MAAM,eAAe,yBAAyB,SAAS;EAAE;EAAW;EAAQ,CAAC;CAE7E,IAAI;AAEJ,MAAK,IAAI,UAAU,GAAG,WAAW,mBAAmB,WAAW;EAC7D,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,KAAK;IAChC,QAAQ;IACR,SAAS;IACT;IACA,QAAQ,WAAW;IACpB,CAAC;AAEF,OAAI,CAAC,SAAS,IAAI;IAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,gBAAgB;IAC/D,MAAM,WAAW,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC,kBAAkB;AAC7E,UAAM,IAAI,MAAM,GAAG,MAAM,cAAc,SAAS,OAAO,GAAG,SAAS,WAAW,KAAK,WAAW;;AAGhG,gBAAa,UAAU;AACvB;WACO,OAAO;AACd,gBAAa,UAAU;AAEvB,OAAI,iBAAiB,gBAAgB,MAAM,SAAS,aAClD,6BAAY,IAAI,MAAM,GAAG,MAAM,2BAA2B,QAAQ,IAAI;OAEtE,aAAY;AAGd,OAAI,CAAC,YAAY,MAAM,IAAI,YAAY,kBACrC,OAAM;AAGR,SAAM,IAAI,SAAc,MAAK,WAAW,GAAG,MAAM,KAAK,QAAQ,CAAC;;;AAInE,OAAM"}

package/dist/http.d.mts

@@ -1,4 +1,4 @@
-import { F as DrainContext } from "./audit-CJl-wZ10.mjs";
+import { I as DrainContext } from "./audit-CC8nfazi.mjs";
 import { DrainPipelineOptions, PipelineDrainFn } from "./pipeline.mjs";
 
 //#region src/http.d.ts

package/dist/http.mjs

@@ -33,6 +33,7 @@ function createHttpDrain(config) {
 				method: "POST",
 				headers: {
 					"Content-Type": "application/json",
+					"X-Evlog-Source": "client",
 					...customHeaders
 				},
 				body,

package/dist/http.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import type { DrainContext } from './types'\nimport type { DrainPipelineOptions, PipelineDrainFn } from './pipeline'\nimport { createDrainPipeline } from './pipeline'\nimport { isBrowser } from './utils'\n\nexport interface HttpDrainConfig {\n  /** URL of the server ingest endpoint */\n  endpoint: string\n  /** Custom headers sent with each fetch request (e.g. Authorization, X-API-Key). Not applied to sendBeacon — see `useBeacon`. */\n  headers?: Record<string, string>\n  /** Request timeout in milliseconds. @default 5000 */\n  timeout?: number\n  /** Use sendBeacon when the page is hidden. @default true */\n  useBeacon?: boolean\n  /** Fetch credentials mode. @default 'same-origin' */\n  credentials?: RequestCredentials\n}\n\nexport interface HttpLogDrainOptions {\n  /** HTTP drain configuration (endpoint is required) */\n  drain: HttpDrainConfig\n  /** Pipeline configuration overrides */\n  pipeline?: DrainPipelineOptions<DrainContext>\n  /** Auto-register visibilitychange flush listener. @default true */\n  autoFlush?: boolean\n}\n\n/**\n * Create a low-level HTTP drain transport function (fetch / sendBeacon).\n *\n * Returns a function compatible with `createDrainPipeline` that sends batches\n * to the configured endpoint via `fetch` (with `keepalive: true`) or\n * `navigator.sendBeacon` when the page is hidden.\n *\n * @example\n * ```ts\n * import { createHttpDrain } from 'evlog/http'\n * import { createDrainPipeline } from 'evlog/pipeline'\n *\n * const pipeline = createDrainPipeline({ batch: { size: 50 } })\n * const drain = pipeline(createHttpDrain({ endpoint: '/api/logs' }))\n * ```\n */\nexport function createHttpDrain(config: HttpDrainConfig): (batch: DrainContext[]) => Promise<void> {\n  const { endpoint, headers: customHeaders, timeout = 5000, useBeacon = true, credentials = 'same-origin' } = config\n\n  return async (batch: DrainContext[]): Promise<void> => {\n    if (batch.length === 0) return\n\n    const body = JSON.stringify(batch)\n\n    if (\n      useBeacon\n      && isBrowser()\n      && document.visibilityState === 'hidden'\n      && typeof navigator.sendBeacon === 'function'\n    ) {\n      const queued = navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' }))\n      if (!queued) {\n        throw new Error('[evlog/http] sendBeacon failed — payload may exceed browser limit')\n      }\n      return\n    }\n\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n    try {\n      const response = await fetch(endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', ...customHeaders },\n        body,\n        signal: controller.signal,\n        keepalive: true,\n        credentials,\n      })\n\n      if (!response.ok) {\n        throw new Error(`[evlog/http] Server responded with ${response.status}`)\n      }\n    } finally {\n      clearTimeout(timeoutId)\n    }\n  }\n}\n\n/**\n * Create a pre-composed HTTP log drain with pipeline, batching, and auto-flush.\n *\n * Returns a `PipelineDrainFn<DrainContext>` directly usable with `initLogger({ drain })`.\n *\n * @example\n * ```ts\n * import { initLogger, log } from 'evlog'\n * import { createHttpLogDrain } from 'evlog/http'\n *\n * const drain = createHttpLogDrain({\n *   drain: { endpoint: '/api/logs' },\n * })\n * initLogger({ drain })\n *\n * log.info({ action: 'page_view', path: location.pathname })\n * ```\n */\nexport function createHttpLogDrain(options: HttpLogDrainOptions): PipelineDrainFn<DrainContext> & { dispose: () => void } {\n  const { autoFlush = true } = options\n\n  const pipeline = createDrainPipeline<DrainContext>({\n    batch: { size: 25, intervalMs: 2000 },\n    retry: { maxAttempts: 2 },\n    ...options.pipeline,\n  })\n\n  const drain = pipeline(createHttpDrain(options.drain)) as PipelineDrainFn<DrainContext> & { dispose: () => void }\n\n  let onVisibilityChange: (() => void) | undefined\n\n  if (autoFlush && isBrowser()) {\n    onVisibilityChange = () => {\n      if (document.visibilityState === 'hidden') {\n        drain.flush()\n      }\n    }\n    document.addEventListener('visibilitychange', onVisibilityChange)\n  }\n\n  drain.dispose = () => {\n    if (onVisibilityChange) {\n      document.removeEventListener('visibilitychange', onVisibilityChange)\n      onVisibilityChange = undefined\n    }\n  }\n\n  return drain\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,gBAAgB,QAAmE;CACjG,MAAM,EAAE,UAAU,SAAS,eAAe,UAAU,KAAM,YAAY,MAAM,cAAc,kBAAkB;AAE5G,QAAO,OAAO,UAAyC;AACrD,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,OAAO,KAAK,UAAU,MAAM;AAElC,MACE,aACG,WAAW,IACX,SAAS,oBAAoB,YAC7B,OAAO,UAAU,eAAe,YACnC;AAEA,OAAI,CADW,UAAU,WAAW,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,oBAAoB,CAAC,CACjF,CACT,OAAM,IAAI,MAAM,oEAAoE;AAEtF;;EAGF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,UAAU;IACrC,QAAQ;IACR,SAAS;KAAE,gBAAgB;KAAoB,GAAG;KAAe;IACjE;IACA,QAAQ,WAAW;IACnB,WAAW;IACX;IACD,CAAC;AAEF,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,sCAAsC,SAAS,SAAS;YAElE;AACR,gBAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;AAuB7B,SAAgB,mBAAmB,SAAuF;CACxH,MAAM,EAAE,YAAY,SAAS;CAQ7B,MAAM,QANW,oBAAkC;EACjD,OAAO;GAAE,MAAM;GAAI,YAAY;GAAM;EACrC,OAAO,EAAE,aAAa,GAAG;EACzB,GAAG,QAAQ;EACZ,CAEqB,CAAC,gBAAgB,QAAQ,MAAM,CAAC;CAEtD,IAAI;AAEJ,KAAI,aAAa,WAAW,EAAE;AAC5B,6BAA2B;AACzB,OAAI,SAAS,oBAAoB,SAC/B,OAAM,OAAO;;AAGjB,WAAS,iBAAiB,oBAAoB,mBAAmB;;AAGnE,OAAM,gBAAgB;AACpB,MAAI,oBAAoB;AACtB,YAAS,oBAAoB,oBAAoB,mBAAmB;AACpE,wBAAqB,KAAA;;;AAIzB,QAAO"}
+{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import type { DrainContext } from './types'\nimport type { DrainPipelineOptions, PipelineDrainFn } from './pipeline'\nimport { createDrainPipeline } from './pipeline'\nimport { isBrowser } from './utils'\n\nexport interface HttpDrainConfig {\n  /** URL of the server ingest endpoint */\n  endpoint: string\n  /** Custom headers sent with each fetch request (e.g. Authorization, X-API-Key). Not applied to sendBeacon — see `useBeacon`. */\n  headers?: Record<string, string>\n  /** Request timeout in milliseconds. @default 5000 */\n  timeout?: number\n  /** Use sendBeacon when the page is hidden. @default true */\n  useBeacon?: boolean\n  /** Fetch credentials mode. @default 'same-origin' */\n  credentials?: RequestCredentials\n}\n\nexport interface HttpLogDrainOptions {\n  /** HTTP drain configuration (endpoint is required) */\n  drain: HttpDrainConfig\n  /** Pipeline configuration overrides */\n  pipeline?: DrainPipelineOptions<DrainContext>\n  /** Auto-register visibilitychange flush listener. @default true */\n  autoFlush?: boolean\n}\n\n/**\n * Create a low-level HTTP drain transport function (fetch / sendBeacon).\n *\n * Returns a function compatible with `createDrainPipeline` that sends batches\n * to the configured endpoint via `fetch` (with `keepalive: true`) or\n * `navigator.sendBeacon` when the page is hidden.\n *\n * @example\n * ```ts\n * import { createHttpDrain } from 'evlog/http'\n * import { createDrainPipeline } from 'evlog/pipeline'\n *\n * const pipeline = createDrainPipeline({ batch: { size: 50 } })\n * const drain = pipeline(createHttpDrain({ endpoint: '/api/logs' }))\n * ```\n */\nexport function createHttpDrain(config: HttpDrainConfig): (batch: DrainContext[]) => Promise<void> {\n  const { endpoint, headers: customHeaders, timeout = 5000, useBeacon = true, credentials = 'same-origin' } = config\n\n  return async (batch: DrainContext[]): Promise<void> => {\n    if (batch.length === 0) return\n\n    const body = JSON.stringify(batch)\n\n    if (\n      useBeacon\n      && isBrowser()\n      && document.visibilityState === 'hidden'\n      && typeof navigator.sendBeacon === 'function'\n    ) {\n      const queued = navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' }))\n      if (!queued) {\n        throw new Error('[evlog/http] sendBeacon failed — payload may exceed browser limit')\n      }\n      return\n    }\n\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n    try {\n      const response = await fetch(endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', 'X-Evlog-Source': 'client', ...customHeaders },\n        body,\n        signal: controller.signal,\n        keepalive: true,\n        credentials,\n      })\n\n      if (!response.ok) {\n        throw new Error(`[evlog/http] Server responded with ${response.status}`)\n      }\n    } finally {\n      clearTimeout(timeoutId)\n    }\n  }\n}\n\n/**\n * Create a pre-composed HTTP log drain with pipeline, batching, and auto-flush.\n *\n * Returns a `PipelineDrainFn<DrainContext>` directly usable with `initLogger({ drain })`.\n *\n * @example\n * ```ts\n * import { initLogger, log } from 'evlog'\n * import { createHttpLogDrain } from 'evlog/http'\n *\n * const drain = createHttpLogDrain({\n *   drain: { endpoint: '/api/logs' },\n * })\n * initLogger({ drain })\n *\n * log.info({ action: 'page_view', path: location.pathname })\n * ```\n */\nexport function createHttpLogDrain(options: HttpLogDrainOptions): PipelineDrainFn<DrainContext> & { dispose: () => void } {\n  const { autoFlush = true } = options\n\n  const pipeline = createDrainPipeline<DrainContext>({\n    batch: { size: 25, intervalMs: 2000 },\n    retry: { maxAttempts: 2 },\n    ...options.pipeline,\n  })\n\n  const drain = pipeline(createHttpDrain(options.drain)) as PipelineDrainFn<DrainContext> & { dispose: () => void }\n\n  let onVisibilityChange: (() => void) | undefined\n\n  if (autoFlush && isBrowser()) {\n    onVisibilityChange = () => {\n      if (document.visibilityState === 'hidden') {\n        drain.flush()\n      }\n    }\n    document.addEventListener('visibilitychange', onVisibilityChange)\n  }\n\n  drain.dispose = () => {\n    if (onVisibilityChange) {\n      document.removeEventListener('visibilitychange', onVisibilityChange)\n      onVisibilityChange = undefined\n    }\n  }\n\n  return drain\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,gBAAgB,QAAmE;CACjG,MAAM,EAAE,UAAU,SAAS,eAAe,UAAU,KAAM,YAAY,MAAM,cAAc,kBAAkB;AAE5G,QAAO,OAAO,UAAyC;AACrD,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,OAAO,KAAK,UAAU,MAAM;AAElC,MACE,aACG,WAAW,IACX,SAAS,oBAAoB,YAC7B,OAAO,UAAU,eAAe,YACnC;AAEA,OAAI,CADW,UAAU,WAAW,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,oBAAoB,CAAC,CACjF,CACT,OAAM,IAAI,MAAM,oEAAoE;AAEtF;;EAGF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,QAAQ;AAE/D,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,UAAU;IACrC,QAAQ;IACR,SAAS;KAAE,gBAAgB;KAAoB,kBAAkB;KAAU,GAAG;KAAe;IAC7F;IACA,QAAQ,WAAW;IACnB,WAAW;IACX;IACD,CAAC;AAEF,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,sCAAsC,SAAS,SAAS;YAElE;AACR,gBAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;AAuB7B,SAAgB,mBAAmB,SAAuF;CACxH,MAAM,EAAE,YAAY,SAAS;CAQ7B,MAAM,QANW,oBAAkC;EACjD,OAAO;GAAE,MAAM;GAAI,YAAY;GAAM;EACrC,OAAO,EAAE,aAAa,GAAG;EACzB,GAAG,QAAQ;EACZ,CAEqB,CAAC,gBAAgB,QAAQ,MAAM,CAAC;CAEtD,IAAI;AAEJ,KAAI,aAAa,WAAW,EAAE;AAC5B,6BAA2B;AACzB,OAAI,SAAS,oBAAoB,SAC/B,OAAM,OAAO;;AAGjB,WAAS,iBAAiB,oBAAoB,mBAAmB;;AAGnE,OAAM,gBAAgB;AACpB,MAAI,oBAAoB;AACtB,YAAS,oBAAoB,oBAAoB,mBAAmB;AACpE,wBAAqB,KAAA;;;AAIzB,QAAO"}

package/dist/index-o1_z4phv.d.mts

@@ -0,0 +1,213 @@
+import { N as AuditTarget, a as AuditInput } from "./audit-CC8nfazi.mjs";
+import { t as EvlogError } from "./error-CpbbtyXL.mjs";
+//#region src/catalog.d.ts
+/**
+ * Static metadata for a single entry in an error catalog.
+ *
+ * `message` is either a constant string or a function that receives required
+ * params at the call site (typed). All other fields are templated defaults
+ * that can be overridden at the call site.
+ */
+interface ErrorCatalogEntry {
+  /** HTTP status code (default: 500). */
+  status?: number;
+  /**
+   * Either a constant string or a typed function whose params become required
+   * arguments at the call site (`factory({ available, required })`).
+   */
+  message: string | ((params: never) => string);
+  /** Why this error occurred (technical reason). */
+  why?: string;
+  /** Actionable fix shown to the user. */
+  fix?: string;
+  /** Link to documentation. */
+  link?: string;
+  /** Free-form metadata for grouping / filtering (not surfaced on the wire). */
+  tags?: readonly string[];
+  /**
+   * Backend-only context defaults. Merged with call-site `internal` (call-site wins).
+   */
+  internal?: Record<string, unknown>;
+}
+/**
+ * Subset of {@link import('./types').ErrorOptions} that callers may override
+ * when invoking a catalog factory. `code` is always derived from the catalog
+ * and intentionally excluded — pass `cause` here for error chaining.
+ */
+interface ErrorFactoryOverrides {
+  message?: string;
+  status?: number;
+  why?: string;
+  fix?: string;
+  link?: string;
+  internal?: Record<string, unknown>;
+  cause?: Error;
+}
+/** @internal Extract the params object type from a templated message function. */
+type MessageParams<TMessage> = TMessage extends ((params: infer P) => string) ? P : Record<string, never>;
+/**
+ * Call-site argument type for a catalog factory:
+ * - if `message` is a function: required params object merged with overrides
+ * - if `message` is a string: optional overrides only
+ */
+type ErrorFactoryOpts<TEntry extends ErrorCatalogEntry> = TEntry['message'] extends ((params: infer _P) => string) ? MessageParams<TEntry['message']> & ErrorFactoryOverrides : ErrorFactoryOverrides;
+/** @internal When message is a string, the call-site argument is optional. */
+type FactoryArgs<TEntry extends ErrorCatalogEntry> = TEntry['message'] extends ((params: never) => string) ? [opts: ErrorFactoryOpts<TEntry>] : [opts?: ErrorFactoryOpts<TEntry>];
+/**
+ * A factory produced by {@link defineError} or each entry of
+ * {@link defineErrorCatalog}. Calling it returns a fully-formed
+ * {@link EvlogError} with the catalog's defaults applied. Static metadata
+ * is exposed as readonly properties for introspection / refactor-safe
+ * comparisons (`err.code === MyError.code`).
+ */
+type DefinedError<TCode extends string, TEntry extends ErrorCatalogEntry> = ((...args: FactoryArgs<TEntry>) => EvlogError) & {
+  readonly code: TCode;
+  readonly status: number;
+  readonly message: TEntry['message'];
+  readonly why: TEntry['why'];
+  readonly fix: TEntry['fix'];
+  readonly link: TEntry['link'];
+  readonly tags: TEntry['tags'];
+  readonly internal: TEntry['internal'];
+};
+/**
+ * Define a single, standalone error factory bound to a stable `code`.
+ *
+ * Each factory produces an {@link EvlogError} with the entry's defaults
+ * applied. Call-site overrides (`cause`, `internal`, `message`, ...) are
+ * shallow-merged onto those defaults.
+ *
+ * @example
+ * ```ts
+ * import { defineError } from 'evlog'
+ *
+ * export const PaymentDeclined = defineError('billing.PAYMENT_DECLINED', {
+ *   status: 402,
+ *   message: 'Card declined',
+ *   why: 'Issuer declined the charge',
+ *   fix: 'Try another card',
+ * })
+ *
+ * throw PaymentDeclined()
+ * throw PaymentDeclined({ cause: stripeErr, internal: { ref: 'ch_x' } })
+ * ```
+ *
+ * @example Templated message with typed params
+ * ```ts
+ * export const InsufficientFunds = defineError('billing.INSUFFICIENT_FUNDS', {
+ *   status: 402,
+ *   message: ({ available, required }: { available: number, required: number }) =>
+ *     `Insufficient funds: $${available}/$${required}`,
+ * })
+ *
+ * throw InsufficientFunds({ available: 5, required: 100 })
+ * ```
+ */
+declare function defineError<const TCode extends string, const TEntry extends ErrorCatalogEntry>(code: TCode, entry: TEntry): DefinedError<TCode, TEntry>;
+/** Map of error catalog entries keyed by their (UPPER_SNAKE) name. */
+interface ErrorCatalogMap {
+  readonly [key: string]: ErrorCatalogEntry;
+}
+/**
+ * The object returned by {@link defineErrorCatalog}. Each map key becomes a
+ * dot-accessed factory whose `code` is `${prefix}.${key}` (preserved casing).
+ *
+ * Catalog metadata (`_prefix`, `_codes`) is exposed as non-enumerable readonly
+ * properties so it does not pollute iteration but is available for typing
+ * (`declare module 'evlog'`) and runtime introspection.
+ */
+type ErrorCatalog<TPrefix extends string, TMap extends ErrorCatalogMap> = { [K in keyof TMap & string]: DefinedError<`${TPrefix}.${K}`, TMap[K]> } & {
+  readonly _prefix: TPrefix;
+  readonly _codes: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>;
+};
+/**
+ * Define a bundle of errors that share a common prefix. The wire `code` for
+ * each entry is `${prefix}.${KEY}` (the key's casing is preserved — convention
+ * is `UPPER_SNAKE_CASE`).
+ *
+ * Pair with `declare module 'evlog'` to surface autocomplete + literal-typed
+ * `code` everywhere across the codebase.
+ *
+ * @example
+ * ```ts
+ * import { defineErrorCatalog } from 'evlog'
+ *
+ * export const billingErrors = defineErrorCatalog('billing', {
+ *   PAYMENT_DECLINED: { status: 402, message: 'Card declined' },
+ *   INSUFFICIENT_FUNDS: {
+ *     status: 402,
+ *     message: ({ available, required }: { available: number, required: number }) =>
+ *       `Insufficient funds: $${available}/$${required}`,
+ *   },
+ * })
+ *
+ * declare module 'evlog' {
+ *   interface RegisteredErrorCatalogs {
+ *     billing: typeof billingErrors
+ *   }
+ * }
+ *
+ * throw billingErrors.PAYMENT_DECLINED()
+ * throw billingErrors.INSUFFICIENT_FUNDS({ available: 5, required: 100 })
+ * ```
+ */
+declare function defineErrorCatalog<const TPrefix extends string, const TMap extends ErrorCatalogMap>(prefix: TPrefix, map: TMap): ErrorCatalog<TPrefix, TMap>;
+/** Static metadata for a single entry in an audit catalog. */
+interface AuditCatalogEntry {
+  /** Default `target.type` for every audit emitted from this action. */
+  target?: string;
+}
+/** Map of audit catalog entries keyed by their (UPPER_SNAKE) name. */
+interface AuditCatalogMap {
+  readonly [key: string]: AuditCatalogEntry;
+}
+/** A factory produced by an audit catalog entry. Returns an {@link AuditInput}. */
+type DefinedCatalogAudit<TAction extends string, TEntry extends AuditCatalogEntry> = ((input: TEntry['target'] extends string ? Omit<AuditInput, 'action' | 'target'> & {
+  target?: Omit<AuditTarget, 'type'> & {
+    type?: TEntry['target'];
+  };
+} : Omit<AuditInput, 'action'>) => AuditInput) & {
+  readonly action: TAction;
+  readonly target: TEntry['target'];
+};
+/**
+ * The object returned by {@link defineAuditCatalog}. Mirrors
+ * {@link ErrorCatalog} but each factory produces an {@link AuditInput}
+ * (typically passed to `log.audit(...)`).
+ */
+type AuditCatalog<TPrefix extends string, TMap extends AuditCatalogMap> = { [K in keyof TMap & string]: DefinedCatalogAudit<`${TPrefix}.${K}`, TMap[K]> } & {
+  readonly _prefix: TPrefix;
+  readonly _actions: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>;
+};
+/**
+ * Define a bundle of audit actions that share a common prefix. The wire
+ * `action` for each entry is `${prefix}.${KEY}`.
+ *
+ * Each entry produces a thin wrapper around {@link defineAuditAction} (target
+ * type is fixed at definition time, action name is auto-prefixed).
+ *
+ * @example
+ * ```ts
+ * import { defineAuditCatalog } from 'evlog'
+ *
+ * export const billingAudit = defineAuditCatalog('billing', {
+ *   INVOICE_REFUND: { target: 'invoice' },
+ *   INVOICE_CREATE: { target: 'invoice' },
+ * })
+ *
+ * declare module 'evlog' {
+ *   interface RegisteredAuditCatalogs {
+ *     billing: typeof billingAudit
+ *   }
+ * }
+ *
+ * log.audit(billingAudit.INVOICE_REFUND({
+ *   actor: { type: 'user', id: u.id },
+ *   target: { id: 'inv_889' },
+ * }))
+ * ```
+ */
+declare function defineAuditCatalog<const TPrefix extends string, const TMap extends AuditCatalogMap>(prefix: TPrefix, map: TMap): AuditCatalog<TPrefix, TMap>;
+//#endregion
+export { DefinedError as a, ErrorCatalogMap as c, defineAuditCatalog as d, defineError as f, DefinedCatalogAudit as i, ErrorFactoryOpts as l, AuditCatalogEntry as n, ErrorCatalog as o, defineErrorCatalog as p, AuditCatalogMap as r, ErrorCatalogEntry as s, AuditCatalog as t, ErrorFactoryOverrides as u };
+//# sourceMappingURL=index-o1_z4phv.d.mts.map

package/dist/index-o1_z4phv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-o1_z4phv.d.mts","names":[],"sources":["../src/catalog.ts"],"mappings":";;;;;;;;;AAYA;UAAiB,iBAAA;;EAEf,MAAA;EAAA;;;;EAKA,OAAA,aAAoB,MAAA;EAMpB;EAJA,GAAA;EAUA;EARA,GAAA;EAQiB;EANjB,IAAA;EAce;EAZf,IAAA;;;;EAIA,QAAA,GAAW,MAAA;AAAA;;;;;;UAQI,qBAAA;EACf,OAAA;EACA,MAAA;EACA,GAAA;EACA,GAAA;EACA,IAAA;EACA,QAAA,GAAW,MAAA;EACX,KAAA,GAAQ,KAAA;AAAA;;KAIL,aAAA,aAA0B,QAAA,WAAkB,MAAA,wBAA6B,CAAA,GAAI,MAAA;;;;;AAOlF;KAAY,gBAAA,gBAAgC,iBAAA,IAC1C,MAAA,sBAA2B,MAAA,yBACvB,aAAA,CAAc,MAAA,eAAqB,qBAAA,GACnC,qBAAA;;KAGD,WAAA,gBAA2B,iBAAA,IAC9B,MAAA,sBAA2B,MAAA,uBACtB,IAAA,EAAM,gBAAA,CAAiB,MAAA,MACvB,IAAA,GAAO,gBAAA,CAAiB,MAAA;;;;;;;;KASnB,YAAA,sCAAkD,iBAAA,SACrD,IAAA,EAAM,WAAA,CAAY,MAAA,MAAY,UAAA;EAAA,SAE1B,IAAA,EAAM,KAAA;EAAA,SACN,MAAA;EAAA,SACA,OAAA,EAAS,MAAA;EAAA,SACT,GAAA,EAAK,MAAA;EAAA,SACL,GAAA,EAAK,MAAA;EAAA,SACL,IAAA,EAAM,MAAA;EAAA,SACN,IAAA,EAAM,MAAA;EAAA,SACN,QAAA,EAAU,MAAA;AAAA;;AAzBI;;;;;;;;;;;;;;;;;;;;;;;AAe3B;;;;;;;;;iBAyFgB,WAAA,kDAEO,iBAAA,CAAA,CACrB,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,MAAA,GAAS,YAAA,CAAa,KAAA,EAAO,MAAA;;UAmBlC,eAAA;EAAA,UACL,GAAA,WAAc,iBAAA;AAAA;;;;;;;;;KAWd,YAAA,sCAAkD,eAAA,kBAC5C,IAAA,YAAgB,YAAA,IAAgB,OAAA,IAAW,CAAA,IAAK,IAAA,CAAK,CAAA;EAAA,SAE1D,OAAA,EAAS,OAAA;EAAA,SACT,MAAA,EAAQ,aAAA,IAAiB,OAAA,UAAiB,IAAA;AAAA;;;;;;;;;;;;;AAtCvD;;;;;;;;;;;;;;;;;;;iBAwEgB,kBAAA,kDAEK,eAAA,CAAA,CACnB,MAAA,EAAQ,OAAA,EAAS,GAAA,EAAK,IAAA,GAAO,YAAA,CAAa,OAAA,EAAS,IAAA;;UAmBpC,iBAAA;EA3FwC;EA6FvD,MAAA;AAAA;;UAIe,eAAA;EAAA,UACL,GAAA,WAAc,iBAAA;AAAA;;KAId,mBAAA,wCAA2D,iBAAA,MAEnE,KAAA,EAAO,MAAA,4BACH,IAAA,CAAK,UAAA;EAAqC,MAAA,GAAS,IAAA,CAAK,WAAA;IAAyB,IAAA,GAAO,MAAA;EAAA;AAAA,IACxF,IAAA,CAAK,UAAA,gBACN,UAAA;EAAA,SAEM,MAAA,EAAQ,OAAA;EAAA,SACR,MAAA,EAAQ,MAAA;AAAA;;;;;;KAQT,YAAA,sCAAkD,eAAA,kBAC5C,IAAA,YAAgB,mBAAA,IAAuB,OAAA,IAAW,CAAA,IAAK,IAAA,CAAK,CAAA;EAAA,SAEjE,OAAA,EAAS,OAAA;EAAA,SACT,QAAA,EAAU,aAAA,IAAiB,OAAA,UAAiB,IAAA;AAAA;;;;;;;;;;;;;;AArDzD;;;;;;;;;;;;;;;iBAoFgB,kBAAA,kDAEK,eAAA,CAAA,CACnB,MAAA,EAAQ,OAAA,EAAS,GAAA,EAAK,IAAA,GAAO,YAAA,CAAa,OAAA,EAAS,IAAA"}

package/dist/index.d.mts

@@ -1,8 +1,9 @@
-import { $ as SamplingRates, A as AuditFields, B as H3EventContext, C as buildAuditFields, D as withAudit, E as signed, F as DrainContext, G as LoggerConfig, H as InternalFields, I as EnrichContext, K as ParsedError, L as EnvironmentContext, M as AuditTarget, N as BaseWideEvent, O as withAuditMethods, P as DeepPartial, Q as SamplingConfig, R as ErrorOptions, S as auditRedactPreset, T as mockAudit, U as Log, V as IngestPayload, W as LogLevel, X as RequestLoggerOptions, Y as RequestLogger, _ as WithAuditOptions, a as AuditInput, at as ClientLogContext, b as auditEnricher, c as AuditOnlyOptions, ct as PluginSetupContext, d as DefinedAuditAction, et as ServerEvent, f as DrainFn, ft as definePlugin, g as WithAuditContext, h as SignedOptions, i as AuditEnricherOptions, it as WideEvent, j as AuditLoggerMethod, k as AuditActor, l as AuditPatchOp, lt as RequestFinishContext, m as SignedChainState, mt as enricherPlugin, n as AuditDeniedError, nt as TailSamplingContext, o as AuditMatcher, ot as EvlogPlugin, p as MockAudit, pt as drainPlugin, q as RedactConfig, r as AuditDiffOptions, rt as TransportConfig, s as AuditMethod, st as PluginRunner, t as AUDIT_SCHEMA_VERSION, tt as TailSamplingCondition, u as AuditableLogger, ut as RequestLifecycleContext, v as audit, w as defineAuditAction, x as auditOnly, y as auditDiff, z as FieldContext } from "./audit-CJl-wZ10.mjs";
-import { n as createError, t as EvlogError } from "./error-C-66_G2M.mjs";
-import { c as isEnabled, d as shouldKeep, i as getEnvironment, n as createLogger, r as createRequestLogger, s as initLogger, t as _log } from "./logger-Brt5-WMK.mjs";
-import { m as isLevelEnabled } from "./utils-gQCeZMbg.mjs";
-import { t as useLogger } from "./useLogger-Cb1R6bQE.mjs";
-import { t as parseError } from "./parseError-B1zJZvQ5.mjs";
-import { i as toMiddlewareOptions, n as defineEvlog, r as toLoggerConfig, t as EvlogConfig } from "./define-Fp8TrdEB.mjs";
-export { AUDIT_SCHEMA_VERSION, type AuditActor, AuditDeniedError, type AuditDiffOptions, type AuditEnricherOptions, type AuditFields, type AuditInput, type AuditLoggerMethod, type AuditMatcher, type AuditMethod, type AuditOnlyOptions, type AuditPatchOp, type AuditTarget, type AuditableLogger, type BaseWideEvent, type ClientLogContext, type DeepPartial, type DefinedAuditAction, type DrainContext, type DrainFn, type EnrichContext, type EnvironmentContext, type ErrorOptions, type EvlogConfig, EvlogError, type EvlogPlugin, type FieldContext, type H3EventContext, type IngestPayload, type InternalFields, type Log, type LogLevel, type LoggerConfig, type MockAudit, type ParsedError, type PluginRunner, type PluginSetupContext, type RedactConfig, type RequestFinishContext, type RequestLifecycleContext, type RequestLogger, type RequestLoggerOptions, type SamplingConfig, type SamplingRates, type ServerEvent, type SignedChainState, type SignedOptions, type TailSamplingCondition, type TailSamplingContext, type TransportConfig, type WideEvent, type WithAuditContext, type WithAuditOptions, audit, auditDiff, auditEnricher, auditOnly, auditRedactPreset, buildAuditFields, createError, createError as createEvlogError, createLogger, createRequestLogger, defineAuditAction, defineEvlog, definePlugin, drainPlugin, enricherPlugin, getEnvironment, initLogger, isEnabled, isLevelEnabled, _log as log, mockAudit, parseError, shouldKeep, signed, toLoggerConfig, toMiddlewareOptions, useLogger, withAudit, withAuditMethods };
+import { $ as RequestLogger, A as AuditActor, B as ErrorOptions, C as buildAuditFields, D as withAudit, E as signed, F as DeepPartial, G as Log, H as H3EventContext, I as DrainContext, J as ParsedError, K as LogLevel, L as EnrichContext, M as AuditLoggerMethod, N as AuditTarget, O as withAuditMethods, P as BaseWideEvent, R as EnvironmentContext, S as auditRedactPreset, T as mockAudit, U as IngestPayload, V as FieldContext, W as InternalFields, X as RegisteredAuditCatalogs, Y as RedactConfig, Z as RegisteredErrorCatalogs, _ as WithAuditOptions, _t as drainPlugin, a as AuditInput, at as TailSamplingCondition, b as auditEnricher, c as AuditOnlyOptions, ct as WideEvent, d as DefinedAuditAction, dt as PluginRunner, et as RequestLoggerOptions, f as DrainFn, ft as PluginSetupContext, g as WithAuditContext, gt as definePlugin, h as SignedOptions, i as AuditEnricherOptions, it as ServerEvent, j as AuditFields, k as AuditAction, l as AuditPatchOp, lt as ClientLogContext, m as SignedChainState, mt as RequestLifecycleContext, n as AuditDeniedError, nt as SamplingConfig, o as AuditMatcher, ot as TailSamplingContext, p as MockAudit, pt as RequestFinishContext, q as LoggerConfig, r as AuditDiffOptions, rt as SamplingRates, s as AuditMethod, st as TransportConfig, t as AUDIT_SCHEMA_VERSION, u as AuditableLogger, ut as EvlogPlugin, v as audit, vt as enricherPlugin, w as defineAuditAction, x as auditOnly, y as auditDiff, z as ErrorCode } from "./audit-CC8nfazi.mjs";
+import { n as createError, t as EvlogError } from "./error-CpbbtyXL.mjs";
+import { a as DefinedError, c as ErrorCatalogMap, d as defineAuditCatalog, f as defineError, i as DefinedCatalogAudit, l as ErrorFactoryOpts, n as AuditCatalogEntry, o as ErrorCatalog, p as defineErrorCatalog, r as AuditCatalogMap, s as ErrorCatalogEntry, t as AuditCatalog, u as ErrorFactoryOverrides } from "./index-o1_z4phv.mjs";
+import { c as isEnabled, d as shouldKeep, i as getEnvironment, n as createLogger, r as createRequestLogger, s as initLogger, t as _log } from "./logger-DntcxxHg.mjs";
+import { m as isLevelEnabled } from "./utils-DLCeShxL.mjs";
+import { t as useLogger } from "./useLogger-BsPL4AQm.mjs";
+import { t as parseError } from "./parseError-yVZ58wIK.mjs";
+import { i as toMiddlewareOptions, n as defineEvlog, r as toLoggerConfig, t as EvlogConfig } from "./define-MSdhzmXn.mjs";
+export { AUDIT_SCHEMA_VERSION, AuditAction, AuditActor, AuditCatalog, AuditCatalogEntry, AuditCatalogMap, AuditDeniedError, AuditDiffOptions, AuditEnricherOptions, AuditFields, AuditInput, AuditLoggerMethod, AuditMatcher, AuditMethod, AuditOnlyOptions, AuditPatchOp, AuditTarget, AuditableLogger, BaseWideEvent, ClientLogContext, DeepPartial, DefinedAuditAction, DefinedCatalogAudit, DefinedError, DrainContext, DrainFn, EnrichContext, EnvironmentContext, ErrorCatalog, ErrorCatalogEntry, ErrorCatalogMap, ErrorCode, ErrorFactoryOpts, ErrorFactoryOverrides, ErrorOptions, EvlogConfig, EvlogError, EvlogPlugin, FieldContext, H3EventContext, IngestPayload, InternalFields, Log, LogLevel, LoggerConfig, MockAudit, ParsedError, PluginRunner, PluginSetupContext, RedactConfig, RegisteredAuditCatalogs, RegisteredErrorCatalogs, RequestFinishContext, RequestLifecycleContext, RequestLogger, RequestLoggerOptions, SamplingConfig, SamplingRates, ServerEvent, SignedChainState, SignedOptions, TailSamplingCondition, TailSamplingContext, TransportConfig, WideEvent, WithAuditContext, WithAuditOptions, audit, auditDiff, auditEnricher, auditOnly, auditRedactPreset, buildAuditFields, createError, createError as createEvlogError, createLogger, createRequestLogger, defineAuditAction, defineAuditCatalog, defineError, defineErrorCatalog, defineEvlog, definePlugin, drainPlugin, enricherPlugin, getEnvironment, initLogger, isEnabled, isLevelEnabled, _log as log, mockAudit, parseError, shouldKeep, signed, toLoggerConfig, toMiddlewareOptions, useLogger, withAudit, withAuditMethods };

package/dist/index.mjs

@@ -1,7 +1,215 @@
-import { D as drainPlugin, E as definePlugin, O as enricherPlugin, _ as getEnvironment, a as auditEnricher, b as initLogger, c as buildAuditFields, d as signed, f as withAudit, g as createRequestLogger, h as createLogger, i as auditDiff, l as defineAuditAction, m as _log, n as AuditDeniedError, o as auditOnly, p as withAuditMethods, r as audit, s as auditRedactPreset, t as AUDIT_SCHEMA_VERSION, u as mockAudit, w as shouldKeep, x as isEnabled } from "./audit--n0QRR2Y.mjs";
+import { D as drainPlugin, E as definePlugin, O as enricherPlugin, _ as getEnvironment, a as auditEnricher, b as initLogger, c as buildAuditFields, d as signed, f as withAudit, g as createRequestLogger, h as createLogger, i as auditDiff, l as defineAuditAction, m as _log, n as AuditDeniedError, o as auditOnly, p as withAuditMethods, r as audit, s as auditRedactPreset, t as AUDIT_SCHEMA_VERSION, u as mockAudit, w as shouldKeep, x as isEnabled } from "./audit-pV5aLGP0.mjs";
 import { isLevelEnabled } from "./utils.mjs";
 import { EvlogError, createError } from "./error.mjs";
 import { useLogger } from "./runtime/server/useLogger.mjs";
 import { parseError } from "./runtime/utils/parseError.mjs";
 import { n as toLoggerConfig, r as toMiddlewareOptions, t as defineEvlog } from "./define-D6OJdSUH.mjs";
-export { AUDIT_SCHEMA_VERSION, AuditDeniedError, EvlogError, audit, auditDiff, auditEnricher, auditOnly, auditRedactPreset, buildAuditFields, createError, createError as createEvlogError, createLogger, createRequestLogger, defineAuditAction, defineEvlog, definePlugin, drainPlugin, enricherPlugin, getEnvironment, initLogger, isEnabled, isLevelEnabled, _log as log, mockAudit, parseError, shouldKeep, signed, toLoggerConfig, toMiddlewareOptions, useLogger, withAudit, withAuditMethods };
+//#region src/catalog.ts
+function buildEvlogError(code, entry, rawArgs) {
+	const { message: messageOverride, status, why, fix, link, cause, internal: callInternal, ...maybeParams } = rawArgs ?? {};
+	let message;
+	if (typeof messageOverride === "string") message = messageOverride;
+	else if (typeof entry.message === "function") message = entry.message(maybeParams);
+	else ({message} = entry);
+	let internal;
+	if (entry.internal || callInternal) internal = {
+		...entry.internal ?? {},
+		...callInternal ?? {}
+	};
+	return new EvlogError({
+		code,
+		message,
+		status: status ?? entry.status ?? 500,
+		why: why ?? entry.why,
+		fix: fix ?? entry.fix,
+		link: link ?? entry.link,
+		cause,
+		internal
+	});
+}
+/**
+* Define a single, standalone error factory bound to a stable `code`.
+*
+* Each factory produces an {@link EvlogError} with the entry's defaults
+* applied. Call-site overrides (`cause`, `internal`, `message`, ...) are
+* shallow-merged onto those defaults.
+*
+* @example
+* ```ts
+* import { defineError } from 'evlog'
+*
+* export const PaymentDeclined = defineError('billing.PAYMENT_DECLINED', {
+*   status: 402,
+*   message: 'Card declined',
+*   why: 'Issuer declined the charge',
+*   fix: 'Try another card',
+* })
+*
+* throw PaymentDeclined()
+* throw PaymentDeclined({ cause: stripeErr, internal: { ref: 'ch_x' } })
+* ```
+*
+* @example Templated message with typed params
+* ```ts
+* export const InsufficientFunds = defineError('billing.INSUFFICIENT_FUNDS', {
+*   status: 402,
+*   message: ({ available, required }: { available: number, required: number }) =>
+*     `Insufficient funds: $${available}/$${required}`,
+* })
+*
+* throw InsufficientFunds({ available: 5, required: 100 })
+* ```
+*/
+function defineError(code, entry) {
+	const factory = ((...args) => buildEvlogError(code, entry, args[0]));
+	Object.defineProperties(factory, {
+		code: {
+			value: code,
+			enumerable: true
+		},
+		status: {
+			value: entry.status ?? 500,
+			enumerable: true
+		},
+		message: {
+			value: entry.message,
+			enumerable: true
+		},
+		why: {
+			value: entry.why,
+			enumerable: true
+		},
+		fix: {
+			value: entry.fix,
+			enumerable: true
+		},
+		link: {
+			value: entry.link,
+			enumerable: true
+		},
+		tags: {
+			value: entry.tags,
+			enumerable: true
+		},
+		internal: {
+			value: entry.internal,
+			enumerable: true
+		}
+	});
+	return factory;
+}
+/**
+* Define a bundle of errors that share a common prefix. The wire `code` for
+* each entry is `${prefix}.${KEY}` (the key's casing is preserved — convention
+* is `UPPER_SNAKE_CASE`).
+*
+* Pair with `declare module 'evlog'` to surface autocomplete + literal-typed
+* `code` everywhere across the codebase.
+*
+* @example
+* ```ts
+* import { defineErrorCatalog } from 'evlog'
+*
+* export const billingErrors = defineErrorCatalog('billing', {
+*   PAYMENT_DECLINED: { status: 402, message: 'Card declined' },
+*   INSUFFICIENT_FUNDS: {
+*     status: 402,
+*     message: ({ available, required }: { available: number, required: number }) =>
+*       `Insufficient funds: $${available}/$${required}`,
+*   },
+* })
+*
+* declare module 'evlog' {
+*   interface RegisteredErrorCatalogs {
+*     billing: typeof billingErrors
+*   }
+* }
+*
+* throw billingErrors.PAYMENT_DECLINED()
+* throw billingErrors.INSUFFICIENT_FUNDS({ available: 5, required: 100 })
+* ```
+*/
+function defineErrorCatalog(prefix, map) {
+	const out = {};
+	const codes = [];
+	for (const key of Object.keys(map)) {
+		const code = `${prefix}.${key}`;
+		out[key] = defineError(code, map[key]);
+		codes.push(code);
+	}
+	Object.defineProperties(out, {
+		_prefix: {
+			value: prefix,
+			enumerable: false
+		},
+		_codes: {
+			value: Object.freeze(codes),
+			enumerable: false
+		}
+	});
+	return out;
+}
+/**
+* Define a bundle of audit actions that share a common prefix. The wire
+* `action` for each entry is `${prefix}.${KEY}`.
+*
+* Each entry produces a thin wrapper around {@link defineAuditAction} (target
+* type is fixed at definition time, action name is auto-prefixed).
+*
+* @example
+* ```ts
+* import { defineAuditCatalog } from 'evlog'
+*
+* export const billingAudit = defineAuditCatalog('billing', {
+*   INVOICE_REFUND: { target: 'invoice' },
+*   INVOICE_CREATE: { target: 'invoice' },
+* })
+*
+* declare module 'evlog' {
+*   interface RegisteredAuditCatalogs {
+*     billing: typeof billingAudit
+*   }
+* }
+*
+* log.audit(billingAudit.INVOICE_REFUND({
+*   actor: { type: 'user', id: u.id },
+*   target: { id: 'inv_889' },
+* }))
+* ```
+*/
+function defineAuditCatalog(prefix, map) {
+	const out = {};
+	const actions = [];
+	for (const key of Object.keys(map)) {
+		const action = `${prefix}.${key}`;
+		const entry = map[key];
+		const fn = defineAuditAction(action, entry.target ? { target: entry.target } : void 0);
+		Object.defineProperties(fn, {
+			action: {
+				value: action,
+				enumerable: true
+			},
+			target: {
+				value: entry.target,
+				enumerable: true
+			}
+		});
+		out[key] = fn;
+		actions.push(action);
+	}
+	Object.defineProperties(out, {
+		_prefix: {
+			value: prefix,
+			enumerable: false
+		},
+		_actions: {
+			value: Object.freeze(actions),
+			enumerable: false
+		}
+	});
+	return out;
+}
+//#endregion
+export { AUDIT_SCHEMA_VERSION, AuditDeniedError, EvlogError, audit, auditDiff, auditEnricher, auditOnly, auditRedactPreset, buildAuditFields, createError, createError as createEvlogError, createLogger, createRequestLogger, defineAuditAction, defineAuditCatalog, defineError, defineErrorCatalog, defineEvlog, definePlugin, drainPlugin, enricherPlugin, getEnvironment, initLogger, isEnabled, isLevelEnabled, _log as log, mockAudit, parseError, shouldKeep, signed, toLoggerConfig, toMiddlewareOptions, useLogger, withAudit, withAuditMethods };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import type { AuditInput } from './audit'\nimport type { AuditTarget } from './types'\nimport { defineAuditAction } from './audit'\nimport { EvlogError } from './error'\n\n/**\n * Static metadata for a single entry in an error catalog.\n *\n * `message` is either a constant string or a function that receives required\n * params at the call site (typed). All other fields are templated defaults\n * that can be overridden at the call site.\n */\nexport interface ErrorCatalogEntry {\n  /** HTTP status code (default: 500). */\n  status?: number\n  /**\n   * Either a constant string or a typed function whose params become required\n   * arguments at the call site (`factory({ available, required })`).\n   */\n  message: string | ((params: never) => string)\n  /** Why this error occurred (technical reason). */\n  why?: string\n  /** Actionable fix shown to the user. */\n  fix?: string\n  /** Link to documentation. */\n  link?: string\n  /** Free-form metadata for grouping / filtering (not surfaced on the wire). */\n  tags?: readonly string[]\n  /**\n   * Backend-only context defaults. Merged with call-site `internal` (call-site wins).\n   */\n  internal?: Record<string, unknown>\n}\n\n/**\n * Subset of {@link import('./types').ErrorOptions} that callers may override\n * when invoking a catalog factory. `code` is always derived from the catalog\n * and intentionally excluded — pass `cause` here for error chaining.\n */\nexport interface ErrorFactoryOverrides {\n  message?: string\n  status?: number\n  why?: string\n  fix?: string\n  link?: string\n  internal?: Record<string, unknown>\n  cause?: Error\n}\n\n/** @internal Extract the params object type from a templated message function. */\ntype MessageParams<TMessage> = TMessage extends (params: infer P) => string ? P : Record<string, never>\n\n/**\n * Call-site argument type for a catalog factory:\n * - if `message` is a function: required params object merged with overrides\n * - if `message` is a string: optional overrides only\n */\nexport type ErrorFactoryOpts<TEntry extends ErrorCatalogEntry> =\n  TEntry['message'] extends (params: infer _P) => string\n    ? MessageParams<TEntry['message']> & ErrorFactoryOverrides\n    : ErrorFactoryOverrides\n\n/** @internal When message is a string, the call-site argument is optional. */\ntype FactoryArgs<TEntry extends ErrorCatalogEntry> =\n  TEntry['message'] extends (params: never) => string\n    ? [opts: ErrorFactoryOpts<TEntry>]\n    : [opts?: ErrorFactoryOpts<TEntry>]\n\n/**\n * A factory produced by {@link defineError} or each entry of\n * {@link defineErrorCatalog}. Calling it returns a fully-formed\n * {@link EvlogError} with the catalog's defaults applied. Static metadata\n * is exposed as readonly properties for introspection / refactor-safe\n * comparisons (`err.code === MyError.code`).\n */\nexport type DefinedError<TCode extends string, TEntry extends ErrorCatalogEntry> =\n  & ((...args: FactoryArgs<TEntry>) => EvlogError)\n  & {\n    readonly code: TCode\n    readonly status: number\n    readonly message: TEntry['message']\n    readonly why: TEntry['why']\n    readonly fix: TEntry['fix']\n    readonly link: TEntry['link']\n    readonly tags: TEntry['tags']\n    readonly internal: TEntry['internal']\n  }\n\nfunction buildEvlogError(\n  code: string,\n  entry: ErrorCatalogEntry,\n  rawArgs: Record<string, unknown> | undefined,\n): EvlogError {\n  const args = rawArgs ?? {}\n  const {\n    message: messageOverride,\n    status,\n    why,\n    fix,\n    link,\n    cause,\n    internal: callInternal,\n    ...maybeParams\n  } = args as ErrorFactoryOverrides & Record<string, unknown>\n\n  let message: string\n  if (typeof messageOverride === 'string') {\n    message = messageOverride\n  } else if (typeof entry.message === 'function') {\n    message = (entry.message as (p: unknown) => string)(maybeParams)\n  } else {\n    ({ message } = entry as { message: string })\n  }\n\n  let internal: Record<string, unknown> | undefined\n  if (entry.internal || callInternal) {\n    internal = { ...(entry.internal ?? {}), ...(callInternal ?? {}) }\n  }\n\n  return new EvlogError({\n    code,\n    message,\n    status: status ?? entry.status ?? 500,\n    why: why ?? entry.why,\n    fix: fix ?? entry.fix,\n    link: link ?? entry.link,\n    cause: cause as Error | undefined,\n    internal,\n  })\n}\n\n/**\n * Define a single, standalone error factory bound to a stable `code`.\n *\n * Each factory produces an {@link EvlogError} with the entry's defaults\n * applied. Call-site overrides (`cause`, `internal`, `message`, ...) are\n * shallow-merged onto those defaults.\n *\n * @example\n * ```ts\n * import { defineError } from 'evlog'\n *\n * export const PaymentDeclined = defineError('billing.PAYMENT_DECLINED', {\n *   status: 402,\n *   message: 'Card declined',\n *   why: 'Issuer declined the charge',\n *   fix: 'Try another card',\n * })\n *\n * throw PaymentDeclined()\n * throw PaymentDeclined({ cause: stripeErr, internal: { ref: 'ch_x' } })\n * ```\n *\n * @example Templated message with typed params\n * ```ts\n * export const InsufficientFunds = defineError('billing.INSUFFICIENT_FUNDS', {\n *   status: 402,\n *   message: ({ available, required }: { available: number, required: number }) =>\n *     `Insufficient funds: $${available}/$${required}`,\n * })\n *\n * throw InsufficientFunds({ available: 5, required: 100 })\n * ```\n */\nexport function defineError<\n  const TCode extends string,\n  const TEntry extends ErrorCatalogEntry,\n>(code: TCode, entry: TEntry): DefinedError<TCode, TEntry> {\n  const factory = ((...args: unknown[]) =>\n    buildEvlogError(code, entry, args[0] as Record<string, unknown> | undefined)) as DefinedError<TCode, TEntry>\n\n  Object.defineProperties(factory, {\n    code: { value: code, enumerable: true },\n    status: { value: entry.status ?? 500, enumerable: true },\n    message: { value: entry.message, enumerable: true },\n    why: { value: entry.why, enumerable: true },\n    fix: { value: entry.fix, enumerable: true },\n    link: { value: entry.link, enumerable: true },\n    tags: { value: entry.tags, enumerable: true },\n    internal: { value: entry.internal, enumerable: true },\n  })\n\n  return factory\n}\n\n/** Map of error catalog entries keyed by their (UPPER_SNAKE) name. */\nexport interface ErrorCatalogMap {\n  readonly [key: string]: ErrorCatalogEntry\n}\n\n/**\n * The object returned by {@link defineErrorCatalog}. Each map key becomes a\n * dot-accessed factory whose `code` is `${prefix}.${key}` (preserved casing).\n *\n * Catalog metadata (`_prefix`, `_codes`) is exposed as non-enumerable readonly\n * properties so it does not pollute iteration but is available for typing\n * (`declare module 'evlog'`) and runtime introspection.\n */\nexport type ErrorCatalog<TPrefix extends string, TMap extends ErrorCatalogMap> =\n  & { [K in keyof TMap & string]: DefinedError<`${TPrefix}.${K}`, TMap[K]> }\n  & {\n    readonly _prefix: TPrefix\n    readonly _codes: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>\n  }\n\n/**\n * Define a bundle of errors that share a common prefix. The wire `code` for\n * each entry is `${prefix}.${KEY}` (the key's casing is preserved — convention\n * is `UPPER_SNAKE_CASE`).\n *\n * Pair with `declare module 'evlog'` to surface autocomplete + literal-typed\n * `code` everywhere across the codebase.\n *\n * @example\n * ```ts\n * import { defineErrorCatalog } from 'evlog'\n *\n * export const billingErrors = defineErrorCatalog('billing', {\n *   PAYMENT_DECLINED: { status: 402, message: 'Card declined' },\n *   INSUFFICIENT_FUNDS: {\n *     status: 402,\n *     message: ({ available, required }: { available: number, required: number }) =>\n *       `Insufficient funds: $${available}/$${required}`,\n *   },\n * })\n *\n * declare module 'evlog' {\n *   interface RegisteredErrorCatalogs {\n *     billing: typeof billingErrors\n *   }\n * }\n *\n * throw billingErrors.PAYMENT_DECLINED()\n * throw billingErrors.INSUFFICIENT_FUNDS({ available: 5, required: 100 })\n * ```\n */\nexport function defineErrorCatalog<\n  const TPrefix extends string,\n  const TMap extends ErrorCatalogMap,\n>(prefix: TPrefix, map: TMap): ErrorCatalog<TPrefix, TMap> {\n  const out: Record<string, unknown> = {}\n  const codes: string[] = []\n\n  for (const key of Object.keys(map)) {\n    const code = `${prefix}.${key}`\n    out[key] = defineError(code, map[key])\n    codes.push(code)\n  }\n\n  Object.defineProperties(out, {\n    _prefix: { value: prefix, enumerable: false },\n    _codes: { value: Object.freeze(codes), enumerable: false },\n  })\n\n  return out as ErrorCatalog<TPrefix, TMap>\n}\n\n/** Static metadata for a single entry in an audit catalog. */\nexport interface AuditCatalogEntry {\n  /** Default `target.type` for every audit emitted from this action. */\n  target?: string\n}\n\n/** Map of audit catalog entries keyed by their (UPPER_SNAKE) name. */\nexport interface AuditCatalogMap {\n  readonly [key: string]: AuditCatalogEntry\n}\n\n/** A factory produced by an audit catalog entry. Returns an {@link AuditInput}. */\nexport type DefinedCatalogAudit<TAction extends string, TEntry extends AuditCatalogEntry> =\n  & ((\n    input: TEntry['target'] extends string\n      ? Omit<AuditInput, 'action' | 'target'> & { target?: Omit<AuditTarget, 'type'> & { type?: TEntry['target'] } }\n      : Omit<AuditInput, 'action'>,\n  ) => AuditInput)\n  & {\n    readonly action: TAction\n    readonly target: TEntry['target']\n  }\n\n/**\n * The object returned by {@link defineAuditCatalog}. Mirrors\n * {@link ErrorCatalog} but each factory produces an {@link AuditInput}\n * (typically passed to `log.audit(...)`).\n */\nexport type AuditCatalog<TPrefix extends string, TMap extends AuditCatalogMap> =\n  & { [K in keyof TMap & string]: DefinedCatalogAudit<`${TPrefix}.${K}`, TMap[K]> }\n  & {\n    readonly _prefix: TPrefix\n    readonly _actions: ReadonlyArray<`${TPrefix}.${keyof TMap & string}`>\n  }\n\n/**\n * Define a bundle of audit actions that share a common prefix. The wire\n * `action` for each entry is `${prefix}.${KEY}`.\n *\n * Each entry produces a thin wrapper around {@link defineAuditAction} (target\n * type is fixed at definition time, action name is auto-prefixed).\n *\n * @example\n * ```ts\n * import { defineAuditCatalog } from 'evlog'\n *\n * export const billingAudit = defineAuditCatalog('billing', {\n *   INVOICE_REFUND: { target: 'invoice' },\n *   INVOICE_CREATE: { target: 'invoice' },\n * })\n *\n * declare module 'evlog' {\n *   interface RegisteredAuditCatalogs {\n *     billing: typeof billingAudit\n *   }\n * }\n *\n * log.audit(billingAudit.INVOICE_REFUND({\n *   actor: { type: 'user', id: u.id },\n *   target: { id: 'inv_889' },\n * }))\n * ```\n */\nexport function defineAuditCatalog<\n  const TPrefix extends string,\n  const TMap extends AuditCatalogMap,\n>(prefix: TPrefix, map: TMap): AuditCatalog<TPrefix, TMap> {\n  const out: Record<string, unknown> = {}\n  const actions: string[] = []\n\n  for (const key of Object.keys(map)) {\n    const action = `${prefix}.${key}`\n    const entry = map[key]\n    const fn = defineAuditAction(action, entry.target ? { target: entry.target } : undefined) as ((input: unknown) => AuditInput) & { action: string, target?: string }\n    Object.defineProperties(fn, {\n      action: { value: action, enumerable: true },\n      target: { value: entry.target, enumerable: true },\n    })\n    out[key] = fn\n    actions.push(action)\n  }\n\n  Object.defineProperties(out, {\n    _prefix: { value: prefix, enumerable: false },\n    _actions: { value: Object.freeze(actions), enumerable: false },\n  })\n\n  return out as AuditCatalog<TPrefix, TMap>\n}\n"],"mappings":";;;;;;;AAwFA,SAAS,gBACP,MACA,OACA,SACY;CAEZ,MAAM,EACJ,SAAS,iBACT,QACA,KACA,KACA,MACA,OACA,UAAU,cACV,GAAG,gBATQ,WAAW,EAAE;CAY1B,IAAI;AACJ,KAAI,OAAO,oBAAoB,SAC7B,WAAU;UACD,OAAO,MAAM,YAAY,WAClC,WAAW,MAAM,QAAmC,YAAY;KAEhE,EAAC,CAAE,WAAY;CAGjB,IAAI;AACJ,KAAI,MAAM,YAAY,aACpB,YAAW;EAAE,GAAI,MAAM,YAAY,EAAE;EAAG,GAAI,gBAAgB,EAAE;EAAG;AAGnE,QAAO,IAAI,WAAW;EACpB;EACA;EACA,QAAQ,UAAU,MAAM,UAAU;EAClC,KAAK,OAAO,MAAM;EAClB,KAAK,OAAO,MAAM;EAClB,MAAM,QAAQ,MAAM;EACb;EACP;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCJ,SAAgB,YAGd,MAAa,OAA4C;CACzD,MAAM,YAAY,GAAG,SACnB,gBAAgB,MAAM,OAAO,KAAK,GAA0C;AAE9E,QAAO,iBAAiB,SAAS;EAC/B,MAAM;GAAE,OAAO;GAAM,YAAY;GAAM;EACvC,QAAQ;GAAE,OAAO,MAAM,UAAU;GAAK,YAAY;GAAM;EACxD,SAAS;GAAE,OAAO,MAAM;GAAS,YAAY;GAAM;EACnD,KAAK;GAAE,OAAO,MAAM;GAAK,YAAY;GAAM;EAC3C,KAAK;GAAE,OAAO,MAAM;GAAK,YAAY;GAAM;EAC3C,MAAM;GAAE,OAAO,MAAM;GAAM,YAAY;GAAM;EAC7C,MAAM;GAAE,OAAO,MAAM;GAAM,YAAY;GAAM;EAC7C,UAAU;GAAE,OAAO,MAAM;GAAU,YAAY;GAAM;EACtD,CAAC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDT,SAAgB,mBAGd,QAAiB,KAAwC;CACzD,MAAM,MAA+B,EAAE;CACvC,MAAM,QAAkB,EAAE;AAE1B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,EAAE;EAClC,MAAM,OAAO,GAAG,OAAO,GAAG;AAC1B,MAAI,OAAO,YAAY,MAAM,IAAI,KAAK;AACtC,QAAM,KAAK,KAAK;;AAGlB,QAAO,iBAAiB,KAAK;EAC3B,SAAS;GAAE,OAAO;GAAQ,YAAY;GAAO;EAC7C,QAAQ;GAAE,OAAO,OAAO,OAAO,MAAM;GAAE,YAAY;GAAO;EAC3D,CAAC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkET,SAAgB,mBAGd,QAAiB,KAAwC;CACzD,MAAM,MAA+B,EAAE;CACvC,MAAM,UAAoB,EAAE;AAE5B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,EAAE;EAClC,MAAM,SAAS,GAAG,OAAO,GAAG;EAC5B,MAAM,QAAQ,IAAI;EAClB,MAAM,KAAK,kBAAkB,QAAQ,MAAM,SAAS,EAAE,QAAQ,MAAM,QAAQ,GAAG,KAAA,EAAU;AACzF,SAAO,iBAAiB,IAAI;GAC1B,QAAQ;IAAE,OAAO;IAAQ,YAAY;IAAM;GAC3C,QAAQ;IAAE,OAAO,MAAM;IAAQ,YAAY;IAAM;GAClD,CAAC;AACF,MAAI,OAAO;AACX,UAAQ,KAAK,OAAO;;AAGtB,QAAO,iBAAiB,KAAK;EAC3B,SAAS;GAAE,OAAO;GAAQ,YAAY;GAAO;EAC7C,UAAU;GAAE,OAAO,OAAO,OAAO,QAAQ;GAAE,YAAY;GAAO;EAC/D,CAAC;AAEF,QAAO"}