@socketsecurity/cli-with-sentry 1.1.15 → 1.1.17

package/external/@socketsecurity/registry/lib/packages.js

@@ -37,6 +37,11 @@ const identSymbol = Symbol.for('indent')
 const newlineSymbol = Symbol.for('newline')
 
 let _cacache
+/**
+ * Get the cacache module for cache operations.
+ * @returns {Object} The cacache module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getCacache() {
   if (_cacache === undefined) {
@@ -46,6 +51,11 @@ function getCacache() {
 }
 
 let _EditablePackageJsonClass
+/**
+ * Get the EditablePackageJson class for package.json manipulation.
+ * @returns {Class} The EditablePackageJson class.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getEditablePackageJsonClass() {
   if (_EditablePackageJsonClass === undefined) {
@@ -461,6 +471,11 @@ function getValidateNpmPackageName() {
   return _validateNpmPackageName
 }
 
+/**
+ * Collect licenses that are incompatible (copyleft).
+ * @param {Object[]} licenseNodes - Array of license nodes.
+ * @returns {Object[]} Array of incompatible license nodes.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function collectIncompatibleLicenses(licenseNodes) {
   const result = []
@@ -473,6 +488,11 @@ function collectIncompatibleLicenses(licenseNodes) {
   return result
 }
 
+/**
+ * Collect warnings from license nodes.
+ * @param {Object[]} licenseNodes - Array of license nodes.
+ * @returns {string[]} Array of warning messages.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function collectLicenseWarnings(licenseNodes) {
   const warnings = new Map()
@@ -488,6 +508,11 @@ function collectLicenseWarnings(licenseNodes) {
   return [...warnings.values()]
 }
 
+/**
+ * Create an AST node from a raw node.
+ * @param {Object} rawNode - Raw node data.
+ * @returns {Object} AST node.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function createAstNode(rawNode) {
   return ObjectHasOwn(rawNode, 'license')
@@ -495,6 +520,11 @@ function createAstNode(rawNode) {
     : createBinaryOperationNode(rawNode)
 }
 
+/**
+ * Create a binary operation AST node.
+ * @param {Object} rawNode - Raw node with left, right, and conjunction.
+ * @returns {Object} Binary operation node.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function createBinaryOperationNode(rawNode) {
   let left
@@ -523,11 +553,23 @@ function createBinaryOperationNode(rawNode) {
   }
 }
 
+/**
+ * Create a license AST node.
+ * @param {Object} rawNode - Raw license node data.
+ * @returns {Object} License node.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function createLicenseNode(rawNode) {
   return { __proto__: null, ...rawNode, type: LICENSE_NODE_TYPE }
 }
 
+/**
+ * Create a package.json object for a Socket registry package.
+ * @param {string} sockRegPkgName - Socket registry package name.
+ * @param {string} directory - Directory path.
+ * @param {Object} [options] - Creation options.
+ * @returns {Object} Package.json object.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function createPackageJson(sockRegPkgName, directory, options) {
   const {
@@ -606,6 +648,13 @@ function createPackageJson(sockRegPkgName, directory, options) {
   }
 }
 
+/**
+ * Extract a package to a destination directory.
+ * @param {string} pkgNameOrId - Package name or identifier.
+ * @param {Object} [options] - Extraction options.
+ * @param {Function} [callback] - Callback to execute after extraction.
+ * @returns {Promise<void>} Resolves when extraction is complete.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function extractPackage(pkgNameOrId, options, callback) {
   if (arguments.length === 2 && typeof options === 'function') {
@@ -645,6 +694,12 @@ async function extractPackage(pkgNameOrId, options, callback) {
   }
 }
 
+/**
+ * Fetch the manifest for a package.
+ * @param {string} pkgNameOrId - Package name or identifier.
+ * @param {Object} [options] - Fetch options.
+ * @returns {Promise<Object|null>} Package manifest or null if failed.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function fetchPackageManifest(pkgNameOrId, options) {
   const pacoteOptions = {
@@ -679,6 +734,12 @@ async function fetchPackageManifest(pkgNameOrId, options) {
     : null
 }
 
+/**
+ * Fetch the packument (package document) for a package.
+ * @param {string} pkgNameOrId - Package name or identifier.
+ * @param {Object} [options] - Fetch options.
+ * @returns {Promise<Object|null>} Package packument or null if failed.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function fetchPackagePackument(pkgNameOrId, options) {
   const pacote = getPacote()
@@ -694,6 +755,12 @@ async function fetchPackagePackument(pkgNameOrId, options) {
   return null
 }
 
+/**
+ * Find package extensions for a given package.
+ * @param {string} pkgName - Package name.
+ * @param {string} pkgVer - Package version.
+ * @returns {Object} Package extensions.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function findPackageExtensions(pkgName, pkgVer) {
   let result
@@ -715,6 +782,12 @@ function findPackageExtensions(pkgName, pkgVer) {
   return result
 }
 
+/**
+ * Find types for a subpath in package exports.
+ * @param {Object} entryExports - Package exports object.
+ * @param {string} subpath - Subpath to find types for.
+ * @returns {string|undefined} Types path if found.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function findTypesForSubpath(entryExports, subpath) {
   const queue = [entryExports]
@@ -752,12 +825,22 @@ function findTypesForSubpath(entryExports, subpath) {
   return undefined
 }
 
+/**
+ * Get the release tag for a version.
+ * @param {string} version - Version string.
+ * @returns {string} Release tag.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getReleaseTag(version) {
   const semver = getSemver()
   return semver.prerelease(version)?.join('.') ?? 'latest'
 }
 
+/**
+ * Extract details from a repository URL.
+ * @param {string} [repoUrl=''] - Repository URL.
+ * @returns {Object} Repository details with host, user, and project.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getRepoUrlDetails(repoUrl = '') {
   const userAndRepo = repoUrl.replace(/^.+github.com\//, '').split('/')
@@ -767,6 +850,11 @@ function getRepoUrlDetails(repoUrl = '') {
   return { user, project }
 }
 
+/**
+ * Get subpaths from package exports.
+ * @param {Object} entryExports - Package exports object.
+ * @returns {string[]} Array of subpaths.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getSubpaths(entryExports) {
   const result = []

package/external/@socketsecurity/registry/lib/path.js

@@ -7,6 +7,11 @@ const slashRegExp = /[/\\]/
 const nodeModulesPathRegExp = /(?:^|[/\\])node_modules(?:[/\\]|$)/
 
 let _buffer
+/**
+ * Lazily load the buffer module.
+ * @returns {import('buffer')} The Node.js buffer module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getBuffer() {
   if (_buffer === undefined) {
@@ -18,6 +23,11 @@ function getBuffer() {
 }
 
 let _path
+/**
+ * Lazily load the path module.
+ * @returns {import('path')} The Node.js path module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getPath() {
   if (_path === undefined) {
@@ -29,6 +39,11 @@ function getPath() {
 }
 
 let _url
+/**
+ * Lazily load the url module.
+ * @returns {import('url')} The Node.js url module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getUrl() {
   if (_url === undefined) {
@@ -39,17 +54,32 @@ function getUrl() {
   return _url
 }
 
+/**
+ * Check if a path contains node_modules directory.
+ * @param {string | Buffer | URL} pathLike - The path to check.
+ * @returns {boolean} True if the path contains node_modules.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isNodeModules(pathLike) {
   const filepath = pathLikeToString(pathLike)
   return nodeModulesPathRegExp.test(filepath)
 }
 
+/**
+ * Check if a value is a valid file path (absolute or relative).
+ * @param {any} pathLike - The value to check.
+ * @returns {boolean} True if the value is a valid path.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isPath(pathLike) {
   return isRelative(pathLike) || getPath().isAbsolute(pathLike)
 }
 
+/**
+ * Check if a path is relative (starts with . or ..).
+ * @param {any} pathLike - The path to check.
+ * @returns {boolean} True if the path is relative.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isRelative(pathLike) {
   const filepath = pathLikeToString(pathLike)
@@ -73,6 +103,11 @@ function isRelative(pathLike) {
   return false
 }
 
+/**
+ * Normalize a path by converting backslashes to forward slashes and collapsing segments.
+ * @param {string | Buffer | URL} pathLike - The path to normalize.
+ * @returns {string} The normalized path.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function normalizePath(pathLike) {
   const filepath = pathLikeToString(pathLike)
@@ -142,12 +177,17 @@ function normalizePath(pathLike) {
   return prefix + collapsed
 }
 
+/**
+ * Convert a path-like value to a string.
+ * @param {string | Buffer | URL | any} pathLike - The path-like value to convert.
+ * @returns {string} The path as a string.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function pathLikeToString(pathLike) {
   if (typeof pathLike === 'string') {
     return pathLike
   }
-  const Buffer = getBuffer()
+  const { Buffer } = getBuffer()
   if (Buffer.isBuffer(pathLike)) {
     return pathLike.toString('utf8')
   }
@@ -158,12 +198,22 @@ function pathLikeToString(pathLike) {
   return String(pathLike)
 }
 
+/**
+ * Split a path into an array of segments.
+ * @param {string | Buffer | URL} pathLike - The path to split.
+ * @returns {string[]} Array of path segments.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function splitPath(pathLike) {
   const filepath = pathLikeToString(pathLike)
   return filepath.split(slashRegExp)
 }
 
+/**
+ * Remove leading ./ or ../ from a path.
+ * @param {string | Buffer | URL} pathLike - The path to trim.
+ * @returns {string} The path without leading dot-slash.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function trimLeadingDotSlash(pathLike) {
   const filepath = pathLikeToString(pathLike)

package/external/@socketsecurity/registry/lib/promises.js

@@ -3,6 +3,11 @@
 const { arrayChunk } = /*@__PURE__*/ require('./arrays')
 
 let _timers
