@meadown/logger 1.8.10 → 1.9.0

package/README.md

@@ -30,11 +30,11 @@ tells you where things came from and disappears when you ship.
 
 - **Zero dependencies**
 - **Development-focused** — built for the dev experience, not production ops
-- **Clickable source link** — every log is a clickable link that jumps to the exact file and line it came from
-- **Tap logging** — log any value or promise inline; fetch calls also get timing, status, size, and body
+- **Clickable source link** — every log jumps straight to the file and line it came from
+- **Tap logging** — log any value or promise inline without breaking the expression
 - **Color-coded levels** — `[INFO]` cyan, `[WARN]` yellow, `[ERROR]` red
-- **Tree layout output** — clean, scannable structure in your terminal
-- **Collapsible messages** — cap long output with `logger.maxLines`
+- **Tree layout** — clean, scannable structure in your terminal
+- **Collapsible output** — cap long dumps with `logger.maxLines`
 
 ## Install
 
@@ -46,33 +46,27 @@ npm install @meadown/logger
 yarn add @meadown/logger
 ```
 
-## Using it
-
-Set `NODE_ENV=production` and all output is suppressed. Anything else and
-logging is on. No config files, no init call, no options object.
+## Quick start
 
 ```ts
 import logger from "@meadown/logger"
 
-logger("Hello world")
-logger("Auth", "user logged in")
-
-logger.warn("This is deprecated")
-logger.error("Something went wrong")
+logger("server started", { port: 3000 })
 ```
 
 ```text
 [INFO]
-├── Auth user logged in
-└── 05-30 04:00:00 PM - (server.ts:42)
+├── server started { port: 3000 }
+└── 05-30 04:00:00 PM - (server.ts:5)
 ```
 
-### Recommended: single shared import
+Works out of the box. Set `NODE_ENV=production` when you ship and the logs
+disappear — no wrappers, no cleanup, nothing to remember.
+
+### Single shared import
 
-Rather than importing directly from `@meadown/logger` in every file, create
-one shared module in your project and re-export from there. This gives you a
-single place to set options like `maxLines` and keeps any future changes to
-one file.
+Create one module in your project and re-export from there. One place to set
+options, one place to change if you ever need to.
 
 ```ts
 // lib/logger.ts
@@ -88,8 +82,8 @@ export default logger
 import logger from "@/lib/logger"
 ```
 
-When re-exporting, use a direct re-export, Not a wrapper function. A wrapper
-breaks the caller location shown in every log line.
+Use a direct re-export — not a wrapper function. A wrapper breaks the
+`(file:line)` link on every log.
 
 ```ts
 // GOOD — location stays honest
