lograil 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This file is generated from git history by `scripts/gen-changelog.mjs` (run via `yarn changelog`) and refreshed automatically on each release.
+
+## [Unreleased] - 2026-08-29
+
+- fix(docs): 更新 GitHub 链接以指向正确的仓库
+- feat: define immutable LogEntry contract and zero-copy IPC transfer
+- feat(logger): 添加异步插件拦截顺序处理，确保传输队列独立，避免阻塞
+- feat: add P1 features (stderrLevels, JSON flatten, serializer/redact presets, env level & namespace filter, OTel trace plugin)
+- feat(logger): 添加全局错误处理和超时机制，确保内部错误不会导致调用方崩溃
+- feat(docs): 更新文档以添加新功能和示例，包括上下文导出、传输器过滤器和生产模式示例
+- feat(sampler): 添加采样器以降低日志量，支持概率采样和限速策略
+- feat(logger): 添加子 logger 支持，合并上下文并允许级别覆盖 feat(otlp): 映射 traceId/spanId 上下文到 OTLP 追踪字段 test: 添加子 logger 和 OTLP 传输器的单元测试
+- feat(transport): 添加 onError 钩子以处理写入失败的情况
+- feat(transport): 添加 OtlpTransport 以支持通过 OTLP HTTP/JSON 转发日志
+- feat(processor): 添加序列化处理器以在格式化前归一化值
+- feat(transport): add optional minimum level for transports to filter log entries
+- feat(core): add crash capture, console bridge and exit auto-flush
+- feat(context): ambient async context via AsyncLocalStorage with browser no-op
+- feat(redact): support path/wildcard redaction over context, metadata and args
+- test: 更新日志文件名称检查以确保包含 Lograil 和文件类型
+- feat: 更新 Electron 运行时以支持主进程和渲染进程的独立日志文件
+- feat: 增加 logo
+- feat: refactor CI and release workflows to use a shared verification pipeline
+- test: increase timeout for daily log rotation test
+- chore: add lint:fix and format scripts to package.json
+- fix: update GitHub token reference in workflows for docs deployment
+- feat: add release workflow for versioned publishing and docs deployment
+- feat: add AGENTS.md for AI coding agent guidance and project setup
+- docs: update repository references from electron-logger to lograil
+- chore: update electron dev deps
+- feat: add .gitattributes for consistent line endings and binary file handling
+- feat: init
+- Create README.md
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Axetroy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+<div align="center">
+  <img src="./logo.svg" alt="lograil" width="128" height="128" />
+</div>
+
+# lograil
+
+Structured, secure logging for **Web**, **Node.js**, and **Electron** — three first-class runtimes, one zero-config `logger`, pluggable transports, filters, processors, formatters, and plugins. Extend to any other platform through the plugin and runtime-adapter APIs.
+
+The same `import { logger } from 'lograil'` works untouched in every runtime. On Electron, the main process writes logs to the console **and** daily rotating files, and renderer logs are forwarded over IPC automatically; on Node it persists to a rotating file by default; in the browser it speaks the console and any remote transport you add.
+
+## Install
+
+```bash
+npm install lograil
+# yarn / pnpm / bun add lograil
+```
+
+## Quick start
+
+```ts
+import { logger } from 'lograil';
+
+logger.info('app started', { version: '1.0.0' });
+logger.error(new Error('something went wrong'));
+```
+
+Need custom behavior? Use `createLogger({ level, pipeline, transports, runtime })` and the plugin API.
+
+## Documentation
+
+Full guides, API reference, and examples are on the **docs site**:
+
+**https://axetroy.github.io/lograil/**
+
+- Getting started · Configuration · Transports · Plugins
+- Runtimes (Web, Node.js, Electron) & extending to others via plugins
+
+## License
+
+MIT

package/dist/cjs/context/async-context.browser.d.ts

