autotel 3.3.0 → 3.3.1
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/dist/auto.cjs +2 -2
- package/dist/auto.js +1 -1
- package/dist/{chunk-OPCTN527.js → chunk-2GWM2CIT.js} +3 -3
- package/dist/{chunk-OPCTN527.js.map → chunk-2GWM2CIT.js.map} +1 -1
- package/dist/{chunk-FZROHTZZ.js → chunk-4EXFRREO.js} +3 -3
- package/dist/{chunk-FZROHTZZ.js.map → chunk-4EXFRREO.js.map} +1 -1
- package/dist/{chunk-U4D5IBSB.js → chunk-55ALGIAR.js} +4 -4
- package/dist/{chunk-U4D5IBSB.js.map → chunk-55ALGIAR.js.map} +1 -1
- package/dist/{chunk-32AXF4MA.js → chunk-B4CGFDZQ.js} +2 -2
- package/dist/{chunk-32AXF4MA.js.map → chunk-B4CGFDZQ.js.map} +1 -1
- package/dist/{chunk-4RA6HIYF.cjs → chunk-C4JCSBFO.cjs} +5 -5
- package/dist/{chunk-4RA6HIYF.cjs.map → chunk-C4JCSBFO.cjs.map} +1 -1
- package/dist/{chunk-QICFEFD6.cjs → chunk-DK6VFPVK.cjs} +7 -7
- package/dist/{chunk-QICFEFD6.cjs.map → chunk-DK6VFPVK.cjs.map} +1 -1
- package/dist/{chunk-U72TGONP.cjs → chunk-FMTNB27Z.cjs} +32 -32
- package/dist/{chunk-U72TGONP.cjs.map → chunk-FMTNB27Z.cjs.map} +1 -1
- package/dist/{chunk-DQSVSGK3.cjs → chunk-JAX4LFGG.cjs} +13 -13
- package/dist/{chunk-DQSVSGK3.cjs.map → chunk-JAX4LFGG.cjs.map} +1 -1
- package/dist/{chunk-TGV2XF57.js → chunk-LCXOOJIP.js} +3 -3
- package/dist/{chunk-TGV2XF57.js.map → chunk-LCXOOJIP.js.map} +1 -1
- package/dist/{chunk-OACAWYLR.js → chunk-LKASEUWE.js} +4 -4
- package/dist/{chunk-OACAWYLR.js.map → chunk-LKASEUWE.js.map} +1 -1
- package/dist/{chunk-MQH5OOZK.cjs → chunk-PWOECUNT.cjs} +17 -17
- package/dist/{chunk-MQH5OOZK.cjs.map → chunk-PWOECUNT.cjs.map} +1 -1
- package/dist/{chunk-QJYWKAC5.cjs → chunk-RYVFCHSO.cjs} +2 -2
- package/dist/{chunk-QJYWKAC5.cjs.map → chunk-RYVFCHSO.cjs.map} +1 -1
- package/dist/{chunk-4TAQQZDU.js → chunk-VFU663OM.js} +3 -3
- package/dist/{chunk-4TAQQZDU.js.map → chunk-VFU663OM.js.map} +1 -1
- package/dist/{chunk-3MZJ7Y24.cjs → chunk-VUYLXWCB.cjs} +5 -5
- package/dist/{chunk-3MZJ7Y24.cjs.map → chunk-VUYLXWCB.cjs.map} +1 -1
- package/dist/correlation-id.cjs +10 -10
- package/dist/correlation-id.js +2 -2
- package/dist/decorators.cjs +4 -4
- package/dist/decorators.js +3 -3
- package/dist/event.cjs +6 -6
- package/dist/event.js +3 -3
- package/dist/functional.cjs +11 -11
- package/dist/functional.js +3 -3
- package/dist/http.cjs +3 -3
- package/dist/http.js +2 -2
- package/dist/index.cjs +71 -71
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +11 -11
- package/dist/index.js.map +1 -1
- package/dist/instrumentation.cjs +8 -8
- package/dist/instrumentation.js +1 -1
- package/dist/messaging.cjs +7 -7
- package/dist/messaging.js +4 -4
- package/dist/semantic-helpers.cjs +8 -8
- package/dist/semantic-helpers.js +4 -4
- package/dist/webhook.cjs +5 -5
- package/dist/webhook.js +3 -3
- package/dist/workflow-distributed.cjs +5 -5
- package/dist/workflow-distributed.js +3 -3
- package/dist/workflow.cjs +8 -8
- package/dist/workflow.js +4 -4
- package/package.json +9 -9
- package/skills/build-audit-trails/SKILL.md +28 -15
- package/skills/build-audit-trails/references/framework-wiring.md +12 -3
- package/skills/review-otel-patterns/SKILL.md +9 -6
- package/src/error-catalog.test.ts +7 -2
- package/src/error-catalog.ts +13 -10
- package/src/init.ts +5 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
3
|
var chunk4P6ZOARG_cjs = require('./chunk-4P6ZOARG.cjs');
|
|
4
|
-
var
|
|
4
|
+
var chunkFMTNB27Z_cjs = require('./chunk-FMTNB27Z.cjs');
|
|
5
5
|
var chunk2GIBANLB_cjs = require('./chunk-2GIBANLB.cjs');
|
|
6
6
|
var async_hooks = require('async_hooks');
|
|
7
7
|
|
|
@@ -10,7 +10,7 @@ var workflowContextStorage = new async_hooks.AsyncLocalStorage();
|
|
|
10
10
|
function traceWorkflow(config) {
|
|
11
11
|
const spanName = `workflow.${config.name}`;
|
|
12
12
|
return (fnFactory) => {
|
|
13
|
-
return
|
|
13
|
+
return chunkFMTNB27Z_cjs.trace(spanName, (baseCtx) => {
|
|
14
14
|
return async (...args) => {
|
|
15
15
|
const workflowId = typeof config.workflowId === "function" ? config.workflowId(...args) : config.workflowId;
|
|
16
16
|
const ctx = createWorkflowContext(baseCtx, config.name, workflowId);
|
|
@@ -62,7 +62,7 @@ function traceWorkflow(config) {
|
|
|
62
62
|
function traceStep(config) {
|
|
63
63
|
return (fn) => {
|
|
64
64
|
const spanName = `step.${config.name}`;
|
|
65
|
-
return
|
|
65
|
+
return chunkFMTNB27Z_cjs.trace(spanName, (baseCtx) => {
|
|
66
66
|
return async (...args) => {
|
|
67
67
|
const workflowCtx = workflowContextStorage.getStore() ?? null;
|
|
68
68
|
const ctx = createStepContext(baseCtx, config, workflowCtx);
|
|
@@ -340,5 +340,5 @@ exports.getCurrentWorkflowContext = getCurrentWorkflowContext;
|
|
|
340
340
|
exports.isInWorkflow = isInWorkflow;
|
|
341
341
|
exports.traceStep = traceStep;
|
|
342
342
|
exports.traceWorkflow = traceWorkflow;
|
|
343
|
-
//# sourceMappingURL=chunk-
|
|
344
|
-
//# sourceMappingURL=chunk-
|
|
343
|
+
//# sourceMappingURL=chunk-C4JCSBFO.cjs.map
|
|
344
|
+
//# sourceMappingURL=chunk-C4JCSBFO.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/workflow.ts"],"names":["AsyncLocalStorage","trace","emitCorrelatedEvent","getActiveSpan"],"mappings":"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","file":"chunk-4RA6HIYF.cjs","sourcesContent":["/**\n * Workflow and Saga tracing helpers\n *\n * Provides specialized tracing for multi-step workflows and sagas with\n * automatic step linking, compensation tracking, and workflow correlation.\n *\n * @example Simple workflow\n * ```typescript\n * import { traceWorkflow, traceStep } from 'autotel/workflow';\n *\n * export const processOrder = traceWorkflow({\n * name: 'OrderFulfillment',\n * workflowId: (order) => order.id,\n * })(ctx => async (order: Order) => {\n * await validateOrder(order);\n * await chargePayment(order);\n * await shipOrder(order);\n * });\n * ```\n *\n * @example Saga with compensation\n * ```typescript\n * import { traceWorkflow, traceStep } from 'autotel/workflow';\n *\n * export const orderSaga = traceWorkflow({\n * name: 'OrderSaga',\n * workflowId: () => generateUUID(),\n * })(ctx => async (order: Order) => {\n *\n * const reserveStep = traceStep({\n * name: 'ReserveInventory',\n * compensate: async () => {\n * await releaseInventory(order.items);\n * },\n * })(async () => {\n * await inventoryService.reserve(order.items);\n * });\n * await reserveStep();\n *\n * const paymentStep = traceStep({\n * name: 'ProcessPayment',\n * linkToPrevious: true,\n * compensate: async () => {\n * await refundPayment(order.paymentId);\n * },\n * })(async () => {\n * await paymentService.charge(order);\n * });\n * await paymentStep();\n * });\n * ```\n *\n * @module\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Attributes, Link, SpanContext } from '@opentelemetry/api';\nimport { emitCorrelatedEvent } from './correlated-events';\nimport { trace } from './functional';\nimport type { TraceContext } from './trace-context';\nimport { getActiveSpan } from './trace-helpers';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Workflow status\n */\nexport type WorkflowStatus =\n | 'pending'\n | 'running'\n | 'completed'\n | 'failed'\n | 'compensating'\n | 'compensated'\n | 'compensation_failed';\n\n/**\n * Step status\n */\nexport type StepStatus =\n | 'pending'\n | 'running'\n | 'completed'\n | 'failed'\n | 'skipped'\n | 'compensated';\n\n/**\n * Configuration for workflow tracing\n */\nexport interface WorkflowConfig<TArgs extends unknown[] = unknown[]> {\n /** Workflow name (e.g., 'OrderFulfillment', 'UserOnboarding') */\n name: string;\n\n /**\n * Function to extract or generate workflow ID\n * Can be static string, function of args, or generator\n */\n workflowId: string | ((...args: TArgs) => string);\n\n /** Optional workflow version */\n version?: string;\n\n /** Additional attributes */\n attributes?: Attributes;\n\n /** Callback on workflow completion */\n onComplete?: (ctx: WorkflowContext, result: unknown) => void;\n\n /** Callback on workflow failure */\n onFailed?: (ctx: WorkflowContext, error: Error) => void;\n\n /** Callback on compensation start */\n onCompensating?: (ctx: WorkflowContext) => void;\n}\n\n/**\n * Configuration for workflow step tracing\n */\nexport interface StepConfig {\n /** Step name */\n name: string;\n\n /** Optional step description */\n description?: string;\n\n /** Step index (auto-assigned if not provided) */\n index?: number;\n\n /** Link to previous step span */\n linkToPrevious?: boolean;\n\n /** Link to specific step(s) by name */\n linkTo?: string | string[];\n\n /** Additional attributes */\n attributes?: Attributes;\n\n /** Compensation handler for saga rollback */\n compensate?: (error: Error) => Promise<void> | void;\n\n /** Whether this step is idempotent */\n idempotent?: boolean;\n\n /** Retry configuration */\n retry?: {\n maxAttempts: number;\n backoffMs?: number;\n };\n\n /** Callback on step completion */\n onComplete?: (ctx: StepContext) => void;\n\n /** Callback on step failure */\n onFailed?: (ctx: StepContext, error: Error) => void;\n}\n\n/**\n * Step metadata stored for linking and compensation\n */\ninterface StepMetadata {\n name: string;\n index: number;\n status: StepStatus;\n spanContext?: SpanContext;\n compensate?: (error: Error) => Promise<void> | void;\n startTime: number;\n endTime?: number;\n}\n\n/**\n * Extended trace context for workflows\n */\nexport interface WorkflowContext extends TraceContext {\n /** Get the workflow ID */\n getWorkflowId(): string;\n\n /** Get workflow name */\n getWorkflowName(): string;\n\n /** Get current workflow status */\n getStatus(): WorkflowStatus;\n\n /** Mark step as completed and store for linking */\n completeStep(stepName: string): void;\n\n /** Get previous step's span context for linking */\n getPreviousStep(stepName?: string): SpanContext | null;\n\n /** Get all completed steps */\n getCompletedSteps(): string[];\n\n /** Register a compensation handler */\n registerCompensation(\n stepName: string,\n handler: (error: Error) => Promise<void> | void,\n ): void;\n\n /** Trigger compensation for all registered steps */\n compensate(error: Error): Promise<void>;\n\n /** Record compensation result */\n recordCompensation(stepName: string, success: boolean, error?: Error): void;\n\n /** Set workflow status */\n setWorkflowStatus(status: WorkflowStatus): void;\n}\n\n/**\n * Extended trace context for workflow steps\n */\nexport interface StepContext extends TraceContext {\n /** Get step name */\n getStepName(): string;\n\n /** Get step index */\n getStepIndex(): number;\n\n /** Mark this step as completed */\n complete(): void;\n\n /** Skip this step */\n skip(reason?: string): void;\n\n /** Get workflow context */\n getWorkflowContext(): WorkflowContext | null;\n}\n\n// ============================================================================\n// Storage\n// ============================================================================\n\n// Store workflow state in a WeakMap keyed by span\nconst workflowStates = new WeakMap<\n object,\n {\n workflowId: string;\n workflowName: string;\n status: WorkflowStatus;\n steps: Map<string, StepMetadata>;\n stepCounter: number;\n compensations: Map<string, (error: Error) => Promise<void> | void>;\n }\n>();\n\n/**\n * AsyncLocalStorage for workflow context (async-safe)\n *\n * This replaces the previous module-level variable which was NOT safe for\n * concurrent workflows. AsyncLocalStorage ensures each async execution chain\n * has its own isolated workflow context.\n */\nconst workflowContextStorage = new AsyncLocalStorage<WorkflowContext>();\n\n// ============================================================================\n// Workflow Helper\n// ============================================================================\n\n/**\n * Create a traced workflow function\n *\n * Wraps business logic in a workflow span with automatic step tracking,\n * correlation via workflow ID, and compensation support.\n *\n * @param config - Workflow configuration\n * @returns Factory function that wraps your workflow logic\n *\n * @example Order fulfillment workflow\n * ```typescript\n * export const fulfillOrder = traceWorkflow({\n * name: 'OrderFulfillment',\n * workflowId: (order) => order.id,\n * version: '2.0',\n * })(ctx => async (order: Order) => {\n * ctx.setAttribute('order.total', order.total);\n *\n * await validateOrder(order);\n * await processPayment(order);\n * await fulfillItems(order);\n * await notifyCustomer(order);\n *\n * return { success: true, orderId: order.id };\n * });\n * ```\n */\nexport function traceWorkflow<TArgs extends unknown[], TReturn>(\n config: WorkflowConfig<TArgs>,\n) {\n const spanName = `workflow.${config.name}`;\n\n return (\n fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>(spanName, (baseCtx) => {\n return async (...args: TArgs) => {\n // Generate or extract workflow ID\n const workflowId =\n typeof config.workflowId === 'function'\n ? config.workflowId(...args)\n : config.workflowId;\n\n // Create workflow context\n const ctx = createWorkflowContext(baseCtx, config.name, workflowId);\n\n // Set workflow attributes\n ctx.setAttribute('workflow.name', config.name);\n ctx.setAttribute('workflow.id', workflowId);\n if (config.version) {\n ctx.setAttribute('workflow.version', config.version);\n }\n ctx.setAttribute('workflow.status', 'running');\n\n // Set custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined) {\n ctx.setAttribute(key, value as string | number | boolean);\n }\n }\n }\n\n // Run workflow in AsyncLocalStorage context for async-safety\n // This ensures concurrent workflows have isolated contexts\n return workflowContextStorage.run(ctx, async () => {\n try {\n // Execute workflow\n const userFn = fnFactory(ctx);\n const result = await userFn(...args);\n\n // Mark as completed\n ctx.setWorkflowStatus('completed');\n config.onComplete?.(ctx, result);\n\n return result;\n } catch (error) {\n // Mark as failed\n ctx.setWorkflowStatus('failed');\n config.onFailed?.(ctx, error as Error);\n\n // Check if we have compensations to run\n const state = getWorkflowState();\n if (state && state.compensations.size > 0) {\n ctx.setWorkflowStatus('compensating');\n config.onCompensating?.(ctx);\n\n try {\n await ctx.compensate(error as Error);\n ctx.setWorkflowStatus('compensated');\n } catch (compensationError) {\n ctx.setWorkflowStatus('compensation_failed');\n ctx.setAttribute(\n 'workflow.compensation.error',\n String(compensationError),\n );\n }\n }\n\n throw error;\n }\n });\n };\n });\n };\n}\n\n/**\n * Create a traced workflow step\n *\n * Wraps step logic with automatic linking to previous steps,\n * compensation registration, and status tracking.\n *\n * @param config - Step configuration\n * @returns Factory function that wraps your step logic\n *\n * @example Step with compensation\n * ```typescript\n * const chargePayment = traceStep({\n * name: 'ChargePayment',\n * linkToPrevious: true,\n * compensate: async (error) => {\n * await paymentService.refund(paymentId);\n * },\n * })(async (amount: number) => {\n * return await paymentService.charge(amount);\n * });\n * ```\n */\nexport function traceStep<TArgs extends unknown[], TReturn>(\n config: StepConfig,\n) {\n return (\n fn: (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n const spanName = `step.${config.name}`;\n\n return trace<TArgs, TReturn>(spanName, (baseCtx) => {\n return async (...args: TArgs) => {\n // Get workflow context from AsyncLocalStorage (async-safe)\n const workflowCtx = workflowContextStorage.getStore() ?? null;\n\n // Create step context\n const ctx = createStepContext(baseCtx, config, workflowCtx);\n\n // Set step attributes\n ctx.setAttribute('workflow.step.name', config.name);\n ctx.setAttribute('workflow.step.index', ctx.getStepIndex());\n ctx.setAttribute('workflow.step.status', 'running');\n\n if (config.description) {\n ctx.setAttribute('workflow.step.description', config.description);\n }\n\n if (config.idempotent) {\n ctx.setAttribute('workflow.step.idempotent', true);\n }\n\n // Set custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined) {\n ctx.setAttribute(key, value as string | number | boolean);\n }\n }\n }\n\n // Link to previous steps\n await addStepLinks(ctx, config, workflowCtx);\n\n // Register compensation if provided\n if (config.compensate && workflowCtx) {\n workflowCtx.registerCompensation(config.name, config.compensate);\n }\n\n // Execute with optional retry\n let lastError: Error | undefined;\n const maxAttempts = config.retry?.maxAttempts ?? 1;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n try {\n if (attempt > 1) {\n ctx.setAttribute('workflow.step.retry_attempt', attempt);\n emitCorrelatedEvent(ctx, 'step_retry', {\n 'workflow.step.attempt': attempt,\n 'workflow.step.max_attempts': maxAttempts,\n });\n\n // Backoff\n if (config.retry?.backoffMs) {\n await sleep(config.retry.backoffMs * attempt);\n }\n }\n\n const result = await fn(...args);\n\n // Mark as completed\n ctx.setAttribute('workflow.step.status', 'completed');\n ctx.complete();\n config.onComplete?.(ctx);\n\n return result;\n } catch (error) {\n lastError = error as Error;\n\n if (attempt < maxAttempts) {\n emitCorrelatedEvent(ctx, 'step_retry_scheduled', {\n 'workflow.step.error': String(error),\n 'workflow.step.attempt': attempt,\n });\n }\n }\n }\n\n // All attempts failed\n ctx.setAttribute('workflow.step.status', 'failed');\n ctx.setAttribute('workflow.step.error', String(lastError));\n config.onFailed?.(ctx, lastError!);\n\n throw lastError;\n };\n });\n };\n}\n\n// ============================================================================\n// Context Creation\n// ============================================================================\n\n/**\n * Create workflow-extended context\n */\nfunction createWorkflowContext(\n baseCtx: TraceContext,\n workflowName: string,\n workflowId: string,\n): WorkflowContext {\n // Initialize state\n const span = getActiveSpan();\n const state = {\n workflowId,\n workflowName,\n status: 'running' as WorkflowStatus,\n steps: new Map<string, StepMetadata>(),\n stepCounter: 0,\n compensations: new Map<string, (error: Error) => Promise<void> | void>(),\n };\n\n if (span) {\n workflowStates.set(span, state);\n }\n\n return {\n ...baseCtx,\n\n getWorkflowId(): string {\n return workflowId;\n },\n\n getWorkflowName(): string {\n return workflowName;\n },\n\n getStatus(): WorkflowStatus {\n return state.status;\n },\n\n completeStep(stepName: string): void {\n let step = state.steps.get(stepName);\n if (!step) {\n // Auto-create step entry for manually managed steps\n // (when using registerCompensation without traceStep)\n step = {\n name: stepName,\n index: state.stepCounter++,\n status: 'pending',\n startTime: Date.now(),\n };\n state.steps.set(stepName, step);\n }\n step.status = 'completed';\n step.endTime = Date.now();\n\n // Capture span context for linking\n const currentSpan = getActiveSpan();\n if (currentSpan) {\n step.spanContext = currentSpan.spanContext();\n }\n },\n\n getPreviousStep(stepName?: string): SpanContext | null {\n if (stepName) {\n const step = state.steps.get(stepName);\n return step?.spanContext ?? null;\n }\n\n // Get last completed step\n let lastStep: StepMetadata | null = null;\n for (const step of state.steps.values()) {\n if (\n step.status === 'completed' &&\n (!lastStep || step.index > lastStep.index)\n ) {\n lastStep = step;\n }\n }\n\n return lastStep?.spanContext ?? null;\n },\n\n getCompletedSteps(): string[] {\n const completed: string[] = [];\n for (const [name, step] of state.steps) {\n if (step.status === 'completed') {\n completed.push(name);\n }\n }\n return completed.toSorted(\n (a, b) =>\n (state.steps.get(a)?.index ?? 0) - (state.steps.get(b)?.index ?? 0),\n );\n },\n\n registerCompensation(\n stepName: string,\n handler: (error: Error) => Promise<void> | void,\n ): void {\n state.compensations.set(stepName, handler);\n },\n\n async compensate(error: Error): Promise<void> {\n // Execute compensations in reverse order\n const compensationOrder = [...state.compensations.entries()].toReversed();\n\n for (const [stepName, handler] of compensationOrder) {\n const step = state.steps.get(stepName);\n if (step && step.status === 'completed') {\n try {\n emitCorrelatedEvent(baseCtx, 'compensation_started', {\n 'workflow.step.name': stepName,\n });\n\n await Promise.resolve(handler(error));\n\n this.recordCompensation(stepName, true);\n step.status = 'compensated';\n } catch (compensationError) {\n this.recordCompensation(\n stepName,\n false,\n compensationError as Error,\n );\n throw compensationError;\n }\n }\n }\n },\n\n recordCompensation(\n stepName: string,\n success: boolean,\n error?: Error,\n ): void {\n emitCorrelatedEvent(baseCtx, 'compensation_completed', {\n 'workflow.step.name': stepName,\n 'workflow.compensation.success': success,\n ...(error && { 'workflow.compensation.error': String(error) }),\n });\n\n baseCtx.setAttribute(\n `workflow.compensation.${stepName}`,\n success ? 'success' : 'failed',\n );\n },\n\n setWorkflowStatus(status: WorkflowStatus): void {\n state.status = status;\n baseCtx.setAttribute('workflow.status', status);\n\n emitCorrelatedEvent(baseCtx, 'workflow_status_changed', {\n 'workflow.status': status,\n });\n },\n };\n}\n\n/**\n * Create step-extended context\n */\nfunction createStepContext(\n baseCtx: TraceContext,\n config: StepConfig,\n workflowCtx: WorkflowContext | null,\n): StepContext {\n // Determine step index\n let stepIndex = config.index ?? 0;\n if (workflowCtx) {\n const span = getActiveSpan();\n if (span) {\n const state = workflowStates.get(span);\n if (state) {\n stepIndex = config.index ?? state.stepCounter++;\n }\n }\n }\n\n // Register step metadata\n if (workflowCtx) {\n const wfSpan = getActiveSpan();\n if (wfSpan) {\n const state = workflowStates.get(wfSpan);\n if (state) {\n state.steps.set(config.name, {\n name: config.name,\n index: stepIndex,\n status: 'running',\n startTime: Date.now(),\n compensate: config.compensate,\n });\n }\n }\n }\n\n return {\n ...baseCtx,\n\n getStepName(): string {\n return config.name;\n },\n\n getStepIndex(): number {\n return stepIndex;\n },\n\n complete(): void {\n if (workflowCtx) {\n workflowCtx.completeStep(config.name);\n }\n },\n\n skip(reason?: string): void {\n baseCtx.setAttribute('workflow.step.status', 'skipped');\n if (reason) {\n baseCtx.setAttribute('workflow.step.skip_reason', reason);\n }\n emitCorrelatedEvent(baseCtx, 'step_skipped', {\n 'workflow.step.name': config.name,\n ...(reason && { 'workflow.step.skip_reason': reason }),\n });\n },\n\n getWorkflowContext(): WorkflowContext | null {\n return workflowCtx;\n },\n };\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Get workflow state from context\n */\nfunction getWorkflowState() {\n const span = getActiveSpan();\n return span ? workflowStates.get(span) : null;\n}\n\n/**\n * Add links to previous steps\n */\nasync function addStepLinks(\n ctx: StepContext,\n config: StepConfig,\n workflowCtx: WorkflowContext | null,\n): Promise<void> {\n if (!workflowCtx) return;\n\n const links: Link[] = [];\n\n // Link to previous step\n if (config.linkToPrevious) {\n const prevSpanContext = workflowCtx.getPreviousStep();\n if (prevSpanContext) {\n links.push({\n context: prevSpanContext,\n attributes: {\n 'workflow.link.type': 'sequence',\n },\n });\n }\n }\n\n // Link to specific steps\n if (config.linkTo) {\n const stepNames = Array.isArray(config.linkTo)\n ? config.linkTo\n : [config.linkTo];\n\n for (const stepName of stepNames) {\n const spanContext = workflowCtx.getPreviousStep(stepName);\n if (spanContext) {\n links.push({\n context: spanContext,\n attributes: {\n 'workflow.link.type': 'dependency',\n 'workflow.link.step': stepName,\n },\n });\n }\n }\n }\n\n // Add all links\n if (links.length > 0) {\n ctx.addLinks(links);\n }\n}\n\n/**\n * Sleep utility for retry backoff\n */\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// ============================================================================\n// Convenience Exports\n// ============================================================================\n\n/**\n * Get current workflow context (if inside a workflow)\n *\n * Uses AsyncLocalStorage to ensure async-safety when multiple\n * workflows are running concurrently.\n */\nexport function getCurrentWorkflowContext(): WorkflowContext | null {\n return workflowContextStorage.getStore() ?? null;\n}\n\n/**\n * Check if currently executing inside a workflow\n *\n * Uses AsyncLocalStorage to ensure async-safety when multiple\n * workflows are running concurrently.\n */\nexport function isInWorkflow(): boolean {\n return workflowContextStorage.getStore() !== undefined;\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/workflow.ts"],"names":["AsyncLocalStorage","trace","emitCorrelatedEvent","getActiveSpan"],"mappings":"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","file":"chunk-C4JCSBFO.cjs","sourcesContent":["/**\n * Workflow and Saga tracing helpers\n *\n * Provides specialized tracing for multi-step workflows and sagas with\n * automatic step linking, compensation tracking, and workflow correlation.\n *\n * @example Simple workflow\n * ```typescript\n * import { traceWorkflow, traceStep } from 'autotel/workflow';\n *\n * export const processOrder = traceWorkflow({\n * name: 'OrderFulfillment',\n * workflowId: (order) => order.id,\n * })(ctx => async (order: Order) => {\n * await validateOrder(order);\n * await chargePayment(order);\n * await shipOrder(order);\n * });\n * ```\n *\n * @example Saga with compensation\n * ```typescript\n * import { traceWorkflow, traceStep } from 'autotel/workflow';\n *\n * export const orderSaga = traceWorkflow({\n * name: 'OrderSaga',\n * workflowId: () => generateUUID(),\n * })(ctx => async (order: Order) => {\n *\n * const reserveStep = traceStep({\n * name: 'ReserveInventory',\n * compensate: async () => {\n * await releaseInventory(order.items);\n * },\n * })(async () => {\n * await inventoryService.reserve(order.items);\n * });\n * await reserveStep();\n *\n * const paymentStep = traceStep({\n * name: 'ProcessPayment',\n * linkToPrevious: true,\n * compensate: async () => {\n * await refundPayment(order.paymentId);\n * },\n * })(async () => {\n * await paymentService.charge(order);\n * });\n * await paymentStep();\n * });\n * ```\n *\n * @module\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Attributes, Link, SpanContext } from '@opentelemetry/api';\nimport { emitCorrelatedEvent } from './correlated-events';\nimport { trace } from './functional';\nimport type { TraceContext } from './trace-context';\nimport { getActiveSpan } from './trace-helpers';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Workflow status\n */\nexport type WorkflowStatus =\n | 'pending'\n | 'running'\n | 'completed'\n | 'failed'\n | 'compensating'\n | 'compensated'\n | 'compensation_failed';\n\n/**\n * Step status\n */\nexport type StepStatus =\n | 'pending'\n | 'running'\n | 'completed'\n | 'failed'\n | 'skipped'\n | 'compensated';\n\n/**\n * Configuration for workflow tracing\n */\nexport interface WorkflowConfig<TArgs extends unknown[] = unknown[]> {\n /** Workflow name (e.g., 'OrderFulfillment', 'UserOnboarding') */\n name: string;\n\n /**\n * Function to extract or generate workflow ID\n * Can be static string, function of args, or generator\n */\n workflowId: string | ((...args: TArgs) => string);\n\n /** Optional workflow version */\n version?: string;\n\n /** Additional attributes */\n attributes?: Attributes;\n\n /** Callback on workflow completion */\n onComplete?: (ctx: WorkflowContext, result: unknown) => void;\n\n /** Callback on workflow failure */\n onFailed?: (ctx: WorkflowContext, error: Error) => void;\n\n /** Callback on compensation start */\n onCompensating?: (ctx: WorkflowContext) => void;\n}\n\n/**\n * Configuration for workflow step tracing\n */\nexport interface StepConfig {\n /** Step name */\n name: string;\n\n /** Optional step description */\n description?: string;\n\n /** Step index (auto-assigned if not provided) */\n index?: number;\n\n /** Link to previous step span */\n linkToPrevious?: boolean;\n\n /** Link to specific step(s) by name */\n linkTo?: string | string[];\n\n /** Additional attributes */\n attributes?: Attributes;\n\n /** Compensation handler for saga rollback */\n compensate?: (error: Error) => Promise<void> | void;\n\n /** Whether this step is idempotent */\n idempotent?: boolean;\n\n /** Retry configuration */\n retry?: {\n maxAttempts: number;\n backoffMs?: number;\n };\n\n /** Callback on step completion */\n onComplete?: (ctx: StepContext) => void;\n\n /** Callback on step failure */\n onFailed?: (ctx: StepContext, error: Error) => void;\n}\n\n/**\n * Step metadata stored for linking and compensation\n */\ninterface StepMetadata {\n name: string;\n index: number;\n status: StepStatus;\n spanContext?: SpanContext;\n compensate?: (error: Error) => Promise<void> | void;\n startTime: number;\n endTime?: number;\n}\n\n/**\n * Extended trace context for workflows\n */\nexport interface WorkflowContext extends TraceContext {\n /** Get the workflow ID */\n getWorkflowId(): string;\n\n /** Get workflow name */\n getWorkflowName(): string;\n\n /** Get current workflow status */\n getStatus(): WorkflowStatus;\n\n /** Mark step as completed and store for linking */\n completeStep(stepName: string): void;\n\n /** Get previous step's span context for linking */\n getPreviousStep(stepName?: string): SpanContext | null;\n\n /** Get all completed steps */\n getCompletedSteps(): string[];\n\n /** Register a compensation handler */\n registerCompensation(\n stepName: string,\n handler: (error: Error) => Promise<void> | void,\n ): void;\n\n /** Trigger compensation for all registered steps */\n compensate(error: Error): Promise<void>;\n\n /** Record compensation result */\n recordCompensation(stepName: string, success: boolean, error?: Error): void;\n\n /** Set workflow status */\n setWorkflowStatus(status: WorkflowStatus): void;\n}\n\n/**\n * Extended trace context for workflow steps\n */\nexport interface StepContext extends TraceContext {\n /** Get step name */\n getStepName(): string;\n\n /** Get step index */\n getStepIndex(): number;\n\n /** Mark this step as completed */\n complete(): void;\n\n /** Skip this step */\n skip(reason?: string): void;\n\n /** Get workflow context */\n getWorkflowContext(): WorkflowContext | null;\n}\n\n// ============================================================================\n// Storage\n// ============================================================================\n\n// Store workflow state in a WeakMap keyed by span\nconst workflowStates = new WeakMap<\n object,\n {\n workflowId: string;\n workflowName: string;\n status: WorkflowStatus;\n steps: Map<string, StepMetadata>;\n stepCounter: number;\n compensations: Map<string, (error: Error) => Promise<void> | void>;\n }\n>();\n\n/**\n * AsyncLocalStorage for workflow context (async-safe)\n *\n * This replaces the previous module-level variable which was NOT safe for\n * concurrent workflows. AsyncLocalStorage ensures each async execution chain\n * has its own isolated workflow context.\n */\nconst workflowContextStorage = new AsyncLocalStorage<WorkflowContext>();\n\n// ============================================================================\n// Workflow Helper\n// ============================================================================\n\n/**\n * Create a traced workflow function\n *\n * Wraps business logic in a workflow span with automatic step tracking,\n * correlation via workflow ID, and compensation support.\n *\n * @param config - Workflow configuration\n * @returns Factory function that wraps your workflow logic\n *\n * @example Order fulfillment workflow\n * ```typescript\n * export const fulfillOrder = traceWorkflow({\n * name: 'OrderFulfillment',\n * workflowId: (order) => order.id,\n * version: '2.0',\n * })(ctx => async (order: Order) => {\n * ctx.setAttribute('order.total', order.total);\n *\n * await validateOrder(order);\n * await processPayment(order);\n * await fulfillItems(order);\n * await notifyCustomer(order);\n *\n * return { success: true, orderId: order.id };\n * });\n * ```\n */\nexport function traceWorkflow<TArgs extends unknown[], TReturn>(\n config: WorkflowConfig<TArgs>,\n) {\n const spanName = `workflow.${config.name}`;\n\n return (\n fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>(spanName, (baseCtx) => {\n return async (...args: TArgs) => {\n // Generate or extract workflow ID\n const workflowId =\n typeof config.workflowId === 'function'\n ? config.workflowId(...args)\n : config.workflowId;\n\n // Create workflow context\n const ctx = createWorkflowContext(baseCtx, config.name, workflowId);\n\n // Set workflow attributes\n ctx.setAttribute('workflow.name', config.name);\n ctx.setAttribute('workflow.id', workflowId);\n if (config.version) {\n ctx.setAttribute('workflow.version', config.version);\n }\n ctx.setAttribute('workflow.status', 'running');\n\n // Set custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined) {\n ctx.setAttribute(key, value as string | number | boolean);\n }\n }\n }\n\n // Run workflow in AsyncLocalStorage context for async-safety\n // This ensures concurrent workflows have isolated contexts\n return workflowContextStorage.run(ctx, async () => {\n try {\n // Execute workflow\n const userFn = fnFactory(ctx);\n const result = await userFn(...args);\n\n // Mark as completed\n ctx.setWorkflowStatus('completed');\n config.onComplete?.(ctx, result);\n\n return result;\n } catch (error) {\n // Mark as failed\n ctx.setWorkflowStatus('failed');\n config.onFailed?.(ctx, error as Error);\n\n // Check if we have compensations to run\n const state = getWorkflowState();\n if (state && state.compensations.size > 0) {\n ctx.setWorkflowStatus('compensating');\n config.onCompensating?.(ctx);\n\n try {\n await ctx.compensate(error as Error);\n ctx.setWorkflowStatus('compensated');\n } catch (compensationError) {\n ctx.setWorkflowStatus('compensation_failed');\n ctx.setAttribute(\n 'workflow.compensation.error',\n String(compensationError),\n );\n }\n }\n\n throw error;\n }\n });\n };\n });\n };\n}\n\n/**\n * Create a traced workflow step\n *\n * Wraps step logic with automatic linking to previous steps,\n * compensation registration, and status tracking.\n *\n * @param config - Step configuration\n * @returns Factory function that wraps your step logic\n *\n * @example Step with compensation\n * ```typescript\n * const chargePayment = traceStep({\n * name: 'ChargePayment',\n * linkToPrevious: true,\n * compensate: async (error) => {\n * await paymentService.refund(paymentId);\n * },\n * })(async (amount: number) => {\n * return await paymentService.charge(amount);\n * });\n * ```\n */\nexport function traceStep<TArgs extends unknown[], TReturn>(\n config: StepConfig,\n) {\n return (\n fn: (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n const spanName = `step.${config.name}`;\n\n return trace<TArgs, TReturn>(spanName, (baseCtx) => {\n return async (...args: TArgs) => {\n // Get workflow context from AsyncLocalStorage (async-safe)\n const workflowCtx = workflowContextStorage.getStore() ?? null;\n\n // Create step context\n const ctx = createStepContext(baseCtx, config, workflowCtx);\n\n // Set step attributes\n ctx.setAttribute('workflow.step.name', config.name);\n ctx.setAttribute('workflow.step.index', ctx.getStepIndex());\n ctx.setAttribute('workflow.step.status', 'running');\n\n if (config.description) {\n ctx.setAttribute('workflow.step.description', config.description);\n }\n\n if (config.idempotent) {\n ctx.setAttribute('workflow.step.idempotent', true);\n }\n\n // Set custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined) {\n ctx.setAttribute(key, value as string | number | boolean);\n }\n }\n }\n\n // Link to previous steps\n await addStepLinks(ctx, config, workflowCtx);\n\n // Register compensation if provided\n if (config.compensate && workflowCtx) {\n workflowCtx.registerCompensation(config.name, config.compensate);\n }\n\n // Execute with optional retry\n let lastError: Error | undefined;\n const maxAttempts = config.retry?.maxAttempts ?? 1;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n try {\n if (attempt > 1) {\n ctx.setAttribute('workflow.step.retry_attempt', attempt);\n emitCorrelatedEvent(ctx, 'step_retry', {\n 'workflow.step.attempt': attempt,\n 'workflow.step.max_attempts': maxAttempts,\n });\n\n // Backoff\n if (config.retry?.backoffMs) {\n await sleep(config.retry.backoffMs * attempt);\n }\n }\n\n const result = await fn(...args);\n\n // Mark as completed\n ctx.setAttribute('workflow.step.status', 'completed');\n ctx.complete();\n config.onComplete?.(ctx);\n\n return result;\n } catch (error) {\n lastError = error as Error;\n\n if (attempt < maxAttempts) {\n emitCorrelatedEvent(ctx, 'step_retry_scheduled', {\n 'workflow.step.error': String(error),\n 'workflow.step.attempt': attempt,\n });\n }\n }\n }\n\n // All attempts failed\n ctx.setAttribute('workflow.step.status', 'failed');\n ctx.setAttribute('workflow.step.error', String(lastError));\n config.onFailed?.(ctx, lastError!);\n\n throw lastError;\n };\n });\n };\n}\n\n// ============================================================================\n// Context Creation\n// ============================================================================\n\n/**\n * Create workflow-extended context\n */\nfunction createWorkflowContext(\n baseCtx: TraceContext,\n workflowName: string,\n workflowId: string,\n): WorkflowContext {\n // Initialize state\n const span = getActiveSpan();\n const state = {\n workflowId,\n workflowName,\n status: 'running' as WorkflowStatus,\n steps: new Map<string, StepMetadata>(),\n stepCounter: 0,\n compensations: new Map<string, (error: Error) => Promise<void> | void>(),\n };\n\n if (span) {\n workflowStates.set(span, state);\n }\n\n return {\n ...baseCtx,\n\n getWorkflowId(): string {\n return workflowId;\n },\n\n getWorkflowName(): string {\n return workflowName;\n },\n\n getStatus(): WorkflowStatus {\n return state.status;\n },\n\n completeStep(stepName: string): void {\n let step = state.steps.get(stepName);\n if (!step) {\n // Auto-create step entry for manually managed steps\n // (when using registerCompensation without traceStep)\n step = {\n name: stepName,\n index: state.stepCounter++,\n status: 'pending',\n startTime: Date.now(),\n };\n state.steps.set(stepName, step);\n }\n step.status = 'completed';\n step.endTime = Date.now();\n\n // Capture span context for linking\n const currentSpan = getActiveSpan();\n if (currentSpan) {\n step.spanContext = currentSpan.spanContext();\n }\n },\n\n getPreviousStep(stepName?: string): SpanContext | null {\n if (stepName) {\n const step = state.steps.get(stepName);\n return step?.spanContext ?? null;\n }\n\n // Get last completed step\n let lastStep: StepMetadata | null = null;\n for (const step of state.steps.values()) {\n if (\n step.status === 'completed' &&\n (!lastStep || step.index > lastStep.index)\n ) {\n lastStep = step;\n }\n }\n\n return lastStep?.spanContext ?? null;\n },\n\n getCompletedSteps(): string[] {\n const completed: string[] = [];\n for (const [name, step] of state.steps) {\n if (step.status === 'completed') {\n completed.push(name);\n }\n }\n return completed.toSorted(\n (a, b) =>\n (state.steps.get(a)?.index ?? 0) - (state.steps.get(b)?.index ?? 0),\n );\n },\n\n registerCompensation(\n stepName: string,\n handler: (error: Error) => Promise<void> | void,\n ): void {\n state.compensations.set(stepName, handler);\n },\n\n async compensate(error: Error): Promise<void> {\n // Execute compensations in reverse order\n const compensationOrder = [...state.compensations.entries()].toReversed();\n\n for (const [stepName, handler] of compensationOrder) {\n const step = state.steps.get(stepName);\n if (step && step.status === 'completed') {\n try {\n emitCorrelatedEvent(baseCtx, 'compensation_started', {\n 'workflow.step.name': stepName,\n });\n\n await Promise.resolve(handler(error));\n\n this.recordCompensation(stepName, true);\n step.status = 'compensated';\n } catch (compensationError) {\n this.recordCompensation(\n stepName,\n false,\n compensationError as Error,\n );\n throw compensationError;\n }\n }\n }\n },\n\n recordCompensation(\n stepName: string,\n success: boolean,\n error?: Error,\n ): void {\n emitCorrelatedEvent(baseCtx, 'compensation_completed', {\n 'workflow.step.name': stepName,\n 'workflow.compensation.success': success,\n ...(error && { 'workflow.compensation.error': String(error) }),\n });\n\n baseCtx.setAttribute(\n `workflow.compensation.${stepName}`,\n success ? 'success' : 'failed',\n );\n },\n\n setWorkflowStatus(status: WorkflowStatus): void {\n state.status = status;\n baseCtx.setAttribute('workflow.status', status);\n\n emitCorrelatedEvent(baseCtx, 'workflow_status_changed', {\n 'workflow.status': status,\n });\n },\n };\n}\n\n/**\n * Create step-extended context\n */\nfunction createStepContext(\n baseCtx: TraceContext,\n config: StepConfig,\n workflowCtx: WorkflowContext | null,\n): StepContext {\n // Determine step index\n let stepIndex = config.index ?? 0;\n if (workflowCtx) {\n const span = getActiveSpan();\n if (span) {\n const state = workflowStates.get(span);\n if (state) {\n stepIndex = config.index ?? state.stepCounter++;\n }\n }\n }\n\n // Register step metadata\n if (workflowCtx) {\n const wfSpan = getActiveSpan();\n if (wfSpan) {\n const state = workflowStates.get(wfSpan);\n if (state) {\n state.steps.set(config.name, {\n name: config.name,\n index: stepIndex,\n status: 'running',\n startTime: Date.now(),\n compensate: config.compensate,\n });\n }\n }\n }\n\n return {\n ...baseCtx,\n\n getStepName(): string {\n return config.name;\n },\n\n getStepIndex(): number {\n return stepIndex;\n },\n\n complete(): void {\n if (workflowCtx) {\n workflowCtx.completeStep(config.name);\n }\n },\n\n skip(reason?: string): void {\n baseCtx.setAttribute('workflow.step.status', 'skipped');\n if (reason) {\n baseCtx.setAttribute('workflow.step.skip_reason', reason);\n }\n emitCorrelatedEvent(baseCtx, 'step_skipped', {\n 'workflow.step.name': config.name,\n ...(reason && { 'workflow.step.skip_reason': reason }),\n });\n },\n\n getWorkflowContext(): WorkflowContext | null {\n return workflowCtx;\n },\n };\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Get workflow state from context\n */\nfunction getWorkflowState() {\n const span = getActiveSpan();\n return span ? workflowStates.get(span) : null;\n}\n\n/**\n * Add links to previous steps\n */\nasync function addStepLinks(\n ctx: StepContext,\n config: StepConfig,\n workflowCtx: WorkflowContext | null,\n): Promise<void> {\n if (!workflowCtx) return;\n\n const links: Link[] = [];\n\n // Link to previous step\n if (config.linkToPrevious) {\n const prevSpanContext = workflowCtx.getPreviousStep();\n if (prevSpanContext) {\n links.push({\n context: prevSpanContext,\n attributes: {\n 'workflow.link.type': 'sequence',\n },\n });\n }\n }\n\n // Link to specific steps\n if (config.linkTo) {\n const stepNames = Array.isArray(config.linkTo)\n ? config.linkTo\n : [config.linkTo];\n\n for (const stepName of stepNames) {\n const spanContext = workflowCtx.getPreviousStep(stepName);\n if (spanContext) {\n links.push({\n context: spanContext,\n attributes: {\n 'workflow.link.type': 'dependency',\n 'workflow.link.step': stepName,\n },\n });\n }\n }\n }\n\n // Add all links\n if (links.length > 0) {\n ctx.addLinks(links);\n }\n}\n\n/**\n * Sleep utility for retry backoff\n */\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// ============================================================================\n// Convenience Exports\n// ============================================================================\n\n/**\n * Get current workflow context (if inside a workflow)\n *\n * Uses AsyncLocalStorage to ensure async-safety when multiple\n * workflows are running concurrently.\n */\nexport function getCurrentWorkflowContext(): WorkflowContext | null {\n return workflowContextStorage.getStore() ?? null;\n}\n\n/**\n * Check if currently executing inside a workflow\n *\n * Uses AsyncLocalStorage to ensure async-safety when multiple\n * workflows are running concurrently.\n */\nexport function isInWorkflow(): boolean {\n return workflowContextStorage.getStore() !== undefined;\n}\n"]}
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
3
|
+
var chunkFMTNB27Z_cjs = require('./chunk-FMTNB27Z.cjs');
|
|
4
4
|
|
|
5
5
|
// src/semantic-helpers.ts
|
|
6
6
|
function traceLLM(config) {
|
|
7
7
|
return (fnFactory) => {
|
|
8
|
-
return
|
|
8
|
+
return chunkFMTNB27Z_cjs.trace((ctx) => {
|
|
9
9
|
ctx.setAttribute("gen.ai.request.model", config.model);
|
|
10
10
|
ctx.setAttribute("gen.ai.operation.name", config.operation || "chat");
|
|
11
11
|
if (config.provider) {
|
|
@@ -25,7 +25,7 @@ function traceLLM(config) {
|
|
|
25
25
|
}
|
|
26
26
|
function traceDB(config) {
|
|
27
27
|
return (fnFactory) => {
|
|
28
|
-
return
|
|
28
|
+
return chunkFMTNB27Z_cjs.trace((ctx) => {
|
|
29
29
|
ctx.setAttribute("db.system", config.system);
|
|
30
30
|
if (config.operation) {
|
|
31
31
|
ctx.setAttribute("db.operation", config.operation);
|
|
@@ -50,7 +50,7 @@ function traceDB(config) {
|
|
|
50
50
|
}
|
|
51
51
|
function traceHTTP(config) {
|
|
52
52
|
return (fnFactory) => {
|
|
53
|
-
return
|
|
53
|
+
return chunkFMTNB27Z_cjs.trace((ctx) => {
|
|
54
54
|
if (config.method) {
|
|
55
55
|
ctx.setAttribute("http.request.method", config.method);
|
|
56
56
|
}
|
|
@@ -71,7 +71,7 @@ function traceHTTP(config) {
|
|
|
71
71
|
}
|
|
72
72
|
function traceMessaging(config) {
|
|
73
73
|
return (fnFactory) => {
|
|
74
|
-
return
|
|
74
|
+
return chunkFMTNB27Z_cjs.trace((ctx) => {
|
|
75
75
|
ctx.setAttribute("messaging.system", config.system);
|
|
76
76
|
if (config.operation) {
|
|
77
77
|
ctx.setAttribute("messaging.operation", config.operation);
|
|
@@ -96,5 +96,5 @@ exports.traceDB = traceDB;
|
|
|
96
96
|
exports.traceHTTP = traceHTTP;
|
|
97
97
|
exports.traceLLM = traceLLM;
|
|
98
98
|
exports.traceMessaging = traceMessaging;
|
|
99
|
-
//# sourceMappingURL=chunk-
|
|
100
|
-
//# sourceMappingURL=chunk-
|
|
99
|
+
//# sourceMappingURL=chunk-DK6VFPVK.cjs.map
|
|
100
|
+
//# sourceMappingURL=chunk-DK6VFPVK.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/semantic-helpers.ts"],"names":["trace"],"mappings":";;;;;AAiLO,SAAS,SAA2C,MAAA,EAAmB;AAC5E,EAAA,OAAO,CACL,SAAA,KAC2C;AAC3C,IAAA,OAAOA,uBAAA,CAAsB,CAAC,GAAA,KAAQ;AAEpC,MAAA,GAAA,CAAI,YAAA,CAAa,sBAAA,EAAwB,MAAA,CAAO,KAAK,CAAA;AACrD,MAAA,GAAA,CAAI,YAAA,CAAa,uBAAA,EAAyB,MAAA,CAAO,SAAA,IAAa,MAAM,CAAA;AACpE,MAAA,IAAI,OAAO,QAAA,EAAU;AACnB,QAAA,GAAA,CAAI,YAAA,CAAa,eAAA,EAAiB,MAAA,CAAO,QAAQ,CAAA;AAAA,MACnD;AACA,MAAA,IAAI,OAAO,UAAA,EAAY;AACrB,QAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA,EAAG;AAC5D,UAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AAGzC,YAAA,MAAM,SAAA,GACJ,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,SAAA,GACb,KAAA,GACA,IAAA,CAAK,UAAU,KAAK,CAAA;AAC1B,YAAA,GAAA,CAAI,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAGA,MAAA,OAAO,UAAU,GAAG,CAAA;AAAA,IACtB,CAAC,CAAA;AAAA,EACH,CAAA;AACF;AAqGO,SAAS,QAA0C,MAAA,EAAkB;AAC1E,EAAA,OAAO,CACL,SAAA,KAC2C;AAC3C,IAAA,OAAOA,uBAAA,CAAsB,CAAC,GAAA,KAAQ;AAEpC,MAAA,GAAA,CAAI,YAAA,CAAa,WAAA,EAAa,MAAA,CAAO,MAAM,CAAA;AAC3C,MAAA,IAAI,OAAO,SAAA,EAAW;AACpB,QAAA,GAAA,CAAI,YAAA,CAAa,cAAA,EAAgB,MAAA,CAAO,SAAS,CAAA;AAAA,MACnD;AACA,MAAA,IAAI,OAAO,QAAA,EAAU;AACnB,QAAA,GAAA,CAAI,YAAA,CAAa,SAAA,EAAW,MAAA,CAAO,QAAQ,CAAA;AAAA,MAC7C;AACA,MAAA,IAAI,OAAO,UAAA,EAAY;AACrB,QAAA,GAAA,CAAI,YAAA,CAAa,oBAAA,EAAsB,MAAA,CAAO,UAAU,CAAA;AAAA,MAC1D;AACA,MAAA,IAAI,OAAO,UAAA,EAAY;AACrB,QAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA,EAAG;AAC5D,UAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AAGzC,YAAA,MAAM,SAAA,GACJ,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,SAAA,GACb,KAAA,GACA,IAAA,CAAK,UAAU,KAAK,CAAA;AAC1B,YAAA,GAAA,CAAI,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAGA,MAAA,OAAO,UAAU,GAAG,CAAA;AAAA,IACtB,CAAC,CAAA;AAAA,EACH,CAAA;AACF;AAsEO,SAAS,UACd,MAAA,EACA;AACA,EAAA,OAAO,CACL,SAAA,KAC2C;AAC3C,IAAA,OAAOA,uBAAA,CAAsB,CAAC,GAAA,KAAQ;AAEpC,MAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,QAAA,GAAA,CAAI,YAAA,CAAa,qBAAA,EAAuB,MAAA,CAAO,MAAM,CAAA;AAAA,MACvD;AACA,MAAA,IAAI,OAAO,GAAA,EAAK;AACd,QAAA,GAAA,CAAI,YAAA,CAAa,UAAA,EAAY,MAAA,CAAO,GAAG,CAAA;AAAA,MACzC;AACA,MAAA,IAAI,OAAO,UAAA,EAAY;AACrB,QAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA,EAAG;AAC5D,UAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AAGzC,YAAA,MAAM,SAAA,GACJ,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,SAAA,GACb,KAAA,GACA,IAAA,CAAK,UAAU,KAAK,CAAA;AAC1B,YAAA,GAAA,CAAI,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAGA,MAAA,OAAO,UAAU,GAAG,CAAA;AAAA,IACtB,CAAC,CAAA;AAAA,EACH,CAAA;AACF;AAmGO,SAAS,eACd,MAAA,EACA;AACA,EAAA,OAAO,CACL,SAAA,KAC2C;AAC3C,IAAA,OAAOA,uBAAA,CAAsB,CAAC,GAAA,KAAQ;AAEpC,MAAA,GAAA,CAAI,YAAA,CAAa,kBAAA,EAAoB,MAAA,CAAO,MAAM,CAAA;AAClD,MAAA,IAAI,OAAO,SAAA,EAAW;AACpB,QAAA,GAAA,CAAI,YAAA,CAAa,qBAAA,EAAuB,MAAA,CAAO,SAAS,CAAA;AAAA,MAC1D;AACA,MAAA,IAAI,OAAO,WAAA,EAAa;AACtB,QAAA,GAAA,CAAI,YAAA,CAAa,4BAAA,EAA8B,MAAA,CAAO,WAAW,CAAA;AAAA,MACnE;AACA,MAAA,IAAI,OAAO,UAAA,EAAY;AACrB,QAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA,EAAG;AAC5D,UAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AAGzC,YAAA,MAAM,SAAA,GACJ,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,QAAA,IACjB,OAAO,KAAA,KAAU,SAAA,GACb,KAAA,GACA,IAAA,CAAK,UAAU,KAAK,CAAA;AAC1B,YAAA,GAAA,CAAI,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAGA,MAAA,OAAO,UAAU,GAAG,CAAA;AAAA,IACtB,CAAC,CAAA;AAAA,EACH,CAAA;AACF","file":"chunk-QICFEFD6.cjs","sourcesContent":["/**\n * Semantic convention helpers for OpenTelemetry\n *\n * Pre-configured trace helpers that follow OpenTelemetry semantic conventions\n * for common operation types. Reduces boilerplate and ensures consistency.\n *\n * Based on: https://opentelemetry.io/docs/specs/semconv/\n */\n\nimport { trace } from './functional';\nimport type { TraceContext } from './trace-context';\nimport type { Attributes } from '@opentelemetry/api';\n\n/**\n * Configuration for LLM (Large Language Model) operations\n *\n * Follows Gen AI semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/gen-ai/\n */\nexport interface LLMConfig {\n /** Model name (e.g., 'gpt-4', 'claude-3-opus') */\n model: string;\n /** Operation type */\n operation?: 'chat' | 'completion' | 'embedding';\n /** Model provider (e.g., 'openai', 'anthropic', 'cohere') - maps to gen.ai.system */\n provider?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Configuration for database operations\n *\n * Follows DB semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/database/\n */\nexport interface DBConfig {\n /** Database system (e.g., 'postgresql', 'mongodb', 'redis') */\n system: string;\n /** Operation type (e.g., 'SELECT', 'INSERT', 'find', 'get') */\n operation?: string;\n /** Database name */\n database?: string;\n /** Collection/table name */\n collection?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Configuration for HTTP client operations\n *\n * Follows HTTP semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/http/\n */\nexport interface HTTPConfig {\n /** HTTP method (e.g., 'GET', 'POST') */\n method?: string;\n /** Target URL or URL template */\n url?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Configuration for messaging operations\n *\n * Follows Messaging semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/messaging/\n */\nexport interface MessagingConfig {\n /** Messaging system (e.g., 'kafka', 'rabbitmq', 'sqs') */\n system: string;\n /** Operation type */\n operation?: 'publish' | 'receive' | 'process';\n /** Destination name (queue/topic) */\n destination?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Trace LLM operations with Gen AI semantic conventions\n *\n * Automatically adds standard attributes for LLM operations:\n * - gen.ai.request.model\n * - gen.ai.operation.name\n * - gen.ai.system\n *\n * **Use Cases:**\n * - Chat completions\n * - Text generation\n * - Embeddings\n * - Multi-step LLM workflows\n *\n * @param config - LLM operation configuration\n * @returns Traced function factory with Gen AI attributes\n *\n * @example Chat completion with OpenAI\n * ```typescript\n * import { traceLLM } from 'autotel/semantic-helpers'\n * import OpenAI from 'openai'\n *\n * const openai = new OpenAI()\n *\n * export const generateResponse = traceLLM({\n * model: 'gpt-4-turbo',\n * operation: 'chat',\n * provider: 'openai'\n * })(ctx => async (prompt: string) => {\n * const response = await openai.chat.completions.create({\n * model: 'gpt-4-turbo',\n * messages: [{ role: 'user', content: prompt }]\n * })\n *\n * // Add usage metrics to span\n * ctx.setAttribute('gen.ai.usage.completion_tokens', response.usage?.completion_tokens)\n * ctx.setAttribute('gen.ai.usage.prompt_tokens', response.usage?.prompt_tokens)\n *\n * return response.choices[0].message.content\n * })\n * ```\n *\n * @example Anthropic Claude with streaming\n * ```typescript\n * import { traceLLM } from 'autotel/semantic-helpers'\n * import Anthropic from '@anthropic-ai/sdk'\n *\n * const anthropic = new Anthropic()\n *\n * export const streamResponse = traceLLM({\n * model: 'claude-3-opus-20240229',\n * operation: 'chat',\n * provider: 'anthropic'\n * })(ctx => async function* (prompt: string) {\n * const stream = await anthropic.messages.create({\n * model: 'claude-3-opus-20240229',\n * messages: [{ role: 'user', content: prompt }],\n * stream: true,\n * max_tokens: 1024\n * })\n *\n * let totalTokens = 0\n * for await (const event of stream) {\n * if (event.type === 'content_block_delta') {\n * yield event.delta.text\n * }\n * if (event.type === 'message_stop') {\n * ctx.setAttribute('gen.ai.usage.completion_tokens', event.message.usage.output_tokens)\n * totalTokens = event.message.usage.output_tokens\n * }\n * }\n *\n * return totalTokens\n * })\n * ```\n *\n * @example Embeddings\n * ```typescript\n * import { traceLLM } from 'autotel/semantic-helpers'\n * import { OpenAIEmbeddings } from '@langchain/openai'\n *\n * const embeddings = new OpenAIEmbeddings()\n *\n * export const embed = traceLLM({\n * model: 'text-embedding-3-small',\n * operation: 'embedding',\n * provider: 'openai'\n * })(ctx => async (text: string) => {\n * const result = await embeddings.embedQuery(text)\n * ctx.setAttribute('gen.ai.response.embedding_length', result.length)\n * return result\n * })\n * ```\n *\n * @public\n */\nexport function traceLLM<TArgs extends unknown[], TReturn>(config: LLMConfig) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n ctx.setAttribute('gen.ai.request.model', config.model);\n ctx.setAttribute('gen.ai.operation.name', config.operation || 'chat');\n if (config.provider) {\n ctx.setAttribute('gen.ai.system', config.provider);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n\n/**\n * Trace database operations with DB semantic conventions\n *\n * Automatically adds standard attributes for database operations:\n * - db.system\n * - db.operation\n * - db.name\n * - db.collection.name (for NoSQL)\n *\n * **Use Cases:**\n * - SQL queries (PostgreSQL, MySQL, SQLite)\n * - NoSQL operations (MongoDB, DynamoDB, Redis)\n * - ORM queries (Prisma, TypeORM, Drizzle)\n *\n * @param config - Database operation configuration\n * @returns Traced function factory with DB attributes\n *\n * @example PostgreSQL query\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { pool } from './db'\n *\n * export const getUser = traceDB({\n * system: 'postgresql',\n * operation: 'SELECT',\n * database: 'app_db',\n * collection: 'users'\n * })(ctx => async (userId: string) => {\n * const query = 'SELECT * FROM users WHERE id = $1'\n * ctx.setAttribute('db.statement', query)\n *\n * const result = await pool.query(query, [userId])\n * ctx.setAttribute('db.rows_affected', result.rowCount)\n *\n * return result.rows[0]\n * })\n * ```\n *\n * @example MongoDB with Mongoose\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { User } from './models/User'\n *\n * export const findUsers = traceDB({\n * system: 'mongodb',\n * operation: 'find',\n * database: 'app_db',\n * collection: 'users'\n * })(ctx => async (filter: object) => {\n * ctx.setAttribute('db.mongodb.filter', JSON.stringify(filter))\n *\n * const users = await User.find(filter).limit(100)\n * ctx.setAttribute('db.response.count', users.length)\n *\n * return users\n * })\n * ```\n *\n * @example Redis operations\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { redis } from './redis'\n *\n * export const cacheGet = traceDB({\n * system: 'redis',\n * operation: 'GET'\n * })(ctx => async (key: string) => {\n * ctx.setAttribute('db.redis.key', key)\n *\n * const value = await redis.get(key)\n * ctx.setAttribute('db.response.cache_hit', value !== null)\n *\n * return value\n * })\n * ```\n *\n * @example Prisma with detailed query info\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { prisma } from './prisma'\n *\n * export const createPost = traceDB({\n * system: 'postgresql',\n * operation: 'INSERT',\n * database: 'app_db',\n * collection: 'posts'\n * })(ctx => async (data: { title: string; content: string; authorId: string }) => {\n * ctx.setAttribute('db.prisma.model', 'Post')\n * ctx.setAttribute('db.prisma.action', 'create')\n *\n * const post = await prisma.post.create({ data })\n *\n * ctx.setAttribute('db.response.id', post.id)\n * return post\n * })\n * ```\n *\n * @public\n */\nexport function traceDB<TArgs extends unknown[], TReturn>(config: DBConfig) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n ctx.setAttribute('db.system', config.system);\n if (config.operation) {\n ctx.setAttribute('db.operation', config.operation);\n }\n if (config.database) {\n ctx.setAttribute('db.name', config.database);\n }\n if (config.collection) {\n ctx.setAttribute('db.collection.name', config.collection);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n\n/**\n * Trace HTTP client operations with HTTP semantic conventions\n *\n * Automatically adds standard attributes for HTTP requests:\n * - http.request.method\n * - url.full\n *\n * **Use Cases:**\n * - External API calls\n * - Microservice communication\n * - Third-party integrations\n *\n * @param config - HTTP operation configuration\n * @returns Traced function factory with HTTP attributes\n *\n * @example Fetch API\n * ```typescript\n * import { traceHTTP } from 'autotel/semantic-helpers'\n *\n * export const fetchUser = traceHTTP({\n * method: 'GET',\n * url: 'https://api.example.com/users/:id'\n * })(ctx => async (userId: string) => {\n * const url = `https://api.example.com/users/${userId}`\n * ctx.setAttribute('url.full', url)\n *\n * const response = await fetch(url)\n * ctx.setAttribute('http.response.status_code', response.status)\n *\n * if (!response.ok) {\n * ctx.setAttribute('error', true)\n * throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n * }\n *\n * return response.json()\n * })\n * ```\n *\n * @example Axios with retry logic\n * ```typescript\n * import { traceHTTP } from 'autotel/semantic-helpers'\n * import axios from 'axios'\n *\n * export const sendWebhook = traceHTTP({\n * method: 'POST',\n * url: 'https://webhook.example.com/events'\n * })(ctx => async (payload: object) => {\n * let attempts = 0\n * const maxAttempts = 3\n *\n * while (attempts < maxAttempts) {\n * try {\n * attempts++\n * ctx.setAttribute('http.request.resend_count', attempts - 1)\n *\n * const response = await axios.post('https://webhook.example.com/events', payload)\n * ctx.setAttribute('http.response.status_code', response.status)\n * return response.data\n * } catch (error) {\n * if (attempts >= maxAttempts) throw error\n * await new Promise(resolve => setTimeout(resolve, 1000 * attempts))\n * }\n * }\n * })\n * ```\n *\n * @public\n */\nexport function traceHTTP<TArgs extends unknown[], TReturn>(\n config: HTTPConfig,\n) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n if (config.method) {\n ctx.setAttribute('http.request.method', config.method);\n }\n if (config.url) {\n ctx.setAttribute('url.full', config.url);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n\n/**\n * Trace messaging operations with Messaging semantic conventions\n *\n * Automatically adds standard attributes for messaging:\n * - messaging.system\n * - messaging.operation\n * - messaging.destination.name\n *\n * **Use Cases:**\n * - Publishing messages to queues/topics\n * - Consuming messages from queues/topics\n * - Event-driven architectures\n *\n * @param config - Messaging operation configuration\n * @returns Traced function factory with Messaging attributes\n *\n * @example Publishing to Kafka\n * ```typescript\n * import { traceMessaging } from 'autotel/semantic-helpers'\n * import { kafka } from './kafka'\n *\n * const producer = kafka.producer()\n *\n * export const publishEvent = traceMessaging({\n * system: 'kafka',\n * operation: 'publish',\n * destination: 'user-events'\n * })(ctx => async (event: { type: string; userId: string; data: object }) => {\n * ctx.setAttribute('messaging.message.type', event.type)\n * ctx.setAttribute('messaging.kafka.partition', 0)\n *\n * await producer.send({\n * topic: 'user-events',\n * messages: [\n * {\n * key: event.userId,\n * value: JSON.stringify(event.data)\n * }\n * ]\n * })\n *\n * ctx.setAttribute('messaging.message.id', event.userId)\n * })\n * ```\n *\n * @example Consuming from RabbitMQ\n * ```typescript\n * import { traceMessaging } from 'autotel/semantic-helpers'\n * import { channel } from './rabbitmq'\n *\n * export const processOrder = traceMessaging({\n * system: 'rabbitmq',\n * operation: 'process',\n * destination: 'orders'\n * })(ctx => async (message: { orderId: string; items: object[] }) => {\n * ctx.setAttribute('messaging.message.id', message.orderId)\n * ctx.setAttribute('messaging.message.body.size', JSON.stringify(message).length)\n *\n * // Process order logic\n * const result = await processOrderInternal(message)\n *\n * ctx.setAttribute('messaging.operation.result', 'success')\n * return result\n * })\n * ```\n *\n * @example AWS SQS with batch processing\n * ```typescript\n * import { traceMessaging } from 'autotel/semantic-helpers'\n * import { SQS } from '@aws-sdk/client-sqs'\n *\n * const sqs = new SQS()\n *\n * export const sendBatch = traceMessaging({\n * system: 'aws_sqs',\n * operation: 'publish',\n * destination: 'notifications-queue'\n * })(ctx => async (messages: Array<{ id: string; body: object }>) => {\n * ctx.setAttribute('messaging.batch.message_count', messages.length)\n *\n * const result = await sqs.sendMessageBatch({\n * QueueUrl: process.env.QUEUE_URL,\n * Entries: messages.map(msg => ({\n * Id: msg.id,\n * MessageBody: JSON.stringify(msg.body)\n * }))\n * })\n *\n * ctx.setAttribute('messaging.operation.success_count', result.Successful?.length || 0)\n * ctx.setAttribute('messaging.operation.failed_count', result.Failed?.length || 0)\n *\n * return result\n * })\n * ```\n *\n * @public\n */\nexport function traceMessaging<TArgs extends unknown[], TReturn>(\n config: MessagingConfig,\n) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n ctx.setAttribute('messaging.system', config.system);\n if (config.operation) {\n ctx.setAttribute('messaging.operation', config.operation);\n }\n if (config.destination) {\n ctx.setAttribute('messaging.destination.name', config.destination);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/semantic-helpers.ts"],"names":["trace"],"mappings":"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","file":"chunk-DK6VFPVK.cjs","sourcesContent":["/**\n * Semantic convention helpers for OpenTelemetry\n *\n * Pre-configured trace helpers that follow OpenTelemetry semantic conventions\n * for common operation types. Reduces boilerplate and ensures consistency.\n *\n * Based on: https://opentelemetry.io/docs/specs/semconv/\n */\n\nimport { trace } from './functional';\nimport type { TraceContext } from './trace-context';\nimport type { Attributes } from '@opentelemetry/api';\n\n/**\n * Configuration for LLM (Large Language Model) operations\n *\n * Follows Gen AI semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/gen-ai/\n */\nexport interface LLMConfig {\n /** Model name (e.g., 'gpt-4', 'claude-3-opus') */\n model: string;\n /** Operation type */\n operation?: 'chat' | 'completion' | 'embedding';\n /** Model provider (e.g., 'openai', 'anthropic', 'cohere') - maps to gen.ai.system */\n provider?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Configuration for database operations\n *\n * Follows DB semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/database/\n */\nexport interface DBConfig {\n /** Database system (e.g., 'postgresql', 'mongodb', 'redis') */\n system: string;\n /** Operation type (e.g., 'SELECT', 'INSERT', 'find', 'get') */\n operation?: string;\n /** Database name */\n database?: string;\n /** Collection/table name */\n collection?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Configuration for HTTP client operations\n *\n * Follows HTTP semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/http/\n */\nexport interface HTTPConfig {\n /** HTTP method (e.g., 'GET', 'POST') */\n method?: string;\n /** Target URL or URL template */\n url?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Configuration for messaging operations\n *\n * Follows Messaging semantic conventions:\n * https://opentelemetry.io/docs/specs/semconv/messaging/\n */\nexport interface MessagingConfig {\n /** Messaging system (e.g., 'kafka', 'rabbitmq', 'sqs') */\n system: string;\n /** Operation type */\n operation?: 'publish' | 'receive' | 'process';\n /** Destination name (queue/topic) */\n destination?: string;\n /** Additional attributes to add to the span */\n attributes?: Attributes;\n}\n\n/**\n * Trace LLM operations with Gen AI semantic conventions\n *\n * Automatically adds standard attributes for LLM operations:\n * - gen.ai.request.model\n * - gen.ai.operation.name\n * - gen.ai.system\n *\n * **Use Cases:**\n * - Chat completions\n * - Text generation\n * - Embeddings\n * - Multi-step LLM workflows\n *\n * @param config - LLM operation configuration\n * @returns Traced function factory with Gen AI attributes\n *\n * @example Chat completion with OpenAI\n * ```typescript\n * import { traceLLM } from 'autotel/semantic-helpers'\n * import OpenAI from 'openai'\n *\n * const openai = new OpenAI()\n *\n * export const generateResponse = traceLLM({\n * model: 'gpt-4-turbo',\n * operation: 'chat',\n * provider: 'openai'\n * })(ctx => async (prompt: string) => {\n * const response = await openai.chat.completions.create({\n * model: 'gpt-4-turbo',\n * messages: [{ role: 'user', content: prompt }]\n * })\n *\n * // Add usage metrics to span\n * ctx.setAttribute('gen.ai.usage.completion_tokens', response.usage?.completion_tokens)\n * ctx.setAttribute('gen.ai.usage.prompt_tokens', response.usage?.prompt_tokens)\n *\n * return response.choices[0].message.content\n * })\n * ```\n *\n * @example Anthropic Claude with streaming\n * ```typescript\n * import { traceLLM } from 'autotel/semantic-helpers'\n * import Anthropic from '@anthropic-ai/sdk'\n *\n * const anthropic = new Anthropic()\n *\n * export const streamResponse = traceLLM({\n * model: 'claude-3-opus-20240229',\n * operation: 'chat',\n * provider: 'anthropic'\n * })(ctx => async function* (prompt: string) {\n * const stream = await anthropic.messages.create({\n * model: 'claude-3-opus-20240229',\n * messages: [{ role: 'user', content: prompt }],\n * stream: true,\n * max_tokens: 1024\n * })\n *\n * let totalTokens = 0\n * for await (const event of stream) {\n * if (event.type === 'content_block_delta') {\n * yield event.delta.text\n * }\n * if (event.type === 'message_stop') {\n * ctx.setAttribute('gen.ai.usage.completion_tokens', event.message.usage.output_tokens)\n * totalTokens = event.message.usage.output_tokens\n * }\n * }\n *\n * return totalTokens\n * })\n * ```\n *\n * @example Embeddings\n * ```typescript\n * import { traceLLM } from 'autotel/semantic-helpers'\n * import { OpenAIEmbeddings } from '@langchain/openai'\n *\n * const embeddings = new OpenAIEmbeddings()\n *\n * export const embed = traceLLM({\n * model: 'text-embedding-3-small',\n * operation: 'embedding',\n * provider: 'openai'\n * })(ctx => async (text: string) => {\n * const result = await embeddings.embedQuery(text)\n * ctx.setAttribute('gen.ai.response.embedding_length', result.length)\n * return result\n * })\n * ```\n *\n * @public\n */\nexport function traceLLM<TArgs extends unknown[], TReturn>(config: LLMConfig) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n ctx.setAttribute('gen.ai.request.model', config.model);\n ctx.setAttribute('gen.ai.operation.name', config.operation || 'chat');\n if (config.provider) {\n ctx.setAttribute('gen.ai.system', config.provider);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n\n/**\n * Trace database operations with DB semantic conventions\n *\n * Automatically adds standard attributes for database operations:\n * - db.system\n * - db.operation\n * - db.name\n * - db.collection.name (for NoSQL)\n *\n * **Use Cases:**\n * - SQL queries (PostgreSQL, MySQL, SQLite)\n * - NoSQL operations (MongoDB, DynamoDB, Redis)\n * - ORM queries (Prisma, TypeORM, Drizzle)\n *\n * @param config - Database operation configuration\n * @returns Traced function factory with DB attributes\n *\n * @example PostgreSQL query\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { pool } from './db'\n *\n * export const getUser = traceDB({\n * system: 'postgresql',\n * operation: 'SELECT',\n * database: 'app_db',\n * collection: 'users'\n * })(ctx => async (userId: string) => {\n * const query = 'SELECT * FROM users WHERE id = $1'\n * ctx.setAttribute('db.statement', query)\n *\n * const result = await pool.query(query, [userId])\n * ctx.setAttribute('db.rows_affected', result.rowCount)\n *\n * return result.rows[0]\n * })\n * ```\n *\n * @example MongoDB with Mongoose\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { User } from './models/User'\n *\n * export const findUsers = traceDB({\n * system: 'mongodb',\n * operation: 'find',\n * database: 'app_db',\n * collection: 'users'\n * })(ctx => async (filter: object) => {\n * ctx.setAttribute('db.mongodb.filter', JSON.stringify(filter))\n *\n * const users = await User.find(filter).limit(100)\n * ctx.setAttribute('db.response.count', users.length)\n *\n * return users\n * })\n * ```\n *\n * @example Redis operations\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { redis } from './redis'\n *\n * export const cacheGet = traceDB({\n * system: 'redis',\n * operation: 'GET'\n * })(ctx => async (key: string) => {\n * ctx.setAttribute('db.redis.key', key)\n *\n * const value = await redis.get(key)\n * ctx.setAttribute('db.response.cache_hit', value !== null)\n *\n * return value\n * })\n * ```\n *\n * @example Prisma with detailed query info\n * ```typescript\n * import { traceDB } from 'autotel/semantic-helpers'\n * import { prisma } from './prisma'\n *\n * export const createPost = traceDB({\n * system: 'postgresql',\n * operation: 'INSERT',\n * database: 'app_db',\n * collection: 'posts'\n * })(ctx => async (data: { title: string; content: string; authorId: string }) => {\n * ctx.setAttribute('db.prisma.model', 'Post')\n * ctx.setAttribute('db.prisma.action', 'create')\n *\n * const post = await prisma.post.create({ data })\n *\n * ctx.setAttribute('db.response.id', post.id)\n * return post\n * })\n * ```\n *\n * @public\n */\nexport function traceDB<TArgs extends unknown[], TReturn>(config: DBConfig) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n ctx.setAttribute('db.system', config.system);\n if (config.operation) {\n ctx.setAttribute('db.operation', config.operation);\n }\n if (config.database) {\n ctx.setAttribute('db.name', config.database);\n }\n if (config.collection) {\n ctx.setAttribute('db.collection.name', config.collection);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n\n/**\n * Trace HTTP client operations with HTTP semantic conventions\n *\n * Automatically adds standard attributes for HTTP requests:\n * - http.request.method\n * - url.full\n *\n * **Use Cases:**\n * - External API calls\n * - Microservice communication\n * - Third-party integrations\n *\n * @param config - HTTP operation configuration\n * @returns Traced function factory with HTTP attributes\n *\n * @example Fetch API\n * ```typescript\n * import { traceHTTP } from 'autotel/semantic-helpers'\n *\n * export const fetchUser = traceHTTP({\n * method: 'GET',\n * url: 'https://api.example.com/users/:id'\n * })(ctx => async (userId: string) => {\n * const url = `https://api.example.com/users/${userId}`\n * ctx.setAttribute('url.full', url)\n *\n * const response = await fetch(url)\n * ctx.setAttribute('http.response.status_code', response.status)\n *\n * if (!response.ok) {\n * ctx.setAttribute('error', true)\n * throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n * }\n *\n * return response.json()\n * })\n * ```\n *\n * @example Axios with retry logic\n * ```typescript\n * import { traceHTTP } from 'autotel/semantic-helpers'\n * import axios from 'axios'\n *\n * export const sendWebhook = traceHTTP({\n * method: 'POST',\n * url: 'https://webhook.example.com/events'\n * })(ctx => async (payload: object) => {\n * let attempts = 0\n * const maxAttempts = 3\n *\n * while (attempts < maxAttempts) {\n * try {\n * attempts++\n * ctx.setAttribute('http.request.resend_count', attempts - 1)\n *\n * const response = await axios.post('https://webhook.example.com/events', payload)\n * ctx.setAttribute('http.response.status_code', response.status)\n * return response.data\n * } catch (error) {\n * if (attempts >= maxAttempts) throw error\n * await new Promise(resolve => setTimeout(resolve, 1000 * attempts))\n * }\n * }\n * })\n * ```\n *\n * @public\n */\nexport function traceHTTP<TArgs extends unknown[], TReturn>(\n config: HTTPConfig,\n) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n if (config.method) {\n ctx.setAttribute('http.request.method', config.method);\n }\n if (config.url) {\n ctx.setAttribute('url.full', config.url);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n\n/**\n * Trace messaging operations with Messaging semantic conventions\n *\n * Automatically adds standard attributes for messaging:\n * - messaging.system\n * - messaging.operation\n * - messaging.destination.name\n *\n * **Use Cases:**\n * - Publishing messages to queues/topics\n * - Consuming messages from queues/topics\n * - Event-driven architectures\n *\n * @param config - Messaging operation configuration\n * @returns Traced function factory with Messaging attributes\n *\n * @example Publishing to Kafka\n * ```typescript\n * import { traceMessaging } from 'autotel/semantic-helpers'\n * import { kafka } from './kafka'\n *\n * const producer = kafka.producer()\n *\n * export const publishEvent = traceMessaging({\n * system: 'kafka',\n * operation: 'publish',\n * destination: 'user-events'\n * })(ctx => async (event: { type: string; userId: string; data: object }) => {\n * ctx.setAttribute('messaging.message.type', event.type)\n * ctx.setAttribute('messaging.kafka.partition', 0)\n *\n * await producer.send({\n * topic: 'user-events',\n * messages: [\n * {\n * key: event.userId,\n * value: JSON.stringify(event.data)\n * }\n * ]\n * })\n *\n * ctx.setAttribute('messaging.message.id', event.userId)\n * })\n * ```\n *\n * @example Consuming from RabbitMQ\n * ```typescript\n * import { traceMessaging } from 'autotel/semantic-helpers'\n * import { channel } from './rabbitmq'\n *\n * export const processOrder = traceMessaging({\n * system: 'rabbitmq',\n * operation: 'process',\n * destination: 'orders'\n * })(ctx => async (message: { orderId: string; items: object[] }) => {\n * ctx.setAttribute('messaging.message.id', message.orderId)\n * ctx.setAttribute('messaging.message.body.size', JSON.stringify(message).length)\n *\n * // Process order logic\n * const result = await processOrderInternal(message)\n *\n * ctx.setAttribute('messaging.operation.result', 'success')\n * return result\n * })\n * ```\n *\n * @example AWS SQS with batch processing\n * ```typescript\n * import { traceMessaging } from 'autotel/semantic-helpers'\n * import { SQS } from '@aws-sdk/client-sqs'\n *\n * const sqs = new SQS()\n *\n * export const sendBatch = traceMessaging({\n * system: 'aws_sqs',\n * operation: 'publish',\n * destination: 'notifications-queue'\n * })(ctx => async (messages: Array<{ id: string; body: object }>) => {\n * ctx.setAttribute('messaging.batch.message_count', messages.length)\n *\n * const result = await sqs.sendMessageBatch({\n * QueueUrl: process.env.QUEUE_URL,\n * Entries: messages.map(msg => ({\n * Id: msg.id,\n * MessageBody: JSON.stringify(msg.body)\n * }))\n * })\n *\n * ctx.setAttribute('messaging.operation.success_count', result.Successful?.length || 0)\n * ctx.setAttribute('messaging.operation.failed_count', result.Failed?.length || 0)\n *\n * return result\n * })\n * ```\n *\n * @public\n */\nexport function traceMessaging<TArgs extends unknown[], TReturn>(\n config: MessagingConfig,\n) {\n return (\n fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>((ctx) => {\n // Set semantic convention attributes\n ctx.setAttribute('messaging.system', config.system);\n if (config.operation) {\n ctx.setAttribute('messaging.operation', config.operation);\n }\n if (config.destination) {\n ctx.setAttribute('messaging.destination.name', config.destination);\n }\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined && value !== null) {\n // setAttribute only accepts primitives (string | number | boolean)\n // Arrays and objects should be serialized\n const attrValue =\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n ? value\n : JSON.stringify(value);\n ctx.setAttribute(key, attrValue);\n }\n }\n }\n\n // Call the user's factory to get their function and return it\n return fnFactory(ctx);\n });\n };\n}\n"]}
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
var chunk2GIBANLB_cjs = require('./chunk-2GIBANLB.cjs');
|
|
4
4
|
var chunkVQTCQKHQ_cjs = require('./chunk-VQTCQKHQ.cjs');
|
|
5
|
-
var
|
|
6
|
-
var
|
|
5
|
+
var chunkJAX4LFGG_cjs = require('./chunk-JAX4LFGG.cjs');
|
|
6
|
+
var chunkRYVFCHSO_cjs = require('./chunk-RYVFCHSO.cjs');
|
|
7
7
|
var chunkVH77IPJN_cjs = require('./chunk-VH77IPJN.cjs');
|
|
8
8
|
var chunkESLWRGAG_cjs = require('./chunk-ESLWRGAG.cjs');
|
|
9
9
|
var api = require('@opentelemetry/api');
|
|
@@ -355,7 +355,7 @@ function shouldSkip(key, fn, skip) {
|
|
|
355
355
|
function getCtxValue() {
|
|
356
356
|
const activeSpan = api.trace.getActiveSpan();
|
|
357
357
|
if (!activeSpan) return null;
|
|
358
|
-
return
|
|
358
|
+
return chunkJAX4LFGG_cjs.createTraceContext(activeSpan);
|
|
359
359
|
}
|
|
360
360
|
var ctx = new Proxy(
|
|
361
361
|
{},
|
|
@@ -420,17 +420,17 @@ function wrapWithTracing(fnFactory, options, variableName) {
|
|
|
420
420
|
}
|
|
421
421
|
const startTime = performance.now();
|
|
422
422
|
const isRootSpan = options.startNewRoot || api.trace.getActiveSpan() === void 0;
|
|
423
|
-
const shouldAutoFlush = options.flushOnRootSpanEnd ??
|
|
424
|
-
const shouldAutoFlushSpans =
|
|
423
|
+
const shouldAutoFlush = options.flushOnRootSpanEnd ?? chunkRYVFCHSO_cjs.getConfig()?.flushOnRootSpanEnd ?? true;
|
|
424
|
+
const shouldAutoFlushSpans = chunkRYVFCHSO_cjs.getConfig()?.forceFlushOnShutdown ?? false;
|
|
425
425
|
const flushIfNeeded = async () => {
|
|
426
426
|
if (!shouldAutoFlush || !isRootSpan) return;
|
|
427
427
|
try {
|
|
428
|
-
const queue =
|
|
428
|
+
const queue = chunkJAX4LFGG_cjs.getEventQueue();
|
|
429
429
|
if (queue && queue.size() > 0) {
|
|
430
430
|
await queue.flush();
|
|
431
431
|
}
|
|
432
432
|
if (shouldAutoFlushSpans) {
|
|
433
|
-
const sdk =
|
|
433
|
+
const sdk = chunkRYVFCHSO_cjs.getSdk();
|
|
434
434
|
if (sdk) {
|
|
435
435
|
try {
|
|
436
436
|
const sdkAny = sdk;
|
|
@@ -445,7 +445,7 @@ function wrapWithTracing(fnFactory, options, variableName) {
|
|
|
445
445
|
}
|
|
446
446
|
}
|
|
447
447
|
} catch (error) {
|
|
448
|
-
const initConfig =
|
|
448
|
+
const initConfig = chunkRYVFCHSO_cjs.getConfig();
|
|
449
449
|
const logger = initConfig?.logger;
|
|
450
450
|
if (logger?.error) {
|
|
451
451
|
logger.error(
|
|
@@ -464,7 +464,7 @@ function wrapWithTracing(fnFactory, options, variableName) {
|
|
|
464
464
|
if (options.spanKind !== void 0) {
|
|
465
465
|
spanOptions.kind = options.spanKind;
|
|
466
466
|
}
|
|
467
|
-
const parentContext =
|
|
467
|
+
const parentContext = chunkJAX4LFGG_cjs.getActiveContextWithBaggage();
|
|
468
468
|
return tracer.startActiveSpan(
|
|
469
469
|
spanName,
|
|
470
470
|
spanOptions,
|
|
@@ -474,11 +474,11 @@ function wrapWithTracing(fnFactory, options, variableName) {
|
|
|
474
474
|
let shouldKeepSpan = true;
|
|
475
475
|
chunk2GIBANLB_cjs.setSpanName(span2, spanName);
|
|
476
476
|
const initialContext = api.context.active();
|
|
477
|
-
const contextStorage =
|
|
477
|
+
const contextStorage = chunkJAX4LFGG_cjs.getContextStorage();
|
|
478
478
|
if (!contextStorage.getStore()) {
|
|
479
|
-
|
|
479
|
+
chunkJAX4LFGG_cjs.enterOrRun(contextStorage, initialContext);
|
|
480
480
|
}
|
|
481
|
-
const ctxValue =
|
|
481
|
+
const ctxValue = chunkJAX4LFGG_cjs.createTraceContext(span2);
|
|
482
482
|
const fn = fnFactory(ctxValue);
|
|
483
483
|
const argsAttributes = options.attributesFromArgs ? options.attributesFromArgs(args) : {};
|
|
484
484
|
const handleTailSampling = (success, duration, error) => {
|
|
@@ -563,7 +563,7 @@ function wrapWithTracing(fnFactory, options, variableName) {
|
|
|
563
563
|
status: "started"
|
|
564
564
|
});
|
|
565
565
|
const executeWithContext = async () => {
|
|
566
|
-
const currentContext =
|
|
566
|
+
const currentContext = chunkJAX4LFGG_cjs.getActiveContextWithBaggage();
|
|
567
567
|
return api.context.with(currentContext, async () => {
|
|
568
568
|
return fn.call(this, ...args);
|
|
569
569
|
});
|
|
@@ -615,14 +615,14 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
|
|
|
615
615
|
}
|
|
616
616
|
const startTime = performance.now();
|
|
617
617
|
const isRootSpan = options.startNewRoot || api.trace.getActiveSpan() === void 0;
|
|
618
|
-
const shouldAutoFlush = options.flushOnRootSpanEnd ??
|
|
619
|
-
const shouldAutoFlushSpans =
|
|
618
|
+
const shouldAutoFlush = options.flushOnRootSpanEnd ?? chunkRYVFCHSO_cjs.getConfig()?.flushOnRootSpanEnd ?? true;
|
|
619
|
+
const shouldAutoFlushSpans = chunkRYVFCHSO_cjs.getConfig()?.forceFlushOnShutdown ?? false;
|
|
620
620
|
const flushIfNeeded = () => {
|
|
621
621
|
if (!shouldAutoFlush || !isRootSpan) return;
|
|
622
|
-
const queue =
|
|
622
|
+
const queue = chunkJAX4LFGG_cjs.getEventQueue();
|
|
623
623
|
if (queue && queue.size() > 0) {
|
|
624
624
|
void queue.flush().catch((error) => {
|
|
625
|
-
const initConfig =
|
|
625
|
+
const initConfig = chunkRYVFCHSO_cjs.getConfig();
|
|
626
626
|
const logger = initConfig?.logger;
|
|
627
627
|
if (logger?.error) {
|
|
628
628
|
logger.error(
|
|
@@ -635,7 +635,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
|
|
|
635
635
|
});
|
|
636
636
|
}
|
|
637
637
|
if (shouldAutoFlushSpans) {
|
|
638
|
-
const sdk =
|
|
638
|
+
const sdk = chunkRYVFCHSO_cjs.getSdk();
|
|
639
639
|
if (sdk) {
|
|
640
640
|
try {
|
|
641
641
|
const sdkAny = sdk;
|
|
@@ -643,7 +643,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
|
|
|
643
643
|
const tracerProvider = sdkAny.getTracerProvider();
|
|
644
644
|
if (tracerProvider && typeof tracerProvider.forceFlush === "function") {
|
|
645
645
|
void tracerProvider.forceFlush().catch((error) => {
|
|
646
|
-
const initConfig =
|
|
646
|
+
const initConfig = chunkRYVFCHSO_cjs.getConfig();
|
|
647
647
|
const logger = initConfig?.logger;
|
|
648
648
|
if (logger?.error) {
|
|
649
649
|
logger.error(
|
|
@@ -668,7 +668,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
|
|
|
668
668
|
if (options.spanKind !== void 0) {
|
|
669
669
|
spanOptions.kind = options.spanKind;
|
|
670
670
|
}
|
|
671
|
-
const parentContext =
|
|
671
|
+
const parentContext = chunkJAX4LFGG_cjs.getActiveContextWithBaggage();
|
|
672
672
|
return tracer.startActiveSpan(
|
|
673
673
|
spanName,
|
|
674
674
|
spanOptions,
|
|
@@ -677,7 +677,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
|
|
|
677
677
|
return chunkVQTCQKHQ_cjs.runInOperationContext(spanName, () => {
|
|
678
678
|
let shouldKeepSpan = true;
|
|
679
679
|
chunk2GIBANLB_cjs.setSpanName(span2, spanName);
|
|
680
|
-
const ctxValue =
|
|
680
|
+
const ctxValue = chunkJAX4LFGG_cjs.createTraceContext(span2);
|
|
681
681
|
const fn = fnFactory(ctxValue);
|
|
682
682
|
const argsAttributes = options.attributesFromArgs ? options.attributesFromArgs(args) : {};
|
|
683
683
|
const handleTailSampling = (success, duration, error) => {
|
|
@@ -792,8 +792,8 @@ function executeImmediately(fn, options) {
|
|
|
792
792
|
}
|
|
793
793
|
const startTime = performance.now();
|
|
794
794
|
const isRootSpan = options.startNewRoot || api.trace.getActiveSpan() === void 0;
|
|
795
|
-
const shouldAutoFlush = options.flushOnRootSpanEnd ??
|
|
796
|
-
const shouldAutoFlushSpans =
|
|
795
|
+
const shouldAutoFlush = options.flushOnRootSpanEnd ?? chunkRYVFCHSO_cjs.getConfig()?.flushOnRootSpanEnd ?? true;
|
|
796
|
+
const shouldAutoFlushSpans = chunkRYVFCHSO_cjs.getConfig()?.forceFlushOnShutdown ?? false;
|
|
797
797
|
const callCounter = options.withMetrics ? meter.createCounter(`${spanName}.calls`, {
|
|
798
798
|
description: `Call count for ${spanName}`,
|
|
799
799
|
unit: "1"
|
|
@@ -805,12 +805,12 @@ function executeImmediately(fn, options) {
|
|
|
805
805
|
const flushIfNeeded = async () => {
|
|
806
806
|
if (!shouldAutoFlush || !isRootSpan) return;
|
|
807
807
|
try {
|
|
808
|
-
const queue =
|
|
808
|
+
const queue = chunkJAX4LFGG_cjs.getEventQueue();
|
|
809
809
|
if (queue && queue.size() > 0) {
|
|
810
810
|
await queue.flush();
|
|
811
811
|
}
|
|
812
812
|
if (shouldAutoFlushSpans) {
|
|
813
|
-
const sdk =
|
|
813
|
+
const sdk = chunkRYVFCHSO_cjs.getSdk();
|
|
814
814
|
if (sdk) {
|
|
815
815
|
try {
|
|
816
816
|
const sdkAny = sdk;
|
|
@@ -825,7 +825,7 @@ function executeImmediately(fn, options) {
|
|
|
825
825
|
}
|
|
826
826
|
}
|
|
827
827
|
} catch (error) {
|
|
828
|
-
const initConfig =
|
|
828
|
+
const initConfig = chunkRYVFCHSO_cjs.getConfig();
|
|
829
829
|
const logger = initConfig?.logger;
|
|
830
830
|
if (logger?.error) {
|
|
831
831
|
logger.error(
|
|
@@ -844,7 +844,7 @@ function executeImmediately(fn, options) {
|
|
|
844
844
|
if (options.spanKind !== void 0) {
|
|
845
845
|
spanOptions.kind = options.spanKind;
|
|
846
846
|
}
|
|
847
|
-
const parentContext =
|
|
847
|
+
const parentContext = chunkJAX4LFGG_cjs.getActiveContextWithBaggage();
|
|
848
848
|
return tracer.startActiveSpan(
|
|
849
849
|
spanName,
|
|
850
850
|
spanOptions,
|
|
@@ -853,7 +853,7 @@ function executeImmediately(fn, options) {
|
|
|
853
853
|
return chunkVQTCQKHQ_cjs.runInOperationContext(spanName, () => {
|
|
854
854
|
let shouldKeepSpan = true;
|
|
855
855
|
chunk2GIBANLB_cjs.setSpanName(span2, spanName);
|
|
856
|
-
const ctxValue =
|
|
856
|
+
const ctxValue = chunkJAX4LFGG_cjs.createTraceContext(span2);
|
|
857
857
|
const handleTailSampling = (success, duration, error) => {
|
|
858
858
|
if (needsTailSampling && "shouldKeepTrace" in sampler && typeof sampler.shouldKeepTrace === "function") {
|
|
859
859
|
shouldKeepSpan = sampler.shouldKeepTrace(samplingContext, {
|
|
@@ -1135,7 +1135,7 @@ function span(nameOrOptions, fn) {
|
|
|
1135
1135
|
}
|
|
1136
1136
|
});
|
|
1137
1137
|
};
|
|
1138
|
-
const parentContext =
|
|
1138
|
+
const parentContext = chunkJAX4LFGG_cjs.getActiveContextWithBaggage();
|
|
1139
1139
|
const result = tracer.startActiveSpan(name, {}, parentContext, executeSpan);
|
|
1140
1140
|
if (result instanceof Promise) {
|
|
1141
1141
|
return result;
|
|
@@ -1170,7 +1170,7 @@ function withBaggage(options) {
|
|
|
1170
1170
|
updatedBaggage = updatedBaggage.setEntry(key, { value });
|
|
1171
1171
|
}
|
|
1172
1172
|
const newContext = api.propagation.setBaggage(currentContext, updatedBaggage);
|
|
1173
|
-
const ctxStorage =
|
|
1173
|
+
const ctxStorage = chunkJAX4LFGG_cjs.getContextStorage();
|
|
1174
1174
|
const previousStored = ctxStorage.getStore();
|
|
1175
1175
|
const baggageEnrichedStored = previousStored ? { value: api.propagation.setBaggage(previousStored.value, updatedBaggage) } : { value: newContext };
|
|
1176
1176
|
const result = previousStored ? ctxStorage.run(baggageEnrichedStored, () => api.context.with(newContext, fn)) : api.context.with(newContext, fn);
|
|
@@ -1203,5 +1203,5 @@ exports.trace = trace;
|
|
|
1203
1203
|
exports.withBaggage = withBaggage;
|
|
1204
1204
|
exports.withNewContext = withNewContext;
|
|
1205
1205
|
exports.withTracing = withTracing;
|
|
1206
|
-
//# sourceMappingURL=chunk-
|
|
1207
|
-
//# sourceMappingURL=chunk-
|
|
1206
|
+
//# sourceMappingURL=chunk-FMTNB27Z.cjs.map
|
|
1207
|
+
//# sourceMappingURL=chunk-FMTNB27Z.cjs.map
|