autotel 4.3.0 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +125 -103
- package/dist/analysis.cjs +87 -0
- package/dist/analysis.cjs.map +1 -0
- package/dist/analysis.d.cts +87 -0
- package/dist/analysis.d.cts.map +1 -0
- package/dist/analysis.d.ts +87 -0
- package/dist/analysis.d.ts.map +1 -0
- package/dist/analysis.js +85 -0
- package/dist/analysis.js.map +1 -0
- package/dist/{attribute-redacting-processor-DtTS9xxh.d.ts → attribute-redacting-processor-Pk7lAzWd.d.cts} +13 -8
- package/dist/attribute-redacting-processor-Pk7lAzWd.d.cts.map +1 -0
- package/dist/{attribute-redacting-processor-DtTS9xxh.d.cts → attribute-redacting-processor-Pk7lAzWd.d.ts} +13 -8
- package/dist/attribute-redacting-processor-Pk7lAzWd.d.ts.map +1 -0
- package/dist/attribute-redacting-processor.cjs +4 -4
- package/dist/attribute-redacting-processor.cjs.map +1 -1
- package/dist/attribute-redacting-processor.d.cts +1 -1
- package/dist/attribute-redacting-processor.d.ts +1 -1
- package/dist/attribute-redacting-processor.js +4 -4
- package/dist/attribute-redacting-processor.js.map +1 -1
- package/dist/attributes.d.cts +1 -1
- package/dist/attributes.d.ts +1 -1
- package/dist/auto.cjs +1 -1
- package/dist/auto.cjs.map +1 -1
- package/dist/auto.d.cts +1 -1
- package/dist/auto.d.ts +1 -1
- package/dist/auto.js +1 -1
- package/dist/auto.js.map +1 -1
- package/dist/business-baggage.d.cts +2 -3
- package/dist/business-baggage.d.cts.map +1 -1
- package/dist/business-baggage.d.ts +2 -3
- package/dist/business-baggage.d.ts.map +1 -1
- package/dist/{canonical-log-line-processor-xvjMgtpF.d.cts → canonical-log-line-processor-B4WgG-VS.d.cts} +2 -3
- package/dist/canonical-log-line-processor-B4WgG-VS.d.cts.map +1 -0
- package/dist/{canonical-log-line-processor-BcRuAdRk.d.ts → canonical-log-line-processor-CL_J7gb5.d.ts} +2 -3
- package/dist/canonical-log-line-processor-CL_J7gb5.d.ts.map +1 -0
- package/dist/{canonical-log-line-processor-CcrDi6TO.cjs → canonical-log-line-processor-DOjb6Kxy.cjs} +5 -5
- package/dist/canonical-log-line-processor-DOjb6Kxy.cjs.map +1 -0
- package/dist/{canonical-log-line-processor-FLezvFCB.js → canonical-log-line-processor-mKABvGP0.js} +5 -5
- package/dist/canonical-log-line-processor-mKABvGP0.js.map +1 -0
- package/dist/config.d.cts +12 -7
- package/dist/config.d.cts.map +1 -1
- package/dist/config.d.ts +12 -7
- package/dist/config.d.ts.map +1 -1
- package/dist/correlation-id.cjs +1 -1
- package/dist/correlation-id.d.cts +0 -1
- package/dist/correlation-id.d.cts.map +1 -1
- package/dist/correlation-id.d.ts +0 -1
- package/dist/correlation-id.d.ts.map +1 -1
- package/dist/correlation-id.js +1 -1
- package/dist/db.d.cts.map +1 -1
- package/dist/db.d.ts.map +1 -1
- package/dist/decorators.cjs +1 -1
- package/dist/decorators.cjs.map +1 -1
- package/dist/decorators.d.cts +1 -2
- package/dist/decorators.d.cts.map +1 -1
- package/dist/decorators.d.ts +1 -2
- package/dist/decorators.d.ts.map +1 -1
- package/dist/decorators.js +1 -1
- package/dist/decorators.js.map +1 -1
- package/dist/{define-event-CreknLm3.d.ts → define-event-B2z1SBe7.d.ts} +2 -3
- package/dist/define-event-B2z1SBe7.d.ts.map +1 -0
- package/dist/{define-event-HZRizPwz.d.cts → define-event-CGG048HE.d.cts} +2 -3
- package/dist/define-event-CGG048HE.d.cts.map +1 -0
- package/dist/diagnostics.cjs +10 -1
- package/dist/diagnostics.cjs.map +1 -1
- package/dist/diagnostics.d.cts +0 -1
- package/dist/diagnostics.d.cts.map +1 -1
- package/dist/diagnostics.d.ts +0 -1
- package/dist/diagnostics.d.ts.map +1 -1
- package/dist/diagnostics.js +10 -1
- package/dist/diagnostics.js.map +1 -1
- package/dist/drain-pipeline.d.cts +12 -5
- package/dist/drain-pipeline.d.cts.map +1 -1
- package/dist/drain-pipeline.d.ts +12 -5
- package/dist/drain-pipeline.d.ts.map +1 -1
- package/dist/enrichers.d.cts.map +1 -1
- package/dist/enrichers.d.ts.map +1 -1
- package/dist/{event-rzA1X5h3.cjs → event-CwIpFdoY.cjs} +3 -3
- package/dist/event-CwIpFdoY.cjs.map +1 -0
- package/dist/{event-BEm5IJ8U.js → event-pLMF5b3d.js} +4 -4
- package/dist/event-pLMF5b3d.js.map +1 -0
- package/dist/{event-subscriber-D1XLkPzi.d.ts → event-subscriber-CWh8sTGh.d.cts} +2 -2
- package/dist/event-subscriber-CWh8sTGh.d.cts.map +1 -0
- package/dist/{event-subscriber-D1XLkPzi.d.cts → event-subscriber-CWh8sTGh.d.ts} +2 -2
- package/dist/event-subscriber-CWh8sTGh.d.ts.map +1 -0
- package/dist/event-subscriber.d.cts +1 -1
- package/dist/event-subscriber.d.ts +1 -1
- package/dist/{event-testing-CfFs3to2.d.ts → event-testing-CA2mIx1E.d.ts} +2 -3
- package/dist/event-testing-CA2mIx1E.d.ts.map +1 -0
- package/dist/{event-testing-BqRnI0z4.d.cts → event-testing-D0qWfqAy.d.cts} +2 -3
- package/dist/event-testing-D0qWfqAy.d.cts.map +1 -0
- package/dist/event-testing.d.cts +1 -1
- package/dist/event-testing.d.ts +1 -1
- package/dist/event.cjs +1 -1
- package/dist/event.d.cts +3 -4
- package/dist/event.d.cts.map +1 -1
- package/dist/event.d.ts +3 -4
- package/dist/event.d.ts.map +1 -1
- package/dist/event.js +1 -1
- package/dist/exporters.d.cts +0 -4
- package/dist/exporters.d.cts.map +1 -1
- package/dist/exporters.d.ts +0 -4
- package/dist/exporters.d.ts.map +1 -1
- package/dist/{filtering-span-processor-B8R8B7Uk.d.ts → filtering-span-processor-BpDagWNa.d.cts} +1 -2
- package/dist/filtering-span-processor-BpDagWNa.d.cts.map +1 -0
- package/dist/{filtering-span-processor-B8R8B7Uk.d.cts → filtering-span-processor-BpDagWNa.d.ts} +1 -2
- package/dist/filtering-span-processor-BpDagWNa.d.ts.map +1 -0
- package/dist/filtering-span-processor.d.cts +1 -1
- package/dist/filtering-span-processor.d.ts +1 -1
- package/dist/functional-Bit6noRu.js +840 -0
- package/dist/functional-Bit6noRu.js.map +1 -0
- package/dist/functional-Cj7PSItS.cjs +890 -0
- package/dist/functional-Cj7PSItS.cjs.map +1 -0
- package/dist/functional.cjs +2 -2
- package/dist/functional.d.cts +79 -130
- package/dist/functional.d.cts.map +1 -1
- package/dist/functional.d.ts +79 -130
- package/dist/functional.d.ts.map +1 -1
- package/dist/functional.js +2 -2
- package/dist/http.cjs +5 -5
- package/dist/http.cjs.map +1 -1
- package/dist/http.d.cts +4 -5
- package/dist/http.d.cts.map +1 -1
- package/dist/http.d.ts +4 -5
- package/dist/http.d.ts.map +1 -1
- package/dist/http.js +5 -5
- package/dist/http.js.map +1 -1
- package/dist/{index-eKuioqT1.d.cts → index-BPcxVucm.d.cts} +2 -3
- package/dist/index-BPcxVucm.d.cts.map +1 -0
- package/dist/{index-Ck06vlW2.d.ts → index-DolOVX6F.d.ts} +2 -3
- package/dist/index-DolOVX6F.d.ts.map +1 -0
- package/dist/index.cjs +7 -8
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +14 -14
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.ts +14 -14
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -8
- package/dist/index.js.map +1 -1
- package/dist/{init-BxJEJ9Tn.cjs → init-B2uvZReD.cjs} +19 -10
- package/dist/init-B2uvZReD.cjs.map +1 -0
- package/dist/{init-B7u-DjxM.d.ts → init-CTyqG9qR.d.ts} +24 -17
- package/dist/init-CTyqG9qR.d.ts.map +1 -0
- package/dist/{init-BvBB45-T.js → init-CdEWjhvl.js} +20 -11
- package/dist/init-CdEWjhvl.js.map +1 -0
- package/dist/{init-DSrRmVnz.d.cts → init-a4yPDYqC.d.cts} +24 -17
- package/dist/init-a4yPDYqC.d.cts.map +1 -0
- package/dist/instrumentation.cjs +7 -13
- package/dist/instrumentation.cjs.map +1 -1
- package/dist/instrumentation.d.cts +0 -1
- package/dist/instrumentation.d.cts.map +1 -1
- package/dist/instrumentation.d.ts +0 -1
- package/dist/instrumentation.d.ts.map +1 -1
- package/dist/instrumentation.js +8 -14
- package/dist/instrumentation.js.map +1 -1
- package/dist/{logger-BauSUhUv.d.ts → logger-CN4xpzMd.d.cts} +1 -2
- package/dist/logger-CN4xpzMd.d.cts.map +1 -0
- package/dist/{logger-BauSUhUv.d.cts → logger-CN4xpzMd.d.ts} +1 -2
- package/dist/logger-CN4xpzMd.d.ts.map +1 -0
- package/dist/logger-D3Ej3DII.js.map +1 -1
- package/dist/logger-thMPLpOG.cjs.map +1 -1
- package/dist/logger.d.cts +1 -1
- package/dist/logger.d.ts +1 -1
- package/dist/messaging-adapters.cjs.map +1 -1
- package/dist/messaging-adapters.d.cts +0 -1
- package/dist/messaging-adapters.d.cts.map +1 -1
- package/dist/messaging-adapters.d.ts +0 -1
- package/dist/messaging-adapters.d.ts.map +1 -1
- package/dist/messaging-adapters.js.map +1 -1
- package/dist/messaging-testing.d.cts +0 -1
- package/dist/messaging-testing.d.cts.map +1 -1
- package/dist/messaging-testing.d.ts +0 -1
- package/dist/messaging-testing.d.ts.map +1 -1
- package/dist/messaging.cjs +27 -10
- package/dist/messaging.cjs.map +1 -1
- package/dist/messaging.d.cts +6 -7
- package/dist/messaging.d.cts.map +1 -1
- package/dist/messaging.d.ts +6 -7
- package/dist/messaging.d.ts.map +1 -1
- package/dist/messaging.js +27 -10
- package/dist/messaging.js.map +1 -1
- package/dist/metric-helpers.d.cts +0 -1
- package/dist/metric-helpers.d.cts.map +1 -1
- package/dist/metric-helpers.d.ts +0 -1
- package/dist/metric-helpers.d.ts.map +1 -1
- package/dist/{metric-testing-DXdK3-Q3.d.ts → metric-testing-CWm6UhaR.d.ts} +2 -3
- package/dist/metric-testing-CWm6UhaR.d.ts.map +1 -0
- package/dist/{metric-testing-MxvzChDp.d.cts → metric-testing-CpvP3ZIa.d.cts} +2 -3
- package/dist/metric-testing-CpvP3ZIa.d.cts.map +1 -0
- package/dist/metric-testing.d.cts +1 -1
- package/dist/metric-testing.d.ts +1 -1
- package/dist/metric.d.cts +3 -4
- package/dist/metric.d.cts.map +1 -1
- package/dist/metric.d.ts +3 -4
- package/dist/metric.d.ts.map +1 -1
- package/dist/parse-error.d.cts.map +1 -1
- package/dist/parse-error.d.ts.map +1 -1
- package/dist/processors.cjs +1 -1
- package/dist/processors.d.cts +1 -1
- package/dist/processors.d.ts +1 -1
- package/dist/processors.js +1 -1
- package/dist/register.d.cts +1 -1
- package/dist/register.d.ts +1 -1
- package/dist/{sampling-DfYhDJij.d.cts → sampling-BR9fkSwx.d.cts} +127 -10
- package/dist/sampling-BR9fkSwx.d.cts.map +1 -0
- package/dist/{sampling-CR0Va1VB.d.ts → sampling-CP3e7-Yr.d.ts} +127 -10
- package/dist/sampling-CP3e7-Yr.d.ts.map +1 -0
- package/dist/sampling.cjs +160 -12
- package/dist/sampling.cjs.map +1 -1
- package/dist/sampling.d.cts +2 -2
- package/dist/sampling.d.ts +2 -2
- package/dist/sampling.js +157 -13
- package/dist/sampling.js.map +1 -1
- package/dist/security-schema.d.cts +9 -4
- package/dist/security-schema.d.cts.map +1 -1
- package/dist/security-schema.d.ts +9 -4
- package/dist/security-schema.d.ts.map +1 -1
- package/dist/semantic-conventions-FhSxv-bK.d.cts.map +1 -1
- package/dist/semantic-conventions-FhSxv-bK.d.ts.map +1 -1
- package/dist/semantic-conventions.cjs.map +1 -1
- package/dist/semantic-conventions.js.map +1 -1
- package/dist/semantic-helpers.cjs +85 -304
- package/dist/semantic-helpers.cjs.map +1 -1
- package/dist/semantic-helpers.d.cts +21 -12
- package/dist/semantic-helpers.d.cts.map +1 -1
- package/dist/semantic-helpers.d.ts +21 -12
- package/dist/semantic-helpers.d.ts.map +1 -1
- package/dist/semantic-helpers.js +85 -304
- package/dist/semantic-helpers.js.map +1 -1
- package/dist/slo.cjs +225 -0
- package/dist/slo.cjs.map +1 -0
- package/dist/slo.d.cts +97 -0
- package/dist/slo.d.cts.map +1 -0
- package/dist/slo.d.ts +97 -0
- package/dist/slo.d.ts.map +1 -0
- package/dist/slo.js +223 -0
- package/dist/slo.js.map +1 -0
- package/dist/{span-name-normalizer-8ZOGJuwv.d.ts → span-name-normalizer-CN1-8C76.d.cts} +1 -2
- package/dist/span-name-normalizer-CN1-8C76.d.cts.map +1 -0
- package/dist/{span-name-normalizer-8ZOGJuwv.d.cts → span-name-normalizer-CN1-8C76.d.ts} +1 -2
- package/dist/span-name-normalizer-CN1-8C76.d.ts.map +1 -0
- package/dist/span-name-normalizer.cjs.map +1 -1
- package/dist/span-name-normalizer.d.cts +1 -1
- package/dist/span-name-normalizer.d.ts +1 -1
- package/dist/span-name-normalizer.js.map +1 -1
- package/dist/tail-sampling-processor.d.cts +0 -1
- package/dist/tail-sampling-processor.d.cts.map +1 -1
- package/dist/tail-sampling-processor.d.ts +0 -1
- package/dist/tail-sampling-processor.d.ts.map +1 -1
- package/dist/test-span-collector.cjs.map +1 -1
- package/dist/test-span-collector.d.cts +0 -1
- package/dist/test-span-collector.d.cts.map +1 -1
- package/dist/test-span-collector.d.ts +0 -1
- package/dist/test-span-collector.d.ts.map +1 -1
- package/dist/test-span-collector.js.map +1 -1
- package/dist/testing.cjs +76 -11
- package/dist/testing.cjs.map +1 -1
- package/dist/testing.d.cts +30 -5
- package/dist/testing.d.cts.map +1 -1
- package/dist/testing.d.ts +30 -5
- package/dist/testing.d.ts.map +1 -1
- package/dist/testing.js +73 -12
- package/dist/testing.js.map +1 -1
- package/dist/{trace-context-Cijqoi6e.d.ts → trace-context-IuyoPyNq.d.cts} +9 -9
- package/dist/trace-context-IuyoPyNq.d.cts.map +1 -0
- package/dist/{trace-context-Cijqoi6e.d.cts → trace-context-IuyoPyNq.d.ts} +9 -9
- package/dist/trace-context-IuyoPyNq.d.ts.map +1 -0
- package/dist/trace-factory-validation-BjVAinz6.js +13 -0
- package/dist/trace-factory-validation-BjVAinz6.js.map +1 -0
- package/dist/trace-factory-validation-Dc8epn87.cjs +19 -0
- package/dist/trace-factory-validation-Dc8epn87.cjs.map +1 -0
- package/dist/trace-helpers.cjs +7 -7
- package/dist/trace-helpers.cjs.map +1 -1
- package/dist/trace-helpers.d.cts +6 -7
- package/dist/trace-helpers.d.cts.map +1 -1
- package/dist/trace-helpers.d.ts +6 -7
- package/dist/trace-helpers.d.ts.map +1 -1
- package/dist/trace-helpers.js +7 -7
- package/dist/trace-helpers.js.map +1 -1
- package/dist/tracer-provider.d.cts +0 -1
- package/dist/tracer-provider.d.cts.map +1 -1
- package/dist/tracer-provider.d.ts +0 -1
- package/dist/tracer-provider.d.ts.map +1 -1
- package/dist/{track-D7O7oIZa.js → track-BBcxEJEC.js} +7 -12
- package/dist/track-BBcxEJEC.js.map +1 -0
- package/dist/{track-eovhCJ-I.cjs → track-BI6dmZ2X.cjs} +6 -17
- package/dist/track-BI6dmZ2X.cjs.map +1 -0
- package/dist/validate.cjs.map +1 -1
- package/dist/validate.d.cts +1 -2
- package/dist/validate.d.cts.map +1 -1
- package/dist/validate.d.ts +1 -2
- package/dist/validate.d.ts.map +1 -1
- package/dist/validate.js.map +1 -1
- package/dist/validation-attributes.d.cts +17 -8
- package/dist/validation-attributes.d.cts.map +1 -1
- package/dist/validation-attributes.d.ts +17 -8
- package/dist/validation-attributes.d.ts.map +1 -1
- package/dist/webhook.cjs +5 -4
- package/dist/webhook.cjs.map +1 -1
- package/dist/webhook.d.cts +4 -4
- package/dist/webhook.d.cts.map +1 -1
- package/dist/webhook.d.ts +4 -4
- package/dist/webhook.d.ts.map +1 -1
- package/dist/webhook.js +5 -4
- package/dist/webhook.js.map +1 -1
- package/dist/workflow-distributed.cjs +5 -5
- package/dist/workflow-distributed.cjs.map +1 -1
- package/dist/workflow-distributed.d.cts +25 -15
- package/dist/workflow-distributed.d.cts.map +1 -1
- package/dist/workflow-distributed.d.ts +25 -15
- package/dist/workflow-distributed.d.ts.map +1 -1
- package/dist/workflow-distributed.js +5 -5
- package/dist/workflow-distributed.js.map +1 -1
- package/dist/workflow.cjs +24 -30
- package/dist/workflow.cjs.map +1 -1
- package/dist/workflow.d.cts +11 -6
- package/dist/workflow.d.cts.map +1 -1
- package/dist/workflow.d.ts +11 -6
- package/dist/workflow.d.ts.map +1 -1
- package/dist/workflow.js +24 -30
- package/dist/workflow.js.map +1 -1
- package/dist/yaml-config.d.cts +2 -3
- package/dist/yaml-config.d.cts.map +1 -1
- package/dist/yaml-config.d.ts +2 -3
- package/dist/yaml-config.d.ts.map +1 -1
- package/package.json +23 -14
- package/skills/analyze-traces/SKILL.md +42 -13
- package/skills/autotel-core/SKILL.md +24 -17
- package/skills/autotel-events/SKILL.md +1 -1
- package/skills/autotel-frameworks/SKILL.md +41 -6
- package/skills/autotel-instrumentation/SKILL.md +14 -9
- package/skills/autotel-request-logging/SKILL.md +19 -14
- package/skills/autotel-structured-errors/SKILL.md +2 -2
- package/skills/build-audit-trails/SKILL.md +11 -11
- package/skills/build-audit-trails/references/audit-queries.md +3 -3
- package/skills/debug-missing-spans/SKILL.md +12 -12
- package/skills/migrate-to-autotel/SKILL.md +20 -20
- package/skills/review-otel-patterns/SKILL.md +44 -42
- package/skills/review-otel-patterns/references/code-review.md +4 -4
- package/skills/review-otel-patterns/references/processor-pipeline.md +3 -3
- package/skills/review-otel-patterns/references/structured-errors.md +1 -1
- package/skills/review-otel-patterns/references/wide-spans.md +2 -2
- package/skills/tune-sampling/SKILL.md +91 -16
- package/dist/attribute-redacting-processor-DtTS9xxh.d.cts.map +0 -1
- package/dist/attribute-redacting-processor-DtTS9xxh.d.ts.map +0 -1
- package/dist/canonical-log-line-processor-BcRuAdRk.d.ts.map +0 -1
- package/dist/canonical-log-line-processor-CcrDi6TO.cjs.map +0 -1
- package/dist/canonical-log-line-processor-FLezvFCB.js.map +0 -1
- package/dist/canonical-log-line-processor-xvjMgtpF.d.cts.map +0 -1
- package/dist/define-event-CreknLm3.d.ts.map +0 -1
- package/dist/define-event-HZRizPwz.d.cts.map +0 -1
- package/dist/event-BEm5IJ8U.js.map +0 -1
- package/dist/event-rzA1X5h3.cjs.map +0 -1
- package/dist/event-subscriber-D1XLkPzi.d.cts.map +0 -1
- package/dist/event-subscriber-D1XLkPzi.d.ts.map +0 -1
- package/dist/event-testing-BqRnI0z4.d.cts.map +0 -1
- package/dist/event-testing-CfFs3to2.d.ts.map +0 -1
- package/dist/filtering-span-processor-B8R8B7Uk.d.cts.map +0 -1
- package/dist/filtering-span-processor-B8R8B7Uk.d.ts.map +0 -1
- package/dist/functional-CwsPyc4l.cjs +0 -1298
- package/dist/functional-CwsPyc4l.cjs.map +0 -1
- package/dist/functional-dAYhXQPA.js +0 -1248
- package/dist/functional-dAYhXQPA.js.map +0 -1
- package/dist/index-Ck06vlW2.d.ts.map +0 -1
- package/dist/index-eKuioqT1.d.cts.map +0 -1
- package/dist/init-B7u-DjxM.d.ts.map +0 -1
- package/dist/init-BvBB45-T.js.map +0 -1
- package/dist/init-BxJEJ9Tn.cjs.map +0 -1
- package/dist/init-DSrRmVnz.d.cts.map +0 -1
- package/dist/logger-BauSUhUv.d.cts.map +0 -1
- package/dist/logger-BauSUhUv.d.ts.map +0 -1
- package/dist/metric-testing-DXdK3-Q3.d.ts.map +0 -1
- package/dist/metric-testing-MxvzChDp.d.cts.map +0 -1
- package/dist/sampling-CR0Va1VB.d.ts.map +0 -1
- package/dist/sampling-DfYhDJij.d.cts.map +0 -1
- package/dist/span-name-normalizer-8ZOGJuwv.d.cts.map +0 -1
- package/dist/span-name-normalizer-8ZOGJuwv.d.ts.map +0 -1
- package/dist/trace-context-Cijqoi6e.d.cts.map +0 -1
- package/dist/trace-context-Cijqoi6e.d.ts.map +0 -1
- package/dist/track-D7O7oIZa.js.map +0 -1
- package/dist/track-eovhCJ-I.cjs.map +0 -1
package/dist/workflow.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflow.cjs","names":["nodeAsyncHooks","trace","getActiveSpan"],"sources":["../src/workflow.ts"],"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\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeAsyncHooks 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 =\n new nodeAsyncHooks.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"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"workflow.cjs","names":["nodeAsyncHooks","withTracing","getActiveSpan"],"sources":["../src/workflow.ts"],"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\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeAsyncHooks from 'node:async_hooks';\nimport type { Attributes, Link, SpanContext } from '@opentelemetry/api';\nimport { emitCorrelatedEvent } from './correlated-events';\nimport { withTracing } from './functional';\nimport { assertTraceFactory } from './trace-factory-validation';\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' | 'running' | 'completed' | 'failed' | 'skipped' | '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 /**\n * Compensation handler for saga rollback.\n *\n * The two-arg `(ctx, error)` form is detected via `Function.length`, so it\n * must not use default or rest parameters (they reduce the reported arity).\n */\n compensate?:\n | ((error: Error) => Promise<void> | void)\n | ((ctx: StepContext, 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?: StepConfig['compensate'];\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 =\n new nodeAsyncHooks.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<TConfigArgs extends unknown[] = unknown[]>(\n config: WorkflowConfig<TConfigArgs>,\n) {\n if (!config || typeof config !== 'object') {\n throw new TypeError('traceWorkflow: config must be an object');\n }\n if (typeof config.name !== 'string' || config.name.trim() === '') {\n throw new TypeError(\n 'traceWorkflow: config.name must be a non-empty string',\n );\n }\n if (\n typeof config.workflowId !== 'string' &&\n typeof config.workflowId !== 'function'\n ) {\n throw new TypeError(\n 'traceWorkflow: config.workflowId must be a string or function',\n );\n }\n const spanName = `workflow.${config.name}`;\n\n return <TArgs extends TConfigArgs, TReturn>(\n fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n assertTraceFactory('traceWorkflow', fnFactory);\n return withTracing<TArgs, TReturn>({ name: 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 assertTraceFactory('traceWorkflow', userFn, 'result');\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 }) as (...args: TArgs) => Promise<TReturn>;\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 */\ntype StepHandler<TArgs extends unknown[], TReturn> = (\n ...args: TArgs\n) => TReturn | Promise<TReturn>;\n\nexport function traceStep(\n config: StepConfig,\n): <TArgs extends unknown[], TReturn>(\n handler: StepHandler<TArgs, TReturn>,\n) => StepHandler<TArgs, TReturn> {\n if (!config || typeof config !== 'object') {\n throw new TypeError('traceStep: config must be an object');\n }\n if (typeof config.name !== 'string' || config.name.trim() === '') {\n throw new TypeError('traceStep: config.name must be a non-empty string');\n }\n\n return (<TArgs extends unknown[], TReturn>(\n handler: StepHandler<TArgs, TReturn>,\n ): StepHandler<TArgs, TReturn> => {\n if (typeof handler !== 'function') {\n throw new TypeError(\n 'traceStep(config)(handler): handler must be a function',\n );\n }\n const spanName = `step.${config.name}`;\n\n return withTracing<TArgs, TReturn>({ name: 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 const compensate = config.compensate;\n workflowCtx.registerCompensation(config.name, (error) => {\n if (compensate.length >= 2) {\n return (\n compensate as (\n stepCtx: StepContext,\n cause: Error,\n ) => Promise<void> | void\n )(ctx, error);\n }\n return (compensate as (cause: Error) => Promise<void> | void)(\n error,\n );\n });\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 // The step is a plain handler; it receives its real arguments.\n // Reach the step span via getActiveTraceContext() inside the body.\n const result = await handler(...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 }) as <TFunctionArgs extends unknown[], TFunctionReturn>(\n handler: StepHandler<TFunctionArgs, TFunctionReturn>,\n ) => StepHandler<TFunctionArgs, TFunctionReturn>;\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"],"mappings":"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"}
|
package/dist/workflow.d.cts
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { n as TraceContext } from "./trace-context-
|
|
1
|
+
import { n as TraceContext } from "./trace-context-IuyoPyNq.cjs";
|
|
2
2
|
import { Attributes, SpanContext } from "@opentelemetry/api";
|
|
3
|
-
|
|
4
3
|
//#region src/workflow.d.ts
|
|
5
4
|
/**
|
|
6
5
|
* Workflow status
|
|
@@ -48,8 +47,13 @@ interface StepConfig {
|
|
|
48
47
|
linkTo?: string | string[];
|
|
49
48
|
/** Additional attributes */
|
|
50
49
|
attributes?: Attributes;
|
|
51
|
-
/**
|
|
52
|
-
|
|
50
|
+
/**
|
|
51
|
+
* Compensation handler for saga rollback.
|
|
52
|
+
*
|
|
53
|
+
* The two-arg `(ctx, error)` form is detected via `Function.length`, so it
|
|
54
|
+
* must not use default or rest parameters (they reduce the reported arity).
|
|
55
|
+
*/
|
|
56
|
+
compensate?: ((error: Error) => Promise<void> | void) | ((ctx: StepContext, error: Error) => Promise<void> | void);
|
|
53
57
|
/** Whether this step is idempotent */
|
|
54
58
|
idempotent?: boolean;
|
|
55
59
|
/** Retry configuration */
|
|
@@ -129,7 +133,7 @@ interface StepContext extends TraceContext {
|
|
|
129
133
|
* });
|
|
130
134
|
* ```
|
|
131
135
|
*/
|
|
132
|
-
declare function traceWorkflow<
|
|
136
|
+
declare function traceWorkflow<TConfigArgs extends unknown[] = unknown[]>(config: WorkflowConfig<TConfigArgs>): <TArgs extends TConfigArgs, TReturn>(fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
|
|
133
137
|
/**
|
|
134
138
|
* Create a traced workflow step
|
|
135
139
|
*
|
|
@@ -152,7 +156,8 @@ declare function traceWorkflow<TArgs extends unknown[], TReturn>(config: Workflo
|
|
|
152
156
|
* });
|
|
153
157
|
* ```
|
|
154
158
|
*/
|
|
155
|
-
|
|
159
|
+
type StepHandler<TArgs extends unknown[], TReturn> = (...args: TArgs) => TReturn | Promise<TReturn>;
|
|
160
|
+
declare function traceStep(config: StepConfig): <TArgs extends unknown[], TReturn>(handler: StepHandler<TArgs, TReturn>) => StepHandler<TArgs, TReturn>;
|
|
156
161
|
/**
|
|
157
162
|
* Get current workflow context (if inside a workflow)
|
|
158
163
|
*
|
package/dist/workflow.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflow.d.cts","names":[],"sources":["../src/workflow.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"workflow.d.cts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;KAuEY;;;;KAYA;;;;UAMK,eAAe;;EAE9B;;;;;EAMA,0BAA0B,MAAM;;EAGhC;;EAGA,aAAa;;EAGb,cAAc,KAAK,iBAAiB;;EAGpC,YAAY,KAAK,iBAAiB,OAAO;;EAGzC,kBAAkB,KAAK;;;;;UAMR;;EAEf;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA,aAAa;;;;;;;EAQb,eACM,OAAO,UAAU,0BACjB,KAAK,aAAa,OAAO,UAAU;;EAGzC;;EAGA;IACE;IACA;;;EAIF,cAAc,KAAK;;EAGnB,YAAY,KAAK,aAAa,OAAO;;;;;UAmBtB,wBAAwB;;EAEvC;;EAGA;;EAGA,aAAa;;EAGb,aAAa;;EAGb,gBAAgB,oBAAoB;;EAGpC;;EAGA,qBACE,kBACA,UAAU,OAAO,UAAU;;EAI7B,WAAW,OAAO,QAAQ;;EAG1B,mBAAmB,kBAAkB,kBAAkB,QAAQ;;EAG/D,kBAAkB,QAAQ;;;;;UAMX,oBAAoB;;EAEnC;;EAGA;;EAGA;;EAGA,KAAK;;EAGL,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DR,cAAc,2CAC5B,QAAQ,eAAe,gBAoBf,cAAc,aAAa,SACjC,YAAY,KAAK,wBAAwB,MAAM,UAAU,QAAQ,kBAC3D,MAAM,UAAU,QAAQ;;;;;;;;;;;;;;;;;;;;;;;KAiG7B,YAAY,yBAAyB,eACrC,MAAM,UACN,UAAU,QAAQ;iBAEP,UACd,QAAQ,cACN,yBAAyB,SAC3B,SAAS,YAAY,OAAO,aACzB,YAAY,OAAO;;;;;;;iBAmbR,6BAA6B;;;;;;;iBAU7B"}
|
package/dist/workflow.d.ts
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { n as TraceContext } from "./trace-context-
|
|
1
|
+
import { n as TraceContext } from "./trace-context-IuyoPyNq.js";
|
|
2
2
|
import { Attributes, SpanContext } from "@opentelemetry/api";
|
|
3
|
-
|
|
4
3
|
//#region src/workflow.d.ts
|
|
5
4
|
/**
|
|
6
5
|
* Workflow status
|
|
@@ -48,8 +47,13 @@ interface StepConfig {
|
|
|
48
47
|
linkTo?: string | string[];
|
|
49
48
|
/** Additional attributes */
|
|
50
49
|
attributes?: Attributes;
|
|
51
|
-
/**
|
|
52
|
-
|
|
50
|
+
/**
|
|
51
|
+
* Compensation handler for saga rollback.
|
|
52
|
+
*
|
|
53
|
+
* The two-arg `(ctx, error)` form is detected via `Function.length`, so it
|
|
54
|
+
* must not use default or rest parameters (they reduce the reported arity).
|
|
55
|
+
*/
|
|
56
|
+
compensate?: ((error: Error) => Promise<void> | void) | ((ctx: StepContext, error: Error) => Promise<void> | void);
|
|
53
57
|
/** Whether this step is idempotent */
|
|
54
58
|
idempotent?: boolean;
|
|
55
59
|
/** Retry configuration */
|
|
@@ -129,7 +133,7 @@ interface StepContext extends TraceContext {
|
|
|
129
133
|
* });
|
|
130
134
|
* ```
|
|
131
135
|
*/
|
|
132
|
-
declare function traceWorkflow<
|
|
136
|
+
declare function traceWorkflow<TConfigArgs extends unknown[] = unknown[]>(config: WorkflowConfig<TConfigArgs>): <TArgs extends TConfigArgs, TReturn>(fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>) => ((...args: TArgs) => Promise<TReturn>);
|
|
133
137
|
/**
|
|
134
138
|
* Create a traced workflow step
|
|
135
139
|
*
|
|
@@ -152,7 +156,8 @@ declare function traceWorkflow<TArgs extends unknown[], TReturn>(config: Workflo
|
|
|
152
156
|
* });
|
|
153
157
|
* ```
|
|
154
158
|
*/
|
|
155
|
-
|
|
159
|
+
type StepHandler<TArgs extends unknown[], TReturn> = (...args: TArgs) => TReturn | Promise<TReturn>;
|
|
160
|
+
declare function traceStep(config: StepConfig): <TArgs extends unknown[], TReturn>(handler: StepHandler<TArgs, TReturn>) => StepHandler<TArgs, TReturn>;
|
|
156
161
|
/**
|
|
157
162
|
* Get current workflow context (if inside a workflow)
|
|
158
163
|
*
|
package/dist/workflow.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflow.d.ts","names":[],"sources":["../src/workflow.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"workflow.d.ts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;KAuEY;;;;KAYA;;;;UAMK,eAAe;;EAE9B;;;;;EAMA,0BAA0B,MAAM;;EAGhC;;EAGA,aAAa;;EAGb,cAAc,KAAK,iBAAiB;;EAGpC,YAAY,KAAK,iBAAiB,OAAO;;EAGzC,kBAAkB,KAAK;;;;;UAMR;;EAEf;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA,aAAa;;;;;;;EAQb,eACM,OAAO,UAAU,0BACjB,KAAK,aAAa,OAAO,UAAU;;EAGzC;;EAGA;IACE;IACA;;;EAIF,cAAc,KAAK;;EAGnB,YAAY,KAAK,aAAa,OAAO;;;;;UAmBtB,wBAAwB;;EAEvC;;EAGA;;EAGA,aAAa;;EAGb,aAAa;;EAGb,gBAAgB,oBAAoB;;EAGpC;;EAGA,qBACE,kBACA,UAAU,OAAO,UAAU;;EAI7B,WAAW,OAAO,QAAQ;;EAG1B,mBAAmB,kBAAkB,kBAAkB,QAAQ;;EAG/D,kBAAkB,QAAQ;;;;;UAMX,oBAAoB;;EAEnC;;EAGA;;EAGA;;EAGA,KAAK;;EAGL,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DR,cAAc,2CAC5B,QAAQ,eAAe,gBAoBf,cAAc,aAAa,SACjC,YAAY,KAAK,wBAAwB,MAAM,UAAU,QAAQ,kBAC3D,MAAM,UAAU,QAAQ;;;;;;;;;;;;;;;;;;;;;;;KAiG7B,YAAY,yBAAyB,eACrC,MAAM,UACN,UAAU,QAAQ;iBAEP,UACd,QAAQ,cACN,yBAAyB,SAC3B,SAAS,YAAY,OAAO,aACzB,YAAY,OAAO;;;;;;;iBAmbR,6BAA6B;;;;;;;iBAU7B"}
|
package/dist/workflow.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { getActiveSpan } from "./trace-helpers.js";
|
|
2
|
-
import {
|
|
2
|
+
import { c as withTracing } from "./functional-Bit6noRu.js";
|
|
3
3
|
import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
|
|
4
|
+
import { t as assertTraceFactory } from "./trace-factory-validation-BjVAinz6.js";
|
|
4
5
|
import * as nodeAsyncHooks from "node:async_hooks";
|
|
5
6
|
|
|
6
7
|
//#region src/workflow.ts
|
|
@@ -95,9 +96,13 @@ const workflowContextStorage = new nodeAsyncHooks.AsyncLocalStorage();
|
|
|
95
96
|
* ```
|
|
96
97
|
*/
|
|
97
98
|
function traceWorkflow(config) {
|
|
99
|
+
if (!config || typeof config !== "object") throw new TypeError("traceWorkflow: config must be an object");
|
|
100
|
+
if (typeof config.name !== "string" || config.name.trim() === "") throw new TypeError("traceWorkflow: config.name must be a non-empty string");
|
|
101
|
+
if (typeof config.workflowId !== "string" && typeof config.workflowId !== "function") throw new TypeError("traceWorkflow: config.workflowId must be a string or function");
|
|
98
102
|
const spanName = `workflow.${config.name}`;
|
|
99
103
|
return (fnFactory) => {
|
|
100
|
-
|
|
104
|
+
assertTraceFactory("traceWorkflow", fnFactory);
|
|
105
|
+
return withTracing({ name: spanName })((baseCtx) => {
|
|
101
106
|
return async (...args) => {
|
|
102
107
|
const workflowId = typeof config.workflowId === "function" ? config.workflowId(...args) : config.workflowId;
|
|
103
108
|
const ctx = createWorkflowContext(baseCtx, config.name, workflowId);
|
|
@@ -110,7 +115,9 @@ function traceWorkflow(config) {
|
|
|
110
115
|
}
|
|
111
116
|
return workflowContextStorage.run(ctx, async () => {
|
|
112
117
|
try {
|
|
113
|
-
const
|
|
118
|
+
const userFn = fnFactory(ctx);
|
|
119
|
+
assertTraceFactory("traceWorkflow", userFn, "result");
|
|
120
|
+
const result = await userFn(...args);
|
|
114
121
|
ctx.setWorkflowStatus("completed");
|
|
115
122
|
config.onComplete?.(ctx, result);
|
|
116
123
|
return result;
|
|
@@ -136,31 +143,12 @@ function traceWorkflow(config) {
|
|
|
136
143
|
});
|
|
137
144
|
};
|
|
138
145
|
}
|
|
139
|
-
/**
|
|
140
|
-
* Create a traced workflow step
|
|
141
|
-
*
|
|
142
|
-
* Wraps step logic with automatic linking to previous steps,
|
|
143
|
-
* compensation registration, and status tracking.
|
|
144
|
-
*
|
|
145
|
-
* @param config - Step configuration
|
|
146
|
-
* @returns Factory function that wraps your step logic
|
|
147
|
-
*
|
|
148
|
-
* @example Step with compensation
|
|
149
|
-
* ```typescript
|
|
150
|
-
* const chargePayment = traceStep({
|
|
151
|
-
* name: 'ChargePayment',
|
|
152
|
-
* linkToPrevious: true,
|
|
153
|
-
* compensate: async (error) => {
|
|
154
|
-
* await paymentService.refund(paymentId);
|
|
155
|
-
* },
|
|
156
|
-
* })(async (amount: number) => {
|
|
157
|
-
* return await paymentService.charge(amount);
|
|
158
|
-
* });
|
|
159
|
-
* ```
|
|
160
|
-
*/
|
|
161
146
|
function traceStep(config) {
|
|
162
|
-
|
|
163
|
-
|
|
147
|
+
if (!config || typeof config !== "object") throw new TypeError("traceStep: config must be an object");
|
|
148
|
+
if (typeof config.name !== "string" || config.name.trim() === "") throw new TypeError("traceStep: config.name must be a non-empty string");
|
|
149
|
+
return ((handler) => {
|
|
150
|
+
if (typeof handler !== "function") throw new TypeError("traceStep(config)(handler): handler must be a function");
|
|
151
|
+
return withTracing({ name: `step.${config.name}` })((baseCtx) => {
|
|
164
152
|
return async (...args) => {
|
|
165
153
|
const workflowCtx = workflowContextStorage.getStore() ?? null;
|
|
166
154
|
const ctx = createStepContext(baseCtx, config, workflowCtx);
|
|
@@ -173,7 +161,13 @@ function traceStep(config) {
|
|
|
173
161
|
for (const [key, value] of Object.entries(config.attributes)) if (value !== void 0) ctx.setAttribute(key, value);
|
|
174
162
|
}
|
|
175
163
|
await addStepLinks(ctx, config, workflowCtx);
|
|
176
|
-
if (config.compensate && workflowCtx)
|
|
164
|
+
if (config.compensate && workflowCtx) {
|
|
165
|
+
const compensate = config.compensate;
|
|
166
|
+
workflowCtx.registerCompensation(config.name, (error) => {
|
|
167
|
+
if (compensate.length >= 2) return compensate(ctx, error);
|
|
168
|
+
return compensate(error);
|
|
169
|
+
});
|
|
170
|
+
}
|
|
177
171
|
let lastError;
|
|
178
172
|
const maxAttempts = config.retry?.maxAttempts ?? 1;
|
|
179
173
|
for (let attempt = 1; attempt <= maxAttempts; attempt++) try {
|
|
@@ -185,7 +179,7 @@ function traceStep(config) {
|
|
|
185
179
|
});
|
|
186
180
|
if (config.retry?.backoffMs) await sleep(config.retry.backoffMs * attempt);
|
|
187
181
|
}
|
|
188
|
-
const result = await
|
|
182
|
+
const result = await handler(...args);
|
|
189
183
|
ctx.setAttribute("workflow.step.status", "completed");
|
|
190
184
|
ctx.complete();
|
|
191
185
|
config.onComplete?.(ctx);
|
|
@@ -203,7 +197,7 @@ function traceStep(config) {
|
|
|
203
197
|
throw lastError;
|
|
204
198
|
};
|
|
205
199
|
});
|
|
206
|
-
};
|
|
200
|
+
});
|
|
207
201
|
}
|
|
208
202
|
/**
|
|
209
203
|
* Create workflow-extended context
|
package/dist/workflow.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflow.js","names":[],"sources":["../src/workflow.ts"],"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\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeAsyncHooks 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 =\n new nodeAsyncHooks.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"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"workflow.js","names":[],"sources":["../src/workflow.ts"],"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\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeAsyncHooks from 'node:async_hooks';\nimport type { Attributes, Link, SpanContext } from '@opentelemetry/api';\nimport { emitCorrelatedEvent } from './correlated-events';\nimport { withTracing } from './functional';\nimport { assertTraceFactory } from './trace-factory-validation';\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' | 'running' | 'completed' | 'failed' | 'skipped' | '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 /**\n * Compensation handler for saga rollback.\n *\n * The two-arg `(ctx, error)` form is detected via `Function.length`, so it\n * must not use default or rest parameters (they reduce the reported arity).\n */\n compensate?:\n | ((error: Error) => Promise<void> | void)\n | ((ctx: StepContext, 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?: StepConfig['compensate'];\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 =\n new nodeAsyncHooks.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<TConfigArgs extends unknown[] = unknown[]>(\n config: WorkflowConfig<TConfigArgs>,\n) {\n if (!config || typeof config !== 'object') {\n throw new TypeError('traceWorkflow: config must be an object');\n }\n if (typeof config.name !== 'string' || config.name.trim() === '') {\n throw new TypeError(\n 'traceWorkflow: config.name must be a non-empty string',\n );\n }\n if (\n typeof config.workflowId !== 'string' &&\n typeof config.workflowId !== 'function'\n ) {\n throw new TypeError(\n 'traceWorkflow: config.workflowId must be a string or function',\n );\n }\n const spanName = `workflow.${config.name}`;\n\n return <TArgs extends TConfigArgs, TReturn>(\n fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n assertTraceFactory('traceWorkflow', fnFactory);\n return withTracing<TArgs, TReturn>({ name: 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 assertTraceFactory('traceWorkflow', userFn, 'result');\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 }) as (...args: TArgs) => Promise<TReturn>;\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 */\ntype StepHandler<TArgs extends unknown[], TReturn> = (\n ...args: TArgs\n) => TReturn | Promise<TReturn>;\n\nexport function traceStep(\n config: StepConfig,\n): <TArgs extends unknown[], TReturn>(\n handler: StepHandler<TArgs, TReturn>,\n) => StepHandler<TArgs, TReturn> {\n if (!config || typeof config !== 'object') {\n throw new TypeError('traceStep: config must be an object');\n }\n if (typeof config.name !== 'string' || config.name.trim() === '') {\n throw new TypeError('traceStep: config.name must be a non-empty string');\n }\n\n return (<TArgs extends unknown[], TReturn>(\n handler: StepHandler<TArgs, TReturn>,\n ): StepHandler<TArgs, TReturn> => {\n if (typeof handler !== 'function') {\n throw new TypeError(\n 'traceStep(config)(handler): handler must be a function',\n );\n }\n const spanName = `step.${config.name}`;\n\n return withTracing<TArgs, TReturn>({ name: 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 const compensate = config.compensate;\n workflowCtx.registerCompensation(config.name, (error) => {\n if (compensate.length >= 2) {\n return (\n compensate as (\n stepCtx: StepContext,\n cause: Error,\n ) => Promise<void> | void\n )(ctx, error);\n }\n return (compensate as (cause: Error) => Promise<void> | void)(\n error,\n );\n });\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 // The step is a plain handler; it receives its real arguments.\n // Reach the step span via getActiveTraceContext() inside the body.\n const result = await handler(...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 }) as <TFunctionArgs extends unknown[], TFunctionReturn>(\n handler: StepHandler<TFunctionArgs, TFunctionReturn>,\n ) => StepHandler<TFunctionArgs, TFunctionReturn>;\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"],"mappings":"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"}
|
package/dist/yaml-config.d.cts
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { n as OtlpSignal, t as AutotelConfig } from "./init-
|
|
3
|
-
|
|
1
|
+
import { h as SamplingPreset } from "./sampling-BR9fkSwx.cjs";
|
|
2
|
+
import { n as OtlpSignal, t as AutotelConfig } from "./init-a4yPDYqC.cjs";
|
|
4
3
|
//#region src/yaml-config.d.ts
|
|
5
4
|
/**
|
|
6
5
|
* YAML config structure
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"yaml-config.d.cts","names":[],"sources":["../src/yaml-config.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"yaml-config.d.cts","names":[],"sources":["../src/yaml-config.ts"],"mappings":";;;;;;;UAsDiB;EACf;IACE;IACA;IACA;;EAEF;IACE;IACA;IACA,UAAU;IACV,eAAe;MACb;MACA;MACA,UAAU;MACV,UAAU;;;EAGd,WAAW;EACX;IACE,SAAS;IACT;IACA;IACA;IACA;IACA;IACA;;EAEF,kCAAkC;IAAiB;;EACnD;;;;;;;;;;;;;;;;iBAwNc,kBAAkB,QAAQ;;;;;;;;;;;;;;;;;iBAmC1B,uBACd,mBACC,QAAQ;;;;;;iBAcK"}
|
package/dist/yaml-config.d.ts
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { n as OtlpSignal, t as AutotelConfig } from "./init-
|
|
3
|
-
|
|
1
|
+
import { h as SamplingPreset } from "./sampling-CP3e7-Yr.js";
|
|
2
|
+
import { n as OtlpSignal, t as AutotelConfig } from "./init-CTyqG9qR.js";
|
|
4
3
|
//#region src/yaml-config.d.ts
|
|
5
4
|
/**
|
|
6
5
|
* YAML config structure
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"yaml-config.d.ts","names":[],"sources":["../src/yaml-config.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"yaml-config.d.ts","names":[],"sources":["../src/yaml-config.ts"],"mappings":";;;;;;;UAsDiB;EACf;IACE;IACA;IACA;;EAEF;IACE;IACA;IACA,UAAU;IACV,eAAe;MACb;MACA;MACA,UAAU;MACV,UAAU;;;EAGd,WAAW;EACX;IACE,SAAS;IACT;IACA;IACA;IACA;IACA;IACA;;EAEF,kCAAkC;IAAiB;;EACnD;;;;;;;;;;;;;;;;iBAwNc,kBAAkB,QAAQ;;;;;;;;;;;;;;;;;iBAmC1B,uBACd,mBACC,QAAQ;;;;;;iBAcK"}
|