@temporalio/interceptors-opentelemetry-v2 1.19.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2021-2025 Temporal Technologies Inc. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# `@temporalio/interceptors-opentelemetry-v2` (Experimental)
+
+[![NPM](https://img.shields.io/npm/v/@temporalio/interceptors-opentelemetry-v2?style=for-the-badge)](https://www.npmjs.com/package/@temporalio/interceptors-opentelemetry-v2)
+
+[Temporal](https://temporal.io)'s [TypeScript SDK](https://docs.temporal.io/typescript/introduction) interceptors for tracing Workflow and Activity executions with [OpenTelemetry](https://opentelemetry.io/) v2.
+
+This package targets OpenTelemetry JS SDK v2. For OpenTelemetry JS SDK v1, use [`@temporalio/interceptors-opentelemetry`](https://www.npmjs.com/package/@temporalio/interceptors-opentelemetry).
+
+**Warning** This package produces incompatible histories from `@temporalio/interceptors-opentelemetry`. Attempting to replay a workflow that was initially run with the original package can trigger a non-determinism error.
+
+- [Interceptors docs](https://docs.temporal.io/typescript/interceptors)
+- [OpenTelemetry Interceptor example setup](https://github.com/temporalio/samples-typescript/tree/main/interceptors-opentelemetry)

package/lib/client/index.d.ts

@@ -0,0 +1,26 @@
+import * as otel from '@opentelemetry/api';
+import type { Next, WorkflowSignalInput, WorkflowSignalWithStartInput, WorkflowStartInput, WorkflowStartOutput, WorkflowStartUpdateInput, WorkflowStartUpdateOutput, WorkflowStartUpdateWithStartInput, WorkflowStartUpdateWithStartOutput, WorkflowQueryInput, WorkflowTerminateInput, WorkflowCancelInput, WorkflowDescribeInput, WorkflowClientInterceptor, TerminateWorkflowExecutionResponse, RequestCancelWorkflowExecutionResponse, DescribeWorkflowExecutionResponse } from '@temporalio/client';
+export interface InterceptorOptions {
+    readonly tracer?: otel.Tracer;
+}
+/**
+ * Intercepts calls to start a Workflow.
+ *
+ * Wraps the operation in an opentelemetry Span and passes it to the Workflow via headers.
+ *
+ * @experimental This interceptor is experimental and APIs may change without notice.
+ */
+export declare class OpenTelemetryWorkflowClientInterceptor implements WorkflowClientInterceptor {
+    protected readonly tracer: otel.Tracer;
+    constructor(options?: InterceptorOptions);
+    start(input: WorkflowStartInput, next: Next<WorkflowClientInterceptor, 'start'>): Promise<string>;
+    signal(input: WorkflowSignalInput, next: Next<WorkflowClientInterceptor, 'signal'>): Promise<void>;
+    startWithDetails(input: WorkflowStartInput, next: Next<WorkflowClientInterceptor, 'startWithDetails'>): Promise<WorkflowStartOutput>;
+    startUpdate(input: WorkflowStartUpdateInput, next: Next<WorkflowClientInterceptor, 'startUpdate'>): Promise<WorkflowStartUpdateOutput>;
+    startUpdateWithStart(input: WorkflowStartUpdateWithStartInput, next: Next<WorkflowClientInterceptor, 'startUpdateWithStart'>): Promise<WorkflowStartUpdateWithStartOutput>;
+    signalWithStart(input: WorkflowSignalWithStartInput, next: Next<WorkflowClientInterceptor, 'signalWithStart'>): Promise<string>;
+    query(input: WorkflowQueryInput, next: Next<WorkflowClientInterceptor, 'query'>): Promise<unknown>;
+    terminate(input: WorkflowTerminateInput, next: Next<WorkflowClientInterceptor, 'terminate'>): Promise<TerminateWorkflowExecutionResponse>;
+    cancel(input: WorkflowCancelInput, next: Next<WorkflowClientInterceptor, 'cancel'>): Promise<RequestCancelWorkflowExecutionResponse>;
+    describe(input: WorkflowDescribeInput, next: Next<WorkflowClientInterceptor, 'describe'>): Promise<DescribeWorkflowExecutionResponse>;
+}

package/lib/client/index.js

@@ -0,0 +1,185 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryWorkflowClientInterceptor = void 0;
+const otel = __importStar(require("@opentelemetry/api"));
+const instrumentation_1 = require("../instrumentation");
+const definitions_1 = require("../workflow/definitions");
+/**
+ * Intercepts calls to start a Workflow.
+ *
+ * Wraps the operation in an opentelemetry Span and passes it to the Workflow via headers.
+ *
+ * @experimental This interceptor is experimental and APIs may change without notice.
+ */
+class OpenTelemetryWorkflowClientInterceptor {
+    tracer;
+    constructor(options) {
+        this.tracer = options?.tracer ?? otel.trace.getTracer('@temporalio/interceptor-client');
+    }
+    async start(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: `${definitions_1.SpanName.WORKFLOW_START}${definitions_1.SPAN_DELIMITER}${input.workflowType}`,
+            fn: async (span) => {
+                const headers = (0, instrumentation_1.headersWithContext)(input.headers);
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.options.workflowId);
+                const runId = await next({ ...input, headers });
+                span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, runId);
+                return runId;
+            },
+        });
+    }
+    async signal(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: `${definitions_1.SpanName.WORKFLOW_SIGNAL}${definitions_1.SPAN_DELIMITER}${input.signalName}`,
+            fn: async (span) => {
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.workflowExecution.workflowId);
+                const headers = (0, instrumentation_1.headersWithContext)(input.headers);
+                await next({ ...input, headers });
+            },
+        });
+    }
+    async startWithDetails(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: `${definitions_1.SpanName.WORKFLOW_START}${definitions_1.SPAN_DELIMITER}${input.workflowType}`,
+            fn: async (span) => {
+                const headers = (0, instrumentation_1.headersWithContext)(input.headers);
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.options.workflowId);
+                const output = await next({ ...input, headers });
+                span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, output.runId);
+                return output;
+            },
+        });
+    }
+    async startUpdate(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: `${definitions_1.SpanName.WORKFLOW_START_UPDATE}${definitions_1.SPAN_DELIMITER}${input.updateName}`,
+            fn: async (span) => {
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.workflowExecution.workflowId);
+                if (input.options.updateId) {
+                    span.setAttribute(instrumentation_1.UPDATE_ID_ATTR_KEY, input.options.updateId);
+                }
+                const headers = (0, instrumentation_1.headersWithContext)(input.headers);
+                const output = await next({ ...input, headers });
+                span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, output.workflowRunId);
+                return output;
+            },
+        });
+    }
+    async startUpdateWithStart(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: `${definitions_1.SpanName.WORKFLOW_UPDATE_WITH_START}${definitions_1.SPAN_DELIMITER}${input.updateName}`,
+            fn: async (span) => {
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.workflowStartOptions.workflowId);
+                if (input.updateOptions.updateId) {
+                    span.setAttribute(instrumentation_1.UPDATE_ID_ATTR_KEY, input.updateOptions.updateId);
+                }
+                const workflowStartHeaders = (0, instrumentation_1.headersWithContext)(input.workflowStartHeaders);
+                const updateHeaders = (0, instrumentation_1.headersWithContext)(input.updateHeaders);
+                const output = await next({ ...input, workflowStartHeaders, updateHeaders });
+                if (output.workflowExecution.runId) {
+                    span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, output.workflowExecution.runId);
+                }
+                return output;
+            },
+        });
+    }
+    async signalWithStart(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: `${definitions_1.SpanName.WORKFLOW_SIGNAL_WITH_START}${definitions_1.SPAN_DELIMITER}${input.workflowType}`,
+            fn: async (span) => {
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.options.workflowId);
+                const headers = (0, instrumentation_1.headersWithContext)(input.headers);
+                const runId = await next({ ...input, headers });
+                span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, runId);
+                return runId;
+            },
+        });
+    }
+    async query(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: `${definitions_1.SpanName.WORKFLOW_QUERY}${definitions_1.SPAN_DELIMITER}${input.queryType}`,
+            fn: async (span) => {
+                const headers = (0, instrumentation_1.headersWithContext)(input.headers);
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.workflowExecution.workflowId);
+                if (input.workflowExecution.runId) {
+                    span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, input.workflowExecution.runId);
+                }
+                return await next({ ...input, headers });
+            },
+        });
+    }
+    async terminate(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: definitions_1.SpanName.WORKFLOW_TERMINATE,
+            fn: async (span) => {
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.workflowExecution.workflowId);
+                if (input.workflowExecution.runId) {
+                    span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, input.workflowExecution.runId);
+                }
+                if (input.reason) {
+                    span.setAttribute(instrumentation_1.TERMINATE_REASON_ATTR_KEY, input.reason);
+                }
+                return await next(input);
+            },
+        });
+    }
+    async cancel(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: definitions_1.SpanName.WORKFLOW_CANCEL,
+            fn: async (span) => {
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.workflowExecution.workflowId);
+                if (input.workflowExecution.runId) {
+                    span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, input.workflowExecution.runId);
+                }
+                return await next(input);
+            },
+        });
+    }
+    async describe(input, next) {
+        return await (0, instrumentation_1.instrument)({
+            tracer: this.tracer,
+            spanName: definitions_1.SpanName.WORKFLOW_DESCRIBE,
+            fn: async (span) => {
+                span.setAttribute(instrumentation_1.WORKFLOW_ID_ATTR_KEY, input.workflowExecution.workflowId);
+                if (input.workflowExecution.runId) {
+                    span.setAttribute(instrumentation_1.RUN_ID_ATTR_KEY, input.workflowExecution.runId);
+                }
+                return await next(input);
+            },
+        });
+    }
+}
+exports.OpenTelemetryWorkflowClientInterceptor = OpenTelemetryWorkflowClientInterceptor;
+//# sourceMappingURL=index.js.map

