@composed-di/instrumentation-otel 0.6.0-alpha

package/dist/OTELEventListener.d.ts

@@ -0,0 +1,37 @@
+import { Tracer } from '@opentelemetry/api';
+import { DisposeContext, EventSpan, InitializeContext, MethodCallContext, ServiceInstrumentation } from '@composed-di/instrumentation-core';
+export interface OTELEventListenerOptions {
+    /**
+     * The tracer used to create spans. Defaults to a tracer obtained from
+     * the global tracer provider — the one `NodeSDK` (and therefore
+     * `@opentelemetry/auto-instrumentations-node`) registers on startup —
+     * so most setups can omit it. The global lookup is lazy: it also works
+     * when the listener is constructed before the SDK starts.
+     */
+    tracer?: Tracer;
+    /**
+     * Record method arguments as the `composed_di.service.function.arguments`
+     * span attribute, serialized to JSON. Off by default: arguments may be
+     * large or contain secrets, and they end up wherever spans are exported.
+     */
+    captureArguments?: boolean;
+    /**
+     * Record return / resolved values as the
+     * `composed_di.service.function.result` span attribute, serialized to
+     * JSON. Off by default, for the same reasons as `captureArguments`.
+     * Applies to method call and initialize spans.
+     */
+    captureResults?: boolean;
+}
+export declare class OTELEventListener implements ServiceInstrumentation {
+    private readonly tracer;
+    private readonly captureArguments;
+    private readonly captureResults;
+    constructor(options?: OTELEventListenerOptions);
+    onInitialize(context: InitializeContext): EventSpan;
+    onDispose(context: DisposeContext): EventSpan;
+    onMethodCall(context: MethodCallContext): EventSpan;
+    private buildSpan;
+    private buildAttributes;
+}
+//# sourceMappingURL=OTELEventListener.d.ts.map

package/dist/OTELEventListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OTELEventListener.d.ts","sourceRoot":"","sources":["../src/OTELEventListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,MAAM,EACP,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EACL,cAAc,EAEd,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,mCAAmC,CAAC;AAG3C,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,OAAO,GAAE,wBAA6B;IAOlD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS;IAWnD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS;IAW7C,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS;IAYnD,OAAO,CAAC,SAAS;IAoCjB,OAAO,CAAC,eAAe;CAqBxB"}

package/dist/OTELEventListener.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTELEventListener = void 0;
+const api_1 = require("@opentelemetry/api");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+class OTELEventListener {
+    constructor(options = {}) {
+        var _a, _b, _c;
+        this.tracer =
+            (_a = options.tracer) !== null && _a !== void 0 ? _a : api_1.trace.getTracer('@composed-di/instrumentation-otel');
+        this.captureArguments = (_b = options.captureArguments) !== null && _b !== void 0 ? _b : false;
+        this.captureResults = (_c = options.captureResults) !== null && _c !== void 0 ? _c : false;
+    }
+    onInitialize(context) {
+        const attributes = this.buildAttributes({
+            key: context.key,
+            event: 'initialize',
+            className: 'ServiceFactory',
+            functionName: 'initialize',
+        });
+        const spanName = `ServiceFactory[${context.key.name}].initialize`;
+        return this.buildSpan(spanName, attributes, this.captureResults);
+    }
+    onDispose(context) {
+        const attributes = this.buildAttributes({
+            key: context.key,
+            event: 'dispose',
+            className: 'ServiceFactory',
+            functionName: 'dispose',
+        });
+        const spanName = `ServiceFactory[${context.key.name}].dispose`;
+        return this.buildSpan(spanName, attributes, false);
+    }
+    onMethodCall(context) {
+        const attributes = this.buildAttributes({
+            key: context.key,
+            event: 'call',
+            className: context.className,
+            functionName: context.functionName,
+            args: context.args,
+        });
+        const spanName = attributes[semantic_conventions_1.ATTR_CODE_FUNCTION_NAME];
+        return this.buildSpan(spanName, attributes, this.captureResults);
+    }
+    buildSpan(spanName, attributes, captureResult) {
+        const parentContext = api_1.context.active();
+        const span = this.tracer.startSpan(spanName, { attributes }, parentContext);
+        const spanContext = api_1.trace.setSpan(parentContext, span);
+        return {
+            run: (fn) => api_1.context.with(spanContext, fn),
+            end: (outcome) => {
+                if (outcome.type === 'failure') {
+                    const error = outcome.error;
+                    span.recordException(error instanceof Error ? error : String(error));
+                    span.setAttribute(semantic_conventions_1.ATTR_ERROR_TYPE, error instanceof Error
+                        ? error.name || semantic_conventions_1.ERROR_TYPE_VALUE_OTHER
+                        : semantic_conventions_1.ERROR_TYPE_VALUE_OTHER);
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: error instanceof Error ? error.message : String(error),
+                    });
+                }
+                else if (captureResult) {
+                    span.setAttribute('composed_di.service.function.result', serialize(outcome.value));
+                }
+                span.end();
+            },
+        };
+    }
+    buildAttributes(params) {
+        var _a;
+        const attributes = {
+            [semantic_conventions_1.ATTR_CODE_FUNCTION_NAME]: `${(_a = params.className) !== null && _a !== void 0 ? _a : params.key.name}.${params.functionName}`,
+            'composed_di.service.key': params.key.name,
+            'composed_di.service.event': params.event,
+        };
+        if (params.args && this.captureArguments) {
+            attributes['composed_di.service.function.arguments'] = serialize(params.args);
+        }
+        return attributes;
+    }
+}
+exports.OTELEventListener = OTELEventListener;
+function serialize(value) {
+    var _a;
+    let text;
+    try {
+        text = (_a = JSON.stringify(value)) !== null && _a !== void 0 ? _a : String(value);
+    }
+    catch (_b) {
+        text = '[unserializable]';
+    }
+    return text;
+}
+//# sourceMappingURL=OTELEventListener.js.map

