@meadown/logger 1.8.10 → 1.9.0

package/dist/cjs/index.js

@@ -2,7 +2,7 @@
 /*
  * index.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
@@ -10,23 +10,37 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.logger = void 0;
-const createLog_js_1 = __importDefault(require("./core/createLog.js"));
-const createTap_js_1 = __importDefault(require("./tap/createTap.js"));
-const index_js_1 = require("./core/writeLog/index.js");
+const index_js_1 = require("./features/logger-max-lines/index.js");
+const index_js_2 = __importDefault(require("./features/logger/index.js"));
+const index_js_3 = __importDefault(require("./features/logger-warn/index.js"));
+const index_js_4 = __importDefault(require("./features/logger-error/index.js"));
+const index_js_5 = __importDefault(require("./features/logger-tap/index.js"));
+const index_js_6 = __importDefault(require("./features/logger-group/index.js"));
 /**
- * Logs to the console, but only outside production. Each line is prefixed with
- * a level tag, a short local timestamp, and a clickable link to the file it was
- * called from; all arguments are then printed as-is.
+ * A logger built for development — colored tags, a local timestamp, and a
+ * clickable `(file:line)` link on every line so you always know where a
+ * message came from. Works like `console.log`: pass anything and it prints.
+ *
+ * Logs only when `NODE_ENV !== "production"`.
+ *
  * @example
- * logger("Auth", "user logged in")
- * // [INFO] 05-30 04:00:00 PM (server.ts:42) Auth user logged in
- * @example
- * logger.maxLines = 5 // long messages collapse to 5 lines; 0 = show all
+ * ```ts
+ * logger("server started", { port: 3000 })
+ * logger.error("db failed", new Error("ECONNREFUSED"))
+ * logger.warn("disk above 80%")
+ * ```
+ *
+ * @example Tap — keep the value flowing, log it on the side
+ * ```ts
+ * const user = logger.tap(await getUser(id), "user")
+ * const res  = await logger.tap(fetch(url), "GET /users")
+ * ```
  */
