@meadown/logger 1.1.0 → 1.2.1

package/README.md

@@ -5,8 +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
-label, a timestamp, and the file and line it came from. And it stays quiet in
-production, so you can leave your logs where they are and not worry about them.
+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.
 
@@ -22,7 +23,7 @@ npm install @meadown/logger
 import customLog from "@meadown/logger"
 
 customLog("Hello world")
-customLog("Auth", "user logged in") // first word can be a label, if you want one
+customLog("Auth", "user logged in") // every argument is printed as-is, like console.log
 
 customLog.warn("This is deprecated")
 customLog.error("Something went wrong")
@@ -31,13 +32,24 @@ customLog.error("Something went wrong")
 You'll see something like:
 
 ```text
-[INFO]  2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
-[WARN]  2026-05-30T10:00:00.000Z (server.ts:51) This is deprecated
-[ERROR] 2026-05-30T10:00:00.000Z (server.ts:60) Something went wrong
+[INFO] 2026-05-30T10:00:00.000Z (server.ts:42)
+Auth user logged in
 ```
 
-That `(server.ts:42)` bit is the part I missed most with plain `console.log` —
-no more hunting for where a message came from.
+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.
+
+## Click to open the source
+
+That `(server.ts:42)` at the end of every log isn't just text — when you're in a
+terminal, it's a **clickable link** that opens the file the log came from. No more
+hunting for where a message came from, and the line number is right there in the
+label.
+
+There's nothing to configure. Links show up automatically when output goes to a
+terminal, and when it's piped to a file or another program they quietly drop to
+plain `(server.ts:42)` text — so your log files never get cluttered with escape
+codes.
 
 ## What about production?
 

package/dist/cjs/index.d.ts

@@ -6,9 +6,8 @@ export interface LogFN {
 }
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
- * an `[INFO]` tag, an ISO timestamp, and the file and line it was called from;
- * all arguments are then printed as-is. `.error` and `.warn` behave the same
- * with their own tags and console channels.
+ * a level tag, an ISO timestamp, and a clickable link to the file and line it
+ * was called from; all arguments are then printed as-is.
  * @example
  * customLog("Auth", "user logged in")
  * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in

package/dist/cjs/index.js

@@ -8,32 +8,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.customLog = void 0;
 const index_js_1 = require("./utils/index.js");
-const config_js_1 = require("./config.js");
-/**
- * Builds a log function bound to a console channel and tag. The returned closure
- * is what the caller invokes directly, so {@link getFileName} still resolves the
- * caller's own frame (no extra stack frame is inserted). `console[channel]` is
- * looked up at call time, so reassigning `console.log` (e.g. in tests) is
- * respected. Logs only outside production — see {@link isLogAllowed}.
- */
-function createLog(channel, tag) {
-    return (...args) => {
-        if ((0, config_js_1.isLogAllowed)())
-            console[channel](tag, (0, index_js_1.getTimeStamp)(), `(${(0, index_js_1.getFileName)()})`, ...args);
-    };
-}
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
- * an `[INFO]` tag, an ISO timestamp, and the file and line it was called from;
- * all arguments are then printed as-is. `.error` and `.warn` behave the same
- * with their own tags and console channels.
+ * a level tag, an ISO timestamp, and a clickable link to the file and line it
+ * was called from; all arguments are then printed as-is.
  * @example
  * customLog("Auth", "user logged in")
  * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
  */
