autotel-edge 3.16.13 → 3.16.15

package/dist/events.js

@@ -1,157 +1,164 @@
-import { getActiveConfig } from './chunk-INQQQVXN.js';
-import { trace } from '@opentelemetry/api';
+import { n as getActiveConfig } from "./config-0FktBGyj.js";
+import { trace } from "@opentelemetry/api";
 
-var DEFAULT_SERVICE_NAME = "edge-service";
+//#region src/events/index.ts
+const DEFAULT_SERVICE_NAME = "edge-service";
+/**
+* Extract a normalized event name from any EdgeEvent.
+* Useful for subscribers that need to send events to events platforms.
+* 
+* @deprecated Use `event.name` directly instead - it's now a property on all events.
+* 
+* @example
+* ```typescript
+* const subscriber: EdgeSubscribersAdapter = async (event) => {
+*   await sendToEvents(event.name, event.attributes) // Use event.name directly
+* }
+* ```
+*/
 function getEventName(event) {
-  return event.name;
+	return event.name;
 }
 function isPromiseLike(value) {
-  return typeof value === "object" && value !== null && "then" in value;
+	return typeof value === "object" && value !== null && "then" in value;
 }
 function createBaseEvent(attributes, options) {
-  const config = getActiveConfig();
-  const serviceName = options.service ?? config?.service.name ?? DEFAULT_SERVICE_NAME;
-  const baseAttributes = attributes ? { ...attributes } : {};
-  const baseEvent = {
-    service: serviceName,
-    timestamp: Date.now(),
-    attributes: baseAttributes
-  };
-  if (options.includeTraceContext ?? true) {
-    const span = trace.getActiveSpan();
-    const spanContext = span?.spanContext();
-    if (spanContext) {
-      baseEvent.traceId = spanContext.traceId;
-      baseEvent.spanId = spanContext.spanId;
-      baseEvent.correlationId = spanContext.traceId.slice(0, 16);
-    }
-  }
-  return baseEvent;
+	const config = getActiveConfig();
+	const serviceName = options.service ?? config?.service.name ?? DEFAULT_SERVICE_NAME;
+	const baseAttributes = attributes ? { ...attributes } : {};
+	const baseEvent = {
+		service: serviceName,
+		timestamp: Date.now(),
+		attributes: baseAttributes
+	};
+	if (options.includeTraceContext ?? true) {
+		const spanContext = trace.getActiveSpan()?.spanContext();
+		if (spanContext) {
+			baseEvent.traceId = spanContext.traceId;
+			baseEvent.spanId = spanContext.spanId;
+			baseEvent.correlationId = spanContext.traceId.slice(0, 16);
+		}
+	}
+	return baseEvent;
 }
 function handleError(error, event, options) {
-  if (options.onError) {
-    try {
-      options.onError(error, event);
-      return;
-    } catch (handlerError) {
-      console.error("[autotel-edge] Subscribers onError handler failed", handlerError);
-    }
-  }
-  console.error("[autotel-edge] Subscribers transport failed", error, { event });
+	if (options.onError) try {
+		options.onError(error, event);
+		return;
+	} catch (handlerError) {
+		console.error("[autotel-edge] Subscribers onError handler failed", handlerError);
+	}
+	console.error("[autotel-edge] Subscribers transport failed", error, { event });
 }
 function deliverResult(result, event, delivery, waitUntil, createOptions) {
-  if (!isPromiseLike(result)) {
-    return delivery === "await" ? Promise.resolve() : void 0;
-  }
-  if (delivery === "await") {
-    return Promise.resolve(result).catch((error) => {
-      handleError(error, event, createOptions);
-      throw error;
-    });
-  }
-  const background = Promise.resolve(result).catch((error) => {
-    handleError(error, event, createOptions);
-  });
-  if (waitUntil) {
-    waitUntil(background);
-  }
-  return void 0;
+	if (!isPromiseLike(result)) return delivery === "await" ? Promise.resolve() : void 0;
+	if (delivery === "await") return Promise.resolve(result).catch((error) => {
+		handleError(error, event, createOptions);
+		throw error;
+	});
+	const background = Promise.resolve(result).catch((error) => {
+		handleError(error, event, createOptions);
+	});
+	if (waitUntil) waitUntil(background);
 }
 function createSubscribersInstance(options, bindings = {}) {
-  const dispatch = (event, callOptions) => {
-    const delivery = callOptions?.delivery ?? bindings.delivery ?? options.delivery ?? "fire-and-forget";
-    const waitUntil = callOptions?.waitUntil ?? bindings.waitUntil ?? options.waitUntil;
-    const result = options.transport(event);
-    return deliverResult(result, event, delivery, waitUntil, options);
-  };
-  const trackEvent = (eventName, attributes, callOptions) => {
-    const baseEvent = createBaseEvent(attributes, options);
-    const event = {
-      ...baseEvent,
-      type: "event",
-      event: eventName,
-      name: eventName
-    };
-    return dispatch(event, callOptions);
-  };
-  const trackFunnelStep = (funnel, status, attributes, callOptions) => {
-    const baseEvent = createBaseEvent(attributes, options);
-    const event = {
-      ...baseEvent,
-      type: "funnel-step",
-      funnel,
-      status,
-      name: `funnel-step.${status}`
-    };
-    return dispatch(event, callOptions);
-  };
-  const trackOutcome = (operation, outcome, attributes, callOptions) => {
-    const baseEvent = createBaseEvent(attributes, options);
-    const event = {
-      ...baseEvent,
-      type: "outcome",
-      operation,
-      outcome,
-      name: `outcome.${outcome}`
-    };
-    return dispatch(event, callOptions);
-  };
-  const trackValue = (metric, value, attributes, callOptions) => {
-    const baseEvent = createBaseEvent(attributes, options);
-    const event = {
-      ...baseEvent,
-      type: "value",
-      metric,
-      value,
-      name: `value.${metric}`
-    };
-    return dispatch(event, callOptions);
-  };
-  return {
-    trackEvent,
-    trackFunnelStep,
-    trackOutcome,
-    trackValue,
-    dispatch,
-    bind: (nextBindings) => createSubscribersInstance(options, { ...bindings, ...nextBindings })
-  };
+	const dispatch = (event, callOptions) => {
+		const delivery = callOptions?.delivery ?? bindings.delivery ?? options.delivery ?? "fire-and-forget";
+		const waitUntil = callOptions?.waitUntil ?? bindings.waitUntil ?? options.waitUntil;
+		return deliverResult(options.transport(event), event, delivery, waitUntil, options);
+	};
+	const trackEvent = (eventName, attributes, callOptions) => {
+		return dispatch({
+			...createBaseEvent(attributes, options),
+			type: "event",
+			event: eventName,
+			name: eventName
+		}, callOptions);
+	};
+	const trackFunnelStep = (funnel, status, attributes, callOptions) => {
+		return dispatch({
+			...createBaseEvent(attributes, options),
+			type: "funnel-step",
+			funnel,
+			status,
+			name: `funnel-step.${status}`
+		}, callOptions);
+	};
+	const trackOutcome = (operation, outcome, attributes, callOptions) => {
+		return dispatch({
+			...createBaseEvent(attributes, options),
+			type: "outcome",
+			operation,
+			outcome,
+			name: `outcome.${outcome}`
+		}, callOptions);
+	};
+	const trackValue = (metric, value, attributes, callOptions) => {
+		return dispatch({
+			...createBaseEvent(attributes, options),
+			type: "value",
+			metric,
+			value,
+			name: `value.${metric}`
+		}, callOptions);
+	};
+	return {
+		trackEvent,
+		trackFunnelStep,
+		trackOutcome,
+		trackValue,
+		dispatch,
+		bind: (nextBindings) => createSubscribersInstance(options, {
+			...bindings,
+			...nextBindings
+		})
+	};
 }
 function createEdgeSubscribers(options) {
-  if (typeof options.transport !== "function") {
-    throw new TypeError("createEdgeSubscribers: options.transport is required");
-  }
-  return createSubscribersInstance(options);
+	if (typeof options.transport !== "function") throw new TypeError("createEdgeSubscribers: options.transport is required");
+	return createSubscribersInstance(options);
 }
