@meadown/logger 1.2.1 → 1.3.0

package/README.md

@@ -5,9 +5,9 @@ remember _which file_ a message came from — and worse, forgetting to pull thos
 out before shipping. So I made this.
 
 It's basically `console.log` with the rough edges sanded off: every message gets a
-level tag, a timestamp, and the file and line it came from — as a **clickable link**
-you can open straight from your terminal. And it stays quiet in production, so you
-can leave your logs where they are and not worry about them.
+**color-coded** level tag, a timestamp, and the file and line it came from — as a
+**clickable link** you can open straight from your terminal. And it stays quiet in
+production, so you can leave your logs where they are and not worry about them.
 
 No dependencies. No config. Import it and you're done.
 
@@ -39,6 +39,16 @@ Auth user logged in
 Each line is tagged by level — `[INFO]`, `[WARN]`, or `[ERROR]` — followed by the
 timestamp and the source location, with your arguments on the next line.
 
+## Color-coded levels
+
+The level tag is colored so you can spot what matters at a glance — `[INFO]` in
+cyan, `[WARN]` in yellow, `[ERROR]` in red. The timestamp and location stay plain so
+the color draws your eye straight to the level.
+
+Colors appear automatically when you're in a terminal. When output is piped to a
+file or another program, the tag prints as plain `[INFO]` text — no stray color
+codes in your log files. Nothing to configure.
+
 ## Click to open the source
 
 That `(server.ts:42)` at the end of every log isn't just text — when you're in a

package/dist/cjs/utils/color.d.ts

@@ -0,0 +1,23 @@
+/** ANSI SGR codes for the colors/styles the logger uses. */
+declare const CODES: {
+    readonly red: 31;
+    readonly yellow: 33;
+    readonly cyan: 36;
+    readonly dim: 2;
+};
+/** The named colors/styles {@link colorize} understands. */
+export type Color = keyof typeof CODES;
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+export declare function colorize(text: string, color: Color): string;
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+export declare function supportsColor(streamName: "stdout" | "stderr"): boolean;
+export {};

package/dist/cjs/utils/color.js

@@ -0,0 +1,38 @@
+"use strict";
+/*
+ * color.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colorize = colorize;
+exports.supportsColor = supportsColor;
+/** ANSI SGR codes for the colors/styles the logger uses. */
+const CODES = {
+    red: 31,
+    yellow: 33,
+    cyan: 36,
+    dim: 2,
+};
+const RESET = "\x1b[0m";
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+function colorize(text, color) {
+    return `\x1b[${CODES[color]}m${text}${RESET}`;
+}
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+function supportsColor(streamName) {
+    if (typeof process === "undefined")
+        return false;
+    const stream = streamName === "stdout" ? process.stdout : process.stderr;
+    return Boolean(stream?.isTTY);
+}

package/dist/cjs/utils/createLog.js

@@ -13,7 +13,14 @@ exports.default = createLog;
 const getCaller_js_1 = __importDefault(require("./getCaller.js"));
 const getTimeStamp_js_1 = __importDefault(require("./getTimeStamp.js"));
 const link_js_1 = require("./link.js");
+const color_js_1 = require("./color.js");
 const config_js_1 = require("../config.js");
