autotel-cloudflare 2.18.18 → 2.18.19

package/dist/actors.d.ts

@@ -1,47 +1,44 @@
-import { ConfigurationOption } from 'autotel-edge';
-
-/**
- * Type definitions for @cloudflare/actors integration
- */
+import { ConfigurationOption } from "autotel-edge";
 
+//#region src/actors/types.d.ts
 /**
  * Actor-specific instrumentation options
  */
 interface ActorInstrumentationOptions {
-    /**
-     * Whether to instrument storage operations (sql queries, etc.)
-     * @default true
-     */
-    instrumentStorage?: boolean;
-    /**
-     * Whether to instrument alarm operations
-     * @default true
-     */
-    instrumentAlarms?: boolean;
-    /**
-     * Whether to instrument socket operations
-     * @default true
-     */
-    instrumentSockets?: boolean;
-    /**
-     * Whether to capture persist events as spans
-     * @default true
-     */
-    capturePersistEvents?: boolean;
-    /**
-     * Custom span name formatter for lifecycle methods
-     */
-    spanNameFormatter?: (actorName: string, lifecycle: string) => string;
+  /**
+   * Whether to instrument storage operations (sql queries, etc.)
+   * @default true
+   */
+  instrumentStorage?: boolean;
+  /**
+   * Whether to instrument alarm operations
+   * @default true
+   */
+  instrumentAlarms?: boolean;
+  /**
+   * Whether to instrument socket operations
+   * @default true
+   */
+  instrumentSockets?: boolean;
+  /**
+   * Whether to capture persist events as spans
+   * @default true
+   */
+  capturePersistEvents?: boolean;
+  /**
+   * Custom span name formatter for lifecycle methods
+   */
+  spanNameFormatter?: (actorName: string, lifecycle: string) => string;
 }
 /**
  * Actor-specific configuration
  * Can be a static config object with actors options, or a function that returns config
  */
 type ActorConfig = ConfigurationOption & {
-    /**
-     * Actor-specific instrumentation options
-     */
-    actors?: ActorInstrumentationOptions;
+  /**
+   * Actor-specific instrumentation options
+   */
+  actors?: ActorInstrumentationOptions;
 };
 /**
  * Actor lifecycle events that can be traced
@@ -52,30 +49,20 @@ type ActorLifecycle = 'init' | 'request' | 'alarm' | 'persist' | 'websocket.conn
  * We don't import the actual type to avoid coupling
  */
 interface ActorLike {
-    name?: string;
-    identifier?: string;
-    storage?: unknown;
-    alarms?: unknown;
-    sockets?: unknown;
-    fetch?(request: Request): Promise<Response>;
-    alarm?(alarmInfo?: unknown): Promise<void>;
+  name?: string;
+  identifier?: string;
+  storage?: unknown;
+  alarms?: unknown;
+  sockets?: unknown;
+  fetch?(request: Request): Promise<Response>;
+  alarm?(alarmInfo?: unknown): Promise<void>;
 }
 /**
  * Constructor type for Actor classes
  */
 type ActorConstructor<T extends ActorLike = ActorLike> = new (state: DurableObjectState, env: unknown) => T;
-
-/**
- * Actor class instrumentation for @cloudflare/actors
- *
- * Wraps Actor lifecycle methods with OpenTelemetry tracing:
- * - onInit: Traced as 'actor.lifecycle': 'init'
- * - onRequest: Traced with full HTTP semantics
- * - onAlarm: Traced as 'actor.lifecycle': 'alarm'
- * - onPersist: Traced as 'actor.lifecycle': 'persist'
- * - WebSocket methods: Traced with socket semantics
- */
-
+//#endregion
+//#region src/actors/instrument-actor.d.ts
 /**
  * Instrument an Actor class for comprehensive OpenTelemetry tracing
  *
@@ -122,21 +109,13 @@ type ActorConstructor<T extends ActorLike = ActorLike> = new (state: DurableObje
  * @returns Instrumented Actor class
  */
 declare function instrumentActor<C extends ActorConstructor>(actorClass: C, config: ActorConfig | ((env: unknown, trigger?: unknown) => ActorConfig)): C;
-
-/**
- * Traced handler wrapper for @cloudflare/actors
- *
- * Wraps the Actors handler() to provide:
- * - Root span for the entire request lifecycle
- * - Actor name extraction and correlation
- * - Request routing tracing
- */
-
+//#endregion
+//#region src/actors/traced-handler.d.ts
 /**
  * Worker handler type matching @cloudflare/actors output
  */
 interface WorkerHandler<E = unknown> {
-    fetch(request: Request, env: E, ctx: ExecutionContext): Promise<Response>;
+  fetch(request: Request, env: E, ctx: ExecutionContext): Promise<Response>;
 }
 /**
  * Create a traced handler that combines Actor instrumentation with request tracing
@@ -172,10 +151,10 @@ interface WorkerHandler<E = unknown> {
  * @returns A Worker handler with full tracing
  */
 declare function tracedHandler<E, A extends ActorLike>(actorClass: ActorConstructor<A> & {
-    nameFromRequest?(request: Request): Promise<string | undefined>;
-    configuration?(request: Request): {
-        locationHint?: DurableObjectLocationHint;
-    };
+  nameFromRequest?(request: Request): Promise<string | undefined>;
+  configuration?(request: Request): {
+    locationHint?: DurableObjectLocationHint;
+  };
 }, config: ActorConfig | ((env: E, trigger?: unknown) => ActorConfig)): WorkerHandler<E>;
 /**
  * Alternative: Create a handler wrapper that uses the existing @cloudflare/actors handler
@@ -196,13 +175,8 @@ declare function tracedHandler<E, A extends ActorLike>(actorClass: ActorConstruc
  * ```
  */
 declare function wrapHandler<E>(originalHandler: WorkerHandler<E>, config: ActorConfig | ((env: E, trigger?: unknown) => ActorConfig)): WorkerHandler<E>;
