apcore-js 0.18.0 → 0.20.0

package/dist/sys-modules/registration.js

@@ -1,11 +1,14 @@
 /**
  * Auto-registration of sys.* modules and middleware from config.
  */
+import * as fs from 'node:fs';
+import * as yaml from 'js-yaml';
+import { SysModuleRegistrationError } from '../errors.js';
 import { ErrorHistory } from '../observability/error-history.js';
 import { ErrorHistoryMiddleware } from '../middleware/error-history.js';
 import { UsageCollector, UsageMiddleware } from '../observability/usage.js';
-import { EventEmitter, createEvent } from '../events/emitter.js';
-import { WebhookSubscriber, A2ASubscriber } from '../events/subscribers.js';
+import { EventEmitter, emitWithLegacy } from '../events/emitter.js';
+import { WebhookSubscriber, A2ASubscriber, FileSubscriber, StdoutSubscriber, FilterSubscriber } from '../events/subscribers.js';
 import { PlatformNotifyMiddleware } from '../middleware/platform-notify.js';
 import { HealthSummaryModule, HealthModule } from './health.js';
 import { ManifestFullModule, ManifestModule } from './manifest.js';
@@ -56,22 +59,70 @@ function _registerBuiltInFactories() {
         const timeoutMs = config['timeout_ms'];
         return new A2ASubscriber(platformUrl, auth, timeoutMs);
     });
+    _subscriberFactories.set('file', (config) => {
+        const path = config['path'];
+        if (typeof path !== 'string' || path.length === 0) {
+            throw new Error(`file subscriber requires a non-empty "path" string field`);
+        }
+        const append = config['append'];
+        const format = config['format'];
+        const rotateBytes = config['rotate_bytes'];
+        return new FileSubscriber(path, append, format, rotateBytes);
+    });
+    _subscriberFactories.set('stdout', (config) => {
+        const format = config['format'];
+        const levelFilter = config['level_filter'];
+        return new StdoutSubscriber(format, levelFilter);
+    });
+    _subscriberFactories.set('filter', (config) => {
+        const delegateType = config['delegate_type'];
+        if (typeof delegateType !== 'string') {
+            throw new Error(`filter subscriber requires a "delegate_type" string field`);
+        }
+        const delegateConfig = (config['delegate_config'] ?? {});
+        const delegateFactory = _subscriberFactories.get(delegateType);
+        if (delegateFactory === undefined) {
+            throw new Error(`Unknown delegate subscriber type '${delegateType}' for filter subscriber`);
+        }
+        const delegate = delegateFactory(delegateConfig);
+        const includeEvents = config['include_events'];
+        const excludeEvents = config['exclude_events'];
+        return new FilterSubscriber(delegate, includeEvents, excludeEvents);
+    });
 }
 // Register built-in factories on module load
 _registerBuiltInFactories();
+/** Register a custom subscriber type for config-driven instantiation. */
 export function registerSubscriberType(typeName, factory) {
     _subscriberFactories.set(typeName, factory);
 }
+/** Remove a previously registered subscriber type. */
 export function unregisterSubscriberType(typeName) {
     if (!_subscriberFactories.has(typeName)) {
         throw new Error(`Subscriber type '${typeName}' is not registered`);
     }
     _subscriberFactories.delete(typeName);
 }
+/** Reset the registry to built-in types only. Intended for test teardown. */
 export function resetSubscriberRegistry() {
     _subscriberFactories.clear();
     _registerBuiltInFactories();
 }
+/**
+ * Instantiate a single subscriber from a config object.
+ * The `type` field selects the factory; all other fields are passed as config.
+ */
+export function createSubscriberFromConfig(config) {
+    const typeName = config['type'];
+    if (typeof typeName !== 'string') {
+        throw new Error('Subscriber config missing "type" field');
+    }
+    const factory = _subscriberFactories.get(typeName);
+    if (factory === undefined) {
+        throw new Error(`Unknown subscriber type '${typeName}'`);
+    }
+    return factory(config);
+}
 /**
  * Instantiate subscribers from config and subscribe them to the emitter.
  */
