@meadown/logger 1.8.10 → 1.8.11

package/dist/cjs/core/writeLog/{formatLocation.d.ts → helpers/formatLocation.d.ts}

@@ -1,4 +1,4 @@
-import { type Caller } from "../../caller/getCaller.js";
+import { type Caller } from "../../../caller/getCaller.js";
 /**
  * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
  * supporting terminal, plain text otherwise. Pure (no stack access).

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

@@ -7,13 +7,14 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatLocation = formatLocation;
-const link_js_1 = require("../../decorations/link.js");
+const link_js_1 = require("../../../decorations/link.js");
 /**
  * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
  * 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/core/writeLog/helpers/index.d.ts

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

package/dist/cjs/core/writeLog/helpers/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+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; } });

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

@@ -8,9 +8,9 @@
 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 constants_js_1 = require("../../../constants.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

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

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.visibleLines = void 0;
 exports.getVisibleLines = getVisibleLines;
 exports.setVisibleLines = setVisibleLines;
-const constants_js_1 = require("../../constants.js");
+const constants_js_1 = require("../../../constants.js");
 /** Max message lines to show before collapsing the rest; 0 (default) shows all. */
 exports.visibleLines = constants_js_1.DEFAULT_MAX_LINES;
 /** How many lines a long message shows before collapsing (0 = all). */

package/dist/cjs/core/writeLog/index.d.ts

@@ -1,15 +1,2 @@
-import { type LogChannel } from "../../constants.js";
-import { type Caller } from "../../caller/getCaller.js";
-export { getVisibleLines, setVisibleLines } from "./visibleLines.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 declare function writeLog(opts: {
-    channel: LogChannel;
-    tag: string;
-    args: unknown[];
-    caller: Caller;
-}): void;
+export { writeLog } from "./writeLog.js";
+export { getVisibleLines, setVisibleLines } from "./helpers/index.js";

package/dist/cjs/core/writeLog/index.js

@@ -5,44 +5,10 @@
  * Copyright (c) 2026 dewan-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.setVisibleLines = exports.getVisibleLines = void 0;
-exports.writeLog = writeLog;
-const constants_js_1 = require("../../constants.js");
-const getTimeStamp_js_1 = __importDefault(require("../../time/getTimeStamp.js"));
-const color_js_1 = require("../../colors/color.js");
-const isTTY_js_1 = require("../../terminal/isTTY.js");
-const renderMessage_js_1 = require("./renderMessage.js");
-const formatLocation_js_1 = require("./formatLocation.js");
-var visibleLines_js_1 = require("./visibleLines.js");
-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; } });
-/**
- * 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 streamName = channel === "log" ? "stdout" : "stderr";
-    // One terminal check drives both color and clickable links — `isTTY` is the
-    // single source of truth (DRY). Off when output is piped/redirected.
-    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);
-    const tagOut = paint(tag, constants_js_1.TAG_COLOR[channel]);
-    const timeStamp = paint((0, getTimeStamp_js_1.default)(), "teal");
-    const locOut = paint(`(${location})`, "dimTeal");
-    const connector = paint(constants_js_1.BRANCH, "gray");
-    const connectorBottom = paint(constants_js_1.BRANCH_END, "gray");
-    const separator = paint(constants_js_1.SEPARATOR, "gray");
-    // Layout: the tag, the message hanging off a `├──` branch, then the timestamp
-    // and location on a `└──` branch below. Leading `\n` spaces entries apart.
-    const message = (0, renderMessage_js_1.renderMessage)(args, useColor);
-    const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
-    console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
-}
+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/cjs/core/writeLog/writeLog.d.ts

@@ -0,0 +1,14 @@
+import { type LogChannel } from "../../constants.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
+ * touches the stack — keeping {@link getCaller}'s frame depth correct no matter
+ * which user-facing function delegates here.
+ */
+export declare function writeLog(opts: {
+    channel: LogChannel;
+    tag: string;
+    args: unknown[];
+    caller: Caller;
+}): void;

package/dist/cjs/core/writeLog/writeLog.js

