@socketsecurity/lib 1.0.2 → 1.0.4

package/dist/packages/provenance.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/packages/provenance.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Package provenance and attestation verification utilities.\n */\n\nimport { NPM_REGISTRY_URL } from '#constants/agents'\n\nimport { createCompositeAbortSignal, createTimeoutSignal } from '../abort'\nimport type { ProvenanceOptions } from '../packages'\nimport { parseUrl } from '../url'\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 ArrayIsArray = Array.isArray\n\nconst SLSA_PROVENANCE_V0_2 = 'https://slsa.dev/provenance/v0.2'\nconst SLSA_PROVENANCE_V1_0 = 'https://slsa.dev/provenance/v1'\n\nlet _fetcher: typeof import('make-fetch-happen') | undefined\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFetcher() {\n  if (_fetcher === undefined) {\n    const makeFetchHappen =\n      /*@__PURE__*/ require('../../external/make-fetch-happen')\n    // Lazy load constants to avoid circular dependencies.\n    const { getPacoteCachePath } =\n      /*@__PURE__*/ require('../../constants/packages')\n    _fetcher = makeFetchHappen.defaults({\n      cachePath: getPacoteCachePath(),\n      // Prefer-offline: Staleness checks for cached data will be bypassed, but\n      // missing data will be requested from the server.\n      // https://github.com/npm/make-fetch-happen?tab=readme-ov-file#--optscache\n      cache: 'force-cache',\n    })\n  }\n  return _fetcher as typeof import('make-fetch-happen')\n}\n\n/**\n * Extract and filter SLSA provenance attestations from attestation data.\n */\nfunction getAttestations(attestationData: unknown): unknown[] {\n  const data = attestationData as { attestations?: unknown[] }\n  if (!data.attestations || !ArrayIsArray(data.attestations)) {\n    return []\n  }\n\n  return data.attestations.filter((attestation: unknown) => {\n    const att = attestation as { predicateType?: string }\n    return (\n      att.predicateType === SLSA_PROVENANCE_V0_2 ||\n      att.predicateType === SLSA_PROVENANCE_V1_0\n    )\n  })\n}\n\n/**\n * Find the first attestation with valid provenance data.\n */\nfunction findProvenance(attestations: unknown[]): unknown {\n  for (const attestation of attestations) {\n    const att = attestation as {\n      bundle?: { dsseEnvelope?: { payload?: string } }\n      predicate?: unknown\n    }\n    try {\n      let predicate = att.predicate\n\n      // If predicate is not directly available, try to decode from DSSE envelope\n      if (!predicate && att.bundle?.dsseEnvelope?.payload) {\n        try {\n          const decodedPayload = Buffer.from(\n            att.bundle.dsseEnvelope.payload,\n            'base64',\n          ).toString('utf8')\n          const statement = JSON.parse(decodedPayload)\n          predicate = statement.predicate\n        } catch {\n          // Failed to decode, continue to next attestation\n          continue\n        }\n      }\n\n      const predicateData = predicate as {\n        buildDefinition?: { externalParameters?: unknown }\n      }\n      if (predicateData?.buildDefinition?.externalParameters) {\n        return {\n          predicate,\n          externalParameters: predicateData.buildDefinition.externalParameters,\n        }\n      }\n      // c8 ignore start - Error handling for malformed attestation data should continue processing other attestations.\n    } catch {\n      // Continue checking other attestations if one fails to parse\n    }\n    // c8 ignore stop\n  }\n  return undefined\n}\n\n/**\n * Check if a value indicates a trusted publisher (GitHub or GitLab).\n */\nfunction isTrustedPublisher(value: unknown): boolean {\n  if (typeof value !== 'string' || !value) {\n    return false\n  }\n\n  let url = parseUrl(value)\n  let hostname = url?.hostname\n\n  // Handle GitHub workflow refs with @ syntax by trying the first part.\n  // Example: \"https://github.com/owner/repo/.github/workflows/ci.yml@refs/heads/main\"\n  if (!url && value.includes('@')) {\n    const firstPart = value.split('@')[0]\n    if (firstPart) {\n      url = parseUrl(firstPart)\n    }\n    if (url) {\n      hostname = url.hostname\n    }\n  }\n\n  // Try common URL prefixes if not already a complete URL.\n  if (!url) {\n    const httpsUrl = parseUrl(`https://${value}`)\n    if (httpsUrl) {\n      hostname = httpsUrl.hostname\n    }\n  }\n\n  if (hostname) {\n    return (\n      hostname === 'github.com' ||\n      hostname.endsWith('.github.com') ||\n      hostname === 'gitlab.com' ||\n      hostname.endsWith('.gitlab.com')\n    )\n  }\n\n  // Fallback: check for provider keywords in non-URL strings.\n  return value.includes('github') || value.includes('gitlab')\n}\n\n/**\n * Convert raw attestation data to user-friendly provenance details.\n */\nexport function getProvenanceDetails(attestationData: unknown): unknown {\n  const attestations = getAttestations(attestationData)\n  if (!attestations.length) {\n    return undefined\n  }\n  // Find the first attestation with valid provenance data.\n  const provenance = findProvenance(attestations)\n  if (!provenance) {\n    return { level: 'attested' }\n  }\n\n  const provenanceData = provenance as {\n    externalParameters?: {\n      context?: string\n      ref?: string\n      repository?: string\n      run_id?: string\n      sha?: string\n      workflow?: {\n        ref?: string\n        repository?: string\n      }\n      workflow_ref?: string\n    }\n    predicate?: {\n      buildDefinition?: { buildType?: string }\n    }\n  }\n  const { externalParameters, predicate } = provenanceData\n  const def = predicate?.buildDefinition\n\n  // Handle both SLSA v0.2 (direct properties) and v1 (nested workflow object)\n  const workflow = externalParameters?.workflow\n  const workflowRef = workflow?.ref || externalParameters?.workflow_ref\n  const workflowUrl = externalParameters?.context\n  const workflowPlatform = def?.buildType\n  const repository = workflow?.repository || externalParameters?.repository\n  const gitRef = externalParameters?.ref || workflow?.ref\n  const commitSha = externalParameters?.sha\n  const workflowRunId = externalParameters?.run_id\n\n  // Check for trusted publishers (GitHub Actions, GitLab CI/CD).\n  const trusted =\n    isTrustedPublisher(workflowRef) ||\n    isTrustedPublisher(workflowUrl) ||\n    isTrustedPublisher(workflowPlatform) ||\n    isTrustedPublisher(repository)\n\n  return {\n    commitSha,\n    gitRef,\n    level: trusted ? 'trusted' : 'attested',\n    repository,\n    workflowRef,\n    workflowUrl,\n    workflowPlatform,\n    workflowRunId,\n  }\n}\n\n/**\n * Fetch package provenance information from npm registry.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function fetchPackageProvenance(\n  pkgName: string,\n  pkgVersion: string,\n  options?: ProvenanceOptions,\n): Promise<unknown> {\n  const { signal, timeout = 10_000 } = {\n    __proto__: null,\n    ...options,\n  } as ProvenanceOptions\n\n  if (signal?.aborted) {\n    return undefined\n  }\n\n  // Create composite signal combining external signal with timeout\n  const timeoutSignal = createTimeoutSignal(timeout)\n  const compositeSignal = createCompositeAbortSignal(signal, timeoutSignal)\n  const fetcher = getFetcher()\n\n  try {\n    const response = await fetcher(\n      // The npm registry attestations API endpoint.\n      `${NPM_REGISTRY_URL}/-/npm/v1/attestations/${encodeURIComponent(pkgName)}@${encodeURIComponent(pkgVersion)}`,\n      {\n        method: 'GET',\n        signal: compositeSignal,\n        headers: {\n          'User-Agent': 'socket-registry',\n        },\n      } as {\n        method: string\n        signal: AbortSignal\n        headers: Record<string, string>\n      },\n    )\n    if (response.ok) {\n      return getProvenanceDetails(await response.json())\n    }\n  } catch {}\n  return undefined\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @fileoverview Package provenance and attestation verification utilities.\n */\n\nimport { NPM_REGISTRY_URL } from '#constants/agents'\n\nimport { createCompositeAbortSignal, createTimeoutSignal } from '../abort'\nimport type { ProvenanceOptions } from '../packages'\nimport { parseUrl } from '../url'\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 ArrayIsArray = Array.isArray\n\nconst SLSA_PROVENANCE_V0_2 = 'https://slsa.dev/provenance/v0.2'\nconst SLSA_PROVENANCE_V1_0 = 'https://slsa.dev/provenance/v1'\n\nlet _fetcher: typeof import('make-fetch-happen') | undefined\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFetcher() {\n  if (_fetcher === undefined) {\n    const makeFetchHappen =\n      /*@__PURE__*/ require('../external/make-fetch-happen')\n    // Lazy load constants to avoid circular dependencies.\n    const { getPacoteCachePath } =\n      /*@__PURE__*/ require('../../constants/packages')\n    _fetcher = makeFetchHappen.defaults({\n      cachePath: getPacoteCachePath(),\n      // Prefer-offline: Staleness checks for cached data will be bypassed, but\n      // missing data will be requested from the server.\n      // https://github.com/npm/make-fetch-happen?tab=readme-ov-file#--optscache\n      cache: 'force-cache',\n    })\n  }\n  return _fetcher as typeof import('make-fetch-happen')\n}\n\n/**\n * Extract and filter SLSA provenance attestations from attestation data.\n */\nfunction getAttestations(attestationData: unknown): unknown[] {\n  const data = attestationData as { attestations?: unknown[] }\n  if (!data.attestations || !ArrayIsArray(data.attestations)) {\n    return []\n  }\n\n  return data.attestations.filter((attestation: unknown) => {\n    const att = attestation as { predicateType?: string }\n    return (\n      att.predicateType === SLSA_PROVENANCE_V0_2 ||\n      att.predicateType === SLSA_PROVENANCE_V1_0\n    )\n  })\n}\n\n/**\n * Find the first attestation with valid provenance data.\n */\nfunction findProvenance(attestations: unknown[]): unknown {\n  for (const attestation of attestations) {\n    const att = attestation as {\n      bundle?: { dsseEnvelope?: { payload?: string } }\n      predicate?: unknown\n    }\n    try {\n      let predicate = att.predicate\n\n      // If predicate is not directly available, try to decode from DSSE envelope\n      if (!predicate && att.bundle?.dsseEnvelope?.payload) {\n        try {\n          const decodedPayload = Buffer.from(\n            att.bundle.dsseEnvelope.payload,\n            'base64',\n          ).toString('utf8')\n          const statement = JSON.parse(decodedPayload)\n          predicate = statement.predicate\n        } catch {\n          // Failed to decode, continue to next attestation\n          continue\n        }\n      }\n\n      const predicateData = predicate as {\n        buildDefinition?: { externalParameters?: unknown }\n      }\n      if (predicateData?.buildDefinition?.externalParameters) {\n        return {\n          predicate,\n          externalParameters: predicateData.buildDefinition.externalParameters,\n        }\n      }\n      // c8 ignore start - Error handling for malformed attestation data should continue processing other attestations.\n    } catch {\n      // Continue checking other attestations if one fails to parse\n    }\n    // c8 ignore stop\n  }\n  return undefined\n}\n\n/**\n * Check if a value indicates a trusted publisher (GitHub or GitLab).\n */\nfunction isTrustedPublisher(value: unknown): boolean {\n  if (typeof value !== 'string' || !value) {\n    return false\n  }\n\n  let url = parseUrl(value)\n  let hostname = url?.hostname\n\n  // Handle GitHub workflow refs with @ syntax by trying the first part.\n  // Example: \"https://github.com/owner/repo/.github/workflows/ci.yml@refs/heads/main\"\n  if (!url && value.includes('@')) {\n    const firstPart = value.split('@')[0]\n    if (firstPart) {\n      url = parseUrl(firstPart)\n    }\n    if (url) {\n      hostname = url.hostname\n    }\n  }\n\n  // Try common URL prefixes if not already a complete URL.\n  if (!url) {\n    const httpsUrl = parseUrl(`https://${value}`)\n    if (httpsUrl) {\n      hostname = httpsUrl.hostname\n    }\n  }\n\n  if (hostname) {\n    return (\n      hostname === 'github.com' ||\n      hostname.endsWith('.github.com') ||\n      hostname === 'gitlab.com' ||\n      hostname.endsWith('.gitlab.com')\n    )\n  }\n\n  // Fallback: check for provider keywords in non-URL strings.\n  return value.includes('github') || value.includes('gitlab')\n}\n\n/**\n * Convert raw attestation data to user-friendly provenance details.\n */\nexport function getProvenanceDetails(attestationData: unknown): unknown {\n  const attestations = getAttestations(attestationData)\n  if (!attestations.length) {\n    return undefined\n  }\n  // Find the first attestation with valid provenance data.\n  const provenance = findProvenance(attestations)\n  if (!provenance) {\n    return { level: 'attested' }\n  }\n\n  const provenanceData = provenance as {\n    externalParameters?: {\n      context?: string\n      ref?: string\n      repository?: string\n      run_id?: string\n      sha?: string\n      workflow?: {\n        ref?: string\n        repository?: string\n      }\n      workflow_ref?: string\n    }\n    predicate?: {\n      buildDefinition?: { buildType?: string }\n    }\n  }\n  const { externalParameters, predicate } = provenanceData\n  const def = predicate?.buildDefinition\n\n  // Handle both SLSA v0.2 (direct properties) and v1 (nested workflow object)\n  const workflow = externalParameters?.workflow\n  const workflowRef = workflow?.ref || externalParameters?.workflow_ref\n  const workflowUrl = externalParameters?.context\n  const workflowPlatform = def?.buildType\n  const repository = workflow?.repository || externalParameters?.repository\n  const gitRef = externalParameters?.ref || workflow?.ref\n  const commitSha = externalParameters?.sha\n  const workflowRunId = externalParameters?.run_id\n\n  // Check for trusted publishers (GitHub Actions, GitLab CI/CD).\n  const trusted =\n    isTrustedPublisher(workflowRef) ||\n    isTrustedPublisher(workflowUrl) ||\n    isTrustedPublisher(workflowPlatform) ||\n    isTrustedPublisher(repository)\n\n  return {\n    commitSha,\n    gitRef,\n    level: trusted ? 'trusted' : 'attested',\n    repository,\n    workflowRef,\n    workflowUrl,\n    workflowPlatform,\n    workflowRunId,\n  }\n}\n\n/**\n * Fetch package provenance information from npm registry.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function fetchPackageProvenance(\n  pkgName: string,\n  pkgVersion: string,\n  options?: ProvenanceOptions,\n): Promise<unknown> {\n  const { signal, timeout = 10_000 } = {\n    __proto__: null,\n    ...options,\n  } as ProvenanceOptions\n\n  if (signal?.aborted) {\n    return undefined\n  }\n\n  // Create composite signal combining external signal with timeout\n  const timeoutSignal = createTimeoutSignal(timeout)\n  const compositeSignal = createCompositeAbortSignal(signal, timeoutSignal)\n  const fetcher = getFetcher()\n\n  try {\n    const response = await fetcher(\n      // The npm registry attestations API endpoint.\n      `${NPM_REGISTRY_URL}/-/npm/v1/attestations/${encodeURIComponent(pkgName)}@${encodeURIComponent(pkgVersion)}`,\n      {\n        method: 'GET',\n        signal: compositeSignal,\n        headers: {\n          'User-Agent': 'socket-registry',\n        },\n      } as {\n        method: string\n        signal: AbortSignal\n        headers: Record<string, string>\n      },\n    )\n    if (response.ok) {\n      return getProvenanceDetails(await response.json())\n    }\n  } catch {}\n  return undefined\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/packages/specs.js

@@ -31,7 +31,7 @@ let _npmPackageArg;
 // @__NO_SIDE_EFFECTS__
 function getNpmPackageArg() {
   if (_npmPackageArg === void 0) {
-    _npmPackageArg = require("../../external/npm-package-arg");
+    _npmPackageArg = require("../external/npm-package-arg");
   }
   return _npmPackageArg;
 }

package/dist/packages/specs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/packages/specs.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Package spec parsing and GitHub URL utilities.\n */\n\nimport { isObjectObject } from '../objects'\nimport { isNonEmptyString } from '../strings'\n\nlet _npmPackageArg: typeof import('npm-package-arg') | undefined\n/**\n * Get the npm-package-arg module.\n */\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\n/**\n * Extract user and project from GitHub repository URL.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getRepoUrlDetails(repoUrl: string = ''): {\n  user: string\n  project: string\n} {\n  const userAndRepo = repoUrl.replace(/^.+github.com\\//, '').split('/')\n  const user = userAndRepo[0] || ''\n  const project =\n    userAndRepo.length > 1 ? userAndRepo[1]?.slice(0, -'.git'.length) || '' : ''\n  return { user, project }\n}\n\n/**\n * Generate GitHub API URL for a tag reference.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function gitHubTagRefUrl(\n  user: string,\n  project: string,\n  tag: string,\n): string {\n  return `https://api.github.com/repos/${user}/${project}/git/ref/tags/${tag}`\n}\n\n/**\n * Generate GitHub tarball download URL for a commit SHA.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function gitHubTgzUrl(\n  user: string,\n  project: string,\n  sha: string,\n): string {\n  return `https://github.com/${user}/${project}/archive/${sha}.tar.gz`\n}\n\n/**\n * Check if a package specifier is a GitHub tarball URL.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isGitHubTgzSpec(spec: unknown, where?: string): boolean {\n  let parsedSpec: unknown\n  if (isObjectObject(spec)) {\n    parsedSpec = spec\n  } else {\n    const npmPackageArg = getNpmPackageArg()\n    parsedSpec = npmPackageArg(spec as string, where)\n  }\n  const typedSpec = parsedSpec as { type?: string; saveSpec?: string }\n  return (\n    typedSpec.type === 'remote' && !!typedSpec.saveSpec?.endsWith('.tar.gz')\n  )\n}\n\n/**\n * Check if a package specifier is a GitHub URL with committish.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isGitHubUrlSpec(spec: unknown, where?: string): boolean {\n  let parsedSpec: unknown\n  if (isObjectObject(spec)) {\n    parsedSpec = spec\n  } else {\n    const npmPackageArg = getNpmPackageArg()\n    parsedSpec = npmPackageArg(spec as string, where)\n  }\n  const typedSpec = parsedSpec as {\n    gitCommittish?: string\n    hosted?: { domain?: string }\n    type?: string\n  }\n  return (\n    typedSpec.type === 'git' &&\n    typedSpec.hosted?.domain === 'github.com' &&\n    isNonEmptyString(typedSpec.gitCommittish)\n  )\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,qBAA+B;AAC/B,qBAAiC;AAEjC,IAAI;AAAA;AAKJ,SAAS,mBAAmB;AAC1B,MAAI,mBAAmB,QAAW;AAChC,qBAA+B,QAAQ,gCAAgC;AAAA,EACzE;AACA,SAAO;AACT;AAAA;AAMO,SAAS,kBAAkB,UAAkB,IAGlD;AACA,QAAM,cAAc,QAAQ,QAAQ,mBAAmB,EAAE,EAAE,MAAM,GAAG;AACpE,QAAM,OAAO,YAAY,CAAC,KAAK;AAC/B,QAAM,UACJ,YAAY,SAAS,IAAI,YAAY,CAAC,GAAG,MAAM,GAAG,CAAC,OAAO,MAAM,KAAK,KAAK;AAC5E,SAAO,EAAE,MAAM,QAAQ;AACzB;AAAA;AAMO,SAAS,gBACd,MACA,SACA,KACQ;AACR,SAAO,gCAAgC,IAAI,IAAI,OAAO,iBAAiB,GAAG;AAC5E;AAAA;AAMO,SAAS,aACd,MACA,SACA,KACQ;AACR,SAAO,sBAAsB,IAAI,IAAI,OAAO,YAAY,GAAG;AAC7D;AAAA;AAMO,SAAS,gBAAgB,MAAe,OAAyB;AACtE,MAAI;AACJ,UAAI,+BAAe,IAAI,GAAG;AACxB,iBAAa;AAAA,EACf,OAAO;AACL,UAAM,gBAAgB,iCAAiB;AACvC,iBAAa,cAAc,MAAgB,KAAK;AAAA,EAClD;AACA,QAAM,YAAY;AAClB,SACE,UAAU,SAAS,YAAY,CAAC,CAAC,UAAU,UAAU,SAAS,SAAS;AAE3E;AAAA;AAMO,SAAS,gBAAgB,MAAe,OAAyB;AACtE,MAAI;AACJ,UAAI,+BAAe,IAAI,GAAG;AACxB,iBAAa;AAAA,EACf,OAAO;AACL,UAAM,gBAAgB,iCAAiB;AACvC,iBAAa,cAAc,MAAgB,KAAK;AAAA,EAClD;AACA,QAAM,YAAY;AAKlB,SACE,UAAU,SAAS,SACnB,UAAU,QAAQ,WAAW,oBAC7B,iCAAiB,UAAU,aAAa;AAE5C;",
+  "sourcesContent": ["/**\n * @fileoverview Package spec parsing and GitHub URL utilities.\n */\n\nimport { isObjectObject } from '../objects'\nimport { isNonEmptyString } from '../strings'\n\nlet _npmPackageArg: typeof import('npm-package-arg') | undefined\n/**\n * Get the npm-package-arg module.\n */\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\n/**\n * Extract user and project from GitHub repository URL.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getRepoUrlDetails(repoUrl: string = ''): {\n  user: string\n  project: string\n} {\n  const userAndRepo = repoUrl.replace(/^.+github.com\\//, '').split('/')\n  const user = userAndRepo[0] || ''\n  const project =\n    userAndRepo.length > 1 ? userAndRepo[1]?.slice(0, -'.git'.length) || '' : ''\n  return { user, project }\n}\n\n/**\n * Generate GitHub API URL for a tag reference.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function gitHubTagRefUrl(\n  user: string,\n  project: string,\n  tag: string,\n): string {\n  return `https://api.github.com/repos/${user}/${project}/git/ref/tags/${tag}`\n}\n\n/**\n * Generate GitHub tarball download URL for a commit SHA.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function gitHubTgzUrl(\n  user: string,\n  project: string,\n  sha: string,\n): string {\n  return `https://github.com/${user}/${project}/archive/${sha}.tar.gz`\n}\n\n/**\n * Check if a package specifier is a GitHub tarball URL.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isGitHubTgzSpec(spec: unknown, where?: string): boolean {\n  let parsedSpec: unknown\n  if (isObjectObject(spec)) {\n    parsedSpec = spec\n  } else {\n    const npmPackageArg = getNpmPackageArg()\n    parsedSpec = npmPackageArg(spec as string, where)\n  }\n  const typedSpec = parsedSpec as { type?: string; saveSpec?: string }\n  return (\n    typedSpec.type === 'remote' && !!typedSpec.saveSpec?.endsWith('.tar.gz')\n  )\n}\n\n/**\n * Check if a package specifier is a GitHub URL with committish.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isGitHubUrlSpec(spec: unknown, where?: string): boolean {\n  let parsedSpec: unknown\n  if (isObjectObject(spec)) {\n    parsedSpec = spec\n  } else {\n    const npmPackageArg = getNpmPackageArg()\n    parsedSpec = npmPackageArg(spec as string, where)\n  }\n  const typedSpec = parsedSpec as {\n    gitCommittish?: string\n    hosted?: { domain?: string }\n    type?: string\n  }\n  return (\n    typedSpec.type === 'git' &&\n    typedSpec.hosted?.domain === 'github.com' &&\n    isNonEmptyString(typedSpec.gitCommittish)\n  )\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,qBAA+B;AAC/B,qBAAiC;AAEjC,IAAI;AAAA;AAKJ,SAAS,mBAAmB;AAC1B,MAAI,mBAAmB,QAAW;AAChC,qBAA+B,QAAQ,6BAA6B;AAAA,EACtE;AACA,SAAO;AACT;AAAA;AAMO,SAAS,kBAAkB,UAAkB,IAGlD;AACA,QAAM,cAAc,QAAQ,QAAQ,mBAAmB,EAAE,EAAE,MAAM,GAAG;AACpE,QAAM,OAAO,YAAY,CAAC,KAAK;AAC/B,QAAM,UACJ,YAAY,SAAS,IAAI,YAAY,CAAC,GAAG,MAAM,GAAG,CAAC,OAAO,MAAM,KAAK,KAAK;AAC5E,SAAO,EAAE,MAAM,QAAQ;AACzB;AAAA;AAMO,SAAS,gBACd,MACA,SACA,KACQ;AACR,SAAO,gCAAgC,IAAI,IAAI,OAAO,iBAAiB,GAAG;AAC5E;AAAA;AAMO,SAAS,aACd,MACA,SACA,KACQ;AACR,SAAO,sBAAsB,IAAI,IAAI,OAAO,YAAY,GAAG;AAC7D;AAAA;AAMO,SAAS,gBAAgB,MAAe,OAAyB;AACtE,MAAI;AACJ,UAAI,+BAAe,IAAI,GAAG;AACxB,iBAAa;AAAA,EACf,OAAO;AACL,UAAM,gBAAgB,iCAAiB;AACvC,iBAAa,cAAc,MAAgB,KAAK;AAAA,EAClD;AACA,QAAM,YAAY;AAClB,SACE,UAAU,SAAS,YAAY,CAAC,CAAC,UAAU,UAAU,SAAS,SAAS;AAE3E;AAAA;AAMO,SAAS,gBAAgB,MAAe,OAAyB;AACtE,MAAI;AACJ,UAAI,+BAAe,IAAI,GAAG;AACxB,iBAAa;AAAA,EACf,OAAO;AACL,UAAM,gBAAgB,iCAAiB;AACvC,iBAAa,cAAc,MAAgB,KAAK;AAAA,EAClD;AACA,QAAM,YAAY;AAKlB,SACE,UAAU,SAAS,SACnB,UAAU,QAAQ,WAAW,oBAC7B,iCAAiB,UAAU,aAAa;AAE5C;",
   "names": []
 }

package/dist/packages/validation.js

@@ -27,7 +27,7 @@ let _validateNpmPackageName;
 // @__NO_SIDE_EFFECTS__
 function getValidateNpmPackageName() {
   if (_validateNpmPackageName === void 0) {
-    _validateNpmPackageName = require("../../external/validate-npm-package-name");
+    _validateNpmPackageName = require("../external/validate-npm-package-name");
   }
   return _validateNpmPackageName;
 }

package/dist/packages/validation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/packages/validation.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Package name validation utilities.\n */\n\nlet _validateNpmPackageName:\n  | typeof import('validate-npm-package-name')\n  | undefined\n/**\n * Get the validate-npm-package-name module.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getValidateNpmPackageName() {\n  if (_validateNpmPackageName === undefined) {\n    _validateNpmPackageName =\n      /*@__PURE__*/ require('../../external/validate-npm-package-name')\n  }\n  return _validateNpmPackageName as typeof import('validate-npm-package-name')\n}\n\n/**\n * Check if package name is a blessed Socket.dev package.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isBlessedPackageName(name: unknown): boolean {\n  return (\n    typeof name === 'string' &&\n    (name === 'sfw' ||\n      name === 'socket' ||\n      name.startsWith('@socketoverride/') ||\n      name.startsWith('@socketregistry/') ||\n      name.startsWith('@socketsecurity/'))\n  )\n}\n\n/**\n * Check if a type string represents a registry fetcher type.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isRegistryFetcherType(type: string): boolean {\n  // RegistryFetcher spec.type check based on:\n  // https://github.com/npm/pacote/blob/v19.0.0/lib/fetcher.js#L467-L488\n  return (\n    type === 'alias' || type === 'range' || type === 'tag' || type === 'version'\n  )\n}\n\n/**\n * Check if a package name is valid according to npm naming rules.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isValidPackageName(name: string): boolean {\n  const validateNpmPackageName = getValidateNpmPackageName()\n  return validateNpmPackageName(name).validForOldPackages\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,IAAI;AAAA;AAOJ,SAAS,4BAA4B;AACnC,MAAI,4BAA4B,QAAW;AACzC,8BACgB,QAAQ,0CAA0C;AAAA,EACpE;AACA,SAAO;AACT;AAAA;AAMO,SAAS,qBAAqB,MAAwB;AAC3D,SACE,OAAO,SAAS,aACf,SAAS,SACR,SAAS,YACT,KAAK,WAAW,kBAAkB,KAClC,KAAK,WAAW,kBAAkB,KAClC,KAAK,WAAW,kBAAkB;AAExC;AAAA;AAMO,SAAS,sBAAsB,MAAuB;AAG3D,SACE,SAAS,WAAW,SAAS,WAAW,SAAS,SAAS,SAAS;AAEvE;AAAA;AAMO,SAAS,mBAAmB,MAAuB;AACxD,QAAM,yBAAyB,0CAA0B;AACzD,SAAO,uBAAuB,IAAI,EAAE;AACtC;",
+  "sourcesContent": ["/**\n * @fileoverview Package name validation utilities.\n */\n\nlet _validateNpmPackageName:\n  | typeof import('validate-npm-package-name')\n  | undefined\n/**\n * Get the validate-npm-package-name module.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getValidateNpmPackageName() {\n  if (_validateNpmPackageName === undefined) {\n    _validateNpmPackageName =\n      /*@__PURE__*/ require('../external/validate-npm-package-name')\n  }\n  return _validateNpmPackageName as typeof import('validate-npm-package-name')\n}\n\n/**\n * Check if package name is a blessed Socket.dev package.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isBlessedPackageName(name: unknown): boolean {\n  return (\n    typeof name === 'string' &&\n    (name === 'sfw' ||\n      name === 'socket' ||\n      name.startsWith('@socketoverride/') ||\n      name.startsWith('@socketregistry/') ||\n      name.startsWith('@socketsecurity/'))\n  )\n}\n\n/**\n * Check if a type string represents a registry fetcher type.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isRegistryFetcherType(type: string): boolean {\n  // RegistryFetcher spec.type check based on:\n  // https://github.com/npm/pacote/blob/v19.0.0/lib/fetcher.js#L467-L488\n  return (\n    type === 'alias' || type === 'range' || type === 'tag' || type === 'version'\n  )\n}\n\n/**\n * Check if a package name is valid according to npm naming rules.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isValidPackageName(name: string): boolean {\n  const validateNpmPackageName = getValidateNpmPackageName()\n  return validateNpmPackageName(name).validForOldPackages\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,IAAI;AAAA;AAOJ,SAAS,4BAA4B;AACnC,MAAI,4BAA4B,QAAW;AACzC,8BACgB,QAAQ,uCAAuC;AAAA,EACjE;AACA,SAAO;AACT;AAAA;AAMO,SAAS,qBAAqB,MAAwB;AAC3D,SACE,OAAO,SAAS,aACf,SAAS,SACR,SAAS,YACT,KAAK,WAAW,kBAAkB,KAClC,KAAK,WAAW,kBAAkB,KAClC,KAAK,WAAW,kBAAkB;AAExC;AAAA;AAMO,SAAS,sBAAsB,MAAuB;AAG3D,SACE,SAAS,WAAW,SAAS,WAAW,SAAS,SAAS,SAAS;AAEvE;AAAA;AAMO,SAAS,mBAAmB,MAAuB;AACxD,QAAM,yBAAyB,0CAA0B;AACzD,SAAO,uBAAuB,IAAI,EAAE;AACtC;",
   "names": []
 }

package/dist/spawn.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/spawn.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Child process spawning utilities with cross-platform support.\n * Provides enhanced spawn functionality with stdio handling and error management.\n *\n * SECURITY: Array-Based Arguments Prevent Command Injection\n *\n * This module uses array-based arguments for all command execution, which is the\n * PRIMARY DEFENSE against command injection attacks. When you pass arguments as\n * an array to spawn():\n *\n *   spawn('npx', ['sfw', tool, ...args], { shell: true })\n *\n * Node.js handles escaping automatically. Each argument is passed directly to the\n * OS without shell interpretation. Shell metacharacters like ; | & $ ( ) ` are\n * treated as LITERAL STRINGS, not as commands. This approach is secure even when\n * shell: true is used on Windows for .cmd/.bat file resolution.\n *\n * UNSAFE ALTERNATIVE (not used in this codebase):\n *   spawn(`npx sfw ${tool} ${args.join(' ')}`, { shell: true })  // \u2716 VULNERABLE\n *\n * String concatenation allows injection. For example, if tool = \"foo; rm -rf /\",\n * the shell would execute both commands. Array-based arguments prevent this.\n *\n * References:\n * - https://nodejs.org/api/child_process.html#child_processspawncommand-args-options\n * - https://cheatsheetseries.owasp.org/cheatsheets/Nodejs_Security_Cheat_Sheet.html\n */\n\nimport { getAbortSignal, getSpinner } from '#constants/process'\n\nimport { isArray } from './arrays'\n\nconst abortSignal = getAbortSignal()\nconst spinner = getSpinner()\n\nimport { getOwn, hasOwn } from './objects'\nimport { stripAnsi } from './strings'\n\n// Define BufferEncoding type for TypeScript compatibility.\ntype BufferEncoding = globalThis.BufferEncoding\n\nconst windowsScriptExtRegExp = /\\.(?:cmd|bat|ps1)$/i\n\nlet _child_process: typeof import('node:child_process') | undefined\n/**\n * Lazily load the child_process module.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getChildProcess() {\n  if (_child_process === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _child_process = /*@__PURE__*/ require('node:child_process')\n  }\n  return _child_process as typeof import('node:child_process')\n}\n\n// Type for promise-spawn options.\nexport type PromiseSpawnOptions = {\n  cwd?: string | undefined\n  stdioString?: boolean | undefined\n  stdio?: StdioType | undefined\n  env?: NodeJS.ProcessEnv | undefined\n  shell?: boolean | string | undefined\n  signal?: AbortSignal | undefined\n  timeout?: number | undefined\n  uid?: number | undefined\n  gid?: number | undefined\n}\n\n// Type for promise-spawn result.\nexport type PromiseSpawnResult = Promise<{\n  cmd: string\n  args: string[] | readonly string[]\n  code: number\n  signal: NodeJS.Signals | null\n  stdout: string | Buffer\n  stderr: string | Buffer\n}> & {\n  process: ChildProcessType\n  stdin: WritableStreamType | null\n}\n\nlet _npmCliPromiseSpawn:\n  | ((\n      cmd: string,\n      args: string[],\n      options?: PromiseSpawnOptions | undefined,\n      extra?: SpawnExtra | undefined,\n    ) => PromiseSpawnResult)\n  | undefined\n/**\n * Lazily load the promise-spawn module for async process spawning.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getNpmcliPromiseSpawn() {\n  if (_npmCliPromiseSpawn === undefined) {\n    _npmCliPromiseSpawn = /*@__PURE__*/ require('../external/@npmcli/promise-spawn')\n  }\n  return _npmCliPromiseSpawn as unknown as typeof import('@npmcli/promise-spawn')\n}\n\nlet _path: typeof import('node:path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\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('node:path')\n}\n\n/**\n * Check if a value is a spawn error.\n */\nexport type SpawnError = {\n  args: string[]\n  cmd: string\n  code: number\n  name: string\n  message: string\n  signal: NodeJS.Signals | null\n  stack: string\n  stderr: string | Buffer\n  stdout: string | Buffer\n}\n\nexport type SpawnErrorWithOutputString = SpawnError & {\n  stdout: string\n  stderr: string\n}\n\nexport type SpawnErrorWithOutputBuffer = SpawnError & {\n  stdout: Buffer\n  stderr: Buffer\n}\n\nexport type SpawnExtra = Record<string, unknown>\n\nexport type IOType = 'pipe' | 'ignore' | 'inherit' | 'overlapped'\nexport type StdioType = IOType | 'ipc' | Array<IOType | 'ipc'>\n\nexport interface SpawnSyncReturns<T> {\n  pid: number\n  output: Array<T | null>\n  stdout: T\n  stderr: T\n  status: number | null\n  signal: NodeJS.Signals | null\n  error?: Error | undefined\n}\n\n/**\n * Check if a value is a spawn error with expected properties.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isSpawnError(value: unknown): value is SpawnError {\n  if (value === null || typeof value !== 'object') {\n    return false\n  }\n  // Check for spawn-specific error properties.\n  const err = value as Record<string, unknown>\n  return (\n    (hasOwn(err, 'code') && typeof err['code'] !== 'undefined') ||\n    (hasOwn(err, 'errno') && typeof err['errno'] !== 'undefined') ||\n    (hasOwn(err, 'syscall') && typeof err['syscall'] === 'string')\n  )\n}\n\n/**\n * Check if stdio configuration matches a specific type.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isStdioType(\n  stdio: string | string[],\n  type?: StdioType | undefined,\n): boolean {\n  // If called with one argument, check if it's a valid stdio type.\n  // biome-ignore lint/complexity/noArguments: Function overload detection for single vs two-arg calls.\n  if (arguments.length === 1) {\n    const validTypes = ['pipe', 'ignore', 'inherit', 'overlapped']\n    return typeof stdio === 'string' && validTypes.includes(stdio)\n  }\n  // Original two-argument behavior.\n  return (\n    stdio === type ||\n    ((stdio === null || stdio === undefined) && type === 'pipe') ||\n    (isArray(stdio) &&\n      stdio.length > 2 &&\n      stdio[0] === type &&\n      stdio[1] === type &&\n      stdio[2] === type)\n  )\n}\n\n/**\n * Strip ANSI escape codes from spawn result stdout and stderr.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction stripAnsiFromSpawnResult(result: unknown): unknown {\n  const res = result as {\n    stdout?: string | Buffer\n    stderr?: string | Buffer\n  }\n  const { stderr, stdout } = res\n  if (typeof stdout === 'string') {\n    res.stdout = stripAnsi(stdout)\n  }\n  if (typeof stderr === 'string') {\n    res.stderr = stripAnsi(stderr)\n  }\n  return res\n}\n\n/*@__NO_SIDE_EFFECTS__*/\n// Duplicated from Node.js child_process.SpawnOptions\n// These are the options passed to child_process.spawn()\ninterface NodeSpawnOptions {\n  cwd?: string | URL | undefined\n  env?: NodeJS.ProcessEnv | undefined\n  argv0?: string | undefined\n  // biome-ignore lint/suspicious/noExplicitAny: Stdio can be complex union of types from Node.js.\n  stdio?: any\n  detached?: boolean | undefined\n  uid?: number | undefined\n  gid?: number | undefined\n  serialization?: 'json' | 'advanced' | undefined\n  shell?: boolean | string | undefined\n  windowsVerbatimArguments?: boolean | undefined\n  windowsHide?: boolean | undefined\n  signal?: AbortSignal | undefined\n  timeout?: number | undefined\n  killSignal?: NodeJS.Signals | number | undefined\n}\n\n// Duplicated from Node.js child_process.ChildProcess\n// This represents a spawned child process\ninterface ChildProcessType {\n  stdin: NodeJS.WritableStream | null\n  stdout: NodeJS.ReadableStream | null\n  stderr: NodeJS.ReadableStream | null\n  // biome-ignore lint/suspicious/noExplicitAny: IPC channel type from Node.js.\n  readonly channel?: any\n  readonly stdio: [\n    NodeJS.WritableStream | null,\n    NodeJS.ReadableStream | null,\n    NodeJS.ReadableStream | null,\n    NodeJS.ReadableStream | NodeJS.WritableStream | null | undefined,\n    NodeJS.ReadableStream | NodeJS.WritableStream | null | undefined,\n  ]\n  readonly killed: boolean\n  readonly pid?: number | undefined\n  readonly connected: boolean\n  readonly exitCode: number | null\n  readonly signalCode: NodeJS.Signals | null\n  readonly spawnargs: string[]\n  readonly spawnfile: string\n  kill(signal?: NodeJS.Signals | number): boolean\n  // biome-ignore lint/suspicious/noExplicitAny: IPC message type from Node.js.\n  send(message: any, callback?: (error: Error | null) => void): boolean\n  send(\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message and handle types from Node.js.\n    message: any,\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message and handle types from Node.js.\n    sendHandle?: any | undefined,\n    callback?: (error: Error | null) => void,\n  ): boolean\n  send(\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message, handle, and options types from Node.js.\n    message: any,\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message, handle, and options types from Node.js.\n    sendHandle?: any | undefined,\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message, handle, and options types from Node.js.\n    options?: any | undefined,\n    callback?: (error: Error | null) => void,\n  ): boolean\n  disconnect(): void\n  unref(): void\n  ref(): void\n}\n\n// Duplicated from Node.js stream.Writable\ninterface WritableStreamType {\n  writable: boolean\n  writableEnded: boolean\n  writableFinished: boolean\n  writableHighWaterMark: number\n  writableLength: number\n  writableObjectMode: boolean\n  writableCorked: number\n  destroyed: boolean\n  write(\n    // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n    chunk: any,\n    encoding?: BufferEncoding | undefined,\n    callback?: (error?: Error | null) => void,\n  ): boolean\n  // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n  write(chunk: any, callback?: (error?: Error | null) => void): boolean\n  end(cb?: () => void): this\n  // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n  end(chunk: any, cb?: () => void): this\n  // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n  end(chunk: any, encoding?: BufferEncoding | undefined, cb?: () => void): this\n  cork(): void\n  uncork(): void\n  destroy(error?: Error | undefined): this\n}\n\n/**\n * Spawn a child process with enhanced error handling and output capture.\n */\nexport type SpawnOptions = import('./objects').Remap<\n  NodeSpawnOptions & {\n    spinner?: import('./spinner').Spinner | undefined\n    stdioString?: boolean\n    stripAnsi?: boolean\n  }\n>\nexport type SpawnResult = PromiseSpawnResult\nexport type SpawnStdioResult = {\n  cmd: string\n  args: string[] | readonly string[]\n  code: number\n  signal: NodeJS.Signals | null\n  stdout: string | Buffer\n  stderr: string | Buffer\n}\n\n/**\n * Spawn a child process and return a promise that resolves when it completes.\n *\n * SECURITY: This function uses array-based arguments which prevent command injection.\n * Arguments in the `args` array are passed directly to the OS without shell\n * interpretation. Shell metacharacters (;|&$()`) are treated as literal strings,\n * not as commands or operators. This is the PRIMARY SECURITY DEFENSE.\n *\n * Even when shell: true is used (on Windows for .cmd/.bat execution), the array-based\n * approach remains secure because Node.js properly escapes each argument before passing\n * to the shell.\n *\n * @param cmd - Command to execute (not user-controlled)\n * @param args - Array of arguments (safe even with user input due to array-based passing)\n * @param options - Spawn options\n * @param extra - Extra options for promise-spawn\n *\n * @example\n * // \u2714 DO THIS - Array-based arguments\n * spawn('git', ['commit', '-m', userMessage])\n * // Each argument is properly escaped, even if userMessage = \"foo; rm -rf /\"\n *\n * @example\n * // \u2716 NEVER DO THIS - String concatenation\n * spawn(`git commit -m \"${userMessage}\"`, { shell: true })\n * // Vulnerable to injection if userMessage = '\"; rm -rf / #'\n */\nexport function spawn(\n  cmd: string,\n  args?: string[] | readonly string[],\n  options?: SpawnOptions | undefined,\n  extra?: SpawnExtra | undefined,\n): SpawnResult {\n  // Windows cmd.exe command resolution for .cmd/.bat/.ps1 files:\n  //\n  // When shell: true is used on Windows with script files (.cmd, .bat, .ps1),\n  // cmd.exe can have issues executing full paths. The solution is to use just\n  // the command basename without extension and let cmd.exe find it via PATH.\n  //\n  // How cmd.exe resolves commands:\n  // 1. Searches current directory first\n  // 2. Then searches each directory in PATH environment variable\n  // 3. For each directory, tries extensions from PATHEXT (.COM, .EXE, .BAT, .CMD, etc.)\n  // 4. Executes the first match found\n  //\n  // Example: Given 'C:\\pnpm\\pnpm.cmd' with shell: true\n  // 1. Extract basename without extension: 'pnpm'\n  // 2. cmd.exe searches PATH directories for 'pnpm'\n  // 3. PATHEXT causes it to try 'pnpm.com', 'pnpm.exe', 'pnpm.bat', 'pnpm.cmd', etc.\n  // 4. Finds and executes 'C:\\pnpm\\pnpm.cmd'\n  //\n  // This approach is consistent with how other tools handle Windows execution:\n  // - npm's promise-spawn: uses which.sync() to find commands in PATH\n  // - cross-spawn: spawns cmd.exe with escaped arguments\n  // - execa: uses cross-spawn under the hood for Windows support\n  //\n  // See: https://github.com/nodejs/node/issues/3675\n  const shell = getOwn(options, 'shell')\n  // Inline WIN32 constant for coverage mode compatibility\n  const WIN32 = process.platform === 'win32'\n  let actualCmd = cmd\n  if (WIN32 && shell && windowsScriptExtRegExp.test(actualCmd)) {\n    const path = getPath()\n    // Extract just the command name without path and extension.\n    actualCmd = path.basename(actualCmd, path.extname(actualCmd))\n  }\n  const {\n    spinner: optionsSpinner = spinner,\n    stripAnsi: shouldStripAnsi = true,\n    ...spawnOptions\n  } = { __proto__: null, ...options } as SpawnOptions\n  const spinnerInstance = optionsSpinner\n  const { env, stdio, stdioString = true } = spawnOptions\n  // The stdio option can be a string or an array.\n  // https://nodejs.org/api/child_process.html#optionsstdio\n  const wasSpinning = !!spinnerInstance?.isSpinning\n  const shouldStopSpinner =\n    wasSpinning && !isStdioType(stdio, 'ignore') && !isStdioType(stdio, 'pipe')\n  const shouldRestartSpinner = shouldStopSpinner\n  if (shouldStopSpinner) {\n    spinnerInstance.stop()\n  }\n  const npmCliPromiseSpawn = getNpmcliPromiseSpawn()\n  // Use __proto__: null to prevent prototype pollution when passing to\n  // third-party code, Node.js built-ins, or JavaScript built-in methods.\n  // https://github.com/npm/promise-spawn\n  // https://github.com/nodejs/node/blob/v24.0.1/lib/child_process.js#L674-L678\n  const promiseSpawnOpts = {\n    __proto__: null,\n    cwd: typeof spawnOptions.cwd === 'string' ? spawnOptions.cwd : undefined,\n    env: {\n      __proto__: null,\n      ...process.env,\n      ...env,\n    } as unknown as NodeJS.ProcessEnv,\n    signal: abortSignal,\n    stdio: spawnOptions.stdio,\n    stdioString,\n    shell: spawnOptions.shell,\n    timeout: spawnOptions.timeout,\n    uid: spawnOptions.uid,\n    gid: spawnOptions.gid,\n  } as unknown as PromiseSpawnOptions\n  const spawnPromise = npmCliPromiseSpawn(\n    actualCmd,\n    args ? [...args] : [],\n    promiseSpawnOpts as Parameters<typeof npmCliPromiseSpawn>[2],\n    extra,\n  )\n  const oldSpawnPromise = spawnPromise\n  let newSpawnPromise: PromiseSpawnResult\n  if (shouldStripAnsi && stdioString) {\n    newSpawnPromise = spawnPromise\n      .then(result => {\n        const strippedResult = stripAnsiFromSpawnResult(result)\n        // Add exitCode as an alias for code.\n        if ('code' in (strippedResult as { code?: number })) {\n          ;(strippedResult as { code: number; exitCode: number }).exitCode = (\n            strippedResult as { code: number }\n          ).code\n        }\n        return strippedResult\n      })\n      .catch(error => {\n        throw stripAnsiFromSpawnResult(error)\n      }) as PromiseSpawnResult\n  } else {\n    newSpawnPromise = spawnPromise.then(result => {\n      // Add exitCode as an alias for code.\n      if ('code' in result) {\n        const res = result as typeof result & { exitCode: number }\n        res.exitCode = result.code\n        return res\n      }\n      return result\n    }) as PromiseSpawnResult\n  }\n  if (shouldRestartSpinner) {\n    newSpawnPromise = newSpawnPromise.finally(() => {\n      spinnerInstance.start()\n    }) as PromiseSpawnResult\n  }\n  // Copy process and stdin properties from original promise\n  ;(newSpawnPromise as unknown as PromiseSpawnResult).process =\n    oldSpawnPromise.process\n  ;(newSpawnPromise as unknown as PromiseSpawnResult).stdin = (\n    oldSpawnPromise as unknown as PromiseSpawnResult\n  ).stdin\n  return newSpawnPromise as SpawnResult\n}\n\n/*@__NO_SIDE_EFFECTS__*/\n/**\n * Synchronously spawn a child process.\n */\nexport type SpawnSyncOptions = Omit<SpawnOptions, 'spinner'>\nexport function spawnSync(\n  cmd: string,\n  args?: string[] | readonly string[],\n  options?: SpawnSyncOptions | undefined,\n): SpawnSyncReturns<string | Buffer> {\n  // Windows cmd.exe command resolution for .cmd/.bat/.ps1 files:\n  // See spawn() function above for detailed explanation of this approach.\n  const shell = getOwn(options, 'shell')\n  // Inline WIN32 constant for coverage mode compatibility\n  const WIN32 = process.platform === 'win32'\n  let actualCmd = cmd\n  if (WIN32 && shell && windowsScriptExtRegExp.test(actualCmd)) {\n    const path = getPath()\n    // Extract just the command name without path and extension.\n    actualCmd = path.basename(actualCmd, path.extname(actualCmd))\n  }\n  const { stripAnsi: shouldStripAnsi = true, ...rawSpawnOptions } = {\n    __proto__: null,\n    ...options,\n  } as SpawnSyncOptions\n  const { stdioString: rawStdioString = true } = rawSpawnOptions\n  const rawEncoding = rawStdioString ? 'utf8' : 'buffer'\n  const spawnOptions = {\n    encoding: rawEncoding,\n    ...rawSpawnOptions,\n  } as NodeSpawnOptions & { encoding: BufferEncoding | 'buffer' }\n  const stdioString = spawnOptions.encoding !== 'buffer'\n  const result = getChildProcess().spawnSync(actualCmd, args, spawnOptions)\n  if (stdioString) {\n    const { stderr, stdout } = result\n    if (stdout) {\n      result.stdout = stdout.toString().trim()\n    }\n    if (stderr) {\n      result.stderr = stderr.toString().trim()\n    }\n  }\n  return (\n    shouldStripAnsi && stdioString ? stripAnsiFromSpawnResult(result) : result\n  ) as SpawnSyncReturns<string | Buffer>\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @fileoverview Child process spawning utilities with cross-platform support.\n * Provides enhanced spawn functionality with stdio handling and error management.\n *\n * SECURITY: Array-Based Arguments Prevent Command Injection\n *\n * This module uses array-based arguments for all command execution, which is the\n * PRIMARY DEFENSE against command injection attacks. When you pass arguments as\n * an array to spawn():\n *\n *   spawn('npx', ['sfw', tool, ...args], { shell: true })\n *\n * Node.js handles escaping automatically. Each argument is passed directly to the\n * OS without shell interpretation. Shell metacharacters like ; | & $ ( ) ` are\n * treated as LITERAL STRINGS, not as commands. This approach is secure even when\n * shell: true is used on Windows for .cmd/.bat file resolution.\n *\n * UNSAFE ALTERNATIVE (not used in this codebase):\n *   spawn(`npx sfw ${tool} ${args.join(' ')}`, { shell: true })  // \u2716 VULNERABLE\n *\n * String concatenation allows injection. For example, if tool = \"foo; rm -rf /\",\n * the shell would execute both commands. Array-based arguments prevent this.\n *\n * References:\n * - https://nodejs.org/api/child_process.html#child_processspawncommand-args-options\n * - https://cheatsheetseries.owasp.org/cheatsheets/Nodejs_Security_Cheat_Sheet.html\n */\n\nimport { getAbortSignal, getSpinner } from '#constants/process'\n\nimport { isArray } from './arrays'\n\nconst abortSignal = getAbortSignal()\nconst spinner = getSpinner()\n\nimport { getOwn, hasOwn } from './objects'\nimport { stripAnsi } from './strings'\n\n// Define BufferEncoding type for TypeScript compatibility.\ntype BufferEncoding = globalThis.BufferEncoding\n\nconst windowsScriptExtRegExp = /\\.(?:cmd|bat|ps1)$/i\n\nlet _child_process: typeof import('node:child_process') | undefined\n/**\n * Lazily load the child_process module.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getChildProcess() {\n  if (_child_process === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _child_process = /*@__PURE__*/ require('node:child_process')\n  }\n  return _child_process as typeof import('node:child_process')\n}\n\n// Type for promise-spawn options.\nexport type PromiseSpawnOptions = {\n  cwd?: string | undefined\n  stdioString?: boolean | undefined\n  stdio?: StdioType | undefined\n  env?: NodeJS.ProcessEnv | undefined\n  shell?: boolean | string | undefined\n  signal?: AbortSignal | undefined\n  timeout?: number | undefined\n  uid?: number | undefined\n  gid?: number | undefined\n}\n\n// Type for promise-spawn result.\nexport type PromiseSpawnResult = Promise<{\n  cmd: string\n  args: string[] | readonly string[]\n  code: number\n  signal: NodeJS.Signals | null\n  stdout: string | Buffer\n  stderr: string | Buffer\n}> & {\n  process: ChildProcessType\n  stdin: WritableStreamType | null\n}\n\nlet _npmCliPromiseSpawn:\n  | ((\n      cmd: string,\n      args: string[],\n      options?: PromiseSpawnOptions | undefined,\n      extra?: SpawnExtra | undefined,\n    ) => PromiseSpawnResult)\n  | undefined\n/**\n * Lazily load the promise-spawn module for async process spawning.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getNpmcliPromiseSpawn() {\n  if (_npmCliPromiseSpawn === undefined) {\n    _npmCliPromiseSpawn = /*@__PURE__*/ require('./external/@npmcli/promise-spawn')\n  }\n  return _npmCliPromiseSpawn as unknown as typeof import('@npmcli/promise-spawn')\n}\n\nlet _path: typeof import('node:path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\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('node:path')\n}\n\n/**\n * Check if a value is a spawn error.\n */\nexport type SpawnError = {\n  args: string[]\n  cmd: string\n  code: number\n  name: string\n  message: string\n  signal: NodeJS.Signals | null\n  stack: string\n  stderr: string | Buffer\n  stdout: string | Buffer\n}\n\nexport type SpawnErrorWithOutputString = SpawnError & {\n  stdout: string\n  stderr: string\n}\n\nexport type SpawnErrorWithOutputBuffer = SpawnError & {\n  stdout: Buffer\n  stderr: Buffer\n}\n\nexport type SpawnExtra = Record<string, unknown>\n\nexport type IOType = 'pipe' | 'ignore' | 'inherit' | 'overlapped'\nexport type StdioType = IOType | 'ipc' | Array<IOType | 'ipc'>\n\nexport interface SpawnSyncReturns<T> {\n  pid: number\n  output: Array<T | null>\n  stdout: T\n  stderr: T\n  status: number | null\n  signal: NodeJS.Signals | null\n  error?: Error | undefined\n}\n\n/**\n * Check if a value is a spawn error with expected properties.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isSpawnError(value: unknown): value is SpawnError {\n  if (value === null || typeof value !== 'object') {\n    return false\n  }\n  // Check for spawn-specific error properties.\n  const err = value as Record<string, unknown>\n  return (\n    (hasOwn(err, 'code') && typeof err['code'] !== 'undefined') ||\n    (hasOwn(err, 'errno') && typeof err['errno'] !== 'undefined') ||\n    (hasOwn(err, 'syscall') && typeof err['syscall'] === 'string')\n  )\n}\n\n/**\n * Check if stdio configuration matches a specific type.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isStdioType(\n  stdio: string | string[],\n  type?: StdioType | undefined,\n): boolean {\n  // If called with one argument, check if it's a valid stdio type.\n  // biome-ignore lint/complexity/noArguments: Function overload detection for single vs two-arg calls.\n  if (arguments.length === 1) {\n    const validTypes = ['pipe', 'ignore', 'inherit', 'overlapped']\n    return typeof stdio === 'string' && validTypes.includes(stdio)\n  }\n  // Original two-argument behavior.\n  return (\n    stdio === type ||\n    ((stdio === null || stdio === undefined) && type === 'pipe') ||\n    (isArray(stdio) &&\n      stdio.length > 2 &&\n      stdio[0] === type &&\n      stdio[1] === type &&\n      stdio[2] === type)\n  )\n}\n\n/**\n * Strip ANSI escape codes from spawn result stdout and stderr.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction stripAnsiFromSpawnResult(result: unknown): unknown {\n  const res = result as {\n    stdout?: string | Buffer\n    stderr?: string | Buffer\n  }\n  const { stderr, stdout } = res\n  if (typeof stdout === 'string') {\n    res.stdout = stripAnsi(stdout)\n  }\n  if (typeof stderr === 'string') {\n    res.stderr = stripAnsi(stderr)\n  }\n  return res\n}\n\n/*@__NO_SIDE_EFFECTS__*/\n// Duplicated from Node.js child_process.SpawnOptions\n// These are the options passed to child_process.spawn()\ninterface NodeSpawnOptions {\n  cwd?: string | URL | undefined\n  env?: NodeJS.ProcessEnv | undefined\n  argv0?: string | undefined\n  // biome-ignore lint/suspicious/noExplicitAny: Stdio can be complex union of types from Node.js.\n  stdio?: any\n  detached?: boolean | undefined\n  uid?: number | undefined\n  gid?: number | undefined\n  serialization?: 'json' | 'advanced' | undefined\n  shell?: boolean | string | undefined\n  windowsVerbatimArguments?: boolean | undefined\n  windowsHide?: boolean | undefined\n  signal?: AbortSignal | undefined\n  timeout?: number | undefined\n  killSignal?: NodeJS.Signals | number | undefined\n}\n\n// Duplicated from Node.js child_process.ChildProcess\n// This represents a spawned child process\ninterface ChildProcessType {\n  stdin: NodeJS.WritableStream | null\n  stdout: NodeJS.ReadableStream | null\n  stderr: NodeJS.ReadableStream | null\n  // biome-ignore lint/suspicious/noExplicitAny: IPC channel type from Node.js.\n  readonly channel?: any\n  readonly stdio: [\n    NodeJS.WritableStream | null,\n    NodeJS.ReadableStream | null,\n    NodeJS.ReadableStream | null,\n    NodeJS.ReadableStream | NodeJS.WritableStream | null | undefined,\n    NodeJS.ReadableStream | NodeJS.WritableStream | null | undefined,\n  ]\n  readonly killed: boolean\n  readonly pid?: number | undefined\n  readonly connected: boolean\n  readonly exitCode: number | null\n  readonly signalCode: NodeJS.Signals | null\n  readonly spawnargs: string[]\n  readonly spawnfile: string\n  kill(signal?: NodeJS.Signals | number): boolean\n  // biome-ignore lint/suspicious/noExplicitAny: IPC message type from Node.js.\n  send(message: any, callback?: (error: Error | null) => void): boolean\n  send(\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message and handle types from Node.js.\n    message: any,\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message and handle types from Node.js.\n    sendHandle?: any | undefined,\n    callback?: (error: Error | null) => void,\n  ): boolean\n  send(\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message, handle, and options types from Node.js.\n    message: any,\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message, handle, and options types from Node.js.\n    sendHandle?: any | undefined,\n    // biome-ignore lint/suspicious/noExplicitAny: IPC message, handle, and options types from Node.js.\n    options?: any | undefined,\n    callback?: (error: Error | null) => void,\n  ): boolean\n  disconnect(): void\n  unref(): void\n  ref(): void\n}\n\n// Duplicated from Node.js stream.Writable\ninterface WritableStreamType {\n  writable: boolean\n  writableEnded: boolean\n  writableFinished: boolean\n  writableHighWaterMark: number\n  writableLength: number\n  writableObjectMode: boolean\n  writableCorked: number\n  destroyed: boolean\n  write(\n    // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n    chunk: any,\n    encoding?: BufferEncoding | undefined,\n    callback?: (error?: Error | null) => void,\n  ): boolean\n  // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n  write(chunk: any, callback?: (error?: Error | null) => void): boolean\n  end(cb?: () => void): this\n  // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n  end(chunk: any, cb?: () => void): this\n  // biome-ignore lint/suspicious/noExplicitAny: Stream chunk can be any type.\n  end(chunk: any, encoding?: BufferEncoding | undefined, cb?: () => void): this\n  cork(): void\n  uncork(): void\n  destroy(error?: Error | undefined): this\n}\n\n/**\n * Spawn a child process with enhanced error handling and output capture.\n */\nexport type SpawnOptions = import('./objects').Remap<\n  NodeSpawnOptions & {\n    spinner?: import('./spinner').Spinner | undefined\n    stdioString?: boolean\n    stripAnsi?: boolean\n  }\n>\nexport type SpawnResult = PromiseSpawnResult\nexport type SpawnStdioResult = {\n  cmd: string\n  args: string[] | readonly string[]\n  code: number\n  signal: NodeJS.Signals | null\n  stdout: string | Buffer\n  stderr: string | Buffer\n}\n\n/**\n * Spawn a child process and return a promise that resolves when it completes.\n *\n * SECURITY: This function uses array-based arguments which prevent command injection.\n * Arguments in the `args` array are passed directly to the OS without shell\n * interpretation. Shell metacharacters (;|&$()`) are treated as literal strings,\n * not as commands or operators. This is the PRIMARY SECURITY DEFENSE.\n *\n * Even when shell: true is used (on Windows for .cmd/.bat execution), the array-based\n * approach remains secure because Node.js properly escapes each argument before passing\n * to the shell.\n *\n * @param cmd - Command to execute (not user-controlled)\n * @param args - Array of arguments (safe even with user input due to array-based passing)\n * @param options - Spawn options\n * @param extra - Extra options for promise-spawn\n *\n * @example\n * // \u2714 DO THIS - Array-based arguments\n * spawn('git', ['commit', '-m', userMessage])\n * // Each argument is properly escaped, even if userMessage = \"foo; rm -rf /\"\n *\n * @example\n * // \u2716 NEVER DO THIS - String concatenation\n * spawn(`git commit -m \"${userMessage}\"`, { shell: true })\n * // Vulnerable to injection if userMessage = '\"; rm -rf / #'\n */\nexport function spawn(\n  cmd: string,\n  args?: string[] | readonly string[],\n  options?: SpawnOptions | undefined,\n  extra?: SpawnExtra | undefined,\n): SpawnResult {\n  // Windows cmd.exe command resolution for .cmd/.bat/.ps1 files:\n  //\n  // When shell: true is used on Windows with script files (.cmd, .bat, .ps1),\n  // cmd.exe can have issues executing full paths. The solution is to use just\n  // the command basename without extension and let cmd.exe find it via PATH.\n  //\n  // How cmd.exe resolves commands:\n  // 1. Searches current directory first\n  // 2. Then searches each directory in PATH environment variable\n  // 3. For each directory, tries extensions from PATHEXT (.COM, .EXE, .BAT, .CMD, etc.)\n  // 4. Executes the first match found\n  //\n  // Example: Given 'C:\\pnpm\\pnpm.cmd' with shell: true\n  // 1. Extract basename without extension: 'pnpm'\n  // 2. cmd.exe searches PATH directories for 'pnpm'\n  // 3. PATHEXT causes it to try 'pnpm.com', 'pnpm.exe', 'pnpm.bat', 'pnpm.cmd', etc.\n  // 4. Finds and executes 'C:\\pnpm\\pnpm.cmd'\n  //\n  // This approach is consistent with how other tools handle Windows execution:\n  // - npm's promise-spawn: uses which.sync() to find commands in PATH\n  // - cross-spawn: spawns cmd.exe with escaped arguments\n  // - execa: uses cross-spawn under the hood for Windows support\n  //\n  // See: https://github.com/nodejs/node/issues/3675\n  const shell = getOwn(options, 'shell')\n  // Inline WIN32 constant for coverage mode compatibility\n  const WIN32 = process.platform === 'win32'\n  let actualCmd = cmd\n  if (WIN32 && shell && windowsScriptExtRegExp.test(actualCmd)) {\n    const path = getPath()\n    // Extract just the command name without path and extension.\n    actualCmd = path.basename(actualCmd, path.extname(actualCmd))\n  }\n  const {\n    spinner: optionsSpinner = spinner,\n    stripAnsi: shouldStripAnsi = true,\n    ...spawnOptions\n  } = { __proto__: null, ...options } as SpawnOptions\n  const spinnerInstance = optionsSpinner\n  const { env, stdio, stdioString = true } = spawnOptions\n  // The stdio option can be a string or an array.\n  // https://nodejs.org/api/child_process.html#optionsstdio\n  const wasSpinning = !!spinnerInstance?.isSpinning\n  const shouldStopSpinner =\n    wasSpinning && !isStdioType(stdio, 'ignore') && !isStdioType(stdio, 'pipe')\n  const shouldRestartSpinner = shouldStopSpinner\n  if (shouldStopSpinner) {\n    spinnerInstance.stop()\n  }\n  const npmCliPromiseSpawn = getNpmcliPromiseSpawn()\n  // Use __proto__: null to prevent prototype pollution when passing to\n  // third-party code, Node.js built-ins, or JavaScript built-in methods.\n  // https://github.com/npm/promise-spawn\n  // https://github.com/nodejs/node/blob/v24.0.1/lib/child_process.js#L674-L678\n  const promiseSpawnOpts = {\n    __proto__: null,\n    cwd: typeof spawnOptions.cwd === 'string' ? spawnOptions.cwd : undefined,\n    env: {\n      __proto__: null,\n      ...process.env,\n      ...env,\n    } as unknown as NodeJS.ProcessEnv,\n    signal: abortSignal,\n    stdio: spawnOptions.stdio,\n    stdioString,\n    shell: spawnOptions.shell,\n    timeout: spawnOptions.timeout,\n    uid: spawnOptions.uid,\n    gid: spawnOptions.gid,\n  } as unknown as PromiseSpawnOptions\n  const spawnPromise = npmCliPromiseSpawn(\n    actualCmd,\n    args ? [...args] : [],\n    promiseSpawnOpts as Parameters<typeof npmCliPromiseSpawn>[2],\n    extra,\n  )\n  const oldSpawnPromise = spawnPromise\n  let newSpawnPromise: PromiseSpawnResult\n  if (shouldStripAnsi && stdioString) {\n    newSpawnPromise = spawnPromise\n      .then(result => {\n        const strippedResult = stripAnsiFromSpawnResult(result)\n        // Add exitCode as an alias for code.\n        if ('code' in (strippedResult as { code?: number })) {\n          ;(strippedResult as { code: number; exitCode: number }).exitCode = (\n            strippedResult as { code: number }\n          ).code\n        }\n        return strippedResult\n      })\n      .catch(error => {\n        throw stripAnsiFromSpawnResult(error)\n      }) as PromiseSpawnResult\n  } else {\n    newSpawnPromise = spawnPromise.then(result => {\n      // Add exitCode as an alias for code.\n      if ('code' in result) {\n        const res = result as typeof result & { exitCode: number }\n        res.exitCode = result.code\n        return res\n      }\n      return result\n    }) as PromiseSpawnResult\n  }\n  if (shouldRestartSpinner) {\n    newSpawnPromise = newSpawnPromise.finally(() => {\n      spinnerInstance.start()\n    }) as PromiseSpawnResult\n  }\n  // Copy process and stdin properties from original promise\n  ;(newSpawnPromise as unknown as PromiseSpawnResult).process =\n    oldSpawnPromise.process\n  ;(newSpawnPromise as unknown as PromiseSpawnResult).stdin = (\n    oldSpawnPromise as unknown as PromiseSpawnResult\n  ).stdin\n  return newSpawnPromise as SpawnResult\n}\n\n/*@__NO_SIDE_EFFECTS__*/\n/**\n * Synchronously spawn a child process.\n */\nexport type SpawnSyncOptions = Omit<SpawnOptions, 'spinner'>\nexport function spawnSync(\n  cmd: string,\n  args?: string[] | readonly string[],\n  options?: SpawnSyncOptions | undefined,\n): SpawnSyncReturns<string | Buffer> {\n  // Windows cmd.exe command resolution for .cmd/.bat/.ps1 files:\n  // See spawn() function above for detailed explanation of this approach.\n  const shell = getOwn(options, 'shell')\n  // Inline WIN32 constant for coverage mode compatibility\n  const WIN32 = process.platform === 'win32'\n  let actualCmd = cmd\n  if (WIN32 && shell && windowsScriptExtRegExp.test(actualCmd)) {\n    const path = getPath()\n    // Extract just the command name without path and extension.\n    actualCmd = path.basename(actualCmd, path.extname(actualCmd))\n  }\n  const { stripAnsi: shouldStripAnsi = true, ...rawSpawnOptions } = {\n    __proto__: null,\n    ...options,\n  } as SpawnSyncOptions\n  const { stdioString: rawStdioString = true } = rawSpawnOptions\n  const rawEncoding = rawStdioString ? 'utf8' : 'buffer'\n  const spawnOptions = {\n    encoding: rawEncoding,\n    ...rawSpawnOptions,\n  } as NodeSpawnOptions & { encoding: BufferEncoding | 'buffer' }\n  const stdioString = spawnOptions.encoding !== 'buffer'\n  const result = getChildProcess().spawnSync(actualCmd, args, spawnOptions)\n  if (stdioString) {\n    const { stderr, stdout } = result\n    if (stdout) {\n      result.stdout = stdout.toString().trim()\n    }\n    if (stderr) {\n      result.stderr = stderr.toString().trim()\n    }\n  }\n  return (\n    shouldStripAnsi && stdioString ? stripAnsiFromSpawnResult(result) : result\n  ) as SpawnSyncReturns<string | Buffer>\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/spinner.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/spinner.ts"],
-  "sourcesContent": ["/**\n * @fileoverview CLI spinner utilities for long-running operations.\n * Provides animated progress indicators with CI environment detection.\n */\n\nimport type { Writable } from 'node:stream'\n\n// Note: getAbortSignal is imported lazily to avoid circular dependencies.\nimport { CI } from '#env/ci'\nimport { generateSocketSpinnerFrames } from './effects/pulse-frames'\nimport type {\n  ShimmerColorGradient,\n  ShimmerConfig,\n  ShimmerDirection,\n  ShimmerState,\n} from './effects/text-shimmer'\nimport { applyShimmer, COLOR_INHERIT, DIR_LTR } from './effects/text-shimmer'\nimport yoctoSpinner from './external/@socketregistry/yocto-spinner'\nimport { hasOwn } from './objects'\nimport { isBlankString, stringWidth } from './strings'\n\nexport type ColorName =\n  | 'black'\n  | 'blue'\n  | 'blueBright'\n  | 'cyan'\n  | 'cyanBright'\n  | 'gray'\n  | 'green'\n  | 'greenBright'\n  | 'magenta'\n  | 'magentaBright'\n  | 'red'\n  | 'redBright'\n  | 'white'\n  | 'whiteBright'\n  | 'yellow'\n  | 'yellowBright'\n\nexport type ColorInherit = 'inherit'\n\nexport type ColorRgb = readonly [number, number, number]\n\nexport type ColorValue = ColorName | ColorRgb\n\nexport type SymbolType = 'fail' | 'info' | 'success' | 'warn'\n\n// Map color names to RGB values.\nconst colorToRgb: Record<ColorName, ColorRgb> = {\n  __proto__: null,\n  black: [0, 0, 0],\n  blue: [0, 0, 255],\n  blueBright: [100, 149, 237],\n  cyan: [0, 255, 255],\n  cyanBright: [0, 255, 255],\n  gray: [128, 128, 128],\n  green: [0, 128, 0],\n  greenBright: [0, 255, 0],\n  magenta: [255, 0, 255],\n  magentaBright: [255, 105, 180],\n  red: [255, 0, 0],\n  redBright: [255, 69, 0],\n  white: [255, 255, 255],\n  whiteBright: [255, 255, 255],\n  yellow: [255, 255, 0],\n  yellowBright: [255, 255, 153],\n} as Record<ColorName, ColorRgb>\n\n/**\n * Check if value is RGB tuple.\n */\nfunction isRgbTuple(value: ColorValue): value is ColorRgb {\n  return Array.isArray(value)\n}\n\n/**\n * Convert ColorValue to RGB tuple.\n */\nfunction toRgb(color: ColorValue): ColorRgb {\n  if (isRgbTuple(color)) {\n    return color\n  }\n  return colorToRgb[color]\n}\n\nexport type ProgressInfo = {\n  current: number\n  total: number\n  unit?: string | undefined\n}\n\nexport type ShimmerInfo = ShimmerState & {\n  color: ColorInherit | ColorValue | ShimmerColorGradient\n}\n\nexport type Spinner = {\n  color: ColorRgb\n  spinner: SpinnerStyle\n\n  get isSpinning(): boolean\n\n  clear(): Spinner\n  debug(text?: string | undefined, ...extras: unknown[]): Spinner\n  debugAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  error(text?: string | undefined, ...extras: unknown[]): Spinner\n  errorAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  fail(text?: string | undefined, ...extras: unknown[]): Spinner\n  failAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  // text property returns a method via _textMethod override\n  text(value: string): Spinner\n  text(): string\n\n  indent(spaces?: number | undefined): Spinner\n  dedent(spaces?: number | undefined): Spinner\n\n  info(text?: string | undefined, ...extras: unknown[]): Spinner\n  infoAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  log(text?: string | undefined, ...extras: unknown[]): Spinner\n  logAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  start(text?: string | undefined): Spinner\n  stop(text?: string | undefined): Spinner\n  stopAndPersist(text?: string | undefined): Spinner\n\n  step(text?: string | undefined, ...extras: unknown[]): Spinner\n  substep(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  success(text?: string | undefined, ...extras: unknown[]): Spinner\n  successAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  done(text?: string | undefined, ...extras: unknown[]): Spinner\n  doneAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  progress(current: number, total: number, unit?: string | undefined): Spinner\n  progressStep(amount?: number): Spinner\n\n  shimmer(enabled: boolean): Spinner\n  shimmer(config: Partial<ShimmerConfig> | ShimmerDirection): Spinner\n\n  warn(text?: string | undefined, ...extras: unknown[]): Spinner\n  warnAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n}\n\nexport type SpinnerOptions = {\n  readonly color?: ColorValue | undefined\n  readonly shimmer?: ShimmerConfig | ShimmerDirection | undefined\n  readonly spinner?: SpinnerStyle | undefined\n  readonly signal?: AbortSignal | undefined\n  readonly stream?: Writable | undefined\n  readonly text?: string | undefined\n}\n\nexport type SpinnerStyle = {\n  readonly frames: string[]\n  readonly interval?: number | undefined\n}\n\nexport const ciSpinner: SpinnerStyle = {\n  frames: [''],\n  interval: 2_147_483_647,\n}\n\nfunction desc(value: unknown) {\n  return {\n    __proto__: null,\n    configurable: true,\n    value,\n    writable: true,\n  }\n}\n\nfunction normalizeText(value: unknown) {\n  return typeof value === 'string' ? value.trimStart() : ''\n}\n\nfunction formatProgress(progress: ProgressInfo): string {\n  const { current, total, unit } = progress\n  const percentage = Math.round((current / total) * 100)\n  const bar = renderProgressBar(percentage)\n  const count = unit ? `${current}/${total} ${unit}` : `${current}/${total}`\n  return `${bar} ${percentage}% (${count})`\n}\n\nfunction renderProgressBar(percentage: number, width: number = 20): string {\n  const filled = Math.round((percentage / 100) * width)\n  const empty = width - filled\n  const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(empty)\n  // Use cyan color for the progress bar\n  const colors = /*@__PURE__*/ require('../external/yoctocolors-cjs')\n  return colors.cyan(bar)\n}\n\nlet _cliSpinners: Record<string, SpinnerStyle> | undefined\n\n/**\n * Get available CLI spinner styles or a specific style by name.\n * Extends the standard cli-spinners collection with Socket custom spinners.\n *\n * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json\n *\n * Custom spinners:\n * - `socket` (default): Socket pulse animation with sparkles and lightning\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getCliSpinners(\n  styleName?: string | undefined,\n): SpinnerStyle | Record<string, SpinnerStyle> | undefined {\n  if (_cliSpinners === undefined) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner constructor.\n    const YoctoCtor = yoctoSpinner as any\n    // Get the YoctoSpinner class to access static properties.\n    const tempInstance = YoctoCtor({})\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner class.\n    const YoctoSpinnerClass = tempInstance.constructor as any\n    // Extend the standard cli-spinners collection with Socket custom spinners.\n    _cliSpinners = {\n      __proto__: null,\n      ...YoctoSpinnerClass.spinners,\n      socket: generateSocketSpinnerFrames(),\n    }\n  }\n  if (typeof styleName === 'string' && _cliSpinners) {\n    return hasOwn(_cliSpinners, styleName) ? _cliSpinners[styleName] : undefined\n  }\n  return _cliSpinners\n}\n\nlet _Spinner: {\n  new (options?: SpinnerOptions | undefined): Spinner\n}\nlet _defaultSpinner: SpinnerStyle | undefined\n\n/**\n * Create a spinner instance for displaying loading indicators.\n *\n * AUTO-CLEAR BEHAVIOR:\n * - All *AndStop() methods AUTO-CLEAR the spinner line via yocto-spinner.stop()\n *   Examples: doneAndStop(), successAndStop(), failAndStop(), etc.\n *\n * - Methods WITHOUT \"AndStop\" do NOT clear (spinner keeps spinning)\n *   Examples: done(), success(), fail(), etc.\n *\n * STREAM USAGE:\n * - Spinner animation: stderr (yocto-spinner default)\n * - Status methods (done, success, fail, info, warn, step, substep): stderr\n * - Data methods (log): stdout\n *\n * COMPARISON WITH LOGGER:\n * - logger.done() does NOT auto-clear (requires manual logger.clearLine())\n * - spinner.doneAndStop() DOES auto-clear (built into yocto-spinner.stop())\n * - Pattern: logger.clearLine().done() vs spinner.doneAndStop()\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function Spinner(options?: SpinnerOptions | undefined): Spinner {\n  if (_Spinner === undefined) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner constructor.\n    const YoctoCtor = yoctoSpinner as any\n    // Get the actual YoctoSpinner class from an instance\n    const tempInstance = YoctoCtor({})\n    const YoctoSpinnerClass = tempInstance.constructor\n\n    /*@__PURE__*/\n    // biome-ignore lint/suspicious/noExplicitAny: Extending yocto-spinner class.\n    _Spinner = class SpinnerClass extends (YoctoSpinnerClass as any) {\n      declare isSpinning: boolean\n      #baseText: string = ''\n      #indentation: string = ''\n      #progress?: ProgressInfo | undefined\n      #shimmer?: ShimmerInfo | undefined\n      #shimmerSavedConfig?: ShimmerInfo | undefined\n\n      constructor(options?: SpinnerOptions | undefined) {\n        const opts = { __proto__: null, ...options } as SpinnerOptions\n\n        // Convert color option to RGB (default to Socket purple).\n        const spinnerColor = opts.color ?? ([140, 82, 255] as const)\n\n        // Validate RGB tuple if provided.\n        if (\n          isRgbTuple(spinnerColor) &&\n          (spinnerColor.length !== 3 ||\n            !spinnerColor.every(\n              n => typeof n === 'number' && n >= 0 && n <= 255,\n            ))\n        ) {\n          throw new TypeError(\n            'RGB color must be an array of 3 numbers between 0 and 255',\n          )\n        }\n\n        const spinnerColorRgb = toRgb(spinnerColor)\n\n        // Parse shimmer config - can be object or direction string.\n        let shimmerInfo: ShimmerInfo | undefined\n        if (opts.shimmer) {\n          let shimmerDir: ShimmerDirection\n          let shimmerColor:\n            | ColorInherit\n            | ColorValue\n            | ShimmerColorGradient\n            | undefined\n          // Default: 0.33 steps per frame (~150ms per step).\n          let shimmerSpeed: number = 1 / 3\n\n          if (typeof opts.shimmer === 'string') {\n            shimmerDir = opts.shimmer\n          } else {\n            const shimmerConfig = {\n              __proto__: null,\n              ...opts.shimmer,\n            } as ShimmerConfig\n            shimmerDir = shimmerConfig.dir ?? DIR_LTR\n            shimmerColor = shimmerConfig.color ?? COLOR_INHERIT\n            shimmerSpeed = shimmerConfig.speed ?? 1 / 3\n          }\n\n          // Create shimmer info with initial animation state:\n          // - COLOR_INHERIT means use spinner color dynamically\n          // - ColorValue (name or RGB tuple) is an explicit override color\n          // - undefined color defaults to COLOR_INHERIT\n          // - speed controls steps per frame (lower = slower, e.g., 0.33 = ~150ms per step)\n          shimmerInfo = {\n            __proto__: null,\n            color: shimmerColor === undefined ? COLOR_INHERIT : shimmerColor,\n            currentDir: DIR_LTR,\n            mode: shimmerDir,\n            speed: shimmerSpeed,\n            step: 0,\n          } as ShimmerInfo\n        }\n\n        // eslint-disable-next-line constructor-super\n        super({\n          signal: require('#constants/process').getAbortSignal(),\n          ...opts,\n          // Pass RGB color directly to yocto-spinner (it now supports RGB).\n          color: spinnerColorRgb,\n          // onRenderFrame callback provides full control over frame + text layout.\n          // Calculates spacing based on frame width to prevent text jumping.\n          onRenderFrame: (\n            frame: string,\n            text: string,\n            applyColor: (text: string) => string,\n          ) => {\n            const width = stringWidth(frame)\n            // Narrow frames (width 1) get 2 spaces, wide frames (width 2) get 1 space.\n            // Total width is consistent: 3 characters (frame + spacing) before text.\n            const spacing = width === 1 ? '  ' : ' '\n            return frame ? `${applyColor(frame)}${spacing}${text}` : text\n          },\n          // onFrameUpdate callback is called by yocto-spinner whenever a frame advances.\n          // This ensures shimmer updates are perfectly synchronized with animation beats.\n          onFrameUpdate: shimmerInfo\n            ? () => {\n                // Update parent's text without triggering render.\n                // Parent's #skipRender flag prevents nested render calls.\n                // Only update if we have base text to avoid blank frames.\n                if (this.#baseText) {\n                  super.text = this.#buildDisplayText()\n                }\n              }\n            : undefined,\n        })\n\n        this.#shimmer = shimmerInfo\n        this.#shimmerSavedConfig = shimmerInfo\n      }\n\n      // Override color getter to ensure it's always RGB.\n      get color(): ColorRgb {\n        const value = super.color\n        return isRgbTuple(value) ? value : toRgb(value)\n      }\n\n      // Override color setter to always convert to RGB before passing to yocto-spinner.\n      set color(value: ColorValue | ColorRgb) {\n        super.color = isRgbTuple(value) ? value : toRgb(value)\n      }\n\n      /**\n       * Apply a yocto-spinner method and update logger state.\n       * Handles text normalization, extra arguments, and logger tracking.\n       * @private\n       */\n      #apply(methodName: string, args: unknown[]) {\n        let extras: unknown[]\n        let text = args.at(0)\n        if (typeof text === 'string') {\n          extras = args.slice(1)\n        } else {\n          extras = args\n          text = ''\n        }\n        const wasSpinning = this.isSpinning\n        const normalized = normalizeText(text)\n        super[methodName](normalized)\n        const {\n          incLogCallCountSymbol,\n          lastWasBlankSymbol,\n          logger,\n        } = /*@__PURE__*/ require('./logger.js')\n        if (methodName === 'stop') {\n          if (wasSpinning && normalized) {\n            logger[lastWasBlankSymbol](isBlankString(normalized))\n            logger[incLogCallCountSymbol]()\n          }\n        } else {\n          logger[lastWasBlankSymbol](false)\n          logger[incLogCallCountSymbol]()\n        }\n        if (extras.length) {\n          logger.log(...extras)\n          logger[lastWasBlankSymbol](false)\n        }\n        return this\n      }\n\n      /**\n       * Build the complete display text with progress, shimmer, and indentation.\n       * Combines base text, progress bar, shimmer effects, and indentation.\n       * @private\n       */\n      #buildDisplayText() {\n        let displayText = this.#baseText\n\n        if (this.#progress) {\n          const progressText = formatProgress(this.#progress)\n          displayText = displayText\n            ? `${displayText} ${progressText}`\n            : progressText\n        }\n\n        // Apply shimmer effect if enabled.\n        if (displayText && this.#shimmer) {\n          // If shimmer color is 'inherit', use current spinner color (getter ensures RGB).\n          // Otherwise, check if it's a gradient (array of arrays) or single color.\n          let shimmerColor: ColorRgb | ShimmerColorGradient\n          if (this.#shimmer.color === COLOR_INHERIT) {\n            shimmerColor = this.color\n          } else if (Array.isArray(this.#shimmer.color[0])) {\n            // It's a gradient - use as is.\n            shimmerColor = this.#shimmer.color as ShimmerColorGradient\n          } else {\n            // It's a single color - convert to RGB.\n            shimmerColor = toRgb(this.#shimmer.color as ColorValue)\n          }\n\n          displayText = applyShimmer(displayText, this.#shimmer, {\n            color: shimmerColor,\n            direction: this.#shimmer.mode,\n          })\n        }\n\n        // Apply indentation\n        if (this.#indentation && displayText) {\n          displayText = this.#indentation + displayText\n        }\n\n        return displayText\n      }\n\n      /**\n       * Show a status message without stopping the spinner.\n       * Outputs the symbol and message to stderr, then continues spinning.\n       */\n      #showStatusAndKeepSpinning(symbolType: SymbolType, args: unknown[]) {\n        let text = args.at(0)\n        let extras: unknown[]\n        if (typeof text === 'string') {\n          extras = args.slice(1)\n        } else {\n          extras = args\n          text = ''\n        }\n\n        const { LOG_SYMBOLS, logger } = /*@__PURE__*/ require('./logger.js')\n        // Note: Status messages always go to stderr.\n        logger.error(`${LOG_SYMBOLS[symbolType]} ${text}`, ...extras)\n        return this\n      }\n\n      /**\n       * Update the spinner's displayed text.\n       * Rebuilds display text and triggers render.\n       * @private\n       */\n      #updateSpinnerText() {\n        // Call the parent class's text setter, which triggers render.\n        super.text = this.#buildDisplayText()\n      }\n\n      /**\n       * Show a debug message without stopping the spinner (only if debug mode enabled).\n       * Outputs to stderr and continues spinning.\n       */\n      debug(...args: unknown[]) {\n        const { isDebug } = /*@__PURE__*/ require('./debug.js')\n        if (isDebug()) {\n          return this.#showStatusAndKeepSpinning('info', args)\n        }\n        return this\n      }\n\n      /**\n       * Show a debug message and stop the spinner (only if debug mode enabled).\n       * Auto-clears the spinner line before displaying the message.\n       */\n      debugAndStop(...args: unknown[]) {\n        const { isDebug } = /*@__PURE__*/ require('./debug.js')\n        if (isDebug()) {\n          return this.#apply('info', args)\n        }\n        return this\n      }\n\n      /**\n       * Decrease indentation level.\n       * Pass 0 to reset indentation to zero.\n       * @param spaces - Number of spaces to remove (default: 2)\n       */\n      dedent(spaces?: number) {\n        // Pass 0 to reset indentation\n        if (spaces === 0) {\n          this.#indentation = ''\n        } else {\n          const amount = spaces ?? 2\n          const newLength = Math.max(0, this.#indentation.length - amount)\n          this.#indentation = this.#indentation.slice(0, newLength)\n        }\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Alias for success() (shorter name).\n       * DESIGN DECISION: Unlike yocto-spinner, our done() does NOT stop the spinner.\n       * Use doneAndStop() if you want to stop the spinner.\n       */\n      done(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('success', args)\n      }\n\n      /**\n       * Show a done message and stop the spinner.\n       * Auto-clears the spinner line before displaying the success message.\n       */\n      doneAndStop(...args: unknown[]) {\n        return this.#apply('success', args)\n      }\n\n      /**\n       * Show a failure message without stopping the spinner.\n       * DESIGN DECISION: Unlike yocto-spinner, our fail() does NOT stop the spinner.\n       * This allows displaying errors while continuing to spin.\n       * Use failAndStop() if you want to stop the spinner.\n       */\n      fail(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('fail', args)\n      }\n\n      /**\n       * Show a failure message and stop the spinner.\n       * Auto-clears the spinner line before displaying the error message.\n       */\n      failAndStop(...args: unknown[]) {\n        return this.#apply('error', args)\n      }\n\n      /**\n       * Increase indentation level.\n       * Pass 0 to reset indentation to zero.\n       * @param spaces - Number of spaces to add (default: 2)\n       */\n      indent(spaces?: number) {\n        // Pass 0 to reset indentation\n        if (spaces === 0) {\n          this.#indentation = ''\n        } else {\n          const amount = spaces ?? 2\n          this.#indentation += ' '.repeat(amount)\n        }\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Show an info message without stopping the spinner.\n       * Outputs to stderr and continues spinning.\n       */\n      info(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('info', args)\n      }\n\n      /**\n       * Show an info message and stop the spinner.\n       * Auto-clears the spinner line before displaying the message.\n       */\n      infoAndStop(...args: unknown[]) {\n        return this.#apply('info', args)\n      }\n\n      /**\n       * Log a message to stdout without stopping the spinner.\n       * Unlike other methods, this outputs to stdout for data logging.\n       */\n      log(...args: unknown[]) {\n        const { logger } = /*@__PURE__*/ require('./logger.js')\n        logger.log(...args)\n        return this\n      }\n\n      /**\n       * Log a message and stop the spinner.\n       * Auto-clears the spinner line before displaying the message.\n       */\n      logAndStop(...args: unknown[]) {\n        return this.#apply('stop', args)\n      }\n\n      /**\n       * Update progress information displayed with the spinner.\n       * Shows a progress bar with percentage and optional unit label.\n       * @param current - Current progress value\n       * @param total - Total progress value\n       * @param unit - Optional unit label (e.g., 'files', 'items')\n       */\n      progress = (\n        current: number,\n        total: number,\n        unit?: string | undefined,\n      ) => {\n        this.#progress = {\n          __proto__: null,\n          current,\n          total,\n          ...(unit ? { unit } : {}),\n        } as ProgressInfo\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Increment progress by a specified amount.\n       * Updates the progress bar displayed with the spinner.\n       * @param amount - Amount to increment (default: 1)\n       */\n      progressStep(amount: number = 1) {\n        if (this.#progress) {\n          const newCurrent = this.#progress.current + amount\n          this.#progress = {\n            __proto__: null,\n            current: Math.max(0, Math.min(newCurrent, this.#progress.total)),\n            total: this.#progress.total,\n            ...(this.#progress.unit ? { unit: this.#progress.unit } : {}),\n          } as ProgressInfo\n          this.#updateSpinnerText()\n        }\n        return this\n      }\n\n      /**\n       * Start the spinner animation with optional text.\n       * Begins displaying the animated spinner.\n       * @param text - Optional text to display with the spinner\n       */\n      start(...args: unknown[]) {\n        if (args.length) {\n          const text = args.at(0)\n          const normalized = normalizeText(text)\n          // We clear this.text on start when `text` is falsy because yocto-spinner\n          // will not clear it otherwise.\n          if (!normalized) {\n            this.#baseText = ''\n            super.text = ''\n          } else {\n            this.#baseText = normalized\n          }\n        }\n\n        this.#updateSpinnerText()\n        return this.#apply('start', args)\n      }\n\n      /**\n       * Log a main step message to stderr without stopping the spinner.\n       * Adds a blank line before the message for visual separation.\n       * Aligns with logger.step() to use stderr for status messages.\n       */\n      step(...args: unknown[]) {\n        const text = args[0]\n        const { logger } = /*@__PURE__*/ require('./logger.js')\n        if (typeof text === 'string') {\n          // Add blank line before step for visual separation.\n          logger.error('')\n          // Use error (stderr) to align with logger.step() default stream.\n          logger.error(text, ...args.slice(1))\n        }\n        return this\n      }\n\n      /**\n       * Log an indented substep message to stderr without stopping the spinner.\n       * Adds 2-space indentation to the message.\n       * Aligns with logger.substep() to use stderr for status messages.\n       */\n      substep(...args: unknown[]) {\n        const text = args[0]\n        if (typeof text === 'string') {\n          // Add 2-space indent for substep.\n          const { logger } = /*@__PURE__*/ require('./logger.js')\n          // Use error (stderr) to align with logger.substep() default stream.\n          logger.error(`  ${text}`, ...args.slice(1))\n        }\n        return this\n      }\n\n      /**\n       * Stop the spinner animation and clear internal state.\n       * Auto-clears the spinner line via yocto-spinner.stop().\n       * Resets progress, shimmer, and text state.\n       * @param text - Optional final text to display after stopping\n       */\n      stop(...args: unknown[]) {\n        // Clear internal state.\n        this.#baseText = ''\n        this.#progress = undefined\n        // Reset shimmer animation state if shimmer is enabled.\n        if (this.#shimmer) {\n          this.#shimmer.currentDir = DIR_LTR\n          this.#shimmer.step = 0\n        }\n        // Call parent stop first (clears screen, sets isSpinning = false).\n        const result = this.#apply('stop', args)\n        // Then clear text to avoid blank frame render.\n        // This is safe now because isSpinning is false.\n        super.text = ''\n        return result\n      }\n\n      /**\n       * Show a success message without stopping the spinner.\n       * DESIGN DECISION: Unlike yocto-spinner, our success() does NOT stop the spinner.\n       * This allows displaying success messages while continuing to spin for multi-step operations.\n       * Use successAndStop() if you want to stop the spinner.\n       */\n      success(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('success', args)\n      }\n\n      /**\n       * Show a success message and stop the spinner.\n       * Auto-clears the spinner line before displaying the success message.\n       */\n      successAndStop(...args: unknown[]) {\n        return this.#apply('success', args)\n      }\n\n      /**\n       * Get or set the spinner text.\n       * When called with no arguments, returns the current text.\n       * When called with text, updates the display and returns the spinner.\n       * @param value - Text to display (omit to get current text)\n       * @returns Current text (getter) or this spinner (setter)\n       */\n      text(): string\n      text(value: string): Spinner\n      text(value?: string): string | Spinner {\n        // biome-ignore lint/complexity/noArguments: Function overload for getter/setter pattern.\n        if (arguments.length === 0) {\n          // Getter: return current base text\n          return this.#baseText\n        }\n        // Setter: update base text and refresh display\n        this.#baseText = value ?? ''\n        this.#updateSpinnerText()\n        return this as unknown as Spinner\n      }\n\n      /**\n       * Show a warning message without stopping the spinner.\n       * Outputs to stderr and continues spinning.\n       */\n      warn(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('warn', args)\n      }\n\n      /**\n       * Show a warning message and stop the spinner.\n       * Auto-clears the spinner line before displaying the warning message.\n       */\n      warnAndStop(...args: unknown[]) {\n        return this.#apply('warning', args)\n      }\n\n      /**\n       * Toggle shimmer effect or update shimmer configuration.\n       * Preserves shimmer config when toggling off, allowing easy re-enable.\n       * Supports partial config updates to tweak specific properties.\n       *\n       * @param enabledOrConfig - Boolean to toggle, partial config to update, or direction string\n       * @returns This spinner for chaining\n       *\n       * @example\n       * // Toggle off (preserves config for later re-enable)\n       * spinner.shimmer(false)\n       *\n       * // Toggle on (restores saved config or uses defaults)\n       * spinner.shimmer(true)\n       *\n       * // Update specific properties\n       * spinner.shimmer({ speed: 0.5 })\n       * spinner.shimmer({ color: [255, 0, 0] })\n       *\n       * // Set direction\n       * spinner.shimmer('rtl')\n       */\n      shimmer(\n        enabledOrConfig:\n          | boolean\n          | Partial<ShimmerConfig>\n          | ShimmerDirection\n          | undefined,\n      ): Spinner {\n        if (enabledOrConfig === false) {\n          // Disable shimmer but preserve config.\n          this.#shimmer = undefined\n        } else if (enabledOrConfig === true) {\n          // Re-enable with saved config or defaults.\n          if (this.#shimmerSavedConfig) {\n            // Restore saved config.\n            this.#shimmer = { ...this.#shimmerSavedConfig }\n          } else {\n            // Create default config.\n            this.#shimmer = {\n              color: COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: DIR_LTR,\n              speed: 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        } else if (typeof enabledOrConfig === 'string') {\n          // Direction string - update existing or create new.\n          if (this.#shimmer) {\n            // Update existing shimmer direction.\n            this.#shimmer = {\n              ...this.#shimmer,\n              mode: enabledOrConfig,\n            }\n            this.#shimmerSavedConfig = this.#shimmer\n          } else if (this.#shimmerSavedConfig) {\n            // Restore and update.\n            this.#shimmer = {\n              ...this.#shimmerSavedConfig,\n              mode: enabledOrConfig,\n            }\n            this.#shimmerSavedConfig = this.#shimmer\n          } else {\n            // Create new with direction.\n            this.#shimmer = {\n              color: COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: enabledOrConfig,\n              speed: 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        } else if (enabledOrConfig && typeof enabledOrConfig === 'object') {\n          // Partial config update - merge with existing or saved config.\n          const partialConfig = {\n            __proto__: null,\n            ...enabledOrConfig,\n          } as Partial<ShimmerConfig>\n\n          if (this.#shimmer) {\n            // Update existing shimmer.\n            this.#shimmer = {\n              ...this.#shimmer,\n              ...(partialConfig.color !== undefined\n                ? { color: partialConfig.color }\n                : {}),\n              ...(partialConfig.dir !== undefined\n                ? { mode: partialConfig.dir }\n                : {}),\n              ...(partialConfig.speed !== undefined\n                ? { speed: partialConfig.speed }\n                : {}),\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          } else if (this.#shimmerSavedConfig) {\n            // Restore and update.\n            this.#shimmer = {\n              ...this.#shimmerSavedConfig,\n              ...(partialConfig.color !== undefined\n                ? { color: partialConfig.color }\n                : {}),\n              ...(partialConfig.dir !== undefined\n                ? { mode: partialConfig.dir }\n                : {}),\n              ...(partialConfig.speed !== undefined\n                ? { speed: partialConfig.speed }\n                : {}),\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          } else {\n            // Create new with partial config.\n            this.#shimmer = {\n              color: partialConfig.color ?? COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: partialConfig.dir ?? DIR_LTR,\n              speed: partialConfig.speed ?? 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        }\n\n        this.#updateSpinnerText()\n        return this as unknown as Spinner\n      }\n    } as unknown as {\n      new (options?: SpinnerOptions | undefined): Spinner\n    }\n    // Add aliases.\n    Object.defineProperties(_Spinner.prototype, {\n      error: desc(_Spinner.prototype.fail),\n      errorAndStop: desc(_Spinner.prototype.failAndStop),\n      warning: desc(_Spinner.prototype.warn),\n      warningAndStop: desc(_Spinner.prototype.warnAndStop),\n    })\n    _defaultSpinner = CI\n      ? ciSpinner\n      : (getCliSpinners('socket') as SpinnerStyle)\n  }\n  return new _Spinner({\n    spinner: _defaultSpinner,\n    ...options,\n  })\n}\n\nlet _spinner: ReturnType<typeof Spinner> | undefined\n/**\n * Get the default spinner instance.\n * Lazily creates the spinner to avoid circular dependencies during module initialization.\n */\nexport function getDefaultSpinner(): ReturnType<typeof Spinner> {\n  if (_spinner === undefined) {\n    _spinner = Spinner()\n  }\n  return _spinner\n}\n\n/**\n * @deprecated Use `getDefaultSpinner()` function instead for better tree-shaking and to avoid circular dependencies.\n */\nexport const spinner = /* @__PURE__ */ (() => {\n  // Lazy initialization to prevent circular dependency issues during module loading.\n  let _lazySpinner: ReturnType<typeof Spinner> | undefined\n  return new Proxy({} as ReturnType<typeof Spinner>, {\n    get(_target, prop) {\n      if (_lazySpinner === undefined) {\n        _lazySpinner = Spinner()\n      }\n      const value = _lazySpinner[prop as keyof ReturnType<typeof Spinner>]\n      return typeof value === 'function' ? value.bind(_lazySpinner) : value\n    },\n  })\n})()\n\nexport type WithSpinnerOptions<T> = {\n  message: string\n  operation: () => Promise<T>\n  spinner?: Spinner | undefined\n}\n\n/**\n * Execute an async operation with spinner lifecycle management.\n * Ensures spinner.stop() is always called via try/finally, even if the operation throws.\n *\n * @param options - Configuration object\n * @param options.message - Message to display while spinner is running\n * @param options.operation - Async function to execute\n * @param options.spinner - Optional spinner instance (if not provided, no spinner is used)\n * @returns Result of the operation\n * @throws Re-throws any error from operation after stopping spinner\n *\n * @example\n * import { spinner, withSpinner } from '@socketsecurity/registry/lib/spinner'\n *\n * // With spinner instance\n * await withSpinner({\n *   message: 'Processing\u2026',\n *   operation: async () => {\n *     return await processData()\n *   },\n *   spinner\n * })\n *\n * // Without spinner instance (no-op)\n * await withSpinner({\n *   message: 'Processing\u2026',\n *   operation: async () => {\n *     return await processData()\n *   }\n * })\n */\nexport async function withSpinner<T>(\n  options: WithSpinnerOptions<T>,\n): Promise<T> {\n  const { message, operation, spinner } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerOptions<T>\n\n  if (!spinner) {\n    return await operation()\n  }\n\n  spinner.start(message)\n  try {\n    return await operation()\n  } finally {\n    spinner.stop()\n  }\n}\n\nexport type WithSpinnerRestoreOptions<T> = {\n  operation: () => Promise<T>\n  spinner?: Spinner | undefined\n  wasSpinning: boolean\n}\n\n/**\n * Execute an async operation with conditional spinner restart.\n * Useful when you need to temporarily stop a spinner for an operation,\n * then restore it to its previous state.\n *\n * @param options - Configuration object\n * @param options.operation - Async function to execute\n * @param options.spinner - Optional spinner instance to manage\n * @param options.wasSpinning - Whether spinner was spinning before\n * @returns Result of the operation\n * @throws Re-throws any error from operation after restoring spinner state\n *\n * @example\n * import { spinner, withSpinnerRestore } from '@socketsecurity/registry/lib/spinner'\n *\n * const wasSpinning = spinner.isSpinning\n * spinner.stop()\n *\n * const result = await withSpinnerRestore({\n *   operation: async () => {\n *     // Do work without spinner\n *     return await someOperation()\n *   },\n *   spinner,\n *   wasSpinning\n * })\n */\nexport async function withSpinnerRestore<T>(\n  options: WithSpinnerRestoreOptions<T>,\n): Promise<T> {\n  const { operation, spinner, wasSpinning } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerRestoreOptions<T>\n\n  try {\n    return await operation()\n  } finally {\n    if (spinner && wasSpinning) {\n      spinner.start()\n    }\n  }\n}\n\nexport type WithSpinnerSyncOptions<T> = {\n  message: string\n  operation: () => T\n  spinner?: Spinner | undefined\n}\n\n/**\n * Execute a synchronous operation with spinner lifecycle management.\n * Ensures spinner.stop() is always called via try/finally, even if the operation throws.\n *\n * @param options - Configuration object\n * @param options.message - Message to display while spinner is running\n * @param options.operation - Function to execute\n * @param options.spinner - Optional spinner instance (if not provided, no spinner is used)\n * @returns Result of the operation\n * @throws Re-throws any error from operation after stopping spinner\n *\n * @example\n * import { spinner, withSpinnerSync} from '@socketsecurity/registry/lib/spinner'\n *\n * const result = withSpinnerSync({\n *   message: 'Processing\u2026',\n *   operation: () => {\n *     return processDataSync()\n *   },\n *   spinner\n * })\n */\nexport function withSpinnerSync<T>(options: WithSpinnerSyncOptions<T>): T {\n  const { message, operation, spinner } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerSyncOptions<T>\n\n  if (!spinner) {\n    return operation()\n  }\n\n  spinner.start(message)\n  try {\n    return operation()\n  } finally {\n    spinner.stop()\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @fileoverview CLI spinner utilities for long-running operations.\n * Provides animated progress indicators with CI environment detection.\n */\n\nimport type { Writable } from 'node:stream'\n\n// Note: getAbortSignal is imported lazily to avoid circular dependencies.\nimport { CI } from '#env/ci'\nimport { generateSocketSpinnerFrames } from './effects/pulse-frames'\nimport type {\n  ShimmerColorGradient,\n  ShimmerConfig,\n  ShimmerDirection,\n  ShimmerState,\n} from './effects/text-shimmer'\nimport { applyShimmer, COLOR_INHERIT, DIR_LTR } from './effects/text-shimmer'\nimport yoctoSpinner from './external/@socketregistry/yocto-spinner'\nimport { hasOwn } from './objects'\nimport { isBlankString, stringWidth } from './strings'\n\nexport type ColorName =\n  | 'black'\n  | 'blue'\n  | 'blueBright'\n  | 'cyan'\n  | 'cyanBright'\n  | 'gray'\n  | 'green'\n  | 'greenBright'\n  | 'magenta'\n  | 'magentaBright'\n  | 'red'\n  | 'redBright'\n  | 'white'\n  | 'whiteBright'\n  | 'yellow'\n  | 'yellowBright'\n\nexport type ColorInherit = 'inherit'\n\nexport type ColorRgb = readonly [number, number, number]\n\nexport type ColorValue = ColorName | ColorRgb\n\nexport type SymbolType = 'fail' | 'info' | 'success' | 'warn'\n\n// Map color names to RGB values.\nconst colorToRgb: Record<ColorName, ColorRgb> = {\n  __proto__: null,\n  black: [0, 0, 0],\n  blue: [0, 0, 255],\n  blueBright: [100, 149, 237],\n  cyan: [0, 255, 255],\n  cyanBright: [0, 255, 255],\n  gray: [128, 128, 128],\n  green: [0, 128, 0],\n  greenBright: [0, 255, 0],\n  magenta: [255, 0, 255],\n  magentaBright: [255, 105, 180],\n  red: [255, 0, 0],\n  redBright: [255, 69, 0],\n  white: [255, 255, 255],\n  whiteBright: [255, 255, 255],\n  yellow: [255, 255, 0],\n  yellowBright: [255, 255, 153],\n} as Record<ColorName, ColorRgb>\n\n/**\n * Check if value is RGB tuple.\n */\nfunction isRgbTuple(value: ColorValue): value is ColorRgb {\n  return Array.isArray(value)\n}\n\n/**\n * Convert ColorValue to RGB tuple.\n */\nfunction toRgb(color: ColorValue): ColorRgb {\n  if (isRgbTuple(color)) {\n    return color\n  }\n  return colorToRgb[color]\n}\n\nexport type ProgressInfo = {\n  current: number\n  total: number\n  unit?: string | undefined\n}\n\nexport type ShimmerInfo = ShimmerState & {\n  color: ColorInherit | ColorValue | ShimmerColorGradient\n}\n\nexport type Spinner = {\n  color: ColorRgb\n  spinner: SpinnerStyle\n\n  get isSpinning(): boolean\n\n  clear(): Spinner\n  debug(text?: string | undefined, ...extras: unknown[]): Spinner\n  debugAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  error(text?: string | undefined, ...extras: unknown[]): Spinner\n  errorAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  fail(text?: string | undefined, ...extras: unknown[]): Spinner\n  failAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  // text property returns a method via _textMethod override\n  text(value: string): Spinner\n  text(): string\n\n  indent(spaces?: number | undefined): Spinner\n  dedent(spaces?: number | undefined): Spinner\n\n  info(text?: string | undefined, ...extras: unknown[]): Spinner\n  infoAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n  log(text?: string | undefined, ...extras: unknown[]): Spinner\n  logAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  start(text?: string | undefined): Spinner\n  stop(text?: string | undefined): Spinner\n  stopAndPersist(text?: string | undefined): Spinner\n\n  step(text?: string | undefined, ...extras: unknown[]): Spinner\n  substep(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  success(text?: string | undefined, ...extras: unknown[]): Spinner\n  successAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  done(text?: string | undefined, ...extras: unknown[]): Spinner\n  doneAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n\n  progress(current: number, total: number, unit?: string | undefined): Spinner\n  progressStep(amount?: number): Spinner\n\n  shimmer(enabled: boolean): Spinner\n  shimmer(config: Partial<ShimmerConfig> | ShimmerDirection): Spinner\n\n  warn(text?: string | undefined, ...extras: unknown[]): Spinner\n  warnAndStop(text?: string | undefined, ...extras: unknown[]): Spinner\n}\n\nexport type SpinnerOptions = {\n  readonly color?: ColorValue | undefined\n  readonly shimmer?: ShimmerConfig | ShimmerDirection | undefined\n  readonly spinner?: SpinnerStyle | undefined\n  readonly signal?: AbortSignal | undefined\n  readonly stream?: Writable | undefined\n  readonly text?: string | undefined\n}\n\nexport type SpinnerStyle = {\n  readonly frames: string[]\n  readonly interval?: number | undefined\n}\n\nexport const ciSpinner: SpinnerStyle = {\n  frames: [''],\n  interval: 2_147_483_647,\n}\n\nfunction desc(value: unknown) {\n  return {\n    __proto__: null,\n    configurable: true,\n    value,\n    writable: true,\n  }\n}\n\nfunction normalizeText(value: unknown) {\n  return typeof value === 'string' ? value.trimStart() : ''\n}\n\nfunction formatProgress(progress: ProgressInfo): string {\n  const { current, total, unit } = progress\n  const percentage = Math.round((current / total) * 100)\n  const bar = renderProgressBar(percentage)\n  const count = unit ? `${current}/${total} ${unit}` : `${current}/${total}`\n  return `${bar} ${percentage}% (${count})`\n}\n\nfunction renderProgressBar(percentage: number, width: number = 20): string {\n  const filled = Math.round((percentage / 100) * width)\n  const empty = width - filled\n  const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(empty)\n  // Use cyan color for the progress bar\n  const colors = /*@__PURE__*/ require('./external/yoctocolors-cjs')\n  return colors.cyan(bar)\n}\n\nlet _cliSpinners: Record<string, SpinnerStyle> | undefined\n\n/**\n * Get available CLI spinner styles or a specific style by name.\n * Extends the standard cli-spinners collection with Socket custom spinners.\n *\n * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json\n *\n * Custom spinners:\n * - `socket` (default): Socket pulse animation with sparkles and lightning\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getCliSpinners(\n  styleName?: string | undefined,\n): SpinnerStyle | Record<string, SpinnerStyle> | undefined {\n  if (_cliSpinners === undefined) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner constructor.\n    const YoctoCtor = yoctoSpinner as any\n    // Get the YoctoSpinner class to access static properties.\n    const tempInstance = YoctoCtor({})\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner class.\n    const YoctoSpinnerClass = tempInstance.constructor as any\n    // Extend the standard cli-spinners collection with Socket custom spinners.\n    _cliSpinners = {\n      __proto__: null,\n      ...YoctoSpinnerClass.spinners,\n      socket: generateSocketSpinnerFrames(),\n    }\n  }\n  if (typeof styleName === 'string' && _cliSpinners) {\n    return hasOwn(_cliSpinners, styleName) ? _cliSpinners[styleName] : undefined\n  }\n  return _cliSpinners\n}\n\nlet _Spinner: {\n  new (options?: SpinnerOptions | undefined): Spinner\n}\nlet _defaultSpinner: SpinnerStyle | undefined\n\n/**\n * Create a spinner instance for displaying loading indicators.\n *\n * AUTO-CLEAR BEHAVIOR:\n * - All *AndStop() methods AUTO-CLEAR the spinner line via yocto-spinner.stop()\n *   Examples: doneAndStop(), successAndStop(), failAndStop(), etc.\n *\n * - Methods WITHOUT \"AndStop\" do NOT clear (spinner keeps spinning)\n *   Examples: done(), success(), fail(), etc.\n *\n * STREAM USAGE:\n * - Spinner animation: stderr (yocto-spinner default)\n * - Status methods (done, success, fail, info, warn, step, substep): stderr\n * - Data methods (log): stdout\n *\n * COMPARISON WITH LOGGER:\n * - logger.done() does NOT auto-clear (requires manual logger.clearLine())\n * - spinner.doneAndStop() DOES auto-clear (built into yocto-spinner.stop())\n * - Pattern: logger.clearLine().done() vs spinner.doneAndStop()\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function Spinner(options?: SpinnerOptions | undefined): Spinner {\n  if (_Spinner === undefined) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing internal yocto-spinner constructor.\n    const YoctoCtor = yoctoSpinner as any\n    // Get the actual YoctoSpinner class from an instance\n    const tempInstance = YoctoCtor({})\n    const YoctoSpinnerClass = tempInstance.constructor\n\n    /*@__PURE__*/\n    // biome-ignore lint/suspicious/noExplicitAny: Extending yocto-spinner class.\n    _Spinner = class SpinnerClass extends (YoctoSpinnerClass as any) {\n      declare isSpinning: boolean\n      #baseText: string = ''\n      #indentation: string = ''\n      #progress?: ProgressInfo | undefined\n      #shimmer?: ShimmerInfo | undefined\n      #shimmerSavedConfig?: ShimmerInfo | undefined\n\n      constructor(options?: SpinnerOptions | undefined) {\n        const opts = { __proto__: null, ...options } as SpinnerOptions\n\n        // Convert color option to RGB (default to Socket purple).\n        const spinnerColor = opts.color ?? ([140, 82, 255] as const)\n\n        // Validate RGB tuple if provided.\n        if (\n          isRgbTuple(spinnerColor) &&\n          (spinnerColor.length !== 3 ||\n            !spinnerColor.every(\n              n => typeof n === 'number' && n >= 0 && n <= 255,\n            ))\n        ) {\n          throw new TypeError(\n            'RGB color must be an array of 3 numbers between 0 and 255',\n          )\n        }\n\n        const spinnerColorRgb = toRgb(spinnerColor)\n\n        // Parse shimmer config - can be object or direction string.\n        let shimmerInfo: ShimmerInfo | undefined\n        if (opts.shimmer) {\n          let shimmerDir: ShimmerDirection\n          let shimmerColor:\n            | ColorInherit\n            | ColorValue\n            | ShimmerColorGradient\n            | undefined\n          // Default: 0.33 steps per frame (~150ms per step).\n          let shimmerSpeed: number = 1 / 3\n\n          if (typeof opts.shimmer === 'string') {\n            shimmerDir = opts.shimmer\n          } else {\n            const shimmerConfig = {\n              __proto__: null,\n              ...opts.shimmer,\n            } as ShimmerConfig\n            shimmerDir = shimmerConfig.dir ?? DIR_LTR\n            shimmerColor = shimmerConfig.color ?? COLOR_INHERIT\n            shimmerSpeed = shimmerConfig.speed ?? 1 / 3\n          }\n\n          // Create shimmer info with initial animation state:\n          // - COLOR_INHERIT means use spinner color dynamically\n          // - ColorValue (name or RGB tuple) is an explicit override color\n          // - undefined color defaults to COLOR_INHERIT\n          // - speed controls steps per frame (lower = slower, e.g., 0.33 = ~150ms per step)\n          shimmerInfo = {\n            __proto__: null,\n            color: shimmerColor === undefined ? COLOR_INHERIT : shimmerColor,\n            currentDir: DIR_LTR,\n            mode: shimmerDir,\n            speed: shimmerSpeed,\n            step: 0,\n          } as ShimmerInfo\n        }\n\n        // eslint-disable-next-line constructor-super\n        super({\n          signal: require('#constants/process').getAbortSignal(),\n          ...opts,\n          // Pass RGB color directly to yocto-spinner (it now supports RGB).\n          color: spinnerColorRgb,\n          // onRenderFrame callback provides full control over frame + text layout.\n          // Calculates spacing based on frame width to prevent text jumping.\n          onRenderFrame: (\n            frame: string,\n            text: string,\n            applyColor: (text: string) => string,\n          ) => {\n            const width = stringWidth(frame)\n            // Narrow frames (width 1) get 2 spaces, wide frames (width 2) get 1 space.\n            // Total width is consistent: 3 characters (frame + spacing) before text.\n            const spacing = width === 1 ? '  ' : ' '\n            return frame ? `${applyColor(frame)}${spacing}${text}` : text\n          },\n          // onFrameUpdate callback is called by yocto-spinner whenever a frame advances.\n          // This ensures shimmer updates are perfectly synchronized with animation beats.\n          onFrameUpdate: shimmerInfo\n            ? () => {\n                // Update parent's text without triggering render.\n                // Parent's #skipRender flag prevents nested render calls.\n                // Only update if we have base text to avoid blank frames.\n                if (this.#baseText) {\n                  super.text = this.#buildDisplayText()\n                }\n              }\n            : undefined,\n        })\n\n        this.#shimmer = shimmerInfo\n        this.#shimmerSavedConfig = shimmerInfo\n      }\n\n      // Override color getter to ensure it's always RGB.\n      get color(): ColorRgb {\n        const value = super.color\n        return isRgbTuple(value) ? value : toRgb(value)\n      }\n\n      // Override color setter to always convert to RGB before passing to yocto-spinner.\n      set color(value: ColorValue | ColorRgb) {\n        super.color = isRgbTuple(value) ? value : toRgb(value)\n      }\n\n      /**\n       * Apply a yocto-spinner method and update logger state.\n       * Handles text normalization, extra arguments, and logger tracking.\n       * @private\n       */\n      #apply(methodName: string, args: unknown[]) {\n        let extras: unknown[]\n        let text = args.at(0)\n        if (typeof text === 'string') {\n          extras = args.slice(1)\n        } else {\n          extras = args\n          text = ''\n        }\n        const wasSpinning = this.isSpinning\n        const normalized = normalizeText(text)\n        super[methodName](normalized)\n        const {\n          incLogCallCountSymbol,\n          lastWasBlankSymbol,\n          logger,\n        } = /*@__PURE__*/ require('./logger.js')\n        if (methodName === 'stop') {\n          if (wasSpinning && normalized) {\n            logger[lastWasBlankSymbol](isBlankString(normalized))\n            logger[incLogCallCountSymbol]()\n          }\n        } else {\n          logger[lastWasBlankSymbol](false)\n          logger[incLogCallCountSymbol]()\n        }\n        if (extras.length) {\n          logger.log(...extras)\n          logger[lastWasBlankSymbol](false)\n        }\n        return this\n      }\n\n      /**\n       * Build the complete display text with progress, shimmer, and indentation.\n       * Combines base text, progress bar, shimmer effects, and indentation.\n       * @private\n       */\n      #buildDisplayText() {\n        let displayText = this.#baseText\n\n        if (this.#progress) {\n          const progressText = formatProgress(this.#progress)\n          displayText = displayText\n            ? `${displayText} ${progressText}`\n            : progressText\n        }\n\n        // Apply shimmer effect if enabled.\n        if (displayText && this.#shimmer) {\n          // If shimmer color is 'inherit', use current spinner color (getter ensures RGB).\n          // Otherwise, check if it's a gradient (array of arrays) or single color.\n          let shimmerColor: ColorRgb | ShimmerColorGradient\n          if (this.#shimmer.color === COLOR_INHERIT) {\n            shimmerColor = this.color\n          } else if (Array.isArray(this.#shimmer.color[0])) {\n            // It's a gradient - use as is.\n            shimmerColor = this.#shimmer.color as ShimmerColorGradient\n          } else {\n            // It's a single color - convert to RGB.\n            shimmerColor = toRgb(this.#shimmer.color as ColorValue)\n          }\n\n          displayText = applyShimmer(displayText, this.#shimmer, {\n            color: shimmerColor,\n            direction: this.#shimmer.mode,\n          })\n        }\n\n        // Apply indentation\n        if (this.#indentation && displayText) {\n          displayText = this.#indentation + displayText\n        }\n\n        return displayText\n      }\n\n      /**\n       * Show a status message without stopping the spinner.\n       * Outputs the symbol and message to stderr, then continues spinning.\n       */\n      #showStatusAndKeepSpinning(symbolType: SymbolType, args: unknown[]) {\n        let text = args.at(0)\n        let extras: unknown[]\n        if (typeof text === 'string') {\n          extras = args.slice(1)\n        } else {\n          extras = args\n          text = ''\n        }\n\n        const { LOG_SYMBOLS, logger } = /*@__PURE__*/ require('./logger.js')\n        // Note: Status messages always go to stderr.\n        logger.error(`${LOG_SYMBOLS[symbolType]} ${text}`, ...extras)\n        return this\n      }\n\n      /**\n       * Update the spinner's displayed text.\n       * Rebuilds display text and triggers render.\n       * @private\n       */\n      #updateSpinnerText() {\n        // Call the parent class's text setter, which triggers render.\n        super.text = this.#buildDisplayText()\n      }\n\n      /**\n       * Show a debug message without stopping the spinner (only if debug mode enabled).\n       * Outputs to stderr and continues spinning.\n       */\n      debug(...args: unknown[]) {\n        const { isDebug } = /*@__PURE__*/ require('./debug.js')\n        if (isDebug()) {\n          return this.#showStatusAndKeepSpinning('info', args)\n        }\n        return this\n      }\n\n      /**\n       * Show a debug message and stop the spinner (only if debug mode enabled).\n       * Auto-clears the spinner line before displaying the message.\n       */\n      debugAndStop(...args: unknown[]) {\n        const { isDebug } = /*@__PURE__*/ require('./debug.js')\n        if (isDebug()) {\n          return this.#apply('info', args)\n        }\n        return this\n      }\n\n      /**\n       * Decrease indentation level.\n       * Pass 0 to reset indentation to zero.\n       * @param spaces - Number of spaces to remove (default: 2)\n       */\n      dedent(spaces?: number) {\n        // Pass 0 to reset indentation\n        if (spaces === 0) {\n          this.#indentation = ''\n        } else {\n          const amount = spaces ?? 2\n          const newLength = Math.max(0, this.#indentation.length - amount)\n          this.#indentation = this.#indentation.slice(0, newLength)\n        }\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Alias for success() (shorter name).\n       * DESIGN DECISION: Unlike yocto-spinner, our done() does NOT stop the spinner.\n       * Use doneAndStop() if you want to stop the spinner.\n       */\n      done(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('success', args)\n      }\n\n      /**\n       * Show a done message and stop the spinner.\n       * Auto-clears the spinner line before displaying the success message.\n       */\n      doneAndStop(...args: unknown[]) {\n        return this.#apply('success', args)\n      }\n\n      /**\n       * Show a failure message without stopping the spinner.\n       * DESIGN DECISION: Unlike yocto-spinner, our fail() does NOT stop the spinner.\n       * This allows displaying errors while continuing to spin.\n       * Use failAndStop() if you want to stop the spinner.\n       */\n      fail(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('fail', args)\n      }\n\n      /**\n       * Show a failure message and stop the spinner.\n       * Auto-clears the spinner line before displaying the error message.\n       */\n      failAndStop(...args: unknown[]) {\n        return this.#apply('error', args)\n      }\n\n      /**\n       * Increase indentation level.\n       * Pass 0 to reset indentation to zero.\n       * @param spaces - Number of spaces to add (default: 2)\n       */\n      indent(spaces?: number) {\n        // Pass 0 to reset indentation\n        if (spaces === 0) {\n          this.#indentation = ''\n        } else {\n          const amount = spaces ?? 2\n          this.#indentation += ' '.repeat(amount)\n        }\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Show an info message without stopping the spinner.\n       * Outputs to stderr and continues spinning.\n       */\n      info(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('info', args)\n      }\n\n      /**\n       * Show an info message and stop the spinner.\n       * Auto-clears the spinner line before displaying the message.\n       */\n      infoAndStop(...args: unknown[]) {\n        return this.#apply('info', args)\n      }\n\n      /**\n       * Log a message to stdout without stopping the spinner.\n       * Unlike other methods, this outputs to stdout for data logging.\n       */\n      log(...args: unknown[]) {\n        const { logger } = /*@__PURE__*/ require('./logger.js')\n        logger.log(...args)\n        return this\n      }\n\n      /**\n       * Log a message and stop the spinner.\n       * Auto-clears the spinner line before displaying the message.\n       */\n      logAndStop(...args: unknown[]) {\n        return this.#apply('stop', args)\n      }\n\n      /**\n       * Update progress information displayed with the spinner.\n       * Shows a progress bar with percentage and optional unit label.\n       * @param current - Current progress value\n       * @param total - Total progress value\n       * @param unit - Optional unit label (e.g., 'files', 'items')\n       */\n      progress = (\n        current: number,\n        total: number,\n        unit?: string | undefined,\n      ) => {\n        this.#progress = {\n          __proto__: null,\n          current,\n          total,\n          ...(unit ? { unit } : {}),\n        } as ProgressInfo\n        this.#updateSpinnerText()\n        return this\n      }\n\n      /**\n       * Increment progress by a specified amount.\n       * Updates the progress bar displayed with the spinner.\n       * @param amount - Amount to increment (default: 1)\n       */\n      progressStep(amount: number = 1) {\n        if (this.#progress) {\n          const newCurrent = this.#progress.current + amount\n          this.#progress = {\n            __proto__: null,\n            current: Math.max(0, Math.min(newCurrent, this.#progress.total)),\n            total: this.#progress.total,\n            ...(this.#progress.unit ? { unit: this.#progress.unit } : {}),\n          } as ProgressInfo\n          this.#updateSpinnerText()\n        }\n        return this\n      }\n\n      /**\n       * Start the spinner animation with optional text.\n       * Begins displaying the animated spinner.\n       * @param text - Optional text to display with the spinner\n       */\n      start(...args: unknown[]) {\n        if (args.length) {\n          const text = args.at(0)\n          const normalized = normalizeText(text)\n          // We clear this.text on start when `text` is falsy because yocto-spinner\n          // will not clear it otherwise.\n          if (!normalized) {\n            this.#baseText = ''\n            super.text = ''\n          } else {\n            this.#baseText = normalized\n          }\n        }\n\n        this.#updateSpinnerText()\n        return this.#apply('start', args)\n      }\n\n      /**\n       * Log a main step message to stderr without stopping the spinner.\n       * Adds a blank line before the message for visual separation.\n       * Aligns with logger.step() to use stderr for status messages.\n       */\n      step(...args: unknown[]) {\n        const text = args[0]\n        const { logger } = /*@__PURE__*/ require('./logger.js')\n        if (typeof text === 'string') {\n          // Add blank line before step for visual separation.\n          logger.error('')\n          // Use error (stderr) to align with logger.step() default stream.\n          logger.error(text, ...args.slice(1))\n        }\n        return this\n      }\n\n      /**\n       * Log an indented substep message to stderr without stopping the spinner.\n       * Adds 2-space indentation to the message.\n       * Aligns with logger.substep() to use stderr for status messages.\n       */\n      substep(...args: unknown[]) {\n        const text = args[0]\n        if (typeof text === 'string') {\n          // Add 2-space indent for substep.\n          const { logger } = /*@__PURE__*/ require('./logger.js')\n          // Use error (stderr) to align with logger.substep() default stream.\n          logger.error(`  ${text}`, ...args.slice(1))\n        }\n        return this\n      }\n\n      /**\n       * Stop the spinner animation and clear internal state.\n       * Auto-clears the spinner line via yocto-spinner.stop().\n       * Resets progress, shimmer, and text state.\n       * @param text - Optional final text to display after stopping\n       */\n      stop(...args: unknown[]) {\n        // Clear internal state.\n        this.#baseText = ''\n        this.#progress = undefined\n        // Reset shimmer animation state if shimmer is enabled.\n        if (this.#shimmer) {\n          this.#shimmer.currentDir = DIR_LTR\n          this.#shimmer.step = 0\n        }\n        // Call parent stop first (clears screen, sets isSpinning = false).\n        const result = this.#apply('stop', args)\n        // Then clear text to avoid blank frame render.\n        // This is safe now because isSpinning is false.\n        super.text = ''\n        return result\n      }\n\n      /**\n       * Show a success message without stopping the spinner.\n       * DESIGN DECISION: Unlike yocto-spinner, our success() does NOT stop the spinner.\n       * This allows displaying success messages while continuing to spin for multi-step operations.\n       * Use successAndStop() if you want to stop the spinner.\n       */\n      success(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('success', args)\n      }\n\n      /**\n       * Show a success message and stop the spinner.\n       * Auto-clears the spinner line before displaying the success message.\n       */\n      successAndStop(...args: unknown[]) {\n        return this.#apply('success', args)\n      }\n\n      /**\n       * Get or set the spinner text.\n       * When called with no arguments, returns the current text.\n       * When called with text, updates the display and returns the spinner.\n       * @param value - Text to display (omit to get current text)\n       * @returns Current text (getter) or this spinner (setter)\n       */\n      text(): string\n      text(value: string): Spinner\n      text(value?: string): string | Spinner {\n        // biome-ignore lint/complexity/noArguments: Function overload for getter/setter pattern.\n        if (arguments.length === 0) {\n          // Getter: return current base text\n          return this.#baseText\n        }\n        // Setter: update base text and refresh display\n        this.#baseText = value ?? ''\n        this.#updateSpinnerText()\n        return this as unknown as Spinner\n      }\n\n      /**\n       * Show a warning message without stopping the spinner.\n       * Outputs to stderr and continues spinning.\n       */\n      warn(...args: unknown[]) {\n        return this.#showStatusAndKeepSpinning('warn', args)\n      }\n\n      /**\n       * Show a warning message and stop the spinner.\n       * Auto-clears the spinner line before displaying the warning message.\n       */\n      warnAndStop(...args: unknown[]) {\n        return this.#apply('warning', args)\n      }\n\n      /**\n       * Toggle shimmer effect or update shimmer configuration.\n       * Preserves shimmer config when toggling off, allowing easy re-enable.\n       * Supports partial config updates to tweak specific properties.\n       *\n       * @param enabledOrConfig - Boolean to toggle, partial config to update, or direction string\n       * @returns This spinner for chaining\n       *\n       * @example\n       * // Toggle off (preserves config for later re-enable)\n       * spinner.shimmer(false)\n       *\n       * // Toggle on (restores saved config or uses defaults)\n       * spinner.shimmer(true)\n       *\n       * // Update specific properties\n       * spinner.shimmer({ speed: 0.5 })\n       * spinner.shimmer({ color: [255, 0, 0] })\n       *\n       * // Set direction\n       * spinner.shimmer('rtl')\n       */\n      shimmer(\n        enabledOrConfig:\n          | boolean\n          | Partial<ShimmerConfig>\n          | ShimmerDirection\n          | undefined,\n      ): Spinner {\n        if (enabledOrConfig === false) {\n          // Disable shimmer but preserve config.\n          this.#shimmer = undefined\n        } else if (enabledOrConfig === true) {\n          // Re-enable with saved config or defaults.\n          if (this.#shimmerSavedConfig) {\n            // Restore saved config.\n            this.#shimmer = { ...this.#shimmerSavedConfig }\n          } else {\n            // Create default config.\n            this.#shimmer = {\n              color: COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: DIR_LTR,\n              speed: 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        } else if (typeof enabledOrConfig === 'string') {\n          // Direction string - update existing or create new.\n          if (this.#shimmer) {\n            // Update existing shimmer direction.\n            this.#shimmer = {\n              ...this.#shimmer,\n              mode: enabledOrConfig,\n            }\n            this.#shimmerSavedConfig = this.#shimmer\n          } else if (this.#shimmerSavedConfig) {\n            // Restore and update.\n            this.#shimmer = {\n              ...this.#shimmerSavedConfig,\n              mode: enabledOrConfig,\n            }\n            this.#shimmerSavedConfig = this.#shimmer\n          } else {\n            // Create new with direction.\n            this.#shimmer = {\n              color: COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: enabledOrConfig,\n              speed: 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        } else if (enabledOrConfig && typeof enabledOrConfig === 'object') {\n          // Partial config update - merge with existing or saved config.\n          const partialConfig = {\n            __proto__: null,\n            ...enabledOrConfig,\n          } as Partial<ShimmerConfig>\n\n          if (this.#shimmer) {\n            // Update existing shimmer.\n            this.#shimmer = {\n              ...this.#shimmer,\n              ...(partialConfig.color !== undefined\n                ? { color: partialConfig.color }\n                : {}),\n              ...(partialConfig.dir !== undefined\n                ? { mode: partialConfig.dir }\n                : {}),\n              ...(partialConfig.speed !== undefined\n                ? { speed: partialConfig.speed }\n                : {}),\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          } else if (this.#shimmerSavedConfig) {\n            // Restore and update.\n            this.#shimmer = {\n              ...this.#shimmerSavedConfig,\n              ...(partialConfig.color !== undefined\n                ? { color: partialConfig.color }\n                : {}),\n              ...(partialConfig.dir !== undefined\n                ? { mode: partialConfig.dir }\n                : {}),\n              ...(partialConfig.speed !== undefined\n                ? { speed: partialConfig.speed }\n                : {}),\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          } else {\n            // Create new with partial config.\n            this.#shimmer = {\n              color: partialConfig.color ?? COLOR_INHERIT,\n              currentDir: DIR_LTR,\n              mode: partialConfig.dir ?? DIR_LTR,\n              speed: partialConfig.speed ?? 1 / 3,\n              step: 0,\n            } as ShimmerInfo\n            this.#shimmerSavedConfig = this.#shimmer\n          }\n        }\n\n        this.#updateSpinnerText()\n        return this as unknown as Spinner\n      }\n    } as unknown as {\n      new (options?: SpinnerOptions | undefined): Spinner\n    }\n    // Add aliases.\n    Object.defineProperties(_Spinner.prototype, {\n      error: desc(_Spinner.prototype.fail),\n      errorAndStop: desc(_Spinner.prototype.failAndStop),\n      warning: desc(_Spinner.prototype.warn),\n      warningAndStop: desc(_Spinner.prototype.warnAndStop),\n    })\n    _defaultSpinner = CI\n      ? ciSpinner\n      : (getCliSpinners('socket') as SpinnerStyle)\n  }\n  return new _Spinner({\n    spinner: _defaultSpinner,\n    ...options,\n  })\n}\n\nlet _spinner: ReturnType<typeof Spinner> | undefined\n/**\n * Get the default spinner instance.\n * Lazily creates the spinner to avoid circular dependencies during module initialization.\n */\nexport function getDefaultSpinner(): ReturnType<typeof Spinner> {\n  if (_spinner === undefined) {\n    _spinner = Spinner()\n  }\n  return _spinner\n}\n\n/**\n * @deprecated Use `getDefaultSpinner()` function instead for better tree-shaking and to avoid circular dependencies.\n */\nexport const spinner = /* @__PURE__ */ (() => {\n  // Lazy initialization to prevent circular dependency issues during module loading.\n  let _lazySpinner: ReturnType<typeof Spinner> | undefined\n  return new Proxy({} as ReturnType<typeof Spinner>, {\n    get(_target, prop) {\n      if (_lazySpinner === undefined) {\n        _lazySpinner = Spinner()\n      }\n      const value = _lazySpinner[prop as keyof ReturnType<typeof Spinner>]\n      return typeof value === 'function' ? value.bind(_lazySpinner) : value\n    },\n  })\n})()\n\nexport type WithSpinnerOptions<T> = {\n  message: string\n  operation: () => Promise<T>\n  spinner?: Spinner | undefined\n}\n\n/**\n * Execute an async operation with spinner lifecycle management.\n * Ensures spinner.stop() is always called via try/finally, even if the operation throws.\n *\n * @param options - Configuration object\n * @param options.message - Message to display while spinner is running\n * @param options.operation - Async function to execute\n * @param options.spinner - Optional spinner instance (if not provided, no spinner is used)\n * @returns Result of the operation\n * @throws Re-throws any error from operation after stopping spinner\n *\n * @example\n * import { spinner, withSpinner } from '@socketsecurity/registry/lib/spinner'\n *\n * // With spinner instance\n * await withSpinner({\n *   message: 'Processing\u2026',\n *   operation: async () => {\n *     return await processData()\n *   },\n *   spinner\n * })\n *\n * // Without spinner instance (no-op)\n * await withSpinner({\n *   message: 'Processing\u2026',\n *   operation: async () => {\n *     return await processData()\n *   }\n * })\n */\nexport async function withSpinner<T>(\n  options: WithSpinnerOptions<T>,\n): Promise<T> {\n  const { message, operation, spinner } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerOptions<T>\n\n  if (!spinner) {\n    return await operation()\n  }\n\n  spinner.start(message)\n  try {\n    return await operation()\n  } finally {\n    spinner.stop()\n  }\n}\n\nexport type WithSpinnerRestoreOptions<T> = {\n  operation: () => Promise<T>\n  spinner?: Spinner | undefined\n  wasSpinning: boolean\n}\n\n/**\n * Execute an async operation with conditional spinner restart.\n * Useful when you need to temporarily stop a spinner for an operation,\n * then restore it to its previous state.\n *\n * @param options - Configuration object\n * @param options.operation - Async function to execute\n * @param options.spinner - Optional spinner instance to manage\n * @param options.wasSpinning - Whether spinner was spinning before\n * @returns Result of the operation\n * @throws Re-throws any error from operation after restoring spinner state\n *\n * @example\n * import { spinner, withSpinnerRestore } from '@socketsecurity/registry/lib/spinner'\n *\n * const wasSpinning = spinner.isSpinning\n * spinner.stop()\n *\n * const result = await withSpinnerRestore({\n *   operation: async () => {\n *     // Do work without spinner\n *     return await someOperation()\n *   },\n *   spinner,\n *   wasSpinning\n * })\n */\nexport async function withSpinnerRestore<T>(\n  options: WithSpinnerRestoreOptions<T>,\n): Promise<T> {\n  const { operation, spinner, wasSpinning } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerRestoreOptions<T>\n\n  try {\n    return await operation()\n  } finally {\n    if (spinner && wasSpinning) {\n      spinner.start()\n    }\n  }\n}\n\nexport type WithSpinnerSyncOptions<T> = {\n  message: string\n  operation: () => T\n  spinner?: Spinner | undefined\n}\n\n/**\n * Execute a synchronous operation with spinner lifecycle management.\n * Ensures spinner.stop() is always called via try/finally, even if the operation throws.\n *\n * @param options - Configuration object\n * @param options.message - Message to display while spinner is running\n * @param options.operation - Function to execute\n * @param options.spinner - Optional spinner instance (if not provided, no spinner is used)\n * @returns Result of the operation\n * @throws Re-throws any error from operation after stopping spinner\n *\n * @example\n * import { spinner, withSpinnerSync} from '@socketsecurity/registry/lib/spinner'\n *\n * const result = withSpinnerSync({\n *   message: 'Processing\u2026',\n *   operation: () => {\n *     return processDataSync()\n *   },\n *   spinner\n * })\n */\nexport function withSpinnerSync<T>(options: WithSpinnerSyncOptions<T>): T {\n  const { message, operation, spinner } = {\n    __proto__: null,\n    ...options,\n  } as WithSpinnerSyncOptions<T>\n\n  if (!spinner) {\n    return operation()\n  }\n\n  spinner.start(message)\n  try {\n    return operation()\n  } finally {\n    spinner.stop()\n  }\n}\n"],
+  "mappings": "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",
   "names": ["yoctoSpinner", "options", "spinner"]
 }

