@socketsecurity/lib 1.3.1 → 1.3.3

package/dist/cache-with-ttl.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/cache-with-ttl.ts"],
   "sourcesContent": ["/**\n * @fileoverview Generic TTL-based caching utility using cacache.\n *\n * Provides a simple interface for caching data with time-to-live (TTL) expiration.\n * Uses cacache for persistent storage with metadata for TTL tracking.\n *\n * Features:\n * - Automatic expiration based on TTL\n * - In-memory memoization for hot data\n * - Persistent storage across process restarts\n * - Type-safe with generics\n *\n * Usage:\n * ```ts\n * const cache = createTtlCache({ ttl: 5 * 60 * 1000 }) // 5 minutes\n * const data = await cache.getOrFetch('key', async () => fetchData())\n * ```\n */\n\nimport * as cacache from './cacache'\n\nexport interface TtlCacheOptions {\n  /**\n   * Time-to-live in milliseconds.\n   * @default 5 * 60 * 1000 (5 minutes)\n   */\n  ttl?: number | undefined\n  /**\n   * Enable in-memory memoization for hot data.\n   * @default true\n   */\n  memoize?: boolean | undefined\n  /**\n   * Custom cache key prefix.\n   * Must not contain wildcards (*).\n   * Use clear({ prefix: \"pattern*\" }) for wildcard matching instead.\n   *\n   * @default 'ttl-cache'\n   * @throws {TypeError} If prefix contains wildcards\n   *\n   * @example\n   * // Valid\n   * createTtlCache({ prefix: 'socket-sdk' })\n   * createTtlCache({ prefix: 'my-app:cache' })\n   *\n   * @example\n   * // Invalid - throws TypeError\n   * createTtlCache({ prefix: 'socket-*' })\n   */\n  prefix?: string | undefined\n}\n\nexport interface TtlCacheEntry<T> {\n  data: T\n  expiresAt: number\n}\n\nexport interface ClearOptions {\n  /**\n   * Only clear in-memory memoization cache, not persistent cache.\n   * Useful for forcing a refresh of cached data without removing it from disk.\n   *\n   * @default false\n   */\n  memoOnly?: boolean | undefined\n}\n\nexport interface TtlCache {\n  /**\n   * Get cached data without fetching.\n   * Returns undefined if not found or expired.\n   *\n   * @param key - Cache key (must not contain wildcards)\n   * @throws {TypeError} If key contains wildcards (*)\n   */\n  get<T>(key: string): Promise<T | undefined>\n  /**\n   * Get all cached entries matching a pattern.\n   * Supports wildcards (*) for flexible matching.\n   *\n   * @param pattern - Key pattern (supports * wildcards, or use '*' for all entries)\n   * @returns Map of matching entries (key -> value)\n   *\n   * @example\n   * // Get all organization entries\n   * const orgs = await cache.getAll<OrgData>('organizations:*')\n   * for (const [key, org] of orgs) {\n   *   console.log(`${key}: ${org.name}`)\n   * }\n   *\n   * @example\n   * // Get all entries with this cache's prefix\n   * const all = await cache.getAll<any>('*')\n   */\n  getAll<T>(pattern: string): Promise<Map<string, T>>\n  /**\n   * Get cached data or fetch and cache if missing/expired.\n   *\n   * @param key - Cache key (must not contain wildcards)\n   */\n  getOrFetch<T>(key: string, fetcher: () => Promise<T>): Promise<T>\n  /**\n   * Set cached data with TTL.\n   *\n   * @param key - Cache key (must not contain wildcards)\n   * @throws {TypeError} If key contains wildcards (*)\n   */\n  set<T>(key: string, data: T): Promise<void>\n  /**\n   * Delete a specific cache entry.\n   *\n   * @param key - Cache key (must not contain wildcards)\n   * @throws {TypeError} If key contains wildcards (*)\n   */\n  delete(key: string): Promise<void>\n  /**\n   * Delete all cache entries matching a pattern.\n   * Supports wildcards (*) for flexible matching.\n   *\n   * @param pattern - Key pattern (supports * wildcards, or omit to delete all)\n   * @returns Number of entries deleted\n   *\n   * @example\n   * // Delete all entries with this cache's prefix\n   * await cache.deleteAll()\n   *\n   * @example\n   * // Delete entries matching prefix\n   * await cache.deleteAll('organizations')\n   *\n   * @example\n   * // Delete entries with wildcard pattern\n   * await cache.deleteAll('scans:abc*')\n   * await cache.deleteAll('npm/lodash/*')\n   */\n  deleteAll(pattern?: string | undefined): Promise<number>\n  /**\n   * Clear all cache entries (like Map.clear()).\n   * Optionally clear only in-memory cache.\n   *\n   * @param options - Optional configuration\n   * @param options.memoOnly - If true, only clears in-memory cache\n   *\n   * @example\n   * // Clear everything (memory + disk)\n   * await cache.clear()\n   *\n   * @example\n   * // Clear only in-memory cache (force refresh)\n   * await cache.clear({ memoOnly: true })\n   */\n  clear(options?: ClearOptions | undefined): Promise<void>\n}\n\n// 5 minutes\nconst DEFAULT_TTL_MS = 5 * 60 * 1000\nconst DEFAULT_PREFIX = 'ttl-cache'\n\n/**\n * Create a TTL-based cache instance.\n */\nexport function createTtlCache(options?: TtlCacheOptions): TtlCache {\n  const opts = {\n    __proto__: null,\n    memoize: true,\n    prefix: DEFAULT_PREFIX,\n    ttl: DEFAULT_TTL_MS,\n    ...options,\n  } as Required<TtlCacheOptions>\n\n  // Validate prefix does not contain wildcards.\n  if (opts.prefix?.includes('*')) {\n    throw new TypeError(\n      'Cache prefix cannot contain wildcards (*). Use clear({ prefix: \"pattern*\" }) for wildcard matching.',\n    )\n  }\n\n  // In-memory cache for hot data\n  const memoCache = new Map<string, TtlCacheEntry<any>>()\n\n  // Ensure ttl is defined\n  const ttl = opts.ttl ?? DEFAULT_TTL_MS\n\n  /**\n   * Build full cache key with prefix.\n   */\n  function buildKey(key: string): string {\n    return `${opts.prefix}:${key}`\n  }\n\n  /**\n   * Check if entry is expired.\n   */\n  function isExpired(entry: TtlCacheEntry<any>): boolean {\n    return Date.now() > entry.expiresAt\n  }\n\n  /**\n   * Create a matcher function for a pattern (with wildcard support).\n   * Returns a function that tests if a key matches the pattern.\n   */\n  function createMatcher(pattern: string): (key: string) => boolean {\n    const fullPattern = buildKey(pattern)\n    const hasWildcard = pattern.includes('*')\n\n    if (!hasWildcard) {\n      // Simple prefix matching (fast path).\n      return (key: string) => key.startsWith(fullPattern)\n    }\n\n    // Wildcard matching with regex.\n    const escaped = fullPattern.replaceAll(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&')\n    const regexPattern = escaped.replaceAll('*', '.*')\n    const regex = new RegExp(`^${regexPattern}`)\n    return (key: string) => regex.test(key)\n  }\n\n  /**\n   * Get cached data without fetching.\n   *\n   * @throws {TypeError} If key contains wildcards (*)\n   */\n  async function get<T>(key: string): Promise<T | undefined> {\n    if (key.includes('*')) {\n      throw new TypeError(\n        'Cache key cannot contain wildcards (*). Use getAll(pattern) to retrieve multiple entries.',\n      )\n    }\n\n    const fullKey = buildKey(key)\n\n    // Check in-memory cache first.\n    if (opts.memoize) {\n      const memoEntry = memoCache.get(fullKey)\n      if (memoEntry && !isExpired(memoEntry)) {\n        return memoEntry.data as T\n      }\n      // Remove expired memo entry.\n      if (memoEntry) {\n        memoCache.delete(fullKey)\n      }\n    }\n\n    // Check persistent cache.\n    const cacheEntry = await cacache.safeGet(fullKey)\n    if (cacheEntry) {\n      const entry = JSON.parse(\n        cacheEntry.data.toString('utf8'),\n      ) as TtlCacheEntry<T>\n      if (!isExpired(entry)) {\n        // Update in-memory cache.\n        if (opts.memoize) {\n          memoCache.set(fullKey, entry)\n        }\n        return entry.data\n      }\n      // Remove expired entry.\n      await cacache.remove(fullKey)\n    }\n\n    return undefined\n  }\n\n  /**\n   * Get all cached entries matching a pattern.\n   * Supports wildcards (*) for flexible matching.\n   */\n  async function getAll<T>(pattern: string): Promise<Map<string, T>> {\n    const results = new Map<string, T>()\n    const matches = createMatcher(pattern)\n\n    // Check in-memory cache first.\n    if (opts.memoize) {\n      for (const [key, entry] of memoCache.entries()) {\n        if (!matches(key)) {\n          continue\n        }\n\n        // Skip if expired.\n        if (isExpired(entry)) {\n          memoCache.delete(key)\n          continue\n        }\n\n        // Add to results (strip cache prefix from key).\n        const originalKey = key.slice((opts.prefix?.length ?? 0) + 1)\n        results.set(originalKey, entry.data as T)\n      }\n    }\n\n    // Check persistent cache for entries not in memory.\n    const cacheDir = (await import('./paths')).getSocketCacacheDir()\n    const cacacheModule = (await import('./cacache')) as any\n    const stream = cacacheModule.getCacache().ls.stream(cacheDir)\n\n    for await (const cacheEntry of stream) {\n      // Skip if doesn't match our cache prefix.\n      if (!cacheEntry.key.startsWith(`${opts.prefix}:`)) {\n        continue\n      }\n\n      // Skip if doesn't match pattern.\n      if (!matches(cacheEntry.key)) {\n        continue\n      }\n\n      // Skip if already in results (from memory).\n      const originalKey = cacheEntry.key.slice((opts.prefix?.length ?? 0) + 1)\n      if (results.has(originalKey)) {\n        continue\n      }\n\n      // Get entry from cache.\n      try {\n        const entry = await cacache.safeGet(cacheEntry.key)\n        if (!entry) {\n          continue\n        }\n\n        const parsed = JSON.parse(\n          entry.data.toString('utf8'),\n        ) as TtlCacheEntry<T>\n\n        // Skip if expired.\n        if (isExpired(parsed)) {\n          await cacache.remove(cacheEntry.key)\n          continue\n        }\n\n        // Add to results.\n        results.set(originalKey, parsed.data)\n\n        // Update in-memory cache.\n        if (opts.memoize) {\n          memoCache.set(cacheEntry.key, parsed)\n        }\n      } catch {\n        // Ignore parse errors or other issues.\n      }\n    }\n\n    return results\n  }\n\n  /**\n   * Set cached data with TTL.\n   *\n   * @throws {TypeError} If key contains wildcards (*)\n   */\n  async function set<T>(key: string, data: T): Promise<void> {\n    if (key.includes('*')) {\n      throw new TypeError(\n        'Cache key cannot contain wildcards (*). Wildcards are only supported in clear({ prefix: \"pattern*\" }).',\n      )\n    }\n\n    const fullKey = buildKey(key)\n    const entry: TtlCacheEntry<T> = {\n      data,\n      expiresAt: Date.now() + ttl,\n    }\n\n    // Update in-memory cache.\n    if (opts.memoize) {\n      memoCache.set(fullKey, entry)\n    }\n\n    // Update persistent cache.\n    await cacache.put(fullKey, JSON.stringify(entry), {\n      metadata: { expiresAt: entry.expiresAt },\n    })\n  }\n\n  /**\n   * Get cached data or fetch and cache if missing/expired.\n   */\n  async function getOrFetch<T>(\n    key: string,\n    fetcher: () => Promise<T>,\n  ): Promise<T> {\n    const cached = await get<T>(key)\n    if (cached !== undefined) {\n      return cached\n    }\n\n    const data = await fetcher()\n    await set(key, data)\n    return data\n  }\n\n  /**\n   * Delete a specific cache entry.\n   *\n   * @throws {TypeError} If key contains wildcards (*)\n   */\n  async function deleteEntry(key: string): Promise<void> {\n    if (key.includes('*')) {\n      throw new TypeError(\n        'Cache key cannot contain wildcards (*). Use deleteAll(pattern) to remove multiple entries.',\n      )\n    }\n\n    const fullKey = buildKey(key)\n    memoCache.delete(fullKey)\n    await cacache.remove(fullKey)\n  }\n\n  /**\n   * Delete all cache entries matching a pattern.\n   * Supports wildcards (*) in patterns.\n   * Delegates to cacache.clear() which handles pattern matching efficiently.\n   */\n  async function deleteAll(pattern?: string | undefined): Promise<number> {\n    // Build full prefix/pattern by combining cache prefix with optional pattern.\n    const fullPrefix = pattern ? `${opts.prefix}:${pattern}` : opts.prefix\n\n    // Delete matching in-memory entries.\n    if (!pattern) {\n      // Delete all in-memory entries for this cache.\n      memoCache.clear()\n    } else {\n      // Delete matching in-memory entries using shared matcher logic.\n      const matches = createMatcher(pattern)\n      for (const key of memoCache.keys()) {\n        if (matches(key)) {\n          memoCache.delete(key)\n        }\n      }\n    }\n\n    // Delete matching persistent cache entries.\n    // Delegate to cacache.clear() which handles wildcards efficiently.\n    const removed = await cacache.clear({ prefix: fullPrefix })\n    return (removed ?? 0) as number\n  }\n\n  /**\n   * Clear all cache entries (like Map.clear()).\n   * Optionally clear only in-memory cache.\n   */\n  async function clear(options?: ClearOptions | undefined): Promise<void> {\n    const opts = { __proto__: null, ...options } as ClearOptions\n\n    // Clear in-memory cache.\n    memoCache.clear()\n\n    // If memoOnly, stop here.\n    if (opts.memoOnly) {\n      return\n    }\n\n    // Clear persistent cache.\n    await deleteAll()\n  }\n\n  return {\n    clear,\n    delete: deleteEntry,\n    deleteAll,\n    get,\n    getAll,\n    getOrFetch,\n    set,\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["options", "opts"]
+  "mappings": ";6iBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,oBAAAE,IAAA,eAAAC,EAAAH,GAmBA,IAAAI,EAAyB,wBAwIzB,MAAMC,EAAiB,IAAS,IAC1BC,EAAiB,YAKhB,SAASJ,EAAeK,EAAqC,CAClE,MAAMC,EAAO,CACX,UAAW,KACX,QAAS,GACT,OAAQF,EACR,IAAKD,EACL,GAAGE,CACL,EAGA,GAAIC,EAAK,QAAQ,SAAS,GAAG,EAC3B,MAAM,IAAI,UACR,qGACF,EAIF,MAAMC,EAAY,IAAI,IAGhBC,EAAMF,EAAK,KAAOH,EAKxB,SAASM,EAASC,EAAqB,CACrC,MAAO,GAAGJ,EAAK,MAAM,IAAII,CAAG,EAC9B,CAKA,SAASC,EAAUC,EAAoC,CACrD,OAAO,KAAK,IAAI,EAAIA,EAAM,SAC5B,CAMA,SAASC,EAAcC,EAA2C,CAChE,MAAMC,EAAcN,EAASK,CAAO,EAGpC,GAAI,CAFgBA,EAAQ,SAAS,GAAG,EAItC,OAAQJ,GAAgBA,EAAI,WAAWK,CAAW,EAKpD,MAAMC,EADUD,EAAY,WAAW,qBAAsB,MAAM,EACtC,WAAW,IAAK,IAAI,EAC3CE,EAAQ,IAAI,OAAO,IAAID,CAAY,EAAE,EAC3C,OAAQN,GAAgBO,EAAM,KAAKP,CAAG,CACxC,CAOA,eAAeQ,EAAOR,EAAqC,CACzD,GAAIA,EAAI,SAAS,GAAG,EAClB,MAAM,IAAI,UACR,2FACF,EAGF,MAAMS,EAAUV,EAASC,CAAG,EAG5B,GAAIJ,EAAK,QAAS,CAChB,MAAMc,EAAYb,EAAU,IAAIY,CAAO,EACvC,GAAIC,GAAa,CAACT,EAAUS,CAAS,EACnC,OAAOA,EAAU,KAGfA,GACFb,EAAU,OAAOY,CAAO,CAE5B,CAGA,MAAME,EAAa,MAAMnB,EAAQ,QAAQiB,CAAO,EAChD,GAAIE,EAAY,CACd,MAAMT,EAAQ,KAAK,MACjBS,EAAW,KAAK,SAAS,MAAM,CACjC,EACA,GAAI,CAACV,EAAUC,CAAK,EAElB,OAAIN,EAAK,SACPC,EAAU,IAAIY,EAASP,CAAK,EAEvBA,EAAM,KAGf,MAAMV,EAAQ,OAAOiB,CAAO,CAC9B,CAGF,CAMA,eAAeG,EAAUR,EAA0C,CACjE,MAAMS,EAAU,IAAI,IACdC,EAAUX,EAAcC,CAAO,EAGrC,GAAIR,EAAK,QACP,SAAW,CAACI,EAAKE,CAAK,IAAKL,EAAU,QAAQ,EAAG,CAC9C,GAAI,CAACiB,EAAQd,CAAG,EACd,SAIF,GAAIC,EAAUC,CAAK,EAAG,CACpBL,EAAU,OAAOG,CAAG,EACpB,QACF,CAGA,MAAMe,EAAcf,EAAI,OAAOJ,EAAK,QAAQ,QAAU,GAAK,CAAC,EAC5DiB,EAAQ,IAAIE,EAAab,EAAM,IAAS,CAC1C,CAIF,MAAMc,GAAY,KAAM,QAAO,SAAS,GAAG,oBAAoB,EAEzDC,GADiB,KAAM,QAAO,WAAW,GAClB,WAAW,EAAE,GAAG,OAAOD,CAAQ,EAE5D,gBAAiBL,KAAcM,EAAQ,CAOrC,GALI,CAACN,EAAW,IAAI,WAAW,GAAGf,EAAK,MAAM,GAAG,GAK5C,CAACkB,EAAQH,EAAW,GAAG,EACzB,SAIF,MAAMI,EAAcJ,EAAW,IAAI,OAAOf,EAAK,QAAQ,QAAU,GAAK,CAAC,EACvE,GAAI,CAAAiB,EAAQ,IAAIE,CAAW,EAK3B,GAAI,CACF,MAAMb,EAAQ,MAAMV,EAAQ,QAAQmB,EAAW,GAAG,EAClD,GAAI,CAACT,EACH,SAGF,MAAMgB,EAAS,KAAK,MAClBhB,EAAM,KAAK,SAAS,MAAM,CAC5B,EAGA,GAAID,EAAUiB,CAAM,EAAG,CACrB,MAAM1B,EAAQ,OAAOmB,EAAW,GAAG,EACnC,QACF,CAGAE,EAAQ,IAAIE,EAAaG,EAAO,IAAI,EAGhCtB,EAAK,SACPC,EAAU,IAAIc,EAAW,IAAKO,CAAM,CAExC,MAAQ,CAER,CACF,CAEA,OAAOL,CACT,CAOA,eAAeM,EAAOnB,EAAaoB,EAAwB,CACzD,GAAIpB,EAAI,SAAS,GAAG,EAClB,MAAM,IAAI,UACR,wGACF,EAGF,MAAMS,EAAUV,EAASC,CAAG,EACtBE,EAA0B,CAC9B,KAAAkB,EACA,UAAW,KAAK,IAAI,EAAItB,CAC1B,EAGIF,EAAK,SACPC,EAAU,IAAIY,EAASP,CAAK,EAI9B,MAAMV,EAAQ,IAAIiB,EAAS,KAAK,UAAUP,CAAK,EAAG,CAChD,SAAU,CAAE,UAAWA,EAAM,SAAU,CACzC,CAAC,CACH,CAKA,eAAemB,EACbrB,EACAsB,EACY,CACZ,MAAMC,EAAS,MAAMf,EAAOR,CAAG,EAC/B,GAAIuB,IAAW,OACb,OAAOA,EAGT,MAAMH,EAAO,MAAME,EAAQ,EAC3B,aAAMH,EAAInB,EAAKoB,CAAI,EACZA,CACT,CAOA,eAAeI,EAAYxB,EAA4B,CACrD,GAAIA,EAAI,SAAS,GAAG,EAClB,MAAM,IAAI,UACR,4FACF,EAGF,MAAMS,EAAUV,EAASC,CAAG,EAC5BH,EAAU,OAAOY,CAAO,EACxB,MAAMjB,EAAQ,OAAOiB,CAAO,CAC9B,CAOA,eAAegB,EAAUrB,EAA+C,CAEtE,MAAMsB,EAAatB,EAAU,GAAGR,EAAK,MAAM,IAAIQ,CAAO,GAAKR,EAAK,OAGhE,GAAI,CAACQ,EAEHP,EAAU,MAAM,MACX,CAEL,MAAMiB,EAAUX,EAAcC,CAAO,EACrC,UAAWJ,KAAOH,EAAU,KAAK,EAC3BiB,EAAQd,CAAG,GACbH,EAAU,OAAOG,CAAG,CAG1B,CAKA,OADgB,MAAMR,EAAQ,MAAM,CAAE,OAAQkC,CAAW,CAAC,GACvC,CACrB,CAMA,eAAeC,EAAMhC,EAAmD,CACtE,MAAMC,EAAO,CAAE,UAAW,KAAM,GAAGD,CAAQ,EAG3CE,EAAU,MAAM,EAGZ,CAAAD,EAAK,UAKT,MAAM6B,EAAU,CAClB,CAEA,MAAO,CACL,MAAAE,EACA,OAAQH,EACR,UAAAC,EACA,IAAAjB,EACA,OAAAI,EACA,WAAAS,EACA,IAAAF,CACF,CACF",
+  "names": ["cache_with_ttl_exports", "__export", "createTtlCache", "__toCommonJS", "cacache", "DEFAULT_TTL_MS", "DEFAULT_PREFIX", "options", "opts", "memoCache", "ttl", "buildKey", "key", "isExpired", "entry", "createMatcher", "pattern", "fullPattern", "regexPattern", "regex", "get", "fullKey", "memoEntry", "cacheEntry", "getAll", "results", "matches", "originalKey", "cacheDir", "stream", "parsed", "set", "data", "getOrFetch", "fetcher", "cached", "deleteEntry", "deleteAll", "fullPrefix", "clear"]
 }

