@composed-di/core 0.5.0-alpha → 0.5.2-alpha

package/dist/index.d.ts

@@ -3,7 +3,8 @@ export * from './serviceModule';
 export * from './serviceFactory';
 export * from './serviceScope';
 export * from './serviceSelector';
-export * from './serviceEventListener';
+export * from './serviceModuleListener';
+export * from './redactingEventListener';
 export * from './errors';
 export * from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -19,7 +19,8 @@ __exportStar(require("./serviceModule"), exports);
 __exportStar(require("./serviceFactory"), exports);
 __exportStar(require("./serviceScope"), exports);
 __exportStar(require("./serviceSelector"), exports);
-__exportStar(require("./serviceEventListener"), exports);
+__exportStar(require("./serviceModuleListener"), exports);
+__exportStar(require("./redactingEventListener"), exports);
 __exportStar(require("./errors"), exports);
 __exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC;AAChC,mDAAiC;AACjC,iDAA+B;AAC/B,oDAAkC;AAClC,yDAAuC;AACvC,2CAAyB;AACzB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC;AAChC,mDAAiC;AACjC,iDAA+B;AAC/B,oDAAkC;AAClC,0DAAwC;AACxC,2DAAyC;AACzC,2CAAyB;AACzB,0CAAwB"}

package/dist/redactingEventListener.d.ts

@@ -0,0 +1,57 @@
+import type { DisposeContext, EventSpan, InitializeContext, MethodCallContext, ServiceModuleListener } from './serviceModuleListener';
+import type { ServiceKey } from './serviceKey';
+/**
+ * The placeholder that replaces redacted values in event contexts and
+ * outcomes.
+ */
+export declare const REDACTED_VALUE = "[redacted]";
+/**
+ * Marks a service — or specific properties of it — as sensitive, so the
+ * values flowing through its events are replaced with {@link REDACTED_VALUE}.
+ */
+export interface RedactionRule<T> {
+    /**
+     * The service key whose values must be redacted. Matched by key
+     * identity, like everywhere else in the container.
+     */
+    key: ServiceKey<T>;
+    /**
+     * Property names to redact. Optional: when omitted, ALL properties of
+     * the service are redacted, along with its initialize result (the
+     * service instance itself may carry credentials or config).
+     */
+    properties?: Extract<keyof T, string>[];
+}
+export declare function redactionRule<T>(key: ServiceKey<T>, properties?: Extract<keyof T, string>[]): RedactionRule<T>;
+/**
+ * A ServiceEventListener decorator that redacts sensitive values before
+ * they reach the wrapped listener. Works with any implementation via
+ * delegation: arguments in MethodCallContext and success values in
+ * EventOutcome are replaced with {@link REDACTED_VALUE}, so the delegate
+ * never sees the sensitive data — whatever it captures or exports is
+ * already scrubbed.
+ *
+ * Failure outcomes are passed through unchanged so error reporting keeps
+ * working; keep secrets out of error messages at the throwing site.
+ *
+ * @example
+ * ```ts
+ * const listener = new RedactingEventListener(
+ *   new OTELEventListener({ captureArguments: true, captureResults: true }),
+ *   [
+ *     { key: SecretClientKey }, // whole service is sensitive
+ *     { key: VaultKey, properties: ['getSecret'] }, // only these calls
+ *   ],
+ * );
+ * ```
+ */
+export declare class RedactingEventListener implements ServiceModuleListener {
+    private readonly delegate;
+    private readonly rules;
+    constructor(delegate: ServiceModuleListener, rules: readonly RedactionRule<any>[]);
+    onInitialize(context: InitializeContext): EventSpan | void;
+    onDispose(context: DisposeContext): EventSpan | void;
+    onMethodCall(context: MethodCallContext): EventSpan | void;
+    private isRedacted;
+}
+//# sourceMappingURL=redactingEventListener.d.ts.map

package/dist/redactingEventListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactingEventListener.d.ts","sourceRoot":"","sources":["../src/redactingEventListener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B;;;OAGG;IACH,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAEnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;CACzC;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAE9G;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,sBAAuB,YAAW,qBAAqB;IAEhE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE;IAGvD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI;IAU1D,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAKpD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI;IAc1D,OAAO,CAAC,UAAU;CAYnB"}

