@socketsecurity/lib 3.2.3 → 3.2.4

package/dist/constants/node.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/node.ts"],
-  "sourcesContent": ["/**\n * Node.js runtime: versions, features, flags, and capabilities.\n */\n\nconst NODE_VERSION = process.version\n\n// Version detection.\nexport function getNodeVersion(): string {\n  return NODE_VERSION\n}\n\nexport function getNodeMajorVersion(): number {\n  return Number.parseInt(NODE_VERSION.slice(1).split('.')[0] || '0', 10)\n}\n\n// Maintained Node.js versions.\nlet _maintainedNodeVersions:\n  | (readonly string[] & {\n      current: string\n      last: string\n      next: string\n      previous: string\n    })\n  | undefined\nexport function getMaintainedNodeVersions() {\n  if (_maintainedNodeVersions === undefined) {\n    try {\n      _maintainedNodeVersions = require('../lib/maintained-node-versions')\n    } catch {\n      _maintainedNodeVersions = Object.freeze(\n        Object.assign([], {\n          current: '',\n          last: '',\n          next: '',\n          previous: '',\n        }),\n      ) as typeof _maintainedNodeVersions\n    }\n  }\n  return _maintainedNodeVersions\n}\n\n// Feature detection.\nexport function supportsNodeCompileCacheApi(): boolean {\n  const major = getNodeMajorVersion()\n  return major >= 24\n}\n\nexport function supportsNodeCompileCacheEnvVar(): boolean {\n  const major = getNodeMajorVersion()\n  return major >= 22\n}\n\nexport function supportsNodeDisableWarningFlag(): boolean {\n  const major = getNodeMajorVersion()\n  return major >= 21\n}\n\nexport function supportsNodePermissionFlag(): boolean {\n  const major = getNodeMajorVersion()\n  return major >= 20\n}\n\nexport function supportsNodeRequireModule(): boolean {\n  const major = getNodeMajorVersion()\n  return (\n    major >= 23 ||\n    (major === 22 &&\n      Number.parseInt(NODE_VERSION.split('.')[1] || '0', 10) >= 12)\n  )\n}\n\nexport function supportsNodeRun(): boolean {\n  const major = getNodeMajorVersion()\n  return (\n    major >= 23 ||\n    (major === 22 &&\n      Number.parseInt(NODE_VERSION.split('.')[1] || '0', 10) >= 11)\n  )\n}\n\nexport function supportsNodeDisableSigusr1Flag(): boolean {\n  const major = getNodeMajorVersion()\n  // --disable-sigusr1 added in v22.14.0, v23.7.0.\n  // Stabilized in v22.20.0, v24.8.0.\n  if (major >= 24) {\n    const minor = Number.parseInt(NODE_VERSION.split('.')[1] || '0', 10)\n    return minor >= 8\n  }\n  if (major === 23) {\n    const minor = Number.parseInt(NODE_VERSION.split('.')[1] || '0', 10)\n    return minor >= 7\n  }\n  if (major === 22) {\n    const minor = Number.parseInt(NODE_VERSION.split('.')[1] || '0', 10)\n    return minor >= 14\n  }\n  return false\n}\n\nlet _nodeDisableSigusr1Flags: string[]\nexport function getNodeDisableSigusr1Flags(): string[] {\n  if (_nodeDisableSigusr1Flags === undefined) {\n    // SIGUSR1 is reserved by Node.js for starting the debugger/inspector.\n    // In production CLI environments, we want to prevent debugger attachment.\n    //\n    // --disable-sigusr1: Prevents Signal I/O Thread from listening to SIGUSR1 (v22.14.0+).\n    // --no-inspect: Disables inspector on older Node versions that don't support --disable-sigusr1.\n    //\n    // Note: --disable-sigusr1 is the correct solution (prevents thread creation entirely).\n    // --no-inspect is a fallback that still creates the signal handler thread but blocks later.\n    _nodeDisableSigusr1Flags = supportsNodeDisableSigusr1Flag()\n      ? ['--disable-sigusr1']\n      : ['--no-inspect']\n  }\n  return _nodeDisableSigusr1Flags\n}\n\nexport function supportsProcessSend(): boolean {\n  return typeof process.send === 'function'\n}\n\n// Node.js flags.\nlet _nodeHardenFlags: string[]\nexport function getNodeHardenFlags(): string[] {\n  if (_nodeHardenFlags === undefined) {\n    const major = getNodeMajorVersion()\n    const flags = [\n      '--disable-proto=delete',\n      // Node.js 24+ uses --permission instead of --experimental-permission.\n      // The permission model graduated from experimental to production-ready.\n      major >= 24 ? '--permission' : '--experimental-permission',\n      // Force uncaught exceptions policy for N-API addons (Node.js 22+).\n      '--force-node-api-uncaught-exceptions-policy',\n    ]\n    // Only add policy flag if we're using experimental permission (Node < 24).\n    // Node 24+ --policy requires a policy file which we don't have.\n    if (major < 24) {\n      flags.push('--experimental-policy')\n    }\n    _nodeHardenFlags = flags\n  }\n  return _nodeHardenFlags\n}\n\nlet _nodePermissionFlags: string[]\nexport function getNodePermissionFlags(): string[] {\n  if (_nodePermissionFlags === undefined) {\n    const major = getNodeMajorVersion()\n    // Node.js 24+ requires explicit permission grants when using --permission flag.\n    // npm needs filesystem access to read package.json files and node_modules.\n    if (major >= 24) {\n      _nodePermissionFlags = [\n        // Allow reading from the entire filesystem (npm needs to read package.json, node_modules, etc.).\n        '--allow-fs-read=*',\n        // Allow writing to the entire filesystem (npm needs to write to node_modules, cache, etc.).\n        '--allow-fs-write=*',\n        // Allow spawning child processes (npm needs to run lifecycle scripts, git, etc.).\n        '--allow-child-process',\n      ]\n    } else {\n      // Node.js 20-23 with --experimental-permission doesn't require explicit grants\n      // or uses different permission API.\n      _nodePermissionFlags = []\n    }\n  }\n  return _nodePermissionFlags\n}\n\nlet _nodeNoWarningsFlags: string[]\nexport function getNodeNoWarningsFlags(): string[] {\n  if (_nodeNoWarningsFlags === undefined) {\n    _nodeNoWarningsFlags = ['--no-warnings', '--no-deprecation']\n  }\n  return _nodeNoWarningsFlags\n}\n\n// Execution path.\nexport function getExecPath(): string {\n  return process.execPath\n}\n\n// Node.js constants.\nexport const NODE_SEA_FUSE = 'NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2'\nexport const ESNEXT = 'esnext'\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/constants/packages.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/packages.ts"],
-  "sourcesContent": ["/**\n * Package metadata, defaults, extensions, and lifecycle scripts.\n */\n\nimport { getNpmLifecycleEvent as getNpmLifecycleEventEnv } from '#env/npm'\n\nlet _lifecycleScriptNames: string[]\nlet _packageDefaultNodeRange: string | undefined\nlet _packageDefaultSocketCategories: readonly string[]\nlet _packageExtensions: Iterable<[string, unknown]>\nlet _pacoteCachePath: string\nlet _packumentCache: Map<string, unknown>\n\n// Package constants.\nexport const PACKAGE = 'package'\nexport const AT_LATEST = '@latest'\nexport const LATEST = 'latest'\nexport const PACKAGE_DEFAULT_VERSION = '1.0.0'\n\n// Package default Node range.\nexport function getPackageDefaultNodeRange(): string | undefined {\n  if (_packageDefaultNodeRange === undefined) {\n    try {\n      _packageDefaultNodeRange = require('../lib/package-default-node-range')\n    } catch {\n      _packageDefaultNodeRange = '>=18'\n    }\n  }\n  return _packageDefaultNodeRange\n}\n\n// Package default Socket categories.\nexport function getPackageDefaultSocketCategories() {\n  if (_packageDefaultSocketCategories === undefined) {\n    try {\n      _packageDefaultSocketCategories = require('../lib/package-default-socket-categories')\n    } catch {\n      _packageDefaultSocketCategories = []\n    }\n  }\n  return _packageDefaultSocketCategories\n}\n\n// Package extensions.\nexport function getPackageExtensions(): Iterable<[string, unknown]> {\n  if (_packageExtensions === undefined) {\n    try {\n      const exts = require('../lib/package-extensions')\n      _packageExtensions = Object.entries(exts)\n    } catch {\n      _packageExtensions = []\n    }\n  }\n  return _packageExtensions\n}\n\n// NPM lifecycle event.\nexport function getNpmLifecycleEvent(): string | undefined {\n  return getNpmLifecycleEventEnv()\n}\n\n// Lifecycle script names.\nexport function getLifecycleScriptNames(): string[] {\n  if (_lifecycleScriptNames === undefined) {\n    try {\n      _lifecycleScriptNames = require('../lib/lifecycle-script-names')\n    } catch {\n      _lifecycleScriptNames = []\n    }\n  }\n  return _lifecycleScriptNames\n}\n\n// Packument cache.\nexport function getPackumentCache(): Map<string, unknown> {\n  if (_packumentCache === undefined) {\n    _packumentCache = new Map()\n  }\n  return _packumentCache\n}\n\n// Pacote cache path.\nexport function getPacoteCachePath(): string {\n  if (_pacoteCachePath === undefined) {\n    try {\n      const pacote = require('../external/pacote')\n      const { normalizePath } = require('../lib/path')\n      const proto = Reflect.getPrototypeOf(\n        (pacote as { RegistryFetcher: { prototype: object } }).RegistryFetcher\n          .prototype,\n      ) as { constructor?: new (...args: unknown[]) => { cache: string } }\n      const PacoteFetcherBase = proto?.constructor\n      const cachePath = PacoteFetcherBase\n        ? new PacoteFetcherBase(/*dummy package spec*/ 'x', {}).cache\n        : ''\n      _pacoteCachePath = normalizePath(cachePath)\n    } catch {\n      _pacoteCachePath = ''\n    }\n  }\n  return _pacoteCachePath\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,iBAAgE;AAEhE,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAI;AAGG,MAAM,UAAU;AAChB,MAAM,YAAY;AAClB,MAAM,SAAS;AACf,MAAM,0BAA0B;AAGhC,SAAS,6BAAiD;AAC/D,MAAI,6BAA6B,QAAW;AAC1C,QAAI;AACF,iCAA2B,QAAQ,mCAAmC;AAAA,IACxE,QAAQ;AACN,iCAA2B;AAAA,IAC7B;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,oCAAoC;AAClD,MAAI,oCAAoC,QAAW;AACjD,QAAI;AACF,wCAAkC,QAAQ,0CAA0C;AAAA,IACtF,QAAQ;AACN,wCAAkC,CAAC;AAAA,IACrC;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,uBAAoD;AAClE,MAAI,uBAAuB,QAAW;AACpC,QAAI;AACF,YAAM,OAAO,QAAQ,2BAA2B;AAChD,2BAAqB,OAAO,QAAQ,IAAI;AAAA,IAC1C,QAAQ;AACN,2BAAqB,CAAC;AAAA,IACxB;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,uBAA2C;AACzD,aAAO,WAAAA,sBAAwB;AACjC;AAGO,SAAS,0BAAoC;AAClD,MAAI,0BAA0B,QAAW;AACvC,QAAI;AACF,8BAAwB,QAAQ,+BAA+B;AAAA,IACjE,QAAQ;AACN,8BAAwB,CAAC;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,oBAA0C;AACxD,MAAI,oBAAoB,QAAW;AACjC,sBAAkB,oBAAI,IAAI;AAAA,EAC5B;AACA,SAAO;AACT;AAGO,SAAS,qBAA6B;AAC3C,MAAI,qBAAqB,QAAW;AAClC,QAAI;AACF,YAAM,SAAS,QAAQ,oBAAoB;AAC3C,YAAM,EAAE,cAAc,IAAI,QAAQ,aAAa;AAC/C,YAAM,QAAQ,QAAQ;AAAA,QACnB,OAAsD,gBACpD;AAAA,MACL;AACA,YAAM,oBAAoB,OAAO;AACjC,YAAM,YAAY,oBACd,IAAI;AAAA;AAAA,QAAyC;AAAA,QAAK,CAAC;AAAA,MAAC,EAAE,QACtD;AACJ,yBAAmB,cAAc,SAAS;AAAA,IAC5C,QAAQ;AACN,yBAAmB;AAAA,IACrB;AAAA,EACF;AACA,SAAO;AACT;",
-  "names": ["getNpmLifecycleEventEnv"]
-}

package/dist/constants/paths.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/paths.ts"],
-  "sourcesContent": ["/**\n * File paths, directory names, extensions, and glob patterns.\n */\n\n// File names.\nexport const PACKAGE_JSON = 'package.json'\nexport const TSCONFIG_JSON = 'tsconfig.json'\nexport const LICENSE = 'LICENSE'\nexport const LICENSE_MD = 'LICENSE.md'\nexport const LICENSE_ORIGINAL = 'LICENSE.original'\nexport const README_MD = 'README.md'\nexport const CHANGELOG_MD = 'CHANGELOG.md'\nexport const MANIFEST_JSON = 'manifest.json'\nexport const EXTENSIONS_JSON = 'extensions.json'\nexport const ESLINT_CONFIG_JS = 'eslint.config.js'\nexport const GITIGNORE = '.gitignore'\nexport const DOT_PACKAGE_LOCK_JSON = '.package-lock.json'\n\n// Directory names.\nexport const NODE_MODULES = 'node_modules'\nexport const DOT_GIT_DIR = '.git'\nexport const DOT_GITHUB = '.github'\nexport const DOT_SOCKET_DIR = '.socket'\nexport const CACHE_DIR = 'cache'\nexport const CACHE_TTL_DIR = 'ttl'\n\n// Path patterns.\nexport const NODE_MODULES_GLOB_RECURSIVE = '**/node_modules'\nexport const SLASH_NODE_MODULES_SLASH = '/node_modules/'\n\n// File extensions.\nexport const EXT_CJS = '.cjs'\nexport const EXT_CMD = '.cmd'\nexport const EXT_CTS = '.cts'\nexport const EXT_DTS = '.d.ts'\nexport const EXT_JS = '.js'\nexport const EXT_JSON = '.json'\nexport const EXT_LOCK = '.lock'\nexport const EXT_LOCKB = '.lockb'\nexport const EXT_MD = '.md'\nexport const EXT_MJS = '.mjs'\nexport const EXT_MTS = '.mts'\nexport const EXT_PS1 = '.ps1'\nexport const EXT_YAML = '.yaml'\nexport const EXT_YML = '.yml'\n\n// Glob patterns.\nexport const LICENSE_GLOB = 'LICEN[CS]E{[.-]*,}'\nexport const LICENSE_GLOB_RECURSIVE = '**/LICEN[CS]E{[.-]*,}'\nexport const LICENSE_ORIGINAL_GLOB = '*.original{.*,}'\nexport const LICENSE_ORIGINAL_GLOB_RECURSIVE = '**/*.original{.*,}'\nexport const README_GLOB = 'README{.*,}'\nexport const README_GLOB_RECURSIVE = '**/README{.*,}'\n\n// Miscellaneous path constants.\nexport const EXTENSIONS = 'extensions'\nexport const ROLLUP_EXTERNAL_SUFFIX = '__rollup_external'\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,MAAM,eAAe;AACrB,MAAM,gBAAgB;AACtB,MAAM,UAAU;AAChB,MAAM,aAAa;AACnB,MAAM,mBAAmB;AACzB,MAAM,YAAY;AAClB,MAAM,eAAe;AACrB,MAAM,gBAAgB;AACtB,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;AACzB,MAAM,YAAY;AAClB,MAAM,wBAAwB;AAG9B,MAAM,eAAe;AACrB,MAAM,cAAc;AACpB,MAAM,aAAa;AACnB,MAAM,iBAAiB;AACvB,MAAM,YAAY;AAClB,MAAM,gBAAgB;AAGtB,MAAM,8BAA8B;AACpC,MAAM,2BAA2B;AAGjC,MAAM,UAAU;AAChB,MAAM,UAAU;AAChB,MAAM,UAAU;AAChB,MAAM,UAAU;AAChB,MAAM,SAAS;AACf,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,SAAS;AACf,MAAM,UAAU;AAChB,MAAM,UAAU;AAChB,MAAM,UAAU;AAChB,MAAM,WAAW;AACjB,MAAM,UAAU;AAGhB,MAAM,eAAe;AACrB,MAAM,yBAAyB;AAC/B,MAAM,wBAAwB;AAC9B,MAAM,kCAAkC;AACxC,MAAM,cAAc;AACpB,MAAM,wBAAwB;AAG9B,MAAM,aAAa;AACnB,MAAM,yBAAyB;",
-  "names": []
-}

package/dist/constants/platform.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/platform.ts"],
-  "sourcesContent": ["/**\n * Platform detection and OS-specific constants.\n */\n\nimport { platform } from 'os'\n\n// Platform detection.\nconst _platform = platform()\nexport const DARWIN = _platform === 'darwin'\nexport const WIN32 = _platform === 'win32'\n\n// File permission modes.\nexport const S_IXUSR = 0o100\nexport const S_IXGRP = 0o010\nexport const S_IXOTH = 0o001\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,gBAAyB;AAGzB,MAAM,gBAAY,oBAAS;AACpB,MAAM,SAAS,cAAc;AAC7B,MAAM,QAAQ,cAAc;AAG5B,MAAM,UAAU;AAChB,MAAM,UAAU;AAChB,MAAM,UAAU;",
-  "names": []
-}

