@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/logger/symbols-builder.js

@@ -1,61 +1,59 @@
 "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 symbols_builder_exports = {};
-__export(symbols_builder_exports, {
-  buildLoggerSymbols: () => buildLoggerSymbols,
-  stripLoggerSymbols: () => stripLoggerSymbols
-});
-module.exports = __toCommonJS(symbols_builder_exports);
-var import_is_unicode_supported = __toESM(require("../external/@socketregistry/is-unicode-supported"));
-var import_string = require("../primordials/string");
-var import_colors = require("./colors");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_string = require('../primordials/string.js');
+const require_logger_colors = require('./colors.js');
+let src_external__socketregistry_is_unicode_supported = require("../external/@socketregistry/is-unicode-supported");
+src_external__socketregistry_is_unicode_supported = require_runtime.__toESM(src_external__socketregistry_is_unicode_supported);
+
+//#region src/logger/symbols-builder.ts
+/**
+* @file Free-function helpers for per-instance log-symbol construction + symbol
+*   stripping. Extracted from `logger/node.ts` (the `Logger` class) so the
+*   class stays under the 1000-line hard cap and so other callers (alt loggers,
+*   format helpers) can reuse the same logic without instantiating a `Logger`.
+*
+*   - `buildLoggerSymbols` — theme + unicode-detection → `LogSymbols` map
+*   - `stripLoggerSymbols` — strip leading status emoji from a string
+*/
+/**
+* Build a `LogSymbols` map for the given theme.
+*
+* On unicode-supporting terminals returns the canonical icons (`✔`, `✖`, `⚠`,
+* `ℹ`, `→`, `∴`, `↻`); otherwise returns ASCII fallbacks (`√`, `×`, `‼`, `i`,
+* `>`, `:.`, `@`). Colors are pulled from the supplied theme via `applyColor`.
+*/
 function buildLoggerSymbols(theme) {
-  const supported = (0, import_is_unicode_supported.default)();
-  const colors = (0, import_colors.getYoctocolors)();
-  return {
-    __proto__: null,
-    fail: (0, import_colors.applyColor)(supported ? "\u2716" : "\xD7", theme.colors.error, colors),
-    info: (0, import_colors.applyColor)(supported ? "\u2139" : "i", theme.colors.info, colors),
-    progress: (0, import_colors.applyColor)(supported ? "\u2234" : ":.", theme.colors.step, colors),
-    skip: (0, import_colors.applyColor)(supported ? "\u21BB" : "@", theme.colors.step, colors),
-    step: (0, import_colors.applyColor)(supported ? "\u2192" : ">", theme.colors.step, colors),
-    success: (0, import_colors.applyColor)(supported ? "\u2714" : "\u221A", theme.colors.success, colors),
-    warn: (0, import_colors.applyColor)(supported ? "\u26A0" : "\u203C", theme.colors.warning, colors)
-  };
+	const supported = (0, src_external__socketregistry_is_unicode_supported.default)();
+	const colors = /* @__PURE__ */ require_logger_colors.getYoctocolors();
+	/* c8 ignore start - ASCII-fallback symbol arms only fire on
+	terminals without unicode support; tests run on unicode TTYs. */
+	return {
+		__proto__: null,
+		fail: /* @__PURE__ */ require_logger_colors.applyColor(supported ? "✖" : "×", theme.colors.error, colors),
+		info: /* @__PURE__ */ require_logger_colors.applyColor(supported ? "ℹ" : "i", theme.colors.info, colors),
+		progress: /* @__PURE__ */ require_logger_colors.applyColor(supported ? "∴" : ":.", theme.colors.step, colors),
+		skip: /* @__PURE__ */ require_logger_colors.applyColor(supported ? "↻" : "@", theme.colors.step, colors),
+		step: /* @__PURE__ */ require_logger_colors.applyColor(supported ? "→" : ">", theme.colors.step, colors),
+		success: /* @__PURE__ */ require_logger_colors.applyColor(supported ? "✔" : "√", theme.colors.success, colors),
+		warn: /* @__PURE__ */ require_logger_colors.applyColor(supported ? "⚠" : "‼", theme.colors.warning, colors)
+	};
+	/* c8 ignore stop */
 }
+/**
+* Strip leading log-status symbols (and variation selectors) from a string.
+* Matches both unicode forms (`✖`, `⚠`, `✔`, `ℹ`, `→`, `∴`, `↻`) and the
+* unambiguous ASCII fallback `:.`. Does not strip lone ASCII letters (`i`, `>`,
+* `@`) since those would mangle real words.
+*
+* Handles the trailing variation-selector U+FE0F + whitespace so a `'✔ Done'`
+* input becomes `'Done'`.
+*/
 function stripLoggerSymbols(text) {
-  return (0, import_string.StringPrototypeReplace)(text, /^(?:[✖✗×⚠‼✔✓√ℹ→∴↻]|:.)[️\s]*/u, "");
+	return require_primordials_string.StringPrototypeReplace(text, /^(?:[✖✗×⚠‼✔✓√ℹ→∴↻]|:.)[️\s]*/u, "");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildLoggerSymbols,
-  stripLoggerSymbols
-});
+
+//#endregion
+exports.buildLoggerSymbols = buildLoggerSymbols;
+exports.stripLoggerSymbols = stripLoggerSymbols;