package/dist/redactingEventListener.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedactingEventListener = exports.REDACTED_VALUE = void 0;
+exports.redactionRule = redactionRule;
+/**
+ * The placeholder that replaces redacted values in event contexts and
+ * outcomes.
+ */
+exports.REDACTED_VALUE = '[redacted]';
+function redactionRule(key, properties) {
+    return { key, properties };
+}
+/**
+ * A ServiceEventListener decorator that redacts sensitive values before
+ * they reach the wrapped listener. Works with any implementation via
+ * delegation: arguments in MethodCallContext and success values in
+ * EventOutcome are replaced with {@link REDACTED_VALUE}, so the delegate
+ * never sees the sensitive data — whatever it captures or exports is
+ * already scrubbed.
+ *
+ * Failure outcomes are passed through unchanged so error reporting keeps
+ * working; keep secrets out of error messages at the throwing site.
+ *
+ * @example
+ * ```ts
+ * const listener = new RedactingEventListener(
+ *   new OTELEventListener({ captureArguments: true, captureResults: true }),
+ *   [
+ *     { key: SecretClientKey }, // whole service is sensitive
+ *     { key: VaultKey, properties: ['getSecret'] }, // only these calls
+ *   ],
+ * );
+ * ```
+ */
+class RedactingEventListener {
+    constructor(delegate, rules) {
+        this.delegate = delegate;
+        this.rules = rules;
+    }
+    onInitialize(context) {
+        var _a, _b;
+        // The initialize result is the service instance itself, so it is
+        // redacted only when the whole service is sensitive — a rule without
+        // `properties`.
+        return redactSpan((_b = (_a = this.delegate).onInitialize) === null || _b === void 0 ? void 0 : _b.call(_a, context), this.isRedacted(context.key));
+    }
+    onDispose(context) {
+        var _a, _b;
+        // Dispose carries no arguments and no result value; nothing to redact.
+        return (_b = (_a = this.delegate).onDispose) === null || _b === void 0 ? void 0 : _b.call(_a, context);
+    }
+    onMethodCall(context) {
+        var _a, _b;
+        const redacted = this.isRedacted(context.key, context.functionName);
+        const span = (_b = (_a = this.delegate).onMethodCall) === null || _b === void 0 ? void 0 : _b.call(_a, redacted
+            ? // Replace each argument rather than the whole array, so the
+             Object.assign(Object.assign({}, context), { args: context.args.map(() => exports.REDACTED_VALUE) }) : context);
+        return redactSpan(span, redacted);
+    }
+    // 1. Si expiro el dbr `EXPIRED` el cron debe mandar a `FACE_MISMATCH`?
+    // 2. Si hubo un matchLevel intermediario el cron debe mandar a `FACE_MISMATCH`? (Probablemente no)
+    isRedacted(key, propertyName) {
+        return this.rules.some((rule) => {
+            var _a;
+            return rule.key === key &&
+                // A rule without `properties` redacts everything on the key,
+                // including initialize — where no property name is passed —
+                // while a rule with `properties` matches only those calls.
+                (rule.properties === undefined ||
+                    (propertyName !== undefined &&
+                        ((_a = rule.properties) === null || _a === void 0 ? void 0 : _a.includes(propertyName))));
+        });
+    }
+}
+exports.RedactingEventListener = RedactingEventListener;
+/**
+ * Wraps the delegate's EventSpan so success values are redacted before
+ * `end` sees them. `run` (and any future fields) pass through untouched.
+ */
+function redactSpan(span, redacted) {
+    if (!redacted || !(span === null || span === void 0 ? void 0 : span.end)) {
+        return span;
+    }
+    const end = span.end.bind(span);
+    return Object.assign(Object.assign({}, span), { end: (outcome) => end(outcome.type === 'success'
+            ? { type: 'success', value: exports.REDACTED_VALUE }
+            : outcome) });
+}
+//# sourceMappingURL=redactingEventListener.js.map

package/dist/redactingEventListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactingEventListener.js","sourceRoot":"","sources":["../src/redactingEventListener.ts"],"names":[],"mappings":";;;AAmCA,sCAEC;AA3BD;;;GAGG;AACU,QAAA,cAAc,GAAG,YAAY,CAAC;AAqB3C,SAAgB,aAAa,CAAI,GAAkB,EAAE,UAAuC;IAC1F,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,sBAAsB;IACjC,YACmB,QAA+B,EAC/B,KAAoC;QADpC,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,UAAK,GAAL,KAAK,CAA+B;IACpD,CAAC;IAEJ,YAAY,CAAC,OAA0B;;QACrC,iEAAiE;QACjE,qEAAqE;QACrE,gBAAgB;QAChB,OAAO,UAAU,CACf,MAAA,MAAA,IAAI,CAAC,QAAQ,EAAC,YAAY,mDAAG,OAAO,CAAC,EACrC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAC7B,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,OAAuB;;QAC/B,uEAAuE;QACvE,OAAO,MAAA,MAAA,IAAI,CAAC,QAAQ,EAAC,SAAS,mDAAG,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,YAAY,CAAC,OAA0B;;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAA,MAAA,IAAI,CAAC,QAAQ,EAAC,YAAY,mDACrC,QAAQ;YACN,CAAC,CAAC,4DAA4D;6CAEvD,OAAO,KAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,sBAAc,CAAC,IAC5D,CAAC,CAAC,OAAO,CACZ,CAAC;QACF,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,uEAAuE;IACvE,mGAAmG;IAC3F,UAAU,CAAC,GAAoB,EAAE,YAAqB;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,CAAC,IAAI,EAAE,EAAE;;YACP,OAAA,IAAI,CAAC,GAAG,KAAK,GAAG;gBAChB,6DAA6D;gBAC7D,4DAA4D;gBAC5D,2DAA2D;gBAC3D,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS;oBAC5B,CAAC,YAAY,KAAK,SAAS;yBACzB,MAAA,IAAI,CAAC,UAAU,0CAAE,QAAQ,CAAC,YAAY,CAAC,CAAA,CAAC,CAAC,CAAA;SAAA,CAChD,CAAC;IACJ,CAAC;CACF;AA/CD,wDA+CC;AAED;;;GAGG;AACH,SAAS,UAAU,CACjB,IAAsB,EACtB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,CAAA,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,uCACK,IAAI,KACP,GAAG,EAAE,CAAC,OAAqB,EAAE,EAAE,CAC7B,GAAG,CACD,OAAO,CAAC,IAAI,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,sBAAc,EAAE;YAC5C,CAAC,CAAC,OAAO,CACZ,IACH;AACJ,CAAC"}

package/dist/serviceEventListener.d.ts

@@ -4,48 +4,54 @@ import type { ServiceKey } from './serviceKey';
  * disposal, or method call), returned by a ServiceEventListener when the
  * operation starts.
  *
