@socketsecurity/cli-with-sentry 1.1.15 → 1.1.18

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

@@ -1,5 +1,6 @@
 'use strict'
 
+const { isArray: ArrayIsArray } = Array
 const { freeze: ObjectFreeze } = Object
 
 const { defaultIgnore, getGlobMatcher } = /*@__PURE__*/ require('./globs')
@@ -37,6 +38,105 @@ function getPath() {
   return _path
 }
 
+/**
+ * Find a file or directory by traversing up parent directories.
+ * @param {string | string[]} name - Name(s) to search for.
+ * @param {FindUpOptions} [options] - Search options.
+ * @returns {Promise<string | undefined>} Path to found file/directory.
+ * @typedef {{cwd?: string; onlyDirectories?: boolean; onlyFiles?: boolean; signal?: AbortSignal}} FindUpOptions
+ */
+/*@__NO_SIDE_EFFECTS__*/
+async function findUp(name, options) {
+  const {
+    cwd = process.cwd(),
+    signal = /*@__PURE__*/ require('./constants/abort-signal')
+  } = { __proto__: null, ...options }
+  let { onlyDirectories = false, onlyFiles = true } = {
+    __proto__: null,
+    ...options
+  }
+  if (onlyDirectories) {
+    onlyFiles = false
+  }
+  if (onlyFiles) {
+    onlyDirectories = false
+  }
+  const fs = getFs()
+  const path = getPath()
+  let dir = path.resolve(cwd)
+  const { root } = path.parse(dir)
+  const names = ArrayIsArray(name) ? name : [name]
+  while (dir && dir !== root) {
+    for (const n of names) {
+      if (signal?.aborted) {
+        return undefined
+      }
+      const thePath = path.join(dir, n)
+      try {
+        // eslint-disable-next-line no-await-in-loop
+        const stats = await fs.promises.stat(thePath)
+        if (!onlyDirectories && stats.isFile()) {
+          return thePath
+        }
+        if (!onlyFiles && stats.isDirectory()) {
+          return thePath
+        }
+      } catch {}
+    }
+    dir = path.dirname(dir)
+  }
+  return undefined
+}
+
+/**
+ * Synchronously find a file or directory by traversing up parent directories.
+ * @param {string | string[]} name - Name(s) to search for.
+ * @param {Omit<FindUpOptions, 'signal'>} [options] - Search options.
+ * @returns {string | undefined} Path to found file/directory.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+function findUpSync(name, options) {
+  const { cwd = process.cwd() } = { __proto__: null, ...options }
+  let { onlyDirectories = false, onlyFiles = true } = {
+    __proto__: null,
+    ...options
+  }
+  if (onlyDirectories) {
+    onlyFiles = false
+  }
+  if (onlyFiles) {
+    onlyDirectories = false
+  }
+  const fs = getFs()
+  const path = getPath()
+  let dir = path.resolve(cwd)
+  const { root } = path.parse(dir)
+  const names = ArrayIsArray(name) ? name : [name]
+  while (dir && dir !== root) {
+    for (const n of names) {
+      const thePath = path.join(dir, n)
+      try {
+        const stats = fs.statSync(thePath)
+        if (!onlyDirectories && stats.isFile()) {
+          return thePath
+        }
+        if (!onlyFiles && stats.isDirectory()) {
+          return thePath
+        }
+      } catch {}
+    }
+    dir = path.dirname(dir)
+  }
+  return undefined
+}
+
+/**
+ * Process directory entries and filter for directories.
+ * @param {import('fs').Dirent[]} dirents - Directory entries to process.
+ * @param {ReadDirOptions} [options] - Options for filtering and sorting.
+ * @returns {string[]} Array of directory names.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function innerReadDirNames(dirents, options) {
   const {
@@ -56,12 +156,24 @@ function innerReadDirNames(dirents, options) {
   return sort ? names.sort(naturalCompare) : names
 }
 
+/**
+ * Check if a path is a directory synchronously.
+ * @param {import('fs').PathLike} filepath - Path to check.
+ * @returns {boolean} True if the path is a directory.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isDirSync(filepath) {
   const fs = getFs()
   return fs.existsSync(filepath) && !!safeStatsSync(filepath)?.isDirectory()
 }
 
+/**
+ * Check if a directory is empty synchronously.
+ * @param {import('fs').PathLike} dirname - Directory path to check.
+ * @param {IsDirEmptyOptions} [options] - Options with ignore patterns.
+ * @returns {boolean} True if the directory is empty or only contains ignored files.
+ * @typedef {{ignore?: string[] | readonly string[]}} IsDirEmptyOptions
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isDirEmptySync(dirname, options) {
   const { ignore = defaultIgnore } = { __proto__: null, ...options }
@@ -85,6 +197,11 @@ function isDirEmptySync(dirname, options) {
   }
 }
 
+/**
+ * Check if a path is a symbolic link synchronously.
+ * @param {import('fs').PathLike} filepath - Path to check.
+ * @returns {boolean} True if the path is a symbolic link.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isSymLinkSync(filepath) {
   const fs = getFs()
@@ -94,6 +211,13 @@ function isSymLinkSync(filepath) {
   return false
 }
 
+/**
+ * Read directory names asynchronously with filtering and sorting.
+ * @param {import('fs').PathLike} dirname - Directory to read.
+ * @param {ReadDirOptions} [options] - Options for filtering and sorting.
+ * @returns {Promise<string[]>} Array of directory names.
+ * @typedef {{ignore?: string[] | readonly string[]; includeEmpty?: boolean; sort?: boolean}} ReadDirOptions
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function readDirNames(dirname, options) {
   const fs = getFs()
@@ -109,6 +233,12 @@ async function readDirNames(dirname, options) {
   return []
 }
 
+/**
+ * Read directory names synchronously with filtering and sorting.
+ * @param {import('fs').PathLike} dirname - Directory to read.
+ * @param {ReadDirOptions} [options] - Options for filtering and sorting.
+ * @returns {string[]} Array of directory names.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function readDirNamesSync(dirname, options) {
   const fs = getFs()
@@ -121,6 +251,12 @@ function readDirNamesSync(dirname, options) {
   return []
 }
 
+/**
+ * Read a file as binary data asynchronously.
+ * @param {import('fs').PathLike | import('fs/promises').FileHandle} filepath - Path to the file.
+ * @param {import('fs').ReadFileOptions} [options] - Read options.
+ * @returns {Promise<Buffer>} The file contents as a Buffer.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function readFileBinary(filepath, options) {
   const fs = getFs()
@@ -131,6 +267,12 @@ async function readFileBinary(filepath, options) {
   })
 }
 
+/**
+ * Read a file as UTF-8 text asynchronously.
+ * @param {import('fs').PathLike | import('fs/promises').FileHandle} filepath - Path to the file.
+ * @param {import('fs').ReadFileOptions} [options] - Read options.
+ * @returns {Promise<string>} The file contents as a string.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function readFileUtf8(filepath, options) {
   const fs = getFs()
@@ -141,6 +283,13 @@ async function readFileUtf8(filepath, options) {
   })
 }
 
+/**
+ * Read and parse a JSON file asynchronously.
+ * @param {import('fs').PathLike} filepath - Path to the JSON file.
+ * @param {ReadJsonOptions} [options] - Read and parse options.
+ * @returns {Promise<any>} The parsed JSON content.
+ * @typedef {{encoding?: string; throws?: boolean; reviver?: Function} & import('fs').ReadFileOptions} ReadJsonOptions
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function readJson(filepath, options) {
   if (typeof options === 'string') {
@@ -169,6 +318,12 @@ async function readJson(filepath, options) {
   })
 }
 
+/**
+ * Read and parse a JSON file synchronously.
+ * @param {import('fs').PathLike} filepath - Path to the JSON file.
+ * @param {ReadJsonOptions} [options] - Read and parse options.
+ * @returns {any} The parsed JSON content.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function readJsonSync(filepath, options) {
   if (typeof options === 'string') {
@@ -197,6 +352,12 @@ function readJsonSync(filepath, options) {
   })
 }
 
+/**
+ * Remove a file or directory asynchronously.
+ * @param {import('fs').PathLike} filepath - Path to remove.
+ * @param {import('fs').RmOptions} [options] - Remove options.
+ * @returns {Promise<void>}
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function remove(filepath, options) {
   // Attempt to workaround occasional ENOTEMPTY errors in Windows.
@@ -209,6 +370,12 @@ async function remove(filepath, options) {
   })
 }
 
+/**
+ * Remove a file or directory synchronously.
+ * @param {import('fs').PathLike} filepath - Path to remove.
+ * @param {import('fs').RmOptions} [options] - Remove options.
+ * @returns {void}
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function removeSync(filepath, options) {
   const fs = getFs()
@@ -219,6 +386,12 @@ function removeSync(filepath, options) {
   })
 }
 
+/**
+ * Safely read a file asynchronously, returning undefined on error.
+ * @param {import('fs').PathLike | import('fs/promises').FileHandle} filepath - Path to the file.
+ * @param {import('fs').ReadFileOptions | string} [options] - Read options or encoding.
+ * @returns {Promise<string | undefined>} The file contents or undefined if read fails.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function safeReadFile(filepath, options) {
   const fs = getFs()
@@ -232,6 +405,12 @@ async function safeReadFile(filepath, options) {
   return undefined
 }
 
+/**
+ * Safely get file stats synchronously, returning undefined on error.
+ * @param {import('fs').PathLike} filepath - Path to stat.
+ * @param {import('fs').StatSyncOptions} [options] - Stat options.
+ * @returns {import('fs').Stats | undefined} File stats or undefined if stat fails.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function safeStatsSync(filepath, options) {
   const fs = getFs()
@@ -245,6 +424,12 @@ function safeStatsSync(filepath, options) {
   return undefined
 }
 
+/**
+ * Safely read a file synchronously, returning undefined on error.
+ * @param {import('fs').PathOrFileDescriptor} filepath - Path to the file.
+ * @param {import('fs').ReadFileOptions | string} [options] - Read options or encoding.
+ * @returns {string | Buffer | undefined} The file contents or undefined if read fails.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function safeReadFileSync(filepath, options) {
   const fs = getFs()
@@ -258,6 +443,15 @@ function safeReadFileSync(filepath, options) {
   return undefined
 }
 
+/**
+ * Stringify JSON with custom formatting options.
+ * @param {any} json - The JSON object to stringify.
+ * @param {string} [EOL='\n'] - End of line character.
+ * @param {boolean} [finalEOL=true] - Whether to add final EOL.
+ * @param {Function | null} [replacer=null] - JSON replacer function.
+ * @param {number | string} [spaces=2] - Indentation spaces.
+ * @returns {string} The formatted JSON string.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function stringify(
   json,
@@ -271,6 +465,11 @@ function stringify(
   return `${str.replace(/\n/g, EOL)}${EOF}`
 }
 
+/**
+ * Generate a unique filepath by prepending underscores if the path exists.
+ * @param {import('fs').PathLike} filepath - The desired filepath.
+ * @returns {string} A unique filepath that doesn't exist.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function uniqueSync(filepath) {
   const fs = getFs()
@@ -283,6 +482,14 @@ function uniqueSync(filepath) {
   return path.join(dirname, basename)
 }
 
+/**
+ * Write JSON content to a file asynchronously with formatting.
+ * @param {import('fs').PathLike} filepath - Path to write to.
+ * @param {any} jsonContent - The JSON content to write.
+ * @param {WriteJsonOptions} [options] - Write and format options.
+ * @returns {Promise<void>}
+ * @typedef {{EOL?: string; finalEOL?: boolean; replacer?: Function; spaces?: number | string} & import('fs').WriteFileOptions} WriteJsonOptions
+ */
 /*@__NO_SIDE_EFFECTS__*/
 async function writeJson(filepath, jsonContent, options) {
   if (typeof options === 'string') {
@@ -301,6 +508,13 @@ async function writeJson(filepath, jsonContent, options) {
   })
 }
 
