@decohere/scribe-pino 0.0.1-dev.10 → 0.0.1-dev.100

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 = {
@@ -84,5 +204,3 @@ function pinoMix(logger) {
         }
     });
 }
-
-//# 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/nexus/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 _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

package/es6/src/pino.adapater.js

@@ -1,9 +1,11 @@
-import { LogAdapter } from "@decohere/scribe";
+import { formatError, LogAdapter } from "@decohere/scribe";
 import pino from "pino";
 export class PinoAdapter extends LogAdapter {
     _pino;
     options;
     stream;
+    disposed = false;
+    retired = false;
     constructor(options, stream){
         super();
         this.options = options;
@@ -33,18 +35,136 @@ export class PinoAdapter extends 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
+        }, formatError(message));
+        return;
+    }
     if (data instanceof Error) {
         message = {
             msg: message,
-            ...{
-                error: data
-            }
+            error: data
         };
     } else if (typeof data === "object") {
         message = {
@@ -69,5 +189,3 @@ function pinoMix(logger) {
         }
     });
 }
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjcmliZS9zY3JpYmUtcGluby9zcmMvcGluby5hZGFwYXRlci50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge1xuXHR0eXBlIEJhc2VMb2dnZXIsXG5cdExvZ0FkYXB0ZXIsXG5cdHR5cGUgTG9nZ2VyLFxuXHR0eXBlIFNjcmliZU9wdGlvbnMsXG59IGZyb20gXCJAZGVjb2hlcmUvc2NyaWJlXCI7XG5pbXBvcnQgcGlubywgeyB0eXBlIExvZ0ZuIH0gZnJvbSBcInBpbm9cIjtcblxuZXhwb3J0IHR5cGUgUGlub0FkYXBhdGVyT3B0aW9ucyA9IHtcblx0b3B0aW9ucz86IHBpbm8uTG9nZ2VyT3B0aW9ucztcblx0c3RyZWFtPzogcGluby5EZXN0aW5hdGlvblN0cmVhbTtcbn07XG5cbmV4cG9ydCBjbGFzcyBQaW5vQWRhcHRlciBleHRlbmRzIExvZ0FkYXB0ZXIge1xuXHRwcml2YXRlIF9waW5vOiBwaW5vLkxvZ2dlcjtcblx0cHJpdmF0ZSByZWFkb25seSBvcHRpb25zOiBwaW5vLkxvZ2dlck9wdGlvbnM7XG5cdHByaXZhdGUgcmVhZG9ubHkgc3RyZWFtOiBwaW5vLkRlc3RpbmF0aW9uU3RyZWFtO1xuXHRwdWJsaWMgY29uc3RydWN0b3Iob3B0aW9uczogcGluby5Mb2dnZXJPcHRpb25zLCBzdHJlYW0/OiBwaW5vLkRlc3RpbmF0aW9uU3RyZWFtKSB7XG5cdFx0c3VwZXIoKTtcblx0XHR0aGlzLm9wdGlvbnMgPSBvcHRpb25zO1xuXHRcdHRoaXMuc3RyZWFtID0gc3RyZWFtO1xuXHR9XG5cblx0cHVibGljIGNvbmZpZ3VyZTxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlIHwgZmFsc2UgPSBmYWxzZT4oXG5cdFx0c2NyaWJlT3B0aW9uczogU2NyaWJlT3B0aW9uczxULCBDdXN0b21Pbmx5Pixcblx0KSB7XG5cdFx0Y29uc3QgeyBsb2dMZXZlbCwgcmVkYWN0aW9ucyB9ID0gc2NyaWJlT3B0aW9ucztcblx0XHRjb25zdCBjdXN0b21MZXZlbHMgPSB0aGlzLmdldExvZ0xldmVscyhzY3JpYmVPcHRpb25zKTtcblxuXHRcdGNvbnN0IHBpbm9PcHRpb25zOiBwaW5vLkxvZ2dlck9wdGlvbnMgPSB7XG5cdFx0XHRjdXN0b21MZXZlbHMsXG5cdFx0XHRsZXZlbDogbG9nTGV2ZWwsXG5cdFx0XHRob29rczogeyBsb2dNZXRob2QgfSxcblx0XHRcdHNlcmlhbGl6ZXJzOiB7XG5cdFx0XHRcdGVycm9yOiBwaW5vLnN0ZFNlcmlhbGl6ZXJzLmVycixcblx0XHRcdH0sXG5cdFx0XHRyZWRhY3Q6IHJlZGFjdGlvbnMsXG5cdFx0XHQuLi50aGlzLm9wdGlvbnMsXG5cdFx0fTtcblx0XHR0aGlzLl9waW5vID0gcGlubyhwaW5vT3B0aW9ucywgdGhpcy5zdHJlYW0pO1xuXHR9XG5cblx0cHVibGljIGdldExvZ2dlcjxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlIHwgZmFsc2UgPSBmYWxzZT4oXG5cdFx0bmFtZTogc3RyaW5nLFxuXHQpOiBMb2dnZXI8VCwgQ3VzdG9tT25seT4ge1xuXHRcdGNvbnN0IGxvZ2dlciA9IHBpbm9NaXg8VCwgQ3VzdG9tT25seT4odGhpcy5fcGluby5jaGlsZCh7IG5hbWUgfSkpO1xuXHRcdHJldHVybiBsb2dnZXI7XG5cdH1cblxuXHRwdWJsaWMgZmx1c2goY2I/OiAoKSA9PiB2b2lkKTogdm9pZCB7XG5cdFx0dGhpcy5fcGluby5mbHVzaChjYik7XG5cdH1cbn1cblxuZnVuY3Rpb24gbG9nTWV0aG9kKHRoaXM6IHBpbm8uTG9nZ2VyLCBhcmdzOiBQYXJhbWV0ZXJzPExvZ0ZuPiwgbWV0aG9kOiBMb2dGbikge1xuXHRsZXQgbWVzc2FnZSA9IGFyZ3MuYXQoMCk7XG5cdGNvbnN0IGRhdGEgPSBhcmdzLmF0KDEpO1xuXG5cdGlmIChkYXRhIGluc3RhbmNlb2YgRXJyb3IpIHtcblx0XHRtZXNzYWdlID0geyBtc2c6IG1lc3NhZ2UsIC4uLnsgZXJyb3I6IGRhdGEgfSB9O1xuXHR9IGVsc2UgaWYgKHR5cGVvZiBkYXRhID09PSBcIm9iamVjdFwiKSB7XG5cdFx0bWVzc2FnZSA9IHsgbXNnOiBtZXNzYWdlLCAuLi5kYXRhIH07XG5cdH0gZWxzZSB7XG5cdFx0bWVzc2FnZSA9IHsgbXNnOiBtZXNzYWdlLCBkYXRhIH07XG5cdH1cblxuXHRtZXRob2QuY2FsbCh0aGlzLCBtZXNzYWdlKTtcbn1cblxuZnVuY3Rpb24gcGlub01peDxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlIHwgZmFsc2UgPSBmYWxzZT4oXG5cdGxvZ2dlcjogcGluby5Mb2dnZXIsXG4pOiBMb2dnZXI8VCwgQ3VzdG9tT25seT4ge1xuXHRyZXR1cm4gT2JqZWN0LmFzc2lnbjxwaW5vLkxvZ2dlciwgQmFzZUxvZ2dlcj4obG9nZ2VyLCB7XG5cdFx0Z2V0IGN1cnJlbnRMZXZlbCgpIHtcblx0XHRcdHJldHVybiBsb2dnZXIubGV2ZWw7XG5cdFx0fSxcblx0XHRnZXQgbG9nTGV2ZWxzKCkge1xuXHRcdFx0cmV0dXJuIGxvZ2dlci5sZXZlbHMudmFsdWVzO1xuXHRcdH0sXG5cdH0pIGFzIExvZ2dlcjxULCBDdXN0b21Pbmx5Pjtcbn1cbiJdLCJuYW1lcyI6WyJMb2dBZGFwdGVyIiwicGlubyIsIlBpbm9BZGFwdGVyIiwiX3Bpbm8iLCJvcHRpb25zIiwic3RyZWFtIiwiY29uZmlndXJlIiwic2NyaWJlT3B0aW9ucyIsImxvZ0xldmVsIiwicmVkYWN0aW9ucyIsImN1c3RvbUxldmVscyIsImdldExvZ0xldmVscyIsInBpbm9PcHRpb25zIiwibGV2ZWwiLCJob29rcyIsImxvZ01ldGhvZCIsInNlcmlhbGl6ZXJzIiwiZXJyb3IiLCJzdGRTZXJpYWxpemVycyIsImVyciIsInJlZGFjdCIsImdldExvZ2dlciIsIm5hbWUiLCJsb2dnZXIiLCJwaW5vTWl4IiwiY2hpbGQiLCJmbHVzaCIsImNiIiwiYXJncyIsIm1ldGhvZCIsIm1lc3NhZ2UiLCJhdCIsImRhdGEiLCJFcnJvciIsIm1zZyIsImNhbGwiLCJPYmplY3QiLCJhc3NpZ24iLCJjdXJyZW50TGV2ZWwiLCJsb2dMZXZlbHMiLCJsZXZlbHMiLCJ2YWx1ZXMiXSwibWFwcGluZ3MiOiJBQUFBLFNBRUNBLFVBQVUsUUFHSixtQkFBbUI7QUFDMUIsT0FBT0MsVUFBMEIsT0FBTztBQU94QyxPQUFPLE1BQU1DLG9CQUFvQkY7SUFDeEJHLE1BQW1CO0lBQ1ZDLFFBQTRCO0lBQzVCQyxPQUErQjtJQUNoRCxZQUFtQkQsT0FBMkIsRUFBRUMsTUFBK0IsQ0FBRTtRQUNoRixLQUFLO1FBQ0wsSUFBSSxDQUFDRCxPQUFPLEdBQUdBO1FBQ2YsSUFBSSxDQUFDQyxNQUFNLEdBQUdBO0lBQ2Y7SUFFT0MsVUFDTkMsYUFBMkMsRUFDMUM7UUFDRCxNQUFNLEVBQUVDLFFBQVEsRUFBRUMsVUFBVSxFQUFFLEdBQUdGO1FBQ2pDLE1BQU1HLGVBQWUsSUFBSSxDQUFDQyxZQUFZLENBQUNKO1FBRXZDLE1BQU1LLGNBQWtDO1lBQ3ZDRjtZQUNBRyxPQUFPTDtZQUNQTSxPQUFPO2dCQUFFQztZQUFVO1lBQ25CQyxhQUFhO2dCQUNaQyxPQUFPaEIsS0FBS2lCLGNBQWMsQ0FBQ0MsR0FBRztZQUMvQjtZQUNBQyxRQUFRWDtZQUNSLEdBQUcsSUFBSSxDQUFDTCxPQUFPO1FBQ2hCO1FBQ0EsSUFBSSxDQUFDRCxLQUFLLEdBQUdGLEtBQUtXLGFBQWEsSUFBSSxDQUFDUCxNQUFNO0lBQzNDO0lBRU9nQixVQUNOQyxJQUFZLEVBQ1k7UUFDeEIsTUFBTUMsU0FBU0MsUUFBdUIsSUFBSSxDQUFDckIsS0FBSyxDQUFDc0IsS0FBSyxDQUFDO1lBQUVIO1FBQUs7UUFDOUQsT0FBT0M7SUFDUjtJQUVPRyxNQUFNQyxFQUFlLEVBQVE7UUFDbkMsSUFBSSxDQUFDeEIsS0FBSyxDQUFDdUIsS0FBSyxDQUFDQztJQUNsQjtBQUNEO0FBRUEsU0FBU1osVUFBNkJhLElBQXVCLEVBQUVDLE1BQWE7SUFDM0UsSUFBSUMsVUFBVUYsS0FBS0csRUFBRSxDQUFDO0lBQ3RCLE1BQU1DLE9BQU9KLEtBQUtHLEVBQUUsQ0FBQztJQUVyQixJQUFJQyxnQkFBZ0JDLE9BQU87UUFDMUJILFVBQVU7WUFBRUksS0FBS0o7WUFBUyxHQUFHO2dCQUFFYixPQUFPZTtZQUFLLENBQUM7UUFBQztJQUM5QyxPQUFPLElBQUksT0FBT0EsU0FBUyxVQUFVO1FBQ3BDRixVQUFVO1lBQUVJLEtBQUtKO1lBQVMsR0FBR0UsSUFBSTtRQUFDO0lBQ25DLE9BQU87UUFDTkYsVUFBVTtZQUFFSSxLQUFLSjtZQUFTRTtRQUFLO0lBQ2hDO0lBRUFILE9BQU9NLElBQUksQ0FBQyxJQUFJLEVBQUVMO0FBQ25CO0FBRUEsU0FBU04sUUFDUkQsTUFBbUI7SUFFbkIsT0FBT2EsT0FBT0MsTUFBTSxDQUEwQmQsUUFBUTtRQUNyRCxJQUFJZSxnQkFBZTtZQUNsQixPQUFPZixPQUFPVixLQUFLO1FBQ3BCO1FBQ0EsSUFBSTBCLGFBQVk7WUFDZixPQUFPaEIsT0FBT2lCLE1BQU0sQ0FBQ0MsTUFBTTtRQUM1QjtJQUNEO0FBQ0QifQ==

