@socketsecurity/lib 3.0.5 → 3.1.0

package/dist/fs.d.ts

@@ -653,21 +653,25 @@ export declare function safeDeleteSync(filepath: PathLike | PathLike[], options?
  * - Silently ignores EEXIST errors (directory already exists)
  * - Re-throws all other errors (permissions, invalid path, etc.)
  * - Works reliably in multi-process/concurrent scenarios
+ * - Defaults to recursive: true for convenient nested directory creation
  *
  * @param path - Directory path to create
- * @param options - Options including recursive and mode settings
+ * @param options - Options including recursive (default: true) and mode settings
  * @returns Promise that resolves when directory is created or already exists
  *
  * @example
  * ```ts
- * // Create a directory, no error if it exists
+ * // Create a directory recursively by default, no error if it exists
  * await safeMkdir('./config')
  *
- * // Create nested directories
- * await safeMkdir('./data/cache/temp', { recursive: true })
+ * // Create nested directories (recursive: true is the default)
+ * await safeMkdir('./data/cache/temp')
  *
  * // Create with specific permissions
  * await safeMkdir('./secure', { mode: 0o700 })
+ *
+ * // Explicitly disable recursive behavior
+ * await safeMkdir('./single-level', { recursive: false })
  * ```
  */
 /*@__NO_SIDE_EFFECTS__*/
@@ -681,20 +685,24 @@ export declare function safeMkdir(path: PathLike, options?: MakeDirectoryOptions
  * - Silently ignores EEXIST errors (directory already exists)
  * - Re-throws all other errors (permissions, invalid path, etc.)
  * - Works reliably in multi-process/concurrent scenarios
+ * - Defaults to recursive: true for convenient nested directory creation
  *
  * @param path - Directory path to create
- * @param options - Options including recursive and mode settings
+ * @param options - Options including recursive (default: true) and mode settings
  *
  * @example
  * ```ts
- * // Create a directory, no error if it exists
+ * // Create a directory recursively by default, no error if it exists
  * safeMkdirSync('./config')
  *
- * // Create nested directories
- * safeMkdirSync('./data/cache/temp', { recursive: true })
+ * // Create nested directories (recursive: true is the default)
+ * safeMkdirSync('./data/cache/temp')
  *
  * // Create with specific permissions
  * safeMkdirSync('./secure', { mode: 0o700 })
+ *
+ * // Explicitly disable recursive behavior
+ * safeMkdirSync('./single-level', { recursive: false })
  * ```
  */
 /*@__NO_SIDE_EFFECTS__*/

package/dist/fs.js

@@ -510,8 +510,9 @@ function safeDeleteSync(filepath, options) {
 // @__NO_SIDE_EFFECTS__
 async function safeMkdir(path, options) {
   const fs = /* @__PURE__ */ getFs();
+  const opts = { __proto__: null, recursive: true, ...options };
   try {
-    await fs.promises.mkdir(path, options);
+    await fs.promises.mkdir(path, opts);
   } catch (e) {
     if (typeof e === "object" && e !== null && "code" in e && e.code !== "EEXIST") {
       throw e;
@@ -521,8 +522,9 @@ async function safeMkdir(path, options) {
 // @__NO_SIDE_EFFECTS__
 function safeMkdirSync(path, options) {
   const fs = /* @__PURE__ */ getFs();
+  const opts = { __proto__: null, recursive: true, ...options };
   try {
-    fs.mkdirSync(path, options);
+    fs.mkdirSync(path, opts);
   } catch (e) {
     if (typeof e === "object" && e !== null && "code" in e && e.code !== "EEXIST") {
       throw e;

package/dist/fs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/fs.ts"],
-  "sourcesContent": ["/**\n * @fileoverview File system utilities with cross-platform path handling.\n * Provides enhanced fs operations, glob matching, and directory traversal functions.\n */\n\nimport type { Abortable } from 'events'\n\nimport type {\n  Dirent,\n  MakeDirectoryOptions,\n  ObjectEncodingOptions,\n  OpenMode,\n  PathLike,\n  StatSyncOptions,\n  WriteFileOptions,\n} from 'fs'\n\nimport { getAbortSignal } from '#constants/process'\n\nimport { isArray } from './arrays'\n\nconst abortSignal = getAbortSignal()\n\nimport { defaultIgnore, getGlobMatcher } from './globs'\nimport type { JsonReviver } from './json'\nimport { jsonParse } from './json'\nimport { objectFreeze, type Remap } from './objects'\nimport { normalizePath, pathLikeToString } from './path'\nimport { registerCacheInvalidation } from './paths/rewire'\nimport { naturalCompare } from './sorts'\n\n/**\n * Supported text encodings for Node.js Buffers.\n * Includes ASCII, UTF-8/16, base64, binary, and hexadecimal encodings.\n */\nexport type BufferEncoding =\n  | 'ascii'\n  | 'utf8'\n  | 'utf-8'\n  | 'utf16le'\n  | 'ucs2'\n  | 'ucs-2'\n  | 'base64'\n  | 'base64url'\n  | 'latin1'\n  | 'binary'\n  | 'hex'\n\n/**\n * Represents any valid JSON content type.\n */\nexport type JsonContent = unknown\n\n/**\n * Options for asynchronous `findUp` operations.\n */\nexport interface FindUpOptions {\n  /**\n   * Starting directory for the search.\n   * @default process.cwd()\n   */\n  cwd?: string | undefined\n  /**\n   * Only match directories, not files.\n   * @default false\n   */\n  onlyDirectories?: boolean | undefined\n  /**\n   * Only match files, not directories.\n   * @default true\n   */\n  onlyFiles?: boolean | undefined\n  /**\n   * Abort signal to cancel the search operation.\n   */\n  signal?: AbortSignal | undefined\n}\n\n/**\n * Options for synchronous `findUpSync` operations.\n */\nexport interface FindUpSyncOptions {\n  /**\n   * Starting directory for the search.\n   * @default process.cwd()\n   */\n  cwd?: string | undefined\n  /**\n   * Directory to stop searching at (inclusive).\n   * When provided, search will stop at this directory even if the root hasn't been reached.\n   */\n  stopAt?: string | undefined\n  /**\n   * Only match directories, not files.\n   * @default false\n   */\n  onlyDirectories?: boolean | undefined\n  /**\n   * Only match files, not directories.\n   * @default true\n   */\n  onlyFiles?: boolean | undefined\n}\n\n/**\n * Options for checking if a directory is empty.\n */\nexport interface IsDirEmptyOptions {\n  /**\n   * Glob patterns for files to ignore when checking emptiness.\n   * Files matching these patterns are not counted.\n   * @default defaultIgnore\n   */\n  ignore?: string[] | readonly string[] | undefined\n}\n\n/**\n * Options for read operations with abort support.\n */\nexport interface ReadOptions extends Abortable {\n  /**\n   * Character encoding to use for reading.\n   * @default 'utf8'\n   */\n  encoding?: BufferEncoding | string | undefined\n  /**\n   * File system flag for reading behavior.\n   * @default 'r'\n   */\n  flag?: string | undefined\n}\n\n/**\n * Options for reading directories with filtering and sorting.\n */\nexport interface ReadDirOptions {\n  /**\n   * Glob patterns for directories to ignore.\n   * @default undefined\n   */\n  ignore?: string[] | readonly string[] | undefined\n  /**\n   * Include empty directories in results.\n   * When `false`, empty directories are filtered out.\n   * @default true\n   */\n  includeEmpty?: boolean | undefined\n  /**\n   * Sort directory names alphabetically using natural sort order.\n   * @default true\n   */\n  sort?: boolean | undefined\n}\n\n/**\n * Options for reading files with encoding and abort support.\n * Can be either an options object, an encoding string, or null.\n */\nexport type ReadFileOptions =\n  | Remap<\n      ObjectEncodingOptions &\n        Abortable & {\n          flag?: OpenMode | undefined\n        }\n    >\n  | BufferEncoding\n  | null\n\n/**\n * Options for reading and parsing JSON files.\n */\nexport type ReadJsonOptions = Remap<\n  ReadFileOptions & {\n    /**\n     * Whether to throw errors on parse failure.\n     * When `false`, returns `undefined` on error instead of throwing.\n     * @default true\n     */\n    throws?: boolean | undefined\n    /**\n     * JSON reviver function to transform parsed values.\n     * Same as the second parameter to `JSON.parse()`.\n     */\n    reviver?: Parameters<typeof JSON.parse>[1] | undefined\n  }\n>\n\n/**\n * Options for file/directory removal operations.\n */\nexport interface RemoveOptions {\n  /**\n   * Force deletion even outside normally safe directories.\n   * When `false`, prevents deletion outside temp, cacache, and ~/.socket.\n   * @default true for safe directories, false otherwise\n   */\n  force?: boolean | undefined\n  /**\n   * Maximum number of retry attempts on failure.\n   * @default 3\n   */\n  maxRetries?: number | undefined\n  /**\n   * Recursively delete directories and contents.\n   * @default true\n   */\n  recursive?: boolean | undefined\n  /**\n   * Delay in milliseconds between retry attempts.\n   * @default 200\n   */\n  retryDelay?: number | undefined\n  /**\n   * Abort signal to cancel the operation.\n   */\n  signal?: AbortSignal | undefined\n}\n\n/**\n * Options for safe read operations that don't throw on errors.\n */\nexport interface SafeReadOptions extends ReadOptions {\n  /**\n   * Default value to return on read failure.\n   * If not provided, `undefined` is returned on error.\n   */\n  defaultValue?: unknown | undefined\n}\n\n/**\n * Options for write operations with encoding and mode control.\n */\nexport interface WriteOptions extends Abortable {\n  /**\n   * Character encoding for writing.\n   * @default 'utf8'\n   */\n  encoding?: BufferEncoding | string | undefined\n  /**\n   * File mode (permissions) to set.\n   * Uses standard Unix permission bits (e.g., 0o644).\n   * @default 0o666 (read/write for all, respecting umask)\n   */\n  mode?: number | undefined\n  /**\n   * File system flag for write behavior.\n   * @default 'w' (create or truncate)\n   */\n  flag?: string | undefined\n}\n\n/**\n * Options for writing JSON files with formatting control.\n */\nexport interface WriteJsonOptions extends WriteOptions {\n  /**\n   * End-of-line sequence to use.\n   * @default '\\n'\n   * @example\n   * ```ts\n   * // Windows-style line endings\n   * writeJson('data.json', data, { EOL: '\\r\\n' })\n   * ```\n   */\n  EOL?: string | undefined\n  /**\n   * Whether to add a final newline at end of file.\n   * @default true\n   */\n  finalEOL?: boolean | undefined\n  /**\n   * JSON replacer function to transform values during stringification.\n   * Same as the second parameter to `JSON.stringify()`.\n   */\n  replacer?: JsonReviver | undefined\n  /**\n   * Number of spaces for indentation, or string to use for indentation.\n   * @default 2\n   * @example\n   * ```ts\n   * // Use tabs instead of spaces\n   * writeJson('data.json', data, { spaces: '\\t' })\n   *\n   * // Use 4 spaces for indentation\n   * writeJson('data.json', data, { spaces: 4 })\n   * ```\n   */\n  spaces?: number | string | undefined\n}\n\nconst defaultRemoveOptions = objectFreeze({\n  __proto__: null,\n  force: true,\n  maxRetries: 3,\n  recursive: true,\n  retryDelay: 200,\n})\n\nlet _fs: typeof import('fs') | undefined\n/**\n * Lazily load the fs module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js fs module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFs() {\n  if (_fs === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n    _fs = /*@__PURE__*/ require('node:fs')\n  }\n  return _fs as typeof import('fs')\n}\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js path module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path as typeof import('path')\n}\n\n/**\n * Process directory entries and filter for directories.\n * Filters entries to include only directories, optionally excluding empty ones.\n * Applies ignore patterns and natural sorting.\n *\n * @param dirents - Directory entries from readdir\n * @param dirname - Parent directory path\n * @param options - Filtering and sorting options\n * @returns Array of directory names, optionally sorted\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction innerReadDirNames(\n  dirents: Dirent[],\n  dirname: string | undefined,\n  options?: ReadDirOptions | undefined,\n): string[] {\n  const {\n    ignore,\n    includeEmpty = true,\n    sort = true,\n  } = { __proto__: null, ...options } as ReadDirOptions\n  const path = getPath()\n  const names = dirents\n    .filter(\n      (d: Dirent) =>\n        d.isDirectory() &&\n        (includeEmpty ||\n          !isDirEmptySync(path.join(dirname || d.parentPath, d.name), {\n            ignore,\n          })),\n    )\n    .map((d: Dirent) => d.name)\n  return sort ? names.sort(naturalCompare) : names\n}\n\n/**\n * Stringify JSON with custom formatting options.\n * Formats JSON with configurable line endings and indentation.\n *\n * @param json - Value to stringify\n * @param EOL - End-of-line sequence\n * @param finalEOL - Whether to add final newline\n * @param replacer - JSON replacer function\n * @param spaces - Indentation spaces or string\n * @returns Formatted JSON string\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction stringify(\n  json: unknown,\n  EOL: string,\n  finalEOL: boolean,\n  replacer: JsonReviver | undefined,\n  spaces: number | string = 2,\n): string {\n  const EOF = finalEOL ? EOL : ''\n  const str = JSON.stringify(json, replacer, spaces)\n  return `${str.replace(/\\n/g, EOL)}${EOF}`\n}\n\n/**\n * Find a file or directory by traversing up parent directories.\n * Searches from the starting directory upward to the filesystem root.\n * Useful for finding configuration files or project roots.\n *\n * @param name - Filename(s) to search for\n * @param options - Search options including cwd and type filters\n * @returns Normalized absolute path if found, undefined otherwise\n *\n * @example\n * ```ts\n * // Find package.json starting from current directory\n * const pkgPath = await findUp('package.json')\n *\n * // Find any of multiple config files\n * const configPath = await findUp(['.config.js', '.config.json'])\n *\n * // Find a directory instead of file\n * const nodeModules = await findUp('node_modules', { onlyDirectories: true })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function findUp(\n  name: string | string[] | readonly string[],\n  options?: FindUpOptions | undefined,\n): Promise<string | undefined> {\n  const { cwd = process.cwd(), signal = abortSignal } = {\n    __proto__: null,\n    ...options,\n  } as FindUpOptions\n  let { onlyDirectories = false, onlyFiles = true } = {\n    __proto__: null,\n    ...options,\n  } as FindUpOptions\n  if (onlyDirectories) {\n    onlyFiles = false\n  }\n  if (onlyFiles) {\n    onlyDirectories = false\n  }\n  const fs = getFs()\n  const path = getPath()\n  let dir = path.resolve(cwd)\n  const { root } = path.parse(dir)\n  const names = isArray(name) ? name : [name as string]\n  while (dir && dir !== root) {\n    for (const n of names) {\n      if (signal?.aborted) {\n        return undefined\n      }\n      const thePath = path.join(dir, n)\n      try {\n        // eslint-disable-next-line no-await-in-loop\n        const stats = await fs.promises.stat(thePath)\n        if (!onlyDirectories && stats.isFile()) {\n          return normalizePath(thePath)\n        }\n        if (!onlyFiles && stats.isDirectory()) {\n          return normalizePath(thePath)\n        }\n      } catch {}\n    }\n    dir = path.dirname(dir)\n  }\n  return undefined\n}\n\n/**\n * Synchronously find a file or directory by traversing up parent directories.\n * Searches from the starting directory upward to the filesystem root or `stopAt` directory.\n * Useful for finding configuration files or project roots in synchronous contexts.\n *\n * @param name - Filename(s) to search for\n * @param options - Search options including cwd, stopAt, and type filters\n * @returns Normalized absolute path if found, undefined otherwise\n *\n * @example\n * ```ts\n * // Find package.json starting from current directory\n * const pkgPath = findUpSync('package.json')\n *\n * // Find .git directory but stop at home directory\n * const gitPath = findUpSync('.git', {\n *   onlyDirectories: true,\n *   stopAt: process.env.HOME\n * })\n *\n * // Find any of multiple config files\n * const configPath = findUpSync(['.eslintrc.js', '.eslintrc.json'])\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function findUpSync(\n  name: string | string[] | readonly string[],\n  options?: FindUpSyncOptions | undefined,\n) {\n  const { cwd = process.cwd(), stopAt } = {\n    __proto__: null,\n    ...options,\n  } as FindUpSyncOptions\n  let { onlyDirectories = false, onlyFiles = true } = {\n    __proto__: null,\n    ...options,\n  } as FindUpSyncOptions\n  if (onlyDirectories) {\n    onlyFiles = false\n  }\n  if (onlyFiles) {\n    onlyDirectories = false\n  }\n  const fs = getFs()\n  const path = getPath()\n  let dir = path.resolve(cwd)\n  const { root } = path.parse(dir)\n  const stopDir = stopAt ? path.resolve(stopAt) : undefined\n  const names = isArray(name) ? name : [name as string]\n  while (dir && dir !== root) {\n    // Check if we should stop at this directory.\n    if (stopDir && dir === stopDir) {\n      // Check current directory but don't go up.\n      for (const n of names) {\n        const thePath = path.join(dir, n)\n        try {\n          const stats = fs.statSync(thePath)\n          if (!onlyDirectories && stats.isFile()) {\n            return normalizePath(thePath)\n          }\n          if (!onlyFiles && stats.isDirectory()) {\n            return normalizePath(thePath)\n          }\n        } catch {}\n      }\n      return undefined\n    }\n    for (const n of names) {\n      const thePath = path.join(dir, n)\n      try {\n        const stats = fs.statSync(thePath)\n        if (!onlyDirectories && stats.isFile()) {\n          return normalizePath(thePath)\n        }\n        if (!onlyFiles && stats.isDirectory()) {\n          return normalizePath(thePath)\n        }\n      } catch {}\n    }\n    dir = path.dirname(dir)\n  }\n  return undefined\n}\n\n/**\n * Check if a path is a directory asynchronously.\n * Returns `true` for directories, `false` for files or non-existent paths.\n *\n * @param filepath - Path to check\n * @returns `true` if path is a directory, `false` otherwise\n *\n * @example\n * ```ts\n * if (await isDir('./src')) {\n *   console.log('src is a directory')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function isDir(filepath: PathLike) {\n  return !!(await safeStats(filepath))?.isDirectory()\n}\n\n/**\n * Check if a path is a directory synchronously.\n * Returns `true` for directories, `false` for files or non-existent paths.\n *\n * @param filepath - Path to check\n * @returns `true` if path is a directory, `false` otherwise\n *\n * @example\n * ```ts\n * if (isDirSync('./src')) {\n *   console.log('src is a directory')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isDirSync(filepath: PathLike) {\n  return !!safeStatsSync(filepath)?.isDirectory()\n}\n\n/**\n * Check if a directory is empty synchronously.\n * A directory is considered empty if it contains no files after applying ignore patterns.\n * Uses glob patterns to filter ignored files.\n *\n * @param dirname - Directory path to check\n * @param options - Options including ignore patterns\n * @returns `true` if directory is empty (or doesn't exist), `false` otherwise\n *\n * @example\n * ```ts\n * // Check if directory is completely empty\n * isDirEmptySync('./build')\n *\n * // Check if directory is empty, ignoring .DS_Store files\n * isDirEmptySync('./cache', { ignore: ['.DS_Store'] })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isDirEmptySync(\n  dirname: PathLike,\n  options?: IsDirEmptyOptions | undefined,\n) {\n  const { ignore = defaultIgnore } = {\n    __proto__: null,\n    ...options,\n  } as IsDirEmptyOptions\n  const fs = getFs()\n  try {\n    const files = fs.readdirSync(dirname)\n    const { length } = files\n    if (length === 0) {\n      return true\n    }\n    const matcher = getGlobMatcher(\n      ignore as string[],\n      {\n        cwd: pathLikeToString(dirname),\n      } as { cwd?: string; dot?: boolean; ignore?: string[]; nocase?: boolean },\n    )\n    let ignoredCount = 0\n    for (let i = 0; i < length; i += 1) {\n      const file = files[i]\n      if (file && matcher(file)) {\n        ignoredCount += 1\n      }\n    }\n    return ignoredCount === length\n  } catch {\n    // Return false for non-existent paths or other errors.\n    return false\n  }\n}\n\n/**\n * Check if a path is a symbolic link synchronously.\n * Uses `lstat` to check the link itself, not the target.\n *\n * @param filepath - Path to check\n * @returns `true` if path is a symbolic link, `false` otherwise\n *\n * @example\n * ```ts\n * if (isSymLinkSync('./my-link')) {\n *   console.log('Path is a symbolic link')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isSymLinkSync(filepath: PathLike) {\n  const fs = getFs()\n  try {\n    return fs.lstatSync(filepath).isSymbolicLink()\n  } catch {}\n  return false\n}\n\n/**\n * Result of file readability validation.\n * Contains lists of valid and invalid file paths.\n */\nexport interface ValidateFilesResult {\n  /**\n   * File paths that passed validation and are readable.\n   */\n  validPaths: string[]\n  /**\n   * File paths that failed validation (unreadable, permission denied, or non-existent).\n   * Common with Yarn Berry PnP virtual filesystem, pnpm symlinks, or filesystem race conditions.\n   */\n  invalidPaths: string[]\n}\n\n/**\n * Validate that file paths are readable before processing.\n * Filters out files from glob results that cannot be accessed (common with\n * Yarn Berry PnP virtual filesystem, pnpm content-addressable store symlinks,\n * or filesystem race conditions in CI/CD environments).\n *\n * This defensive pattern prevents ENOENT errors when files exist in glob\n * results but are not accessible via standard filesystem operations.\n *\n * @param filepaths - Array of file paths to validate\n * @returns Object with `validPaths` (readable) and `invalidPaths` (unreadable)\n *\n * @example\n * ```ts\n * import { validateFiles } from '@socketsecurity/lib/fs'\n *\n * const files = ['package.json', '.pnp.cjs/virtual-file.json']\n * const { validPaths, invalidPaths } = validateFiles(files)\n *\n * console.log(`Valid: ${validPaths.length}`)\n * console.log(`Invalid: ${invalidPaths.length}`)\n * ```\n *\n * @example\n * ```ts\n * // Typical usage in Socket CLI commands\n * const packagePaths = await getPackageFilesForScan(targets)\n * const { validPaths } = validateFiles(packagePaths)\n * await sdk.uploadManifestFiles(orgSlug, validPaths)\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function validateFiles(\n  filepaths: string[] | readonly string[],\n): ValidateFilesResult {\n  const fs = getFs()\n  const validPaths: string[] = []\n  const invalidPaths: string[] = []\n  const { R_OK } = fs.constants\n\n  for (const filepath of filepaths) {\n    try {\n      fs.accessSync(filepath, R_OK)\n      validPaths.push(filepath)\n    } catch {\n      invalidPaths.push(filepath)\n    }\n  }\n\n  return { __proto__: null, validPaths, invalidPaths } as ValidateFilesResult\n}\n\n/**\n * Read directory names asynchronously with filtering and sorting.\n * Returns only directory names (not files), with optional filtering for empty directories\n * and glob-based ignore patterns. Results are naturally sorted by default.\n *\n * @param dirname - Directory path to read\n * @param options - Options for filtering and sorting\n * @returns Array of directory names, empty array on error\n *\n * @example\n * ```ts\n * // Get all subdirectories, sorted naturally\n * const dirs = await readDirNames('./packages')\n *\n * // Get non-empty directories only\n * const nonEmpty = await readDirNames('./cache', { includeEmpty: false })\n *\n * // Get directories without sorting\n * const unsorted = await readDirNames('./src', { sort: false })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readDirNames(\n  dirname: PathLike,\n  options?: ReadDirOptions | undefined,\n) {\n  const fs = getFs()\n  try {\n    return innerReadDirNames(\n      await fs.promises.readdir(dirname, {\n        __proto__: null,\n        encoding: 'utf8',\n        withFileTypes: true,\n      } as ObjectEncodingOptions & { withFileTypes: true }),\n      String(dirname),\n      options,\n    )\n  } catch {}\n  return []\n}\n\n/**\n * Read directory names synchronously with filtering and sorting.\n * Returns only directory names (not files), with optional filtering for empty directories\n * and glob-based ignore patterns. Results are naturally sorted by default.\n *\n * @param dirname - Directory path to read\n * @param options - Options for filtering and sorting\n * @returns Array of directory names, empty array on error\n *\n * @example\n * ```ts\n * // Get all subdirectories, sorted naturally\n * const dirs = readDirNamesSync('./packages')\n *\n * // Get non-empty directories only, ignoring node_modules\n * const nonEmpty = readDirNamesSync('./src', {\n *   includeEmpty: false,\n *   ignore: ['node_modules']\n * })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readDirNamesSync(dirname: PathLike, options?: ReadDirOptions) {\n  const fs = getFs()\n  try {\n    return innerReadDirNames(\n      fs.readdirSync(dirname, {\n        __proto__: null,\n        encoding: 'utf8',\n        withFileTypes: true,\n      } as ObjectEncodingOptions & { withFileTypes: true }),\n      String(dirname),\n      options,\n    )\n  } catch {}\n  return []\n}\n\n/**\n * Read a file as binary data asynchronously.\n * Returns a Buffer without encoding the contents.\n * Useful for reading images, archives, or other binary formats.\n *\n * @param filepath - Path to file\n * @param options - Read options (encoding is forced to null for binary)\n * @returns Promise resolving to Buffer containing file contents\n *\n * @example\n * ```ts\n * // Read an image file\n * const imageBuffer = await readFileBinary('./image.png')\n *\n * // Read with abort signal\n * const buffer = await readFileBinary('./data.bin', { signal: abortSignal })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readFileBinary(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  // Don't specify encoding to get a Buffer.\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return await fs.promises.readFile(filepath, {\n    signal: abortSignal,\n    ...opts,\n    encoding: null,\n  })\n}\n\n/**\n * Read a file as UTF-8 text asynchronously.\n * Returns a string with the file contents decoded as UTF-8.\n * This is the most common way to read text files.\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding and abort signal\n * @returns Promise resolving to string containing file contents\n *\n * @example\n * ```ts\n * // Read a text file\n * const content = await readFileUtf8('./README.md')\n *\n * // Read with custom encoding\n * const content = await readFileUtf8('./data.txt', { encoding: 'utf-8' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readFileUtf8(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return await fs.promises.readFile(filepath, {\n    signal: abortSignal,\n    ...opts,\n    encoding: 'utf8',\n  })\n}\n\n/**\n * Read a file as binary data synchronously.\n * Returns a Buffer without encoding the contents.\n * Useful for reading images, archives, or other binary formats.\n *\n * @param filepath - Path to file\n * @param options - Read options (encoding is forced to null for binary)\n * @returns Buffer containing file contents\n *\n * @example\n * ```ts\n * // Read an image file\n * const imageBuffer = readFileBinarySync('./logo.png')\n *\n * // Read a compressed file\n * const gzipData = readFileBinarySync('./archive.gz')\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readFileBinarySync(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  // Don't specify encoding to get a Buffer\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return fs.readFileSync(filepath, {\n    ...opts,\n    encoding: null,\n  } as ObjectEncodingOptions)\n}\n\n/**\n * Read a file as UTF-8 text synchronously.\n * Returns a string with the file contents decoded as UTF-8.\n * This is the most common way to read text files synchronously.\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding\n * @returns String containing file contents\n *\n * @example\n * ```ts\n * // Read a configuration file\n * const config = readFileUtf8Sync('./config.txt')\n *\n * // Read with custom options\n * const data = readFileUtf8Sync('./data.txt', { encoding: 'utf8' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readFileUtf8Sync(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return fs.readFileSync(filepath, {\n    ...opts,\n    encoding: 'utf8',\n  } as ObjectEncodingOptions)\n}\n\n/**\n * Read and parse a JSON file asynchronously.\n * Reads the file as UTF-8 text and parses it as JSON.\n * Optionally accepts a reviver function to transform parsed values.\n *\n * @param filepath - Path to JSON file\n * @param options - Read and parse options\n * @returns Promise resolving to parsed JSON value, or undefined if throws is false and an error occurs\n *\n * @example\n * ```ts\n * // Read and parse package.json\n * const pkg = await readJson('./package.json')\n *\n * // Read JSON with custom reviver\n * const data = await readJson('./data.json', {\n *   reviver: (key, value) => {\n *     if (key === 'date') return new Date(value)\n *     return value\n *   }\n * })\n *\n * // Don't throw on parse errors\n * const config = await readJson('./config.json', { throws: false })\n * if (config === undefined) {\n *   console.log('Failed to parse config')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readJson(\n  filepath: PathLike,\n  options?: ReadJsonOptions | string | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { reviver, throws, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  } as unknown as ReadJsonOptions\n  const shouldThrow = throws === undefined || !!throws\n  const fs = getFs()\n  let content = ''\n  try {\n    content = await fs.promises.readFile(filepath, {\n      __proto__: null,\n      encoding: 'utf8',\n      ...fsOptions,\n    } as unknown as Parameters<typeof fs.promises.readFile>[1] & {\n      encoding: string\n    })\n  } catch (e) {\n    if (shouldThrow) {\n      const code = (e as NodeJS.ErrnoException).code\n      if (code === 'ENOENT') {\n        throw new Error(\n          `JSON file not found: ${filepath}\\n` +\n            'Ensure the file exists or create it with the expected structure.',\n          { cause: e },\n        )\n      }\n      if (code === 'EACCES' || code === 'EPERM') {\n        throw new Error(\n          `Permission denied reading JSON file: ${filepath}\\n` +\n            'Check file permissions or run with appropriate access.',\n          { cause: e },\n        )\n      }\n      throw e\n    }\n    return undefined\n  }\n  return jsonParse(content, {\n    filepath: String(filepath),\n    reviver,\n    throws: shouldThrow,\n  })\n}\n\n/**\n * Read and parse a JSON file synchronously.\n * Reads the file as UTF-8 text and parses it as JSON.\n * Optionally accepts a reviver function to transform parsed values.\n *\n * @param filepath - Path to JSON file\n * @param options - Read and parse options\n * @returns Parsed JSON value, or undefined if throws is false and an error occurs\n *\n * @example\n * ```ts\n * // Read and parse tsconfig.json\n * const tsconfig = readJsonSync('./tsconfig.json')\n *\n * // Read JSON with custom reviver\n * const data = readJsonSync('./data.json', {\n *   reviver: (key, value) => {\n *     if (typeof value === 'string' && /^\\d{4}-\\d{2}-\\d{2}/.test(value)) {\n *       return new Date(value)\n *     }\n *     return value\n *   }\n * })\n *\n * // Don't throw on parse errors\n * const config = readJsonSync('./config.json', { throws: false })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readJsonSync(\n  filepath: PathLike,\n  options?: ReadJsonOptions | string | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { reviver, throws, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  } as unknown as ReadJsonOptions\n  const shouldThrow = throws === undefined || !!throws\n  const fs = getFs()\n  let content = ''\n  try {\n    content = fs.readFileSync(filepath, {\n      __proto__: null,\n      encoding: 'utf8',\n      ...fsOptions,\n    } as unknown as Parameters<typeof fs.readFileSync>[1] & {\n      encoding: string\n    })\n  } catch (e) {\n    if (shouldThrow) {\n      const code = (e as NodeJS.ErrnoException).code\n      if (code === 'ENOENT') {\n        throw new Error(\n          `JSON file not found: ${filepath}\\n` +\n            'Ensure the file exists or create it with the expected structure.',\n          { cause: e },\n        )\n      }\n      if (code === 'EACCES' || code === 'EPERM') {\n        throw new Error(\n          `Permission denied reading JSON file: ${filepath}\\n` +\n            'Check file permissions or run with appropriate access.',\n          { cause: e },\n        )\n      }\n      throw e\n    }\n    return undefined\n  }\n  return jsonParse(content, {\n    filepath: String(filepath),\n    reviver,\n    throws: shouldThrow,\n  })\n}\n\n// Cache for resolved allowed directories\nlet _cachedAllowedDirs: string[] | undefined\n\n/**\n * Get resolved allowed directories for safe deletion with lazy caching.\n * These directories are resolved once and cached for the process lifetime.\n */\nfunction getAllowedDirectories(): string[] {\n  if (_cachedAllowedDirs === undefined) {\n    const path = getPath()\n    const {\n      getOsTmpDir,\n      getSocketCacacheDir,\n      getSocketUserDir,\n    } = /*@__PURE__*/ require('#lib/paths')\n\n    _cachedAllowedDirs = [\n      path.resolve(getOsTmpDir()),\n      path.resolve(getSocketCacacheDir()),\n      path.resolve(getSocketUserDir()),\n    ]\n  }\n  return _cachedAllowedDirs\n}\n\n/**\n * Invalidate the cached allowed directories.\n * Called automatically by the paths/rewire module when paths are overridden in tests.\n *\n * @internal Used for test rewiring\n */\nexport function invalidatePathCache(): void {\n  _cachedAllowedDirs = undefined\n}\n\n// Register cache invalidation with the rewire module\nregisterCacheInvalidation(invalidatePathCache)\n\n/**\n * Safely delete a file or directory asynchronously with built-in protections.\n * Uses `del` for safer deletion that prevents removing cwd and above by default.\n * Automatically uses force: true for temp directory, cacache, and ~/.socket subdirectories.\n *\n * @param filepath - Path or array of paths to delete (supports glob patterns)\n * @param options - Deletion options including force, retries, and recursion\n * @throws {Error} When attempting to delete protected paths without force option\n *\n * @example\n * ```ts\n * // Delete a single file\n * await safeDelete('./temp-file.txt')\n *\n * // Delete a directory recursively\n * await safeDelete('./build', { recursive: true })\n *\n * // Delete multiple paths\n * await safeDelete(['./dist', './coverage'])\n *\n * // Delete with custom retry settings\n * await safeDelete('./flaky-dir', { maxRetries: 5, retryDelay: 500 })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeDelete(\n  filepath: PathLike | PathLike[],\n  options?: RemoveOptions | undefined,\n) {\n  const del = /*@__PURE__*/ require('./external/del')\n  const { deleteAsync } = del\n  const opts = { __proto__: null, ...options } as RemoveOptions\n  const patterns = isArray(filepath)\n    ? filepath.map(pathLikeToString)\n    : [pathLikeToString(filepath)]\n\n  // Check if we're deleting within allowed directories.\n  let shouldForce = opts.force !== false\n  if (!shouldForce && patterns.length > 0) {\n    const path = getPath()\n    const allowedDirs = getAllowedDirectories()\n\n    // Check if all patterns are within allowed directories.\n    const allInAllowedDirs = patterns.every(pattern => {\n      const resolvedPath = path.resolve(pattern)\n\n      // Check each allowed directory\n      for (const allowedDir of allowedDirs) {\n        const isInAllowedDir =\n          resolvedPath.startsWith(allowedDir + path.sep) ||\n          resolvedPath === allowedDir\n        const relativePath = path.relative(allowedDir, resolvedPath)\n        const isGoingBackward = relativePath.startsWith('..')\n\n        if (isInAllowedDir && !isGoingBackward) {\n          return true\n        }\n      }\n\n      return false\n    })\n\n    if (allInAllowedDirs) {\n      shouldForce = true\n    }\n  }\n\n  await deleteAsync(patterns, {\n    concurrency: opts.maxRetries || defaultRemoveOptions.maxRetries,\n    dryRun: false,\n    force: shouldForce,\n    onlyFiles: false,\n  })\n}\n\n/**\n * Safely delete a file or directory synchronously with built-in protections.\n * Uses `del` for safer deletion that prevents removing cwd and above by default.\n * Automatically uses force: true for temp directory, cacache, and ~/.socket subdirectories.\n *\n * @param filepath - Path or array of paths to delete (supports glob patterns)\n * @param options - Deletion options including force, retries, and recursion\n * @throws {Error} When attempting to delete protected paths without force option\n *\n * @example\n * ```ts\n * // Delete a single file\n * safeDeleteSync('./temp-file.txt')\n *\n * // Delete a directory recursively\n * safeDeleteSync('./build', { recursive: true })\n *\n * // Delete multiple paths with globs\n * safeDeleteSync(['./dist/**', './coverage/**'])\n *\n * // Force delete a protected path (use with caution)\n * safeDeleteSync('./important', { force: true })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeDeleteSync(\n  filepath: PathLike | PathLike[],\n  options?: RemoveOptions | undefined,\n) {\n  const del = /*@__PURE__*/ require('./external/del')\n  const { deleteSync } = del\n  const opts = { __proto__: null, ...options } as RemoveOptions\n  const patterns = isArray(filepath)\n    ? filepath.map(pathLikeToString)\n    : [pathLikeToString(filepath)]\n\n  // Check if we're deleting within allowed directories.\n  let shouldForce = opts.force !== false\n  if (!shouldForce && patterns.length > 0) {\n    const path = getPath()\n    const allowedDirs = getAllowedDirectories()\n\n    // Check if all patterns are within allowed directories.\n    const allInAllowedDirs = patterns.every(pattern => {\n      const resolvedPath = path.resolve(pattern)\n\n      // Check each allowed directory\n      for (const allowedDir of allowedDirs) {\n        const isInAllowedDir =\n          resolvedPath.startsWith(allowedDir + path.sep) ||\n          resolvedPath === allowedDir\n        const relativePath = path.relative(allowedDir, resolvedPath)\n        const isGoingBackward = relativePath.startsWith('..')\n\n        if (isInAllowedDir && !isGoingBackward) {\n          return true\n        }\n      }\n\n      return false\n    })\n\n    if (allInAllowedDirs) {\n      shouldForce = true\n    }\n  }\n\n  deleteSync(patterns, {\n    concurrency: opts.maxRetries || defaultRemoveOptions.maxRetries,\n    dryRun: false,\n    force: shouldForce,\n    onlyFiles: false,\n  })\n}\n\n/**\n * Safely create a directory asynchronously, ignoring EEXIST errors.\n * This function wraps fs.promises.mkdir and handles the race condition where\n * the directory might already exist, which is common in concurrent code.\n *\n * Unlike fs.promises.mkdir with recursive:true, this function:\n * - Silently ignores EEXIST errors (directory already exists)\n * - Re-throws all other errors (permissions, invalid path, etc.)\n * - Works reliably in multi-process/concurrent scenarios\n *\n * @param path - Directory path to create\n * @param options - Options including recursive and mode settings\n * @returns Promise that resolves when directory is created or already exists\n *\n * @example\n * ```ts\n * // Create a directory, no error if it exists\n * await safeMkdir('./config')\n *\n * // Create nested directories\n * await safeMkdir('./data/cache/temp', { recursive: true })\n *\n * // Create with specific permissions\n * await safeMkdir('./secure', { mode: 0o700 })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeMkdir(\n  path: PathLike,\n  options?: MakeDirectoryOptions | undefined,\n): Promise<void> {\n  const fs = getFs()\n  try {\n    await fs.promises.mkdir(path, options)\n  } catch (e: unknown) {\n    // Ignore EEXIST error - directory already exists.\n    if (\n      typeof e === 'object' &&\n      e !== null &&\n      'code' in e &&\n      e.code !== 'EEXIST'\n    ) {\n      throw e\n    }\n  }\n}\n\n/**\n * Safely create a directory synchronously, ignoring EEXIST errors.\n * This function wraps fs.mkdirSync and handles the race condition where\n * the directory might already exist, which is common in concurrent code.\n *\n * Unlike fs.mkdirSync with recursive:true, this function:\n * - Silently ignores EEXIST errors (directory already exists)\n * - Re-throws all other errors (permissions, invalid path, etc.)\n * - Works reliably in multi-process/concurrent scenarios\n *\n * @param path - Directory path to create\n * @param options - Options including recursive and mode settings\n *\n * @example\n * ```ts\n * // Create a directory, no error if it exists\n * safeMkdirSync('./config')\n *\n * // Create nested directories\n * safeMkdirSync('./data/cache/temp', { recursive: true })\n *\n * // Create with specific permissions\n * safeMkdirSync('./secure', { mode: 0o700 })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeMkdirSync(\n  path: PathLike,\n  options?: MakeDirectoryOptions | undefined,\n): void {\n  const fs = getFs()\n  try {\n    fs.mkdirSync(path, options)\n  } catch (e: unknown) {\n    // Ignore EEXIST error - directory already exists.\n    if (\n      typeof e === 'object' &&\n      e !== null &&\n      'code' in e &&\n      e.code !== 'EEXIST'\n    ) {\n      throw e\n    }\n  }\n}\n\n/**\n * Safely read a file asynchronously, returning undefined on error.\n * Useful when you want to attempt reading a file without handling errors explicitly.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding and default value\n * @returns Promise resolving to file contents, or undefined on error\n *\n * @example\n * ```ts\n * // Try to read a file, get undefined if it doesn't exist\n * const content = await safeReadFile('./optional-config.txt')\n * if (content) {\n *   console.log('Config found:', content)\n * }\n *\n * // Read with specific encoding\n * const data = await safeReadFile('./data.txt', { encoding: 'utf8' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeReadFile(\n  filepath: PathLike,\n  options?: SafeReadOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  try {\n    return await fs.promises.readFile(filepath, {\n      signal: abortSignal,\n      ...opts,\n    } as Abortable)\n  } catch {}\n  return undefined\n}\n\n/**\n * Safely read a file synchronously, returning undefined on error.\n * Useful when you want to attempt reading a file without handling errors explicitly.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding and default value\n * @returns File contents, or undefined on error\n *\n * @example\n * ```ts\n * // Try to read a config file\n * const config = safeReadFileSync('./config.txt')\n * if (config) {\n *   console.log('Config loaded successfully')\n * }\n *\n * // Read binary file safely\n * const buffer = safeReadFileSync('./image.png', { encoding: null })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeReadFileSync(\n  filepath: PathLike,\n  options?: SafeReadOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  try {\n    return fs.readFileSync(filepath, {\n      __proto__: null,\n      ...opts,\n    } as ObjectEncodingOptions)\n  } catch {}\n  return undefined\n}\n\n/**\n * Safely get file stats asynchronously, returning undefined on error.\n * Useful for checking file existence and properties without error handling.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to check\n * @returns Promise resolving to Stats object, or undefined on error\n *\n * @example\n * ```ts\n * // Check if file exists and get its stats\n * const stats = await safeStats('./file.txt')\n * if (stats) {\n *   console.log('File size:', stats.size)\n *   console.log('Modified:', stats.mtime)\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeStats(filepath: PathLike) {\n  const fs = getFs()\n  try {\n    return await fs.promises.stat(filepath)\n  } catch {}\n  return undefined\n}\n\n/**\n * Safely get file stats synchronously, returning undefined on error.\n * Useful for checking file existence and properties without error handling.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to check\n * @param options - Read options (currently unused but kept for API consistency)\n * @returns Stats object, or undefined on error\n *\n * @example\n * ```ts\n * // Check if file exists and get its size\n * const stats = safeStatsSync('./file.txt')\n * if (stats) {\n *   console.log('File size:', stats.size)\n *   console.log('Is directory:', stats.isDirectory())\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeStatsSync(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  try {\n    return fs.statSync(filepath, {\n      __proto__: null,\n      throwIfNoEntry: false,\n      ...opts,\n    } as StatSyncOptions)\n  } catch {}\n  return undefined\n}\n\n/**\n * Generate a unique filepath by adding number suffix if the path exists.\n * Appends `-1`, `-2`, etc. before the file extension until a non-existent path is found.\n * Useful for creating files without overwriting existing ones.\n *\n * @param filepath - Desired file path\n * @returns Normalized unique filepath (original if it doesn't exist, or with number suffix)\n *\n * @example\n * ```ts\n * // If 'report.pdf' exists, returns 'report-1.pdf'\n * const uniquePath = uniqueSync('./report.pdf')\n *\n * // If 'data.json' and 'data-1.json' exist, returns 'data-2.json'\n * const path = uniqueSync('./data.json')\n *\n * // If 'backup' doesn't exist, returns 'backup' unchanged\n * const backupPath = uniqueSync('./backup')\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function uniqueSync(filepath: PathLike): string {\n  const fs = getFs()\n  const path = getPath()\n  const filepathStr = String(filepath)\n\n  // If the file doesn't exist, return as is\n  if (!fs.existsSync(filepathStr)) {\n    return normalizePath(filepathStr)\n  }\n\n  const dirname = path.dirname(filepathStr)\n  const ext = path.extname(filepathStr)\n  const basename = path.basename(filepathStr, ext)\n\n  let counter = 1\n  let uniquePath: string\n  do {\n    uniquePath = path.join(dirname, `${basename}-${counter}${ext}`)\n    counter++\n  } while (fs.existsSync(uniquePath))\n\n  return normalizePath(uniquePath)\n}\n\n/**\n * Write JSON content to a file asynchronously with formatting.\n * Stringifies the value with configurable indentation and line endings.\n * Automatically adds a final newline by default for POSIX compliance.\n *\n * @param filepath - Path to write to\n * @param jsonContent - Value to stringify and write\n * @param options - Write options including formatting and encoding\n * @returns Promise that resolves when write completes\n *\n * @example\n * ```ts\n * // Write formatted JSON with default 2-space indentation\n * await writeJson('./data.json', { name: 'example', version: '1.0.0' })\n *\n * // Write with custom indentation\n * await writeJson('./config.json', config, { spaces: 4 })\n *\n * // Write with tabs instead of spaces\n * await writeJson('./data.json', data, { spaces: '\\t' })\n *\n * // Write without final newline\n * await writeJson('./inline.json', obj, { finalEOL: false })\n *\n * // Write with Windows line endings\n * await writeJson('./win.json', data, { EOL: '\\r\\n' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function writeJson(\n  filepath: PathLike,\n  jsonContent: unknown,\n  options?: WriteJsonOptions | string,\n): Promise<void> {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  } as WriteJsonOptions\n  const fs = getFs()\n  const jsonString = stringify(\n    jsonContent,\n    EOL || '\\n',\n    finalEOL !== undefined ? finalEOL : true,\n    replacer,\n    spaces,\n  )\n  await fs.promises.writeFile(filepath, jsonString, {\n    encoding: 'utf8',\n    ...fsOptions,\n    __proto__: null,\n  } as ObjectEncodingOptions)\n}\n\n/**\n * Write JSON content to a file synchronously with formatting.\n * Stringifies the value with configurable indentation and line endings.\n * Automatically adds a final newline by default for POSIX compliance.\n *\n * @param filepath - Path to write to\n * @param jsonContent - Value to stringify and write\n * @param options - Write options including formatting and encoding\n *\n * @example\n * ```ts\n * // Write formatted JSON with default 2-space indentation\n * writeJsonSync('./package.json', pkg)\n *\n * // Write with custom indentation\n * writeJsonSync('./tsconfig.json', tsconfig, { spaces: 4 })\n *\n * // Write with tabs for indentation\n * writeJsonSync('./data.json', data, { spaces: '\\t' })\n *\n * // Write compacted (no indentation)\n * writeJsonSync('./compact.json', data, { spaces: 0 })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function writeJsonSync(\n  filepath: PathLike,\n  jsonContent: unknown,\n  options?: WriteJsonOptions | string | undefined,\n): void {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  }\n  const fs = getFs()\n  const jsonString = stringify(\n    jsonContent,\n    EOL || '\\n',\n    finalEOL !== undefined ? finalEOL : true,\n    replacer,\n    spaces,\n  )\n  fs.writeFileSync(filepath, jsonString, {\n    encoding: 'utf8',\n    ...fsOptions,\n    __proto__: null,\n  } as WriteFileOptions)\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,qBAA+B;AAE/B,oBAAwB;AAIxB,mBAA8C;AAE9C,kBAA0B;AAC1B,qBAAyC;AACzC,kBAAgD;AAChD,oBAA0C;AAC1C,mBAA+B;AAR/B,MAAM,kBAAc,+BAAe;AA6QnC,MAAM,2BAAuB,6BAAa;AAAA,EACxC,WAAW;AAAA,EACX,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AACd,CAAC;AAED,IAAI;AAAA;AASJ,SAAS,QAAQ;AACf,MAAI,QAAQ,QAAW;AAErB,UAAoB,QAAQ,SAAS;AAAA,EACvC;AACA,SAAO;AACT;AAEA,IAAI;AAAA;AASJ,SAAS,UAAU;AACjB,MAAI,UAAU,QAAW;AAGvB,YAAsB,QAAQ,WAAW;AAAA,EAC3C;AACA,SAAO;AACT;AAAA;AAcA,SAAS,kBACP,SACA,SACA,SACU;AACV,QAAM;AAAA,IACJ;AAAA,IACA,eAAe;AAAA,IACf,OAAO;AAAA,EACT,IAAI,EAAE,WAAW,MAAM,GAAG,QAAQ;AAClC,QAAM,OAAO,wBAAQ;AACrB,QAAM,QAAQ,QACX;AAAA,IACC,CAAC,MACC,EAAE,YAAY,MACb,gBACC,CAAC,+BAAe,KAAK,KAAK,WAAW,EAAE,YAAY,EAAE,IAAI,GAAG;AAAA,MAC1D;AAAA,IACF,CAAC;AAAA,EACP,EACC,IAAI,CAAC,MAAc,EAAE,IAAI;AAC5B,SAAO,OAAO,MAAM,KAAK,2BAAc,IAAI;AAC7C;AAAA;AAeA,SAAS,UACP,MACA,KACA,UACA,UACA,SAA0B,GAClB;AACR,QAAM,MAAM,WAAW,MAAM;AAC7B,QAAM,MAAM,KAAK,UAAU,MAAM,UAAU,MAAM;AACjD,SAAO,GAAG,IAAI,QAAQ,OAAO,GAAG,CAAC,GAAG,GAAG;AACzC;AAAA;AAwBA,eAAsB,OACpB,MACA,SAC6B;AAC7B,QAAM,EAAE,MAAM,QAAQ,IAAI,GAAG,SAAS,YAAY,IAAI;AAAA,IACpD,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,MAAI,EAAE,kBAAkB,OAAO,YAAY,KAAK,IAAI;AAAA,IAClD,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,MAAI,iBAAiB;AACnB,gBAAY;AAAA,EACd;AACA,MAAI,WAAW;AACb,sBAAkB;AAAA,EACpB;AACA,QAAM,KAAK,sBAAM;AACjB,QAAM,OAAO,wBAAQ;AACrB,MAAI,MAAM,KAAK,QAAQ,GAAG;AAC1B,QAAM,EAAE,KAAK,IAAI,KAAK,MAAM,GAAG;AAC/B,QAAM,YAAQ,uBAAQ,IAAI,IAAI,OAAO,CAAC,IAAc;AACpD,SAAO,OAAO,QAAQ,MAAM;AAC1B,eAAW,KAAK,OAAO;AACrB,UAAI,QAAQ,SAAS;AACnB,eAAO;AAAA,MACT;AACA,YAAM,UAAU,KAAK,KAAK,KAAK,CAAC;AAChC,UAAI;AAEF,cAAM,QAAQ,MAAM,GAAG,SAAS,KAAK,OAAO;AAC5C,YAAI,CAAC,mBAAmB,MAAM,OAAO,GAAG;AACtC,qBAAO,2BAAc,OAAO;AAAA,QAC9B;AACA,YAAI,CAAC,aAAa,MAAM,YAAY,GAAG;AACrC,qBAAO,2BAAc,OAAO;AAAA,QAC9B;AAAA,MACF,QAAQ;AAAA,MAAC;AAAA,IACX;AACA,UAAM,KAAK,QAAQ,GAAG;AAAA,EACxB;AACA,SAAO;AACT;AAAA;AA2BO,SAAS,WACd,MACA,SACA;AACA,QAAM,EAAE,MAAM,QAAQ,IAAI,GAAG,OAAO,IAAI;AAAA,IACtC,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,MAAI,EAAE,kBAAkB,OAAO,YAAY,KAAK,IAAI;AAAA,IAClD,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,MAAI,iBAAiB;AACnB,gBAAY;AAAA,EACd;AACA,MAAI,WAAW;AACb,sBAAkB;AAAA,EACpB;AACA,QAAM,KAAK,sBAAM;AACjB,QAAM,OAAO,wBAAQ;AACrB,MAAI,MAAM,KAAK,QAAQ,GAAG;AAC1B,QAAM,EAAE,KAAK,IAAI,KAAK,MAAM,GAAG;AAC/B,QAAM,UAAU,SAAS,KAAK,QAAQ,MAAM,IAAI;AAChD,QAAM,YAAQ,uBAAQ,IAAI,IAAI,OAAO,CAAC,IAAc;AACpD,SAAO,OAAO,QAAQ,MAAM;AAE1B,QAAI,WAAW,QAAQ,SAAS;AAE9B,iBAAW,KAAK,OAAO;AACrB,cAAM,UAAU,KAAK,KAAK,KAAK,CAAC;AAChC,YAAI;AACF,gBAAM,QAAQ,GAAG,SAAS,OAAO;AACjC,cAAI,CAAC,mBAAmB,MAAM,OAAO,GAAG;AACtC,uBAAO,2BAAc,OAAO;AAAA,UAC9B;AACA,cAAI,CAAC,aAAa,MAAM,YAAY,GAAG;AACrC,uBAAO,2BAAc,OAAO;AAAA,UAC9B;AAAA,QACF,QAAQ;AAAA,QAAC;AAAA,MACX;AACA,aAAO;AAAA,IACT;AACA,eAAW,KAAK,OAAO;AACrB,YAAM,UAAU,KAAK,KAAK,KAAK,CAAC;AAChC,UAAI;AACF,cAAM,QAAQ,GAAG,SAAS,OAAO;AACjC,YAAI,CAAC,mBAAmB,MAAM,OAAO,GAAG;AACtC,qBAAO,2BAAc,OAAO;AAAA,QAC9B;AACA,YAAI,CAAC,aAAa,MAAM,YAAY,GAAG;AACrC,qBAAO,2BAAc,OAAO;AAAA,QAC9B;AAAA,MACF,QAAQ;AAAA,MAAC;AAAA,IACX;AACA,UAAM,KAAK,QAAQ,GAAG;AAAA,EACxB;AACA,SAAO;AACT;AAAA;AAiBA,eAAsB,MAAM,UAAoB;AAC9C,SAAO,CAAC,EAAE,MAAM,0BAAU,QAAQ,IAAI,YAAY;AACpD;AAAA;AAiBO,SAAS,UAAU,UAAoB;AAC5C,SAAO,CAAC,EAAC,8BAAc,QAAQ,IAAG,YAAY;AAChD;AAAA;AAqBO,SAAS,eACd,SACA,SACA;AACA,QAAM,EAAE,SAAS,2BAAc,IAAI;AAAA,IACjC,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,UAAM,QAAQ,GAAG,YAAY,OAAO;AACpC,UAAM,EAAE,OAAO,IAAI;AACnB,QAAI,WAAW,GAAG;AAChB,aAAO;AAAA,IACT;AACA,UAAM,cAAU;AAAA,MACd;AAAA,MACA;AAAA,QACE,SAAK,8BAAiB,OAAO;AAAA,MAC/B;AAAA,IACF;AACA,QAAI,eAAe;AACnB,aAAS,IAAI,GAAG,IAAI,QAAQ,KAAK,GAAG;AAClC,YAAM,OAAO,MAAM,CAAC;AACpB,UAAI,QAAQ,QAAQ,IAAI,GAAG;AACzB,wBAAgB;AAAA,MAClB;AAAA,IACF;AACA,WAAO,iBAAiB;AAAA,EAC1B,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAAA;AAiBO,SAAS,cAAc,UAAoB;AAChD,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,WAAO,GAAG,UAAU,QAAQ,EAAE,eAAe;AAAA,EAC/C,QAAQ;AAAA,EAAC;AACT,SAAO;AACT;AAAA;AAkDO,SAAS,cACd,WACqB;AACrB,QAAM,KAAK,sBAAM;AACjB,QAAM,aAAuB,CAAC;AAC9B,QAAM,eAAyB,CAAC;AAChC,QAAM,EAAE,KAAK,IAAI,GAAG;AAEpB,aAAW,YAAY,WAAW;AAChC,QAAI;AACF,SAAG,WAAW,UAAU,IAAI;AAC5B,iBAAW,KAAK,QAAQ;AAAA,IAC1B,QAAQ;AACN,mBAAa,KAAK,QAAQ;AAAA,IAC5B;AAAA,EACF;AAEA,SAAO,EAAE,WAAW,MAAM,YAAY,aAAa;AACrD;AAAA;AAwBA,eAAsB,aACpB,SACA,SACA;AACA,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,WAAO;AAAA,MACL,MAAM,GAAG,SAAS,QAAQ,SAAS;AAAA,QACjC,WAAW;AAAA,QACX,UAAU;AAAA,QACV,eAAe;AAAA,MACjB,CAAoD;AAAA,MACpD,OAAO,OAAO;AAAA,MACd;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAAC;AACT,SAAO,CAAC;AACV;AAAA;AAwBO,SAAS,iBAAiB,SAAmB,SAA0B;AAC5E,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,WAAO;AAAA,MACL,GAAG,YAAY,SAAS;AAAA,QACtB,WAAW;AAAA,QACX,UAAU;AAAA,QACV,eAAe;AAAA,MACjB,CAAoD;AAAA,MACpD,OAAO,OAAO;AAAA,MACd;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAAC;AACT,SAAO,CAAC;AACV;AAAA;AAqBA,eAAsB,eACpB,UACA,SACA;AAEA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,KAAK,sBAAM;AACjB,SAAO,MAAM,GAAG,SAAS,SAAS,UAAU;AAAA,IAC1C,QAAQ;AAAA,IACR,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,CAAC;AACH;AAAA;AAqBA,eAAsB,aACpB,UACA,SACA;AACA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,KAAK,sBAAM;AACjB,SAAO,MAAM,GAAG,SAAS,SAAS,UAAU;AAAA,IAC1C,QAAQ;AAAA,IACR,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,CAAC;AACH;AAAA;AAqBO,SAAS,mBACd,UACA,SACA;AAEA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,KAAK,sBAAM;AACjB,SAAO,GAAG,aAAa,UAAU;AAAA,IAC/B,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,CAA0B;AAC5B;AAAA;AAqBO,SAAS,iBACd,UACA,SACA;AACA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,KAAK,sBAAM;AACjB,SAAO,GAAG,aAAa,UAAU;AAAA,IAC/B,GAAG;AAAA,IACH,UAAU;AAAA,EACZ,CAA0B;AAC5B;AAAA;AAgCA,eAAsB,SACpB,UACA,SACA;AACA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,EAAE,SAAS,QAAQ,GAAG,UAAU,IAAI;AAAA,IACxC,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,QAAM,cAAc,WAAW,UAAa,CAAC,CAAC;AAC9C,QAAM,KAAK,sBAAM;AACjB,MAAI,UAAU;AACd,MAAI;AACF,cAAU,MAAM,GAAG,SAAS,SAAS,UAAU;AAAA,MAC7C,WAAW;AAAA,MACX,UAAU;AAAA,MACV,GAAG;AAAA,IACL,CAEC;AAAA,EACH,SAAS,GAAG;AACV,QAAI,aAAa;AACf,YAAM,OAAQ,EAA4B;AAC1C,UAAI,SAAS,UAAU;AACrB,cAAM,IAAI;AAAA,UACR,wBAAwB,QAAQ;AAAA;AAAA,UAEhC,EAAE,OAAO,EAAE;AAAA,QACb;AAAA,MACF;AACA,UAAI,SAAS,YAAY,SAAS,SAAS;AACzC,cAAM,IAAI;AAAA,UACR,wCAAwC,QAAQ;AAAA;AAAA,UAEhD,EAAE,OAAO,EAAE;AAAA,QACb;AAAA,MACF;AACA,YAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT;AACA,aAAO,uBAAU,SAAS;AAAA,IACxB,UAAU,OAAO,QAAQ;AAAA,IACzB;AAAA,IACA,QAAQ;AAAA,EACV,CAAC;AACH;AAAA;AA+BO,SAAS,aACd,UACA,SACA;AACA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,EAAE,SAAS,QAAQ,GAAG,UAAU,IAAI;AAAA,IACxC,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,QAAM,cAAc,WAAW,UAAa,CAAC,CAAC;AAC9C,QAAM,KAAK,sBAAM;AACjB,MAAI,UAAU;AACd,MAAI;AACF,cAAU,GAAG,aAAa,UAAU;AAAA,MAClC,WAAW;AAAA,MACX,UAAU;AAAA,MACV,GAAG;AAAA,IACL,CAEC;AAAA,EACH,SAAS,GAAG;AACV,QAAI,aAAa;AACf,YAAM,OAAQ,EAA4B;AAC1C,UAAI,SAAS,UAAU;AACrB,cAAM,IAAI;AAAA,UACR,wBAAwB,QAAQ;AAAA;AAAA,UAEhC,EAAE,OAAO,EAAE;AAAA,QACb;AAAA,MACF;AACA,UAAI,SAAS,YAAY,SAAS,SAAS;AACzC,cAAM,IAAI;AAAA,UACR,wCAAwC,QAAQ;AAAA;AAAA,UAEhD,EAAE,OAAO,EAAE;AAAA,QACb;AAAA,MACF;AACA,YAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT;AACA,aAAO,uBAAU,SAAS;AAAA,IACxB,UAAU,OAAO,QAAQ;AAAA,IACzB;AAAA,IACA,QAAQ;AAAA,EACV,CAAC;AACH;AAGA,IAAI;AAMJ,SAAS,wBAAkC;AACzC,MAAI,uBAAuB,QAAW;AACpC,UAAM,OAAO,wBAAQ;AACrB,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAkB,QAAQ,YAAY;AAEtC,yBAAqB;AAAA,MACnB,KAAK,QAAQ,YAAY,CAAC;AAAA,MAC1B,KAAK,QAAQ,oBAAoB,CAAC;AAAA,MAClC,KAAK,QAAQ,iBAAiB,CAAC;AAAA,IACjC;AAAA,EACF;AACA,SAAO;AACT;AAQO,SAAS,sBAA4B;AAC1C,uBAAqB;AACvB;AAAA,IAGA,yCAA0B,mBAAmB;AAAA;AA2B7C,eAAsB,WACpB,UACA,SACA;AACA,QAAM,MAAoB,QAAQ,gBAAgB;AAClD,QAAM,EAAE,YAAY,IAAI;AACxB,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,eAAW,uBAAQ,QAAQ,IAC7B,SAAS,IAAI,4BAAgB,IAC7B,KAAC,8BAAiB,QAAQ,CAAC;AAG/B,MAAI,cAAc,KAAK,UAAU;AACjC,MAAI,CAAC,eAAe,SAAS,SAAS,GAAG;AACvC,UAAM,OAAO,wBAAQ;AACrB,UAAM,cAAc,sBAAsB;AAG1C,UAAM,mBAAmB,SAAS,MAAM,aAAW;AACjD,YAAM,eAAe,KAAK,QAAQ,OAAO;AAGzC,iBAAW,cAAc,aAAa;AACpC,cAAM,iBACJ,aAAa,WAAW,aAAa,KAAK,GAAG,KAC7C,iBAAiB;AACnB,cAAM,eAAe,KAAK,SAAS,YAAY,YAAY;AAC3D,cAAM,kBAAkB,aAAa,WAAW,IAAI;AAEpD,YAAI,kBAAkB,CAAC,iBAAiB;AACtC,iBAAO;AAAA,QACT;AAAA,MACF;AAEA,aAAO;AAAA,IACT,CAAC;AAED,QAAI,kBAAkB;AACpB,oBAAc;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,YAAY,UAAU;AAAA,IAC1B,aAAa,KAAK,cAAc,qBAAqB;AAAA,IACrD,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,WAAW;AAAA,EACb,CAAC;AACH;AAAA;AA2BO,SAAS,eACd,UACA,SACA;AACA,QAAM,MAAoB,QAAQ,gBAAgB;AAClD,QAAM,EAAE,WAAW,IAAI;AACvB,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,eAAW,uBAAQ,QAAQ,IAC7B,SAAS,IAAI,4BAAgB,IAC7B,KAAC,8BAAiB,QAAQ,CAAC;AAG/B,MAAI,cAAc,KAAK,UAAU;AACjC,MAAI,CAAC,eAAe,SAAS,SAAS,GAAG;AACvC,UAAM,OAAO,wBAAQ;AACrB,UAAM,cAAc,sBAAsB;AAG1C,UAAM,mBAAmB,SAAS,MAAM,aAAW;AACjD,YAAM,eAAe,KAAK,QAAQ,OAAO;AAGzC,iBAAW,cAAc,aAAa;AACpC,cAAM,iBACJ,aAAa,WAAW,aAAa,KAAK,GAAG,KAC7C,iBAAiB;AACnB,cAAM,eAAe,KAAK,SAAS,YAAY,YAAY;AAC3D,cAAM,kBAAkB,aAAa,WAAW,IAAI;AAEpD,YAAI,kBAAkB,CAAC,iBAAiB;AACtC,iBAAO;AAAA,QACT;AAAA,MACF;AAEA,aAAO;AAAA,IACT,CAAC;AAED,QAAI,kBAAkB;AACpB,oBAAc;AAAA,IAChB;AAAA,EACF;AAEA,aAAW,UAAU;AAAA,IACnB,aAAa,KAAK,cAAc,qBAAqB;AAAA,IACrD,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,WAAW;AAAA,EACb,CAAC;AACH;AAAA;AA6BA,eAAsB,UACpB,MACA,SACe;AACf,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,UAAM,GAAG,SAAS,MAAM,MAAM,OAAO;AAAA,EACvC,SAAS,GAAY;AAEnB,QACE,OAAO,MAAM,YACb,MAAM,QACN,UAAU,KACV,EAAE,SAAS,UACX;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAAA;AA4BO,SAAS,cACd,MACA,SACM;AACN,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,OAAG,UAAU,MAAM,OAAO;AAAA,EAC5B,SAAS,GAAY;AAEnB,QACE,OAAO,MAAM,YACb,MAAM,QACN,UAAU,KACV,EAAE,SAAS,UACX;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAAA;AAwBA,eAAsB,aACpB,UACA,SACA;AACA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,WAAO,MAAM,GAAG,SAAS,SAAS,UAAU;AAAA,MAC1C,QAAQ;AAAA,MACR,GAAG;AAAA,IACL,CAAc;AAAA,EAChB,QAAQ;AAAA,EAAC;AACT,SAAO;AACT;AAAA;AAwBO,SAAS,iBACd,UACA,SACA;AACA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,WAAO,GAAG,aAAa,UAAU;AAAA,MAC/B,WAAW;AAAA,MACX,GAAG;AAAA,IACL,CAA0B;AAAA,EAC5B,QAAQ;AAAA,EAAC;AACT,SAAO;AACT;AAAA;AAqBA,eAAsB,UAAU,UAAoB;AAClD,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,WAAO,MAAM,GAAG,SAAS,KAAK,QAAQ;AAAA,EACxC,QAAQ;AAAA,EAAC;AACT,SAAO;AACT;AAAA;AAsBO,SAAS,cACd,UACA,SACA;AACA,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,WAAO,GAAG,SAAS,UAAU;AAAA,MAC3B,WAAW;AAAA,MACX,gBAAgB;AAAA,MAChB,GAAG;AAAA,IACL,CAAoB;AAAA,EACtB,QAAQ;AAAA,EAAC;AACT,SAAO;AACT;AAAA;AAuBO,SAAS,WAAW,UAA4B;AACrD,QAAM,KAAK,sBAAM;AACjB,QAAM,OAAO,wBAAQ;AACrB,QAAM,cAAc,OAAO,QAAQ;AAGnC,MAAI,CAAC,GAAG,WAAW,WAAW,GAAG;AAC/B,eAAO,2BAAc,WAAW;AAAA,EAClC;AAEA,QAAM,UAAU,KAAK,QAAQ,WAAW;AACxC,QAAM,MAAM,KAAK,QAAQ,WAAW;AACpC,QAAM,WAAW,KAAK,SAAS,aAAa,GAAG;AAE/C,MAAI,UAAU;AACd,MAAI;AACJ,KAAG;AACD,iBAAa,KAAK,KAAK,SAAS,GAAG,QAAQ,IAAI,OAAO,GAAG,GAAG,EAAE;AAC9D;AAAA,EACF,SAAS,GAAG,WAAW,UAAU;AAEjC,aAAO,2BAAc,UAAU;AACjC;AAAA;AA+BA,eAAsB,UACpB,UACA,aACA,SACe;AACf,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,EAAE,KAAK,UAAU,UAAU,QAAQ,GAAG,UAAU,IAAI;AAAA,IACxD,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,QAAM,KAAK,sBAAM;AACjB,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,OAAO;AAAA,IACP,aAAa,SAAY,WAAW;AAAA,IACpC;AAAA,IACA;AAAA,EACF;AACA,QAAM,GAAG,SAAS,UAAU,UAAU,YAAY;AAAA,IAChD,UAAU;AAAA,IACV,GAAG;AAAA,IACH,WAAW;AAAA,EACb,CAA0B;AAC5B;AAAA;AA2BO,SAAS,cACd,UACA,aACA,SACM;AACN,QAAM,OAAO,OAAO,YAAY,WAAW,EAAE,UAAU,QAAQ,IAAI;AACnE,QAAM,EAAE,KAAK,UAAU,UAAU,QAAQ,GAAG,UAAU,IAAI;AAAA,IACxD,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AACA,QAAM,KAAK,sBAAM;AACjB,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,OAAO;AAAA,IACP,aAAa,SAAY,WAAW;AAAA,IACpC;AAAA,IACA;AAAA,EACF;AACA,KAAG,cAAc,UAAU,YAAY;AAAA,IACrC,UAAU;AAAA,IACV,GAAG;AAAA,IACH,WAAW;AAAA,EACb,CAAqB;AACvB;",
+  "sourcesContent": ["/**\n * @fileoverview File system utilities with cross-platform path handling.\n * Provides enhanced fs operations, glob matching, and directory traversal functions.\n */\n\nimport type { Abortable } from 'events'\n\nimport type {\n  Dirent,\n  MakeDirectoryOptions,\n  ObjectEncodingOptions,\n  OpenMode,\n  PathLike,\n  StatSyncOptions,\n  WriteFileOptions,\n} from 'fs'\n\nimport { getAbortSignal } from '#constants/process'\n\nimport { isArray } from './arrays'\n\nconst abortSignal = getAbortSignal()\n\nimport { defaultIgnore, getGlobMatcher } from './globs'\nimport type { JsonReviver } from './json'\nimport { jsonParse } from './json'\nimport { objectFreeze, type Remap } from './objects'\nimport { normalizePath, pathLikeToString } from './path'\nimport { registerCacheInvalidation } from './paths/rewire'\nimport { naturalCompare } from './sorts'\n\n/**\n * Supported text encodings for Node.js Buffers.\n * Includes ASCII, UTF-8/16, base64, binary, and hexadecimal encodings.\n */\nexport type BufferEncoding =\n  | 'ascii'\n  | 'utf8'\n  | 'utf-8'\n  | 'utf16le'\n  | 'ucs2'\n  | 'ucs-2'\n  | 'base64'\n  | 'base64url'\n  | 'latin1'\n  | 'binary'\n  | 'hex'\n\n/**\n * Represents any valid JSON content type.\n */\nexport type JsonContent = unknown\n\n/**\n * Options for asynchronous `findUp` operations.\n */\nexport interface FindUpOptions {\n  /**\n   * Starting directory for the search.\n   * @default process.cwd()\n   */\n  cwd?: string | undefined\n  /**\n   * Only match directories, not files.\n   * @default false\n   */\n  onlyDirectories?: boolean | undefined\n  /**\n   * Only match files, not directories.\n   * @default true\n   */\n  onlyFiles?: boolean | undefined\n  /**\n   * Abort signal to cancel the search operation.\n   */\n  signal?: AbortSignal | undefined\n}\n\n/**\n * Options for synchronous `findUpSync` operations.\n */\nexport interface FindUpSyncOptions {\n  /**\n   * Starting directory for the search.\n   * @default process.cwd()\n   */\n  cwd?: string | undefined\n  /**\n   * Directory to stop searching at (inclusive).\n   * When provided, search will stop at this directory even if the root hasn't been reached.\n   */\n  stopAt?: string | undefined\n  /**\n   * Only match directories, not files.\n   * @default false\n   */\n  onlyDirectories?: boolean | undefined\n  /**\n   * Only match files, not directories.\n   * @default true\n   */\n  onlyFiles?: boolean | undefined\n}\n\n/**\n * Options for checking if a directory is empty.\n */\nexport interface IsDirEmptyOptions {\n  /**\n   * Glob patterns for files to ignore when checking emptiness.\n   * Files matching these patterns are not counted.\n   * @default defaultIgnore\n   */\n  ignore?: string[] | readonly string[] | undefined\n}\n\n/**\n * Options for read operations with abort support.\n */\nexport interface ReadOptions extends Abortable {\n  /**\n   * Character encoding to use for reading.\n   * @default 'utf8'\n   */\n  encoding?: BufferEncoding | string | undefined\n  /**\n   * File system flag for reading behavior.\n   * @default 'r'\n   */\n  flag?: string | undefined\n}\n\n/**\n * Options for reading directories with filtering and sorting.\n */\nexport interface ReadDirOptions {\n  /**\n   * Glob patterns for directories to ignore.\n   * @default undefined\n   */\n  ignore?: string[] | readonly string[] | undefined\n  /**\n   * Include empty directories in results.\n   * When `false`, empty directories are filtered out.\n   * @default true\n   */\n  includeEmpty?: boolean | undefined\n  /**\n   * Sort directory names alphabetically using natural sort order.\n   * @default true\n   */\n  sort?: boolean | undefined\n}\n\n/**\n * Options for reading files with encoding and abort support.\n * Can be either an options object, an encoding string, or null.\n */\nexport type ReadFileOptions =\n  | Remap<\n      ObjectEncodingOptions &\n        Abortable & {\n          flag?: OpenMode | undefined\n        }\n    >\n  | BufferEncoding\n  | null\n\n/**\n * Options for reading and parsing JSON files.\n */\nexport type ReadJsonOptions = Remap<\n  ReadFileOptions & {\n    /**\n     * Whether to throw errors on parse failure.\n     * When `false`, returns `undefined` on error instead of throwing.\n     * @default true\n     */\n    throws?: boolean | undefined\n    /**\n     * JSON reviver function to transform parsed values.\n     * Same as the second parameter to `JSON.parse()`.\n     */\n    reviver?: Parameters<typeof JSON.parse>[1] | undefined\n  }\n>\n\n/**\n * Options for file/directory removal operations.\n */\nexport interface RemoveOptions {\n  /**\n   * Force deletion even outside normally safe directories.\n   * When `false`, prevents deletion outside temp, cacache, and ~/.socket.\n   * @default true for safe directories, false otherwise\n   */\n  force?: boolean | undefined\n  /**\n   * Maximum number of retry attempts on failure.\n   * @default 3\n   */\n  maxRetries?: number | undefined\n  /**\n   * Recursively delete directories and contents.\n   * @default true\n   */\n  recursive?: boolean | undefined\n  /**\n   * Delay in milliseconds between retry attempts.\n   * @default 200\n   */\n  retryDelay?: number | undefined\n  /**\n   * Abort signal to cancel the operation.\n   */\n  signal?: AbortSignal | undefined\n}\n\n/**\n * Options for safe read operations that don't throw on errors.\n */\nexport interface SafeReadOptions extends ReadOptions {\n  /**\n   * Default value to return on read failure.\n   * If not provided, `undefined` is returned on error.\n   */\n  defaultValue?: unknown | undefined\n}\n\n/**\n * Options for write operations with encoding and mode control.\n */\nexport interface WriteOptions extends Abortable {\n  /**\n   * Character encoding for writing.\n   * @default 'utf8'\n   */\n  encoding?: BufferEncoding | string | undefined\n  /**\n   * File mode (permissions) to set.\n   * Uses standard Unix permission bits (e.g., 0o644).\n   * @default 0o666 (read/write for all, respecting umask)\n   */\n  mode?: number | undefined\n  /**\n   * File system flag for write behavior.\n   * @default 'w' (create or truncate)\n   */\n  flag?: string | undefined\n}\n\n/**\n * Options for writing JSON files with formatting control.\n */\nexport interface WriteJsonOptions extends WriteOptions {\n  /**\n   * End-of-line sequence to use.\n   * @default '\\n'\n   * @example\n   * ```ts\n   * // Windows-style line endings\n   * writeJson('data.json', data, { EOL: '\\r\\n' })\n   * ```\n   */\n  EOL?: string | undefined\n  /**\n   * Whether to add a final newline at end of file.\n   * @default true\n   */\n  finalEOL?: boolean | undefined\n  /**\n   * JSON replacer function to transform values during stringification.\n   * Same as the second parameter to `JSON.stringify()`.\n   */\n  replacer?: JsonReviver | undefined\n  /**\n   * Number of spaces for indentation, or string to use for indentation.\n   * @default 2\n   * @example\n   * ```ts\n   * // Use tabs instead of spaces\n   * writeJson('data.json', data, { spaces: '\\t' })\n   *\n   * // Use 4 spaces for indentation\n   * writeJson('data.json', data, { spaces: 4 })\n   * ```\n   */\n  spaces?: number | string | undefined\n}\n\nconst defaultRemoveOptions = objectFreeze({\n  __proto__: null,\n  force: true,\n  maxRetries: 3,\n  recursive: true,\n  retryDelay: 200,\n})\n\nlet _fs: typeof import('fs') | undefined\n/**\n * Lazily load the fs module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js fs module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFs() {\n  if (_fs === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n    _fs = /*@__PURE__*/ require('node:fs')\n  }\n  return _fs as typeof import('fs')\n}\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js path module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path as typeof import('path')\n}\n\n/**\n * Process directory entries and filter for directories.\n * Filters entries to include only directories, optionally excluding empty ones.\n * Applies ignore patterns and natural sorting.\n *\n * @param dirents - Directory entries from readdir\n * @param dirname - Parent directory path\n * @param options - Filtering and sorting options\n * @returns Array of directory names, optionally sorted\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction innerReadDirNames(\n  dirents: Dirent[],\n  dirname: string | undefined,\n  options?: ReadDirOptions | undefined,\n): string[] {\n  const {\n    ignore,\n    includeEmpty = true,\n    sort = true,\n  } = { __proto__: null, ...options } as ReadDirOptions\n  const path = getPath()\n  const names = dirents\n    .filter(\n      (d: Dirent) =>\n        d.isDirectory() &&\n        (includeEmpty ||\n          !isDirEmptySync(path.join(dirname || d.parentPath, d.name), {\n            ignore,\n          })),\n    )\n    .map((d: Dirent) => d.name)\n  return sort ? names.sort(naturalCompare) : names\n}\n\n/**\n * Stringify JSON with custom formatting options.\n * Formats JSON with configurable line endings and indentation.\n *\n * @param json - Value to stringify\n * @param EOL - End-of-line sequence\n * @param finalEOL - Whether to add final newline\n * @param replacer - JSON replacer function\n * @param spaces - Indentation spaces or string\n * @returns Formatted JSON string\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction stringify(\n  json: unknown,\n  EOL: string,\n  finalEOL: boolean,\n  replacer: JsonReviver | undefined,\n  spaces: number | string = 2,\n): string {\n  const EOF = finalEOL ? EOL : ''\n  const str = JSON.stringify(json, replacer, spaces)\n  return `${str.replace(/\\n/g, EOL)}${EOF}`\n}\n\n/**\n * Find a file or directory by traversing up parent directories.\n * Searches from the starting directory upward to the filesystem root.\n * Useful for finding configuration files or project roots.\n *\n * @param name - Filename(s) to search for\n * @param options - Search options including cwd and type filters\n * @returns Normalized absolute path if found, undefined otherwise\n *\n * @example\n * ```ts\n * // Find package.json starting from current directory\n * const pkgPath = await findUp('package.json')\n *\n * // Find any of multiple config files\n * const configPath = await findUp(['.config.js', '.config.json'])\n *\n * // Find a directory instead of file\n * const nodeModules = await findUp('node_modules', { onlyDirectories: true })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function findUp(\n  name: string | string[] | readonly string[],\n  options?: FindUpOptions | undefined,\n): Promise<string | undefined> {\n  const { cwd = process.cwd(), signal = abortSignal } = {\n    __proto__: null,\n    ...options,\n  } as FindUpOptions\n  let { onlyDirectories = false, onlyFiles = true } = {\n    __proto__: null,\n    ...options,\n  } as FindUpOptions\n  if (onlyDirectories) {\n    onlyFiles = false\n  }\n  if (onlyFiles) {\n    onlyDirectories = false\n  }\n  const fs = getFs()\n  const path = getPath()\n  let dir = path.resolve(cwd)\n  const { root } = path.parse(dir)\n  const names = isArray(name) ? name : [name as string]\n  while (dir && dir !== root) {\n    for (const n of names) {\n      if (signal?.aborted) {\n        return undefined\n      }\n      const thePath = path.join(dir, n)\n      try {\n        // eslint-disable-next-line no-await-in-loop\n        const stats = await fs.promises.stat(thePath)\n        if (!onlyDirectories && stats.isFile()) {\n          return normalizePath(thePath)\n        }\n        if (!onlyFiles && stats.isDirectory()) {\n          return normalizePath(thePath)\n        }\n      } catch {}\n    }\n    dir = path.dirname(dir)\n  }\n  return undefined\n}\n\n/**\n * Synchronously find a file or directory by traversing up parent directories.\n * Searches from the starting directory upward to the filesystem root or `stopAt` directory.\n * Useful for finding configuration files or project roots in synchronous contexts.\n *\n * @param name - Filename(s) to search for\n * @param options - Search options including cwd, stopAt, and type filters\n * @returns Normalized absolute path if found, undefined otherwise\n *\n * @example\n * ```ts\n * // Find package.json starting from current directory\n * const pkgPath = findUpSync('package.json')\n *\n * // Find .git directory but stop at home directory\n * const gitPath = findUpSync('.git', {\n *   onlyDirectories: true,\n *   stopAt: process.env.HOME\n * })\n *\n * // Find any of multiple config files\n * const configPath = findUpSync(['.eslintrc.js', '.eslintrc.json'])\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function findUpSync(\n  name: string | string[] | readonly string[],\n  options?: FindUpSyncOptions | undefined,\n) {\n  const { cwd = process.cwd(), stopAt } = {\n    __proto__: null,\n    ...options,\n  } as FindUpSyncOptions\n  let { onlyDirectories = false, onlyFiles = true } = {\n    __proto__: null,\n    ...options,\n  } as FindUpSyncOptions\n  if (onlyDirectories) {\n    onlyFiles = false\n  }\n  if (onlyFiles) {\n    onlyDirectories = false\n  }\n  const fs = getFs()\n  const path = getPath()\n  let dir = path.resolve(cwd)\n  const { root } = path.parse(dir)\n  const stopDir = stopAt ? path.resolve(stopAt) : undefined\n  const names = isArray(name) ? name : [name as string]\n  while (dir && dir !== root) {\n    // Check if we should stop at this directory.\n    if (stopDir && dir === stopDir) {\n      // Check current directory but don't go up.\n      for (const n of names) {\n        const thePath = path.join(dir, n)\n        try {\n          const stats = fs.statSync(thePath)\n          if (!onlyDirectories && stats.isFile()) {\n            return normalizePath(thePath)\n          }\n          if (!onlyFiles && stats.isDirectory()) {\n            return normalizePath(thePath)\n          }\n        } catch {}\n      }\n      return undefined\n    }\n    for (const n of names) {\n      const thePath = path.join(dir, n)\n      try {\n        const stats = fs.statSync(thePath)\n        if (!onlyDirectories && stats.isFile()) {\n          return normalizePath(thePath)\n        }\n        if (!onlyFiles && stats.isDirectory()) {\n          return normalizePath(thePath)\n        }\n      } catch {}\n    }\n    dir = path.dirname(dir)\n  }\n  return undefined\n}\n\n/**\n * Check if a path is a directory asynchronously.\n * Returns `true` for directories, `false` for files or non-existent paths.\n *\n * @param filepath - Path to check\n * @returns `true` if path is a directory, `false` otherwise\n *\n * @example\n * ```ts\n * if (await isDir('./src')) {\n *   console.log('src is a directory')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function isDir(filepath: PathLike) {\n  return !!(await safeStats(filepath))?.isDirectory()\n}\n\n/**\n * Check if a path is a directory synchronously.\n * Returns `true` for directories, `false` for files or non-existent paths.\n *\n * @param filepath - Path to check\n * @returns `true` if path is a directory, `false` otherwise\n *\n * @example\n * ```ts\n * if (isDirSync('./src')) {\n *   console.log('src is a directory')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isDirSync(filepath: PathLike) {\n  return !!safeStatsSync(filepath)?.isDirectory()\n}\n\n/**\n * Check if a directory is empty synchronously.\n * A directory is considered empty if it contains no files after applying ignore patterns.\n * Uses glob patterns to filter ignored files.\n *\n * @param dirname - Directory path to check\n * @param options - Options including ignore patterns\n * @returns `true` if directory is empty (or doesn't exist), `false` otherwise\n *\n * @example\n * ```ts\n * // Check if directory is completely empty\n * isDirEmptySync('./build')\n *\n * // Check if directory is empty, ignoring .DS_Store files\n * isDirEmptySync('./cache', { ignore: ['.DS_Store'] })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isDirEmptySync(\n  dirname: PathLike,\n  options?: IsDirEmptyOptions | undefined,\n) {\n  const { ignore = defaultIgnore } = {\n    __proto__: null,\n    ...options,\n  } as IsDirEmptyOptions\n  const fs = getFs()\n  try {\n    const files = fs.readdirSync(dirname)\n    const { length } = files\n    if (length === 0) {\n      return true\n    }\n    const matcher = getGlobMatcher(\n      ignore as string[],\n      {\n        cwd: pathLikeToString(dirname),\n      } as { cwd?: string; dot?: boolean; ignore?: string[]; nocase?: boolean },\n    )\n    let ignoredCount = 0\n    for (let i = 0; i < length; i += 1) {\n      const file = files[i]\n      if (file && matcher(file)) {\n        ignoredCount += 1\n      }\n    }\n    return ignoredCount === length\n  } catch {\n    // Return false for non-existent paths or other errors.\n    return false\n  }\n}\n\n/**\n * Check if a path is a symbolic link synchronously.\n * Uses `lstat` to check the link itself, not the target.\n *\n * @param filepath - Path to check\n * @returns `true` if path is a symbolic link, `false` otherwise\n *\n * @example\n * ```ts\n * if (isSymLinkSync('./my-link')) {\n *   console.log('Path is a symbolic link')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isSymLinkSync(filepath: PathLike) {\n  const fs = getFs()\n  try {\n    return fs.lstatSync(filepath).isSymbolicLink()\n  } catch {}\n  return false\n}\n\n/**\n * Result of file readability validation.\n * Contains lists of valid and invalid file paths.\n */\nexport interface ValidateFilesResult {\n  /**\n   * File paths that passed validation and are readable.\n   */\n  validPaths: string[]\n  /**\n   * File paths that failed validation (unreadable, permission denied, or non-existent).\n   * Common with Yarn Berry PnP virtual filesystem, pnpm symlinks, or filesystem race conditions.\n   */\n  invalidPaths: string[]\n}\n\n/**\n * Validate that file paths are readable before processing.\n * Filters out files from glob results that cannot be accessed (common with\n * Yarn Berry PnP virtual filesystem, pnpm content-addressable store symlinks,\n * or filesystem race conditions in CI/CD environments).\n *\n * This defensive pattern prevents ENOENT errors when files exist in glob\n * results but are not accessible via standard filesystem operations.\n *\n * @param filepaths - Array of file paths to validate\n * @returns Object with `validPaths` (readable) and `invalidPaths` (unreadable)\n *\n * @example\n * ```ts\n * import { validateFiles } from '@socketsecurity/lib/fs'\n *\n * const files = ['package.json', '.pnp.cjs/virtual-file.json']\n * const { validPaths, invalidPaths } = validateFiles(files)\n *\n * console.log(`Valid: ${validPaths.length}`)\n * console.log(`Invalid: ${invalidPaths.length}`)\n * ```\n *\n * @example\n * ```ts\n * // Typical usage in Socket CLI commands\n * const packagePaths = await getPackageFilesForScan(targets)\n * const { validPaths } = validateFiles(packagePaths)\n * await sdk.uploadManifestFiles(orgSlug, validPaths)\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function validateFiles(\n  filepaths: string[] | readonly string[],\n): ValidateFilesResult {\n  const fs = getFs()\n  const validPaths: string[] = []\n  const invalidPaths: string[] = []\n  const { R_OK } = fs.constants\n\n  for (const filepath of filepaths) {\n    try {\n      fs.accessSync(filepath, R_OK)\n      validPaths.push(filepath)\n    } catch {\n      invalidPaths.push(filepath)\n    }\n  }\n\n  return { __proto__: null, validPaths, invalidPaths } as ValidateFilesResult\n}\n\n/**\n * Read directory names asynchronously with filtering and sorting.\n * Returns only directory names (not files), with optional filtering for empty directories\n * and glob-based ignore patterns. Results are naturally sorted by default.\n *\n * @param dirname - Directory path to read\n * @param options - Options for filtering and sorting\n * @returns Array of directory names, empty array on error\n *\n * @example\n * ```ts\n * // Get all subdirectories, sorted naturally\n * const dirs = await readDirNames('./packages')\n *\n * // Get non-empty directories only\n * const nonEmpty = await readDirNames('./cache', { includeEmpty: false })\n *\n * // Get directories without sorting\n * const unsorted = await readDirNames('./src', { sort: false })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readDirNames(\n  dirname: PathLike,\n  options?: ReadDirOptions | undefined,\n) {\n  const fs = getFs()\n  try {\n    return innerReadDirNames(\n      await fs.promises.readdir(dirname, {\n        __proto__: null,\n        encoding: 'utf8',\n        withFileTypes: true,\n      } as ObjectEncodingOptions & { withFileTypes: true }),\n      String(dirname),\n      options,\n    )\n  } catch {}\n  return []\n}\n\n/**\n * Read directory names synchronously with filtering and sorting.\n * Returns only directory names (not files), with optional filtering for empty directories\n * and glob-based ignore patterns. Results are naturally sorted by default.\n *\n * @param dirname - Directory path to read\n * @param options - Options for filtering and sorting\n * @returns Array of directory names, empty array on error\n *\n * @example\n * ```ts\n * // Get all subdirectories, sorted naturally\n * const dirs = readDirNamesSync('./packages')\n *\n * // Get non-empty directories only, ignoring node_modules\n * const nonEmpty = readDirNamesSync('./src', {\n *   includeEmpty: false,\n *   ignore: ['node_modules']\n * })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readDirNamesSync(dirname: PathLike, options?: ReadDirOptions) {\n  const fs = getFs()\n  try {\n    return innerReadDirNames(\n      fs.readdirSync(dirname, {\n        __proto__: null,\n        encoding: 'utf8',\n        withFileTypes: true,\n      } as ObjectEncodingOptions & { withFileTypes: true }),\n      String(dirname),\n      options,\n    )\n  } catch {}\n  return []\n}\n\n/**\n * Read a file as binary data asynchronously.\n * Returns a Buffer without encoding the contents.\n * Useful for reading images, archives, or other binary formats.\n *\n * @param filepath - Path to file\n * @param options - Read options (encoding is forced to null for binary)\n * @returns Promise resolving to Buffer containing file contents\n *\n * @example\n * ```ts\n * // Read an image file\n * const imageBuffer = await readFileBinary('./image.png')\n *\n * // Read with abort signal\n * const buffer = await readFileBinary('./data.bin', { signal: abortSignal })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readFileBinary(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  // Don't specify encoding to get a Buffer.\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return await fs.promises.readFile(filepath, {\n    signal: abortSignal,\n    ...opts,\n    encoding: null,\n  })\n}\n\n/**\n * Read a file as UTF-8 text asynchronously.\n * Returns a string with the file contents decoded as UTF-8.\n * This is the most common way to read text files.\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding and abort signal\n * @returns Promise resolving to string containing file contents\n *\n * @example\n * ```ts\n * // Read a text file\n * const content = await readFileUtf8('./README.md')\n *\n * // Read with custom encoding\n * const content = await readFileUtf8('./data.txt', { encoding: 'utf-8' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readFileUtf8(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return await fs.promises.readFile(filepath, {\n    signal: abortSignal,\n    ...opts,\n    encoding: 'utf8',\n  })\n}\n\n/**\n * Read a file as binary data synchronously.\n * Returns a Buffer without encoding the contents.\n * Useful for reading images, archives, or other binary formats.\n *\n * @param filepath - Path to file\n * @param options - Read options (encoding is forced to null for binary)\n * @returns Buffer containing file contents\n *\n * @example\n * ```ts\n * // Read an image file\n * const imageBuffer = readFileBinarySync('./logo.png')\n *\n * // Read a compressed file\n * const gzipData = readFileBinarySync('./archive.gz')\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readFileBinarySync(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  // Don't specify encoding to get a Buffer\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return fs.readFileSync(filepath, {\n    ...opts,\n    encoding: null,\n  } as ObjectEncodingOptions)\n}\n\n/**\n * Read a file as UTF-8 text synchronously.\n * Returns a string with the file contents decoded as UTF-8.\n * This is the most common way to read text files synchronously.\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding\n * @returns String containing file contents\n *\n * @example\n * ```ts\n * // Read a configuration file\n * const config = readFileUtf8Sync('./config.txt')\n *\n * // Read with custom options\n * const data = readFileUtf8Sync('./data.txt', { encoding: 'utf8' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readFileUtf8Sync(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  return fs.readFileSync(filepath, {\n    ...opts,\n    encoding: 'utf8',\n  } as ObjectEncodingOptions)\n}\n\n/**\n * Read and parse a JSON file asynchronously.\n * Reads the file as UTF-8 text and parses it as JSON.\n * Optionally accepts a reviver function to transform parsed values.\n *\n * @param filepath - Path to JSON file\n * @param options - Read and parse options\n * @returns Promise resolving to parsed JSON value, or undefined if throws is false and an error occurs\n *\n * @example\n * ```ts\n * // Read and parse package.json\n * const pkg = await readJson('./package.json')\n *\n * // Read JSON with custom reviver\n * const data = await readJson('./data.json', {\n *   reviver: (key, value) => {\n *     if (key === 'date') return new Date(value)\n *     return value\n *   }\n * })\n *\n * // Don't throw on parse errors\n * const config = await readJson('./config.json', { throws: false })\n * if (config === undefined) {\n *   console.log('Failed to parse config')\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function readJson(\n  filepath: PathLike,\n  options?: ReadJsonOptions | string | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { reviver, throws, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  } as unknown as ReadJsonOptions\n  const shouldThrow = throws === undefined || !!throws\n  const fs = getFs()\n  let content = ''\n  try {\n    content = await fs.promises.readFile(filepath, {\n      __proto__: null,\n      encoding: 'utf8',\n      ...fsOptions,\n    } as unknown as Parameters<typeof fs.promises.readFile>[1] & {\n      encoding: string\n    })\n  } catch (e) {\n    if (shouldThrow) {\n      const code = (e as NodeJS.ErrnoException).code\n      if (code === 'ENOENT') {\n        throw new Error(\n          `JSON file not found: ${filepath}\\n` +\n            'Ensure the file exists or create it with the expected structure.',\n          { cause: e },\n        )\n      }\n      if (code === 'EACCES' || code === 'EPERM') {\n        throw new Error(\n          `Permission denied reading JSON file: ${filepath}\\n` +\n            'Check file permissions or run with appropriate access.',\n          { cause: e },\n        )\n      }\n      throw e\n    }\n    return undefined\n  }\n  return jsonParse(content, {\n    filepath: String(filepath),\n    reviver,\n    throws: shouldThrow,\n  })\n}\n\n/**\n * Read and parse a JSON file synchronously.\n * Reads the file as UTF-8 text and parses it as JSON.\n * Optionally accepts a reviver function to transform parsed values.\n *\n * @param filepath - Path to JSON file\n * @param options - Read and parse options\n * @returns Parsed JSON value, or undefined if throws is false and an error occurs\n *\n * @example\n * ```ts\n * // Read and parse tsconfig.json\n * const tsconfig = readJsonSync('./tsconfig.json')\n *\n * // Read JSON with custom reviver\n * const data = readJsonSync('./data.json', {\n *   reviver: (key, value) => {\n *     if (typeof value === 'string' && /^\\d{4}-\\d{2}-\\d{2}/.test(value)) {\n *       return new Date(value)\n *     }\n *     return value\n *   }\n * })\n *\n * // Don't throw on parse errors\n * const config = readJsonSync('./config.json', { throws: false })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function readJsonSync(\n  filepath: PathLike,\n  options?: ReadJsonOptions | string | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { reviver, throws, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  } as unknown as ReadJsonOptions\n  const shouldThrow = throws === undefined || !!throws\n  const fs = getFs()\n  let content = ''\n  try {\n    content = fs.readFileSync(filepath, {\n      __proto__: null,\n      encoding: 'utf8',\n      ...fsOptions,\n    } as unknown as Parameters<typeof fs.readFileSync>[1] & {\n      encoding: string\n    })\n  } catch (e) {\n    if (shouldThrow) {\n      const code = (e as NodeJS.ErrnoException).code\n      if (code === 'ENOENT') {\n        throw new Error(\n          `JSON file not found: ${filepath}\\n` +\n            'Ensure the file exists or create it with the expected structure.',\n          { cause: e },\n        )\n      }\n      if (code === 'EACCES' || code === 'EPERM') {\n        throw new Error(\n          `Permission denied reading JSON file: ${filepath}\\n` +\n            'Check file permissions or run with appropriate access.',\n          { cause: e },\n        )\n      }\n      throw e\n    }\n    return undefined\n  }\n  return jsonParse(content, {\n    filepath: String(filepath),\n    reviver,\n    throws: shouldThrow,\n  })\n}\n\n// Cache for resolved allowed directories\nlet _cachedAllowedDirs: string[] | undefined\n\n/**\n * Get resolved allowed directories for safe deletion with lazy caching.\n * These directories are resolved once and cached for the process lifetime.\n */\nfunction getAllowedDirectories(): string[] {\n  if (_cachedAllowedDirs === undefined) {\n    const path = getPath()\n    const {\n      getOsTmpDir,\n      getSocketCacacheDir,\n      getSocketUserDir,\n    } = /*@__PURE__*/ require('#lib/paths')\n\n    _cachedAllowedDirs = [\n      path.resolve(getOsTmpDir()),\n      path.resolve(getSocketCacacheDir()),\n      path.resolve(getSocketUserDir()),\n    ]\n  }\n  return _cachedAllowedDirs\n}\n\n/**\n * Invalidate the cached allowed directories.\n * Called automatically by the paths/rewire module when paths are overridden in tests.\n *\n * @internal Used for test rewiring\n */\nexport function invalidatePathCache(): void {\n  _cachedAllowedDirs = undefined\n}\n\n// Register cache invalidation with the rewire module\nregisterCacheInvalidation(invalidatePathCache)\n\n/**\n * Safely delete a file or directory asynchronously with built-in protections.\n * Uses `del` for safer deletion that prevents removing cwd and above by default.\n * Automatically uses force: true for temp directory, cacache, and ~/.socket subdirectories.\n *\n * @param filepath - Path or array of paths to delete (supports glob patterns)\n * @param options - Deletion options including force, retries, and recursion\n * @throws {Error} When attempting to delete protected paths without force option\n *\n * @example\n * ```ts\n * // Delete a single file\n * await safeDelete('./temp-file.txt')\n *\n * // Delete a directory recursively\n * await safeDelete('./build', { recursive: true })\n *\n * // Delete multiple paths\n * await safeDelete(['./dist', './coverage'])\n *\n * // Delete with custom retry settings\n * await safeDelete('./flaky-dir', { maxRetries: 5, retryDelay: 500 })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeDelete(\n  filepath: PathLike | PathLike[],\n  options?: RemoveOptions | undefined,\n) {\n  const del = /*@__PURE__*/ require('./external/del')\n  const { deleteAsync } = del\n  const opts = { __proto__: null, ...options } as RemoveOptions\n  const patterns = isArray(filepath)\n    ? filepath.map(pathLikeToString)\n    : [pathLikeToString(filepath)]\n\n  // Check if we're deleting within allowed directories.\n  let shouldForce = opts.force !== false\n  if (!shouldForce && patterns.length > 0) {\n    const path = getPath()\n    const allowedDirs = getAllowedDirectories()\n\n    // Check if all patterns are within allowed directories.\n    const allInAllowedDirs = patterns.every(pattern => {\n      const resolvedPath = path.resolve(pattern)\n\n      // Check each allowed directory\n      for (const allowedDir of allowedDirs) {\n        const isInAllowedDir =\n          resolvedPath.startsWith(allowedDir + path.sep) ||\n          resolvedPath === allowedDir\n        const relativePath = path.relative(allowedDir, resolvedPath)\n        const isGoingBackward = relativePath.startsWith('..')\n\n        if (isInAllowedDir && !isGoingBackward) {\n          return true\n        }\n      }\n\n      return false\n    })\n\n    if (allInAllowedDirs) {\n      shouldForce = true\n    }\n  }\n\n  await deleteAsync(patterns, {\n    concurrency: opts.maxRetries || defaultRemoveOptions.maxRetries,\n    dryRun: false,\n    force: shouldForce,\n    onlyFiles: false,\n  })\n}\n\n/**\n * Safely delete a file or directory synchronously with built-in protections.\n * Uses `del` for safer deletion that prevents removing cwd and above by default.\n * Automatically uses force: true for temp directory, cacache, and ~/.socket subdirectories.\n *\n * @param filepath - Path or array of paths to delete (supports glob patterns)\n * @param options - Deletion options including force, retries, and recursion\n * @throws {Error} When attempting to delete protected paths without force option\n *\n * @example\n * ```ts\n * // Delete a single file\n * safeDeleteSync('./temp-file.txt')\n *\n * // Delete a directory recursively\n * safeDeleteSync('./build', { recursive: true })\n *\n * // Delete multiple paths with globs\n * safeDeleteSync(['./dist/**', './coverage/**'])\n *\n * // Force delete a protected path (use with caution)\n * safeDeleteSync('./important', { force: true })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeDeleteSync(\n  filepath: PathLike | PathLike[],\n  options?: RemoveOptions | undefined,\n) {\n  const del = /*@__PURE__*/ require('./external/del')\n  const { deleteSync } = del\n  const opts = { __proto__: null, ...options } as RemoveOptions\n  const patterns = isArray(filepath)\n    ? filepath.map(pathLikeToString)\n    : [pathLikeToString(filepath)]\n\n  // Check if we're deleting within allowed directories.\n  let shouldForce = opts.force !== false\n  if (!shouldForce && patterns.length > 0) {\n    const path = getPath()\n    const allowedDirs = getAllowedDirectories()\n\n    // Check if all patterns are within allowed directories.\n    const allInAllowedDirs = patterns.every(pattern => {\n      const resolvedPath = path.resolve(pattern)\n\n      // Check each allowed directory\n      for (const allowedDir of allowedDirs) {\n        const isInAllowedDir =\n          resolvedPath.startsWith(allowedDir + path.sep) ||\n          resolvedPath === allowedDir\n        const relativePath = path.relative(allowedDir, resolvedPath)\n        const isGoingBackward = relativePath.startsWith('..')\n\n        if (isInAllowedDir && !isGoingBackward) {\n          return true\n        }\n      }\n\n      return false\n    })\n\n    if (allInAllowedDirs) {\n      shouldForce = true\n    }\n  }\n\n  deleteSync(patterns, {\n    concurrency: opts.maxRetries || defaultRemoveOptions.maxRetries,\n    dryRun: false,\n    force: shouldForce,\n    onlyFiles: false,\n  })\n}\n\n/**\n * Safely create a directory asynchronously, ignoring EEXIST errors.\n * This function wraps fs.promises.mkdir and handles the race condition where\n * the directory might already exist, which is common in concurrent code.\n *\n * Unlike fs.promises.mkdir with recursive:true, this function:\n * - Silently ignores EEXIST errors (directory already exists)\n * - Re-throws all other errors (permissions, invalid path, etc.)\n * - Works reliably in multi-process/concurrent scenarios\n * - Defaults to recursive: true for convenient nested directory creation\n *\n * @param path - Directory path to create\n * @param options - Options including recursive (default: true) and mode settings\n * @returns Promise that resolves when directory is created or already exists\n *\n * @example\n * ```ts\n * // Create a directory recursively by default, no error if it exists\n * await safeMkdir('./config')\n *\n * // Create nested directories (recursive: true is the default)\n * await safeMkdir('./data/cache/temp')\n *\n * // Create with specific permissions\n * await safeMkdir('./secure', { mode: 0o700 })\n *\n * // Explicitly disable recursive behavior\n * await safeMkdir('./single-level', { recursive: false })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeMkdir(\n  path: PathLike,\n  options?: MakeDirectoryOptions | undefined,\n): Promise<void> {\n  const fs = getFs()\n  const opts = { __proto__: null, recursive: true, ...options }\n  try {\n    await fs.promises.mkdir(path, opts)\n  } catch (e: unknown) {\n    // Ignore EEXIST error - directory already exists.\n    if (\n      typeof e === 'object' &&\n      e !== null &&\n      'code' in e &&\n      e.code !== 'EEXIST'\n    ) {\n      throw e\n    }\n  }\n}\n\n/**\n * Safely create a directory synchronously, ignoring EEXIST errors.\n * This function wraps fs.mkdirSync and handles the race condition where\n * the directory might already exist, which is common in concurrent code.\n *\n * Unlike fs.mkdirSync with recursive:true, this function:\n * - Silently ignores EEXIST errors (directory already exists)\n * - Re-throws all other errors (permissions, invalid path, etc.)\n * - Works reliably in multi-process/concurrent scenarios\n * - Defaults to recursive: true for convenient nested directory creation\n *\n * @param path - Directory path to create\n * @param options - Options including recursive (default: true) and mode settings\n *\n * @example\n * ```ts\n * // Create a directory recursively by default, no error if it exists\n * safeMkdirSync('./config')\n *\n * // Create nested directories (recursive: true is the default)\n * safeMkdirSync('./data/cache/temp')\n *\n * // Create with specific permissions\n * safeMkdirSync('./secure', { mode: 0o700 })\n *\n * // Explicitly disable recursive behavior\n * safeMkdirSync('./single-level', { recursive: false })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeMkdirSync(\n  path: PathLike,\n  options?: MakeDirectoryOptions | undefined,\n): void {\n  const fs = getFs()\n  const opts = { __proto__: null, recursive: true, ...options }\n  try {\n    fs.mkdirSync(path, opts)\n  } catch (e: unknown) {\n    // Ignore EEXIST error - directory already exists.\n    if (\n      typeof e === 'object' &&\n      e !== null &&\n      'code' in e &&\n      e.code !== 'EEXIST'\n    ) {\n      throw e\n    }\n  }\n}\n\n/**\n * Safely read a file asynchronously, returning undefined on error.\n * Useful when you want to attempt reading a file without handling errors explicitly.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding and default value\n * @returns Promise resolving to file contents, or undefined on error\n *\n * @example\n * ```ts\n * // Try to read a file, get undefined if it doesn't exist\n * const content = await safeReadFile('./optional-config.txt')\n * if (content) {\n *   console.log('Config found:', content)\n * }\n *\n * // Read with specific encoding\n * const data = await safeReadFile('./data.txt', { encoding: 'utf8' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeReadFile(\n  filepath: PathLike,\n  options?: SafeReadOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  try {\n    return await fs.promises.readFile(filepath, {\n      signal: abortSignal,\n      ...opts,\n    } as Abortable)\n  } catch {}\n  return undefined\n}\n\n/**\n * Safely read a file synchronously, returning undefined on error.\n * Useful when you want to attempt reading a file without handling errors explicitly.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to file\n * @param options - Read options including encoding and default value\n * @returns File contents, or undefined on error\n *\n * @example\n * ```ts\n * // Try to read a config file\n * const config = safeReadFileSync('./config.txt')\n * if (config) {\n *   console.log('Config loaded successfully')\n * }\n *\n * // Read binary file safely\n * const buffer = safeReadFileSync('./image.png', { encoding: null })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeReadFileSync(\n  filepath: PathLike,\n  options?: SafeReadOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  try {\n    return fs.readFileSync(filepath, {\n      __proto__: null,\n      ...opts,\n    } as ObjectEncodingOptions)\n  } catch {}\n  return undefined\n}\n\n/**\n * Safely get file stats asynchronously, returning undefined on error.\n * Useful for checking file existence and properties without error handling.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to check\n * @returns Promise resolving to Stats object, or undefined on error\n *\n * @example\n * ```ts\n * // Check if file exists and get its stats\n * const stats = await safeStats('./file.txt')\n * if (stats) {\n *   console.log('File size:', stats.size)\n *   console.log('Modified:', stats.mtime)\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function safeStats(filepath: PathLike) {\n  const fs = getFs()\n  try {\n    return await fs.promises.stat(filepath)\n  } catch {}\n  return undefined\n}\n\n/**\n * Safely get file stats synchronously, returning undefined on error.\n * Useful for checking file existence and properties without error handling.\n * Returns undefined for any error (file not found, permission denied, etc.).\n *\n * @param filepath - Path to check\n * @param options - Read options (currently unused but kept for API consistency)\n * @returns Stats object, or undefined on error\n *\n * @example\n * ```ts\n * // Check if file exists and get its size\n * const stats = safeStatsSync('./file.txt')\n * if (stats) {\n *   console.log('File size:', stats.size)\n *   console.log('Is directory:', stats.isDirectory())\n * }\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function safeStatsSync(\n  filepath: PathLike,\n  options?: ReadFileOptions | undefined,\n) {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const fs = getFs()\n  try {\n    return fs.statSync(filepath, {\n      __proto__: null,\n      throwIfNoEntry: false,\n      ...opts,\n    } as StatSyncOptions)\n  } catch {}\n  return undefined\n}\n\n/**\n * Generate a unique filepath by adding number suffix if the path exists.\n * Appends `-1`, `-2`, etc. before the file extension until a non-existent path is found.\n * Useful for creating files without overwriting existing ones.\n *\n * @param filepath - Desired file path\n * @returns Normalized unique filepath (original if it doesn't exist, or with number suffix)\n *\n * @example\n * ```ts\n * // If 'report.pdf' exists, returns 'report-1.pdf'\n * const uniquePath = uniqueSync('./report.pdf')\n *\n * // If 'data.json' and 'data-1.json' exist, returns 'data-2.json'\n * const path = uniqueSync('./data.json')\n *\n * // If 'backup' doesn't exist, returns 'backup' unchanged\n * const backupPath = uniqueSync('./backup')\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function uniqueSync(filepath: PathLike): string {\n  const fs = getFs()\n  const path = getPath()\n  const filepathStr = String(filepath)\n\n  // If the file doesn't exist, return as is\n  if (!fs.existsSync(filepathStr)) {\n    return normalizePath(filepathStr)\n  }\n\n  const dirname = path.dirname(filepathStr)\n  const ext = path.extname(filepathStr)\n  const basename = path.basename(filepathStr, ext)\n\n  let counter = 1\n  let uniquePath: string\n  do {\n    uniquePath = path.join(dirname, `${basename}-${counter}${ext}`)\n    counter++\n  } while (fs.existsSync(uniquePath))\n\n  return normalizePath(uniquePath)\n}\n\n/**\n * Write JSON content to a file asynchronously with formatting.\n * Stringifies the value with configurable indentation and line endings.\n * Automatically adds a final newline by default for POSIX compliance.\n *\n * @param filepath - Path to write to\n * @param jsonContent - Value to stringify and write\n * @param options - Write options including formatting and encoding\n * @returns Promise that resolves when write completes\n *\n * @example\n * ```ts\n * // Write formatted JSON with default 2-space indentation\n * await writeJson('./data.json', { name: 'example', version: '1.0.0' })\n *\n * // Write with custom indentation\n * await writeJson('./config.json', config, { spaces: 4 })\n *\n * // Write with tabs instead of spaces\n * await writeJson('./data.json', data, { spaces: '\\t' })\n *\n * // Write without final newline\n * await writeJson('./inline.json', obj, { finalEOL: false })\n *\n * // Write with Windows line endings\n * await writeJson('./win.json', data, { EOL: '\\r\\n' })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport async function writeJson(\n  filepath: PathLike,\n  jsonContent: unknown,\n  options?: WriteJsonOptions | string,\n): Promise<void> {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  } as WriteJsonOptions\n  const fs = getFs()\n  const jsonString = stringify(\n    jsonContent,\n    EOL || '\\n',\n    finalEOL !== undefined ? finalEOL : true,\n    replacer,\n    spaces,\n  )\n  await fs.promises.writeFile(filepath, jsonString, {\n    encoding: 'utf8',\n    ...fsOptions,\n    __proto__: null,\n  } as ObjectEncodingOptions)\n}\n\n/**\n * Write JSON content to a file synchronously with formatting.\n * Stringifies the value with configurable indentation and line endings.\n * Automatically adds a final newline by default for POSIX compliance.\n *\n * @param filepath - Path to write to\n * @param jsonContent - Value to stringify and write\n * @param options - Write options including formatting and encoding\n *\n * @example\n * ```ts\n * // Write formatted JSON with default 2-space indentation\n * writeJsonSync('./package.json', pkg)\n *\n * // Write with custom indentation\n * writeJsonSync('./tsconfig.json', tsconfig, { spaces: 4 })\n *\n * // Write with tabs for indentation\n * writeJsonSync('./data.json', data, { spaces: '\\t' })\n *\n * // Write compacted (no indentation)\n * writeJsonSync('./compact.json', data, { spaces: 0 })\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function writeJsonSync(\n  filepath: PathLike,\n  jsonContent: unknown,\n  options?: WriteJsonOptions | string | undefined,\n): void {\n  const opts = typeof options === 'string' ? { encoding: options } : options\n  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {\n    __proto__: null,\n    ...opts,\n  }\n  const fs = getFs()\n  const jsonString = stringify(\n    jsonContent,\n    EOL || '\\n',\n    finalEOL !== undefined ? finalEOL : true,\n    replacer,\n    spaces,\n  )\n  fs.writeFileSync(filepath, jsonString, {\n    encoding: 'utf8',\n    ...fsOptions,\n    __proto__: null,\n  } as WriteFileOptions)\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "3.0.5",
+  "version": "3.1.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [
@@ -589,7 +589,7 @@
     "@npmcli/package-json": "7.0.0",
     "@npmcli/promise-spawn": "8.0.3",
     "@socketregistry/is-unicode-supported": "1.0.5",
-    "@socketregistry/packageurl-js": "1.3.2",
+    "@socketregistry/packageurl-js": "1.3.3",
     "@socketregistry/yocto-spinner": "1.0.19",
     "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250920.1",