+/**
+* Get Subscribers instance from active config, bound to the current ExecutionContext.
+* Returns null if Subscribers is not configured.
+*
+* @example
+* ```typescript
+* export default {
+*   async fetch(request, env, ctx) {
+*     const Subscribers = getEdgeSubscribers(ctx);
+*     if (Subscribers) {
+*       Subscribers.trackEvent('user.signup', { plan: 'pro' });
+*     }
+*     return new Response('ok');
+*   }
+* }
+* ```
+*/
 function getEdgeSubscribers(ctx) {
-  const config = getActiveConfig();
-  if (!config) {
-    return null;
-  }
-  const subscribers = config.subscribers ?? [];
-  if (subscribers.length === 0) {
-    return null;
-  }
-  const combinedTransport = async (event) => {
-    await Promise.all(
-      subscribers.map(async (subscriber, index) => {
-        try {
-          await subscriber(event);
-        } catch (error) {
-          console.error("[autotel-edge] Subscribers subscriber failed", error, {
-            subscriberIndex: index,
-            eventType: event.type
-          });
-        }
-      })
-    );
-  };
-  return createEdgeSubscribers({
-    transport: combinedTransport,
-    service: config.service.name,
-    waitUntil: ctx ? (promise) => ctx.waitUntil(promise) : void 0
-  });
+	const config = getActiveConfig();
+	if (!config) return null;
+	const subscribers = config.subscribers ?? [];
+	if (subscribers.length === 0) return null;
+	const combinedTransport = async (event) => {
+		await Promise.all(subscribers.map(async (subscriber, index) => {
+			try {
+				await subscriber(event);
+			} catch (error) {
+				console.error("[autotel-edge] Subscribers subscriber failed", error, {
+					subscriberIndex: index,
+					eventType: event.type
+				});
+			}
+		}));
+	};
+	return createEdgeSubscribers({
+		transport: combinedTransport,
+		service: config.service.name,
+		waitUntil: ctx ? (promise) => ctx.waitUntil(promise) : void 0
+	});
 }
 
+//#endregion
 export { createEdgeSubscribers, getEdgeSubscribers, getEventName };