+/** The tag color for each channel: info → cyan, warn → yellow, error → red. */
+const TAG_COLOR = {
+    log: "cyan",
+    warn: "yellow",
+    error: "red",
+};
 /**
  * Renders a caller as a `(file:line)` location. When the terminal supports
  * OSC-8 hyperlinks, the location is a clickable link to the exact source line;
@@ -41,6 +48,10 @@ function createLog(channel, tag) {
             return;
         const caller = (0, getCaller_js_1.default)();
         const location = formatLocation(caller, streamName);
-        console[channel](tag, (0, getTimeStamp_js_1.default)(), `(${location})`, `\n`, ...args, `\n`);
+        // Color only the level tag, and only on a real terminal.
+        const tagOut = (0, color_js_1.supportsColor)(streamName)
+            ? (0, color_js_1.colorize)(tag, TAG_COLOR[channel])
+            : tag;
+        console[channel](tagOut, (0, getTimeStamp_js_1.default)(), `(${location})`, `\n`, ...args, `\n`);
     };
 }

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

@@ -2,3 +2,4 @@ export { default as createLog, type LogChannel } from "./createLog.js";
 export { default as getCaller, type Caller } from "./getCaller.js";
 export { default as getTimeStamp } from "./getTimeStamp.js";
 export { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+export { colorize, supportsColor, type Color } from "./color.js";

package/dist/cjs/utils/index.js

@@ -9,7 +9,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.supportsHyperlinks = exports.hyperlink = exports.fileUrl = exports.getTimeStamp = exports.getCaller = exports.createLog = void 0;
+exports.supportsColor = exports.colorize = exports.supportsHyperlinks = exports.hyperlink = exports.fileUrl = exports.getTimeStamp = exports.getCaller = exports.createLog = void 0;
 var createLog_js_1 = require("./createLog.js");
 Object.defineProperty(exports, "createLog", { enumerable: true, get: function () { return __importDefault(createLog_js_1).default; } });
 var getCaller_js_1 = require("./getCaller.js");
@@ -20,3 +20,6 @@ var link_js_1 = require("./link.js");
 Object.defineProperty(exports, "fileUrl", { enumerable: true, get: function () { return link_js_1.fileUrl; } });
 Object.defineProperty(exports, "hyperlink", { enumerable: true, get: function () { return link_js_1.hyperlink; } });
 Object.defineProperty(exports, "supportsHyperlinks", { enumerable: true, get: function () { return link_js_1.supportsHyperlinks; } });
+var color_js_1 = require("./color.js");
+Object.defineProperty(exports, "colorize", { enumerable: true, get: function () { return color_js_1.colorize; } });
+Object.defineProperty(exports, "supportsColor", { enumerable: true, get: function () { return color_js_1.supportsColor; } });

package/dist/utils/color.d.ts

@@ -0,0 +1,24 @@
+/** ANSI SGR codes for the colors/styles the logger uses. */
+declare const CODES: {
+    readonly red: 31;
+    readonly yellow: 33;
+    readonly cyan: 36;
+    readonly dim: 2;
+};
+/** The named colors/styles {@link colorize} understands. */
+export type Color = keyof typeof CODES;
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+export declare function colorize(text: string, color: Color): string;
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+export declare function supportsColor(streamName: "stdout" | "stderr"): boolean;
+export {};
+//# sourceMappingURL=color.d.ts.map

package/dist/utils/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAOA,4DAA4D;AAC5D,QAAA,MAAM,KAAK;;;;;CAKD,CAAA;AAEV,4DAA4D;AAC5D,MAAM,MAAM,KAAK,GAAG,MAAM,OAAO,KAAK,CAAA;AAItC;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAItE"}

package/dist/utils/color.js

@@ -0,0 +1,35 @@
+/*
+ * color.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+/** ANSI SGR codes for the colors/styles the logger uses. */
+const CODES = {
+    red: 31,
+    yellow: 33,
+    cyan: 36,
+    dim: 2,
+};
+const RESET = "\x1b[0m";
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+export function colorize(text, color) {
+    return `\x1b[${CODES[color]}m${text}${RESET}`;
+}
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+export function supportsColor(streamName) {
+    if (typeof process === "undefined")
+        return false;
+    const stream = streamName === "stdout" ? process.stdout : process.stderr;
+    return Boolean(stream?.isTTY);
+}
+//# sourceMappingURL=color.js.map

package/dist/utils/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,MAAM,KAAK,GAAG;IACZ,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,CAAC;CACE,CAAA;AAKV,MAAM,KAAK,GAAG,SAAS,CAAA;AAEvB;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAY;IACjD,OAAO,QAAQ,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAA;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAA+B;IAC3D,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IAChD,MAAM,MAAM,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IACxE,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC"}

