vestig 0.11.5 → 0.13.0

package/dist/utils/dedupe.d.ts

@@ -0,0 +1,80 @@
+import type { DedupeConfig, LogLevel } from '../types';
+/**
+ * Result of checking if a log should be suppressed
+ */
+export interface DedupeResult {
+    /** Whether this log should be suppressed */
+    suppressed: boolean;
+    /** If not suppressed and is a summary, how many were suppressed */
+    suppressedCount?: number;
+    /** If this is a summary log, the original key */
+    isFlush?: boolean;
+}
+/**
+ * Deduplicator for suppressing repeated identical log messages
+ *
+ * Uses an LRU-like eviction strategy to bound memory usage while
+ * tracking duplicate logs within a time window.
+ */
+export declare class Deduplicator {
+    private readonly config;
+    private readonly tracked;
+    private cleanupTimer;
+    constructor(config?: DedupeConfig);
+    /**
+     * Check if a log should be suppressed
+     *
+     * @param message - The log message
+     * @param level - The log level
+     * @param namespace - Optional namespace
+     * @returns Whether the log should be suppressed
+     */
+    shouldSuppress(message: string, level: LogLevel, namespace?: string): DedupeResult;
+    /**
+     * Get counts of all currently tracked logs that were suppressed
+     *
+     * Useful for flushing all pending summaries on shutdown.
+     */
+    getPendingSummaries(): Array<{
+        key: string;
+        count: number;
+        level: LogLevel;
+    }>;
+    /**
+     * Clear all tracked entries
+     */
+    clear(): void;
+    /**
+     * Stop the cleanup timer
+     */
+    destroy(): void;
+    /**
+     * Create a deduplication key from message and optional context
+     */
+    private createKey;
+    /**
+     * Track a new log entry
+     */
+    private track;
+    /**
+     * Evict the oldest entry (LRU-style)
+     */
+    private evictOldest;
+    /**
+     * Start periodic cleanup of expired entries
+     *
+     * Only cleans up entries that have count=1 (no pending summary).
+     * Entries with pending summaries are kept until the next log of the same
+     * type, which will emit the summary and reset tracking.
+     */
+    private startCleanup;
+    /**
+     * Get statistics about the deduplicator
+     */
+    getStats(): {
+        tracked: number;
+        maxSize: number;
+        windowMs: number;
+    };
+}
+//# sourceMappingURL=dedupe.d.ts.map

package/dist/utils/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../../src/utils/dedupe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAyBtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAA;IACnB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,YAAY,CAA8C;gBAEtD,MAAM,CAAC,EAAE,YAAY;IAajC;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY;IAkClF;;;;OAIG;IACH,mBAAmB,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC;IAgB7E;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB;;OAEG;IACH,OAAO,CAAC,KAAK;IAab;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAOlE"}

package/dist/utils/dedupe.js