package/dist/constants/process.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/process.ts"],
-  "sourcesContent": ["/**\n * Process control: abort signals and UI utilities.\n */\n\nimport type { Spinner } from '#lib/spinner'\n\n// Abort controller and signal.\nlet _abortController: AbortController\nexport function getAbortController(): AbortController {\n  if (_abortController === undefined) {\n    _abortController = new AbortController()\n  }\n  return _abortController\n}\n\nexport function getAbortSignal(): AbortSignal {\n  return getAbortController().signal\n}\n\n// Spinner instance.\nlet _spinner: Spinner | null | undefined\nexport function getSpinner(): Spinner | null {\n  if (_spinner === undefined) {\n    try {\n      const { Spinner: SpinnerFn } = require('../lib/spinner')\n      _spinner = SpinnerFn() ?? null\n    } catch {\n      _spinner = null\n    }\n  }\n  return _spinner ?? null\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,IAAI;AACG,SAAS,qBAAsC;AACpD,MAAI,qBAAqB,QAAW;AAClC,uBAAmB,IAAI,gBAAgB;AAAA,EACzC;AACA,SAAO;AACT;AAEO,SAAS,iBAA8B;AAC5C,SAAO,mBAAmB,EAAE;AAC9B;AAGA,IAAI;AACG,SAAS,aAA6B;AAC3C,MAAI,aAAa,QAAW;AAC1B,QAAI;AACF,YAAM,EAAE,SAAS,UAAU,IAAI,QAAQ,gBAAgB;AACvD,iBAAW,UAAU,KAAK;AAAA,IAC5B,QAAQ;AACN,iBAAW;AAAA,IACb;AAAA,EACF;AACA,SAAO,YAAY;AACrB;",
-  "names": []
-}

package/dist/constants/socket.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/socket.ts"],
-  "sourcesContent": ["/**\n * Socket.dev APIs, scopes, organizations, and application names.\n */\n\n// Socket.dev API.\nexport const SOCKET_API_BASE_URL = 'https://api.socket.dev/v0'\nexport const SOCKET_PUBLIC_API_KEY =\n  'sktsec_t_--RAN5U4ivauy4w37-6aoKyYPDt5ZbaT5JBVMqiwKo_api'\n// Alias for backward compatibility.\nexport const SOCKET_PUBLIC_API_TOKEN = SOCKET_PUBLIC_API_KEY\n\n// Socket.dev URLs.\nexport const SOCKET_WEBSITE_URL = 'https://socket.dev'\nexport const SOCKET_CONTACT_URL = 'https://socket.dev/contact'\nexport const SOCKET_DASHBOARD_URL = 'https://socket.dev/dashboard'\nexport const SOCKET_API_TOKENS_URL =\n  'https://socket.dev/dashboard/settings/api-tokens'\nexport const SOCKET_PRICING_URL = 'https://socket.dev/pricing'\nexport const SOCKET_STATUS_URL = 'https://status.socket.dev'\nexport const SOCKET_DOCS_URL = 'https://docs.socket.dev'\n\n// Socket.dev scopes.\nexport const SOCKET_REGISTRY_SCOPE = '@socketregistry'\nexport const SOCKET_SECURITY_SCOPE = '@socketsecurity'\nexport const SOCKET_OVERRIDE_SCOPE = '@socketoverride'\n\n// Socket.dev organization and repositories.\nexport const SOCKET_GITHUB_ORG = 'SocketDev'\nexport const SOCKET_REGISTRY_REPO_NAME = 'socket-registry'\nexport const SOCKET_REGISTRY_PACKAGE_NAME = '@socketsecurity/registry'\nexport const SOCKET_REGISTRY_NPM_ORG = 'socketregistry'\n\n// Socket.dev application names.\nexport const SOCKET_CLI_APP_NAME = 'socket'\nexport const SOCKET_DLX_APP_NAME = 'dlx'\nexport const SOCKET_FIREWALL_APP_NAME = 'sfw'\nexport const SOCKET_REGISTRY_APP_NAME = 'registry'\nexport const SOCKET_APP_PREFIX = '_'\n\n// Socket.dev IPC.\nexport const SOCKET_IPC_HANDSHAKE = 'SOCKET_IPC_HANDSHAKE'\n\n// Socket.dev cache and registry.\nexport const CACHE_SOCKET_API_DIR = 'socket-api'\nexport const REGISTRY = 'registry'\nexport const REGISTRY_SCOPE_DELIMITER = '__'\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;AAAA;AAAA;AAAA;AAKO,MAAM,sBAAsB;AAC5B,MAAM,wBACX;AAEK,MAAM,0BAA0B;AAGhC,MAAM,qBAAqB;AAC3B,MAAM,qBAAqB;AAC3B,MAAM,uBAAuB;AAC7B,MAAM,wBACX;AACK,MAAM,qBAAqB;AAC3B,MAAM,oBAAoB;AAC1B,MAAM,kBAAkB;AAGxB,MAAM,wBAAwB;AAC9B,MAAM,wBAAwB;AAC9B,MAAM,wBAAwB;AAG9B,MAAM,oBAAoB;AAC1B,MAAM,4BAA4B;AAClC,MAAM,+BAA+B;AACrC,MAAM,0BAA0B;AAGhC,MAAM,sBAAsB;AAC5B,MAAM,sBAAsB;AAC5B,MAAM,2BAA2B;AACjC,MAAM,2BAA2B;AACjC,MAAM,oBAAoB;AAG1B,MAAM,uBAAuB;AAG7B,MAAM,uBAAuB;AAC7B,MAAM,WAAW;AACjB,MAAM,2BAA2B;",
-  "names": []
-}

package/dist/constants/testing.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/testing.ts"],
-  "sourcesContent": ["/**\n * Testing framework constants and CI environment detection.\n */\n\n// Testing frameworks.\nexport const TEST = 'test'\nexport const VITEST = 'VITEST'\n\n// CI environment.\nexport const CI = 'CI'\nexport const PRE_COMMIT = 'PRE_COMMIT'\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,MAAM,OAAO;AACb,MAAM,SAAS;AAGf,MAAM,KAAK;AACX,MAAM,aAAa;",
-  "names": []
-}

package/dist/constants/time.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/time.ts"],
-  "sourcesContent": ["/**\n * Time-related constants including cache TTLs and timeouts.\n */\n\n// Time unit multipliers (milliseconds).\nexport const MILLISECONDS_PER_SECOND = 1000\nexport const MILLISECONDS_PER_MINUTE = 60 * MILLISECONDS_PER_SECOND\nexport const MILLISECONDS_PER_HOUR = 60 * MILLISECONDS_PER_MINUTE\nexport const MILLISECONDS_PER_DAY = 24 * MILLISECONDS_PER_HOUR\n\n// Cache TTL values.\n// DLX binary cache expires after 7 days.\nexport const DLX_BINARY_CACHE_TTL = 7 * MILLISECONDS_PER_DAY\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,MAAM,0BAA0B;AAChC,MAAM,0BAA0B,KAAK;AACrC,MAAM,wBAAwB,KAAK;AACnC,MAAM,uBAAuB,KAAK;AAIlC,MAAM,uBAAuB,IAAI;",
-  "names": []
-}

package/dist/constants/typescript.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/constants/typescript.ts"],
-  "sourcesContent": ["/**\n * TypeScript availability and type system checks.\n */\n\n// TypeScript types/libs availability.\nexport function getTsTypesAvailable(): boolean {\n  try {\n    require.resolve('typescript/lib/lib.d.ts')\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport function getTsLibsAvailable(): boolean {\n  try {\n    require.resolve('typescript/lib')\n    return true\n  } catch {\n    return false\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,SAAS,sBAA+B;AAC7C,MAAI;AACF,oBAAgB,yBAAyB;AACzC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,qBAA8B;AAC5C,MAAI;AACF,oBAAgB,gBAAgB;AAChC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;",
-  "names": []
-}

package/dist/cover/code.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/cover/code.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Code coverage utilities for parsing v8 coverage data.\n */\n\nimport { promises as fs } from 'fs'\n\nimport { readJson } from '../fs'\nimport { isObjectObject } from '../objects'\nimport { spawn } from '../spawn'\n\nimport type {\n  CodeCoverageResult,\n  CoverageMetric,\n  GetCodeCoverageOptions,\n  V8CoverageData,\n  V8FileCoverage,\n} from './types'\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path as typeof import('path')\n}\n\n/**\n * Get code coverage metrics from v8 coverage-final.json.\n *\n * @throws {Error} When coverage file doesn't exist and generateIfMissing is false.\n * @throws {Error} When coverage data format is invalid.\n */\nexport async function getCodeCoverage(\n  options?: GetCodeCoverageOptions | undefined,\n): Promise<CodeCoverageResult> {\n  const path = getPath()\n  const opts = {\n    __proto__: null,\n    coveragePath: path.join(process.cwd(), 'coverage/coverage-final.json'),\n    generateIfMissing: false,\n    ...options,\n  } as GetCodeCoverageOptions\n\n  const { coveragePath, generateIfMissing } = opts\n\n  if (!coveragePath) {\n    throw new Error('Coverage path is required')\n  }\n\n  // Check if coverage file exists.\n  const coverageExists = await fs\n    .access(coveragePath)\n    .then(() => true)\n    .catch(() => false)\n\n  if (!coverageExists) {\n    if (generateIfMissing) {\n      // Run vitest to generate coverage.\n      await spawn('vitest', ['run', '--coverage'], {\n        cwd: process.cwd(),\n        stdio: 'inherit',\n      })\n    } else {\n      throw new Error(\n        `Coverage file not found at \"${coveragePath}\". Run tests with coverage first.`,\n      )\n    }\n  }\n\n  // Read and parse coverage-final.json.\n  const coverageData = (await readJson(coveragePath)) as unknown\n\n  if (!isObjectObject(coverageData)) {\n    throw new Error(`Invalid coverage data format in \"${coveragePath}\"`)\n  }\n\n  // Aggregate metrics across all files.\n  const totals = {\n    __proto__: null,\n    branches: { __proto__: null, covered: 0, total: 0 },\n    functions: { __proto__: null, covered: 0, total: 0 },\n    lines: { __proto__: null, covered: 0, total: 0 },\n    statements: { __proto__: null, covered: 0, total: 0 },\n  }\n\n  const v8Data = coverageData as V8CoverageData\n\n  for (const fileCoverage of Object.values(v8Data)) {\n    if (!isObjectObject(fileCoverage)) {\n      continue\n    }\n\n    const fc = fileCoverage as V8FileCoverage\n\n    // Aggregate statements.\n    if (fc.s && isObjectObject(fc.s)) {\n      const statementCounts = Object.values(fc.s)\n      for (const count of statementCounts) {\n        if (typeof count === 'number') {\n          totals.statements.total += 1\n          if (count > 0) {\n            totals.statements.covered += 1\n          }\n        }\n      }\n    }\n\n    // Aggregate branches.\n    if (fc.b && isObjectObject(fc.b)) {\n      const branchCounts = Object.values(fc.b)\n      for (const branches of branchCounts) {\n        if (Array.isArray(branches)) {\n          for (const count of branches) {\n            if (typeof count === 'number') {\n              totals.branches.total += 1\n              if (count > 0) {\n                totals.branches.covered += 1\n              }\n            }\n          }\n        }\n      }\n    }\n\n    // Aggregate functions.\n    if (fc.f && isObjectObject(fc.f)) {\n      const functionCounts = Object.values(fc.f)\n      for (const count of functionCounts) {\n        if (typeof count === 'number') {\n          totals.functions.total += 1\n          if (count > 0) {\n            totals.functions.covered += 1\n          }\n        }\n      }\n    }\n\n    // Note: Lines are typically derived from statement map in v8.\n    // For simplicity, we use statements as a proxy for lines.\n    // In a production implementation, you'd parse statementMap to get actual line coverage.\n    totals.lines.covered = totals.statements.covered\n    totals.lines.total = totals.statements.total\n  }\n\n  // Calculate percentages.\n  return {\n    branches: calculateMetric(totals.branches),\n    functions: calculateMetric(totals.functions),\n    lines: calculateMetric(totals.lines),\n    statements: calculateMetric(totals.statements),\n  }\n}\n\n/**\n * Calculate coverage metric with percentage.\n */\nfunction calculateMetric(data: {\n  covered: number\n  total: number\n}): CoverageMetric {\n  const percent =\n    data.total === 0 ? '0.00' : ((data.covered / data.total) * 100).toFixed(2)\n\n  return {\n    covered: data.covered,\n    percent,\n    total: data.total,\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["import_fs", "fs"]
-}

package/dist/cover/formatters.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/cover/formatters.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Coverage output formatters.\n */\n\nimport { indentString } from '../strings'\n\nimport type { FormatCoverageOptions } from './types'\n\n/**\n * Coverage emoji thresholds for visual feedback.\n */\nconst COVERAGE_EMOJI_THRESHOLDS = [\n  { emoji: ' \uD83D\uDE80', threshold: 99 },\n  { emoji: ' \uD83C\uDFAF', threshold: 95 },\n  { emoji: ' \u2728', threshold: 90 },\n  { emoji: ' \uD83D\uDC9A', threshold: 85 },\n  { emoji: ' \u2705', threshold: 80 },\n  { emoji: ' \uD83D\uDFE2', threshold: 70 },\n  { emoji: ' \uD83D\uDFE1', threshold: 60 },\n  { emoji: ' \uD83D\uDD28', threshold: 50 },\n  { emoji: ' \u26A0\uFE0F', threshold: 0 },\n]\n\n/**\n * Get emoji for coverage percentage.\n */\nexport function getCoverageEmoji(percent: number): string {\n  const entry = COVERAGE_EMOJI_THRESHOLDS.find(\n    ({ threshold }) => percent >= threshold,\n  )\n  return entry?.emoji || ''\n}\n\n/**\n * Format coverage data for console output.\n */\nexport function formatCoverage(options: FormatCoverageOptions): string {\n  const opts = {\n    __proto__: null,\n    format: 'default' as const,\n    ...options,\n  } as Required<FormatCoverageOptions>\n\n  const { code, format, type } = opts\n\n  if (format === 'json') {\n    return JSON.stringify({ code, type }, null, 2)\n  }\n\n  const overall = calculateOverall(code, type)\n\n  if (format === 'simple') {\n    return overall\n  }\n\n  // Default format with emoji and details.\n  let output = ''\n\n  // Code coverage section.\n  output += 'Code Coverage:\\n'\n  output += indentString(`Statements: ${code.statements.percent}%\\n`, {\n    count: 2,\n  })\n  output += indentString(`Branches: ${code.branches.percent}%\\n`, { count: 2 })\n  output += indentString(`Functions: ${code.functions.percent}%\\n`, {\n    count: 2,\n  })\n  output += indentString(`Lines: ${code.lines.percent}%\\n`, { count: 2 })\n\n  // Type coverage section.\n  if (type) {\n    output += '\\nType Coverage:\\n'\n    output += indentString(\n      `${type.percent}% (${type.covered}/${type.total})\\n`,\n      { count: 2 },\n    )\n  }\n\n  // Overall.\n  const emoji = getCoverageEmoji(Number.parseFloat(overall))\n  output += `\\nOverall: ${overall}%${emoji}\\n`\n\n  return output\n}\n\n/**\n * Calculate overall coverage percentage.\n */\nfunction calculateOverall(\n  code: FormatCoverageOptions['code'],\n  type: FormatCoverageOptions['type'],\n): string {\n  const metrics = [\n    Number.parseFloat(code.statements.percent),\n    Number.parseFloat(code.branches.percent),\n    Number.parseFloat(code.functions.percent),\n    Number.parseFloat(code.lines.percent),\n  ]\n\n  if (type) {\n    metrics.push(Number.parseFloat(type.percent))\n  }\n\n  const average = metrics.reduce((sum, val) => sum + val, 0) / metrics.length\n  return average.toFixed(2)\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,qBAA6B;AAO7B,MAAM,4BAA4B;AAAA,EAChC,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,WAAM,WAAW,GAAG;AAAA,EAC7B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,WAAM,WAAW,GAAG;AAAA,EAC7B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,iBAAO,WAAW,EAAE;AAC/B;AAKO,SAAS,iBAAiB,SAAyB;AACxD,QAAM,QAAQ,0BAA0B;AAAA,IACtC,CAAC,EAAE,UAAU,MAAM,WAAW;AAAA,EAChC;AACA,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,eAAe,SAAwC;AACrE,QAAM,OAAO;AAAA,IACX,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,GAAG;AAAA,EACL;AAEA,QAAM,EAAE,MAAM,QAAQ,KAAK,IAAI;AAE/B,MAAI,WAAW,QAAQ;AACrB,WAAO,KAAK,UAAU,EAAE,MAAM,KAAK,GAAG,MAAM,CAAC;AAAA,EAC/C;AAEA,QAAM,UAAU,iBAAiB,MAAM,IAAI;AAE3C,MAAI,WAAW,UAAU;AACvB,WAAO;AAAA,EACT;AAGA,MAAI,SAAS;AAGb,YAAU;AACV,gBAAU,6BAAa,eAAe,KAAK,WAAW,OAAO;AAAA,GAAO;AAAA,IAClE,OAAO;AAAA,EACT,CAAC;AACD,gBAAU,6BAAa,aAAa,KAAK,SAAS,OAAO;AAAA,GAAO,EAAE,OAAO,EAAE,CAAC;AAC5E,gBAAU,6BAAa,cAAc,KAAK,UAAU,OAAO;AAAA,GAAO;AAAA,IAChE,OAAO;AAAA,EACT,CAAC;AACD,gBAAU,6BAAa,UAAU,KAAK,MAAM,OAAO;AAAA,GAAO,EAAE,OAAO,EAAE,CAAC;AAGtE,MAAI,MAAM;AACR,cAAU;AACV,kBAAU;AAAA,MACR,GAAG,KAAK,OAAO,MAAM,KAAK,OAAO,IAAI,KAAK,KAAK;AAAA;AAAA,MAC/C,EAAE,OAAO,EAAE;AAAA,IACb;AAAA,EACF;AAGA,QAAM,QAAQ,iBAAiB,OAAO,WAAW,OAAO,CAAC;AACzD,YAAU;AAAA,WAAc,OAAO,IAAI,KAAK;AAAA;AAExC,SAAO;AACT;AAKA,SAAS,iBACP,MACA,MACQ;AACR,QAAM,UAAU;AAAA,IACd,OAAO,WAAW,KAAK,WAAW,OAAO;AAAA,IACzC,OAAO,WAAW,KAAK,SAAS,OAAO;AAAA,IACvC,OAAO,WAAW,KAAK,UAAU,OAAO;AAAA,IACxC,OAAO,WAAW,KAAK,MAAM,OAAO;AAAA,EACtC;AAEA,MAAI,MAAM;AACR,YAAQ,KAAK,OAAO,WAAW,KAAK,OAAO,CAAC;AAAA,EAC9C;AAEA,QAAM,UAAU,QAAQ,OAAO,CAAC,KAAK,QAAQ,MAAM,KAAK,CAAC,IAAI,QAAQ;AACrE,SAAO,QAAQ,QAAQ,CAAC;AAC1B;",
-  "names": []
-}

