@meadown/logger 1.2.0 → 1.2.1

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 a **clickable link** to the exact 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.
 
@@ -39,21 +39,17 @@ 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.
 
-## Click to jump to the source
+## Click to open the source
 
-That `(server.ts:42)` at the end of every log isn't just text — in terminals that
-support it, it's a **clickable link** that opens the exact line that wrote the log.
-No more hunting for where a message came from.
+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.
 
-It works out of the box in editors and terminals like VS Code, iTerm2, WezTerm,
-Kitty, and Windows Terminal. Anywhere else, it quietly falls back to plain
-`(server.ts:42)` text — nothing to configure, never any garbled output.
-
-If your terminal supports links but isn't auto-detected, you can force them on:
-
-```bash
-FORCE_HYPERLINK=1 node app.js
-```
+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/utils/createLog.js

@@ -24,7 +24,7 @@ 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, caller.line));
+        return (0, link_js_1.hyperlink)(caller.label, (0, link_js_1.fileUrl)(caller.file));
     return caller.label;
 }
 /**

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

@@ -1,17 +1,21 @@
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * 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, line: number): string;
+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 simply show `text`.
+ * 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;
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * 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

@@ -11,16 +11,19 @@ exports.hyperlink = hyperlink;
 exports.supportsHyperlinks = supportsHyperlinks;
 const node_url_1 = require("node:url");
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * 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, line) {
-    const base = file.startsWith("file://") ? file : (0, node_url_1.pathToFileURL)(file).href;
-    return `${base}:${line}`;
+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 simply show `text`.
+ * 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;;";
@@ -28,36 +31,14 @@ function hyperlink(text, url) {
     return `${OSC}${url}${BEL}${text}${OSC}${BEL}`;
 }
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * 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 env = process.env;
-    const force = env.FORCE_HYPERLINK;
-    if (force !== undefined && force !== "")
-        return force !== "0" && force.toLowerCase() !== "false";
     const stream = streamName === "stdout" ? process.stdout : process.stderr;
-    if (!stream || !stream.isTTY)
-        return false;
-    if (env.TERM === "dumb")
-        return false;
-    if (env.CI !== undefined && env.CI !== "")
-        return false;
-    const program = env.TERM_PROGRAM;
-    if (program === "vscode" ||
-        program === "iTerm.app" ||
-        program === "Hyper" ||
-        program === "WezTerm")
-        return true;
-    if (env.WT_SESSION)
-        return true; // Windows Terminal
-    if (env.KITTY_WINDOW_ID)
-        return true;
-    if (env.VTE_VERSION !== undefined && Number(env.VTE_VERSION) >= 5000)
-        return true; // GNOME, etc.
-    return false;
+    return Boolean(stream?.isTTY);
 }

package/dist/utils/createLog.js

@@ -18,7 +18,7 @@ function formatLocation(caller, streamName) {
     if (caller.file !== null &&
         caller.line !== null &&
         supportsHyperlinks(streamName))
-        return hyperlink(caller.label, fileUrl(caller.file, caller.line));
+        return hyperlink(caller.label, fileUrl(caller.file));
     return caller.label;
 }
 /**

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,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACnE,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,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/link.d.ts

@@ -1,18 +1,22 @@
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * 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, line: number): string;
+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 simply show `text`.
+ * 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;
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * 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

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;GAGG;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,CA2B3E"}
+{"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

@@ -6,16 +6,19 @@
  */
 import { pathToFileURL } from "node:url";
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * 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, line) {
-    const base = file.startsWith("file://") ? file : pathToFileURL(file).href;
-    return `${base}:${line}`;
+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 simply show `text`.
+ * 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;;";
@@ -23,37 +26,15 @@ export function hyperlink(text, url) {
     return `${OSC}${url}${BEL}${text}${OSC}${BEL}`;
 }
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * 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 env = process.env;
-    const force = env.FORCE_HYPERLINK;
-    if (force !== undefined && force !== "")
-        return force !== "0" && force.toLowerCase() !== "false";
     const stream = streamName === "stdout" ? process.stdout : process.stderr;
-    if (!stream || !stream.isTTY)
-        return false;
-    if (env.TERM === "dumb")
-        return false;
-    if (env.CI !== undefined && env.CI !== "")
-        return false;
-    const program = env.TERM_PROGRAM;
-    if (program === "vscode" ||
-        program === "iTerm.app" ||
-        program === "Hyper" ||
-        program === "WezTerm")
-        return true;
-    if (env.WT_SESSION)
-        return true; // Windows Terminal
-    if (env.KITTY_WINDOW_ID)
-        return true;
-    if (env.VTE_VERSION !== undefined && Number(env.VTE_VERSION) >= 5000)
-        return true; // GNOME, etc.
-    return false;
+    return Boolean(stream?.isTTY);
 }
 //# sourceMappingURL=link.js.map

package/dist/utils/link.js.map

@@ -1 +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;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;IACzE,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;AAC1B,CAAC;AAED;;;GAGG;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,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;IAEvB,MAAM,KAAK,GAAG,GAAG,CAAC,eAAe,CAAA;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QACrC,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,CAAA;IAEzD,MAAM,MAAM,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IACxE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAC1C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IACrC,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAA;IAEvD,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAA;IAChC,IACE,OAAO,KAAK,QAAQ;QACpB,OAAO,KAAK,WAAW;QACvB,OAAO,KAAK,OAAO;QACnB,OAAO,KAAK,SAAS;QAErB,OAAO,IAAI,CAAA;IACb,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA,CAAC,mBAAmB;IACnD,IAAI,GAAG,CAAC,eAAe;QAAE,OAAO,IAAI,CAAA;IACpC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QAClE,OAAO,IAAI,CAAA,CAAC,cAAc;IAE5B,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"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.2.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",