@socketsecurity/lib 3.5.0 → 4.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "3.5.0",
+  "version": "4.0.1",
   "packageManager": "pnpm@10.22.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
@@ -111,10 +111,6 @@
       "types": "./dist/argv/parse.d.ts",
       "default": "./dist/argv/parse.js"
     },
-    "./argv/quote": {
-      "types": "./dist/argv/quote.d.ts",
-      "default": "./dist/argv/quote.js"
-    },
     "./arrays": {
       "types": "./dist/arrays.d.ts",
       "default": "./dist/arrays.js"
@@ -163,10 +159,6 @@
       "types": "./dist/constants/packages.d.ts",
       "default": "./dist/constants/packages.js"
     },
-    "./constants/paths": {
-      "types": "./dist/constants/paths.d.ts",
-      "default": "./dist/constants/paths.js"
-    },
     "./constants/platform": {
       "types": "./dist/constants/platform.d.ts",
       "default": "./dist/constants/platform.js"
@@ -439,10 +431,6 @@
       "types": "./dist/packages/operations.d.ts",
       "default": "./dist/packages/operations.js"
     },
-    "./packages/paths": {
-      "types": "./dist/packages/paths.d.ts",
-      "default": "./dist/packages/paths.js"
-    },
     "./packages/provenance": {
       "types": "./dist/packages/provenance.d.ts",
       "default": "./dist/packages/provenance.js"
@@ -455,18 +443,38 @@
       "types": "./dist/packages/validation.d.ts",
       "default": "./dist/packages/validation.js"
     },