package/dist/cover/type.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/cover/type.ts"],
-  "sourcesContent": ["/**\n * @fileoverview TypeScript type coverage utilities.\n */\n\nimport { spawn } from '../spawn'\n\nimport type { GetTypeCoverageOptions, TypeCoverageResult } from './types'\n\n/**\n * Get TypeScript type coverage metrics.\n *\n * @throws {Error} When type-coverage command fails (if generateIfMissing is false).\n */\nexport async function getTypeCoverage(\n  options?: GetTypeCoverageOptions | undefined,\n): Promise<TypeCoverageResult | null> {\n  const opts = {\n    __proto__: null,\n    cwd: process.cwd(),\n    generateIfMissing: false,\n    ...options,\n  } as GetTypeCoverageOptions\n\n  const { cwd, generateIfMissing } = opts\n\n  if (!cwd) {\n    throw new Error('Working directory is required.')\n  }\n\n  try {\n    // Run type-coverage to get metrics.\n    const result = await spawn('type-coverage', ['--detail'], {\n      cwd,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    })\n\n    // Parse output: \"1234 / 5678 48.92%\"\n    const outputText = result.stdout ? result.stdout.toString() : ''\n    const match = /(\\d+) \\/ (\\d+) ([\\d.]+)%/.exec(outputText)\n\n    if (!match || !match[1] || !match[2] || !match[3]) {\n      return null\n    }\n\n    return {\n      covered: Number.parseInt(match[1], 10),\n      percent: match[3],\n      total: Number.parseInt(match[2], 10),\n    }\n  } catch (e) {\n    if (generateIfMissing) {\n      throw new Error(\n        'Unable to generate type coverage. Ensure type-coverage is installed.',\n        { cause: e },\n      )\n    }\n    // If not generating, return null when type-coverage isn't available.\n    return null\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,mBAAsB;AAStB,eAAsB,gBACpB,SACoC;AACpC,QAAM,OAAO;AAAA,IACX,WAAW;AAAA,IACX,KAAK,QAAQ,IAAI;AAAA,IACjB,mBAAmB;AAAA,IACnB,GAAG;AAAA,EACL;AAEA,QAAM,EAAE,KAAK,kBAAkB,IAAI;AAEnC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD;AAEA,MAAI;AAEF,UAAM,SAAS,UAAM,oBAAM,iBAAiB,CAAC,UAAU,GAAG;AAAA,MACxD;AAAA,MACA,OAAO,CAAC,UAAU,QAAQ,MAAM;AAAA,IAClC,CAAC;AAGD,UAAM,aAAa,OAAO,SAAS,OAAO,OAAO,SAAS,IAAI;AAC9D,UAAM,QAAQ,2BAA2B,KAAK,UAAU;AAExD,QAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;AACjD,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,SAAS,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE;AAAA,MACrC,SAAS,MAAM,CAAC;AAAA,MAChB,OAAO,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE;AAAA,IACrC;AAAA,EACF,SAAS,GAAG;AACV,QAAI,mBAAmB;AACrB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,EAAE,OAAO,EAAE;AAAA,MACb;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;",
-  "names": []
-}

package/dist/cover/types.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/cover/types.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Type definitions for coverage utilities.\n */\n\n/**\n * Code coverage metrics for a single category.\n */\nexport type CoverageMetric = {\n  covered: number\n  percent: string\n  total: number\n}\n\n/**\n * Complete code coverage results from v8.\n */\nexport type CodeCoverageResult = {\n  branches: CoverageMetric\n  functions: CoverageMetric\n  lines: CoverageMetric\n  statements: CoverageMetric\n}\n\n/**\n * TypeScript type coverage results.\n */\nexport type TypeCoverageResult = {\n  covered: number\n  percent: string\n  total: number\n}\n\n/**\n * Options for getting code coverage.\n */\nexport type GetCodeCoverageOptions = {\n  coveragePath?: string | undefined\n  generateIfMissing?: boolean | undefined\n}\n\n/**\n * Options for getting type coverage.\n */\nexport type GetTypeCoverageOptions = {\n  cwd?: string | undefined\n  generateIfMissing?: boolean | undefined\n}\n\n/**\n * Output format for coverage display.\n */\nexport type CoverageFormat = 'default' | 'json' | 'simple'\n\n/**\n * Options for formatting coverage output.\n */\nexport type FormatCoverageOptions = {\n  code: CodeCoverageResult\n  format?: CoverageFormat | undefined\n  type?: TypeCoverageResult | undefined\n}\n\n/**\n * V8 coverage data structure for a single file.\n */\nexport type V8FileCoverage = {\n  b?: Record<string, number[]> | undefined\n  branchMap?: Record<string, unknown> | undefined\n  f?: Record<string, number> | undefined\n  fnMap?: Record<string, unknown> | undefined\n  path: string\n  s?: Record<string, number> | undefined\n  statementMap?: Record<string, unknown> | undefined\n}\n\n/**\n * V8 coverage-final.json structure.\n */\nexport type V8CoverageData = Record<string, V8FileCoverage>\n"],
-  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
-  "names": []
-}

package/dist/debug.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/debug.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Debug logging utilities with lazy loading and environment-based control.\n * Provides Socket CLI specific debug functionality and logging formatters.\n */\n\nimport { getSpinner } from '#constants/process'\nimport { getDebug } from '#env/debug'\nimport { getSocketDebug } from '#env/socket'\nimport isUnicodeSupported from './external/@socketregistry/is-unicode-supported'\nimport debugJs from './external/debug'\n\nimport { getDefaultLogger } from './logger'\nimport { hasOwn } from './objects'\nimport { applyLinePrefix } from './strings'\n\nconst logger = getDefaultLogger()\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst ReflectApply = Reflect.apply\n\n// Type definitions\ninterface DebugOptions {\n  namespaces?: string\n  spinner?: { isSpinning: boolean; stop(): void; start(): void }\n  [key: string]: unknown\n}\n\ntype NamespacesOrOptions = string | DebugOptions\n\ninterface InspectOptions {\n  depth?: number | null\n  colors?: boolean\n  [key: string]: unknown\n}\n\nexport type { DebugOptions, NamespacesOrOptions, InspectOptions }\n\nconst debugByNamespace = new Map()\n/**\n * Get or create a debug instance for a namespace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getDebugJsInstance(namespace: string) {\n  let inst = debugByNamespace.get(namespace)\n  if (inst) {\n    return inst\n  }\n  if (\n    !getDebug() &&\n    getSocketDebug() &&\n    (namespace === 'error' || namespace === 'notice')\n  ) {\n    debugJs.enable(namespace)\n  }\n  inst = debugJs(namespace)\n  inst.log = customLog\n  debugByNamespace.set(namespace, inst)\n  return inst\n}\n\nlet _util: typeof import('util') | undefined\n/**\n * Lazily load the util module.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getUtil() {\n  if (_util === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _util = /*@__PURE__*/ require('node:util')\n  }\n  return _util as typeof import('util')\n}\n\n/**\n * Extract caller information from the stack trace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getCallerInfo(stackOffset: number = 3): string {\n  let name = ''\n  const captureStackTrace = Error.captureStackTrace\n  if (typeof captureStackTrace === 'function') {\n    const obj: { stack?: unknown } = {}\n    captureStackTrace(obj, getCallerInfo)\n    const stack = obj.stack\n    if (typeof stack === 'string') {\n      let lineCount = 0\n      let lineStart = 0\n      for (let i = 0, { length } = stack; i < length; i += 1) {\n        if (stack[i] === '\\n') {\n          lineCount += 1\n          if (lineCount < stackOffset) {\n            // Store the start index of the next line.\n            lineStart = i + 1\n          } else {\n            // Extract the full line and trim it.\n            const line = stack.slice(lineStart, i).trimStart()\n            // Match the function name portion (e.g., \"async runFix\").\n            const match = /(?<=^at\\s+).*?(?=\\s+\\(|$)/.exec(line)?.[0]\n            if (match) {\n              name = match\n                // Strip known V8 invocation prefixes to get the name.\n                .replace(/^(?:async|bound|get|new|set)\\s+/, '')\n              if (name.startsWith('Object.')) {\n                // Strip leading 'Object.' if not an own property of Object.\n                const afterDot = name.slice(7 /*'Object.'.length*/)\n                if (!hasOwn(Object, afterDot)) {\n                  name = afterDot\n                }\n              }\n            }\n            break\n          }\n        }\n      }\n    }\n  }\n  return name\n}\n\n/**\n * Custom log function for debug output.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction customLog(...args: unknown[]) {\n  const util = getUtil()\n  const inspectOpts = debugJs.inspectOpts\n    ? {\n        ...debugJs.inspectOpts,\n        showHidden:\n          debugJs.inspectOpts.showHidden === null\n            ? undefined\n            : debugJs.inspectOpts.showHidden,\n        depth:\n          debugJs.inspectOpts.depth === null ||\n          typeof debugJs.inspectOpts.depth === 'boolean'\n            ? undefined\n            : debugJs.inspectOpts.depth,\n      }\n    : {}\n  ReflectApply(logger.info, logger, [\n    util.formatWithOptions(inspectOpts, ...args),\n  ])\n}\n\n/**\n * Extract options from namespaces parameter.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction extractOptions(namespaces: NamespacesOrOptions): DebugOptions {\n  return namespaces !== null && typeof namespaces === 'object'\n    ? ({ __proto__: null, ...namespaces } as DebugOptions)\n    : ({ __proto__: null, namespaces } as DebugOptions)\n}\n\n/**\n * Check if debug is enabled for given namespaces.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isEnabled(namespaces: string | undefined) {\n  // Check if debugging is enabled at all\n  if (!getSocketDebug()) {\n    return false\n  }\n  if (typeof namespaces !== 'string' || !namespaces || namespaces === '*') {\n    return true\n  }\n  // Namespace splitting logic is based the 'debug' package implementation:\n  // https://github.com/debug-js/debug/blob/4.4.1/src/common.js#L169-L173.\n  const split = namespaces\n    .trim()\n    .replace(/\\s+/g, ',')\n    .split(',')\n    .filter(Boolean)\n  const names = []\n  const skips = []\n  for (const ns of split) {\n    if (ns.startsWith('-')) {\n      skips.push(ns.slice(1))\n    } else {\n      names.push(ns)\n    }\n  }\n  if (names.length && !names.some(ns => getDebugJsInstance(ns).enabled)) {\n    return false\n  }\n  return skips.every(ns => !getDebugJsInstance(ns).enabled)\n}\n\n/**\n * Debug output for object inspection with caller info.\n */\nfunction debugDirNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugDirNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  let opts: InspectOptions | undefined = inspectOpts\n  if (opts === undefined) {\n    const debugOpts = debugJs.inspectOpts\n    if (debugOpts) {\n      opts = {\n        ...debugOpts,\n        showHidden:\n          debugOpts.showHidden === null ? undefined : debugOpts.showHidden,\n        depth:\n          debugOpts.depth === null || typeof debugOpts.depth === 'boolean'\n            ? null\n            : debugOpts.depth,\n      } as InspectOptions\n    }\n  }\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  logger.info(`[DEBUG] ${callerName} ${pointingTriangle} object inspection:`)\n  logger.dir(obj, inspectOpts)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\nlet pointingTriangle: string | undefined\n/**\n * Debug output with caller info.\n */\nfunction debugNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugNs -> getCallerInfo).\n  const name = getCallerInfo(4) || 'anonymous'\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${name ? `${name} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : args\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug logging function with caller info.\n */\nfunction debugLogNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugLogNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${callerName ? `${callerName} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : [`[DEBUG] ${callerName} ${pointingTriangle}`, ...args]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug output for cache operations with caller info.\n * First argument is the operation type (hit/miss/set/clear).\n * Second argument is the cache key or message.\n * Optional third argument is metadata object.\n */\nfunction debugCacheNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugCacheNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const logArgs = meta !== undefined ? [prefix, meta] : [prefix]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Cache debug function with caller info.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function debugCache(\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n): void {\n  if (!getSocketDebug()) {\n    return\n  }\n  // Get caller info with stack offset of 3 (caller -> debugCache -> getCallerInfo).\n  const callerName = getCallerInfo(3) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const args = meta !== undefined ? [prefix, meta] : [prefix]\n  console.log(...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebugNs(namespaces: string | undefined): boolean {\n  return !!getSocketDebug() && isEnabled(namespaces)\n}\n\n/**\n * Debug output with caller info (wrapper for debugNs with default namespace).\n */\nfunction debug(...args: unknown[]): void {\n  debugNs('*', ...args)\n}\n\n/**\n * Debug output for object inspection (wrapper for debugDirNs with default namespace).\n */\nfunction debugDir(\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n): void {\n  debugDirNs('*', obj, inspectOpts)\n}\n\n/**\n * Debug logging function (wrapper for debugLogNs with default namespace).\n */\nfunction debugLog(...args: unknown[]): void {\n  debugLogNs('*', ...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebug(): boolean {\n  return !!getSocketDebug()\n}\n\n/**\n * Create a Node.js util.debuglog compatible function.\n * Returns a function that conditionally writes debug messages to stderr.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debuglog(section: string) {\n  const util = getUtil()\n  return util.debuglog(section)\n}\n\n/**\n * Create timing functions for measuring code execution time.\n * Returns an object with start() and end() methods, plus a callable function.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debugtime(label: string) {\n  const util = getUtil()\n  // Node.js util doesn't have debugtime - create a custom implementation\n  let startTime: number | undefined\n  const impl = () => {\n    if (startTime === undefined) {\n      startTime = Date.now()\n    } else {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  impl.start = () => {\n    startTime = Date.now()\n  }\n  impl.end = () => {\n    if (startTime !== undefined) {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  return impl\n}\n\n// Export main debug functions with caller info.\nexport { debug }\n// debugCache is already exported directly above\nexport { debugCacheNs }\nexport { debugDir }\nexport { debugDirNs }\nexport { debugLog }\nexport { debuglog }\nexport { debugLogNs }\nexport { debugNs }\nexport { debugtime }\nexport { isDebug }\nexport { isDebugNs }\n"],
-  "mappings": "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",
-  "names": ["import_debug", "debugJs", "isUnicodeSupported"]
-}

