@decohere/scribe-pino 0.0.1-dev.13 → 0.0.1-dev.131

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025-2026 Typesmiths
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/commonjs/src/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", {
     value: true
 });
 _export_star(require("./pino.adapater.js"), exports);
+_export_star(require("./pino.recipe.js"), exports);
 _export_star(require("./scribe-pino.js"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {
@@ -17,5 +18,3 @@ function _export_star(from, to) {
     });
     return from;
 }
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjcmliZS9zY3JpYmUtcGluby9zcmMvaW5kZXgudHMiXSwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0ICogZnJvbSBcIi4vcGluby5hZGFwYXRlci5qc1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vc2NyaWJlLXBpbm8uanNcIjtcbiJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7O3FCQUFjO3FCQUNBIn0=

package/commonjs/src/pino.adapater.js

@@ -19,6 +19,8 @@ class PinoAdapter extends _scribe.LogAdapter {
     _pino;
     options;
     stream;
+    disposed = false;
+    retired = false;
     constructor(options, stream){
         super();
         this.options = options;
@@ -48,18 +50,136 @@ class PinoAdapter extends _scribe.LogAdapter {
         return logger;
     }
     flush(cb) {
+        if (this.retired || !this._pino) {
+            cb?.();
+            return;
+        }
         this._pino.flush(cb);
     }
+    /**
+	 * Immediately stop accepting writes into the destination (ThreadStream).
+	 * Does not wait for flush — use `stop()` for async drain after retire.
+	 */ retire() {
+        if (this.retired) {
+            return;
+        }
+        this.retired = true;
+        const guarded = this.stream;
+        if (typeof guarded?.retire === "function") {
+            guarded.retire("adapter retired");
+            return;
+        }
+        destroyDestination(this.stream);
+    }
+    async [Symbol.asyncDispose]() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        if (!this.retired) {
+            const dest = this.stream;
+            if (dest != null && typeof dest.end === "function") {
+                // pino.transport() is a ThreadStream: pino.flush() → Atomics.waitAsync can
+                // hang forever after concurrent writes. end() flushSyncs then signals
+                // finish/close (it does not accept a Node Writable callback).
+                await endDestination(dest);
+            } else if (this._pino) {
+                await new Promise((resolve, reject)=>{
+                    try {
+                        this._pino.flush((err)=>{
+                            if (err != null) {
+                                reject(err);
+                                return;
+                            }
+                            resolve();
+                        });
+                    } catch (err) {
+                        reject(err instanceof Error ? err : new Error(String(err)));
+                    }
+                });
+            }
+        }
+        // Mark dead after graceful end (or immediately if already force-retired).
+        this.retire();
+    }
+}
+function destroyDestination(stream) {
+    const destroyable = stream;
+    if (typeof destroyable?.destroy === "function") {
+        try {
+            destroyable.destroy();
+        } catch  {
+        // already dead
+        }
+    }
+}
+/**
+ * Drain a pino destination.
+ *
+ * Node `Writable.end(cb)` invokes `cb`. `pino.transport()` returns a
+ * ThreadStream whose `end()` takes no callback and signals via `finish`/`close`
+ * instead — waiting only on `end(cb)` hangs forever and blocks Flux HMR.
+ */ function endDestination(stream) {
+    if (typeof stream.end !== "function") {
+        return Promise.resolve();
+    }
+    if (stream.destroyed || stream.closed || stream.writableFinished) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject)=>{
+        let settled = false;
+        const settle = (err)=>{
+            if (settled) {
+                return;
+            }
+            settled = true;
+            stream.off?.("finish", onFinish);
+            stream.off?.("close", onClose);
+            stream.off?.("error", onError);
+            if (err != null) {
+                reject(err);
+                return;
+            }
+            resolve();
+        };
+        const onFinish = ()=>settle();
+        const onClose = ()=>settle();
+        const onError = (err)=>{
+            // ThreadStream may emit error then close during teardown; closed = done.
+            if (stream.destroyed || stream.closed) {
+                settle();
+                return;
+            }
+            settle(err);
+        };
+        stream.once?.("finish", onFinish);
+        stream.once?.("close", onClose);
+        stream.once?.("error", onError);
+        try {
+            stream.end((err)=>settle(err));
+        } catch (err) {
+            settle(err instanceof Error ? err : new Error(String(err)));
+            return;
+        }
+        // ThreadStream.end() is a no-op when already destroyed (no events).
+        if (stream.destroyed || stream.closed || stream.writableFinished) {
+            settle();
+        }
+    });
 }
 function logMethod(args, method) {
     let message = args.at(0);
     const data = args.at(1);
+    if (message instanceof Error) {
+        method.call(this, {
+            err: message
+        }, (0, _scribe.formatError)(message));
+        return;
+    }
     if (data instanceof Error) {
         message = {
             msg: message,
-            ...{
-                error: data
-            }
+            error: data
         };
     } else if (typeof data === "object") {
         message = {
@@ -74,15 +194,18 @@ function logMethod(args, method) {
     }
     method.call(this, message);
 }
-function pinoMix(logger) {
+/**
+ * Add Scribe's logger members to a Pino logger. `spawn` is Pino's own `child`:
+ * a Pino child inherits its parent's members through the prototype, so
+ * `logger.child` would be the parent's override.
+ */ function pinoMix(logger, spawn = logger.child) {
     return Object.assign(logger, {
         get currentLevel () {
             return logger.level;
         },
         get logLevels () {
             return logger.levels.values;
-        }
+        },
+        child: (fields)=>pinoMix(spawn.call(logger, fields), spawn)
     });
 }
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjcmliZS9zY3JpYmUtcGluby9zcmMvcGluby5hZGFwYXRlci50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge1xuXHR0eXBlIEJhc2VMb2dnZXIsXG5cdExvZ0FkYXB0ZXIsXG5cdHR5cGUgTG9nZ2VyLFxuXHR0eXBlIFNjcmliZU9wdGlvbnMsXG59IGZyb20gXCJAZGVjb2hlcmUvc2NyaWJlXCI7XG5pbXBvcnQgcGlubywgeyB0eXBlIExvZ0ZuIH0gZnJvbSBcInBpbm9cIjtcblxuZXhwb3J0IHR5cGUgUGlub0FkYXBhdGVyT3B0aW9ucyA9IHtcblx0b3B0aW9ucz86IHBpbm8uTG9nZ2VyT3B0aW9ucztcblx0c3RyZWFtPzogcGluby5EZXN0aW5hdGlvblN0cmVhbTtcbn07XG5cbmV4cG9ydCBjbGFzcyBQaW5vQWRhcHRlciBleHRlbmRzIExvZ0FkYXB0ZXIge1xuXHRwcml2YXRlIF9waW5vOiBwaW5vLkxvZ2dlcjtcblx0cHJpdmF0ZSByZWFkb25seSBvcHRpb25zOiBwaW5vLkxvZ2dlck9wdGlvbnM7XG5cdHByaXZhdGUgcmVhZG9ubHkgc3RyZWFtOiBwaW5vLkRlc3RpbmF0aW9uU3RyZWFtO1xuXHRwdWJsaWMgY29uc3RydWN0b3Iob3B0aW9uczogcGluby5Mb2dnZXJPcHRpb25zLCBzdHJlYW0/OiBwaW5vLkRlc3RpbmF0aW9uU3RyZWFtKSB7XG5cdFx0c3VwZXIoKTtcblx0XHR0aGlzLm9wdGlvbnMgPSBvcHRpb25zO1xuXHRcdHRoaXMuc3RyZWFtID0gc3RyZWFtO1xuXHR9XG5cblx0cHVibGljIGNvbmZpZ3VyZTxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlIHwgZmFsc2UgPSBmYWxzZT4oXG5cdFx0c2NyaWJlT3B0aW9uczogU2NyaWJlT3B0aW9uczxULCBDdXN0b21Pbmx5Pixcblx0KSB7XG5cdFx0Y29uc3QgeyBsb2dMZXZlbCwgcmVkYWN0aW9ucyB9ID0gc2NyaWJlT3B0aW9ucztcblx0XHRjb25zdCBjdXN0b21MZXZlbHMgPSB0aGlzLmdldExvZ0xldmVscyhzY3JpYmVPcHRpb25zKTtcblxuXHRcdGNvbnN0IHBpbm9PcHRpb25zOiBwaW5vLkxvZ2dlck9wdGlvbnMgPSB7XG5cdFx0XHRjdXN0b21MZXZlbHMsXG5cdFx0XHRsZXZlbDogbG9nTGV2ZWwsXG5cdFx0XHRob29rczogeyBsb2dNZXRob2QgfSxcblx0XHRcdHNlcmlhbGl6ZXJzOiB7XG5cdFx0XHRcdGVycm9yOiBwaW5vLnN0ZFNlcmlhbGl6ZXJzLmVycixcblx0XHRcdH0sXG5cdFx0XHRyZWRhY3Q6IHJlZGFjdGlvbnMsXG5cdFx0XHQuLi50aGlzLm9wdGlvbnMsXG5cdFx0fTtcblx0XHR0aGlzLl9waW5vID0gcGlubyhwaW5vT3B0aW9ucywgdGhpcy5zdHJlYW0pO1xuXHR9XG5cblx0cHVibGljIGdldExvZ2dlcjxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlIHwgZmFsc2UgPSBmYWxzZT4oXG5cdFx0bmFtZTogc3RyaW5nLFxuXHQpOiBMb2dnZXI8VCwgQ3VzdG9tT25seT4ge1xuXHRcdGNvbnN0IGxvZ2dlciA9IHBpbm9NaXg8VCwgQ3VzdG9tT25seT4odGhpcy5fcGluby5jaGlsZCh7IG5hbWUgfSkpO1xuXHRcdHJldHVybiBsb2dnZXI7XG5cdH1cblxuXHRwdWJsaWMgZmx1c2goY2I/OiAoKSA9PiB2b2lkKTogdm9pZCB7XG5cdFx0dGhpcy5fcGluby5mbHVzaChjYik7XG5cdH1cbn1cblxuZnVuY3Rpb24gbG9nTWV0aG9kKHRoaXM6IHBpbm8uTG9nZ2VyLCBhcmdzOiBQYXJhbWV0ZXJzPExvZ0ZuPiwgbWV0aG9kOiBMb2dGbikge1xuXHRsZXQgbWVzc2FnZSA9IGFyZ3MuYXQoMCk7XG5cdGNvbnN0IGRhdGEgPSBhcmdzLmF0KDEpO1xuXG5cdGlmIChkYXRhIGluc3RhbmNlb2YgRXJyb3IpIHtcblx0XHRtZXNzYWdlID0geyBtc2c6IG1lc3NhZ2UsIC4uLnsgZXJyb3I6IGRhdGEgfSB9O1xuXHR9IGVsc2UgaWYgKHR5cGVvZiBkYXRhID09PSBcIm9iamVjdFwiKSB7XG5cdFx0bWVzc2FnZSA9IHsgbXNnOiBtZXNzYWdlLCAuLi5kYXRhIH07XG5cdH0gZWxzZSB7XG5cdFx0bWVzc2FnZSA9IHsgbXNnOiBtZXNzYWdlLCBkYXRhIH07XG5cdH1cblxuXHRtZXRob2QuY2FsbCh0aGlzLCBtZXNzYWdlKTtcbn1cblxuZnVuY3Rpb24gcGlub01peDxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlIHwgZmFsc2UgPSBmYWxzZT4oXG5cdGxvZ2dlcjogcGluby5Mb2dnZXIsXG4pOiBMb2dnZXI8VCwgQ3VzdG9tT25seT4ge1xuXHRyZXR1cm4gT2JqZWN0LmFzc2lnbjxwaW5vLkxvZ2dlciwgQmFzZUxvZ2dlcj4obG9nZ2VyLCB7XG5cdFx0Z2V0IGN1cnJlbnRMZXZlbCgpIHtcblx0XHRcdHJldHVybiBsb2dnZXIubGV2ZWw7XG5cdFx0fSxcblx0XHRnZXQgbG9nTGV2ZWxzKCkge1xuXHRcdFx0cmV0dXJuIGxvZ2dlci5sZXZlbHMudmFsdWVzO1xuXHRcdH0sXG5cdH0pIGFzIExvZ2dlcjxULCBDdXN0b21Pbmx5Pjtcbn1cbiJdLCJuYW1lcyI6WyJQaW5vQWRhcHRlciIsIkxvZ0FkYXB0ZXIiLCJfcGlubyIsIm9wdGlvbnMiLCJzdHJlYW0iLCJjb25maWd1cmUiLCJzY3JpYmVPcHRpb25zIiwibG9nTGV2ZWwiLCJyZWRhY3Rpb25zIiwiY3VzdG9tTGV2ZWxzIiwiZ2V0TG9nTGV2ZWxzIiwicGlub09wdGlvbnMiLCJsZXZlbCIsImhvb2tzIiwibG9nTWV0aG9kIiwic2VyaWFsaXplcnMiLCJlcnJvciIsInBpbm8iLCJzdGRTZXJpYWxpemVycyIsImVyciIsInJlZGFjdCIsImdldExvZ2dlciIsIm5hbWUiLCJsb2dnZXIiLCJwaW5vTWl4IiwiY2hpbGQiLCJmbHVzaCIsImNiIiwiYXJncyIsIm1ldGhvZCIsIm1lc3NhZ2UiLCJhdCIsImRhdGEiLCJFcnJvciIsIm1zZyIsImNhbGwiLCJPYmplY3QiLCJhc3NpZ24iLCJjdXJyZW50TGV2ZWwiLCJsb2dMZXZlbHMiLCJsZXZlbHMiLCJ2YWx1ZXMiXSwibWFwcGluZ3MiOiI7Ozs7K0JBYWFBOzs7ZUFBQUE7Ozt3QkFSTjs2REFDMEI7Ozs7OztBQU8xQixNQUFNQSxvQkFBb0JDLGtCQUFVO0lBQ2xDQyxNQUFtQjtJQUNWQyxRQUE0QjtJQUM1QkMsT0FBK0I7SUFDaEQsWUFBbUJELE9BQTJCLEVBQUVDLE1BQStCLENBQUU7UUFDaEYsS0FBSztRQUNMLElBQUksQ0FBQ0QsT0FBTyxHQUFHQTtRQUNmLElBQUksQ0FBQ0MsTUFBTSxHQUFHQTtJQUNmO0lBRU9DLFVBQ05DLGFBQTJDLEVBQzFDO1FBQ0QsTUFBTSxFQUFFQyxRQUFRLEVBQUVDLFVBQVUsRUFBRSxHQUFHRjtRQUNqQyxNQUFNRyxlQUFlLElBQUksQ0FBQ0MsWUFBWSxDQUFDSjtRQUV2QyxNQUFNSyxjQUFrQztZQUN2Q0Y7WUFDQUcsT0FBT0w7WUFDUE0sT0FBTztnQkFBRUM7WUFBVTtZQUNuQkMsYUFBYTtnQkFDWkMsT0FBT0MsYUFBSSxDQUFDQyxjQUFjLENBQUNDLEdBQUc7WUFDL0I7WUFDQUMsUUFBUVo7WUFDUixHQUFHLElBQUksQ0FBQ0wsT0FBTztRQUNoQjtRQUNBLElBQUksQ0FBQ0QsS0FBSyxHQUFHZSxJQUFBQSxhQUFJLEVBQUNOLGFBQWEsSUFBSSxDQUFDUCxNQUFNO0lBQzNDO0lBRU9pQixVQUNOQyxJQUFZLEVBQ1k7UUFDeEIsTUFBTUMsU0FBU0MsUUFBdUIsSUFBSSxDQUFDdEIsS0FBSyxDQUFDdUIsS0FBSyxDQUFDO1lBQUVIO1FBQUs7UUFDOUQsT0FBT0M7SUFDUjtJQUVPRyxNQUFNQyxFQUFlLEVBQVE7UUFDbkMsSUFBSSxDQUFDekIsS0FBSyxDQUFDd0IsS0FBSyxDQUFDQztJQUNsQjtBQUNEO0FBRUEsU0FBU2IsVUFBNkJjLElBQXVCLEVBQUVDLE1BQWE7SUFDM0UsSUFBSUMsVUFBVUYsS0FBS0csRUFBRSxDQUFDO0lBQ3RCLE1BQU1DLE9BQU9KLEtBQUtHLEVBQUUsQ0FBQztJQUVyQixJQUFJQyxnQkFBZ0JDLE9BQU87UUFDMUJILFVBQVU7WUFBRUksS0FBS0o7WUFBUyxHQUFHO2dCQUFFZCxPQUFPZ0I7WUFBSyxDQUFDO1FBQUM7SUFDOUMsT0FBTyxJQUFJLE9BQU9BLFNBQVMsVUFBVTtRQUNwQ0YsVUFBVTtZQUFFSSxLQUFLSjtZQUFTLEdBQUdFLElBQUk7UUFBQztJQUNuQyxPQUFPO1FBQ05GLFVBQVU7WUFBRUksS0FBS0o7WUFBU0U7UUFBSztJQUNoQztJQUVBSCxPQUFPTSxJQUFJLENBQUMsSUFBSSxFQUFFTDtBQUNuQjtBQUVBLFNBQVNOLFFBQ1JELE1BQW1CO0lBRW5CLE9BQU9hLE9BQU9DLE1BQU0sQ0FBMEJkLFFBQVE7UUFDckQsSUFBSWUsZ0JBQWU7WUFDbEIsT0FBT2YsT0FBT1gsS0FBSztRQUNwQjtRQUNBLElBQUkyQixhQUFZO1lBQ2YsT0FBT2hCLE9BQU9pQixNQUFNLENBQUNDLE1BQU07UUFDNUI7SUFDRDtBQUNEIn0=

package/commonjs/src/pino.recipe.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "pinoRecipe", {
+    enumerable: true,
+    get: function() {
+        return pinoRecipe;
+    }
+});
+const _system = require("@decohere/core/system");
+const DEFAULT_ROLL_SIZE = "10m";
+const DEFAULT_ROLL_FREQUENCY = "daily";
+const DEFAULT_ROLL_KEEP = 14;
+const ENV_LOG_FILE = "SCRIBE_LOG_FILE";
+const ENV_LOG_SIZE = "SCRIBE_LOG_SIZE";
+const ENV_LOG_FREQUENCY = "SCRIBE_LOG_FREQUENCY";
+const ENV_LOG_KEEP = "SCRIBE_LOG_KEEP";
+function currentEnvironment() {
+    return process.env.NODE_ENV === _system.Environments.production ? _system.Environments.production : _system.Environments.development;
+}
+function isEnabled(when, environment) {
+    return (when ?? "development") === "always" || environment === _system.Environments.development;
+}
+function envString(name) {
+    const value = process.env[name]?.trim();
+    return value ? value : undefined;
+}
+function envFrequency() {
+    const raw = envString(ENV_LOG_FREQUENCY);
+    if (raw == null) {
+        return undefined;
+    }
+    if (/^\d+$/.test(raw)) {
+        return Number(raw);
+    }
+    return raw;
+}
+function envKeep() {
+    const raw = envString(ENV_LOG_KEEP);
+    if (raw == null) {
+        return undefined;
+    }
+    const keep = Number(raw);
+    return Number.isFinite(keep) && keep >= 0 ? keep : undefined;
+}
+/**
+ * Resolve roll options. `SCRIBE_LOG_FILE` overrides `file` so ops can redirect
+ * without touching app code. Size / frequency / keep: explicit > env > default.
+ */ function resolveRoll(options) {
+    return {
+        file: envString(ENV_LOG_FILE) ?? options.file,
+        size: options.size ?? envString(ENV_LOG_SIZE) ?? DEFAULT_ROLL_SIZE,
+        frequency: options.frequency ?? envFrequency() ?? DEFAULT_ROLL_FREQUENCY,
+        keep: options.keep ?? envKeep() ?? DEFAULT_ROLL_KEEP,
+        mkdir: options.mkdir ?? true,
+        symlink: options.symlink ?? false
+    };
+}
+function prettyTarget(options) {
+    return {
+        target: "pino-pretty",
+        options: {
+            colorize: options.colorize ?? true
+        }
+    };
+}
+function rollTarget(options) {
+    const roll = resolveRoll(options);
+    return {
+        target: "pino-roll",
+        options: {
+            file: roll.file,
+            mkdir: roll.mkdir,
+            size: roll.size,
+            frequency: roll.frequency,
+            limit: {
+                count: roll.keep
+            },
+            symlink: roll.symlink
+        }
+    };
+}
+function transport(plan, environment = currentEnvironment()) {
+    const targets = [];
+    if (plan.pretty && isEnabled(plan.pretty.when, environment)) {
+        targets.push(prettyTarget(plan.pretty));
+    }
+    if (plan.roll && isEnabled(plan.roll.when, environment)) {
+        targets.push(rollTarget(plan.roll));
+    }
+    if (targets.length === 0) {
+        return undefined;
+    }
+    if (targets.length === 1) {
+        return targets[0];
+    }
+    return {
+        targets
+    };
+}
+const pinoRecipe = {
+    transport,
+    currentEnvironment,
+    resolveRoll
+};

package/commonjs/src/pino.transport-guard.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "guardTransport", {
+    enumerable: true,
+    get: function() {
+        return guardTransport;
+    }
+});
+function guardTransport(transport) {
+    const stream = transport;
+    let retired = false;
+    let reported = false;
+    const retire = (reason = "retired")=>{
+        if (retired) {
+            return;
+        }
+        retired = true;
+        if (!reported) {
+            reported = true;
+            process.stderr.write(`[scribe-pino] transport retired: ${reason}\n`);
+        }
+        if (typeof stream.destroy === "function") {
+            try {
+                stream.destroy();
+            } catch  {
+            // already dead
+            }
+        }
+    };
+    if (typeof stream.on === "function") {
+        stream.on("error", (err)=>{
+            retire(err?.message ?? String(err));
+        });
+    }
+    if (typeof stream.write === "function") {
+        const originalWrite = stream.write.bind(stream);
+        stream.write = (chunk, encodingOrCb, cb)=>{
+            if (retired) {
+                completeWrite(encodingOrCb, cb);
+                return true;
+            }
+            try {
+                return originalWrite(chunk, encodingOrCb, cb);
+            } catch (err) {
+                retire(err instanceof Error ? err.message : String(err));
+                completeWrite(encodingOrCb, cb);
+                return true;
+            }
+        };
+    }
+    Object.defineProperty(stream, "retired", {
+        get: ()=>retired,
+        enumerable: true
+    });
+    Object.defineProperty(stream, "retire", {
+        value: retire,
+        enumerable: true
+    });
+    return stream;
+}
+function completeWrite(encodingOrCb, cb) {
+    const done = typeof encodingOrCb === "function" ? encodingOrCb : typeof cb === "function" ? cb : undefined;
+    if (typeof done === "function") {
+        done();
+    }
+}