@@ -0,0 +1,16 @@
+export type AmbientContext = Record<string, unknown>;
+/**
+ * Browser / non-Node stub. `AsyncLocalStorage` is unavailable here, so ambient
+ * context is a no-op — logs are unaffected and no context propagates. The real
+ * implementation (`async-context.ts`) is selected over this file in Node builds
+ * via the `browser` field in `package.json`.
+ */
+export declare const asyncContext: {
+    run<T>(fn: () => T, _context: AmbientContext): T;
+    runAsync<T>(fn: () => Promise<T>, _context: AmbientContext): Promise<T>;
+    get(): AmbientContext;
+    supported(): boolean;
+};
+/** Run `fn` with `context` active as the ambient logging context (no-op outside Node). */
+export declare function runWithContext<T>(fn: () => T, _context: AmbientContext): T;
+//# sourceMappingURL=async-context.browser.d.ts.map

package/dist/cjs/context/async-context.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.browser.d.ts","sourceRoot":"","sources":["../../../src/context/async-context.browser.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;QACnB,CAAC,MAAM,MAAM,CAAC,YAAY,cAAc,GAAG,CAAC;aAGvC,CAAC,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;WAGhE,cAAc;iBAGR,OAAO;CAGrB,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,CAAC,CAE1E"}

package/dist/cjs/context/async-context.browser.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asyncContext = void 0;
+exports.runWithContext = runWithContext;
+/**
+ * Browser / non-Node stub. `AsyncLocalStorage` is unavailable here, so ambient
+ * context is a no-op — logs are unaffected and no context propagates. The real
+ * implementation (`async-context.ts`) is selected over this file in Node builds
+ * via the `browser` field in `package.json`.
+ */
+exports.asyncContext = {
+    run(fn, _context) {
+        return fn();
+    },
+    runAsync(fn, _context) {
+        return fn();
+    },
+    get() {
+        return {};
+    },
+    supported() {
+        return false;
+    },
+};
+/** Run `fn` with `context` active as the ambient logging context (no-op outside Node). */
+function runWithContext(fn, _context) {
+    return fn();
+}
+//# sourceMappingURL=async-context.browser.js.map

package/dist/cjs/context/async-context.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.browser.js","sourceRoot":"","sources":["../../../src/context/async-context.browser.ts"],"names":[],"mappings":";;;AAwBA,wCAEC;AAxBD;;;;;GAKG;AACU,QAAA,YAAY,GAAG;IAC1B,GAAG,CAAI,EAAW,EAAE,QAAwB;QAC1C,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,QAAQ,CAAI,EAAoB,EAAE,QAAwB;QACxD,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,GAAG;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,SAAS;QACP,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF,0FAA0F;AAC1F,SAAgB,cAAc,CAAI,EAAW,EAAE,QAAwB;IACrE,OAAO,EAAE,EAAE,CAAC;AACd,CAAC"}

package/dist/cjs/context/async-context.d.ts

@@ -0,0 +1,10 @@
+export type AmbientContext = Record<string, unknown>;
+export declare const asyncContext: {
+    run<T>(fn: () => T, context: AmbientContext): T;
+    runAsync<T>(fn: () => Promise<T>, context: AmbientContext): Promise<T>;
+    get(): AmbientContext;
+    supported(): boolean;
+};
+/** Run `fn` with `context` active as the ambient logging context. */
+export declare function runWithContext<T>(fn: () => T, context: AmbientContext): T;
+//# sourceMappingURL=async-context.d.ts.map

package/dist/cjs/context/async-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.d.ts","sourceRoot":"","sources":["../../../src/context/async-context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAerD,eAAO,MAAM,YAAY;QACnB,CAAC,MAAM,MAAM,CAAC,WAAW,cAAc,GAAG,CAAC;aAGtC,CAAC,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,WAAW,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;WAG/D,cAAc;iBAGR,OAAO;CAGrB,CAAC;AAIF,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,CAAC,CAEzE"}