package/dist/constants/agents.js

@@ -1,128 +1,3 @@
 /* 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 agents_exports = {};
-__export(agents_exports, {
-  BUN: () => BUN,
-  BUN_LOCK: () => BUN_LOCK,
-  BUN_LOCKB: () => BUN_LOCKB,
-  NPM: () => NPM,
-  NPM_BIN_PATH: () => NPM_BIN_PATH,
-  NPM_REAL_EXEC_PATH: () => NPM_REAL_EXEC_PATH,
-  NPM_REGISTRY_URL: () => NPM_REGISTRY_URL,
-  NPM_SHRINKWRAP_JSON: () => NPM_SHRINKWRAP_JSON,
-  NPX: () => NPX,
-  OVERRIDES: () => OVERRIDES,
-  PACKAGE_LOCK: () => PACKAGE_LOCK,
-  PACKAGE_LOCK_JSON: () => PACKAGE_LOCK_JSON,
-  PNPM: () => PNPM,
-  PNPM_LOCK: () => PNPM_LOCK,
-  PNPM_LOCK_YAML: () => PNPM_LOCK_YAML,
-  PNPM_WORKSPACE_YAML: () => PNPM_WORKSPACE_YAML,
-  RESOLUTIONS: () => RESOLUTIONS,
-  VLT: () => VLT,
-  VLT_LOCK_JSON: () => VLT_LOCK_JSON,
-  YARN: () => YARN,
-  YARN_BERRY: () => YARN_BERRY,
-  YARN_CLASSIC: () => YARN_CLASSIC,
-  YARN_LOCK: () => YARN_LOCK
-});
-module.exports = __toCommonJS(agents_exports);
-const NPM = "npm";
-const PNPM = "pnpm";
-const YARN = "yarn";
-const BUN = "bun";
-const VLT = "vlt";
-const NPX = "npx";
-const NPM_BIN_PATH = /* @__PURE__ */ (() => {
-  try {
-    const which = require("which");
-    return which.sync("npm", { nothrow: true }) || "npm";
-  } catch {
-    return "npm";
-  }
-})();
-const NPM_REAL_EXEC_PATH = /* @__PURE__ */ (() => {
-  try {
-    const { existsSync } = require("node:fs");
-    const path = require("node:path");
-    const which = require("which");
-    const npmBin = which.sync("npm", { nothrow: true });
-    if (!npmBin) {
-      return void 0;
-    }
-    const npmDir = path.dirname(npmBin);
-    const nodeModulesPath = path.join(
-      npmDir,
-      "..",
-      "lib",
-      "node_modules",
-      "npm",
-      "lib",
-      "cli.js"
-    );
-    if (existsSync(nodeModulesPath)) {
-      return nodeModulesPath;
-    }
-    return void 0;
-  } catch {
-    return void 0;
-  }
-})();
-const NPM_REGISTRY_URL = "https://registry.npmjs.org";
-const YARN_BERRY = "yarn/berry";
-const YARN_CLASSIC = "yarn/classic";
-const PACKAGE_LOCK = "package-lock";
-const PACKAGE_LOCK_JSON = "package-lock.json";
-const NPM_SHRINKWRAP_JSON = "npm-shrinkwrap.json";
-const PNPM_LOCK = "pnpm-lock";
-const PNPM_LOCK_YAML = "pnpm-lock.yaml";
-const YARN_LOCK = "yarn.lock";
-const BUN_LOCK = "bun.lock";
-const BUN_LOCKB = "bun.lockb";
-const VLT_LOCK_JSON = "vlt-lock.json";
-const PNPM_WORKSPACE_YAML = "pnpm-workspace.yaml";
-const OVERRIDES = "overrides";
-const RESOLUTIONS = "resolutions";
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BUN,
-  BUN_LOCK,
-  BUN_LOCKB,
-  NPM,
-  NPM_BIN_PATH,
-  NPM_REAL_EXEC_PATH,
-  NPM_REGISTRY_URL,
-  NPM_SHRINKWRAP_JSON,
-  NPX,
-  OVERRIDES,
-  PACKAGE_LOCK,
-  PACKAGE_LOCK_JSON,
-  PNPM,
-  PNPM_LOCK,
-  PNPM_LOCK_YAML,
-  PNPM_WORKSPACE_YAML,
-  RESOLUTIONS,
-  VLT,
-  VLT_LOCK_JSON,
-  YARN,
-  YARN_BERRY,
-  YARN_CLASSIC,
-  YARN_LOCK
-});
+var c=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var _=(o,n)=>{for(var r in n)c(o,r,{get:n[r],enumerable:!0})},N=(o,n,r,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of i(n))!x.call(o,t)&&t!==r&&c(o,t,{get:()=>n[t],enumerable:!(e=p(n,t))||e.enumerable});return o};var u=o=>N(c({},"__esModule",{value:!0}),o);var T={};_(T,{BUN:()=>m,BUN_LOCK:()=>w,BUN_LOCKB:()=>Y,NPM:()=>P,NPM_BIN_PATH:()=>L,NPM_REAL_EXEC_PATH:()=>R,NPM_REGISTRY_URL:()=>O,NPM_SHRINKWRAP_JSON:()=>K,NPX:()=>A,OVERRIDES:()=>j,PACKAGE_LOCK:()=>d,PACKAGE_LOCK_JSON:()=>k,PNPM:()=>l,PNPM_LOCK:()=>M,PNPM_LOCK_YAML:()=>S,PNPM_WORKSPACE_YAML:()=>B,RESOLUTIONS:()=>I,VLT:()=>h,VLT_LOCK_JSON:()=>b,YARN:()=>a,YARN_BERRY:()=>C,YARN_CLASSIC:()=>y,YARN_LOCK:()=>E});module.exports=u(T);const P="npm",l="pnpm",a="yarn",m="bun",h="vlt",A="npx",L=(()=>{try{return require('../external/which').sync("npm",{nothrow:!0})||"npm"}catch{return"npm"}})(),R=(()=>{try{const{existsSync:o}=require("node:fs"),n=require("node:path"),e=require('../external/which').sync("npm",{nothrow:!0});if(!e)return;const t=n.dirname(e),s=n.join(t,"..","lib","node_modules","npm","lib","cli.js");return o(s)?s:void 0}catch{return}})(),O="https://registry.npmjs.org",C="yarn/berry",y="yarn/classic",d="package-lock",k="package-lock.json",K="npm-shrinkwrap.json",M="pnpm-lock",S="pnpm-lock.yaml",E="yarn.lock",w="bun.lock",Y="bun.lockb",b="vlt-lock.json",B="pnpm-workspace.yaml",j="overrides",I="resolutions";0&&(module.exports={BUN,BUN_LOCK,BUN_LOCKB,NPM,NPM_BIN_PATH,NPM_REAL_EXEC_PATH,NPM_REGISTRY_URL,NPM_SHRINKWRAP_JSON,NPX,OVERRIDES,PACKAGE_LOCK,PACKAGE_LOCK_JSON,PNPM,PNPM_LOCK,PNPM_LOCK_YAML,PNPM_WORKSPACE_YAML,RESOLUTIONS,VLT,VLT_LOCK_JSON,YARN,YARN_BERRY,YARN_CLASSIC,YARN_LOCK});
 //# sourceMappingURL=agents.js.map

