@composed-di/core 0.5.3-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,119 +0,0 @@
-import type { DisposeContext, EventSpan, InitializeContext, MethodCallContext, ServiceModuleListener } from './serviceModuleListener';
-import type { ServiceKey } from './serviceKey';
-/**
- * The placeholder that replaces a redacted value when no custom
- * transform is given for it.
- */
-export declare const REDACTED_VALUE = "[REDACTED]";
-/**
- * Custom masking for one included property, narrowed to the exact
- * method named when {@link RedactionRuleBuilder.redact} is called.
- * Omitting a side fully blanks it with {@link REDACTED_VALUE}; providing
- * one lets you report a partial mask instead (e.g. the last 4 digits of
- * a card number) — both always return a `string`, the masked
- * representation to report in place of the real value.
- */
-export type Mask<T, K extends Extract<keyof T, string>> = T[K] extends (...args: infer A) => infer R ? {
-    maskArgs?: (...args: A) => string;
-    maskResult?: (result: R) => string;
-} : never;
-/**
- * Marks a service — or specific properties of it — as sensitive, so the
- * values flowing through its events are redacted. Returned by
- * {@link RedactionRuleBuilder.build}, which is the only way to construct
- * one — the `redactAll`/per-property merge logic lives entirely inside
- * `maskArgs`/`maskResult`, so callers never need to know how a rule
- * reached its decision, only what to do with it.
- */
-export interface RedactionRule<T> {
-    readonly key: ServiceKey<T>;
-    /**
-     * The args to report for a call to `functionName`: unchanged if not
-     * redacted, otherwise blanked or run through a custom `maskArgs`.
-     */
-    maskArgs(functionName: string, args: readonly unknown[]): readonly unknown[];
-    /**
-     * The value to report for a success outcome: unchanged if not
-     * redacted, otherwise blanked or run through a custom `maskResult`.
-     * Omit `functionName` to ask about the initialize result (the service
-     * instance itself), which only the rule's `redactAll` default touches.
-     */
-    maskResult(functionName: string | undefined, result: unknown): unknown;
-}
-/**
- * Fluent, single-key rule builder returned by {@link redactionRule}.
- * `redactAll`, `redact`, and `exclude` all merge into the same rule —
- * call them in any combination, in any order; the more specific
- * per-property calls (`redact`/`exclude`) always win over the blanket
- * `redactAll` default for the properties they name.
- *
- * @example
- * ```ts
- * const rules = [
- *   redactionRule(SecretClientKey)
- *     .redactAll()
- *     .build(), // whole service is sensitive
- *   redactionRule(BillingKey)
- *     .redactAll()
- *     .redact('chargeCard', { maskResult: (card) => `card ending in ${card.number.slice(-4)}` })
- *     .exclude('ping') // redact everything except this, with one custom mask
- *     .build(),
- *   redactionRule(VaultKey)
- *     .redact('getSecret')
- *     .build(), // only this call, nothing else
- * ];
- * ```
- */
-export declare class RedactionRuleBuilder<T> {
-    private readonly key;
-    private redactAllFlag;
-    private readonly overrides;
-    constructor(key: ServiceKey<T>);
-    /** Redacts every property, plus the initialize result, by default. */
-    redactAll(): this;
-    /**
-     * Marks one property (method) as redacted, with optional custom
-     * masking. Call repeatedly for several properties. Overrides
-     * `redactAll`/`exclude` for this specific property.
-     */
-    redact<K extends Extract<keyof T, string>>(name: K, mask?: Mask<T, K>): this;
-    /**
-     * Marks one or more properties as explicitly NOT redacted, overriding
-     * `redactAll` for just these.
-     */
-    exclude(...names: Extract<keyof T, string>[]): this;
-    build(): RedactionRule<any>;
-}
-export declare function redactionRule<T>(key: ServiceKey<T>): RedactionRuleBuilder<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 (wholesale, or via a custom transform)
- * before the delegate ever sees them — 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 }),
- *   [
- *     redactionRule(SecretClientKey).redactAll().build(), // whole service is sensitive
- *     redactionRule(VaultKey).redact('getSecret').build(), // only this call
- *     redactionRule(HealthKey).redactAll().exclude('ping').build(), // everything but this call
- *   ],
- * );
- * ```
- */
-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;
-}
-//# 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;;;;;;;GAOG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CACrE,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,MAAM,CAAC,GACR;IACE,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;CACpC,GACD,KAAK,CAAC;AAeV;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,OAAO,EAAE,CAAC;IAE7E;;;;;OAKG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CACxE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAoB,CAAC,CAAC;IAIrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;gBAErC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IAE/C,sEAAsE;IACtE,SAAS,IAAI,IAAI;IAKjB;;;;OAIG;IACH,MAAM,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAK5E;;;OAGG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI;IAOnD,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC;CAwC5B;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAE5E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;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;IAK1D,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAKpD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI;CAY3D"}

package/dist/redactingEventListener.js

@@ -1,169 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedactingEventListener = exports.RedactionRuleBuilder = exports.REDACTED_VALUE = void 0;
-exports.redactionRule = redactionRule;
-/**
- * The placeholder that replaces a redacted value when no custom
- * transform is given for it.
- */
-exports.REDACTED_VALUE = '[REDACTED]';
-/**
- * Fluent, single-key rule builder returned by {@link redactionRule}.
- * `redactAll`, `redact`, and `exclude` all merge into the same rule —
- * call them in any combination, in any order; the more specific
- * per-property calls (`redact`/`exclude`) always win over the blanket
- * `redactAll` default for the properties they name.
- *
- * @example
- * ```ts
- * const rules = [
- *   redactionRule(SecretClientKey)
- *     .redactAll()
- *     .build(), // whole service is sensitive
- *   redactionRule(BillingKey)
- *     .redactAll()
- *     .redact('chargeCard', { maskResult: (card) => `card ending in ${card.number.slice(-4)}` })
- *     .exclude('ping') // redact everything except this, with one custom mask
- *     .build(),
- *   redactionRule(VaultKey)
- *     .redact('getSecret')
- *     .build(), // only this call, nothing else
- * ];
- * ```
- */
-class RedactionRuleBuilder {
-    constructor(key) {
-        this.key = key;
-        this.redactAllFlag = false;
-        this.overrides = {};
-    }
-    /** Redacts every property, plus the initialize result, by default. */
-    redactAll() {
-        this.redactAllFlag = true;
-        return this;
-    }
-    /**
-     * Marks one property (method) as redacted, with optional custom
-     * masking. Call repeatedly for several properties. Overrides
-     * `redactAll`/`exclude` for this specific property.
-     */
-    redact(name, mask) {
-        this.overrides[name] = Object.assign({ redacted: true }, mask);
-        return this;
-    }
-    /**
-     * Marks one or more properties as explicitly NOT redacted, overriding
-     * `redactAll` for just these.
-     */
-    exclude(...names) {
-        for (const name of names) {
-            this.overrides[name] = { redacted: false };
-        }
-        return this;
-    }
-    build() {
-        if (!this.redactAllFlag && Object.keys(this.overrides).length === 0) {
-            throw new Error(`redactionRule(${this.key.name}) has no effect: call .redactAll() and/or .redact(...) ` +
-                'before .build(), otherwise this rule never redacts anything.');
-        }
-        const redactAllFlag = this.redactAllFlag;
-        const overrides = this.overrides;
-        return {
-            key: this.key,
-            maskArgs(functionName, args) {
-                const override = overrides[functionName];
-                const redacted = override ? override.redacted : redactAllFlag;
-                if (!redacted) {
-                    return args;
-                }
-                return (override === null || override === void 0 ? void 0 : override.maskArgs)
-                    ? // A custom mask reports one string for the whole call,
-                        // rather than a value per argument.
-                        [override.maskArgs(...args)]
-                    : // Replace each argument rather than the whole array, so the
-                        // delegate still sees the call's arity.
-                        args.map(() => exports.REDACTED_VALUE);
-            },
-            maskResult(functionName, result) {
-                const override = functionName === undefined ? undefined : overrides[functionName];
-                const redacted = override ? override.redacted : redactAllFlag;
-                if (!redacted) {
-                    return result;
-                }
-                return (override === null || override === void 0 ? void 0 : override.maskResult)
-                    ? override.maskResult(result)
-                    : exports.REDACTED_VALUE;
-            },
-        };
-    }
-}
-exports.RedactionRuleBuilder = RedactionRuleBuilder;
-function redactionRule(key) {
-    return new RedactionRuleBuilder(key);
-}
-/**
- * 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 (wholesale, or via a custom transform)
- * before the delegate ever sees them — 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 }),
- *   [
- *     redactionRule(SecretClientKey).redactAll().build(), // whole service is sensitive
- *     redactionRule(VaultKey).redact('getSecret').build(), // only this call
- *     redactionRule(HealthKey).redactAll().exclude('ping').build(), // everything but this call
- *   ],
- * );
- * ```
- */
-class RedactingEventListener {
-    constructor(delegate, rules) {
-        this.delegate = delegate;
-        this.rules = rules;
-    }
-    onInitialize(context) {
-        var _a, _b;
-        const rule = this.rules.find((r) => r.key === context.key);
-        return redactSpan((_b = (_a = this.delegate).onInitialize) === null || _b === void 0 ? void 0 : _b.call(_a, context), rule);
-    }
-    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 rule = this.rules.find((r) => r.key === context.key);
-        const span = (_b = (_a = this.delegate).onMethodCall) === null || _b === void 0 ? void 0 : _b.call(_a, rule
-            ? Object.assign(Object.assign({}, context), { args: rule.maskArgs(context.functionName, context.args) }) : context);
-        return redactSpan(span, rule, context.functionName);
-    }
-}
-exports.RedactingEventListener = RedactingEventListener;
-/**
- * Wraps the delegate's EventSpan so success values are redacted before
- * `end` sees them, by delegating to the rule's `maskResult`. `run` (and
- * any future fields) pass through untouched. `functionName` is omitted
- * for the initialize result (the instance itself).
- */
-function redactSpan(span, rule, functionName) {
-    if (!rule || !(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: rule.maskResult(functionName, outcome.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":"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"}