package/dist/dlx-binary.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/dlx-binary.ts"],
-  "sourcesContent": ["/** @fileoverview DLX binary execution utilities for Socket ecosystem. */\n\nimport { createHash } from 'crypto'\n\nimport os from 'os'\n\nimport path from 'path'\n\nimport { WIN32 } from '#constants/platform'\n\nimport { generateCacheKey } from './dlx'\nimport { dlxManifest } from './dlx-manifest'\nimport { httpDownload } from './http-request'\nimport { isDir, readJson, safeDelete, safeMkdir } from './fs'\nimport { isObjectObject } from './objects'\nimport { normalizePath } from './path'\nimport { getSocketDlxDir } from './paths'\nimport { processLock } from './process-lock'\nimport type { SpawnExtra, SpawnOptions } from './spawn'\nimport { spawn } from './spawn'\n\nlet _fs: typeof import('fs') | undefined\n/**\n * Lazily load the fs module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js fs module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFs() {\n  if (_fs === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _fs = /*@__PURE__*/ require('node:fs')\n  }\n  return _fs as typeof import('fs')\n}\n\nexport interface DlxBinaryOptions {\n  /**\n   * URL to download the binary from.\n   */\n  url: string\n\n  /**\n   * Optional name for the cached binary (defaults to URL hash).\n   */\n  name?: string | undefined\n\n  /**\n   * Expected checksum (sha256) for verification.\n   */\n  checksum?: string | undefined\n\n  /**\n   * Cache TTL in milliseconds (default: 7 days).\n   */\n  cacheTtl?: number | undefined\n\n  /**\n   * Force re-download even if cached.\n   * Aligns with npm/npx --force flag.\n   */\n  force?: boolean | undefined\n\n  /**\n   * Skip confirmation prompts (auto-approve).\n   * Aligns with npx --yes/-y flag.\n   */\n  yes?: boolean | undefined\n\n  /**\n   * Suppress output (quiet mode).\n   * Aligns with npx --quiet/-q and pnpm --silent/-s flags.\n   */\n  quiet?: boolean | undefined\n\n  /**\n   * Additional spawn options.\n   */\n  spawnOptions?: SpawnOptions | undefined\n}\n\nexport interface DlxBinaryResult {\n  /** Path to the cached binary. */\n  binaryPath: string\n  /** Whether the binary was newly downloaded. */\n  downloaded: boolean\n  /** The spawn promise for the running process. */\n  spawnPromise: ReturnType<typeof spawn>\n}\n\n/**\n * Metadata structure for cached binaries (.dlx-metadata.json).\n * Unified schema shared across TypeScript (dlxBinary) and C++ (socket_macho_decompress).\n *\n * Core Fields (present in all implementations):\n * - version: Schema version (currently \"1.0.0\")\n * - cache_key: First 16 chars of SHA-512 hash (matches directory name)\n * - timestamp: Unix timestamp in milliseconds\n * - checksum: Full hash of cached binary (SHA-512 for C++, SHA-256 for TypeScript)\n * - checksum_algorithm: \"sha512\" or \"sha256\"\n * - platform: \"darwin\" | \"linux\" | \"win32\"\n * - arch: \"x64\" | \"arm64\"\n * - size: Size of cached binary in bytes\n * - source: Origin information\n *   - type: \"download\" (from URL) or \"decompression\" (from embedded binary)\n *   - url: Download URL (if type is \"download\")\n *   - path: Source binary path (if type is \"decompression\")\n *\n * Extra Fields (implementation-specific):\n * - For C++ decompression:\n *   - compressed_size: Size of compressed data in bytes\n *   - compression_algorithm: Brotli level (numeric)\n *   - compression_ratio: original_size / compressed_size\n *\n * Example (TypeScript download):\n * ```json\n * {\n *   \"version\": \"1.0.0\",\n *   \"cache_key\": \"a1b2c3d4e5f67890\",\n *   \"timestamp\": 1730332800000,\n *   \"checksum\": \"sha256-abc123...\",\n *   \"checksum_algorithm\": \"sha256\",\n *   \"platform\": \"darwin\",\n *   \"arch\": \"arm64\",\n *   \"size\": 15000000,\n *   \"source\": {\n *     \"type\": \"download\",\n *     \"url\": \"https://example.com/binary\"\n *   }\n * }\n * ```\n *\n * Example (C++ decompression):\n * ```json\n * {\n *   \"version\": \"1.0.0\",\n *   \"cache_key\": \"0123456789abcdef\",\n *   \"timestamp\": 1730332800000,\n *   \"checksum\": \"sha512-def456...\",\n *   \"checksum_algorithm\": \"sha512\",\n *   \"platform\": \"darwin\",\n *   \"arch\": \"arm64\",\n *   \"size\": 13000000,\n *   \"source\": {\n *     \"type\": \"decompression\",\n *     \"path\": \"/usr/local/bin/socket\"\n *   },\n *   \"extra\": {\n *     \"compressed_size\": 1700000,\n *     \"compression_algorithm\": 3,\n *     \"compression_ratio\": 7.647\n *   }\n * }\n * ```\n *\n * @internal This interface documents the metadata file format.\n */\nexport interface DlxMetadata {\n  version: string\n  cache_key: string\n  timestamp: number\n  checksum: string\n  checksum_algorithm: string\n  platform: string\n  arch: string\n  size: number\n  source?: {\n    type: 'download' | 'decompression'\n    url?: string\n    path?: string\n  }\n  extra?: Record<string, unknown>\n}\n\n/**\n * Get metadata file path for a cached binary.\n */\nfunction getMetadataPath(cacheEntryPath: string): string {\n  return path.join(cacheEntryPath, '.dlx-metadata.json')\n}\n\n/**\n * Check if a cached binary is still valid.\n */\nasync function isCacheValid(\n  cacheEntryPath: string,\n  cacheTtl: number,\n): Promise<boolean> {\n  const fs = getFs()\n  try {\n    const metaPath = getMetadataPath(cacheEntryPath)\n    if (!fs.existsSync(metaPath)) {\n      return false\n    }\n\n    const metadata = await readJson(metaPath, { throws: false })\n    if (!isObjectObject(metadata)) {\n      return false\n    }\n    const now = Date.now()\n    const timestamp = (metadata as Record<string, unknown>)['timestamp']\n    // If timestamp is missing or invalid, cache is invalid\n    if (typeof timestamp !== 'number' || timestamp <= 0) {\n      return false\n    }\n    const age = now - timestamp\n\n    return age < cacheTtl\n  } catch {\n    return false\n  }\n}\n\n/**\n * Download a file from a URL with integrity checking and concurrent download protection.\n * Uses processLock to prevent multiple processes from downloading the same binary simultaneously.\n * Internal helper function for downloading binary files.\n */\nasync function downloadBinaryFile(\n  url: string,\n  destPath: string,\n  checksum?: string | undefined,\n): Promise<string> {\n  // Use process lock to prevent concurrent downloads.\n  // Lock is placed in the cache entry directory as 'concurrency.lock'.\n  const cacheEntryDir = path.dirname(destPath)\n  const lockPath = path.join(cacheEntryDir, 'concurrency.lock')\n\n  return await processLock.withLock(\n    lockPath,\n    async () => {\n      const fs = getFs()\n      // Check if file was downloaded while waiting for lock.\n      if (fs.existsSync(destPath)) {\n        const stats = await fs.promises.stat(destPath)\n        if (stats.size > 0) {\n          // File exists, compute and return checksum.\n          const fileBuffer = await fs.promises.readFile(destPath)\n          const hasher = createHash('sha256')\n          hasher.update(fileBuffer)\n          return hasher.digest('hex')\n        }\n      }\n\n      // Download the file.\n      try {\n        await httpDownload(url, destPath)\n      } catch (e) {\n        throw new Error(\n          `Failed to download binary from ${url}\\n` +\n            `Destination: ${destPath}\\n` +\n            'Check your internet connection or verify the URL is accessible.',\n          { cause: e },\n        )\n      }\n\n      // Compute checksum of downloaded file.\n      const fileBuffer = await fs.promises.readFile(destPath)\n      const hasher = createHash('sha256')\n      hasher.update(fileBuffer)\n      const actualChecksum = hasher.digest('hex')\n\n      // Verify checksum if provided.\n      if (checksum && actualChecksum !== checksum) {\n        // Clean up invalid file.\n        await safeDelete(destPath)\n        throw new Error(\n          `Checksum mismatch: expected ${checksum}, got ${actualChecksum}`,\n        )\n      }\n\n      // Make executable on POSIX systems.\n      if (!WIN32) {\n        await fs.promises.chmod(destPath, 0o755)\n      }\n\n      return actualChecksum\n    },\n    {\n      // Align with npm npx locking strategy.\n      staleMs: 5000,\n      touchIntervalMs: 2000,\n    },\n  )\n}\n\n/**\n * Write metadata for a cached binary.\n * Writes to both per-directory metadata file (for backward compatibility)\n * and global manifest (~/.socket/_dlx/.dlx-manifest.json).\n * Uses unified schema shared with C++ decompressor and CLI dlxBinary.\n * Schema documentation: See DlxMetadata interface in this file (exported).\n * Core fields: version, cache_key, timestamp, checksum, checksum_algorithm, platform, arch, size, source\n * Note: This implementation uses SHA-256 checksums instead of SHA-512.\n */\nasync function writeMetadata(\n  cacheEntryPath: string,\n  cacheKey: string,\n  url: string,\n  binaryName: string,\n  checksum: string,\n  size: number,\n): Promise<void> {\n  // Write per-directory metadata file for backward compatibility.\n  const metaPath = getMetadataPath(cacheEntryPath)\n  const metadata = {\n    version: '1.0.0',\n    cache_key: cacheKey,\n    timestamp: Date.now(),\n    checksum,\n    checksum_algorithm: 'sha256',\n    platform: os.platform(),\n    arch: os.arch(),\n    size,\n    source: {\n      type: 'download',\n      url,\n    },\n  }\n  const fs = getFs()\n  await fs.promises.writeFile(metaPath, JSON.stringify(metadata, null, 2))\n\n  // Write to global manifest.\n  try {\n    const spec = `${url}:${binaryName}`\n    await dlxManifest.setBinaryEntry(spec, cacheKey, {\n      checksum,\n      checksum_algorithm: 'sha256',\n      platform: os.platform(),\n      arch: os.arch(),\n      size,\n      source: {\n        type: 'download',\n        url,\n      },\n    })\n  } catch {\n    // Silently ignore manifest write errors - not critical.\n    // The per-directory metadata is the source of truth for now.\n  }\n}\n\n/**\n * Clean expired entries from the DLX cache.\n */\nexport async function cleanDlxCache(\n  maxAge: number = /*@__INLINE__*/ require('#constants/time').DLX_BINARY_CACHE_TTL,\n): Promise<number> {\n  const cacheDir = getDlxCachePath()\n  const fs = getFs()\n\n  if (!fs.existsSync(cacheDir)) {\n    return 0\n  }\n\n  let cleaned = 0\n  const now = Date.now()\n  const entries = await fs.promises.readdir(cacheDir)\n\n  for (const entry of entries) {\n    const entryPath = path.join(cacheDir, entry)\n    const metaPath = getMetadataPath(entryPath)\n\n    try {\n      // eslint-disable-next-line no-await-in-loop\n      if (!(await isDir(entryPath))) {\n        continue\n      }\n\n      // eslint-disable-next-line no-await-in-loop\n      const metadata = await readJson(metaPath, { throws: false })\n      if (\n        !metadata ||\n        typeof metadata !== 'object' ||\n        Array.isArray(metadata)\n      ) {\n        continue\n      }\n      const timestamp = (metadata as Record<string, unknown>)['timestamp']\n      // If timestamp is missing or invalid, treat as expired (age = infinity)\n      const age =\n        typeof timestamp === 'number' && timestamp > 0\n          ? now - timestamp\n          : Number.POSITIVE_INFINITY\n\n      if (age > maxAge) {\n        // Remove entire cache entry directory.\n        // eslint-disable-next-line no-await-in-loop\n        await safeDelete(entryPath, { force: true, recursive: true })\n        cleaned += 1\n      }\n    } catch {\n      // If we can't read metadata, check if directory is empty or corrupted.\n      try {\n        // eslint-disable-next-line no-await-in-loop\n        const contents = await fs.promises.readdir(entryPath)\n        if (!contents.length) {\n          // Remove empty directory.\n          // eslint-disable-next-line no-await-in-loop\n          await safeDelete(entryPath)\n          cleaned += 1\n        }\n      } catch {}\n    }\n  }\n\n  return cleaned\n}\n\n/**\n * Download and execute a binary from a URL with caching.\n */\nexport async function dlxBinary(\n  args: readonly string[] | string[],\n  options?: DlxBinaryOptions | undefined,\n  spawnExtra?: SpawnExtra | undefined,\n): Promise<DlxBinaryResult> {\n  const {\n    cacheTtl = /*@__INLINE__*/ require('#constants/time').DLX_BINARY_CACHE_TTL,\n    checksum,\n    force: userForce = false,\n    name,\n    spawnOptions,\n    url,\n    yes,\n  } = { __proto__: null, ...options } as DlxBinaryOptions\n\n  // Map --yes flag to force behavior (auto-approve/skip prompts)\n  const force = yes === true ? true : userForce\n\n  // Generate cache paths similar to pnpm/npx structure.\n  const cacheDir = getDlxCachePath()\n  const binaryName = name || `binary-${process.platform}-${os.arch()}`\n  // Create spec from URL and binary name for unique cache identity.\n  const spec = `${url}:${binaryName}`\n  const cacheKey = generateCacheKey(spec)\n  const cacheEntryDir = path.join(cacheDir, cacheKey)\n  const binaryPath = normalizePath(path.join(cacheEntryDir, binaryName))\n  const fs = getFs()\n\n  let downloaded = false\n  let computedChecksum = checksum\n\n  // Check if we need to download.\n  if (\n    !force &&\n    fs.existsSync(cacheEntryDir) &&\n    (await isCacheValid(cacheEntryDir, cacheTtl))\n  ) {\n    // Binary is cached and valid, read the checksum from metadata.\n    try {\n      const metaPath = getMetadataPath(cacheEntryDir)\n      const metadata = await readJson(metaPath, { throws: false })\n      if (\n        metadata &&\n        typeof metadata === 'object' &&\n        !Array.isArray(metadata) &&\n        typeof (metadata as Record<string, unknown>)['checksum'] === 'string'\n      ) {\n        computedChecksum = (metadata as Record<string, unknown>)[\n          'checksum'\n        ] as string\n      } else {\n        // If metadata is invalid, re-download.\n        downloaded = true\n      }\n    } catch {\n      // If we can't read metadata, re-download.\n      downloaded = true\n    }\n  } else {\n    downloaded = true\n  }\n\n  if (downloaded) {\n    // Ensure cache directory exists before downloading.\n    try {\n      await safeMkdir(cacheEntryDir)\n    } catch (e) {\n      const code = (e as NodeJS.ErrnoException).code\n      if (code === 'EACCES' || code === 'EPERM') {\n        throw new Error(\n          `Permission denied creating binary cache directory: ${cacheEntryDir}\\n` +\n            'Please check directory permissions or run with appropriate access.',\n          { cause: e },\n        )\n      }\n      if (code === 'EROFS') {\n        throw new Error(\n          `Cannot create binary cache directory on read-only filesystem: ${cacheEntryDir}\\n` +\n            'Ensure the filesystem is writable or set SOCKET_DLX_DIR to a writable location.',\n          { cause: e },\n        )\n      }\n      throw new Error(\n        `Failed to create binary cache directory: ${cacheEntryDir}`,\n        { cause: e },\n      )\n    }\n\n    // Download the binary.\n    computedChecksum = await downloadBinaryFile(url, binaryPath, checksum)\n\n    // Get file size for metadata.\n    const stats = await fs.promises.stat(binaryPath)\n    await writeMetadata(\n      cacheEntryDir,\n      cacheKey,\n      url,\n      binaryName,\n      computedChecksum || '',\n      stats.size,\n    )\n  }\n\n  // Execute the binary.\n  // On Windows, script files (.bat, .cmd, .ps1) require shell: true because\n  // they are not executable on their own and must be run through cmd.exe.\n  // Note: .exe files are actual binaries and don't need shell mode.\n  const needsShell = WIN32 && /\\.(?:bat|cmd|ps1)$/i.test(binaryPath)\n  // Windows cmd.exe PATH resolution behavior:\n  // When shell: true on Windows with .cmd/.bat/.ps1 files, spawn will automatically\n  // strip the full path down to just the basename without extension (e.g.,\n  // C:\\cache\\test.cmd becomes just \"test\"). Windows cmd.exe then searches for \"test\"\n  // in directories listed in PATH, trying each extension from PATHEXT environment\n  // variable (.COM, .EXE, .BAT, .CMD, etc.) until it finds a match.\n  //\n  // Since our binaries are downloaded to a custom cache directory that's not in PATH\n  // (unlike system package managers like npm/pnpm/yarn which are already in PATH),\n  // we must prepend the cache directory to PATH so cmd.exe can locate the binary.\n  //\n  // This approach is consistent with how other tools handle Windows command execution:\n  // - npm's promise-spawn: uses which.sync() to find commands in PATH\n  // - cross-spawn: spawns cmd.exe with escaped arguments\n  // - Node.js spawn with shell: true: delegates to cmd.exe which uses PATH\n  const finalSpawnOptions = needsShell\n    ? {\n        ...spawnOptions,\n        env: {\n          ...spawnOptions?.env,\n          PATH: `${cacheEntryDir}${path.delimiter}${process.env['PATH'] || ''}`,\n        },\n        shell: true,\n      }\n    : spawnOptions\n  const spawnPromise = spawn(binaryPath, args, finalSpawnOptions, spawnExtra)\n\n  return {\n    binaryPath,\n    downloaded,\n    spawnPromise,\n  }\n}\n\n/**\n * Download a binary from a URL with caching (without execution).\n * Similar to downloadPackage from dlx-package.\n *\n * @returns Object containing the path to the cached binary and whether it was downloaded\n */\nexport async function downloadBinary(\n  options: Omit<DlxBinaryOptions, 'spawnOptions'>,\n): Promise<{ binaryPath: string; downloaded: boolean }> {\n  const {\n    cacheTtl = /*@__INLINE__*/ require('#constants/time').DLX_BINARY_CACHE_TTL,\n    checksum,\n    force = false,\n    name,\n    url,\n  } = { __proto__: null, ...options } as DlxBinaryOptions\n\n  // Generate cache paths similar to pnpm/npx structure.\n  const cacheDir = getDlxCachePath()\n  const binaryName = name || `binary-${process.platform}-${os.arch()}`\n  // Create spec from URL and binary name for unique cache identity.\n  const spec = `${url}:${binaryName}`\n  const cacheKey = generateCacheKey(spec)\n  const cacheEntryDir = path.join(cacheDir, cacheKey)\n  const binaryPath = normalizePath(path.join(cacheEntryDir, binaryName))\n  const fs = getFs()\n\n  let downloaded = false\n\n  // Check if we need to download.\n  if (\n    !force &&\n    fs.existsSync(cacheEntryDir) &&\n    (await isCacheValid(cacheEntryDir, cacheTtl))\n  ) {\n    // Binary is cached and valid.\n    downloaded = false\n  } else {\n    // Ensure cache directory exists before downloading.\n    try {\n      await safeMkdir(cacheEntryDir)\n    } catch (e) {\n      const code = (e as NodeJS.ErrnoException).code\n      if (code === 'EACCES' || code === 'EPERM') {\n        throw new Error(\n          `Permission denied creating binary cache directory: ${cacheEntryDir}\\n` +\n            'Please check directory permissions or run with appropriate access.',\n          { cause: e },\n        )\n      }\n      if (code === 'EROFS') {\n        throw new Error(\n          `Cannot create binary cache directory on read-only filesystem: ${cacheEntryDir}\\n` +\n            'Ensure the filesystem is writable or set SOCKET_DLX_DIR to a writable location.',\n          { cause: e },\n        )\n      }\n      throw new Error(\n        `Failed to create binary cache directory: ${cacheEntryDir}`,\n        { cause: e },\n      )\n    }\n\n    // Download the binary.\n    const computedChecksum = await downloadBinaryFile(url, binaryPath, checksum)\n\n    // Get file size for metadata.\n    const stats = await fs.promises.stat(binaryPath)\n    await writeMetadata(\n      cacheEntryDir,\n      cacheKey,\n      url,\n      binaryName,\n      computedChecksum || '',\n      stats.size,\n    )\n    downloaded = true\n  }\n\n  return {\n    binaryPath,\n    downloaded,\n  }\n}\n\n/**\n * Execute a cached binary without re-downloading.\n * Similar to executePackage from dlx-package.\n * Binary must have been previously downloaded via downloadBinary or dlxBinary.\n *\n * @param binaryPath Path to the cached binary (from downloadBinary result)\n * @param args Arguments to pass to the binary\n * @param spawnOptions Spawn options for execution\n * @param spawnExtra Extra spawn configuration\n * @returns The spawn promise for the running process\n */\nexport function executeBinary(\n  binaryPath: string,\n  args: readonly string[] | string[],\n  spawnOptions?: SpawnOptions | undefined,\n  spawnExtra?: SpawnExtra | undefined,\n): ReturnType<typeof spawn> {\n  // On Windows, script files (.bat, .cmd, .ps1) require shell: true because\n  // they are not executable on their own and must be run through cmd.exe.\n  // Note: .exe files are actual binaries and don't need shell mode.\n  const needsShell = WIN32 && /\\.(?:bat|cmd|ps1)$/i.test(binaryPath)\n\n  // Windows cmd.exe PATH resolution behavior:\n  // When shell: true on Windows with .cmd/.bat/.ps1 files, spawn will automatically\n  // strip the full path down to just the basename without extension. Windows cmd.exe\n  // then searches for the binary in directories listed in PATH.\n  //\n  // Since our binaries are downloaded to a custom cache directory that's not in PATH,\n  // we must prepend the cache directory to PATH so cmd.exe can locate the binary.\n  const cacheEntryDir = path.dirname(binaryPath)\n  const finalSpawnOptions = needsShell\n    ? {\n        ...spawnOptions,\n        env: {\n          ...spawnOptions?.env,\n          PATH: `${cacheEntryDir}${path.delimiter}${process.env['PATH'] || ''}`,\n        },\n        shell: true,\n      }\n    : spawnOptions\n\n  return spawn(binaryPath, args, finalSpawnOptions, spawnExtra)\n}\n\n/**\n * Get the DLX binary cache directory path.\n * Returns normalized path for cross-platform compatibility.\n * Uses same directory as dlx-package for unified DLX storage.\n */\nexport function getDlxCachePath(): string {\n  return getSocketDlxDir()\n}\n\n/**\n * Get information about cached binaries.\n */\nexport async function listDlxCache(): Promise<\n  Array<{\n    age: number\n    arch: string\n    checksum: string\n    name: string\n    platform: string\n    size: number\n    url: string\n  }>\n> {\n  const cacheDir = getDlxCachePath()\n  const fs = getFs()\n\n  if (!fs.existsSync(cacheDir)) {\n    return []\n  }\n\n  const results = []\n  const now = Date.now()\n  const entries = await fs.promises.readdir(cacheDir)\n\n  for (const entry of entries) {\n    const entryPath = path.join(cacheDir, entry)\n    try {\n      // eslint-disable-next-line no-await-in-loop\n      if (!(await isDir(entryPath))) {\n        continue\n      }\n\n      const metaPath = getMetadataPath(entryPath)\n      // eslint-disable-next-line no-await-in-loop\n      const metadata = await readJson(metaPath, { throws: false })\n      if (\n        !metadata ||\n        typeof metadata !== 'object' ||\n        Array.isArray(metadata)\n      ) {\n        continue\n      }\n\n      const metaObj = metadata as Record<string, unknown>\n\n      // Get URL from unified schema (source.url) or legacy schema (url).\n      // Allow empty URL for backward compatibility with partial metadata.\n      const source = metaObj['source'] as Record<string, unknown> | undefined\n      const url =\n        (source?.['url'] as string) || (metaObj['url'] as string) || ''\n\n      // Find the binary file in the directory.\n      // eslint-disable-next-line no-await-in-loop\n      const files = await fs.promises.readdir(entryPath)\n      const binaryFile = files.find(f => !f.startsWith('.'))\n\n      if (binaryFile) {\n        const binaryPath = path.join(entryPath, binaryFile)\n        // eslint-disable-next-line no-await-in-loop\n        const binaryStats = await fs.promises.stat(binaryPath)\n\n        results.push({\n          age: now - ((metaObj['timestamp'] as number) || 0),\n          arch: (metaObj['arch'] as string) || 'unknown',\n          checksum: (metaObj['checksum'] as string) || '',\n          name: binaryFile,\n          platform: (metaObj['platform'] as string) || 'unknown',\n          size: binaryStats.size,\n          url,\n        })\n      }\n    } catch {}\n  }\n\n  return results\n}\n"],
-  "mappings": "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",
-  "names": ["import_path", "path", "fileBuffer", "hasher", "os"]
-}

