@socketsecurity/lib 5.18.1 → 5.19.0

package/dist/arrays.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Array utility functions for formatting lists and collections.
+ * Provides conjunction and disjunction formatters using Intl.ListFormat.
+ */
 /**
  * Split an array into chunks of a specified size.
  *
@@ -27,7 +31,6 @@
  * // Returns: [[1, 2], [3]]
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function arrayChunk<T>(arr: T[] | readonly T[], size?: number | undefined): T[][];
 /**
  * Get unique values from an array.
@@ -59,12 +62,7 @@ export declare function arrayChunk<T>(arr: T[] | readonly T[], size?: number | u
  * // Returns: []
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function arrayUnique<T>(arr: T[] | readonly T[]): T[];
-// IMPORTANT: Do not use destructuring here - use direct assignment instead.
-// tsgo has a bug that incorrectly transpiles destructured exports, resulting in
-// `exports.SomeName = void 0;` which causes runtime errors.
-// See: https://github.com/SocketDev/socket-packageurl-js/issues/3
 /**
  * Alias for native Array.isArray.
  * Determines whether the passed value is an array.
@@ -132,7 +130,6 @@ export declare const isArray: (arg: any) => arg is any[];
  * // Outputs: "You can choose React, Vue, and Angular"
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function joinAnd(arr: string[] | readonly string[]): string;
 /**
  * Join array elements with proper "or" disjunction formatting.
@@ -168,5 +165,4 @@ export declare function joinAnd(arr: string[] | readonly string[]): string;
  * // Outputs: "Choose a package manager: npm, yarn, or pnpm"
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function joinOr(arr: string[] | readonly string[]): string;

package/dist/arrays.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/bin.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Binary path resolution and execution utilities for package managers.
+ * Provides cross-platform bin path lookup, command execution, and path normalization.
+ */
 /**
  * Options for the which function.
  */