package/lib/client/index.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `npm i @temporalio/interceptors-opentelemetry-v2`
+ *
+ * Interceptors that add OpenTelemetry tracing.
+ *
+ * [Documentation](https://docs.temporal.io/typescript/logging#opentelemetry-tracing)
+ *
+ * @module
+ */
+export * from './plugin';
+export * from './workflow';
+export * from './worker';
+export { OpenTelemetryWorkflowClientInterceptor } from './client';

package/lib/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * `npm i @temporalio/interceptors-opentelemetry-v2`
+ *
+ * Interceptors that add OpenTelemetry tracing.
+ *
+ * [Documentation](https://docs.temporal.io/typescript/logging#opentelemetry-tracing)
+ *
+ * @module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryWorkflowClientInterceptor = void 0;
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./workflow"), exports);
+__exportStar(require("./worker"), exports);
+var client_1 = require("./client");
+Object.defineProperty(exports, "OpenTelemetryWorkflowClientInterceptor", { enumerable: true, get: function () { return client_1.OpenTelemetryWorkflowClientInterceptor; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,6CAA2B;AAC3B,2CAAyB;AACzB,mCAAkE;AAAzD,gIAAA,sCAAsC,OAAA"}

package/lib/instrumentation.d.ts

@@ -0,0 +1,58 @@
+/**
+ * opentelemetry instrumentation helper functions
+ * @module
+ */
+import * as otel from '@opentelemetry/api';
+import { type Headers } from '@temporalio/common';
+/** Default trace header for opentelemetry interceptors */
+export declare const TRACE_HEADER = "_tracer-data";
+/** As in workflow run id */
+export declare const RUN_ID_ATTR_KEY = "run_id";
+/** As in workflow id */
+export declare const WORKFLOW_ID_ATTR_KEY = "temporalWorkflowId";
+/** As in activity id */
+export declare const ACTIVITY_ID_ATTR_KEY = "temporalActivityId";
+/** As in update id */
+export declare const UPDATE_ID_ATTR_KEY = "temporalUpdateId";
+/** As in termination reason */
+export declare const TERMINATE_REASON_ATTR_KEY = "temporalTerminateReason";
+/** As in Nexus service */
+export declare const NEXUS_SERVICE_ATTR_KEY = "temporalNexusService";
+/** As in Nexus operation */
+export declare const NEXUS_OPERATION_ATTR_KEY = "temporalNexusOperation";
+/** As in Nexus endpoint */
+export declare const NEXUS_ENDPOINT_ATTR_KEY = "temporalNexusEndpoint";
+/**
+ * If found, return an otel Context deserialized from the provided headers
+ */
+export declare function extractContextFromHeaders(headers: Headers): otel.Context | undefined;
+/**
+ * If found, return an otel Context deserialized from the provided Nexus headers.
+ *
+ * Nexus headers are plain `Record<string, string>`, so we extract the context
+ * directly from the string map.
+ */
+export declare function extractContextFromNexusHeaders(headers: Record<string, string>): otel.Context | undefined;
+/**
+ * Given headers, return new headers with the current otel context inserted
+ */
+export declare function headersWithContext(headers: Headers): Headers;
+/**
+ * Given Nexus headers, return new headers with the current otel context injected directly
+ */
+export declare function nexusHeadersWithContext(headers: Record<string, string>): Record<string, string>;
+export interface InstrumentOptions<T> {
+    tracer: otel.Tracer;
+    spanName: string;
+    fn: (span: otel.Span) => Promise<T>;
+    context?: otel.Context;
+    acceptableErrors?: (err: unknown) => boolean;
+}
+export type InstrumentOptionsSync<T> = Omit<InstrumentOptions<T>, 'fn'> & {
+    fn: (span: otel.Span) => T;
+};
+/**
+ * Wraps `fn` in a span which ends when function returns or throws
+ */
+export declare function instrument<T>({ tracer, spanName, fn, context, acceptableErrors, }: InstrumentOptions<T>): Promise<T>;
+export declare function instrumentSync<T>({ tracer, spanName, fn, context, acceptableErrors }: InstrumentOptionsSync<T>): T;

package/lib/instrumentation.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NEXUS_ENDPOINT_ATTR_KEY = exports.NEXUS_OPERATION_ATTR_KEY = exports.NEXUS_SERVICE_ATTR_KEY = exports.TERMINATE_REASON_ATTR_KEY = exports.UPDATE_ID_ATTR_KEY = exports.ACTIVITY_ID_ATTR_KEY = exports.WORKFLOW_ID_ATTR_KEY = exports.RUN_ID_ATTR_KEY = exports.TRACE_HEADER = void 0;
+exports.extractContextFromHeaders = extractContextFromHeaders;
+exports.extractContextFromNexusHeaders = extractContextFromNexusHeaders;
+exports.headersWithContext = headersWithContext;
+exports.nexusHeadersWithContext = nexusHeadersWithContext;
+exports.instrument = instrument;
+exports.instrumentSync = instrumentSync;
+/**
+ * opentelemetry instrumentation helper functions
+ * @module
+ */
+const otel = __importStar(require("@opentelemetry/api"));
+const common_1 = require("@temporalio/common");
+/** Default trace header for opentelemetry interceptors */
+exports.TRACE_HEADER = '_tracer-data';
+/** As in workflow run id */
+exports.RUN_ID_ATTR_KEY = 'run_id';
+/** As in workflow id */
+exports.WORKFLOW_ID_ATTR_KEY = 'temporalWorkflowId';
+/** As in activity id */
+exports.ACTIVITY_ID_ATTR_KEY = 'temporalActivityId';
+/** As in update id */
+exports.UPDATE_ID_ATTR_KEY = 'temporalUpdateId';
+/** As in termination reason */
+exports.TERMINATE_REASON_ATTR_KEY = 'temporalTerminateReason';
+/** As in Nexus service */
+exports.NEXUS_SERVICE_ATTR_KEY = 'temporalNexusService';
+/** As in Nexus operation */
+exports.NEXUS_OPERATION_ATTR_KEY = 'temporalNexusOperation';
+/** As in Nexus endpoint */
+exports.NEXUS_ENDPOINT_ATTR_KEY = 'temporalNexusEndpoint';
+const payloadConverter = common_1.defaultPayloadConverter;
+/**
+ * If found, return an otel Context deserialized from the provided headers
+ */
+function extractContextFromHeaders(headers) {
+    const encodedSpanContext = headers[exports.TRACE_HEADER];
+    if (encodedSpanContext === undefined) {
+        return undefined;
+    }
+    const textMap = payloadConverter.fromPayload(encodedSpanContext);
+    return otel.propagation.extract(otel.context.active(), textMap, otel.defaultTextMapGetter);
+}
+/**
+ * If found, return an otel Context deserialized from the provided Nexus headers.
+ *
+ * Nexus headers are plain `Record<string, string>`, so we extract the context
+ * directly from the string map.
+ */
+function extractContextFromNexusHeaders(headers) {
+    if (Object.keys(headers).length === 0) {
+        return undefined;
+    }
+    return otel.propagation.extract(otel.context.active(), headers, otel.defaultTextMapGetter);
+}
+/**
+ * Given headers, return new headers with the current otel context inserted
+ */
+function headersWithContext(headers) {
+    const carrier = {};
+    otel.propagation.inject(otel.context.active(), carrier, otel.defaultTextMapSetter);
+    return { ...headers, [exports.TRACE_HEADER]: payloadConverter.toPayload(carrier) };
+}
+/**
+ * Given Nexus headers, return new headers with the current otel context injected directly
+ */
+function nexusHeadersWithContext(headers) {
+    const carrier = {};
+    otel.propagation.inject(otel.context.active(), carrier, otel.defaultTextMapSetter);
+    return { ...headers, ...carrier };
+}
+async function wrapWithSpan(span, fn, acceptableErrors) {
+    try {
+        const ret = await fn(span);
+        span.setStatus({ code: otel.SpanStatusCode.OK });
+        return ret;
+    }
+    catch (err) {
+        maybeAddErrorToSpan(err, span, acceptableErrors);
+        throw err;
+    }
+    finally {
+        span.end();
+    }
+}
+function wrapWithSpanSync(span, fn, acceptableErrors) {
+    try {
+        const ret = fn(span);
+        span.setStatus({ code: otel.SpanStatusCode.OK });
+        return ret;
+    }
+    catch (err) {
+        maybeAddErrorToSpan(err, span, acceptableErrors);
+        throw err;
+    }
+    finally {
+        span.end();
+    }
+}
+function maybeAddErrorToSpan(err, span, acceptableErrors) {
+    const isBenignErr = err instanceof common_1.ApplicationFailure && err.category === common_1.ApplicationFailureCategory.BENIGN;
+    if (acceptableErrors === undefined || !acceptableErrors(err)) {
+        const statusCode = isBenignErr ? otel.SpanStatusCode.UNSET : otel.SpanStatusCode.ERROR;
+        const message = err != null && typeof err.message === 'string' ? err.message : String(err);
+        span.setStatus({ code: statusCode, message });
+        span.recordException(err);
+    }
+    else {
+        span.setStatus({ code: otel.SpanStatusCode.OK });
+    }
+}
+/**
+ * Wraps `fn` in a span which ends when function returns or throws
+ */
+async function instrument({ tracer, spanName, fn, context, acceptableErrors, }) {
+    if (context) {
+        return await tracer.startActiveSpan(spanName, {}, context, async (span) => await wrapWithSpan(span, fn, acceptableErrors));
+    }
+    return await tracer.startActiveSpan(spanName, async (span) => await wrapWithSpan(span, fn, acceptableErrors));
+}
+function instrumentSync({ tracer, spanName, fn, context, acceptableErrors }) {
+    if (context) {
+        return tracer.startActiveSpan(spanName, {}, context, (span) => wrapWithSpanSync(span, fn, acceptableErrors));
+    }
+    return tracer.startActiveSpan(spanName, (span) => wrapWithSpanSync(span, fn, acceptableErrors));
+}
+//# sourceMappingURL=instrumentation.js.map

package/lib/instrumentation.js.map

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

package/lib/plugin.d.ts

@@ -0,0 +1,31 @@
+import type { SpanProcessor } from '@opentelemetry/sdk-trace-base';
+import type { Resource } from '@opentelemetry/resources';
+import { SimplePlugin } from '@temporalio/plugin';
+import type { ReplayWorkerOptions, WorkerOptions } from '@temporalio/worker';
+import type { InterceptorOptions } from './client';
+/**
+ * Configuration options for {@link OpenTelemetryPlugin}.
+ *
+ * @experimental Plugins is an experimental feature; APIs may change without notice.
+ */
+export interface OpenTelemetryPluginOptions extends InterceptorOptions {
+    /** OpenTelemetry resource attributes to attach to exported spans */
+    readonly resource: Resource;
+    /** Exporter used to send spans to a tracing backend */
+    readonly spanProcessor: SpanProcessor;
+}
+/**
+ * A plugin that adds OpenTelemetry tracing.
+ *
+ * Configures Client, Activity, and Workflow interceptors for trace propagation and injects
+ * a span exporter sink for Workflow spans.
+ *
+ * @experimental Plugins is an experimental feature; APIs may change without notice.
+ */
+export declare class OpenTelemetryPlugin extends SimplePlugin {
+    readonly otelOptions: OpenTelemetryPluginOptions;
+    constructor(otelOptions: OpenTelemetryPluginOptions);
+    configureWorker(options: WorkerOptions): WorkerOptions;
+    configureReplayWorker(options: ReplayWorkerOptions): ReplayWorkerOptions;
+    private injectSinks;
+}

package/lib/plugin.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryPlugin = void 0;
+const plugin_1 = require("@temporalio/plugin");
+const client_1 = require("./client");
+const worker_1 = require("./worker");
+/**
+ * A plugin that adds OpenTelemetry tracing.
+ *
+ * Configures Client, Activity, and Workflow interceptors for trace propagation and injects
+ * a span exporter sink for Workflow spans.
+ *
+ * @experimental Plugins is an experimental feature; APIs may change without notice.
+ */
+class OpenTelemetryPlugin extends plugin_1.SimplePlugin {
+    otelOptions;
+    constructor(otelOptions) {
+        const workflowInterceptorsPath = require.resolve('./workflow-interceptors');
+        const interceptorOptions = otelOptions.tracer ? { tracer: otelOptions.tracer } : {};
+        super({
+            name: 'OpenTelemetryPlugin',
+            clientInterceptors: {
+                workflow: [new client_1.OpenTelemetryWorkflowClientInterceptor(interceptorOptions)],
+            },
+            workerInterceptors: {
+                client: {
+                    workflow: [new client_1.OpenTelemetryWorkflowClientInterceptor(interceptorOptions)],
+                },
+                workflowModules: [workflowInterceptorsPath],
+                activity: [
+                    (ctx) => ({
+                        inbound: new worker_1.OpenTelemetryActivityInboundInterceptor(ctx, interceptorOptions),
+                        outbound: new worker_1.OpenTelemetryActivityOutboundInterceptor(ctx),
+                    }),
+                ],
+                nexus: [
+                    (ctx) => ({
+                        inbound: new worker_1.OpenTelemetryNexusInboundInterceptor(ctx, interceptorOptions),
+                        outbound: new worker_1.OpenTelemetryNexusOutboundInterceptor(ctx),
+                    }),
+                ],
+            },
+        });
+        this.otelOptions = otelOptions;
+    }
+    configureWorker(options) {
+        return super.configureWorker(this.injectSinks(options));
+    }
+    configureReplayWorker(options) {
+        return super.configureReplayWorker(this.injectSinks(options));
+    }
+    injectSinks(options) {
+        const sinks = {
+            exporter: (0, worker_1.makeWorkflowExporter)(this.otelOptions.spanProcessor, this.otelOptions.resource),
+        };
+        return {
+            ...options,
+            sinks: {
+                ...options.sinks,
+                ...sinks,
+            },
+        };
+    }
+}
+exports.OpenTelemetryPlugin = OpenTelemetryPlugin;
+//# sourceMappingURL=plugin.js.map

package/lib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":";;;AAEA,+CAAkD;AAGlD,qCAAkE;AAClE,qCAMkB;AAelB;;;;;;;GAOG;AACH,MAAa,mBAAoB,SAAQ,qBAAY;IAC9B;IAArB,YAAqB,WAAuC;QAC1D,MAAM,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC5E,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,KAAK,CAAC;YACJ,IAAI,EAAE,qBAAqB;YAC3B,kBAAkB,EAAE;gBAClB,QAAQ,EAAE,CAAC,IAAI,+CAAsC,CAAC,kBAAkB,CAAC,CAAC;aAC3E;YACD,kBAAkB,EAAE;gBAClB,MAAM,EAAE;oBACN,QAAQ,EAAE,CAAC,IAAI,+CAAsC,CAAC,kBAAkB,CAAC,CAAC;iBAC3E;gBACD,eAAe,EAAE,CAAC,wBAAwB,CAAC;gBAC3C,QAAQ,EAAE;oBACR,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBACR,OAAO,EAAE,IAAI,gDAAuC,CAAC,GAAG,EAAE,kBAAkB,CAAC;wBAC7E,QAAQ,EAAE,IAAI,iDAAwC,CAAC,GAAG,CAAC;qBAC5D,CAAC;iBACH;gBACD,KAAK,EAAE;oBACL,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBACR,OAAO,EAAE,IAAI,6CAAoC,CAAC,GAAG,EAAE,kBAAkB,CAAC;wBAC1E,QAAQ,EAAE,IAAI,8CAAqC,CAAC,GAAG,CAAC;qBACzD,CAAC;iBACH;aACF;SACF,CAAC,CAAC;QA1BgB,gBAAW,GAAX,WAAW,CAA4B;IA2B5D,CAAC;IAED,eAAe,CAAC,OAAsB;QACpC,OAAO,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,qBAAqB,CAAC,OAA4B;QAChD,OAAO,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,WAAW,CAA2C,OAAU;QACtE,MAAM,KAAK,GAAsC;YAC/C,QAAQ,EAAE,IAAA,6BAAoB,EAAC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;SAC1F,CAAC;QACF,OAAO;YACL,GAAG,OAAO;YACV,KAAK,EAAE;gBACL,GAAG,OAAO,CAAC,KAAK;gBAChB,GAAG,KAAK;aACT;SACF,CAAC;IACJ,CAAC;CACF;AAlDD,kDAkDC"}