@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/json/types.js

@@ -1,18 +1,2 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var types_exports = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/links/create.js

@@ -1,65 +1,98 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var create_exports = {};
-__export(create_exports, {
-  link: () => link,
-  links: () => links
-});
-module.exports = __toCommonJS(create_exports);
-var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-var import_array = require("../primordials/array");
-var import_context = require("../themes/context");
-var import_themes = require("../themes/themes");
-var import_resolve = require("../themes/resolve");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_array = require('../primordials/array.js');
+const require_themes_themes = require('../themes/themes.js');
+const require_themes_context = require('../themes/context.js');
+const require_themes_resolve = require('../themes/resolve.js');
+let src_external_yoctocolors_cjs = require("../external/yoctocolors-cjs");
+src_external_yoctocolors_cjs = require_runtime.__toESM(src_external_yoctocolors_cjs);
+
+//#region src/links/create.ts
+/**
+* @file Themed hyperlink utilities for terminal output. Provides colored
+*   hyperlinks using theme configuration.
+*/
+/**
+* Create a themed hyperlink for terminal output. The link text is colored using
+* the theme's link color.
+*
+* Note: Most terminals support ANSI color codes but not clickable links. This
+* function colors the text but does not create clickable hyperlinks. For
+* clickable links, use a library like 'terminal-link' separately.
+*
+* @example
+*   ;```ts
+*   import { link } from '@socketsecurity/lib/links/create'
+*
+*   // Use current theme
+*   console.log(link('Documentation', 'https://socket.dev'))
+*
+*   // Override theme
+*   console.log(
+*     link('API Docs', 'https://api.socket.dev', {
+*       theme: 'coana',
+*     }),
+*   )
+*
+*   // Show URL as fallback
+*   console.log(
+*     link('GitHub', 'https://github.com', {
+*       fallback: true,
+*     }),
+*   )
+*   // Output: "GitHub (https://github.com)"
+*   ```
+*
+* @param text - Link text to display.
+* @param url - URL (included in fallback mode)
+* @param options - Link configuration options.
+*
+* @returns Colored link text
+*/
 function link(text, url, options) {
-  const opts = { __proto__: null, fallback: false, ...options };
-  const theme = typeof opts.theme === "string" ? import_themes.THEMES[opts.theme] : opts.theme ?? (0, import_context.getTheme)();
-  const linkColor = (0, import_resolve.resolveColor)(theme.colors.link, theme.colors);
-  const colors = import_yoctocolors_cjs.default;
-  let colored;
-  if (typeof linkColor === "string" && linkColor !== "inherit") {
-    const colorMethod = colors[linkColor];
-    colored = colorMethod ? colorMethod(text) : colors.cyan(text);
-  } else if ((0, import_array.ArrayIsArray)(linkColor)) {
-    colored = colors.cyan(text);
-  } else {
-    colored = colors.cyan(text);
-  }
-  return opts.fallback ? `${colored} (${url})` : colored;
+	const opts = {
+		__proto__: null,
+		fallback: false,
+		...options
+	};
+	const theme = typeof opts.theme === "string" ? require_themes_themes.THEMES[opts.theme] : opts.theme ?? require_themes_context.getTheme();
+	const linkColor = require_themes_resolve.resolveColor(theme.colors.link, theme.colors);
+	const colors = src_external_yoctocolors_cjs.default;
+	let colored;
+	if (typeof linkColor === "string" && linkColor !== "inherit") {
+		const colorMethod = colors[linkColor];
+		colored = colorMethod ? colorMethod(text) : colors.cyan(text);
+	} else if (require_primordials_array.ArrayIsArray(linkColor)) colored = colors.cyan(text);
+	else colored = colors.cyan(text);
+	return opts.fallback ? `${colored} (${url})` : colored;
 }