package/dist/logger/symbols.js

@@ -1,129 +1,146 @@
 "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 symbols_exports = {};
-__export(symbols_exports, {
-  LOG_SYMBOLS: () => LOG_SYMBOLS,
-  getConsoleSymbols: () => getConsoleSymbols,
-  getKGroupIndentationWidthSymbol: () => getKGroupIndentationWidthSymbol,
-  incLogCallCountSymbol: () => incLogCallCountSymbol,
-  lastWasBlankSymbol: () => lastWasBlankSymbol
-});
-module.exports = __toCommonJS(symbols_exports);
-var import_is_unicode_supported = __toESM(require("../external/@socketregistry/is-unicode-supported"));
-var import_globals = require("../primordials/globals");
-var import_object = require("../primordials/object");
-var import_reflect = require("../primordials/reflect");
-var import_context = require("../themes/context");
-var import_colors = require("./colors");
-var import_internal = require("./_internal");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_object = require('../primordials/object.js');
+const require_primordials_reflect = require('../primordials/reflect.js');
+const require_themes_context = require('../themes/context.js');
+const require_logger__internal = require('./_internal.js');
+const require_logger_colors = require('./colors.js');
+const require_primordials_globals = require('../primordials/globals.js');
+let src_external__socketregistry_is_unicode_supported = require("../external/@socketregistry/is-unicode-supported");
+src_external__socketregistry_is_unicode_supported = require_runtime.__toESM(src_external__socketregistry_is_unicode_supported);
+
+//#region src/logger/symbols.ts
+/**
+* @file Symbol exports + the `LOG_SYMBOLS` proxy. The two `Symbol.for(...)`
+*   constants are how the spinner (and tests) reach into a `Logger` instance to
+*   bump the call counter and toggle blank-line tracking without exposing
+*   private fields. The `LOG_SYMBOLS` proxy is the public colored-symbol
+*   palette that lazily initializes on first access (so importing the logger
+*   during early Node.js bootstrap doesn't pre-resolve the theme before themes
+*   are configured) and re-renders whenever `setTheme()` fires
+*   `onThemeChange`.
+*/
 let _consoleSymbols;
 let _kGroupIndentationWidthSymbol;
+/**
+* Lazily get console symbols on first access.
+*
+* Deferred to avoid accessing global console during early Node.js bootstrap
+* before stdout is ready.
+*/
 function getConsoleSymbols() {
-  if (_consoleSymbols === void 0) {
-    _consoleSymbols = (0, import_object.ObjectGetOwnPropertySymbols)(import_internal.globalConsole);
-  }
-  return _consoleSymbols;
+	/* c8 ignore start */
+	if (_consoleSymbols === void 0) _consoleSymbols = require_primordials_object.ObjectGetOwnPropertySymbols(require_logger__internal.globalConsole);
+	/* c8 ignore stop */
+	return _consoleSymbols;
 }
+/**
+* Lazily get kGroupIndentationWidth symbol on first access.
+*/
 function getKGroupIndentationWidthSymbol() {
-  if (_kGroupIndentationWidthSymbol === void 0) {
-    _kGroupIndentationWidthSymbol = getConsoleSymbols().find((s) => s.label === "kGroupIndentWidth") ?? Symbol("kGroupIndentWidth");
-  }
-  return _kGroupIndentationWidthSymbol;
+	/* c8 ignore next - Lazy-init second-call branch; module-singleton. */
+	if (_kGroupIndentationWidthSymbol === void 0) _kGroupIndentationWidthSymbol = getConsoleSymbols().find((s) => s.label === "kGroupIndentWidth") ?? Symbol("kGroupIndentWidth");
+	return _kGroupIndentationWidthSymbol;
 }
+/**
+* Symbol for incrementing the internal log call counter.
+*
+* This is an internal symbol used to track the number of times logging methods
+* have been called on a logger instance.
+*/
 const incLogCallCountSymbol = Symbol.for("logger.logCallCount++");
+/**
+* Symbol for tracking whether the last logged line was blank.
+*
+* This is used internally to prevent multiple consecutive blank lines and to
+* determine whether to add spacing before certain messages.
+*/
 const lastWasBlankSymbol = Symbol.for("logger.lastWasBlank");
