autotel 3.5.0 → 3.7.0

package/dist/workflow-distributed.d.ts

@@ -1,7 +1,7 @@
-import { SafeBaggageSchema } from './business-baggage.js';
-import { T as TraceContext } from './trace-context-DbGKd1Rn.js';
-import '@opentelemetry/api';
+import { n as TraceContext } from "./trace-context-Cijqoi6e.js";
+import { SafeBaggageSchema } from "./business-baggage.js";
 
+//#region src/workflow-distributed.d.ts
 /**
  * Pre-built baggage schema for distributed workflows
  *
@@ -24,193 +24,182 @@ import '@opentelemetry/api';
  * ```
  */
 declare const WorkflowBaggage: SafeBaggageSchema<{
-    /** Unique identifier for the workflow instance */
-    readonly workflowId: {
-        readonly type: "string";
-        readonly maxLength: 128;
-        readonly required: true;
-    };
-    /** Name/type of the workflow (e.g., "OrderFulfillment") */
-    readonly workflowName: {
-        readonly type: "string";
-        readonly maxLength: 64;
-        readonly required: true;
-    };
-    /** Version of the workflow definition */
-    readonly workflowVersion: {
-        readonly type: "string";
-        readonly maxLength: 32;
-    };
-    /** Current step name */
-    readonly stepName: {
-        readonly type: "string";
-        readonly maxLength: 64;
-    };
-    /** Current step index (0-based) */
-    readonly stepIndex: {
-        readonly type: "number";
-    };
-    /** Total number of steps (if known) */
-    readonly totalSteps: {
-        readonly type: "number";
-    };
-    /** Parent workflow ID (for sub-workflows) */
-    readonly parentWorkflowId: {
-        readonly type: "string";
-        readonly maxLength: 128;
-    };
-    /** Correlation ID for external systems */
-    readonly correlationId: {
-        readonly type: "string";
-        readonly maxLength: 128;
-    };
-    /** Workflow priority */
-    readonly priority: {
-        readonly type: "enum";
-        readonly values: readonly ["low", "normal", "high", "critical"];
-    };
-    /** Initiating user/system */
-    readonly initiatedBy: {
-        readonly type: "string";
-        readonly maxLength: 64;
-    };
-    /** Workflow start timestamp (ISO) */
-    readonly startedAt: {
-        readonly type: "string";
-        readonly maxLength: 30;
-    };
+  /** Unique identifier for the workflow instance */readonly workflowId: {
+    readonly type: "string";
+    readonly maxLength: 128;
+    readonly required: true;
+  }; /** Name/type of the workflow (e.g., "OrderFulfillment") */
+  readonly workflowName: {
+    readonly type: "string";
+    readonly maxLength: 64;
+    readonly required: true;
+  }; /** Version of the workflow definition */
+  readonly workflowVersion: {
+    readonly type: "string";
+    readonly maxLength: 32;
+  }; /** Current step name */
+  readonly stepName: {
+    readonly type: "string";
+    readonly maxLength: 64;
+  }; /** Current step index (0-based) */
+  readonly stepIndex: {
+    readonly type: "number";
+  }; /** Total number of steps (if known) */
+  readonly totalSteps: {
+    readonly type: "number";
+  }; /** Parent workflow ID (for sub-workflows) */
+  readonly parentWorkflowId: {
+    readonly type: "string";
+    readonly maxLength: 128;
+  }; /** Correlation ID for external systems */
+  readonly correlationId: {
+    readonly type: "string";
+    readonly maxLength: 128;
+  }; /** Workflow priority */
+  readonly priority: {
+    readonly type: "enum";
+    readonly values: readonly ["low", "normal", "high", "critical"];
+  }; /** Initiating user/system */
+  readonly initiatedBy: {
+    readonly type: "string";
+    readonly maxLength: 64;
+  }; /** Workflow start timestamp (ISO) */
+  readonly startedAt: {
+    readonly type: "string";
+    readonly maxLength: 30;
+  };
 }>;
 /**
  * Type for workflow baggage values
  */
 type WorkflowBaggageValues = {
-    workflowId: string;
-    workflowName: string;
-    workflowVersion?: string;
-    stepName?: string;
-    stepIndex?: number;
-    totalSteps?: number;
-    parentWorkflowId?: string;
-    correlationId?: string;
-    priority?: 'low' | 'normal' | 'high' | 'critical';
-    initiatedBy?: string;
-    startedAt?: string;
+  workflowId: string;
+  workflowName: string;
+  workflowVersion?: string;
+  stepName?: string;
+  stepIndex?: number;
+  totalSteps?: number;
+  parentWorkflowId?: string;
+  correlationId?: string;
+  priority?: 'low' | 'normal' | 'high' | 'critical';
+  initiatedBy?: string;
+  startedAt?: string;
 };
 /**
  * Configuration for distributed workflow tracing
  */
 interface DistributedWorkflowConfig {
-    /** Workflow name/type (e.g., "OrderFulfillment", "UserOnboarding") */
-    name: string;
-    /**
-     * Extract workflow ID from function arguments
-     *
-     * Receives all arguments passed to the workflow function, allowing
-     * multi-parameter handlers to derive workflow IDs from any argument.
-     *
-     * @example Single argument
-     * ```typescript
-     * workflowIdFrom: (order) => order.id
-     * ```
-     *
-     * @example Multiple arguments (payload + metadata)
-     * ```typescript
-     * workflowIdFrom: (payload, metadata) => metadata.correlationId ?? payload.id
-     * ```
-     */
-    workflowIdFrom: (...args: unknown[]) => string;
-    /** Workflow version (e.g., "1.0.0", "2023-01-15") */
-    version?: string;
-    /** Total number of steps if known */
-    totalSteps?: number;
-    /** Parent workflow ID (for sub-workflows) */
-    parentWorkflowId?: string;
-    /** Correlation ID for external systems */
-    correlationId?: string;
-    /** Workflow priority */
-    priority?: 'low' | 'normal' | 'high' | 'critical';
-    /** User/system that initiated the workflow */
-    initiatedBy?: string;
-    /** Additional span attributes */
-    attributes?: Record<string, string | number | boolean>;
-    /** Callback on workflow start */
-    onStart?: (ctx: DistributedWorkflowContext) => void;
-    /** Callback on workflow completion */
-    onComplete?: (ctx: DistributedWorkflowContext, result: unknown) => void;
-    /** Callback on workflow error */
-    onError?: (ctx: DistributedWorkflowContext, error: Error) => void;
+  /** Workflow name/type (e.g., "OrderFulfillment", "UserOnboarding") */
+  name: string;
+  /**
+   * Extract workflow ID from function arguments
+   *
+   * Receives all arguments passed to the workflow function, allowing
+   * multi-parameter handlers to derive workflow IDs from any argument.
+   *
+   * @example Single argument
+   * ```typescript
+   * workflowIdFrom: (order) => order.id
+   * ```
+   *
+   * @example Multiple arguments (payload + metadata)
+   * ```typescript
+   * workflowIdFrom: (payload, metadata) => metadata.correlationId ?? payload.id
+   * ```
+   */
+  workflowIdFrom: (...args: unknown[]) => string;
+  /** Workflow version (e.g., "1.0.0", "2023-01-15") */
+  version?: string;
+  /** Total number of steps if known */
+  totalSteps?: number;
+  /** Parent workflow ID (for sub-workflows) */
+  parentWorkflowId?: string;
+  /** Correlation ID for external systems */
+  correlationId?: string;
+  /** Workflow priority */
+  priority?: 'low' | 'normal' | 'high' | 'critical';
+  /** User/system that initiated the workflow */
+  initiatedBy?: string;
+  /** Additional span attributes */
+  attributes?: Record<string, string | number | boolean>;
+  /** Callback on workflow start */
+  onStart?: (ctx: DistributedWorkflowContext) => void;
+  /** Callback on workflow completion */
+  onComplete?: (ctx: DistributedWorkflowContext, result: unknown) => void;
+  /** Callback on workflow error */
+  onError?: (ctx: DistributedWorkflowContext, error: Error) => void;
 }
 /**
  * Configuration for distributed workflow step
  */
 interface DistributedStepConfig {
-    /** Step name (e.g., "ReserveInventory", "ChargePayment") */
-    name: string;
-    /**
-     * Extract baggage from incoming message/request
-     *
-     * If true, reads workflow baggage from current context (assumes already extracted).
-     * If function, extracts from arguments.
-     *
-     * @default true
-     */
-    extractBaggage?: boolean | ((args: unknown[]) => WorkflowBaggageValues | null);
-    /** Override step index (otherwise uses baggage or auto-increments) */
-    stepIndex?: number;
-    /** Additional span attributes */
-    attributes?: Record<string, string | number | boolean>;
-    /** Whether this step is idempotent (safe to retry) */
-    idempotent?: boolean;
-    /** Whether this step is a compensation/rollback step */
-    isCompensation?: boolean;
-    /** Callback on step start */
-    onStart?: (ctx: DistributedStepContext) => void;
-    /** Callback on step completion */
-    onComplete?: (ctx: DistributedStepContext, result: unknown) => void;
-    /** Callback on step error */
-    onError?: (ctx: DistributedStepContext, error: Error) => void;
+  /** Step name (e.g., "ReserveInventory", "ChargePayment") */
+  name: string;
+  /**
+   * Extract baggage from incoming message/request
+   *
+   * If true, reads workflow baggage from current context (assumes already extracted).
+   * If function, extracts from arguments.
+   *
+   * @default true
+   */
+  extractBaggage?: boolean | ((args: unknown[]) => WorkflowBaggageValues | null);
+  /** Override step index (otherwise uses baggage or auto-increments) */
+  stepIndex?: number;
+  /** Additional span attributes */
+  attributes?: Record<string, string | number | boolean>;
+  /** Whether this step is idempotent (safe to retry) */
+  idempotent?: boolean;
+  /** Whether this step is a compensation/rollback step */
+  isCompensation?: boolean;
+  /** Callback on step start */
+  onStart?: (ctx: DistributedStepContext) => void;
+  /** Callback on step completion */
+  onComplete?: (ctx: DistributedStepContext, result: unknown) => void;
+  /** Callback on step error */
+  onError?: (ctx: DistributedStepContext, error: Error) => void;
 }
 /**
  * Extended context for distributed workflow root
  */
 interface DistributedWorkflowContext extends TraceContext {
-    /** The workflow ID */
-    workflowId: string;
-    /** The workflow name */
-    workflowName: string;
-    /** The workflow version */
-    workflowVersion?: string;
-    /** Get workflow baggage for propagation to other services */
-    getWorkflowBaggage(): WorkflowBaggageValues;
-    /** Set additional workflow baggage fields */
-    setWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;
-    /** Get headers with workflow baggage for outgoing requests */
-    getWorkflowHeaders(): Record<string, string>;
-    /** Record workflow step completion (for progress tracking) */
-    recordStepProgress(stepName: string, stepIndex: number): void;
+  /** The workflow ID */
+  workflowId: string;
+  /** The workflow name */
+  workflowName: string;
+  /** The workflow version */
+  workflowVersion?: string;
+  /** Get workflow baggage for propagation to other services */
+  getWorkflowBaggage(): WorkflowBaggageValues;
+  /** Set additional workflow baggage fields */
+  setWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;
+  /** Get headers with workflow baggage for outgoing requests */
+  getWorkflowHeaders(): Record<string, string>;
+  /** Record workflow step completion (for progress tracking) */
+  recordStepProgress(stepName: string, stepIndex: number): void;
 }
 /**
  * Extended context for distributed workflow step
  */
 interface DistributedStepContext extends TraceContext {
-    /** The workflow ID (from baggage) */
-    workflowId: string | null;
-    /** The workflow name (from baggage) */
-    workflowName: string | null;
-    /** The current step name */
-    stepName: string;
-    /** The current step index */
-    stepIndex: number | null;
-    /** Whether this step is a compensation */
-    isCompensation: boolean;
-    /** Get the full workflow baggage */
-    getWorkflowBaggage(): WorkflowBaggageValues | null;
-    /** Update workflow baggage (e.g., increment step index) */
-    updateWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;
-    /** Get headers with updated workflow baggage for downstream calls */
-    getWorkflowHeaders(): Record<string, string>;
-    /** Mark step as requiring compensation on failure */
-    requiresCompensation(compensationData?: Record<string, unknown>): void;
+  /** The workflow ID (from baggage) */
+  workflowId: string | null;
+  /** The workflow name (from baggage) */
+  workflowName: string | null;
+  /** The current step name */
+  stepName: string;
+  /** The current step index */
+  stepIndex: number | null;
+  /** Whether this step is a compensation */
+  isCompensation: boolean;
+  /** Get the full workflow baggage */
+  getWorkflowBaggage(): WorkflowBaggageValues | null;
+  /** Update workflow baggage (e.g., increment step index) */
+  updateWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;
+  /** Get headers with updated workflow baggage for downstream calls */
+  getWorkflowHeaders(): Record<string, string>;
+  /** Mark step as requiring compensation on failure */
+  requiresCompensation(compensationData?: Record<string, unknown>): void;
 }
 /**
  * Create a traced distributed workflow function
@@ -307,12 +296,12 @@ declare function isInDistributedWorkflow(ctx: TraceContext): boolean;
  * @returns Progress info or null if not in a workflow
  */
 declare function getWorkflowProgress(ctx: TraceContext): {
-    workflowId: string;
-    workflowName: string;
-    currentStep: string | null;
-    currentStepIndex: number | null;
-    totalSteps: number | null;
-    percentComplete: number | null;
+  workflowId: string;
+  workflowName: string;
+  currentStep: string | null;
+  currentStepIndex: number | null;
+  totalSteps: number | null;
+  percentComplete: number | null;
 } | null;
 /**
  * Create workflow correlation headers for manual propagation
@@ -341,5 +330,6 @@ declare function createWorkflowHeaders(values: Partial<WorkflowBaggageValues>):
  * @returns Parsed workflow values or null
  */
 declare function parseWorkflowFromBaggage(baggageHeader: string): Partial<WorkflowBaggageValues> | null;
-
-export { type DistributedStepConfig, type DistributedStepContext, type DistributedWorkflowConfig, type DistributedWorkflowContext, WorkflowBaggage, type WorkflowBaggageValues, createWorkflowHeaders, generateWorkflowId, getWorkflowProgress, isInDistributedWorkflow, parseWorkflowFromBaggage, traceDistributedStep, traceDistributedWorkflow };
+//#endregion
+export { DistributedStepConfig, DistributedStepContext, DistributedWorkflowConfig, DistributedWorkflowContext, WorkflowBaggage, WorkflowBaggageValues, createWorkflowHeaders, generateWorkflowId, getWorkflowProgress, isInDistributedWorkflow, parseWorkflowFromBaggage, traceDistributedStep, traceDistributedWorkflow };
+//# sourceMappingURL=workflow-distributed.d.ts.map

package/dist/workflow-distributed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-distributed.d.ts","names":[],"sources":["../src/workflow-distributed.ts"],"mappings":"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"}