@@ -99,10 +93,62 @@ export { default as logger } from "@meadown/logger"
 export const logger = (...args) => log(...args)
 ```
 
-## API response logging
+## API
+
+```text
+┌─────────────────┬─────────────┬──────────────────────────┬───────────────────────────┐
+│     Method      │     Tag     │          Params          │          Purpose          │
+├─────────────────┼─────────────┼──────────────────────────┼───────────────────────────┤
+│ logger()        │ [INFO]      │ ...args: unknown[]       │ general info              │
+├─────────────────┼─────────────┼──────────────────────────┼───────────────────────────┤
+│ logger.warn()   │ [WARN]      │ ...args: unknown[]       │ something needs attention │
+├─────────────────┼─────────────┼──────────────────────────┼───────────────────────────┤
+│ logger.error()  │ [ERROR]     │ ...args: unknown[]       │ something broke           │
+├─────────────────┼─────────────┼──────────────────────────┼───────────────────────────┤
+│ logger.tap()    │ [TAP]       │ value: T, label?: string │ log value, returns as-is  │
+├─────────────────┼─────────────┼──────────────────────────┼───────────────────────────┤
+│ logger.group()  │ [name]      │ { name: string,          │ consolidate related       │
+│                 │             │   type?: LogChannel,     │ items under a label       │
+│                 │             │   logs: unknown[] }      │                           │
+├─────────────────┼─────────────┼──────────────────────────┼───────────────────────────┤
+│ logger.maxLines │ —           │ number                   │ cap output at N lines     │
+└─────────────────┴─────────────┴──────────────────────────┴───────────────────────────┘
+```
+
+Every tag is self-describing. You scan the logs and immediately know what each
+entry is without reading the message. That's the design principle holding the
+whole API together.
+
+### `logger()`
+
+Your everyday log. Pass it anything — strings, objects, errors, whatever.
+Works exactly like `console.log`, just prettier.
+
+```ts
+logger("server started")
+logger("user logged in", { userId: 42, role: "admin" })
+```
+
+```text
+[INFO]
+├── user logged in { userId: 42, role: 'admin' }
+└── 05-30 04:00:00 PM - (server.ts:12)
+```
+
+### `logger.tap()`
+
+The one you reach for when you want to see what's inside something without
+stopping to assign it to a variable first. Logs it and gives it straight back.
+
+```ts
+const port = logger.tap(5000, "port")
+server.listen(logger.tap(port, "port"))
+```
+
+#### API response logging
 
-Drop `tap` into any `await` chain. You get timing, status, size, and the
-actual response body. The promise flows through untouched. One line of code.
+Drop it into any `await` and you get timing, status, size, and the response
+body — without touching your code at all.
 
 ```ts
 const user = await logger.tap(
@@ -129,15 +175,14 @@ const user = await logger.tap(
 └── 05-30 07:54:26 PM - (api.ts:12)
 ```
 
-You can immediately see: was it successful? How long did it take? What came
-back? Without opening DevTools.
+Was it successful? How long did it take? What came back? All there, without
+opening DevTools.
 
 ![API response logging: tap a fetch and see timing, status, size, and body](media/tap-api-demo.png)
 
-### Tap any value
+#### Tap any value
 
-`tap` works on anything, not just fetch. Pass in any value or expression and
-get it back exactly as it was. The only thing that happens is a log.
+Not just fetch. Any value, any expression. Logged and returned as-is.
 
 ```ts
 // numbers, strings, objects — logged and returned as-is
@@ -147,7 +192,7 @@ logger.tap(config, "loaded config")
 ```
 
 ```ts
-// async functions — promise flows through, timing logged when it settles
+// promises — flows through, timing logged when it settles
 const user = await logger.tap(getUser(), "getUser")
 const config = await logger.tap(loadConfig(), "loadConfig")
 ```
@@ -157,43 +202,96 @@ const config = await logger.tap(loadConfig(), "loadConfig")
 server.listen(logger.tap(port, "port"))
 ```
 
-If it's a promise, `tap` logs elapsed time once it settles. If it resolves
-to a `Response` (any fetch like call), you also get status and size, same
-as the fetch example above.
+If it's a promise, timing is logged once it settles. If it resolves to a
+`Response`, you also get status and size.
 
-## Clickable source link
+### `logger.group()`
 
-That `(server.ts:42)` is a **clickable link**. Click it and your editor opens the file and jumps straight to that line. Works in VS Code, iTerm2, WezTerm, Kitty, and Windows Terminal. Degrades to plain text everywhere else.
+Got a handful of related things to log at once? Group them. One block, one
+timestamp, one place to look.
 
-## Color-coded levels
+```ts
+logger.group({
+  name: "Server setup",
+  logs: [
+    `Running on port ${port}`,
+    `Environment: ${env}`,
+    `API: http://localhost:${port}/api`,
+  ],
+})
+```
+
+```text
+[SERVER SETUP]
+├── Running on port 5000
+├── Environment: development
+├── API: http://localhost:5000/api
+└── 05-30 04:00:00 PM - (server.ts:23)
+```
+
+Use `type` to set the channel and tag color. Defaults to `"log"` (cyan, stdout).
+
+```ts
+logger.group({
+  name: "Validation failed",
+  type: "error", // red, stderr
+  logs: ["email invalid", "password too short"],
+})
+
+logger.group({
+  name: "Config warnings",
+  type: "warn", // yellow, stderr
+  logs: ["deprecated key found", "missing optional field"],
+})
+```
+
+`logs` takes anything — strings, objects, arrays, errors. Each renders exactly
+as `console.log` would.
+
+### `logger.error()`
 
-`[INFO]` , `[TAP]` cyan · `[WARN]` yellow · `[ERROR]` red. Timestamp and location tinted teal.
-Auto-disabled when output is piped no escape codes in your log files.
+Red tag, goes to `stderr`. Pass an `Error` and you get the stack too.
 
-## Tree layout output
+```ts
+logger.error("database connection failed", new Error("ECONNREFUSED"))
+```
 
 ```text
