@socketsecurity/lib 3.2.4 → 3.2.5

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.2.5](https://github.com/SocketDev/socket-lib/releases/tag/v3.2.5) - 2025-11-05
+
+### Added
+
+- **scripts**: Add path alias resolution script (`fix-path-aliases.mjs`)
+  - Resolves internal path aliases (`#lib/*`, `#constants/*`, etc.) to relative paths in built CommonJS files
+
+- **build**: Integrate path alias resolution into build pipeline
+  - Add path alias plugin to esbuild config
+  - Integrate `fix-path-aliases.mjs` into build process
+  - Ensures path aliases work correctly in compiled CommonJS output
+
 ## [3.2.4](https://github.com/SocketDev/socket-lib/releases/tag/v3.2.4) - 2025-11-04
 
 ### Added

package/README.md

@@ -2,6 +2,9 @@
 
 [![Socket Badge](https://socket.dev/api/badge/npm/package/@socketsecurity/lib)](https://socket.dev/npm/package/@socketsecurity/lib)
 [![CI](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml/badge.svg)](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml)
+![Test Coverage](https://img.shields.io/badge/test--coverage-100%25-brightgreen)
+![Type Coverage](https://img.shields.io/badge/type--coverage-100%25-brightgreen)
+
 [![Follow @SocketSecurity](https://img.shields.io/twitter/follow/SocketSecurity?style=social)](https://twitter.com/SocketSecurity)
 
 **Core infrastructure library for Socket.dev security tools** — utilities, constants, and helpers with zero dependencies.
@@ -28,12 +31,12 @@ spinner.stop()
 
 ```
 @socketsecurity/lib
-├── Visual Effects       → Spinners, shimmer, themes, logger
+├── Visual Effects       → 5 themes, spinners, shimmer, logger
 ├── File System          → fs, paths, globs, temp files
-├── Package Management   → npm, pnpm, yarn utilities
+├── Package Management   → 11 utilities (npm, pnpm, yarn, dlx)
 ├── Process & Spawn      → Safe process spawning, IPC
-├── Environment          → 68 typed env getters (CI, paths, etc)
-├── Constants            → Node.js, npm, platform constants
+├── Environment          → 22 modules with 68 typed env getters
+├── Constants            → 14 modules (Node.js, npm, platform)
 ├── Utilities            → Arrays, objects, strings, promises
 └── Types                → Full TypeScript definitions
 ```
@@ -47,13 +50,12 @@ spinner.stop()
 ```typescript
 import { Spinner, setTheme } from '@socketsecurity/lib'
 
-setTheme('ultra')  // 🌈 Rainbow mode!
+setTheme('ultra')  // 🌈 Rainbow shimmer!
 const spinner = Spinner({ text: 'Processing...' })
-spinner.enableShimmer()
 spinner.start()
 ```
 
-**5 Built-in Themes:** `socket` (purple) · `coana` · `socket-firewall` · `socket-cli-python` · `ultra` (rainbow)
+**5 Built-in Themes:** `socket` (violet) · `sunset` (twilight) · `terracotta` (warm) · `lush` (steel blue) · `ultra` (rainbow)
 
 👉 [**Theme System Docs**](./docs/themes.md)
 
@@ -168,15 +170,15 @@ const data = await retry(() => fetchData(), { maxAttempts: 3 })
   ├─ time          → MILLISECONDS_PER_*, DLX_BINARY_CACHE_TTL
   └─ encoding      → UTF8, CHAR_* codes
 
-/env/              → 68 typed environment getters
+/env/              → 22 modules providing 68 typed getters
   ├─ ci            → getCI() - Detect CI environment
   ├─ home          → getHome() - User home directory
   ├─ node-env      → getNodeEnv() - NODE_ENV value
-  └─ ...           → And 65 more!
+  └─ ...           → And 19 more modules!
 
-/packages/         → Package management utilities
+/packages/         → Package management utilities (11 modules)
   ├─ validation    → Package name/version validation
-  ├─ operations    → Install, extract, manifest
+  ├─ operations    → Install, extract, manifest, dlx
   ├─ registry      → npm registry utilities
   └─ editable      → Editable installs detection
 
@@ -191,9 +193,9 @@ const data = await retry(() => fetchData(), { maxAttempts: 3 })
   ├─ clear         → Clear terminal
   └─ footer        → Terminal footers
 
-/themes/           → Theme system for consistent branding
+/themes/           → Theme system for consistent branding (5 modules)
   ├─ types         → Theme type definitions
-  ├─ themes        → 5 built-in themes
+  ├─ themes        → 5 themes (socket, sunset, terracotta, lush, ultra)
   ├─ context       → Global theme management
   └─ utils         → Color resolution, theme creation
 ```
@@ -202,7 +204,7 @@ const data = await retry(() => fetchData(), { maxAttempts: 3 })
 
 | Doc | Description |
 |-----|-------------|
-| [**Getting Started**](./docs/getting-started.md) | Development workflow, commands, architecture |
+| [**Getting Started**](./docs/getting-started.md) | Quick start for contributors (5 min setup) |
 | [**Theme System**](./docs/themes.md) | Themed spinners, colors, and effects |
 | [**Build Architecture**](./docs/build.md) | Vendored dependencies, build system |
 | [**CLAUDE.md**](./CLAUDE.md) | Coding standards and patterns |
@@ -216,13 +218,13 @@ const data = await retry(() => fetchData(), { maxAttempts: 3 })
 ├─────────────────────────────────────────────────────┤
 │  src/                                               │
 │  ├── constants/        14 modules                   │
-│  ├── env/              68 getters                   │
-│  ├── packages/         12 utilities                 │
+│  ├── env/              22 modules (68 getters)      │
+│  ├── packages/         11 utilities                 │
 │  ├── effects/           4 visual effects            │
 │  ├── stdio/             9 I/O utilities             │
-│  ├── themes/            Theme system                │
-│  ├── external/         40+ vendored deps            │
-│  └── ... 60+ more modules                           │
+│  ├── themes/            5 theme definitions         │
+│  ├── external/         16 vendored deps             │
+│  └── ... 62+ more modules                           │
 ├─────────────────────────────────────────────────────┤
 │  Build: esbuild → CommonJS (ES2022)                │
 │  Types: tsgo (TypeScript Native Preview)            │
@@ -232,37 +234,31 @@ const data = await retry(() => fetchData(), { maxAttempts: 3 })
 
 ## Development
 
-```bash
-# Setup
-git clone https://github.com/SocketDev/socket-lib.git
-cd socket-lib
-pnpm install
+**New to the project?** See the [**Getting Started Guide**](./docs/getting-started.md) for setup, workflow, and contribution guidelines.
 
-# Build
-pnpm run build       # Production build
+**Quick commands:**
+```bash
+pnpm install         # Install dependencies
 pnpm run dev         # Watch mode
-
-# Test
-pnpm test            # Run all tests
-pnpm run cover       # With coverage
-
-# Quality
-pnpm run check       # Type check
-pnpm run lint        # Lint code
+pnpm test            # Run tests
 pnpm run fix         # Auto-fix issues
 ```
 
 ## Stats
 
-- **183** TypeScript modules
+- **143** TypeScript modules
 - **120+** granular exports
 - **68** typed environment getters
+- **22** environment modules
 - **14** constant modules
+- **5** theme definitions
 - **4600+** tests passing
 - **Zero** runtime dependencies
 
 ## Contributing
 
+**Ready to contribute?** Start with the [Getting Started Guide](./docs/getting-started.md) for a quick setup walkthrough.
+
 See [CLAUDE.md](./CLAUDE.md) for:
 - Code style and patterns
 - Path alias usage

package/dist/agent.js

@@ -34,8 +34,8 @@ __export(agent_exports, {
   isPnpmLoglevelFlag: () => isPnpmLoglevelFlag
 });
 module.exports = __toCommonJS(agent_exports);
-var import_ci = require("#env/ci");
-var import_platform = require("#constants/platform");
+var import_ci = require("./env/ci");
+var import_platform = require("./constants/platform");
 var import_bin = require("./bin");
 var import_debug = require("./debug");
 var import_fs = require("./fs");
@@ -87,7 +87,7 @@ function execNpm(args, options) {
     // one level quieter.
     useDebug || npmArgs.some(isNpmLoglevelFlag) ? [] : ["--loglevel", "warn"]
   );
-  const npmBin = require("#constants/agents").NPM_BIN_PATH;
+  const npmBin = require("./constants/agents").NPM_BIN_PATH;
   return (0, import_spawn.spawn)(
     npmBin,
     [
@@ -231,11 +231,11 @@ function execScript(scriptName, args, options) {
   if (spawnOptions.shell === true) {
     return (0, import_spawn.spawn)(scriptName, resolvedArgs, spawnOptions);
   }
-  const useNodeRun = !prepost && /* @__PURE__ */ require("#constants/node").supportsNodeRun();
+  const useNodeRun = !prepost && /* @__PURE__ */ require("./constants/node").supportsNodeRun();
   const cwd = (0, import_objects.getOwn)(spawnOptions, "cwd") ?? process.cwd();
   const pnpmLockPath = (0, import_fs.findUpSync)(
     /*@__INLINE__*/
-    require("#constants/agents").PNPM_LOCK_YAML,
+    require("./constants/agents").PNPM_LOCK_YAML,
     { cwd }
   );
   if (pnpmLockPath) {
@@ -243,7 +243,7 @@ function execScript(scriptName, args, options) {
   }
   const packageLockPath = (0, import_fs.findUpSync)(
     /*@__INLINE__*/
-    require("#constants/agents").PACKAGE_LOCK_JSON,
+    require("./constants/agents").PACKAGE_LOCK_JSON,
     { cwd }
   );
   if (packageLockPath) {
@@ -251,18 +251,18 @@ function execScript(scriptName, args, options) {
   }
   const yarnLockPath = (0, import_fs.findUpSync)(
     /*@__INLINE__*/
-    require("#constants/agents").YARN_LOCK,
+    require("./constants/agents").YARN_LOCK,
     { cwd }
   );
   if (yarnLockPath) {
     return /* @__PURE__ */ execYarn(["run", scriptName, ...resolvedArgs], spawnOptions);
   }
   return (0, import_spawn.spawn)(
-    /* @__PURE__ */ require("#constants/node").getExecPath(),
+    /* @__PURE__ */ require("./constants/node").getExecPath(),
     [
-      .../* @__PURE__ */ require("#constants/node").getNodeNoWarningsFlags(),
+      .../* @__PURE__ */ require("./constants/node").getNodeNoWarningsFlags(),
       ...useNodeRun ? ["--run"] : [
-        require("#constants/agents").NPM_REAL_EXEC_PATH,
+        require("./constants/agents").NPM_REAL_EXEC_PATH,
         "run"
       ],
       scriptName,

package/dist/bin.js

@@ -32,10 +32,10 @@ __export(bin_exports, {
   whichSync: () => whichSync
 });
 module.exports = __toCommonJS(bin_exports);
-var import_home = require("#env/home");
-var import_windows = require("#env/windows");
-var import_xdg = require("#env/xdg");
-var import_platform = require("#constants/platform");
+var import_home = require("./env/home");
+var import_windows = require("./env/windows");
+var import_xdg = require("./env/xdg");
+var import_platform = require("./constants/platform");
 var import_fs = require("./fs");
 var import_path = require("./path");
 var import_spawn = require("./spawn");

package/dist/constants/node.js

@@ -49,18 +49,7 @@ function getNodeMajorVersion() {
 let _maintainedNodeVersions;
 function getMaintainedNodeVersions() {
   if (_maintainedNodeVersions === void 0) {
-    try {
-      _maintainedNodeVersions = require("../lib/maintained-node-versions");
-    } catch {
-      _maintainedNodeVersions = Object.freeze(
-        Object.assign([], {
-          current: "",
-          last: "",
-          next: "",
-          previous: ""
-        })
-      );
-    }
+    _maintainedNodeVersions = require("../maintained-node-versions").default;
   }
   return _maintainedNodeVersions;
 }

package/dist/constants/packages.js

@@ -32,7 +32,7 @@ __export(packages_exports, {
   getPacoteCachePath: () => getPacoteCachePath
 });
 module.exports = __toCommonJS(packages_exports);
-var import_npm = require("#env/npm");
+var import_npm = require("../env/npm");
 let _lifecycleScriptNames;
 let _packageDefaultNodeRange;
 let _packageDefaultSocketCategories;
@@ -45,32 +45,20 @@ const LATEST = "latest";
 const PACKAGE_DEFAULT_VERSION = "1.0.0";
 function getPackageDefaultNodeRange() {
   if (_packageDefaultNodeRange === void 0) {
-    try {
-      _packageDefaultNodeRange = require("../lib/package-default-node-range");
-    } catch {
-      _packageDefaultNodeRange = ">=18";
-    }
+    _packageDefaultNodeRange = require("../package-default-node-range").default;
   }
   return _packageDefaultNodeRange;
 }
 function getPackageDefaultSocketCategories() {
   if (_packageDefaultSocketCategories === void 0) {
-    try {
-      _packageDefaultSocketCategories = require("../lib/package-default-socket-categories");
-    } catch {
-      _packageDefaultSocketCategories = [];
-    }
+    _packageDefaultSocketCategories = require("../package-default-socket-categories").default;
   }
   return _packageDefaultSocketCategories;
 }
 function getPackageExtensions() {
   if (_packageExtensions === void 0) {
-    try {
-      const exts = require("../lib/package-extensions");
-      _packageExtensions = Object.entries(exts);
-    } catch {
-      _packageExtensions = [];
-    }
+    const exts = require("../package-extensions").default;
+    _packageExtensions = Object.entries(exts);
   }
   return _packageExtensions;
 }
@@ -79,11 +67,8 @@ function getNpmLifecycleEvent() {
 }
 function getLifecycleScriptNames() {
   if (_lifecycleScriptNames === void 0) {
-    try {
-      _lifecycleScriptNames = require("../lib/lifecycle-script-names");
-    } catch {
-      _lifecycleScriptNames = [];
-    }
+    const scriptNamesSet = require("../lifecycle-script-names").default;
+    _lifecycleScriptNames = Array.from(scriptNamesSet);
   }
   return _lifecycleScriptNames;
 }
@@ -96,8 +81,8 @@ function getPackumentCache() {
 function getPacoteCachePath() {
   if (_pacoteCachePath === void 0) {
     try {
-      const pacote = require("../external/pacote");
-      const { normalizePath } = require("../lib/path");
+      const pacote = require('../external/pacote');
+      const { normalizePath } = require("../path");
       const proto = Reflect.getPrototypeOf(
         pacote.RegistryFetcher.prototype
       );

package/dist/constants/process.js

@@ -37,12 +37,8 @@ function getAbortSignal() {
 let _spinner;
 function getSpinner() {
   if (_spinner === void 0) {
-    try {
-      const { Spinner: SpinnerFn } = require("../lib/spinner");
-      _spinner = SpinnerFn() ?? null;
-    } catch {
-      _spinner = null;
-    }
+    const { Spinner: SpinnerFn } = require("../spinner");
+    _spinner = SpinnerFn() ?? null;
   }
   return _spinner ?? null;
 }

package/dist/debug.js

@@ -43,9 +43,9 @@ __export(debug_exports, {
   isDebugNs: () => isDebugNs
 });
 module.exports = __toCommonJS(debug_exports);
-var import_process = require("#constants/process");
-var import_debug = require("#env/debug");
-var import_socket = require("#env/socket");
+var import_process = require("./constants/process");
+var import_debug = require("./env/debug");
+var import_socket = require("./env/socket");
 var import_is_unicode_supported = __toESM(require("./external/@socketregistry/is-unicode-supported"));
 var import_debug2 = __toESM(require("./external/debug"));
 var import_logger = require("./logger");

package/dist/dlx-binary.js

@@ -40,7 +40,7 @@ module.exports = __toCommonJS(dlx_binary_exports);
 var import_crypto = require("crypto");
 var import_os = __toESM(require("os"));
 var import_path = __toESM(require("path"));
-var import_platform = require("#constants/platform");
+var import_platform = require("./constants/platform");
 var import_dlx = require("./dlx");
 var import_dlx_manifest = require("./dlx-manifest");
 var import_http_request = require("./http-request");
@@ -167,7 +167,7 @@ async function writeMetadata(cacheEntryPath, cacheKey, url, binaryName, checksum
 }
 async function cleanDlxCache(maxAge = (
   /*@__INLINE__*/
-  require("#constants/time").DLX_BINARY_CACHE_TTL
+  require("./constants/time").DLX_BINARY_CACHE_TTL
 )) {
   const cacheDir = getDlxCachePath();
   const fs = /* @__PURE__ */ getFs();
@@ -211,7 +211,7 @@ async function dlxBinary(args, options, spawnExtra) {
   const {
     cacheTtl = (
       /*@__INLINE__*/
-      require("#constants/time").DLX_BINARY_CACHE_TTL
+      require("./constants/time").DLX_BINARY_CACHE_TTL
     ),
     checksum,
     force: userForce = false,
@@ -300,7 +300,7 @@ async function downloadBinary(options) {
   const {
     cacheTtl = (
       /*@__INLINE__*/
-      require("#constants/time").DLX_BINARY_CACHE_TTL
+      require("./constants/time").DLX_BINARY_CACHE_TTL
     ),
     checksum,
     force = false,

package/dist/effects/text-shimmer.js

@@ -30,7 +30,7 @@ __export(text_shimmer_exports, {
 module.exports = __toCommonJS(text_shimmer_exports);
 var import_ansi = require("../ansi");
 var import_arrays = require("../arrays");
-var import_ci = require("#env/ci");
+var import_ci = require("../env/ci");
 var import_utils = require("../themes/utils");
 var import_themes = require("../themes/themes");
 function detectStyles(text) {

package/dist/env/ci.js

@@ -22,8 +22,8 @@ __export(ci_exports, {
   getCI: () => getCI
 });
 module.exports = __toCommonJS(ci_exports);
-var import_helpers = require("#env/helpers");
-var import_rewire = require("#env/rewire");
+var import_helpers = require("./helpers");
+var import_rewire = require("./rewire");
 function getCI() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("CI"));
 }

package/dist/env/debug.js

@@ -22,7 +22,7 @@ __export(debug_exports, {
   getDebug: () => getDebug
 });
 module.exports = __toCommonJS(debug_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getDebug() {
   return (0, import_rewire.getEnvValue)("DEBUG");
 }

package/dist/env/github.js

@@ -29,7 +29,7 @@ __export(github_exports, {
   getGithubToken: () => getGithubToken
 });
 module.exports = __toCommonJS(github_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getGithubApiUrl() {
   return (0, import_rewire.getEnvValue)("GITHUB_API_URL");
 }

package/dist/env/home.js

@@ -22,7 +22,7 @@ __export(home_exports, {
   getHome: () => getHome
 });
 module.exports = __toCommonJS(home_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getHome() {
   return (0, import_rewire.getEnvValue)("HOME");
 }

package/dist/env/locale.js

@@ -24,7 +24,7 @@ __export(locale_exports, {
   getLcMessages: () => getLcMessages
 });
 module.exports = __toCommonJS(locale_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getLang() {
   return (0, import_rewire.getEnvValue)("LANG");
 }

package/dist/env/node-auth-token.js

@@ -22,7 +22,7 @@ __export(node_auth_token_exports, {
   getNodeAuthToken: () => getNodeAuthToken
 });
 module.exports = __toCommonJS(node_auth_token_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getNodeAuthToken() {
   return (0, import_rewire.getEnvValue)("NODE_AUTH_TOKEN");
 }

package/dist/env/node-env.js

@@ -22,7 +22,7 @@ __export(node_env_exports, {
   getNodeEnv: () => getNodeEnv
 });
 module.exports = __toCommonJS(node_env_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getNodeEnv() {
   return (0, import_rewire.getEnvValue)("NODE_ENV");
 }

package/dist/env/npm.js

@@ -26,7 +26,7 @@ __export(npm_exports, {
   getNpmToken: () => getNpmToken
 });
 module.exports = __toCommonJS(npm_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getNpmConfigRegistry() {
   return (0, import_rewire.getEnvValue)("npm_config_registry");
 }

package/dist/env/package-manager.js

@@ -24,7 +24,7 @@ __export(package_manager_exports, {
   getPackageManagerUserAgent: () => getPackageManagerUserAgent
 });
 module.exports = __toCommonJS(package_manager_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function detectPackageManager() {
   const userAgent = getPackageManagerUserAgent();
   if (userAgent) {

package/dist/env/path.js

@@ -22,7 +22,7 @@ __export(path_exports, {
   getPath: () => getPath
 });
 module.exports = __toCommonJS(path_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getPath() {
   return (0, import_rewire.getEnvValue)("PATH");
 }

package/dist/env/pre-commit.js

@@ -22,8 +22,8 @@ __export(pre_commit_exports, {
   getPreCommit: () => getPreCommit
 });
 module.exports = __toCommonJS(pre_commit_exports);
-var import_helpers = require("#env/helpers");
-var import_rewire = require("#env/rewire");
+var import_helpers = require("./helpers");
+var import_rewire = require("./rewire");
 function getPreCommit() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("PRE_COMMIT"));
 }

package/dist/env/shell.js

@@ -22,7 +22,7 @@ __export(shell_exports, {
   getShell: () => getShell
 });
 module.exports = __toCommonJS(shell_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getShell() {
   return (0, import_rewire.getEnvValue)("SHELL");
 }

package/dist/env/socket-cli-shadow.js

@@ -26,8 +26,8 @@ __export(socket_cli_shadow_exports, {
   getSocketCliShadowSilent: () => getSocketCliShadowSilent
 });
 module.exports = __toCommonJS(socket_cli_shadow_exports);
-var import_helpers = require("#env/helpers");
-var import_rewire = require("#env/rewire");
+var import_helpers = require("./helpers");
+var import_rewire = require("./rewire");
 function getSocketCliShadowAcceptRisks() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_SHADOW_ACCEPT_RISKS"));
 }

package/dist/env/socket-cli.js

@@ -35,8 +35,8 @@ __export(socket_cli_exports, {
   getSocketCliViewAllRisks: () => getSocketCliViewAllRisks
 });
 module.exports = __toCommonJS(socket_cli_exports);
-var import_helpers = require("#env/helpers");
-var import_rewire = require("#env/rewire");
+var import_helpers = require("./helpers");
+var import_rewire = require("./rewire");
 function getSocketCliAcceptRisks() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_ACCEPT_RISKS"));
 }

package/dist/env/socket.js

@@ -36,8 +36,8 @@ __export(socket_exports, {
   getSocketViewAllRisks: () => getSocketViewAllRisks
 });
 module.exports = __toCommonJS(socket_exports);
-var import_helpers = require("#env/helpers");
-var import_rewire = require("#env/rewire");
+var import_helpers = require("./helpers");
+var import_rewire = require("./rewire");
 function getSocketAcceptRisks() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_ACCEPT_RISKS"));
 }

package/dist/env/temp-dir.js

@@ -24,7 +24,7 @@ __export(temp_dir_exports, {
   getTmpdir: () => getTmpdir
 });
 module.exports = __toCommonJS(temp_dir_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getTmpdir() {
   return (0, import_rewire.getEnvValue)("TMPDIR");
 }

package/dist/env/term.js

@@ -22,7 +22,7 @@ __export(term_exports, {
   getTerm: () => getTerm
 });
 module.exports = __toCommonJS(term_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getTerm() {
   return (0, import_rewire.getEnvValue)("TERM");
 }

package/dist/env/test.js

@@ -24,9 +24,9 @@ __export(test_exports, {
   isTest: () => isTest
 });
 module.exports = __toCommonJS(test_exports);
-var import_helpers = require("#env/helpers");
-var import_node_env = require("#env/node-env");
-var import_rewire = require("#env/rewire");
+var import_helpers = require("./helpers");
+var import_node_env = require("./node-env");
+var import_rewire = require("./rewire");
 function getJestWorkerId() {
   return (0, import_helpers.envAsString)((0, import_rewire.getEnvValue)("JEST_WORKER_ID"));
 }

package/dist/env/windows.js

@@ -25,7 +25,7 @@ __export(windows_exports, {
   getUserprofile: () => getUserprofile
 });
 module.exports = __toCommonJS(windows_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getAppdata() {
   return (0, import_rewire.getEnvValue)("APPDATA");
 }

package/dist/env/xdg.js

@@ -24,7 +24,7 @@ __export(xdg_exports, {
   getXdgDataHome: () => getXdgDataHome
 });
 module.exports = __toCommonJS(xdg_exports);
-var import_rewire = require("#env/rewire");
+var import_rewire = require("./rewire");
 function getXdgCacheHome() {
   return (0, import_rewire.getEnvValue)("XDG_CACHE_HOME");
 }

package/dist/fs.js

@@ -48,7 +48,7 @@ __export(fs_exports, {
   writeJsonSync: () => writeJsonSync
 });
 module.exports = __toCommonJS(fs_exports);
-var import_process = require("#constants/process");
+var import_process = require("./constants/process");
 var import_arrays = require("./arrays");
 var import_globs = require("./globs");
 var import_json = require("./json");
@@ -429,7 +429,7 @@ function getAllowedDirectories() {
       getOsTmpDir,
       getSocketCacacheDir,
       getSocketUserDir
-    } = require("#lib/paths");
+    } = require("./paths");
     _cachedAllowedDirs = [
       path.resolve(getOsTmpDir()),
       path.resolve(getSocketCacacheDir()),

package/dist/git.js

@@ -45,7 +45,7 @@ __export(git_exports, {
 });
 module.exports = __toCommonJS(git_exports);
 var import_path = __toESM(require("path"));
-var import_platform = require("#constants/platform");
+var import_platform = require("./constants/platform");
 var import_debug = require("./debug");
 var import_globs = require("./globs");
 var import_path2 = require("./path");

package/dist/github.js

@@ -31,8 +31,8 @@ __export(github_exports, {
 });
 module.exports = __toCommonJS(github_exports);
 var import_cache_with_ttl = require("./cache-with-ttl");
-var import_github = require("#env/github");
-var import_socket_cli = require("#env/socket-cli");
+var import_github = require("./env/github");
+var import_socket_cli = require("./env/socket-cli");
 var import_http_request = require("./http-request");
 var import_spawn = require("./spawn");
 const GITHUB_API_BASE_URL = "https://api.github.com";

package/dist/globs.js

@@ -97,14 +97,14 @@ function globStreamLicenses(dirname, options) {
   if (ignoreOriginals) {
     const { LICENSE_ORIGINAL_GLOB_RECURSIVE } = (
       /*@__INLINE__*/
-      require("#constants/paths")
+      require("./constants/paths")
     );
     ignore.push(LICENSE_ORIGINAL_GLOB_RECURSIVE);
   }
   const fastGlob = /* @__PURE__ */ getFastGlob();
   const paths = (
     /*@__INLINE__*/
-    require("#constants/paths")
+    require("./constants/paths")
   );
   return fastGlob.globStream(
     [recursive ? paths.LICENSE_GLOB_RECURSIVE : paths.LICENSE_GLOB],

package/dist/lifecycle-script-names.d.ts

@@ -0,0 +1,2 @@
+declare const _default: Set<string>;
+export default _default;

package/dist/lifecycle-script-names.js

@@ -0,0 +1,40 @@
+"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 lifecycle_script_names_exports = {};
+__export(lifecycle_script_names_exports, {
+  default: () => lifecycle_script_names_default
+});
+module.exports = __toCommonJS(lifecycle_script_names_exports);
+var lifecycle_script_names_default = new Set(
+  [
+    "dependencies",
+    "prepublishOnly",
+    ...[
+      "install",
+      "pack",
+      "prepare",
+      "publish",
+      "restart",
+      "start",
+      "stop",
+      "version"
+    ].map((n) => [`pre${n}`, n, `post${n}`])
+  ].flat()
+);

package/dist/objects.js

@@ -40,7 +40,7 @@ __export(objects_exports, {
   toSortedObjectFromEntries: () => toSortedObjectFromEntries
 });
 module.exports = __toCommonJS(objects_exports);
-var import_core = require("#constants/core");
+var import_core = require("./constants/core");
 var import_arrays = require("./arrays");
 var import_sorts = require("./sorts");
 const ObjectDefineProperties = Object.defineProperties;

package/dist/package-default-node-range.d.ts

@@ -0,0 +1,2 @@
+declare const _default: string;
+export default _default;

package/dist/package-default-node-range.js

@@ -0,0 +1,27 @@
+"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 package_default_node_range_exports = {};
+__export(package_default_node_range_exports, {
+  default: () => package_default_node_range_default
+});
+module.exports = __toCommonJS(package_default_node_range_exports);
+const maintainedNodeVersions = require("./maintained-node-versions").default;
+const semver = require("./external/semver");
+var package_default_node_range_default = `>=${semver.parse(maintainedNodeVersions.last).major}`;

package/dist/package-default-socket-categories.d.ts

@@ -0,0 +1,2 @@
+declare const _default: readonly string[];
+export default _default;

package/dist/package-default-socket-categories.js

@@ -0,0 +1,25 @@
+"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 package_default_socket_categories_exports = {};
+__export(package_default_socket_categories_exports, {
+  default: () => package_default_socket_categories_default
+});
+module.exports = __toCommonJS(package_default_socket_categories_exports);
+var package_default_socket_categories_default = Object.freeze(["cleanup"]);

package/dist/package-extensions.d.ts

@@ -0,0 +1,2 @@
+declare const _default: readonly any[];
+export default _default;

package/dist/package-extensions.js

@@ -0,0 +1,66 @@
+"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 package_extensions_exports = {};
+__export(package_extensions_exports, {
+  default: () => package_extensions_default
+});
+module.exports = __toCommonJS(package_extensions_exports);
+const { freeze: ObjectFreeze } = Object;
+const yarnPkgExtensions = require("./external/@yarnpkg/extensions");
+var package_extensions_default = ObjectFreeze(
+  [
+    yarnPkgExtensions.packageExtensions,
+    [
+      "@yarnpkg/extensions@>=1.1.0",
+      {
+        // Properties with undefined values are omitted when saved as JSON.
+        peerDependencies: void 0
+      }
+    ],
+    [
+      "abab@>=2.0.0",
+      {
+        devDependencies: {
+          // Lower the Webpack from v4.x to one supported by abab's peers.
+          webpack: "^3.12.0"
+        }
+      }
+    ],
+    [
+      "is-generator-function@>=1.0.7",
+      {
+        scripts: {
+          // Make the script a silent no-op.
+          "test:uglified": ""
+        }
+      }
+    ]
+  ].sort((a_, b_) => {
+    const a = a_[0].slice(0, a_[0].lastIndexOf("@"));
+    const b = b_[0].slice(0, b_[0].lastIndexOf("@"));
+    if (a < b) {
+      return -1;
+    }
+    if (a > b) {
+      return 1;
+    }
+    return 0;
+  })
+);

package/dist/packages/exports.js

@@ -27,7 +27,7 @@ __export(exports_exports, {
   resolvePackageJsonEntryExports: () => resolvePackageJsonEntryExports
 });
 module.exports = __toCommonJS(exports_exports);
-var import_core = require("#constants/core");
+var import_core = require("../constants/core");
 var import_arrays = require("../arrays");
 var import_objects = require("../objects");
 // @__NO_SIDE_EFFECTS__

package/dist/packages/isolation.js

@@ -23,10 +23,10 @@ __export(isolation_exports, {
 });
 module.exports = __toCommonJS(isolation_exports);
 var import_fs = require("fs");
-var import_platform = require("#constants/platform");
+var import_platform = require("../constants/platform");
 var import_path = require("../path");
 var import_operations = require("./operations");
-var import_paths = require("#lib/paths");
+var import_paths = require("../paths");
 let _path;
 // @__NO_SIDE_EFFECTS__
 function getPath() {

package/dist/packages/licenses.js

@@ -29,8 +29,8 @@ __export(licenses_exports, {
   visitLicenses: () => visitLicenses
 });
 module.exports = __toCommonJS(licenses_exports);
-var import_core = require("#constants/core");
-var import_licenses = require("#constants/licenses");
+var import_core = require("../constants/core");
+var import_licenses = require("../constants/licenses");
 var import_objects = require("../objects");
 var import_path = require("../path");
 const copyLeftLicenses = (0, import_licenses.getCopyLeftLicenses)();

package/dist/packages/manifest.js

@@ -24,9 +24,9 @@ __export(manifest_exports, {
   fetchPackagePackument: () => fetchPackagePackument
 });
 module.exports = __toCommonJS(manifest_exports);
-var import_packages = require("#constants/packages");
-var import_process = require("#constants/process");
-var import_socket = require("#constants/socket");
+var import_packages = require("../constants/packages");
+var import_process = require("../constants/process");
+var import_socket = require("../constants/socket");
 var import_arrays = require("../arrays");
 var import_objects = require("../objects");
 var import_exports = require("./exports");

package/dist/packages/normalize.js

@@ -71,7 +71,7 @@ let _findPackageExtensions;
 // @__NO_SIDE_EFFECTS__
 function _getFindPackageExtensions() {
   if (_findPackageExtensions === void 0) {
-    const operations = require("#packages/operations");
+    const operations = require("./operations");
     _findPackageExtensions = operations.findPackageExtensions;
   }
   return _findPackageExtensions;

package/dist/packages/operations.js

@@ -30,9 +30,9 @@ __export(operations_exports, {
   resolveRegistryPackageName: () => resolveRegistryPackageName
 });
 module.exports = __toCommonJS(operations_exports);
-var import_packages = require("#constants/packages");
-var import_process = require("#constants/process");
-var import_socket = require("#constants/socket");
+var import_packages = require("../constants/packages");
+var import_process = require("../constants/process");
+var import_socket = require("../constants/socket");
 var import_fs = require("../fs");
 var import_objects = require("../objects");
 var import_normalize = require("./normalize");
@@ -110,7 +110,7 @@ let _toEditablePackageJson;
 // @__NO_SIDE_EFFECTS__
 function _getToEditablePackageJson() {
   if (_toEditablePackageJson === void 0) {
-    _toEditablePackageJson = require("#packages/editable").toEditablePackageJson;
+    _toEditablePackageJson = require("./editable").toEditablePackageJson;
   }
   return _toEditablePackageJson;
 }
@@ -118,7 +118,7 @@ let _toEditablePackageJsonSync;
 // @__NO_SIDE_EFFECTS__
 function _getToEditablePackageJsonSync() {
   if (_toEditablePackageJsonSync === void 0) {
-    _toEditablePackageJsonSync = require("#packages/editable").toEditablePackageJsonSync;
+    _toEditablePackageJsonSync = require("./editable").toEditablePackageJsonSync;
   }
   return _toEditablePackageJsonSync;
 }

package/dist/packages/provenance.js

@@ -23,7 +23,7 @@ __export(provenance_exports, {
   getProvenanceDetails: () => getProvenanceDetails
 });
 module.exports = __toCommonJS(provenance_exports);
-var import_agents = require("#constants/agents");
+var import_agents = require("../constants/agents");
 var import_abort = require("../abort");
 var import_url = require("../url");
 const ArrayIsArray = Array.isArray;

package/dist/path.js

@@ -30,7 +30,7 @@ __export(path_exports, {
   trimLeadingDotSlash: () => trimLeadingDotSlash
 });
 module.exports = __toCommonJS(path_exports);
-var import_platform = require("#constants/platform");
+var import_platform = require("./constants/platform");
 var import_strings = require("./strings");
 const CHAR_BACKWARD_SLASH = 92;
 const CHAR_COLON = 58;

package/dist/paths.js

@@ -47,9 +47,9 @@ __export(paths_exports, {
 module.exports = __toCommonJS(paths_exports);
 var os = __toESM(require("os"));
 var path = __toESM(require("path"));
-var import_home = require("#env/home");
-var import_socket = require("#env/socket");
-var import_windows = require("#env/windows");
+var import_home = require("./env/home");
+var import_socket = require("./env/socket");
+var import_windows = require("./env/windows");
 var import_path = require("./path");
 var import_rewire = require("./paths/rewire");
 function getOsHomeDir() {
@@ -68,7 +68,7 @@ function getSocketUserDir() {
       path.join(
         getUserHomeDir(),
         /*@__INLINE__*/
-        require("#constants/paths").DOT_SOCKET_DIR
+        require("./constants/paths").DOT_SOCKET_DIR
       )
     );
   }
@@ -79,7 +79,7 @@ function getSocketAppDir(appName) {
     path.join(
       getSocketUserDir(),
       `${/*@__INLINE__*/
-      require("#constants/socket").SOCKET_APP_PREFIX}${appName}`
+      require("./constants/socket").SOCKET_APP_PREFIX}${appName}`
     )
   );
 }
@@ -95,7 +95,7 @@ function getSocketCacacheDir() {
         path.join(
           getSocketUserDir(),
           `${/*@__INLINE__*/
-          require("#constants/socket").SOCKET_APP_PREFIX}cacache`
+          require("./constants/socket").SOCKET_APP_PREFIX}cacache`
         )
       );
     }
@@ -110,8 +110,8 @@ function getSocketDlxDir() {
     path.join(
       getSocketUserDir(),
       `${/*@__INLINE__*/
-      require("#constants/socket").SOCKET_APP_PREFIX}${/*@__INLINE__*/
-      require("#constants/socket").SOCKET_DLX_APP_NAME}`
+      require("./constants/socket").SOCKET_APP_PREFIX}${/*@__INLINE__*/
+      require("./constants/socket").SOCKET_DLX_APP_NAME}`
     )
   );
 }
@@ -120,7 +120,7 @@ function getSocketAppCacheDir(appName) {
     path.join(
       getSocketAppDir(appName),
       /*@__INLINE__*/
-      require("#constants/paths").CACHE_DIR
+      require("./constants/paths").CACHE_DIR
     )
   );
 }
@@ -129,20 +129,20 @@ function getSocketAppCacheTtlDir(appName) {
     path.join(
       getSocketAppCacheDir(appName),
       /*@__INLINE__*/
-      require("#constants/paths").CACHE_TTL_DIR
+      require("./constants/paths").CACHE_TTL_DIR
     )
   );
 }
 function getSocketCliDir() {
   return getSocketAppDir(
     /*@__INLINE__*/
-    require("#constants/socket").SOCKET_CLI_APP_NAME
+    require("./constants/socket").SOCKET_CLI_APP_NAME
   );
 }
 function getSocketRegistryDir() {
   return getSocketAppDir(
     /*@__INLINE__*/
-    require("#constants/socket").SOCKET_REGISTRY_APP_NAME
+    require("./constants/socket").SOCKET_REGISTRY_APP_NAME
   );
 }
 function getSocketRegistryGithubCacheDir() {
@@ -150,10 +150,10 @@ function getSocketRegistryGithubCacheDir() {
     path.join(
       getSocketAppCacheTtlDir(
         /*@__INLINE__*/
-        require("#constants/socket").SOCKET_REGISTRY_APP_NAME
+        require("./constants/socket").SOCKET_REGISTRY_APP_NAME
       ),
       /*@__INLINE__*/
-      require("#constants/github").CACHE_GITHUB_DIR
+      require("./constants/github").CACHE_GITHUB_DIR
     )
   );
 }

package/dist/promises.js

@@ -29,8 +29,8 @@ __export(promises_exports, {
   resolveRetryOptions: () => resolveRetryOptions
 });
 module.exports = __toCommonJS(promises_exports);
-var import_core = require("#constants/core");
-var import_process = require("#constants/process");
+var import_core = require("./constants/core");
+var import_process = require("./constants/process");
 var import_arrays = require("./arrays");
 const abortSignal = (0, import_process.getAbortSignal)();
 let _timers;

package/dist/spawn.js

@@ -25,7 +25,7 @@ __export(spawn_exports, {
   spawnSync: () => spawnSync
 });
 module.exports = __toCommonJS(spawn_exports);
-var import_process = require("#constants/process");
+var import_process = require("./constants/process");
 var import_arrays = require("./arrays");
 var import_objects = require("./objects");
 var import_strings = require("./strings");

package/dist/spinner.js

@@ -39,7 +39,7 @@ __export(spinner_exports, {
   withSpinnerSync: () => withSpinnerSync
 });
 module.exports = __toCommonJS(spinner_exports);
-var import_ci = require("#env/ci");
+var import_ci = require("./env/ci");
 var import_debug = require("./debug");
 var import_pulse_frames = require("./effects/pulse-frames");
 var import_text_shimmer = require("./effects/text-shimmer");
@@ -197,7 +197,7 @@ function Spinner(options) {
           };
         }
         super({
-          signal: require("#constants/process").getAbortSignal(),
+          signal: require("./constants/process").getAbortSignal(),
           ...opts,
           // Pass RGB color directly to yocto-spinner (it now supports RGB).
           color: spinnerColorRgb,

package/dist/stdio/prompts.js

@@ -40,7 +40,7 @@ __export(prompts_exports, {
   wrapPrompt: () => wrapPrompt
 });
 module.exports = __toCommonJS(prompts_exports);
-var import_process = require("#constants/process");
+var import_process = require("../constants/process");
 var import_context = require("../themes/context");
 var import_themes = require("../themes/themes");
 var import_utils = require("../themes/utils");

package/dist/temporary-executor.js

@@ -22,7 +22,7 @@ __export(temporary_executor_exports, {
   isRunningInTemporaryExecutor: () => isRunningInTemporaryExecutor
 });
 module.exports = __toCommonJS(temporary_executor_exports);
-var import_platform = require("#constants/platform");
+var import_platform = require("./constants/platform");
 var import_path = require("./path");
 function isRunningInTemporaryExecutor(cwd = process.cwd()) {
   const userAgent = process.env["npm_config_user_agent"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "3.2.4",
+  "version": "3.2.5",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [
@@ -288,6 +288,10 @@
       "types": "./dist/json.d.ts",
       "default": "./dist/json.js"
     },
+    "./lifecycle-script-names": {
+      "types": "./dist/lifecycle-script-names.d.ts",
+      "default": "./dist/lifecycle-script-names.js"
+    },
     "./links": {
       "types": "./dist/links/index.d.ts",
       "default": "./dist/links/index.js"
@@ -312,6 +316,18 @@
       "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"
+    },
     "./packages": {
       "types": "./dist/packages.d.ts",
       "default": "./dist/packages.js"
@@ -595,7 +611,7 @@
     "@socketregistry/is-unicode-supported": "1.0.5",
     "@socketregistry/packageurl-js": "1.3.5",
     "@socketregistry/yocto-spinner": "1.0.25",
-    "@socketsecurity/lib-stable": "https://registry.npmjs.org/@socketsecurity/lib/-/lib-3.2.1.tgz",
+    "@socketsecurity/lib-stable": "https://registry.npmjs.org/@socketsecurity/lib/-/lib-3.2.4.tgz",
     "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250920.1",
     "@vitest/coverage-v8": "4.0.3",