+/**
+ * Write JSON content to a file synchronously with formatting.
+ * @param {import('fs').PathLike} filepath - Path to write to.
+ * @param {any} jsonContent - The JSON content to write.
+ * @param {WriteJsonOptions} [options] - Write and format options.
+ * @returns {void}
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function writeJsonSync(filepath, jsonContent, options) {
   if (typeof options === 'string') {
@@ -320,15 +534,17 @@ function writeJsonSync(filepath, jsonContent, options) {
 }
 
 module.exports = {
+  findUp,
+  findUpSync,
   isDirSync,
   isDirEmptySync,
   isSymLinkSync,
+  readDirNames,
+  readDirNamesSync,
   readFileBinary,
   readFileUtf8,
   readJson,
   readJsonSync,
-  readDirNames,
-  readDirNamesSync,
   remove,
   removeSync,
   safeReadFile,

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

@@ -1,5 +1,10 @@
 'use strict'
 
+/**
+ * Wrap an async function to silently catch and ignore errors.
+ * @param {Function} fn - The async function to wrap.
+ * @returns {Function} The wrapped async function that returns undefined on error.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function silentWrapAsync(fn) {
   return async (...args) => {

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

@@ -36,7 +36,6 @@ const defaultIgnore = ObjectFreeze([
   '**/.eslintcache',
   '**/.nvm',
   '**/.tap',