+/**
+* Create multiple themed links from an array of link specifications.
+*
+* @example
+*   ;```ts
+*   import { links } from '@socketsecurity/lib/links/create'
+*
+*   const formatted = links([
+*     ['Documentation', 'https://socket.dev'],
+*     ['API Reference', 'https://api.socket.dev'],
+*     ['GitHub', 'https://github.com/SocketDev'],
+*   ])
+*
+*   formatted.forEach(link => console.log(link))
+*   ```
+*
+* @param links - Array of [text, url] pairs.
+* @param options - Link configuration options.
+*
+* @returns Array of colored link texts
+*/
 function links(linkSpecs, options) {
-  return linkSpecs.map(([text, url]) => link(text, url, options));
+	return linkSpecs.map(([text, url]) => link(text, url, options));
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  link,
-  links
-});
+
+//#endregion
+exports.link = link;
+exports.links = links;

package/dist/links/types.js

@@ -1,18 +1,2 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var types_exports = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/logger/_internal.js

@@ -1,80 +1,116 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var internal_exports = {};
-__export(internal_exports, {
-  boundConsoleEntries: () => boundConsoleEntries,
-  consolePropAttributes: () => consolePropAttributes,
-  globalConsole: () => globalConsole,
-  maxIndentation: () => maxIndentation,
-  privateConsole: () => privateConsole,
-  privateConstructorArgs: () => privateConstructorArgs
-});
-module.exports = __toCommonJS(internal_exports);
-var import_map_set = require("../primordials/map-set");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_map_set = require('../primordials/map-set.js');
+
+//#region src/logger/_internal.ts
+/**
+* @file Private state shared between the `logger/node` class (which owns the
+*   public `Logger` surface) and `logger/console-init` (which mutates
+*   `Logger.prototype` to mirror `globalConsole`). The `_` prefix keeps this
+*   module out of the generated package.json `exports` map (the `dist/**\/_*`
+*   ignore pattern in `scripts/fix/generate-package-exports.mts` filters it
+*   out), so it is not part of the public surface — it exists only to give the
+*   two leaves above a common owner for the WeakMap-backed lazy-init state. Why
+*   two WeakMaps instead of `#privateField` slots:
+*
+*   - Logger adds dynamic console methods to its prototype at first use (see
+*     `console-init.ts` `ensurePrototypeInitialized`). Those dynamic methods
+*     are constructed via the `{ [key]: function () }` shorthand and CANNOT
+*     access TC39 private fields on `this`.
+*   - WeakMaps work for both the static methods on the `Logger` class body AND
+*     the dynamically-attached prototype methods. WeakMap entries are GC'd
+*     alongside the `Logger` instance.
+*   - `privateConstructorArgs` is deleted after first `Console` build so we don't
+*     pin the original args for the lifetime of the logger.
+*/
+/**
+* The global `console` reference captured at module load. Pinned to a local so
+* dynamic `console` overrides at runtime can't affect the logger's source
+* console (e.g., test rewiring of `globalThis.console`).
+*/
 const globalConsole = console;
+/**
+* Property-descriptor template used when registering dynamic console methods on
+* `Logger.prototype`. Writable + configurable so tests can override;
+* non-enumerable so the methods don't leak into `for...in` iteration on a
+* logger instance.
+*/
 const consolePropAttributes = {
-  __proto__: null,
-  writable: true,
-  enumerable: false,
-  configurable: true
+	__proto__: null,
+	writable: true,
+	enumerable: false,
+	configurable: true
 };
+/**
+* Cap on the indentation prefix length so a runaway `indent(n)` call with a
+* huge `n` can't allocate a multi-megabyte string.
+*/
 const maxIndentation = 1e3;
