autotel 3.5.0 → 3.7.0

package/dist/metric.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"metric.js"}
+{"version":3,"file":"metric.js","names":[],"sources":["../src/metric.ts"],"sourcesContent":["/**\n * Metrics API for OpenTelemetry\n *\n * Track business metrics for OpenTelemetry (Prometheus/Grafana).\n * For business people who think in metrics.\n *\n * @example Track business metrics\n * ```typescript\n * const metrics = new Metric('checkout')\n *\n * // Track events as metrics\n * metrics.trackEvent('order.completed', {\n *   amount: 99.99,\n *   currency: 'USD'\n * })\n *\n * // Track conversion funnels\n * metrics.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })\n * metrics.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })\n *\n * // Track outcomes\n * metrics.trackOutcome('payment.process', 'success', { amount: 99.99 })\n * metrics.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })\n *\n * // Track values\n * metrics.trackValue('revenue', 149.99, { currency: 'USD' })\n * ```\n */\n\nimport {\n  type Counter,\n  type Histogram,\n  type Attributes,\n} from '@opentelemetry/api';\nimport { getConfig } from './config';\nimport { type Logger } from './logger';\nimport {\n  type EventAttributes,\n  type FunnelStatus,\n  type OutcomeStatus,\n} from './event-subscriber';\nimport { type MetricsCollector } from './metric-testing';\n\n// Re-export types for convenience\nexport type {\n  EventAttributes,\n  FunnelStatus,\n  OutcomeStatus,\n} from './event-subscriber';\n\n/**\n * Metrics class for tracking business metrics in OpenTelemetry\n *\n * Track critical business indicators such as:\n * - User events (signups, purchases, feature usage) as metrics\n * - Conversion funnels (signup → activation → purchase)\n * - Business outcomes (success/failure rates)\n * - Value metrics (revenue, counts, etc.)\n *\n * All metrics are sent to OpenTelemetry (OTLP/Prometheus/Grafana).\n */\n/**\n * Metric configuration for customizing metric names and descriptions\n */\nexport interface MetricConfig {\n  /** Metric name (e.g., 'metrics.events' or 'custom.events') */\n  name?: string;\n  /** Metric description */\n  description?: string;\n  /** Metric unit (default: '1') */\n  unit?: string;\n}\n\n/**\n * Metrics options\n */\nexport interface MetricsOptions {\n  /** Optional logger for audit trail */\n  logger?: Logger;\n  /** Optional collector for testing (captures metrics in memory) */\n  collector?: MetricsCollector;\n\n  /**\n   * Namespace for metrics (default: 'metrics')\n   * Results in metrics like: {serviceName}.{namespace}.events\n   */\n  namespace?: string;\n\n  /**\n   * Custom metric configurations\n   * Override metric names, descriptions, and units\n   */\n  metrics?: {\n    events?: MetricConfig;\n    funnel?: MetricConfig;\n    outcomes?: MetricConfig;\n    value?: MetricConfig;\n  };\n}\n\nexport class Metric {\n  private serviceName: string;\n  private eventCounter: Counter;\n  private funnelCounter: Counter;\n  private outcomeCounter: Counter;\n  private valueHistogram: Histogram;\n  private logger?: Logger;\n  private collector?: MetricsCollector;\n\n  /**\n   * Create a new Metrics instance\n   *\n   * @param serviceName - Service name for metric namespacing\n   * @param options - Optional configuration (logger, collector, namespace, metrics)\n   *\n   * @example Basic usage (default 'metrics' namespace)\n   * ```typescript\n   * const metrics = new Metric('checkout');\n   * // Creates: checkout.metrics.events, checkout.metrics.funnel, etc.\n   * ```\n   *\n   * @example Custom namespace\n   * ```typescript\n   * const metrics = new Metric('api', { namespace: 'business' });\n   * // Creates: api.business.events, api.business.funnel, etc.\n   * ```\n   *\n   * @example Custom metric names and descriptions\n   * ```typescript\n   * const metrics = new Metric('payments', {\n   *   metrics: {\n   *     outcomes: {\n   *       name: 'payments.transactions',\n   *       description: 'Payment transaction outcomes',\n   *       unit: 'transactions'\n   *     },\n   *     value: {\n   *       name: 'payments.revenue',\n   *       description: 'Payment revenue in USD',\n   *       unit: 'USD'\n   *     }\n   *   }\n   * });\n   * ```\n   */\n  constructor(serviceName: string, options: MetricsOptions = {}) {\n    this.serviceName = serviceName;\n    this.logger = options.logger;\n    this.collector = options.collector;\n\n    const config = getConfig();\n    const meter = config.meter;\n\n    // Default namespace and metric configurations\n    const namespace = options.namespace || 'metrics';\n    const metricsConfig = options.metrics || {};\n\n    // Event counter configuration\n    const eventsConfig = metricsConfig.events || {};\n    this.eventCounter = meter.createCounter(\n      eventsConfig.name || `${serviceName}.${namespace}.events`,\n      {\n        description: eventsConfig.description || 'Count of business events',\n        unit: eventsConfig.unit || '1',\n      },\n    );\n\n    // Funnel counter configuration\n    const funnelConfig = metricsConfig.funnel || {};\n    this.funnelCounter = meter.createCounter(\n      funnelConfig.name || `${serviceName}.${namespace}.funnel`,\n      {\n        description: funnelConfig.description || 'Conversion funnel tracking',\n        unit: funnelConfig.unit || '1',\n      },\n    );\n\n    // Outcome counter configuration\n    const outcomesConfig = metricsConfig.outcomes || {};\n    this.outcomeCounter = meter.createCounter(\n      outcomesConfig.name || `${serviceName}.${namespace}.outcomes`,\n      {\n        description:\n          outcomesConfig.description || 'Outcome tracking (success/failure)',\n        unit: outcomesConfig.unit || '1',\n      },\n    );\n\n    // Value histogram configuration\n    const valueConfig = metricsConfig.value || {};\n    this.valueHistogram = meter.createHistogram(\n      valueConfig.name || `${serviceName}.${namespace}.value`,\n      {\n        description:\n          valueConfig.description || 'Value metrics (revenue, counts, etc.)',\n        unit: valueConfig.unit || '1',\n      },\n    );\n  }\n\n  /**\n   * Track a business event as a metric\n   *\n   * Use this for tracking user actions, business events, product usage as metrics:\n   * - \"user.signup\"\n   * - \"order.completed\"\n   * - \"feature.used\"\n   *\n   * @example\n   * ```typescript\n   * // Track user signup as metric\n   * metrics.trackEvent('user.signup', {\n   *   userId: '123',\n   *   plan: 'pro'\n   * })\n   *\n   * // Track order as metric\n   * metrics.trackEvent('order.completed', {\n   *   orderId: 'ord_123',\n   *   amount: 99.99\n   * })\n   * ```\n   */\n  trackEvent(eventName: string, attributes?: EventAttributes): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      event: eventName,\n      ...attributes,\n    };\n\n    this.eventCounter.add(1, attrs);\n\n    this.logger?.info(\n      {\n        event: eventName,\n        attributes,\n      },\n      'Metric event tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordEvent({\n      event: eventName,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Track conversion funnel steps as metrics\n   *\n   * Monitor where users drop off in multi-step processes.\n   *\n   * @example\n   * ```typescript\n   * // Track signup funnel\n   * metrics.trackFunnelStep('signup', 'started', { userId: '123' })\n   * metrics.trackFunnelStep('signup', 'email_verified', { userId: '123' })\n   * metrics.trackFunnelStep('signup', 'completed', { userId: '123' })\n   *\n   * // Track checkout flow\n   * metrics.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })\n   * metrics.trackFunnelStep('checkout', 'payment_info', { cartValue: 99.99 })\n   * metrics.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })\n   * ```\n   */\n  trackFunnelStep(\n    funnelName: string,\n    status: FunnelStatus,\n    attributes?: EventAttributes,\n  ): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      funnel: funnelName,\n      status,\n      ...attributes,\n    };\n\n    this.funnelCounter.add(1, attrs);\n\n    this.logger?.info(\n      {\n        funnel: funnelName,\n        status,\n        attributes,\n      },\n      'Funnel step tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordFunnelStep({\n      funnel: funnelName,\n      status,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Track outcomes (success/failure/partial) as metrics\n   *\n   * Monitor success rates of critical operations.\n   *\n   * @example\n   * ```typescript\n   * // Track email delivery\n   * metrics.trackOutcome('email.delivery', 'success', {\n   *   recipientType: 'user',\n   *   emailType: 'welcome'\n   * })\n   *\n   * metrics.trackOutcome('email.delivery', 'failure', {\n   *   recipientType: 'user',\n   *   errorCode: 'invalid_email'\n   * })\n   *\n   * // Track payment processing\n   * metrics.trackOutcome('payment.process', 'success', { amount: 99.99 })\n   * metrics.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })\n   * ```\n   */\n  trackOutcome(\n    operationName: string,\n    status: OutcomeStatus,\n    attributes?: EventAttributes,\n  ): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      operation: operationName,\n      status,\n      ...attributes,\n    };\n\n    this.outcomeCounter.add(1, attrs);\n\n    this.logger?.info(\n      {\n        operation: operationName,\n        status,\n        attributes,\n      },\n      'Outcome tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordOutcome({\n      operation: operationName,\n      status,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Track value metrics\n   *\n   * Record numerical values like revenue, transaction amounts,\n   * item counts, processing times, engagement scores, etc.\n   *\n   * @example\n   * ```typescript\n   * // Track revenue\n   * metrics.trackValue('order.revenue', 149.99, {\n   *   currency: 'USD',\n   *   productCategory: 'electronics'\n   * })\n   *\n   * // Track items per cart\n   * metrics.trackValue('cart.item_count', 5, {\n   *   userId: '123'\n   * })\n   *\n   * // Track processing time\n   * metrics.trackValue('api.response_time', 250, {\n   *   unit: 'ms',\n   *   endpoint: '/api/checkout'\n   * })\n   * ```\n   */\n  trackValue(\n    metricName: string,\n    value: number,\n    attributes?: EventAttributes,\n  ): void {\n    const attrs: Attributes = {\n      service: this.serviceName,\n      metric: metricName,\n      ...attributes,\n    };\n\n    this.valueHistogram.record(value, attrs);\n\n    this.logger?.debug(\n      {\n        metric: metricName,\n        value,\n        attributes,\n      },\n      'Value metric tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordValue({\n      metric: metricName,\n      value,\n      attributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n  }\n}\n\n/**\n * Global metrics instances (singleton pattern)\n */\nconst metricsInstances = new Map<string, Metric>();\n\n/**\n * Get or create a Metrics instance for a service\n *\n * @param serviceName - Service name for metric namespacing\n * @param logger - Optional logger\n * @returns Metrics instance\n *\n * @example\n * ```typescript\n * const metrics = getMetrics('checkout')\n * metrics.trackEvent('order.completed', { orderId: '123' })\n * ```\n */\nexport function getMetrics(serviceName: string, logger?: Logger): Metric {\n  if (!metricsInstances.has(serviceName)) {\n    metricsInstances.set(serviceName, new Metric(serviceName, { logger }));\n  }\n  return metricsInstances.get(serviceName)!;\n}\n\n/**\n * Reset all metrics instances (mainly for testing)\n */\nexport function resetMetrics(): void {\n  metricsInstances.clear();\n}\n"],"mappings":";;;;AAoGA,IAAa,SAAb,MAAoB;CAClB,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCR,YAAY,aAAqB,UAA0B,CAAC,GAAG;EAC7D,KAAK,cAAc;EACnB,KAAK,SAAS,QAAQ;EACtB,KAAK,YAAY,QAAQ;EAGzB,MAAM,QADS,UACI,CAAC,CAAC;EAGrB,MAAM,YAAY,QAAQ,aAAa;EACvC,MAAM,gBAAgB,QAAQ,WAAW,CAAC;EAG1C,MAAM,eAAe,cAAc,UAAU,CAAC;EAC9C,KAAK,eAAe,MAAM,cACxB,aAAa,QAAQ,GAAG,YAAY,GAAG,UAAU,UACjD;GACE,aAAa,aAAa,eAAe;GACzC,MAAM,aAAa,QAAQ;EAC7B,CACF;EAGA,MAAM,eAAe,cAAc,UAAU,CAAC;EAC9C,KAAK,gBAAgB,MAAM,cACzB,aAAa,QAAQ,GAAG,YAAY,GAAG,UAAU,UACjD;GACE,aAAa,aAAa,eAAe;GACzC,MAAM,aAAa,QAAQ;EAC7B,CACF;EAGA,MAAM,iBAAiB,cAAc,YAAY,CAAC;EAClD,KAAK,iBAAiB,MAAM,cAC1B,eAAe,QAAQ,GAAG,YAAY,GAAG,UAAU,YACnD;GACE,aACE,eAAe,eAAe;GAChC,MAAM,eAAe,QAAQ;EAC/B,CACF;EAGA,MAAM,cAAc,cAAc,SAAS,CAAC;EAC5C,KAAK,iBAAiB,MAAM,gBAC1B,YAAY,QAAQ,GAAG,YAAY,GAAG,UAAU,SAChD;GACE,aACE,YAAY,eAAe;GAC7B,MAAM,YAAY,QAAQ;EAC5B,CACF;CACF;;;;;;;;;;;;;;;;;;;;;;;;CAyBA,WAAW,WAAmB,YAAoC;EAChE,MAAM,QAAoB;GACxB,SAAS,KAAK;GACd,OAAO;GACP,GAAG;EACL;EAEA,KAAK,aAAa,IAAI,GAAG,KAAK;EAE9B,KAAK,QAAQ,KACX;GACE,OAAO;GACP;EACF,GACA,sBACF;EAGA,KAAK,WAAW,YAAY;GAC1B,OAAO;GACP;GACA,SAAS,KAAK;GACd,WAAW,KAAK,IAAI;EACtB,CAAC;CACH;;;;;;;;;;;;;;;;;;;CAoBA,gBACE,YACA,QACA,YACM;EACN,MAAM,QAAoB;GACxB,SAAS,KAAK;GACd,QAAQ;GACR;GACA,GAAG;EACL;EAEA,KAAK,cAAc,IAAI,GAAG,KAAK;EAE/B,KAAK,QAAQ,KACX;GACE,QAAQ;GACR;GACA;EACF,GACA,qBACF;EAGA,KAAK,WAAW,iBAAiB;GAC/B,QAAQ;GACR;GACA;GACA,SAAS,KAAK;GACd,WAAW,KAAK,IAAI;EACtB,CAAC;CACH;;;;;;;;;;;;;;;;;;;;;;;;CAyBA,aACE,eACA,QACA,YACM;EACN,MAAM,QAAoB;GACxB,SAAS,KAAK;GACd,WAAW;GACX;GACA,GAAG;EACL;EAEA,KAAK,eAAe,IAAI,GAAG,KAAK;EAEhC,KAAK,QAAQ,KACX;GACE,WAAW;GACX;GACA;EACF,GACA,iBACF;EAGA,KAAK,WAAW,cAAc;GAC5B,WAAW;GACX;GACA;GACA,SAAS,KAAK;GACd,WAAW,KAAK,IAAI;EACtB,CAAC;CACH;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BA,WACE,YACA,OACA,YACM;EACN,MAAM,QAAoB;GACxB,SAAS,KAAK;GACd,QAAQ;GACR,GAAG;EACL;EAEA,KAAK,eAAe,OAAO,OAAO,KAAK;EAEvC,KAAK,QAAQ,MACX;GACE,QAAQ;GACR;GACA;EACF,GACA,sBACF;EAGA,KAAK,WAAW,YAAY;GAC1B,QAAQ;GACR;GACA;GACA,SAAS,KAAK;GACd,WAAW,KAAK,IAAI;EACtB,CAAC;CACH;AACF;;;;AAKA,MAAM,mCAAmB,IAAI,IAAoB;;;;;;;;;;;;;;AAejD,SAAgB,WAAW,aAAqB,QAAyB;CACvE,IAAI,CAAC,iBAAiB,IAAI,WAAW,GACnC,iBAAiB,IAAI,aAAa,IAAI,OAAO,aAAa,EAAE,OAAO,CAAC,CAAC;CAEvE,OAAO,iBAAiB,IAAI,WAAW;AACzC;;;;AAKA,SAAgB,eAAqB;CACnC,iBAAiB,MAAM;AACzB"}