package/dist/cjs/context/async-context.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asyncContext = void 0;
+exports.runWithContext = runWithContext;
+const node_async_hooks_1 = require("node:async_hooks");
+/**
+ * Ambient (request-scoped) context propagation.
+ *
+ * Built on `AsyncLocalStorage`, so a context set with {@link runWithContext}
+ * is automatically visible to **every** log call inside `fn` — including those
+ * reached after `await` — without manual plumbing. In non-Node runtimes this
+ * module is swapped for `async-context.browser.js` (via `package.json` `browser`)
+ * which is a no-op, so the API is safe to call everywhere.
+ */
+// Shared frozen empty object returned when no async store is active, so the
+// common (no ambient context) path allocates nothing on every `get()`.
+const EMPTY_AMBIENT = Object.freeze({});
+exports.asyncContext = {
+    run(fn, context) {
+        return storage.run(context, fn);
+    },
+    runAsync(fn, context) {
+        return storage.run(context, fn);
+    },
+    get() {
+        return storage.getStore() ?? EMPTY_AMBIENT;
+    },
+    supported() {
+        return true;
+    },
+};
+const storage = new node_async_hooks_1.AsyncLocalStorage();
+/** Run `fn` with `context` active as the ambient logging context. */
+function runWithContext(fn, context) {
+    return exports.asyncContext.run(fn, context);
+}
+//# sourceMappingURL=async-context.js.map

package/dist/cjs/context/async-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.js","sourceRoot":"","sources":["../../../src/context/async-context.ts"],"names":[],"mappings":";;;AAmCA,wCAEC;AArCD,uDAAqD;AAIrD;;;;;;;;GAQG;AACH,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,aAAa,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE3C,QAAA,YAAY,GAAG;IAC1B,GAAG,CAAI,EAAW,EAAE,OAAuB;QACzC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,QAAQ,CAAI,EAAoB,EAAE,OAAuB;QACvD,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,GAAG;QACD,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,aAAa,CAAC;IAC7C,CAAC;IACD,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,oCAAiB,EAAkB,CAAC;AAExD,qEAAqE;AACrE,SAAgB,cAAc,CAAI,EAAW,EAAE,OAAuB;IACpE,OAAO,oBAAY,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/cjs/context/context.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Context module.
+ *
+ * Manages structured contextual data (request id, user id, window id, etc.)
+ * that is attached to every log entry. Contexts are hierarchical:
+ * a global context provides defaults for all loggers, and child loggers
+ * can carry their own scoped context.
+ */
+export interface ContextStore {
+    /** Read the full context object. */
+    get(): Record<string, unknown>;
+    /** Set a single key. */
+    set(key: string, value: unknown): void;
+    /** Merge multiple keys at once. Returns the store for chaining. */
+    merge(values: Record<string, unknown>): ContextStore;
+    /** Remove a single key. */
+    delete(key: string): void;
+    /** Reset the store to empty. */
+    clear(): void;
+    /** Create a child store seeded with the current values. */
+    child(): ContextStore;
+}
+/**
+ * A shared, frozen empty record. Returned by `ContextStore.get()` when empty
+ * and used as the default `metadata` for every entry, so the hot path never
+ * allocates an empty object — and `freezeEntry` can recognise it as a sentinel
+ * and skip cloning/freezing entirely.
+ */
+export declare const EMPTY_RECORD: Record<string, unknown>;
+/** True when the record has no own enumerable keys. */
+export declare function isEmptyRecord(o: Record<string, unknown>): boolean;
+export declare function createContextStore(initial?: Record<string, unknown>): ContextStore;
+//# sourceMappingURL=context.d.ts.map