-//# sourceMappingURL=events.js.map
 //# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/events/index.ts"],"names":[],"mappings":"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","file":"events.js","sourcesContent":["import { trace } from '@opentelemetry/api';\nimport { getActiveConfig } from '../core/config';\nimport type {\n  OrPromise,\n  EdgeEvent,\n  FunnelStepStatus,\n  OutcomeStatus,\n  EdgeTrackEvent,\n  EdgeFunnelStepEvent,\n  EdgeOutcomeEvent,\n  EdgeValueEvent,\n  EdgeEventBase,\n} from '../types';\n\nexport type SubscriberDeliveryMode = 'fire-and-forget' | 'await';\n\n// Re-export event types for convenience\n\n\nexport type EdgeTransport = (event: EdgeEvent) => OrPromise<void>;\n\nexport interface EdgeDispatchOptions {\n  delivery?: SubscriberDeliveryMode;\n  waitUntil?: (promise: Promise<void>) => void;\n}\n\nexport interface CreateEdgeSubscribersOptions {\n  /**\n   * User-supplied transport invoked for every Subscribers event.\n   * Implementations can call PostHog, Stripe, Zapier, Durable Objects, etc.\n   */\n  transport: EdgeTransport;\n  /**\n   * Optional service name used when no request config is active.\n   * Defaults to the active instrumentation config's service name or \"edge-service\".\n   */\n  service?: string;\n  /**\n   * Default delivery behaviour for transport promises.\n   * \"fire-and-forget\" (default) will not block the calling code.\n   */\n  delivery?: SubscriberDeliveryMode;\n  /**\n   * Default waitUntil handler (Cloudflare Workers, Vercel waitUntil).\n   * Used when delivery === \"fire-and-forget\".\n   */\n  waitUntil?: (promise: Promise<void>) => void;\n  /**\n   * Optional error handler invoked when the transport rejects.\n   */\n  onError?: (error: unknown, event: EdgeEvent) => void;\n  /**\n   * Include OpenTelemetry trace/span identifiers in the payload. Default true.\n   */\n  includeTraceContext?: boolean;\n}\n\nexport interface EdgeSubscribers {\n  trackEvent(\n    event: string,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  trackFunnelStep(\n    funnel: string,\n    status: FunnelStepStatus,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  trackOutcome(\n    operation: string,\n    outcome: OutcomeStatus,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  trackValue(\n    metric: string,\n    value: number,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  dispatch(event: EdgeEvent, options?: EdgeDispatchOptions): OrPromise<void>;\n  bind(options: EdgeDispatchOptions): EdgeSubscribers;\n}\n\nconst DEFAULT_SERVICE_NAME = 'edge-service';\n\n/**\n * Extract a normalized event name from any EdgeEvent.\n * Useful for subscribers that need to send events to events platforms.\n * \n * @deprecated Use `event.name` directly instead - it's now a property on all events.\n * \n * @example\n * ```typescript\n * const subscriber: EdgeSubscribersAdapter = async (event) => {\n *   await sendToEvents(event.name, event.attributes) // Use event.name directly\n * }\n * ```\n */\nexport function getEventName(event: EdgeEvent): string {\n  return event.name;\n}\n\nfunction isPromiseLike(value: unknown): value is Promise<unknown> {\n  return typeof value === 'object' && value !== null && 'then' in value;\n}\n\nfunction createBaseEvent(\n  attributes: Record<string, unknown> | undefined,\n  options: CreateEdgeSubscribersOptions,\n): Omit<EdgeEventBase, 'name'> {\n  const config = getActiveConfig();\n  // Prioritize explicit service override, then config service name, then default\n  const serviceName = options.service ?? config?.service.name ?? DEFAULT_SERVICE_NAME;\n  const baseAttributes = attributes ? { ...attributes } : {};\n\n  const baseEvent: Omit<EdgeEventBase, 'name'> = {\n    service: serviceName,\n    timestamp: Date.now(),\n    attributes: baseAttributes,\n  };\n\n  if (options.includeTraceContext ?? true) {\n    const span = trace.getActiveSpan();\n    const spanContext = span?.spanContext();\n    if (spanContext) {\n      baseEvent.traceId = spanContext.traceId;\n      baseEvent.spanId = spanContext.spanId;\n      baseEvent.correlationId = spanContext.traceId.slice(0, 16);\n    }\n  }\n\n  return baseEvent;\n}\n\nfunction handleError(\n  error: unknown,\n  event: EdgeEvent,\n  options: CreateEdgeSubscribersOptions,\n): void {\n  if (options.onError) {\n    try {\n      options.onError(error, event);\n      return;\n    } catch (handlerError) {\n      console.error('[autotel-edge] Subscribers onError handler failed', handlerError);\n    }\n  }\n\n  console.error('[autotel-edge] Subscribers transport failed', error, { event });\n}\n\nfunction deliverResult(\n  result: OrPromise<void>,\n  event: EdgeEvent,\n  delivery: SubscriberDeliveryMode,\n  waitUntil: EdgeDispatchOptions['waitUntil'],\n  createOptions: CreateEdgeSubscribersOptions,\n): OrPromise<void> {\n  if (!isPromiseLike(result)) {\n    return delivery === 'await' ? Promise.resolve() : undefined;\n  }\n\n  if (delivery === 'await') {\n    return Promise.resolve(result).catch((error) => {\n      handleError(error, event, createOptions);\n      throw error;\n    });\n  }\n\n  const background = Promise.resolve(result).catch((error) => {\n    handleError(error, event, createOptions);\n  });\n\n  if (waitUntil) {\n    waitUntil(background);\n  } else {\n    void background;\n  }\n\n  return undefined;\n}\n\nfunction createSubscribersInstance(\n  options: CreateEdgeSubscribersOptions,\n  bindings: EdgeDispatchOptions = {},\n): EdgeSubscribers {\n  const dispatch = (\n    event: EdgeEvent,\n    callOptions?: EdgeDispatchOptions,\n  ): OrPromise<void> => {\n    const delivery =\n      callOptions?.delivery ??\n      bindings.delivery ??\n      options.delivery ??\n      ('fire-and-forget' as SubscriberDeliveryMode);\n    const waitUntil = callOptions?.waitUntil ?? bindings.waitUntil ?? options.waitUntil;\n    const result = options.transport(event);\n    return deliverResult(result, event, delivery, waitUntil, options);\n  };\n\n  const trackEvent: EdgeSubscribers['trackEvent'] = (eventName, attributes, callOptions) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeTrackEvent = {\n      ...baseEvent,\n      type: 'event',\n      event: eventName,\n      name: eventName,\n    } as EdgeTrackEvent;\n    return dispatch(event, callOptions);\n  };\n\n  const trackFunnelStep: EdgeSubscribers['trackFunnelStep'] = (\n    funnel,\n    status,\n    attributes,\n    callOptions,\n  ) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeFunnelStepEvent = {\n      ...baseEvent,\n      type: 'funnel-step',\n      funnel,\n      status,\n      name: `funnel-step.${status}`,\n    } as EdgeFunnelStepEvent;\n    return dispatch(event, callOptions);\n  };\n\n  const trackOutcome: EdgeSubscribers['trackOutcome'] = (\n    operation,\n    outcome,\n    attributes,\n    callOptions,\n  ) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeOutcomeEvent = {\n      ...baseEvent,\n      type: 'outcome',\n      operation,\n      outcome,\n      name: `outcome.${outcome}`,\n    } as EdgeOutcomeEvent;\n    return dispatch(event, callOptions);\n  };\n\n  const trackValue: EdgeSubscribers['trackValue'] = (\n    metric,\n    value,\n    attributes,\n    callOptions,\n  ) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeValueEvent = {\n      ...baseEvent,\n      type: 'value',\n      metric,\n      value,\n      name: `value.${metric}`,\n    } as EdgeValueEvent;\n    return dispatch(event, callOptions);\n  };\n\n  return {\n    trackEvent,\n    trackFunnelStep,\n    trackOutcome,\n    trackValue,\n    dispatch,\n    bind: (nextBindings: EdgeDispatchOptions) =>\n      createSubscribersInstance(options, { ...bindings, ...nextBindings }),\n  };\n}\n\nexport function createEdgeSubscribers(options: CreateEdgeSubscribersOptions): EdgeSubscribers {\n  if (typeof options.transport !== 'function') {\n    throw new TypeError('createEdgeSubscribers: options.transport is required');\n  }\n\n  return createSubscribersInstance(options);\n}\n\n/**\n * Get Subscribers instance from active config, bound to the current ExecutionContext.\n * Returns null if Subscribers is not configured.\n *\n * @example\n * ```typescript\n * export default {\n *   async fetch(request, env, ctx) {\n *     const Subscribers = getEdgeSubscribers(ctx);\n *     if (Subscribers) {\n *       Subscribers.trackEvent('user.signup', { plan: 'pro' });\n *     }\n *     return new Response('ok');\n *   }\n * }\n * ```\n */\nexport function getEdgeSubscribers(\n  ctx?: { waitUntil(promise: Promise<any>): void },\n): EdgeSubscribers | null {\n  const config = getActiveConfig();\n  if (!config) {\n    return null;\n  }\n\n  const subscribers = config.subscribers ?? [];\n  if (subscribers.length === 0) {\n    return null;\n  }\n\n  // Combine all subscribers into a single transport function\n  const combinedTransport: EdgeTransport = async (event) => {\n    await Promise.all(\n      subscribers.map(async (subscriber, index) => {\n        try {\n          await subscriber(event);\n        } catch (error) {\n          console.error('[autotel-edge] Subscribers subscriber failed', error, {\n            subscriberIndex: index,\n            eventType: event.type,\n          });\n        }\n      }),\n    );\n  };\n\n  return createEdgeSubscribers({\n    transport: combinedTransport,\n    service: config.service.name,\n    waitUntil: ctx ? (promise) => ctx.waitUntil(promise) : undefined,\n  });\n}\n\n\nexport {type FunnelStepStatus, type OutcomeStatus, type EdgeEvent, type EdgeTrackEvent, type EdgeFunnelStepEvent, type EdgeOutcomeEvent, type EdgeValueEvent} from '../types';"]}