package/dist/node-require-DF5QBX6z.cjs

@@ -0,0 +1,99 @@
+let node_module = require("node:module");
+
+//#region src/node-require.ts
+/**
+* Cross-format require() helper for CJS and ESM compatibility
+*
+* Provides a synchronous `require()` function that works in both:
+* - CJS builds: Uses native `require`
+* - ESM builds: Uses `createRequire(import.meta.url)`
+*
+* This allows optional peer dependencies and dynamic module loading
+* to work synchronously in both module formats.
+*/
+let cachedRequire;
+function getNodeRequire() {
+	if (cachedRequire) return cachedRequire;
+	const base = typeof __filename === "string" ? __filename : require("url").pathToFileURL(__filename).href;
+	if (!base) throw Object.assign(/* @__PURE__ */ new Error("node require() is unavailable in this runtime"), { code: "MODULE_NOT_FOUND" });
+	cachedRequire = (0, node_module.createRequire)(base);
+	return cachedRequire;
+}
+/**
+* Synchronously require a module (works in both CJS and ESM)
+*
+* @param id - Module ID to require
+* @returns The required module
+* @throws Error if module cannot be loaded
+*
+* @example
+* ```typescript
+* import { safeRequire } from './node-require';
+*
+* const traceloop = safeRequire('@traceloop/node-server-sdk');
+* if (traceloop) {
+*   traceloop.initialize({ ... });
+* }
+* ```
+*/
+function safeRequire(id) {
+	try {
+		return getNodeRequire()(id);
+	} catch (error) {
+		if (error && error.code === "MODULE_NOT_FOUND") return;
+		throw error;
+	}
+}
+/**
+* Synchronously require a module (throws if not found)
+*
+* Use this when the module is required (not optional).
+*
+* @param id - Module ID to require
+* @returns The required module
+* @throws Error if module cannot be loaded
+*
+* @example
+* ```typescript
+* import { requireModule } from './node-require';
+*
+* const fs = requireModule<typeof import('node:fs')>('node:fs');
+* const content = fs.readFileSync('file.txt', 'utf8');
+* ```
+*/
+function requireModule(id) {
+	return getNodeRequire()(id);
+}
+/**
+* Direct access to the nodeRequire function (for advanced use cases).
+*
+* Lazily resolves the underlying Node `require` on first call, so importing
+* this binding never triggers `createRequire` in runtimes that lack a module
+* path (e.g. Cloudflare Workers).
+*
+* Only the call signature and `resolve` (including `resolve.paths`) are
+* forwarded. The live, mutable members of a real `require` — `.cache`,
+* `.main`, `.extensions` — are intentionally NOT exposed: a lazy wrapper
+* can't mirror that shared state without resolving eagerly, which would
+* reintroduce the workerd crash. Use `createRequire` directly if you need
+* them.
+*/
+const nodeRequire = ((id) => getNodeRequire()(id));
+const lazyResolve = ((id, options) => getNodeRequire().resolve(id, options));
+lazyResolve.paths = (request) => getNodeRequire().resolve.paths(request);
+nodeRequire.resolve = lazyResolve;
+
+//#endregion
+Object.defineProperty(exports, 'requireModule', {
+  enumerable: true,
+  get: function () {
+    return requireModule;
+  }
+});
+Object.defineProperty(exports, 'safeRequire', {
+  enumerable: true,
+  get: function () {
+    return safeRequire;
+  }
+});
+//# sourceMappingURL=node-require-DF5QBX6z.cjs.map