package/dist/utils/createLog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLog.d.ts","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAYA,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;AAqBjD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAQ9B"}
+{"version":3,"file":"createLog.d.ts","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAaA,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;AA4BjD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAc9B"}

package/dist/utils/createLog.js

@@ -7,7 +7,14 @@
 import getCaller from "./getCaller.js";
 import getTimeStamp from "./getTimeStamp.js";
 import { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+import { colorize, supportsColor } from "./color.js";
 import { isLogAllowed } from "../config.js";
+/** The tag color for each channel: info → cyan, warn → yellow, error → red. */
+const TAG_COLOR = {
+    log: "cyan",
+    warn: "yellow",
+    error: "red",
+};
 /**
  * Renders a caller as a `(file:line)` location. When the terminal supports
  * OSC-8 hyperlinks, the location is a clickable link to the exact source line;
@@ -35,7 +42,11 @@ export default function createLog(channel, tag) {
             return;
         const caller = getCaller();
         const location = formatLocation(caller, streamName);
-        console[channel](tag, getTimeStamp(), `(${location})`, `\n`, ...args, `\n`);
+        // Color only the level tag, and only on a real terminal.
+        const tagOut = supportsColor(streamName)
+            ? colorize(tag, TAG_COLOR[channel])
+            : tag;
+        console[channel](tagOut, getTimeStamp(), `(${location})`, `\n`, ...args, `\n`);
     };
 }
 //# sourceMappingURL=createLog.js.map

package/dist/utils/createLog.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLog.js","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAA0B,MAAM,gBAAgB,CAAA;AACvD,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAK3C;;;;;GAKG;AACH,SAAS,cAAc,CACrB,MAAc,EACd,UAA+B;IAE/B,IACE,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,kBAAkB,CAAC,UAAU,CAAC;QAE9B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACtD,OAAO,MAAM,CAAC,KAAK,CAAA;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAmB,EACnB,GAAW;IAEX,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC1D,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,CAAC,YAAY,EAAE;YAAE,OAAM;QAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QACnD,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAA;IAC7E,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"createLog.js","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAA0B,MAAM,gBAAgB,CAAA;AACvD,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAc,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAK3C,+EAA+E;AAC/E,MAAM,SAAS,GAA8B;IAC3C,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,KAAK;CACb,CAAA;AAED;;;;;GAKG;AACH,SAAS,cAAc,CACrB,MAAc,EACd,UAA+B;IAE/B,IACE,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,kBAAkB,CAAC,UAAU,CAAC;QAE9B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACtD,OAAO,MAAM,CAAC,KAAK,CAAA;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAmB,EACnB,GAAW;IAEX,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC1D,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,CAAC,YAAY,EAAE;YAAE,OAAM;QAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QAEnD,yDAAyD;QACzD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;YACtC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC,CAAC,GAAG,CAAA;QAEP,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAA;IAChF,CAAC,CAAA;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -2,4 +2,5 @@ export { default as createLog, type LogChannel } from "./createLog.js";
 export { default as getCaller, type Caller } from "./getCaller.js";
 export { default as getTimeStamp } from "./getTimeStamp.js";
 export { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+export { colorize, supportsColor, type Color } from "./color.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/dist/utils/index.js

@@ -8,4 +8,5 @@ export { default as createLog } from "./createLog.js";
 export { default as getCaller } from "./getCaller.js";
 export { default as getTimeStamp } from "./getTimeStamp.js";
 export { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+export { colorize, supportsColor } from "./color.js";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAmB,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAe,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAmB,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAe,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAc,MAAM,YAAY,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "A tiny, zero-dependency logger for Node.js and TypeScript that tags each line, timestamps it, shows the source file and line, and goes quiet in production.",
   "keywords": [
     "logger",