+/**
+ * Get the timers/promises module.
+ * @returns {Object} The timers/promises module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getTimers() {
   if (_timers === undefined) {
@@ -13,6 +18,11 @@ function getTimers() {
   return _timers
 }
 
+/**
+ * Normalize options for iteration functions.
+ * @param {Object} [options] - Iteration options.
+ * @returns {Object} Normalized iteration options.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function normalizeIterationOptions(options) {
   const {
@@ -32,6 +42,11 @@ function normalizeIterationOptions(options) {
   }
 }
 
+/**
+ * Normalize options for retry functionality.
+ * @param {Object|number} [options] - Retry options or number of retries.
+ * @returns {Object} Normalized retry options.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function normalizeRetryOptions(options) {
   const {
@@ -72,6 +87,11 @@ function normalizeRetryOptions(options) {
   }
 }
 
+/**
+ * Resolve retry options from various input formats.
+ * @param {Object|number} [options] - Options object or number of retries.
+ * @returns {Object} Resolved retry options object.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function resolveRetryOptions(options) {
   return {
@@ -80,6 +100,13 @@ function resolveRetryOptions(options) {
   }
 }
 
+/**
+ * Execute an async function for each array element with concurrency control.
+ * @param {any[]} array - Array to iterate over.
+ * @param {Function} callbackFn - Async function to execute for each element.
+ * @param {Object} [options] - Iteration options including concurrency and retries.
+ * @returns {Promise<void>} Resolves when all iterations complete.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function pEach(array, callbackFn, options) {
   const iterOpts = normalizeIterationOptions(options)
@@ -90,6 +117,13 @@ async function pEach(array, callbackFn, options) {
   )
 }
 
+/**
+ * Filter an array asynchronously with concurrency control.
+ * @param {any[]} array - Array to filter.
+ * @param {Function} callbackFn - Async predicate function.
+ * @param {Object} [options] - Iteration options including concurrency and retries.
+ * @returns {Promise<any[]>} Filtered array.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function pFilter(array, callbackFn, options) {
   const iterOpts = normalizeIterationOptions(options)
@@ -102,6 +136,13 @@ async function pFilter(array, callbackFn, options) {
   ).flat()
 }
 
+/**
+ * Process chunked arrays with an async callback.
+ * @param {any[][]} chunks - Array of array chunks.
+ * @param {Function} callbackFn - Async function to execute for each element.
+ * @param {Object} [options] - Retry options.
+ * @returns {Promise<void>} Resolves when all chunks are processed.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function pEachChunk(chunks, callbackFn, options) {
   const retryOpts = normalizeRetryOptions(options)
@@ -122,6 +163,13 @@ async function pEachChunk(chunks, callbackFn, options) {
   }
 }
 
+/**
+ * Filter chunked arrays with an async predicate.
+ * @param {any[][]} chunks - Array of array chunks.
+ * @param {Function} callbackFn - Async predicate function.
+ * @param {Object} [options] - Retry options.
+ * @returns {Promise<any[][]>} Filtered chunks.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function pFilterChunk(chunks, callbackFn, options) {
   const retryOpts = normalizeRetryOptions(options)
@@ -149,6 +197,13 @@ async function pFilterChunk(chunks, callbackFn, options) {
   return filteredChunks
 }
 
+/**
+ * Retry an async function with exponential backoff.
+ * @param {Function} callbackFn - Async function to retry.
+ * @param {Object} [options] - Retry options including retries, backoff, and delays.
+ * @returns {Promise<any>} Result of the successful function call.
+ * @throws {Error} The last error if all retries fail.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function pRetry(callbackFn, options) {
   const {

package/external/@socketsecurity/registry/lib/regexps.js

@@ -5,6 +5,11 @@
 // MIT License
 // Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
 
+/**
+ * Escape special characters in a string for use in a regular expression.
+ * @param {string} str - The string to escape.
+ * @returns {string} The escaped string safe for use in a RegExp.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function escapeRegExp(str) {
   // Escape characters with special meaning either inside or outside character sets.

package/external/@socketsecurity/registry/lib/sorts.js

@@ -1,6 +1,12 @@
 'use strict'
 
 let _localeCompare
+/**
+ * Compare two strings using locale-aware comparison.
+ * @param {string} x - First string to compare.
+ * @param {string} y - Second string to compare.
+ * @returns {number} Negative if x < y, positive if x > y, 0 if equal.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function localeCompare(x, y) {
   if (_localeCompare === undefined) {
@@ -11,6 +17,12 @@ function localeCompare(x, y) {
 }
 
 let _naturalCompare
+/**
+ * Compare two strings using natural sorting (numeric-aware, case-insensitive).
+ * @param {string} x - First string to compare.
+ * @param {string} y - Second string to compare.
+ * @returns {number} Negative if x < y, positive if x > y, 0 if equal.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function naturalCompare(x, y) {
   if (_naturalCompare === undefined) {
@@ -34,6 +46,11 @@ function naturalCompare(x, y) {
 }
 
 let _naturalSorter
+/**
+ * Sort an array using natural comparison.
+ * @param {any[]} arrayToSort - The array to sort.
+ * @returns {any} The fast-sort instance with natural comparison.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function naturalSorter(arrayToSort) {
   if (_naturalSorter === undefined) {

package/external/@socketsecurity/registry/lib/spawn.js

@@ -3,9 +3,16 @@
 const { isArray: ArrayIsArray } = Array
 const { hasOwn: ObjectHasOwn, keys: ObjectKeys } = Object
 
+const { getOwn } = /*@__PURE__*/ require('./objects')
 const { stripAnsi } = /*@__PURE__*/ require('./strings')
 