package/commonjs/src/scribe-pino.js

@@ -2,16 +2,35 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "PinoExtensions", {
-    enumerable: true,
-    get: function() {
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get PinoExtensions () {
         return PinoExtensions;
+    },
+    get guardTransport () {
+        return _pinotransportguard.guardTransport;
+    },
+    get pinoTransport () {
+        return pinoTransport;
     }
 });
-const _extensibility = require("@decohere/nexus/extensibility");
-const _system = require("@decohere/nexus/system");
+const _extensibility = require("@decohere/core/extensibility");
+const _system = require("@decohere/core/system");
 const _scribe = require("@decohere/scribe");
+const _pino = /*#__PURE__*/ _interop_require_default(require("pino"));
 const _pinoadapater = require("./pino.adapater.js");
+const _pinorecipe = require("./pino.recipe.js");
+const _pinotransportguard = require("./pino.transport-guard.js");
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
 function _ts_decorate(decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -23,27 +42,32 @@ function _ts_metadata(k, v) {
 }
 class PinoExtensions {
     static withPino(factory, config, logLevel) {
-        return configureScribe(factory, {
+        return configureScribe(factory, logLevel != null ? {
             logLevel
-        }, config);
+        } : undefined, config);
     }
-    static withPinoPretty(factory, logLevel) {
-        return PinoExtensions.withPino(factory, {
-            transports: {
-                target: "pino-pretty",
-                options: {
-                    colorize: true
-                }
-            }
-        }, logLevel);
+    static withPinoPretty(factory, logLevelOrOptions) {
+        const pretty = parsePrettyArg(logLevelOrOptions);
+        return attachRecipe(factory, {
+            pretty,
+            logLevel: pretty.logLevel
+        });
+    }
+    static withPinoRoll(factory, options) {
+        return attachRecipe(factory, {
+            roll: options,
+            logLevel: options.logLevel
+        });
     }
     static withPinoCustom(factory, options) {
-        const { scribe, transports } = options;
+        const { scribe, transports } = options ?? {};
         return configureScribe(factory, scribe, transports);
     }
 }
 _ts_decorate([
-    (0, _extensibility.extension)(_scribe.scribe),
+    (0, _extensibility.extension)(_scribe.scribe, {
+        static: true
+    }),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof _scribe.scribe === "undefined" ? Object : _scribe.scribe,
@@ -53,7 +77,9 @@ _ts_decorate([
     _ts_metadata("design:returntype", void 0)
 ], PinoExtensions, "withPino", null);
 _ts_decorate([
-    (0, _extensibility.extension)(_scribe.scribe),
+    (0, _extensibility.extension)(_scribe.scribe, {
+        static: true
+    }),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof _scribe.scribe === "undefined" ? Object : _scribe.scribe,
@@ -62,7 +88,20 @@ _ts_decorate([
     _ts_metadata("design:returntype", void 0)
 ], PinoExtensions, "withPinoPretty", null);
 _ts_decorate([
-    (0, _extensibility.extension)(_scribe.scribe),
+    (0, _extensibility.extension)(_scribe.scribe, {
+        static: true
+    }),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof _scribe.scribe === "undefined" ? Object : _scribe.scribe,
+        typeof PinoRollRecipeOptions === "undefined" ? Object : PinoRollRecipeOptions
+    ]),
+    _ts_metadata("design:returntype", void 0)
+], PinoExtensions, "withPinoRoll", null);
+_ts_decorate([
+    (0, _extensibility.extension)(_scribe.scribe, {
+        static: true
+    }),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof _scribe.scribe === "undefined" ? Object : _scribe.scribe,
@@ -70,23 +109,85 @@ _ts_decorate([
     ]),
     _ts_metadata("design:returntype", void 0)
 ], PinoExtensions, "withPinoCustom", null);
+function parsePrettyArg(logLevelOrOptions) {
+    if (logLevelOrOptions == null) {
+        return {};
+    }
+    if (typeof logLevelOrOptions === "string") {
+        return {
+            logLevel: logLevelOrOptions
+        };
+    }
+    return logLevelOrOptions;
+}
+function attachRecipe(factory, plan) {
+    const loggerFactory = applyRecipe(factory, plan);
+    const chain = {
+        withPinoPretty (logLevelOrOptions) {
+            const pretty = parsePrettyArg(logLevelOrOptions);
+            return attachRecipe(factory, {
+                ...plan,
+                pretty: {
+                    ...plan.pretty,
+                    ...pretty
+                },
+                logLevel: pretty.logLevel ?? plan.logLevel
+            });
+        },
+        withPinoRoll (options) {
+            return attachRecipe(factory, {
+                ...plan,
+                roll: options,
+                logLevel: options.logLevel ?? plan.logLevel
+            });
+        }
+    };
+    return Object.assign(loggerFactory, chain, {
+        and: chain
+    });
+}
+/**
+ * Guard a worker transport so failures (roll EEXIST, worker exit) neither
+ * crash the process nor spam stderr on every subsequent log write.
+ */ function createSafeTransport(options) {
+    return (0, _pinotransportguard.guardTransport)(_pino.default.transport(options));
+}
+function adapterForTransport(transport) {
+    if (transport == null) {
+        return new _pinoadapater.PinoAdapter({});
+    }
+    return new _pinoadapater.PinoAdapter({}, createSafeTransport(transport));
+}
+function applyRecipe(factory, plan) {
+    const adapter = adapterForTransport(_pinorecipe.pinoRecipe.transport(plan));
+    // Omit logLevel when unset so mergeDefaults can read LOG_LEVEL / SCRIBE_LOG_LEVEL.
+    return factory.configure({
+        options: plan.logLevel != null ? {
+            logLevel: plan.logLevel
+        } : {},
+        adapter
+    });
+}
 function configureScribe(factory, options, config) {
     const environment = process.env.NODE_ENV ?? _system.DefaultEnvironment;
-    const configs = Array.isArray(config) ? config : [
+    const configs = (Array.isArray(config) ? config : config != null ? [
         config
-    ];
-    const transports = configs.filter((config)=>config.environment && config.environment === environment || true);
-    if (transports.length > 1) {
+    ] : []).filter((item)=>item.environment == null || item.environment === environment);
+    if (configs.length > 1) {
         throw new _scribe.LoggingConfigurationError(`There should only be one configuration per environment for logging`);
     }
-    const transport = transports.at(0)?.transports;
-    const adapter = new _pinoadapater.PinoAdapter({
-        transport
-    });
+    const adapter = adapterForTransport(configs.at(0)?.transports);
+    // Do not force DefaultLogLevel — that would shadow env resolution in mergeDefaults.
     return factory.configure({
-        options,
+        options: options ?? {},
         adapter
     });
 }
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjcmliZS9zY3JpYmUtcGluby9zcmMvc2NyaWJlLXBpbm8udHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgZXh0ZW5zaW9uIH0gZnJvbSBcIkBkZWNvaGVyZS9uZXh1cy9leHRlbnNpYmlsaXR5XCI7XG5pbXBvcnQgeyBEZWZhdWx0RW52aXJvbm1lbnQsIHR5cGUgRW52aXJvbm1lbnQgfSBmcm9tIFwiQGRlY29oZXJlL25leHVzL3N5c3RlbVwiO1xuaW1wb3J0IHtcblx0dHlwZSBEZWZhdWx0TGV2ZWxzLFxuXHR0eXBlIExvZ2dlcixcblx0TG9nZ2luZ0NvbmZpZ3VyYXRpb25FcnJvcixcblx0dHlwZSBTY3JpYmVPcHRpb25zLFxuXHRzY3JpYmUsXG59IGZyb20gXCJAZGVjb2hlcmUvc2NyaWJlXCI7XG5pbXBvcnQgdHlwZSB7XG5cdFRyYW5zcG9ydE11bHRpT3B0aW9ucyxcblx0VHJhbnNwb3J0UGlwZWxpbmVPcHRpb25zLFxuXHRUcmFuc3BvcnRTaW5nbGVPcHRpb25zLFxufSBmcm9tIFwicGlub1wiO1xuXG5pbXBvcnQgeyBQaW5vQWRhcHRlciB9IGZyb20gXCIuL3Bpbm8uYWRhcGF0ZXIuanNcIjtcblxudHlwZSBUcmFuc3BvcnRDb25maWcgPSB7XG5cdGVudmlyb25tZW50PzogRW52aXJvbm1lbnQ7XG5cdHRyYW5zcG9ydHM6IFRyYW5zcG9ydFNpbmdsZU9wdGlvbnMgfCBUcmFuc3BvcnRNdWx0aU9wdGlvbnMgfCBUcmFuc3BvcnRQaXBlbGluZU9wdGlvbnM7XG59O1xuXG50eXBlIEN1c3RvbUxldmVsT3B0aW9uczxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlID0gdW5kZWZpbmVkPiA9IHtcblx0c2NyaWJlPzogU2NyaWJlT3B0aW9uczxULCBDdXN0b21Pbmx5Pjtcblx0dHJhbnNwb3J0cz86IFRyYW5zcG9ydENvbmZpZyB8IFRyYW5zcG9ydENvbmZpZ1tdO1xufTtcblxuZGVjbGFyZSBtb2R1bGUgXCJAZGVjb2hlcmUvc2NyaWJlXCIge1xuXHRpbnRlcmZhY2Ugc2NyaWJlIHtcblx0XHR3aXRoUGlubyhcblx0XHRcdHRyYW5zcG9ydHM6IFRyYW5zcG9ydENvbmZpZyB8IFRyYW5zcG9ydENvbmZpZ1tdLFxuXHRcdFx0bG9nbGV2ZWw/OiBEZWZhdWx0TGV2ZWxzIHwgc3RyaW5nLFxuXHRcdCk6IChuYW1lPzogc3RyaW5nKSA9PiBMb2dnZXI7XG5cdFx0d2l0aFBpbm9QcmV0dHkobG9nTGV2ZWw/OiBEZWZhdWx0TGV2ZWxzIHwgc3RyaW5nKTogKG5hbWU/OiBzdHJpbmcpID0+IExvZ2dlcjtcblx0XHR3aXRoUGlub0N1c3RvbTxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlID0gdW5kZWZpbmVkPihcblx0XHRcdG9wdGlvbnM/OiBDdXN0b21MZXZlbE9wdGlvbnM8VCwgQ3VzdG9tT25seT4sXG5cdFx0KTogKG5hbWU/OiBzdHJpbmcpID0+IExvZ2dlcjxULCBDdXN0b21Pbmx5Pjtcblx0fVxufVxuXG5leHBvcnQgY2xhc3MgUGlub0V4dGVuc2lvbnMge1xuXHRAZXh0ZW5zaW9uKHNjcmliZSlcblx0cHVibGljIHN0YXRpYyB3aXRoUGlubyhcblx0XHRmYWN0b3J5OiBzY3JpYmUsXG5cdFx0Y29uZmlnOiBUcmFuc3BvcnRDb25maWcgfCBUcmFuc3BvcnRDb25maWdbXSxcblx0XHRsb2dMZXZlbD86IERlZmF1bHRMZXZlbHMgfCBzdHJpbmcsXG5cdCkge1xuXHRcdHJldHVybiBjb25maWd1cmVTY3JpYmUoZmFjdG9yeSwgeyBsb2dMZXZlbCB9LCBjb25maWcpO1xuXHR9XG5cblx0QGV4dGVuc2lvbihzY3JpYmUpXG5cdHB1YmxpYyBzdGF0aWMgd2l0aFBpbm9QcmV0dHkoZmFjdG9yeTogc2NyaWJlLCBsb2dMZXZlbD86IERlZmF1bHRMZXZlbHMgfCBzdHJpbmcpIHtcblx0XHRyZXR1cm4gUGlub0V4dGVuc2lvbnMud2l0aFBpbm8oXG5cdFx0XHRmYWN0b3J5LFxuXHRcdFx0eyB0cmFuc3BvcnRzOiB7IHRhcmdldDogXCJwaW5vLXByZXR0eVwiLCBvcHRpb25zOiB7IGNvbG9yaXplOiB0cnVlIH0gfSB9LFxuXHRcdFx0bG9nTGV2ZWwsXG5cdFx0KTtcblx0fVxuXG5cdEBleHRlbnNpb24oc2NyaWJlKVxuXHRwdWJsaWMgc3RhdGljIHdpdGhQaW5vQ3VzdG9tPFQgZXh0ZW5kcyBzdHJpbmcgPSBuZXZlciwgQ3VzdG9tT25seSBleHRlbmRzIHRydWUgPSB1bmRlZmluZWQ+KFxuXHRcdGZhY3Rvcnk6IHNjcmliZSxcblx0XHRvcHRpb25zPzogQ3VzdG9tTGV2ZWxPcHRpb25zPFQsIEN1c3RvbU9ubHk+LFxuXHQpIHtcblx0XHRjb25zdCB7IHNjcmliZSwgdHJhbnNwb3J0cyB9ID0gb3B0aW9ucztcblx0XHRyZXR1cm4gY29uZmlndXJlU2NyaWJlKGZhY3RvcnksIHNjcmliZSwgdHJhbnNwb3J0cyk7XG5cdH1cbn1cblxuZnVuY3Rpb24gY29uZmlndXJlU2NyaWJlPFQgZXh0ZW5kcyBzdHJpbmcgPSBuZXZlciwgQ3VzdG9tT25seSBleHRlbmRzIHRydWUgfCBmYWxzZSA9IGZhbHNlPihcblx0ZmFjdG9yeTogc2NyaWJlLFxuXHRvcHRpb25zOiBTY3JpYmVPcHRpb25zPFQsIEN1c3RvbU9ubHk+LFxuXHRjb25maWc6IFRyYW5zcG9ydENvbmZpZyB8IFRyYW5zcG9ydENvbmZpZ1tdLFxuKSB7XG5cdGNvbnN0IGVudmlyb25tZW50ID0gcHJvY2Vzcy5lbnYuTk9ERV9FTlYgPz8gRGVmYXVsdEVudmlyb25tZW50O1xuXHRjb25zdCBjb25maWdzID0gQXJyYXkuaXNBcnJheShjb25maWcpID8gY29uZmlnIDogW2NvbmZpZ107XG5cdGNvbnN0IHRyYW5zcG9ydHMgPSBjb25maWdzLmZpbHRlcihcblx0XHQoY29uZmlnKSA9PiAoY29uZmlnLmVudmlyb25tZW50ICYmIGNvbmZpZy5lbnZpcm9ubWVudCA9PT0gZW52aXJvbm1lbnQpIHx8IHRydWUsXG5cdCk7XG5cblx0aWYgKHRyYW5zcG9ydHMubGVuZ3RoID4gMSkge1xuXHRcdHRocm93IG5ldyBMb2dnaW5nQ29uZmlndXJhdGlvbkVycm9yKFxuXHRcdFx0YFRoZXJlIHNob3VsZCBvbmx5IGJlIG9uZSBjb25maWd1cmF0aW9uIHBlciBlbnZpcm9ubWVudCBmb3IgbG9nZ2luZ2AsXG5cdFx0KTtcblx0fVxuXG5cdGNvbnN0IHRyYW5zcG9ydCA9IHRyYW5zcG9ydHMuYXQoMCk/LnRyYW5zcG9ydHM7XG5cdGNvbnN0IGFkYXB0ZXIgPSBuZXcgUGlub0FkYXB0ZXIoeyB0cmFuc3BvcnQgfSk7XG5cdHJldHVybiBmYWN0b3J5LmNvbmZpZ3VyZSh7XG5cdFx0b3B0aW9ucyxcblx0XHRhZGFwdGVyLFxuXHR9KTtcbn1cbiJdLCJuYW1lcyI6WyJQaW5vRXh0ZW5zaW9ucyIsIndpdGhQaW5vIiwiZmFjdG9yeSIsImNvbmZpZyIsImxvZ0xldmVsIiwiY29uZmlndXJlU2NyaWJlIiwid2l0aFBpbm9QcmV0dHkiLCJ0cmFuc3BvcnRzIiwidGFyZ2V0Iiwib3B0aW9ucyIsImNvbG9yaXplIiwid2l0aFBpbm9DdXN0b20iLCJzY3JpYmUiLCJlbnZpcm9ubWVudCIsInByb2Nlc3MiLCJlbnYiLCJOT0RFX0VOViIsIkRlZmF1bHRFbnZpcm9ubWVudCIsImNvbmZpZ3MiLCJBcnJheSIsImlzQXJyYXkiLCJmaWx0ZXIiLCJsZW5ndGgiLCJMb2dnaW5nQ29uZmlndXJhdGlvbkVycm9yIiwidHJhbnNwb3J0IiwiYXQiLCJhZGFwdGVyIiwiUGlub0FkYXB0ZXIiLCJjb25maWd1cmUiXSwibWFwcGluZ3MiOiI7Ozs7K0JBd0NhQTs7O2VBQUFBOzs7K0JBeENhO3dCQUMyQjt3QkFPOUM7OEJBT3FCOzs7Ozs7Ozs7O0FBeUJyQixNQUFNQTtJQUNaLE9BQ2NDLFNBQ2JDLE9BQWUsRUFDZkMsTUFBMkMsRUFDM0NDLFFBQWlDLEVBQ2hDO1FBQ0QsT0FBT0MsZ0JBQWdCSCxTQUFTO1lBQUVFO1FBQVMsR0FBR0Q7SUFDL0M7SUFFQSxPQUNjRyxlQUFlSixPQUFlLEVBQUVFLFFBQWlDLEVBQUU7UUFDaEYsT0FBT0osZUFBZUMsUUFBUSxDQUM3QkMsU0FDQTtZQUFFSyxZQUFZO2dCQUFFQyxRQUFRO2dCQUFlQyxTQUFTO29CQUFFQyxVQUFVO2dCQUFLO1lBQUU7UUFBRSxHQUNyRU47SUFFRjtJQUVBLE9BQ2NPLGVBQ2JULE9BQWUsRUFDZk8sT0FBMkMsRUFDMUM7UUFDRCxNQUFNLEVBQUVHLE1BQU0sRUFBRUwsVUFBVSxFQUFFLEdBQUdFO1FBQy9CLE9BQU9KLGdCQUFnQkgsU0FBU1UsUUFBUUw7SUFDekM7QUFDRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFQSxTQUFTRixnQkFDUkgsT0FBZSxFQUNmTyxPQUFxQyxFQUNyQ04sTUFBMkM7SUFFM0MsTUFBTVUsY0FBY0MsUUFBUUMsR0FBRyxDQUFDQyxRQUFRLElBQUlDLDBCQUFrQjtJQUM5RCxNQUFNQyxVQUFVQyxNQUFNQyxPQUFPLENBQUNqQixVQUFVQSxTQUFTO1FBQUNBO0tBQU87SUFDekQsTUFBTUksYUFBYVcsUUFBUUcsTUFBTSxDQUNoQyxDQUFDbEIsU0FBVyxBQUFDQSxPQUFPVSxXQUFXLElBQUlWLE9BQU9VLFdBQVcsS0FBS0EsZUFBZ0I7SUFHM0UsSUFBSU4sV0FBV2UsTUFBTSxHQUFHLEdBQUc7UUFDMUIsTUFBTSxJQUFJQyxpQ0FBeUIsQ0FDbEMsQ0FBQyxrRUFBa0UsQ0FBQztJQUV0RTtJQUVBLE1BQU1DLFlBQVlqQixXQUFXa0IsRUFBRSxDQUFDLElBQUlsQjtJQUNwQyxNQUFNbUIsVUFBVSxJQUFJQyx5QkFBVyxDQUFDO1FBQUVIO0lBQVU7SUFDNUMsT0FBT3RCLFFBQVEwQixTQUFTLENBQUM7UUFDeEJuQjtRQUNBaUI7SUFDRDtBQUNEIn0=
+/** @deprecated Use {@link guardTransport} — kept for callers/tests from the silence-only era. */ function silenceErrors(transport) {
+    return (0, _pinotransportguard.guardTransport)(transport);
+}
+const pinoTransport = {
+    createSafeTransport,
+    guardTransport: _pinotransportguard.guardTransport,
+    silenceErrors
+};

package/es6/src/index.js

@@ -1,4 +1,3 @@
 export * from "./pino.adapater.js";
+export * from "./pino.recipe.js";
 export * from "./scribe-pino.js";
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjcmliZS9zY3JpYmUtcGluby9zcmMvaW5kZXgudHMiXSwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0ICogZnJvbSBcIi4vcGluby5hZGFwYXRlci5qc1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vc2NyaWJlLXBpbm8uanNcIjtcbiJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHFCQUFxQjtBQUNuQyxjQUFjLG1CQUFtQiJ9