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

package/src/utils.ts

@@ -1,38 +1,38 @@
-import { ServiceModule } from './serviceModule';
-import { ServiceKey } from './serviceKey';
+import { ServiceModule } from './serviceModule'
+import { ServiceKey } from './serviceKey'
 
 export interface DotGraphOptions {
   /** Graph direction: 'TB' (top-bottom), 'LR' (left-right), 'BT' (bottom-top), 'RL' (right-left) */
-  direction?: 'TB' | 'LR' | 'BT' | 'RL';
+  direction?: 'TB' | 'LR' | 'BT' | 'RL'
   /** Title for the graph */
-  title?: string;
+  title?: string
   /** Show nodes with no dependencies in a different color */
-  highlightLeaves?: boolean;
+  highlightLeaves?: boolean
   /** Show nodes with no dependents in a different color */
-  highlightRoots?: boolean;
+  highlightRoots?: boolean
 }
 
 export interface MermaidGraphOptions {
   /** Graph direction: 'TB' (top-bottom), 'LR' (left-right), 'BT' (bottom-top), 'RL' (right-left) */
-  direction?: 'TB' | 'LR' | 'BT' | 'RL';
+  direction?: 'TB' | 'LR' | 'BT' | 'RL'
   /** Show nodes with no dependencies in a different color */
-  highlightLeaves?: boolean;
+  highlightLeaves?: boolean
   /** Show nodes with no dependents in a different color */
-  highlightRoots?: boolean;
+  highlightRoots?: boolean
 }
 
 /**
  * Escapes special characters in strings for DOT notation
  */
 function escapeDotString(str: string): string {
-  return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+  return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')
 }
 
 /**
  * Escapes special characters in strings for Mermaid notation
  */
 function escapeMermaidString(str: string): string {
-  return str.replace(/"/g, '#quot;');
+  return str.replace(/"/g, '#quot;')
 }
 
 /**
@@ -56,98 +56,98 @@ export function createDotGraph(
     highlightRoots: true,
   },
 ): string {
-  const factories = module.factories;
-  const lines: string[] = [];
+  const factories = module.factories
+  const lines: string[] = []
 
   // Start the digraph
-  lines.push('digraph ServiceDependencies {');
-  lines.push(`  label="${title}";`);
-  lines.push('  labelloc="t";');
-  lines.push('  fontsize=16;');
-  lines.push(`  rankdir=${direction};`);
-  lines.push('');
+  lines.push('digraph ServiceDependencies {')
+  lines.push(`  label="${title}";`)
+  lines.push('  labelloc="t";')
+  lines.push('  fontsize=16;')
+  lines.push(`  rankdir=${direction};`)
+  lines.push('')
 
   // Default node styling
-  lines.push('  node [');
-  lines.push('    shape=box,');
-  lines.push('    style="rounded,filled",');
-  lines.push('    fillcolor="#e1f5ff",');
-  lines.push('    color="#0288d1",');
-  lines.push('    fontname="Arial",');
-  lines.push('    fontsize=12');
-  lines.push('  ];');
-  lines.push('');
+  lines.push('  node [')
+  lines.push('    shape=box,')
+  lines.push('    style="rounded,filled",')
+  lines.push('    fillcolor="#e1f5ff",')
+  lines.push('    color="#0288d1",')
+  lines.push('    fontname="Arial",')
+  lines.push('    fontsize=12')
+  lines.push('  ];')
+  lines.push('')
 
   // Default edge styling
-  lines.push('  edge [');
-  lines.push('    color="#666666",');
-  lines.push('    arrowsize=0.8');
-  lines.push('  ];');
-  lines.push('');
+  lines.push('  edge [')
+  lines.push('    color="#666666",')
+  lines.push('    arrowsize=0.8')
+  lines.push('  ];')
+  lines.push('')
 
   // Build dependency maps to identify leaves and roots
-  const hasDependencies = new Set<string>();
-  const hasDependents = new Set<string>();
+  const hasDependencies = new Set<string>()
+  const hasDependents = new Set<string>()
 
   factories.forEach((factory) => {
-    const serviceName = factory.provides.name;
+    const serviceName = factory.provides.name
 
     if (factory.dependsOn.length > 0) {
-      hasDependencies.add(serviceName);
+      hasDependencies.add(serviceName)
     }
 
     factory.dependsOn.forEach((dependency: ServiceKey<unknown>) => {
-      hasDependents.add(dependency.name);
-    });
-  });
+      hasDependents.add(dependency.name)
+    })
+  })
 
   // Define nodes with special styling for leaves and roots
-  const nodeIds = new Map<string, string>();
-  let nodeCounter = 0;
+  const nodeIds = new Map<string, string>()
+  let nodeCounter = 0
 
   factories.forEach((factory) => {
-    const serviceName = factory.provides.name;
-    const nodeId = `node${nodeCounter++}`;
-    nodeIds.set(serviceName, nodeId);
+    const serviceName = factory.provides.name
+    const nodeId = `node${nodeCounter++}`
+    nodeIds.set(serviceName, nodeId)
 
-    const isLeaf = !hasDependencies.has(serviceName);
-    const isRoot = !hasDependents.has(serviceName);
+    const isLeaf = !hasDependencies.has(serviceName)
+    const isRoot = !hasDependents.has(serviceName)
 
-    let nodeStyle = '';
+    let nodeStyle = ''
 
     if (highlightLeaves && isLeaf) {
-      nodeStyle = ' [fillcolor="#c8e6c9", color="#388e3c"]';
+      nodeStyle = ' [fillcolor="#c8e6c9", color="#388e3c"]'
     } else if (highlightRoots && isRoot) {
-      nodeStyle = ' [fillcolor="#ffccbc", color="#d84315"]';
+      nodeStyle = ' [fillcolor="#ffccbc", color="#d84315"]'
     }
 
     lines.push(
       `  ${nodeId} [label="${escapeDotString(serviceName)}"]${nodeStyle};`,
-    );
-  });
+    )
+  })
 
-  lines.push('');
+  lines.push('')
 
   // Define edges (dependencies)
   factories.forEach((factory) => {
-    const serviceName = factory.provides.name;
-    const serviceNodeId = nodeIds.get(serviceName)!;
+    const serviceName = factory.provides.name
+    const serviceNodeId = nodeIds.get(serviceName)!
 
     factory.dependsOn.forEach((dependency: ServiceKey<unknown>) => {
-      const depName = dependency.name;
-      const depNodeId = nodeIds.get(depName);
+      const depName = dependency.name
+      const depNodeId = nodeIds.get(depName)
 
       if (depNodeId) {
         // Arrow points from dependent to dependency (what needs it -> what provides it)
-        lines.push(`  ${serviceNodeId} -> ${depNodeId};`);
+        lines.push(`  ${serviceNodeId} -> ${depNodeId};`)
       }
-    });
-  });
+    })
+  })
 
   // Close the digraph
-  lines.push('}');
+  lines.push('}')
 
-  return lines.join('\n');
+  return lines.join('\n')
 }
 
 /**
@@ -161,9 +161,9 @@ export function printDotGraph(
   module: ServiceModule,
   options?: DotGraphOptions,
 ): void {
-  console.log(createDotGraph(module, options));
-  console.log('\n\nCopy the DOT output above and paste it into:');
-  console.log('https://dreampuf.github.io/GraphvizOnline/');
+  console.log(createDotGraph(module, options))
+  console.log('\n\nCopy the DOT output above and paste it into:')
+  console.log('https://dreampuf.github.io/GraphvizOnline/')
 }
 
 /**
@@ -185,79 +185,79 @@ export function createMermaidGraph(
     highlightRoots: true,
   },
 ): string {
-  const factories = module.factories;
-  const lines: string[] = [];
+  const factories = module.factories
+  const lines: string[] = []
 
   // Start the flowchart
-  lines.push(`flowchart ${direction}`);
+  lines.push(`flowchart ${direction}`)
 
   // Build dependency maps to identify leaves and roots
-  const hasDependencies = new Set<string>();
-  const hasDependents = new Set<string>();
+  const hasDependencies = new Set<string>()
+  const hasDependents = new Set<string>()
 
   factories.forEach((factory) => {
-    const serviceName = factory.provides.name;
+    const serviceName = factory.provides.name
 
     if (factory.dependsOn.length > 0) {
-      hasDependencies.add(serviceName);
+      hasDependencies.add(serviceName)
     }
 
     factory.dependsOn.forEach((dependency) => {
-      hasDependents.add(dependency.name);
-    });
-  });
+      hasDependents.add(dependency.name)
+    })
+  })
 
   // Define nodes with special styling for leaves and roots
-  const nodeIds = new Map<string, string>();
-  let nodeCounter = 0;
+  const nodeIds = new Map<string, string>()
+  let nodeCounter = 0
 
   factories.forEach((factory) => {
-    const serviceName = factory.provides.name;
-    const nodeId = `node${nodeCounter++}`;
-    nodeIds.set(serviceName, nodeId);
+    const serviceName = factory.provides.name
+    const nodeId = `node${nodeCounter++}`
+    nodeIds.set(serviceName, nodeId)
 
-    lines.push(`  ${nodeId}["${escapeMermaidString(serviceName)}"]`);
-  });
+    lines.push(`  ${nodeId}["${escapeMermaidString(serviceName)}"]`)
+  })
 
-  lines.push('');
+  lines.push('')
 
   // Define edges (dependencies)
   factories.forEach((factory) => {
-    const serviceName = factory.provides.name;
-    const serviceNodeId = nodeIds.get(serviceName)!;
+    const serviceName = factory.provides.name
+    const serviceNodeId = nodeIds.get(serviceName)!
 
     factory.dependsOn.forEach((dependency) => {
-      const depName = dependency.name;
-      const depNodeId = nodeIds.get(depName);
+      const depName = dependency.name
+      const depNodeId = nodeIds.get(depName)
 
       if (depNodeId) {
         // Arrow points from dependent to dependency (what needs it -> what provides it)
-        lines.push(`  ${serviceNodeId} --> ${depNodeId}`);
+        lines.push(`  ${serviceNodeId} --> ${depNodeId}`)
       }
-    });
-  });
+    })
+  })
 
-  lines.push('');
+  lines.push('')
 
   // Apply styling
   factories.forEach((factory) => {
-    const serviceName = factory.provides.name;
-    const serviceNodeId = nodeIds.get(serviceName)!;
+    const serviceName = factory.provides.name
+    const serviceNodeId = nodeIds.get(serviceName)!
 
-    const isLeaf = !hasDependencies.has(serviceName);
-    const isRoot = !hasDependents.has(serviceName);
+    const isLeaf = !hasDependencies.has(serviceName)
+    const isRoot = !hasDependents.has(serviceName)
 
     if (highlightLeaves && isLeaf) {
-      lines.push(`  style ${serviceNodeId} fill:#c8e6c9,stroke:#388e3c`);
+      lines.push(`  style ${serviceNodeId} fill:#c8e6c9,stroke:#388e3c`)
     } else if (highlightRoots && isRoot) {
-      lines.push(`  style ${serviceNodeId} fill:#ffccbc,stroke:#d84315`);
+      lines.push(`  style ${serviceNodeId} fill:#ffccbc,stroke:#d84315`)
     } else {
       // Default style
-      lines.push(`  style ${serviceNodeId} fill:#e1f5ff,stroke:#0288d1`);
+      lines.push(`  style ${serviceNodeId} fill:#e1f5ff,stroke:#0288d1`)
     }
-  });
+  })
 
-  return lines.join('\n');
+  return lines.join('\n')
 }
 
 /**
@@ -271,7 +271,7 @@ export function printMermaidGraph(
   module: ServiceModule,
   options?: MermaidGraphOptions,
 ): void {
-  console.log(createMermaidGraph(module, options));
-  console.log('\n\nCopy the Mermaid output above and paste it into:');
-  console.log('https://mermaid.live/');
+  console.log(createMermaidGraph(module, options))
+  console.log('\n\nCopy the Mermaid output above and paste it into:')
+  console.log('https://mermaid.live/')
 }

package/dist/redactingEventListener.d.ts

@@ -1,57 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,89 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,133 +0,0 @@
-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 ServiceEventListener {
-    /**
-     * 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=serviceEventListener.d.ts.map

package/dist/serviceEventListener.d.ts.map

@@ -1 +0,0 @@
-{"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/serviceEventListener.js

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

package/dist/serviceEventListener.js.map

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