@spinajs/log 2.0.481 → 2.0.484

package/lib/mjs/callsite.js

@@ -0,0 +1,57 @@
+/**
+ * Best-effort caller-frame capture for the `${callsite}` layout variable.
+ *
+ * NLog gates stack-trace capture behind `StackTraceUsage` so that logging is
+ * zero-cost unless a target's layout actually references the caller. This
+ * mirrors that: {@link FrameworkLogger} only calls {@link captureCallsite}
+ * when some target's layout references `${callsite}`, so the `new Error()`
+ * ( the only cost here ) is never constructed otherwise.
+ *
+ * The parser is intentionally defensive - it must NEVER throw. Browser stack
+ * formats vary and V8's format is not guaranteed, so an unparseable stack just
+ * yields `""` rather than crashing a log call.
+ */
+/**
+ * Walk the current stack and return the first frame OUTSIDE the log package -
+ * i.e. the user's call site - as `"basename:line"` ( e.g. `service.ts:42` ).
+ *
+ * Internal frames belonging to the logger itself ( `log.ts`, `callsite.ts`,
+ * the `log-common` package, `wrapWrite`, `createLogMessageObject` ) are skipped
+ * so the returned frame is the caller of `log.info(...)` / `log.error(...)`.
+ *
+ * Returns `""` when no frame can be parsed ( no stack, or an unrecognized
+ * stack format ). Best-effort by design.
+ */
+export function captureCallsite() {
+    const stack = new Error().stack;
+    if (!stack) {
+        return "";
+    }
+    const lines = stack.split("\n");
+    for (const line of lines) {
+        // only real stack frames ( "    at ..." ) - skip the leading "Error" line
+        // and any non-frame text.
+        if (!/\bat\b/.test(line)) {
+            continue;
+        }
+        // skip frames that live inside the logger's own code:
+        //  - files log.ts / callsite.ts ( source ) or log.js / callsite.js ( built )
+        //  - anything under a `log` or `log-common` package's src/ or lib/ tree
+        //  - the internal helpers wrapWrite / createLogMessageObject
+        if (/[\\/]log(-common)?[\\/](src|lib)[\\/]|[\\/](log|callsite)\.(ts|js|mjs|cjs)\b|\bwrapWrite\b|\bcreateLogMessageObject\b|\bcaptureCallsite\b/.test(line)) {
+            continue;
+        }
+        // extract "path:line" from either:
+        //   "    at fn (path:line:col)"   ( named frame )
+        //   "    at path:line:col"        ( anonymous frame )
+        const m = line.match(/\(?([^()]+):(\d+):(\d+)\)?\s*$/);
+        if (m) {
+            // basename only - keeps rendered log lines short and stable across
+            // machines ( full absolute paths differ per checkout ).
+            const file = m[1].split(/[\\/]/).pop() ?? m[1];
+            return `${file}:${m[2]}`;
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=callsite.js.map

package/lib/mjs/callsite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callsite.js","sourceRoot":"","sources":["../../src/callsite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,0EAA0E;QAC1E,0BAA0B;QAC1B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,sDAAsD;QACtD,6EAA6E;QAC7E,wEAAwE;QACxE,6DAA6D;QAC7D,IAAI,2IAA2I,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3J,SAAS;QACX,CAAC;QAED,mCAAmC;QACnC,kDAAkD;QAClD,sDAAsD;QACtD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE,CAAC;YACN,mEAAmE;YACnE,wDAAwD;YACxD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/lib/mjs/config/log.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Default configuration shipped with @spinajs/log ( Node only ).
+ *
+ * Everything the log package can be tuned with lives here, so the configuration
+ * module surfaces a single, discoverable list of what can be changed:
+ *
+ *  1. a DEFAULT fs provider `fs-log-default` rooted at the working process
+ *     directory, so FileTarget works without any user fs configuration,
+ *  2. `logger.file` - the default FileTarget options ( buffer / rotation /
+ *     retention tunables ). FileTarget merges these UNDER any per-target
+ *     `options`, and a user project config ( loaded last ) overrides them - the
+ *     same override chain every other spinajs package uses.
+ *
+ * Config files are merged with array concatenation, so the provider entry is
+ * APPENDED to any providers the user configures.
+ */
+/**
+ * Canonical default FileTarget options. This is the SINGLE source of truth for
+ * every log tunable - change a default HERE, never inline in the target or a
+ * strategy. It is exported ( not just embedded in the config below ) so the
+ * FileTarget can fall back to the exact same values when the config file is not
+ * discovered ( eg. isolated unit tests ), and so tests share one definition.
+ */
+export declare const LOG_FILE_DEFAULTS: {
+    /** fs provider holding the active log file. */
+    fs: string;
+    /** Zip the archived file when it is moved to the archive. */
+    compress: boolean;
+    /** Rotate the active log once it grows past this many bytes ( 1 MB ). */
+    maxSize: number;
+    /** Flush the in-memory buffer after this many messages. */
+    maxBufferSize: number;
+    /** Hard cap on buffered messages; oldest are dropped past this so a down sink cannot OOM. */
+    maxQueueSize: number;
+    /** Periodic flush tick in milliseconds, so a partial buffer is not held. */
+    flushInterval: number;
+    /** How often ( seconds ) SizeLogArchiveStrategy checks the active log size. */
+    archiveInterval: number;
+    /** Rotation trigger strategy ( decides WHEN to archive ). */
+    archiveStrategy: string;
+    /** Retention strategies applied in order after each rotation. */
+    retentionStrategies: string[];
+    /** Archives to keep ( CountLogRetentionStrategy ), oldest deleted first. */
+    maxArchiveFiles: number;
+    /** Max archive age in seconds ( AgeLogRetentionStrategy ), 7 days. */
+    maxAge: number;
+};
+declare const log: {
+    fs: {
+        defaultProvider: string;
+        providers: {
+            name: string;
+            service: string;
+            basePath: string;
+        }[];
+    };
+    logger: {
+        file: {
+            /** fs provider holding the active log file. */
+            fs: string;
+            /** Zip the archived file when it is moved to the archive. */
+            compress: boolean;
+            /** Rotate the active log once it grows past this many bytes ( 1 MB ). */
+            maxSize: number;
+            /** Flush the in-memory buffer after this many messages. */
+            maxBufferSize: number;
+            /** Hard cap on buffered messages; oldest are dropped past this so a down sink cannot OOM. */
+            maxQueueSize: number;
+            /** Periodic flush tick in milliseconds, so a partial buffer is not held. */
+            flushInterval: number;
+            /** How often ( seconds ) SizeLogArchiveStrategy checks the active log size. */
+            archiveInterval: number;
+            /** Rotation trigger strategy ( decides WHEN to archive ). */
+            archiveStrategy: string;
+            /** Retention strategies applied in order after each rotation. */
+            retentionStrategies: string[];
+            /** Archives to keep ( CountLogRetentionStrategy ), oldest deleted first. */
+            maxArchiveFiles: number;
+            /** Max archive age in seconds ( AgeLogRetentionStrategy ), 7 days. */
+            maxAge: number;
+        };
+        perf: {
+            enabled: boolean;
+            thresholds: {
+                "orm.query": number;
+                "http.request": number;
+                default: number;
+            };
+            overThresholdLevel: string;
+            underThresholdLevel: string;
+            logCounters: boolean;
+        };
+    };
+};
+export default log;
+//# sourceMappingURL=log.d.ts.map

package/lib/mjs/config/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/config/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;IAC5B,+CAA+C;;IAG/C,6DAA6D;;IAG7D,yEAAyE;;IAGzE,2DAA2D;;IAG3D,6FAA6F;;IAG7F,4EAA4E;;IAG5E,+EAA+E;;IAG/E,6DAA6D;;IAG7D,iEAAiE;;IAGjE,4EAA4E;;IAG5E,sEAAsE;;CAEvE,CAAC;AAEF,QAAA,MAAM,GAAG;;;;;;;;;;;YAlCP,+CAA+C;;YAG/C,6DAA6D;;YAG7D,yEAAyE;;YAGzE,2DAA2D;;YAG3D,6FAA6F;;YAG7F,4EAA4E;;YAG5E,+EAA+E;;YAG/E,6DAA6D;;YAG7D,iEAAiE;;YAGjE,4EAA4E;;YAG5E,sEAAsE;;;;;;;;;;;;;;;CAyBvE,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/lib/mjs/config/log.js

@@ -0,0 +1,72 @@
+/**
+ * Default configuration shipped with @spinajs/log ( Node only ).
+ *
+ * Everything the log package can be tuned with lives here, so the configuration
+ * module surfaces a single, discoverable list of what can be changed:
+ *
+ *  1. a DEFAULT fs provider `fs-log-default` rooted at the working process
+ *     directory, so FileTarget works without any user fs configuration,
+ *  2. `logger.file` - the default FileTarget options ( buffer / rotation /
+ *     retention tunables ). FileTarget merges these UNDER any per-target
+ *     `options`, and a user project config ( loaded last ) overrides them - the
+ *     same override chain every other spinajs package uses.
+ *
+ * Config files are merged with array concatenation, so the provider entry is
+ * APPENDED to any providers the user configures.
+ */
+const DEFAULT_FS_PROVIDER = "fs-log-default";
+/**
+ * Canonical default FileTarget options. This is the SINGLE source of truth for
+ * every log tunable - change a default HERE, never inline in the target or a
+ * strategy. It is exported ( not just embedded in the config below ) so the
+ * FileTarget can fall back to the exact same values when the config file is not
+ * discovered ( eg. isolated unit tests ), and so tests share one definition.
+ */
+export const LOG_FILE_DEFAULTS = {
+    /** fs provider holding the active log file. */
+    fs: DEFAULT_FS_PROVIDER,
+    /** Zip the archived file when it is moved to the archive. */
+    compress: false,
+    /** Rotate the active log once it grows past this many bytes ( 1 MB ). */
+    maxSize: 1024 * 1024,
+    /** Flush the in-memory buffer after this many messages. */
+    maxBufferSize: 100,
+    /** Hard cap on buffered messages; oldest are dropped past this so a down sink cannot OOM. */
+    maxQueueSize: 100000,
+    /** Periodic flush tick in milliseconds, so a partial buffer is not held. */
+    flushInterval: 1000,
+    /** How often ( seconds ) SizeLogArchiveStrategy checks the active log size. */
+    archiveInterval: 60,
+    /** Rotation trigger strategy ( decides WHEN to archive ). */
+    archiveStrategy: "SizeLogArchiveStrategy",
+    /** Retention strategies applied in order after each rotation. */
+    retentionStrategies: ["CountLogRetentionStrategy"],
+    /** Archives to keep ( CountLogRetentionStrategy ), oldest deleted first. */
+    maxArchiveFiles: 5,
+    /** Max archive age in seconds ( AgeLogRetentionStrategy ), 7 days. */
+    maxAge: 7 * 24 * 60 * 60,
+};
+const log = {
+    fs: {
+        defaultProvider: DEFAULT_FS_PROVIDER,
+        providers: [
+            {
+                name: DEFAULT_FS_PROVIDER,
+                service: "fsNative",
+                basePath: process.cwd(),
+            },
+        ],
+    },
+    logger: {
+        file: LOG_FILE_DEFAULTS,
+        perf: {
+            enabled: true,
+            thresholds: { "orm.query": 200, "http.request": 1000, default: 0 },
+            overThresholdLevel: "warn",
+            underThresholdLevel: "trace",
+            logCounters: false,
+        },
+    },
+};
+export default log;
+//# sourceMappingURL=log.js.map

package/lib/mjs/config/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/config/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,+CAA+C;IAC/C,EAAE,EAAE,mBAAmB;IAEvB,6DAA6D;IAC7D,QAAQ,EAAE,KAAK;IAEf,yEAAyE;IACzE,OAAO,EAAE,IAAI,GAAG,IAAI;IAEpB,2DAA2D;IAC3D,aAAa,EAAE,GAAG;IAElB,6FAA6F;IAC7F,YAAY,EAAE,MAAM;IAEpB,4EAA4E;IAC5E,aAAa,EAAE,IAAI;IAEnB,+EAA+E;IAC/E,eAAe,EAAE,EAAE;IAEnB,6DAA6D;IAC7D,eAAe,EAAE,wBAAwB;IAEzC,iEAAiE;IACjE,mBAAmB,EAAE,CAAC,2BAA2B,CAAC;IAElD,4EAA4E;IAC5E,eAAe,EAAE,CAAC;IAElB,sEAAsE;IACtE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;CACzB,CAAC;AAEF,MAAM,GAAG,GAAG;IACV,EAAE,EAAE;QACF,eAAe,EAAE,mBAAmB;QACpC,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,UAAU;gBACnB,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;aACxB;SACF;KACF;IACD,MAAM,EAAE;QACN,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE;YAClE,kBAAkB,EAAE,MAAM;YAC1B,mBAAmB,EAAE,OAAO;YAC5B,WAAW,EAAE,KAAK;SACnB;KACF;CACF,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/lib/mjs/context.browser.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Browser fallback for {@link LogContext}. The browser has no
+ * `node:async_hooks` / AsyncLocalStorage, so this keeps a single module-level
+ * `current` object and swaps it synchronously around `with`.
+ *
+ * LIMITATION: there is NO async isolation here. `with` only holds the context
+ * for the synchronous portion of `fn`; anything that runs after an `await` or a
+ * deferred callback ( unless wrapped with {@link LogContextImpl.bind} ) will not
+ * see it. This mirrors the Node API surface so callers write the same code, but
+ * on the browser ambient context is best-effort and synchronous only.
+ */
+declare class LogContextImpl {
+    private current;
+    /**
+     * The current ambient store.
+     */
+    active(): Record<string, unknown>;
+    /**
+     * Synchronously set the context to `{ ...current, ...vars }` for the duration
+     * of `fn`, restoring the previous value afterwards. No async isolation.
+     */
+    with<T>(vars: Record<string, unknown>, fn: () => T): T;
+    /**
+     * Mutate the current store in place ( late-bound values ).
+     */
+    set(key: string, value: unknown): void;
+    /**
+     * Capture the current store and restore it around each invocation of the
+     * returned function.
+     */
+    bind<A extends unknown[], R>(fn: (...a: A) => R): (...a: A) => R;
+}
+/**
+ * Shared ambient log context ( browser, synchronous fallback ).
+ */
+export declare const LogContext: LogContextImpl;
+/**
+ * Projects only primitive scalar values ( string / number / boolean / bigint )
+ * from an ambient-context object, dropping objects, arrays, Dates, functions,
+ * null and undefined. Ambient context is meant for correlation ids ( requestId,
+ * traceId, ... ) that belong on every log line; structured payloads should be
+ * passed explicitly per call ( log.info({ obj }, ... ) ), not via ambient context.
+ */
+export declare function scalarContext(ctx: Record<string, unknown>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=context.browser.d.ts.map

package/lib/mjs/context.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.browser.d.ts","sourceRoot":"","sources":["../../src/context.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,OAAO,CAA+B;IAE9C;;OAEG;IACI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIxC;;;OAGG;IACI,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAU7D;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI7C;;;OAGG;IACI,IAAI,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;CAYxE;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,gBAAuB,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASnF"}

package/lib/mjs/context.browser.js

@@ -0,0 +1,81 @@
+/**
+ * Browser fallback for {@link LogContext}. The browser has no
+ * `node:async_hooks` / AsyncLocalStorage, so this keeps a single module-level
+ * `current` object and swaps it synchronously around `with`.
+ *
+ * LIMITATION: there is NO async isolation here. `with` only holds the context
+ * for the synchronous portion of `fn`; anything that runs after an `await` or a
+ * deferred callback ( unless wrapped with {@link LogContextImpl.bind} ) will not
+ * see it. This mirrors the Node API surface so callers write the same code, but
+ * on the browser ambient context is best-effort and synchronous only.
+ */
+class LogContextImpl {
+    constructor() {
+        this.current = {};
+    }
+    /**
+     * The current ambient store.
+     */
+    active() {
+        return this.current;
+    }
+    /**
+     * Synchronously set the context to `{ ...current, ...vars }` for the duration
+     * of `fn`, restoring the previous value afterwards. No async isolation.
+     */
+    with(vars, fn) {
+        const previous = this.current;
+        this.current = { ...previous, ...vars };
+        try {
+            return fn();
+        }
+        finally {
+            this.current = previous;
+        }
+    }
+    /**
+     * Mutate the current store in place ( late-bound values ).
+     */
+    set(key, value) {
+        this.current[key] = value;
+    }
+    /**
+     * Capture the current store and restore it around each invocation of the
+     * returned function.
+     */
+    bind(fn) {
+        const captured = this.current;
+        return (...args) => {
+            const previous = this.current;
+            this.current = captured;
+            try {
+                return fn(...args);
+            }
+            finally {
+                this.current = previous;
+            }
+        };
+    }
+}
+/**
+ * Shared ambient log context ( browser, synchronous fallback ).
+ */
+export const LogContext = new LogContextImpl();
+/**
+ * Projects only primitive scalar values ( string / number / boolean / bigint )
+ * from an ambient-context object, dropping objects, arrays, Dates, functions,
+ * null and undefined. Ambient context is meant for correlation ids ( requestId,
+ * traceId, ... ) that belong on every log line; structured payloads should be
+ * passed explicitly per call ( log.info({ obj }, ... ) ), not via ambient context.
+ */
+export function scalarContext(ctx) {
+    const out = {};
+    for (const [k, v] of Object.entries(ctx)) {
+        const t = typeof v;
+        if (t === "string" || t === "number" || t === "boolean" || t === "bigint") {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=context.browser.js.map

package/lib/mjs/context.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.browser.js","sourceRoot":"","sources":["../../src/context.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,cAAc;IAApB;QACU,YAAO,GAA4B,EAAE,CAAC;IA8ChD,CAAC;IA5CC;;OAEG;IACI,MAAM;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACI,IAAI,CAAI,IAA6B,EAAE,EAAW;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,GAAW,EAAE,KAAc;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,IAAI,CAAyB,EAAkB;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,OAAO,CAAC,GAAG,IAAO,EAAK,EAAE;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;YACxB,IAAI,CAAC;gBACH,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACrB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAA4B;IACxD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1E,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/mjs/context.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Ambient log context backed by `node:async_hooks` AsyncLocalStorage.
+ *
+ * It deliberately resolves the SAME DI-singleton AsyncLocalStorage instance the
+ * @spinajs/http module runs per action ( `als.run(req.storage, ...)` ). Because
+ * that instance is a shared DI singleton, any log emitted anywhere inside a
+ * request automatically inherits the request store ( requestId, realIp, ... )
+ * with zero threading — the log package wires `setLogContextProvider(() =>
+ * LogContext.active())` so `createLogMessageObject` merges it at lowest
+ * precedence.
+ *
+ * The store type is a plain `Record<string, unknown>` — a superset of http's
+ * `IActionLocalStoregeContext` — so log stays independent of http.
+ */
+declare class LogContextImpl {
+    /**
+     * Resolve the shared AsyncLocalStorage from DI. Resolved as a bare concrete
+     * class it is a shared singleton, so this is the very instance http drives per
+     * action. We deliberately do NOT cache the reference: DI returns the same
+     * singleton on every call ( cheap lookup ), and NOT caching keeps LogContext
+     * consistent with the current DI instance even if the container is reset /
+     * re-registered ( a stale cached reference would silently diverge — e.g. after
+     * a `DI.clearCache()` the store written via a freshly-resolved instance would
+     * be invisible here ).
+     */
+    private storage;
+    /**
+     * The current ambient store, or an empty object when outside any context.
+     */
+    active(): Record<string, unknown>;
+    /**
+     * Run `fn` with `vars` merged ( copy-on-write ) onto the current store, so
+     * nesting accumulates and http's already-set fields ( eg. requestId ) survive.
+     */
+    with<T>(vars: Record<string, unknown>, fn: () => T): T;
+    /**
+     * Mutate the current store in place ( late-bound values ). No-op when called
+     * outside any active context.
+     */
+    set(key: string, value: unknown): void;
+    /**
+     * Capture the current store and re-attach it whenever the returned function is
+     * invoked. Use to carry context across detached callbacks / EventEmitter
+     * handlers that would otherwise lose it.
+     */
+    bind<A extends unknown[], R>(fn: (...a: A) => R): (...a: A) => R;
+}
+/**
+ * Shared ambient log context. See {@link LogContextImpl}.
+ */
+export declare const LogContext: LogContextImpl;
+/**
+ * Projects only primitive scalar values ( string / number / boolean / bigint )
+ * from an ambient-context object, dropping objects, arrays, Dates, functions,
+ * null and undefined. Ambient context is meant for correlation ids ( requestId,
+ * traceId, ... ) that belong on every log line; structured payloads should be
+ * passed explicitly per call ( log.info({ obj }, ... ) ), not via ambient context.
+ */
+export declare function scalarContext(ctx: Record<string, unknown>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/lib/mjs/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,cAAM,cAAc;IAClB;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO;IAIf;;OAEG;IACI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIxC;;;OAGG;IACI,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI7D;;;OAGG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAO7C;;;;OAIG;IACI,IAAI,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;CAOxE;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,gBAAuB,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASnF"}

package/lib/mjs/context.js

@@ -0,0 +1,88 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { DI } from "@spinajs/di";
+/**
+ * Ambient log context backed by `node:async_hooks` AsyncLocalStorage.
+ *
+ * It deliberately resolves the SAME DI-singleton AsyncLocalStorage instance the
+ * @spinajs/http module runs per action ( `als.run(req.storage, ...)` ). Because
+ * that instance is a shared DI singleton, any log emitted anywhere inside a
+ * request automatically inherits the request store ( requestId, realIp, ... )
+ * with zero threading — the log package wires `setLogContextProvider(() =>
+ * LogContext.active())` so `createLogMessageObject` merges it at lowest
+ * precedence.
+ *
+ * The store type is a plain `Record<string, unknown>` — a superset of http's
+ * `IActionLocalStoregeContext` — so log stays independent of http.
+ */
+class LogContextImpl {
+    /**
+     * Resolve the shared AsyncLocalStorage from DI. Resolved as a bare concrete
+     * class it is a shared singleton, so this is the very instance http drives per
+     * action. We deliberately do NOT cache the reference: DI returns the same
+     * singleton on every call ( cheap lookup ), and NOT caching keeps LogContext
+     * consistent with the current DI instance even if the container is reset /
+     * re-registered ( a stale cached reference would silently diverge — e.g. after
+     * a `DI.clearCache()` the store written via a freshly-resolved instance would
+     * be invisible here ).
+     */
+    storage() {
+        return DI.resolve(AsyncLocalStorage);
+    }
+    /**
+     * The current ambient store, or an empty object when outside any context.
+     */
+    active() {
+        return this.storage().getStore() ?? {};
+    }
+    /**
+     * Run `fn` with `vars` merged ( copy-on-write ) onto the current store, so
+     * nesting accumulates and http's already-set fields ( eg. requestId ) survive.
+     */
+    with(vars, fn) {
+        return this.storage().run({ ...this.active(), ...vars }, fn);
+    }
+    /**
+     * Mutate the current store in place ( late-bound values ). No-op when called
+     * outside any active context.
+     */
+    set(key, value) {
+        const store = this.storage().getStore();
+        if (store) {
+            store[key] = value;
+        }
+    }
+    /**
+     * Capture the current store and re-attach it whenever the returned function is
+     * invoked. Use to carry context across detached callbacks / EventEmitter
+     * handlers that would otherwise lose it.
+     */
+    bind(fn) {
+        const store = this.storage().getStore();
+        if (!store) {
+            return fn;
+        }
+        return (...args) => this.storage().run(store, () => fn(...args));
+    }
+}
+/**
+ * Shared ambient log context. See {@link LogContextImpl}.
+ */
+export const LogContext = new LogContextImpl();
+/**
+ * Projects only primitive scalar values ( string / number / boolean / bigint )
+ * from an ambient-context object, dropping objects, arrays, Dates, functions,
+ * null and undefined. Ambient context is meant for correlation ids ( requestId,
+ * traceId, ... ) that belong on every log line; structured payloads should be
+ * passed explicitly per call ( log.info({ obj }, ... ) ), not via ambient context.
+ */
+export function scalarContext(ctx) {
+    const out = {};
+    for (const [k, v] of Object.entries(ctx)) {
+        const t = typeof v;
+        if (t === "string" || t === "number" || t === "boolean" || t === "bigint") {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=context.js.map

package/lib/mjs/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,MAAM,cAAc;IAClB;;;;;;;;;OASG;IACK,OAAO;QACb,OAAO,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAA+C,CAAC;IACrF,CAAC;IAED;;OAEG;IACI,MAAM;QACX,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED;;;OAGG;IACI,IAAI,CAAI,IAA6B,EAAE,EAAW;QACvD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,GAAW,EAAE,KAAc;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAyB,EAAkB;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,GAAG,IAAO,EAAK,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAA4B;IACxD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1E,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/mjs/filters/LevelFilter.d.ts

@@ -0,0 +1,24 @@
+import { ILogEntry, ILogFilterOptions, LogFilter, LogLevel, StrToLogLevel } from "@spinajs/log-common";
+type LevelName = keyof typeof StrToLogLevel;
+/**
+ * Options for {@link LevelFilter}.
+ */
+export interface ILevelFilterOptions extends ILogFilterOptions {
+    /** Lowest level to keep ( inclusive ). Entries below are dropped. */
+    min?: LevelName;
+    /** Highest level to keep ( inclusive ). Entries above are dropped. */
+    max?: LevelName;
+}
+/**
+ * Level-window filter. Keeps an entry only when its numeric {@link LogLevel} is
+ * within `[min, max]` ( both inclusive, both optional ), otherwise drops it.
+ * Useful for routing eg. only warn..error to a given target via a filter.
+ */
+export declare class LevelFilter extends LogFilter {
+    protected min: LogLevel;
+    protected max: LogLevel;
+    constructor(options?: ILevelFilterOptions);
+    apply(entry: ILogEntry): ILogEntry | null;
+}
+export {};
+//# sourceMappingURL=LevelFilter.d.ts.map

package/lib/mjs/filters/LevelFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LevelFilter.d.ts","sourceRoot":"","sources":["../../../src/filters/LevelFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGvG,KAAK,SAAS,GAAG,MAAM,OAAO,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,qEAAqE;IACrE,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAEa,WAAY,SAAQ,SAAS;IACxC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC;IACxB,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC;gBAEZ,OAAO,CAAC,EAAE,mBAAmB;IAMlC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;CAMjD"}

package/lib/mjs/filters/LevelFilter.js

@@ -0,0 +1,36 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { LogFilter, LogLevel, StrToLogLevel } from "@spinajs/log-common";
+import { Injectable, NewInstance } from "@spinajs/di";
+/**
+ * Level-window filter. Keeps an entry only when its numeric {@link LogLevel} is
+ * within `[min, max]` ( both inclusive, both optional ), otherwise drops it.
+ * Useful for routing eg. only warn..error to a given target via a filter.
+ */
+let LevelFilter = class LevelFilter extends LogFilter {
+    constructor(options) {
+        super(options);
+        this.min = options?.min !== undefined ? StrToLogLevel[options.min] : LogLevel.Trace;
+        this.max = options?.max !== undefined ? StrToLogLevel[options.max] : LogLevel.Security;
+    }
+    apply(entry) {
+        if (entry.Level < this.min || entry.Level > this.max) {
+            return null;
+        }
+        return entry;
+    }
+};
+LevelFilter = __decorate([
+    Injectable("LevelFilter"),
+    NewInstance(),
+    __metadata("design:paramtypes", [Object])
+], LevelFilter);
+export { LevelFilter };
+//# sourceMappingURL=LevelFilter.js.map

package/lib/mjs/filters/LevelFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LevelFilter.js","sourceRoot":"","sources":["../../../src/filters/LevelFilter.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAgC,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AActD;;;;GAIG;AAGI,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,SAAS;IAIxC,YAAY,OAA6B;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QACpF,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACzF,CAAC;IAEM,KAAK,CAAC,KAAgB;QAC3B,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAhBY,WAAW;IAFvB,UAAU,CAAC,aAAa,CAAC;IACzB,WAAW,EAAE;;GACD,WAAW,CAgBvB"}

package/lib/mjs/filters/MatchFilter.d.ts

@@ -0,0 +1,30 @@
+import { ILogEntry, ILogFilterOptions, LogFilter } from "@spinajs/log-common";
+/**
+ * Options for {@link MatchFilter}.
+ */
+export interface IMatchFilterOptions extends ILogFilterOptions {
+    /** Regex source tested against the chosen field. Required. */
+    pattern: string;
+    /** Variable field to test. Default "message". */
+    field?: string;
+    /** "keep" ( default ) keeps on match, drops otherwise; "drop" drops on match. */
+    mode?: "keep" | "drop";
+    /** RegExp flags ( eg. "i" ). */
+    flags?: string;
+}
+/**
+ * Regex keep/drop filter. Builds a RegExp from `pattern`/`flags` and tests it
+ * against `String(entry.Variables[field])` ( field defaults to "message" ).
+ * In "keep" mode the entry is kept only on a match; in "drop" mode it is
+ * dropped on a match. An invalid pattern degrades to a no-op ( pass-through )
+ * and warns ONCE so a bad config never silently swallows or drops everything.
+ */
+export declare class MatchFilter extends LogFilter {
+    protected regex: RegExp | null;
+    protected field: string;
+    protected mode: "keep" | "drop";
+    protected warned: boolean;
+    constructor(options?: IMatchFilterOptions);
+    apply(entry: ILogEntry): ILogEntry | null;
+}
+//# sourceMappingURL=MatchFilter.d.ts.map

package/lib/mjs/filters/MatchFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatchFilter.d.ts","sourceRoot":"","sources":["../../../src/filters/MatchFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG9E;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAEa,WAAY,SAAQ,SAAS;IACxC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IACtC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,SAAS,CAAC,MAAM,UAAS;gBAEb,OAAO,CAAC,EAAE,mBAAmB;IAqBlC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;CAejD"}