package/dist/constants/agents.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/constants/agents.ts"],
   "sourcesContent": ["/**\n * Package manager agent constants.\n * Agent names, lockfile names, registry URLs, and configuration field names.\n */\n\n// Agent names.\nexport const NPM = 'npm'\nexport const PNPM = 'pnpm'\nexport const YARN = 'yarn'\nexport const BUN = 'bun'\nexport const VLT = 'vlt'\nexport const NPX = 'npx'\n\n// NPM binary path - resolved at runtime using which.\nexport const NPM_BIN_PATH = /*@__PURE__*/ (() => {\n  try {\n    const which = /*@__PURE__*/ require('which')\n    return which.sync('npm', { nothrow: true }) || 'npm'\n  } catch {\n    return 'npm'\n  }\n})()\n\n// NPM CLI entry point - resolved at runtime from npm bin location.\n// NOTE: This is kept for backward compatibility but NPM_BIN_PATH should be used instead\n// because cli.js exports a function that must be invoked, not executed directly.\nexport const NPM_REAL_EXEC_PATH = /*@__PURE__*/ (() => {\n  try {\n    const { existsSync } = /*@__PURE__*/ require('node:fs')\n    const path = /*@__PURE__*/ require('node:path')\n    const which = /*@__PURE__*/ require('which')\n    // Find npm binary using which.\n    const npmBin = which.sync('npm', { nothrow: true })\n    if (!npmBin) {\n      return undefined\n    }\n    // npm bin is typically at: /path/to/node/bin/npm\n    // cli.js is at: /path/to/node/lib/node_modules/npm/lib/cli.js\n    // /path/to/node/bin\n    const npmDir = path.dirname(npmBin)\n    const nodeModulesPath = path.join(\n      npmDir,\n      '..',\n      'lib',\n      'node_modules',\n      'npm',\n      'lib',\n      'cli.js',\n    )\n    if (existsSync(nodeModulesPath)) {\n      return nodeModulesPath\n    }\n    return undefined\n  } catch {\n    return undefined\n  }\n})()\n\n// NPM registry URL.\nexport const NPM_REGISTRY_URL = 'https://registry.npmjs.org'\n\n// Agent variants.\nexport const YARN_BERRY = 'yarn/berry'\nexport const YARN_CLASSIC = 'yarn/classic'\n\n// Lock files.\nexport const PACKAGE_LOCK = 'package-lock'\nexport const PACKAGE_LOCK_JSON = 'package-lock.json'\nexport const NPM_SHRINKWRAP_JSON = 'npm-shrinkwrap.json'\nexport const PNPM_LOCK = 'pnpm-lock'\nexport const PNPM_LOCK_YAML = 'pnpm-lock.yaml'\nexport const YARN_LOCK = 'yarn.lock'\nexport const BUN_LOCK = 'bun.lock'\nexport const BUN_LOCKB = 'bun.lockb'\nexport const VLT_LOCK_JSON = 'vlt-lock.json'\n\n// Workspace configuration.\nexport const PNPM_WORKSPACE_YAML = 'pnpm-workspace.yaml'\n\n// Package.json fields for dependency overrides.\nexport const OVERRIDES = 'overrides'\nexport const RESOLUTIONS = 'resolutions'\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,MAAM,MAAM;AACZ,MAAM,OAAO;AACb,MAAM,OAAO;AACb,MAAM,MAAM;AACZ,MAAM,MAAM;AACZ,MAAM,MAAM;AAGZ,MAAM,eAA8B,uBAAM;AAC/C,MAAI;AACF,UAAM,QAAsB,QAAQ,OAAO;AAC3C,WAAO,MAAM,KAAK,OAAO,EAAE,SAAS,KAAK,CAAC,KAAK;AAAA,EACjD,QAAQ;AACN,WAAO;AAAA,EACT;AACF,GAAG;AAKI,MAAM,qBAAoC,uBAAM;AACrD,MAAI;AACF,UAAM,EAAE,WAAW,IAAkB,QAAQ,SAAS;AACtD,UAAM,OAAqB,QAAQ,WAAW;AAC9C,UAAM,QAAsB,QAAQ,OAAO;AAE3C,UAAM,SAAS,MAAM,KAAK,OAAO,EAAE,SAAS,KAAK,CAAC;AAClD,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAIA,UAAM,SAAS,KAAK,QAAQ,MAAM;AAClC,UAAM,kBAAkB,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,QAAI,WAAW,eAAe,GAAG;AAC/B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF,GAAG;AAGI,MAAM,mBAAmB;AAGzB,MAAM,aAAa;AACnB,MAAM,eAAe;AAGrB,MAAM,eAAe;AACrB,MAAM,oBAAoB;AAC1B,MAAM,sBAAsB;AAC5B,MAAM,YAAY;AAClB,MAAM,iBAAiB;AACvB,MAAM,YAAY;AAClB,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,gBAAgB;AAGtB,MAAM,sBAAsB;AAG5B,MAAM,YAAY;AAClB,MAAM,cAAc;",
-  "names": []
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,SAAAE,EAAA,aAAAC,EAAA,cAAAC,EAAA,QAAAC,EAAA,iBAAAC,EAAA,uBAAAC,EAAA,qBAAAC,EAAA,wBAAAC,EAAA,QAAAC,EAAA,cAAAC,EAAA,iBAAAC,EAAA,sBAAAC,EAAA,SAAAC,EAAA,cAAAC,EAAA,mBAAAC,EAAA,wBAAAC,EAAA,gBAAAC,EAAA,QAAAC,EAAA,kBAAAC,EAAA,SAAAC,EAAA,eAAAC,EAAA,iBAAAC,EAAA,cAAAC,IAAA,eAAAC,EAAAzB,GAMO,MAAMK,EAAM,MACNS,EAAO,OACPO,EAAO,OACPnB,EAAM,MACNiB,EAAM,MACNT,EAAM,MAGNJ,GAA8B,IAAM,CAC/C,GAAI,CAEF,MAD4B,SAAQ,OAAO,EAC9B,KAAK,MAAO,CAAE,QAAS,EAAK,CAAC,GAAK,KACjD,MAAQ,CACN,MAAO,KACT,CACF,GAAG,EAKUC,GAAoC,IAAM,CACrD,GAAI,CACF,KAAM,CAAE,WAAAmB,CAAW,EAAkB,QAAQ,SAAS,EAChDC,EAAqB,QAAQ,WAAW,EAGxCC,EAFsB,QAAQ,OAAO,EAEtB,KAAK,MAAO,CAAE,QAAS,EAAK,CAAC,EAClD,GAAI,CAACA,EACH,OAKF,MAAMC,EAASF,EAAK,QAAQC,CAAM,EAC5BE,EAAkBH,EAAK,KAC3BE,EACA,KACA,MACA,eACA,MACA,MACA,QACF,EACA,OAAIH,EAAWI,CAAe,EACrBA,EAET,MACF,MAAQ,CACN,MACF,CACF,GAAG,EAGUtB,EAAmB,6BAGnBc,EAAa,aACbC,EAAe,eAGfX,EAAe,eACfC,EAAoB,oBACpBJ,EAAsB,sBACtBM,EAAY,YACZC,EAAiB,iBACjBQ,EAAY,YACZrB,EAAW,WACXC,EAAY,YACZgB,EAAgB,gBAGhBH,EAAsB,sBAGtBN,EAAY,YACZO,EAAc",
+  "names": ["agents_exports", "__export", "BUN", "BUN_LOCK", "BUN_LOCKB", "NPM", "NPM_BIN_PATH", "NPM_REAL_EXEC_PATH", "NPM_REGISTRY_URL", "NPM_SHRINKWRAP_JSON", "NPX", "OVERRIDES", "PACKAGE_LOCK", "PACKAGE_LOCK_JSON", "PNPM", "PNPM_LOCK", "PNPM_LOCK_YAML", "PNPM_WORKSPACE_YAML", "RESOLUTIONS", "VLT", "VLT_LOCK_JSON", "YARN", "YARN_BERRY", "YARN_CLASSIC", "YARN_LOCK", "__toCommonJS", "existsSync", "path", "npmBin", "npmDir", "nodeModulesPath"]
 }