package/dist/dlx-manifest.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/dlx-manifest.ts"],
-  "sourcesContent": ["/**\n * @fileoverview DLX manifest storage utilities.\n * Manages persistent caching of DLX package and binary metadata with TTL support\n * and atomic file operations.\n *\n * Key Functions:\n * - getManifestEntry: Retrieve manifest entry by spec\n * - setPackageEntry: Store npm package metadata\n * - setBinaryEntry: Store binary download metadata\n *\n * Features:\n * - TTL-based cache expiration\n * - Atomic file operations with locking\n * - JSON-based persistent storage\n * - Error-resistant implementation\n *\n * Storage Format:\n * - Stores in ~/.socket/_dlx/.dlx-manifest.json\n * - Per-spec manifest entries with timestamps\n * - Thread-safe operations using process lock utility\n *\n * Usage:\n * - Update check caching\n * - Binary metadata tracking\n * - Rate limiting registry requests\n */\n\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'fs'\nimport path from 'path'\n\nimport { readFileUtf8Sync, safeMkdirSync } from './fs'\nimport { getDefaultLogger } from './logger'\nimport { getSocketDlxDir } from './paths'\nimport { processLock } from './process-lock'\n\nconst logger = getDefaultLogger()\n\n/**\n * Manifest file name.\n */\nconst MANIFEST_FILE_NAME = '.dlx-manifest.json'\n\n/**\n * Details for npm package entries.\n */\nexport interface PackageDetails {\n  installed_version: string\n  size?: number\n  update_check?: {\n    last_check: number\n    last_notification: number\n    latest_known: string\n  }\n}\n\n/**\n * Details for binary download entries.\n */\nexport interface BinaryDetails {\n  checksum: string\n  checksum_algorithm: 'sha256' | 'sha512'\n  platform: string\n  arch: string\n  size: number\n  source: {\n    type: 'download'\n    url: string\n  }\n}\n\n/**\n * Unified manifest entry for all cached items (packages and binaries).\n * Shared fields at root, type-specific fields in details.\n */\nexport interface ManifestEntry {\n  type: 'package' | 'binary'\n  cache_key: string\n  timestamp: number\n  details: PackageDetails | BinaryDetails\n}\n\n/**\n * Type guard for package entries.\n */\nexport function isPackageEntry(\n  entry: ManifestEntry,\n): entry is ManifestEntry & { details: PackageDetails } {\n  return entry.type === 'package'\n}\n\n/**\n * Type guard for binary entries.\n */\nexport function isBinaryEntry(\n  entry: ManifestEntry,\n): entry is ManifestEntry & { details: BinaryDetails } {\n  return entry.type === 'binary'\n}\n\n/**\n * Legacy store record format (deprecated, for migration).\n */\nexport interface StoreRecord {\n  timestampFetch: number\n  timestampNotification: number\n  version: string\n}\n\nexport interface DlxManifestOptions {\n  /**\n   * Custom manifest file path (defaults to ~/.socket/_dlx/.dlx-manifest.json).\n   */\n  manifestPath?: string\n}\n\n/**\n * DLX manifest storage manager with atomic operations.\n * Supports both legacy format (package name keys) and new unified manifest format (spec keys).\n */\nexport class DlxManifest {\n  private readonly manifestPath: string\n  private readonly lockPath: string\n\n  constructor(options: DlxManifestOptions = {}) {\n    this.manifestPath =\n      options.manifestPath ?? path.join(getSocketDlxDir(), MANIFEST_FILE_NAME)\n    this.lockPath = `${this.manifestPath}.lock`\n  }\n\n  /**\n   * Read the entire manifest file.\n   */\n  private readManifest(): Record<string, ManifestEntry | StoreRecord> {\n    try {\n      if (!existsSync(this.manifestPath)) {\n        return Object.create(null)\n      }\n\n      const rawContent = readFileUtf8Sync(this.manifestPath)\n      const content = (\n        typeof rawContent === 'string'\n          ? rawContent\n          : rawContent.toString('utf8')\n      ).trim()\n\n      if (!content) {\n        return Object.create(null)\n      }\n\n      return JSON.parse(content) as Record<string, ManifestEntry | StoreRecord>\n    } catch (error) {\n      logger.warn(\n        `Failed to read manifest: ${error instanceof Error ? error.message : String(error)}`,\n      )\n      return Object.create(null)\n    }\n  }\n\n  /**\n   * Get a manifest entry by spec (e.g., \"@socketsecurity/cli@^2.0.11\").\n   */\n  getManifestEntry(spec: string): ManifestEntry | undefined {\n    const data = this.readManifest()\n    const entry = data[spec]\n\n    // Check if it's a new-format entry (has 'type' field).\n    if (entry && 'type' in entry) {\n      return entry as ManifestEntry\n    }\n\n    return undefined\n  }\n\n  /**\n   * Get cached update information for a package (legacy format).\n   * @deprecated Use getManifestEntry() for new code.\n   */\n  get(name: string): StoreRecord | undefined {\n    const data = this.readManifest()\n    const entry = data[name]\n\n    // Return legacy format entries only.\n    if (entry && !('type' in entry)) {\n      return entry as StoreRecord\n    }\n\n    return undefined\n  }\n\n  /**\n   * Set a package manifest entry.\n   */\n  async setPackageEntry(\n    spec: string,\n    cacheKey: string,\n    details: PackageDetails,\n  ): Promise<void> {\n    await processLock.withLock(this.lockPath, async () => {\n      const data = this.readManifest()\n\n      data[spec] = {\n        type: 'package',\n        cache_key: cacheKey,\n        timestamp: Date.now(),\n        details,\n      }\n\n      await this.writeManifest(data)\n    })\n  }\n\n  /**\n   * Set a binary manifest entry.\n   */\n  async setBinaryEntry(\n    spec: string,\n    cacheKey: string,\n    details: BinaryDetails,\n  ): Promise<void> {\n    await processLock.withLock(this.lockPath, async () => {\n      const data = this.readManifest()\n\n      data[spec] = {\n        type: 'binary',\n        cache_key: cacheKey,\n        timestamp: Date.now(),\n        details,\n      }\n\n      await this.writeManifest(data)\n    })\n  }\n\n  /**\n   * Write the manifest file atomically.\n   */\n  private async writeManifest(\n    data: Record<string, ManifestEntry | StoreRecord>,\n  ): Promise<void> {\n    // Ensure directory exists.\n    const manifestDir = path.dirname(this.manifestPath)\n    try {\n      safeMkdirSync(manifestDir, { recursive: true })\n    } catch (error) {\n      logger.warn(\n        `Failed to create manifest directory: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n\n    // Write atomically.\n    const content = JSON.stringify(data, null, 2)\n    const tempPath = `${this.manifestPath}.tmp`\n\n    try {\n      writeFileSync(tempPath, content, 'utf8')\n      writeFileSync(this.manifestPath, content, 'utf8')\n\n      // Clean up temp file.\n      try {\n        if (existsSync(tempPath)) {\n          unlinkSync(tempPath)\n        }\n      } catch {\n        // Cleanup failed, not critical.\n      }\n    } catch (error) {\n      // Clean up temp file on error.\n      try {\n        if (existsSync(tempPath)) {\n          unlinkSync(tempPath)\n        }\n      } catch {\n        // Best effort cleanup.\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Store update information for a package (legacy format).\n   * @deprecated Use setPackageEntry() for new code.\n   */\n  async set(name: string, record: StoreRecord): Promise<void> {\n    await processLock.withLock(this.lockPath, async () => {\n      let data: Record<string, StoreRecord> = Object.create(null)\n\n      // Read existing data.\n      try {\n        if (existsSync(this.manifestPath)) {\n          const content = readFileSync(this.manifestPath, 'utf8')\n          if (content.trim()) {\n            data = JSON.parse(content) as Record<string, StoreRecord>\n          }\n        }\n      } catch (error) {\n        logger.warn(\n          `Failed to read existing manifest: ${error instanceof Error ? error.message : String(error)}`,\n        )\n      }\n\n      // Update record.\n      data[name] = record\n\n      // Ensure directory exists.\n      const manifestDir = path.dirname(this.manifestPath)\n      try {\n        safeMkdirSync(manifestDir, { recursive: true })\n      } catch (error) {\n        logger.warn(\n          `Failed to create manifest directory: ${error instanceof Error ? error.message : String(error)}`,\n        )\n      }\n\n      // Write atomically.\n      const content = JSON.stringify(data, null, 2)\n      const tempPath = `${this.manifestPath}.tmp`\n\n      try {\n        writeFileSync(tempPath, content, 'utf8')\n        writeFileSync(this.manifestPath, content, 'utf8')\n\n        // Clean up temp file.\n        try {\n          if (existsSync(tempPath)) {\n            unlinkSync(tempPath)\n          }\n        } catch {\n          // Cleanup failed, not critical.\n        }\n      } catch (error) {\n        // Clean up temp file on error.\n        try {\n          if (existsSync(tempPath)) {\n            unlinkSync(tempPath)\n          }\n        } catch {\n          // Best effort cleanup.\n        }\n        throw error\n      }\n    })\n  }\n\n  /**\n   * Clear cached data for a specific entry.\n   */\n  async clear(name: string): Promise<void> {\n    await processLock.withLock(this.lockPath, async () => {\n      try {\n        if (!existsSync(this.manifestPath)) {\n          return\n        }\n\n        const content = readFileSync(this.manifestPath, 'utf8')\n        if (!content.trim()) {\n          return\n        }\n\n        const data = JSON.parse(content) as Record<string, StoreRecord>\n        delete data[name]\n\n        const updatedContent = JSON.stringify(data, null, 2)\n        writeFileSync(this.manifestPath, updatedContent, 'utf8')\n      } catch (error) {\n        logger.warn(\n          `Failed to clear cache for ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        )\n      }\n    })\n  }\n\n  /**\n   * Clear all cached data.\n   */\n  async clearAll(): Promise<void> {\n    await processLock.withLock(this.lockPath, async () => {\n      try {\n        if (existsSync(this.manifestPath)) {\n          unlinkSync(this.manifestPath)\n        }\n      } catch (error) {\n        logger.warn(\n          `Failed to clear all cache: ${error instanceof Error ? error.message : String(error)}`,\n        )\n      }\n    })\n  }\n\n  /**\n   * Check if cached data is fresh based on TTL.\n   */\n  isFresh(record: StoreRecord | undefined, ttlMs: number): boolean {\n    if (!record) {\n      return false\n    }\n\n    const age = Date.now() - record.timestampFetch\n    return age < ttlMs\n  }\n\n  /**\n   * Get all cached package names.\n   */\n  getAllPackages(): string[] {\n    try {\n      if (!existsSync(this.manifestPath)) {\n        return []\n      }\n\n      const rawContent = readFileUtf8Sync(this.manifestPath)\n      const content = (\n        typeof rawContent === 'string'\n          ? rawContent\n          : rawContent.toString('utf8')\n      ).trim()\n      if (!content) {\n        return []\n      }\n\n      const data = JSON.parse(content) as Record<string, StoreRecord>\n      return Object.keys(data)\n    } catch (error) {\n      logger.warn(\n        `Failed to get package list: ${error instanceof Error ? error.message : String(error)}`,\n      )\n      return []\n    }\n  }\n}\n\n// Export singleton instance using default manifest location.\nexport const dlxManifest = new DlxManifest()\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BA,gBAAoE;AACpE,kBAAiB;AAEjB,IAAAA,aAAgD;AAChD,oBAAiC;AACjC,mBAAgC;AAChC,0BAA4B;AAE5B,MAAM,aAAS,gCAAiB;AAKhC,MAAM,qBAAqB;AA4CpB,SAAS,eACd,OACsD;AACtD,SAAO,MAAM,SAAS;AACxB;AAKO,SAAS,cACd,OACqD;AACrD,SAAO,MAAM,SAAS;AACxB;AAsBO,MAAM,YAAY;AAAA,EACN;AAAA,EACA;AAAA,EAEjB,YAAY,UAA8B,CAAC,GAAG;AAC5C,SAAK,eACH,QAAQ,gBAAgB,YAAAC,QAAK,SAAK,8BAAgB,GAAG,kBAAkB;AACzE,SAAK,WAAW,GAAG,KAAK,YAAY;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKQ,eAA4D;AAClE,QAAI;AACF,UAAI,KAAC,sBAAW,KAAK,YAAY,GAAG;AAClC,eAAO,uBAAO,OAAO,IAAI;AAAA,MAC3B;AAEA,YAAM,iBAAa,6BAAiB,KAAK,YAAY;AACrD,YAAM,WACJ,OAAO,eAAe,WAClB,aACA,WAAW,SAAS,MAAM,GAC9B,KAAK;AAEP,UAAI,CAAC,SAAS;AACZ,eAAO,uBAAO,OAAO,IAAI;AAAA,MAC3B;AAEA,aAAO,KAAK,MAAM,OAAO;AAAA,IAC3B,SAAS,OAAO;AACd,aAAO;AAAA,QACL,4BAA4B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,MACpF;AACA,aAAO,uBAAO,OAAO,IAAI;AAAA,IAC3B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAiB,MAAyC;AACxD,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,QAAQ,KAAK,IAAI;AAGvB,QAAI,SAAS,UAAU,OAAO;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,MAAuC;AACzC,UAAM,OAAO,KAAK,aAAa;AAC/B,UAAM,QAAQ,KAAK,IAAI;AAGvB,QAAI,SAAS,EAAE,UAAU,QAAQ;AAC/B,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBACJ,MACA,UACA,SACe;AACf,UAAM,gCAAY,SAAS,KAAK,UAAU,YAAY;AACpD,YAAM,OAAO,KAAK,aAAa;AAE/B,WAAK,IAAI,IAAI;AAAA,QACX,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW,KAAK,IAAI;AAAA,QACpB;AAAA,MACF;AAEA,YAAM,KAAK,cAAc,IAAI;AAAA,IAC/B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eACJ,MACA,UACA,SACe;AACf,UAAM,gCAAY,SAAS,KAAK,UAAU,YAAY;AACpD,YAAM,OAAO,KAAK,aAAa;AAE/B,WAAK,IAAI,IAAI;AAAA,QACX,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW,KAAK,IAAI;AAAA,QACpB;AAAA,MACF;AAEA,YAAM,KAAK,cAAc,IAAI;AAAA,IAC/B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,cACZ,MACe;AAEf,UAAM,cAAc,YAAAA,QAAK,QAAQ,KAAK,YAAY;AAClD,QAAI;AACF,oCAAc,aAAa,EAAE,WAAW,KAAK,CAAC;AAAA,IAChD,SAAS,OAAO;AACd,aAAO;AAAA,QACL,wCAAwC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,MAChG;AAAA,IACF;AAGA,UAAM,UAAU,KAAK,UAAU,MAAM,MAAM,CAAC;AAC5C,UAAM,WAAW,GAAG,KAAK,YAAY;AAErC,QAAI;AACF,mCAAc,UAAU,SAAS,MAAM;AACvC,mCAAc,KAAK,cAAc,SAAS,MAAM;AAGhD,UAAI;AACF,gBAAI,sBAAW,QAAQ,GAAG;AACxB,oCAAW,QAAQ;AAAA,QACrB;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF,SAAS,OAAO;AAEd,UAAI;AACF,gBAAI,sBAAW,QAAQ,GAAG;AACxB,oCAAW,QAAQ;AAAA,QACrB;AAAA,MACF,QAAQ;AAAA,MAER;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAI,MAAc,QAAoC;AAC1D,UAAM,gCAAY,SAAS,KAAK,UAAU,YAAY;AACpD,UAAI,OAAoC,uBAAO,OAAO,IAAI;AAG1D,UAAI;AACF,gBAAI,sBAAW,KAAK,YAAY,GAAG;AACjC,gBAAMC,eAAU,wBAAa,KAAK,cAAc,MAAM;AACtD,cAAIA,SAAQ,KAAK,GAAG;AAClB,mBAAO,KAAK,MAAMA,QAAO;AAAA,UAC3B;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,eAAO;AAAA,UACL,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QAC7F;AAAA,MACF;AAGA,WAAK,IAAI,IAAI;AAGb,YAAM,cAAc,YAAAD,QAAK,QAAQ,KAAK,YAAY;AAClD,UAAI;AACF,sCAAc,aAAa,EAAE,WAAW,KAAK,CAAC;AAAA,MAChD,SAAS,OAAO;AACd,eAAO;AAAA,UACL,wCAAwC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QAChG;AAAA,MACF;AAGA,YAAM,UAAU,KAAK,UAAU,MAAM,MAAM,CAAC;AAC5C,YAAM,WAAW,GAAG,KAAK,YAAY;AAErC,UAAI;AACF,qCAAc,UAAU,SAAS,MAAM;AACvC,qCAAc,KAAK,cAAc,SAAS,MAAM;AAGhD,YAAI;AACF,kBAAI,sBAAW,QAAQ,GAAG;AACxB,sCAAW,QAAQ;AAAA,UACrB;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF,SAAS,OAAO;AAEd,YAAI;AACF,kBAAI,sBAAW,QAAQ,GAAG;AACxB,sCAAW,QAAQ;AAAA,UACrB;AAAA,QACF,QAAQ;AAAA,QAER;AACA,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MAAM,MAA6B;AACvC,UAAM,gCAAY,SAAS,KAAK,UAAU,YAAY;AACpD,UAAI;AACF,YAAI,KAAC,sBAAW,KAAK,YAAY,GAAG;AAClC;AAAA,QACF;AAEA,cAAM,cAAU,wBAAa,KAAK,cAAc,MAAM;AACtD,YAAI,CAAC,QAAQ,KAAK,GAAG;AACnB;AAAA,QACF;AAEA,cAAM,OAAO,KAAK,MAAM,OAAO;AAC/B,eAAO,KAAK,IAAI;AAEhB,cAAM,iBAAiB,KAAK,UAAU,MAAM,MAAM,CAAC;AACnD,qCAAc,KAAK,cAAc,gBAAgB,MAAM;AAAA,MACzD,SAAS,OAAO;AACd,eAAO;AAAA,UACL,6BAA6B,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QAC9F;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAA0B;AAC9B,UAAM,gCAAY,SAAS,KAAK,UAAU,YAAY;AACpD,UAAI;AACF,gBAAI,sBAAW,KAAK,YAAY,GAAG;AACjC,oCAAW,KAAK,YAAY;AAAA,QAC9B;AAAA,MACF,SAAS,OAAO;AACd,eAAO;AAAA,UACL,8BAA8B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACtF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,QAAiC,OAAwB;AAC/D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,UAAM,MAAM,KAAK,IAAI,IAAI,OAAO;AAChC,WAAO,MAAM;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,iBAA2B;AACzB,QAAI;AACF,UAAI,KAAC,sBAAW,KAAK,YAAY,GAAG;AAClC,eAAO,CAAC;AAAA,MACV;AAEA,YAAM,iBAAa,6BAAiB,KAAK,YAAY;AACrD,YAAM,WACJ,OAAO,eAAe,WAClB,aACA,WAAW,SAAS,MAAM,GAC9B,KAAK;AACP,UAAI,CAAC,SAAS;AACZ,eAAO,CAAC;AAAA,MACV;AAEA,YAAM,OAAO,KAAK,MAAM,OAAO;AAC/B,aAAO,OAAO,KAAK,IAAI;AAAA,IACzB,SAAS,OAAO;AACd,aAAO;AAAA,QACL,+BAA+B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,MACvF;AACA,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;AAGO,MAAM,cAAc,IAAI,YAAY;",
-  "names": ["import_fs", "path", "content"]
-}