-
-/**
- * Actor storage instrumentation
- *
- * Traces operations on actor.storage including SQL queries
- */
-
+//#endregion
+//#region src/actors/storage.d.ts
 /**
  * Instrument Actor storage for tracing
  *
@@ -211,13 +185,8 @@ declare function wrapHandler<E>(originalHandler: WorkerHandler<E>, config: Actor
  * - Key-value operations (if available)
  */
 declare function instrumentActorStorage(storage: unknown, actorInstance: ActorLike, actorClass: object): unknown;
-
-/**
- * Actor alarms instrumentation
- *
- * Traces operations on actor.alarms
- */
-
+//#endregion
+//#region src/actors/alarms.d.ts
 /**
  * Instrument Actor alarms for tracing
  *
@@ -228,13 +197,8 @@ declare function instrumentActorStorage(storage: unknown, actorInstance: ActorLi
  * - cancelAll: Cancel all alarms
  */
 declare function instrumentActorAlarms(alarms: unknown, actorInstance: ActorLike, actorClass: object): unknown;
-
-/**
- * Actor sockets instrumentation
- *
- * Traces operations on actor.sockets
- */
-
+//#endregion
+//#region src/actors/sockets.d.ts
 /**
  * Instrument Actor sockets for tracing
  *
@@ -244,5 +208,6 @@ declare function instrumentActorAlarms(alarms: unknown, actorInstance: ActorLike
  * - send: Send message to a specific socket
  */
 declare function instrumentActorSockets(sockets: unknown, actorInstance: ActorLike, actorClass: object): unknown;
-
+//#endregion
 export { type ActorConfig, type ActorInstrumentationOptions, type ActorLifecycle, instrumentActor, instrumentActorAlarms, instrumentActorSockets, instrumentActorStorage, tracedHandler, wrapHandler };
+//# sourceMappingURL=actors.d.ts.map

package/dist/actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors.d.ts","names":[],"sources":["../src/actors/types.ts","../src/actors/instrument-actor.ts","../src/actors/traced-handler.ts","../src/actors/storage.ts","../src/actors/alarms.ts","../src/actors/sockets.ts"],"mappings":";;;;;;UASiB,2BAAA;EAWf;;;;EANA,iBAAA;EAuBwC;;AAAiB;AAO3D;EAxBE,gBAAA;;;;;EAMA,iBAAA;EAsBoC;AAAA;AAMtC;;EAtBE,oBAAA;EAsBwB;AAAA;AA2B1B;EA5CE,iBAAA,IAAqB,SAAA,UAAmB,SAAA;AAAA;;;;;KAO9B,WAAA,GAAc,mBAAA;EA4CY;;;EAxCpC,MAAA,GAAS,2BAA2B;AAAA;;;;KAM1B,cAAA;;;;;UA2BK,SAAA;EACf,IAAA;EACA,UAAA;EACA,OAAA;EACA,MAAA;EACA,OAAA;EACA,KAAA,EAAO,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,QAAA;EAClC,KAAA,EAAO,SAAA,aAAsB,OAAA;AAAA;AASzB;;;AAAA,KAHM,gBAAA,WAA2B,SAAA,GAAY,SAAA,SACjD,KAAA,EAAO,kBAAA,EACP,GAAA,cACG,CAAA;;;;;;;AA5DsD;AAO3D;;;;;;;;AAIsC;AAMtC;;;;AAA0B;AA2B1B;;;;;;;;;;;;;;;;;;;;;;;AAOsC;AAMtC;;iBC2agB,eAAA,WAA0B,gBAAA,EACxC,UAAA,EAAY,CAAA,EACZ,MAAA,EAAQ,WAAA,KAAgB,GAAA,WAAc,OAAA,eAAsB,WAAA,IAC3D,CAAA;;;;;;UC9eO,aAAA;EACR,KAAA,CAAM,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,CAAA,EAAG,GAAA,EAAK,gBAAA,GAAmB,OAAA,CAAQ,QAAA;AAAA;AFMP;AAO3D;;;;;;;;AAIsC;AAMtC;;;;AAA0B;AA2B1B;;;;;;;;;;;;;;;;;;AA5C2D,iBE8B3C,aAAA,cAA2B,SAAA,EACzC,UAAA,EAAY,gBAAA,CAAiB,CAAA;EAC3B,eAAA,EAAiB,OAAA,EAAS,OAAA,GAAU,OAAA;EACpC,aAAA,EAAe,OAAA,EAAS,OAAA;IAAY,YAAA,GAAe,yBAAA;EAAA;AAAA,GAErD,MAAA,EAAQ,WAAA,KAAgB,GAAA,EAAK,CAAA,EAAG,OAAA,eAAsB,WAAA,IACrD,aAAA,CAAc,CAAA;AFqBjB;;;;;;;;;;;;;;;;;AAGM;AAHN,iBEsIgB,WAAA,IACd,eAAA,EAAiB,aAAA,CAAc,CAAA,GAC/B,MAAA,EAAQ,WAAA,KAAgB,GAAA,EAAK,CAAA,EAAG,OAAA,eAAsB,WAAA,IACrD,aAAA,CAAc,CAAA;;;;;;;;;;iBC9MD,sBAAA,CACd,OAAA,WACA,aAAA,EAAe,SAAS,EACxB,UAAA;;;;;;;;;;;;iBCDc,qBAAA,CACd,MAAA,WACA,aAAA,EAAe,SAAS,EACxB,UAAA;;;;;;;;;;;iBCJc,sBAAA,CACd,OAAA,WACA,aAAA,EAAe,SAAS,EACxB,UAAA"}