package/dist/cjs/context/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context/context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,wBAAwB;IACxB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,mEAAmE;IACnE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC;IACrD,2BAA2B;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gCAAgC;IAChC,KAAK,IAAI,IAAI,CAAC;IACd,2DAA2D;IAC3D,KAAK,IAAI,YAAY,CAAC;CACvB;AAID;;;;;GAKG;AACH,eAAO,MAAM,YAAY,yBAAgB,CAAC;AAE1C,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAGjE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CA6BlF"}

package/dist/cjs/context/context.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Context module.
+ *
+ * Manages structured contextual data (request id, user id, window id, etc.)
+ * that is attached to every log entry. Contexts are hierarchical:
+ * a global context provides defaults for all loggers, and child loggers
+ * can carry their own scoped context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_RECORD = void 0;
+exports.isEmptyRecord = isEmptyRecord;
+exports.createContextStore = createContextStore;
+const EMPTY_CONTEXT = Object.freeze({});
+/**
+ * A shared, frozen empty record. Returned by `ContextStore.get()` when empty
+ * and used as the default `metadata` for every entry, so the hot path never
+ * allocates an empty object — and `freezeEntry` can recognise it as a sentinel
+ * and skip cloning/freezing entirely.
+ */
+exports.EMPTY_RECORD = EMPTY_CONTEXT;
+/** True when the record has no own enumerable keys. */
+function isEmptyRecord(o) {
+    for (const _k in o)
+        return false;
+    return true;
+}
+function createContextStore(initial) {
+    let data = { ...(initial ?? {}) };
+    const store = {
+        get() {
+            // Avoid cloning (and allocating) when the store is empty — the shared
+            // frozen object can never be mutated by callers.
+            for (const _k in data)
+                return { ...data };
+            return EMPTY_CONTEXT;
+        },
+        set(key, value) {
+            data[key] = value;
+        },
+        merge(values) {
+            data = { ...data, ...values };
+            return store;
+        },
+        delete(key) {
+            delete data[key];
+        },
+        clear() {
+            data = {};
+        },
+        child() {
+            return createContextStore(data);
+        },
+    };
+    return store;
+}
+//# sourceMappingURL=context.js.map

package/dist/cjs/context/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/context/context.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA4BH,sCAGC;AAED,gDA6BC;AA7CD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAA4B,CAAC;AAEnE;;;;;GAKG;AACU,QAAA,YAAY,GAAG,aAAa,CAAC;AAE1C,uDAAuD;AACvD,SAAgB,aAAa,CAAC,CAA0B;IACtD,KAAK,MAAM,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAAiC;IAClE,IAAI,IAAI,GAA4B,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAE3D,MAAM,KAAK,GAAiB;QAC1B,GAAG;YACD,sEAAsE;YACtE,iDAAiD;YACjD,KAAK,MAAM,EAAE,IAAI,IAAI;gBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;YAC1C,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,KAAK;YACZ,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,MAAM;YACV,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,CAAC,GAAG;YACR,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,KAAK;YACH,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,KAAK;YACH,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cjs/context/index.d.ts