package/dist/dlx-package.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/dlx-package.ts"],
-  "sourcesContent": ["/**\n * @fileoverview DLX package execution - Install and execute npm packages.\n *\n * This module provides functionality to install and execute npm packages\n * in the ~/.socket/_dlx directory, similar to npx but with Socket's own cache.\n *\n * Uses content-addressed storage like npm's _npx:\n * - Hash is generated from package spec (name@version)\n * - Each unique spec gets its own directory: ~/.socket/_dlx/<hash>/\n * - Allows caching multiple versions of the same package\n *\n * Concurrency protection:\n * - Uses process-lock to prevent concurrent installation corruption\n * - Lock file created at ~/.socket/_dlx/<hash>/concurrency.lock\n * - Uses npm npx's concurrency.lock naming convention (5s stale, 2s touching)\n * - Prevents multiple processes from corrupting the same package installation\n *\n * Version range handling:\n * - Exact versions (1.0.0) use cache if available\n * - Range versions (^1.0.0, ~1.0.0) auto-force to get latest within range\n * - User can override with explicit force: false\n *\n * Key difference from dlx-binary.ts:\n * - dlx-binary.ts: Downloads standalone binaries from URLs\n * - dlx-package.ts: Installs npm packages from registries\n *\n * Implementation:\n * - Uses pacote for package installation (no npm CLI required)\n * - Split into downloadPackage() and executePackage() for flexibility\n * - dlxPackage() combines both for convenience\n */\n\nimport path from 'path'\n\nimport { WIN32 } from './constants/platform'\nimport { getPacoteCachePath } from './constants/packages'\nimport { generateCacheKey } from './dlx'\nimport { readJsonSync, safeMkdir } from './fs'\nimport { normalizePath } from './path'\nimport { getSocketDlxDir } from './paths'\nimport { processLock } from './process-lock'\nimport type { SpawnExtra, SpawnOptions } from './spawn'\nimport { spawn } from './spawn'\n\nlet _fs: typeof import('fs') | undefined\n/**\n * Lazily load the fs module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js fs module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFs() {\n  if (_fs === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _fs = /*@__PURE__*/ require('node:fs')\n  }\n  return _fs as typeof import('fs')\n}\n\nlet _npmPackageArg: typeof import('npm-package-arg') | undefined\n/*@__NO_SIDE_EFFECTS__*/\nfunction getNpmPackageArg() {\n  if (_npmPackageArg === undefined) {\n    _npmPackageArg = /*@__PURE__*/ require('./external/npm-package-arg')\n  }\n  return _npmPackageArg as typeof import('npm-package-arg')\n}\n\nlet _libnpmexec: typeof import('./external/libnpmexec') | undefined\n/*@__NO_SIDE_EFFECTS__*/\nfunction getLibnpmexec() {\n  if (_libnpmexec === undefined) {\n    _libnpmexec = /*@__PURE__*/ require('./external/libnpmexec')\n  }\n  return _libnpmexec!\n}\n\nlet _pacote: typeof import('pacote') | undefined\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPacote() {\n  if (_pacote === undefined) {\n    _pacote = /*@__PURE__*/ require('./external/pacote')\n  }\n  return _pacote as typeof import('pacote')\n}\n\n/**\n * Regex to check if a version string contains range operators.\n * Matches any version with range operators: ~, ^, >, <, =, x, X, *, spaces, or ||.\n */\nconst rangeOperatorsRegExp = /[~^><=xX* ]|\\|\\|/\n\nexport interface DownloadPackageResult {\n  /** Path to the installed package directory. */\n  packageDir: string\n  /** Path to the binary. */\n  binaryPath: string\n  /** Whether the package was newly installed. */\n  installed: boolean\n}\n\nexport interface DlxPackageOptions {\n  /**\n   * Package to install (e.g., '@cyclonedx/cdxgen@10.0.0').\n   * Aligns with npx --package flag.\n   */\n  package: string\n\n  /**\n   * Binary name to execute (optional - auto-detected in most cases).\n   *\n   * Auto-detection logic:\n   * 1. If package has only one binary, uses it automatically\n   * 2. Tries user-provided binaryName\n   * 3. Tries last segment of package name (e.g., 'cli' from '@socketsecurity/cli')\n   * 4. Falls back to first binary\n   *\n   * Only needed when package has multiple binaries and auto-detection fails.\n   *\n   * @example\n   * // Auto-detected (single binary)\n   * { package: '@socketsecurity/cli' }  // Finds 'socket' binary automatically\n   *\n   * // Explicit (multiple binaries)\n   * { package: 'some-tool', binaryName: 'specific-tool' }\n   */\n  binaryName?: string | undefined\n\n  /**\n   * Force reinstallation even if package exists.\n   * Aligns with npx --yes/-y flag behavior.\n   */\n  force?: boolean | undefined\n\n  /**\n   * Skip confirmation prompts (auto-approve).\n   * Aligns with npx --yes/-y flag.\n   */\n  yes?: boolean | undefined\n\n  /**\n   * Suppress output (quiet mode).\n   * Aligns with npx --quiet/-q and pnpm --silent/-s flags.\n   */\n  quiet?: boolean | undefined\n\n  /**\n   * Additional spawn options for the execution.\n   */\n  spawnOptions?: SpawnOptions | undefined\n}\n\nexport interface DlxPackageResult {\n  /** Path to the installed package directory. */\n  packageDir: string\n  /** Path to the binary that was executed. */\n  binaryPath: string\n  /** Whether the package was newly installed. */\n  installed: boolean\n  /** The spawn promise for the running process. */\n  spawnPromise: ReturnType<typeof spawn>\n}\n\n/**\n * Parse package spec into name and version using npm-package-arg.\n * Examples:\n * - 'lodash@4.17.21' \u2192 { name: 'lodash', version: '4.17.21' }\n * - '@scope/pkg@1.0.0' \u2192 { name: '@scope/pkg', version: '1.0.0' }\n * - 'lodash' \u2192 { name: 'lodash', version: undefined }\n */\nfunction parsePackageSpec(spec: string): {\n  name: string\n  version: string | undefined\n} {\n  try {\n    const npa = getNpmPackageArg()\n    const parsed = npa(spec)\n\n    // Extract version from different types of specs.\n    // For registry specs, use fetchSpec (the version/range).\n    // For git/file/etc, version will be undefined.\n    const version =\n      parsed.type === 'tag'\n        ? parsed.fetchSpec\n        : parsed.type === 'version' || parsed.type === 'range'\n          ? parsed.fetchSpec\n          : undefined\n\n    return {\n      name: parsed.name || spec,\n      version,\n    }\n  } catch {\n    // Fallback to simple parsing if npm-package-arg fails.\n    const atIndex = spec.lastIndexOf('@')\n    if (atIndex === -1 || spec.startsWith('@')) {\n      // No version or scoped package without version.\n      return { name: spec, version: undefined }\n    }\n    return {\n      name: spec.slice(0, atIndex),\n      version: spec.slice(atIndex + 1),\n    }\n  }\n}\n\n/**\n * Install package to ~/.socket/_dlx/<hash>/ if not already installed.\n * Uses pacote for installation (no npm CLI required).\n * Protected by process lock to prevent concurrent installation corruption.\n */\nasync function ensurePackageInstalled(\n  packageName: string,\n  packageSpec: string,\n  force: boolean,\n): Promise<{ installed: boolean; packageDir: string }> {\n  const cacheKey = generateCacheKey(packageSpec)\n  const packageDir = normalizePath(path.join(getSocketDlxDir(), cacheKey))\n  const installedDir = normalizePath(\n    path.join(packageDir, 'node_modules', packageName),\n  )\n\n  // Ensure package directory exists before creating lock.\n  // The lock directory will be created inside this directory.\n  try {\n    await safeMkdir(packageDir)\n  } catch (e) {\n    const code = (e as NodeJS.ErrnoException).code\n    if (code === 'EACCES' || code === 'EPERM') {\n      throw new Error(\n        `Permission denied creating package directory: ${packageDir}\\n` +\n          'Please check directory permissions or run with appropriate access.',\n        { cause: e },\n      )\n    }\n    if (code === 'EROFS') {\n      throw new Error(\n        `Cannot create package directory on read-only filesystem: ${packageDir}\\n` +\n          'Ensure the filesystem is writable or set SOCKET_DLX_DIR to a writable location.',\n        { cause: e },\n      )\n    }\n    throw new Error(`Failed to create package directory: ${packageDir}`, {\n      cause: e,\n    })\n  }\n\n  // Use process lock to prevent concurrent installations.\n  // Uses npm npx's concurrency.lock naming convention.\n  const lockPath = path.join(packageDir, 'concurrency.lock')\n\n  return await processLock.withLock(\n    lockPath,\n    async () => {\n      const fs = getFs()\n      // Double-check if already installed (unless force).\n      // Another process may have installed while waiting for lock.\n      if (!force && fs.existsSync(installedDir)) {\n        // Verify package.json exists.\n        const pkgJsonPath = path.join(installedDir, 'package.json')\n        if (fs.existsSync(pkgJsonPath)) {\n          return { installed: false, packageDir }\n        }\n      }\n\n      // Use pacote to extract the package.\n      // Pacote leverages npm cache when available but doesn't require npm CLI.\n      const pacoteCachePath = getPacoteCachePath()\n      try {\n        await getPacote().extract(packageSpec, installedDir, {\n          // Use consistent pacote cache path (respects npm cache locations when available).\n          cache: pacoteCachePath || path.join(packageDir, '.cache'),\n        })\n      } catch (e) {\n        const code = (e as any).code\n        if (code === 'E404' || code === 'ETARGET') {\n          throw new Error(\n            `Package not found: ${packageSpec}\\n` +\n              'Verify the package exists on npm registry and check the version.\\n' +\n              `Visit https://www.npmjs.com/package/${packageName} to see available versions.`,\n            { cause: e },\n          )\n        }\n        if (\n          code === 'ENOTFOUND' ||\n          code === 'ETIMEDOUT' ||\n          code === 'EAI_AGAIN'\n        ) {\n          throw new Error(\n            `Network error installing ${packageSpec}\\n` +\n              'Check your internet connection and try again.',\n            { cause: e },\n          )\n        }\n        throw new Error(\n          `Failed to install package: ${packageSpec}\\n` +\n            `Destination: ${installedDir}\\n` +\n            'Check npm registry connectivity or package name.',\n          { cause: e },\n        )\n      }\n\n      return { installed: true, packageDir }\n    },\n    {\n      // Align with npm npx locking strategy.\n      staleMs: 5000,\n      touchIntervalMs: 2000,\n    },\n  )\n}\n\n/**\n * Resolve binary path with cross-platform wrapper support.\n * On Windows, checks for .cmd, .bat, .ps1, .exe wrappers in order.\n * On Unix, uses path directly.\n *\n * Aligns with npm/npx binary resolution strategy.\n */\nfunction resolveBinaryPath(basePath: string): string {\n  const fs = getFs()\n\n  if (!WIN32) {\n    // Unix: use path directly\n    return basePath\n  }\n\n  // Windows: check for wrappers in priority order\n  // Order matches npm bin-links creation: .cmd, .ps1, .exe, then bare\n  const extensions = ['.cmd', '.bat', '.ps1', '.exe', '']\n\n  for (const ext of extensions) {\n    const testPath = basePath + ext\n    if (fs.existsSync(testPath)) {\n      return testPath\n    }\n  }\n\n  // Fallback to original path if no wrapper found\n  return basePath\n}\n\n/**\n * Find the binary path for an installed package.\n * Uses npm's bin resolution strategy with user-friendly fallbacks.\n * Resolves platform-specific wrappers (.cmd, .ps1, etc.) on Windows.\n *\n * Resolution strategy (cherry-picked from libnpmexec):\n * 1. Use npm's getBinFromManifest (handles aliases and standard cases)\n * 2. Fall back to user-provided binaryName if npm's strategy fails\n * 3. Try last segment of package name as final fallback\n * 4. Use first binary as last resort\n */\nfunction findBinaryPath(\n  packageDir: string,\n  packageName: string,\n  binaryName?: string,\n): string {\n  const installedDir = normalizePath(\n    path.join(packageDir, 'node_modules', packageName),\n  )\n  const pkgJsonPath = path.join(installedDir, 'package.json')\n\n  // Read package.json to find bin entry.\n  const pkgJson = readJsonSync(pkgJsonPath) as Record<string, unknown>\n  const bin = pkgJson['bin']\n\n  let binName: string | undefined\n  let binPath: string | undefined\n\n  if (typeof bin === 'string') {\n    // Single binary - use it directly.\n    binPath = bin\n  } else if (typeof bin === 'object' && bin !== null) {\n    const binObj = bin as Record<string, string>\n    const binKeys = Object.keys(binObj)\n\n    // If only one binary, use it regardless of name.\n    if (binKeys.length === 1) {\n      binName = binKeys[0]!\n      binPath = binObj[binName]\n    } else {\n      // Multiple binaries - use npm's battle-tested resolution strategy first.\n      try {\n        const { getBinFromManifest } = getLibnpmexec()\n        binName = getBinFromManifest({\n          name: packageName,\n          bin: binObj,\n          _id: `${packageName}@${(pkgJson as any).version || 'unknown'}`,\n        })\n        binPath = binObj[binName]\n      } catch {\n        // npm's strategy failed - fall back to user-friendly resolution:\n        // 1. User-provided binaryName\n        // 2. Last segment of package name (e.g., 'cli' from '@socketsecurity/cli')\n        // 3. First binary as fallback\n        const lastSegment = packageName.split('/').pop()\n        const candidates = [\n          binaryName,\n          lastSegment,\n          packageName.replace(/^@[^/]+\\//, ''),\n        ].filter(Boolean)\n\n        for (const candidate of candidates) {\n          if (candidate && binObj[candidate]) {\n            binName = candidate\n            binPath = binObj[candidate]\n            break\n          }\n        }\n\n        // Fallback to first binary if nothing matched.\n        if (!binPath && binKeys.length > 0) {\n          binName = binKeys[0]!\n          binPath = binObj[binName]\n        }\n      }\n    }\n  }\n\n  if (!binPath) {\n    throw new Error(`No binary found for package \"${packageName}\"`)\n  }\n\n  const rawPath = normalizePath(path.join(installedDir, binPath))\n\n  // Resolve platform-specific wrapper (Windows .cmd/.ps1/etc.)\n  return resolveBinaryPath(rawPath)\n}\n\n/**\n * Execute a package via DLX - install if needed and run its binary.\n *\n * This is the Socket equivalent of npx/pnpm dlx/yarn dlx, but using\n * our own cache directory (~/.socket/_dlx) and installation logic.\n *\n * Auto-forces reinstall for version ranges to get latest within range.\n *\n * @example\n * ```typescript\n * // Download and execute cdxgen\n * const result = await dlxPackage(\n *   ['--version'],\n *   { package: '@cyclonedx/cdxgen@10.0.0' }\n * )\n * await result.spawnPromise\n * ```\n */\nexport async function dlxPackage(\n  args: readonly string[] | string[],\n  options?: DlxPackageOptions | undefined,\n  spawnExtra?: SpawnExtra | undefined,\n): Promise<DlxPackageResult> {\n  // Download the package.\n  const downloadResult = await downloadPackage(options!)\n\n  // Execute the binary.\n  const spawnPromise = executePackage(\n    downloadResult.binaryPath,\n    args,\n    options?.spawnOptions,\n    spawnExtra,\n  )\n\n  return {\n    ...downloadResult,\n    spawnPromise,\n  }\n}\n\n/**\n * Make all binaries in an installed package executable.\n * Reads the package.json bin field and makes all binaries executable (chmod 0o755).\n * Handles both single binary (string) and multiple binaries (object) formats.\n *\n * Aligns with npm's approach:\n * - Uses 0o755 permission (matches npm's cmd-shim)\n * - Reads bin field from package.json (matches npm's bin-links and libnpmexec)\n * - Handles both string and object bin formats\n *\n * References:\n * - npm cmd-shim: https://github.com/npm/cmd-shim/blob/main/lib/index.js\n * - npm getBinFromManifest: https://github.com/npm/libnpmexec/blob/main/lib/get-bin-from-manifest.js\n */\nfunction makePackageBinsExecutable(\n  packageDir: string,\n  packageName: string,\n): void {\n  if (WIN32) {\n    // Windows doesn't need chmod\n    return\n  }\n\n  const fs = getFs()\n  const installedDir = normalizePath(\n    path.join(packageDir, 'node_modules', packageName),\n  )\n  const pkgJsonPath = path.join(installedDir, 'package.json')\n\n  try {\n    const pkgJson = readJsonSync(pkgJsonPath) as Record<string, unknown>\n    const bin = pkgJson['bin']\n\n    if (!bin) {\n      return\n    }\n\n    const binPaths: string[] = []\n\n    if (typeof bin === 'string') {\n      // Single binary\n      binPaths.push(bin)\n    } else if (typeof bin === 'object' && bin !== null) {\n      // Multiple binaries\n      const binObj = bin as Record<string, string>\n      binPaths.push(...Object.values(binObj))\n    }\n\n    // Make all binaries executable\n    for (const binPath of binPaths) {\n      const fullPath = normalizePath(path.join(installedDir, binPath))\n      if (fs.existsSync(fullPath)) {\n        try {\n          fs.chmodSync(fullPath, 0o755)\n        } catch {\n          // Ignore chmod errors on individual binaries\n        }\n      }\n    }\n  } catch {\n    // Ignore errors reading package.json or making binaries executable\n    // This is non-critical functionality\n  }\n}\n\n/**\n * Download and install a package without executing it.\n * This is useful for self-update or when you need the package files\n * but don't want to run the binary immediately.\n *\n * @example\n * ```typescript\n * // Install @socketsecurity/cli without running it\n * const result = await downloadPackage({\n *   package: '@socketsecurity/cli@1.2.0',\n *   force: true\n * })\n * console.log('Installed to:', result.packageDir)\n * console.log('Binary at:', result.binaryPath)\n * ```\n */\nexport async function downloadPackage(\n  options: DlxPackageOptions,\n): Promise<DownloadPackageResult> {\n  const {\n    binaryName,\n    force: userForce,\n    package: packageSpec,\n    yes,\n  } = {\n    __proto__: null,\n    ...options,\n  } as DlxPackageOptions\n\n  // Parse package spec.\n  const { name: packageName, version: packageVersion } =\n    parsePackageSpec(packageSpec)\n\n  // Determine force behavior:\n  // 1. Explicit force takes precedence\n  // 2. --yes flag implies force (auto-approve/skip prompts)\n  // 3. Version ranges auto-force to get latest\n  const isVersionRange =\n    packageVersion !== undefined && rangeOperatorsRegExp.test(packageVersion)\n  const force =\n    userForce !== undefined ? userForce : yes === true ? true : isVersionRange\n\n  // Build full package spec for installation.\n  const fullPackageSpec = packageVersion\n    ? `${packageName}@${packageVersion}`\n    : packageName\n\n  // Ensure package is installed.\n  const { installed, packageDir } = await ensurePackageInstalled(\n    packageName,\n    fullPackageSpec,\n    force,\n  )\n\n  // Find binary path.\n  const binaryPath = findBinaryPath(packageDir, packageName, binaryName)\n\n  // Make all binaries in the package executable on Unix systems.\n  makePackageBinsExecutable(packageDir, packageName)\n\n  return {\n    binaryPath,\n    installed,\n    packageDir,\n  }\n}\n\n/**\n * Execute a package's binary with cross-platform shell handling.\n * The package must already be installed (use downloadPackage first).\n *\n * On Windows, script files (.bat, .cmd, .ps1) require shell: true.\n * Matches npm/npx execution behavior.\n *\n * @example\n * ```typescript\n * // Execute an already-installed package\n * const downloaded = await downloadPackage({ package: 'cowsay@1.5.0' })\n * const result = await executePackage(\n *   downloaded.binaryPath,\n *   ['Hello World'],\n *   { stdio: 'inherit' }\n * )\n * ```\n */\nexport function executePackage(\n  binaryPath: string,\n  args: readonly string[] | string[],\n  spawnOptions?: SpawnOptions | undefined,\n  spawnExtra?: SpawnExtra | undefined,\n): ReturnType<typeof spawn> {\n  // On Windows, script files (.bat, .cmd, .ps1) require shell: true\n  // because they are not executable on their own and must be run through cmd.exe.\n  // .exe files are actual binaries and don't need shell mode.\n  const needsShell = WIN32 && /\\.(?:bat|cmd|ps1)$/i.test(binaryPath)\n\n  const finalOptions = needsShell\n    ? {\n        ...spawnOptions,\n        shell: true,\n      }\n    : spawnOptions\n\n  return spawn(binaryPath, args, finalOptions, spawnExtra)\n}\n"],
-  "mappings": "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",
-  "names": ["import_path", "path"]
-}