package/dist/node-require-DF5QBX6z.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-require-DF5QBX6z.cjs","names":[],"sources":["../src/node-require.ts"],"sourcesContent":["/**\n * Cross-format require() helper for CJS and ESM compatibility\n *\n * Provides a synchronous `require()` function that works in both:\n * - CJS builds: Uses native `require`\n * - ESM builds: Uses `createRequire(import.meta.url)`\n *\n * This allows optional peer dependencies and dynamic module loading\n * to work synchronously in both module formats.\n */\n\nimport { createRequire } from 'node:module';\n\n// `__filename` is provided by CJS and by esbuild's CJS output wrapper, but\n// is undefined under pure ESM. `import.meta.url` is provided by ESM. Pick\n// whichever is available so the helper works in:\n//   - native CJS (autotel's published `.cjs`)\n//   - native ESM (autotel's published `.js`)\n//   - ESM-bundled-into-CJS by a downstream consumer (e.g. CDK's\n//     `aws-lambda-nodejs` → esbuild with `format: cjs`). esbuild rewrites\n//     `import.meta` to `{}` in this case, so `createRequire(import.meta.url)`\n//     alone collapses to `createRequire(undefined)` and crashes at load.\n// `typeof __filename` does NOT throw when the identifier is undeclared, so\n// the ESM build evaluates the conditional safely.\ndeclare const __filename: string | undefined;\n\n// Build the Node `require` lazily on first use. Calling `createRequire`\n// eagerly at module load crashes in runtimes where neither `__filename` nor\n// `import.meta.url` resolves to a path — e.g. Cloudflare Workers / workerd,\n// where the bundle has no module path and `createRequire(undefined)` throws\n// synchronously at import. Deferring the call keeps merely importing this\n// module (and therefore anything that re-exports it, such as `track`)\n// side-effect-free; Node/CJS/ESM still get a real `require` on first call.\nlet cachedRequire: NodeRequire | undefined;\n\nfunction getNodeRequire(): NodeRequire {\n  if (cachedRequire) return cachedRequire;\n  const base = typeof __filename === 'string' ? __filename : import.meta.url;\n  if (!base) {\n    // No module path in this runtime. Surface as a missing-module error so\n    // optional lookups via `safeRequire()` degrade gracefully to `undefined`.\n    throw Object.assign(\n      new Error('node require() is unavailable in this runtime'),\n      { code: 'MODULE_NOT_FOUND' },\n    );\n  }\n  cachedRequire = createRequire(base);\n  return cachedRequire;\n}\n\n/**\n * Synchronously require a module (works in both CJS and ESM)\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { safeRequire } from './node-require';\n *\n * const traceloop = safeRequire('@traceloop/node-server-sdk');\n * if (traceloop) {\n *   traceloop.initialize({ ... });\n * }\n * ```\n */\nexport function safeRequire<T = unknown>(id: string): T | undefined {\n  try {\n    return getNodeRequire()(id) as T;\n  } catch (error) {\n    if (error && (error as NodeJS.ErrnoException).code === 'MODULE_NOT_FOUND') {\n      // Optional dependency missing – return undefined\n      return undefined;\n    }\n    // Any other error is a real bug: rethrow\n    throw error;\n  }\n}\n\n/**\n * Synchronously require a module (throws if not found)\n *\n * Use this when the module is required (not optional).\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { requireModule } from './node-require';\n *\n * const fs = requireModule<typeof import('node:fs')>('node:fs');\n * const content = fs.readFileSync('file.txt', 'utf8');\n * ```\n */\nexport function requireModule<T = unknown>(id: string): T {\n  return getNodeRequire()(id) as T;\n}\n\n/**\n * Direct access to the nodeRequire function (for advanced use cases).\n *\n * Lazily resolves the underlying Node `require` on first call, so importing\n * this binding never triggers `createRequire` in runtimes that lack a module\n * path (e.g. Cloudflare Workers).\n *\n * Only the call signature and `resolve` (including `resolve.paths`) are\n * forwarded. The live, mutable members of a real `require` — `.cache`,\n * `.main`, `.extensions` — are intentionally NOT exposed: a lazy wrapper\n * can't mirror that shared state without resolving eagerly, which would\n * reintroduce the workerd crash. Use `createRequire` directly if you need\n * them.\n */\nconst nodeRequire = ((id: string) => getNodeRequire()(id)) as NodeRequire;\nconst lazyResolve = ((id: string, options?: { paths?: string[] }) =>\n  getNodeRequire().resolve(id, options)) as NodeRequire['resolve'];\nlazyResolve.paths = (request: string) =>\n  getNodeRequire().resolve.paths(request);\nnodeRequire.resolve = lazyResolve;\n\nexport { nodeRequire };\n"],"mappings":";;;;;;;;;;;;;AAiCA,IAAI;AAEJ,SAAS,iBAA8B;CACrC,IAAI,eAAe,OAAO;CAC1B,MAAM,OAAO,OAAO,eAAe,WAAW;CAC9C,IAAI,CAAC,MAGH,MAAM,OAAO,uBACX,IAAI,MAAM,+CAA+C,GACzD,EAAE,MAAM,mBAAmB,CAC7B;CAEF,+CAA8B,IAAI;CAClC,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,YAAyB,IAA2B;CAClE,IAAI;EACF,OAAO,eAAe,CAAC,CAAC,EAAE;CAC5B,SAAS,OAAO;EACd,IAAI,SAAU,MAAgC,SAAS,oBAErD;EAGF,MAAM;CACR;AACF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,cAA2B,IAAe;CACxD,OAAO,eAAe,CAAC,CAAC,EAAE;AAC5B;;;;;;;;;;;;;;;AAgBA,MAAM,gBAAgB,OAAe,eAAe,CAAC,CAAC,EAAE;AACxD,MAAM,gBAAgB,IAAY,YAChC,eAAe,CAAC,CAAC,QAAQ,IAAI,OAAO;AACtC,YAAY,SAAS,YACnB,eAAe,CAAC,CAAC,QAAQ,MAAM,OAAO;AACxC,YAAY,UAAU"}