+/**
+* Log symbols for terminal output with colored indicators.
+*
+* Provides colored Unicode symbols (✖, ℹ, ∴, →, ✔, ⚠) with ASCII fallbacks (×,
+* i, :., >, √, ‼) for terminals that don't support Unicode. Symbols are colored
+* according to the active theme's color palette (error, info, reason, step,
+* success, warning).
+*
+* The symbols are lazily initialized on first access and automatically update
+* when the fallback theme changes (via setTheme()). Note that LOG_SYMBOLS
+* reflect the global fallback theme, not async-local theme contexts from
+* withTheme().
+*
+* @example
+*   ```typescript
+*   import { LOG_SYMBOLS } from '@socketsecurity/lib/logger/symbols'
+*
+*   console.log(`${LOG_SYMBOLS.fail} Build failed`) // Theme error color ✖
+*   console.log(`${LOG_SYMBOLS.info} Starting process`) // Theme info color ℹ
+*   console.log(`${LOG_SYMBOLS.progress} Working on task`) // Theme step color ∴
+*   console.log(`${LOG_SYMBOLS.step} Processing files`) // Theme step color →
+*   console.log(`${LOG_SYMBOLS.success} Build completed`) // Theme success color ✔
+*   console.log(`${LOG_SYMBOLS.warn} Deprecated API used`) // Theme warning color ⚠
+*   ```
+*/
 const LOG_SYMBOLS = /* @__PURE__ */ (() => {
-  const target = {
-    __proto__: null
-  };
-  let initialized = false;
-  const handler = {
-    __proto__: null
-  };
-  const updateSymbols = () => {
-    const supported = (0, import_is_unicode_supported.default)();
-    const colors = (0, import_colors.getYoctocolors)();
-    const theme = (0, import_context.getTheme)();
-    const successColor = theme.colors.success;
-    const errorColor = theme.colors.error;
-    const warningColor = theme.colors.warning;
-    const infoColor = theme.colors.info;
-    const stepColor = theme.colors.step;
-    target["fail"] = (0, import_colors.applyColor)(supported ? "\u2716" : "\xD7", errorColor, colors);
-    target["info"] = (0, import_colors.applyColor)(supported ? "\u2139" : "i", infoColor, colors);
-    target["progress"] = (0, import_colors.applyColor)(supported ? "\u2234" : ":.", stepColor, colors);
-    target["reason"] = colors.dim(
-      (0, import_colors.applyColor)(supported ? "\u2234" : ":.", warningColor, colors)
-    );
-    target["skip"] = (0, import_colors.applyColor)(supported ? "\u21BB" : "@", stepColor, colors);
-    target["step"] = (0, import_colors.applyColor)(supported ? "\u2192" : ">", stepColor, colors);
-    target["success"] = (0, import_colors.applyColor)(supported ? "\u2714" : "\u221A", successColor, colors);
-    target["warn"] = (0, import_colors.applyColor)(supported ? "\u26A0" : "\u203C", warningColor, colors);
-  };
-  const init = () => {
-    if (initialized) {
-      return;
-    }
-    updateSymbols();
-    initialized = true;
-    for (const trapName in handler) {
-      delete handler[trapName];
-    }
-  };
-  const reset = () => {
-    if (!initialized) {
-      return;
-    }
-    updateSymbols();
-  };
-  for (const trapName of (0, import_reflect.ReflectOwnKeys)(Reflect)) {
-    const fn = Reflect[trapName];
-    if (typeof fn === "function") {
-      ;
-      handler[trapName] = (...args) => {
-        init();
-        return fn(...args);
-      };
-    }
-  }
-  (0, import_context.onThemeChange)(() => {
-    reset();
-  });
-  return new import_globals.ProxyCtor(target, handler);
+	const target = { __proto__: null };
+	let initialized = false;
+	const handler = { __proto__: null };
+	const updateSymbols = () => {
+		const supported = (0, src_external__socketregistry_is_unicode_supported.default)();
+		const colors = /* @__PURE__ */ require_logger_colors.getYoctocolors();
+		const theme = require_themes_context.getTheme();
+		const successColor = theme.colors.success;
+		const errorColor = theme.colors.error;
+		const warningColor = theme.colors.warning;
+		const infoColor = theme.colors.info;
+		const stepColor = theme.colors.step;
+		/* c8 ignore start - ASCII-fallback symbol arms only fire on
+		terminals without unicode support; tests run on unicode TTYs. */
+		target["fail"] = /* @__PURE__ */ require_logger_colors.applyColor(supported ? "✖" : "×", errorColor, colors);
+		target["info"] = /* @__PURE__ */ require_logger_colors.applyColor(supported ? "ℹ" : "i", infoColor, colors);
+		target["progress"] = /* @__PURE__ */ require_logger_colors.applyColor(supported ? "∴" : ":.", stepColor, colors);
+		target["reason"] = colors.dim(/* @__PURE__ */ require_logger_colors.applyColor(supported ? "∴" : ":.", warningColor, colors));
+		target["skip"] = /* @__PURE__ */ require_logger_colors.applyColor(supported ? "↻" : "@", stepColor, colors);
+		target["step"] = /* @__PURE__ */ require_logger_colors.applyColor(supported ? "→" : ">", stepColor, colors);
+		target["success"] = /* @__PURE__ */ require_logger_colors.applyColor(supported ? "✔" : "√", successColor, colors);
+		target["warn"] = /* @__PURE__ */ require_logger_colors.applyColor(supported ? "⚠" : "‼", warningColor, colors);
+		/* c8 ignore stop */
+	};
+	const init = () => {
+		/* c8 ignore start */
+		if (initialized) return;
+		/* c8 ignore stop */
+		updateSymbols();
+		initialized = true;
+		for (const trapName in handler) delete handler[trapName];
+	};
+	const reset = () => {
+		/* c8 ignore start */
+		if (!initialized) return;
+		/* c8 ignore stop */
+		updateSymbols();
+	};
+	for (const trapName of require_primordials_reflect.ReflectOwnKeys(Reflect)) {
+		const fn = Reflect[trapName];
+		if (typeof fn === "function") handler[trapName] = (...args) => {
+			init();
+			return fn(...args);
+		};
+	}
+	/* c8 ignore next 4 - onThemeChange callback fires only when
+	setTheme() is called at runtime; tests use the static default
+	theme. */
+	require_themes_context.onThemeChange(() => {
+		reset();
+	});
+	return new require_primordials_globals.ProxyCtor(target, handler);
 })();
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  LOG_SYMBOLS,
-  getConsoleSymbols,
-  getKGroupIndentationWidthSymbol,
-  incLogCallCountSymbol,
-  lastWasBlankSymbol
-});
+
+//#endregion
+exports.LOG_SYMBOLS = LOG_SYMBOLS;
+exports.getConsoleSymbols = getConsoleSymbols;
+exports.getKGroupIndentationWidthSymbol = getKGroupIndentationWidthSymbol;
+exports.incLogCallCountSymbol = incLogCallCountSymbol;
+exports.lastWasBlankSymbol = lastWasBlankSymbol;