+{"version":3,"file":"events.js","names":[],"sources":["../src/events/index.ts"],"sourcesContent":["import { trace } from '@opentelemetry/api';\nimport { getActiveConfig } from '../core/config';\nimport type {\n  OrPromise,\n  EdgeEvent,\n  FunnelStepStatus,\n  OutcomeStatus,\n  EdgeTrackEvent,\n  EdgeFunnelStepEvent,\n  EdgeOutcomeEvent,\n  EdgeValueEvent,\n  EdgeEventBase,\n} from '../types';\n\nexport type SubscriberDeliveryMode = 'fire-and-forget' | 'await';\n\n// Re-export event types for convenience\n\n\nexport type EdgeTransport = (event: EdgeEvent) => OrPromise<void>;\n\nexport interface EdgeDispatchOptions {\n  delivery?: SubscriberDeliveryMode;\n  waitUntil?: (promise: Promise<void>) => void;\n}\n\nexport interface CreateEdgeSubscribersOptions {\n  /**\n   * User-supplied transport invoked for every Subscribers event.\n   * Implementations can call PostHog, Stripe, Zapier, Durable Objects, etc.\n   */\n  transport: EdgeTransport;\n  /**\n   * Optional service name used when no request config is active.\n   * Defaults to the active instrumentation config's service name or \"edge-service\".\n   */\n  service?: string;\n  /**\n   * Default delivery behaviour for transport promises.\n   * \"fire-and-forget\" (default) will not block the calling code.\n   */\n  delivery?: SubscriberDeliveryMode;\n  /**\n   * Default waitUntil handler (Cloudflare Workers, Vercel waitUntil).\n   * Used when delivery === \"fire-and-forget\".\n   */\n  waitUntil?: (promise: Promise<void>) => void;\n  /**\n   * Optional error handler invoked when the transport rejects.\n   */\n  onError?: (error: unknown, event: EdgeEvent) => void;\n  /**\n   * Include OpenTelemetry trace/span identifiers in the payload. Default true.\n   */\n  includeTraceContext?: boolean;\n}\n\nexport interface EdgeSubscribers {\n  trackEvent(\n    event: string,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  trackFunnelStep(\n    funnel: string,\n    status: FunnelStepStatus,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  trackOutcome(\n    operation: string,\n    outcome: OutcomeStatus,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  trackValue(\n    metric: string,\n    value: number,\n    attributes?: Record<string, unknown>,\n    options?: EdgeDispatchOptions,\n  ): OrPromise<void>;\n  dispatch(event: EdgeEvent, options?: EdgeDispatchOptions): OrPromise<void>;\n  bind(options: EdgeDispatchOptions): EdgeSubscribers;\n}\n\nconst DEFAULT_SERVICE_NAME = 'edge-service';\n\n/**\n * Extract a normalized event name from any EdgeEvent.\n * Useful for subscribers that need to send events to events platforms.\n * \n * @deprecated Use `event.name` directly instead - it's now a property on all events.\n * \n * @example\n * ```typescript\n * const subscriber: EdgeSubscribersAdapter = async (event) => {\n *   await sendToEvents(event.name, event.attributes) // Use event.name directly\n * }\n * ```\n */\nexport function getEventName(event: EdgeEvent): string {\n  return event.name;\n}\n\nfunction isPromiseLike(value: unknown): value is Promise<unknown> {\n  return typeof value === 'object' && value !== null && 'then' in value;\n}\n\nfunction createBaseEvent(\n  attributes: Record<string, unknown> | undefined,\n  options: CreateEdgeSubscribersOptions,\n): Omit<EdgeEventBase, 'name'> {\n  const config = getActiveConfig();\n  // Prioritize explicit service override, then config service name, then default\n  const serviceName = options.service ?? config?.service.name ?? DEFAULT_SERVICE_NAME;\n  const baseAttributes = attributes ? { ...attributes } : {};\n\n  const baseEvent: Omit<EdgeEventBase, 'name'> = {\n    service: serviceName,\n    timestamp: Date.now(),\n    attributes: baseAttributes,\n  };\n\n  if (options.includeTraceContext ?? true) {\n    const span = trace.getActiveSpan();\n    const spanContext = span?.spanContext();\n    if (spanContext) {\n      baseEvent.traceId = spanContext.traceId;\n      baseEvent.spanId = spanContext.spanId;\n      baseEvent.correlationId = spanContext.traceId.slice(0, 16);\n    }\n  }\n\n  return baseEvent;\n}\n\nfunction handleError(\n  error: unknown,\n  event: EdgeEvent,\n  options: CreateEdgeSubscribersOptions,\n): void {\n  if (options.onError) {\n    try {\n      options.onError(error, event);\n      return;\n    } catch (handlerError) {\n      console.error('[autotel-edge] Subscribers onError handler failed', handlerError);\n    }\n  }\n\n  console.error('[autotel-edge] Subscribers transport failed', error, { event });\n}\n\nfunction deliverResult(\n  result: OrPromise<void>,\n  event: EdgeEvent,\n  delivery: SubscriberDeliveryMode,\n  waitUntil: EdgeDispatchOptions['waitUntil'],\n  createOptions: CreateEdgeSubscribersOptions,\n): OrPromise<void> {\n  if (!isPromiseLike(result)) {\n    return delivery === 'await' ? Promise.resolve() : undefined;\n  }\n\n  if (delivery === 'await') {\n    return Promise.resolve(result).catch((error) => {\n      handleError(error, event, createOptions);\n      throw error;\n    });\n  }\n\n  const background = Promise.resolve(result).catch((error) => {\n    handleError(error, event, createOptions);\n  });\n\n  if (waitUntil) {\n    waitUntil(background);\n  } else {\n    void background;\n  }\n\n  return undefined;\n}\n\nfunction createSubscribersInstance(\n  options: CreateEdgeSubscribersOptions,\n  bindings: EdgeDispatchOptions = {},\n): EdgeSubscribers {\n  const dispatch = (\n    event: EdgeEvent,\n    callOptions?: EdgeDispatchOptions,\n  ): OrPromise<void> => {\n    const delivery =\n      callOptions?.delivery ??\n      bindings.delivery ??\n      options.delivery ??\n      ('fire-and-forget' as SubscriberDeliveryMode);\n    const waitUntil = callOptions?.waitUntil ?? bindings.waitUntil ?? options.waitUntil;\n    const result = options.transport(event);\n    return deliverResult(result, event, delivery, waitUntil, options);\n  };\n\n  const trackEvent: EdgeSubscribers['trackEvent'] = (eventName, attributes, callOptions) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeTrackEvent = {\n      ...baseEvent,\n      type: 'event',\n      event: eventName,\n      name: eventName,\n    } as EdgeTrackEvent;\n    return dispatch(event, callOptions);\n  };\n\n  const trackFunnelStep: EdgeSubscribers['trackFunnelStep'] = (\n    funnel,\n    status,\n    attributes,\n    callOptions,\n  ) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeFunnelStepEvent = {\n      ...baseEvent,\n      type: 'funnel-step',\n      funnel,\n      status,\n      name: `funnel-step.${status}`,\n    } as EdgeFunnelStepEvent;\n    return dispatch(event, callOptions);\n  };\n\n  const trackOutcome: EdgeSubscribers['trackOutcome'] = (\n    operation,\n    outcome,\n    attributes,\n    callOptions,\n  ) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeOutcomeEvent = {\n      ...baseEvent,\n      type: 'outcome',\n      operation,\n      outcome,\n      name: `outcome.${outcome}`,\n    } as EdgeOutcomeEvent;\n    return dispatch(event, callOptions);\n  };\n\n  const trackValue: EdgeSubscribers['trackValue'] = (\n    metric,\n    value,\n    attributes,\n    callOptions,\n  ) => {\n    const baseEvent = createBaseEvent(attributes, options);\n    const event: EdgeValueEvent = {\n      ...baseEvent,\n      type: 'value',\n      metric,\n      value,\n      name: `value.${metric}`,\n    } as EdgeValueEvent;\n    return dispatch(event, callOptions);\n  };\n\n  return {\n    trackEvent,\n    trackFunnelStep,\n    trackOutcome,\n    trackValue,\n    dispatch,\n    bind: (nextBindings: EdgeDispatchOptions) =>\n      createSubscribersInstance(options, { ...bindings, ...nextBindings }),\n  };\n}\n\nexport function createEdgeSubscribers(options: CreateEdgeSubscribersOptions): EdgeSubscribers {\n  if (typeof options.transport !== 'function') {\n    throw new TypeError('createEdgeSubscribers: options.transport is required');\n  }\n\n  return createSubscribersInstance(options);\n}\n\n/**\n * Get Subscribers instance from active config, bound to the current ExecutionContext.\n * Returns null if Subscribers is not configured.\n *\n * @example\n * ```typescript\n * export default {\n *   async fetch(request, env, ctx) {\n *     const Subscribers = getEdgeSubscribers(ctx);\n *     if (Subscribers) {\n *       Subscribers.trackEvent('user.signup', { plan: 'pro' });\n *     }\n *     return new Response('ok');\n *   }\n * }\n * ```\n */\nexport function getEdgeSubscribers(\n  ctx?: { waitUntil(promise: Promise<any>): void },\n): EdgeSubscribers | null {\n  const config = getActiveConfig();\n  if (!config) {\n    return null;\n  }\n\n  const subscribers = config.subscribers ?? [];\n  if (subscribers.length === 0) {\n    return null;\n  }\n\n  // Combine all subscribers into a single transport function\n  const combinedTransport: EdgeTransport = async (event) => {\n    await Promise.all(\n      subscribers.map(async (subscriber, index) => {\n        try {\n          await subscriber(event);\n        } catch (error) {\n          console.error('[autotel-edge] Subscribers subscriber failed', error, {\n            subscriberIndex: index,\n            eventType: event.type,\n          });\n        }\n      }),\n    );\n  };\n\n  return createEdgeSubscribers({\n    transport: combinedTransport,\n    service: config.service.name,\n    waitUntil: ctx ? (promise) => ctx.waitUntil(promise) : undefined,\n  });\n}\n\n\nexport {type FunnelStepStatus, type OutcomeStatus, type EdgeEvent, type EdgeTrackEvent, type EdgeFunnelStepEvent, type EdgeOutcomeEvent, type EdgeValueEvent} from '../types';"],"mappings":";;;;AAqFA,MAAM,uBAAuB;;;;;;;;;;;;;;AAe7B,SAAgB,aAAa,OAA0B;CACrD,OAAO,MAAM;AACf;AAEA,SAAS,cAAc,OAA2C;CAChE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU;AAClE;AAEA,SAAS,gBACP,YACA,SAC6B;CAC7B,MAAM,SAAS,gBAAgB;CAE/B,MAAM,cAAc,QAAQ,WAAW,QAAQ,QAAQ,QAAQ;CAC/D,MAAM,iBAAiB,aAAa,EAAE,GAAG,WAAW,IAAI,CAAC;CAEzD,MAAM,YAAyC;EAC7C,SAAS;EACT,WAAW,KAAK,IAAI;EACpB,YAAY;CACd;CAEA,IAAI,QAAQ,uBAAuB,MAAM;EAEvC,MAAM,cADO,MAAM,cACI,CAAC,EAAE,YAAY;EACtC,IAAI,aAAa;GACf,UAAU,UAAU,YAAY;GAChC,UAAU,SAAS,YAAY;GAC/B,UAAU,gBAAgB,YAAY,QAAQ,MAAM,GAAG,EAAE;EAC3D;CACF;CAEA,OAAO;AACT;AAEA,SAAS,YACP,OACA,OACA,SACM;CACN,IAAI,QAAQ,SACV,IAAI;EACF,QAAQ,QAAQ,OAAO,KAAK;EAC5B;CACF,SAAS,cAAc;EACrB,QAAQ,MAAM,qDAAqD,YAAY;CACjF;CAGF,QAAQ,MAAM,+CAA+C,OAAO,EAAE,MAAM,CAAC;AAC/E;AAEA,SAAS,cACP,QACA,OACA,UACA,WACA,eACiB;CACjB,IAAI,CAAC,cAAc,MAAM,GACvB,OAAO,aAAa,UAAU,QAAQ,QAAQ,IAAI;CAGpD,IAAI,aAAa,SACf,OAAO,QAAQ,QAAQ,MAAM,CAAC,CAAC,OAAO,UAAU;EAC9C,YAAY,OAAO,OAAO,aAAa;EACvC,MAAM;CACR,CAAC;CAGH,MAAM,aAAa,QAAQ,QAAQ,MAAM,CAAC,CAAC,OAAO,UAAU;EAC1D,YAAY,OAAO,OAAO,aAAa;CACzC,CAAC;CAED,IAAI,WACF,UAAU,UAAU;AAMxB;AAEA,SAAS,0BACP,SACA,WAAgC,CAAC,GAChB;CACjB,MAAM,YACJ,OACA,gBACoB;EACpB,MAAM,WACJ,aAAa,YACb,SAAS,YACT,QAAQ,YACP;EACH,MAAM,YAAY,aAAa,aAAa,SAAS,aAAa,QAAQ;EAE1E,OAAO,cADQ,QAAQ,UAAU,KACP,GAAG,OAAO,UAAU,WAAW,OAAO;CAClE;CAEA,MAAM,cAA6C,WAAW,YAAY,gBAAgB;EAQxF,OAAO,SAAS;GALd,GAFgB,gBAAgB,YAAY,OAEjC;GACX,MAAM;GACN,OAAO;GACP,MAAM;EAEY,GAAG,WAAW;CACpC;CAEA,MAAM,mBACJ,QACA,QACA,YACA,gBACG;EASH,OAAO,SAAS;GANd,GAFgB,gBAAgB,YAAY,OAEjC;GACX,MAAM;GACN;GACA;GACA,MAAM,eAAe;EAEH,GAAG,WAAW;CACpC;CAEA,MAAM,gBACJ,WACA,SACA,YACA,gBACG;EASH,OAAO,SAAS;GANd,GAFgB,gBAAgB,YAAY,OAEjC;GACX,MAAM;GACN;GACA;GACA,MAAM,WAAW;EAEC,GAAG,WAAW;CACpC;CAEA,MAAM,cACJ,QACA,OACA,YACA,gBACG;EASH,OAAO,SAAS;GANd,GAFgB,gBAAgB,YAAY,OAEjC;GACX,MAAM;GACN;GACA;GACA,MAAM,SAAS;EAEG,GAAG,WAAW;CACpC;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA,OAAO,iBACL,0BAA0B,SAAS;GAAE,GAAG;GAAU,GAAG;EAAa,CAAC;CACvE;AACF;AAEA,SAAgB,sBAAsB,SAAwD;CAC5F,IAAI,OAAO,QAAQ,cAAc,YAC/B,MAAM,IAAI,UAAU,sDAAsD;CAG5E,OAAO,0BAA0B,OAAO;AAC1C;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,mBACd,KACwB;CACxB,MAAM,SAAS,gBAAgB;CAC/B,IAAI,CAAC,QACH,OAAO;CAGT,MAAM,cAAc,OAAO,eAAe,CAAC;CAC3C,IAAI,YAAY,WAAW,GACzB,OAAO;CAIT,MAAM,oBAAmC,OAAO,UAAU;EACxD,MAAM,QAAQ,IACZ,YAAY,IAAI,OAAO,YAAY,UAAU;GAC3C,IAAI;IACF,MAAM,WAAW,KAAK;GACxB,SAAS,OAAO;IACd,QAAQ,MAAM,gDAAgD,OAAO;KACnE,iBAAiB;KACjB,WAAW,MAAM;IACnB,CAAC;GACH;EACF,CAAC,CACH;CACF;CAEA,OAAO,sBAAsB;EAC3B,WAAW;EACX,SAAS,OAAO,QAAQ;EACxB,WAAW,OAAO,YAAY,IAAI,UAAU,OAAO,IAAI;CACzD,CAAC;AACH"}

