@thi.ng/rstream-log 5.0.6 → 5.1.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-25T14:07:53Z
+- **Last updated**: 2024-03-01T15:22:50Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,14 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [5.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream-log@5.1.0) (2024-02-28)
+
+#### 🚀 Features
+
+- update formatString() ([1ad60cc](https://github.com/thi-ng/umbrella/commit/1ad60cc))
+  - add support for msg post-processing in formatString()
+  - add/update docstrings
+
 ### [5.0.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream-log@5.0.1) (2024-02-16)
 
 #### 🩹 Bug fixes

package/README.md

@@ -1,16 +1,5 @@
 <!-- This file is generated - DO NOT EDIT! -->
 <!-- Please see: https://github.com/thi-ng/umbrella/blob/develop/CONTRIBUTING.md#changes-to-readme-files -->
-> [!IMPORTANT]
-> ‼️ Announcing the thi.ng user survey 2024 📋
->
-> [Please participate in the survey here!](https://forms.gle/XacbSDEmQMPZg8197)\
-> (open until end of February)
->
-> **To achieve a better sample size, I'd highly appreciate if you could
-> circulate the link to this survey in your own networks.**
->
-> [Discussion](https://github.com/thi-ng/umbrella/discussions/447)
-
 # ![@thi.ng/rstream-log](https://media.thi.ng/umbrella/banners-20230807/thing-rstream-log.svg?8a1c5872)
 
 [![npm version](https://img.shields.io/npm/v/@thi.ng/rstream-log.svg)](https://www.npmjs.com/package/@thi.ng/rstream-log)
@@ -22,7 +11,7 @@
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
-> 🚀 Help me to work full-time on these projects by [sponsoring me on
+> 🚀 Please help me to work full-time on these projects by [sponsoring me on
 > GitHub](https://github.com/sponsors/postspectacular). Thank you! ❤️
 
 - [About](#about)
@@ -83,7 +72,7 @@ For Node.js REPL:
 const rstreamLog = await import("@thi.ng/rstream-log");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 750 bytes
+Package sizes (brotli'd, pre-treeshake): ESM: 768 bytes
 
 ## Dependencies
 

package/format.d.ts

@@ -2,7 +2,21 @@ import { type LogEntry } from "@thi.ng/logger/api";
 import type { Transducer } from "@thi.ng/transducers";
 import type { BodyFormat, DateFormat, LogEntryObj } from "./api.js";
 export declare const isoDate: (dt: number) => string;
-export declare const formatString: (dtFmt?: DateFormat, bodyFmt?: BodyFormat) => Transducer<LogEntry, string>;
+/**
+ * Log entry formatter/transducer. Formats a {@link LogEntry} tuple as string
+ * using optionally provided formatters.
+ *
+ * @remarks
+ * If `wrap` is given, it will be called with both the already formatted message
+ * string and the original log entry. The function can be used to post-process
+ * the message (e.g. to wrap it in ANSI color escape sequences, based on logger
+ * ID and/or level, also see [thi.ng/text-format](https://thi.ng/text-format))
+ *
+ * @param dateFmt
+ * @param bodyFmt
+ * @param wrap
+ */
+export declare const formatString: (dateFmt?: DateFormat, bodyFmt?: BodyFormat, wrap?: ((msg: string, entry: LogEntry) => string) | undefined) => Transducer<LogEntry, string>;
 /**
  * Takes an array of regex patterns and optional `mask` string. Returns
  * transducer which replaces all found pattern occurrences with `mask`.
@@ -31,6 +45,17 @@ export declare const formatString: (dtFmt?: DateFormat, bodyFmt?: BodyFormat) =>
  * @param mask -
  */
 export declare const maskSecrets: (patterns: RegExp[], mask?: string) => Transducer<string, string>;
+/**
+ * Log entry transducer which converts a {@link LogEntry} tuple to a
+ * {@link LogEntryObj}.
+ */
 export declare const formatObject: () => Transducer<LogEntry, LogEntryObj>;
-export declare const formatJSON: (dtfmt?: DateFormat) => Transducer<LogEntry, string>;
+/**
+ * Log entry formatter/transducer. Format a {@link LogEntry} tuple into a
+ * serialized JSON string (object keys: `id`, `level`, `time`, `body`), with the
+ * entry's timestamp formatted using given `dateFmt` (default: {@link isoDate}).
+ *
+ * @param dateFmt
+ */
+export declare const formatJSON: (dateFmt?: DateFormat) => Transducer<LogEntry, string>;
 //# sourceMappingURL=format.d.ts.map

package/format.js

@@ -2,24 +2,27 @@ import { LogLevel } from "@thi.ng/logger/api";
 import { stringify } from "@thi.ng/strings/stringify";
 import { map } from "@thi.ng/transducers/map";
 const isoDate = (dt) => new Date(dt).toISOString();
-const formatString = (dtFmt, bodyFmt) => {
-  dtFmt = dtFmt || isoDate;
+const formatString = (dateFmt, bodyFmt, wrap) => {
+  dateFmt = dateFmt || isoDate;
   bodyFmt = bodyFmt || ((x) => x.map(stringify()).join(" "));
-  return map(
-    ([level, id, time, ...body]) => `[${LogLevel[level]}] ${id}: ${dtFmt(time)} ${bodyFmt(body)}`
-  );
+  return map((entry) => {
+    const [level, id, time, ...body] = entry;
+    const date = dateFmt(time);
+    const res = `[${LogLevel[level]}] ${id}: ${date ? date + " " : ""}${bodyFmt(body)}`;
+    return wrap ? wrap(res, entry) : res;
+  });
 };
 const maskSecrets = (patterns, mask = "****") => map(
   (msg) => patterns.reduce((acc, pat) => acc.replace(pat, mask), msg)
 );
 const formatObject = () => map(([level, id, time, ...body]) => ({ level, id, time, body }));
-const formatJSON = (dtfmt) => {
-  dtfmt = dtfmt || isoDate;
+const formatJSON = (dateFmt) => {
+  dateFmt = dateFmt || isoDate;
   return map(
     ([level, id, time, ...body]) => JSON.stringify({
       id,
       level: LogLevel[level],
-      time: dtfmt(time),
+      time: dateFmt(time),
       body
     })
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/rstream-log",
-  "version": "5.0.6",
+  "version": "5.1.1",
   "description": "Structured, multilevel & hierarchical loggers based on @thi.ng/rstream",
   "type": "module",
   "module": "./index.js",
@@ -35,12 +35,12 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.26",
-    "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/logger": "^3.0.3",
-    "@thi.ng/rstream": "^8.3.8",
-    "@thi.ng/strings": "^3.7.17",
-    "@thi.ng/transducers": "^8.9.7"
+    "@thi.ng/api": "^8.9.27",
+    "@thi.ng/checks": "^3.5.1",
+    "@thi.ng/logger": "^3.0.4",
+    "@thi.ng/rstream": "^8.3.9",
+    "@thi.ng/strings": "^3.7.19",
+    "@thi.ng/transducers": "^8.9.8"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -97,5 +97,5 @@
     ],
     "year": 2017
   },
-  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
+  "gitHead": "d660ae8fd1bf64d919b4334f19509f1f539d70f6\n"
 }