package/dist/logger/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/memo/_internal.js

@@ -1,53 +1,43 @@
 "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, {
-  cacheRegistry: () => cacheRegistry,
-  defaultKeyGen: () => defaultKeyGen
-});
-module.exports = __toCommonJS(internal_exports);
-var import_json = require("../primordials/json");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_json = require('../primordials/json.js');
+
+//#region src/memo/_internal.ts
+/**
+* @file Private internals for `memo/*` modules — the shared `cacheRegistry`
+*   (each memoize variant registers its per-instance clear function here so
+*   `clearAllMemoizationCaches` can fan out). `defaultKeyGen` is co-located
+*   because both `memoize` and `memoizeAsync` use it as the default cache-key
+*   encoder.
+*/
+/**
+* Global registry of memoization cache clear functions.
+*/
 const cacheRegistry = [];
+/**
+* Default cache key generator that disambiguates `undefined`, `BigInt`, and
+* `Map`/`Set` arguments (which `JSON.stringify` drops or collapses).
+*/
 function defaultKeyGen(args) {
-  return (0, import_json.JSONStringify)(args, (_key, value) => {
-    if (value === void 0) {
-      return "\0undefined";
-    }
-    if (typeof value === "bigint") {
-      return `\0bigint:${value.toString()}`;
-    }
-    if (typeof value === "function") {
-      return `\0fn:${value.name || "anonymous"}`;
-    }
-    if (value instanceof Map) {
-      return { __tag: "Map", entries: Array.from(value.entries()) };
-    }
-    if (value instanceof Set) {
-      return { __tag: "Set", values: Array.from(value.values()) };
-    }
-    return value;
-  });
+	return require_primordials_json.JSONStringify(args, (_key, value) => {
+		if (value === void 0) return "\0undefined";
+		if (typeof value === "bigint") return `\0bigint:${value.toString()}`;
+		if (typeof value === "function")
+ /* c8 ignore next */
+		return `\0fn:${value.name || "anonymous"}`;
+		if (value instanceof Map) return {
+			__tag: "Map",
+			entries: Array.from(value.entries())
+		};
+		if (value instanceof Set) return {
+			__tag: "Set",
+			values: Array.from(value.values())
+		};
+		return value;
+	});
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  cacheRegistry,
-  defaultKeyGen
-});
+
+//#endregion
+exports.cacheRegistry = cacheRegistry;
+exports.defaultKeyGen = defaultKeyGen;