-    "./path": {
-      "types": "./dist/path.d.ts",
-      "default": "./dist/path.js"
+    "./paths/dirnames": {
+      "types": "./dist/paths/dirnames.d.ts",
+      "default": "./dist/paths/dirnames.js"
+    },
+    "./paths/exts": {
+      "types": "./dist/paths/exts.d.ts",
+      "default": "./dist/paths/exts.js"
+    },
+    "./paths/filenames": {
+      "types": "./dist/paths/filenames.d.ts",
+      "default": "./dist/paths/filenames.js"
     },
-    "./paths": {
-      "types": "./dist/paths.d.ts",
-      "default": "./dist/paths.js"
+    "./paths/globs": {
+      "types": "./dist/paths/globs.d.ts",
+      "default": "./dist/paths/globs.js"
+    },
+    "./paths/normalize": {
+      "types": "./dist/paths/normalize.d.ts",
+      "default": "./dist/paths/normalize.js"
+    },
+    "./paths/packages": {
+      "types": "./dist/paths/packages.d.ts",
+      "default": "./dist/paths/packages.js"
     },
     "./paths/rewire": {
       "types": "./dist/paths/rewire.d.ts",
       "default": "./dist/paths/rewire.js"
     },
+    "./paths/socket": {
+      "types": "./dist/paths/socket.d.ts",
+      "default": "./dist/paths/socket.js"
+    },
     "./performance": {
       "types": "./dist/performance.d.ts",
       "default": "./dist/performance.js"
@@ -638,15 +646,6 @@
     "./tsconfig.json": "./tsconfig.json",
     "./tsconfig.test.json": "./tsconfig.test.json"
   },
-  "imports": {
-    "#constants/*": "./dist/constants/*.js",
-    "#env/*": "./dist/env/*.js",
-    "#lib/*": "./dist/*.js",
-    "#packages/*": "./dist/packages/*.js",
-    "#socketsecurity/lib/*": "@socketsecurity/lib-stable/*",
-    "#types": "./dist/types.js",
-    "#utils/*": "./dist/utils/*.js"
-  },
   "files": [
     "dist",
     "data/extensions.json",
@@ -691,7 +690,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@3.4.0",
+    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@4.0.0",
     "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250920.1",
     "@vitest/coverage-v8": "4.0.3",

package/dist/argv/quote.d.ts

@@ -1,49 +0,0 @@
-/**
- * Argument quoting utilities for shell execution with spawn()
- *
- * These functions handle quoting of command-line arguments when using
- * child_process.spawn() with shell: true.
- *
- * IMPORTANT: Only needed when shell: true. With shell: false, arguments
- * are passed directly to the OS kernel as an array (no quoting needed).
- */
-/**
- * Quote an argument for POSIX shell execution (bash, sh, zsh).
- *
- * Uses single quotes (POSIX standard) which prevent all expansions except
- * single quotes themselves. Internal single quotes are escaped using '\''
- *
- * @param arg - Argument to quote
- * @returns Quoted argument safe for POSIX shells when using shell: true
- *
- * @example
- * ```ts
- * import { posixQuote } from '@socketsecurity/lib/argv/quote'
- *
- * // With shell: true on Unix
- * const path = '/path/with spaces/file.txt'
- * spawn('sh', ['-c', 'cat', posixQuote(path)], { shell: true })
- * // sh receives: sh -c cat '/path/with spaces/file.txt'
- * ```
- */
-export declare function posixQuote(arg: string): string;
-/**
- * Quote an argument for Windows cmd.exe shell execution.
- *
- * Uses double quotes (cmd.exe standard) and escapes internal quotes by doubling.
- * Handles all cmd.exe special characters: space, &, |, <, >, ^, %, (, ), !, "
- *
- * @param arg - Argument to quote
- * @returns Quoted argument safe for cmd.exe when using shell: true
- *
- * @example
- * ```ts
- * import { win32Quote } from '@socketsecurity/lib/argv/quote'
- *
- * // With shell: true on Windows
- * const path = 'C:\\Program Files\\app.exe'
- * spawn('cmd', ['/c', 'app', win32Quote(path)], { shell: true })
- * // cmd.exe receives: cmd /c app "C:\Program Files\app.exe"
- * ```
- */
-export declare function win32Quote(arg: string): string;

package/dist/constants/paths.d.ts

@@ -1,51 +0,0 @@
-/**
- * File paths, directory names, extensions, and glob patterns.
- */
-// File names.
-export declare const PACKAGE_JSON = "package.json";
-export declare const TSCONFIG_JSON = "tsconfig.json";
-export declare const LICENSE = "LICENSE";
-export declare const LICENSE_MD = "LICENSE.md";
-export declare const LICENSE_ORIGINAL = "LICENSE.original";
-export declare const README_MD = "README.md";
-export declare const CHANGELOG_MD = "CHANGELOG.md";
-export declare const MANIFEST_JSON = "manifest.json";
-export declare const EXTENSIONS_JSON = "extensions.json";
-export declare const ESLINT_CONFIG_JS = "eslint.config.js";
-export declare const GITIGNORE = ".gitignore";
-export declare const DOT_PACKAGE_LOCK_JSON = ".package-lock.json";
-// Directory names.
-export declare const NODE_MODULES = "node_modules";
-export declare const DOT_GIT_DIR = ".git";
-export declare const DOT_GITHUB = ".github";
-export declare const DOT_SOCKET_DIR = ".socket";
-export declare const CACHE_DIR = "cache";
-export declare const CACHE_TTL_DIR = "ttl";
-// Path patterns.
-export declare const NODE_MODULES_GLOB_RECURSIVE = "**/node_modules";
-export declare const SLASH_NODE_MODULES_SLASH = "/node_modules/";
-// File extensions.
-export declare const EXT_CJS = ".cjs";
-export declare const EXT_CMD = ".cmd";
-export declare const EXT_CTS = ".cts";
-export declare const EXT_DTS = ".d.ts";
-export declare const EXT_JS = ".js";
-export declare const EXT_JSON = ".json";
-export declare const EXT_LOCK = ".lock";
-export declare const EXT_LOCKB = ".lockb";
-export declare const EXT_MD = ".md";
-export declare const EXT_MJS = ".mjs";
-export declare const EXT_MTS = ".mts";
-export declare const EXT_PS1 = ".ps1";
-export declare const EXT_YAML = ".yaml";
-export declare const EXT_YML = ".yml";
-// Glob patterns.
-export declare const LICENSE_GLOB = "LICEN[CS]E{[.-]*,}";
-export declare const LICENSE_GLOB_RECURSIVE = "**/LICEN[CS]E{[.-]*,}";
-export declare const LICENSE_ORIGINAL_GLOB = "*.original{.*,}";
-export declare const LICENSE_ORIGINAL_GLOB_RECURSIVE = "**/*.original{.*,}";
-export declare const README_GLOB = "README{.*,}";
-export declare const README_GLOB_RECURSIVE = "**/README{.*,}";
-// Miscellaneous path constants.
-export declare const EXTENSIONS = "extensions";
-export declare const ROLLUP_EXTERNAL_SUFFIX = "__rollup_external";

package/dist/constants/paths.js

@@ -1,152 +0,0 @@
-"use strict";
-/* Socket Lib - Built with esbuild */
-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 paths_exports = {};
-__export(paths_exports, {
-  CACHE_DIR: () => CACHE_DIR,
-  CACHE_TTL_DIR: () => CACHE_TTL_DIR,
-  CHANGELOG_MD: () => CHANGELOG_MD,
-  DOT_GITHUB: () => DOT_GITHUB,
-  DOT_GIT_DIR: () => DOT_GIT_DIR,
-  DOT_PACKAGE_LOCK_JSON: () => DOT_PACKAGE_LOCK_JSON,
-  DOT_SOCKET_DIR: () => DOT_SOCKET_DIR,
-  ESLINT_CONFIG_JS: () => ESLINT_CONFIG_JS,
-  EXTENSIONS: () => EXTENSIONS,
-  EXTENSIONS_JSON: () => EXTENSIONS_JSON,
-  EXT_CJS: () => EXT_CJS,
-  EXT_CMD: () => EXT_CMD,
-  EXT_CTS: () => EXT_CTS,
-  EXT_DTS: () => EXT_DTS,
-  EXT_JS: () => EXT_JS,
-  EXT_JSON: () => EXT_JSON,
-  EXT_LOCK: () => EXT_LOCK,
-  EXT_LOCKB: () => EXT_LOCKB,
-  EXT_MD: () => EXT_MD,
-  EXT_MJS: () => EXT_MJS,
-  EXT_MTS: () => EXT_MTS,
-  EXT_PS1: () => EXT_PS1,
-  EXT_YAML: () => EXT_YAML,
-  EXT_YML: () => EXT_YML,
-  GITIGNORE: () => GITIGNORE,
-  LICENSE: () => LICENSE,
-  LICENSE_GLOB: () => LICENSE_GLOB,
-  LICENSE_GLOB_RECURSIVE: () => LICENSE_GLOB_RECURSIVE,
-  LICENSE_MD: () => LICENSE_MD,
-  LICENSE_ORIGINAL: () => LICENSE_ORIGINAL,
-  LICENSE_ORIGINAL_GLOB: () => LICENSE_ORIGINAL_GLOB,
-  LICENSE_ORIGINAL_GLOB_RECURSIVE: () => LICENSE_ORIGINAL_GLOB_RECURSIVE,
-  MANIFEST_JSON: () => MANIFEST_JSON,
-  NODE_MODULES: () => NODE_MODULES,
-  NODE_MODULES_GLOB_RECURSIVE: () => NODE_MODULES_GLOB_RECURSIVE,
-  PACKAGE_JSON: () => PACKAGE_JSON,
-  README_GLOB: () => README_GLOB,
-  README_GLOB_RECURSIVE: () => README_GLOB_RECURSIVE,
-  README_MD: () => README_MD,
-  ROLLUP_EXTERNAL_SUFFIX: () => ROLLUP_EXTERNAL_SUFFIX,
-  SLASH_NODE_MODULES_SLASH: () => SLASH_NODE_MODULES_SLASH,
-  TSCONFIG_JSON: () => TSCONFIG_JSON
-});
-module.exports = __toCommonJS(paths_exports);
-const PACKAGE_JSON = "package.json";
-const TSCONFIG_JSON = "tsconfig.json";
-const LICENSE = "LICENSE";
-const LICENSE_MD = "LICENSE.md";
-const LICENSE_ORIGINAL = "LICENSE.original";
-const README_MD = "README.md";
-const CHANGELOG_MD = "CHANGELOG.md";
-const MANIFEST_JSON = "manifest.json";
-const EXTENSIONS_JSON = "extensions.json";
-const ESLINT_CONFIG_JS = "eslint.config.js";
-const GITIGNORE = ".gitignore";
-const DOT_PACKAGE_LOCK_JSON = ".package-lock.json";
-const NODE_MODULES = "node_modules";
-const DOT_GIT_DIR = ".git";
-const DOT_GITHUB = ".github";
-const DOT_SOCKET_DIR = ".socket";
-const CACHE_DIR = "cache";
-const CACHE_TTL_DIR = "ttl";
-const NODE_MODULES_GLOB_RECURSIVE = "**/node_modules";
-const SLASH_NODE_MODULES_SLASH = "/node_modules/";
-const EXT_CJS = ".cjs";
-const EXT_CMD = ".cmd";
-const EXT_CTS = ".cts";
-const EXT_DTS = ".d.ts";
-const EXT_JS = ".js";
-const EXT_JSON = ".json";
-const EXT_LOCK = ".lock";
-const EXT_LOCKB = ".lockb";
-const EXT_MD = ".md";
-const EXT_MJS = ".mjs";
-const EXT_MTS = ".mts";
-const EXT_PS1 = ".ps1";
-const EXT_YAML = ".yaml";
-const EXT_YML = ".yml";
-const LICENSE_GLOB = "LICEN[CS]E{[.-]*,}";
-const LICENSE_GLOB_RECURSIVE = "**/LICEN[CS]E{[.-]*,}";
-const LICENSE_ORIGINAL_GLOB = "*.original{.*,}";
-const LICENSE_ORIGINAL_GLOB_RECURSIVE = "**/*.original{.*,}";
-const README_GLOB = "README{.*,}";
-const README_GLOB_RECURSIVE = "**/README{.*,}";
-const EXTENSIONS = "extensions";
-const ROLLUP_EXTERNAL_SUFFIX = "__rollup_external";
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  CACHE_DIR,
-  CACHE_TTL_DIR,
-  CHANGELOG_MD,
-  DOT_GITHUB,
-  DOT_GIT_DIR,
-  DOT_PACKAGE_LOCK_JSON,
-  DOT_SOCKET_DIR,
-  ESLINT_CONFIG_JS,
-  EXTENSIONS,
-  EXTENSIONS_JSON,
-  EXT_CJS,
-  EXT_CMD,
-  EXT_CTS,
-  EXT_DTS,
-  EXT_JS,
-  EXT_JSON,
-  EXT_LOCK,
-  EXT_LOCKB,
-  EXT_MD,
-  EXT_MJS,
-  EXT_MTS,
-  EXT_PS1,
-  EXT_YAML,
-  EXT_YML,
-  GITIGNORE,
-  LICENSE,
-  LICENSE_GLOB,
-  LICENSE_GLOB_RECURSIVE,
-  LICENSE_MD,
-  LICENSE_ORIGINAL,
-  LICENSE_ORIGINAL_GLOB,
-  LICENSE_ORIGINAL_GLOB_RECURSIVE,
-  MANIFEST_JSON,
-  NODE_MODULES,
-  NODE_MODULES_GLOB_RECURSIVE,
-  PACKAGE_JSON,
-  README_GLOB,
-  README_GLOB_RECURSIVE,
-  README_MD,
-  ROLLUP_EXTERNAL_SUFFIX,
-  SLASH_NODE_MODULES_SLASH,
-  TSCONFIG_JSON
-});