package/dist/dlx.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/dlx.ts"],
-  "sourcesContent": ["/** @fileoverview DLX (execute package) utilities for Socket ecosystem shared installations. */\n\nimport { createHash } from 'crypto'\n\nimport { readDirNamesSync, safeDelete, safeMkdir, safeMkdirSync } from './fs'\nimport { normalizePath } from './path'\nimport { getSocketDlxDir } from './paths'\nimport { pEach } from './promises'\n\nlet _fs: typeof import('fs') | undefined\n/**\n * Lazily load the fs module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js fs module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFs() {\n  if (_fs === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _fs = /*@__PURE__*/ require('node:fs')\n  }\n  return _fs as typeof import('fs')\n}\n\n/**\n * Generate a cache directory name using npm/npx approach.\n * Uses first 16 characters of SHA-512 hash (like npm/npx).\n *\n * Rationale for SHA-512 truncated (vs full SHA-256):\n * - Matches npm/npx ecosystem behavior\n * - Shorter paths for Windows MAX_PATH compatibility (260 chars)\n * - 16 hex chars = 64 bits = acceptable collision risk for local cache\n * - Collision probability ~1 in 18 quintillion with 1000 entries\n *\n * Input strategy (aligned with npx):\n * - npx uses package spec strings (e.g., '@scope/pkg@1.0.0', 'prettier@3.0.0')\n * - Caller provides complete spec string with version for accurate cache keying\n * - For package installs: Use PURL-style spec with version\n *   Examples: 'npm:prettier@3.0.0', 'pypi:requests@2.31.0', 'gem:rails@7.0.0'\n *   Note: Socket uses shorthand format without 'pkg:' prefix\n *   (handled by @socketregistry/packageurl-js)\n * - For binary downloads: Use URL:name for uniqueness\n *\n * Reference: npm/cli v11.6.2 libnpmexec/lib/index.js#L233-L244\n * https://github.com/npm/cli/blob/v11.6.2/workspaces/libnpmexec/lib/index.js#L233-L244\n * Implementation: packages.map().sort().join('\\n') \u2192 SHA-512 \u2192 slice(0,16)\n * npx hashes the package spec (name@version), not just name\n */\nexport function generateCacheKey(spec: string): string {\n  return createHash('sha512').update(spec).digest('hex').substring(0, 16)\n}\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path!\n}\n\n/**\n * Clear all DLX package installations.\n */\nexport async function clearDlx(): Promise<void> {\n  const packages = await listDlxPackagesAsync()\n  await pEach(packages, pkg => removeDlxPackage(pkg))\n}\n\n/**\n * Clear all DLX package installations synchronously.\n */\nexport function clearDlxSync(): void {\n  const packages = listDlxPackages()\n  for (const pkg of packages) {\n    removeDlxPackageSync(pkg)\n  }\n}\n\n/**\n * Check if the DLX directory exists.\n */\nexport function dlxDirExists(): boolean {\n  const fs = getFs()\n  return fs.existsSync(getSocketDlxDir())\n}\n\n/**\n * Check if the DLX directory exists asynchronously.\n */\nexport async function dlxDirExistsAsync(): Promise<boolean> {\n  const fs = getFs()\n  try {\n    await fs.promises.access(getSocketDlxDir())\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Ensure the DLX directory exists, creating it if necessary.\n */\nexport async function ensureDlxDir(): Promise<void> {\n  await safeMkdir(getSocketDlxDir())\n}\n\n/**\n * Ensure the DLX directory exists synchronously, creating it if necessary.\n */\nexport function ensureDlxDirSync(): void {\n  safeMkdirSync(getSocketDlxDir())\n}\n\n/**\n * Get the installed package directory within DLX node_modules.\n */\nexport function getDlxInstalledPackageDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(\n    path.join(getDlxPackageNodeModulesDir(packageName), packageName),\n  )\n}\n\n/**\n * Get the DLX installation directory for a specific package.\n */\nexport function getDlxPackageDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(path.join(getSocketDlxDir(), packageName))\n}\n\n/**\n * Get the package.json path for a DLX installed package.\n */\nexport function getDlxPackageJsonPath(packageName: string): string {\n  const path = getPath()\n  return normalizePath(\n    path.join(getDlxInstalledPackageDir(packageName), 'package.json'),\n  )\n}\n\n/**\n * Get the node_modules directory for a DLX package installation.\n */\nexport function getDlxPackageNodeModulesDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(path.join(getDlxPackageDir(packageName), 'node_modules'))\n}\n\n/**\n * Check if a file path is within the Socket DLX directory.\n * This is useful for determining if a binary or file is managed by Socket's DLX system.\n *\n * @param filePath - Absolute or relative path to check\n * @returns true if the path is within ~/.socket/_dlx/, false otherwise\n *\n * @example\n * ```typescript\n * isInSocketDlx('/home/user/.socket/_dlx/abc123/bin/socket') // true\n * isInSocketDlx('/usr/local/bin/socket') // false\n * isInSocketDlx(process.argv[0]) // Check if current binary is in DLX\n * ```\n */\nexport function isInSocketDlx(filePath: string): boolean {\n  if (!filePath) {\n    return false\n  }\n\n  const path = getPath()\n  const dlxDir = getSocketDlxDir()\n  const absolutePath = normalizePath(path.resolve(filePath))\n\n  // Check if the absolute path starts with the DLX directory.\n  // Both paths are normalized to use forward slashes for consistent comparison.\n  return absolutePath.startsWith(`${dlxDir}/`)\n}\n\n/**\n * Check if a package is installed in DLX.\n */\nexport function isDlxPackageInstalled(packageName: string): boolean {\n  const fs = getFs()\n  return fs.existsSync(getDlxInstalledPackageDir(packageName))\n}\n\n/**\n * Check if a package is installed in DLX asynchronously.\n */\nexport async function isDlxPackageInstalledAsync(\n  packageName: string,\n): Promise<boolean> {\n  const fs = getFs()\n  try {\n    await fs.promises.access(getDlxInstalledPackageDir(packageName))\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * List all packages installed in DLX.\n */\nexport function listDlxPackages(): string[] {\n  try {\n    return readDirNamesSync(getSocketDlxDir(), { sort: true })\n  } catch {\n    return []\n  }\n}\n\n/**\n * List all packages installed in DLX asynchronously.\n */\nexport async function listDlxPackagesAsync(): Promise<string[]> {\n  const fs = getFs()\n  try {\n    const entries = await fs.promises.readdir(getSocketDlxDir(), {\n      withFileTypes: true,\n    })\n    return entries\n      .filter(e => e.isDirectory())\n      .map(e => e.name)\n      .sort()\n  } catch {\n    return []\n  }\n}\n\n/**\n * Remove a DLX package installation.\n */\nexport async function removeDlxPackage(packageName: string): Promise<void> {\n  const packageDir = getDlxPackageDir(packageName)\n  try {\n    await safeDelete(packageDir, { recursive: true, force: true })\n  } catch (e) {\n    throw new Error(`Failed to remove DLX package \"${packageName}\"`, {\n      cause: e,\n    })\n  }\n}\n\n/**\n * Remove a DLX package installation synchronously.\n */\nexport function removeDlxPackageSync(packageName: string): void {\n  const fs = getFs()\n  const packageDir = getDlxPackageDir(packageName)\n  try {\n    fs.rmSync(packageDir, { recursive: true, force: true })\n  } catch (e) {\n    const code = (e as NodeJS.ErrnoException).code\n    if (code === 'EACCES' || code === 'EPERM') {\n      throw new Error(\n        `Permission denied removing DLX package \"${packageName}\"\\n` +\n          `Directory: ${packageDir}\\n` +\n          'To resolve:\\n' +\n          '  1. Check file/directory permissions\\n' +\n          '  2. Close any programs using files in this directory\\n' +\n          '  3. Try running with elevated privileges if necessary\\n' +\n          `  4. Manually remove: rm -rf \"${packageDir}\"`,\n        { cause: e },\n      )\n    }\n    if (code === 'EROFS') {\n      throw new Error(\n        `Cannot remove DLX package \"${packageName}\" from read-only filesystem\\n` +\n          `Directory: ${packageDir}\\n` +\n          'The filesystem is mounted read-only.',\n        { cause: e },\n      )\n    }\n    throw new Error(\n      `Failed to remove DLX package \"${packageName}\"\\n` +\n        `Directory: ${packageDir}\\n` +\n        'Check permissions and ensure no programs are using this directory.',\n      { cause: e },\n    )\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/effects/pulse-frames.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/effects/pulse-frames.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Socket pulse animation frames generator.\n * Generates themeable pulsing animation frames using sparkles (\u2727 \u2726) and lightning (\u26A1).\n * Follows the cli-spinners format: https://github.com/sindresorhus/cli-spinners\n */\n\nexport type SocketFramesOptions = {\n  readonly baseColor?: readonly [number, number, number] | undefined\n  readonly interval?: number | undefined\n  /**\n   * Theme to use for pulse colors.\n   * Can be a theme name ('socket', 'sunset', etc.) or a Theme object.\n   * Note: Currently frames only contain brightness modifiers.\n   * Colors are applied by yocto-spinner based on spinner.color.\n   */\n  readonly theme?:\n    | import('../themes/types').Theme\n    | import('../themes/themes').ThemeName\n    | undefined\n}\n\n/**\n * Generate Socket pulse animation frames.\n * Creates a pulsing throbber using Unicode sparkles and lightning symbols.\n * Frames use brightness modifiers (bold/dim) but no embedded colors.\n * Yocto-spinner applies the current spinner color to each frame.\n *\n * Returns a spinner definition compatible with cli-spinners format.\n *\n * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json\n */\nexport function generateSocketSpinnerFrames(\n  options?: SocketFramesOptions | undefined,\n): {\n  frames: string[]\n  interval: number\n} {\n  const opts = { __proto__: null, ...options } as SocketFramesOptions\n  const interval = opts.interval ?? 50\n\n  // ANSI codes for brightness modifiers only (no colors).\n  // Yocto-spinner will apply the spinner's current color to each frame.\n  const bold = '\\x1b[1m'\n  const dim = '\\x1b[2m'\n  const reset = '\\x1b[0m'\n\n  // Using VS15 (\\uFE0E) to force text-style rendering.\n  // Lightning bolt (\u26A1) is wider than stars. To keep consistent spacing:\n  // - All frames have NO internal padding\n  // - Yocto-spinner adds 1 space after each frame\n  // - Success/fail symbols also get 1 space (consistent)\n  const lightning = '\u26A1\\uFE0E'\n  const starFilled = '\u2726\\uFE0E'\n  const starOutline = '\u2727\\uFE0E'\n  const starTiny = '\u22C6\\uFE0E'\n\n  // Pulse frames with brightness modifiers only.\n  // Each frame gets colored by yocto-spinner based on current spinner.color.\n  // Yocto-spinner adds 1 space after the frame automatically.\n  const frames = [\n    // Build up from dim to bright\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    // Fade down\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${dim}${starOutline}${reset}`,\n  ]\n\n  return {\n    __proto__: null,\n    frames,\n    interval,\n  } as { frames: string[]; interval: number }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA+BO,SAAS,4BACd,SAIA;AACA,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,WAAW,KAAK,YAAY;AAIlC,QAAM,OAAO;AACb,QAAM,MAAM;AACZ,QAAM,QAAQ;AAOd,QAAM,YAAY;AAClB,QAAM,aAAa;AACnB,QAAM,cAAc;AACpB,QAAM,WAAW;AAKjB,QAAM,SAAS;AAAA;AAAA,IAEb,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA;AAAA,IAE3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,EAC9B;AAEA,SAAO;AAAA,IACL,WAAW;AAAA,IACX;AAAA,IACA;AAAA,EACF;AACF;",
-  "names": []
-}