package/es6/src/pino.recipe.js

@@ -0,0 +1,96 @@
+import { Environments } from "@decohere/nexus/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 === Environments.production ? Environments.production : Environments.development;
+}
+function isEnabled(when, environment) {
+    return (when ?? "development") === "always" || environment === 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
+    };
+}
+export const pinoRecipe = {
+    transport,
+    currentEnvironment,
+    resolveRoll
+};

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

@@ -0,0 +1,61 @@
+/**
+ * Wrap a pino worker transport so a dead ThreadStream cannot spam or crash.
+ * On first error / write throw: report once, destroy, no-op further writes.
+ */ export 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/es6/src/scribe-pino.js

@@ -10,30 +10,39 @@ function _ts_metadata(k, v) {
 import { extension } from "@decohere/nexus/extensibility";
 import { DefaultEnvironment } from "@decohere/nexus/system";
 import { LoggingConfigurationError, scribe } from "@decohere/scribe";
+import pino from "pino";
 import { PinoAdapter } from "./pino.adapater.js";
+import { pinoRecipe } from "./pino.recipe.js";
+import { guardTransport } from "./pino.transport-guard.js";
+export { guardTransport } from "./pino.transport-guard.js";
 export 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([
-    extension(scribe),
+    extension(scribe, {
+        static: true
+    }),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof scribe === "undefined" ? Object : scribe,
@@ -43,7 +52,9 @@ _ts_decorate([
     _ts_metadata("design:returntype", void 0)
 ], PinoExtensions, "withPino", null);
 _ts_decorate([
-    extension(scribe),
+    extension(scribe, {
+        static: true
+    }),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof scribe === "undefined" ? Object : scribe,
@@ -52,7 +63,20 @@ _ts_decorate([
     _ts_metadata("design:returntype", void 0)
 ], PinoExtensions, "withPinoPretty", null);
 _ts_decorate([
-    extension(scribe),
+    extension(scribe, {
+        static: true
+    }),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof scribe === "undefined" ? Object : scribe,
+        typeof PinoRollRecipeOptions === "undefined" ? Object : PinoRollRecipeOptions
+    ]),
+    _ts_metadata("design:returntype", void 0)
+], PinoExtensions, "withPinoRoll", null);
+_ts_decorate([
+    extension(scribe, {
+        static: true
+    }),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof scribe === "undefined" ? Object : scribe,
@@ -60,23 +84,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 guardTransport(pino.transport(options));
+}
+function adapterForTransport(transport) {
+    if (transport == null) {
+        return new PinoAdapter({});
+    }
+    return new PinoAdapter({}, createSafeTransport(transport));
+}
+function applyRecipe(factory, plan) {
+    const adapter = adapterForTransport(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 ?? 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 LoggingConfigurationError(`There should only be one configuration per environment for logging`);
     }
-    const transport = transports.at(0)?.transports;
-    const adapter = new 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/LnRyYW5zcG9ydHM7XG5cdGNvbnN0IGFkYXB0ZXIgPSBuZXcgUGlub0FkYXB0ZXIoeyB0cmFuc3BvcnQgfSk7XG5cdHJldHVybiBmYWN0b3J5LmNvbmZpZ3VyZSh7XG5cdFx0b3B0aW9ucyxcblx0XHRhZGFwdGVyLFxuXHR9KTtcbn1cbiJdLCJuYW1lcyI6WyJleHRlbnNpb24iLCJEZWZhdWx0RW52aXJvbm1lbnQiLCJMb2dnaW5nQ29uZmlndXJhdGlvbkVycm9yIiwic2NyaWJlIiwiUGlub0FkYXB0ZXIiLCJQaW5vRXh0ZW5zaW9ucyIsIndpdGhQaW5vIiwiZmFjdG9yeSIsImNvbmZpZyIsImxvZ0xldmVsIiwiY29uZmlndXJlU2NyaWJlIiwid2l0aFBpbm9QcmV0dHkiLCJ0cmFuc3BvcnRzIiwidGFyZ2V0Iiwib3B0aW9ucyIsImNvbG9yaXplIiwid2l0aFBpbm9DdXN0b20iLCJlbnZpcm9ubWVudCIsInByb2Nlc3MiLCJlbnYiLCJOT0RFX0VOViIsImNvbmZpZ3MiLCJBcnJheSIsImlzQXJyYXkiLCJmaWx0ZXIiLCJsZW5ndGgiLCJ0cmFuc3BvcnQiLCJhdCIsImFkYXB0ZXIiLCJjb25maWd1cmUiXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLFNBQVNBLFNBQVMsUUFBUSxnQ0FBZ0M7QUFDMUQsU0FBU0Msa0JBQWtCLFFBQTBCLHlCQUF5QjtBQUM5RSxTQUdDQyx5QkFBeUIsRUFFekJDLE1BQU0sUUFDQSxtQkFBbUI7QUFPMUIsU0FBU0MsV0FBVyxRQUFRLHFCQUFxQjtBQXlCakQsT0FBTyxNQUFNQztJQUNaLE9BQ2NDLFNBQ2JDLE9BQWUsRUFDZkMsTUFBMkMsRUFDM0NDLFFBQWlDLEVBQ2hDO1FBQ0QsT0FBT0MsZ0JBQWdCSCxTQUFTO1lBQUVFO1FBQVMsR0FBR0Q7SUFDL0M7SUFFQSxPQUNjRyxlQUFlSixPQUFlLEVBQUVFLFFBQWlDLEVBQUU7UUFDaEYsT0FBT0osZUFBZUMsUUFBUSxDQUM3QkMsU0FDQTtZQUFFSyxZQUFZO2dCQUFFQyxRQUFRO2dCQUFlQyxTQUFTO29CQUFFQyxVQUFVO2dCQUFLO1lBQUU7UUFBRSxHQUNyRU47SUFFRjtJQUVBLE9BQ2NPLGVBQ2JULE9BQWUsRUFDZk8sT0FBMkMsRUFDMUM7UUFDRCxNQUFNLEVBQUVYLE1BQU0sRUFBRVMsVUFBVSxFQUFFLEdBQUdFO1FBQy9CLE9BQU9KLGdCQUFnQkgsU0FBU0osUUFBUVM7SUFDekM7QUFDRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFQSxTQUFTRixnQkFDUkgsT0FBZSxFQUNmTyxPQUFxQyxFQUNyQ04sTUFBMkM7SUFFM0MsTUFBTVMsY0FBY0MsUUFBUUMsR0FBRyxDQUFDQyxRQUFRLElBQUluQjtJQUM1QyxNQUFNb0IsVUFBVUMsTUFBTUMsT0FBTyxDQUFDZixVQUFVQSxTQUFTO1FBQUNBO0tBQU87SUFDekQsTUFBTUksYUFBYVMsUUFBUUcsTUFBTSxDQUNoQyxDQUFDaEIsU0FBVyxBQUFDQSxPQUFPUyxXQUFXLElBQUlULE9BQU9TLFdBQVcsS0FBS0EsZUFBZ0I7SUFHM0UsSUFBSUwsV0FBV2EsTUFBTSxHQUFHLEdBQUc7UUFDMUIsTUFBTSxJQUFJdkIsMEJBQ1QsQ0FBQyxrRUFBa0UsQ0FBQztJQUV0RTtJQUVBLE1BQU13QixZQUFZZCxXQUFXZSxFQUFFLENBQUMsSUFBSWY7SUFDcEMsTUFBTWdCLFVBQVUsSUFBSXhCLFlBQVk7UUFBRXNCO0lBQVU7SUFDNUMsT0FBT25CLFFBQVFzQixTQUFTLENBQUM7UUFDeEJmO1FBQ0FjO0lBQ0Q7QUFDRCJ9
+/** @deprecated Use {@link guardTransport} — kept for callers/tests from the silence-only era. */ function silenceErrors(transport) {
+    return guardTransport(transport);
+}
+export const pinoTransport = {
+    createSafeTransport,
+    guardTransport,
+    silenceErrors
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/scribe-pino",
-  "version": "0.0.1-dev.10",
+  "version": "0.0.1-dev.100",
   "description": "Pino adapter for @decohere/scribe",
   "keywords": [
     "typescript",
@@ -23,9 +23,21 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/nexus": "0.0.1-dev.10",
-    "@decohere/scribe": "0.0.1-dev.10",
+    "@decohere/nexus": "0.0.1-dev.100",
+    "@decohere/scribe": "0.0.1-dev.100",
     "pino": "^10.3.0"
   },
-  "devDependencies": {}
+  "devDependencies": {},
+  "peerDependencies": {
+    "pino-pretty": "^13.0.0",
+    "pino-roll": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "pino-pretty": {
+      "optional": true
+    },
+    "pino-roll": {
+      "optional": true
+    }
+  }
 }

package/types/src/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./pino.adapater.js";
+export * from "./pino.recipe.js";
 export * from "./scribe-pino.js";

package/types/src/pino.adapater.d.ts

@@ -8,8 +8,16 @@ export declare class PinoAdapter extends LogAdapter {
     private _pino;
     private readonly options;
     private readonly stream;
+    private disposed;
+    private retired;
     constructor(options: pino.LoggerOptions, stream?: pino.DestinationStream);
     configure<T extends string = never, CustomOnly extends true | false = false>(scribeOptions: ScribeOptions<T, CustomOnly>): void;
     getLogger<T extends string = never, CustomOnly extends true | false = false>(name: string): Logger<T, CustomOnly>;
     flush(cb?: () => void): void;
+    /**
+     * Immediately stop accepting writes into the destination (ThreadStream).
+     * Does not wait for flush — use `stop()` for async drain after retire.
+     */
+    retire(): void;
+    [Symbol.asyncDispose](): Promise<void>;
 }

package/types/src/pino.recipe.d.ts

@@ -0,0 +1,45 @@
+import { type Environment } from "@decohere/nexus/system";
+import type { TransportMultiOptions, TransportSingleOptions } from "pino";
+/** Pretty and roll are local-dev conveniences. Production ships JSON on stdout. */
+export type PinoWhen = "development" | "always";
+export type PinoPrettyRecipeOptions = {
+    colorize?: boolean;
+    logLevel?: string;
+    when?: PinoWhen;
+};
+export type PinoRollRecipeOptions = {
+    /** Default roll path. Overridden at runtime by `SCRIBE_LOG_FILE` when set. */
+    file: string;
+    size?: string;
+    frequency?: string | number;
+    keep?: number;
+    mkdir?: boolean;
+    symlink?: boolean;
+    logLevel?: string;
+    when?: PinoWhen;
+};
+export type PinoRecipePlan = {
+    pretty?: PinoPrettyRecipeOptions;
+    roll?: PinoRollRecipeOptions;
+    logLevel?: string;
+};
+declare function currentEnvironment(): Environment;
+/**
+ * Resolve roll options. `SCRIBE_LOG_FILE` overrides `file` so ops can redirect
+ * without touching app code. Size / frequency / keep: explicit > env > default.
+ */
+declare function resolveRoll(options: PinoRollRecipeOptions): {
+    file: string;
+    size: string;
+    frequency: string | number;
+    keep: number;
+    mkdir: boolean;
+    symlink: boolean;
+};
+declare function transport(plan: PinoRecipePlan, environment?: Environment): TransportSingleOptions | TransportMultiOptions | undefined;
+export declare const pinoRecipe: {
+    transport: typeof transport;
+    currentEnvironment: typeof currentEnvironment;
+    resolveRoll: typeof resolveRoll;
+};
+export {};

package/types/src/pino.transport-guard.d.ts

@@ -0,0 +1,10 @@
+import type { DestinationStream } from "pino";
+export type GuardedTransport = DestinationStream & {
+    readonly retired: boolean;
+    retire(reason?: string): void;
+};
+/**
+ * Wrap a pino worker transport so a dead ThreadStream cannot spam or crash.
+ * On first error / write throw: report once, destroy, no-op further writes.
+ */
+export declare function guardTransport(transport: DestinationStream): GuardedTransport;

package/types/src/scribe-pino.d.ts

@@ -1,24 +1,72 @@
 import { type Environment } from "@decohere/nexus/system";
 import { type DefaultLevels, type Logger, type ScribeOptions, scribe } from "@decohere/scribe";
-import type { TransportMultiOptions, TransportPipelineOptions, TransportSingleOptions } from "pino";
+import { type DestinationStream, type TransportMultiOptions, type TransportPipelineOptions, type TransportSingleOptions } from "pino";
+import { type PinoPrettyRecipeOptions, type PinoRollRecipeOptions } from "./pino.recipe.js";
+import { type GuardedTransport, guardTransport } from "./pino.transport-guard.js";
+export type { GuardedTransport } from "./pino.transport-guard.js";
+export { guardTransport } from "./pino.transport-guard.js";
+type TransportOptions = TransportSingleOptions | TransportMultiOptions | TransportPipelineOptions;
 type TransportConfig = {
     environment?: Environment;
-    transports: TransportSingleOptions | TransportMultiOptions | TransportPipelineOptions;
+    transports: TransportOptions;
 };
 type CustomLevelOptions<T extends string = never, CustomOnly extends true = undefined> = {
     scribe?: ScribeOptions<T, CustomOnly>;
     transports?: TransportConfig | TransportConfig[];
 };
+export type PinoLoggerFactory = (name?: string) => Logger;
+export type PinoRecipeChain = {
+    withPinoPretty(logLevelOrOptions?: DefaultLevels | string | PinoPrettyRecipeOptions): PinoRecipe;
+    withPinoRoll(options: PinoRollRecipeOptions): PinoRecipe;
+};
+export type PinoRecipe = PinoLoggerFactory & PinoRecipeChain & {
+    readonly and: PinoRecipeChain;
+};
 declare module "@decohere/scribe" {
     interface scribe {
-        withPino(transports: TransportConfig | TransportConfig[], loglevel?: DefaultLevels | string): (name?: string) => Logger;
-        withPinoPretty(logLevel?: DefaultLevels | string): (name?: string) => Logger;
-        withPinoCustom<T extends string = never, CustomOnly extends true = undefined>(options?: CustomLevelOptions<T, CustomOnly>): (name?: string) => Logger<T, CustomOnly>;
+        withPino(transports: TransportConfig | TransportConfig[], loglevel?: DefaultLevels | string): PinoLoggerFactory;
+        /**
+         * Colorized pretty transport. Development only unless `{ when: "always" }`.
+         * Chain with `.and.withPinoRoll({ file })`. Production writes JSON to stdout
+         * so log shipping stays outside the process.
+         */
+        withPinoPretty(logLevelOrOptions?: DefaultLevels | string | PinoPrettyRecipeOptions): PinoRecipe;
+        /**
+         * Rolling log files. Development only unless `{ when: "always" }`.
+         * Do not enable in production — ship stdout from a sidecar or platform agent.
+         * `symlink` defaults off; enabling it can race under multi-worker / HMR.
+         * Ops may override path/size/frequency/keep via `SCRIBE_LOG_FILE`,
+         * `SCRIBE_LOG_SIZE`, `SCRIBE_LOG_FREQUENCY`, and `SCRIBE_LOG_KEEP`
+         * (file env wins over `options.file`; other explicit options beat env).
+         */
+        withPinoRoll(options: PinoRollRecipeOptions): PinoRecipe;
+        withPinoCustom<T extends string = never, CustomOnly extends true = undefined>(options?: CustomLevelOptions<T, CustomOnly>): PinoLoggerFactory;
+    }
+    namespace scribe {
+        function withPino(transports: TransportConfig | TransportConfig[], loglevel?: DefaultLevels | string): PinoLoggerFactory;
+        function withPinoPretty(logLevelOrOptions?: DefaultLevels | string | PinoPrettyRecipeOptions): PinoRecipe;
+        function withPinoRoll(options: PinoRollRecipeOptions): PinoRecipe;
+        function withPinoCustom<T extends string = never, CustomOnly extends true = undefined>(options?: CustomLevelOptions<T, CustomOnly>): PinoLoggerFactory;
     }
 }
 export declare class PinoExtensions {
     static withPino(factory: scribe, config: TransportConfig | TransportConfig[], logLevel?: DefaultLevels | string): (name?: string) => Logger<never, false>;
-    static withPinoPretty(factory: scribe, logLevel?: DefaultLevels | string): (name?: string) => Logger<never, false>;
+    static withPinoPretty(factory: scribe, logLevelOrOptions?: DefaultLevels | string | PinoPrettyRecipeOptions): PinoRecipe;
+    static withPinoRoll(factory: scribe, options: PinoRollRecipeOptions): PinoRecipe;
     static withPinoCustom<T extends string = never, CustomOnly extends true = undefined>(factory: scribe, options?: CustomLevelOptions<T, CustomOnly>): (name?: string) => Logger<T, CustomOnly>;
 }
-export {};
+/**
+ * Guard a worker transport so failures (roll EEXIST, worker exit) neither
+ * crash the process nor spam stderr on every subsequent log write.
+ */
+declare function createSafeTransport(options: TransportOptions): DestinationStream;
+/** @deprecated Use {@link guardTransport} — kept for callers/tests from the silence-only era. */
+declare function silenceErrors(transport: {
+    on(event: "error", listener: (err: Error) => void): unknown;
+    write?: (...args: never[]) => unknown;
+}): GuardedTransport;
+export declare const pinoTransport: {
+    createSafeTransport: typeof createSafeTransport;
+    guardTransport: typeof guardTransport;
+    silenceErrors: typeof silenceErrors;
+};