+const windowsScriptExtRegExp = /\.(?:cmd|bat|ps1)$/i
+
 let _child_process
+/**
+ * Lazily load the child_process module.
+ * @returns {import('child_process')} The Node.js child_process module.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getChildProcess() {
   if (_child_process === undefined) {
@@ -16,15 +23,49 @@ function getChildProcess() {
   return _child_process
 }
 
-let _spawn
+let _npmCliPromiseSpawn
+/**
+ * Lazily load the promise-spawn module for async process spawning.
+ * @returns {Function} The promise-spawn module.
+ */
 /*@__NO_SIDE_EFFECTS__*/
-function getSpawn() {
-  if (_spawn === undefined) {
-    _spawn = /*@__PURE__*/ require('../external/@npmcli/promise-spawn')
+function getNpmcliPromiseSpawn() {
+  if (_npmCliPromiseSpawn === undefined) {
+    _npmCliPromiseSpawn = /*@__PURE__*/ require('../external/@npmcli/promise-spawn')
   }
-  return _spawn
+  return _npmCliPromiseSpawn
 }
 
+let _path
+/**
+ * Lazily load the path module to avoid Webpack errors.
+ * @returns {import('path')} The Node.js path module.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+function getPath() {
+  if (_path === undefined) {
+    // Use non-'node:' prefixed require to avoid Webpack errors.
+    // eslint-disable-next-line n/prefer-node-protocol
+    _path = /*@__PURE__*/ require('path')
+  }
+  return _path
+}
+
+/**
+ * Check if a value is a spawn error.
+ * @param {any} value - The value to check.
+ * @returns {value is SpawnError} True if the value is a spawn error.
+ * @typedef {Object} SpawnError
+ * @property {string[]} args - Command arguments.
+ * @property {string} cmd - Command that was run.
+ * @property {number} code - Exit code.
+ * @property {string} name - Error name.
+ * @property {string} message - Error message.
+ * @property {AbortSignal | null} signal - Abort signal.
+ * @property {string} stack - Stack trace.
+ * @property {string | Buffer} stderr - Standard error output.
+ * @property {string | Buffer} stdout - Standard output.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isSpawnError(value) {
   return (
@@ -39,6 +80,12 @@ function isSpawnError(value) {
   )
 }
 
+/**
+ * Check if stdio configuration matches a specific type.
+ * @param {string | string[] | readonly string[]} stdio - The stdio configuration.
+ * @param {import('child_process').IOType | 'ipc' | Array<import('child_process').IOType | 'ipc'>} type - The type to check.
+ * @returns {boolean} True if the stdio matches the type.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isStdioType(stdio, type) {
   return (
@@ -52,6 +99,11 @@ function isStdioType(stdio, type) {
   )
 }
 
+/**
+ * Strip ANSI escape codes from spawn result stdout and stderr.
+ * @param {{ stdout?: string; stderr?: string }} result - The spawn result.
+ * @returns {{ stdout?: string; stderr?: string }} The result with ANSI codes stripped.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function stripAnsiFromSpawnResult(result) {
   const { stderr, stdout } = result
@@ -65,7 +117,32 @@ function stripAnsiFromSpawnResult(result) {
 }
 
 /*@__NO_SIDE_EFFECTS__*/