package/dist/node-require-Db1oDpLj.js

@@ -0,0 +1,88 @@
+import { createRequire } from "node:module";
+
+//#region src/node-require.ts
+/**
+* Cross-format require() helper for CJS and ESM compatibility
+*
+* Provides a synchronous `require()` function that works in both:
+* - CJS builds: Uses native `require`
+* - ESM builds: Uses `createRequire(import.meta.url)`
+*
+* This allows optional peer dependencies and dynamic module loading
+* to work synchronously in both module formats.
+*/
+let cachedRequire;
+function getNodeRequire() {
+	if (cachedRequire) return cachedRequire;
+	const base = typeof __filename === "string" ? __filename : import.meta.url;
+	if (!base) throw Object.assign(/* @__PURE__ */ new Error("node require() is unavailable in this runtime"), { code: "MODULE_NOT_FOUND" });
+	cachedRequire = createRequire(base);
+	return cachedRequire;
+}
+/**
+* Synchronously require a module (works in both CJS and ESM)
+*
+* @param id - Module ID to require
+* @returns The required module
+* @throws Error if module cannot be loaded
+*
+* @example
+* ```typescript
+* import { safeRequire } from './node-require';
+*
+* const traceloop = safeRequire('@traceloop/node-server-sdk');
+* if (traceloop) {
+*   traceloop.initialize({ ... });
+* }
+* ```
+*/
+function safeRequire(id) {
+	try {
+		return getNodeRequire()(id);
+	} catch (error) {
+		if (error && error.code === "MODULE_NOT_FOUND") return;
+		throw error;
+	}
+}
+/**
+* Synchronously require a module (throws if not found)
+*
+* Use this when the module is required (not optional).
+*
+* @param id - Module ID to require
+* @returns The required module
+* @throws Error if module cannot be loaded
+*
+* @example
+* ```typescript
+* import { requireModule } from './node-require';
+*
+* const fs = requireModule<typeof import('node:fs')>('node:fs');
+* const content = fs.readFileSync('file.txt', 'utf8');
+* ```
+*/
+function requireModule(id) {
+	return getNodeRequire()(id);
+}
+/**
+* Direct access to the nodeRequire function (for advanced use cases).
+*
+* Lazily resolves the underlying Node `require` on first call, so importing
+* this binding never triggers `createRequire` in runtimes that lack a module
+* path (e.g. Cloudflare Workers).
+*
+* Only the call signature and `resolve` (including `resolve.paths`) are
+* forwarded. The live, mutable members of a real `require` — `.cache`,
+* `.main`, `.extensions` — are intentionally NOT exposed: a lazy wrapper
+* can't mirror that shared state without resolving eagerly, which would
+* reintroduce the workerd crash. Use `createRequire` directly if you need
+* them.
+*/
+const nodeRequire = ((id) => getNodeRequire()(id));
+const lazyResolve = ((id, options) => getNodeRequire().resolve(id, options));
+lazyResolve.paths = (request) => getNodeRequire().resolve.paths(request);
+nodeRequire.resolve = lazyResolve;
+
+//#endregion
+export { safeRequire as n, requireModule as t };
+//# sourceMappingURL=node-require-Db1oDpLj.js.map