@@ -0,0 +1,43 @@
+"use strict";
+/*
+ * writeLog.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-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.writeLog = writeLog;
+const constants_js_1 = require("../../constants.js");
+const isTTY_js_1 = require("../../terminal/isTTY.js");
+const getTimeStamp_js_1 = __importDefault(require("../../time/getTimeStamp.js"));
+const color_js_1 = require("../../colors/color.js");
+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 streamName = channel === "log" ? "stdout" : "stderr";
+    // One terminal check drives both color and clickable links — `isTTY` is the
+    // single source of truth (DRY). Off when output is piped/redirected.
+    const useColor = (0, isTTY_js_1.isTTY)(streamName);
+    const paint = (s, c) => (useColor ? (0, color_js_1.colorize)(s, c) : s);
+    const location = (0, index_js_1.formatLocation)(caller, useColor);
+    const tagOut = paint(tag, constants_js_1.TAG_COLOR[channel]);
+    const timeStamp = paint((0, getTimeStamp_js_1.default)(), "teal");
+    const locOut = paint(`(${location})`, "dimTeal");
+    const connector = paint(constants_js_1.BRANCH, "gray");
+    const connectorBottom = paint(constants_js_1.BRANCH_END, "gray");
+    const separator = paint(constants_js_1.SEPARATOR, "gray");
+    // Layout: the tag, the message hanging off a `├──` branch, then the timestamp
+    // and location on a `└──` branch below. Leading `\n` spaces entries apart.
+    const message = (0, index_js_1.renderMessage)(args, useColor);
+    const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
+    console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
+}

package/dist/cjs/index.d.ts

@@ -1,32 +1,61 @@
-/** The logger: a callable for info logs, plus `.error`, `.warn`, and `.tap`. */
-export interface LogFN {
+/** Type of the logger — use this to annotate variables or parameters that accept it. */
+export interface Logger {
+    /** Log at info level — `stdout`, cyan `[INFO]` tag. */
     (...args: unknown[]): void;
+    /** Log at error level — `stderr`, red `[ERROR]` tag. */
     error(...args: unknown[]): void;
+    /** Log at warn level — `stderr`, yellow `[WARN]` tag. */
     warn(...args: unknown[]): void;
     /**
-     * Logs `value` (optionally tagged with `label`) and returns it **unchanged**,
-     * so it drops into any expression: `const u = logger.tap(getUser(), "user")`.
-     * Pass a **promise** (e.g. a `fetch`) and you get the same promise back while
-     * its elapsed time — and the HTTP status if it's a `Response` — is logged in
-     * the background. Silent in production; the value always flows through.
+     * Logs `value` with an optional `label` and gives it straight back unchanged
+     * — so you can drop it into any expression without adding an extra line.
+     *
+     * **Sync value** — logged immediately, returned as-is:
+     * ```ts
+     * const port = logger.tap(3000, "port")       // logs it, port is still 3000
+     * const user = logger.tap(getUser(), "user")  // logs the user object, returns it
+     * ```
+     *
+     * **Promise** — the same promise comes back; timing and HTTP status are logged
+     * in the background once it settles, without blocking your code:
+     * ```ts
+     * const res  = await logger.tap(fetch(url), "GET /users")  // logs status + ms
+     * const data = await logger.tap(loadConfig(), "config")    // logs value + ms
+     * ```
+     *
+     * @param value  Any value or promise — always returned as-is.
+     * @param label  Optional label shown next to the value in the log line.
      */
     tap<T>(value: T, label?: string): T;
     /**
-     * How many lines of a multi-line message to show before collapsing the rest
-     * into a `… N more lines` summary. `0` (the default) shows everything.
+     * How many lines to show before the rest collapses into a
+     * `… N more lines` summary. `0` (default) shows everything.
+     *
+     * @example
+     * logger.maxLines = 5
      */
     maxLines: number;
 }
 /**
- * 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")
+ * ```
  */
-declare const logger: LogFN;
+declare const logger: Logger;
 export { logger };
 export default logger;

package/dist/cjs/index.js

@@ -14,14 +14,24 @@ 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");
 /**
- * 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]"),

package/dist/cjs/tap/createTap.js

@@ -10,10 +10,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = createTap;
+const config_js_1 = require("../config.js");
 const getCaller_js_1 = __importDefault(require("../caller/getCaller.js"));
 const index_js_1 = require("../core/writeLog/index.js");
-const config_js_1 = require("../config.js");
-const tapAsync_js_1 = require("./tapAsync.js");
+const index_js_2 = require("./tapAsync/index.js");
 /**
  * Builds `tap` — logs a value and returns it **unchanged**, so it drops into any
  * expression (`const u = logger.tap(getUser(), "user")`). The consumer always
@@ -32,10 +32,10 @@ function createTap() {
         if (!(0, config_js_1.isLogAllowed)())
             return value;
         const caller = (0, getCaller_js_1.default)();
-        if ((0, tapAsync_js_1.isThenable)(value)) {
+        if ((0, index_js_2.isThenable)(value)) {
             // value is a promise → hand off to the async tap (caller passed in so the
             // location stays on the user's file, not on this helper).
-            (0, tapAsync_js_1.tapAsync)(value, label, caller);
+            (0, index_js_2.tapAsync)(value, label, caller);
         }
         else {
             (0, index_js_1.writeLog)({

package/dist/cjs/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/cjs/tap/tapAsync/helpers/buildBlock.js

@@ -0,0 +1,56 @@
+"use strict";
+/*
+ * buildBlock.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBlock = buildBlock;
+const node_util_1 = require("node:util");
+const format_js_1 = require("./format.js");
+const color_js_1 = require("../../../colors/color.js");
+const response_js_1 = require("./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
+ */
+function buildBlock(label, ms, res, body, useColor) {
+    const paint = (s, c) => useColor ? (0, color_js_1.colorize)(s, c) : s;
+    const pipe = paint("│", "gray");
+    const branch = paint("├──", "gray");
+    const last = paint("└──", "gray");
+    const indent = `${pipe}  `;
+    const timeLine = `${indent}${branch} time:   ${(0, format_js_1.formatDuration)(ms, useColor)}`;
+    const statusLine = `${indent}${branch} status: ${(0, response_js_1.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 = (0, node_util_1.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/cjs/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/cjs/tap/tapAsync/helpers/format.js

@@ -0,0 +1,30 @@
+"use strict";
+/*
+ * format.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDuration = formatDuration;
+exports.formatBytes = formatBytes;
+const color_js_1 = require("../../../colors/color.js");
+/** `65ms` (green) · `1.2s` (yellow) · `5.8s` (red). */
+function formatDuration(ms, useColor) {
+    const text = ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${ms}ms`;
+    if (!useColor)
+        return text;
+    if (ms >= 2000)
+        return (0, color_js_1.colorize)(text, "red");
+    if (ms >= 500)
+        return (0, color_js_1.colorize)(text, "yellow");
+    return (0, color_js_1.colorize)(text, "green");
+}
+/** `848 B` / `1.84 KB` / `2.10 MB`. */
+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/cjs/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/cjs/tap/tapAsync/helpers/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBytes = exports.formatDuration = exports.isThenable = exports.buildBlock = exports.formatStatus = exports.isResponse = exports.readBody = void 0;
+var response_js_1 = require("./response.js");
+Object.defineProperty(exports, "readBody", { enumerable: true, get: function () { return response_js_1.readBody; } });
+Object.defineProperty(exports, "isResponse", { enumerable: true, get: function () { return response_js_1.isResponse; } });
+Object.defineProperty(exports, "formatStatus", { enumerable: true, get: function () { return response_js_1.formatStatus; } });
+var buildBlock_js_1 = require("./buildBlock.js");
+Object.defineProperty(exports, "buildBlock", { enumerable: true, get: function () { return buildBlock_js_1.buildBlock; } });
+var isThenable_js_1 = require("./isThenable.js");
+Object.defineProperty(exports, "isThenable", { enumerable: true, get: function () { return isThenable_js_1.isThenable; } });
+var format_js_1 = require("./format.js");
+Object.defineProperty(exports, "formatDuration", { enumerable: true, get: function () { return format_js_1.formatDuration; } });
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return format_js_1.formatBytes; } });