+/**
+ * Spawn a child process with enhanced error handling and output capture.
+ * @template {SpawnOptions} O
+ * @param {string} cmd - The command to execute.
+ * @param {string[] | readonly string[]} [args=[]] - Arguments to pass to the command.
+ * @param {O} [options] - Spawn options.
+ * @param {Record<any, any>} [extra] - Additional data to include in the result.
+ * @returns {SpawnResult<O extends {stdioString: false} ? Buffer : string, typeof extra>} Command result with process handle.
+ * @typedef {import('./objects').Remap<import('child_process').SpawnOptions & {spinner?: import('./spinner').Spinner; stdioString?: boolean; stripAnsi?: boolean}>} SpawnOptions
+ * @typedef {Promise<SpawnStdioResult> & {process: import('child_process').ChildProcess; stdin: import('stream').Writable | null}} SpawnResult
+ * @typedef {{cmd: string; args: string[] | readonly string[]; code: number; signal: AbortSignal | null; stdout: string | Buffer; stderr: string | Buffer}} SpawnStdioResult
+ */
 function spawn(cmd, args, options, extra) {
+  // On Windows with shell: true, use just the command name, not the full path.
+  // When shell: true is used, Windows cmd.exe has issues executing full paths to
+  // .cmd/.bat files (e.g., 'C:\...\pnpm.cmd'), often resulting in ENOENT errors.
+  // Using just the command name (e.g., 'pnpm') allows cmd.exe to find it via PATH.
+  // See: https://github.com/nodejs/node/issues/3675
+  // Check for .cmd, .bat, .ps1 extensions that indicate a Windows script.
+  const shell = getOwn(options, 'shell')
+  const WIN32 = /*@__PURE__*/ require('./constants/win32')
+  if (WIN32 && shell && windowsScriptExtRegExp.test(cmd)) {
+    const path = getPath()
+    // Extract just the command name without path and extension.
+    cmd = path.basename(cmd, path.extname(cmd))
+  }
   const {
     spinner = /*@__PURE__*/ require('./constants/spinner'),
     stripAnsi: shouldStripAnsi = true,
@@ -81,8 +158,8 @@ function spawn(cmd, args, options, extra) {
   if (shouldStopSpinner) {
     spinner.stop()
   }
-  const spawn = getSpawn()
-  let spawnPromise = spawn(
+  const npmCliPromiseSpawn = getNpmcliPromiseSpawn()
+  let spawnPromise = npmCliPromiseSpawn(
     cmd,
     args,
     {
@@ -119,7 +196,28 @@ function spawn(cmd, args, options, extra) {
 }
 
 /*@__NO_SIDE_EFFECTS__*/
+/**
+ * Synchronously spawn a child process.
+ * @param {string} cmd - The command to execute.
+ * @param {string[] | readonly string[]} [args] - Arguments to pass to the command.
+ * @param {SpawnSyncOptions} [options] - Spawn options without spinner support.
+ * @returns {import('child_process').SpawnSyncReturns<string | Buffer>} Command result.
+ * @typedef {Omit<SpawnOptions, 'spinner'>} SpawnSyncOptions
+ */
 function spawnSync(cmd, args, options) {
+  // On Windows with shell: true, use just the command name, not the full path.
+  // When shell: true is used, Windows cmd.exe has issues executing full paths to
+  // .cmd/.bat files (e.g., 'C:\...\pnpm.cmd'), often resulting in ENOENT errors.
+  // Using just the command name (e.g., 'pnpm') allows cmd.exe to find it via PATH.
+  // See: https://github.com/nodejs/node/issues/3675
+  // Check for .cmd, .bat, .ps1 extensions that indicate a Windows script.
+  const shell = getOwn(options, 'shell')
+  const WIN32 = /*@__PURE__*/ require('./constants/win32')
+  if (WIN32 && shell && windowsScriptExtRegExp.test(cmd)) {
+    const path = getPath()
+    // Extract just the command name without path and extension.
+    cmd = path.basename(cmd, path.extname(cmd))
+  }
   const { stripAnsi: shouldStripAnsi = true, ...rawSpawnOptions } = {
     __proto__: null,
     ...options

package/external/@socketsecurity/registry/lib/streams.js

@@ -6,6 +6,11 @@ const {
 } = /*@__PURE__*/ require('./promises')
 
 let _streamingIterables
+/**
+ * Get the streaming-iterables module.
+ * @returns {Object} The streaming-iterables module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getStreamingIterables() {
   if (_streamingIterables === undefined) {
@@ -14,6 +19,13 @@ function getStreamingIterables() {
   return _streamingIterables
 }
 
+/**
+ * Execute a function for each item in an iterable in parallel.
+ * @param {AsyncIterable} iterable - The async iterable to process.
+ * @param {Function} func - Function to execute for each item.
+ * @param {Object} [options] - Iteration options including concurrency.
+ * @returns {Promise<void>} Resolves when all items are processed.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function parallelEach(iterable, func, options) {
   for await (const _ of parallelMap(iterable, func, options)) {
@@ -21,6 +33,13 @@ async function parallelEach(iterable, func, options) {
   }
 }
 
+/**
+ * Map over an iterable in parallel with concurrency control.
+ * @param {AsyncIterable} iterable - The async iterable to map.
+ * @param {Function} func - Mapping function.
+ * @param {Object} [options] - Iteration options including concurrency.
+ * @returns {AsyncIterable} Async iterable of mapped values.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function parallelMap(iterable, func, options) {
   const streamingIterables = getStreamingIterables()
@@ -36,6 +55,13 @@ function parallelMap(iterable, func, options) {
   )
 }
 
+/**
+ * Transform an iterable with a function.
+ * @param {AsyncIterable} iterable - The async iterable to transform.
+ * @param {Function} func - Transform function.
+ * @param {Object} [options] - Iteration options including concurrency.
+ * @returns {AsyncIterable} Transformed async iterable.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function transform(iterable, func, options) {
   const streamingIterables = getStreamingIterables()