@deployanyway/doggo-log 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0 — 2026-10-08
+
+- Scoped logs, optional barks: Use `logger.child("database")` to create an independent logger with a nested prefix. Enable `{ bark: true }` or CLI `--bark` for dog commentary. JSON preserves the original message and adds a separate `commentary` field. Filtering still suppresses output.
+- Add npm and CI badges to the published README.
+
 ## 0.1.1 — 2026-10-08
 
 - Correct npm installation and npx documentation after the initial publication.

package/README.md

@@ -1,5 +1,8 @@
 # doggo-log
 
+[![npm version](https://img.shields.io/npm/v/%40deployanyway%2Fdoggo-log)](https://www.npmjs.com/package/@deployanyway/doggo-log)
+[![CI](https://github.com/DeployAnyway/doggo-log/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DeployAnyway/doggo-log/actions/workflows/ci.yml)
+
 A tiny Node.js console logger with JSON output, log levels, and dog emojis. Good logs. Very good logs.
 
 ```text
@@ -140,3 +143,19 @@ See [CONTRIBUTING.md](CONTRIBUTING.md).
 - [doggo-log](https://github.com/DeployAnyway/doggo-log)
 - [ship-it-meter](https://github.com/DeployAnyway/ship-it-meter)
 - [bro-say](https://github.com/DeployAnyway/bro-say)
+
+## Scoped logs, optional barks
+
+Use `logger.child("database")` to create an independent logger with a nested prefix. Enable `{ bark: true }` or CLI `--bark` for dog commentary. JSON preserves the original message and adds a separate `commentary` field. Filtering still suppresses output.
+
+```sh
+npx @deployanyway/doggo-log success "Migration complete" --bark --prefix database
+```
+
+API (import the named functions from this package):
+
+```js
+createDogLogger({ bark: true, prefix: "api" })
+  .child("database")
+  .success("Migration complete");
+```

package/bin/cli.js

@@ -12,6 +12,7 @@ try {
       help: { type: "boolean", short: "h" },
       version: { type: "boolean", short: "v" },
       json: { type: "boolean" },
+      bark: { type: "boolean" },
       timestamp: { type: "boolean" },
       quiet: { type: "boolean" },
       color: { type: "boolean" },
@@ -22,7 +23,7 @@ try {
   });
   if (values.help) {
     console.log(
-      "Usage: doggo-log <method> <message> [options]\n\nMethods: log, info, success, warn, error, debug\nOptions:\n  --json         Emit JSON\n  --timestamp    Include an ISO timestamp\n  --no-emoji     Disable emojis\n  --color        Enable ANSI colors\n  --prefix text  Add a prefix\n  --level name   Minimum level (CLI default: debug)\n  --quiet        Suppress output\n  -h, --help     Show help\n  -v, --version  Show version\n\nExit codes: 0 success; 2 invalid arguments. Logging an error exits 0.",
+      "Usage: doggo-log <method> <message> [options]\n\nMethods: log, info, success, warn, error, debug\nOptions:\n  --bark         Add useful dog commentary\n  --json         Emit JSON\n  --timestamp    Include an ISO timestamp\n  --no-emoji     Disable emojis\n  --color        Enable ANSI colors\n  --prefix text  Add a prefix\n  --level name   Minimum level (CLI default: debug)\n  --quiet        Suppress output\n  -h, --help     Show help\n  -v, --version  Show version\n\nExit codes: 0 success; 2 invalid arguments. Logging an error exits 0.",
     );
   } else if (values.version) {
     console.log(
@@ -36,6 +37,7 @@ try {
       throw new TypeError("Provide a valid method and nonempty message.");
     const logger = createDogLogger({
       emoji: !values["no-emoji"],
+      bark: values.bark ?? false,
       color: values.color ?? false,
       timestamp: values.timestamp ?? false,
       json: values.json ?? false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deployanyway/doggo-log",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "A tiny Node.js console logger with JSON output, log levels, and dog emojis. Good logs. Very good logs.",
   "type": "module",
   "exports": "./src/index.js",

package/src/index.js

@@ -1,5 +1,13 @@
 import { format } from "node:util";
 import { levels } from "./levels.js";
+const barks = {
+  debug: "Sniffing for clues.",
+  log: "Filed under things I sniffed.",
+  info: "Good to know. Good dog to tell you.",
+  success: "Treat budget approved.",
+  warn: "Suspicious squirrel detected.",
+  error: "The dog has fetched the incident report.",
+};
 
 /**
  * Create a small logger. Methods return the emitted line, or undefined if filtered.
@@ -10,6 +18,7 @@ export function createDogLogger(options = {}) {
     throw new TypeError("Options must be an object.");
   const config = {
     emoji: true,
+    bark: false,
     color: false,
     timestamp: false,
     json: false,
@@ -23,7 +32,7 @@ export function createDogLogger(options = {}) {
     clock: () => new Date(),
     ...options,
   };
-  for (const key of ["emoji", "color", "timestamp", "json", "quiet"]) {
+  for (const key of ["emoji", "color", "timestamp", "json", "quiet", "bark"]) {
     if (typeof config[key] !== "boolean")
       throw new TypeError(`${key} must be a boolean.`);
   }
@@ -35,13 +44,14 @@ export function createDogLogger(options = {}) {
     );
   if (typeof config.write !== "function" || typeof config.clock !== "function")
     throw new TypeError("write and clock must be functions.");
-  return Object.fromEntries(
+  const logger = Object.fromEntries(
     Object.entries(levels).map(([level, style]) => [
       level,
       (...args) => {
         if (config.quiet || style.rank < levels[config.level].rank)
           return undefined;
         const message = format(...args);
+        const commentary = config.bark ? barks[level] : undefined;
         let timestamp;
         if (config.timestamp) {
           const date = config.clock();
@@ -54,6 +64,7 @@ export function createDogLogger(options = {}) {
           line = JSON.stringify({
             level,
             message,
+            ...(commentary ? { commentary } : {}),
             ...(config.prefix ? { prefix: config.prefix } : {}),
             ...(timestamp ? { timestamp } : {}),
           });
@@ -64,6 +75,7 @@ export function createDogLogger(options = {}) {
             config.emoji ? style.emoji : undefined,
             level.toUpperCase().padEnd(7),
             message,
+            commentary,
           ]
             .filter((part) => part !== undefined && part !== "")
             .join(" ");
@@ -74,6 +86,15 @@ export function createDogLogger(options = {}) {
       },
     ]),
   );
+  logger.child = (prefix) => {
+    if (typeof prefix !== "string" || !prefix.trim())
+      throw new TypeError("Child prefix must be a nonempty string.");
+    return createDogLogger({
+      ...config,
+      prefix: [config.prefix, prefix.trim()].filter(Boolean).join(":"),
+    });
+  };
+  return logger;
 }
 
 /** Default logger: emoji enabled, no timestamp/color, info threshold. */