@@ -100,17 +151,54 @@ export function _instantiateSubscribers(config, eventEmitter, sysCfg = null) {
 /**
  * Auto-register all sys.* modules and middleware based on config.
  */
-export function registerSysModules(registry, executor, config, metricsCollector) {
+export function registerSysModules(registry, executor, config, metricsCollector, options) {
     const result = {};
+    const failOnError = options?.failOnError ?? false;
+    const overridesPath = options?.overridesPath ?? null;
+    const overridesStore = options?.overridesStore ?? null;
+    const auditStore = options?.auditStore ?? null;
     // §9.15.3: prefer config.namespace('sys_modules') in namespace mode
     const sysCfg = _resolveSysCfg(config);
     if (!_cfgGet(sysCfg, config, 'enabled', false)) {
         return result;
     }
+    // Load overrides file and apply after base config
+    if (overridesPath !== null && fs.existsSync(overridesPath)) {
+        try {
+            const content = fs.readFileSync(overridesPath, 'utf-8');
+            const parsed = yaml.load(content);
+            if (typeof parsed === 'object' && parsed !== null) {
+                for (const [key, value] of Object.entries(parsed)) {
+                    config.set(key, value);
+                }
+            }
+        }
+        catch (err) {
+            console.warn('[apcore:sys-modules] Failed to load overrides file:', err);
+        }
+    }
+    // Apply overrides from the OverridesStore (Issue #45.1) — async stores are
+    // not supported here; if `load()` returns a Promise we log and skip.
+    if (overridesStore !== null) {
+        try {
+            const loaded = overridesStore.load();
+            if (loaded !== null && typeof loaded.then === 'function') {
+                console.warn('[apcore:sys-modules] OverridesStore.load() returned a Promise; async stores cannot be applied during synchronous registerSysModules. Pre-load and inject into Config directly.');
+            }
+            else {
+                for (const [key, value] of Object.entries(loaded)) {
+                    config.set(key, value);
+                }
+            }
+        }
+        catch (err) {
+            console.warn('[apcore:sys-modules] Failed to load overrides from OverridesStore:', err);
+        }
+    }
     // Error history
     const maxPerModule = Number(_cfgGet(sysCfg, config, 'error_history.max_entries_per_module', 50));
     const maxTotal = Number(_cfgGet(sysCfg, config, 'error_history.max_total_entries', 1000));
-    const errorHistory = new ErrorHistory(maxPerModule, maxTotal);
+    const errorHistory = new ErrorHistory({ maxEntriesPerModule: maxPerModule, maxTotalEntries: maxTotal });
     result.errorHistory = errorHistory;
     const ehMiddleware = new ErrorHistoryMiddleware(errorHistory);
     executor.use(ehMiddleware);
@@ -123,7 +211,16 @@ export function registerSysModules(registry, executor, config, metricsCollector)
     result.usageMiddleware = usageMiddleware;
     // Register sys modules via registerInternal to bypass reserved-word checks
     const reg = (id, mod) => {
-        registry.registerInternal(id, mod);
+        try {
+            registry.registerInternal(id, mod);
+        }
+        catch (err) {
+            const cause = err instanceof Error ? err : new Error(String(err));
+            if (failOnError) {
+                throw new SysModuleRegistrationError(id, cause);
+            }
+            console.error(`[apcore:sys-modules] Failed to register system module '${id}':`, err);
+        }
     };
     // Health modules
     reg('system.health.summary', new HealthSummaryModule(registry, metricsCollector ?? null, errorHistory, config));
@@ -147,15 +244,22 @@ export function registerSysModules(registry, executor, config, metricsCollector)
         executor.use(pnMiddleware);
         result.platformNotifyMiddleware = pnMiddleware;
         // Control modules (require EventEmitter)
-        reg('system.control.toggle_feature', new ToggleFeatureModule(registry, eventEmitter));
-        reg('system.control.update_config', new UpdateConfigModule(config, eventEmitter));
-        reg('system.control.reload_module', new ReloadModule(registry, eventEmitter));
-        // Bridge registry events
+        reg('system.control.toggle_feature', new ToggleFeatureModule(registry, eventEmitter, undefined, auditStore ?? undefined, overridesStore ?? undefined));
+        reg('system.control.update_config', new UpdateConfigModule(config, eventEmitter, {
+            auditStore: auditStore ?? undefined,
+            overridesPath: overridesPath ?? undefined,
+            overridesStore: overridesStore ?? undefined,
+        }));
+        reg('system.control.reload_module', new ReloadModule(registry, eventEmitter, auditStore ?? undefined));
+        // Bridge registry events.
+        // §Issue #36: emit canonical apcore.registry.* names and legacy aliases
+        // (with deprecated: true) during the deprecation window. Once the legacy
+        // names are removed, drop the emitWithLegacy() wrapper for direct emit().
         registry.on('register', (moduleId) => {
-            eventEmitter.emit(createEvent('module_registered', moduleId, 'info', {}));
+            emitWithLegacy(eventEmitter, 'apcore.registry.module_registered', 'module_registered', moduleId, 'info', {});
         });
         registry.on('unregister', (moduleId) => {
-            eventEmitter.emit(createEvent('module_unregistered', moduleId, 'info', {}));
+            emitWithLegacy(eventEmitter, 'apcore.registry.module_unregistered', 'module_unregistered', moduleId, 'info', {});
         });
     }
     return result;

package/dist/sys-modules/registration.js.map

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

package/dist/sys-modules/toggle.d.ts

@@ -8,6 +8,8 @@
  */
 import type { Registry } from '../registry/registry.js';
 import type { EventEmitter } from '../events/emitter.js';
+import type { AuditStore } from './audit.js';
+import type { OverridesStore } from './overrides.js';
 /**
  * Toggle state container. Tracks which modules are disabled.
  * State survives module reload since it lives outside the Registry.
@@ -84,8 +86,11 @@ export declare class ToggleFeatureModule {
     private readonly _registry;
     private readonly _emitter;
     private readonly _toggleState;
-    constructor(registry: Registry, eventEmitter: EventEmitter, toggleState?: ToggleState);
-    execute(inputs: Record<string, unknown>, _context: unknown): Record<string, unknown>;
+    private readonly _auditStore;
+    private readonly _overridesStore;
+    constructor(registry: Registry, eventEmitter: EventEmitter, toggleState?: ToggleState, auditStore?: AuditStore, overridesStore?: OverridesStore);
+    execute(inputs: Record<string, unknown>, context: unknown): Record<string, unknown>;
+    private _persistToggleOverride;
     private _validateInputs;
 }
 //# sourceMappingURL=toggle.d.ts.map

package/dist/sys-modules/toggle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../src/sys-modules/toggle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,IAAI,IAAI;CAGd;AAED,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,aAAoB,CAAC;AAEtD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,qDAAqD;IACzE,QAAQ,CAAC,WAAW;;;;;;;;;;;;MAAoO;IACxP,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;MAQlB;IACF,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;MAQnB;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAE/B,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,WAAW;IAMrF,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgBpF,OAAO,CAAC,eAAe;CAexB"}
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../src/sys-modules/toggle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,IAAI,IAAI;CAGd;AAED,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,aAAoB,CAAC;AAEtD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,qDAAqD;IACzE,QAAQ,CAAC,WAAW;;;;;;;;;;;;MAAoO;IACxP,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;MAQlB;IACF,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;MAQnB;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;gBAGtD,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,EACzB,UAAU,CAAC,EAAE,UAAU,EACvB,cAAc,CAAC,EAAE,cAAc;IASjC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA0CnF,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,eAAe;CAexB"}

package/dist/sys-modules/toggle.js

@@ -8,6 +8,7 @@
  */
 import { InvalidInputError, ModuleNotFoundError, ModuleDisabledError } from '../errors.js';
 import { createEvent } from '../events/emitter.js';
+import { buildAuditEntry, extractAuditIdentity } from './audit.js';
 /**
  * Toggle state container. Tracks which modules are disabled.
  * State survives module reload since it lives outside the Registry.
@@ -68,27 +69,82 @@ export class ToggleFeatureModule {
     _registry;
     _emitter;
     _toggleState;
-    constructor(registry, eventEmitter, toggleState) {
+    _auditStore;
+    _overridesStore;
+    constructor(registry, eventEmitter, toggleState, auditStore, overridesStore) {
         this._registry = registry;
         this._emitter = eventEmitter;
         this._toggleState = toggleState ?? DEFAULT_TOGGLE_STATE;
+        this._auditStore = auditStore ?? null;
+        this._overridesStore = overridesStore ?? null;
     }
-    execute(inputs, _context) {
+    execute(inputs, context) {
         const { moduleId, enabled, reason } = this._validateInputs(inputs);
+        const ctx = context;
         if (!this._registry.has(moduleId)) {
             throw new ModuleNotFoundError(moduleId);
         }
+        const before = !this._toggleState.isDisabled(moduleId);
         if (enabled) {
             this._toggleState.enable(moduleId);
         }
         else {
             this._toggleState.disable(moduleId);
         }
-        // W-12: Event payload carries only { enabled } to match Python reference implementation.
-        // `reason` is returned in the module output but not emitted in the event.
-        this._emitter.emit(createEvent('apcore.module.toggled', moduleId, 'info', { enabled }));
+        const entry = buildAuditEntry('toggle_feature', moduleId, ctx, { before, after: enabled });
+        if (this._auditStore !== null) {
+            this._auditStore.append(entry);
+        }
+        else {
+            console.warn(`[apcore:audit] toggle_feature ${moduleId} actor=${entry.actorId} before=${before} after=${enabled} reason=${reason}`);
+        }
+        // W-12: Event payload carries `enabled` (Python parity) plus requester
+        // identity per Issue #45.2 so subscribers can attribute the toggle. The
+        // `reason` field is returned in the module output but not in the event.
+        const { caller_id, identity } = extractAuditIdentity(ctx);
+        const toggledPayload = {
+            module_id: moduleId,
+            enabled,
+            caller_id,
+        };
+        if (identity !== null)
+            toggledPayload['identity'] = identity;
+        this._emitter.emit(createEvent('apcore.module.toggled', moduleId, 'info', toggledPayload));
+        console.warn(`[apcore:control] Feature toggled: module_id=${moduleId} enabled=${enabled} reason=${reason}`);
+        if (this._overridesStore !== null) {
+            this._persistToggleOverride(moduleId, enabled);
+        }
         return { success: true, module_id: moduleId, enabled };
     }
+    _persistToggleOverride(moduleId, enabled) {
+        const store = this._overridesStore;
+        const overrideKey = `toggle.${moduleId}`;
+        try {
+            const loaded = store.load();
+            if (loaded !== null && typeof loaded.then === 'function') {
+                loaded
+                    .then((existing) => {
+                    existing[overrideKey] = enabled;
+                    return store.save(existing);
+                })
+                    .catch((err) => {
+                    console.warn(`[apcore:control] Failed to persist toggle override for '${moduleId}':`, err);
+                });
+                return;
+            }
+            const existing = loaded;
+            existing[overrideKey] = enabled;
+            const saveResult = store.save(existing);
+            if (saveResult !== undefined && typeof saveResult.then === 'function') {
+                saveResult.catch((err) => {
+                    console.warn(`[apcore:control] Failed to persist toggle override for '${moduleId}':`, err);
+                });
+            }
+        }
+        catch (err) {
+            console.warn(`[apcore:control] Failed to persist toggle override for '${moduleId}':`, err);
+        }
+    }
     _validateInputs(inputs) {
         const moduleId = inputs['module_id'];
         if (typeof moduleId !== 'string' || !moduleId) {

package/dist/sys-modules/toggle.js.map

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

package/dist/trace-context.d.ts

@@ -1,5 +1,6 @@
 /**
- * W3C Trace Context support: TraceParent parsing and TraceContext injection/extraction.
+ * W3C Trace Context support: TraceParent + tracestate parsing and TraceContext
+ * injection/extraction.
  */
 import type { Context } from './context.js';
 export interface TraceParent {
@@ -7,22 +8,41 @@ export interface TraceParent {
     readonly traceId: string;
     readonly parentId: string;
     readonly traceFlags: string;
+    /** Parsed `tracestate` entries. Empty array when the header is absent. */
+    readonly tracestate: ReadonlyArray<readonly [string, string]>;
 }
+/**
+ * Headers container the extractor accepts. Plain dict, fetch `Headers`, or `Map`.
+ *
+ * For plain objects, lookup folds keys to lowercase. For `Headers`, the platform
+ * already performs case-insensitive matching. For `Map`, lookup folds keys.
+ */
+export type HeadersLike = Record<string, unknown> | Headers | Map<string, string>;
 export declare class TraceContext {
     /**
-     * Build a traceparent header dict from an apcore Context.
+     * Build outbound trace headers from an apcore Context.
+     *
+     * Behavior:
+     * - Uses `context.traceId` (already 32-hex) as the traceparent trace_id.
+     * - When `parentId` is supplied it is used verbatim and MUST match `^[0-9a-f]{16}$`;
+     *   otherwise the last span on the tracing stack provides the id, falling back
+     *   to a fresh random 16-hex value.
+     * - When the Context carries an inbound TraceParent under
+     *   `data['_apcore.trace.inbound']`, its `traceFlags` and `tracestate` are
+     *   propagated; otherwise traceFlags defaults to `"01"` (sampled) for new roots.
      *
-     * Uses `context.traceId` (already 32-hex format) directly in the
-     * W3C traceparent header. Uses the last span's `spanId` from the
-     * tracing stack if available, otherwise generates a random 16-hex parent id.
+     * @param context apcore Context
+     * @param parentId optional 16-hex parent id override
+     * @throws {Error} if `parentId` is provided but malformed
      */
-    static inject(context: Context): Record<string, string>;
+    static inject(context: Context, parentId?: string): Record<string, string>;
     /**
-     * Parse the `traceparent` header from the given headers object.
+     * Parse the `traceparent` (and optional `tracestate`) header from a header
+     * container, performing case-insensitive header name lookup.
      *
-     * Returns `null` if the header is missing or malformed.
+     * Returns `null` if the traceparent header is missing or malformed.
      */
-    static extract(headers: Record<string, string>): TraceParent | null;
+    static extract(headers: HeadersLike): TraceParent | null;
     /**
      * Strictly parse a traceparent string, throwing on invalid format.
      *
@@ -30,5 +50,23 @@ export declare class TraceContext {
      *   `00-<32 hex>-<16 hex>-<2 hex>` format.
      */
     static fromTraceparent(traceparent: string): TraceParent;
+    /**
+     * Parse a W3C `tracestate` header value.
+     *
+     * Splits on commas, trims each member, and accepts only entries shaped as
+     * `key=value` (the value may contain `=`). Malformed members are dropped
+     * silently. The list is truncated to {@link MAX_TRACESTATE_ENTRIES} (32).
+     */
+    static parseTracestate(raw: string): Array<[string, string]>;
+    /**
+     * Format tracestate entries to a comma-separated header value.
+     */
+    static formatTracestate(entries: ReadonlyArray<readonly [string, string]>): string;
+    /**
+     * Case-insensitive header lookup across plain objects, `Headers`, and `Map`.
+     *
+     * @returns the header value (or `undefined` if not present).
+     */
+    static lookupHeaderCi(headers: HeadersLike, name: string): string | undefined;
 }
 //# sourceMappingURL=trace-context.d.ts.map

package/dist/trace-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAevD;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,GAAG,IAAI;IA0BnE;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;CAuBzD"}
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAY5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,OAAO,GACP,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExB,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAoC1E;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI;IA+BxD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;IAyBxD;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAqC5D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM;IAIlF;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CA0B9E"}