- * Exactly one of `end` or `error` is invoked when the operation finishes,
- * so implementations can close over per-call state (start time, an
- * OpenTelemetry span, a correlation id) without any bookkeeping to pair
- * concurrent start/finish events.
+ * `end` is invoked exactly once when the operation finishes, so
+ * implementations can close over per-call state (a start time, a span
+ * handle, a correlation id) without any bookkeeping to pair concurrent
+ * start/finish events.
  */
 export interface EventSpan {
     /**
-     * Invoked when the operation completes successfully. For methods that
-     * return a promise, this fires when the promise resolves, not when the
-     * method returns.
+     * Optional wrapper around the operation itself. When present, the module
+     * invokes the operation as `run(() => operation())`, so the listener can
+     * establish ambient state that the operation body and its async
+     * continuations inherit — this is what lets spans of nested service
+     * calls form a parent-child hierarchy.
      *
-     * Whether to retain or log the outcome is the implementation's choice;
-     * the value is passed by reference, so implementations must not mutate it.
+     * Implementations must invoke `fn` exactly once, synchronously, and
+     * return its result unchanged (for async operations, the promise itself).
+     * `end` is still delivered separately when the operation finishes.
      *
-     * @param outcome - The outcome of the operation. Present for method call
-     * spans (the return or resolved value) and initialize spans (the service
-     * instance), absent for dispose spans.
-     * @return void
+     * @param fn - A thunk that performs the operation.
+     * @return The value returned by `fn`.
      */
-    end?(outcome?: EventOutcome): void;
+    run?<T>(fn: () => T): T;
     /**
-     * Invoked when the operation throws or rejects. Terminal like `end`;
-     * the two are mutually exclusive. The error is rethrown to the caller
-     * after this is invoked.
+     * Invoked exactly once when the operation finishes, whether it succeeded
+     * or failed. For methods that return a promise, this fires when the
+     * promise settles, not when the method returns. On failure, the error is
+     * rethrown to the caller after this is invoked.
      *
-     * @param error - The error object or value that was thrown or rejected.
+     * Whether to retain or log the outcome is the implementation's choice;
+     * values are passed by reference, so implementations must not mutate them.
+     *
+     * @param outcome - How the operation finished, and its value or error.
      * @return void
      */
-    error?(error: unknown): void;
+    end?(outcome: EventOutcome): void;
 }
 /**
- * The successful outcome of an operation, delivered to EventSpan.end.
- * Future fields (e.g. a correlation id) are added here rather than as
- * extra parameters.
+ * How an operation finished, delivered to EventSpan.end: `success` carries
+ * the value produced by the operation (the return or resolved value for
+ * method calls, the service instance for initialize, undefined for
+ * dispose); `failure` carries the error that was thrown or rejected.
  */
-export interface EventOutcome {
-    /**
-     * The value produced by the operation: the return value for synchronous
-     * methods, or the resolved value for methods returning a promise.
-     */
-    result: unknown;
-}
+export type EventOutcome = {
+    type: 'success';
+    value: unknown;
+} | {
+    type: 'failure';
+    error: unknown;
+};
 /**
  * Context of a service initialization, delivered to onInitialize.
  * Future fields are added here rather than as extra parameters.
@@ -75,10 +81,17 @@ export interface MethodCallContext {
      * The unique identifier of the service the method belongs to.
      */
     key: ServiceKey<unknown>;
+    /**
+     * The name of the class implementing the service (the instance's
+     * constructor name), which may differ from `key.name`. Undefined for
+     * services that are not instances of a named class, such as plain
+     * object literals.
+     */
+    className?: string;
     /**
      * The name of the method that is being called.
      */
-    methodName: string;
+    functionName: string;
     /**
      * The arguments the method was invoked with, passed by reference;
      * implementations must not mutate them.

package/dist/serviceEventListener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceEventListener.d.ts","sourceRoot":"","sources":["../src/serviceEventListener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAEnC;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;CAC7D"}
+{"version":3,"file":"serviceEventListener.d.ts","sourceRoot":"","sources":["../src/serviceEventListener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAExB;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;CAC7D"}

package/dist/serviceModule.d.ts

@@ -1,7 +1,7 @@
 import { ServiceKey } from './serviceKey';
 import { ServiceFactory } from './serviceFactory';
 import { ServiceScope } from './serviceScope';
-import type { ServiceEventListener } from './serviceEventListener';
+import type { ServiceModuleListener } from './serviceModuleListener';
 type GenericFactory = ServiceFactory<unknown, readonly ServiceKey<any>[]>;
 /**
  * ServiceModule is a container for service factories and manages dependency resolution.
@@ -65,7 +65,7 @@ export declare class ServiceModule {
      * @return A new ServiceModule containing the deduplicated factories.
      * @throws {ServiceModuleInitError} If circular or missing dependencies are detected during module creation.
      */
-    static from(entries: (ServiceModule | GenericFactory)[], listener?: ServiceEventListener): ServiceModule;
+    static from(entries: (ServiceModule | GenericFactory)[], listener?: ServiceModuleListener): ServiceModule;
 }
 export {};
 //# sourceMappingURL=serviceModule.d.ts.map