package/dist/OTELEventListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OTELEventListener.js","sourceRoot":"","sources":["../src/OTELEventListener.ts"],"names":[],"mappings":";;;AAAA,4CAM4B;AAC5B,8EAI6C;AAqC7C,MAAa,iBAAiB;IAK5B,YAAY,UAAoC,EAAE;;QAChD,IAAI,CAAC,MAAM;YACT,MAAA,OAAO,CAAC,MAAM,mCAAI,WAAK,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QACzE,IAAI,CAAC,gBAAgB,GAAG,MAAA,OAAO,CAAC,gBAAgB,mCAAI,KAAK,CAAC;QAC1D,IAAI,CAAC,cAAc,GAAG,MAAA,OAAO,CAAC,cAAc,mCAAI,KAAK,CAAC;IACxD,CAAC;IAED,YAAY,CAAC,OAA0B;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;YACtC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,gBAAgB;YAC3B,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,kBAAkB,OAAO,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC;QAClE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC;IAED,SAAS,CAAC,OAAuB;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;YACtC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,gBAAgB;YAC3B,YAAY,EAAE,SAAS;SACxB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,kBAAkB,OAAO,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC;QAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,YAAY,CAAC,OAA0B;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;YACtC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,UAAU,CAAC,8CAAuB,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC;IAEO,SAAS,CACf,QAAgB,EAChB,UAAsB,EACtB,aAAsB;QAEtB,MAAM,aAAa,GAAG,aAAW,CAAC,MAAM,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,aAAa,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,WAAK,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAEvD,OAAO;YACL,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,aAAW,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9C,GAAG,EAAE,CAAC,OAAqB,EAAE,EAAE;gBAC7B,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;oBAC5B,IAAI,CAAC,eAAe,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBACrE,IAAI,CAAC,YAAY,CACf,sCAAe,EACf,KAAK,YAAY,KAAK;wBACpB,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,6CAAsB;wBACtC,CAAC,CAAC,6CAAsB,CAC3B,CAAC;oBACF,IAAI,CAAC,SAAS,CAAC;wBACb,IAAI,EAAE,oBAAc,CAAC,KAAK;wBAC1B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAChE,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,aAAa,EAAE,CAAC;oBACzB,IAAI,CAAC,YAAY,CACf,qCAAqC,EACrC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CACzB,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,MAMvB;;QACC,MAAM,UAAU,GAA8B;YAC5C,CAAC,8CAAuB,CAAC,EAAE,GAAG,MAAA,MAAM,CAAC,SAAS,mCAAI,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,EAAE;YAC1F,yBAAyB,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI;YAC1C,2BAA2B,EAAE,MAAM,CAAC,KAAK;SAC1C,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzC,UAAU,CAAC,wCAAwC,CAAC,GAAG,SAAS,CAC9D,MAAM,CAAC,IAAI,CACZ,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAvGD,8CAuGC;AAED,SAAS,SAAS,CAAC,KAAc;;IAC/B,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAA,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mCAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,WAAM,CAAC;QACP,IAAI,GAAG,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './otelInstrumentation';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"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 __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 });
+__exportStar(require("./otelInstrumentation"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAqC"}

package/dist/otelInstrumentation.d.ts

@@ -0,0 +1,30 @@
+import { Tracer } from '@opentelemetry/api';
+import { DisposeContext, EventSpan, InitializeContext, MethodCallContext, ServiceInstrumentation } from '@composed-di/instrumentation-core';
+export interface OTELInstrumentationOptions {
+    /**
+     * The tracer used to create spans. Defaults to a tracer obtained from
+     * the global tracer provider — the one `NodeSDK` (and therefore
+     * `@opentelemetry/auto-instrumentations-node`) registers on startup —
+     * so most setups can omit it. The global lookup is lazy: it also works
+     * when the instrumentation is constructed before the SDK starts.
+     */
+    tracer?: Tracer;
+}
+/**
+ * A ServiceInstrumentation that records service events as OTEL spans.
+ *
+ * Arguments and results are recorded (as the
+ * `composed_di.service.function.arguments` / `.result` attributes,
+ * serialized to JSON) exactly when `instrument()` delivers them — capture
+ * and redaction policy live in the InstrumentOptions, not here.
+ */
+export declare class OTELInstrumentation implements ServiceInstrumentation {
+    private readonly tracer;
+    constructor(options?: OTELInstrumentationOptions);
+    onInitialize(context: InitializeContext): EventSpan;
+    onDispose(context: DisposeContext): EventSpan;
+    onMethodCall(context: MethodCallContext): EventSpan;
+    private buildSpan;
+    private buildAttributes;
+}
+//# sourceMappingURL=otelInstrumentation.d.ts.map

package/dist/otelInstrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otelInstrumentation.d.ts","sourceRoot":"","sources":["../src/otelInstrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,MAAM,EACP,MAAM,oBAAoB,CAAA;AAM3B,OAAO,EACL,cAAc,EAEd,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,mCAAmC,CAAA;AAG1C,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,OAAO,GAAE,0BAA+B;IAKpD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS;IAWnD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS;IAW7C,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS;IAYnD,OAAO,CAAC,SAAS;IAkCjB,OAAO,CAAC,eAAe;CAuBxB"}

package/dist/otelInstrumentation.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTELInstrumentation = void 0;
+const api_1 = require("@opentelemetry/api");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+/**
+ * A ServiceInstrumentation that records service events as OTEL spans.
+ *
+ * Arguments and results are recorded (as the
+ * `composed_di.service.function.arguments` / `.result` attributes,
+ * serialized to JSON) exactly when `instrument()` delivers them — capture
+ * and redaction policy live in the InstrumentOptions, not here.
+ */
+class OTELInstrumentation {
+    constructor(options = {}) {
+        var _a;
+        this.tracer =
+            (_a = options.tracer) !== null && _a !== void 0 ? _a : api_1.trace.getTracer('@composed-di/instrumentation-otel');
+    }
+    onInitialize(context) {
+        const attributes = this.buildAttributes({
+            key: context.key,
+            event: 'initialize',
+            className: 'ServiceFactory',
+            functionName: 'initialize',
+        });
+        const spanName = `ServiceFactory[${context.key.name}].initialize`;
+        return this.buildSpan(spanName, attributes);
+    }
+    onDispose(context) {
+        const attributes = this.buildAttributes({
+            key: context.key,
+            event: 'dispose',
+            className: 'ServiceFactory',
+            functionName: 'dispose',
+        });
+        const spanName = `ServiceFactory[${context.key.name}].dispose`;
+        return this.buildSpan(spanName, attributes);
+    }
+    onMethodCall(context) {
+        const attributes = this.buildAttributes({
+            key: context.key,
+            event: 'call',
+            className: context.className,
+            functionName: context.functionName,
+            args: context.args,
+        });
+        const spanName = attributes[semantic_conventions_1.ATTR_CODE_FUNCTION_NAME];
+        return this.buildSpan(spanName, attributes);
+    }
+    buildSpan(spanName, attributes) {
+        const parentContext = api_1.context.active();
+        const span = this.tracer.startSpan(spanName, { attributes }, parentContext);
+        const spanContext = api_1.trace.setSpan(parentContext, span);
+        return {
+            run: (fn) => api_1.context.with(spanContext, fn),
+            end: (outcome) => {
+                if (outcome.type === 'failure') {
+                    const error = outcome.error;
+                    span.recordException(error instanceof Error ? error : String(error));
+                    span.setAttribute(semantic_conventions_1.ATTR_ERROR_TYPE, error instanceof Error
+                        ? error.name || semantic_conventions_1.ERROR_TYPE_VALUE_OTHER
+                        : semantic_conventions_1.ERROR_TYPE_VALUE_OTHER);
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: error instanceof Error ? error.message : String(error),
+                    });
+                }
+                else if ('value' in outcome) {
+                    // Present exactly when result capture is enabled in the
+                    // InstrumentOptions; the value arrives already redacted.
+                    span.setAttribute('composed_di.service.function.result', serialize(outcome.value));
+                }
+                span.end();
+            },
+        };
+    }
+    buildAttributes(params) {
+        var _a;
+        const attributes = {
+            [semantic_conventions_1.ATTR_CODE_FUNCTION_NAME]: `${(_a = params.className) !== null && _a !== void 0 ? _a : params.key.name}.${params.functionName}`,
+            'composed_di.service.key': params.key.name,
+            'composed_di.service.event': params.event,
+        };
+        // Present exactly when argument capture is enabled in the
+        // InstrumentOptions; the args arrive already redacted.
+        if (params.args) {
+            attributes['composed_di.service.function.arguments'] = serialize(params.args);
+        }
+        return attributes;
+    }
+}
+exports.OTELInstrumentation = OTELInstrumentation;
+function serialize(value) {
+    var _a;
+    let text;
+    try {
+        text = (_a = JSON.stringify(value)) !== null && _a !== void 0 ? _a : String(value);
+    }
+    catch (_b) {
+        text = '[unserializable]';
+    }
+    return text;
+}
+//# sourceMappingURL=otelInstrumentation.js.map

