@spinajs/log 2.0.481 → 2.0.482

package/lib/mjs/archive/strategies/util.js

@@ -0,0 +1,54 @@
+import { posix } from "path";
+/**
+ * Prefix every archived file name gets. Only files under `archiveDir` starting
+ * with this prefix are considered archives ( so the active log dir, when it is
+ * the same directory as the archive dir, is not touched ).
+ */
+export const ARCHIVE_PREFIX = "archived_";
+/**
+ * Joins archive dir + file name with forward slashes. fs providers resolve
+ * paths against their base path and normalize separators, so a posix join keeps
+ * behaviour identical across platforms.
+ */
+export function archivePath(ctx, name) {
+    return ctx.archiveDir ? posix.join(ctx.archiveDir, name) : name;
+}
+/**
+ * Lists archive files in `ctx.archiveDir` on `ctx.archiveFs`, sorted ascending
+ * by modification time ( oldest first, newest last ). Only files carrying the
+ * archive prefix are returned; directories and unrelated files are ignored.
+ */
+export async function listArchives(ctx) {
+    let names;
+    try {
+        names = await ctx.archiveFs.list(ctx.archiveDir || "/");
+    }
+    catch {
+        // archive dir may not exist yet ( nothing rotated )
+        return [];
+    }
+    const entries = [];
+    for (const name of names) {
+        if (!name.startsWith(ARCHIVE_PREFIX)) {
+            continue;
+        }
+        const p = archivePath(ctx, name);
+        try {
+            const stat = await ctx.archiveFs.stat(p);
+            if (stat.IsDirectory) {
+                continue;
+            }
+            entries.push({ path: p, stat });
+        }
+        catch {
+            // stat can fail on a file removed concurrently - skip it
+        }
+    }
+    entries.sort((a, b) => {
+        const at = a.stat.ModifiedTime?.toMillis() ?? 0;
+        const bt = b.stat.ModifiedTime?.toMillis() ?? 0;
+        return at - bt;
+    });
+    return entries;
+}
+//# sourceMappingURL=util.js.map

package/lib/mjs/archive/strategies/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../src/archive/strategies/util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAG7B;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAU1C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAuB,EAAE,IAAY;IAC/D,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAuB;IACxD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;QACpD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChD,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,YAAY,EAAM,MAAM,aAAa,CAAC;AA4B3D,qBACa,cAAe,SAAQ,YAAY;IACvC,SAAS,IAAI,IAAI;CAczB"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,YAAY,EAAM,MAAM,aAAa,CAAC;AAkC3D,qBACa,cAAe,SAAQ,YAAY;IACvC,SAAS,IAAI,IAAI;CAmCzB"}

package/lib/mjs/bootstrap.js

@@ -6,7 +6,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { Configuration } from "@spinajs/configuration";
 import { Injectable, Bootstrapper, DI } from "@spinajs/di";
-import { Log } from "@spinajs/log-common";
+import { Log, setLogContextProvider } from "@spinajs/log-common";
+import { LogContext, scalarContext } from "./context.js";
+import { wirePerfScope } from "./perf.js";
 import CONFIGURATION_SCHEMA from "./schemas/log.configuration.js";
 const uncaughtExceptionHandler = (err) => {
     // if we have configuration resolved, we can assume that logger can read configuration
@@ -32,15 +34,36 @@ const unhandledRejection = (reason, p) => {
         console.error("Unhandled rejection: \n reason: " + reason.message + " \n stack:" + reason.stack);
     }
 };