@@ -0,0 +1,3 @@
+export * from './context.js';
+export * from './async-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/cjs/context/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context.js"), exports);
+__exportStar(require("./async-context.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,qDAAmC"}

package/dist/cjs/core/entry.d.ts

@@ -0,0 +1,30 @@
+import type { LogEntry } from '../types.js';
+/**
+ * An entry that has crossed the immutability boundary: the entry itself and its
+ * `context`, `metadata` and `args` containers are frozen. Nested values are
+ * intentionally NOT deep-frozen (that would defeat the zero-copy goal) and must
+ * be treated as immutable by convention.
+ */
+export type FrozenLogEntry = Readonly<LogEntry> & {
+    readonly context: Readonly<Record<string, unknown>>;
+    readonly metadata: Readonly<Record<string, unknown>>;
+    readonly args: readonly unknown[];
+};
+/**
+ * Freeze a {@link LogEntry} at its transport boundary so it can be shared by
+ * reference (zero-copy) across all transports, plugins and formatters without
+ * any of them being able to mutate it.
+ *
+ * Behaviour:
+ * - The entry and its `context` / `metadata` / `args` containers are frozen.
+ * - When `context` is the logger's *live* ambient context (not already a frozen,
+ *   safe object) it is first copied into a fresh frozen snapshot. This prevents
+ *   us from freezing the logger's shared state and ensures an already-emitted
+ *   entry can never be mutated by a later `setContext`.
+ * - It is a no-op (and idempotent) when the entry is already frozen.
+ *
+ * Nested values are left unfrozen on purpose: deep-freezing a potentially large
+ * object graph on every log call would erase the zero-copy performance benefit.
+ */
+export declare function freezeEntry<T extends LogEntry>(entry: T): T & FrozenLogEntry;
+//# sourceMappingURL=entry.d.ts.map

package/dist/cjs/core/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../src/core/entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG;IAChD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,cAAc,CAiB5E"}

package/dist/cjs/core/entry.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.freezeEntry = freezeEntry;
+const context_js_1 = require("../context/context.js");
+/**
+ * Freeze a {@link LogEntry} at its transport boundary so it can be shared by
+ * reference (zero-copy) across all transports, plugins and formatters without
+ * any of them being able to mutate it.
+ *
+ * Behaviour:
+ * - The entry and its `context` / `metadata` / `args` containers are frozen.
+ * - When `context` is the logger's *live* ambient context (not already a frozen,
+ *   safe object) it is first copied into a fresh frozen snapshot. This prevents
+ *   us from freezing the logger's shared state and ensures an already-emitted
+ *   entry can never be mutated by a later `setContext`.
+ * - It is a no-op (and idempotent) when the entry is already frozen.
+ *
+ * Nested values are left unfrozen on purpose: deep-freezing a potentially large
+ * object graph on every log call would erase the zero-copy performance benefit.
+ */
+function freezeEntry(entry) {
+    if (Object.isFrozen(entry))
+        return entry;
+    const ctx = entry.context;
+    const meta = entry.metadata;
+    entry.context =
+        ctx === context_js_1.EMPTY_RECORD || Object.isFrozen(ctx) ? ctx : Object.freeze({ ...ctx });
+    // Skip cloning/freezing when empty: the shared `EMPTY_RECORD` sentinel is
+    // already frozen and reused by reference, so the common (no-metadata) path
+    // allocates nothing here.
+    entry.metadata =
+        meta === context_js_1.EMPTY_RECORD || Object.isFrozen(meta) ? meta : Object.freeze({ ...meta });
+    if (!Object.isFrozen(entry.args))
+        Object.freeze(entry.args);
+    return Object.freeze(entry);
+}
+//# sourceMappingURL=entry.js.map

package/dist/cjs/core/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/core/entry.ts"],"names":[],"mappings":";;AA+BA,kCAiBC;AA/CD,sDAAqD;AAcrD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,WAAW,CAAqB,KAAQ;IACtD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAA2B,CAAC;IAE/D,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC3B,KAA8C,CAAC,OAAO;QACrD,GAAG,KAAK,yBAAY,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IAEjF,0EAA0E;IAC1E,2EAA2E;IAC3E,0BAA0B;IACzB,KAA+C,CAAC,QAAQ;QACvD,IAAI,KAAK,yBAAY,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAErF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAuB,CAAC;AACpD,CAAC"}

package/dist/cjs/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from './level.js';
+export * from './logger.js';
+export * from './entry.js';
+export * from './printf.js';
+export { Pipeline } from '../pipeline/pipeline.js';
+export type { PipelineOptions } from '../pipeline/pipeline.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cjs/core/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pipeline = void 0;
+__exportStar(require("./level.js"), exports);
+__exportStar(require("./logger.js"), exports);
+__exportStar(require("./entry.js"), exports);
+__exportStar(require("./printf.js"), exports);
+var pipeline_js_1 = require("../pipeline/pipeline.js");
+Object.defineProperty(exports, "Pipeline", { enumerable: true, get: function () { return pipeline_js_1.Pipeline; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,6CAA2B;AAC3B,8CAA4B;AAC5B,uDAAmD;AAA1C,uGAAA,QAAQ,OAAA"}

package/dist/cjs/core/level.d.ts

@@ -0,0 +1,12 @@
+import type { LogLevelName, LogLevelValue, LogLevelInput } from '../types.js';
+import { LOG_LEVELS } from '../types.js';
+export { LOG_LEVELS };
+export type { LogLevelName, LogLevelValue, LogLevelInput };
+/**
+ * Resolve a level name from a numeric value, falling back to the closest
+ * lower-known level when the exact value is not registered.
+ */
+export declare function levelNameFromValue(value: LogLevelValue): LogLevelName;
+export declare function compareLevel(a: LogLevelInput, b: LogLevelInput): number;
+export declare function isLevelEnabled(configured: LogLevelInput, candidate: LogLevelInput): boolean;
+//# sourceMappingURL=level.d.ts.map

package/dist/cjs/core/level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.d.ts","sourceRoot":"","sources":["../../../src/core/level.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAWrE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAEvE;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAE3F"}

package/dist/cjs/core/level.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_LEVELS = void 0;
+exports.levelNameFromValue = levelNameFromValue;
+exports.compareLevel = compareLevel;
+exports.isLevelEnabled = isLevelEnabled;
+const types_js_1 = require("../types.js");
+Object.defineProperty(exports, "LOG_LEVELS", { enumerable: true, get: function () { return types_js_1.LOG_LEVELS; } });
+/**
+ * Resolve a level name from a numeric value, falling back to the closest
+ * lower-known level when the exact value is not registered.
+ */
+function levelNameFromValue(value) {
+    let best = 'trace';
+    let bestValue = -Infinity;
+    for (const name of Object.keys(types_js_1.LOG_LEVELS)) {
+        const lv = types_js_1.LOG_LEVELS[name];
+        if (lv <= value && lv > bestValue) {
+            best = name;
+            bestValue = lv;
+        }
+    }
+    return best;
+}
+function compareLevel(a, b) {
+    return (0, types_js_1.normalizeLevel)(a) - (0, types_js_1.normalizeLevel)(b);
+}
+function isLevelEnabled(configured, candidate) {
+    return (0, types_js_1.normalizeLevel)(candidate) >= (0, types_js_1.normalizeLevel)(configured);
+}
+//# sourceMappingURL=level.js.map

package/dist/cjs/core/level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.js","sourceRoot":"","sources":["../../../src/core/level.ts"],"names":[],"mappings":";;;AAWA,gDAWC;AAED,oCAEC;AAED,wCAEC;AA7BD,0CAAyD;AAEhD,2FAFA,qBAAU,OAEA;AAInB;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,KAAoB;IACrD,IAAI,IAAI,GAAiB,OAAO,CAAC;IACjC,IAAI,SAAS,GAAG,CAAC,QAAQ,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,qBAAU,CAAmB,EAAE,CAAC;QAC7D,MAAM,EAAE,GAAG,qBAAU,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAI,KAAK,IAAI,EAAE,GAAG,SAAS,EAAE,CAAC;YAClC,IAAI,GAAG,IAAI,CAAC;YACZ,SAAS,GAAG,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,YAAY,CAAC,CAAgB,EAAE,CAAgB;IAC7D,OAAO,IAAA,yBAAc,EAAC,CAAC,CAAC,GAAG,IAAA,yBAAc,EAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,cAAc,CAAC,UAAyB,EAAE,SAAwB;IAChF,OAAO,IAAA,yBAAc,EAAC,SAAS,CAAC,IAAI,IAAA,yBAAc,EAAC,UAAU,CAAC,CAAC;AACjE,CAAC"}