+/**
+* Pre-bound copies of the console methods that need their original `this` to
+* function (e.g., `console.error.bind(globalConsole)`). Mapping `[name,
+* boundFn]` so `console-init.ts` can apply them onto the per-instance Console
+* without re-binding on every call.
+*
+* Notes from the upstream Node implementation:
+*
+* - `_stderrErrorHandler` / `_stdoutErrorHandler` are `kBindProperties`
+*   properties — they live on the per-instance Console and need their `this`
+*   set to `globalConsole`.
+*   https://github.com/nodejs/node/blob/v24.0.1/lib/internal/console/constructor.js#L230-L265
+* - `group` / `groupCollapsed` / `groupEnd` are explicitly skipped because Node
+*   20 with `--frozen-intrinsics` makes `Symbol(kGroupIndent)` read-only, which
+*   the Logger's own group methods avoid by tracking indentation at the prefix
+*   layer.
+*/
 const boundConsoleEntries = [
-  // Add bound properties from console[kBindProperties](ignoreErrors, colorMode, groupIndentation).
-  // https://github.com/nodejs/node/blob/v24.0.1/lib/internal/console/constructor.js#L230-L265
-  "_stderrErrorHandler",
-  "_stdoutErrorHandler",
-  // Add methods that need to be bound to function properly.
-  "assert",
-  "clear",
-  "count",
-  "countReset",
-  "createTask",
-  "debug",
-  "dir",
-  "dirxml",
-  "error",
-  // Skip group methods because in at least Node 20 with the Node --frozen-intrinsics
-  // flag it triggers a readonly property for Symbol(kGroupIndent). Instead, we
-  // implement these methods ourselves.
-  //'group',
-  //'groupCollapsed',
-  //'groupEnd',
-  "info",
-  "log",
-  "table",
-  "time",
-  "timeEnd",
-  "timeLog",
-  "trace",
-  "warn"
+	"_stderrErrorHandler",
+	"_stdoutErrorHandler",
+	"assert",
+	"clear",
+	"count",
+	"countReset",
+	"createTask",
+	"debug",
+	"dir",
+	"dirxml",
+	"error",
+	"info",
+	"log",
+	"table",
+	"time",
+	"timeEnd",
+	"timeLog",
+	"trace",
+	"warn"
 ].filter((n) => typeof globalConsole[n] === "function").map((n) => [n, globalConsole[n].bind(globalConsole)]);
-const privateConsole = new import_map_set.WeakMapCtor();
-const privateConstructorArgs = new import_map_set.WeakMapCtor();
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  boundConsoleEntries,
-  consolePropAttributes,
-  globalConsole,
-  maxIndentation,
-  privateConsole,
-  privateConstructorArgs
-});
+/**
+* WeakMap storing the Console instance for each Logger.
+*
+* Console creation is lazy - deferred until first logging method call. This
+* allows logger to be imported during early Node.js bootstrap before stdout is
+* ready, avoiding ERR_CONSOLE_WRITABLE_STREAM errors.
+*/
+const privateConsole = new require_primordials_map_set.WeakMapCtor();
+/**
+* WeakMap storing constructor arguments for lazy Console initialization.
+*
+* WeakMap is required instead of a private field (#constructorArgs) because: 1.
+* Private fields can't be accessed from dynamically created functions 2. Logger
+* adds console methods dynamically to its prototype 3. These dynamic methods
+* need constructor args for lazy initialization 4. WeakMap allows both regular
+* methods and dynamic functions to access args.
+*
+* The args are deleted from the WeakMap after Console is created (memory
+* cleanup).
+*/
+const privateConstructorArgs = new require_primordials_map_set.WeakMapCtor();
+
+//#endregion
+exports.boundConsoleEntries = boundConsoleEntries;
+exports.consolePropAttributes = consolePropAttributes;
+exports.globalConsole = globalConsole;
+exports.maxIndentation = maxIndentation;
+exports.privateConsole = privateConsole;
+exports.privateConstructorArgs = privateConstructorArgs;

package/dist/logger/browser.js