-const logger = Object.assign((0, createLog_js_1.default)("log", "[INFO]"), {
-    error: (0, createLog_js_1.default)("error", "[ERROR]"),
-    warn: (0, createLog_js_1.default)("warn", "[WARN]"),
-    tap: (0, createTap_js_1.default)(),
+const logger = Object.assign(index_js_2.default, {
+    error: index_js_4.default,
+    warn: index_js_3.default,
+    tap: index_js_5.default,
+    group: index_js_6.default,
 });
 exports.logger = logger;
 // `maxLines` is a live getter/setter backed by the shared collapse setting, so

package/dist/cjs/types/index.d.ts

@@ -0,0 +1,2 @@
+/** The console channels the logger writes to. */
+export type LogChannel = "log" | "error" | "warn";

package/dist/cjs/types/index.js

@@ -0,0 +1,8 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,7 +1,7 @@
 /*
  * config.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 /**

package/dist/{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/{constants.js → const/index.js}

@@ -1,18 +1,12 @@
 /*
  * 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.
  */
-/** The tag color per channel: info/tap → cyan, warn → yellow, error → red. */
-export const TAG_COLOR = {
-    log: "cyan",
-    warn: "yellow",
-    error: "red",
-};
 /** Glyphs that draw each entry's little tree. */
 export const BRANCH = "├──"; // the message branch
 export const BRANCH_END = "└──"; // the last (metadata) branch

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

@@ -1,7 +1,7 @@
 /*
  * getCaller.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 const UNKNOWN = { label: "unknown", file: null, line: null };

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

@@ -1,7 +1,7 @@
 /*
  * color.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 /** ANSI SGR codes for the colors/styles the logger uses. */

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

@@ -1,7 +1,7 @@
 /*
  * link.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 import { pathToFileURL } from "node:url";

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

@@ -1,7 +1,7 @@
 /*
  * isTTY.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 /**

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

@@ -1,7 +1,7 @@
 /*
  * getTimeStamp.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 // Time-only 12-hour formatter (date is built separately, timezone is dropped).

package/dist/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/domain/write/helpers/buildContext.js

@@ -0,0 +1,33 @@
+/*
+ * buildContext.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { BRANCH, BRANCH_END, SEPARATOR } from "../../../const/index.js";
+import { colorize } from "../../colors/color.js";
+/** Tag color per channel — cyan for log/tap, yellow for warn, red for error. */
+export const TAG_COLOR = {
+    log: "cyan",
+    warn: "yellow",
+    error: "red",
+};
+import { isTTY } from "../../terminal/isTTY.js";
+import getTimeStamp from "../../time/getTimeStamp.js";
+import { formatLocation } from "./formatLocation.js";
+/** Builds the shared paint/layout values used by both writeLog and writeGroup. */
+export function buildContext(channel, caller) {
+    const streamName = channel === "log" ? "stdout" : "stderr";
+    const useColor = isTTY(streamName);
+    const paint = (s, c) => (useColor ? colorize(s, c) : s);
+    const location = formatLocation(caller, useColor);
+    return {
+        useColor,
+        paint,
+        timeStamp: paint(getTimeStamp(), "teal"),
+        locOut: paint(`(${location})`, "dimTeal"),
+        connector: paint(BRANCH, "gray"),
+        connectorEnd: paint(BRANCH_END, "gray"),
+        separator: paint(SEPARATOR, "gray"),
+    };
+}

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

@@ -1,7 +1,7 @@
 /*
  * formatLocation.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 import { fileUrl, hyperlink } from "../../decorations/link.js";
@@ -10,7 +10,8 @@ import { fileUrl, hyperlink } from "../../decorations/link.js";
  * supporting terminal, plain text otherwise. Pure (no stack access).
  */
 export function formatLocation(caller, interactive) {
-    if (caller.file !== null && caller.line !== null && interactive)
+    if (caller.file !== null && caller.line !== null && interactive) {
         return hyperlink(caller.label, fileUrl(caller.file));
+    }
     return caller.label;
 }

package/dist/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/domain/write/helpers/index.js

@@ -0,0 +1,10 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+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/{core/writeLog → domain/write/helpers}/renderMessage.js

@@ -1,13 +1,13 @@
 /*
  * renderMessage.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 import { formatWithOptions } from "node:util";
-import { MESSAGE_INDENT } from "../../constants.js";
-import { colorize } from "../../colors/color.js";
 import { visibleLines } from "./visibleLines.js";
+import { colorize } from "../../colors/color.js";
+import { MESSAGE_INDENT } from "../../../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
@@ -33,5 +33,6 @@ function collapse(text, useColor) {
  */
 export function renderMessage(args, useColor) {
     const text = formatWithOptions({ colors: useColor }, ...args);
-    return collapse(text.replace(/\n/g, `\n${colorize(MESSAGE_INDENT, "gray")}`), useColor);
+    const indent = useColor ? colorize(MESSAGE_INDENT, "gray") : MESSAGE_INDENT;
+    return collapse(text.replace(/\n/g, `\n${indent}`), useColor);
 }

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

@@ -1,10 +1,10 @@
 /*
  * visibleLines.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
-import { DEFAULT_MAX_LINES } from "../../constants.js";
+import { DEFAULT_MAX_LINES } from "../../../const/index.js";
 /** Max message lines to show before collapsing the rest; 0 (default) shows all. */
 export let visibleLines = DEFAULT_MAX_LINES;
 /** How many lines a long message shows before collapsing (0 = all). */

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

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

package/dist/domain/write/index.js

@@ -0,0 +1,8 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { writeLog } from "./writeLog.js";
+export { getVisibleLines, setVisibleLines } from "./helpers/index.js";

package/dist/{cjs/core/writeLog/index.d.ts → 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/domain/write/writeLog.js

@@ -0,0 +1,21 @@
+/*
+ * writeLog.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { renderMessage, buildContext, TAG_COLOR } from "./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.
+ */
+export function writeLog(opts) {
+    const { channel, tag, args, caller } = opts;
+    const { useColor, paint, timeStamp, locOut, connector, connectorEnd, separator, } = buildContext(channel, caller);
+    const tagOut = paint(tag, TAG_COLOR[channel]);
+    const message = renderMessage(args, useColor);
+    const meta = `\n${connectorEnd} ${timeStamp} ${separator} ${locOut}`;
+    console[channel](`\n${tagOut} \n${connector} ${message}${meta}`);
+}

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

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

package/dist/features/logger/index.js

@@ -0,0 +1,15 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeLog } from "../../domain/write/writeLog.js";
+export default function log(...args) {
+    if (!isLogAllowed())
+        return;
+    const caller = getCaller();
+    writeLog({ channel: "log", tag: "[INFO]", args, caller });
+}

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

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

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

@@ -0,0 +1,15 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeLog } from "../../domain/write/writeLog.js";
+export default function logError(...args) {
+    if (!isLogAllowed())
+        return;
+    const caller = getCaller();
+    writeLog({ channel: "error", tag: "[ERROR]", args, caller });
+}

package/dist/features/logger-group/createGroup.d.ts

@@ -0,0 +1,11 @@
+import { type LogChannel } from "../../types/index.js";
+export interface GroupOptions {
+    name: string;
+    type?: LogChannel;
+    logs: unknown[];
+}
+/** Type of `logger.group` — use this to annotate variables or parameters that accept it. */
+export interface Group {
+    (opts: GroupOptions): void;
+}
+export default function group({ name, type, logs, }: GroupOptions): void;

package/dist/features/logger-group/createGroup.js

@@ -0,0 +1,15 @@
+/*
+ * createGroup.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeGroup } from "./writeGroup.js";
+export default function group({ name, type = "log", logs, }) {
+    if (!isLogAllowed())
+        return;
+    const caller = getCaller();
+    writeGroup({ name, channel: type, logs, caller });
+}

package/dist/features/logger-group/index.d.ts

@@ -0,0 +1 @@
+export { default, type Group, type GroupOptions } from "./createGroup.js";

package/dist/features/logger-group/index.js

@@ -0,0 +1,7 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { default } from "./createGroup.js";

package/dist/features/logger-group/writeGroup.d.ts

@@ -0,0 +1,8 @@
+import { type LogChannel } from "../../types/index.js";
+import { type Caller } from "../../domain/caller/getCaller.js";
+export declare function writeGroup(opts: {
+    name: string;
+    channel: LogChannel;
+    logs: unknown[];
+    caller: Caller;
+}): void;

package/dist/features/logger-group/writeGroup.js

@@ -0,0 +1,17 @@
+/*
+ * writeGroup.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { renderMessage, buildContext, TAG_COLOR, } from "../../domain/write/helpers/index.js";
+export function writeGroup(opts) {
+    const { name, channel, logs, caller } = opts;
+    const { useColor, paint, timeStamp, locOut, connector, connectorEnd, separator, } = buildContext(channel, caller);
+    const tagOut = paint(`[${name.toUpperCase()}]`, TAG_COLOR[channel]);
+    const itemLines = logs
+        .map((item) => `\n${connector} ${renderMessage([item], useColor)}`)
+        .join("");
+    const meta = `\n${connectorEnd} ${timeStamp} ${separator} ${locOut}`;
+    console[channel](`\n${tagOut} ${itemLines}${meta}`);
+}

package/dist/features/logger-max-lines/index.d.ts

@@ -0,0 +1 @@
+export { getVisibleLines, setVisibleLines } from "../../domain/write/index.js";

package/dist/features/logger-max-lines/index.js

@@ -0,0 +1,7 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { getVisibleLines, setVisibleLines } from "../../domain/write/index.js";

package/dist/features/logger-tap/createTap.d.ts

@@ -0,0 +1,5 @@
+/** Type of `logger.tap` — use this to annotate variables or parameters that accept it. */
+export interface Tap {
+    <T>(value: T, label?: string): T;
+}
+export default function tap<T>(value: T, label?: string): T;

package/dist/features/logger-tap/createTap.js

@@ -0,0 +1,27 @@
+/*
+ * createTap.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeLog } from "../../domain/write/writeLog.js";
+import { isThenable, tapAsync } from "./tapAsync/index.js";
+export default function tap(value, label) {
+    if (!isLogAllowed())
+        return value;
+    const caller = getCaller();
+    if (isThenable(value)) {
+        tapAsync(value, label, caller);
+    }
+    else {
+        writeLog({
+            channel: "log",
+            tag: "[TAP]",
+            args: label === undefined ? [value] : [label, value],
+            caller,
+        });
+    }
+    return value;
+}

package/dist/features/logger-tap/index.d.ts

@@ -0,0 +1 @@
+export { default, type Tap } from "./createTap.js";

package/dist/features/logger-tap/index.js

@@ -0,0 +1,7 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { default } from "./createTap.js";

package/dist/features/logger-tap/tapAsync/helpers/buildBlock.d.ts

@@ -0,0 +1,19 @@
+import { type ResponseLike } from "./response.js";
+/**
+ * Renders the nested tree block:
+ *
+ *   GET /users/1
+ *   │
+ *   │  response:
+ *   │  ├── time:   65ms
+ *   │  ├── status: 200 OK
+ *   │  └── size:   848 B
+ *   │
+ *   │  body:
+ *   │  ├── id:    1
+ *   │  └── name:  Leanne Graham
+ */
+export declare function buildBlock(label: string | undefined, ms: number, res: ResponseLike, body: {
+    data: unknown;
+    size: string;
+}, useColor: boolean): unknown[];

package/dist/features/logger-tap/tapAsync/helpers/buildBlock.js

@@ -0,0 +1,53 @@
+/*
+ * buildBlock.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { formatWithOptions } from "node:util";
+import { formatDuration } from "./format.js";
+import { colorize } from "../../../../domain/colors/color.js";
+import { formatStatus } from "./response.js";
+/**
+ * Renders the nested tree block:
+ *
+ *   GET /users/1
+ *   │
+ *   │  response:
+ *   │  ├── time:   65ms
+ *   │  ├── status: 200 OK
+ *   │  └── size:   848 B
+ *   │
+ *   │  body:
+ *   │  ├── id:    1
+ *   │  └── name:  Leanne Graham
+ */
+export function buildBlock(label, ms, res, body, useColor) {
+    const paint = (s, c) => useColor ? colorize(s, c) : s;
+    const pipe = paint("│", "gray");
+    const branch = paint("├──", "gray");
+    const last = paint("└──", "gray");
+    const indent = `${pipe}  `;
+    const timeLine = `${indent}${branch} time:   ${formatDuration(ms, useColor)}`;
+    const statusLine = `${indent}${branch} status: ${formatStatus(res, useColor)}`;
+    const sizeLine = `${indent}${last} size:   ${body.size}`;
+    const responseLines = [
+        `${pipe}`,
+        `${indent}response:`,
+        timeLine,
+        statusLine,
+        sizeLine,
+    ];
+    const head = label === undefined ? "" : `${label}\n`;
+    if (body.data === undefined) {
+        return [`${head}${responseLines.join("\n")}`];
+    }
+    const bodyText = formatWithOptions({ colors: useColor }, body.data);
+    const bodyLines = bodyText.split("\n");
+    const lastIdx = bodyLines.length - 1;
+    const bodyBlock = bodyLines
+        .map((line, i) => `${indent}${i === lastIdx ? last : branch} ${line}`)
+        .join("\n");
+    const full = [...responseLines, `${pipe}`, `${indent}body:`, bodyBlock].join("\n");
+    return [`${head}${full}`];
+}

package/dist/features/logger-tap/tapAsync/helpers/format.d.ts

@@ -0,0 +1,4 @@
+/** `65ms` (green) · `1.2s` (yellow) · `5.8s` (red). */
+export declare function formatDuration(ms: number, useColor: boolean): string;
+/** `848 B` / `1.84 KB` / `2.10 MB`. */
+export declare function formatBytes(bytes: number): string;

package/dist/features/logger-tap/tapAsync/helpers/format.js

@@ -0,0 +1,26 @@
+/*
+ * format.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { colorize } from "../../../../domain/colors/color.js";
+/** `65ms` (green) · `1.2s` (yellow) · `5.8s` (red). */
+export function formatDuration(ms, useColor) {
+    const text = ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${ms}ms`;
+    if (!useColor)
+        return text;
+    if (ms >= 2000)
+        return colorize(text, "red");
+    if (ms >= 500)
+        return colorize(text, "yellow");
+    return colorize(text, "green");
+}
+/** `848 B` / `1.84 KB` / `2.10 MB`. */
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}

package/dist/features/logger-tap/tapAsync/helpers/index.d.ts

@@ -0,0 +1,4 @@
+export { readBody, isResponse, formatStatus, type ResponseLike, } from "./response.js";
+export { buildBlock } from "./buildBlock.js";
+export { isThenable } from "./isThenable.js";
+export { formatDuration, formatBytes } from "./format.js";

package/dist/features/logger-tap/tapAsync/helpers/index.js

@@ -0,0 +1,10 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { readBody, isResponse, formatStatus, } from "./response.js";
+export { buildBlock } from "./buildBlock.js";
+export { isThenable } from "./isThenable.js";
+export { formatDuration, formatBytes } from "./format.js";

package/dist/features/logger-tap/tapAsync/helpers/isThenable.d.ts

@@ -0,0 +1,2 @@
+/** Whether `value` is thenable (a promise we can await + time). */
+export declare function isThenable(value: unknown): value is PromiseLike<unknown>;