-const customLog = Object.assign(createLog("log", "[INFO]"), {
-    error: createLog("error", "[ERROR]"),
-    warn: createLog("warn", "[WARN]"),
+const customLog = Object.assign((0, index_js_1.createLog)("log", "[INFO]"), {
+    error: (0, index_js_1.createLog)("error", "[ERROR]"),
+    warn: (0, index_js_1.createLog)("warn", "[WARN]"),
 });
 exports.customLog = customLog;
 exports.default = customLog;

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

@@ -0,0 +1,10 @@
+/** The console channels the logger writes to. */
+export type LogChannel = "log" | "error" | "warn";
+/**
+ * Builds a log function bound to a console channel and tag. The returned closure
+ * is what the caller invokes directly, so {@link getCaller} still resolves the
+ * caller's own frame (no extra stack frame is inserted). `console[channel]` is
+ * looked up at call time, so reassigning `console.log` (e.g. in tests) is
+ * respected. Logs only outside production — see {@link isLogAllowed}.
+ */
+export default function createLog(channel: LogChannel, tag: string): (...args: unknown[]) => void;

package/dist/cjs/utils/createLog.js

@@ -0,0 +1,46 @@
+"use strict";
+/*
+ * createLog.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.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 config_js_1 = require("../config.js");
+/**
+ * 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;
+ * otherwise it's plain text. Pure (no stack access), so it can be called from a
+ * helper without disturbing {@link getCaller}'s frame depth.
+ */
+function formatLocation(caller, streamName) {
+    if (caller.file !== null &&
+        caller.line !== null &&
+        (0, link_js_1.supportsHyperlinks)(streamName))
+        return (0, link_js_1.hyperlink)(caller.label, (0, link_js_1.fileUrl)(caller.file));
+    return caller.label;
+}
+/**
+ * Builds a log function bound to a console channel and tag. The returned closure
+ * is what the caller invokes directly, so {@link getCaller} still resolves the
+ * caller's own frame (no extra stack frame is inserted). `console[channel]` is
+ * looked up at call time, so reassigning `console.log` (e.g. in tests) is
+ * respected. Logs only outside production — see {@link isLogAllowed}.
+ */
+function createLog(channel, tag) {
+    const streamName = channel === "log" ? "stdout" : "stderr";
+    return (...args) => {
+        if (!(0, config_js_1.isLogAllowed)())
+            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`);
+    };
+}

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

@@ -0,0 +1,16 @@
+/** A resolved call site. `file`/`line` are `null` when they can't be determined. */
+export interface Caller {
+    /** Short display location, e.g. `server.ts:42`, or `"unknown"`. */
+    label: string;
+    /** Absolute path (or `file://` URL) of the calling file, or `null`. */
+    file: string | null;
+    /** 1-based line number, or `null`. */
+    line: number | null;
+}
+/**
+ * Reads the call stack and returns the caller's location — both a short display
+ * label (`file:line`) and the absolute path/line needed to build a clickable
+ * link. Returns {@link UNKNOWN} when the frame isn't a resolvable source file
+ * (e.g. minified, eval, or native code).
+ */
+export default function getCaller(): Caller;

package/dist/cjs/utils/getCaller.js

@@ -0,0 +1,37 @@
+"use strict";
+/*
+ * getCaller.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getCaller;
+const UNKNOWN = { label: "unknown", file: null, line: null };
+/** Matches a source file by extension: `.js/.jsx/.ts/.tsx` and `.cjs/.mjs/.cts/.mts`. */
+const SOURCE_FILE = /\.[cm]?[jt]sx?$/;
+/**
+ * Reads the call stack and returns the caller's location — both a short display
+ * label (`file:line`) and the absolute path/line needed to build a clickable
+ * link. Returns {@link UNKNOWN} when the frame isn't a resolvable source file
+ * (e.g. minified, eval, or native code).
+ */
+function getCaller() {
+    const stack = new Error().stack ?? "";
+    const frame = stack.split("\n")[3] ?? "";
+    // V8 frames look like `at fn (/path/file.js:10:5)` or `at /path/file.js:10:5`
+    // (and `file://…` for ESM). Prefer the parenthesised location when present.
+    const parens = frame.match(/\(([^)]+)\)\s*$/);
+    const inner = (parens?.[1] ?? frame.replace(/^\s*at\s+(?:async\s+)?/, "")).trim();
+    // Split off the trailing `:line:column`, keeping the (possibly colon-bearing)
+    // path intact (e.g. Windows `C:\…` or `file://…`).
+    const match = inner.match(/^(.*):(\d+):\d+$/);
+    const file = match?.[1];
+    if (file === undefined)
+        return UNKNOWN;
+    const line = Number(match?.[2]);
+    const base = file.split(/[/\\]/).pop() ?? "";
+    if (!SOURCE_FILE.test(base))
+        return UNKNOWN;
+    return { label: `${base}:${line}`, file, line };
+}

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

@@ -1,2 +1,4 @@
-export { default as getFileName } from "./getFileName.js";
+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";

package/dist/cjs/utils/index.js

@@ -9,8 +9,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTimeStamp = exports.getFileName = void 0;
-var getFileName_js_1 = require("./getFileName.js");
-Object.defineProperty(exports, "getFileName", { enumerable: true, get: function () { return __importDefault(getFileName_js_1).default; } });
+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");
+Object.defineProperty(exports, "getCaller", { enumerable: true, get: function () { return __importDefault(getCaller_js_1).default; } });
 var getTimeStamp_js_1 = require("./getTimeStamp.js");
 Object.defineProperty(exports, "getTimeStamp", { enumerable: true, get: function () { return __importDefault(getTimeStamp_js_1).default; } });
+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; } });

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