package/dist/node-require-Db1oDpLj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-require-Db1oDpLj.js","names":[],"sources":["../src/node-require.ts"],"sourcesContent":["/**\n * Cross-format require() helper for CJS and ESM compatibility\n *\n * Provides a synchronous `require()` function that works in both:\n * - CJS builds: Uses native `require`\n * - ESM builds: Uses `createRequire(import.meta.url)`\n *\n * This allows optional peer dependencies and dynamic module loading\n * to work synchronously in both module formats.\n */\n\nimport { createRequire } from 'node:module';\n\n// `__filename` is provided by CJS and by esbuild's CJS output wrapper, but\n// is undefined under pure ESM. `import.meta.url` is provided by ESM. Pick\n// whichever is available so the helper works in:\n//   - native CJS (autotel's published `.cjs`)\n//   - native ESM (autotel's published `.js`)\n//   - ESM-bundled-into-CJS by a downstream consumer (e.g. CDK's\n//     `aws-lambda-nodejs` → esbuild with `format: cjs`). esbuild rewrites\n//     `import.meta` to `{}` in this case, so `createRequire(import.meta.url)`\n//     alone collapses to `createRequire(undefined)` and crashes at load.\n// `typeof __filename` does NOT throw when the identifier is undeclared, so\n// the ESM build evaluates the conditional safely.\ndeclare const __filename: string | undefined;\n\n// Build the Node `require` lazily on first use. Calling `createRequire`\n// eagerly at module load crashes in runtimes where neither `__filename` nor\n// `import.meta.url` resolves to a path — e.g. Cloudflare Workers / workerd,\n// where the bundle has no module path and `createRequire(undefined)` throws\n// synchronously at import. Deferring the call keeps merely importing this\n// module (and therefore anything that re-exports it, such as `track`)\n// side-effect-free; Node/CJS/ESM still get a real `require` on first call.\nlet cachedRequire: NodeRequire | undefined;\n\nfunction getNodeRequire(): NodeRequire {\n  if (cachedRequire) return cachedRequire;\n  const base = typeof __filename === 'string' ? __filename : import.meta.url;\n  if (!base) {\n    // No module path in this runtime. Surface as a missing-module error so\n    // optional lookups via `safeRequire()` degrade gracefully to `undefined`.\n    throw Object.assign(\n      new Error('node require() is unavailable in this runtime'),\n      { code: 'MODULE_NOT_FOUND' },\n    );\n  }\n  cachedRequire = createRequire(base);\n  return cachedRequire;\n}\n\n/**\n * Synchronously require a module (works in both CJS and ESM)\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { safeRequire } from './node-require';\n *\n * const traceloop = safeRequire('@traceloop/node-server-sdk');\n * if (traceloop) {\n *   traceloop.initialize({ ... });\n * }\n * ```\n */\nexport function safeRequire<T = unknown>(id: string): T | undefined {\n  try {\n    return getNodeRequire()(id) as T;\n  } catch (error) {\n    if (error && (error as NodeJS.ErrnoException).code === 'MODULE_NOT_FOUND') {\n      // Optional dependency missing – return undefined\n      return undefined;\n    }\n    // Any other error is a real bug: rethrow\n    throw error;\n  }\n}\n\n/**\n * Synchronously require a module (throws if not found)\n *\n * Use this when the module is required (not optional).\n *\n * @param id - Module ID to require\n * @returns The required module\n * @throws Error if module cannot be loaded\n *\n * @example\n * ```typescript\n * import { requireModule } from './node-require';\n *\n * const fs = requireModule<typeof import('node:fs')>('node:fs');\n * const content = fs.readFileSync('file.txt', 'utf8');\n * ```\n */\nexport function requireModule<T = unknown>(id: string): T {\n  return getNodeRequire()(id) as T;\n}\n\n/**\n * Direct access to the nodeRequire function (for advanced use cases).\n *\n * Lazily resolves the underlying Node `require` on first call, so importing\n * this binding never triggers `createRequire` in runtimes that lack a module\n * path (e.g. Cloudflare Workers).\n *\n * Only the call signature and `resolve` (including `resolve.paths`) are\n * forwarded. The live, mutable members of a real `require` — `.cache`,\n * `.main`, `.extensions` — are intentionally NOT exposed: a lazy wrapper\n * can't mirror that shared state without resolving eagerly, which would\n * reintroduce the workerd crash. Use `createRequire` directly if you need\n * them.\n */\nconst nodeRequire = ((id: string) => getNodeRequire()(id)) as NodeRequire;\nconst lazyResolve = ((id: string, options?: { paths?: string[] }) =>\n  getNodeRequire().resolve(id, options)) as NodeRequire['resolve'];\nlazyResolve.paths = (request: string) =>\n  getNodeRequire().resolve.paths(request);\nnodeRequire.resolve = lazyResolve;\n\nexport { nodeRequire };\n"],"mappings":";;;;;;;;;;;;;AAiCA,IAAI;AAEJ,SAAS,iBAA8B;CACrC,IAAI,eAAe,OAAO;CAC1B,MAAM,OAAO,OAAO,eAAe,WAAW,aAAa,OAAO,KAAK;CACvE,IAAI,CAAC,MAGH,MAAM,OAAO,uBACX,IAAI,MAAM,+CAA+C,GACzD,EAAE,MAAM,mBAAmB,CAC7B;CAEF,gBAAgB,cAAc,IAAI;CAClC,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,YAAyB,IAA2B;CAClE,IAAI;EACF,OAAO,eAAe,CAAC,CAAC,EAAE;CAC5B,SAAS,OAAO;EACd,IAAI,SAAU,MAAgC,SAAS,oBAErD;EAGF,MAAM;CACR;AACF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,cAA2B,IAAe;CACxD,OAAO,eAAe,CAAC,CAAC,EAAE;AAC5B;;;;;;;;;;;;;;;AAgBA,MAAM,gBAAgB,OAAe,eAAe,CAAC,CAAC,EAAE;AACxD,MAAM,gBAAgB,IAAY,YAChC,eAAe,CAAC,CAAC,QAAQ,IAAI,OAAO;AACtC,YAAY,SAAS,YACnB,eAAe,CAAC,CAAC,QAAQ,MAAM,OAAO;AACxC,YAAY,UAAU"}

package/dist/operation-context-C-2hmmtP.js

@@ -0,0 +1,59 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/operation-context.ts
+/**
+* Operation context tracking using AsyncLocalStorage
+*
+* This module provides a way to track operation names across async boundaries
+* so they can be automatically captured in events events.
+*
+* We cannot read span attributes from OpenTelemetry's API (it's write-only),
+* so we maintain our own async context storage.
+*/
+/**
+* AsyncLocalStorage instance for tracking operation context
+*/
+const operationStorage = new AsyncLocalStorage();
+/**
+* Get the current operation context (if any)
+*
+* @returns The current operation context, or undefined if not in an operation
+*
+* @example
+* ```typescript
+* const ctx = getOperationContext();
+* if (ctx) {
+*   console.log('Current operation:', ctx.name);
+* }
+* ```
+*/
+function getOperationContext() {
+	return operationStorage.getStore();
+}
+/**
+* Run a function within an operation context
+*
+* This sets the operation name for the duration of the function execution,
+* including all async operations spawned from it.
+*
+* @param name - The operation name to set
+* @param fn - The function to execute within the context
+* @returns The result of the function
+*
+* @example
+* ```typescript
+* const result = await runInOperationContext('user.create', async () => {
+*   // Any events.trackEvent() calls here will automatically capture
+*   // 'operation.name': 'user.create'
+*   await createUser();
+*   return 'success';
+* });
+* ```
+*/
+function runInOperationContext(name, fn) {
+	return operationStorage.run({ name }, fn);
+}
+
+//#endregion
+export { runInOperationContext as n, getOperationContext as t };
+//# sourceMappingURL=operation-context-C-2hmmtP.js.map

