@decohere/scribe-pino 0.0.1-dev.12 → 0.0.1-dev.120

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 = {
@@ -59,15 +179,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/OiAoKSA9PiB2b2lkKTogdm9pZCB7XG5cdFx0dGhpcy5fcGluby5mbHVzaChjYik7XG5cdH1cbn1cblxuZnVuY3Rpb24gbG9nTWV0aG9kKHRoaXM6IHBpbm8uTG9nZ2VyLCBhcmdzOiBQYXJhbWV0ZXJzPExvZ0ZuPiwgbWV0aG9kOiBMb2dGbikge1xuXHRsZXQgbWVzc2FnZSA9IGFyZ3MuYXQoMCk7XG5cdGNvbnN0IGRhdGEgPSBhcmdzLmF0KDEpO1xuXG5cdGlmIChkYXRhIGluc3RhbmNlb2YgRXJyb3IpIHtcblx0XHRtZXNzYWdlID0geyBtc2c6IG1lc3NhZ2UsIC4uLnsgZXJyb3I6IGRhdGEgfSB9O1xuXHR9IGVsc2UgaWYgKHR5cGVvZiBkYXRhID09PSBcIm9iamVjdFwiKSB7XG5cdFx0bWVzc2FnZSA9IHsgbXNnOiBtZXNzYWdlLCAuLi5kYXRhIH07XG5cdH0gZWxzZSB7XG5cdFx0bWVzc2FnZSA9IHsgbXNnOiBtZXNzYWdlLCBkYXRhIH07XG5cdH1cblxuXHRtZXRob2QuY2FsbCh0aGlzLCBtZXNzYWdlKTtcbn1cblxuZnVuY3Rpb24gcGlub01peDxUIGV4dGVuZHMgc3RyaW5nID0gbmV2ZXIsIEN1c3RvbU9ubHkgZXh0ZW5kcyB0cnVlIHwgZmFsc2UgPSBmYWxzZT4oXG5cdGxvZ2dlcjogcGluby5Mb2dnZXIsXG4pOiBMb2dnZXI8VCwgQ3VzdG9tT25seT4ge1xuXHRyZXR1cm4gT2JqZWN0LmFzc2lnbjxwaW5vLkxvZ2dlciwgQmFzZUxvZ2dlcj4obG9nZ2VyLCB7XG5cdFx0Z2V0IGN1cnJlbnRMZXZlbCgpIHtcblx0XHRcdHJldHVybiBsb2dnZXIubGV2ZWw7XG5cdFx0fSxcblx0XHRnZXQgbG9nTGV2ZWxzKCkge1xuXHRcdFx0cmV0dXJuIGxvZ2dlci5sZXZlbHMudmFsdWVzO1xuXHRcdH0sXG5cdH0pIGFzIExvZ2dlcjxULCBDdXN0b21Pbmx5Pjtcbn1cbiJdLCJuYW1lcyI6WyJMb2dBZGFwdGVyIiwicGlubyIsIlBpbm9BZGFwdGVyIiwiX3Bpbm8iLCJvcHRpb25zIiwic3RyZWFtIiwiY29uZmlndXJlIiwic2NyaWJlT3B0aW9ucyIsImxvZ0xldmVsIiwicmVkYWN0aW9ucyIsImN1c3RvbUxldmVscyIsImdldExvZ0xldmVscyIsInBpbm9PcHRpb25zIiwibGV2ZWwiLCJob29rcyIsImxvZ01ldGhvZCIsInNlcmlhbGl6ZXJzIiwiZXJyb3IiLCJzdGRTZXJpYWxpemVycyIsImVyciIsInJlZGFjdCIsImdldExvZ2dlciIsIm5hbWUiLCJsb2dnZXIiLCJwaW5vTWl4IiwiY2hpbGQiLCJmbHVzaCIsImNiIiwiYXJncyIsIm1ldGhvZCIsIm1lc3NhZ2UiLCJhdCIsImRhdGEiLCJFcnJvciIsIm1zZyIsImNhbGwiLCJPYmplY3QiLCJhc3NpZ24iLCJjdXJyZW50TGV2ZWwiLCJsb2dMZXZlbHMiLCJsZXZlbHMiLCJ2YWx1ZXMiXSwibWFwcGluZ3MiOiJBQUFBLFNBRUNBLFVBQVUsUUFHSixtQkFBbUI7QUFDMUIsT0FBT0MsVUFBMEIsT0FBTztBQU94QyxPQUFPLE1BQU1DLG9CQUFvQkY7SUFDeEJHLE1BQW1CO0lBQ1ZDLFFBQTRCO0lBQzVCQyxPQUErQjtJQUNoRCxZQUFtQkQsT0FBMkIsRUFBRUMsTUFBK0IsQ0FBRTtRQUNoRixLQUFLO1FBQ0wsSUFBSSxDQUFDRCxPQUFPLEdBQUdBO1FBQ2YsSUFBSSxDQUFDQyxNQUFNLEdBQUdBO0lBQ2Y7SUFFT0MsVUFDTkMsYUFBMkMsRUFDMUM7UUFDRCxNQUFNLEVBQUVDLFFBQVEsRUFBRUMsVUFBVSxFQUFFLEdBQUdGO1FBQ2pDLE1BQU1HLGVBQWUsSUFBSSxDQUFDQyxZQUFZLENBQUNKO1FBRXZDLE1BQU1LLGNBQWtDO1lBQ3ZDRjtZQUNBRyxPQUFPTDtZQUNQTSxPQUFPO2dCQUFFQztZQUFVO1lBQ25CQyxhQUFhO2dCQUNaQyxPQUFPaEIsS0FBS2lCLGNBQWMsQ0FBQ0MsR0FBRztZQUMvQjtZQUNBQyxRQUFRWDtZQUNSLEdBQUcsSUFBSSxDQUFDTCxPQUFPO1FBQ2hCO1FBQ0EsSUFBSSxDQUFDRCxLQUFLLEdBQUdGLEtBQUtXLGFBQWEsSUFBSSxDQUFDUCxNQUFNO0lBQzNDO0lBRU9nQixVQUNOQyxJQUFZLEVBQ1k7UUFDeEIsTUFBTUMsU0FBU0MsUUFBdUIsSUFBSSxDQUFDckIsS0FBSyxDQUFDc0IsS0FBSyxDQUFDO1lBQUVIO1FBQUs7UUFDOUQsT0FBT0M7SUFDUjtJQUVPRyxNQUFNQyxFQUFlLEVBQVE7UUFDbkMsSUFBSSxDQUFDeEIsS0FBSyxDQUFDdUIsS0FBSyxDQUFDQztJQUNsQjtBQUNEO0FBRUEsU0FBU1osVUFBNkJhLElBQXVCLEVBQUVDLE1BQWE7SUFDM0UsSUFBSUMsVUFBVUYsS0FBS0csRUFBRSxDQUFDO0lBQ3RCLE1BQU1DLE9BQU9KLEtBQUtHLEVBQUUsQ0FBQztJQUVyQixJQUFJQyxnQkFBZ0JDLE9BQU87UUFDMUJILFVBQVU7WUFBRUksS0FBS0o7WUFBUyxHQUFHO2dCQUFFYixPQUFPZTtZQUFLLENBQUM7UUFBQztJQUM5QyxPQUFPLElBQUksT0FBT0EsU0FBUyxVQUFVO1FBQ3BDRixVQUFVO1lBQUVJLEtBQUtKO1lBQVMsR0FBR0UsSUFBSTtRQUFDO0lBQ25DLE9BQU87UUFDTkYsVUFBVTtZQUFFSSxLQUFLSjtZQUFTRTtRQUFLO0lBQ2hDO0lBRUFILE9BQU9NLElBQUksQ0FBQyxJQUFJLEVBQUVMO0FBQ25CO0FBRUEsU0FBU04sUUFDUkQsTUFBbUI7SUFFbkIsT0FBT2EsT0FBT0MsTUFBTSxDQUEwQmQsUUFBUTtRQUNyRCxJQUFJZSxnQkFBZTtZQUNsQixPQUFPZixPQUFPVixLQUFLO1FBQ3BCO1FBQ0EsSUFBSTBCLGFBQVk7WUFDZixPQUFPaEIsT0FBT2lCLE1BQU0sQ0FBQ0MsTUFBTTtRQUM1QjtJQUNEO0FBQ0QifQ==

package/es6/src/pino.recipe.js

@@ -0,0 +1,96 @@
+import { Environments } from "@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 === 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

@@ -7,33 +7,42 @@ function _ts_decorate(decorators, target, key, desc) {
 function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-import { extension } from "@decohere/nexus/extensibility";
-import { DefaultEnvironment } from "@decohere/nexus/system";
+import { extension } from "@decohere/core/extensibility";
+import { DefaultEnvironment } from "@decohere/core/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.12",
+  "version": "0.0.1-dev.120",
   "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.12",
-    "@decohere/scribe": "0.0.1-dev.12",
+    "@decohere/core": "0.0.1-dev.120",
+    "@decohere/scribe": "0.0.1-dev.120",
     "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/core/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;