@@ -0,0 +1,21 @@
+/**
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
+ */
+export declare function fileUrl(file: string): string;
+/**
+ * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
+ */
+export declare function hyperlink(text: string, url: string): string;
+/**
+ * Whether to emit OSC-8 hyperlinks 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, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
+ */
+export declare function supportsHyperlinks(streamName: "stdout" | "stderr"): boolean;

package/dist/cjs/utils/link.js

@@ -0,0 +1,44 @@
+"use strict";
+/*
+ * link.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileUrl = fileUrl;
+exports.hyperlink = hyperlink;
+exports.supportsHyperlinks = supportsHyperlinks;
+const node_url_1 = require("node:url");
+/**
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
+ */
+function fileUrl(file) {
+    return file.startsWith("file://") ? file : (0, node_url_1.pathToFileURL)(file).href;
+}
+/**
+ * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
+ */
+function hyperlink(text, url) {
+    const OSC = "\x1b]8;;";
+    const BEL = "\x07";
+    return `${OSC}${url}${BEL}${text}${OSC}${BEL}`;
+}
+/**
+ * Whether to emit OSC-8 hyperlinks 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, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
+ */
+function supportsHyperlinks(streamName) {
+    if (typeof process === "undefined")
+        return false;
+    const stream = streamName === "stdout" ? process.stdout : process.stderr;
+    return Boolean(stream?.isTTY);
+}

package/dist/index.d.ts

@@ -6,9 +6,8 @@ export interface LogFN {
 }
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
- * an `[INFO]` tag, an ISO timestamp, and the file and line it was called from;
- * all arguments are then printed as-is. `.error` and `.warn` behave the same
- * with their own tags and console channels.
+ * a level tag, an ISO timestamp, and a clickable link to the file and line it
+ * was called from; all arguments are then printed as-is.
  * @example
  * customLog("Auth", "user logged in")
  * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC/B;AAmBD;;;;;;;;GAQG;AACH,QAAA,MAAM,SAAS,EAAE,KAGf,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,SAAS,EAAE,KAGf,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}

package/dist/index.js

@@ -4,26 +4,11 @@
  * Copyright (c) 2026 dewan-meadown
  * All rights reserved
  */
-import { getFileName, getTimeStamp } from "./utils/index.js";
-import { isLogAllowed } from "./config.js";
-/**
- * Builds a log function bound to a console channel and tag. The returned closure
- * is what the caller invokes directly, so {@link getFileName} still resolves the
- * caller's own frame (no extra stack frame is inserted). `console[channel]` is
- * looked up at call time, so reassigning `console.log` (e.g. in tests) is
- * respected. Logs only outside production — see {@link isLogAllowed}.
- */
-function createLog(channel, tag) {
-    return (...args) => {
-        if (isLogAllowed())
-            console[channel](tag, getTimeStamp(), `(${getFileName()})`, ...args);
-    };
-}
+import { createLog } from "./utils/index.js";
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
- * an `[INFO]` tag, an ISO timestamp, and the file and line it was called from;
- * all arguments are then printed as-is. `.error` and `.warn` behave the same
- * with their own tags and console channels.
+ * a level tag, an ISO timestamp, and a clickable link to the file and line it
+ * was called from; all arguments are then printed as-is.
  * @example
  * customLog("Auth", "user logged in")
  * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAS1C;;;;;;GAMG;AACH,SAAS,SAAS,CAChB,OAAiC,EACjC,GAAW;IAEX,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,YAAY,EAAE;YAChB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,IAAI,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACxE,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAU,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;IACjE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;CAClC,CAAC,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAS5C;;;;;;;GAOG;AACH,MAAM,SAAS,GAAU,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;IACjE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;CAClC,CAAC,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}

package/dist/utils/createLog.d.ts

@@ -0,0 +1,11 @@
+/** The console channels the logger writes to. */
+export type LogChannel = "log" | "error" | "warn";
+/**
+ * Builds a log function bound to a console channel and tag. The returned closure
+ * is what the caller invokes directly, so {@link getCaller} still resolves the
+ * caller's own frame (no extra stack frame is inserted). `console[channel]` is
+ * looked up at call time, so reassigning `console.log` (e.g. in tests) is
+ * respected. Logs only outside production — see {@link isLogAllowed}.
+ */
+export default function createLog(channel: LogChannel, tag: string): (...args: unknown[]) => void;
+//# sourceMappingURL=createLog.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/createLog.js

