autotel 2.26.3 → 3.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -23
- package/dist/attribute-redacting-processor.cjs +8 -8
- package/dist/attribute-redacting-processor.d.cts +10 -1
- package/dist/attribute-redacting-processor.d.ts +10 -1
- package/dist/attribute-redacting-processor.js +1 -1
- package/dist/attributes.cjs +21 -21
- package/dist/attributes.d.cts +3 -3
- package/dist/attributes.d.ts +3 -3
- package/dist/attributes.js +2 -2
- package/dist/auto.cjs +3 -3
- package/dist/auto.js +2 -2
- package/dist/business-baggage.d.cts +1 -1
- package/dist/business-baggage.d.ts +1 -1
- package/dist/chunk-4P6ZOARG.cjs +33 -0
- package/dist/chunk-4P6ZOARG.cjs.map +1 -0
- package/dist/{chunk-U54FTVFH.js → chunk-52PUSFC2.js} +3 -3
- package/dist/{chunk-U54FTVFH.js.map → chunk-52PUSFC2.js.map} +1 -1
- package/dist/{chunk-YEVCD6DR.cjs → chunk-7SMNC4LS.cjs} +7 -7
- package/dist/{chunk-YEVCD6DR.cjs.map → chunk-7SMNC4LS.cjs.map} +1 -1
- package/dist/{chunk-563EL6O6.cjs → chunk-BPO2PQ3T.cjs} +12 -8
- package/dist/chunk-BPO2PQ3T.cjs.map +1 -0
- package/dist/{chunk-WZOKY3PW.cjs → chunk-DAZ7EGR4.cjs} +19 -19
- package/dist/{chunk-WZOKY3PW.cjs.map → chunk-DAZ7EGR4.cjs.map} +1 -1
- package/dist/{chunk-ER43K7ES.js → chunk-DDXIUZEG.js} +3 -3
- package/dist/{chunk-ER43K7ES.js.map → chunk-DDXIUZEG.js.map} +1 -1
- package/dist/{chunk-JKIMEPI2.cjs → chunk-DQ2SUROF.cjs} +4 -4
- package/dist/{chunk-JKIMEPI2.cjs.map → chunk-DQ2SUROF.cjs.map} +1 -1
- package/dist/{chunk-B3ZHLLMP.js → chunk-DSMSIVTG.js} +2 -2
- package/dist/chunk-DSMSIVTG.js.map +1 -0
- package/dist/{chunk-OBWXM4NN.cjs → chunk-HKZHUGGN.cjs} +15 -14
- package/dist/chunk-HKZHUGGN.cjs.map +1 -0
- package/dist/{chunk-TDNKIHKT.js → chunk-JVWJDHDB.js} +13 -4
- package/dist/chunk-JVWJDHDB.js.map +1 -0
- package/dist/{chunk-YN7USLHW.js → chunk-K7HSRLP5.js} +11 -10
- package/dist/chunk-K7HSRLP5.js.map +1 -0
- package/dist/chunk-KIL5CUN6.js +31 -0
- package/dist/chunk-KIL5CUN6.js.map +1 -0
- package/dist/chunk-KKGM42RQ.cjs +1207 -0
- package/dist/chunk-KKGM42RQ.cjs.map +1 -0
- package/dist/{chunk-6YGUN7IY.cjs → chunk-MOO75VE4.cjs} +18 -17
- package/dist/chunk-MOO75VE4.cjs.map +1 -0
- package/dist/{chunk-GML3FBOT.cjs → chunk-NCSMD3TK.cjs} +2 -2
- package/dist/chunk-NCSMD3TK.cjs.map +1 -0
- package/dist/{chunk-CMNGGTQL.cjs → chunk-NXLRY2CE.cjs} +13 -4
- package/dist/chunk-NXLRY2CE.cjs.map +1 -0
- package/dist/{chunk-BJ2XPN77.js → chunk-OM4OSBOP.js} +5 -5
- package/dist/{chunk-BJ2XPN77.js.map → chunk-OM4OSBOP.js.map} +1 -1
- package/dist/{chunk-HPUGKUMZ.js → chunk-PMRWMRXY.js} +13 -640
- package/dist/chunk-PMRWMRXY.js.map +1 -0
- package/dist/{chunk-UTZR7P7E.cjs → chunk-QPH5ZKP5.cjs} +43 -673
- package/dist/chunk-QPH5ZKP5.cjs.map +1 -0
- package/dist/chunk-SEO6NAQT.js +14 -0
- package/dist/chunk-SEO6NAQT.js.map +1 -0
- package/dist/{chunk-QC5MNKVF.js → chunk-TFRZOUTV.js} +13 -12
- package/dist/chunk-TFRZOUTV.js.map +1 -0
- package/dist/chunk-VQTCQKHQ.cjs +17 -0
- package/dist/chunk-VQTCQKHQ.cjs.map +1 -0
- package/dist/chunk-Z7VAOK5X.js +1183 -0
- package/dist/chunk-Z7VAOK5X.js.map +1 -0
- package/dist/{chunk-W35FVJBC.js → chunk-ZDPIWKWD.js} +9 -5
- package/dist/chunk-ZDPIWKWD.js.map +1 -0
- package/dist/correlation-id.cjs +22 -10
- package/dist/correlation-id.js +14 -2
- package/dist/decorators.cjs +7 -8
- package/dist/decorators.cjs.map +1 -1
- package/dist/decorators.d.cts +1 -1
- package/dist/decorators.d.ts +1 -1
- package/dist/decorators.js +6 -7
- package/dist/decorators.js.map +1 -1
- package/dist/event.cjs +8 -9
- package/dist/event.js +5 -6
- package/dist/functional.cjs +13 -14
- package/dist/functional.d.cts +1 -1
- package/dist/functional.d.ts +1 -1
- package/dist/functional.js +6 -7
- package/dist/http.cjs +13 -2
- package/dist/http.cjs.map +1 -1
- package/dist/http.js +12 -1
- package/dist/http.js.map +1 -1
- package/dist/index.cjs +305 -280
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +89 -10
- package/dist/index.d.ts +89 -10
- package/dist/index.js +180 -181
- package/dist/index.js.map +1 -1
- package/dist/instrumentation.cjs +9 -9
- package/dist/instrumentation.js +2 -2
- package/dist/messaging-adapters.d.cts +1 -1
- package/dist/messaging-adapters.d.ts +1 -1
- package/dist/messaging-testing.d.cts +1 -1
- package/dist/messaging-testing.d.ts +1 -1
- package/dist/messaging.cjs +11 -11
- package/dist/messaging.d.cts +1 -1
- package/dist/messaging.d.ts +1 -1
- package/dist/messaging.js +8 -8
- package/dist/semantic-helpers.cjs +11 -12
- package/dist/semantic-helpers.d.cts +1 -1
- package/dist/semantic-helpers.d.ts +1 -1
- package/dist/semantic-helpers.js +7 -8
- package/dist/{trace-context-t5X1AP-e.d.cts → trace-context-DbGKd1Rn.d.cts} +18 -5
- package/dist/{trace-context-t5X1AP-e.d.ts → trace-context-DbGKd1Rn.d.ts} +18 -5
- package/dist/trace-helpers.cjs +13 -13
- package/dist/trace-helpers.d.cts +2 -2
- package/dist/trace-helpers.d.ts +2 -2
- package/dist/trace-helpers.js +1 -1
- package/dist/{utils-CbUkl8r1.d.cts → utils-BahBCFtJ.d.cts} +1 -1
- package/dist/{utils-Buel3cj0.d.ts → utils-CLKwaUlG.d.ts} +1 -1
- package/dist/webhook.cjs +21 -12
- package/dist/webhook.cjs.map +1 -1
- package/dist/webhook.d.cts +1 -1
- package/dist/webhook.d.ts +1 -1
- package/dist/webhook.js +20 -11
- package/dist/webhook.js.map +1 -1
- package/dist/workflow-distributed.cjs +25 -21
- package/dist/workflow-distributed.cjs.map +1 -1
- package/dist/workflow-distributed.d.cts +1 -1
- package/dist/workflow-distributed.d.ts +1 -1
- package/dist/workflow-distributed.js +23 -19
- package/dist/workflow-distributed.js.map +1 -1
- package/dist/workflow.cjs +12 -12
- package/dist/workflow.d.cts +1 -1
- package/dist/workflow.d.ts +1 -1
- package/dist/workflow.js +8 -8
- package/package.json +43 -45
- package/skills/analyze-traces/SKILL.md +178 -0
- package/skills/autotel-core/SKILL.md +2 -7
- package/skills/autotel-events/SKILL.md +2 -6
- package/skills/autotel-frameworks/SKILL.md +2 -9
- package/skills/autotel-instrumentation/SKILL.md +2 -7
- package/skills/autotel-request-logging/SKILL.md +2 -8
- package/skills/autotel-structured-errors/SKILL.md +2 -7
- package/skills/build-audit-trails/SKILL.md +302 -0
- package/skills/debug-missing-spans/SKILL.md +248 -0
- package/skills/migrate-to-autotel/SKILL.md +268 -0
- package/skills/review-otel-patterns/SKILL.md +488 -0
- package/skills/review-otel-patterns/references/code-review.md +75 -0
- package/skills/review-otel-patterns/references/processor-pipeline.md +205 -0
- package/skills/review-otel-patterns/references/structured-errors.md +102 -0
- package/skills/review-otel-patterns/references/wide-spans.md +85 -0
- package/skills/tune-sampling/SKILL.md +210 -0
- package/src/attribute-redacting-processor.test.ts +6 -4
- package/src/attribute-redacting-processor.ts +11 -2
- package/src/correlated-events.test.ts +151 -0
- package/src/correlated-events.ts +47 -0
- package/src/drain-toolkit.test.ts +113 -0
- package/src/drain-toolkit.ts +129 -0
- package/src/enricher-toolkit.test.ts +67 -0
- package/src/enricher-toolkit.ts +79 -0
- package/src/functional.ts +2 -0
- package/src/gen-ai-events.ts +14 -5
- package/src/index.ts +39 -4
- package/src/messaging.ts +10 -9
- package/src/redact-values.test.ts +24 -10
- package/src/redact-values.ts +9 -2
- package/src/request-logger.test.ts +91 -0
- package/src/request-logger.ts +40 -5
- package/src/structured-error.test.ts +86 -1
- package/src/structured-error.ts +9 -2
- package/src/trace-context.ts +39 -11
- package/src/trace-helpers.ts +2 -2
- package/src/trace-hybrid.test.ts +42 -0
- package/src/trace-hybrid.ts +37 -0
- package/src/webhook.ts +16 -7
- package/src/workflow-distributed.ts +18 -13
- package/src/workflow.ts +7 -6
- package/bin/intent.js +0 -6
- package/dist/chunk-563EL6O6.cjs.map +0 -1
- package/dist/chunk-6YGUN7IY.cjs.map +0 -1
- package/dist/chunk-B3ZHLLMP.js.map +0 -1
- package/dist/chunk-BBBWDIYQ.js +0 -211
- package/dist/chunk-BBBWDIYQ.js.map +0 -1
- package/dist/chunk-CMNGGTQL.cjs.map +0 -1
- package/dist/chunk-D5LMF53P.cjs +0 -150
- package/dist/chunk-D5LMF53P.cjs.map +0 -1
- package/dist/chunk-GML3FBOT.cjs.map +0 -1
- package/dist/chunk-HPUGKUMZ.js.map +0 -1
- package/dist/chunk-HZ3FYBJG.cjs +0 -217
- package/dist/chunk-HZ3FYBJG.cjs.map +0 -1
- package/dist/chunk-JSNUWSBH.cjs +0 -62
- package/dist/chunk-JSNUWSBH.cjs.map +0 -1
- package/dist/chunk-OBWXM4NN.cjs.map +0 -1
- package/dist/chunk-QC5MNKVF.js.map +0 -1
- package/dist/chunk-S4OFEXLA.js +0 -53
- package/dist/chunk-S4OFEXLA.js.map +0 -1
- package/dist/chunk-TDNKIHKT.js.map +0 -1
- package/dist/chunk-UTZR7P7E.cjs.map +0 -1
- package/dist/chunk-W35FVJBC.js.map +0 -1
- package/dist/chunk-WD4RP6IV.js +0 -146
- package/dist/chunk-WD4RP6IV.js.map +0 -1
- package/dist/chunk-YN7USLHW.js.map +0 -1
- package/src/package-manifest.test.ts +0 -24
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/workflow-distributed.ts"],"names":[],"mappings":"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","file":"workflow-distributed.js","sourcesContent":["/**\n * Distributed workflow tracing with cross-service correlation\n *\n * Enables tracking workflows that span multiple microservices by propagating\n * workflow identity (workflowId, stepName, stepIndex) via baggage in message headers.\n *\n * Unlike local workflow.ts (which uses AsyncLocalStorage), distributed workflows\n * propagate context across network boundaries using W3C baggage.\n *\n * @example Order fulfillment saga across services\n * ```typescript\n * // Service A: Order Service\n * import { traceDistributedWorkflow, WorkflowBaggage } from 'autotel/workflow-distributed';\n * import { traceProducer } from 'autotel/messaging';\n *\n * export const createOrder = traceDistributedWorkflow({\n * name: 'OrderFulfillment',\n * workflowIdFrom: (order) => order.id,\n * version: '1.0.0',\n * })(ctx => async (order: Order) => {\n * // Workflow baggage is auto-set\n * await publishToInventory(order);\n * });\n *\n * const publishToInventory = traceProducer({\n * system: 'kafka',\n * destination: 'inventory-requests',\n * propagateBaggage: true, // Includes workflow.* baggage\n * })(ctx => async (order) => {\n * await producer.send({ topic: 'inventory-requests', value: order });\n * });\n *\n * // Service B: Inventory Service\n * import { traceDistributedStep, WorkflowBaggage } from 'autotel/workflow-distributed';\n *\n * export const processInventory = traceDistributedStep({\n * name: 'ReserveInventory',\n * extractBaggage: true, // Extracts workflow.* from headers\n * })(ctx => async (message) => {\n * const workflow = WorkflowBaggage.get(ctx);\n * // workflow.workflowId === order.id (propagated from Service A)\n * console.log(`Processing step for workflow ${workflow.workflowId}`);\n * await reserveItems(message.items);\n * });\n * ```\n *\n * @module\n */\n\nimport { context, propagation, SpanKind } from '@opentelemetry/api';\nimport { createSafeBaggageSchema } from './business-baggage';\nimport { trace } from './functional';\nimport type { TraceContext } from './trace-context';\n\n// ============================================================================\n// Workflow Baggage Schema\n// ============================================================================\n\n/**\n * Workflow baggage field definitions\n */\nconst workflowBaggageFields = {\n /** Unique identifier for the workflow instance */\n workflowId: { type: 'string' as const, maxLength: 128, required: true },\n\n /** Name/type of the workflow (e.g., \"OrderFulfillment\") */\n workflowName: { type: 'string' as const, maxLength: 64, required: true },\n\n /** Version of the workflow definition */\n workflowVersion: { type: 'string' as const, maxLength: 32 },\n\n /** Current step name */\n stepName: { type: 'string' as const, maxLength: 64 },\n\n /** Current step index (0-based) */\n stepIndex: { type: 'number' as const },\n\n /** Total number of steps (if known) */\n totalSteps: { type: 'number' as const },\n\n /** Parent workflow ID (for sub-workflows) */\n parentWorkflowId: { type: 'string' as const, maxLength: 128 },\n\n /** Correlation ID for external systems */\n correlationId: { type: 'string' as const, maxLength: 128 },\n\n /** Workflow priority */\n priority: {\n type: 'enum' as const,\n values: ['low', 'normal', 'high', 'critical'] as const,\n },\n\n /** Initiating user/system */\n initiatedBy: { type: 'string' as const, maxLength: 64 },\n\n /** Workflow start timestamp (ISO) */\n startedAt: { type: 'string' as const, maxLength: 30 },\n} as const;\n\n/**\n * Pre-built baggage schema for distributed workflows\n *\n * Use this to read/write workflow context that propagates across services.\n *\n * @example Setting workflow baggage\n * ```typescript\n * WorkflowBaggage.set(ctx, {\n * workflowId: 'order-12345',\n * workflowName: 'OrderFulfillment',\n * stepName: 'ReserveInventory',\n * stepIndex: 1,\n * });\n * ```\n *\n * @example Reading workflow baggage in downstream service\n * ```typescript\n * const { workflowId, workflowName, stepIndex } = WorkflowBaggage.get(ctx);\n * console.log(`Processing ${workflowName} step ${stepIndex}`);\n * ```\n */\nexport const WorkflowBaggage = createSafeBaggageSchema(workflowBaggageFields, {\n prefix: 'workflow',\n hashHighCardinality: false, // Workflow IDs should be traceable\n redactPII: false, // Workflow fields are internal identifiers\n});\n\n/**\n * Type for workflow baggage values\n */\nexport type WorkflowBaggageValues = {\n workflowId: string;\n workflowName: string;\n workflowVersion?: string;\n stepName?: string;\n stepIndex?: number;\n totalSteps?: number;\n parentWorkflowId?: string;\n correlationId?: string;\n priority?: 'low' | 'normal' | 'high' | 'critical';\n initiatedBy?: string;\n startedAt?: string;\n};\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Configuration for distributed workflow tracing\n */\nexport interface DistributedWorkflowConfig {\n /** Workflow name/type (e.g., \"OrderFulfillment\", \"UserOnboarding\") */\n name: string;\n\n /**\n * Extract workflow ID from function arguments\n *\n * Receives all arguments passed to the workflow function, allowing\n * multi-parameter handlers to derive workflow IDs from any argument.\n *\n * @example Single argument\n * ```typescript\n * workflowIdFrom: (order) => order.id\n * ```\n *\n * @example Multiple arguments (payload + metadata)\n * ```typescript\n * workflowIdFrom: (payload, metadata) => metadata.correlationId ?? payload.id\n * ```\n */\n workflowIdFrom: (...args: unknown[]) => string;\n\n /** Workflow version (e.g., \"1.0.0\", \"2023-01-15\") */\n version?: string;\n\n /** Total number of steps if known */\n totalSteps?: number;\n\n /** Parent workflow ID (for sub-workflows) */\n parentWorkflowId?: string;\n\n /** Correlation ID for external systems */\n correlationId?: string;\n\n /** Workflow priority */\n priority?: 'low' | 'normal' | 'high' | 'critical';\n\n /** User/system that initiated the workflow */\n initiatedBy?: string;\n\n /** Additional span attributes */\n attributes?: Record<string, string | number | boolean>;\n\n /** Callback on workflow start */\n onStart?: (ctx: DistributedWorkflowContext) => void;\n\n /** Callback on workflow completion */\n onComplete?: (ctx: DistributedWorkflowContext, result: unknown) => void;\n\n /** Callback on workflow error */\n onError?: (ctx: DistributedWorkflowContext, error: Error) => void;\n}\n\n/**\n * Configuration for distributed workflow step\n */\nexport interface DistributedStepConfig {\n /** Step name (e.g., \"ReserveInventory\", \"ChargePayment\") */\n name: string;\n\n /**\n * Extract baggage from incoming message/request\n *\n * If true, reads workflow baggage from current context (assumes already extracted).\n * If function, extracts from arguments.\n *\n * @default true\n */\n extractBaggage?:\n | boolean\n | ((args: unknown[]) => WorkflowBaggageValues | null);\n\n /** Override step index (otherwise uses baggage or auto-increments) */\n stepIndex?: number;\n\n /** Additional span attributes */\n attributes?: Record<string, string | number | boolean>;\n\n /** Whether this step is idempotent (safe to retry) */\n idempotent?: boolean;\n\n /** Whether this step is a compensation/rollback step */\n isCompensation?: boolean;\n\n /** Callback on step start */\n onStart?: (ctx: DistributedStepContext) => void;\n\n /** Callback on step completion */\n onComplete?: (ctx: DistributedStepContext, result: unknown) => void;\n\n /** Callback on step error */\n onError?: (ctx: DistributedStepContext, error: Error) => void;\n}\n\n/**\n * Extended context for distributed workflow root\n */\nexport interface DistributedWorkflowContext extends TraceContext {\n /** The workflow ID */\n workflowId: string;\n\n /** The workflow name */\n workflowName: string;\n\n /** The workflow version */\n workflowVersion?: string;\n\n /** Get workflow baggage for propagation to other services */\n getWorkflowBaggage(): WorkflowBaggageValues;\n\n /** Set additional workflow baggage fields */\n setWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;\n\n /** Get headers with workflow baggage for outgoing requests */\n getWorkflowHeaders(): Record<string, string>;\n\n /** Record workflow step completion (for progress tracking) */\n recordStepProgress(stepName: string, stepIndex: number): void;\n}\n\n/**\n * Extended context for distributed workflow step\n */\nexport interface DistributedStepContext extends TraceContext {\n /** The workflow ID (from baggage) */\n workflowId: string | null;\n\n /** The workflow name (from baggage) */\n workflowName: string | null;\n\n /** The current step name */\n stepName: string;\n\n /** The current step index */\n stepIndex: number | null;\n\n /** Whether this step is a compensation */\n isCompensation: boolean;\n\n /** Get the full workflow baggage */\n getWorkflowBaggage(): WorkflowBaggageValues | null;\n\n /** Update workflow baggage (e.g., increment step index) */\n updateWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;\n\n /** Get headers with updated workflow baggage for downstream calls */\n getWorkflowHeaders(): Record<string, string>;\n\n /** Mark step as requiring compensation on failure */\n requiresCompensation(compensationData?: Record<string, unknown>): void;\n}\n\n// ============================================================================\n// Distributed Workflow Tracer\n// ============================================================================\n\n/**\n * Create a traced distributed workflow function\n *\n * Wraps a function as the entry point for a distributed workflow. Automatically:\n * - Generates or extracts workflow ID\n * - Sets workflow baggage for downstream propagation\n * - Creates root span with workflow attributes\n *\n * @param config - Workflow configuration\n * @returns Factory function for the workflow handler\n *\n * @example Basic usage\n * ```typescript\n * export const createOrder = traceDistributedWorkflow({\n * name: 'OrderFulfillment',\n * workflowIdFrom: (order) => order.id,\n * version: '1.0.0',\n * })(ctx => async (order: Order) => {\n * ctx.recordStepProgress('ValidateOrder', 0);\n * await validateOrder(order);\n *\n * ctx.recordStepProgress('ReserveInventory', 1);\n * await publishToInventoryService(order);\n *\n * return { workflowId: ctx.workflowId, status: 'started' };\n * });\n * ```\n */\nexport function traceDistributedWorkflow<TArgs extends unknown[], TReturn>(\n config: DistributedWorkflowConfig,\n) {\n const spanName = `workflow.${config.name}`;\n\n return (\n fnFactory: (\n ctx: DistributedWorkflowContext,\n ) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>(\n { name: spanName, spanKind: SpanKind.INTERNAL },\n (baseCtx) => {\n return async (...args: TArgs) => {\n // Extract workflow ID from arguments (spread to allow multi-arg access)\n const workflowId = config.workflowIdFrom(...args);\n const startedAt = new Date().toISOString();\n\n // Initialize workflow baggage\n const baggageValues: WorkflowBaggageValues = {\n workflowId,\n workflowName: config.name,\n workflowVersion: config.version,\n stepIndex: 0,\n totalSteps: config.totalSteps,\n parentWorkflowId: config.parentWorkflowId,\n correlationId: config.correlationId,\n priority: config.priority,\n initiatedBy: config.initiatedBy,\n startedAt,\n };\n\n // Set baggage\n WorkflowBaggage.set(baseCtx, baggageValues);\n\n // Set span attributes\n baseCtx.setAttribute('workflow.id', workflowId);\n baseCtx.setAttribute('workflow.name', config.name);\n if (config.version) {\n baseCtx.setAttribute('workflow.version', config.version);\n }\n if (config.totalSteps) {\n baseCtx.setAttribute('workflow.total_steps', config.totalSteps);\n }\n if (config.parentWorkflowId) {\n baseCtx.setAttribute('workflow.parent_id', config.parentWorkflowId);\n }\n if (config.priority) {\n baseCtx.setAttribute('workflow.priority', config.priority);\n }\n if (config.initiatedBy) {\n baseCtx.setAttribute('workflow.initiated_by', config.initiatedBy);\n }\n baseCtx.setAttribute('workflow.started_at', startedAt);\n\n // Apply custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n baseCtx.setAttribute(key, value);\n }\n }\n\n // Create extended context\n const workflowCtx: DistributedWorkflowContext = {\n ...baseCtx,\n workflowId,\n workflowName: config.name,\n workflowVersion: config.version,\n\n getWorkflowBaggage(): WorkflowBaggageValues {\n return { ...baggageValues };\n },\n\n setWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void {\n Object.assign(baggageValues, values);\n WorkflowBaggage.set(baseCtx, baggageValues);\n },\n\n getWorkflowHeaders(): Record<string, string> {\n const headers: Record<string, string> = {};\n const ctx = context.active();\n propagation.inject(ctx, headers);\n return headers;\n },\n\n recordStepProgress(stepName: string, stepIndex: number): void {\n baggageValues.stepName = stepName;\n baggageValues.stepIndex = stepIndex;\n WorkflowBaggage.set(baseCtx, baggageValues);\n\n baseCtx.addEvent('workflow.step_progress', {\n 'workflow.step.name': stepName,\n 'workflow.step.index': stepIndex,\n });\n },\n };\n\n // Call onStart callback\n config.onStart?.(workflowCtx);\n\n // Add start event\n baseCtx.addEvent('workflow.started', {\n 'workflow.id': workflowId,\n 'workflow.name': config.name,\n });\n\n try {\n const userFn = fnFactory(workflowCtx);\n const result = await userFn(...args);\n\n // Call onComplete callback\n config.onComplete?.(workflowCtx, result);\n\n // Add completion event\n baseCtx.addEvent('workflow.completed', {\n 'workflow.id': workflowId,\n });\n\n return result;\n } catch (error) {\n // Call onError callback\n config.onError?.(workflowCtx, error as Error);\n\n // Add error event\n baseCtx.addEvent('workflow.failed', {\n 'workflow.id': workflowId,\n 'workflow.error': (error as Error).message,\n });\n\n throw error;\n }\n };\n },\n );\n };\n}\n\n// ============================================================================\n// Distributed Step Tracer\n// ============================================================================\n\n/**\n * Create a traced distributed workflow step\n *\n * Use in downstream services to trace steps that are part of a distributed workflow.\n * Automatically extracts workflow baggage from the current context.\n *\n * @param config - Step configuration\n * @returns Factory function for the step handler\n *\n * @example Consumer in downstream service\n * ```typescript\n * export const processInventory = traceConsumer({\n * system: 'kafka',\n * destination: 'inventory-requests',\n * extractBaggage: true, // Extracts workflow.* from headers\n * })(ctx => {\n * // Wrap inner logic with traceDistributedStep\n * return traceDistributedStep({\n * name: 'ReserveInventory',\n * })(stepCtx => async (message) => {\n * console.log(`Processing workflow ${stepCtx.workflowId}`);\n * await reserveItems(message.items);\n * })(message);\n * });\n * ```\n *\n * @example Standalone step handler\n * ```typescript\n * export const reserveInventory = traceDistributedStep({\n * name: 'ReserveInventory',\n * idempotent: true,\n * })(ctx => async (request: InventoryRequest) => {\n * if (ctx.workflowId) {\n * console.log(`Part of workflow ${ctx.workflowId}, step ${ctx.stepIndex}`);\n * }\n * return await inventoryService.reserve(request.items);\n * });\n * ```\n */\nexport function traceDistributedStep<TArgs extends unknown[], TReturn>(\n config: DistributedStepConfig,\n) {\n const spanName = `workflow.step.${config.name}`;\n\n return (\n fnFactory: (\n ctx: DistributedStepContext,\n ) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>(\n { name: spanName, spanKind: SpanKind.INTERNAL },\n (baseCtx) => {\n return async (...args: TArgs) => {\n // Extract workflow baggage\n let baggageValues: WorkflowBaggageValues | null = null;\n\n const extractBaggage = config.extractBaggage ?? true;\n if (typeof extractBaggage === 'function') {\n baggageValues = extractBaggage(args);\n } else if (extractBaggage) {\n // Read from current context\n const extracted = WorkflowBaggage.get(baseCtx);\n if (extracted.workflowId && extracted.workflowName) {\n baggageValues = extracted as WorkflowBaggageValues;\n }\n }\n\n // Determine step index\n // If explicit stepIndex provided in config, use it\n // Otherwise, auto-increment from baggage if available\n let stepIndex: number | null;\n if (config.stepIndex !== undefined) {\n stepIndex = config.stepIndex;\n } else if (baggageValues?.stepIndex === undefined) {\n stepIndex = null;\n } else {\n // Auto-increment from previous step\n stepIndex = baggageValues.stepIndex + 1;\n }\n\n // Update baggage with current step\n if (baggageValues) {\n baggageValues.stepName = config.name;\n if (stepIndex !== null) {\n baggageValues.stepIndex = stepIndex;\n }\n WorkflowBaggage.set(baseCtx, baggageValues);\n }\n\n // Set span attributes\n baseCtx.setAttribute('workflow.step.name', config.name);\n if (stepIndex !== null) {\n baseCtx.setAttribute('workflow.step.index', stepIndex);\n }\n if (config.idempotent !== undefined) {\n baseCtx.setAttribute('workflow.step.idempotent', config.idempotent);\n }\n if (config.isCompensation) {\n baseCtx.setAttribute('workflow.step.is_compensation', true);\n }\n\n // Add workflow context attributes if available\n if (baggageValues) {\n baseCtx.setAttribute('workflow.id', baggageValues.workflowId);\n baseCtx.setAttribute('workflow.name', baggageValues.workflowName);\n if (baggageValues.workflowVersion) {\n baseCtx.setAttribute(\n 'workflow.version',\n baggageValues.workflowVersion,\n );\n }\n if (baggageValues.totalSteps) {\n baseCtx.setAttribute(\n 'workflow.total_steps',\n baggageValues.totalSteps,\n );\n }\n }\n\n // Apply custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n baseCtx.setAttribute(key, value);\n }\n }\n\n // Compensation data storage\n let compensationData: Record<string, unknown> | undefined;\n\n // Create extended context\n const stepCtx: DistributedStepContext = {\n ...baseCtx,\n workflowId: baggageValues?.workflowId ?? null,\n workflowName: baggageValues?.workflowName ?? null,\n stepName: config.name,\n stepIndex,\n isCompensation: config.isCompensation ?? false,\n\n getWorkflowBaggage(): WorkflowBaggageValues | null {\n return baggageValues ? { ...baggageValues } : null;\n },\n\n updateWorkflowBaggage(\n values: Partial<WorkflowBaggageValues>,\n ): void {\n if (baggageValues) {\n Object.assign(baggageValues, values);\n WorkflowBaggage.set(baseCtx, baggageValues);\n }\n },\n\n getWorkflowHeaders(): Record<string, string> {\n const headers: Record<string, string> = {};\n const ctx = context.active();\n propagation.inject(ctx, headers);\n return headers;\n },\n\n requiresCompensation(data?: Record<string, unknown>): void {\n compensationData = data;\n baseCtx.setAttribute('workflow.step.requires_compensation', true);\n baseCtx.addEvent('workflow.step.compensation_registered', {\n 'workflow.step.name': config.name,\n ...(data && {\n 'workflow.step.compensation_data': JSON.stringify(data),\n }),\n });\n },\n };\n\n // Call onStart callback\n config.onStart?.(stepCtx);\n\n // Add start event\n baseCtx.addEvent('workflow.step.started', {\n 'workflow.step.name': config.name,\n ...(baggageValues && { 'workflow.id': baggageValues.workflowId }),\n });\n\n try {\n const userFn = fnFactory(stepCtx);\n const result = await userFn(...args);\n\n // Call onComplete callback\n config.onComplete?.(stepCtx, result);\n\n // Add completion event\n baseCtx.addEvent('workflow.step.completed', {\n 'workflow.step.name': config.name,\n });\n\n return result;\n } catch (error) {\n // Call onError callback\n config.onError?.(stepCtx, error as Error);\n\n // Add error event with compensation info if registered\n baseCtx.addEvent('workflow.step.failed', {\n 'workflow.step.name': config.name,\n 'workflow.step.error': (error as Error).message,\n ...(compensationData && {\n 'workflow.step.requires_compensation': true,\n }),\n });\n\n throw error;\n }\n };\n },\n );\n };\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Generate a unique workflow ID\n *\n * @param prefix - Optional prefix for the ID\n * @returns A unique workflow ID\n *\n * @example\n * ```typescript\n * const workflowId = generateWorkflowId('order'); // \"order-abc123def456\"\n * ```\n */\nexport function generateWorkflowId(prefix?: string): string {\n const random = Math.random().toString(36).slice(2, 15);\n const timestamp = Date.now().toString(36);\n const id = `${timestamp}-${random}`;\n return prefix ? `${prefix}-${id}` : id;\n}\n\n/**\n * Check if the current context is part of a distributed workflow\n *\n * @param ctx - The trace context\n * @returns True if workflow baggage is present\n */\nexport function isInDistributedWorkflow(ctx: TraceContext): boolean {\n const baggage = WorkflowBaggage.get(ctx);\n return !!(baggage.workflowId && baggage.workflowName);\n}\n\n/**\n * Get workflow progress information\n *\n * @param ctx - The trace context\n * @returns Progress info or null if not in a workflow\n */\nexport function getWorkflowProgress(ctx: TraceContext): {\n workflowId: string;\n workflowName: string;\n currentStep: string | null;\n currentStepIndex: number | null;\n totalSteps: number | null;\n percentComplete: number | null;\n} | null {\n const baggage = WorkflowBaggage.get(ctx);\n if (!baggage.workflowId || !baggage.workflowName) {\n return null;\n }\n\n const percentComplete =\n baggage.totalSteps && baggage.stepIndex !== undefined\n ? Math.round(((baggage.stepIndex + 1) / baggage.totalSteps) * 100)\n : null;\n\n return {\n workflowId: baggage.workflowId,\n workflowName: baggage.workflowName,\n currentStep: baggage.stepName ?? null,\n currentStepIndex: baggage.stepIndex ?? null,\n totalSteps: baggage.totalSteps ?? null,\n percentComplete,\n };\n}\n\n/**\n * Create workflow correlation headers for manual propagation\n *\n * Use when you need to manually add workflow context to outgoing requests.\n *\n * @param values - Workflow baggage values\n * @returns Headers object with workflow baggage\n *\n * @example\n * ```typescript\n * const headers = createWorkflowHeaders({\n * workflowId: 'order-123',\n * workflowName: 'OrderFulfillment',\n * stepIndex: 2,\n * });\n *\n * await fetch('/api/inventory', { headers });\n * ```\n */\nexport function createWorkflowHeaders(\n values: Partial<WorkflowBaggageValues>,\n): Record<string, string> {\n const headers: Record<string, string> = {};\n\n // Build baggage string\n const baggageEntries: string[] = [];\n\n if (values.workflowId) {\n baggageEntries.push(\n `workflow.workflowId=${encodeURIComponent(values.workflowId)}`,\n );\n }\n if (values.workflowName) {\n baggageEntries.push(\n `workflow.workflowName=${encodeURIComponent(values.workflowName)}`,\n );\n }\n if (values.workflowVersion) {\n baggageEntries.push(\n `workflow.workflowVersion=${encodeURIComponent(values.workflowVersion)}`,\n );\n }\n if (values.stepName) {\n baggageEntries.push(\n `workflow.stepName=${encodeURIComponent(values.stepName)}`,\n );\n }\n if (values.stepIndex !== undefined) {\n baggageEntries.push(`workflow.stepIndex=${values.stepIndex}`);\n }\n if (values.totalSteps !== undefined) {\n baggageEntries.push(`workflow.totalSteps=${values.totalSteps}`);\n }\n if (values.priority) {\n baggageEntries.push(`workflow.priority=${values.priority}`);\n }\n if (values.correlationId) {\n baggageEntries.push(\n `workflow.correlationId=${encodeURIComponent(values.correlationId)}`,\n );\n }\n if (values.parentWorkflowId) {\n baggageEntries.push(\n `workflow.parentWorkflowId=${encodeURIComponent(values.parentWorkflowId)}`,\n );\n }\n if (values.initiatedBy) {\n baggageEntries.push(\n `workflow.initiatedBy=${encodeURIComponent(values.initiatedBy)}`,\n );\n }\n if (values.startedAt) {\n baggageEntries.push(\n `workflow.startedAt=${encodeURIComponent(values.startedAt)}`,\n );\n }\n\n if (baggageEntries.length > 0) {\n headers['baggage'] = baggageEntries.join(',');\n }\n\n return headers;\n}\n\n/**\n * Parse workflow context from baggage header\n *\n * @param baggageHeader - The baggage header value\n * @returns Parsed workflow values or null\n */\nexport function parseWorkflowFromBaggage(\n baggageHeader: string,\n): Partial<WorkflowBaggageValues> | null {\n if (!baggageHeader) {\n return null;\n }\n\n const values: Partial<WorkflowBaggageValues> = {};\n const entries = baggageHeader.split(',');\n\n for (const entry of entries) {\n const [key, value] = entry.trim().split('=');\n if (!key || !value) continue;\n\n const decodedValue = decodeURIComponent(value);\n\n switch (key) {\n case 'workflow.workflowId': {\n values.workflowId = decodedValue;\n break;\n }\n case 'workflow.workflowName': {\n values.workflowName = decodedValue;\n break;\n }\n case 'workflow.workflowVersion': {\n values.workflowVersion = decodedValue;\n break;\n }\n case 'workflow.stepName': {\n values.stepName = decodedValue;\n break;\n }\n case 'workflow.stepIndex': {\n values.stepIndex = Number.parseInt(decodedValue, 10);\n break;\n }\n case 'workflow.totalSteps': {\n values.totalSteps = Number.parseInt(decodedValue, 10);\n break;\n }\n case 'workflow.priority': {\n values.priority = decodedValue as WorkflowBaggageValues['priority'];\n break;\n }\n case 'workflow.correlationId': {\n values.correlationId = decodedValue;\n break;\n }\n case 'workflow.parentWorkflowId': {\n values.parentWorkflowId = decodedValue;\n break;\n }\n case 'workflow.initiatedBy': {\n values.initiatedBy = decodedValue;\n break;\n }\n case 'workflow.startedAt': {\n values.startedAt = decodedValue;\n break;\n }\n }\n }\n\n return Object.keys(values).length > 0 ? values : null;\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/workflow-distributed.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA8DA,IAAM,qBAAA,GAAwB;AAAA;AAAA,EAE5B,YAAY,EAAE,IAAA,EAAM,UAAmB,SAAA,EAAW,GAAA,EAAK,UAAU,IAAA,EAAK;AAAA;AAAA,EAGtE,cAAc,EAAE,IAAA,EAAM,UAAmB,SAAA,EAAW,EAAA,EAAI,UAAU,IAAA,EAAK;AAAA;AAAA,EAGvE,eAAA,EAAiB,EAAE,IAAA,EAAM,QAAA,EAAmB,WAAW,EAAA,EAAG;AAAA;AAAA,EAG1D,QAAA,EAAU,EAAE,IAAA,EAAM,QAAA,EAAmB,WAAW,EAAA,EAAG;AAAA;AAAA,EAGnD,SAAA,EAAW,EAAE,IAAA,EAAM,QAAA,EAAkB;AAAA;AAAA,EAGrC,UAAA,EAAY,EAAE,IAAA,EAAM,QAAA,EAAkB;AAAA;AAAA,EAGtC,gBAAA,EAAkB,EAAE,IAAA,EAAM,QAAA,EAAmB,WAAW,GAAA,EAAI;AAAA;AAAA,EAG5D,aAAA,EAAe,EAAE,IAAA,EAAM,QAAA,EAAmB,WAAW,GAAA,EAAI;AAAA;AAAA,EAGzD,QAAA,EAAU;AAAA,IACR,IAAA,EAAM,MAAA;AAAA,IACN,MAAA,EAAQ,CAAC,KAAA,EAAO,QAAA,EAAU,QAAQ,UAAU;AAAA,GAC9C;AAAA;AAAA,EAGA,WAAA,EAAa,EAAE,IAAA,EAAM,QAAA,EAAmB,WAAW,EAAA,EAAG;AAAA;AAAA,EAGtD,SAAA,EAAW,EAAE,IAAA,EAAM,QAAA,EAAmB,WAAW,EAAA;AACnD,CAAA;AAuBO,IAAM,eAAA,GAAkB,wBAAwB,qBAAA,EAAuB;AAAA,EAC5E,MAAA,EAAQ,UAAA;AAAA,EACR,mBAAA,EAAqB,KAAA;AAAA;AAAA,EACrB,SAAA,EAAW;AAAA;AACb,CAAC;AAkNM,SAAS,yBACd,MAAA,EACA;AACA,EAAA,MAAM,QAAA,GAAW,CAAA,SAAA,EAAY,MAAA,CAAO,IAAI,CAAA,CAAA;AAExC,EAAA,OAAO,CACL,SAAA,KAG2C;AAC3C,IAAA,OAAO,KAAA;AAAA,MACL,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,SAAS,QAAA,EAAS;AAAA,MAC9C,CAAC,OAAA,KAAY;AACX,QAAA,OAAO,UAAU,IAAA,KAAgB;AAE/B,UAAA,MAAM,UAAA,GAAa,MAAA,CAAO,cAAA,CAAe,GAAG,IAAI,CAAA;AAChD,UAAA,MAAM,SAAA,GAAA,iBAAY,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAGzC,UAAA,MAAM,aAAA,GAAuC;AAAA,YAC3C,UAAA;AAAA,YACA,cAAc,MAAA,CAAO,IAAA;AAAA,YACrB,iBAAiB,MAAA,CAAO,OAAA;AAAA,YACxB,SAAA,EAAW,CAAA;AAAA,YACX,YAAY,MAAA,CAAO,UAAA;AAAA,YACnB,kBAAkB,MAAA,CAAO,gBAAA;AAAA,YACzB,eAAe,MAAA,CAAO,aAAA;AAAA,YACtB,UAAU,MAAA,CAAO,QAAA;AAAA,YACjB,aAAa,MAAA,CAAO,WAAA;AAAA,YACpB;AAAA,WACF;AAGA,UAAA,eAAA,CAAgB,GAAA,CAAI,SAAS,aAAa,CAAA;AAG1C,UAAA,OAAA,CAAQ,YAAA,CAAa,eAAe,UAAU,CAAA;AAC9C,UAAA,OAAA,CAAQ,YAAA,CAAa,eAAA,EAAiB,MAAA,CAAO,IAAI,CAAA;AACjD,UAAA,IAAI,OAAO,OAAA,EAAS;AAClB,YAAA,OAAA,CAAQ,YAAA,CAAa,kBAAA,EAAoB,MAAA,CAAO,OAAO,CAAA;AAAA,UACzD;AACA,UAAA,IAAI,OAAO,UAAA,EAAY;AACrB,YAAA,OAAA,CAAQ,YAAA,CAAa,sBAAA,EAAwB,MAAA,CAAO,UAAU,CAAA;AAAA,UAChE;AACA,UAAA,IAAI,OAAO,gBAAA,EAAkB;AAC3B,YAAA,OAAA,CAAQ,YAAA,CAAa,oBAAA,EAAsB,MAAA,CAAO,gBAAgB,CAAA;AAAA,UACpE;AACA,UAAA,IAAI,OAAO,QAAA,EAAU;AACnB,YAAA,OAAA,CAAQ,YAAA,CAAa,mBAAA,EAAqB,MAAA,CAAO,QAAQ,CAAA;AAAA,UAC3D;AACA,UAAA,IAAI,OAAO,WAAA,EAAa;AACtB,YAAA,OAAA,CAAQ,YAAA,CAAa,uBAAA,EAAyB,MAAA,CAAO,WAAW,CAAA;AAAA,UAClE;AACA,UAAA,OAAA,CAAQ,YAAA,CAAa,uBAAuB,SAAS,CAAA;AAGrD,UAAA,IAAI,OAAO,UAAA,EAAY;AACrB,YAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA,EAAG;AAC5D,cAAA,OAAA,CAAQ,YAAA,CAAa,KAAK,KAAK,CAAA;AAAA,YACjC;AAAA,UACF;AAGA,UAAA,MAAM,WAAA,GAA0C;AAAA,YAC9C,GAAG,OAAA;AAAA,YACH,UAAA;AAAA,YACA,cAAc,MAAA,CAAO,IAAA;AAAA,YACrB,iBAAiB,MAAA,CAAO,OAAA;AAAA,YAExB,kBAAA,GAA4C;AAC1C,cAAA,OAAO,EAAE,GAAG,aAAA,EAAc;AAAA,YAC5B,CAAA;AAAA,YAEA,mBAAmB,MAAA,EAA8C;AAC/D,cAAA,MAAA,CAAO,MAAA,CAAO,eAAe,MAAM,CAAA;AACnC,cAAA,eAAA,CAAgB,GAAA,CAAI,SAAS,aAAa,CAAA;AAAA,YAC5C,CAAA;AAAA,YAEA,kBAAA,GAA6C;AAC3C,cAAA,MAAM,UAAkC,EAAC;AACzC,cAAA,MAAM,GAAA,GAAM,QAAQ,MAAA,EAAO;AAC3B,cAAA,WAAA,CAAY,MAAA,CAAO,KAAK,OAAO,CAAA;AAC/B,cAAA,OAAO,OAAA;AAAA,YACT,CAAA;AAAA,YAEA,kBAAA,CAAmB,UAAkB,SAAA,EAAyB;AAC5D,cAAA,aAAA,CAAc,QAAA,GAAW,QAAA;AACzB,cAAA,aAAA,CAAc,SAAA,GAAY,SAAA;AAC1B,cAAA,eAAA,CAAgB,GAAA,CAAI,SAAS,aAAa,CAAA;AAE1C,cAAA,mBAAA,CAAoB,SAAS,wBAAA,EAA0B;AAAA,gBACrD,oBAAA,EAAsB,QAAA;AAAA,gBACtB,qBAAA,EAAuB;AAAA,eACxB,CAAA;AAAA,YACH;AAAA,WACF;AAGA,UAAA,MAAA,CAAO,UAAU,WAAW,CAAA;AAG5B,UAAA,mBAAA,CAAoB,SAAS,kBAAA,EAAoB;AAAA,YAC/C,aAAA,EAAe,UAAA;AAAA,YACf,iBAAiB,MAAA,CAAO;AAAA,WACzB,CAAA;AAED,UAAA,IAAI;AACF,YAAA,MAAM,MAAA,GAAS,UAAU,WAAW,CAAA;AACpC,YAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,GAAG,IAAI,CAAA;AAGnC,YAAA,MAAA,CAAO,UAAA,GAAa,aAAa,MAAM,CAAA;AAGvC,YAAA,mBAAA,CAAoB,SAAS,oBAAA,EAAsB;AAAA,cACjD,aAAA,EAAe;AAAA,aAChB,CAAA;AAED,YAAA,OAAO,MAAA;AAAA,UACT,SAAS,KAAA,EAAO;AAEd,YAAA,MAAA,CAAO,OAAA,GAAU,aAAa,KAAc,CAAA;AAG5C,YAAA,mBAAA,CAAoB,SAAS,iBAAA,EAAmB;AAAA,cAC9C,aAAA,EAAe,UAAA;AAAA,cACf,kBAAmB,KAAA,CAAgB;AAAA,aACpC,CAAA;AAED,YAAA,MAAM,KAAA;AAAA,UACR;AAAA,QACF,CAAA;AAAA,MACF;AAAA,KACF;AAAA,EACF,CAAA;AACF;AA6CO,SAAS,qBACd,MAAA,EACA;AACA,EAAA,MAAM,QAAA,GAAW,CAAA,cAAA,EAAiB,MAAA,CAAO,IAAI,CAAA,CAAA;AAE7C,EAAA,OAAO,CACL,SAAA,KAG2C;AAC3C,IAAA,OAAO,KAAA;AAAA,MACL,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,SAAS,QAAA,EAAS;AAAA,MAC9C,CAAC,OAAA,KAAY;AACX,QAAA,OAAO,UAAU,IAAA,KAAgB;AAE/B,UAAA,IAAI,aAAA,GAA8C,IAAA;AAElD,UAAA,MAAM,cAAA,GAAiB,OAAO,cAAA,IAAkB,IAAA;AAChD,UAAA,IAAI,OAAO,mBAAmB,UAAA,EAAY;AACxC,YAAA,aAAA,GAAgB,eAAe,IAAI,CAAA;AAAA,UACrC,WAAW,cAAA,EAAgB;AAEzB,YAAA,MAAM,SAAA,GAAY,eAAA,CAAgB,GAAA,CAAI,OAAO,CAAA;AAC7C,YAAA,IAAI,SAAA,CAAU,UAAA,IAAc,SAAA,CAAU,YAAA,EAAc;AAClD,cAAA,aAAA,GAAgB,SAAA;AAAA,YAClB;AAAA,UACF;AAKA,UAAA,IAAI,SAAA;AACJ,UAAA,IAAI,MAAA,CAAO,cAAc,MAAA,EAAW;AAClC,YAAA,SAAA,GAAY,MAAA,CAAO,SAAA;AAAA,UACrB,CAAA,MAAA,IAAW,aAAA,EAAe,SAAA,KAAc,MAAA,EAAW;AACjD,YAAA,SAAA,GAAY,IAAA;AAAA,UACd,CAAA,MAAO;AAEL,YAAA,SAAA,GAAY,cAAc,SAAA,GAAY,CAAA;AAAA,UACxC;AAGA,UAAA,IAAI,aAAA,EAAe;AACjB,YAAA,aAAA,CAAc,WAAW,MAAA,CAAO,IAAA;AAChC,YAAA,IAAI,cAAc,IAAA,EAAM;AACtB,cAAA,aAAA,CAAc,SAAA,GAAY,SAAA;AAAA,YAC5B;AACA,YAAA,eAAA,CAAgB,GAAA,CAAI,SAAS,aAAa,CAAA;AAAA,UAC5C;AAGA,UAAA,OAAA,CAAQ,YAAA,CAAa,oBAAA,EAAsB,MAAA,CAAO,IAAI,CAAA;AACtD,UAAA,IAAI,cAAc,IAAA,EAAM;AACtB,YAAA,OAAA,CAAQ,YAAA,CAAa,uBAAuB,SAAS,CAAA;AAAA,UACvD;AACA,UAAA,IAAI,MAAA,CAAO,eAAe,MAAA,EAAW;AACnC,YAAA,OAAA,CAAQ,YAAA,CAAa,0BAAA,EAA4B,MAAA,CAAO,UAAU,CAAA;AAAA,UACpE;AACA,UAAA,IAAI,OAAO,cAAA,EAAgB;AACzB,YAAA,OAAA,CAAQ,YAAA,CAAa,iCAAiC,IAAI,CAAA;AAAA,UAC5D;AAGA,UAAA,IAAI,aAAA,EAAe;AACjB,YAAA,OAAA,CAAQ,YAAA,CAAa,aAAA,EAAe,aAAA,CAAc,UAAU,CAAA;AAC5D,YAAA,OAAA,CAAQ,YAAA,CAAa,eAAA,EAAiB,aAAA,CAAc,YAAY,CAAA;AAChE,YAAA,IAAI,cAAc,eAAA,EAAiB;AACjC,cAAA,OAAA,CAAQ,YAAA;AAAA,gBACN,kBAAA;AAAA,gBACA,aAAA,CAAc;AAAA,eAChB;AAAA,YACF;AACA,YAAA,IAAI,cAAc,UAAA,EAAY;AAC5B,cAAA,OAAA,CAAQ,YAAA;AAAA,gBACN,sBAAA;AAAA,gBACA,aAAA,CAAc;AAAA,eAChB;AAAA,YACF;AAAA,UACF;AAGA,UAAA,IAAI,OAAO,UAAA,EAAY;AACrB,YAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA,EAAG;AAC5D,cAAA,OAAA,CAAQ,YAAA,CAAa,KAAK,KAAK,CAAA;AAAA,YACjC;AAAA,UACF;AAGA,UAAA,IAAI,gBAAA;AAGJ,UAAA,MAAM,OAAA,GAAkC;AAAA,YACtC,GAAG,OAAA;AAAA,YACH,UAAA,EAAY,eAAe,UAAA,IAAc,IAAA;AAAA,YACzC,YAAA,EAAc,eAAe,YAAA,IAAgB,IAAA;AAAA,YAC7C,UAAU,MAAA,CAAO,IAAA;AAAA,YACjB,SAAA;AAAA,YACA,cAAA,EAAgB,OAAO,cAAA,IAAkB,KAAA;AAAA,YAEzC,kBAAA,GAAmD;AACjD,cAAA,OAAO,aAAA,GAAgB,EAAE,GAAG,aAAA,EAAc,GAAI,IAAA;AAAA,YAChD,CAAA;AAAA,YAEA,sBACE,MAAA,EACM;AACN,cAAA,IAAI,aAAA,EAAe;AACjB,gBAAA,MAAA,CAAO,MAAA,CAAO,eAAe,MAAM,CAAA;AACnC,gBAAA,eAAA,CAAgB,GAAA,CAAI,SAAS,aAAa,CAAA;AAAA,cAC5C;AAAA,YACF,CAAA;AAAA,YAEA,kBAAA,GAA6C;AAC3C,cAAA,MAAM,UAAkC,EAAC;AACzC,cAAA,MAAM,GAAA,GAAM,QAAQ,MAAA,EAAO;AAC3B,cAAA,WAAA,CAAY,MAAA,CAAO,KAAK,OAAO,CAAA;AAC/B,cAAA,OAAO,OAAA;AAAA,YACT,CAAA;AAAA,YAEA,qBAAqB,IAAA,EAAsC;AACzD,cAAA,gBAAA,GAAmB,IAAA;AACnB,cAAA,OAAA,CAAQ,YAAA,CAAa,uCAAuC,IAAI,CAAA;AAChE,cAAA,mBAAA;AAAA,gBACE,OAAA;AAAA,gBACA,uCAAA;AAAA,gBACA;AAAA,kBACE,sBAAsB,MAAA,CAAO,IAAA;AAAA,kBAC7B,GAAI,IAAA,IAAQ;AAAA,oBACV,iCAAA,EAAmC,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA;AACxD;AACF,eACF;AAAA,YACF;AAAA,WACF;AAGA,UAAA,MAAA,CAAO,UAAU,OAAO,CAAA;AAGxB,UAAA,mBAAA,CAAoB,SAAS,uBAAA,EAAyB;AAAA,YACpD,sBAAsB,MAAA,CAAO,IAAA;AAAA,YAC7B,GAAI,aAAA,IAAiB,EAAE,aAAA,EAAe,cAAc,UAAA;AAAW,WAChE,CAAA;AAED,UAAA,IAAI;AACF,YAAA,MAAM,MAAA,GAAS,UAAU,OAAO,CAAA;AAChC,YAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,GAAG,IAAI,CAAA;AAGnC,YAAA,MAAA,CAAO,UAAA,GAAa,SAAS,MAAM,CAAA;AAGnC,YAAA,mBAAA,CAAoB,SAAS,yBAAA,EAA2B;AAAA,cACtD,sBAAsB,MAAA,CAAO;AAAA,aAC9B,CAAA;AAED,YAAA,OAAO,MAAA;AAAA,UACT,SAAS,KAAA,EAAO;AAEd,YAAA,MAAA,CAAO,OAAA,GAAU,SAAS,KAAc,CAAA;AAGxC,YAAA,mBAAA,CAAoB,SAAS,sBAAA,EAAwB;AAAA,cACnD,sBAAsB,MAAA,CAAO,IAAA;AAAA,cAC7B,uBAAwB,KAAA,CAAgB,OAAA;AAAA,cACxC,GAAI,gBAAA,IAAoB;AAAA,gBACtB,qCAAA,EAAuC;AAAA;AACzC,aACD,CAAA;AAED,YAAA,MAAM,KAAA;AAAA,UACR;AAAA,QACF,CAAA;AAAA,MACF;AAAA,KACF;AAAA,EACF,CAAA;AACF;AAiBO,SAAS,mBAAmB,MAAA,EAAyB;AAC1D,EAAA,MAAM,MAAA,GAAS,KAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA;AACrD,EAAA,MAAM,SAAA,GAAY,IAAA,CAAK,GAAA,EAAI,CAAE,SAAS,EAAE,CAAA;AACxC,EAAA,MAAM,EAAA,GAAK,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA;AACjC,EAAA,OAAO,MAAA,GAAS,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,EAAE,CAAA,CAAA,GAAK,EAAA;AACtC;AAQO,SAAS,wBAAwB,GAAA,EAA4B;AAClE,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,GAAA,CAAI,GAAG,CAAA;AACvC,EAAA,OAAO,CAAC,EAAE,OAAA,CAAQ,UAAA,IAAc,OAAA,CAAQ,YAAA,CAAA;AAC1C;AAQO,SAAS,oBAAoB,GAAA,EAO3B;AACP,EAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,GAAA,CAAI,GAAG,CAAA;AACvC,EAAA,IAAI,CAAC,OAAA,CAAQ,UAAA,IAAc,CAAC,QAAQ,YAAA,EAAc;AAChD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,eAAA,GACJ,OAAA,CAAQ,UAAA,IAAc,OAAA,CAAQ,cAAc,MAAA,GACxC,IAAA,CAAK,KAAA,CAAA,CAAQ,OAAA,CAAQ,SAAA,GAAY,CAAA,IAAK,OAAA,CAAQ,UAAA,GAAc,GAAG,CAAA,GAC/D,IAAA;AAEN,EAAA,OAAO;AAAA,IACL,YAAY,OAAA,CAAQ,UAAA;AAAA,IACpB,cAAc,OAAA,CAAQ,YAAA;AAAA,IACtB,WAAA,EAAa,QAAQ,QAAA,IAAY,IAAA;AAAA,IACjC,gBAAA,EAAkB,QAAQ,SAAA,IAAa,IAAA;AAAA,IACvC,UAAA,EAAY,QAAQ,UAAA,IAAc,IAAA;AAAA,IAClC;AAAA,GACF;AACF;AAqBO,SAAS,sBACd,MAAA,EACwB;AACxB,EAAA,MAAM,UAAkC,EAAC;AAGzC,EAAA,MAAM,iBAA2B,EAAC;AAElC,EAAA,IAAI,OAAO,UAAA,EAAY;AACrB,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,oBAAA,EAAuB,kBAAA,CAAmB,MAAA,CAAO,UAAU,CAAC,CAAA;AAAA,KAC9D;AAAA,EACF;AACA,EAAA,IAAI,OAAO,YAAA,EAAc;AACvB,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,sBAAA,EAAyB,kBAAA,CAAmB,MAAA,CAAO,YAAY,CAAC,CAAA;AAAA,KAClE;AAAA,EACF;AACA,EAAA,IAAI,OAAO,eAAA,EAAiB;AAC1B,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,yBAAA,EAA4B,kBAAA,CAAmB,MAAA,CAAO,eAAe,CAAC,CAAA;AAAA,KACxE;AAAA,EACF;AACA,EAAA,IAAI,OAAO,QAAA,EAAU;AACnB,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,kBAAA,EAAqB,kBAAA,CAAmB,MAAA,CAAO,QAAQ,CAAC,CAAA;AAAA,KAC1D;AAAA,EACF;AACA,EAAA,IAAI,MAAA,CAAO,cAAc,MAAA,EAAW;AAClC,IAAA,cAAA,CAAe,IAAA,CAAK,CAAA,mBAAA,EAAsB,MAAA,CAAO,SAAS,CAAA,CAAE,CAAA;AAAA,EAC9D;AACA,EAAA,IAAI,MAAA,CAAO,eAAe,MAAA,EAAW;AACnC,IAAA,cAAA,CAAe,IAAA,CAAK,CAAA,oBAAA,EAAuB,MAAA,CAAO,UAAU,CAAA,CAAE,CAAA;AAAA,EAChE;AACA,EAAA,IAAI,OAAO,QAAA,EAAU;AACnB,IAAA,cAAA,CAAe,IAAA,CAAK,CAAA,kBAAA,EAAqB,MAAA,CAAO,QAAQ,CAAA,CAAE,CAAA;AAAA,EAC5D;AACA,EAAA,IAAI,OAAO,aAAA,EAAe;AACxB,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,uBAAA,EAA0B,kBAAA,CAAmB,MAAA,CAAO,aAAa,CAAC,CAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,IAAI,OAAO,gBAAA,EAAkB;AAC3B,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,0BAAA,EAA6B,kBAAA,CAAmB,MAAA,CAAO,gBAAgB,CAAC,CAAA;AAAA,KAC1E;AAAA,EACF;AACA,EAAA,IAAI,OAAO,WAAA,EAAa;AACtB,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,qBAAA,EAAwB,kBAAA,CAAmB,MAAA,CAAO,WAAW,CAAC,CAAA;AAAA,KAChE;AAAA,EACF;AACA,EAAA,IAAI,OAAO,SAAA,EAAW;AACpB,IAAA,cAAA,CAAe,IAAA;AAAA,MACb,CAAA,mBAAA,EAAsB,kBAAA,CAAmB,MAAA,CAAO,SAAS,CAAC,CAAA;AAAA,KAC5D;AAAA,EACF;AAEA,EAAA,IAAI,cAAA,CAAe,SAAS,CAAA,EAAG;AAC7B,IAAA,OAAA,CAAQ,SAAS,CAAA,GAAI,cAAA,CAAe,IAAA,CAAK,GAAG,CAAA;AAAA,EAC9C;AAEA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,yBACd,aAAA,EACuC;AACvC,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAyC,EAAC;AAChD,EAAA,MAAM,OAAA,GAAU,aAAA,CAAc,KAAA,CAAM,GAAG,CAAA;AAEvC,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,CAAC,KAAK,KAAK,CAAA,GAAI,MAAM,IAAA,EAAK,CAAE,MAAM,GAAG,CAAA;AAC3C,IAAA,IAAI,CAAC,GAAA,IAAO,CAAC,KAAA,EAAO;AAEpB,IAAA,MAAM,YAAA,GAAe,mBAAmB,KAAK,CAAA;AAE7C,IAAA,QAAQ,GAAA;AAAK,MACX,KAAK,qBAAA,EAAuB;AAC1B,QAAA,MAAA,CAAO,UAAA,GAAa,YAAA;AACpB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,uBAAA,EAAyB;AAC5B,QAAA,MAAA,CAAO,YAAA,GAAe,YAAA;AACtB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,0BAAA,EAA4B;AAC/B,QAAA,MAAA,CAAO,eAAA,GAAkB,YAAA;AACzB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,mBAAA,EAAqB;AACxB,QAAA,MAAA,CAAO,QAAA,GAAW,YAAA;AAClB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,oBAAA,EAAsB;AACzB,QAAA,MAAA,CAAO,SAAA,GAAY,MAAA,CAAO,QAAA,CAAS,YAAA,EAAc,EAAE,CAAA;AACnD,QAAA;AAAA,MACF;AAAA,MACA,KAAK,qBAAA,EAAuB;AAC1B,QAAA,MAAA,CAAO,UAAA,GAAa,MAAA,CAAO,QAAA,CAAS,YAAA,EAAc,EAAE,CAAA;AACpD,QAAA;AAAA,MACF;AAAA,MACA,KAAK,mBAAA,EAAqB;AACxB,QAAA,MAAA,CAAO,QAAA,GAAW,YAAA;AAClB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,wBAAA,EAA0B;AAC7B,QAAA,MAAA,CAAO,aAAA,GAAgB,YAAA;AACvB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,2BAAA,EAA6B;AAChC,QAAA,MAAA,CAAO,gBAAA,GAAmB,YAAA;AAC1B,QAAA;AAAA,MACF;AAAA,MACA,KAAK,sBAAA,EAAwB;AAC3B,QAAA,MAAA,CAAO,WAAA,GAAc,YAAA;AACrB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,oBAAA,EAAsB;AACzB,QAAA,MAAA,CAAO,SAAA,GAAY,YAAA;AACnB,QAAA;AAAA,MACF;AAAA;AACF,EACF;AAEA,EAAA,OAAO,OAAO,IAAA,CAAK,MAAM,CAAA,CAAE,MAAA,GAAS,IAAI,MAAA,GAAS,IAAA;AACnD","file":"workflow-distributed.js","sourcesContent":["/**\n * Distributed workflow tracing with cross-service correlation\n *\n * Enables tracking workflows that span multiple microservices by propagating\n * workflow identity (workflowId, stepName, stepIndex) via baggage in message headers.\n *\n * Unlike local workflow.ts (which uses AsyncLocalStorage), distributed workflows\n * propagate context across network boundaries using W3C baggage.\n *\n * @example Order fulfillment saga across services\n * ```typescript\n * // Service A: Order Service\n * import { traceDistributedWorkflow, WorkflowBaggage } from 'autotel/workflow-distributed';\n * import { traceProducer } from 'autotel/messaging';\n *\n * export const createOrder = traceDistributedWorkflow({\n * name: 'OrderFulfillment',\n * workflowIdFrom: (order) => order.id,\n * version: '1.0.0',\n * })(ctx => async (order: Order) => {\n * // Workflow baggage is auto-set\n * await publishToInventory(order);\n * });\n *\n * const publishToInventory = traceProducer({\n * system: 'kafka',\n * destination: 'inventory-requests',\n * propagateBaggage: true, // Includes workflow.* baggage\n * })(ctx => async (order) => {\n * await producer.send({ topic: 'inventory-requests', value: order });\n * });\n *\n * // Service B: Inventory Service\n * import { traceDistributedStep, WorkflowBaggage } from 'autotel/workflow-distributed';\n *\n * export const processInventory = traceDistributedStep({\n * name: 'ReserveInventory',\n * extractBaggage: true, // Extracts workflow.* from headers\n * })(ctx => async (message) => {\n * const workflow = WorkflowBaggage.get(ctx);\n * // workflow.workflowId === order.id (propagated from Service A)\n * console.log(`Processing step for workflow ${workflow.workflowId}`);\n * await reserveItems(message.items);\n * });\n * ```\n *\n * @module\n */\n\nimport { context, propagation, SpanKind } from '@opentelemetry/api';\nimport { createSafeBaggageSchema } from './business-baggage';\nimport { emitCorrelatedEvent } from './correlated-events';\nimport { trace } from './functional';\nimport type { TraceContext } from './trace-context';\n\n// ============================================================================\n// Workflow Baggage Schema\n// ============================================================================\n\n/**\n * Workflow baggage field definitions\n */\nconst workflowBaggageFields = {\n /** Unique identifier for the workflow instance */\n workflowId: { type: 'string' as const, maxLength: 128, required: true },\n\n /** Name/type of the workflow (e.g., \"OrderFulfillment\") */\n workflowName: { type: 'string' as const, maxLength: 64, required: true },\n\n /** Version of the workflow definition */\n workflowVersion: { type: 'string' as const, maxLength: 32 },\n\n /** Current step name */\n stepName: { type: 'string' as const, maxLength: 64 },\n\n /** Current step index (0-based) */\n stepIndex: { type: 'number' as const },\n\n /** Total number of steps (if known) */\n totalSteps: { type: 'number' as const },\n\n /** Parent workflow ID (for sub-workflows) */\n parentWorkflowId: { type: 'string' as const, maxLength: 128 },\n\n /** Correlation ID for external systems */\n correlationId: { type: 'string' as const, maxLength: 128 },\n\n /** Workflow priority */\n priority: {\n type: 'enum' as const,\n values: ['low', 'normal', 'high', 'critical'] as const,\n },\n\n /** Initiating user/system */\n initiatedBy: { type: 'string' as const, maxLength: 64 },\n\n /** Workflow start timestamp (ISO) */\n startedAt: { type: 'string' as const, maxLength: 30 },\n} as const;\n\n/**\n * Pre-built baggage schema for distributed workflows\n *\n * Use this to read/write workflow context that propagates across services.\n *\n * @example Setting workflow baggage\n * ```typescript\n * WorkflowBaggage.set(ctx, {\n * workflowId: 'order-12345',\n * workflowName: 'OrderFulfillment',\n * stepName: 'ReserveInventory',\n * stepIndex: 1,\n * });\n * ```\n *\n * @example Reading workflow baggage in downstream service\n * ```typescript\n * const { workflowId, workflowName, stepIndex } = WorkflowBaggage.get(ctx);\n * console.log(`Processing ${workflowName} step ${stepIndex}`);\n * ```\n */\nexport const WorkflowBaggage = createSafeBaggageSchema(workflowBaggageFields, {\n prefix: 'workflow',\n hashHighCardinality: false, // Workflow IDs should be traceable\n redactPII: false, // Workflow fields are internal identifiers\n});\n\n/**\n * Type for workflow baggage values\n */\nexport type WorkflowBaggageValues = {\n workflowId: string;\n workflowName: string;\n workflowVersion?: string;\n stepName?: string;\n stepIndex?: number;\n totalSteps?: number;\n parentWorkflowId?: string;\n correlationId?: string;\n priority?: 'low' | 'normal' | 'high' | 'critical';\n initiatedBy?: string;\n startedAt?: string;\n};\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Configuration for distributed workflow tracing\n */\nexport interface DistributedWorkflowConfig {\n /** Workflow name/type (e.g., \"OrderFulfillment\", \"UserOnboarding\") */\n name: string;\n\n /**\n * Extract workflow ID from function arguments\n *\n * Receives all arguments passed to the workflow function, allowing\n * multi-parameter handlers to derive workflow IDs from any argument.\n *\n * @example Single argument\n * ```typescript\n * workflowIdFrom: (order) => order.id\n * ```\n *\n * @example Multiple arguments (payload + metadata)\n * ```typescript\n * workflowIdFrom: (payload, metadata) => metadata.correlationId ?? payload.id\n * ```\n */\n workflowIdFrom: (...args: unknown[]) => string;\n\n /** Workflow version (e.g., \"1.0.0\", \"2023-01-15\") */\n version?: string;\n\n /** Total number of steps if known */\n totalSteps?: number;\n\n /** Parent workflow ID (for sub-workflows) */\n parentWorkflowId?: string;\n\n /** Correlation ID for external systems */\n correlationId?: string;\n\n /** Workflow priority */\n priority?: 'low' | 'normal' | 'high' | 'critical';\n\n /** User/system that initiated the workflow */\n initiatedBy?: string;\n\n /** Additional span attributes */\n attributes?: Record<string, string | number | boolean>;\n\n /** Callback on workflow start */\n onStart?: (ctx: DistributedWorkflowContext) => void;\n\n /** Callback on workflow completion */\n onComplete?: (ctx: DistributedWorkflowContext, result: unknown) => void;\n\n /** Callback on workflow error */\n onError?: (ctx: DistributedWorkflowContext, error: Error) => void;\n}\n\n/**\n * Configuration for distributed workflow step\n */\nexport interface DistributedStepConfig {\n /** Step name (e.g., \"ReserveInventory\", \"ChargePayment\") */\n name: string;\n\n /**\n * Extract baggage from incoming message/request\n *\n * If true, reads workflow baggage from current context (assumes already extracted).\n * If function, extracts from arguments.\n *\n * @default true\n */\n extractBaggage?:\n | boolean\n | ((args: unknown[]) => WorkflowBaggageValues | null);\n\n /** Override step index (otherwise uses baggage or auto-increments) */\n stepIndex?: number;\n\n /** Additional span attributes */\n attributes?: Record<string, string | number | boolean>;\n\n /** Whether this step is idempotent (safe to retry) */\n idempotent?: boolean;\n\n /** Whether this step is a compensation/rollback step */\n isCompensation?: boolean;\n\n /** Callback on step start */\n onStart?: (ctx: DistributedStepContext) => void;\n\n /** Callback on step completion */\n onComplete?: (ctx: DistributedStepContext, result: unknown) => void;\n\n /** Callback on step error */\n onError?: (ctx: DistributedStepContext, error: Error) => void;\n}\n\n/**\n * Extended context for distributed workflow root\n */\nexport interface DistributedWorkflowContext extends TraceContext {\n /** The workflow ID */\n workflowId: string;\n\n /** The workflow name */\n workflowName: string;\n\n /** The workflow version */\n workflowVersion?: string;\n\n /** Get workflow baggage for propagation to other services */\n getWorkflowBaggage(): WorkflowBaggageValues;\n\n /** Set additional workflow baggage fields */\n setWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;\n\n /** Get headers with workflow baggage for outgoing requests */\n getWorkflowHeaders(): Record<string, string>;\n\n /** Record workflow step completion (for progress tracking) */\n recordStepProgress(stepName: string, stepIndex: number): void;\n}\n\n/**\n * Extended context for distributed workflow step\n */\nexport interface DistributedStepContext extends TraceContext {\n /** The workflow ID (from baggage) */\n workflowId: string | null;\n\n /** The workflow name (from baggage) */\n workflowName: string | null;\n\n /** The current step name */\n stepName: string;\n\n /** The current step index */\n stepIndex: number | null;\n\n /** Whether this step is a compensation */\n isCompensation: boolean;\n\n /** Get the full workflow baggage */\n getWorkflowBaggage(): WorkflowBaggageValues | null;\n\n /** Update workflow baggage (e.g., increment step index) */\n updateWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void;\n\n /** Get headers with updated workflow baggage for downstream calls */\n getWorkflowHeaders(): Record<string, string>;\n\n /** Mark step as requiring compensation on failure */\n requiresCompensation(compensationData?: Record<string, unknown>): void;\n}\n\n// ============================================================================\n// Distributed Workflow Tracer\n// ============================================================================\n\n/**\n * Create a traced distributed workflow function\n *\n * Wraps a function as the entry point for a distributed workflow. Automatically:\n * - Generates or extracts workflow ID\n * - Sets workflow baggage for downstream propagation\n * - Creates root span with workflow attributes\n *\n * @param config - Workflow configuration\n * @returns Factory function for the workflow handler\n *\n * @example Basic usage\n * ```typescript\n * export const createOrder = traceDistributedWorkflow({\n * name: 'OrderFulfillment',\n * workflowIdFrom: (order) => order.id,\n * version: '1.0.0',\n * })(ctx => async (order: Order) => {\n * ctx.recordStepProgress('ValidateOrder', 0);\n * await validateOrder(order);\n *\n * ctx.recordStepProgress('ReserveInventory', 1);\n * await publishToInventoryService(order);\n *\n * return { workflowId: ctx.workflowId, status: 'started' };\n * });\n * ```\n */\nexport function traceDistributedWorkflow<TArgs extends unknown[], TReturn>(\n config: DistributedWorkflowConfig,\n) {\n const spanName = `workflow.${config.name}`;\n\n return (\n fnFactory: (\n ctx: DistributedWorkflowContext,\n ) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>(\n { name: spanName, spanKind: SpanKind.INTERNAL },\n (baseCtx) => {\n return async (...args: TArgs) => {\n // Extract workflow ID from arguments (spread to allow multi-arg access)\n const workflowId = config.workflowIdFrom(...args);\n const startedAt = new Date().toISOString();\n\n // Initialize workflow baggage\n const baggageValues: WorkflowBaggageValues = {\n workflowId,\n workflowName: config.name,\n workflowVersion: config.version,\n stepIndex: 0,\n totalSteps: config.totalSteps,\n parentWorkflowId: config.parentWorkflowId,\n correlationId: config.correlationId,\n priority: config.priority,\n initiatedBy: config.initiatedBy,\n startedAt,\n };\n\n // Set baggage\n WorkflowBaggage.set(baseCtx, baggageValues);\n\n // Set span attributes\n baseCtx.setAttribute('workflow.id', workflowId);\n baseCtx.setAttribute('workflow.name', config.name);\n if (config.version) {\n baseCtx.setAttribute('workflow.version', config.version);\n }\n if (config.totalSteps) {\n baseCtx.setAttribute('workflow.total_steps', config.totalSteps);\n }\n if (config.parentWorkflowId) {\n baseCtx.setAttribute('workflow.parent_id', config.parentWorkflowId);\n }\n if (config.priority) {\n baseCtx.setAttribute('workflow.priority', config.priority);\n }\n if (config.initiatedBy) {\n baseCtx.setAttribute('workflow.initiated_by', config.initiatedBy);\n }\n baseCtx.setAttribute('workflow.started_at', startedAt);\n\n // Apply custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n baseCtx.setAttribute(key, value);\n }\n }\n\n // Create extended context\n const workflowCtx: DistributedWorkflowContext = {\n ...baseCtx,\n workflowId,\n workflowName: config.name,\n workflowVersion: config.version,\n\n getWorkflowBaggage(): WorkflowBaggageValues {\n return { ...baggageValues };\n },\n\n setWorkflowBaggage(values: Partial<WorkflowBaggageValues>): void {\n Object.assign(baggageValues, values);\n WorkflowBaggage.set(baseCtx, baggageValues);\n },\n\n getWorkflowHeaders(): Record<string, string> {\n const headers: Record<string, string> = {};\n const ctx = context.active();\n propagation.inject(ctx, headers);\n return headers;\n },\n\n recordStepProgress(stepName: string, stepIndex: number): void {\n baggageValues.stepName = stepName;\n baggageValues.stepIndex = stepIndex;\n WorkflowBaggage.set(baseCtx, baggageValues);\n\n emitCorrelatedEvent(baseCtx, 'workflow.step_progress', {\n 'workflow.step.name': stepName,\n 'workflow.step.index': stepIndex,\n });\n },\n };\n\n // Call onStart callback\n config.onStart?.(workflowCtx);\n\n // Add start event\n emitCorrelatedEvent(baseCtx, 'workflow.started', {\n 'workflow.id': workflowId,\n 'workflow.name': config.name,\n });\n\n try {\n const userFn = fnFactory(workflowCtx);\n const result = await userFn(...args);\n\n // Call onComplete callback\n config.onComplete?.(workflowCtx, result);\n\n // Add completion event\n emitCorrelatedEvent(baseCtx, 'workflow.completed', {\n 'workflow.id': workflowId,\n });\n\n return result;\n } catch (error) {\n // Call onError callback\n config.onError?.(workflowCtx, error as Error);\n\n // Add error event\n emitCorrelatedEvent(baseCtx, 'workflow.failed', {\n 'workflow.id': workflowId,\n 'workflow.error': (error as Error).message,\n });\n\n throw error;\n }\n };\n },\n );\n };\n}\n\n// ============================================================================\n// Distributed Step Tracer\n// ============================================================================\n\n/**\n * Create a traced distributed workflow step\n *\n * Use in downstream services to trace steps that are part of a distributed workflow.\n * Automatically extracts workflow baggage from the current context.\n *\n * @param config - Step configuration\n * @returns Factory function for the step handler\n *\n * @example Consumer in downstream service\n * ```typescript\n * export const processInventory = traceConsumer({\n * system: 'kafka',\n * destination: 'inventory-requests',\n * extractBaggage: true, // Extracts workflow.* from headers\n * })(ctx => {\n * // Wrap inner logic with traceDistributedStep\n * return traceDistributedStep({\n * name: 'ReserveInventory',\n * })(stepCtx => async (message) => {\n * console.log(`Processing workflow ${stepCtx.workflowId}`);\n * await reserveItems(message.items);\n * })(message);\n * });\n * ```\n *\n * @example Standalone step handler\n * ```typescript\n * export const reserveInventory = traceDistributedStep({\n * name: 'ReserveInventory',\n * idempotent: true,\n * })(ctx => async (request: InventoryRequest) => {\n * if (ctx.workflowId) {\n * console.log(`Part of workflow ${ctx.workflowId}, step ${ctx.stepIndex}`);\n * }\n * return await inventoryService.reserve(request.items);\n * });\n * ```\n */\nexport function traceDistributedStep<TArgs extends unknown[], TReturn>(\n config: DistributedStepConfig,\n) {\n const spanName = `workflow.step.${config.name}`;\n\n return (\n fnFactory: (\n ctx: DistributedStepContext,\n ) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>(\n { name: spanName, spanKind: SpanKind.INTERNAL },\n (baseCtx) => {\n return async (...args: TArgs) => {\n // Extract workflow baggage\n let baggageValues: WorkflowBaggageValues | null = null;\n\n const extractBaggage = config.extractBaggage ?? true;\n if (typeof extractBaggage === 'function') {\n baggageValues = extractBaggage(args);\n } else if (extractBaggage) {\n // Read from current context\n const extracted = WorkflowBaggage.get(baseCtx);\n if (extracted.workflowId && extracted.workflowName) {\n baggageValues = extracted as WorkflowBaggageValues;\n }\n }\n\n // Determine step index\n // If explicit stepIndex provided in config, use it\n // Otherwise, auto-increment from baggage if available\n let stepIndex: number | null;\n if (config.stepIndex !== undefined) {\n stepIndex = config.stepIndex;\n } else if (baggageValues?.stepIndex === undefined) {\n stepIndex = null;\n } else {\n // Auto-increment from previous step\n stepIndex = baggageValues.stepIndex + 1;\n }\n\n // Update baggage with current step\n if (baggageValues) {\n baggageValues.stepName = config.name;\n if (stepIndex !== null) {\n baggageValues.stepIndex = stepIndex;\n }\n WorkflowBaggage.set(baseCtx, baggageValues);\n }\n\n // Set span attributes\n baseCtx.setAttribute('workflow.step.name', config.name);\n if (stepIndex !== null) {\n baseCtx.setAttribute('workflow.step.index', stepIndex);\n }\n if (config.idempotent !== undefined) {\n baseCtx.setAttribute('workflow.step.idempotent', config.idempotent);\n }\n if (config.isCompensation) {\n baseCtx.setAttribute('workflow.step.is_compensation', true);\n }\n\n // Add workflow context attributes if available\n if (baggageValues) {\n baseCtx.setAttribute('workflow.id', baggageValues.workflowId);\n baseCtx.setAttribute('workflow.name', baggageValues.workflowName);\n if (baggageValues.workflowVersion) {\n baseCtx.setAttribute(\n 'workflow.version',\n baggageValues.workflowVersion,\n );\n }\n if (baggageValues.totalSteps) {\n baseCtx.setAttribute(\n 'workflow.total_steps',\n baggageValues.totalSteps,\n );\n }\n }\n\n // Apply custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n baseCtx.setAttribute(key, value);\n }\n }\n\n // Compensation data storage\n let compensationData: Record<string, unknown> | undefined;\n\n // Create extended context\n const stepCtx: DistributedStepContext = {\n ...baseCtx,\n workflowId: baggageValues?.workflowId ?? null,\n workflowName: baggageValues?.workflowName ?? null,\n stepName: config.name,\n stepIndex,\n isCompensation: config.isCompensation ?? false,\n\n getWorkflowBaggage(): WorkflowBaggageValues | null {\n return baggageValues ? { ...baggageValues } : null;\n },\n\n updateWorkflowBaggage(\n values: Partial<WorkflowBaggageValues>,\n ): void {\n if (baggageValues) {\n Object.assign(baggageValues, values);\n WorkflowBaggage.set(baseCtx, baggageValues);\n }\n },\n\n getWorkflowHeaders(): Record<string, string> {\n const headers: Record<string, string> = {};\n const ctx = context.active();\n propagation.inject(ctx, headers);\n return headers;\n },\n\n requiresCompensation(data?: Record<string, unknown>): void {\n compensationData = data;\n baseCtx.setAttribute('workflow.step.requires_compensation', true);\n emitCorrelatedEvent(\n baseCtx,\n 'workflow.step.compensation_registered',\n {\n 'workflow.step.name': config.name,\n ...(data && {\n 'workflow.step.compensation_data': JSON.stringify(data),\n }),\n },\n );\n },\n };\n\n // Call onStart callback\n config.onStart?.(stepCtx);\n\n // Add start event\n emitCorrelatedEvent(baseCtx, 'workflow.step.started', {\n 'workflow.step.name': config.name,\n ...(baggageValues && { 'workflow.id': baggageValues.workflowId }),\n });\n\n try {\n const userFn = fnFactory(stepCtx);\n const result = await userFn(...args);\n\n // Call onComplete callback\n config.onComplete?.(stepCtx, result);\n\n // Add completion event\n emitCorrelatedEvent(baseCtx, 'workflow.step.completed', {\n 'workflow.step.name': config.name,\n });\n\n return result;\n } catch (error) {\n // Call onError callback\n config.onError?.(stepCtx, error as Error);\n\n // Add error event with compensation info if registered\n emitCorrelatedEvent(baseCtx, 'workflow.step.failed', {\n 'workflow.step.name': config.name,\n 'workflow.step.error': (error as Error).message,\n ...(compensationData && {\n 'workflow.step.requires_compensation': true,\n }),\n });\n\n throw error;\n }\n };\n },\n );\n };\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Generate a unique workflow ID\n *\n * @param prefix - Optional prefix for the ID\n * @returns A unique workflow ID\n *\n * @example\n * ```typescript\n * const workflowId = generateWorkflowId('order'); // \"order-abc123def456\"\n * ```\n */\nexport function generateWorkflowId(prefix?: string): string {\n const random = Math.random().toString(36).slice(2, 15);\n const timestamp = Date.now().toString(36);\n const id = `${timestamp}-${random}`;\n return prefix ? `${prefix}-${id}` : id;\n}\n\n/**\n * Check if the current context is part of a distributed workflow\n *\n * @param ctx - The trace context\n * @returns True if workflow baggage is present\n */\nexport function isInDistributedWorkflow(ctx: TraceContext): boolean {\n const baggage = WorkflowBaggage.get(ctx);\n return !!(baggage.workflowId && baggage.workflowName);\n}\n\n/**\n * Get workflow progress information\n *\n * @param ctx - The trace context\n * @returns Progress info or null if not in a workflow\n */\nexport function getWorkflowProgress(ctx: TraceContext): {\n workflowId: string;\n workflowName: string;\n currentStep: string | null;\n currentStepIndex: number | null;\n totalSteps: number | null;\n percentComplete: number | null;\n} | null {\n const baggage = WorkflowBaggage.get(ctx);\n if (!baggage.workflowId || !baggage.workflowName) {\n return null;\n }\n\n const percentComplete =\n baggage.totalSteps && baggage.stepIndex !== undefined\n ? Math.round(((baggage.stepIndex + 1) / baggage.totalSteps) * 100)\n : null;\n\n return {\n workflowId: baggage.workflowId,\n workflowName: baggage.workflowName,\n currentStep: baggage.stepName ?? null,\n currentStepIndex: baggage.stepIndex ?? null,\n totalSteps: baggage.totalSteps ?? null,\n percentComplete,\n };\n}\n\n/**\n * Create workflow correlation headers for manual propagation\n *\n * Use when you need to manually add workflow context to outgoing requests.\n *\n * @param values - Workflow baggage values\n * @returns Headers object with workflow baggage\n *\n * @example\n * ```typescript\n * const headers = createWorkflowHeaders({\n * workflowId: 'order-123',\n * workflowName: 'OrderFulfillment',\n * stepIndex: 2,\n * });\n *\n * await fetch('/api/inventory', { headers });\n * ```\n */\nexport function createWorkflowHeaders(\n values: Partial<WorkflowBaggageValues>,\n): Record<string, string> {\n const headers: Record<string, string> = {};\n\n // Build baggage string\n const baggageEntries: string[] = [];\n\n if (values.workflowId) {\n baggageEntries.push(\n `workflow.workflowId=${encodeURIComponent(values.workflowId)}`,\n );\n }\n if (values.workflowName) {\n baggageEntries.push(\n `workflow.workflowName=${encodeURIComponent(values.workflowName)}`,\n );\n }\n if (values.workflowVersion) {\n baggageEntries.push(\n `workflow.workflowVersion=${encodeURIComponent(values.workflowVersion)}`,\n );\n }\n if (values.stepName) {\n baggageEntries.push(\n `workflow.stepName=${encodeURIComponent(values.stepName)}`,\n );\n }\n if (values.stepIndex !== undefined) {\n baggageEntries.push(`workflow.stepIndex=${values.stepIndex}`);\n }\n if (values.totalSteps !== undefined) {\n baggageEntries.push(`workflow.totalSteps=${values.totalSteps}`);\n }\n if (values.priority) {\n baggageEntries.push(`workflow.priority=${values.priority}`);\n }\n if (values.correlationId) {\n baggageEntries.push(\n `workflow.correlationId=${encodeURIComponent(values.correlationId)}`,\n );\n }\n if (values.parentWorkflowId) {\n baggageEntries.push(\n `workflow.parentWorkflowId=${encodeURIComponent(values.parentWorkflowId)}`,\n );\n }\n if (values.initiatedBy) {\n baggageEntries.push(\n `workflow.initiatedBy=${encodeURIComponent(values.initiatedBy)}`,\n );\n }\n if (values.startedAt) {\n baggageEntries.push(\n `workflow.startedAt=${encodeURIComponent(values.startedAt)}`,\n );\n }\n\n if (baggageEntries.length > 0) {\n headers['baggage'] = baggageEntries.join(',');\n }\n\n return headers;\n}\n\n/**\n * Parse workflow context from baggage header\n *\n * @param baggageHeader - The baggage header value\n * @returns Parsed workflow values or null\n */\nexport function parseWorkflowFromBaggage(\n baggageHeader: string,\n): Partial<WorkflowBaggageValues> | null {\n if (!baggageHeader) {\n return null;\n }\n\n const values: Partial<WorkflowBaggageValues> = {};\n const entries = baggageHeader.split(',');\n\n for (const entry of entries) {\n const [key, value] = entry.trim().split('=');\n if (!key || !value) continue;\n\n const decodedValue = decodeURIComponent(value);\n\n switch (key) {\n case 'workflow.workflowId': {\n values.workflowId = decodedValue;\n break;\n }\n case 'workflow.workflowName': {\n values.workflowName = decodedValue;\n break;\n }\n case 'workflow.workflowVersion': {\n values.workflowVersion = decodedValue;\n break;\n }\n case 'workflow.stepName': {\n values.stepName = decodedValue;\n break;\n }\n case 'workflow.stepIndex': {\n values.stepIndex = Number.parseInt(decodedValue, 10);\n break;\n }\n case 'workflow.totalSteps': {\n values.totalSteps = Number.parseInt(decodedValue, 10);\n break;\n }\n case 'workflow.priority': {\n values.priority = decodedValue as WorkflowBaggageValues['priority'];\n break;\n }\n case 'workflow.correlationId': {\n values.correlationId = decodedValue;\n break;\n }\n case 'workflow.parentWorkflowId': {\n values.parentWorkflowId = decodedValue;\n break;\n }\n case 'workflow.initiatedBy': {\n values.initiatedBy = decodedValue;\n break;\n }\n case 'workflow.startedAt': {\n values.startedAt = decodedValue;\n break;\n }\n }\n }\n\n return Object.keys(values).length > 0 ? values : null;\n}\n"]}
|
package/dist/workflow.cjs
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
4
|
-
require('./chunk-
|
|
5
|
-
require('./chunk-
|
|
6
|
-
require('./chunk-
|
|
7
|
-
require('./chunk-
|
|
8
|
-
require('./chunk-
|
|
9
|
-
require('./chunk-
|
|
3
|
+
var chunkMOO75VE4_cjs = require('./chunk-MOO75VE4.cjs');
|
|
4
|
+
require('./chunk-4P6ZOARG.cjs');
|
|
5
|
+
require('./chunk-QPH5ZKP5.cjs');
|
|
6
|
+
require('./chunk-NCSMD3TK.cjs');
|
|
7
|
+
require('./chunk-VQTCQKHQ.cjs');
|
|
8
|
+
require('./chunk-KKGM42RQ.cjs');
|
|
9
|
+
require('./chunk-BPO2PQ3T.cjs');
|
|
10
10
|
require('./chunk-OC6X2VIN.cjs');
|
|
11
11
|
require('./chunk-CEAQK2QY.cjs');
|
|
12
12
|
require('./chunk-ZNMBW67B.cjs');
|
|
13
13
|
require('./chunk-IOYFAFHJ.cjs');
|
|
14
|
-
require('./chunk-
|
|
14
|
+
require('./chunk-NXLRY2CE.cjs');
|
|
15
15
|
require('./chunk-CU6IDACR.cjs');
|
|
16
16
|
require('./chunk-6S5RUKU3.cjs');
|
|
17
17
|
require('./chunk-YS6C2YJE.cjs');
|
|
@@ -25,19 +25,19 @@ require('./chunk-JEQ2X3Z6.cjs');
|
|
|
25
25
|
|
|
26
26
|
Object.defineProperty(exports, "getCurrentWorkflowContext", {
|
|
27
27
|
enumerable: true,
|
|
28
|
-
get: function () { return
|
|
28
|
+
get: function () { return chunkMOO75VE4_cjs.getCurrentWorkflowContext; }
|
|
29
29
|
});
|
|
30
30
|
Object.defineProperty(exports, "isInWorkflow", {
|
|
31
31
|
enumerable: true,
|
|
32
|
-
get: function () { return
|
|
32
|
+
get: function () { return chunkMOO75VE4_cjs.isInWorkflow; }
|
|
33
33
|
});
|
|
34
34
|
Object.defineProperty(exports, "traceStep", {
|
|
35
35
|
enumerable: true,
|
|
36
|
-
get: function () { return
|
|
36
|
+
get: function () { return chunkMOO75VE4_cjs.traceStep; }
|
|
37
37
|
});
|
|
38
38
|
Object.defineProperty(exports, "traceWorkflow", {
|
|
39
39
|
enumerable: true,
|
|
40
|
-
get: function () { return
|
|
40
|
+
get: function () { return chunkMOO75VE4_cjs.traceWorkflow; }
|
|
41
41
|
});
|
|
42
42
|
//# sourceMappingURL=workflow.cjs.map
|
|
43
43
|
//# sourceMappingURL=workflow.cjs.map
|
package/dist/workflow.d.cts
CHANGED
package/dist/workflow.d.ts
CHANGED
package/dist/workflow.js
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-
|
|
2
|
-
import './chunk-
|
|
3
|
-
import './chunk-
|
|
4
|
-
import './chunk-
|
|
5
|
-
import './chunk-
|
|
6
|
-
import './chunk-
|
|
7
|
-
import './chunk-
|
|
1
|
+
export { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from './chunk-K7HSRLP5.js';
|
|
2
|
+
import './chunk-KIL5CUN6.js';
|
|
3
|
+
import './chunk-PMRWMRXY.js';
|
|
4
|
+
import './chunk-DSMSIVTG.js';
|
|
5
|
+
import './chunk-SEO6NAQT.js';
|
|
6
|
+
import './chunk-Z7VAOK5X.js';
|
|
7
|
+
import './chunk-ZDPIWKWD.js';
|
|
8
8
|
import './chunk-3SDILILG.js';
|
|
9
9
|
import './chunk-A4E5AQFK.js';
|
|
10
10
|
import './chunk-WGWSHJ2N.js';
|
|
11
11
|
import './chunk-GYR5K654.js';
|
|
12
|
-
import './chunk-
|
|
12
|
+
import './chunk-JVWJDHDB.js';
|
|
13
13
|
import './chunk-6UQRVUN3.js';
|
|
14
14
|
import './chunk-3QXBFGKP.js';
|
|
15
15
|
import './chunk-33WTKH7X.js';
|
package/package.json
CHANGED
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "autotel",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.0.3",
|
|
4
4
|
"description": "Write Once, Observe Anywhere",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"types": "./dist/index.d.ts",
|
|
7
7
|
"type": "module",
|
|
8
|
-
"sideEffects":
|
|
8
|
+
"sideEffects": [
|
|
9
|
+
"./dist/chunk-*.js",
|
|
10
|
+
"./dist/chunk-*.cjs"
|
|
11
|
+
],
|
|
9
12
|
"exports": {
|
|
10
13
|
".": {
|
|
11
14
|
"types": "./dist/index.d.ts",
|
|
@@ -225,9 +228,7 @@
|
|
|
225
228
|
"dist",
|
|
226
229
|
"src",
|
|
227
230
|
"README.md",
|
|
228
|
-
"skills"
|
|
229
|
-
"!skills/_artifacts",
|
|
230
|
-
"bin"
|
|
231
|
+
"skills"
|
|
231
232
|
],
|
|
232
233
|
"keywords": [
|
|
233
234
|
"opentelemetry",
|
|
@@ -250,33 +251,32 @@
|
|
|
250
251
|
"license": "MIT",
|
|
251
252
|
"dependencies": {
|
|
252
253
|
"@opentelemetry/api": "^1.9.1",
|
|
253
|
-
"@opentelemetry/api-logs": "^0.
|
|
254
|
-
"@opentelemetry/exporter-logs-otlp-http": "^0.
|
|
255
|
-
"@opentelemetry/exporter-metrics-otlp-http": "^0.
|
|
256
|
-
"@opentelemetry/exporter-trace-otlp-http": "^0.
|
|
257
|
-
"@opentelemetry/instrumentation": "^0.
|
|
258
|
-
"@opentelemetry/resources": "^2.7.
|
|
259
|
-
"@opentelemetry/sdk-logs": "^0.
|
|
260
|
-
"@opentelemetry/sdk-metrics": "^2.7.
|
|
261
|
-
"@opentelemetry/sdk-node": "^0.
|
|
262
|
-
"@opentelemetry/sdk-trace-base": "^2.7.
|
|
254
|
+
"@opentelemetry/api-logs": "^0.216.0",
|
|
255
|
+
"@opentelemetry/exporter-logs-otlp-http": "^0.216.0",
|
|
256
|
+
"@opentelemetry/exporter-metrics-otlp-http": "^0.216.0",
|
|
257
|
+
"@opentelemetry/exporter-trace-otlp-http": "^0.216.0",
|
|
258
|
+
"@opentelemetry/instrumentation": "^0.216.0",
|
|
259
|
+
"@opentelemetry/resources": "^2.7.1",
|
|
260
|
+
"@opentelemetry/sdk-logs": "^0.216.0",
|
|
261
|
+
"@opentelemetry/sdk-metrics": "^2.7.1",
|
|
262
|
+
"@opentelemetry/sdk-node": "^0.216.0",
|
|
263
|
+
"@opentelemetry/sdk-trace-base": "^2.7.1",
|
|
263
264
|
"@opentelemetry/semantic-conventions": "^1.40.0",
|
|
264
|
-
"import-in-the-middle": "^3.0.1"
|
|
265
|
-
"@tanstack/intent": "^0.0.36"
|
|
265
|
+
"import-in-the-middle": "^3.0.1"
|
|
266
266
|
},
|
|
267
267
|
"peerDependencies": {
|
|
268
|
-
"@opentelemetry/auto-instrumentations-node": "^0.
|
|
269
|
-
"@opentelemetry/exporter-logs-otlp-grpc": "^0.
|
|
270
|
-
"@opentelemetry/exporter-metrics-otlp-grpc": "^0.
|
|
271
|
-
"@opentelemetry/exporter-trace-otlp-grpc": "^0.
|
|
272
|
-
"@opentelemetry/resource-detector-aws": "^2.
|
|
273
|
-
"@opentelemetry/resource-detector-container": "^0.8.
|
|
274
|
-
"@opentelemetry/resource-detector-gcp": "^0.
|
|
275
|
-
"@opentelemetry/sdk-trace-node": "^2.7.
|
|
268
|
+
"@opentelemetry/auto-instrumentations-node": "^0.74.0",
|
|
269
|
+
"@opentelemetry/exporter-logs-otlp-grpc": "^0.216.0",
|
|
270
|
+
"@opentelemetry/exporter-metrics-otlp-grpc": "^0.216.0",
|
|
271
|
+
"@opentelemetry/exporter-trace-otlp-grpc": "^0.216.0",
|
|
272
|
+
"@opentelemetry/resource-detector-aws": "^2.16.0",
|
|
273
|
+
"@opentelemetry/resource-detector-container": "^0.8.7",
|
|
274
|
+
"@opentelemetry/resource-detector-gcp": "^0.51.0",
|
|
275
|
+
"@opentelemetry/sdk-trace-node": "^2.7.1",
|
|
276
276
|
"@traceloop/node-server-sdk": "^0.26.0",
|
|
277
277
|
"pino": "^10.3.1",
|
|
278
278
|
"pino-pretty": "^13.1.3",
|
|
279
|
-
"yaml": "^2.8.
|
|
279
|
+
"yaml": "^2.8.4"
|
|
280
280
|
},
|
|
281
281
|
"peerDependenciesMeta": {
|
|
282
282
|
"@opentelemetry/auto-instrumentations-node": {
|
|
@@ -319,22 +319,22 @@
|
|
|
319
319
|
"devDependencies": {
|
|
320
320
|
"@arethetypeswrong/cli": "^0.18.2",
|
|
321
321
|
"@edge-runtime/vm": "^5.0.0",
|
|
322
|
-
"@opentelemetry/auto-instrumentations-node": "^0.
|
|
323
|
-
"@opentelemetry/context-async-hooks": "^2.7.
|
|
324
|
-
"@opentelemetry/exporter-logs-otlp-grpc": "^0.
|
|
325
|
-
"@opentelemetry/exporter-metrics-otlp-grpc": "^0.
|
|
326
|
-
"@opentelemetry/exporter-trace-otlp-grpc": "^0.
|
|
327
|
-
"@opentelemetry/resource-detector-aws": "^2.
|
|
328
|
-
"@opentelemetry/resource-detector-container": "^0.8.
|
|
329
|
-
"@opentelemetry/resource-detector-gcp": "^0.
|
|
330
|
-
"@opentelemetry/sdk-trace-node": "^2.7.
|
|
331
|
-
"@swc/core": "^1.15.
|
|
322
|
+
"@opentelemetry/auto-instrumentations-node": "^0.74.0",
|
|
323
|
+
"@opentelemetry/context-async-hooks": "^2.7.1",
|
|
324
|
+
"@opentelemetry/exporter-logs-otlp-grpc": "^0.216.0",
|
|
325
|
+
"@opentelemetry/exporter-metrics-otlp-grpc": "^0.216.0",
|
|
326
|
+
"@opentelemetry/exporter-trace-otlp-grpc": "^0.216.0",
|
|
327
|
+
"@opentelemetry/resource-detector-aws": "^2.16.0",
|
|
328
|
+
"@opentelemetry/resource-detector-container": "^0.8.7",
|
|
329
|
+
"@opentelemetry/resource-detector-gcp": "^0.51.0",
|
|
330
|
+
"@opentelemetry/sdk-trace-node": "^2.7.1",
|
|
331
|
+
"@swc/core": "^1.15.32",
|
|
332
332
|
"@total-typescript/ts-reset": "^0.6.1",
|
|
333
333
|
"@total-typescript/tsconfig": "^1.0.4",
|
|
334
334
|
"@types/eslint-config-prettier": "^6.11.3",
|
|
335
335
|
"@types/node": "^25.6.0",
|
|
336
|
-
"@typescript-eslint/eslint-plugin": "^8.59.
|
|
337
|
-
"@typescript-eslint/parser": "^8.59.
|
|
336
|
+
"@typescript-eslint/eslint-plugin": "^8.59.1",
|
|
337
|
+
"@typescript-eslint/parser": "^8.59.1",
|
|
338
338
|
"eslint-config-prettier": "^10.1.8",
|
|
339
339
|
"eslint-plugin-unicorn": "^64.0.0",
|
|
340
340
|
"pino": "^10.3.1",
|
|
@@ -343,13 +343,13 @@
|
|
|
343
343
|
"tsup": "^8.5.1",
|
|
344
344
|
"tsx": "^4.21.0",
|
|
345
345
|
"typescript": "^6.0.3",
|
|
346
|
-
"typescript-eslint": "^8.59.
|
|
346
|
+
"typescript-eslint": "^8.59.1",
|
|
347
347
|
"unplugin-swc": "^1.5.9",
|
|
348
348
|
"vite-tsconfig-paths": "^6.1.1",
|
|
349
349
|
"vitest": "^4.1.5",
|
|
350
350
|
"vitest-mock-extended": "^4.0.0",
|
|
351
351
|
"winston": "^3.19.0",
|
|
352
|
-
"yaml": "^2.8.
|
|
352
|
+
"yaml": "^2.8.4"
|
|
353
353
|
},
|
|
354
354
|
"repository": {
|
|
355
355
|
"type": "git",
|
|
@@ -359,15 +359,12 @@
|
|
|
359
359
|
"url": "https://github.com/jagreehal/autotel/issues"
|
|
360
360
|
},
|
|
361
361
|
"homepage": "https://github.com/jagreehal/autotel#readme",
|
|
362
|
-
"bin": {
|
|
363
|
-
"intent": "./bin/intent.js"
|
|
364
|
-
},
|
|
365
362
|
"scripts": {
|
|
366
363
|
"build": "tsup",
|
|
367
364
|
"ci": "npm run build && npm run check-format && npm run check-exports && npm run lint && npm run test",
|
|
368
365
|
"dev": "tsup --watch",
|
|
369
|
-
"lint": "
|
|
370
|
-
"lint:fix": "
|
|
366
|
+
"lint": "eslint src/**/*.ts",
|
|
367
|
+
"lint:fix": "eslint src/**/*.ts --fix",
|
|
371
368
|
"format": "prettier --write .",
|
|
372
369
|
"format:check": "prettier --check src/**/*.ts",
|
|
373
370
|
"type-check": "tsc --noEmit",
|
|
@@ -375,6 +372,7 @@
|
|
|
375
372
|
"test:watch": "vitest --config vitest.unit.config.ts",
|
|
376
373
|
"test:integration": "vitest run --config vitest.integration.config.ts",
|
|
377
374
|
"test:integration:watch": "vitest --config vitest.integration.config.ts",
|
|
375
|
+
"test:e2e": "vitest run --config vitest.e2e.config.ts",
|
|
378
376
|
"test:all": "pnpm test && pnpm test:integration",
|
|
379
377
|
"check-format": "prettier --check ./src",
|
|
380
378
|
"check-exports": "attw --pack . --ignore-rules false-esm no-resolution cjs-resolves-to-esm",
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: analyze-traces
|
|
3
|
+
description: >
|
|
4
|
+
Analyze OpenTelemetry traces and structured logs from a running autotel service to debug errors,
|
|
5
|
+
investigate latency, follow requests across services, and surface cardinality / attribute hygiene
|
|
6
|
+
problems. Works with traces from any OTLP backend (Honeycomb, Grafana Tempo, Datadog, Jaeger,
|
|
7
|
+
Sentry, Axiom, HyperDX, …) plus the local `.autotel/spans/` dump and `InMemorySpanExporter` in tests.
|
|
8
|
+
license: MIT
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Analyze traces
|
|
12
|
+
|
|
13
|
+
This skill teaches an AI assistant how to read and reason about OpenTelemetry traces produced by autotel — whether they're sitting in a backend, exported to a local JSON dump, or captured in a test.
|
|
14
|
+
|
|
15
|
+
## When to use
|
|
16
|
+
|
|
17
|
+
- Debugging a failing endpoint after deploy
|
|
18
|
+
- Investigating latency regressions (p50 / p95 / p99 spike)
|
|
19
|
+
- Following a single request across browser → server → queue → worker
|
|
20
|
+
- Auditing attribute hygiene (cardinality, PII leak risk, noise)
|
|
21
|
+
- Spot-checking that a new instrumentation actually produces the spans you expected
|
|
22
|
+
|
|
23
|
+
## Input formats
|
|
24
|
+
|
|
25
|
+
| Source | How to access |
|
|
26
|
+
| ------------------------------ | ------------------------------------------------------------------ |
|
|
27
|
+
| Local debug dump | `.autotel/spans/*.ndjson` — one span per line, OTLP JSON shape |
|
|
28
|
+
| `InMemorySpanExporter` (tests) | `exporter.getFinishedSpans()` |
|
|
29
|
+
| Backend (interactive) | Jaeger / Tempo / Honeycomb UI; Datadog Trace Search; etc. |
|
|
30
|
+
| Backend (programmatic) | Honeycomb Query API, Tempo `/api/search`, Datadog Logs / Trace API |
|
|
31
|
+
|
|
32
|
+
## The shape of an autotel span
|
|
33
|
+
|
|
34
|
+
```json
|
|
35
|
+
{
|
|
36
|
+
"name": "POST /api/checkout",
|
|
37
|
+
"context": { "traceId": "…", "spanId": "…" },
|
|
38
|
+
"parentSpanId": "…",
|
|
39
|
+
"kind": "SERVER",
|
|
40
|
+
"startTimeUnixNano": "…",
|
|
41
|
+
"endTimeUnixNano": "…",
|
|
42
|
+
"status": { "code": "OK" },
|
|
43
|
+
"attributes": {
|
|
44
|
+
"service.name": "checkout",
|
|
45
|
+
"http.request.method": "POST",
|
|
46
|
+
"url.full": "https://api.example.com/api/checkout",
|
|
47
|
+
"http.response.status_code": 200,
|
|
48
|
+
"user.id": "usr_123",
|
|
49
|
+
"user.plan": "enterprise",
|
|
50
|
+
"cart.items": 3,
|
|
51
|
+
"cart.total": 14999,
|
|
52
|
+
"_correlationId": "01J…"
|
|
53
|
+
},
|
|
54
|
+
"events": [
|
|
55
|
+
{
|
|
56
|
+
"name": "log.emit.manual",
|
|
57
|
+
"attributes": { "level": "info", "stage": "validated" }
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"links": [],
|
|
61
|
+
"resource": {
|
|
62
|
+
"service.name": "checkout",
|
|
63
|
+
"deploy.id": "v2025.05.04-1"
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Key conventions to recognise:
|
|
69
|
+
|
|
70
|
+
- `service.name` distinguishes services in a multi-service trace.
|
|
71
|
+
- `_correlationId` (autotel-specific) is stable within a logical unit of work even across forked child spans (`_parentCorrelationId` ties them).
|
|
72
|
+
- `gen_ai.*` attributes follow OpenTelemetry gen-ai semantic conventions for LLM calls.
|
|
73
|
+
- `exception.*` attributes (auto-set by `createStructuredError`) carry `type`, `message`, `stacktrace`.
|
|
74
|
+
|
|
75
|
+
## Common investigations
|
|
76
|
+
|
|
77
|
+
### "Why is endpoint X failing?"
|
|
78
|
+
|
|
79
|
+
1. Find the trace: filter `service.name = "<svc>" AND http.route = "<route>" AND status = error` for the last hour.
|
|
80
|
+
2. Open the slowest / latest matching trace.
|
|
81
|
+
3. Inspect the root span's `exception.message` and `exception.stacktrace`.
|
|
82
|
+
4. Walk down the child spans — the deepest span with `status.code = ERROR` is usually the culprit.
|
|
83
|
+
5. If using `createStructuredError`, look for `code`, `why`, `internal.*` attributes. They usually answer the "why" without you reading code.
|
|
84
|
+
|
|
85
|
+
### "Why is endpoint X slow?"
|
|
86
|
+
|
|
87
|
+
1. Find a slow trace: `service.name = "<svc>" AND http.route = "<route>" AND duration > p99(duration)`.
|
|
88
|
+
2. View the waterfall — pinpoint the longest child span by self-time (not wall time).
|
|
89
|
+
3. Common offenders:
|
|
90
|
+
- **Sequential awaits that should be parallel** — sibling spans run end-to-end instead of overlapping.
|
|
91
|
+
- **N+1 queries** — many short same-named spans (`SELECT * FROM …`) under one parent.
|
|
92
|
+
- **Cold starts** — `faas.coldstart=true` in Workers or Lambda.
|
|
93
|
+
- **Tool retries** — gen-ai spans with `gen_ai.response.finish_reason = error` followed by another call.
|
|
94
|
+
|
|
95
|
+
### "Follow this user across services"
|
|
96
|
+
|
|
97
|
+
Use `_correlationId` (or `user.id` if you have it):
|
|
98
|
+
|
|
99
|
+
```
|
|
100
|
+
service.name in (web, api, worker) AND _correlationId = "01J…"
|
|
101
|
+
ORDER BY startTime
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
Each service contributes spans with the same `traceId` (W3C trace context propagation handles this automatically with autotel's global fetch instrumentation).
|
|
105
|
+
|
|
106
|
+
### "Did the new instrumentation actually fire?"
|
|
107
|
+
|
|
108
|
+
In a test, dump the in-memory exporter:
|
|
109
|
+
|
|
110
|
+
```typescript
|
|
111
|
+
import { InMemorySpanExporter } from 'autotel/exporters';
|
|
112
|
+
const exporter = new InMemorySpanExporter();
|
|
113
|
+
// … run the code under test
|
|
114
|
+
const spans = exporter.getFinishedSpans();
|
|
115
|
+
console.log(spans.map((s) => ({ name: s.name, attrs: s.attributes })));
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Or live, point the SDK at a local file dump:
|
|
119
|
+
|
|
120
|
+
```typescript
|
|
121
|
+
init({ service: 'my-app', debug: 'pretty', spanDumpPath: '.autotel/spans' });
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
…then `tail -f .autotel/spans/*.ndjson | jq` while exercising the feature.
|
|
125
|
+
|
|
126
|
+
## Cardinality / hygiene audits
|
|
127
|
+
|
|
128
|
+
| Check | Query / heuristic |
|
|
129
|
+
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
130
|
+
| **Span name cardinality** | Top-K distinct `name` per service. Anything > a few hundred is a red flag — likely an unnormalised URL. |
|
|
131
|
+
| **Per-attribute cardinality** | `unique(attribute_value)` per `attribute_key`. UUIDs / emails / `Date.now()` ids in attributes blow up storage. |
|
|
132
|
+
| **Missing `service.name`** | Spans where the resource attribute is empty or `"app"` — fix at the SDK init. |
|
|
133
|
+
| **PII smell** | Look for raw `@`, leading digit-runs of length 16, or `eyJ` prefixes — your redactor is off. |
|
|
134
|
+
| **Health-check noise** | Spans with `http.route in (/healthz, /ready)`. Drop with `FilteringSpanProcessor`. |
|
|
135
|
+
|
|
136
|
+
## Reading gen-ai traces
|
|
137
|
+
|
|
138
|
+
LLM calls produce a parent span (kind `CLIENT`) with children for each tool call:
|
|
139
|
+
|
|
140
|
+
| Attribute | Meaning |
|
|
141
|
+
| ---------------------------------------------------------- | ---------------------------------------- |
|
|
142
|
+
| `gen_ai.system` | Provider (`openai`, `anthropic`, …) |
|
|
143
|
+
| `gen_ai.request.model` | Model id |
|
|
144
|
+
| `gen_ai.usage.input_tokens` / `output_tokens` | Token count |
|
|
145
|
+
| `gen_ai.usage.cache_read_tokens` / `cache_creation_tokens` | Cache hits |
|
|
146
|
+
| `gen_ai.response.finish_reason` | `stop`, `tool_calls`, `length`, `error` |
|
|
147
|
+
| `gen_ai.tool.name` | Tool invoked (on tool-call child spans) |
|
|
148
|
+
| `gen_ai.cost.usd` | Estimated cost (if pricing map provided) |
|
|
149
|
+
|
|
150
|
+
Common findings:
|
|
151
|
+
|
|
152
|
+
- High `gen_ai.usage.input_tokens` with low `cache_read_tokens` → enable prompt caching.
|
|
153
|
+
- Many sequential tool-call spans → consider parallel tool calls if the model supports it.
|
|
154
|
+
- `gen_ai.response.finish_reason = length` → bump `max_tokens`.
|
|
155
|
+
|
|
156
|
+
## When the trace is missing
|
|
157
|
+
|
|
158
|
+
If you expected a span and there isn't one:
|
|
159
|
+
|
|
160
|
+
1. **Sampling.** Did head sampling drop it? Check `sampling.rates` and `recordedSpans` in any subscriber.
|
|
161
|
+
2. **Workers without `waitUntil`.** Did the request return before the exporter flushed? Move to `defineWorkerFetch` / `wrapModule`.
|
|
162
|
+
3. **`instrumentation.disabled = true`** — check env-conditional config.
|
|
163
|
+
4. **Exporter rejected.** Check service logs for `OTLP exporter` 4xx / 5xx — bad token, wrong dataset.
|
|
164
|
+
|
|
165
|
+
## Output format
|
|
166
|
+
|
|
167
|
+
When summarising an investigation, lead with the **decision-changing fact**, then the supporting evidence:
|
|
168
|
+
|
|
169
|
+
```
|
|
170
|
+
Failure cause: payment.declined (Stripe code: insufficient_funds)
|
|
171
|
+
- Trace: 9d3a…b21
|
|
172
|
+
- 38 / 412 checkout requests in the last hour failed with status=402.
|
|
173
|
+
- All in eu-west-1, all on plan=free.
|
|
174
|
+
- exception.cause.stripeChargeId starts with ch_3M…
|
|
175
|
+
- Suggest: surface the structured `fix` field to the client; current 402 body returns generic message.
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Keep raw span dumps out of the summary; link to the trace ID instead.
|