+// Guard so a double bootstrap ( eg. re-run in the same process ) does not
+// register the beforeExit drain twice.
+let beforeExitAttached = false;
 let LogBotstrapper = class LogBotstrapper extends Bootstrapper {
     bootstrap() {
         DI.register(CONFIGURATION_SCHEMA).asValue("__configurationSchema__");
+        // Best-effort teardown drain: on a CLEAN process exit, force-flush every
+        // logger's targets so buffered File / Loki / OTLP entries are written out.
+        // beforeExit does NOT run on hard exits ( process.exit / signals / crashes ),
+        // so this only catches clean drains. Node-only ( guard mirrors
+        // internal-logger ); do not double-register.
+        if (!beforeExitAttached && typeof process !== "undefined" && typeof process.on === "function") {
+            beforeExitAttached = true;
+            process.on("beforeExit", () => {
+                void Log.flushAll();
+            });
+        }
+        // Feed the ambient async-context store into every log entry ( merged at
+        // lowest precedence by createLogMessageObject ). LogContext resolves the
+        // same DI-singleton AsyncLocalStorage the http module runs per action, so
+        // logs inherit requestId / realIp / ... for free.
+        setLogContextProvider(() => scalarContext(LogContext.active()));
+        // Wire the per-request perf accumulator onto the same async store.
+        wirePerfScope();
         // check if we run tests,
         // hook for uncaughtException causes to not showing
         // mocha errors in console
         if (!process.env.TESTING) {
             process.removeListener("uncaughtException", uncaughtExceptionHandler);
-            process.removeListener("unhandledRejection", uncaughtExceptionHandler);
+            process.removeListener("unhandledRejection", unhandledRejection);
             process.on("uncaughtException", uncaughtExceptionHandler);
             process.on("unhandledRejection", unhandledRejection);
         }

package/lib/mjs/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,oBAAoB,MAAM,gCAAgC,CAAC;AAElE,MAAM,wBAAwB,GAAG,CAAC,GAAU,EAAE,EAAE;IAC9C,sFAAsF;IACtF,wBAAwB;IACxB,wBAAwB;IACxB,IAAI,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,GAAG,CAAC,OAAO,GAAG,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAAa,EAAE,CAAmB,EAAE,EAAE;IAChE,sFAAsF;IACtF,wBAAwB;IACxB,wBAAwB;IACxB,IAAI,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,KAAK,CAAC,MAAe,EAAE,mCAAmC,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,MAAM,CAAC,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnG,CAAC;AACH,CAAC,CAAC;AAGK,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,YAAY;IACvC,SAAS;QACd,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAErE,yBAAyB;QACzB,mDAAmD;QACnD,0BAA0B;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC;YACtE,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC;YAEvE,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC;YAC1D,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAA;AAfY,cAAc;IAD1B,UAAU,CAAC,YAAY,CAAC;GACZ,cAAc,CAe1B"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,oBAAoB,MAAM,gCAAgC,CAAC;AAElE,MAAM,wBAAwB,GAAG,CAAC,GAAU,EAAE,EAAE;IAC9C,sFAAsF;IACtF,wBAAwB;IACxB,wBAAwB;IACxB,IAAI,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,GAAG,CAAC,OAAO,GAAG,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAAa,EAAE,CAAmB,EAAE,EAAE;IAChE,sFAAsF;IACtF,wBAAwB;IACxB,wBAAwB;IACxB,IAAI,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,KAAK,CAAC,MAAe,EAAE,mCAAmC,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,MAAM,CAAC,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnG,CAAC;AACH,CAAC,CAAC;AAEF,0EAA0E;AAC1E,uCAAuC;AACvC,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAGxB,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,YAAY;IACvC,SAAS;QACd,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAErE,yEAAyE;QACzE,2EAA2E;QAC3E,8EAA8E;QAC9E,+DAA+D;QAC/D,6CAA6C;QAC7C,IAAI,CAAC,kBAAkB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;YAC9F,kBAAkB,GAAG,IAAI,CAAC;YAC1B,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;gBAC5B,KAAK,GAAG,CAAC,QAAQ,EAAE,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,kDAAkD;QAClD,qBAAqB,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEhE,mEAAmE;QACnE,aAAa,EAAE,CAAC;QAEhB,yBAAyB;QACzB,mDAAmD;QACnD,0BAA0B;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC;YACtE,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;YAEjE,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC;YAC1D,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAA;AApCY,cAAc;IAD1B,UAAU,CAAC,YAAY,CAAC;GACZ,cAAc,CAoC1B"}

package/lib/mjs/callsite.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 declare function captureCallsite(): string;
+//# sourceMappingURL=callsite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callsite.d.ts","sourceRoot":"","sources":["../../src/callsite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAmCxC"}

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"}