lograil 0.1.0

package/dist/cjs/transport/rotating-file.d.ts

@@ -0,0 +1,67 @@
+import type { LogEntry } from '../types.js';
+import type { Formatter } from '../pipeline/formatter.js';
+import type { Transport } from './transport.js';
+export interface RotatingFileTransportOptions {
+    /** Active (or current-day) log file path, e.g. `/var/log/app.log`. */
+    path: string;
+    /** Size mode: rotate once the active file exceeds this size in bytes. */
+    maxSize?: number;
+    /**
+     * Maximum number of files in the rotation set.
+     *  - Size mode: `app.log` + `app.1.log` … (generations). Minimum 2.
+     *  - Daily mode: `{name}.{YYYY-MM-DD}.01..{maxFiles}.log` per day; when the
+     *    index would pass `maxFiles` it wraps back to `01` and clears that file.
+     *    Defaults to 5 (size) or 99 (daily).
+     */
+    maxFiles?: number;
+    /**
+     * Daily mode (default `true`): one dated file per day, split into
+     * `01`..`{maxFiles}` indexes. Set `false` for plain size-based generation
+     * rotation (`app.log` → `app.1.log` → …) without dates.
+     */
+    daily?: boolean;
+    /** Override the clock (mainly for testing). Defaults to `new Date()`. */
+    now?: () => Date;
+    formatter?: Formatter;
+    name?: string;
+}
+/**
+ * File transport with rotation, for the Electron main process (Node.js).
+ *
+ * Two modes:
+ *  - **Daily** (default): the active file is
+ *    `{name}.{YYYY-MM-DD}.{index}.log`, where `index` runs `01`..`maxFiles`
+ *    (default 99). When it would pass `maxFiles` it wraps back to `01` and
+ *    that file is cleared — a `maxFiles`-file ring buffer per day. When the
+ *    local day changes, the index resets to `01` for the new day.
+ */
+export declare class RotatingFileTransport implements Transport {
+    readonly name: string;
+    readonly formatter: Formatter;
+    private readonly path;
+    private readonly maxSize;
+    private readonly maxFiles;
+    private readonly daily;
+    private readonly now;
+    private handle;
+    private queue;
+    private size;
+    private sizeInitialized;
+    private currentDate;
+    private index;
+    constructor(options: RotatingFileTransportOptions);
+    private activePath;
+    private ensureHandle;
+    private ensureSize;
+    private rotateSize;
+    /**
+     * Move to a new index file. When `clear` is true the target file is
+     * truncated first (used both for normal index advancement and for the
+     * wrap-to-01, which must clear the stale `01` slot).
+     */
+    private rotateToIndex;
+    write(_entry: LogEntry, formatted: string): void | Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=rotating-file.d.ts.map

package/dist/cjs/transport/rotating-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotating-file.d.ts","sourceRoot":"","sources":["../../../src/transport/rotating-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAaD;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,YAAW,SAAS;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,MAAM,CAAiD;IAC/D,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,KAAK,CAAK;gBAEN,OAAO,EAAE,4BAA4B;IAkBjD,OAAO,CAAC,UAAU;YAUJ,YAAY;YAOZ,UAAU;YAWV,UAAU;IAuBxB;;;;OAIG;YACW,aAAa;IAqB3B,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/cjs/transport/rotating-file.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RotatingFileTransport = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const formatter_js_1 = require("../pipeline/formatter.js");
+const DEFAULT_MAX_SIZE = 10 * 1024 * 1024;
+const DEFAULT_MAX_FILES = 5;
+const DEFAULT_MAX_FILES_DAILY = 99;
+function dateStamp(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+/**
+ * File transport with rotation, for the Electron main process (Node.js).
+ *
+ * Two modes:
+ *  - **Daily** (default): the active file is
+ *    `{name}.{YYYY-MM-DD}.{index}.log`, where `index` runs `01`..`maxFiles`
+ *    (default 99). When it would pass `maxFiles` it wraps back to `01` and
+ *    that file is cleared — a `maxFiles`-file ring buffer per day. When the
+ *    local day changes, the index resets to `01` for the new day.
+ */
+class RotatingFileTransport {
+    constructor(options) {
+        this.handle = null;
+        this.queue = Promise.resolve();
+        this.size = 0;
+        this.sizeInitialized = false;
+        this.index = 1;
+        if (!options.path) {
+            throw new Error('RotatingFileTransport requires a "path"');
+        }
+        this.path = options.path;
+        this.daily = options.daily ?? true;
+        this.maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
+        this.maxFiles = options.maxFiles ?? (this.daily ? DEFAULT_MAX_FILES_DAILY : DEFAULT_MAX_FILES);
+        if (!this.daily) {
+            this.maxFiles = Math.max(2, this.maxFiles);
+        }
+        else {
+            this.maxFiles = Math.max(1, this.maxFiles);
+        }
+        this.now = options.now ?? (() => new Date());
+        this.name = options.name ?? `rotating-file:${options.path}`;
+        this.formatter = options.formatter ?? (0, formatter_js_1.createJsonFormatter)();
+    }
+    activePath() {
+        if (!this.daily) {
+            return this.path;
+        }
+        const ext = (0, node_path_1.extname)(this.path);
+        const base = ext ? this.path.slice(0, -ext.length) : this.path;
+        const idx = String(this.index).padStart(2, '0');
+        return `${base}.${this.currentDate}.${idx}${ext}`;
+    }
+    async ensureHandle() {
+        if (!this.handle) {
+            await (0, promises_1.mkdir)((0, node_path_1.dirname)(this.activePath()), { recursive: true });
+            this.handle = await (0, promises_1.open)(this.activePath(), 'a');
+        }
+    }
+    async ensureSize() {
+        if (this.sizeInitialized)
+            return;
+        try {
+            const st = await (0, promises_1.stat)(this.activePath());
+            this.size = st.size;
+        }
+        catch {
+            this.size = 0;
+        }
+        this.sizeInitialized = true;
+    }
+    async rotateSize() {
+        if (this.handle) {
+            await this.handle.close();
+            this.handle = null;
+        }
+        const gens = this.maxFiles - 1;
+        for (let k = gens; k >= 2; k--) {
+            try {
+                await (0, promises_1.rename)(`${this.path}.${k - 1}`, `${this.path}.${k}`);
+            }
+            catch {
+                /* generation missing — skip */
+            }
+        }
+        try {
+            await (0, promises_1.rename)(this.path, `${this.path}.1`);
+        }
+        catch {
+            /* nothing to rotate yet */
+        }
+        this.size = 0;
+        this.sizeInitialized = true;
+        await this.ensureHandle();
+    }
+    /**
+     * Move to a new index file. When `clear` is true the target file is
+     * truncated first (used both for normal index advancement and for the
+     * wrap-to-01, which must clear the stale `01` slot).
+     */
+    async rotateToIndex(idx, clear) {
+        if (this.handle) {
+            await this.handle.close();
+            this.handle = null;
+        }
+        this.index = idx;
+        if (clear) {
+            try {
+                await (0, promises_1.truncate)(this.activePath(), 0);
+            }
+            catch {
+                /* file did not exist yet — fine */
+            }
+            this.size = 0;
+            this.sizeInitialized = true;
+        }
+        await this.ensureHandle();
+        if (!clear) {
+            await this.ensureSize();
+        }
+    }
+    write(_entry, formatted) {
+        const line = formatted + '\n';
+        const bytes = Buffer.byteLength(line, 'utf8');
+        const task = this.queue
+            .then(async () => {
+            if (!this.daily) {
+                await this.ensureSize();
+                if (this.size + bytes > this.maxSize) {
+                    await this.rotateSize();
+                }
+            }
+            else {
+                const today = dateStamp(this.now());
+                if (this.currentDate === undefined || today !== this.currentDate) {
+                    // First open, or a new day: reset to index 01 (resume/append).
+                    this.currentDate = today;
+                    this.index = 1;
+                    await this.rotateToIndex(1, false);
+                }
+                else {
+                    await this.ensureSize();
+                    if (this.size + bytes > this.maxSize) {
+                        let next = this.index + 1;
+                        if (next > this.maxFiles) {
+                            next = 1; // wrap and clear the 01 slot
+                        }
+                        await this.rotateToIndex(next, true);
+                    }
+                }
+            }
+            await this.ensureHandle();
+            await this.handle.write(line);
+            this.size += bytes;
+        })
+            .catch(() => {
+            /* swallow write errors to avoid crashing the app */
+        });
+        this.queue = task;
+        return task;
+    }
+    async flush() {
+        await this.queue;
+    }
+    async close() {
+        await this.queue;
+        if (this.handle) {
+            await this.handle.close();
+            this.handle = null;
+        }
+    }
+}
+exports.RotatingFileTransport = RotatingFileTransport;
+//# sourceMappingURL=rotating-file.js.map

package/dist/cjs/transport/rotating-file.js.map

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

package/dist/cjs/transport/transport.d.ts

@@ -0,0 +1,35 @@
+import type { LogEntry, LogLevelInput } from '../types.js';
+import type { Formatter } from '../pipeline/formatter.js';
+/**
+ * A Transport is the final sink of a log entry. Examples: console, file,
+ * IPC to the Electron main process, or HTTP remote reporting.
+ *
+ * `write` may be synchronous or async. When async, the Logger awaits it
+ * during a `flush()`.
+ */
+export interface Transport {
+    /** Unique transport name, used for diagnostics and removal. */
+    readonly name: string;
+    /** Optional per-transport formatter, overrides the pipeline default. */
+    readonly formatter?: Formatter;
+    /**
+     * Optional minimum level for this transport, as a name (`'info'`) or number.
+     * Entries below this level are skipped by this transport (the logger-level
+     * filter still applies first). Lets you route, e.g., `error`+ to a remote
+     * sink while sending everything to a file.
+     */
+    readonly level?: LogLevelInput;
+    /** Emit a processed entry. */
+    write(entry: LogEntry, formatted: string): void | Promise<void>;
+    /**
+     * Optional hook invoked by the logger when `write` (or the promise it
+     * returns) fails, so a broken sink can be reported without throwing out of
+     * the caller's `log.*` call. The original entry is passed for context.
+     */
+    onError?(err: unknown, entry: LogEntry): void;
+    /** Optional flush; awaited by `Logger.flush()`. */
+    flush?(): void | Promise<void>;
+    /** Optional teardown. */
+    close?(): void | Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,8BAA8B;IAC9B,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE;;;;OAIG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9C,mDAAmD;IACnD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,yBAAyB;IACzB,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC"}

package/dist/cjs/transport/transport.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transport.js.map

package/dist/cjs/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/transport/transport.ts"],"names":[],"mappings":""}

package/dist/cjs/transport/worker-ipc.d.ts

@@ -0,0 +1,43 @@
+import type { LogEntry } from '../types.js';
+import type { Transport } from './transport.js';
+/** Minimal view of the `postMessage` function available in Web Workers and Node worker_threads. */
+type PostMessageFn = (message: unknown, transfer?: unknown[]) => void;
+/** Minimal view of a Worker-like target that can receive messages. */
+type MessageTarget = {
+    postMessage: PostMessageFn;
+};
+export interface WorkerIpcTransportOptions {
+    /** Transport name. */
+    name?: string;
+}
+/**
+ * Worker-side transport that sends entries to the main thread via
+ * `self.postMessage()`. Safe to import in non-Worker environments — the write
+ * call is a no-op when `self.postMessage` is unavailable.
+ */
+export declare class WorkerIpcTransport implements Transport {
+    readonly name: string;
+    constructor(options?: WorkerIpcTransportOptions);
+    write(entry: LogEntry, _formatted: string): void;
+    /** Send a cross-process level command to the main thread. */
+    sendLevelCommand(level: number): void;
+}
+export interface WorkerReceiverOptions {
+    /** Specific Worker instance to listen on. If omitted, listens on `self.onmessage` (shared worker / global). */
+    worker?: MessageTarget;
+}
+/**
+ * Main-thread helper: listen for worker entries and feed them into the
+ * provided `ingest` callback (typically `logger.ingestEntry`). Level-change
+ * commands are forwarded to `onLevelCommand` when provided.
+ * Returns an unregister function.
+ *
+ * Works with `Worker` instances (dedicated workers). For a specific worker
+ * pass `worker: myWorkerInstance`; otherwise listens on `self.onmessage`
+ * for shared-worker / broadcast-channel patterns.
+ */
+export declare function registerWorkerReceiver(ingest: (entry: LogEntry) => void, options?: WorkerReceiverOptions & {
+    onLevelCommand?: (level: number) => void;
+}): () => void;
+export {};
+//# sourceMappingURL=worker-ipc.d.ts.map

package/dist/cjs/transport/worker-ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-ipc.d.ts","sourceRoot":"","sources":["../../../src/transport/worker-ipc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,mGAAmG;AACnG,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEtE,sEAAsE;AACtE,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,aAAa,CAAC;CAC5B,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,GAAE,yBAA8B;IAInD,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAWhD,6DAA6D;IAC7D,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAWtC;AAED,MAAM,WAAW,qBAAqB;IACpC,+GAA+G;IAC/G,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,EACjC,OAAO,GAAE,qBAAqB,GAAG;IAAE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GACjF,MAAM,IAAI,CA8DZ"}

package/dist/cjs/transport/worker-ipc.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerIpcTransport = void 0;
+exports.registerWorkerReceiver = registerWorkerReceiver;
+const types_js_1 = require("../types.js");
+const types_js_2 = require("../types.js");
+/**
+ * Worker-side transport that sends entries to the main thread via
+ * `self.postMessage()`. Safe to import in non-Worker environments — the write
+ * call is a no-op when `self.postMessage` is unavailable.
+ */
+class WorkerIpcTransport {
+    constructor(options = {}) {
+        this.name = options.name ?? 'worker-ipc';
+    }
+    write(entry, _formatted) {
+        try {
+            const target = self;
+            if (typeof target.postMessage === 'function') {
+                target.postMessage({ __lograilWorker: true, entry });
+            }
+        }
+        catch {
+            /* postMessage unavailable or failed — drop silently */
+        }
+    }
+    /** Send a cross-process level command to the main thread. */
+    sendLevelCommand(level) {
+        try {
+            const target = self;
+            if (typeof target.postMessage === 'function') {
+                const cmd = { __lograilCmd: true, __lograilCmdType: 'setLevel', level };
+                target.postMessage(cmd);
+            }
+        }
+        catch {
+            /* postMessage unavailable — drop silently */
+        }
+    }
+}
+exports.WorkerIpcTransport = WorkerIpcTransport;
+/**
+ * Main-thread helper: listen for worker entries and feed them into the
+ * provided `ingest` callback (typically `logger.ingestEntry`). Level-change
+ * commands are forwarded to `onLevelCommand` when provided.
+ * Returns an unregister function.
+ *
+ * Works with `Worker` instances (dedicated workers). For a specific worker
+ * pass `worker: myWorkerInstance`; otherwise listens on `self.onmessage`
+ * for shared-worker / broadcast-channel patterns.
+ */
+function registerWorkerReceiver(ingest, options = {}) {
+    const onLevelCommand = options.onLevelCommand;
+    const handler = (event) => {
+        const data = event.data;
+        if (data &&
+            typeof data === 'object' &&
+            '__lograilWorker' in data &&
+            data.__lograilWorker === true &&
+            'entry' in data) {
+            ingest(data.entry);
+        }
+        else if ((0, types_js_1.isLogLevelCommand)(data)) {
+            onLevelCommand?.((0, types_js_2.normalizeLevel)(data.level));
+        }
+    };
+    const worker = options.worker;
+    if (worker && typeof worker === 'object') {
+        if ('on' in worker && typeof worker.on === 'function') {
+            // Node Worker instance — worker.on('message', handler)
+            // Node passes raw data (not MessageEvent), so adapt:
+            const nodeHandler = (data) => {
+                if (data &&
+                    typeof data === 'object' &&
+                    '__lograilWorker' in data &&
+                    data.__lograilWorker === true &&
+                    'entry' in data) {
+                    ingest(data.entry);
+                }
+            };
+            worker.on('message', nodeHandler);
+            return () => {
+                /* Node Worker doesn't support off(); callers should dispose the Worker */
+            };
+        }
+        if ('onmessage' in worker) {
+            // Web Worker — dedicated worker onmessage
+            worker.onmessage = handler;
+            return () => {
+                if (worker.onmessage === handler)
+                    worker.onmessage = null;
+            };
+        }
+    }
+    // Global self.onmessage — shared worker / fallback
+    const prev = self.onmessage;
+    self.addEventListener('message', handler);
+    return () => {
+        self.removeEventListener('message', handler);
+        // Restore previous handler if it was there
+        if (self.onmessage === null && prev !== undefined) {
+            self.onmessage = prev;
+        }
+    };
+}
+//# sourceMappingURL=worker-ipc.js.map

package/dist/cjs/transport/worker-ipc.js.map

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

package/dist/cjs/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Shared type definitions for the logging library.
+ *
+ * These types form the stable contract used across Core, Pipeline,
+ * Transport, Runtime and Plugin modules.
+ */
+export type LogLevelName = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export type LogLevelValue = number;
+/**
+ * Ordered by severity. Higher value means more severe.
+ */
+export declare const LOG_LEVELS: Record<LogLevelName, LogLevelValue>;
+export declare const LOG_LEVEL_NAMES: LogLevelName[];
+export declare function isLogLevelName(value: unknown): value is LogLevelName;
+/**
+ * A single structured log record produced by the Logger.
+ *
+ * **Immutability contract.** Once an entry is handed to the transports it is
+ * frozen (see {@link freezeEntry}): the entry itself and its `context`,
+ * `metadata` and `args` containers become read-only, and the entry is shared by
+ * reference (zero-copy) across every transport, formatter and plugin. Treat
+ * nested values as immutable too — they are intentionally NOT deep-frozen so we
+ * never pay a serialization/clone cost on the hot path.
+ *
+ * Across a process boundary (Electron IPC) the entry is serialised once into a
+ * transferable `ArrayBuffer` and moved (not copied) to the other process; the
+ * receiver deserialises a fresh, independent entry.
+ */
+export interface LogEntry {
+    /** Numeric severity, see {@link LOG_LEVELS}. */
+    level: LogLevelValue;
+    /** Human readable level name. */
+    levelName: LogLevelName;
+    /** Primary message text. */
+    message: string;
+    /** Extra positional arguments passed to the log call. */
+    args: unknown[];
+    /** Epoch milliseconds when the entry was created. */
+    timestamp: number;
+    /** Coarse ISO timestamp for display / serialization. */
+    time: string;
+    /** Scope / namespace, e.g. child logger name. */
+    scope?: string;
+    /** Process id when available (Electron main / Node). */
+    pid?: number;
+    /** Persistent contextual fields (see Context module). */
+    context: Record<string, unknown>;
+    /** One-off metadata attached to this entry only. */
+    metadata: Record<string, unknown>;
+    /** Error object when the entry was created from one. */
+    error?: Error;
+}
+export type LogFn = (message: unknown, ...args: unknown[]) => void;
+export interface LoggerMethods {
+    trace: LogFn;
+    debug: LogFn;
+    info: LogFn;
+    warn: LogFn;
+    error: LogFn;
+    fatal: LogFn;
+}
+export type LogLevelInput = LogLevelName | LogLevelValue;
+export declare function normalizeLevel(input: LogLevelInput): LogLevelValue;
+/** Cross-process command sent over IPC to change log level. */
+export interface LogLevelCommand {
+    __lograilCmd: true;
+    __lograilCmdType: 'setLevel';
+    level: LogLevelName | LogLevelValue;
+}
+/** Returns true when the value is a {@link LogLevelCommand}. */
+export declare function isLogLevelCommand(value: unknown): value is LogLevelCommand;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,aAAa,CAO1D,CAAC;AAEF,eAAO,MAAM,eAAe,EAA8B,YAAY,EAAE,CAAC;AAEzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,KAAK,EAAE,aAAa,CAAC;IACrB,iCAAiC;IACjC,SAAS,EAAE,YAAY,CAAC;IACxB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,wDAAwD;IACxD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CASlE;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,IAAI,CAAC;IACnB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,KAAK,EAAE,YAAY,GAAG,aAAa,CAAC;CACrC;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}

package/dist/cjs/types.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Shared type definitions for the logging library.
+ *
+ * These types form the stable contract used across Core, Pipeline,
+ * Transport, Runtime and Plugin modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_LEVEL_NAMES = exports.LOG_LEVELS = void 0;
+exports.isLogLevelName = isLogLevelName;
+exports.normalizeLevel = normalizeLevel;
+exports.isLogLevelCommand = isLogLevelCommand;
+/**
+ * Ordered by severity. Higher value means more severe.
+ */
+exports.LOG_LEVELS = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+exports.LOG_LEVEL_NAMES = Object.keys(exports.LOG_LEVELS);
+function isLogLevelName(value) {
+    return typeof value === 'string' && value in exports.LOG_LEVELS;
+}
+function normalizeLevel(input) {
+    if (typeof input === 'number') {
+        return input;
+    }
+    const value = exports.LOG_LEVELS[input];
+    if (value === undefined) {
+        throw new Error(`Unknown log level: ${String(input)}`);
+    }
+    return value;
+}
+/** Returns true when the value is a {@link LogLevelCommand}. */
+function isLogLevelCommand(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.__lograilCmd === true &&
+        value.__lograilCmdType === 'setLevel');
+}
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAoBH,wCAEC;AAsDD,wCASC;AAUD,8CAOC;AAhGD;;GAEG;AACU,QAAA,UAAU,GAAwC;IAC7D,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC;AAEW,QAAA,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAU,CAAmB,CAAC;AAEzE,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,kBAAU,CAAC;AAC1D,CAAC;AAsDD,SAAgB,cAAc,CAAC,KAAoB;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,kBAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD,gEAAgE;AAChE,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,YAAY,KAAK,IAAI;QACvD,KAAiC,CAAC,gBAAgB,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC"}

package/dist/esm/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/esm/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/esm/context/async-context.browser.js

@@ -0,0 +1,25 @@
+/**
+ * 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 const 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). */
+export function runWithContext(fn, _context) {
+    return fn();
+}
+//# sourceMappingURL=async-context.browser.js.map

package/dist/esm/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":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,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,MAAM,UAAU,cAAc,CAAI,EAAW,EAAE,QAAwB;IACrE,OAAO,EAAE,EAAE,CAAC;AACd,CAAC"}