pino-nice 0.0.1 → 0.0.2

package/README.md

@@ -16,9 +16,10 @@ Structured JSON logs are great for machines and terrible for human eyes. `pino-p
 
 - 🧾 **Sectioned details + headline.** Each record renders its structured fields as an indented, YAML-like block, connected with box-drawing lines (`│` / `└─`) down to a single headline `LEVEL  timestamp  message`.
 - 🎨 **Color-coded levels.** `trace`/`debug`/`info`/`warn`/`error`/`fatal` each get a distinct color, applied to the connectors too, so severity pops at a glance.
-- 🧨 **First-class errors.** Stack traces are cleaned up, internal `node_modules`/`node:` frames are dimmed, and nested `cause` chains and `AggregateError`s are rendered with their structure intact.
+- 🧨 **First-class errors.** Serialized errors are detected by shape under _any_ key (`err`, `error`, or nested), stack traces are cleaned up, internal `node_modules`/`node:` frames are dimmed, and nested `cause` chains and `AggregateError`s are rendered with their structure intact.
 - 🔌 **Works with more than pino.** Recognizes pino defaults plus common aliases like `severity` / `message` / `timestamp`, so logs from other services format nicely too.
-- 🕒 **Readable timestamps.** Local time by default (or `--utc`), with a missing timestamp filled in from the current time.
+- 🕒 **Theme-friendly timestamps.** The clock (`HH:MM:SS`) is bold while the date and milliseconds are dimmed, so it stays readable on both dark and light terminals. Local time by default (or `--utc`, which appends a `Z`), with a missing timestamp filled in from the current time.
+- 🪢 **Verbatim passthrough.** Lines that aren't recognized as logs (plain text, malformed JSON, or JSON without a level) are printed through untouched, so interleaved non-log output isn't swallowed.
 - 🔗 **URL-safe wrapping.** Lines flow to your terminal's width with no manual mid-token breaks, so long URLs stay clickable.
 - 🚀 **Bun & Node, zero runtime deps.** Ships as a tiny dependency-free CLI.
 
@@ -88,12 +89,22 @@ If you pass several level flags, the **last one wins** (e.g. `--error --info` sh
 
 pino-nice resolves fields from common conventions:
 
-- **Level:** `level` (numeric `10`–`60`) or `severity` (`"INFO"`, `"DEBUG"`, ...)
-- **Message:** `msg` or `message`
+- **Level:** `level` (numeric `10`–`60`) or `severity` (`"INFO"`, `"DEBUG"`, ...) — the only required field
+- **Message:** `msg` or `message` — optional (e.g. `log.info({ obj })` renders fine without one)
 - **Timestamp:** `time` or `timestamp` (epoch ms or ISO string); if absent, the current time is used
 
 All six pino levels are supported: `trace` (10), `debug` (20), `info` (30), `warn` (40), `error` (50), `fatal` (60).
 
+### Non-log lines
+
+Any line that can't be recognized as a log is passed through **verbatim**:
+
+- not valid JSON (plain text, banners, malformed JSON)
+- valid JSON that isn't an object (e.g. a bare array or string)
+- a JSON object with no `level` field
+
+This keeps `pino-nice` transparent for mixed streams. Recognized logs that fall below the active level filter (e.g. `--warn`) are still dropped — filtering is intentional, passthrough is for genuinely unrecognized lines. Blank lines are ignored.
+
 ## 📄 License
 
 [MIT](LICENSE) © Tim Zadorozhny

package/dist/pino-nice.d.ts

@@ -10,6 +10,7 @@ declare class PinoNice {
     private readonly minLevel;
     constructor(options?: PinoNiceOptions);
     private handleLine;
+    private write;
     pipe(): Promise<void>;
 }
 

package/dist/pino-nice.js

@@ -276,11 +276,18 @@ var PinoNice = class {
     try {
       entry = JSON.parse(line);
     } catch {
+      this.write(rawLine + "\n");
+      return;
+    }
+    if (!isPlainObject(entry)) {
+      this.write(rawLine + "\n");
       return;
     }
-    if (!isPlainObject(entry)) return;
     const level = firstDefined(entry, LEVEL_KEYS);
-    if (level === void 0) return;
+    if (level === void 0) {
+      this.write(rawLine + "\n");
+      return;
+    }
     const message = firstDefined(entry, MESSAGE_KEYS) ?? "";
     const time = firstDefined(entry, TIME_KEYS) ?? Date.now();
     if (levelToNumber(level) < this.minLevel) return;
@@ -295,8 +302,11 @@ var PinoNice = class {
       out.push(info.color(BOX.vertical) + "   " + dataLine);
     }
     out.push(summaryLine(time, level, message, this.utc));
+    this.write(out.join("\n") + "\n");
+  }
+  write(text) {
     try {
-      process.stdout.write(out.join("\n") + "\n");
+      process.stdout.write(text);
     } catch (error) {
       if (error?.code === "EPIPE") process.exit(0);
       throw error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pino-nice",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Pretty-print pino (and pino-like) JSON logs from stdin with a clean, human-friendly streaming view.",
   "type": "module",
   "author": "Tim Zadorozhny <tzador@gmail.com>",