@@ -1,58 +1,47 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/logger/browser.ts
+/**
+* @file Browser-safe `Logger` implementation — mirrors the public `success` /
+*   `fail` / `warn` / `error` / `info` / `log` surface of the Node `Logger`
+*   (see `./node`) but backed by the global `console` so it works in Chrome MV3
+*   service workers, content scripts, popups, and any other browser context
+*   without `node:process` / `node:console` / fs. Consumers should import
+*   `Logger` from `./logger` (auto-routed by the package.json `browser`
+*   condition) or `./default` for the singleton. `./browser` is the
+*   explicit-platform name; useful for tests pinning to one implementation.
+*/
+const SYM_SUCCESS = "✓";
+const SYM_FAIL = "✕";
+const SYM_WARN = "⚠";
+const SYM_INFO = "ℹ";
+var Logger = class {
+	log(message, ...args) {
+		console.log(message, ...args);
+		return this;
+	}
+	info(message, ...args) {
+		console.log(SYM_INFO, message, ...args);
+		return this;
+	}
+	warn(message, ...args) {
+		console.warn(SYM_WARN, message, ...args);
+		return this;
+	}
+	error(message, ...args) {
+		console.error(SYM_FAIL, message, ...args);
+		return this;
+	}
+	success(message, ...args) {
+		console.log(SYM_SUCCESS, message, ...args);
+		return this;
+	}
+	fail(message, ...args) {
+		return this.error(message, ...args);
+	}
 };
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var browser_exports = {};
-__export(browser_exports, {
-  Logger: () => Logger
-});
-module.exports = __toCommonJS(browser_exports);
-const SYM_SUCCESS = "\u2713";
-const SYM_FAIL = "\u2715";
-const SYM_WARN = "\u26A0";
-const SYM_INFO = "\u2139";
-class Logger {
-  log(message, ...args) {
-    console.log(message, ...args);
-    return this;
-  }
-  info(message, ...args) {
-    console.log(SYM_INFO, message, ...args);
-    return this;
-  }
-  warn(message, ...args) {
-    console.warn(SYM_WARN, message, ...args);
-    return this;
-  }
-  error(message, ...args) {
-    console.error(SYM_FAIL, message, ...args);
-    return this;
-  }
-  success(message, ...args) {
-    console.log(SYM_SUCCESS, message, ...args);
-    return this;
-  }
-  fail(message, ...args) {
-    return this.error(message, ...args);
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Logger
-});
+
+//#endregion
+exports.Logger = Logger;

package/dist/logger/colors.js

@@ -1,54 +1,36 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var colors_exports = {};
-__export(colors_exports, {
-  applyColor: () => applyColor,
-  getYoctocolors: () => getYoctocolors
-});
-module.exports = __toCommonJS(colors_exports);
-var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+let src_external_yoctocolors_cjs = require("../external/yoctocolors-cjs");
+src_external_yoctocolors_cjs = require_runtime.__toESM(src_external_yoctocolors_cjs);
+
+//#region src/logger/colors.ts
+/**
+* @file Color application helpers for `logger/*` modules. Wraps the vendored
+*   `yoctocolors-cjs` palette so the logger can accept either a named color
+*   (`'green'`) or an explicit RGB tuple (`[255, 0, 0]`); RGB tuples are
+*   emitted via the 24-bit `[38;2;...m` escape because `yoctocolors-cjs`
+*   doesn't ship an `rgb()` helper.
+*/
+/**
+* Apply a color to text using yoctocolors. Handles both named colors and RGB
+* tuples.
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function applyColor(text, color, colors) {
-  if (typeof color === "string") {
-    return colors[color](text);
-  }
-  const { 0: r, 1: g, 2: b } = color;
-  return `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+	if (typeof color === "string") return colors[color](text);
+	const { 0: r, 1: g, 2: b } = color;
+	return `\u001B[38;2;${r};${g};${b}m${text}\u001B[39m`;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Get the yoctocolors module for terminal colors.
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getYoctocolors() {
-  return import_yoctocolors_cjs.default;
+	return src_external_yoctocolors_cjs.default;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  applyColor,
-  getYoctocolors
-});
+
+//#endregion
+exports.applyColor = applyColor;
+exports.getYoctocolors = getYoctocolors;