package/dist/effects/text-shimmer.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/effects/text-shimmer.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Text shimmer animation utilities.\n * Provides animated highlight effects for spinner text with configurable directions:\n * - LTR (left-to-right): Shimmer wave moves from left to right\n * - RTL (right-to-left): Shimmer wave moves from right to left\n * - Bidirectional: Alternates between LTR and RTL each cycle\n * - Random: Picks a random direction each cycle\n * - None: No shimmer animation\n *\n * The shimmer effect creates a bright wave that travels across the text,\n * with characters near the wave appearing nearly white and fading to the\n * base color as they get further from the wave position.\n */\n\nimport { ANSI_RESET, stripAnsi } from '../ansi'\nimport { isArray } from '../arrays'\nimport { getCI } from '#env/ci'\nimport { resolveColor } from '../themes/utils'\nimport { THEMES } from '../themes/themes'\nimport type { ColorValue } from '../spinner'\n\nimport type {\n  ShimmerColorGradient,\n  ShimmerColorRgb,\n  ShimmerDirection,\n  ShimmerState,\n} from './types'\n\n// Re-export types for backward compatibility.\nexport type {\n  ShimmerColor,\n  ShimmerColorGradient,\n  ShimmerColorInherit,\n  ShimmerColorRgb,\n  ShimmerConfig,\n  ShimmerDirection,\n  ShimmerState,\n} from './types'\n\n/**\n * Detected text formatting styles from ANSI codes.\n */\ntype TextStyles = {\n  bold: boolean\n  dim: boolean\n  italic: boolean\n  strikethrough: boolean\n  underline: boolean\n}\n\n/**\n * Detect all text formatting styles present in ANSI-coded text.\n * Checks for bold, dim, italic, underline, and strikethrough.\n */\nfunction detectStyles(text: string): TextStyles {\n  return {\n    __proto__: null,\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    bold: /\\x1b\\[1m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    dim: /\\x1b\\[2m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    italic: /\\x1b\\[3m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    strikethrough: /\\x1b\\[9m/.test(text),\n    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.\n    underline: /\\x1b\\[4m/.test(text),\n  } as TextStyles\n}\n\n/**\n * Build ANSI code string from text styles.\n * Returns the concatenated ANSI codes needed to apply the styles.\n */\nfunction stylesToAnsi(styles: TextStyles): string {\n  let codes = ''\n  if (styles.bold) {\n    codes += '\\x1b[1m'\n  }\n  if (styles.dim) {\n    codes += '\\x1b[2m'\n  }\n  if (styles.italic) {\n    codes += '\\x1b[3m'\n  }\n  if (styles.underline) {\n    codes += '\\x1b[4m'\n  }\n  if (styles.strikethrough) {\n    codes += '\\x1b[9m'\n  }\n  return codes\n}\n\n// Internal options for applyShimmer function.\ntype ShimmerOptions = {\n  readonly color?: ShimmerColorRgb | ShimmerColorGradient | undefined\n  readonly direction?: ShimmerDirection | undefined\n  readonly shimmerWidth?: number | undefined\n  readonly styles?: TextStyles | undefined\n  readonly theme?:\n    | import('../themes/types').Theme\n    | import('../themes/themes').ThemeName\n    | undefined\n}\n\nexport const COLOR_INHERIT = 'inherit'\n\nexport const DIR_LTR = 'ltr'\n\nexport const DIR_NONE = 'none'\n\nexport const DIR_RANDOM = 'random'\n\nexport const DIR_RTL = 'rtl'\n\nexport const MODE_BI = 'bi'\n\n/**\n * Calculate shimmer intensity based on distance from shimmer wave position.\n * Uses a power curve for smooth falloff - characters close to the wave\n * get high intensity (bright white), while distant characters get 0.\n */\nfunction shimmerIntensity(\n  distance: number,\n  shimmerWidth: number = 2.5,\n): number {\n  // Characters beyond shimmer width get no effect.\n  if (distance > shimmerWidth) {\n    return 0\n  }\n  // Smooth falloff using power curve.\n  const normalized = distance / shimmerWidth\n  return (1 - normalized) ** 2.5\n}\n\n/**\n * Blend two RGB colors based on a blend factor (0-1).\n * factor 0 = color1, factor 1 = color2, factor 0.5 = 50/50 blend.\n */\nfunction blendColors(\n  color1: readonly [number, number, number],\n  color2: readonly [number, number, number],\n  factor: number,\n): readonly [number, number, number] {\n  const r = Math.round(color1[0] + (color2[0] - color1[0]) * factor)\n  const g = Math.round(color1[1] + (color2[1] - color1[1]) * factor)\n  const b = Math.round(color1[2] + (color2[2] - color1[2]) * factor)\n  return [r, g, b] as const\n}\n\n/**\n * Render character with shimmer effect based on distance from shimmer position.\n * Characters closer to the shimmer position get brighter (nearly white),\n * while characters further away use the base color.\n * Creates a smooth gradient by blending base color with white based on intensity.\n * Supports both single color and per-character color gradients.\n */\nfunction renderChar(\n  char: string,\n  index: number,\n  shimmerPos: number,\n  baseColor: readonly [number, number, number] | ShimmerColorGradient,\n  styles: TextStyles,\n): string {\n  // Calculate how far this character is from the shimmer wave.\n  const distance = Math.abs(index - shimmerPos)\n  const intensity = shimmerIntensity(distance)\n\n  const styleCode = stylesToAnsi(styles)\n\n  // Get base color for this character (single or per-character from gradient).\n  const charColor: readonly [number, number, number] = isArray(baseColor[0])\n    ? ((baseColor as ShimmerColorGradient)[index % baseColor.length] ?? [\n        140, 82, 255,\n      ])\n    : (baseColor as readonly [number, number, number])\n\n  // If no shimmer intensity, use base color as-is.\n  if (intensity === 0) {\n    const base = `\\x1b[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`\n    return `${styleCode}${base}${char}${ANSI_RESET}`\n  }\n\n  // Blend base color with white based on intensity to create smooth gradient.\n  // Higher intensity = more white, creating the shimmer wave effect.\n  const white: readonly [number, number, number] = [255, 255, 255] as const\n  const blended = blendColors(charColor, white, intensity)\n\n  const color = `\\x1b[38;2;${blended[0]};${blended[1]};${blended[2]}m`\n  return `${styleCode}${color}${char}${ANSI_RESET}`\n}\n\n/**\n * Calculate shimmer wave position for current animation step.\n * The shimmer wave moves across the text length, with extra space\n * for the wave to fade in/out at the edges.\n */\nfunction getShimmerPos(\n  textLength: number,\n  step: number,\n  currentDir: 'ltr' | 'rtl',\n  shimmerWidth: number = 2.5,\n): number {\n  // Total steps for one complete cycle (text length + fade in/out space).\n  const totalSteps = textLength + shimmerWidth + 2\n\n  // RTL: Shimmer moves from right to left.\n  if (currentDir === DIR_RTL) {\n    return textLength - (step % totalSteps)\n  }\n\n  // LTR: Shimmer moves from left to right.\n  return step % totalSteps\n}\n\n/**\n * Resolve shimmer direction to a concrete 'ltr' or 'rtl' value.\n * Used for initializing shimmer state and picking random directions.\n */\nfunction pickDirection(direction: ShimmerDirection): 'ltr' | 'rtl' {\n  // Random mode: 50/50 chance of LTR or RTL.\n  if (direction === DIR_RANDOM) {\n    return Math.random() < 0.5 ? DIR_LTR : DIR_RTL\n  }\n  // RTL mode: Use RTL direction.\n  if (direction === DIR_RTL) {\n    return DIR_RTL\n  }\n  // LTR mode (or any other): Default to LTR.\n  return DIR_LTR\n}\n\n/**\n * Apply shimmer animation effect to text.\n * This is the main entry point for shimmer animations. It:\n * 1. Strips ANSI codes to get plain text for character positioning\n * 2. Detects any styling (bold, italic, underline, etc.) to preserve\n * 3. Calculates the current shimmer wave position based on animation step\n * 4. Renders each character with appropriate brightness based on distance from wave\n * 5. Updates the animation state for the next frame\n * 6. Handles direction changes for bidirectional and random modes\n */\nexport function applyShimmer(\n  text: string,\n  state: ShimmerState,\n  options?: ShimmerOptions | undefined,\n): string {\n  const opts = { __proto__: null, ...options } as ShimmerOptions\n  const direction = opts.direction ?? DIR_NONE\n  const shimmerWidth = opts.shimmerWidth ?? 2.5\n\n  // Resolve color from theme or use provided color or default Socket purple.\n  let color: ShimmerColorRgb | ShimmerColorGradient\n  if (opts.theme) {\n    // Resolve theme to Theme object\n    const theme =\n      typeof opts.theme === 'string' ? THEMES[opts.theme] : opts.theme\n    // Use theme's primary color\n    const themeColor = resolveColor(\n      theme.colors.primary,\n      theme.colors,\n    ) as ColorValue\n    // Convert ColorValue to ShimmerColorRgb\n    // Fallback to Socket purple if color is a string\n    color =\n      typeof themeColor === 'string' ? ([140, 82, 255] as const) : themeColor\n  } else {\n    color = opts.color ?? ([140, 82, 255] as const)\n  }\n\n  // Detect text formatting styles from original text.\n  const styles = opts.styles ?? detectStyles(text)\n\n  // Strip ANSI codes to get plain text.\n  const plainText = stripAnsi(text)\n\n  // No shimmer effect in CI or when direction is 'none'.\n  if (getCI() || !plainText || direction === DIR_NONE) {\n    const styleCode = stylesToAnsi(styles)\n\n    // Support gradient colors (array of colors, one per character).\n    const isGradient = isArray(color[0])\n\n    return plainText\n      .split('')\n      .map((char, i) => {\n        const charColor: readonly [number, number, number] = isGradient\n          ? ((color as ShimmerColorGradient)[i % color.length] ?? [\n              140, 82, 255,\n            ])\n          : (color as readonly [number, number, number])\n        const base = `\\x1b[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`\n        return `${styleCode}${base}${char}${ANSI_RESET}`\n      })\n      .join('')\n  }\n\n  // Calculate shimmer position.\n  const shimmerPos = getShimmerPos(\n    plainText.length,\n    state.step,\n    state.currentDir,\n    shimmerWidth,\n  )\n\n  // Render text with shimmer.\n  const result = plainText\n    .split('')\n    .map((char, i) => renderChar(char, i, shimmerPos, color, styles))\n    .join('')\n\n  // Advance shimmer position by speed amount each frame.\n  // Speed represents steps per frame (e.g., 0.33 = advance 0.33 steps per frame).\n  // This creates smooth animation by moving in small increments every frame\n  // instead of jumping larger distances every N frames.\n  state.step += state.speed\n\n  // Handle bidirectional direction changes.\n  const totalSteps = plainText.length + shimmerWidth + 2\n  if (state.mode === MODE_BI) {\n    if (state.step >= totalSteps) {\n      state.step = 0\n      // Toggle direction every cycle.\n      state.currentDir = state.currentDir === DIR_LTR ? DIR_RTL : DIR_LTR\n    }\n  } else if (state.mode === DIR_RANDOM) {\n    // Change direction randomly at end of each cycle.\n    if (state.step >= totalSteps) {\n      state.step = 0\n      state.currentDir = pickDirection(DIR_RANDOM)\n    }\n  } else {\n    // Reset for continuous loops.\n    if (state.step >= totalSteps) {\n      state.step = 0\n    }\n  }\n\n  return result\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/effects/types.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/effects/types.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Shared types for effects (shimmer, pulse, ultra, etc.).\n * Common type definitions used across multiple effect modules.\n */\n\nexport type ShimmerColorInherit = 'inherit'\n\nexport type ShimmerColorRgb = readonly [number, number, number]\n\nexport type ShimmerColor = ShimmerColorInherit | ShimmerColorRgb\n\nexport type ShimmerColorGradient = readonly ShimmerColorRgb[]\n\nexport type ShimmerDirection = 'ltr' | 'rtl' | 'bi' | 'random' | 'none'\n\n/**\n * Shimmer animation configuration.\n */\nexport type ShimmerConfig = {\n  readonly color?: ShimmerColor | ShimmerColorGradient | undefined\n  readonly dir?: ShimmerDirection | undefined\n  /**\n   * Animation speed in steps per frame.\n   * Lower values = slower shimmer (e.g., 0.33 = ~150ms per step).\n   * Higher values = faster shimmer (e.g., 1.0 = 50ms per step).\n   * Default: 1/3 (~0.33).\n   */\n  readonly speed?: number | undefined\n  /**\n   * Theme to use for shimmer colors.\n   * Can be a theme name ('socket', 'sunset', etc.) or a Theme object.\n   * If provided, overrides the color option.\n   */\n  readonly theme?:\n    | import('../themes/types').Theme\n    | import('../themes/themes').ThemeName\n    | undefined\n}\n\n/**\n * Internal shimmer animation state.\n * Tracks current animation position and direction.\n */\nexport type ShimmerState = {\n  currentDir: 'ltr' | 'rtl'\n  mode: ShimmerDirection\n  /**\n   * Animation speed in steps per frame.\n   * The shimmer position advances by this amount every frame.\n   */\n  speed: number\n  /**\n   * Current shimmer position.\n   * Can be fractional for smooth sub-character movement.\n   */\n  step: number\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
-  "names": []
-}

package/dist/effects/ultra.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/effects/ultra.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Ultrathink rainbow gradient effect.\n * Provides rainbow gradient color generation for shimmer animations.\n * \"Ultrathink\" is Claude's intensive thinking mode for deep analysis.\n */\n\nimport type { ShimmerColorGradient, ShimmerColorRgb } from './types'\n\n/**\n * Rainbow gradient colors used for ultrathink effect.\n * This gradient cycles through the full color spectrum with smooth transitions.\n */\nexport const RAINBOW_GRADIENT: ShimmerColorGradient = [\n  // Red/pink.\n  [255, 100, 120],\n  // Orange.\n  [255, 140, 80],\n  // Yellow/gold.\n  [255, 180, 60],\n  // Yellow/green.\n  [220, 200, 80],\n  // Green.\n  [120, 200, 100],\n  // Cyan/turquoise.\n  [80, 200, 180],\n  // Blue.\n  [80, 160, 220],\n  // Purple/violet.\n  [140, 120, 220],\n  // Pink/magenta.\n  [200, 100, 200],\n  // Red/pink.\n  [255, 100, 140],\n]\n\n/**\n * Generate rainbow gradient colors for any text length.\n * Colors are distributed evenly across the text by cycling through the gradient.\n */\nexport function generateRainbowGradient(\n  textLength: number,\n): ShimmerColorGradient {\n  const colors: ShimmerColorRgb[] = []\n\n  for (let i = 0; i < textLength; i += 1) {\n    const colorIndex = i % RAINBOW_GRADIENT.length\n    const color = RAINBOW_GRADIENT[colorIndex]\n    if (color) {\n      colors.push(color)\n    }\n  }\n\n  return colors as ShimmerColorGradient\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYO,MAAM,mBAAyC;AAAA;AAAA,EAEpD,CAAC,KAAK,KAAK,GAAG;AAAA;AAAA,EAEd,CAAC,KAAK,KAAK,EAAE;AAAA;AAAA,EAEb,CAAC,KAAK,KAAK,EAAE;AAAA;AAAA,EAEb,CAAC,KAAK,KAAK,EAAE;AAAA;AAAA,EAEb,CAAC,KAAK,KAAK,GAAG;AAAA;AAAA,EAEd,CAAC,IAAI,KAAK,GAAG;AAAA;AAAA,EAEb,CAAC,IAAI,KAAK,GAAG;AAAA;AAAA,EAEb,CAAC,KAAK,KAAK,GAAG;AAAA;AAAA,EAEd,CAAC,KAAK,KAAK,GAAG;AAAA;AAAA,EAEd,CAAC,KAAK,KAAK,GAAG;AAChB;AAMO,SAAS,wBACd,YACsB;AACtB,QAAM,SAA4B,CAAC;AAEnC,WAAS,IAAI,GAAG,IAAI,YAAY,KAAK,GAAG;AACtC,UAAM,aAAa,IAAI,iBAAiB;AACxC,UAAM,QAAQ,iBAAiB,UAAU;AACzC,QAAI,OAAO;AACT,aAAO,KAAK,KAAK;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AACT;",
-  "names": []
-}