package/dist/operation-context-C-2hmmtP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-context-C-2hmmtP.js","names":[],"sources":["../src/operation-context.ts"],"sourcesContent":["/**\n * Operation context tracking using AsyncLocalStorage\n *\n * This module provides a way to track operation names across async boundaries\n * so they can be automatically captured in events events.\n *\n * We cannot read span attributes from OpenTelemetry's API (it's write-only),\n * so we maintain our own async context storage.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n/**\n * Operation context that flows through async operations\n */\nexport interface OperationContext {\n  /**\n   * The name of the current operation\n   * This is set by trace() or span() and can be read by events\n   */\n  name: string;\n}\n\n/**\n * AsyncLocalStorage instance for tracking operation context\n */\nconst operationStorage = new AsyncLocalStorage<OperationContext>();\n\n/**\n * Get the current operation context (if any)\n *\n * @returns The current operation context, or undefined if not in an operation\n *\n * @example\n * ```typescript\n * const ctx = getOperationContext();\n * if (ctx) {\n *   console.log('Current operation:', ctx.name);\n * }\n * ```\n */\nexport function getOperationContext(): OperationContext | undefined {\n  return operationStorage.getStore();\n}\n\n/**\n * Run a function within an operation context\n *\n * This sets the operation name for the duration of the function execution,\n * including all async operations spawned from it.\n *\n * @param name - The operation name to set\n * @param fn - The function to execute within the context\n * @returns The result of the function\n *\n * @example\n * ```typescript\n * const result = await runInOperationContext('user.create', async () => {\n *   // Any events.trackEvent() calls here will automatically capture\n *   // 'operation.name': 'user.create'\n *   await createUser();\n *   return 'success';\n * });\n * ```\n */\nexport function runInOperationContext<T>(name: string, fn: () => T): T {\n  return operationStorage.run({ name }, fn);\n}\n\n/**\n * Update the operation name in the current context\n *\n * This is useful when you want to change the operation name within\n * an already-established context (e.g., when entering a nested span).\n *\n * @param name - The new operation name\n *\n * @example\n * ```typescript\n * runInOperationContext('parent.operation', () => {\n *   // operation.name is 'parent.operation'\n *\n *   updateOperationName('nested.operation');\n *   // operation.name is now 'nested.operation'\n * });\n * ```\n */\nexport function updateOperationName(name: string): void {\n  const store = operationStorage.getStore();\n  if (store) {\n    store.name = name;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,MAAM,mBAAmB,IAAI,kBAAoC;;;;;;;;;;;;;;AAejE,SAAgB,sBAAoD;CAClE,OAAO,iBAAiB,SAAS;AACnC;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,sBAAyB,MAAc,IAAgB;CACrE,OAAO,iBAAiB,IAAI,EAAE,KAAK,GAAG,EAAE;AAC1C"}

package/dist/operation-context-n4_obUwq.cjs

@@ -0,0 +1,70 @@
+let node_async_hooks = require("node:async_hooks");
+
+//#region src/operation-context.ts
+/**
+* Operation context tracking using AsyncLocalStorage
+*
+* This module provides a way to track operation names across async boundaries
+* so they can be automatically captured in events events.
+*
+* We cannot read span attributes from OpenTelemetry's API (it's write-only),
+* so we maintain our own async context storage.
+*/
+/**
+* AsyncLocalStorage instance for tracking operation context
+*/
+const operationStorage = new node_async_hooks.AsyncLocalStorage();
+/**
+* Get the current operation context (if any)
+*
+* @returns The current operation context, or undefined if not in an operation
+*
+* @example
+* ```typescript
+* const ctx = getOperationContext();
+* if (ctx) {
+*   console.log('Current operation:', ctx.name);
+* }
+* ```
+*/
+function getOperationContext() {
+	return operationStorage.getStore();
+}
+/**
+* Run a function within an operation context
+*
+* This sets the operation name for the duration of the function execution,
+* including all async operations spawned from it.
+*
+* @param name - The operation name to set
+* @param fn - The function to execute within the context
+* @returns The result of the function
+*
+* @example
+* ```typescript
+* const result = await runInOperationContext('user.create', async () => {
+*   // Any events.trackEvent() calls here will automatically capture
+*   // 'operation.name': 'user.create'
+*   await createUser();
+*   return 'success';
+* });
+* ```
+*/
+function runInOperationContext(name, fn) {
+	return operationStorage.run({ name }, fn);
+}
+
+//#endregion
+Object.defineProperty(exports, 'getOperationContext', {
+  enumerable: true,
+  get: function () {
+    return getOperationContext;
+  }
+});
+Object.defineProperty(exports, 'runInOperationContext', {
+  enumerable: true,
+  get: function () {
+    return runInOperationContext;
+  }
+});
+//# sourceMappingURL=operation-context-n4_obUwq.cjs.map

package/dist/operation-context-n4_obUwq.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-context-n4_obUwq.cjs","names":["AsyncLocalStorage"],"sources":["../src/operation-context.ts"],"sourcesContent":["/**\n * Operation context tracking using AsyncLocalStorage\n *\n * This module provides a way to track operation names across async boundaries\n * so they can be automatically captured in events events.\n *\n * We cannot read span attributes from OpenTelemetry's API (it's write-only),\n * so we maintain our own async context storage.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n/**\n * Operation context that flows through async operations\n */\nexport interface OperationContext {\n  /**\n   * The name of the current operation\n   * This is set by trace() or span() and can be read by events\n   */\n  name: string;\n}\n\n/**\n * AsyncLocalStorage instance for tracking operation context\n */\nconst operationStorage = new AsyncLocalStorage<OperationContext>();\n\n/**\n * Get the current operation context (if any)\n *\n * @returns The current operation context, or undefined if not in an operation\n *\n * @example\n * ```typescript\n * const ctx = getOperationContext();\n * if (ctx) {\n *   console.log('Current operation:', ctx.name);\n * }\n * ```\n */\nexport function getOperationContext(): OperationContext | undefined {\n  return operationStorage.getStore();\n}\n\n/**\n * Run a function within an operation context\n *\n * This sets the operation name for the duration of the function execution,\n * including all async operations spawned from it.\n *\n * @param name - The operation name to set\n * @param fn - The function to execute within the context\n * @returns The result of the function\n *\n * @example\n * ```typescript\n * const result = await runInOperationContext('user.create', async () => {\n *   // Any events.trackEvent() calls here will automatically capture\n *   // 'operation.name': 'user.create'\n *   await createUser();\n *   return 'success';\n * });\n * ```\n */\nexport function runInOperationContext<T>(name: string, fn: () => T): T {\n  return operationStorage.run({ name }, fn);\n}\n\n/**\n * Update the operation name in the current context\n *\n * This is useful when you want to change the operation name within\n * an already-established context (e.g., when entering a nested span).\n *\n * @param name - The new operation name\n *\n * @example\n * ```typescript\n * runInOperationContext('parent.operation', () => {\n *   // operation.name is 'parent.operation'\n *\n *   updateOperationName('nested.operation');\n *   // operation.name is now 'nested.operation'\n * });\n * ```\n */\nexport function updateOperationName(name: string): void {\n  const store = operationStorage.getStore();\n  if (store) {\n    store.name = name;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,MAAM,mBAAmB,IAAIA,mCAAoC;;;;;;;;;;;;;;AAejE,SAAgB,sBAAoD;CAClE,OAAO,iBAAiB,SAAS;AACnC;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,sBAAyB,MAAc,IAAgB;CACrE,OAAO,iBAAiB,IAAI,EAAE,KAAK,GAAG,EAAE;AAC1C"}

package/dist/parse-error.cjs

@@ -1,12 +1,58 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-var chunkT4B5LB6E_cjs = require('./chunk-T4B5LB6E.cjs');
+//#region src/parse-error.ts
+function toStatus(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string") {
+		const n = Number(value);
+		if (Number.isFinite(n)) return n;
+	}
+}
+function pickString(value) {
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function pickCode(value) {
+	if (typeof value === "string" || typeof value === "number") return value;
+}
+function pickDetails(value) {
+	if (value && typeof value === "object" && value.constructor === Object) return value;
+}
+function parseError(error) {
+	if (error instanceof Error) {
+		const structured = error;
+		return {
+			message: error.message || "An error occurred",
+			status: toStatus(structured.status) ?? 500,
+			why: pickString(structured.why),
+			fix: pickString(structured.fix),
+			link: pickString(structured.link),
+			code: pickCode(structured.code),
+			details: pickDetails(structured.details),
+			raw: error
+		};
+	}
+	if (error && typeof error === "object") {
+		const err = error;
+		const data = err.data && typeof err.data === "object" ? err.data : void 0;
+		const payload = (data?.data && typeof data.data === "object" ? data.data : void 0) ?? data;
+		return {
+			message: pickString(data?.statusText) || pickString(data?.statusMessage) || pickString(data?.message) || pickString(payload?.statusText) || pickString(payload?.statusMessage) || pickString(payload?.message) || pickString(err.message) || "An error occurred",
+			status: toStatus(payload?.status) || toStatus(payload?.statusCode) || toStatus(err.status) || toStatus(err.statusCode) || 500,
+			why: pickString(payload?.why) || pickString(err.why),
+			fix: pickString(payload?.fix) || pickString(err.fix),
+			link: pickString(payload?.link) || pickString(err.link),
+			code: pickCode(payload?.code) || pickCode(err.code),
+			details: pickDetails(payload?.details) || pickDetails(err.details),
+			raw: error
+		};
+	}
+	return {
+		message: String(error),
+		status: 500,
+		raw: error
+	};
+}
 
-
-
-Object.defineProperty(exports, "parseError", {
-  enumerable: true,
-  get: function () { return chunkT4B5LB6E_cjs.parseError; }
-});
-//# sourceMappingURL=parse-error.cjs.map
+//#endregion
+exports.parseError = parseError;
 //# sourceMappingURL=parse-error.cjs.map

package/dist/parse-error.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"parse-error.cjs"}
+{"version":3,"file":"parse-error.cjs","names":[],"sources":["../src/parse-error.ts"],"sourcesContent":["import type { StructuredError } from './structured-error';\n\nexport interface ParsedError {\n  message: string;\n  status: number;\n  why?: string;\n  fix?: string;\n  link?: string;\n  code?: string | number;\n  details?: Record<string, unknown>;\n  raw: unknown;\n}\n\ntype ErrorLike = {\n  message?: unknown;\n  status?: unknown;\n  statusCode?: unknown;\n  data?: unknown;\n  code?: unknown;\n  why?: unknown;\n  fix?: unknown;\n  link?: unknown;\n  details?: unknown;\n};\n\nfunction toStatus(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string') {\n    const n = Number(value);\n    if (Number.isFinite(n)) return n;\n  }\n  return undefined;\n}\n\nfunction pickString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n\nfunction pickCode(value: unknown): string | number | undefined {\n  if (typeof value === 'string' || typeof value === 'number') return value;\n  return undefined;\n}\n\nfunction pickDetails(value: unknown): Record<string, unknown> | undefined {\n  if (value && typeof value === 'object' && value.constructor === Object) {\n    return value as Record<string, unknown>;\n  }\n  return undefined;\n}\n\nexport function parseError(error: unknown): ParsedError {\n  if (error instanceof Error) {\n    const structured = error as StructuredError;\n    return {\n      message: error.message || 'An error occurred',\n      status: toStatus(structured.status) ?? 500,\n      why: pickString(structured.why),\n      fix: pickString(structured.fix),\n      link: pickString(structured.link),\n      code: pickCode(structured.code),\n      details: pickDetails(structured.details),\n      raw: error,\n    };\n  }\n\n  if (error && typeof error === 'object') {\n    const err = error as ErrorLike;\n    const data =\n      err.data && typeof err.data === 'object'\n        ? (err.data as Record<string, unknown>)\n        : undefined;\n    const nested =\n      data?.data && typeof data.data === 'object'\n        ? (data.data as Record<string, unknown>)\n        : undefined;\n    const payload = nested ?? data;\n\n    const message =\n      pickString(data?.statusText) ||\n      pickString(data?.statusMessage) ||\n      pickString(data?.message) ||\n      pickString(payload?.statusText) ||\n      pickString(payload?.statusMessage) ||\n      pickString(payload?.message) ||\n      pickString(err.message) ||\n      'An error occurred';\n\n    const status =\n      toStatus(payload?.status) ||\n      toStatus(payload?.statusCode) ||\n      toStatus(err.status) ||\n      toStatus(err.statusCode) ||\n      500;\n\n    return {\n      message,\n      status,\n      why: pickString(payload?.why) || pickString(err.why),\n      fix: pickString(payload?.fix) || pickString(err.fix),\n      link: pickString(payload?.link) || pickString(err.link),\n      code: pickCode(payload?.code) || pickCode(err.code),\n      details: pickDetails(payload?.details) || pickDetails(err.details),\n      raw: error,\n    };\n  }\n\n  return {\n    message: String(error),\n    status: 500,\n    raw: error,\n  };\n}\n"],"mappings":";;;AAyBA,SAAS,SAAS,OAAoC;CACpD,IAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GAAG,OAAO;CAChE,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,IAAI,OAAO,KAAK;EACtB,IAAI,OAAO,SAAS,CAAC,GAAG,OAAO;CACjC;AAEF;AAEA,SAAS,WAAW,OAAoC;CACtD,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAEA,SAAS,SAAS,OAA6C;CAC7D,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU,OAAO;AAErE;AAEA,SAAS,YAAY,OAAqD;CACxE,IAAI,SAAS,OAAO,UAAU,YAAY,MAAM,gBAAgB,QAC9D,OAAO;AAGX;AAEA,SAAgB,WAAW,OAA6B;CACtD,IAAI,iBAAiB,OAAO;EAC1B,MAAM,aAAa;EACnB,OAAO;GACL,SAAS,MAAM,WAAW;GAC1B,QAAQ,SAAS,WAAW,MAAM,KAAK;GACvC,KAAK,WAAW,WAAW,GAAG;GAC9B,KAAK,WAAW,WAAW,GAAG;GAC9B,MAAM,WAAW,WAAW,IAAI;GAChC,MAAM,SAAS,WAAW,IAAI;GAC9B,SAAS,YAAY,WAAW,OAAO;GACvC,KAAK;EACP;CACF;CAEA,IAAI,SAAS,OAAO,UAAU,UAAU;EACtC,MAAM,MAAM;EACZ,MAAM,OACJ,IAAI,QAAQ,OAAO,IAAI,SAAS,WAC3B,IAAI,OACL;EAKN,MAAM,WAHJ,MAAM,QAAQ,OAAO,KAAK,SAAS,WAC9B,KAAK,OACN,WACoB;EAmB1B,OAAO;GACL,SAjBA,WAAW,MAAM,UAAU,KAC3B,WAAW,MAAM,aAAa,KAC9B,WAAW,MAAM,OAAO,KACxB,WAAW,SAAS,UAAU,KAC9B,WAAW,SAAS,aAAa,KACjC,WAAW,SAAS,OAAO,KAC3B,WAAW,IAAI,OAAO,KACtB;GAWA,QARA,SAAS,SAAS,MAAM,KACxB,SAAS,SAAS,UAAU,KAC5B,SAAS,IAAI,MAAM,KACnB,SAAS,IAAI,UAAU,KACvB;GAKA,KAAK,WAAW,SAAS,GAAG,KAAK,WAAW,IAAI,GAAG;GACnD,KAAK,WAAW,SAAS,GAAG,KAAK,WAAW,IAAI,GAAG;GACnD,MAAM,WAAW,SAAS,IAAI,KAAK,WAAW,IAAI,IAAI;GACtD,MAAM,SAAS,SAAS,IAAI,KAAK,SAAS,IAAI,IAAI;GAClD,SAAS,YAAY,SAAS,OAAO,KAAK,YAAY,IAAI,OAAO;GACjE,KAAK;EACP;CACF;CAEA,OAAO;EACL,SAAS,OAAO,KAAK;EACrB,QAAQ;EACR,KAAK;CACP;AACF"}

package/dist/parse-error.d.cts

@@ -1,13 +1,15 @@
+//#region src/parse-error.d.ts
 interface ParsedError {
-    message: string;
-    status: number;
-    why?: string;
-    fix?: string;
-    link?: string;
-    code?: string | number;
-    details?: Record<string, unknown>;
-    raw: unknown;
+  message: string;
+  status: number;
+  why?: string;
+  fix?: string;
+  link?: string;
+  code?: string | number;
+  details?: Record<string, unknown>;
+  raw: unknown;
 }
 declare function parseError(error: unknown): ParsedError;
-
-export { type ParsedError, parseError };
+//#endregion
+export { ParsedError, parseError };
+//# sourceMappingURL=parse-error.d.cts.map

package/dist/parse-error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error.d.cts","names":[],"sources":["../src/parse-error.ts"],"mappings":";UAEiB,WAAA;EACf,OAAA;EACA,MAAA;EACA,GAAA;EACA,GAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA,GAAU,MAAM;EAChB,GAAA;AAAA;AAAA,iBAwCc,UAAA,CAAW,KAAA,YAAiB,WAAW"}

package/dist/parse-error.d.ts

@@ -1,13 +1,15 @@
+//#region src/parse-error.d.ts
 interface ParsedError {
-    message: string;
-    status: number;
-    why?: string;
-    fix?: string;
-    link?: string;
-    code?: string | number;
-    details?: Record<string, unknown>;
-    raw: unknown;
+  message: string;
+  status: number;
+  why?: string;
+  fix?: string;
+  link?: string;
+  code?: string | number;
+  details?: Record<string, unknown>;
+  raw: unknown;
 }
 declare function parseError(error: unknown): ParsedError;
-
-export { type ParsedError, parseError };
+//#endregion
+export { ParsedError, parseError };
+//# sourceMappingURL=parse-error.d.ts.map

package/dist/parse-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error.d.ts","names":[],"sources":["../src/parse-error.ts"],"mappings":";UAEiB,WAAA;EACf,OAAA;EACA,MAAA;EACA,GAAA;EACA,GAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA,GAAU,MAAM;EAChB,GAAA;AAAA;AAAA,iBAwCc,UAAA,CAAW,KAAA,YAAiB,WAAW"}

package/dist/parse-error.js

@@ -1,3 +1,56 @@
-export { parseError } from './chunk-J7VGRIAJ.js';
-//# sourceMappingURL=parse-error.js.map
+//#region src/parse-error.ts
+function toStatus(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string") {
+		const n = Number(value);
+		if (Number.isFinite(n)) return n;
+	}
+}
+function pickString(value) {
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function pickCode(value) {
+	if (typeof value === "string" || typeof value === "number") return value;
+}
+function pickDetails(value) {
+	if (value && typeof value === "object" && value.constructor === Object) return value;
+}
+function parseError(error) {
+	if (error instanceof Error) {
+		const structured = error;
+		return {
+			message: error.message || "An error occurred",
+			status: toStatus(structured.status) ?? 500,
+			why: pickString(structured.why),
+			fix: pickString(structured.fix),
+			link: pickString(structured.link),
+			code: pickCode(structured.code),
+			details: pickDetails(structured.details),
+			raw: error
+		};
+	}
+	if (error && typeof error === "object") {
+		const err = error;
+		const data = err.data && typeof err.data === "object" ? err.data : void 0;
+		const payload = (data?.data && typeof data.data === "object" ? data.data : void 0) ?? data;
+		return {
+			message: pickString(data?.statusText) || pickString(data?.statusMessage) || pickString(data?.message) || pickString(payload?.statusText) || pickString(payload?.statusMessage) || pickString(payload?.message) || pickString(err.message) || "An error occurred",
+			status: toStatus(payload?.status) || toStatus(payload?.statusCode) || toStatus(err.status) || toStatus(err.statusCode) || 500,
+			why: pickString(payload?.why) || pickString(err.why),
+			fix: pickString(payload?.fix) || pickString(err.fix),
+			link: pickString(payload?.link) || pickString(err.link),
+			code: pickCode(payload?.code) || pickCode(err.code),
+			details: pickDetails(payload?.details) || pickDetails(err.details),
+			raw: error
+		};
+	}
+	return {
+		message: String(error),
+		status: 500,
+		raw: error
+	};
+}
+
+//#endregion
+export { parseError };
 //# sourceMappingURL=parse-error.js.map

package/dist/parse-error.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"parse-error.js"}
+{"version":3,"file":"parse-error.js","names":[],"sources":["../src/parse-error.ts"],"sourcesContent":["import type { StructuredError } from './structured-error';\n\nexport interface ParsedError {\n  message: string;\n  status: number;\n  why?: string;\n  fix?: string;\n  link?: string;\n  code?: string | number;\n  details?: Record<string, unknown>;\n  raw: unknown;\n}\n\ntype ErrorLike = {\n  message?: unknown;\n  status?: unknown;\n  statusCode?: unknown;\n  data?: unknown;\n  code?: unknown;\n  why?: unknown;\n  fix?: unknown;\n  link?: unknown;\n  details?: unknown;\n};\n\nfunction toStatus(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string') {\n    const n = Number(value);\n    if (Number.isFinite(n)) return n;\n  }\n  return undefined;\n}\n\nfunction pickString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n\nfunction pickCode(value: unknown): string | number | undefined {\n  if (typeof value === 'string' || typeof value === 'number') return value;\n  return undefined;\n}\n\nfunction pickDetails(value: unknown): Record<string, unknown> | undefined {\n  if (value && typeof value === 'object' && value.constructor === Object) {\n    return value as Record<string, unknown>;\n  }\n  return undefined;\n}\n\nexport function parseError(error: unknown): ParsedError {\n  if (error instanceof Error) {\n    const structured = error as StructuredError;\n    return {\n      message: error.message || 'An error occurred',\n      status: toStatus(structured.status) ?? 500,\n      why: pickString(structured.why),\n      fix: pickString(structured.fix),\n      link: pickString(structured.link),\n      code: pickCode(structured.code),\n      details: pickDetails(structured.details),\n      raw: error,\n    };\n  }\n\n  if (error && typeof error === 'object') {\n    const err = error as ErrorLike;\n    const data =\n      err.data && typeof err.data === 'object'\n        ? (err.data as Record<string, unknown>)\n        : undefined;\n    const nested =\n      data?.data && typeof data.data === 'object'\n        ? (data.data as Record<string, unknown>)\n        : undefined;\n    const payload = nested ?? data;\n\n    const message =\n      pickString(data?.statusText) ||\n      pickString(data?.statusMessage) ||\n      pickString(data?.message) ||\n      pickString(payload?.statusText) ||\n      pickString(payload?.statusMessage) ||\n      pickString(payload?.message) ||\n      pickString(err.message) ||\n      'An error occurred';\n\n    const status =\n      toStatus(payload?.status) ||\n      toStatus(payload?.statusCode) ||\n      toStatus(err.status) ||\n      toStatus(err.statusCode) ||\n      500;\n\n    return {\n      message,\n      status,\n      why: pickString(payload?.why) || pickString(err.why),\n      fix: pickString(payload?.fix) || pickString(err.fix),\n      link: pickString(payload?.link) || pickString(err.link),\n      code: pickCode(payload?.code) || pickCode(err.code),\n      details: pickDetails(payload?.details) || pickDetails(err.details),\n      raw: error,\n    };\n  }\n\n  return {\n    message: String(error),\n    status: 500,\n    raw: error,\n  };\n}\n"],"mappings":";AAyBA,SAAS,SAAS,OAAoC;CACpD,IAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GAAG,OAAO;CAChE,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,IAAI,OAAO,KAAK;EACtB,IAAI,OAAO,SAAS,CAAC,GAAG,OAAO;CACjC;AAEF;AAEA,SAAS,WAAW,OAAoC;CACtD,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAEA,SAAS,SAAS,OAA6C;CAC7D,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU,OAAO;AAErE;AAEA,SAAS,YAAY,OAAqD;CACxE,IAAI,SAAS,OAAO,UAAU,YAAY,MAAM,gBAAgB,QAC9D,OAAO;AAGX;AAEA,SAAgB,WAAW,OAA6B;CACtD,IAAI,iBAAiB,OAAO;EAC1B,MAAM,aAAa;EACnB,OAAO;GACL,SAAS,MAAM,WAAW;GAC1B,QAAQ,SAAS,WAAW,MAAM,KAAK;GACvC,KAAK,WAAW,WAAW,GAAG;GAC9B,KAAK,WAAW,WAAW,GAAG;GAC9B,MAAM,WAAW,WAAW,IAAI;GAChC,MAAM,SAAS,WAAW,IAAI;GAC9B,SAAS,YAAY,WAAW,OAAO;GACvC,KAAK;EACP;CACF;CAEA,IAAI,SAAS,OAAO,UAAU,UAAU;EACtC,MAAM,MAAM;EACZ,MAAM,OACJ,IAAI,QAAQ,OAAO,IAAI,SAAS,WAC3B,IAAI,OACL;EAKN,MAAM,WAHJ,MAAM,QAAQ,OAAO,KAAK,SAAS,WAC9B,KAAK,OACN,WACoB;EAmB1B,OAAO;GACL,SAjBA,WAAW,MAAM,UAAU,KAC3B,WAAW,MAAM,aAAa,KAC9B,WAAW,MAAM,OAAO,KACxB,WAAW,SAAS,UAAU,KAC9B,WAAW,SAAS,aAAa,KACjC,WAAW,SAAS,OAAO,KAC3B,WAAW,IAAI,OAAO,KACtB;GAWA,QARA,SAAS,SAAS,MAAM,KACxB,SAAS,SAAS,UAAU,KAC5B,SAAS,IAAI,MAAM,KACnB,SAAS,IAAI,UAAU,KACvB;GAKA,KAAK,WAAW,SAAS,GAAG,KAAK,WAAW,IAAI,GAAG;GACnD,KAAK,WAAW,SAAS,GAAG,KAAK,WAAW,IAAI,GAAG;GACnD,MAAM,WAAW,SAAS,IAAI,KAAK,WAAW,IAAI,IAAI;GACtD,MAAM,SAAS,SAAS,IAAI,KAAK,SAAS,IAAI,IAAI;GAClD,SAAS,YAAY,SAAS,OAAO,KAAK,YAAY,IAAI,OAAO;GACjE,KAAK;EACP;CACF;CAEA,OAAO;EACL,SAAS,OAAO,KAAK;EACrB,QAAQ;EACR,KAAK;CACP;AACF"}