package/dist/cjs/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>;

package/dist/cjs/tap/tapAsync/helpers/isThenable.js

@@ -0,0 +1,15 @@
+"use strict";
+/*
+ * isThenable.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isThenable = isThenable;
+/** Whether `value` is thenable (a promise we can await + time). */
+function isThenable(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.then === "function");
+}

package/dist/cjs/tap/tapAsync/helpers/response.d.ts

@@ -0,0 +1,21 @@
+export type ResponseLike = {
+    status: number;
+    statusText?: unknown;
+    headers?: {
+        get?: (name: string) => string | null;
+    };
+    clone: () => ResponseLike;
+    text: () => Promise<string>;
+};
+/** Whether the resolved value is a fetch `Response` we can read. */
+export declare function isResponse(value: unknown): value is ResponseLike;
+export declare function formatStatus(res: ResponseLike, useColor: boolean): string;
+/**
+ * Reads a (cloned) response body and returns both the parsed value and the
+ * actual byte size. Size is calculated from the body text — not `Content-Length`,
+ * which is absent on compressed responses — so size is always shown.
+ */
+export declare function readBody(res: ResponseLike): Promise<{
+    data: unknown;
+    size: string;
+}>;

package/dist/cjs/tap/tapAsync/helpers/response.js

@@ -0,0 +1,62 @@
+"use strict";
+/*
+ * response.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isResponse = isResponse;
+exports.formatStatus = formatStatus;
+exports.readBody = readBody;
+const format_js_1 = require("./format.js");
+const color_js_1 = require("../../../colors/color.js");
+/** Whether the resolved value is a fetch `Response` we can read. */
+function isResponse(value) {
+    const v = value;
+    return (typeof v?.status === "number" &&
+        typeof v.clone === "function" &&
+        typeof v.text === "function");
+}
+/**
+ * Status badge color:
+ * 2xx → green · 3xx → cyan · 4xx → yellow · 5xx → red
+ */
+function statusColor(status) {
+    if (status >= 500)
+        return "red";
+    if (status >= 400)
+        return "yellow";
+    if (status >= 300)
+        return "cyan";
+    return "green";
+}
+function formatStatus(res, useColor) {
+    const text = typeof res.statusText === "string" && res.statusText
+        ? `${res.status} ${res.statusText}`
+        : `${res.status}`;
+    return useColor ? (0, color_js_1.colorize)(text, statusColor(res.status)) : text;
+}
+/**
+ * Reads a (cloned) response body and returns both the parsed value and the
+ * actual byte size. Size is calculated from the body text — not `Content-Length`,
+ * which is absent on compressed responses — so size is always shown.
+ */
+async function readBody(res) {
+    try {
+        const text = await res.text();
+        const bytes = new TextEncoder().encode(text).length;
+        const size = (0, format_js_1.formatBytes)(bytes);
+        if (text === "")
+            return { data: undefined, size };
+        try {
+            return { data: JSON.parse(text), size };
+        }
+        catch {
+            return { data: text, size };
+        }
+    }
+    catch {
+        return { data: undefined, size: "unknown" };
+    }
+}

package/dist/cjs/tap/tapAsync/index.d.ts

@@ -0,0 +1,2 @@
+export { tapAsync } from "./tapAsync.js";
+export { isThenable } from "./helpers/index.js";

package/dist/cjs/tap/tapAsync/index.js

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

package/dist/{tap → cjs/tap/tapAsync}/tapAsync.d.ts

@@ -1,6 +1,4 @@
-import { type Caller } from "../caller/getCaller.js";
-/** Whether `value` is thenable (a promise we can await + time). */
-export declare function isThenable(value: unknown): value is PromiseLike<unknown>;
+import { type Caller } from "../../caller/getCaller.js";
 /**
  * The async tap. Fire-and-forget: returns `promise` immediately (unchanged),
  * and logs a rich block once it resolves. For a `Response`, reads the body from