@@ -0,0 +1,41 @@
+/*
+ * createLog.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+import getCaller from "./getCaller.js";
+import getTimeStamp from "./getTimeStamp.js";
+import { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+import { isLogAllowed } from "../config.js";
+/**
+ * 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;
+ * otherwise it's plain text. Pure (no stack access), so it can be called from a
+ * helper without disturbing {@link getCaller}'s frame depth.
+ */
+function formatLocation(caller, streamName) {
+    if (caller.file !== null &&
+        caller.line !== null &&
+        supportsHyperlinks(streamName))
+        return hyperlink(caller.label, fileUrl(caller.file));
+    return caller.label;
+}
+/**
+ * Builds a log function bound to a console channel and tag. The returned closure
+ * is what the caller invokes directly, so {@link getCaller} still resolves the
+ * caller's own frame (no extra stack frame is inserted). `console[channel]` is
+ * looked up at call time, so reassigning `console.log` (e.g. in tests) is
+ * respected. Logs only outside production — see {@link isLogAllowed}.
+ */
+export default function createLog(channel, tag) {
+    const streamName = channel === "log" ? "stdout" : "stderr";
+    return (...args) => {
+        if (!isLogAllowed())
+            return;
+        const caller = getCaller();
+        const location = formatLocation(caller, streamName);
+        console[channel](tag, getTimeStamp(), `(${location})`, `\n`, ...args, `\n`);
+    };
+}
+//# sourceMappingURL=createLog.js.map

package/dist/utils/createLog.js.map

@@ -0,0 +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"}

package/dist/utils/getCaller.d.ts

@@ -0,0 +1,17 @@
+/** A resolved call site. `file`/`line` are `null` when they can't be determined. */
+export interface Caller {
+    /** Short display location, e.g. `server.ts:42`, or `"unknown"`. */
+    label: string;
+    /** Absolute path (or `file://` URL) of the calling file, or `null`. */
+    file: string | null;
+    /** 1-based line number, or `null`. */
+    line: number | null;
+}
+/**
+ * Reads the call stack and returns the caller's location — both a short display
+ * label (`file:line`) and the absolute path/line needed to build a clickable
+ * link. Returns {@link UNKNOWN} when the frame isn't a resolvable source file
+ * (e.g. minified, eval, or native code).
+ */
+export default function getCaller(): Caller;
+//# sourceMappingURL=getCaller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCaller.d.ts","sourceRoot":"","sources":["../../src/utils/getCaller.ts"],"names":[],"mappings":"AAOA,oFAAoF;AACpF,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAOD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,IAAI,MAAM,CAsB1C"}

package/dist/utils/getCaller.js

@@ -0,0 +1,35 @@
+/*
+ * getCaller.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+const UNKNOWN = { label: "unknown", file: null, line: null };
+/** Matches a source file by extension: `.js/.jsx/.ts/.tsx` and `.cjs/.mjs/.cts/.mts`. */
+const SOURCE_FILE = /\.[cm]?[jt]sx?$/;
+/**
+ * Reads the call stack and returns the caller's location — both a short display
+ * label (`file:line`) and the absolute path/line needed to build a clickable
+ * link. Returns {@link UNKNOWN} when the frame isn't a resolvable source file
+ * (e.g. minified, eval, or native code).
+ */
+export default function getCaller() {
+    const stack = new Error().stack ?? "";
+    const frame = stack.split("\n")[3] ?? "";
+    // V8 frames look like `at fn (/path/file.js:10:5)` or `at /path/file.js:10:5`
+    // (and `file://…` for ESM). Prefer the parenthesised location when present.
+    const parens = frame.match(/\(([^)]+)\)\s*$/);
+    const inner = (parens?.[1] ?? frame.replace(/^\s*at\s+(?:async\s+)?/, "")).trim();
+    // Split off the trailing `:line:column`, keeping the (possibly colon-bearing)
+    // path intact (e.g. Windows `C:\…` or `file://…`).
+    const match = inner.match(/^(.*):(\d+):\d+$/);
+    const file = match?.[1];
+    if (file === undefined)
+        return UNKNOWN;
+    const line = Number(match?.[2]);
+    const base = file.split(/[/\\]/).pop() ?? "";
+    if (!SOURCE_FILE.test(base))
+        return UNKNOWN;
+    return { label: `${base}:${line}`, file, line };
+}
+//# sourceMappingURL=getCaller.js.map