@@ -24,14 +28,13 @@ export interface WhichOptions {
  * await execBin('/usr/local/bin/node', ['script.js'], { cwd: '/tmp' })
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function execBin(binPath: string, args?: string[], options?: import('./spawn').SpawnOptions): Promise<{
     cmd: string;
     args: string[] | readonly string[];
     code: number;
-    signal: NodeJS.Signals;
-    stdout: string | Buffer<ArrayBufferLike>;
-    stderr: string | Buffer<ArrayBufferLike>;
+    signal: NodeJS.Signals | null;
+    stdout: string | Buffer;
+    stderr: string | Buffer;
 }>;
 /**
  * Find the real executable for a binary, bypassing shadow bins.
@@ -83,7 +86,6 @@ export declare function findRealYarn(): string;
  * ```
  */
 export declare function isShadowBinPath(dirPath: string | undefined): boolean;
-/*@__NO_SIDE_EFFECTS__*/
 /**
  * Resolve a binary path to the real underlying script file.
  * Handles Windows .cmd wrappers and Unix shell scripts, resolving them to the actual .js files they execute.

package/dist/bin.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;
@@ -43,10 +44,10 @@ __export(bin_exports, {
 });
 module.exports = __toCommonJS(bin_exports);
 var import_node_process = __toESM(require("node:process"));
+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_which = __toESM(require("./external/which"));
 var import_fs = require("./fs");
 var import_normalize = require("./paths/normalize");
@@ -58,7 +59,7 @@ let _fs;
 // @__NO_SIDE_EFFECTS__
 function getFs() {
   if (_fs === void 0) {
-    _fs = require("fs");
+    _fs = require("node:fs");
   }
   return _fs;
 }
@@ -66,7 +67,7 @@ let _path;
 // @__NO_SIDE_EFFECTS__
 function getPath() {
   if (_path === void 0) {
-    _path = require("path");
+    _path = require("node:path");
   }
   return _path;
 }
@@ -137,11 +138,19 @@ function findRealNpm() {
   const fs = /* @__PURE__ */ getFs();
   const path = /* @__PURE__ */ getPath();
   const nodeDir = path.dirname(import_node_process.default.execPath);
-  const npmInNodeDir = path.join(nodeDir, "npm");
-  if (fs.existsSync(npmInNodeDir)) {
-    return npmInNodeDir;
+  const nodeDirCandidates = import_platform.WIN32 ? [path.join(nodeDir, "npm.cmd"), path.join(nodeDir, "npm")] : [path.join(nodeDir, "npm")];
+  for (const candidate of nodeDirCandidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
   }
-  const commonPaths = ["/usr/local/bin/npm", "/usr/bin/npm"];
+  const appdata = (0, import_windows.getAppdata)();
+  const commonPaths = import_platform.WIN32 ? [
+    appdata ? path.join(appdata, "npm", "npm.cmd") : "",
+    appdata ? path.join(appdata, "npm", "npm") : "",
+    "C:\\Program Files\\nodejs\\npm.cmd",
+    "C:\\Program Files\\nodejs\\npm"
+  ].filter(Boolean) : ["/usr/local/bin/npm", "/usr/bin/npm"];
   const result = findRealBin("npm", commonPaths);
   if (result && fs.existsSync(result)) {
     return result;
@@ -154,36 +163,41 @@ function findRealNpm() {
 }
 function findRealPnpm() {
   const path = /* @__PURE__ */ getPath();
+  const home = (0, import_home.getHome)();
+  const appdata = (0, import_windows.getAppdata)();
+  const localappdata = (0, import_windows.getLocalappdata)();
+  const xdgDataHome = (0, import_xdg.getXdgDataHome)();
   const commonPaths = import_platform.WIN32 ? [
-    // Windows common paths.
-    path.join((0, import_windows.getAppdata)(), "npm", "pnpm.cmd"),
-    path.join((0, import_windows.getAppdata)(), "npm", "pnpm"),
-    path.join((0, import_windows.getLocalappdata)(), "pnpm", "pnpm.cmd"),
-    path.join((0, import_windows.getLocalappdata)(), "pnpm", "pnpm"),
+    appdata ? path.join(appdata, "npm", "pnpm.cmd") : "",
+    appdata ? path.join(appdata, "npm", "pnpm") : "",
+    localappdata ? path.join(localappdata, "pnpm", "pnpm.cmd") : "",
+    localappdata ? path.join(localappdata, "pnpm", "pnpm") : "",
     "C:\\Program Files\\nodejs\\pnpm.cmd",
     "C:\\Program Files\\nodejs\\pnpm"
   ].filter(Boolean) : [
-    // Unix common paths.
     "/usr/local/bin/pnpm",
     "/usr/bin/pnpm",
-    path.join(
-      (0, import_xdg.getXdgDataHome)() || `${(0, import_home.getHome)()}/.local/share`,
-      "pnpm/pnpm"
-    ),
-    path.join((0, import_home.getHome)(), ".pnpm/pnpm")
+    xdgDataHome ? path.join(xdgDataHome, "pnpm/pnpm") : home ? path.join(home, ".local/share/pnpm/pnpm") : "",
+    home ? path.join(home, ".pnpm/pnpm") : ""
   ].filter(Boolean);
   return findRealBin("pnpm", commonPaths) ?? "";
 }
 function findRealYarn() {
   const path = /* @__PURE__ */ getPath();
-  const commonPaths = [
+  const home = (0, import_home.getHome)();
+  const appdata = (0, import_windows.getAppdata)();
+  const commonPaths = import_platform.WIN32 ? [
+    appdata ? path.join(appdata, "npm", "yarn.cmd") : "",
+    appdata ? path.join(appdata, "npm", "yarn") : "",
+    home ? path.join(home, ".yarn/bin/yarn.cmd") : "",
+    home ? path.join(home, ".yarn/bin/yarn") : "",
+    "C:\\Program Files\\nodejs\\yarn.cmd",
+    "C:\\Program Files\\nodejs\\yarn"
+  ].filter(Boolean) : [
     "/usr/local/bin/yarn",
     "/usr/bin/yarn",
-    path.join((0, import_home.getHome)(), ".yarn/bin/yarn"),
-    path.join(
-      (0, import_home.getHome)(),
-      ".config/yarn/global/node_modules/.bin/yarn"
-    )
+    home ? path.join(home, ".yarn/bin/yarn") : "",
+    home ? path.join(home, ".config/yarn/global/node_modules/.bin/yarn") : ""
   ].filter(Boolean);
   return findRealBin("yarn", commonPaths) ?? "";
 }
@@ -413,7 +427,10 @@ async function which(binName, options) {
     return binName;
   }
   try {
-    const result = await (0, import_which.default)(binName, options);
+    const result = await (0, import_which.default)(
+      binName,
+      options
+    );
     return result;
   } catch {
     return null;
@@ -421,7 +438,7 @@ async function which(binName, options) {
 }
 async function whichReal(binName, options) {
   const fs = /* @__PURE__ */ getFs();
-  const opts = { nothrow: true, ...options };
+  const opts = { __proto__: null, nothrow: true, ...options };
   if (opts.all) {
     const cachedAll = binPathAllCache.get(binName);
     if (cachedAll && cachedAll.length > 0) {
@@ -439,7 +456,10 @@ async function whichReal(binName, options) {
       binPathCache.delete(binName);
     }
   }
-  const result = await (0, import_which.default)(binName, opts);
+  const result = await (0, import_which.default)(
+    binName,
+    opts
+  );
   if (opts?.all) {
     const paths = Array.isArray(result) ? result : typeof result === "string" ? [result] : void 0;
     if (paths?.length) {
@@ -458,7 +478,7 @@ async function whichReal(binName, options) {
 }
 function whichRealSync(binName, options) {
   const fs = /* @__PURE__ */ getFs();
-  const opts = { nothrow: true, ...options };
+  const opts = { __proto__: null, nothrow: true, ...options };
   if (opts.all) {
     const cachedAll = binPathAllCache.get(binName);
     if (cachedAll && cachedAll.length > 0) {
@@ -498,7 +518,10 @@ function whichSync(binName, options) {
     return binName;
   }
   try {
-    const result = import_which.default.sync(binName, options);
+    const result = import_which.default.sync(
+      binName,
+      options
+    );
     return result;
   } catch {
     return null;

package/dist/cacache.d.ts

@@ -1,3 +1,4 @@
+/** @fileoverview Cacache utilities for Socket ecosystem shared content-addressable cache. */
 export interface GetOptions {
     integrity?: string | undefined;
     size?: number | undefined;
@@ -6,14 +7,14 @@ export interface GetOptions {
 export interface PutOptions {
     integrity?: string | undefined;
     size?: number | undefined;
-    metadata?: any | undefined;
+    metadata?: unknown | undefined;
     memoize?: boolean | undefined;
 }
 export interface CacheEntry {
     data: Buffer;
     integrity: string;
     key: string;
-    metadata?: any | undefined;
+    metadata?: unknown | undefined;
     path: string;
     size: number;
     time: number;
@@ -30,16 +31,6 @@ export interface RemoveOptions {
      */
     prefix?: string | undefined;
 }
-/**
- * Get the cacache module for cache operations.
- *
- * @example
- * ```typescript
- * const cacache = getCacache()
- * const entries = await cacache.ls(cacheDir)
- * ```
- */
-export declare function getCacache(): import("./external/cacache").CacacheInstance;
 /**
  * Clear entries from the Socket shared cache.
  *
@@ -78,6 +69,16 @@ export declare function clear(options?: RemoveOptions | undefined): Promise<numb
  * ```
  */
 export declare function get(key: string, options?: GetOptions | undefined): Promise<CacheEntry>;
+/**
+ * Get the cacache module for cache operations.
+ *
+ * @example
+ * ```typescript
+ * const cacache = getCacache()
+ * const entries = await cacache.ls(cacheDir)
+ * ```
+ */
+export declare function getCacache(): import("./external/cacache").CacacheInstance;
 /**
  * Put data into the Socket shared cache with a key.
  *

package/dist/cacache.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;
@@ -40,14 +41,6 @@ __export(cacache_exports, {
 module.exports = __toCommonJS(cacache_exports);
 var import_cacache = __toESM(require("./external/cacache"));
 var import_socket = require("./paths/socket");
-function getCacache() {
-  return import_cacache.default;
-}
-function patternToRegex(pattern) {
-  const escaped = pattern.replaceAll(/[.+?^${}()|[\]\\]/g, "\\$&");
-  const regexPattern = escaped.replaceAll("*", ".*");
-  return new RegExp(`^${regexPattern}`);
-}
 function matchesPattern(key, pattern) {
   if (!pattern.includes("*")) {
     return key.startsWith(pattern);
@@ -55,6 +48,11 @@ function matchesPattern(key, pattern) {
   const regex = patternToRegex(pattern);
   return regex.test(key);
 }
+function patternToRegex(pattern) {
+  const escaped = pattern.replaceAll(/[.+?^${}()|[\]\\]/g, "\\$&");
+  const regexPattern = escaped.replaceAll("*", ".*");
+  return new RegExp(`^${regexPattern}`);
+}
 async function clear(options) {
   const opts = { __proto__: null, ...options };
   const cacache2 = getCacache();
@@ -107,6 +105,9 @@ async function get(key, options) {
   const cacache2 = getCacache();
   return await cacache2.get((0, import_socket.getSocketCacacheDir)(), key, options);
 }
+function getCacache() {
+  return import_cacache.default;
+}
 async function put(key, data, options) {
   if (key.includes("*")) {
     throw new TypeError(

package/dist/cache-with-ttl.d.ts

@@ -1,37 +1,21 @@
-export interface TtlCacheOptions {
-    /**
-     * Time-to-live in milliseconds.
-     * @default 5 * 60 * 1000 (5 minutes)
-     */
-    ttl?: number | undefined;
-    /**
-     * Enable in-memory memoization for hot data.
-     * @default true
-     */
-    memoize?: boolean | undefined;
-    /**
-     * Custom cache key prefix.
-     * Must not contain wildcards (*).
-     * Use clear({ prefix: "pattern*" }) for wildcard matching instead.
-     *
-     * @default 'ttl-cache'
-     * @throws {TypeError} If prefix contains wildcards
-     *
-     * @example
-     * // Valid
-     * createTtlCache({ prefix: 'socket-sdk' })
-     * createTtlCache({ prefix: 'my-app:cache' })
-     *
-     * @example
-     * // Invalid - throws TypeError
-     * createTtlCache({ prefix: 'socket-*' })
-     */
-    prefix?: string | undefined;
-}
-export interface TtlCacheEntry<T> {
-    data: T;
-    expiresAt: number;
-}
+/**
+ * @fileoverview Generic TTL-based caching utility using cacache.
+ *
+ * Provides a simple interface for caching data with time-to-live (TTL) expiration.
+ * Uses cacache for persistent storage with metadata for TTL tracking.
+ *
+ * Features:
+ * - Automatic expiration based on TTL
+ * - In-memory memoization for hot data
+ * - Persistent storage across process restarts
+ * - Type-safe with generics
+ *
+ * Usage:
+ * ```ts
+ * const cache = createTtlCache({ ttl: 5 * 60 * 1000 }) // 5 minutes
+ * const data = await cache.getOrFetch('key', async () => fetchData())
+ * ```
+ */
 export interface ClearOptions {
     /**
      * Only clear in-memory memoization cache, not persistent cache.
@@ -66,7 +50,7 @@ export interface TtlCache {
      *
      * @example
      * // Get all entries with this cache's prefix
-     * const all = await cache.getAll<any>('*')
+     * const all = await cache.getAll<unknown>('*')
      */
     getAll<T>(pattern: string): Promise<Map<string, T>>;
     /**
@@ -127,6 +111,40 @@ export interface TtlCache {
      */
     clear(options?: ClearOptions | undefined): Promise<void>;
 }
+export interface TtlCacheEntry<T> {
+    data: T;
+    expiresAt: number;
+}
+export interface TtlCacheOptions {
+    /**
+     * Time-to-live in milliseconds.
+     * @default 5 * 60 * 1000 (5 minutes)
+     */
+    ttl?: number | undefined;
+    /**
+     * Enable in-memory memoization for hot data.
+     * @default true
+     */
+    memoize?: boolean | undefined;
+    /**
+     * Custom cache key prefix.
+     * Must not contain wildcards (*).
+     * Use clear({ prefix: "pattern*" }) for wildcard matching instead.
+     *
+     * @default 'ttl-cache'
+     * @throws {TypeError} If prefix contains wildcards
+     *
+     * @example
+     * // Valid
+     * createTtlCache({ prefix: 'socket-sdk' })
+     * createTtlCache({ prefix: 'my-app:cache' })
+     *
+     * @example
+     * // Invalid - throws TypeError
+     * createTtlCache({ prefix: 'socket-*' })
+     */
+    prefix?: string | undefined;
+}
 /**
  * Create a TTL-based cache instance.
  *

package/dist/cache-with-ttl.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;

package/dist/colors.d.ts

@@ -2,16 +2,16 @@
  * @fileoverview Color utilities for RGB color conversion and manipulation.
  * Provides type-safe color handling with named colors and RGB tuples.
  */
-/**
- * Named color values supported by the library.
- * Maps to standard terminal colors with bright variants.
- */
-export type ColorName = 'black' | 'blue' | 'blueBright' | 'cyan' | 'cyanBright' | 'gray' | 'green' | 'greenBright' | 'magenta' | 'magentaBright' | 'red' | 'redBright' | 'white' | 'whiteBright' | 'yellow' | 'yellowBright';
 /**
  * Special 'inherit' color value that uses the current color context.
  * Used with effects like shimmer to dynamically inherit color.
  */
 export type ColorInherit = 'inherit';
+/**
+ * Named color values supported by the library.
+ * Maps to standard terminal colors with bright variants.
+ */
+export type ColorName = 'black' | 'blue' | 'blueBright' | 'cyan' | 'cyanBright' | 'gray' | 'green' | 'greenBright' | 'magenta' | 'magentaBright' | 'red' | 'redBright' | 'white' | 'whiteBright' | 'yellow' | 'yellowBright';
 /**
  * RGB color tuple with values 0-255 for red, green, and blue channels.
  * @example [140, 82, 255] // Socket purple

package/dist/colors.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/constants/agents.d.ts

@@ -1,4 +1,8 @@
-// Agent names.
+/**
+ * @fileoverview Package manager agent constants.
+ * Exports agent names (npm/pnpm/yarn/bun/vlt/npx), lockfile names, registry
+ * URLs, and resolved npm binary paths used across Socket tooling.
+ */
 export declare const NPM = "npm";
 export declare const PNPM = "pnpm";
 export declare const YARN = "yarn";
@@ -6,16 +10,10 @@ export declare const BUN = "bun";
 export declare const VLT = "vlt";
 export declare const NPX = "npx";
 export declare const NPM_BIN_PATH: string;
-// NPM CLI entry point - resolved at runtime from npm bin location.
-// NOTE: This is kept for backward compatibility but NPM_BIN_PATH should be used instead
-// because cli.js exports a function that must be invoked, not executed directly.
 export declare const NPM_REAL_EXEC_PATH: any;
-// NPM registry URL.
 export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org";
-// Agent variants.
 export declare const YARN_BERRY = "yarn/berry";
 export declare const YARN_CLASSIC = "yarn/classic";
-// Lock files.
 export declare const PACKAGE_LOCK = "package-lock";
 export declare const PACKAGE_LOCK_JSON = "package-lock.json";
 export declare const NPM_SHRINKWRAP_JSON = "npm-shrinkwrap.json";
@@ -25,8 +23,6 @@ export declare const YARN_LOCK = "yarn.lock";
 export declare const BUN_LOCK = "bun.lock";
 export declare const BUN_LOCKB = "bun.lockb";
 export declare const VLT_LOCK_JSON = "vlt-lock.json";
-// Workspace configuration.
 export declare const PNPM_WORKSPACE_YAML = "pnpm-workspace.yaml";
-// Package.json fields for dependency overrides.
 export declare const OVERRIDES = "overrides";
 export declare const RESOLUTIONS = "resolutions";

package/dist/constants/agents.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;
@@ -74,8 +75,8 @@ const NPM_REAL_EXEC_PATH = /* @__PURE__ */ (() => {
     if (!_npmBinPath) {
       return void 0;
     }
-    const { existsSync } = require("fs");
-    const path = require("path");
+    const { existsSync } = require("node:fs");
+    const path = require("node:path");
     const npmDir = path.dirname(_npmBinPath);
     const nodeModulesPath = path.join(
       npmDir,

package/dist/constants/core.d.ts

@@ -1,22 +1,17 @@
 /**
- * Core primitives and fundamental constants.
- * Goal: Minimize this module by finding proper semantic homes for all constants.
+ * @fileoverview Core primitives and fundamental constants.
+ * Holds sentinels, unknown/empty tokens, the internals symbol, and a few
+ * shared env-var name strings. Intentionally kept small - prefer moving
+ * constants to a more specific `src/constants/*` module when possible.
  */
-// Internal implementation symbol.
 export declare const kInternalsSymbol: unique symbol;
-// Sentinel values.
 export declare const LOOP_SENTINEL = 1000000;
-// Error and unknown values.
 export declare const UNKNOWN_ERROR = "Unknown error";
 export declare const UNKNOWN_VALUE = "<unknown>";
-// Empty values.
 export declare const EMPTY_FILE = "/* empty */\n";
 export declare const EMPTY_VALUE = "<value>";
-// Undefined token.
 export declare const UNDEFINED_TOKEN: undefined;
-// Miscellaneous.
-export declare const V = "v";
 export declare const COLUMN_LIMIT = 80;
-// Environment variable name constants.
+export declare const V = "v";
 export declare const NODE_AUTH_TOKEN = "NODE_AUTH_TOKEN";
 export declare const NODE_ENV = "NODE_ENV";

package/dist/constants/core.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;
@@ -39,8 +40,8 @@ const UNKNOWN_VALUE = "<unknown>";
 const EMPTY_FILE = "/* empty */\n";
 const EMPTY_VALUE = "<value>";
 const UNDEFINED_TOKEN = void 0;
-const V = "v";
 const COLUMN_LIMIT = 80;
+const V = "v";
 const NODE_AUTH_TOKEN = "NODE_AUTH_TOKEN";
 const NODE_ENV = "NODE_ENV";
 // Annotate the CommonJS export names for ESM import in node:

package/dist/constants/encoding.d.ts

@@ -1,9 +1,9 @@
 /**
- * Character encodings and character codes.
+ * @fileoverview Character encoding and character code constants.
+ * Exports the default UTF-8 encoding name and numeric char codes for common
+ * ASCII characters used by path and parsing utilities.
  */
-// Encoding.
 export declare const UTF8 = "utf8";
-// Character codes.
 export declare const CHAR_BACKWARD_SLASH = 92;
 export declare const CHAR_COLON = 58;
 export declare const CHAR_FORWARD_SLASH = 47;

package/dist/constants/encoding.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/constants/github.d.ts

@@ -1,7 +1,7 @@
 /**
- * GitHub APIs and cache configuration.
+ * @fileoverview GitHub API and cache constants.
+ * Provides the GitHub REST API base URL and the cache subdirectory name used
+ * for persisting GitHub responses.
  */
-// GitHub API.
 export declare const GITHUB_API_BASE_URL = "https://api.github.com";
-// GitHub cache.
 export declare const CACHE_GITHUB_DIR = "github";

package/dist/constants/github.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/constants/licenses.d.ts

@@ -1,8 +1,15 @@
 /**
- * License identifiers and copy-left license sets.
+ * @fileoverview License identifier constants.
+ * Exports common SPDX license strings (MIT, UNLICENSED) and a lazily-built
+ * set of copy-left SPDX identifiers used when classifying package licenses.
  */
-// License identifiers.
 export declare const MIT = "MIT";
 export declare const UNLICENCED = "UNLICENCED";
 export declare const UNLICENSED = "UNLICENSED";
+/**
+ * Get the set of SPDX identifiers considered copy-left (AGPL, GPL, EPL,
+ * EUPL, CC-BY-SA variants). The set is lazily built and cached on first call.
+ *
+ * @returns A `Set` of SPDX license identifier strings.
+ */
 export declare function getCopyLeftLicenses(): Set<string>;

package/dist/constants/licenses.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;