package/dist/otelInstrumentation.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@composed-di/instrumentation-otel",
+  "version": "0.6.0-alpha",
+  "private": false,
+  "keywords": [
+    "dependency injection",
+    "di",
+    "observability",
+    "opentelemetry",
+    "otel",
+    "tracing"
+  ],
+  "license": "MIT",
+  "author": "Juan Herrera juanhr454@gmail.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imherrera/composed-di.git",
+    "directory": "packages/instrumentation-otel"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "commonjs",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opentelemetry/semantic-conventions": "^1.30.0",
+    "@composed-di/core": "^0.6.0-alpha",
+    "@composed-di/instrumentation-core": "^0.6.0-alpha"
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/context-async-hooks": "^2.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.9.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './otelInstrumentation'

package/src/otelInstrumentation.ts

@@ -0,0 +1,151 @@
+import {
+  Attributes,
+  context as otelContext,
+  SpanStatusCode,
+  trace,
+  Tracer,
+} from '@opentelemetry/api'
+import {
+  ATTR_CODE_FUNCTION_NAME,
+  ATTR_ERROR_TYPE,
+  ERROR_TYPE_VALUE_OTHER,
+} from '@opentelemetry/semantic-conventions'
+import {
+  DisposeContext,
+  EventOutcome,
+  EventSpan,
+  InitializeContext,
+  MethodCallContext,
+  ServiceInstrumentation,
+} from '@composed-di/instrumentation-core'
+import { ServiceKey } from '@composed-di/core'
+
+export interface OTELInstrumentationOptions {
+  /**
+   * The tracer used to create spans. Defaults to a tracer obtained from
+   * the global tracer provider — the one `NodeSDK` (and therefore
+   * `@opentelemetry/auto-instrumentations-node`) registers on startup —
+   * so most setups can omit it. The global lookup is lazy: it also works
+   * when the instrumentation is constructed before the SDK starts.
+   */
+  tracer?: Tracer
+}
+
+/**
+ * A ServiceInstrumentation that records service events as OTEL spans.
+ *
+ * Arguments and results are recorded (as the
+ * `composed_di.service.function.arguments` / `.result` attributes,
+ * serialized to JSON) exactly when `instrument()` delivers them — capture
+ * and redaction policy live in the InstrumentOptions, not here.
+ */
+export class OTELInstrumentation implements ServiceInstrumentation {
+  private readonly tracer: Tracer
+
+  constructor(options: OTELInstrumentationOptions = {}) {
+    this.tracer =
+      options.tracer ?? trace.getTracer('@composed-di/instrumentation-otel')
+  }
+
+  onInitialize(context: InitializeContext): EventSpan {
+    const attributes = this.buildAttributes({
+      key: context.key,
+      event: 'initialize',
+      className: 'ServiceFactory',
+      functionName: 'initialize',
+    })
+    const spanName = `ServiceFactory[${context.key.name}].initialize`
+    return this.buildSpan(spanName, attributes)
+  }
+
+  onDispose(context: DisposeContext): EventSpan {
+    const attributes = this.buildAttributes({
+      key: context.key,
+      event: 'dispose',
+      className: 'ServiceFactory',
+      functionName: 'dispose',
+    })
+    const spanName = `ServiceFactory[${context.key.name}].dispose`
+    return this.buildSpan(spanName, attributes)
+  }
+
+  onMethodCall(context: MethodCallContext): EventSpan {
+    const attributes = this.buildAttributes({
+      key: context.key,
+      event: 'call',
+      className: context.className,
+      functionName: context.functionName,
+      args: context.args,
+    })
+    const spanName = attributes[ATTR_CODE_FUNCTION_NAME]
+    return this.buildSpan(spanName, attributes)
+  }
+
+  private buildSpan(spanName: string, attributes: Attributes): EventSpan {
+    const parentContext = otelContext.active()
+    const span = this.tracer.startSpan(spanName, { attributes }, parentContext)
+    const spanContext = trace.setSpan(parentContext, span)
+
+    return {
+      run: (fn) => otelContext.with(spanContext, fn),
+      end: (outcome: EventOutcome) => {
+        if (outcome.type === 'failure') {
+          const error = outcome.error
+          span.recordException(error instanceof Error ? error : String(error))
+          span.setAttribute(
+            ATTR_ERROR_TYPE,
+            error instanceof Error
+              ? error.name || ERROR_TYPE_VALUE_OTHER
+              : ERROR_TYPE_VALUE_OTHER,
+          )
+          span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : String(error),
+          })
+        } else if ('value' in outcome) {
+          // Present exactly when result capture is enabled in the
+          // InstrumentOptions; the value arrives already redacted.
+          span.setAttribute(
+            'composed_di.service.function.result',
+            serialize(outcome.value),
+          )
+        }
+        span.end()
+      },
+    }
+  }
+
+  private buildAttributes(params: {
+    key: ServiceKey<unknown>
+    event: 'initialize' | 'dispose' | 'call'
+    className?: string
+    functionName: string
+    args?: readonly unknown[]
+  }) {
+    const attributes: { [key: string]: string } = {
+      [ATTR_CODE_FUNCTION_NAME]: `${params.className ?? params.key.name}.${params.functionName}`,
+      'composed_di.service.key': params.key.name,
+      'composed_di.service.event': params.event,
+    }
+
+    // Present exactly when argument capture is enabled in the
+    // InstrumentOptions; the args arrive already redacted.
+    if (params.args) {
+      attributes['composed_di.service.function.arguments'] = serialize(
+        params.args,
+      )
+    }
+
+    return attributes
+  }
+}
+
+function serialize(value: unknown): string {
+  let text: string
+  try {
+    text = JSON.stringify(value) ?? String(value)
+  } catch {
+    text = '[unserializable]'
+  }
+  return text
+}