package/dist/utils/getCaller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCaller.js","sourceRoot":"","sources":["../../src/utils/getCaller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,OAAO,GAAW,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAEpE,yFAAyF;AACzF,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAErC;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS;IAC/B,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAA;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAExC,8EAA8E;IAC9E,4EAA4E;IAC5E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,CACZ,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAC3D,CAAC,IAAI,EAAE,CAAA;IAER,8EAA8E;IAC9E,mDAAmD;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;IACvB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IAEtC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;IAC5C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IAE3C,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACjD,CAAC"}

package/dist/utils/index.d.ts

@@ -1,3 +1,5 @@
-export { default as getFileName } from "./getFileName.js";
+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";
 //# 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,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,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"}

package/dist/utils/index.js

@@ -4,6 +4,8 @@
  * Copyright (c) 2026 dewan-meadown
  * All rights reserved
  */
-export { default as getFileName } from "./getFileName.js";
+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";
 //# 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,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,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"}

package/dist/utils/link.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
+ */
+export declare function fileUrl(file: string): string;
+/**
+ * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
+ */
+export declare function hyperlink(text: string, url: string): string;
+/**
+ * Whether to emit OSC-8 hyperlinks 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, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
+ */
+export declare function supportsHyperlinks(streamName: "stdout" | "stderr"): boolean;
+//# sourceMappingURL=link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAI3E"}

package/dist/utils/link.js

@@ -0,0 +1,40 @@
+/*
+ * link.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+import { pathToFileURL } from "node:url";
+/**
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
+ */
+export function fileUrl(file) {
+    return file.startsWith("file://") ? file : pathToFileURL(file).href;
+}
+/**
+ * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
+ */
+export function hyperlink(text, url) {
+    const OSC = "\x1b]8;;";
+    const BEL = "\x07";
+    return `${OSC}${url}${BEL}${text}${OSC}${BEL}`;
+}
+/**
+ * Whether to emit OSC-8 hyperlinks 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, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
+ */
+export function supportsHyperlinks(streamName) {
+    if (typeof process === "undefined")
+        return false;
+    const stream = streamName === "stdout" ? process.stdout : process.stderr;
+    return Boolean(stream?.isTTY);
+}
+//# sourceMappingURL=link.js.map

package/dist/utils/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAW;IACjD,MAAM,GAAG,GAAG,UAAU,CAAA;IACtB,MAAM,GAAG,GAAG,MAAM,CAAA;IAClB,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,EAAE,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA+B;IAChE,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "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",

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

@@ -1,5 +0,0 @@
-/**
- * Returns the caller's source location as `file.ext:line` by reading the call
- * stack, or `"unknown"` if it can't be determined (e.g. minified or eval code).
- */
-export default function getFileName(): string;

package/dist/cjs/utils/getFileName.js

@@ -1,19 +0,0 @@
-"use strict";
-/*
- * getFileName.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = getFileName;
-/**
- * Returns the caller's source location as `file.ext:line` by reading the call
- * stack, or `"unknown"` if it can't be determined (e.g. minified or eval code).
- */
-function getFileName() {
-    const stack = new Error().stack ?? "";
-    const line = stack.split("\n")[3] ?? "";
-    const match = line.match(/([^/\\]+\.[cm]?[jt]sx?):(\d+)/);
-    return match ? match[0] : "unknown";
-}

package/dist/utils/getFileName.d.ts

@@ -1,6 +0,0 @@
-/**
- * Returns the caller's source location as `file.ext:line` by reading the call
- * stack, or `"unknown"` if it can't be determined (e.g. minified or eval code).
- */
-export default function getFileName(): string;
-//# sourceMappingURL=getFileName.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"getFileName.d.ts","sourceRoot":"","sources":["../../src/utils/getFileName.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,IAAI,MAAM,CAK5C"}

package/dist/utils/getFileName.js

@@ -1,17 +0,0 @@
-/*
- * getFileName.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-/**
- * Returns the caller's source location as `file.ext:line` by reading the call
- * stack, or `"unknown"` if it can't be determined (e.g. minified or eval code).
- */
-export default function getFileName() {
-    const stack = new Error().stack ?? "";
-    const line = stack.split("\n")[3] ?? "";
-    const match = line.match(/([^/\\]+\.[cm]?[jt]sx?):(\d+)/);
-    return match ? match[0] : "unknown";
-}
-//# sourceMappingURL=getFileName.js.map

package/dist/utils/getFileName.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getFileName.js","sourceRoot":"","sources":["../../src/utils/getFileName.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW;IACjC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAA;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;IACzD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACrC,CAAC"}