package/dist/execution-logger-BWlya70r.d.ts

@@ -0,0 +1,137 @@
+import { AttributeValue, Link, Span, SpanStatusCode, TimeInput } from "@opentelemetry/api";
+import { Sampler } from "@opentelemetry/sdk-trace-base";
+
+//#region src/core/trace-context.d.ts
+/**
+ * Base trace context containing trace identifiers
+ */
+interface TraceContextBase {
+  traceId: string;
+  spanId: string;
+  correlationId: string;
+  'code.function'?: string;
+}
+/**
+ * Span methods available on trace context
+ */
+interface SpanMethods {
+  /** Set a single attribute on the span */
+  setAttribute(key: string, value: AttributeValue): void;
+  /** Set multiple attributes on the span */
+  setAttributes(attrs: Record<string, AttributeValue>): void;
+  /** Set the status of the span */
+  setStatus(status: {
+    code: SpanStatusCode;
+    message?: string;
+  }): void;
+  /** Record an exception on the span */
+  recordException(exception: Error, time?: TimeInput): void;
+  /** Add an event to the span (for logging milestones/checkpoints) */
+  addEvent(name: string, attributesOrStartTime?: Record<string, AttributeValue> | TimeInput, startTime?: TimeInput): void;
+  /** Add a link to another span */
+  addLink(link: Link): void;
+  /** Add multiple links to other spans */
+  addLinks(links: Link[]): void;
+  /** Update the span name dynamically */
+  updateName(name: string): void;
+  /** Check if the span is recording */
+  isRecording(): boolean;
+}
+/**
+ * Complete trace context that merges base context and span methods
+ *
+ * This is the ctx parameter passed to factory functions in trace().
+ * It provides access to trace IDs and span manipulation methods.
+ */
+type TraceContext = TraceContextBase & SpanMethods;
+//#endregion
+//#region src/functional.d.ts
+type ExtractFunctionSignature<T> = T extends ((ctx: TraceContext) => infer F) ? F extends ((...args: infer Args) => infer Return) ? (...args: Args) => Return : never : never;
+type WrappedFunction<TArgs extends any[], TReturn> = (...args: TArgs) => TReturn | Promise<TReturn>;
+/**
+ * trace function options
+ */
+interface traceOptions<TArgs extends any[] = any[], TReturn = any> {
+  name?: string;
+  serviceName?: string;
+  sampler?: Sampler;
+  attributesFromArgs?: (args: TArgs) => Record<string, unknown>;
+  attributesFromResult?: (result: TReturn) => Record<string, unknown>;
+  attributes?: Record<string, unknown>;
+}
+declare function trace$1<TReturn = any>(fn: () => TReturn): () => TReturn;
+declare function trace$1<TArgs extends any[], TReturn = any>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function trace$1<TReturn = any>(fnFactory: (ctx: TraceContext) => () => TReturn): () => TReturn;
+declare function trace$1<TReturn = any>(fn: (ctx: TraceContext) => TReturn): TReturn;
+declare function trace$1<TFactory extends (ctx: TraceContext) => (...args: any[]) => any>(fnFactory: TFactory): ExtractFunctionSignature<TFactory>;
+declare function trace$1<TArgs extends any[], TReturn = any>(fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(name: string, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function trace$1<TReturn = any>(name: string, fn: (ctx: TraceContext) => TReturn): TReturn;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(name: string, fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(options: traceOptions<TArgs, TReturn>, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function trace$1<TReturn = any>(options: traceOptions<[], TReturn>, fn: (ctx: TraceContext) => TReturn): TReturn;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(options: traceOptions<TArgs, TReturn>, fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function trace$1<TReturn = any>(fn: () => Promise<TReturn>): () => Promise<TReturn>;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(fn: (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+declare function trace$1<TReturn = any>(fn: (ctx: TraceContext) => Promise<TReturn>): Promise<TReturn>;
+declare function trace$1<TReturn = any>(fnFactory: (ctx: TraceContext) => () => Promise<TReturn>): () => Promise<TReturn>;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(name: string, fn: (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+declare function trace$1<TReturn = any>(name: string, fn: (ctx: TraceContext) => Promise<TReturn>): Promise<TReturn>;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(name: string, fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(options: traceOptions<TArgs, TReturn>, fn: (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+declare function trace$1<TReturn = any>(options: traceOptions<[], TReturn>, fn: (ctx: TraceContext) => Promise<TReturn>): Promise<TReturn>;
+declare function trace$1<TArgs extends any[] = any[], TReturn = any>(options: traceOptions<TArgs, TReturn>, fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+declare function withTracing<TArgs extends any[] = any[], TReturn = any>(options: Omit<traceOptions<TArgs, TReturn>, 'name'>): (fnOrFactory: ((...args: TArgs) => TReturn | Promise<TReturn>) | ((ctx: TraceContext) => (...args: TArgs) => TReturn | Promise<TReturn>)) => WrappedFunction<TArgs, TReturn>;
+interface InstrumentOptions extends traceOptions {
+  functions: Record<string, any>;
+  overrides?: Record<string, Partial<traceOptions>>;
+  skip?: (string | RegExp | ((key: string, fn: Function) => boolean))[];
+}
+declare function instrument<T extends Record<string, any>>(options: InstrumentOptions): T;
+interface SpanOptions$1 {
+  name: string;
+  attributes?: Record<string, string | number | boolean>;
+}
+declare function span<T = unknown>(name: string, fn: (span: Span) => T): T;
+declare function span<T = unknown>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
+declare function span<T = unknown>(options: SpanOptions$1, fn: (span: Span) => T): T;
+declare function span<T = unknown>(options: SpanOptions$1, fn: (span: Span) => Promise<T>): Promise<T>;
+//#endregion
+//#region src/execution-logger.d.ts
+/**
+ * Optional lifecycle hooks for adapters that need to track child loggers
+ * spawned by `log.fork()` (e.g. activeLoggers maps in framework integrations).
+ */
+interface ForkLifecycle {
+  /** Called after the child logger is created, before `fn` runs. */
+  onChildEnter?: (child: ExecutionLogger) => void;
+  /** Called after the child has finished (emit + drain), success or failure. */
+  onChildExit?: (child: ExecutionLogger) => void;
+}
+interface ForkOptions {
+  lifecycle?: ForkLifecycle;
+}
+interface ExecutionLogger {
+  set(fields: Record<string, unknown>): void;
+  info(message: string, fields?: Record<string, unknown>): void;
+  warn(message: string, fields?: Record<string, unknown>): void;
+  error(error: Error | string, fields?: Record<string, unknown>): void;
+  getContext(): Record<string, unknown>;
+  emitNow(overrides?: Record<string, unknown>): ExecutionLogSnapshot;
+  fork(label: string, fn: () => void | Promise<void>, options?: ForkOptions): void;
+}
+interface ExecutionLogSnapshot {
+  timestamp: string;
+  traceId: string;
+  spanId: string;
+  correlationId: string;
+  context: Record<string, unknown>;
+}
+interface ExecutionLoggerOptions {
+  onEmit?: (snapshot: ExecutionLogSnapshot) => void | Promise<void>;
+}
+declare function getExecutionLogger(ctx?: TraceContext, options?: ExecutionLoggerOptions): ExecutionLogger;
+//#endregion
+export { ForkOptions as a, instrument as c, traceOptions as d, withTracing as f, ForkLifecycle as i, span as l, ExecutionLogger as n, getExecutionLogger as o, TraceContext as p, ExecutionLoggerOptions as r, InstrumentOptions as s, ExecutionLogSnapshot as t, trace$1 as u };
+//# sourceMappingURL=execution-logger-BWlya70r.d.ts.map

package/dist/execution-logger-BWlya70r.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-logger-BWlya70r.d.ts","names":[],"sources":["../src/core/trace-context.ts","../src/functional.ts","../src/execution-logger.ts"],"mappings":"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"}