@socketsecurity/lib 5.18.1 → 5.19.0

package/dist/json/edit.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -32,8 +33,8 @@ __export(edit_exports, {
   getEditableJsonClass: () => getEditableJsonClass
 });
 module.exports = __toCommonJS(edit_exports);
-var import_promises = require("node:timers/promises");
 var import_node_process = __toESM(require("node:process"));
+var import_promises = require("node:timers/promises");
 var import_format = require("./format");
 const identSymbol = import_format.INDENT_SYMBOL;
 const newlineSymbol = import_format.NEWLINE_SYMBOL;
@@ -43,12 +44,34 @@ let _fs;
 // @__NO_SIDE_EFFECTS__
 function getFs() {
   if (_fs === void 0) {
-    _fs = require("fs");
+    _fs = require("node:fs");
   }
   return _fs;
 }
-async function retryWrite(filepath, content, retries = 3, baseDelay = 10) {
+function parseJson(content) {
+  return JSONParse(content);
+}
+async function readFile(filepath) {
   const { promises: fsPromises } = /* @__PURE__ */ getFs();
+  const maxRetries = import_node_process.default.platform === "win32" ? 5 : 1;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fsPromises.readFile(filepath, "utf8");
+    } catch (err) {
+      const isLastAttempt = attempt === maxRetries;
+      const isEnoent = err instanceof Error && "code" in err && err.code === "ENOENT";
+      if (!isEnoent || isLastAttempt) {
+        throw err;
+      }
+      const delay = import_node_process.default.platform === "win32" ? 50 * (attempt + 1) : 20;
+      await (0, import_promises.setTimeout)(delay);
+    }
+  }
+  throw new Error("Unreachable code");
+}
+async function retryWrite(filepath, content, retries = 3, baseDelay = 10) {
+  const fs = /* @__PURE__ */ getFs();
+  const { promises: fsPromises } = fs;
   for (let attempt = 0; attempt <= retries; attempt++) {
     try {
       await fsPromises.writeFile(filepath, content);
@@ -57,15 +80,13 @@ async function retryWrite(filepath, content, retries = 3, baseDelay = 10) {
         let accessRetries = 0;
         const maxAccessRetries = 5;
         while (accessRetries < maxAccessRetries) {
-          try {
-            await fsPromises.access(filepath);
+          if (fs.existsSync(filepath)) {
             await (0, import_promises.setTimeout)(10);
             break;
-          } catch {
-            const delay = 20 * (accessRetries + 1);
-            await (0, import_promises.setTimeout)(delay);
-            accessRetries++;
           }
+          const delay = 20 * (accessRetries + 1);
+          await (0, import_promises.setTimeout)(delay);
+          accessRetries++;
         }
       }
       return;
@@ -80,27 +101,6 @@ async function retryWrite(filepath, content, retries = 3, baseDelay = 10) {
     }
   }
 }
-function parseJson(content) {
-  return JSONParse(content);
-}
-async function readFile(filepath) {
-  const { promises: fsPromises } = /* @__PURE__ */ getFs();
-  const maxRetries = import_node_process.default.platform === "win32" ? 5 : 1;
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
-    try {
-      return await fsPromises.readFile(filepath, "utf8");
-    } catch (err) {
-      const isLastAttempt = attempt === maxRetries;
-      const isEnoent = err instanceof Error && "code" in err && err.code === "ENOENT";
-      if (!isEnoent || isLastAttempt) {
-        throw err;
-      }
-      const delay = import_node_process.default.platform === "win32" ? 50 * (attempt + 1) : 20;
-      await (0, import_promises.setTimeout)(delay);
-    }
-  }
-  throw new Error("Unreachable code");
-}
 // @__NO_SIDE_EFFECTS__
 function getEditableJsonClass() {
   if (_EditableJsonClass === void 0) {

package/dist/json/format.d.ts

@@ -19,9 +19,9 @@ export interface JsonFormatting {
  * Options for determining if a save should occur.
  */
 export interface ShouldSaveOptions {
-    ignoreWhitespace?: boolean;
-    sort?: boolean;
-    sortFn?: (obj: Record<string, unknown>) => Record<string, unknown>;
+    ignoreWhitespace?: boolean | undefined;
+    sort?: boolean | undefined;
+    sortFn?: ((obj: Record<string, unknown>) => Record<string, unknown>) | undefined;
 }
 /**
  * Detect indentation from a JSON string.
@@ -77,6 +77,39 @@ export declare function extractFormatting(json: string): JsonFormatting;
  * ```
  */
 export declare function getDefaultFormatting(): JsonFormatting;
+/**
+ * Extract formatting from content object that has symbol-based metadata.
+ *
+ * @param content - Content object with Symbol.for('indent') and Symbol.for('newline')
+ * @returns Formatting metadata, or defaults if symbols not present
+ *
+ * @example
+ * ```typescript
+ * const content = { [Symbol.for("indent")]: 4, [Symbol.for("newline")]: "\r\n" }
+ * getFormattingFromContent(content)  // { indent: 4, newline: "\r\n" }
+ * ```
+ */
+export declare function getFormattingFromContent(content: Record<string | symbol, unknown>): JsonFormatting;
+/**
+ * Determine if content should be saved based on changes and options.
+ * Compares current content with original content and respects options like
+ * ignoreWhitespace and sort.
+ *
+ * @param currentContent - Current content object (may include formatting symbols)
+ * @param originalContent - Original content for comparison (may include formatting symbols)
+ * @param originalFileContent - Original file content as string (for whitespace comparison)
+ * @param options - Options controlling save behavior
+ * @returns true if content should be saved, false otherwise
+ *
+ * @example
+ * ```ts
+ * const current = { key: 'new-value', [Symbol.for('indent')]: 2 }
+ * const original = { key: 'old-value', [Symbol.for('indent')]: 2 }
+ * shouldSave(current, original, '{\n  "key": "old-value"\n}\n')
+ * // => true
+ * ```
+ */
+export declare function shouldSave(currentContent: Record<string | symbol, unknown>, originalContent: Record<string | symbol, unknown> | undefined, originalFileContent: string, options?: ShouldSaveOptions): boolean;
 /**
  * Sort object keys alphabetically.
  * Creates a new object with sorted keys (does not mutate input).
@@ -123,36 +156,3 @@ export declare function stringifyWithFormatting(content: Record<string, unknown>
  * ```
  */
 export declare function stripFormattingSymbols(content: Record<string | symbol, unknown>): Record<string, unknown>;
-/**
- * Extract formatting from content object that has symbol-based metadata.
- *
- * @param content - Content object with Symbol.for('indent') and Symbol.for('newline')
- * @returns Formatting metadata, or defaults if symbols not present
- *
- * @example
- * ```typescript
- * const content = { [Symbol.for("indent")]: 4, [Symbol.for("newline")]: "\r\n" }
- * getFormattingFromContent(content)  // { indent: 4, newline: "\r\n" }
- * ```
- */
-export declare function getFormattingFromContent(content: Record<string | symbol, unknown>): JsonFormatting;
-/**
- * Determine if content should be saved based on changes and options.
- * Compares current content with original content and respects options like
- * ignoreWhitespace and sort.
- *
- * @param currentContent - Current content object (may include formatting symbols)
- * @param originalContent - Original content for comparison (may include formatting symbols)
- * @param originalFileContent - Original file content as string (for whitespace comparison)
- * @param options - Options controlling save behavior
- * @returns true if content should be saved, false otherwise
- *
- * @example
- * ```ts
- * const current = { key: 'new-value', [Symbol.for('indent')]: 2 }
- * const original = { key: 'old-value', [Symbol.for('indent')]: 2 }
- * shouldSave(current, original, '{\n  "key": "old-value"\n}\n')
- * // => true
- * ```
- */
-export declare function shouldSave(currentContent: Record<string | symbol, unknown>, originalContent: Record<string | symbol, unknown> | undefined, originalFileContent: string, options?: ShouldSaveOptions): boolean;

package/dist/json/format.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -61,6 +62,27 @@ function getDefaultFormatting() {
     newline: "\n"
   };
 }
+function getFormattingFromContent(content) {
+  const indent = content[INDENT_SYMBOL];
+  const newline = content[NEWLINE_SYMBOL];
+  return {
+    indent: indent === void 0 || indent === null ? 2 : indent,
+    newline: newline === void 0 || newline === null ? "\n" : newline
+  };
+}
+function shouldSave(currentContent, originalContent, originalFileContent, options = {}) {
+  const { ignoreWhitespace = false, sort = false, sortFn } = options;
+  const content = stripFormattingSymbols(currentContent);
+  const sortedContent = sortFn ? sortFn(content) : sort ? sortKeys(content) : content;
+  const origContent = originalContent ? stripFormattingSymbols(originalContent) : {};
+  if (ignoreWhitespace) {
+    const util = require("node:util");
+    return !util.isDeepStrictEqual(sortedContent, origContent);
+  }
+  const formatting = getFormattingFromContent(currentContent);
+  const newFileContent = stringifyWithFormatting(sortedContent, formatting);
+  return newFileContent.trim() !== originalFileContent.trim();
+}
 function sortKeys(obj) {
   const sorted = { __proto__: null };
   const keys = Object.keys(obj).sort();
@@ -84,27 +106,6 @@ function stripFormattingSymbols(content) {
   } = content;
   return rest;
 }
-function getFormattingFromContent(content) {
-  const indent = content[INDENT_SYMBOL];
-  const newline = content[NEWLINE_SYMBOL];
-  return {
-    indent: indent === void 0 || indent === null ? 2 : indent,
-    newline: newline === void 0 || newline === null ? "\n" : newline
-  };
-}
-function shouldSave(currentContent, originalContent, originalFileContent, options = {}) {
-  const { ignoreWhitespace = false, sort = false, sortFn } = options;
-  const content = stripFormattingSymbols(currentContent);
-  const sortedContent = sortFn ? sortFn(content) : sort ? sortKeys(content) : content;
-  const origContent = originalContent ? stripFormattingSymbols(originalContent) : {};
-  if (ignoreWhitespace) {
-    const util = require("util");
-    return !util.isDeepStrictEqual(sortedContent, origContent);
-  }
-  const formatting = getFormattingFromContent(currentContent);
-  const newFileContent = stringifyWithFormatting(sortedContent, formatting);
-  return newFileContent.trim() !== originalFileContent.trim();
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   INDENT_SYMBOL,

package/dist/json/parse.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview JSON parsing utilities with Buffer detection and BOM stripping.
+ * Provides safe JSON parsing with automatic encoding handling.
+ */
 import type { JsonParseOptions, JsonPrimitive, JsonValue } from './types';
 /**
  * Check if a value is a JSON primitive type.
@@ -17,7 +21,6 @@ import type { JsonParseOptions, JsonPrimitive, JsonValue } from './types';
  * isJsonPrimitive(undefined) // => false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function isJsonPrimitive(value: unknown): value is JsonPrimitive;
 /**
  * Parse JSON content with automatic Buffer handling and BOM stripping.
@@ -72,5 +75,4 @@ export declare function isJsonPrimitive(value: unknown): value is JsonPrimitive;
  * console.log(data.created instanceof Date) // => true
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function jsonParse(content: string | Buffer, options?: JsonParseOptions | undefined): JsonValue | undefined;

package/dist/json/parse.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/json/types.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;

package/dist/{links/index.d.ts → links.d.ts}

@@ -1,5 +1,9 @@
-import type { Theme } from '../themes/types';
-import type { ThemeName } from '../themes/themes';
+/**
+ * @fileoverview Themed hyperlink utilities for terminal output.
+ * Provides colored hyperlinks using theme configuration.
+ */
+import type { ThemeName } from './themes/themes';
+import type { Theme } from './themes/types';
 /**
  * Options for creating themed links.
  */

package/dist/{links/index.js → links.js}

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -33,10 +34,10 @@ __export(links_exports, {
   links: () => links
 });
 module.exports = __toCommonJS(links_exports);
-var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-var import_context = require("../themes/context");
-var import_themes = require("../themes/themes");
-var import_utils = require("../themes/utils");
+var import_yoctocolors_cjs = __toESM(require("./external/yoctocolors-cjs"));
+var import_context = require("./themes/context");
+var import_themes = require("./themes/themes");
+var import_utils = require("./themes/utils");
 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)();

package/dist/logger.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Console logging utilities with line prefix support.
+ * Provides enhanced console methods with formatted output capabilities.
+ */
 /**
  * Log symbols for terminal output with colored indicators.
  *
@@ -161,7 +165,6 @@ export declare const lastWasBlankSymbol: unique symbol;
  * })
  * ```
  */
-/*@__PURE__*/
 export declare class Logger {
     #private;
     /**
@@ -564,8 +567,6 @@ export declare class Logger {
      * logger.groupEnd()
      * ```
      */
-    // groupCollapsed is an alias of group.
-    // https://nodejs.org/api/console.html#consolegroupcollapsed
     groupCollapsed(...label: unknown[]): this;
     /**
      * Ends the current log group and decreases indentation.
@@ -990,6 +991,3 @@ export declare class Logger {
  * ```
  */
 export declare function getDefaultLogger(): Logger;
-// REMOVED: Deprecated `logger` export
-// Migration: Use getDefaultLogger() instead
-// See: getDefaultLogger() function above

package/dist/logger.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -46,30 +47,10 @@ const globalConsole = console;
 const ReflectApply = Reflect.apply;
 const ReflectConstruct = Reflect.construct;
 let _Console;
-// @__NO_SIDE_EFFECTS__
-function constructConsole(...args) {
-  if (_Console === void 0) {
-    const nodeConsole = require("console");
-    _Console = nodeConsole.Console;
-  }
-  return ReflectConstruct(
-    _Console,
-    // eslint-disable-line no-undef
-    args
-  );
-}
-// @__NO_SIDE_EFFECTS__
-function getYoctocolors() {
-  return import_yoctocolors_cjs.default;
-}
-// @__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`;
-}
+let _consoleSymbols;
+let _kGroupIndentationWidthSymbol;
+let _prototypeInitialized = false;
+let _logger;
 const LOG_SYMBOLS = /* @__PURE__ */ (() => {
   const target = {
     __proto__: null
@@ -87,16 +68,16 @@ const LOG_SYMBOLS = /* @__PURE__ */ (() => {
     const warningColor = theme.colors.warning;
     const infoColor = theme.colors.info;
     const stepColor = theme.colors.step;
-    target.fail = /* @__PURE__ */ applyColor(supported ? "\u2716" : "\xD7", errorColor, colors);
-    target.info = /* @__PURE__ */ applyColor(supported ? "\u2139" : "i", infoColor, colors);
-    target.progress = /* @__PURE__ */ applyColor(supported ? "\u2234" : ":.", stepColor, colors);
-    target.reason = colors.dim(
+    target["fail"] = /* @__PURE__ */ applyColor(supported ? "\u2716" : "\xD7", errorColor, colors);
+    target["info"] = /* @__PURE__ */ applyColor(supported ? "\u2139" : "i", infoColor, colors);
+    target["progress"] = /* @__PURE__ */ applyColor(supported ? "\u2234" : ":.", stepColor, colors);
+    target["reason"] = colors.dim(
       /* @__PURE__ */ applyColor(supported ? "\u2234" : ":.", warningColor, colors)
     );
-    target.skip = /* @__PURE__ */ applyColor(supported ? "\u21BB" : "@", stepColor, colors);
-    target.step = /* @__PURE__ */ applyColor(supported ? "\u2192" : ">", stepColor, colors);
-    target.success = /* @__PURE__ */ applyColor(supported ? "\u2714" : "\u221A", successColor, colors);
-    target.warn = /* @__PURE__ */ applyColor(supported ? "\u26A0" : "\u203C", warningColor, colors);
+    target["skip"] = /* @__PURE__ */ applyColor(supported ? "\u21BB" : "@", stepColor, colors);
+    target["step"] = /* @__PURE__ */ applyColor(supported ? "\u2192" : ">", stepColor, colors);
+    target["success"] = /* @__PURE__ */ applyColor(supported ? "\u2714" : "\u221A", successColor, colors);
+    target["warn"] = /* @__PURE__ */ applyColor(supported ? "\u26A0" : "\u203C", warningColor, colors);
   };
   const init = () => {
     if (initialized) {
@@ -168,21 +149,7 @@ const consolePropAttributes = {
 const maxIndentation = 1e3;
 const privateConsole = /* @__PURE__ */ new WeakMap();
 const privateConstructorArgs = /* @__PURE__ */ new WeakMap();
-let _consoleSymbols;
-function getConsoleSymbols() {
-  if (_consoleSymbols === void 0) {
-    _consoleSymbols = Object.getOwnPropertySymbols(globalConsole);
-  }
-  return _consoleSymbols;
-}
 const incLogCallCountSymbol = Symbol.for("logger.logCallCount++");
-let _kGroupIndentationWidthSymbol;
-function getKGroupIndentationWidthSymbol() {
-  if (_kGroupIndentationWidthSymbol === void 0) {
-    _kGroupIndentationWidthSymbol = getConsoleSymbols().find((s) => s.label === "kGroupIndentWidth") ?? Symbol("kGroupIndentWidth");
-  }
-  return _kGroupIndentationWidthSymbol;
-}
 const lastWasBlankSymbol = Symbol.for("logger.lastWasBlank");
 class Logger {
   /**
@@ -236,7 +203,10 @@ class Logger {
       const themeOption = options.theme;
       if (themeOption) {
         if (typeof themeOption === "string") {
-          this.#theme = import_themes.THEMES[themeOption];
+          const resolved = import_themes.THEMES[themeOption];
+          if (resolved) {
+            this.#theme = resolved;
+          }
         } else {
           this.#theme = themeOption;
         }
@@ -438,7 +408,9 @@ class Logger {
       instance.#parent = this;
       instance.#boundStream = "stderr";
       instance.#options = { __proto__: null, ...this.#options };
-      instance.#theme = this.#theme;
+      if (this.#theme) {
+        instance.#theme = this.#theme;
+      }
       this.#stderrLogger = instance;
     }
     return this.#stderrLogger;
@@ -471,7 +443,9 @@ class Logger {
       instance.#parent = this;
       instance.#boundStream = "stdout";
       instance.#options = { __proto__: null, ...this.#options };
-      instance.#theme = this.#theme;
+      if (this.#theme) {
+        instance.#theme = this.#theme;
+      }
       this.#stdoutLogger = instance;
     }
     return this.#stdoutLogger;
@@ -584,7 +558,7 @@ class Logger {
   clearLine() {
     const con = this.#getConsole();
     const stream = this.#getTargetStream();
-    const streamObj = stream === "stderr" ? con._stderr : con._stdout;
+    const streamObj = stream === "stderr" ? con["_stderr"] : con["_stdout"];
     if (streamObj.isTTY) {
       streamObj.cursorTo(0);
       streamObj.clearLine(0);
@@ -1061,7 +1035,7 @@ class Logger {
   progress(text) {
     const con = this.#getConsole();
     const stream = this.#getTargetStream();
-    const streamObj = stream === "stderr" ? con._stderr : con._stdout;
+    const streamObj = stream === "stderr" ? con["_stderr"] : con["_stdout"];
     const symbols = this.#getSymbols();
     streamObj.write(`${symbols.progress} ${text}`);
     this[lastWasBlankSymbol](false);
@@ -1408,7 +1382,26 @@ class Logger {
     return this;
   }
 }
-let _prototypeInitialized = false;
+// @__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`;
+}
+// @__NO_SIDE_EFFECTS__
+function constructConsole(...args) {
+  if (_Console === void 0) {
+    const nodeConsole = require("node:console");
+    _Console = nodeConsole.Console;
+  }
+  return ReflectConstruct(
+    _Console,
+    // eslint-disable-line no-undef
+    args
+  );
+}
 function ensurePrototypeInitialized() {
   if (_prototypeInitialized) {
     return;
@@ -1467,7 +1460,22 @@ function ensurePrototypeInitialized() {
   }
   Object.defineProperties(Logger.prototype, Object.fromEntries(entries));
 }
-let _logger;
+function getConsoleSymbols() {
+  if (_consoleSymbols === void 0) {
+    _consoleSymbols = Object.getOwnPropertySymbols(globalConsole);
+  }
+  return _consoleSymbols;
+}
+function getKGroupIndentationWidthSymbol() {
+  if (_kGroupIndentationWidthSymbol === void 0) {
+    _kGroupIndentationWidthSymbol = getConsoleSymbols().find((s) => s.label === "kGroupIndentWidth") ?? Symbol("kGroupIndentWidth");
+  }
+  return _kGroupIndentationWidthSymbol;
+}
+// @__NO_SIDE_EFFECTS__
+function getYoctocolors() {
+  return import_yoctocolors_cjs.default;
+}
 function getDefaultLogger() {
   if (_logger === void 0) {
     _logger = new Logger();