package/dist/serviceModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceModule.d.ts","sourceRoot":"","sources":["../src/serviceModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,KAAK,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAG1E;;;;;;;GAOG;AACH,qBAAa,aAAa;IAMJ,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE;IALxD;;;;OAIG;IACH,OAAO;IAOP;;;;;;OAMG;IACU,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA2BnD;;;;;OAKG;IACU,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAWhE;;;;;;;;;OASG;IACI,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY;IAQnC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,CAAC,aAAa,GAAG,cAAc,CAAC,EAAE,EAC3C,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,aAAa;CAsBjB"}
+{"version":3,"file":"serviceModule.d.ts","sourceRoot":"","sources":["../src/serviceModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,KAAK,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAG1E;;;;;;;GAOG;AACH,qBAAa,aAAa;IAMJ,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE;IALxD;;;;OAIG;IACH,OAAO;IAOP;;;;;;OAMG;IACU,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA2BnD;;;;;OAKG;IACU,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAWhE;;;;;;;;;OASG;IACI,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY;IAQnC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,CAAC,aAAa,GAAG,cAAc,CAAC,EAAE,EAC3C,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,aAAa;CAsBjB"}

package/dist/serviceModule.js

@@ -230,9 +230,9 @@ function isSuitable(key, factory) {
  * lifecycle events and method calls.
  *
  * For each of initialize, dispose, and method calls, the listener is invoked
- * at the start of the operation and may return an EventSpan whose `end` or
- * `error` is called when the operation finishes. Errors are rethrown after
- * being reported.
+ * at the start of the operation and may return an EventSpan whose `end` is
+ * called with the outcome when the operation finishes. Errors are rethrown
+ * after being reported.
  *
  * @param listener The listener notified of lifecycle and method call events.
  * @param delegate The original service factory to be instrumented.
@@ -250,25 +250,25 @@ function makeObservable(listener, delegate) {
             if (dispose) {
                 const span = (_a = listener.onDispose) === null || _a === void 0 ? void 0 : _a.call(listener, { key });
                 try {
-                    dispose();
+                    invokeWithin(span, dispose);
                 }
                 catch (error) {
-                    (_b = span === null || span === void 0 ? void 0 : span.error) === null || _b === void 0 ? void 0 : _b.call(span, error);
+                    (_b = span === null || span === void 0 ? void 0 : span.end) === null || _b === void 0 ? void 0 : _b.call(span, { type: 'failure', error });
                     throw error;
                 }
-                (_c = span === null || span === void 0 ? void 0 : span.end) === null || _c === void 0 ? void 0 : _c.call(span);
+                (_c = span === null || span === void 0 ? void 0 : span.end) === null || _c === void 0 ? void 0 : _c.call(span, { type: 'success', value: undefined });
             }
         },
         initialize: (...args) => __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const span = (_a = listener.onInitialize) === null || _a === void 0 ? void 0 : _a.call(listener, { key });
             try {
-                const instance = observeMethodCalls(yield delegate.initialize(...args), listener, key);
-                (_b = span === null || span === void 0 ? void 0 : span.end) === null || _b === void 0 ? void 0 : _b.call(span, { result: instance });
+                const instance = observeMethodCalls(yield invokeWithin(span, () => delegate.initialize(...args)), listener, key);
+                (_b = span === null || span === void 0 ? void 0 : span.end) === null || _b === void 0 ? void 0 : _b.call(span, { type: 'success', value: instance });
                 return instance;
             }
             catch (error) {
-                (_c = span === null || span === void 0 ? void 0 : span.error) === null || _c === void 0 ? void 0 : _c.call(span, error);
+                (_c = span === null || span === void 0 ? void 0 : span.end) === null || _c === void 0 ? void 0 : _c.call(span, { type: 'failure', error });
                 throw error;
             }
         }),