-[INFO]
-├── Auth user logged in
-└── 05-30 04:00:00 PM - (server.ts:42)
+[ERROR]
+├── database connection failed Error: ECONNREFUSED
+│       at Object.<anonymous> (server.ts:14:18)
+└── 05-30 04:00:00 PM - (server.ts:14)
+```
+
+### `logger.warn()`
+
+Yellow tag, `stderr`. For the things that aren't broken yet.
+
+```ts
+logger.warn("disk usage above 80%")
+logger.warn("deprecated config key", { key: "timeout", use: "timeoutMs" })
+```
+
+```text
+[WARN]
+├── disk usage above 80%
+└── 05-30 04:00:00 PM - (monitor.ts:8)
 ```
 
-Level tag, message, timestamp, and location all in a clean tree. Easy to scan,
-even in a busy terminal.
+### `logger.maxLines`
 
-## Collapsible messages
+Got a massive object dumping 200 lines? Set this and it cuts off after N lines
+with a count of what's hidden. Set back to `0` to show everything again.
 
 ```ts
 logger.maxLines = 5 // show 5 lines, then "... N more lines"
 logger.maxLines = 0 // default — show everything
 ```
 
-## NODE_ENV
+## Production
 
-You shouldn't have to think about whether your logs will leak into production.
-This package reads `NODE_ENV` and handles it for you. Set it to `production`
-and all output is handled for you. You never have to remember to wrap a log call,
-remove a debug line, or grep the codebase before a release.
+Set `NODE_ENV=production` and everything goes silent. No wrapper calls, no
+grep before release, no accidental logs in prod.
 
 | `NODE_ENV`                               | Logs?      |
 | ---------------------------------------- | ---------- |

package/dist/cjs/{config.js → config/index.js}

@@ -2,7 +2,7 @@
 /*
  * config.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/{constants.d.ts → const/index.d.ts}

@@ -1,8 +1,3 @@
-import { type Color } from "./colors/color.js";
-/** The console channels the logger writes to. */
-export type LogChannel = "log" | "error" | "warn";
-/** The tag color per channel: info/tap → cyan, warn → yellow, error → red. */
-export declare const TAG_COLOR: Record<LogChannel, Color>;
 /** Glyphs that draw each entry's little tree. */
 export declare const BRANCH = "\u251C\u2500\u2500";
 export declare const BRANCH_END = "\u2514\u2500\u2500";

package/dist/cjs/{constants.js → const/index.js}

@@ -2,20 +2,14 @@
 /*
  * constants.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  *
  * Single home for the logger's layout/behavior constants, so the values that
  * shape an entry live in one place instead of as magic literals across modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_MAX_LINES = exports.MESSAGE_INDENT = exports.SEPARATOR = exports.BRANCH_END = exports.BRANCH = exports.TAG_COLOR = void 0;
-/** The tag color per channel: info/tap → cyan, warn → yellow, error → red. */
-exports.TAG_COLOR = {
-    log: "cyan",
-    warn: "yellow",
-    error: "red",
-};
+exports.DEFAULT_MAX_LINES = exports.MESSAGE_INDENT = exports.SEPARATOR = exports.BRANCH_END = exports.BRANCH = void 0;
 /** Glyphs that draw each entry's little tree. */
 exports.BRANCH = "├──"; // the message branch
 exports.BRANCH_END = "└──"; // the last (metadata) branch

package/dist/cjs/{caller → domain/caller}/getCaller.js

@@ -2,7 +2,7 @@
 /*
  * getCaller.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/{colors → domain/colors}/color.js

@@ -2,7 +2,7 @@
 /*
  * color.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/{decorations → domain/decorations}/link.js

@@ -2,7 +2,7 @@
 /*
  * link.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/{terminal → domain/terminal}/isTTY.js

@@ -2,7 +2,7 @@
 /*
  * isTTY.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/{time → domain/time}/getTimeStamp.js

@@ -2,7 +2,7 @@
 /*
  * getTimeStamp.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/domain/write/helpers/buildContext.d.ts

@@ -0,0 +1,16 @@
+import { type LogChannel } from "../../../types/index.js";
+import { type Caller } from "../../caller/getCaller.js";
+import { type Color } from "../../colors/color.js";
+/** Tag color per channel — cyan for log/tap, yellow for warn, red for error. */
+export declare const TAG_COLOR: Record<LogChannel, Color>;
+export interface RenderContext {
+    useColor: boolean;
+    paint: (s: string, c: Color) => string;
+    timeStamp: string;
+    locOut: string;
+    connector: string;
+    connectorEnd: string;
+    separator: string;
+}
+/** Builds the shared paint/layout values used by both writeLog and writeGroup. */
+export declare function buildContext(channel: LogChannel, caller: Caller): RenderContext;

package/dist/cjs/domain/write/helpers/buildContext.js

@@ -0,0 +1,40 @@
+"use strict";
+/*
+ * buildContext.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TAG_COLOR = void 0;
+exports.buildContext = buildContext;
+const index_js_1 = require("../../../const/index.js");
+const color_js_1 = require("../../colors/color.js");
+/** Tag color per channel — cyan for log/tap, yellow for warn, red for error. */
+exports.TAG_COLOR = {
+    log: "cyan",
+    warn: "yellow",
+    error: "red",
+};
+const isTTY_js_1 = require("../../terminal/isTTY.js");
+const getTimeStamp_js_1 = __importDefault(require("../../time/getTimeStamp.js"));
+const formatLocation_js_1 = require("./formatLocation.js");
+/** Builds the shared paint/layout values used by both writeLog and writeGroup. */
+function buildContext(channel, caller) {
+    const streamName = channel === "log" ? "stdout" : "stderr";
+    const useColor = (0, isTTY_js_1.isTTY)(streamName);
+    const paint = (s, c) => (useColor ? (0, color_js_1.colorize)(s, c) : s);
+    const location = (0, formatLocation_js_1.formatLocation)(caller, useColor);
+    return {
+        useColor,
+        paint,
+        timeStamp: paint((0, getTimeStamp_js_1.default)(), "teal"),
+        locOut: paint(`(${location})`, "dimTeal"),
+        connector: paint(index_js_1.BRANCH, "gray"),
+        connectorEnd: paint(index_js_1.BRANCH_END, "gray"),
+        separator: paint(index_js_1.SEPARATOR, "gray"),
+    };
+}

package/dist/cjs/{core/writeLog → domain/write/helpers}/formatLocation.js

@@ -2,7 +2,7 @@
 /*
  * formatLocation.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -13,7 +13,8 @@ const link_js_1 = require("../../decorations/link.js");
  * supporting terminal, plain text otherwise. Pure (no stack access).
  */
 function formatLocation(caller, interactive) {
-    if (caller.file !== null && caller.line !== null && interactive)
+    if (caller.file !== null && caller.line !== null && interactive) {
         return (0, link_js_1.hyperlink)(caller.label, (0, link_js_1.fileUrl)(caller.file));
+    }
     return caller.label;
 }

package/dist/cjs/domain/write/helpers/index.d.ts

@@ -0,0 +1,4 @@
+export { visibleLines, getVisibleLines, setVisibleLines, } from "./visibleLines.js";
+export { renderMessage } from "./renderMessage.js";
+export { formatLocation } from "./formatLocation.js";
+export { buildContext, TAG_COLOR } from "./buildContext.js";

package/dist/cjs/domain/write/helpers/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TAG_COLOR = exports.buildContext = exports.formatLocation = exports.renderMessage = exports.setVisibleLines = exports.getVisibleLines = exports.visibleLines = void 0;
+var visibleLines_js_1 = require("./visibleLines.js");
+Object.defineProperty(exports, "visibleLines", { enumerable: true, get: function () { return visibleLines_js_1.visibleLines; } });
+Object.defineProperty(exports, "getVisibleLines", { enumerable: true, get: function () { return visibleLines_js_1.getVisibleLines; } });
+Object.defineProperty(exports, "setVisibleLines", { enumerable: true, get: function () { return visibleLines_js_1.setVisibleLines; } });
+var renderMessage_js_1 = require("./renderMessage.js");
+Object.defineProperty(exports, "renderMessage", { enumerable: true, get: function () { return renderMessage_js_1.renderMessage; } });
+var formatLocation_js_1 = require("./formatLocation.js");
+Object.defineProperty(exports, "formatLocation", { enumerable: true, get: function () { return formatLocation_js_1.formatLocation; } });
+var buildContext_js_1 = require("./buildContext.js");
+Object.defineProperty(exports, "buildContext", { enumerable: true, get: function () { return buildContext_js_1.buildContext; } });
+Object.defineProperty(exports, "TAG_COLOR", { enumerable: true, get: function () { return buildContext_js_1.TAG_COLOR; } });

package/dist/cjs/{core/writeLog → domain/write/helpers}/renderMessage.js

@@ -2,15 +2,15 @@
 /*
  * renderMessage.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderMessage = renderMessage;
 const node_util_1 = require("node:util");
-const constants_js_1 = require("../../constants.js");
-const color_js_1 = require("../../colors/color.js");
 const visibleLines_js_1 = require("./visibleLines.js");
+const color_js_1 = require("../../colors/color.js");
+const index_js_1 = require("../../../const/index.js");
 /**
  * Collapses a long multi-line message to {@link visibleLines} lines, replacing
  * the rest with a dimmed `… N more lines` summary. When `visibleLines` is 0
@@ -23,7 +23,7 @@ function collapse(text, useColor) {
     if (lines.length <= visibleLines_js_1.visibleLines)
         return text;
     const hidden = lines.length - visibleLines_js_1.visibleLines;
-    const summary = `${constants_js_1.MESSAGE_INDENT}... ${hidden} more line${hidden === 1 ? "" : "s"}`;
+    const summary = `${index_js_1.MESSAGE_INDENT}... ${hidden} more line${hidden === 1 ? "" : "s"}`;
     const visible = lines.slice(0, visibleLines_js_1.visibleLines);
     visible.push(useColor ? (0, color_js_1.colorize)(summary, "gray") : summary);
     return visible.join("\n");
@@ -36,5 +36,6 @@ function collapse(text, useColor) {
  */
 function renderMessage(args, useColor) {
     const text = (0, node_util_1.formatWithOptions)({ colors: useColor }, ...args);
-    return collapse(text.replace(/\n/g, `\n${(0, color_js_1.colorize)(constants_js_1.MESSAGE_INDENT, "gray")}`), useColor);
+    const indent = useColor ? (0, color_js_1.colorize)(index_js_1.MESSAGE_INDENT, "gray") : index_js_1.MESSAGE_INDENT;
+    return collapse(text.replace(/\n/g, `\n${indent}`), useColor);
 }

package/dist/cjs/{core/writeLog → domain/write/helpers}/visibleLines.js

@@ -2,16 +2,16 @@
 /*
  * visibleLines.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.visibleLines = void 0;
 exports.getVisibleLines = getVisibleLines;
 exports.setVisibleLines = setVisibleLines;
-const constants_js_1 = require("../../constants.js");
+const index_js_1 = require("../../../const/index.js");
 /** Max message lines to show before collapsing the rest; 0 (default) shows all. */
-exports.visibleLines = constants_js_1.DEFAULT_MAX_LINES;
+exports.visibleLines = index_js_1.DEFAULT_MAX_LINES;
 /** How many lines a long message shows before collapsing (0 = all). */
 function getVisibleLines() {
     return exports.visibleLines;

package/dist/cjs/domain/write/index.d.ts

@@ -0,0 +1,2 @@
+export { writeLog } from "./writeLog.js";
+export { getVisibleLines, setVisibleLines } from "./helpers/index.js";

package/dist/cjs/domain/write/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setVisibleLines = exports.getVisibleLines = exports.writeLog = void 0;
+var writeLog_js_1 = require("./writeLog.js");
+Object.defineProperty(exports, "writeLog", { enumerable: true, get: function () { return writeLog_js_1.writeLog; } });
+var index_js_1 = require("./helpers/index.js");
+Object.defineProperty(exports, "getVisibleLines", { enumerable: true, get: function () { return index_js_1.getVisibleLines; } });
+Object.defineProperty(exports, "setVisibleLines", { enumerable: true, get: function () { return index_js_1.setVisibleLines; } });

package/dist/{core/writeLog/index.d.ts → cjs/domain/write/writeLog.d.ts}

@@ -1,6 +1,5 @@
-import { type LogChannel } from "../../constants.js";
-import { type Caller } from "../../caller/getCaller.js";
-export { getVisibleLines, setVisibleLines } from "./visibleLines.js";
+import { type LogChannel } from "../../types/index.js";
+import { type Caller } from "../caller/getCaller.js";
 /**
  * Renders and writes one log entry. The `caller` is resolved by the *caller* of
  * this function (the log closure or `tap`) and passed in, so this helper never

package/dist/cjs/domain/write/writeLog.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * writeLog.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeLog = writeLog;
+const index_js_1 = require("./helpers/index.js");
+/**
+ * Renders and writes one log entry. The `caller` is resolved by the *caller* of
+ * this function (the log closure or `tap`) and passed in, so this helper never
+ * touches the stack — keeping {@link getCaller}'s frame depth correct no matter
+ * which user-facing function delegates here.
+ */
+function writeLog(opts) {
+    const { channel, tag, args, caller } = opts;
+    const { useColor, paint, timeStamp, locOut, connector, connectorEnd, separator, } = (0, index_js_1.buildContext)(channel, caller);
+    const tagOut = paint(tag, index_js_1.TAG_COLOR[channel]);
+    const message = (0, index_js_1.renderMessage)(args, useColor);
+    const meta = `\n${connectorEnd} ${timeStamp} ${separator} ${locOut}`;
+    console[channel](`\n${tagOut} \n${connector} ${message}${meta}`);
+}

package/dist/cjs/features/logger/index.d.ts

@@ -0,0 +1 @@
+export default function log(...args: unknown[]): void;

package/dist/cjs/features/logger/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = log;
+const index_js_1 = require("../../config/index.js");
+const getCaller_js_1 = __importDefault(require("../../domain/caller/getCaller.js"));
+const writeLog_js_1 = require("../../domain/write/writeLog.js");
+function log(...args) {
+    if (!(0, index_js_1.isLogAllowed)())
+        return;
+    const caller = (0, getCaller_js_1.default)();
+    (0, writeLog_js_1.writeLog)({ channel: "log", tag: "[INFO]", args, caller });
+}

package/dist/cjs/features/logger-error/index.d.ts

@@ -0,0 +1 @@
+export default function logError(...args: unknown[]): void;

package/dist/cjs/features/logger-error/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = logError;
+const index_js_1 = require("../../config/index.js");
+const getCaller_js_1 = __importDefault(require("../../domain/caller/getCaller.js"));
+const writeLog_js_1 = require("../../domain/write/writeLog.js");
+function logError(...args) {
+    if (!(0, index_js_1.isLogAllowed)())
+        return;
+    const caller = (0, getCaller_js_1.default)();
+    (0, writeLog_js_1.writeLog)({ channel: "error", tag: "[ERROR]", args, caller });
+}