@socketsecurity/lib 4.3.0 → 5.0.0

package/dist/promises.js

@@ -101,20 +101,6 @@ function normalizeRetryOptions(options) {
   };
 }
 // @__NO_SIDE_EFFECTS__
-function resolveRetryOptions(options) {
-  const defaults = {
-    __proto__: null,
-    retries: 0,
-    baseDelayMs: 200,
-    maxDelayMs: 1e4,
-    backoffFactor: 2
-  };
-  if (typeof options === "number") {
-    return { ...defaults, retries: options };
-  }
-  return options ? { ...defaults, ...options } : defaults;
-}
-// @__NO_SIDE_EFFECTS__
 async function pEach(array, callbackFn, options) {
   const iterOpts = /* @__PURE__ */ normalizeIterationOptions(options);
   const { concurrency, retries, signal } = iterOpts;
@@ -259,6 +245,20 @@ async function pRetry(callbackFn, options) {
   }
   return void 0;
 }
+// @__NO_SIDE_EFFECTS__
+function resolveRetryOptions(options) {
+  const defaults = {
+    __proto__: null,
+    retries: 0,
+    baseDelayMs: 200,
+    maxDelayMs: 1e4,
+    backoffFactor: 2
+  };
+  if (typeof options === "number") {
+    return { ...defaults, retries: options };
+  }
+  return options ? { ...defaults, ...options } : defaults;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   normalizeIterationOptions,

package/dist/sorts.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Compare semantic versions.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function compareSemver(a: string, b: string): number;
+/**
+ * Simple string comparison.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function compareStr(a: string, b: string): number;
 /**
  * Compare two strings using locale-aware comparison.
  */
@@ -15,14 +25,4 @@ type FastSortFunction = ReturnType<typeof import('fast-sort').createNewSortInsta
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function naturalSorter<T>(arrayToSort: T[]): ReturnType<FastSortFunction>;
-/**
- * Simple string comparison.
- */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function compareStr(a: string, b: string): number;
-/**
- * Compare semantic versions.
- */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function compareSemver(a: string, b: string): number;
 export {};

package/dist/sorts.js

@@ -38,6 +38,25 @@ __export(sorts_exports, {
 module.exports = __toCommonJS(sorts_exports);
 var fastSort = __toESM(require("./external/fast-sort.js"));
 var semver = __toESM(require("./external/semver.js"));
+// @__NO_SIDE_EFFECTS__
+function compareSemver(a, b) {
+  const validA = semver.valid(a);
+  const validB = semver.valid(b);
+  if (!validA && !validB) {
+    return 0;
+  }
+  if (!validA) {
+    return -1;
+  }
+  if (!validB) {
+    return 1;
+  }
+  return semver.compare(a, b);
+}
+// @__NO_SIDE_EFFECTS__
+function compareStr(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
 let _localeCompare;
 // @__NO_SIDE_EFFECTS__
 function localeCompare(x, y) {
@@ -77,25 +96,6 @@ function naturalSorter(arrayToSort) {
   }
   return _naturalSorter(arrayToSort);
 }
-// @__NO_SIDE_EFFECTS__
-function compareStr(a, b) {
-  return a < b ? -1 : a > b ? 1 : 0;
-}
-// @__NO_SIDE_EFFECTS__
-function compareSemver(a, b) {
-  const validA = semver.valid(a);
-  const validB = semver.valid(b);
-  if (!validA && !validB) {
-    return 0;
-  }
-  if (!validA) {
-    return -1;
-  }
-  if (!validB) {
-    return 1;
-  }
-  return semver.compare(a, b);
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   compareSemver,

package/dist/strings.d.ts

@@ -85,6 +85,41 @@ export declare function applyLinePrefix(str: string, options?: ApplyLinePrefixOp
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function camelToKebab(str: string): string;
+/**
+ * Center text within a given width.
+ *
+ * Adds spaces before and after the text to center it within the specified width.
+ * Distributes padding evenly on both sides. When the padding is odd, the extra
+ * space is added to the right side. Strips ANSI codes before calculating text
+ * length to ensure accurate centering of colored text.
+ *
+ * If the text is already wider than or equal to the target width, returns the
+ * original text unchanged (no truncation occurs).
+ *
+ * @param text - The text to center (may include ANSI codes)
+ * @param width - The target width in columns
+ * @returns The centered text with padding
+ *
+ * @example
+ * ```ts
+ * centerText('hello', 11)
+ * // Returns: '   hello   ' (3 spaces on each side)
+ *
+ * centerText('hi', 10)
+ * // Returns: '    hi    ' (4 spaces on each side)
+ *
+ * centerText('odd', 8)
+ * // Returns: '  odd   ' (2 left, 3 right)
+ *
+ * centerText('\x1b[31mred\x1b[0m', 7)
+ * // Returns: '  \x1b[31mred\x1b[0m  ' (ANSI codes preserved, 'red' centered)
+ *
+ * centerText('too long text', 5)
+ * // Returns: 'too long text' (no truncation, returned as-is)
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function centerText(text: string, width: number): string;
 export interface IndentStringOptions {
     /**
      * Number of spaces to indent each line.
@@ -181,6 +216,33 @@ export declare function isBlankString(value: unknown): value is BlankString;
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function isNonEmptyString(value: unknown): value is Exclude<string, EmptyString>;
+/**
+ * Repeat a string a specified number of times.
+ *
+ * Creates a new string by repeating the input string `count` times.
+ * Returns an empty string if count is 0 or negative.
+ *
+ * @param str - The string to repeat
+ * @param count - The number of times to repeat the string
+ * @returns The repeated string, or empty string if count <= 0
+ *
+ * @example
+ * ```ts
+ * repeatString('hello', 3)
+ * // Returns: 'hellohellohello'
+ *
+ * repeatString('x', 5)
+ * // Returns: 'xxxxx'
+ *
+ * repeatString('hello', 0)
+ * // Returns: ''
+ *
+ * repeatString('hello', -1)
+ * // Returns: ''
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function repeatString(str: string, count: number): string;
 export interface SearchOptions {
     /**
      * The position in the string to begin searching from.
@@ -252,6 +314,7 @@ export declare function search(str: string, regexp: RegExp, options?: SearchOpti
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function stripBom(str: string): string;
+/* c8 ignore stop */
 /**
  * Get the visual width of a string in terminal columns.
  *
@@ -403,66 +466,3 @@ export declare function toKebabCase(str: string): string;
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function trimNewlines(str: string): string;
-/**
- * Repeat a string n times.
- *
- * Creates a new string by repeating the input string the specified number of times.
- * Returns an empty string if count is zero or negative. This is a simple wrapper
- * around `String.prototype.repeat()` with guard for non-positive counts.
- *
- * @param str - The string to repeat
- * @param count - The number of times to repeat the string
- * @returns The repeated string, or empty string if count <= 0
- *
- * @example
- * ```ts
- * repeatString('hello', 3)
- * // Returns: 'hellohellohello'
- *
- * repeatString('x', 5)
- * // Returns: 'xxxxx'
- *
- * repeatString('hello', 0)
- * // Returns: ''
- *
- * repeatString('hello', -1)
- * // Returns: ''
- * ```
- */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function repeatString(str: string, count: number): string;
-/**
- * Center text within a given width.
- *
- * Adds spaces before and after the text to center it within the specified width.
- * Distributes padding evenly on both sides. When the padding is odd, the extra
- * space is added to the right side. Strips ANSI codes before calculating text
- * length to ensure accurate centering of colored text.
- *
- * If the text is already wider than or equal to the target width, returns the
- * original text unchanged (no truncation occurs).
- *
- * @param text - The text to center (may include ANSI codes)
- * @param width - The target width in columns
- * @returns The centered text with padding
- *
- * @example
- * ```ts
- * centerText('hello', 11)
- * // Returns: '   hello   ' (3 spaces on each side)
- *
- * centerText('hi', 10)
- * // Returns: '    hi    ' (4 spaces on each side)
- *
- * centerText('odd', 8)
- * // Returns: '  odd   ' (2 left, 3 right)
- *
- * centerText('\x1b[31mred\x1b[0m', 7)
- * // Returns: '  \x1b[31mred\x1b[0m  ' (ANSI codes preserved, 'red' centered)
- *
- * centerText('too long text', 5)
- * // Returns: 'too long text' (no truncation, returned as-is)
- * ```
- */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function centerText(text: string, width: number): string;

package/dist/strings.js

@@ -92,6 +92,17 @@ function camelToKebab(str) {
   return result;
 }
 // @__NO_SIDE_EFFECTS__
+function centerText(text, width) {
+  const textLength = (0, import_ansi.stripAnsi)(text).length;
+  if (textLength >= width) {
+    return text;
+  }
+  const padding = width - textLength;
+  const leftPad = Math.floor(padding / 2);
+  const rightPad = padding - leftPad;
+  return " ".repeat(leftPad) + text + " ".repeat(rightPad);
+}
+// @__NO_SIDE_EFFECTS__
 function indentString(str, options) {
   const { count = 1 } = { __proto__: null, ...options };
   return str.replace(/^(?!\s*$)/gm, " ".repeat(count));
@@ -105,6 +116,13 @@ function isNonEmptyString(value) {
   return typeof value === "string" && value.length > 0;
 }
 // @__NO_SIDE_EFFECTS__
+function repeatString(str, count) {
+  if (count <= 0) {
+    return "";
+  }
+  return str.repeat(count);
+}
+// @__NO_SIDE_EFFECTS__
 function search(str, regexp, options) {
   const { fromIndex = 0 } = { __proto__: null, ...options };
   const { length } = str;
@@ -215,24 +233,6 @@ function trimNewlines(str) {
   }
   return start === 0 && end === length ? str : str.slice(start, end);
 }
-// @__NO_SIDE_EFFECTS__
-function repeatString(str, count) {
-  if (count <= 0) {
-    return "";
-  }
-  return str.repeat(count);
-}
-// @__NO_SIDE_EFFECTS__
-function centerText(text, width) {
-  const textLength = (0, import_ansi.stripAnsi)(text).length;
-  if (textLength >= width) {
-    return text;
-  }
-  const padding = width - textLength;
-  const leftPad = Math.floor(padding / 2);
-  const rightPad = padding - leftPad;
-  return " ".repeat(leftPad) + text + " ".repeat(rightPad);
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ansiRegex,

package/dist/suppress-warnings.js

@@ -82,11 +82,15 @@ function restoreWarnings() {
   }
 }
 async function withSuppressedWarnings(warningType, callback) {
+  const wasAlreadySuppressed = suppressedWarnings.has(warningType);
   const original = process.emitWarning;
   suppressWarningType(warningType);
   try {
     return await callback();
   } finally {
+    if (!wasAlreadySuppressed) {
+      suppressedWarnings.delete(warningType);
+    }
     process.emitWarning = original;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "4.3.0",
+  "version": "5.0.0",
   "packageManager": "pnpm@10.22.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
@@ -151,10 +151,26 @@
       "types": "./dist/constants/licenses.d.ts",
       "default": "./dist/constants/licenses.js"
     },
+    "./constants/lifecycle-script-names": {
+      "types": "./dist/constants/lifecycle-script-names.d.ts",
+      "default": "./dist/constants/lifecycle-script-names.js"
+    },
+    "./constants/maintained-node-versions": {
+      "types": "./dist/constants/maintained-node-versions.d.ts",
+      "default": "./dist/constants/maintained-node-versions.js"
+    },
     "./constants/node": {
       "types": "./dist/constants/node.d.ts",
       "default": "./dist/constants/node.js"
     },
+    "./constants/package-default-node-range": {
+      "types": "./dist/constants/package-default-node-range.d.ts",
+      "default": "./dist/constants/package-default-node-range.js"
+    },
+    "./constants/package-default-socket-categories": {
+      "types": "./dist/constants/package-default-socket-categories.d.ts",
+      "default": "./dist/constants/package-default-socket-categories.js"
+    },
     "./constants/packages": {
       "types": "./dist/constants/packages.d.ts",
       "default": "./dist/constants/packages.js"
@@ -203,21 +219,33 @@
       "types": "./dist/debug.d.ts",
       "default": "./dist/debug.js"
     },
-    "./dlx": {
-      "types": "./dist/dlx.d.ts",
-      "default": "./dist/dlx.js"
+    "./dlx/binary": {
+      "types": "./dist/dlx/binary.d.ts",
+      "default": "./dist/dlx/binary.js"
+    },
+    "./dlx/cache": {
+      "types": "./dist/dlx/cache.d.ts",
+      "default": "./dist/dlx/cache.js"
+    },
+    "./dlx/dir": {
+      "types": "./dist/dlx/dir.d.ts",
+      "default": "./dist/dlx/dir.js"
     },
-    "./dlx-binary": {
-      "types": "./dist/dlx-binary.d.ts",
-      "default": "./dist/dlx-binary.js"
+    "./dlx/manifest": {
+      "types": "./dist/dlx/manifest.d.ts",
+      "default": "./dist/dlx/manifest.js"
     },
-    "./dlx-manifest": {
-      "types": "./dist/dlx-manifest.d.ts",
-      "default": "./dist/dlx-manifest.js"
+    "./dlx/package": {
+      "types": "./dist/dlx/package.d.ts",
+      "default": "./dist/dlx/package.js"
     },
-    "./dlx-package": {
-      "types": "./dist/dlx-package.d.ts",
-      "default": "./dist/dlx-package.js"
+    "./dlx/packages": {
+      "types": "./dist/dlx/packages.d.ts",
+      "default": "./dist/dlx/packages.js"
+    },
+    "./dlx/paths": {
+      "types": "./dist/dlx/paths.d.ts",
+      "default": "./dist/dlx/paths.js"
     },
     "./effects/pulse-frames": {
       "types": "./dist/effects/pulse-frames.d.ts",
@@ -355,13 +383,21 @@
       "types": "./dist/ipc.d.ts",
       "default": "./dist/ipc.js"
     },
-    "./json": {
-      "types": "./dist/json.d.ts",
-      "default": "./dist/json.js"
+    "./json/edit": {
+      "types": "./dist/json/edit.d.ts",
+      "default": "./dist/json/edit.js"
+    },
+    "./json/format": {
+      "types": "./dist/json/format.d.ts",
+      "default": "./dist/json/format.js"
+    },
+    "./json/parse": {
+      "types": "./dist/json/parse.d.ts",
+      "default": "./dist/json/parse.js"
     },
-    "./lifecycle-script-names": {
-      "types": "./dist/lifecycle-script-names.d.ts",
-      "default": "./dist/lifecycle-script-names.js"
+    "./json/types": {
+      "types": "./dist/json/types.d.ts",
+      "default": "./dist/json/types.js"
     },
     "./links": {
       "types": "./dist/links/index.d.ts",
@@ -375,10 +411,6 @@
       "types": "./dist/logger.d.ts",
       "default": "./dist/logger.js"
     },
-    "./maintained-node-versions": {
-      "types": "./dist/maintained-node-versions.d.ts",
-      "default": "./dist/maintained-node-versions.js"
-    },
     "./memoization": {
       "types": "./dist/memoization.d.ts",
       "default": "./dist/memoization.js"
@@ -387,14 +419,6 @@
       "types": "./dist/objects.d.ts",
       "default": "./dist/objects.js"
     },
-    "./package-default-node-range": {
-      "types": "./dist/package-default-node-range.d.ts",
-      "default": "./dist/package-default-node-range.js"
-    },
-    "./package-default-socket-categories": {
-      "types": "./dist/package-default-socket-categories.d.ts",
-      "default": "./dist/package-default-socket-categories.js"
-    },
     "./package-extensions": {
       "types": "./dist/package-extensions.d.ts",
       "default": "./dist/package-extensions.js"
@@ -403,9 +427,9 @@
       "types": "./dist/packages.d.ts",
       "default": "./dist/packages.js"
     },
-    "./packages/editable": {
-      "types": "./dist/packages/editable.d.ts",
-      "default": "./dist/packages/editable.js"
+    "./packages/edit": {
+      "types": "./dist/packages/edit.d.ts",
+      "default": "./dist/packages/edit.js"
     },
     "./packages/exports": {
       "types": "./dist/packages/exports.d.ts",
@@ -690,7 +714,7 @@
     "@socketregistry/is-unicode-supported": "1.0.5",
     "@socketregistry/packageurl-js": "1.3.5",
     "@socketregistry/yocto-spinner": "1.0.25",
-    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@4.1.0",
+    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@4.3.0",
     "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250920.1",
     "@vitest/coverage-v8": "4.0.3",

package/dist/dlx.d.ts

@@ -1,104 +0,0 @@
-/**
- * Generate a cache directory name using npm/npx approach.
- * Uses first 16 characters of SHA-512 hash (like npm/npx).
- *
- * Rationale for SHA-512 truncated (vs full SHA-256):
- * - Matches npm/npx ecosystem behavior
- * - Shorter paths for Windows MAX_PATH compatibility (260 chars)
- * - 16 hex chars = 64 bits = acceptable collision risk for local cache
- * - Collision probability ~1 in 18 quintillion with 1000 entries
- *
- * Input strategy (aligned with npx):
- * - npx uses package spec strings (e.g., '@scope/pkg@1.0.0', 'prettier@3.0.0')
- * - Caller provides complete spec string with version for accurate cache keying
- * - For package installs: Use PURL-style spec with version
- *   Examples: 'npm:prettier@3.0.0', 'pypi:requests@2.31.0', 'gem:rails@7.0.0'
- *   Note: Socket uses shorthand format without 'pkg:' prefix
- *   (handled by @socketregistry/packageurl-js)
- * - For binary downloads: Use URL:name for uniqueness
- *
- * Reference: npm/cli v11.6.2 libnpmexec/lib/index.js#L233-L244
- * https://github.com/npm/cli/blob/v11.6.2/workspaces/libnpmexec/lib/index.js#L233-L244
- * Implementation: packages.map().sort().join('\n') → SHA-512 → slice(0,16)
- * npx hashes the package spec (name@version), not just name
- */
-export declare function generateCacheKey(spec: string): string;
-/**
- * Clear all DLX package installations.
- */
-export declare function clearDlx(): Promise<void>;
-/**
- * Clear all DLX package installations synchronously.
- */
-export declare function clearDlxSync(): void;
-/**
- * Check if the DLX directory exists.
- */
-export declare function dlxDirExists(): boolean;
-/**
- * Check if the DLX directory exists asynchronously.
- */
-export declare function dlxDirExistsAsync(): Promise<boolean>;
-/**
- * Ensure the DLX directory exists, creating it if necessary.
- */
-export declare function ensureDlxDir(): Promise<void>;
-/**
- * Ensure the DLX directory exists synchronously, creating it if necessary.
- */
-export declare function ensureDlxDirSync(): void;
-/**
- * Get the installed package directory within DLX node_modules.
- */
-export declare function getDlxInstalledPackageDir(packageName: string): string;
-/**
- * Get the DLX installation directory for a specific package.
- */
-export declare function getDlxPackageDir(packageName: string): string;
-/**
- * Get the package.json path for a DLX installed package.
- */
-export declare function getDlxPackageJsonPath(packageName: string): string;
-/**
- * Get the node_modules directory for a DLX package installation.
- */
-export declare function getDlxPackageNodeModulesDir(packageName: string): string;
-/**
- * Check if a file path is within the Socket DLX directory.
- * This is useful for determining if a binary or file is managed by Socket's DLX system.
- *
- * @param filePath - Absolute or relative path to check
- * @returns true if the path is within ~/.socket/_dlx/, false otherwise
- *
- * @example
- * ```typescript
- * isInSocketDlx('/home/user/.socket/_dlx/abc123/bin/socket') // true
- * isInSocketDlx('/usr/local/bin/socket') // false
- * isInSocketDlx(process.argv[0]) // Check if current binary is in DLX
- * ```
- */
-export declare function isInSocketDlx(filePath: string): boolean;
-/**
- * Check if a package is installed in DLX.
- */
-export declare function isDlxPackageInstalled(packageName: string): boolean;
-/**
- * Check if a package is installed in DLX asynchronously.
- */
-export declare function isDlxPackageInstalledAsync(packageName: string): Promise<boolean>;
-/**
- * List all packages installed in DLX.
- */
-export declare function listDlxPackages(): string[];
-/**
- * List all packages installed in DLX asynchronously.
- */
-export declare function listDlxPackagesAsync(): Promise<string[]>;
-/**
- * Remove a DLX package installation.
- */
-export declare function removeDlxPackage(packageName: string): Promise<void>;
-/**
- * Remove a DLX package installation synchronously.
- */
-export declare function removeDlxPackageSync(packageName: string): void;