@@ -277,8 +277,8 @@ function makeObservable(listener, delegate) {
 /**
  * Wraps an object with a Proxy to notify the listener of method calls.
  *
- * Methods returning a promise report end/error when the promise settles,
- * not when the method returns.
+ * Methods returning a promise report their outcome when the promise
+ * settles, not when the method returns.
  *
  * @param thing The object whose method calls need to be observed.
  * @param listener The listener notified of method call events.
@@ -289,6 +289,7 @@ function observeMethodCalls(thing, listener, key) {
     if (typeof thing !== 'object' || thing === null) {
         return thing;
     }
+    const className = classNameOf(thing);
     return new Proxy(thing, {
         get(target, prop) {
             const value = Reflect.get(target, prop);
@@ -297,27 +298,28 @@ function observeMethodCalls(thing, listener, key) {
                     var _a, _b, _c;
                     const span = (_a = listener.onMethodCall) === null || _a === void 0 ? void 0 : _a.call(listener, {
                         key,
-                        methodName: prop,
+                        className,
+                        functionName: prop,
                         args,
                     });
                     try {
-                        const result = value.apply(target, args);
+                        const result = invokeWithin(span, () => value.apply(target, args));
                         if (result instanceof Promise) {
                             return result.then((resolved) => {
                                 var _a;
-                                (_a = span === null || span === void 0 ? void 0 : span.end) === null || _a === void 0 ? void 0 : _a.call(span, { result: resolved });
+                                (_a = span === null || span === void 0 ? void 0 : span.end) === null || _a === void 0 ? void 0 : _a.call(span, { type: 'success', value: resolved });
                                 return resolved;
                             }, (error) => {
                                 var _a;
-                                (_a = span === null || span === void 0 ? void 0 : span.error) === null || _a === void 0 ? void 0 : _a.call(span, error);
+                                (_a = span === null || span === void 0 ? void 0 : span.end) === null || _a === void 0 ? void 0 : _a.call(span, { type: 'failure', error });
                                 throw error;
                             });
                         }
-                        (_b = span === null || span === void 0 ? void 0 : span.end) === null || _b === void 0 ? void 0 : _b.call(span, { result });
+                        (_b = span === null || span === void 0 ? void 0 : span.end) === null || _b === void 0 ? void 0 : _b.call(span, { type: 'success', value: result });
                         return result;
                     }
                     catch (error) {
-                        (_c = span === null || span === void 0 ? void 0 : span.error) === null || _c === void 0 ? void 0 : _c.call(span, error);
+                        (_c = span === null || span === void 0 ? void 0 : span.end) === null || _c === void 0 ? void 0 : _c.call(span, { type: 'failure', error });
                         throw error;
                     }
                 };
@@ -326,4 +328,29 @@ function observeMethodCalls(thing, listener, key) {
         },
     });
 }
+/**
+ * Invokes an operation through the EventSpan's `run` wrapper when the
+ * listener provided one, so it can establish ambient state (tracing
+ * context) around the operation; invokes the operation directly otherwise.
+ *
+ * @param span The EventSpan returned by the listener, if any.
+ * @param fn The thunk performing the operation.
+ * @returns The value returned by `fn`.
+ */
+function invokeWithin(span, fn) {
+    return (span === null || span === void 0 ? void 0 : span.run) ? span.run(fn) : fn();
+}
+/**
+ * Resolves the class name of a service instance, or undefined for values
+ * that are not instances of a named class (plain object literals,
+ * null-prototype objects).
+ *
+ * @param thing The service instance to inspect.
+ * @returns The constructor name, or undefined when there is none to report.
+ */
+function classNameOf(thing) {
+    var _a;
+    const name = (_a = thing.constructor) === null || _a === void 0 ? void 0 : _a.name;
+    return name && name !== 'Object' ? name : undefined;
+}
 //# sourceMappingURL=serviceModule.js.map

package/dist/serviceModule.js.map

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

package/dist/serviceModuleListener.d.ts

@@ -0,0 +1,133 @@
+import type { ServiceKey } from './serviceKey';
+/**
+ * A handle representing a single in-flight operation (initialization,
+ * disposal, or method call), returned by a ServiceEventListener when the
+ * operation starts.
+ *
+ * `end` is invoked exactly once when the operation finishes, so
+ * implementations can close over per-call state (a start time, a span
+ * handle, a correlation id) without any bookkeeping to pair concurrent
+ * start/finish events.
+ */
+export interface EventSpan {
+    /**
+     * Optional wrapper around the operation itself. When present, the module
+     * invokes the operation as `run(() => operation())`, so the listener can
+     * establish ambient state that the operation body and its async
+     * continuations inherit — this is what lets spans of nested service
+     * calls form a parent-child hierarchy.
+     *
+     * Implementations must invoke `fn` exactly once, synchronously, and
+     * return its result unchanged (for async operations, the promise itself).
+     * `end` is still delivered separately when the operation finishes.
+     *
+     * @param fn - A thunk that performs the operation.
+     * @return The value returned by `fn`.
+     */
+    run?<T>(fn: () => T): T;
+    /**
+     * Invoked exactly once when the operation finishes, whether it succeeded
+     * or failed. For methods that return a promise, this fires when the
+     * promise settles, not when the method returns. On failure, the error is
+     * rethrown to the caller after this is invoked.
+     *
+     * Whether to retain or log the outcome is the implementation's choice;
+     * values are passed by reference, so implementations must not mutate them.
+     *
+     * @param outcome - How the operation finished, and its value or error.
+     * @return void
+     */
+    end?(outcome: EventOutcome): void;
+}
+/**
+ * How an operation finished, delivered to EventSpan.end: `success` carries
+ * the value produced by the operation (the return or resolved value for
+ * method calls, the service instance for initialize, undefined for
+ * dispose); `failure` carries the error that was thrown or rejected.
+ */
+export type EventOutcome = {
+    type: 'success';
+    value: unknown;
+} | {
+    type: 'failure';
+    error: unknown;
+};
+/**
+ * Context of a service initialization, delivered to onInitialize.
+ * Future fields are added here rather than as extra parameters.
+ */
+export interface InitializeContext {
+    /**
+     * The unique identifier of the service that is being initialized.
+     */
+    key: ServiceKey<unknown>;
+}
+/**
+ * Context of a service disposal, delivered to onDispose.
+ * Future fields are added here rather than as extra parameters.
+ */
+export interface DisposeContext {
+    /**
+     * The unique identifier of the service that is being disposed.
+     */
+    key: ServiceKey<unknown>;
+}
+/**
+ * Context of a method invocation, delivered to onMethodCall.
+ * Future fields are added here rather than as extra parameters.
+ */
+export interface MethodCallContext {
+    /**
+     * The unique identifier of the service the method belongs to.
+     */
+    key: ServiceKey<unknown>;
+    /**
+     * The name of the class implementing the service (the instance's
+     * constructor name), which may differ from `key.name`. Undefined for
+     * services that are not instances of a named class, such as plain
+     * object literals.
+     */
+    className?: string;
+    /**
+     * The name of the method that is being called.
+     */
+    functionName: string;
+    /**
+     * The arguments the method was invoked with, passed by reference;
+     * implementations must not mutate them.
+     */
+    args: readonly unknown[];
+}
+/**
+ * Interface for listening to service events. Implement this interface to
+ * observe lifecycle events and method calls of services in a module.
+ *
+ * Each method is invoked when the corresponding operation starts and may
+ * return an EventSpan that is notified when that operation finishes.
+ * Returning nothing opts out of completion tracking for that call.
+ */
+export interface ServiceModuleListener {
+    /**
+     * Invoked at the start of the initialization process for a specific service.
+     *
+     * @param context - Context of the initialization, including the service key.
+     * @return An EventSpan notified when initialization finishes, or void.
+     */
+    onInitialize?(context: InitializeContext): EventSpan | void;
+    /**
+     * Invoked when the disposal process for a service starts.
+     *
+     * @param context - Context of the disposal, including the service key.
+     * @return An EventSpan notified when disposal finishes, or void.
+     */
+    onDispose?(context: DisposeContext): EventSpan | void;
+    /**
+     * Invoked when a method call starts on a service instance.
+     *
+     * @param context - Context of the invocation, including the service key,
+     * the method name, and its arguments.
+     * @return An EventSpan notified when the call finishes, or void.
+     */
+    onMethodCall?(context: MethodCallContext): EventSpan | void;
+}
+//# sourceMappingURL=serviceModuleListener.d.ts.map

package/dist/serviceModuleListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceModuleListener.d.ts","sourceRoot":"","sources":["../src/serviceModuleListener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAExB;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;CAC7D"}

package/dist/serviceModuleListener.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=serviceModuleListener.js.map

package/dist/serviceModuleListener.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@composed-di/core",
   "private": false,
-  "version": "0.5.0-alpha",
+  "version": "0.5.2-alpha",
   "author": "Juan Herrera juanhr454@gmail.com",
   "type": "commonjs",
   "main": "./dist/index.js",

package/src/index.ts

@@ -3,6 +3,7 @@ export * from './serviceModule';
 export * from './serviceFactory';
 export * from './serviceScope';
 export * from './serviceSelector';
-export * from './serviceEventListener';
+export * from './serviceModuleListener';
+export * from './redactingEventListener';
 export * from './errors';
 export * from './utils';

package/src/redactingEventListener.ts

@@ -0,0 +1,132 @@
+import type {
+  DisposeContext,
+  EventOutcome,
+  EventSpan,
+  InitializeContext,
+  MethodCallContext,
+  ServiceModuleListener,
+} from './serviceModuleListener';
+import type { ServiceKey } from './serviceKey';
+
+/**
+ * The placeholder that replaces redacted values in event contexts and
+ * outcomes.
+ */
+export const REDACTED_VALUE = '[redacted]';
+
+/**
+ * Marks a service — or specific properties of it — as sensitive, so the
+ * values flowing through its events are replaced with {@link REDACTED_VALUE}.
+ */
+export interface RedactionRule<T> {
+  /**
+   * The service key whose values must be redacted. Matched by key
+   * identity, like everywhere else in the container.
+   */
+  key: ServiceKey<T>;
+
+  /**
+   * Property names to redact. Optional: when omitted, ALL properties of
+   * the service are redacted, along with its initialize result (the
+   * service instance itself may carry credentials or config).
+   */
+  properties?: Extract<keyof T, string>[];
+}
+
+export function redactionRule<T>(key: ServiceKey<T>, properties?: Extract<keyof T, string>[]): RedactionRule<T> {
+  return { key, properties };
+}
+
+/**
+ * A ServiceEventListener decorator that redacts sensitive values before
+ * they reach the wrapped listener. Works with any implementation via
+ * delegation: arguments in MethodCallContext and success values in
+ * EventOutcome are replaced with {@link REDACTED_VALUE}, so the delegate
+ * never sees the sensitive data — whatever it captures or exports is
+ * already scrubbed.
+ *
+ * Failure outcomes are passed through unchanged so error reporting keeps
+ * working; keep secrets out of error messages at the throwing site.
+ *
+ * @example
+ * ```ts
+ * const listener = new RedactingEventListener(
+ *   new OTELEventListener({ captureArguments: true, captureResults: true }),
+ *   [
+ *     { key: SecretClientKey }, // whole service is sensitive
+ *     { key: VaultKey, properties: ['getSecret'] }, // only these calls
+ *   ],
+ * );
+ * ```
+ */
+export class RedactingEventListener implements ServiceModuleListener {
+  constructor(
+    private readonly delegate: ServiceModuleListener,
+    private readonly rules: readonly RedactionRule<any>[],
+  ) {}
+
+  onInitialize(context: InitializeContext): EventSpan | void {
+    // The initialize result is the service instance itself, so it is
+    // redacted only when the whole service is sensitive — a rule without
+    // `properties`.
+    return redactSpan(
+      this.delegate.onInitialize?.(context),
+      this.isRedacted(context.key),
+    );
+  }
+
+  onDispose(context: DisposeContext): EventSpan | void {
+    // Dispose carries no arguments and no result value; nothing to redact.
+    return this.delegate.onDispose?.(context);
+  }
+
+  onMethodCall(context: MethodCallContext): EventSpan | void {
+    const redacted = this.isRedacted(context.key, context.functionName);
+    const span = this.delegate.onMethodCall?.(
+      redacted
+        ? // Replace each argument rather than the whole array, so the
+          // delegate still sees the call's arity.
+          { ...context, args: context.args.map(() => REDACTED_VALUE) }
+        : context,
+    );
+    return redactSpan(span, redacted);
+  }
+
+  // 1. Si expiro el dbr `EXPIRED` el cron debe mandar a `FACE_MISMATCH`?
+  // 2. Si hubo un matchLevel intermediario el cron debe mandar a `FACE_MISMATCH`? (Probablemente no)
+  private isRedacted(key: ServiceKey<any>, propertyName?: string): boolean {
+    return this.rules.some(
+      (rule) =>
+        rule.key === key &&
+        // A rule without `properties` redacts everything on the key,
+        // including initialize — where no property name is passed —
+        // while a rule with `properties` matches only those calls.
+        (rule.properties === undefined ||
+          (propertyName !== undefined &&
+            rule.properties?.includes(propertyName))),
+    );
+  }
+}
+
+/**
+ * Wraps the delegate's EventSpan so success values are redacted before
+ * `end` sees them. `run` (and any future fields) pass through untouched.
+ */
+function redactSpan(
+  span: EventSpan | void,
+  redacted: boolean,
+): EventSpan | void {
+  if (!redacted || !span?.end) {
+    return span;
+  }
+  const end = span.end.bind(span);
+  return {
+    ...span,
+    end: (outcome: EventOutcome) =>
+      end(
+        outcome.type === 'success'
+          ? { type: 'success', value: REDACTED_VALUE }
+          : outcome,
+      ),
+  };
+}

package/src/serviceModule.ts

@@ -3,7 +3,10 @@ import { ServiceFactory } from './serviceFactory';
 import { ServiceScope } from './serviceScope';
 import { ServiceSelector } from './serviceSelector';
 import { ServiceFactoryNotFoundError, ServiceModuleInitError } from './errors';
-import type { ServiceEventListener } from './serviceEventListener';
+import type {
+  EventSpan,
+  ServiceModuleListener,
+} from './serviceModuleListener';
 
 type GenericFactory = ServiceFactory<unknown, readonly ServiceKey<any>[]>;
 type GenericKey = ServiceKey<any>;
@@ -120,7 +123,7 @@ export class ServiceModule {
    */
   static from(
     entries: (ServiceModule | GenericFactory)[],
-    listener?: ServiceEventListener,
+    listener?: ServiceModuleListener,
   ): ServiceModule {
     // Flatten entries and keep only the last factory for each ServiceKey
     const flattened = entries.flatMap((e) =>
@@ -265,16 +268,16 @@ function isSuitable<T, D extends readonly ServiceKey<any>[]>(
  * lifecycle events and method calls.
  *
  * For each of initialize, dispose, and method calls, the listener is invoked
- * at the start of the operation and may return an EventSpan whose `end` or
- * `error` is called when the operation finishes. Errors are rethrown after
- * being reported.
+ * at the start of the operation and may return an EventSpan whose `end` is
+ * called with the outcome when the operation finishes. Errors are rethrown
+ * after being reported.
  *
  * @param listener The listener notified of lifecycle and method call events.
  * @param delegate The original service factory to be instrumented.
  * @return A new service factory that provides the same dependencies but includes event notification logic.
  */
 function makeObservable<T, D extends readonly ServiceKey<any>[]>(
-  listener: ServiceEventListener,
+  listener: ServiceModuleListener,
   delegate: ServiceFactory<any, D>,
 ): ServiceFactory<T, D> {
   const key = delegate.provides;
@@ -288,26 +291,26 @@ function makeObservable<T, D extends readonly ServiceKey<any>[]>(
       if (dispose) {
         const span = listener.onDispose?.({ key });
         try {
-          dispose();
+          invokeWithin(span, dispose);
         } catch (error) {
-          span?.error?.(error);
+          span?.end?.({ type: 'failure', error });
           throw error;
         }
-        span?.end?.();
+        span?.end?.({ type: 'success', value: undefined });
       }
     },
     initialize: async (...args) => {
       const span = listener.onInitialize?.({ key });
       try {
         const instance = observeMethodCalls(
-          await delegate.initialize(...args),
+          await invokeWithin(span, () => delegate.initialize(...args)),
           listener,
           key,
         );
-        span?.end?.({ result: instance });
+        span?.end?.({ type: 'success', value: instance });
         return instance;
       } catch (error) {
-        span?.error?.(error);
+        span?.end?.({ type: 'failure', error });
         throw error;
       }
     },
@@ -317,8 +320,8 @@ function makeObservable<T, D extends readonly ServiceKey<any>[]>(
 /**
  * Wraps an object with a Proxy to notify the listener of method calls.
  *
- * Methods returning a promise report end/error when the promise settles,
- * not when the method returns.
+ * Methods returning a promise report their outcome when the promise
+ * settles, not when the method returns.
  *
  * @param thing The object whose method calls need to be observed.
  * @param listener The listener notified of method call events.
@@ -327,13 +330,15 @@ function makeObservable<T, D extends readonly ServiceKey<any>[]>(
  */
 function observeMethodCalls(
   thing: any,
-  listener: ServiceEventListener,
+  listener: ServiceModuleListener,
   key: ServiceKey<unknown>,
 ): any {
   if (typeof thing !== 'object' || thing === null) {
     return thing;
   }
 
+  const className = classNameOf(thing);
+
   return new Proxy(thing, {
     get(target, prop) {
       const value = Reflect.get(target, prop);
@@ -341,27 +346,28 @@ function observeMethodCalls(
         return (...args: unknown[]) => {
           const span = listener.onMethodCall?.({
             key,
-            methodName: prop,
+            className,
+            functionName: prop,
             args,
           });
           try {
-            const result = value.apply(target, args);
+            const result = invokeWithin(span, () => value.apply(target, args));
             if (result instanceof Promise) {
               return result.then(
                 (resolved) => {
-                  span?.end?.({ result: resolved });
+                  span?.end?.({ type: 'success', value: resolved });
                   return resolved;
                 },
                 (error) => {
-                  span?.error?.(error);
+                  span?.end?.({ type: 'failure', error });
                   throw error;
                 },
               );
             }
-            span?.end?.({ result });
+            span?.end?.({ type: 'success', value: result });
             return result;
           } catch (error) {
-            span?.error?.(error);
+            span?.end?.({ type: 'failure', error });
             throw error;
           }
         };
@@ -370,3 +376,29 @@ function observeMethodCalls(
     },
   });
 }
+
+/**
+ * Invokes an operation through the EventSpan's `run` wrapper when the
+ * listener provided one, so it can establish ambient state (tracing
+ * context) around the operation; invokes the operation directly otherwise.
+ *
+ * @param span The EventSpan returned by the listener, if any.
+ * @param fn The thunk performing the operation.
+ * @returns The value returned by `fn`.
+ */
+function invokeWithin<T>(span: EventSpan | void, fn: () => T): T {
+  return span?.run ? span.run(fn) : fn();
+}
+
+/**
+ * Resolves the class name of a service instance, or undefined for values
+ * that are not instances of a named class (plain object literals,
+ * null-prototype objects).
+ *
+ * @param thing The service instance to inspect.
+ * @returns The constructor name, or undefined when there is none to report.
+ */
+function classNameOf(thing: object): string | undefined {
+  const name = thing.constructor?.name;
+  return name && name !== 'Object' ? name : undefined;
+}

package/src/{serviceEventListener.ts → serviceModuleListener.ts}

@@ -5,50 +5,51 @@ import type { ServiceKey } from './serviceKey';
  * disposal, or method call), returned by a ServiceEventListener when the
  * operation starts.
  *
- * Exactly one of `end` or `error` is invoked when the operation finishes,
- * so implementations can close over per-call state (start time, an
- * OpenTelemetry span, a correlation id) without any bookkeeping to pair
- * concurrent start/finish events.
+ * `end` is invoked exactly once when the operation finishes, so
+ * implementations can close over per-call state (a start time, a span
+ * handle, a correlation id) without any bookkeeping to pair concurrent
+ * start/finish events.
  */
 export interface EventSpan {
   /**
-   * Invoked when the operation completes successfully. For methods that
-   * return a promise, this fires when the promise resolves, not when the
-   * method returns.
+   * Optional wrapper around the operation itself. When present, the module
+   * invokes the operation as `run(() => operation())`, so the listener can
+   * establish ambient state that the operation body and its async
+   * continuations inherit — this is what lets spans of nested service
+   * calls form a parent-child hierarchy.
    *
-   * Whether to retain or log the outcome is the implementation's choice;
-   * the value is passed by reference, so implementations must not mutate it.
+   * Implementations must invoke `fn` exactly once, synchronously, and
+   * return its result unchanged (for async operations, the promise itself).
+   * `end` is still delivered separately when the operation finishes.
    *
-   * @param outcome - The outcome of the operation. Present for method call
-   * spans (the return or resolved value) and initialize spans (the service
-   * instance), absent for dispose spans.
-   * @return void
+   * @param fn - A thunk that performs the operation.
+   * @return The value returned by `fn`.
    */
-  end?(outcome?: EventOutcome): void;
+  run?<T>(fn: () => T): T;
 
   /**
-   * Invoked when the operation throws or rejects. Terminal like `end`;
-   * the two are mutually exclusive. The error is rethrown to the caller
-   * after this is invoked.
+   * Invoked exactly once when the operation finishes, whether it succeeded
+   * or failed. For methods that return a promise, this fires when the
+   * promise settles, not when the method returns. On failure, the error is
+   * rethrown to the caller after this is invoked.
    *
-   * @param error - The error object or value that was thrown or rejected.
+   * Whether to retain or log the outcome is the implementation's choice;
+   * values are passed by reference, so implementations must not mutate them.
+   *
+   * @param outcome - How the operation finished, and its value or error.
    * @return void
    */
-  error?(error: unknown): void;
+  end?(outcome: EventOutcome): void;
 }
 
 /**
- * The successful outcome of an operation, delivered to EventSpan.end.
- * Future fields (e.g. a correlation id) are added here rather than as
- * extra parameters.
+ * How an operation finished, delivered to EventSpan.end: `success` carries
+ * the value produced by the operation (the return or resolved value for
+ * method calls, the service instance for initialize, undefined for
+ * dispose); `failure` carries the error that was thrown or rejected.
  */
-export interface EventOutcome {
-  /**
-   * The value produced by the operation: the return value for synchronous
-   * methods, or the resolved value for methods returning a promise.
-   */
-  result: unknown;
-}
+export type EventOutcome =
+  { type: 'success'; value: unknown } | { type: 'failure'; error: unknown };
 
 /**
  * Context of a service initialization, delivered to onInitialize.
@@ -82,10 +83,18 @@ export interface MethodCallContext {
    */
   key: ServiceKey<unknown>;
 
+  /**
+   * The name of the class implementing the service (the instance's
+   * constructor name), which may differ from `key.name`. Undefined for
+   * services that are not instances of a named class, such as plain
+   * object literals.
+   */
+  className?: string;
+
   /**
    * The name of the method that is being called.
    */
-  methodName: string;
+  functionName: string;
 
   /**
    * The arguments the method was invoked with, passed by reference;
@@ -102,7 +111,7 @@ export interface MethodCallContext {
  * return an EventSpan that is notified when that operation finishes.
  * Returning nothing opts out of completion tracking for that call.
  */
-export interface ServiceEventListener {
+export interface ServiceModuleListener {
   /**
    * Invoked at the start of the initialization process for a specific service.
    *