package/dist/stdio/prompts.js

@@ -61,11 +61,11 @@ function wrapPrompt(inquirerPrompt) {
     return typeof result === "string" ? result.trim() : result;
   };
 }
-const confirmExport = require("../../external/@inquirer/confirm");
-const inputExport = require("../../external/@inquirer/input");
-const passwordExport = require("../../external/@inquirer/password");
-const searchExport = require("../../external/@inquirer/search");
-const selectExport = require("../../external/@inquirer/select");
+const confirmExport = require("../external/@inquirer/confirm");
+const inputExport = require("../external/@inquirer/input");
+const passwordExport = require("../external/@inquirer/password");
+const searchExport = require("../external/@inquirer/search");
+const selectExport = require("../external/@inquirer/select");
 const confirmRaw = confirmExport.default ?? confirmExport;
 const inputRaw = inputExport.default ?? inputExport;
 const passwordRaw = passwordExport.default ?? passwordExport;

package/dist/stdio/prompts.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/stdio/prompts.ts"],
-  "sourcesContent": ["/**\n * @fileoverview User prompt utilities for interactive scripts.\n * Provides inquirer.js integration with spinner support and context handling.\n */\n\nimport { getAbortSignal, getSpinner } from '#constants/process'\n\nconst abortSignal = getAbortSignal()\nconst spinner = getSpinner()\n\n// Type definitions\n\nexport interface Choice<Value = unknown> {\n  value: Value\n  disabled?: boolean | string | undefined\n  description?: string | undefined\n  name?: string | undefined\n  short?: string | undefined\n}\n\n// Duplicated from @inquirer/type - InquirerContext\n// This is the minimal context interface used by Inquirer prompts\ninterface InquirerContext {\n  signal?: AbortSignal | undefined\n  input?: NodeJS.ReadableStream | undefined\n  output?: NodeJS.WritableStream | undefined\n  clearPromptOnDone?: boolean | undefined\n}\n\nexport type Context = import('../objects').Remap<\n  InquirerContext & {\n    spinner?: import('../spinner').Spinner | undefined\n  }\n>\n\n// Duplicated from @inquirer/select - Separator\n// A separator object used in select/checkbox prompts to create visual separators\n// This type definition ensures the Separator type is available in published packages\ndeclare class SeparatorType {\n  readonly separator: string\n  readonly type: 'separator'\n  constructor(separator?: string)\n}\n\nexport type Separator = SeparatorType\n\n/**\n * Wrap an inquirer prompt with spinner handling and signal injection.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function wrapPrompt<T = unknown>(\n  inquirerPrompt: (...args: unknown[]) => Promise<T>,\n): (...args: unknown[]) => Promise<T | undefined> {\n  return async (...args) => {\n    const origContext = (args.length > 1 ? args[1] : undefined) as\n      | Context\n      | undefined\n    const { spinner: contextSpinner, ...contextWithoutSpinner } =\n      origContext ?? ({} as Context)\n    const spinnerInstance =\n      contextSpinner !== undefined ? contextSpinner : spinner\n    const signal = abortSignal\n    if (origContext) {\n      args[1] = {\n        signal,\n        ...contextWithoutSpinner,\n      }\n    } else {\n      args[1] = { signal }\n    }\n    const wasSpinning = !!spinnerInstance?.isSpinning\n    spinnerInstance?.stop()\n    let result: unknown\n    try {\n      result = await inquirerPrompt(...args)\n    } catch (e) {\n      if (e instanceof TypeError) {\n        throw e\n      }\n    }\n    if (wasSpinning) {\n      spinnerInstance.start()\n    }\n    return (typeof result === 'string' ? result.trim() : result) as\n      | T\n      | undefined\n  }\n}\n\n// c8 ignore start - Third-party inquirer library requires and exports not testable in isolation.\nconst confirmExport = /*@__PURE__*/ require('../../external/@inquirer/confirm')\nconst inputExport = /*@__PURE__*/ require('../../external/@inquirer/input')\nconst passwordExport = /*@__PURE__*/ require('../../external/@inquirer/password')\nconst searchExport = /*@__PURE__*/ require('../../external/@inquirer/search')\nconst selectExport = /*@__PURE__*/ require('../../external/@inquirer/select')\nconst confirmRaw = confirmExport.default ?? confirmExport\nconst inputRaw = inputExport.default ?? inputExport\nconst passwordRaw = passwordExport.default ?? passwordExport\nconst searchRaw = searchExport.default ?? searchExport\nconst selectRaw = selectExport.default ?? selectExport\nconst ActualSeparator = selectExport.Separator\n// c8 ignore stop\n\nexport const confirm: typeof confirmRaw = wrapPrompt(confirmRaw)\nexport const input: typeof inputRaw = wrapPrompt(inputRaw)\nexport const password: typeof passwordRaw = wrapPrompt(passwordRaw)\nexport const search: typeof searchRaw = wrapPrompt(searchRaw)\nexport const select: typeof selectRaw = wrapPrompt(selectRaw)\nexport { ActualSeparator as Separator }\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAA2C;AAE3C,MAAM,kBAAc,+BAAe;AACnC,MAAM,cAAU,2BAAW;AAAA;AA0CpB,SAAS,WACd,gBACgD;AAChD,SAAO,UAAU,SAAS;AACxB,UAAM,cAAe,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI;AAGjD,UAAM,EAAE,SAAS,gBAAgB,GAAG,sBAAsB,IACxD,eAAgB,CAAC;AACnB,UAAM,kBACJ,mBAAmB,SAAY,iBAAiB;AAClD,UAAM,SAAS;AACf,QAAI,aAAa;AACf,WAAK,CAAC,IAAI;AAAA,QACR;AAAA,QACA,GAAG;AAAA,MACL;AAAA,IACF,OAAO;AACL,WAAK,CAAC,IAAI,EAAE,OAAO;AAAA,IACrB;AACA,UAAM,cAAc,CAAC,CAAC,iBAAiB;AACvC,qBAAiB,KAAK;AACtB,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,eAAe,GAAG,IAAI;AAAA,IACvC,SAAS,GAAG;AACV,UAAI,aAAa,WAAW;AAC1B,cAAM;AAAA,MACR;AAAA,IACF;AACA,QAAI,aAAa;AACf,sBAAgB,MAAM;AAAA,IACxB;AACA,WAAQ,OAAO,WAAW,WAAW,OAAO,KAAK,IAAI;AAAA,EAGvD;AACF;AAGA,MAAM,gBAA8B,QAAQ,kCAAkC;AAC9E,MAAM,cAA4B,QAAQ,gCAAgC;AAC1E,MAAM,iBAA+B,QAAQ,mCAAmC;AAChF,MAAM,eAA6B,QAAQ,iCAAiC;AAC5E,MAAM,eAA6B,QAAQ,iCAAiC;AAC5E,MAAM,aAAa,cAAc,WAAW;AAC5C,MAAM,WAAW,YAAY,WAAW;AACxC,MAAM,cAAc,eAAe,WAAW;AAC9C,MAAM,YAAY,aAAa,WAAW;AAC1C,MAAM,YAAY,aAAa,WAAW;AAC1C,MAAM,kBAAkB,aAAa;AAG9B,MAAM,UAA6B,2BAAW,UAAU;AACxD,MAAM,QAAyB,2BAAW,QAAQ;AAClD,MAAM,WAA+B,2BAAW,WAAW;AAC3D,MAAM,SAA2B,2BAAW,SAAS;AACrD,MAAM,SAA2B,2BAAW,SAAS;",
+  "sourcesContent": ["/**\n * @fileoverview User prompt utilities for interactive scripts.\n * Provides inquirer.js integration with spinner support and context handling.\n */\n\nimport { getAbortSignal, getSpinner } from '#constants/process'\n\nconst abortSignal = getAbortSignal()\nconst spinner = getSpinner()\n\n// Type definitions\n\nexport interface Choice<Value = unknown> {\n  value: Value\n  disabled?: boolean | string | undefined\n  description?: string | undefined\n  name?: string | undefined\n  short?: string | undefined\n}\n\n// Duplicated from @inquirer/type - InquirerContext\n// This is the minimal context interface used by Inquirer prompts\ninterface InquirerContext {\n  signal?: AbortSignal | undefined\n  input?: NodeJS.ReadableStream | undefined\n  output?: NodeJS.WritableStream | undefined\n  clearPromptOnDone?: boolean | undefined\n}\n\nexport type Context = import('../objects').Remap<\n  InquirerContext & {\n    spinner?: import('../spinner').Spinner | undefined\n  }\n>\n\n// Duplicated from @inquirer/select - Separator\n// A separator object used in select/checkbox prompts to create visual separators\n// This type definition ensures the Separator type is available in published packages\ndeclare class SeparatorType {\n  readonly separator: string\n  readonly type: 'separator'\n  constructor(separator?: string)\n}\n\nexport type Separator = SeparatorType\n\n/**\n * Wrap an inquirer prompt with spinner handling and signal injection.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function wrapPrompt<T = unknown>(\n  inquirerPrompt: (...args: unknown[]) => Promise<T>,\n): (...args: unknown[]) => Promise<T | undefined> {\n  return async (...args) => {\n    const origContext = (args.length > 1 ? args[1] : undefined) as\n      | Context\n      | undefined\n    const { spinner: contextSpinner, ...contextWithoutSpinner } =\n      origContext ?? ({} as Context)\n    const spinnerInstance =\n      contextSpinner !== undefined ? contextSpinner : spinner\n    const signal = abortSignal\n    if (origContext) {\n      args[1] = {\n        signal,\n        ...contextWithoutSpinner,\n      }\n    } else {\n      args[1] = { signal }\n    }\n    const wasSpinning = !!spinnerInstance?.isSpinning\n    spinnerInstance?.stop()\n    let result: unknown\n    try {\n      result = await inquirerPrompt(...args)\n    } catch (e) {\n      if (e instanceof TypeError) {\n        throw e\n      }\n    }\n    if (wasSpinning) {\n      spinnerInstance.start()\n    }\n    return (typeof result === 'string' ? result.trim() : result) as\n      | T\n      | undefined\n  }\n}\n\n// c8 ignore start - Third-party inquirer library requires and exports not testable in isolation.\nconst confirmExport = /*@__PURE__*/ require('../external/@inquirer/confirm')\nconst inputExport = /*@__PURE__*/ require('../external/@inquirer/input')\nconst passwordExport = /*@__PURE__*/ require('../external/@inquirer/password')\nconst searchExport = /*@__PURE__*/ require('../external/@inquirer/search')\nconst selectExport = /*@__PURE__*/ require('../external/@inquirer/select')\nconst confirmRaw = confirmExport.default ?? confirmExport\nconst inputRaw = inputExport.default ?? inputExport\nconst passwordRaw = passwordExport.default ?? passwordExport\nconst searchRaw = searchExport.default ?? searchExport\nconst selectRaw = selectExport.default ?? selectExport\nconst ActualSeparator = selectExport.Separator\n// c8 ignore stop\n\nexport const confirm: typeof confirmRaw = wrapPrompt(confirmRaw)\nexport const input: typeof inputRaw = wrapPrompt(inputRaw)\nexport const password: typeof passwordRaw = wrapPrompt(passwordRaw)\nexport const search: typeof searchRaw = wrapPrompt(searchRaw)\nexport const select: typeof selectRaw = wrapPrompt(selectRaw)\nexport { ActualSeparator as Separator }\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAA2C;AAE3C,MAAM,kBAAc,+BAAe;AACnC,MAAM,cAAU,2BAAW;AAAA;AA0CpB,SAAS,WACd,gBACgD;AAChD,SAAO,UAAU,SAAS;AACxB,UAAM,cAAe,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI;AAGjD,UAAM,EAAE,SAAS,gBAAgB,GAAG,sBAAsB,IACxD,eAAgB,CAAC;AACnB,UAAM,kBACJ,mBAAmB,SAAY,iBAAiB;AAClD,UAAM,SAAS;AACf,QAAI,aAAa;AACf,WAAK,CAAC,IAAI;AAAA,QACR;AAAA,QACA,GAAG;AAAA,MACL;AAAA,IACF,OAAO;AACL,WAAK,CAAC,IAAI,EAAE,OAAO;AAAA,IACrB;AACA,UAAM,cAAc,CAAC,CAAC,iBAAiB;AACvC,qBAAiB,KAAK;AACtB,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,eAAe,GAAG,IAAI;AAAA,IACvC,SAAS,GAAG;AACV,UAAI,aAAa,WAAW;AAC1B,cAAM;AAAA,MACR;AAAA,IACF;AACA,QAAI,aAAa;AACf,sBAAgB,MAAM;AAAA,IACxB;AACA,WAAQ,OAAO,WAAW,WAAW,OAAO,KAAK,IAAI;AAAA,EAGvD;AACF;AAGA,MAAM,gBAA8B,QAAQ,+BAA+B;AAC3E,MAAM,cAA4B,QAAQ,6BAA6B;AACvE,MAAM,iBAA+B,QAAQ,gCAAgC;AAC7E,MAAM,eAA6B,QAAQ,8BAA8B;AACzE,MAAM,eAA6B,QAAQ,8BAA8B;AACzE,MAAM,aAAa,cAAc,WAAW;AAC5C,MAAM,WAAW,YAAY,WAAW;AACxC,MAAM,cAAc,eAAe,WAAW;AAC9C,MAAM,YAAY,aAAa,WAAW;AAC1C,MAAM,YAAY,aAAa,WAAW;AAC1C,MAAM,kBAAkB,aAAa;AAG9B,MAAM,UAA6B,2BAAW,UAAU;AACxD,MAAM,QAAyB,2BAAW,QAAQ;AAClD,MAAM,WAA+B,2BAAW,WAAW;AAC3D,MAAM,SAA2B,2BAAW,SAAS;AACrD,MAAM,SAA2B,2BAAW,SAAS;",
   "names": []
 }

package/dist/streams.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/streams.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Stream processing utilities with streaming-iterables integration.\n * Provides async stream handling and transformation functions.\n */\n\nimport type { IterationOptions } from './promises'\nimport { normalizeIterationOptions, pRetry } from './promises'\n\nlet _streamingIterables:\n  | {\n      parallelMap: <T, U>(\n        concurrency: number,\n        mapper: (item: T) => Promise<U>,\n        iterable: Iterable<T> | AsyncIterable<T>,\n      ) => AsyncIterable<U>\n      transform: <T, U>(\n        concurrency: number,\n        mapper: (item: T) => Promise<U>,\n        iterable: Iterable<T> | AsyncIterable<T>,\n      ) => AsyncIterable<U>\n    }\n  | undefined\n/**\n * Get the streaming-iterables module.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getStreamingIterables() {\n  if (_streamingIterables === undefined) {\n    _streamingIterables = /*@__PURE__*/ require('../external/streaming-iterables')\n  }\n  return _streamingIterables\n}\n\n/**\n * Execute a function for each item in an iterable in parallel.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function parallelEach<T>(\n  iterable: Iterable<T> | AsyncIterable<T>,\n  func: (item: T) => Promise<unknown>,\n  options?: number | IterationOptions,\n): Promise<void> {\n  for await (const _ of parallelMap(iterable, func, options)) {\n    /* empty block */\n  }\n}\n\n/**\n * Map over an iterable in parallel with concurrency control.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function parallelMap<T, U>(\n  iterable: Iterable<T> | AsyncIterable<T>,\n  func: (item: T) => Promise<U>,\n  options?: number | IterationOptions,\n): AsyncIterable<U> {\n  const streamingIterables = getStreamingIterables()\n  const opts = normalizeIterationOptions(options)\n  const result = streamingIterables?.parallelMap(\n    opts.concurrency,\n    async (item: T) => {\n      const result = await pRetry((...args: unknown[]) => func(args[0] as T), {\n        ...opts.retries,\n        args: [item],\n      })\n      return result as U\n    },\n    iterable,\n  )\n  return result as AsyncIterable<U>\n}\n\n/**\n * Transform an iterable with a function.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function transform<T, U>(\n  iterable: Iterable<T> | AsyncIterable<T>,\n  func: (item: T) => Promise<U>,\n  options?: number | IterationOptions,\n): AsyncIterable<U> {\n  const streamingIterables = getStreamingIterables()\n  const opts = normalizeIterationOptions(options)\n  const result = streamingIterables?.transform(\n    opts.concurrency,\n    async (item: T) => {\n      const result = await pRetry((...args: unknown[]) => func(args[0] as T), {\n        ...opts.retries,\n        args: [item],\n      })\n      return result as U\n    },\n    iterable,\n  )\n  return result as AsyncIterable<U>\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAAkD;AAElD,IAAI;AAAA;AAmBJ,SAAS,wBAAwB;AAC/B,MAAI,wBAAwB,QAAW;AACrC,0BAAoC,QAAQ,iCAAiC;AAAA,EAC/E;AACA,SAAO;AACT;AAAA;AAMA,eAAsB,aACpB,UACA,MACA,SACe;AACf,mBAAiB,KAAK,4BAAY,UAAU,MAAM,OAAO,GAAG;AAAA,EAE5D;AACF;AAAA;AAMO,SAAS,YACd,UACA,MACA,SACkB;AAClB,QAAM,qBAAqB,sCAAsB;AACjD,QAAM,WAAO,2CAA0B,OAAO;AAC9C,QAAM,SAAS,oBAAoB;AAAA,IACjC,KAAK;AAAA,IACL,OAAO,SAAY;AACjB,YAAMA,UAAS,UAAM,wBAAO,IAAI,SAAoB,KAAK,KAAK,CAAC,CAAM,GAAG;AAAA,QACtE,GAAG,KAAK;AAAA,QACR,MAAM,CAAC,IAAI;AAAA,MACb,CAAC;AACD,aAAOA;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACA,SAAO;AACT;AAAA;AAMO,SAAS,UACd,UACA,MACA,SACkB;AAClB,QAAM,qBAAqB,sCAAsB;AACjD,QAAM,WAAO,2CAA0B,OAAO;AAC9C,QAAM,SAAS,oBAAoB;AAAA,IACjC,KAAK;AAAA,IACL,OAAO,SAAY;AACjB,YAAMA,UAAS,UAAM,wBAAO,IAAI,SAAoB,KAAK,KAAK,CAAC,CAAM,GAAG;AAAA,QACtE,GAAG,KAAK;AAAA,QACR,MAAM,CAAC,IAAI;AAAA,MACb,CAAC;AACD,aAAOA;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACA,SAAO;AACT;",
+  "sourcesContent": ["/**\n * @fileoverview Stream processing utilities with streaming-iterables integration.\n * Provides async stream handling and transformation functions.\n */\n\nimport type { IterationOptions } from './promises'\nimport { normalizeIterationOptions, pRetry } from './promises'\n\nlet _streamingIterables:\n  | {\n      parallelMap: <T, U>(\n        concurrency: number,\n        mapper: (item: T) => Promise<U>,\n        iterable: Iterable<T> | AsyncIterable<T>,\n      ) => AsyncIterable<U>\n      transform: <T, U>(\n        concurrency: number,\n        mapper: (item: T) => Promise<U>,\n        iterable: Iterable<T> | AsyncIterable<T>,\n      ) => AsyncIterable<U>\n    }\n  | undefined\n/**\n * Get the streaming-iterables module.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getStreamingIterables() {\n  if (_streamingIterables === undefined) {\n    _streamingIterables = /*@__PURE__*/ require('./external/streaming-iterables')\n  }\n  return _streamingIterables\n}\n\n/**\n * Execute a function for each item in an iterable in parallel.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function parallelEach<T>(\n  iterable: Iterable<T> | AsyncIterable<T>,\n  func: (item: T) => Promise<unknown>,\n  options?: number | IterationOptions,\n): Promise<void> {\n  for await (const _ of parallelMap(iterable, func, options)) {\n    /* empty block */\n  }\n}\n\n/**\n * Map over an iterable in parallel with concurrency control.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function parallelMap<T, U>(\n  iterable: Iterable<T> | AsyncIterable<T>,\n  func: (item: T) => Promise<U>,\n  options?: number | IterationOptions,\n): AsyncIterable<U> {\n  const streamingIterables = getStreamingIterables()\n  const opts = normalizeIterationOptions(options)\n  const result = streamingIterables?.parallelMap(\n    opts.concurrency,\n    async (item: T) => {\n      const result = await pRetry((...args: unknown[]) => func(args[0] as T), {\n        ...opts.retries,\n        args: [item],\n      })\n      return result as U\n    },\n    iterable,\n  )\n  return result as AsyncIterable<U>\n}\n\n/**\n * Transform an iterable with a function.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function transform<T, U>(\n  iterable: Iterable<T> | AsyncIterable<T>,\n  func: (item: T) => Promise<U>,\n  options?: number | IterationOptions,\n): AsyncIterable<U> {\n  const streamingIterables = getStreamingIterables()\n  const opts = normalizeIterationOptions(options)\n  const result = streamingIterables?.transform(\n    opts.concurrency,\n    async (item: T) => {\n      const result = await pRetry((...args: unknown[]) => func(args[0] as T), {\n        ...opts.retries,\n        args: [item],\n      })\n      return result as U\n    },\n    iterable,\n  )\n  return result as AsyncIterable<U>\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAAkD;AAElD,IAAI;AAAA;AAmBJ,SAAS,wBAAwB;AAC/B,MAAI,wBAAwB,QAAW;AACrC,0BAAoC,QAAQ,gCAAgC;AAAA,EAC9E;AACA,SAAO;AACT;AAAA;AAMA,eAAsB,aACpB,UACA,MACA,SACe;AACf,mBAAiB,KAAK,4BAAY,UAAU,MAAM,OAAO,GAAG;AAAA,EAE5D;AACF;AAAA;AAMO,SAAS,YACd,UACA,MACA,SACkB;AAClB,QAAM,qBAAqB,sCAAsB;AACjD,QAAM,WAAO,2CAA0B,OAAO;AAC9C,QAAM,SAAS,oBAAoB;AAAA,IACjC,KAAK;AAAA,IACL,OAAO,SAAY;AACjB,YAAMA,UAAS,UAAM,wBAAO,IAAI,SAAoB,KAAK,KAAK,CAAC,CAAM,GAAG;AAAA,QACtE,GAAG,KAAK;AAAA,QACR,MAAM,CAAC,IAAI;AAAA,MACb,CAAC;AACD,aAAOA;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACA,SAAO;AACT;AAAA;AAMO,SAAS,UACd,UACA,MACA,SACkB;AAClB,QAAM,qBAAqB,sCAAsB;AACjD,QAAM,WAAO,2CAA0B,OAAO;AAC9C,QAAM,SAAS,oBAAoB;AAAA,IACjC,KAAK;AAAA,IACL,OAAO,SAAY;AACjB,YAAMA,UAAS,UAAM,wBAAO,IAAI,SAAoB,KAAK,KAAK,CAAC,CAAM,GAAG;AAAA,QACtE,GAAG,KAAK;AAAA,QACR,MAAM,CAAC,IAAI;AAAA,MACb,CAAC;AACD,aAAOA;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACA,SAAO;AACT;",
   "names": ["result"]
 }