package/dist/constants/core.js

@@ -1,59 +1,4 @@
 /* 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 core_exports = {};
-__export(core_exports, {
-  COLUMN_LIMIT: () => COLUMN_LIMIT,
-  EMPTY_FILE: () => EMPTY_FILE,
-  EMPTY_VALUE: () => EMPTY_VALUE,
-  LOOP_SENTINEL: () => LOOP_SENTINEL,
-  NODE_AUTH_TOKEN: () => NODE_AUTH_TOKEN,
-  NODE_ENV: () => NODE_ENV,
-  UNDEFINED_TOKEN: () => UNDEFINED_TOKEN,
-  UNKNOWN_ERROR: () => UNKNOWN_ERROR,
-  UNKNOWN_VALUE: () => UNKNOWN_VALUE,
-  V: () => V,
-  kInternalsSymbol: () => kInternalsSymbol
-});
-module.exports = __toCommonJS(core_exports);
-const kInternalsSymbol = Symbol("@socketregistry.constants.internals");
-const LOOP_SENTINEL = 1e6;
-const UNKNOWN_ERROR = "Unknown error";
-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 NODE_AUTH_TOKEN = "NODE_AUTH_TOKEN";
-const NODE_ENV = "NODE_ENV";
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  COLUMN_LIMIT,
-  EMPTY_FILE,
-  EMPTY_VALUE,
-  LOOP_SENTINEL,
-  NODE_AUTH_TOKEN,
-  NODE_ENV,
-  UNDEFINED_TOKEN,
-  UNKNOWN_ERROR,
-  UNKNOWN_VALUE,
-  V,
-  kInternalsSymbol
-});
+var N=Object.defineProperty;var r=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var c=(t,o)=>{for(var e in o)N(t,e,{get:o[e],enumerable:!0})},O=(t,o,e,E)=>{if(o&&typeof o=="object"||typeof o=="function")for(let n of s(o))!_.call(t,n)&&n!==e&&N(t,n,{get:()=>o[n],enumerable:!(E=r(o,n))||E.enumerable});return t};var p=t=>O(N({},"__esModule",{value:!0}),t);var y={};c(y,{COLUMN_LIMIT:()=>V,EMPTY_FILE:()=>D,EMPTY_VALUE:()=>I,LOOP_SENTINEL:()=>T,NODE_AUTH_TOKEN:()=>a,NODE_ENV:()=>k,UNDEFINED_TOKEN:()=>l,UNKNOWN_ERROR:()=>U,UNKNOWN_VALUE:()=>L,V:()=>K,kInternalsSymbol:()=>x});module.exports=p(y);const x=Symbol("@socketregistry.constants.internals"),T=1e6,U="Unknown error",L="<unknown>",D=`/* empty */
+`,I="<value>",l=void 0,K="v",V=80,a="NODE_AUTH_TOKEN",k="NODE_ENV";0&&(module.exports={COLUMN_LIMIT,EMPTY_FILE,EMPTY_VALUE,LOOP_SENTINEL,NODE_AUTH_TOKEN,NODE_ENV,UNDEFINED_TOKEN,UNKNOWN_ERROR,UNKNOWN_VALUE,V,kInternalsSymbol});
 //# sourceMappingURL=core.js.map

package/dist/constants/core.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/constants/core.ts"],
   "sourcesContent": ["/**\n * Core primitives and fundamental constants.\n * Goal: Minimize this module by finding proper semantic homes for all constants.\n */\n\n// Internal implementation symbol.\nexport const kInternalsSymbol = Symbol('@socketregistry.constants.internals')\n\n// Sentinel values.\nexport const LOOP_SENTINEL = 1_000_000\n\n// Error and unknown values.\nexport const UNKNOWN_ERROR = 'Unknown error'\nexport const UNKNOWN_VALUE = '<unknown>'\n\n// Empty values.\nexport const EMPTY_FILE = '/* empty */\\n'\nexport const EMPTY_VALUE = '<value>'\n\n// Undefined token.\nexport const UNDEFINED_TOKEN = undefined\n\n// Miscellaneous.\nexport const V = 'v'\nexport const COLUMN_LIMIT = 80\n\n// Environment variable name constants.\nexport const NODE_AUTH_TOKEN = 'NODE_AUTH_TOKEN'\nexport const NODE_ENV = 'NODE_ENV'\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,MAAM,mBAAmB,OAAO,qCAAqC;AAGrE,MAAM,gBAAgB;AAGtB,MAAM,gBAAgB;AACtB,MAAM,gBAAgB;AAGtB,MAAM,aAAa;AACnB,MAAM,cAAc;AAGpB,MAAM,kBAAkB;AAGxB,MAAM,IAAI;AACV,MAAM,eAAe;AAGrB,MAAM,kBAAkB;AACxB,MAAM,WAAW;",
-  "names": []
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,EAAA,eAAAC,EAAA,gBAAAC,EAAA,kBAAAC,EAAA,oBAAAC,EAAA,aAAAC,EAAA,oBAAAC,EAAA,kBAAAC,EAAA,kBAAAC,EAAA,MAAAC,EAAA,qBAAAC,IAAA,eAAAC,EAAAb,GAMO,MAAMY,EAAmB,OAAO,qCAAqC,EAG/DP,EAAgB,IAGhBI,EAAgB,gBAChBC,EAAgB,YAGhBP,EAAa;AAAA,EACbC,EAAc,UAGdI,EAAkB,OAGlBG,EAAI,IACJT,EAAe,GAGfI,EAAkB,kBAClBC,EAAW",
+  "names": ["core_exports", "__export", "COLUMN_LIMIT", "EMPTY_FILE", "EMPTY_VALUE", "LOOP_SENTINEL", "NODE_AUTH_TOKEN", "NODE_ENV", "UNDEFINED_TOKEN", "UNKNOWN_ERROR", "UNKNOWN_VALUE", "V", "kInternalsSymbol", "__toCommonJS"]
 }

package/dist/constants/encoding.js

@@ -1,50 +1,3 @@
 /* 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 encoding_exports = {};
-__export(encoding_exports, {
-  CHAR_BACKWARD_SLASH: () => CHAR_BACKWARD_SLASH,
-  CHAR_COLON: () => CHAR_COLON,
-  CHAR_FORWARD_SLASH: () => CHAR_FORWARD_SLASH,
-  CHAR_LOWERCASE_A: () => CHAR_LOWERCASE_A,
-  CHAR_LOWERCASE_Z: () => CHAR_LOWERCASE_Z,
-  CHAR_UPPERCASE_A: () => CHAR_UPPERCASE_A,
-  CHAR_UPPERCASE_Z: () => CHAR_UPPERCASE_Z,
-  UTF8: () => UTF8
-});
-module.exports = __toCommonJS(encoding_exports);
-const UTF8 = "utf8";
-const CHAR_BACKWARD_SLASH = 92;
-const CHAR_COLON = 58;
-const CHAR_FORWARD_SLASH = 47;
-const CHAR_LOWERCASE_A = 97;
-const CHAR_LOWERCASE_Z = 122;
-const CHAR_UPPERCASE_A = 65;
-const CHAR_UPPERCASE_Z = 90;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  CHAR_BACKWARD_SLASH,
-  CHAR_COLON,
-  CHAR_FORWARD_SLASH,
-  CHAR_LOWERCASE_A,
-  CHAR_LOWERCASE_Z,
-  CHAR_UPPERCASE_A,
-  CHAR_UPPERCASE_Z,
-  UTF8
-});
+var C=Object.defineProperty;var H=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var e=Object.prototype.hasOwnProperty;var n=(t,A)=>{for(var R in A)C(t,R,{get:A[R],enumerable:!0})},p=(t,A,R,_)=>{if(A&&typeof A=="object"||typeof A=="function")for(let o of c(A))!e.call(t,o)&&o!==R&&C(t,o,{get:()=>A[o],enumerable:!(_=H(A,o))||_.enumerable});return t};var r=t=>p(C({},"__esModule",{value:!0}),t);var U={};n(U,{CHAR_BACKWARD_SLASH:()=>x,CHAR_COLON:()=>E,CHAR_FORWARD_SLASH:()=>S,CHAR_LOWERCASE_A:()=>L,CHAR_LOWERCASE_Z:()=>O,CHAR_UPPERCASE_A:()=>P,CHAR_UPPERCASE_Z:()=>W,UTF8:()=>s});module.exports=r(U);const s="utf8",x=92,E=58,S=47,L=97,O=122,P=65,W=90;0&&(module.exports={CHAR_BACKWARD_SLASH,CHAR_COLON,CHAR_FORWARD_SLASH,CHAR_LOWERCASE_A,CHAR_LOWERCASE_Z,CHAR_UPPERCASE_A,CHAR_UPPERCASE_Z,UTF8});
 //# sourceMappingURL=encoding.js.map

package/dist/constants/encoding.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/constants/encoding.ts"],
   "sourcesContent": ["/**\n * Character encodings and character codes.\n */\n\n// Encoding.\nexport const UTF8 = 'utf8'\n\n// Character codes.\nexport const CHAR_BACKWARD_SLASH = 92\nexport const CHAR_COLON = 58\nexport const CHAR_FORWARD_SLASH = 47\nexport const CHAR_LOWERCASE_A = 97\nexport const CHAR_LOWERCASE_Z = 122\nexport const CHAR_UPPERCASE_A = 65\nexport const CHAR_UPPERCASE_Z = 90\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,MAAM,OAAO;AAGb,MAAM,sBAAsB;AAC5B,MAAM,aAAa;AACnB,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,mBAAmB;AACzB,MAAM,mBAAmB;AACzB,MAAM,mBAAmB;",
-  "names": []
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,yBAAAE,EAAA,eAAAC,EAAA,uBAAAC,EAAA,qBAAAC,EAAA,qBAAAC,EAAA,qBAAAC,EAAA,qBAAAC,EAAA,SAAAC,IAAA,eAAAC,EAAAV,GAKO,MAAMS,EAAO,OAGPP,EAAsB,GACtBC,EAAa,GACbC,EAAqB,GACrBC,EAAmB,GACnBC,EAAmB,IACnBC,EAAmB,GACnBC,EAAmB",
+  "names": ["encoding_exports", "__export", "CHAR_BACKWARD_SLASH", "CHAR_COLON", "CHAR_FORWARD_SLASH", "CHAR_LOWERCASE_A", "CHAR_LOWERCASE_Z", "CHAR_UPPERCASE_A", "CHAR_UPPERCASE_Z", "UTF8", "__toCommonJS"]
 }

package/dist/constants/github.js

@@ -1,32 +1,3 @@
 /* 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 github_exports = {};
-__export(github_exports, {
-  CACHE_GITHUB_DIR: () => CACHE_GITHUB_DIR,
-  GITHUB_API_BASE_URL: () => GITHUB_API_BASE_URL
-});
-module.exports = __toCommonJS(github_exports);
-const GITHUB_API_BASE_URL = "https://api.github.com";
-const CACHE_GITHUB_DIR = "github";
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  CACHE_GITHUB_DIR,
-  GITHUB_API_BASE_URL
-});
+var I=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var A=(o,t)=>{for(var p in t)I(o,p,{get:t[p],enumerable:!0})},B=(o,t,p,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let _ of i(t))!s.call(o,_)&&_!==p&&I(o,_,{get:()=>t[_],enumerable:!(c=h(t,_))||c.enumerable});return o};var H=o=>B(I({},"__esModule",{value:!0}),o);var e={};A(e,{CACHE_GITHUB_DIR:()=>b,GITHUB_API_BASE_URL:()=>U});module.exports=H(e);const U="https://api.github.com",b="github";0&&(module.exports={CACHE_GITHUB_DIR,GITHUB_API_BASE_URL});
 //# sourceMappingURL=github.js.map

package/dist/constants/github.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/constants/github.ts"],
   "sourcesContent": ["/**\n * GitHub APIs and cache configuration.\n */\n\n// GitHub API.\nexport const GITHUB_API_BASE_URL = 'https://api.github.com'\n\n// GitHub cache.\nexport const CACHE_GITHUB_DIR = 'github'\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,MAAM,sBAAsB;AAG5B,MAAM,mBAAmB;",
-  "names": []
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,sBAAAE,EAAA,wBAAAC,IAAA,eAAAC,EAAAJ,GAKO,MAAMG,EAAsB,yBAGtBD,EAAmB",
+  "names": ["github_exports", "__export", "CACHE_GITHUB_DIR", "GITHUB_API_BASE_URL", "__toCommonJS"]
 }

package/dist/constants/licenses.js

@@ -1,68 +1,3 @@
 /* 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 licenses_exports = {};
-__export(licenses_exports, {
-  MIT: () => MIT,
-  UNLICENCED: () => UNLICENCED,
-  UNLICENSED: () => UNLICENSED,
-  getCopyLeftLicenses: () => getCopyLeftLicenses
-});
-module.exports = __toCommonJS(licenses_exports);
-const MIT = "MIT";
-const UNLICENCED = "UNLICENCED";
-const UNLICENSED = "UNLICENSED";
-let _copyLeftLicenses;
-function getCopyLeftLicenses() {
-  if (_copyLeftLicenses === void 0) {
-    _copyLeftLicenses = /* @__PURE__ */ new Set([
-      "AGPL-1.0",
-      "AGPL-1.0-only",
-      "AGPL-1.0-or-later",
-      "AGPL-3.0",
-      "AGPL-3.0-only",
-      "AGPL-3.0-or-later",
-      "CC-BY-SA-1.0",
-      "CC-BY-SA-2.0",
-      "CC-BY-SA-3.0",
-      "CC-BY-SA-4.0",
-      "EPL-1.0",
-      "EPL-2.0",
-      "EUPL-1.1",
-      "EUPL-1.2",
-      "GPL-1.0",
-      "GPL-1.0-only",
-      "GPL-1.0-or-later",
-      "GPL-2.0",
-      "GPL-2.0-only",
-      "GPL-2.0-or-later",
-      "GPL-3.0",
-      "GPL-3.0-only",
-      "GPL-3.0-or-later"
-    ]);
-  }
-  return _copyLeftLicenses;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  MIT,
-  UNLICENCED,
-  UNLICENSED,
-  getCopyLeftLicenses
-});
+var P=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var l=(e,L)=>{for(var o in L)P(e,o,{get:L[o],enumerable:!0})},A=(e,L,o,r)=>{if(L&&typeof L=="object"||typeof L=="function")for(let t of G(L))!E.call(e,t)&&t!==o&&P(e,t,{get:()=>L[t],enumerable:!(r=C(L,t))||r.enumerable});return e};var s=e=>A(P({},"__esModule",{value:!0}),e);var y={};l(y,{MIT:()=>S,UNLICENCED:()=>N,UNLICENSED:()=>c,getCopyLeftLicenses:()=>i});module.exports=s(y);const S="MIT",N="UNLICENCED",c="UNLICENSED";let n;function i(){return n===void 0&&(n=new Set(["AGPL-1.0","AGPL-1.0-only","AGPL-1.0-or-later","AGPL-3.0","AGPL-3.0-only","AGPL-3.0-or-later","CC-BY-SA-1.0","CC-BY-SA-2.0","CC-BY-SA-3.0","CC-BY-SA-4.0","EPL-1.0","EPL-2.0","EUPL-1.1","EUPL-1.2","GPL-1.0","GPL-1.0-only","GPL-1.0-or-later","GPL-2.0","GPL-2.0-only","GPL-2.0-or-later","GPL-3.0","GPL-3.0-only","GPL-3.0-or-later"])),n}0&&(module.exports={MIT,UNLICENCED,UNLICENSED,getCopyLeftLicenses});
 //# sourceMappingURL=licenses.js.map

package/dist/constants/licenses.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/constants/licenses.ts"],
   "sourcesContent": ["/**\n * License identifiers and copy-left license sets.\n */\n\n// License identifiers.\nexport const MIT = 'MIT'\nexport const UNLICENCED = 'UNLICENCED'\nexport const UNLICENSED = 'UNLICENSED'\n\n// Copy-left licenses.\nlet _copyLeftLicenses: Set<string>\nexport function getCopyLeftLicenses(): Set<string> {\n  if (_copyLeftLicenses === undefined) {\n    _copyLeftLicenses = new Set([\n      'AGPL-1.0',\n      'AGPL-1.0-only',\n      'AGPL-1.0-or-later',\n      'AGPL-3.0',\n      'AGPL-3.0-only',\n      'AGPL-3.0-or-later',\n      'CC-BY-SA-1.0',\n      'CC-BY-SA-2.0',\n      'CC-BY-SA-3.0',\n      'CC-BY-SA-4.0',\n      'EPL-1.0',\n      'EPL-2.0',\n      'EUPL-1.1',\n      'EUPL-1.2',\n      'GPL-1.0',\n      'GPL-1.0-only',\n      'GPL-1.0-or-later',\n      'GPL-2.0',\n      'GPL-2.0-only',\n      'GPL-2.0-or-later',\n      'GPL-3.0',\n      'GPL-3.0-only',\n      'GPL-3.0-or-later',\n    ])\n  }\n  return _copyLeftLicenses\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,MAAM,MAAM;AACZ,MAAM,aAAa;AACnB,MAAM,aAAa;AAG1B,IAAI;AACG,SAAS,sBAAmC;AACjD,MAAI,sBAAsB,QAAW;AACnC,wBAAoB,oBAAI,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AACT;",
-  "names": []
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,SAAAE,EAAA,eAAAC,EAAA,eAAAC,EAAA,wBAAAC,IAAA,eAAAC,EAAAN,GAKO,MAAME,EAAM,MACNC,EAAa,aACbC,EAAa,aAG1B,IAAIG,EACG,SAASF,GAAmC,CACjD,OAAIE,IAAsB,SACxBA,EAAoB,IAAI,IAAI,CAC1B,WACA,gBACA,oBACA,WACA,gBACA,oBACA,eACA,eACA,eACA,eACA,UACA,UACA,WACA,WACA,UACA,eACA,mBACA,UACA,eACA,mBACA,UACA,eACA,kBACF,CAAC,GAEIA,CACT",
+  "names": ["licenses_exports", "__export", "MIT", "UNLICENCED", "UNLICENSED", "getCopyLeftLicenses", "__toCommonJS", "_copyLeftLicenses"]
 }