@cto.af/log 1.0.1 → 1.1.0

package/lib/index.d.ts

@@ -1,10 +1,10 @@
-import { pino } from 'pino';
+import pino from 'pino';
 
-interface LogOptions extends pino.LoggerOptions<never, false> {
+interface CtoLogOptions {
     /**
      * Increase (or decrease if negative) log verbosity by this much.
      * -3: fatal, -2: error, -1: warn, 0: info, 1: debug, 2: trace.
-     * Useful for -qqqvvvv option processing.
+     * Useful for -qqqvvvv option processing.  Default: 0.
      */
     logLevel?: number;
     /** If a string, create this log file and write to it. */
@@ -18,7 +18,15 @@ interface LogOptions extends pino.LoggerOptions<never, false> {
      * to stdout.  Default: 'pid,hostname,name,host,port'.
      */
     prettyIgnore?: string;
+    /**
+     * Log instance, created by the first layer to call createLog.  Alternative
+     * to getLog for times when multiple loggers are needed.
+     */
+    log?: Logger | null;
 }
+declare const DEFAULT_LOG_OPTIONS: Required<CtoLogOptions>;
+declare const LOG_OPTIONS_NAMES: Set<keyof CtoLogOptions | Set<keyof pino.LoggerOptions<never, false>>>;
+type LogOptions = CtoLogOptions & pino.LoggerOptions<never, false>;
 type Logger = pino.Logger;
 /**
  * Create a new log instance.  Mostly useful for testing.
@@ -30,12 +38,13 @@ type Logger = pino.Logger;
 declare function createLog(opts?: LogOptions, bindings?: pino.Bindings): Logger;
 /**
  * Get a singleton logging object.  Opts and bindings are used the first time,
- * and ignored thereafter.
+ * and ignored thereafter.  Ideally the highest-level layer will call this
+ * first before any lower layer.
  *
  * @param opts Logging options.
  * @param bindings Extra fields to put into every log item.
  * @returns Singleton logging object.
  */
-declare function getLog(opts: LogOptions, bindings?: pino.Bindings): Logger;
+declare function getLog(opts?: LogOptions, bindings?: pino.Bindings): Logger;
 
-export { type LogOptions, type Logger, createLog, getLog };
+export { type CtoLogOptions, DEFAULT_LOG_OPTIONS, LOG_OPTIONS_NAMES, type LogOptions, type Logger, createLog, getLog };

package/lib/index.js

@@ -1 +1 @@
-import{Writable as m}from"stream";import{pino as o}from"pino";import u from"pino-pretty";var p=class extends m{_write(r,s,i){i(null)}};function c(l={},r){let{logLevel:s,logFile:i,mute:d=!1,sync:a=!1,prettyIgnore:f="pid,hostname,name,host,port",...n}=l;if(s!==void 0){let e=Math.round(3-s);e<1?e=1:e>6&&(e=6),n.level=o.levels.labels[e*10]}let t;if(d&&!i)t=o(n,new p);else if(i){let e=o.destination({dest:i,sync:a,append:!0,mkdir:!0});d?t=o(n,e):t=o(n,o.multistream([{level:n.level,stream:e},{level:n.level,stream:u({ignore:f})}]))}else t=o(n,u({ignore:f}));return r&&t.setBindings(r),t}var g;function b(l,r={}){return g||(g=c(l,r)),g}export{c as createLog,b as getLog};
+import{assertDisjoint as f,nameSet as d,select as L}from"@cto.af/utils";import{Writable as c}from"stream";import r from"pino";import p from"pino-pretty";var a={log:null,logFile:null,logLevel:0,mute:!1,prettyIgnore:"pid,hostname,name,host,port",sync:!1},m=d(a),u=new Set(["base","browser","crlf","customLevels","depthLimit","edgeLimit","enabled","errorKey","formatters","hooks","level","levelComparison","levelVal","messageKey","mixin","mixinMergeStrategy","msgPrefix","name","nestedKey","onChild","redact","safe","serializers","timestamp","transport","useOnlyCustomLevels"]);f(m,u);var S=new Set([...m,u]),g=class extends c{_write(i,e,o){o(null)}};function O(n={},i){let[e,o]=L(n,a);if(e.log)return e.log;if(e.logLevel!==void 0){let t=Math.round(3-e.logLevel);t<1?t=1:t>6&&(t=6),o.level=r.levels.labels[t*10]}let l;if(e.mute&&!e.logFile)l=r(o,new g);else if(e.logFile){let t=r.destination({dest:e.logFile,sync:e.sync,append:!0,mkdir:!0});e.mute?l=r(o,t):l=r(o,r.multistream([{level:o.level,stream:t},{level:o.level,stream:p({ignore:e.prettyIgnore})}]))}else l=r(o,p({ignore:e.prettyIgnore}));return i&&l.setBindings(i),n.log=l,l}var s;function I(n,i={}){return n?.log?n.log:(s||(s=O(n,i)),s)}export{a as DEFAULT_LOG_OPTIONS,S as LOG_OPTIONS_NAMES,O as createLog,I as getLog};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cto.af/log",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "decription": "",
   "main": "lib/index.js",
   "files": [
@@ -19,10 +19,11 @@
     "url": "https://github.com/cto-af/log/issues"
   },
   "dependencies": {
-    "pino": "9.7.0",
-    "pino-pretty": "13.0.0"
+    "@cto.af/utils": "1.3.1",
+    "pino": "9.9.0",
+    "pino-pretty": "13.1.1"
   },
-  "packageManager": "pnpm@10.12.1",
+  "packageManager": "pnpm@10.15.0",
   "engines": {
     "node": ">=20"
   }