@emdzej/bimmerz-logger 0.1.0

package/dist/logger.js

@@ -0,0 +1,136 @@
+/**
+ * Logger implementation + central config.
+ *
+ * Logger handles are thin proxies that consult the live module-
+ * scoped config on every call. That's what makes
+ * `configureLogger({ categories: { EDIABASX: 'debug' } })` flip
+ * existing handles' behaviour instantly — no need to refetch
+ * loggers from callers.
+ *
+ * Performance: level resolution is a Map lookup + at most ~3 dot-
+ * segment slices for typical category paths. Both happen *before*
+ * any binding merge or sink dispatch, so a `log.debug({…}, 'msg')`
+ * call that's below threshold spends about as much time as a
+ * branch + Map.get. Same shape as pino's "no-op below level"
+ * pattern.
+ */
+import { resolveLevel } from './categories.js';
+import { levelPasses } from './levels.js';
+/**
+ * Default sink — lazily installed on the active config when no
+ * `sink` is explicitly supplied. Set via `setDefaultSink()` from
+ * the sink-side init so we don't have a circular dep.
+ */
+let DEFAULT_SINK = null;
+/** @internal — called from index.ts after sink modules load. */
+export function setDefaultSink(sink) {
+    DEFAULT_SINK = sink;
+}
+/** Module-scoped live config. Initialized to a sensible "info, console" default. */
+const active = {
+    level: 'info',
+};
+/**
+ * Replace or merge into the active configuration. The merge is
+ * shallow — `categories` and `sink` are replaced wholesale when
+ * present in the partial. Pass `categories: {}` to clear all
+ * per-category overrides.
+ *
+ * Effective immediately for every logger handle, including ones
+ * already returned by `getLogger()`.
+ */
+export function configureLogger(config) {
+    if (config.level !== undefined)
+        active.level = config.level;
+    if (config.categories !== undefined)
+        active.categories = config.categories;
+    if (config.sink !== undefined)
+        active.sink = config.sink;
+}
+/**
+ * Snapshot of the active configuration. Returned object is a copy
+ * — mutating it doesn't affect the live config (use
+ * `configureLogger()` for that).
+ */
+export function getLoggerConfig() {
+    return {
+        level: active.level,
+        categories: active.categories ? { ...active.categories } : undefined,
+        sink: active.sink,
+    };
+}
+class LoggerImpl {
+    category;
+    bindings;
+    constructor(category, bindings = {}) {
+        this.category = category;
+        this.bindings = bindings;
+    }
+    get level() {
+        return resolveLevel(this.category, active.categories, active.level);
+    }
+    trace(a, b) {
+        this.emit('trace', a, b);
+    }
+    debug(a, b) {
+        this.emit('debug', a, b);
+    }
+    info(a, b) {
+        this.emit('info', a, b);
+    }
+    warn(a, b) {
+        this.emit('warn', a, b);
+    }
+    error(a, b) {
+        this.emit('error', a, b);
+    }
+    fatal(a, b) {
+        this.emit('fatal', a, b);
+    }
+    child(bindings) {
+        return new LoggerImpl(this.category, { ...this.bindings, ...bindings });
+    }
+    emit(level, a, b) {
+        const threshold = resolveLevel(this.category, active.categories, active.level);
+        if (!levelPasses(level, threshold))
+            return;
+        let msg;
+        let callBindings;
+        if (typeof a === 'string') {
+            msg = a;
+        }
+        else {
+            callBindings = a;
+            msg = b ?? '';
+        }
+        const mergedBindings = callBindings === undefined
+            ? this.bindings
+            : { ...this.bindings, ...callBindings };
+        const record = {
+            level,
+            category: this.category,
+            bindings: mergedBindings,
+            msg,
+            time: Date.now(),
+        };
+        const sink = active.sink ?? DEFAULT_SINK;
+        if (sink)
+            sink.write(record);
+    }
+}
+/**
+ * Get a logger handle. Call with no arguments for the root logger
+ * (category = `null`); pass a dot-separated string to scope under
+ * a category. Re-calling with the same category does NOT return
+ * the same instance — handles are cheap, and shared identity would
+ * make `child()` bindings spill across callers.
+ *
+ * Examples:
+ *   const log = getLogger();
+ *   const parser = getLogger("EDIABASX.parser");
+ *   const job = parser.child({ jobId: "C_S_LESEN" });
+ */
+export function getLogger(category) {
+    return new LoggerImpl(category ?? null);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

package/dist/logger.test.d.ts.map

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

package/dist/logger.test.js

@@ -0,0 +1,199 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import { configureLogger, getLogger, getLoggerConfig } from './logger.js';
+import { resolveLevel } from './categories.js';
+import { levelPasses } from './levels.js';
+import { bufferSink } from './sinks/buffer.js';
+import { multiSink } from './sinks/multi.js';
+import { nullSink } from './sinks/null.js';
+/** Reset to a known state after each test so tests don't leak config. */
+afterEach(() => {
+    configureLogger({ level: 'info', categories: {}, sink: nullSink() });
+});
+describe('levelPasses', () => {
+    it('matches pino ordering', () => {
+        expect(levelPasses('debug', 'info')).toBe(false);
+        expect(levelPasses('info', 'info')).toBe(true);
+        expect(levelPasses('error', 'info')).toBe(true);
+    });
+    it('silent blocks everything', () => {
+        expect(levelPasses('fatal', 'silent')).toBe(false);
+        expect(levelPasses('trace', 'silent')).toBe(false);
+    });
+});
+describe('resolveLevel hierarchy', () => {
+    const rules = { EDIABASX: 'debug', 'EDIABASX.parser': 'trace', INPAX: 'info' };
+    it('returns fallback for null category', () => {
+        expect(resolveLevel(null, rules, 'warn')).toBe('warn');
+    });
+    it('uses exact match when present', () => {
+        expect(resolveLevel('EDIABASX', rules, 'warn')).toBe('debug');
+    });
+    it('walks up dot segments', () => {
+        expect(resolveLevel('EDIABASX.parser.lexer', rules, 'warn')).toBe('trace');
+        expect(resolveLevel('EDIABASX.runner', rules, 'warn')).toBe('debug');
+    });
+    it('falls back when no segment matches', () => {
+        expect(resolveLevel('OTHER.subsystem', rules, 'warn')).toBe('warn');
+    });
+    it('ignores rules with bad level values', () => {
+        expect(resolveLevel('FOO', { FOO: 'bogus' }, 'warn')).toBe('warn');
+    });
+});
+describe('Logger basic dispatch', () => {
+    it('emits records at or above the threshold', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'info', sink: buf });
+        const log = getLogger();
+        log.debug('skipped');
+        log.info('kept');
+        log.warn('kept too');
+        const recs = buf.snapshot();
+        expect(recs.map((r) => r.msg)).toEqual(['kept', 'kept too']);
+        expect(recs[0]?.level).toBe('info');
+    });
+    it('attaches bindings when called with (obj, msg)', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'trace', sink: buf });
+        getLogger('A').info({ id: 7, tag: 'x' }, 'with bindings');
+        expect(buf.snapshot()[0]).toMatchObject({
+            level: 'info',
+            category: 'A',
+            bindings: { id: 7, tag: 'x' },
+            msg: 'with bindings',
+        });
+    });
+    it('emits empty bindings when called with (msg) only', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'trace', sink: buf });
+        getLogger().info('bare');
+        expect(buf.snapshot()[0]?.bindings).toEqual({});
+    });
+    it('attaches a `time` epoch ms', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'trace', sink: buf });
+        const before = Date.now();
+        getLogger().info('t');
+        const after = Date.now();
+        const rec = buf.snapshot()[0];
+        expect(rec.time).toBeGreaterThanOrEqual(before);
+        expect(rec.time).toBeLessThanOrEqual(after);
+    });
+});
+describe('Logger category resolution', () => {
+    it('applies per-category levels', () => {
+        const buf = bufferSink();
+        configureLogger({
+            level: 'warn',
+            categories: { EDIABASX: 'debug' },
+            sink: buf,
+        });
+        getLogger('EDIABASX').debug('kept');
+        getLogger('INPAX').debug('dropped');
+        getLogger().debug('dropped too');
+        expect(buf.snapshot().map((r) => r.msg)).toEqual(['kept']);
+    });
+    it('hierarchical override beats parent', () => {
+        const buf = bufferSink();
+        configureLogger({
+            level: 'warn',
+            categories: { EDIABASX: 'debug', 'EDIABASX.parser': 'trace' },
+            sink: buf,
+        });
+        getLogger('EDIABASX.parser').trace('kept');
+        getLogger('EDIABASX.runner').trace('dropped');
+        expect(buf.snapshot().map((r) => r.msg)).toEqual(['kept']);
+    });
+    it('logger.level reflects the live effective threshold', () => {
+        configureLogger({ level: 'warn', categories: { FOO: 'trace' } });
+        expect(getLogger('FOO').level).toBe('trace');
+        expect(getLogger('BAR').level).toBe('warn');
+    });
+});
+describe('runtime reconfigure', () => {
+    it('affects existing logger handles', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'info', sink: buf });
+        const log = getLogger('X');
+        log.debug('dropped #1');
+        configureLogger({ level: 'debug' });
+        log.debug('kept after reconfigure');
+        expect(buf.snapshot().map((r) => r.msg)).toEqual(['kept after reconfigure']);
+    });
+    it('partial reconfigure merges with existing config', () => {
+        configureLogger({ level: 'error', categories: { A: 'debug' } });
+        configureLogger({ level: 'info' }); // categories should remain
+        const cfg = getLoggerConfig();
+        expect(cfg.level).toBe('info');
+        expect(cfg.categories).toEqual({ A: 'debug' });
+    });
+    it('explicit empty categories clears overrides', () => {
+        configureLogger({ level: 'warn', categories: { A: 'debug' } });
+        configureLogger({ categories: {} });
+        expect(getLoggerConfig().categories).toEqual({});
+    });
+});
+describe('child loggers', () => {
+    it('carry permanent bindings on every call', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'trace', sink: buf });
+        const log = getLogger('X').child({ tenant: 'acme' });
+        log.info('one');
+        log.info({ extra: 1 }, 'two');
+        expect(buf.snapshot().map((r) => r.bindings)).toEqual([
+            { tenant: 'acme' },
+            { tenant: 'acme', extra: 1 },
+        ]);
+    });
+    it('call-binding overrides child binding on key conflict', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'trace', sink: buf });
+        const log = getLogger().child({ tenant: 'acme' });
+        log.info({ tenant: 'override' }, 'x');
+        expect(buf.snapshot()[0]?.bindings).toEqual({ tenant: 'override' });
+    });
+    it('child inherits category + level resolution', () => {
+        configureLogger({ level: 'warn', categories: { Y: 'trace' } });
+        const log = getLogger('Y').child({ a: 1 });
+        expect(log.level).toBe('trace');
+    });
+});
+describe('bufferSink', () => {
+    it('keeps records up to capacity', () => {
+        const buf = bufferSink({ capacity: 3 });
+        configureLogger({ level: 'trace', sink: buf });
+        for (let i = 0; i < 5; i++)
+            getLogger().info(`m${i}`);
+        expect(buf.snapshot().map((r) => r.msg)).toEqual(['m2', 'm3', 'm4']);
+        expect(buf.size()).toBe(3);
+    });
+    it('clear() empties the buffer', () => {
+        const buf = bufferSink();
+        configureLogger({ level: 'trace', sink: buf });
+        getLogger().info('a');
+        buf.clear();
+        expect(buf.size()).toBe(0);
+        expect(buf.snapshot()).toEqual([]);
+    });
+});
+describe('multiSink', () => {
+    it('fans out to every wrapped sink', () => {
+        const a = bufferSink();
+        const b = bufferSink();
+        configureLogger({ level: 'trace', sink: multiSink(a, b) });
+        getLogger().info('hi');
+        expect(a.snapshot().map((r) => r.msg)).toEqual(['hi']);
+        expect(b.snapshot().map((r) => r.msg)).toEqual(['hi']);
+    });
+    it('isolates failing sinks from healthy ones', () => {
+        const angry = {
+            write() {
+                throw new Error('boom');
+            },
+        };
+        const calm = bufferSink();
+        configureLogger({ level: 'trace', sink: multiSink(angry, calm) });
+        expect(() => getLogger().info('hi')).not.toThrow();
+        expect(calm.snapshot().map((r) => r.msg)).toEqual(['hi']);
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/logger.test.js.map

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

package/dist/sinks/buffer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * In-memory ring-buffer sink. Holds the last `capacity` records and
+ * lets UI code snapshot them on demand — drives "Download log"
+ * buttons in web apps without having to also intercept the console.
+ *
+ * Capacity defaults to 5000 (~1MB if records average 200 bytes).
+ * Older records are dropped silently as new ones arrive.
+ */
+import type { LogRecord, Sink } from '../types.js';
+export interface BufferSink extends Sink {
+    /** Records currently held, oldest → newest. */
+    snapshot(): LogRecord[];
+    /** Drop every held record. */
+    clear(): void;
+    /** Number of records currently held (≤ capacity). */
+    size(): number;
+}
+export interface BufferSinkOptions {
+    /** Max records held; older ones drop. Default 5000. */
+    capacity?: number;
+}
+export declare function bufferSink(opts?: BufferSinkOptions): BufferSink;
+//# sourceMappingURL=buffer.d.ts.map

package/dist/sinks/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/sinks/buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,+CAA+C;IAC/C,QAAQ,IAAI,SAAS,EAAE,CAAC;IACxB,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,qDAAqD;IACrD,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,UAAU,CAgCnE"}

package/dist/sinks/buffer.js

@@ -0,0 +1,44 @@
+/**
+ * In-memory ring-buffer sink. Holds the last `capacity` records and
+ * lets UI code snapshot them on demand — drives "Download log"
+ * buttons in web apps without having to also intercept the console.
+ *
+ * Capacity defaults to 5000 (~1MB if records average 200 bytes).
+ * Older records are dropped silently as new ones arrive.
+ */
+export function bufferSink(opts = {}) {
+    const capacity = Math.max(1, opts.capacity ?? 5000);
+    // Plain array is fine — pop+shift would be O(N); we use an
+    // index-based ring so push is O(1) and snapshot is O(N) only on
+    // demand.
+    const ring = new Array(capacity);
+    let head = 0; // next write position
+    let count = 0;
+    return {
+        write(record) {
+            ring[head] = record;
+            head = (head + 1) % capacity;
+            if (count < capacity)
+                count++;
+        },
+        snapshot() {
+            const out = [];
+            const start = count < capacity ? 0 : head;
+            for (let i = 0; i < count; i++) {
+                const r = ring[(start + i) % capacity];
+                if (r)
+                    out.push(r);
+            }
+            return out;
+        },
+        clear() {
+            ring.fill(undefined);
+            head = 0;
+            count = 0;
+        },
+        size() {
+            return count;
+        },
+    };
+}
+//# sourceMappingURL=buffer.js.map

package/dist/sinks/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../src/sinks/buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,MAAM,UAAU,UAAU,CAAC,OAA0B,EAAE;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;IACpD,2DAA2D;IAC3D,gEAAgE;IAChE,UAAU;IACV,MAAM,IAAI,GAA8B,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,sBAAsB;IACpC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO;QACL,KAAK,CAAC,MAAiB;YACrB,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YACpB,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;YAC7B,IAAI,KAAK,GAAG,QAAQ;gBAAE,KAAK,EAAE,CAAC;QAChC,CAAC;QACD,QAAQ;YACN,MAAM,GAAG,GAAgB,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;gBACvC,IAAI,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK;YACH,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,IAAI,GAAG,CAAC,CAAC;YACT,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;QACD,IAAI;YACF,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sinks/console.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Default sink — works in Node and the browser, no dependencies.
+ *
+ * Routes through `console.{trace|debug|info|warn|error}` per level
+ * so browser devtools' level-filter sidebar works correctly. In
+ * Node, console.* writes to stderr (warn/error) or stdout (rest)
+ * — same as bare `console.log`. For Node CLIs that want
+ * pino-pretty / file destinations, switch to
+ * `@emdzej/bimmerz-logger/sinks/pino`.
+ *
+ * Line format:
+ *   2026-05-23T19:14:32.123Z DEBUG [EDIABASX.parser] msg {jobId:"C_S_LESEN"}
+ *
+ * Bindings render as compact JSON. ANSI colours are added when the
+ * environment looks like a TTY (best-effort: `process.stdout.isTTY`
+ * in Node, never in the browser).
+ */
+import type { Sink } from '../types.js';
+export interface ConsoleSinkOptions {
+    /**
+     * Force colour on/off. Defaults to "on if Node TTY, off otherwise".
+     * Browser devtools renders ANSI literally, so we leave it off there
+     * unless explicitly requested.
+     */
+    colors?: boolean;
+    /**
+     * Render `time` as a relative `+12ms` offset from the sink's
+     * creation moment instead of an absolute ISO timestamp. Handy for
+     * spotting time gaps between adjacent calls.
+     */
+    relativeTime?: boolean;
+}
+export declare function consoleSink(opts?: ConsoleSinkOptions): Sink;
+//# sourceMappingURL=console.d.ts.map

package/dist/sinks/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/sinks/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAuB,IAAI,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkDD,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,IAAI,CAmB/D"}

package/dist/sinks/console.js

@@ -0,0 +1,106 @@
+/**
+ * Default sink — works in Node and the browser, no dependencies.
+ *
+ * Routes through `console.{trace|debug|info|warn|error}` per level
+ * so browser devtools' level-filter sidebar works correctly. In
+ * Node, console.* writes to stderr (warn/error) or stdout (rest)
+ * — same as bare `console.log`. For Node CLIs that want
+ * pino-pretty / file destinations, switch to
+ * `@emdzej/bimmerz-logger/sinks/pino`.
+ *
+ * Line format:
+ *   2026-05-23T19:14:32.123Z DEBUG [EDIABASX.parser] msg {jobId:"C_S_LESEN"}
+ *
+ * Bindings render as compact JSON. ANSI colours are added when the
+ * environment looks like a TTY (best-effort: `process.stdout.isTTY`
+ * in Node, never in the browser).
+ */
+const ANSI = {
+    reset: '\x1b[0m',
+    gray: '\x1b[90m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    bgRed: '\x1b[41m',
+};
+const LEVEL_COLOR = {
+    trace: ANSI.gray,
+    debug: ANSI.cyan,
+    info: ANSI.green,
+    warn: ANSI.yellow,
+    error: ANSI.red,
+    fatal: ANSI.bgRed,
+    silent: '',
+};
+const LEVEL_TAG = {
+    trace: 'TRACE',
+    debug: 'DEBUG',
+    info: 'INFO ',
+    warn: 'WARN ',
+    error: 'ERROR',
+    fatal: 'FATAL',
+    silent: '',
+};
+const LEVEL_METHOD = {
+    trace: 'debug',
+    debug: 'debug',
+    info: 'info',
+    warn: 'warn',
+    error: 'error',
+    fatal: 'error',
+    silent: 'log',
+};
+function detectTty() {
+    // Node: process.stdout.isTTY → typically true under terminals.
+    // Avoid `process` in a way that bundlers can't tree-shake out
+    // gracefully — `globalThis` access is cheap.
+    const g = globalThis;
+    return !!g.process?.stdout?.isTTY;
+}
+export function consoleSink(opts = {}) {
+    const colors = opts.colors ?? detectTty();
+    const t0 = opts.relativeTime ? Date.now() : 0;
+    return {
+        write(record) {
+            const tag = LEVEL_TAG[record.level];
+            const tagColored = colors ? `${LEVEL_COLOR[record.level]}${tag}${ANSI.reset}` : tag;
+            const time = opts.relativeTime
+                ? `+${(record.time - t0).toString().padStart(4)}ms`
+                : new Date(record.time).toISOString();
+            const cat = record.category ? ` [${record.category}]` : '';
+            const bindings = Object.keys(record.bindings).length > 0
+                ? ` ${safeStringify(record.bindings)}`
+                : '';
+            const line = `${time} ${tagColored}${cat} ${record.msg}${bindings}`;
+            const method = LEVEL_METHOD[record.level];
+            console[method](line);
+        },
+    };
+}
+/**
+ * JSON.stringify with circular-ref guard and Error → {name, message,
+ * stack} expansion. Bindings often carry Error instances or shared
+ * state objects; we don't want a circular ref or a "[object Object]"
+ * to drop information.
+ */
+function safeStringify(value) {
+    const seen = new WeakSet();
+    try {
+        return JSON.stringify(value, (_, v) => {
+            if (v instanceof Error) {
+                return { name: v.name, message: v.message, stack: v.stack };
+            }
+            if (typeof v === 'object' && v !== null) {
+                if (seen.has(v))
+                    return '[Circular]';
+                seen.add(v);
+            }
+            return v;
+        });
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/sinks/console.js.map

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

package/dist/sinks/multi.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fan out one record to every wrapped sink. Common pairing:
+ * `multiSink(consoleSink(), bufferSink({ capacity: 10_000 }))` —
+ * see lines in devtools while also accumulating them for an
+ * end-user "Download log" button.
+ *
+ * Failures in one sink don't stop later sinks — each `write` is
+ * wrapped in try/catch and errors are swallowed (logging
+ * recursively from a logging error would loop).
+ */
+import type { Sink } from '../types.js';
+export declare function multiSink(...sinks: Sink[]): Sink;
+//# sourceMappingURL=multi.d.ts.map

package/dist/sinks/multi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi.d.ts","sourceRoot":"","sources":["../../src/sinks/multi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAa,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAgB,SAAS,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAahD"}

package/dist/sinks/multi.js

@@ -0,0 +1,26 @@
+/**
+ * Fan out one record to every wrapped sink. Common pairing:
+ * `multiSink(consoleSink(), bufferSink({ capacity: 10_000 }))` —
+ * see lines in devtools while also accumulating them for an
+ * end-user "Download log" button.
+ *
+ * Failures in one sink don't stop later sinks — each `write` is
+ * wrapped in try/catch and errors are swallowed (logging
+ * recursively from a logging error would loop).
+ */
+export function multiSink(...sinks) {
+    return {
+        write(record) {
+            for (const s of sinks) {
+                try {
+                    s.write(record);
+                }
+                catch {
+                    // Intentional: don't let one bad sink kill the others, and
+                    // don't log the failure (that would re-enter `write`).
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=multi.js.map

package/dist/sinks/multi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi.js","sourceRoot":"","sources":["../../src/sinks/multi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,SAAS,CAAC,GAAG,KAAa;IACxC,OAAO;QACL,KAAK,CAAC,MAAiB;YACrB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC;oBACP,2DAA2D;oBAC3D,uDAAuD;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sinks/null.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Null sink — drops every record. Use in tests so logging code
+ * doesn't pollute the test runner output, or in production code
+ * paths where you want to disable logging entirely without going
+ * through `silent` level (e.g. a "verbose" CLI flag that controls
+ * level but a separate "quiet" flag that controls the sink).
+ */
+import type { Sink } from '../types.js';
+export declare function nullSink(): Sink;
+//# sourceMappingURL=null.d.ts.map