-  '**/.tapci.yaml',
   '**/.vscode',
   '**/*.tsbuildinfo',
   '**/Thumbs.db',
@@ -45,6 +44,11 @@ const defaultIgnore = ObjectFreeze([
 ])
 
 let _picomatch
+/**
+ * Lazily load the picomatch module.
+ * @returns {import('picomatch')} The picomatch module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getPicomatch() {
   if (_picomatch === undefined) {
@@ -55,6 +59,11 @@ function getPicomatch() {
 }
 
 let _fastGlob
+/**
+ * Lazily load the fast-glob module.
+ * @returns {import('fast-glob')} The fast-glob module.
+ * @private
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getFastGlob() {
   if (_fastGlob === undefined) {
@@ -63,6 +72,12 @@ function getFastGlob() {
   return _fastGlob
 }
 
+/**
+ * Create a stream of license file paths matching glob patterns.
+ * @param {string} dirname - The directory to search in.
+ * @param {{ignore?: string[]; ignoreOriginals?: boolean; recursive?: boolean}} [options] - Glob options.
+ * @returns {import('stream').Stream} Stream of matching file paths.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function globStreamLicenses(dirname, options) {
   const {
@@ -99,6 +114,12 @@ function globStreamLicenses(dirname, options) {
 }
 
 const matcherCache = new Map()
+/**
+ * Get a cached glob matcher function.
+ * @param {string | string[]} glob - Glob pattern(s) to match.
+ * @param {Object} [options] - Picomatch options.
+ * @returns {Function} The glob matcher function.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function getGlobMatcher(glob, options) {
   const patterns = Array.isArray(glob) ? glob : [glob]

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

@@ -4,6 +4,11 @@ const { parse: JSONParse } = JSON
 
 const { stripBom } = /*@__PURE__*/ require('./strings')
 
+/**
+ * Check if a value is a Buffer instance.
+ * @param {any} x - The value to check.
+ * @returns {boolean} True if the value is a Buffer.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isBuffer(x) {
   if (!x || typeof x !== 'object' || typeof x.length !== 'number') {
@@ -20,6 +25,11 @@ function isBuffer(x) {
   return !!(typeof Ctor?.isBuffer === 'function' && Ctor.isBuffer(x))
 }
 
+/**
+ * Check if a value is a JSON primitive (null, boolean, number, or string).
+ * @param {any} value - The value to check.
+ * @returns {boolean} True if the value is a JSON primitive.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function isJsonPrimitive(value) {
   return (
@@ -30,6 +40,12 @@ function isJsonPrimitive(value) {
   )
 }
 
+/**
+ * Parse JSON content with error handling and BOM stripping.
+ * @param {string | Buffer} content - The JSON content to parse.
+ * @param {{filepath?: string; reviver?: Function; throws?: boolean}} [options] - Parse options.
+ * @returns {any} The parsed JSON object, or null if parsing fails and throws is false.
+ */
 /*@__NO_SIDE_EFFECTS__*/
 function jsonParse(content, options) {
   const { filepath, reviver, throws } = { __proto__: null, ...options }