@@ -0,0 +1,173 @@
+/**
+ * Default dedupe configuration
+ */
+const DEFAULTS = {
+    enabled: true,
+    windowMs: 1000,
+    maxSize: 1000,
+    includeLevel: true,
+    includeNamespace: true,
+};
+/**
+ * Deduplicator for suppressing repeated identical log messages
+ *
+ * Uses an LRU-like eviction strategy to bound memory usage while
+ * tracking duplicate logs within a time window.
+ */
+export class Deduplicator {
+    config;
+    tracked = new Map();
+    cleanupTimer = null;
+    constructor(config) {
+        this.config = {
+            ...DEFAULTS,
+            ...config,
+            enabled: config?.enabled ?? DEFAULTS.enabled,
+        };
+        // Start cleanup timer
+        if (this.config.enabled) {
+            this.startCleanup();
+        }
+    }
+    /**
+     * Check if a log should be suppressed
+     *
+     * @param message - The log message
+     * @param level - The log level
+     * @param namespace - Optional namespace
+     * @returns Whether the log should be suppressed
+     */
+    shouldSuppress(message, level, namespace) {
+        if (!this.config.enabled) {
+            return { suppressed: false };
+        }
+        const key = this.createKey(message, level, namespace);
+        const now = Date.now();
+        const existing = this.tracked.get(key);
+        if (existing) {
+            // Check if still within window
+            if (now - existing.firstSeen < this.config.windowMs) {
+                existing.count++;
+                return { suppressed: true };
+            }
+            // Window expired - emit summary and reset
+            const suppressedCount = existing.count - 1; // Exclude the first one
+            this.tracked.delete(key);
+            // Start tracking this new occurrence
+            this.track(key, now, level);
+            if (suppressedCount > 0) {
+                return { suppressed: false, suppressedCount, isFlush: true };
+            }
+            return { suppressed: false };
+        }
+        // First occurrence - track it
+        this.track(key, now, level);
+        return { suppressed: false };
+    }
+    /**
+     * Get counts of all currently tracked logs that were suppressed
+     *
+     * Useful for flushing all pending summaries on shutdown.
+     */
+    getPendingSummaries() {
+        const summaries = [];
+        for (const [key, entry] of this.tracked) {
+            if (entry.count > 1) {
+                summaries.push({
+                    key,
+                    count: entry.count - 1, // Exclude the first logged one
+                    level: entry.level,
+                });
+            }
+        }
+        return summaries;
+    }
+    /**
+     * Clear all tracked entries
+     */
+    clear() {
+        this.tracked.clear();
+    }
+    /**
+     * Stop the cleanup timer
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.tracked.clear();
+    }
+    /**
+     * Create a deduplication key from message and optional context
+     */
+    createKey(message, level, namespace) {
+        const parts = [message];
+        if (this.config.includeLevel) {
+            parts.unshift(level);
+        }
+        if (this.config.includeNamespace && namespace) {
+            parts.unshift(namespace);
+        }
+        return parts.join('|');
+    }
+    /**
+     * Track a new log entry
+     */
+    track(key, timestamp, level) {
+        // Evict oldest if at capacity
+        if (this.tracked.size >= this.config.maxSize) {
+            this.evictOldest();
+        }
+        this.tracked.set(key, {
+            firstSeen: timestamp,
+            count: 1,
+            level,
+        });
+    }
+    /**
+     * Evict the oldest entry (LRU-style)
+     */
+    evictOldest() {
+        // Map maintains insertion order, so first key is oldest
+        const firstKey = this.tracked.keys().next().value;
+        if (firstKey !== undefined) {
+            this.tracked.delete(firstKey);
+        }
+    }
+    /**
+     * Start periodic cleanup of expired entries
+     *
+     * Only cleans up entries that have count=1 (no pending summary).
+     * Entries with pending summaries are kept until the next log of the same
+     * type, which will emit the summary and reset tracking.
+     */
+    startCleanup() {
+        // Clean up every windowMs (but wait 2x windowMs for first run to avoid edge cases)
+        this.cleanupTimer = setInterval(() => {
+            const now = Date.now();
+            const expireTime = now - this.config.windowMs;
+            for (const [key, entry] of this.tracked) {
+                // Only clean up if expired AND no pending summary
+                if (entry.firstSeen < expireTime && entry.count === 1) {
+                    this.tracked.delete(key);
+                }
+            }
+        }, this.config.windowMs * 2); // Run less frequently to reduce timing issues
+        // Unref so it doesn't keep the process alive
+        if (typeof this.cleanupTimer === 'object' && 'unref' in this.cleanupTimer) {
+            this.cleanupTimer.unref();
+        }
+    }
+    /**
+     * Get statistics about the deduplicator
+     */
+    getStats() {
+        return {
+            tracked: this.tracked.size,
+            maxSize: this.config.maxSize,
+            windowMs: this.config.windowMs,
+        };
+    }
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/utils/dedupe.js.map

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

package/dist/utils/sanitize.d.ts

@@ -41,9 +41,27 @@ export declare class Sanitizer {
      */
     addPattern(pattern: SanitizePattern): void;
     /**
-     * Check if a field name should be sanitized
+     * Check if a field name or path should be sanitized
+     *
+     * Supports:
+     * - Simple field names: 'password' matches any field named 'password'
+     * - Dot notation paths: 'user.password' matches password under user
+     * - Glob patterns: '**.password' matches password at any depth
+     * - Wildcard: 'config.*' matches any direct child of config
      */
     private isSensitiveField;
+    /**
+     * Match a field path against a FieldMatcher with glob support
+     */
+    private matchFieldPath;
+    /**
+     * Match a path against a glob pattern
+     *
+     * Supports:
+     * - ** matches any number of path segments (including zero)
+     * - * matches exactly one path segment
+     */
+    private matchGlobPattern;
     /**
      * Match a field against a FieldMatcher
      */
@@ -54,6 +72,10 @@ export declare class Sanitizer {
     private sanitizeString;
     /**
      * Recursively sanitize a value
+     *
+     * @param value - The value to sanitize
+     * @param depth - Current recursion depth
+     * @param path - Dot-notation path to current position (e.g., 'user.credentials')
      */
     private sanitizeValue;
     /**

package/dist/utils/sanitize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAa7F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,MAAM,GAAE,cAAmB;IAsBvC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS;IAIpD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC7B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,SAAS;IAIZ;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAKxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAS5C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;CAG/C;AAKD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,GAAE,MAAM,EAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAa5F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,GAAE,MAAM,EAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAS5F;AAGD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAa7F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,MAAM,GAAE,cAAmB;IAsBvC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS;IAIpD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC7B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,SAAS;IAIZ;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAKxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAS5C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAkDxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAoCrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;CAG/C;AAKD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,GAAE,MAAM,EAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAa5F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,GAAE,MAAM,EAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAS5F;AAGD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/utils/sanitize.js

@@ -65,7 +65,7 @@ export class Sanitizer {
     sanitize(value) {
         if (!this.config.enabled)
             return value;
-        return this.sanitizeValue(value, 0);
+        return this.sanitizeValue(value, 0, '');
     }
     /**
      * Add a field to sanitize
@@ -86,20 +86,120 @@ export class Sanitizer {
         this.config.patterns.push(pattern);
     }
     /**
-     * Check if a field name should be sanitized
+     * Check if a field name or path should be sanitized
+     *
+     * Supports:
+     * - Simple field names: 'password' matches any field named 'password'
+     * - Dot notation paths: 'user.password' matches password under user
+     * - Glob patterns: '**.password' matches password at any depth
+     * - Wildcard: 'config.*' matches any direct child of config
      */
-    isSensitiveField(fieldName) {
+    isSensitiveField(fieldName, path) {
         const lower = fieldName.toLowerCase();
-        // Check simple field set
+        const fullPath = path ? `${path}.${fieldName}` : fieldName;
+        const fullPathLower = fullPath.toLowerCase();
+        // Check simple field set (matches by key name or full path)
         if (this.fieldSet.has(lower))
             return true;
+        if (this.fieldSet.has(fullPathLower))
+            return true;
         // Check field matchers
         for (const matcher of this.fieldMatchers) {
+            // Check against key name
             if (this.matchField(lower, matcher))
                 return true;
+            // Check against full path
+            if (this.matchFieldPath(fullPathLower, matcher))
+                return true;
         }
         return false;
     }
+    /**
+     * Match a field path against a FieldMatcher with glob support
+     */
+    matchFieldPath(path, matcher) {
+        const value = matcher.caseSensitive ? matcher.value : matcher.value.toLowerCase();
+        const targetPath = matcher.caseSensitive ? path : path.toLowerCase();
+        // Handle glob patterns
+        if (value.includes('**') || value.includes('*')) {
+            return this.matchGlobPattern(targetPath, value);
+        }
+        // For non-glob patterns, check if the pattern matches the full path
+        switch (matcher.type) {
+            case 'exact':
+                return targetPath === value;
+            case 'prefix':
+                return targetPath.startsWith(value);
+            case 'suffix':
+                return targetPath.endsWith(value);
+            case 'contains':
+                return targetPath.includes(value);
+            case 'regex':
+                return new RegExp(matcher.value, matcher.caseSensitive ? '' : 'i').test(path);
+            default:
+                return false;
+        }
+    }
+    /**
+     * Match a path against a glob pattern
+     *
+     * Supports:
+     * - ** matches any number of path segments (including zero)
+     * - * matches exactly one path segment
+     */
+    matchGlobPattern(path, pattern) {
+        const segments = pattern.split('.');
+        const regexParts = [];
+        let addDotPrefix = false; // Track if next segment needs a dot prefix
+        for (let i = 0; i < segments.length; i++) {
+            const segment = segments[i]; // Always defined within loop bounds
+            const isLast = i === segments.length - 1;
+            if (segment === '**') {
+                // ** matches any number of segments (including zero)
+                if (i === 0 && isLast) {
+                    // Just "**" matches everything
+                    regexParts.push('.*');
+                }
+                else if (i === 0) {
+                    // "**.foo" - optional prefix with dot included
+                    regexParts.push('(?:.*\\.)?');
+                    // Don't add dot prefix to next segment - it's included in (?:.*\.)?
+                }
+                else if (isLast) {
+                    // "foo.**" - match foo followed by anything
+                    regexParts.push('(?:\\..*)?');
+                }
+                else {
+                    // "foo.**.bar" - match zero or more segments in between
+                    regexParts.push('(?:\\.[^.]+)*');
+                    addDotPrefix = true;
+                }
+            }
+            else if (segment === '*') {
+                // * matches exactly one segment
+                if (addDotPrefix) {
+                    regexParts.push('\\.[^.]+');
+                }
+                else {
+                    regexParts.push('[^.]+');
+                }
+                addDotPrefix = true;
+            }
+            else {
+                // Literal segment
+                const escaped = segment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                if (addDotPrefix) {
+                    regexParts.push(`\\.${escaped}`);
+                }
+                else {
+                    regexParts.push(escaped);
+                }
+                addDotPrefix = true;
+            }
+        }
+        const regexPattern = regexParts.join('');
+        return new RegExp(`^${regexPattern}$`, 'i').test(path);
+    }
     /**
      * Match a field against a FieldMatcher
      */
@@ -139,8 +239,12 @@ export class Sanitizer {
     }
     /**
      * Recursively sanitize a value
+     *
+     * @param value - The value to sanitize
+     * @param depth - Current recursion depth
+     * @param path - Dot-notation path to current position (e.g., 'user.credentials')
      */
-    sanitizeValue(value, depth) {
+    sanitizeValue(value, depth, path) {
         if (depth > this.config.depth)
             return value;
         // Handle null/undefined
@@ -152,17 +256,18 @@ export class Sanitizer {
         }
         // Handle arrays
         if (Array.isArray(value)) {
-            return value.map((item) => this.sanitizeValue(item, depth + 1));
+            return value.map((item, index) => this.sanitizeValue(item, depth + 1, path ? `${path}[${index}]` : `[${index}]`));
         }
         // Handle objects
         if (typeof value === 'object') {
             const result = {};
             for (const [key, val] of Object.entries(value)) {
-                if (this.isSensitiveField(key)) {
+                if (this.isSensitiveField(key, path)) {
                     result[key] = this.config.replacement;
                 }
                 else {
-                    result[key] = this.sanitizeValue(val, depth + 1);
+                    const newPath = path ? `${path}.${key}` : key;
+                    result[key] = this.sanitizeValue(val, depth + 1, newPath);
                 }
             }
             return result;

package/dist/utils/sanitize.js.map

@@ -1 +1 @@
-{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE7E;;GAEG;AACH,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAExC;;GAEG;AACH,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,SAAS;IACJ,MAAM,CAA0B;IAChC,QAAQ,CAAa;IACrB,aAAa,CAAgB;IAE9C,YAAY,SAAyB,EAAE;QACtC,IAAI,CAAC,MAAM,GAAG;YACb,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,mBAAmB;YACtD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,iBAAiB;SACxC,CAAA;QAED,yDAAyD;QACzD,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;QACjC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QAEvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;YACvC,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC/B,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAsB;QACvC,OAAO,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC7B,MAAsB,EACtB,SAAkC;QAElC,OAAO,IAAI,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;IACjE,CAAC;IAED;;OAEG;IACH,QAAQ,CAAI,KAAQ;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,KAAK,CAAA;QACtC,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAM,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAA4B;QACpC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;QACvC,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;IACF,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAwB;QAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAED;;;;;;;;OAQG;IACK,gBAAgB,CAAC,SAAiB,EAAE,IAAY;QACvD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAA;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAC1D,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;QAE5C,4DAA4D;QAC5D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;YAAE,OAAO,IAAI,CAAA;QAEjD,uBAAuB;QACvB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,yBAAyB;YACzB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAA;YAChD,0BAA0B;YAC1B,IAAI,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAA;QAC7D,CAAC;QAED,OAAO,KAAK,CAAA;IACb,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAY,EAAE,OAAqB;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;QACjF,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;QAEpE,uBAAuB;QACvB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QAChD,CAAC;QAED,oEAAoE;QACpE,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,OAAO;gBACX,OAAO,UAAU,KAAK,KAAK,CAAA;YAC5B,KAAK,QAAQ;gBACZ,OAAO,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;YACpC,KAAK,QAAQ;gBACZ,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAClC,KAAK,UAAU;gBACd,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAClC,KAAK,OAAO;gBACX,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC9E;gBACC,OAAO,KAAK,CAAA;QACd,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACK,gBAAgB,CAAC,IAAY,EAAE,OAAe;QACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACnC,MAAM,UAAU,GAAa,EAAE,CAAA;QAC/B,IAAI,YAAY,GAAG,KAAK,CAAA,CAAC,2CAA2C;QAEpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAA,CAAC,oCAAoC;YAC1E,MAAM,MAAM,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YAExC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACtB,qDAAqD;gBACrD,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;oBACvB,+BAA+B;oBAC/B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACtB,CAAC;qBAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpB,+CAA+C;oBAC/C,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;oBAC7B,oEAAoE;gBACrE,CAAC;qBAAM,IAAI,MAAM,EAAE,CAAC;oBACnB,4CAA4C;oBAC5C,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;gBAC9B,CAAC;qBAAM,CAAC;oBACP,wDAAwD;oBACxD,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;oBAChC,YAAY,GAAG,IAAI,CAAA;gBACpB,CAAC;YACF,CAAC;iBAAM,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBAC5B,gCAAgC;gBAChC,IAAI,YAAY,EAAE,CAAC;oBAClB,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;gBAC5B,CAAC;qBAAM,CAAC;oBACP,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACzB,CAAC;gBACD,YAAY,GAAG,IAAI,CAAA;YACpB,CAAC;iBAAM,CAAC;gBACP,kBAAkB;gBAClB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;gBAC9D,IAAI,YAAY,EAAE,CAAC;oBAClB,UAAU,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAA;gBACjC,CAAC;qBAAM,CAAC;oBACP,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACzB,CAAC;gBACD,YAAY,GAAG,IAAI,CAAA;YACpB,CAAC;QACF,CAAC;QAED,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACxC,OAAO,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,SAAiB,EAAE,OAAqB;QAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;QACjF,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAA;QAExE,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,OAAO;gBACX,OAAO,IAAI,KAAK,KAAK,CAAA;YACtB,KAAK,QAAQ;gBACZ,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;YAC9B,KAAK,QAAQ;gBACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC5B,KAAK,UAAU;gBACd,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC5B,KAAK,OAAO;gBACX,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACnF;gBACC,OAAO,KAAK,CAAA;QACd,CAAC;IACF,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,KAAa;QACnC,IAAI,MAAM,GAAG,KAAK,CAAA;QAElB,KAAK,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAA;YAClD,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YACtC,CAAC;iBAAM,CAAC;gBACP,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YACtC,CAAC;QACF,CAAC;QAED,OAAO,MAAM,CAAA;IACd,CAAC;IAED;;;;;;OAMG;IACK,aAAa,CAAC,KAAc,EAAE,KAAa,EAAE,IAAY;QAChE,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QAE3C,wBAAwB;QACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;QAEvD,iBAAiB;QACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QAClC,CAAC;QAED,gBAAgB;QAChB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAChC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAC9E,CAAA;QACF,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAA4B,EAAE,CAAA;YAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChD,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;oBACtC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAA;gBACtC,CAAC;qBAAM,CAAC;oBACP,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;oBAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;gBAC1D,CAAC;YACF,CAAC;YACD,OAAO,MAAM,CAAA;QACd,CAAC;QAED,0BAA0B;QAC1B,OAAO,KAAK,CAAA;IACb,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,IAAI,CAAC,MAAM,CAAA;IACnB,CAAC;CACD;AAED,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;AAExD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,mBAA6B,EAAE,EAAE,KAAK,GAAG,CAAC;IAClF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,iDAAiD;QACjD,oFAAoF;QACpF,MAAM,SAAS,GAAG,SAAS,CAAC,uBAAuB,CAAC,SAAS,EAAE;YAC9D,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxC,IAAI,EAAE,UAAmB;gBACzB,KAAK,EAAE,KAAK;aACZ,CAAC,CAAC;SACH,CAAC,CAAA;QACF,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,mBAA6B,EAAE;IAC9D,MAAM,SAAS,GAAG,SAAS,CAAC,uBAAuB,CAAC,SAAS,EAAE;QAC9D,qDAAqD;QACrD,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,IAAI,EAAE,UAAmB;YACzB,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;KACH,CAAC,CAAA;IACF,OAAO,CAAC,KAAc,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACrD,CAAC;AAED,iDAAiD;AACjD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/version.d.ts

@@ -2,5 +2,5 @@
  * Vestig library version
  * This is automatically updated during the release process
  */
-export declare const VERSION = "0.11.4";
+export declare const VERSION = "0.11.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
  * Vestig library version
  * This is automatically updated during the release process
  */
-export const VERSION = '0.11.4';
+export const VERSION = '0.11.5';
 //# sourceMappingURL=version.js.map

package/dist/wide-events/builder.d.ts

@@ -0,0 +1,51 @@
+import type { LogMetadata } from '../types';
+import type { WideEvent, WideEventBuilder, WideEventConfig, WideEventContext, WideEventEndOptions, WideEventFields } from './types';
+/**
+ * Implementation of WideEventBuilder.
+ *
+ * Accumulates context throughout a request lifecycle and
+ * produces a single comprehensive event at the end.
+ */
+export declare class WideEventBuilderImpl implements WideEventBuilder {
+    private readonly _type;
+    private readonly _startTime;
+    private readonly _startedAt;
+    private _context;
+    private _fields;
+    private _ended;
+    constructor(config: WideEventConfig);
+    get type(): string;
+    get startTime(): number;
+    get ended(): boolean;
+    set(category: string, key: string, value: unknown): this;
+    get(category: string, key: string): unknown;
+    merge(category: string, fields: Record<string, unknown>): this;
+    mergeAll(fields: WideEventFields): this;
+    setContext(context: Partial<WideEventContext>): this;
+    getContext(): WideEventContext;
+    getFields(): Readonly<WideEventFields>;
+    end(options?: WideEventEndOptions): WideEvent;
+    toMetadata(): LogMetadata;
+    private _assertNotEnded;
+    private _deepClone;
+}
+/**
+ * Create a new wide event builder.
+ *
+ * @param config - Event configuration (type is required)
+ * @returns A new WideEventBuilder instance
+ *
+ * @example
+ * ```typescript
+ * const event = createWideEvent({ type: 'http.request' });
+ *
+ * event.set('http', 'method', 'POST');
+ * event.set('http', 'path', '/api/checkout');
+ * event.set('user', 'id', userId);
+ *
+ * const wideEvent = event.end({ status: 'success' });
+ * logger.info('Request completed', wideEvent);
+ * ```
+ */
+export declare function createWideEvent(config: WideEventConfig): WideEventBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist/wide-events/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/wide-events/builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,UAAU,CAAA;AAE5D,OAAO,KAAK,EACX,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EAEf,MAAM,SAAS,CAAA;AAYhB;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,eAAe;IAQnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IASxD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAI3C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9D,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAQvC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAMpD,UAAU,IAAI,gBAAgB;IAI9B,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC;IAItC,GAAG,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS;IAgDjD,UAAU,IAAI,WAAW;IAwBzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,UAAU;CAWlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAEzE"}