@socketsecurity/lib 3.0.2 → 3.0.4

package/dist/fs.js

@@ -1,9 +1,672 @@
 /* Socket Lib - Built with esbuild */
-var F=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var $=(n,e)=>{for(var t in e)F(n,t,{get:e[t],enumerable:!0})},B=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of W(e))!M.call(n,o)&&o!==t&&F(n,o,{get:()=>e[o],enumerable:!(i=T(e,o))||i.enumerable});return n};var q=n=>B(F({},"__esModule",{value:!0}),n);var ye={};$(ye,{findUp:()=>V,findUpSync:()=>G,invalidatePathCache:()=>I,isDir:()=>z,isDirEmptySync:()=>j,isDirSync:()=>X,isSymLinkSync:()=>K,readDirNames:()=>Q,readDirNamesSync:()=>Y,readFileBinary:()=>Z,readFileBinarySync:()=>ne,readFileUtf8:()=>ee,readFileUtf8Sync:()=>te,readJson:()=>ie,readJsonSync:()=>re,safeDelete:()=>oe,safeDeleteSync:()=>se,safeMkdir:()=>ae,safeMkdirSync:()=>ce,safeReadFile:()=>de,safeReadFileSync:()=>fe,safeStats:()=>U,safeStatsSync:()=>C,uniqueSync:()=>le,validateFiles:()=>H,writeJson:()=>ue,writeJsonSync:()=>pe});module.exports=q(ye);var v=require("#constants/process"),_=require("./arrays"),S=require("./globs"),b=require("./json"),D=require("./objects"),p=require("./path"),E=require("./paths/rewire"),R=require("./sorts");const w=(0,v.getAbortSignal)(),L=(0,D.objectFreeze)({__proto__:null,force:!0,maxRetries:3,recursive:!0,retryDelay:200});let P;function f(){return P===void 0&&(P=require("node:fs")),P}let k;function m(){return k===void 0&&(k=require("node:path")),k}function J(n,e,t){const{ignore:i,includeEmpty:o=!0,sort:s=!0}={__proto__:null,...t},c=m(),a=n.filter(r=>r.isDirectory()&&(o||!j(c.join(e||r.parentPath,r.name),{ignore:i}))).map(r=>r.name);return s?a.sort(R.naturalCompare):a}function A(n,e,t,i,o=2){const s=t?e:"";return`${JSON.stringify(n,i,o).replace(/\n/g,e)}${s}`}async function V(n,e){const{cwd:t=process.cwd(),signal:i=w}={__proto__:null,...e};let{onlyDirectories:o=!1,onlyFiles:s=!0}={__proto__:null,...e};o&&(s=!1),s&&(o=!1);const c=f(),a=m();let r=a.resolve(t);const{root:d}=a.parse(r),l=(0,_.isArray)(n)?n:[n];for(;r&&r!==d;){for(const g of l){if(i?.aborted)return;const u=a.join(r,g);try{const y=await c.promises.stat(u);if(!o&&y.isFile())return(0,p.normalizePath)(u);if(!s&&y.isDirectory())return(0,p.normalizePath)(u)}catch{}}r=a.dirname(r)}}function G(n,e){const{cwd:t=process.cwd(),stopAt:i}={__proto__:null,...e};let{onlyDirectories:o=!1,onlyFiles:s=!0}={__proto__:null,...e};o&&(s=!1),s&&(o=!1);const c=f(),a=m();let r=a.resolve(t);const{root:d}=a.parse(r),l=i?a.resolve(i):void 0,g=(0,_.isArray)(n)?n:[n];for(;r&&r!==d;){if(l&&r===l){for(const u of g){const y=a.join(r,u);try{const h=c.statSync(y);if(!o&&h.isFile())return(0,p.normalizePath)(y);if(!s&&h.isDirectory())return(0,p.normalizePath)(y)}catch{}}return}for(const u of g){const y=a.join(r,u);try{const h=c.statSync(y);if(!o&&h.isFile())return(0,p.normalizePath)(y);if(!s&&h.isDirectory())return(0,p.normalizePath)(y)}catch{}}r=a.dirname(r)}}async function z(n){return!!(await U(n))?.isDirectory()}function X(n){return!!C(n)?.isDirectory()}function j(n,e){const{ignore:t=S.defaultIgnore}={__proto__:null,...e},i=f();try{const o=i.readdirSync(n),{length:s}=o;if(s===0)return!0;const c=(0,S.getGlobMatcher)(t,{cwd:(0,p.pathLikeToString)(n)});let a=0;for(let r=0;r<s;r+=1){const d=o[r];d&&c(d)&&(a+=1)}return a===s}catch{return!1}}function K(n){const e=f();try{return e.lstatSync(n).isSymbolicLink()}catch{}return!1}function H(n){const e=f(),t=[],i=[],{R_OK:o}=e.constants;for(const s of n)try{e.accessSync(s,o),t.push(s)}catch{i.push(s)}return{__proto__:null,validPaths:t,invalidPaths:i}}async function Q(n,e){const t=f();try{return J(await t.promises.readdir(n,{__proto__:null,encoding:"utf8",withFileTypes:!0}),String(n),e)}catch{}return[]}function Y(n,e){const t=f();try{return J(t.readdirSync(n,{__proto__:null,encoding:"utf8",withFileTypes:!0}),String(n),e)}catch{}return[]}async function Z(n,e){const t=typeof e=="string"?{encoding:e}:e;return await f().promises.readFile(n,{signal:w,...t,encoding:null})}async function ee(n,e){const t=typeof e=="string"?{encoding:e}:e;return await f().promises.readFile(n,{signal:w,...t,encoding:"utf8"})}function ne(n,e){const t=typeof e=="string"?{encoding:e}:e;return f().readFileSync(n,{...t,encoding:null})}function te(n,e){const t=typeof e=="string"?{encoding:e}:e;return f().readFileSync(n,{...t,encoding:"utf8"})}async function ie(n,e){const t=typeof e=="string"?{encoding:e}:e,{reviver:i,throws:o,...s}={__proto__:null,...t},c=o===void 0||!!o,a=f();let r="";try{r=await a.promises.readFile(n,{__proto__:null,encoding:"utf8",...s})}catch(d){if(c){const l=d.code;throw l==="ENOENT"?new Error(`JSON file not found: ${n}
-Ensure the file exists or create it with the expected structure.`,{cause:d}):l==="EACCES"||l==="EPERM"?new Error(`Permission denied reading JSON file: ${n}
-Check file permissions or run with appropriate access.`,{cause:d}):d}return}return(0,b.jsonParse)(r,{filepath:String(n),reviver:i,throws:c})}function re(n,e){const t=typeof e=="string"?{encoding:e}:e,{reviver:i,throws:o,...s}={__proto__:null,...t},c=o===void 0||!!o,a=f();let r="";try{r=a.readFileSync(n,{__proto__:null,encoding:"utf8",...s})}catch(d){if(c){const l=d.code;throw l==="ENOENT"?new Error(`JSON file not found: ${n}
-Ensure the file exists or create it with the expected structure.`,{cause:d}):l==="EACCES"||l==="EPERM"?new Error(`Permission denied reading JSON file: ${n}
-Check file permissions or run with appropriate access.`,{cause:d}):d}return}return(0,b.jsonParse)(r,{filepath:String(n),reviver:i,throws:c})}let O;function N(){if(O===void 0){const n=m(),{getOsTmpDir:e,getSocketCacacheDir:t,getSocketUserDir:i}=require("#lib/paths");O=[n.resolve(e()),n.resolve(t()),n.resolve(i())]}return O}function I(){O=void 0}(0,E.registerCacheInvalidation)(I);async function oe(n,e){const t=require("./external/del"),{deleteAsync:i}=t,o={__proto__:null,...e},s=(0,_.isArray)(n)?n.map(p.pathLikeToString):[(0,p.pathLikeToString)(n)];let c=o.force!==!1;if(!c&&s.length>0){const a=m(),r=N();s.every(l=>{const g=a.resolve(l);for(const u of r){const y=g.startsWith(u+a.sep)||g===u,x=a.relative(u,g).startsWith("..");if(y&&!x)return!0}return!1})&&(c=!0)}await i(s,{concurrency:o.maxRetries||L.maxRetries,dryRun:!1,force:c,onlyFiles:!1})}function se(n,e){const t=require("./external/del"),{deleteSync:i}=t,o={__proto__:null,...e},s=(0,_.isArray)(n)?n.map(p.pathLikeToString):[(0,p.pathLikeToString)(n)];let c=o.force!==!1;if(!c&&s.length>0){const a=m(),r=N();s.every(l=>{const g=a.resolve(l);for(const u of r){const y=g.startsWith(u+a.sep)||g===u,x=a.relative(u,g).startsWith("..");if(y&&!x)return!0}return!1})&&(c=!0)}i(s,{concurrency:o.maxRetries||L.maxRetries,dryRun:!1,force:c,onlyFiles:!1})}async function ae(n,e){const t=f();try{await t.promises.mkdir(n,e)}catch(i){if(typeof i=="object"&&i!==null&&"code"in i&&i.code!=="EEXIST")throw i}}function ce(n,e){const t=f();try{t.mkdirSync(n,e)}catch(i){if(typeof i=="object"&&i!==null&&"code"in i&&i.code!=="EEXIST")throw i}}async function de(n,e){const t=typeof e=="string"?{encoding:e}:e,i=f();try{return await i.promises.readFile(n,{signal:w,...t})}catch{}}function fe(n,e){const t=typeof e=="string"?{encoding:e}:e,i=f();try{return i.readFileSync(n,{__proto__:null,...t})}catch{}}async function U(n){const e=f();try{return await e.promises.stat(n)}catch{}}function C(n,e){const t=typeof e=="string"?{encoding:e}:e,i=f();try{return i.statSync(n,{__proto__:null,throwIfNoEntry:!1,...t})}catch{}}function le(n){const e=f(),t=m(),i=String(n);if(!e.existsSync(i))return(0,p.normalizePath)(i);const o=t.dirname(i),s=t.extname(i),c=t.basename(i,s);let a=1,r;do r=t.join(o,`${c}-${a}${s}`),a++;while(e.existsSync(r));return(0,p.normalizePath)(r)}async function ue(n,e,t){const i=typeof t=="string"?{encoding:t}:t,{EOL:o,finalEOL:s,replacer:c,spaces:a,...r}={__proto__:null,...i},d=f(),l=A(e,o||`
-`,s!==void 0?s:!0,c,a);await d.promises.writeFile(n,l,{encoding:"utf8",...r,__proto__:null})}function pe(n,e,t){const i=typeof t=="string"?{encoding:t}:t,{EOL:o,finalEOL:s,replacer:c,spaces:a,...r}={__proto__:null,...i},d=f(),l=A(e,o||`
-`,s!==void 0?s:!0,c,a);d.writeFileSync(n,l,{encoding:"utf8",...r,__proto__:null})}0&&(module.exports={findUp,findUpSync,invalidatePathCache,isDir,isDirEmptySync,isDirSync,isSymLinkSync,readDirNames,readDirNamesSync,readFileBinary,readFileBinarySync,readFileUtf8,readFileUtf8Sync,readJson,readJsonSync,safeDelete,safeDeleteSync,safeMkdir,safeMkdirSync,safeReadFile,safeReadFileSync,safeStats,safeStatsSync,uniqueSync,validateFiles,writeJson,writeJsonSync});
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var fs_exports = {};
+__export(fs_exports, {
+  findUp: () => findUp,
+  findUpSync: () => findUpSync,
+  invalidatePathCache: () => invalidatePathCache,
+  isDir: () => isDir,
+  isDirEmptySync: () => isDirEmptySync,
+  isDirSync: () => isDirSync,
+  isSymLinkSync: () => isSymLinkSync,
+  readDirNames: () => readDirNames,
+  readDirNamesSync: () => readDirNamesSync,
+  readFileBinary: () => readFileBinary,
+  readFileBinarySync: () => readFileBinarySync,
+  readFileUtf8: () => readFileUtf8,
+  readFileUtf8Sync: () => readFileUtf8Sync,
+  readJson: () => readJson,
+  readJsonSync: () => readJsonSync,
+  safeDelete: () => safeDelete,
+  safeDeleteSync: () => safeDeleteSync,
+  safeMkdir: () => safeMkdir,
+  safeMkdirSync: () => safeMkdirSync,
+  safeReadFile: () => safeReadFile,
+  safeReadFileSync: () => safeReadFileSync,
+  safeStats: () => safeStats,
+  safeStatsSync: () => safeStatsSync,
+  uniqueSync: () => uniqueSync,
+  validateFiles: () => validateFiles,
+  writeJson: () => writeJson,
+  writeJsonSync: () => writeJsonSync
+});
+module.exports = __toCommonJS(fs_exports);
+var import_process = require("#constants/process");
+var import_arrays = require("./arrays");
+var import_globs = require("./globs");
+var import_json = require("./json");
+var import_objects = require("./objects");
+var import_path = require("./path");
+var import_rewire = require("./paths/rewire");
+var import_sorts = require("./sorts");
+const abortSignal = (0, import_process.getAbortSignal)();
+const defaultRemoveOptions = (0, import_objects.objectFreeze)({
+  __proto__: null,
+  force: true,
+  maxRetries: 3,
+  recursive: true,
+  retryDelay: 200
+});
+let _fs;
+// @__NO_SIDE_EFFECTS__
+function getFs() {
+  if (_fs === void 0) {
+    _fs = require("node:fs");
+  }
+  return _fs;
+}
+let _path;
+// @__NO_SIDE_EFFECTS__
+function getPath() {
+  if (_path === void 0) {
+    _path = require("node:path");
+  }
+  return _path;
+}
+// @__NO_SIDE_EFFECTS__
+function innerReadDirNames(dirents, dirname, options) {
+  const {
+    ignore,
+    includeEmpty = true,
+    sort = true
+  } = { __proto__: null, ...options };
+  const path = /* @__PURE__ */ getPath();
+  const names = dirents.filter(
+    (d) => d.isDirectory() && (includeEmpty || !/* @__PURE__ */ isDirEmptySync(path.join(dirname || d.parentPath, d.name), {
+      ignore
+    }))
+  ).map((d) => d.name);
+  return sort ? names.sort(import_sorts.naturalCompare) : names;
+}
+// @__NO_SIDE_EFFECTS__
+function stringify(json, EOL, finalEOL, replacer, spaces = 2) {
+  const EOF = finalEOL ? EOL : "";
+  const str = JSON.stringify(json, replacer, spaces);
+  return `${str.replace(/\n/g, EOL)}${EOF}`;
+}
+// @__NO_SIDE_EFFECTS__
+async function findUp(name, options) {
+  const { cwd = process.cwd(), signal = abortSignal } = {
+    __proto__: null,
+    ...options
+  };
+  let { onlyDirectories = false, onlyFiles = true } = {
+    __proto__: null,
+    ...options
+  };
+  if (onlyDirectories) {
+    onlyFiles = false;
+  }
+  if (onlyFiles) {
+    onlyDirectories = false;
+  }
+  const fs = /* @__PURE__ */ getFs();
+  const path = /* @__PURE__ */ getPath();
+  let dir = path.resolve(cwd);
+  const { root } = path.parse(dir);
+  const names = (0, import_arrays.isArray)(name) ? name : [name];
+  while (dir && dir !== root) {
+    for (const n of names) {
+      if (signal?.aborted) {
+        return void 0;
+      }
+      const thePath = path.join(dir, n);
+      try {
+        const stats = await fs.promises.stat(thePath);
+        if (!onlyDirectories && stats.isFile()) {
+          return (0, import_path.normalizePath)(thePath);
+        }
+        if (!onlyFiles && stats.isDirectory()) {
+          return (0, import_path.normalizePath)(thePath);
+        }
+      } catch {
+      }
+    }
+    dir = path.dirname(dir);
+  }
+  return void 0;
+}
+// @__NO_SIDE_EFFECTS__
+function findUpSync(name, options) {
+  const { cwd = process.cwd(), stopAt } = {
+    __proto__: null,
+    ...options
+  };
+  let { onlyDirectories = false, onlyFiles = true } = {
+    __proto__: null,
+    ...options
+  };
+  if (onlyDirectories) {
+    onlyFiles = false;
+  }
+  if (onlyFiles) {
+    onlyDirectories = false;
+  }
+  const fs = /* @__PURE__ */ getFs();
+  const path = /* @__PURE__ */ getPath();
+  let dir = path.resolve(cwd);
+  const { root } = path.parse(dir);
+  const stopDir = stopAt ? path.resolve(stopAt) : void 0;
+  const names = (0, import_arrays.isArray)(name) ? name : [name];
+  while (dir && dir !== root) {
+    if (stopDir && dir === stopDir) {
+      for (const n of names) {
+        const thePath = path.join(dir, n);
+        try {
+          const stats = fs.statSync(thePath);
+          if (!onlyDirectories && stats.isFile()) {
+            return (0, import_path.normalizePath)(thePath);
+          }
+          if (!onlyFiles && stats.isDirectory()) {
+            return (0, import_path.normalizePath)(thePath);
+          }
+        } catch {
+        }
+      }
+      return void 0;
+    }
+    for (const n of names) {
+      const thePath = path.join(dir, n);
+      try {
+        const stats = fs.statSync(thePath);
+        if (!onlyDirectories && stats.isFile()) {
+          return (0, import_path.normalizePath)(thePath);
+        }
+        if (!onlyFiles && stats.isDirectory()) {
+          return (0, import_path.normalizePath)(thePath);
+        }
+      } catch {
+      }
+    }
+    dir = path.dirname(dir);
+  }
+  return void 0;
+}
+// @__NO_SIDE_EFFECTS__
+async function isDir(filepath) {
+  return !!(await /* @__PURE__ */ safeStats(filepath))?.isDirectory();
+}
+// @__NO_SIDE_EFFECTS__
+function isDirSync(filepath) {
+  return !!(/* @__PURE__ */ safeStatsSync(filepath))?.isDirectory();
+}
+// @__NO_SIDE_EFFECTS__
+function isDirEmptySync(dirname, options) {
+  const { ignore = import_globs.defaultIgnore } = {
+    __proto__: null,
+    ...options
+  };
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    const files = fs.readdirSync(dirname);
+    const { length } = files;
+    if (length === 0) {
+      return true;
+    }
+    const matcher = (0, import_globs.getGlobMatcher)(
+      ignore,
+      {
+        cwd: (0, import_path.pathLikeToString)(dirname)
+      }
+    );
+    let ignoredCount = 0;
+    for (let i = 0; i < length; i += 1) {
+      const file = files[i];
+      if (file && matcher(file)) {
+        ignoredCount += 1;
+      }
+    }
+    return ignoredCount === length;
+  } catch {
+    return false;
+  }
+}
+// @__NO_SIDE_EFFECTS__
+function isSymLinkSync(filepath) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    return fs.lstatSync(filepath).isSymbolicLink();
+  } catch {
+  }
+  return false;
+}
+// @__NO_SIDE_EFFECTS__
+function validateFiles(filepaths) {
+  const fs = /* @__PURE__ */ getFs();
+  const validPaths = [];
+  const invalidPaths = [];
+  const { R_OK } = fs.constants;
+  for (const filepath of filepaths) {
+    try {
+      fs.accessSync(filepath, R_OK);
+      validPaths.push(filepath);
+    } catch {
+      invalidPaths.push(filepath);
+    }
+  }
+  return { __proto__: null, validPaths, invalidPaths };
+}
+// @__NO_SIDE_EFFECTS__
+async function readDirNames(dirname, options) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    return /* @__PURE__ */ innerReadDirNames(
+      await fs.promises.readdir(dirname, {
+        __proto__: null,
+        encoding: "utf8",
+        withFileTypes: true
+      }),
+      String(dirname),
+      options
+    );
+  } catch {
+  }
+  return [];
+}
+// @__NO_SIDE_EFFECTS__
+function readDirNamesSync(dirname, options) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    return /* @__PURE__ */ innerReadDirNames(
+      fs.readdirSync(dirname, {
+        __proto__: null,
+        encoding: "utf8",
+        withFileTypes: true
+      }),
+      String(dirname),
+      options
+    );
+  } catch {
+  }
+  return [];
+}
+// @__NO_SIDE_EFFECTS__
+async function readFileBinary(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const fs = /* @__PURE__ */ getFs();
+  return await fs.promises.readFile(filepath, {
+    signal: abortSignal,
+    ...opts,
+    encoding: null
+  });
+}
+// @__NO_SIDE_EFFECTS__
+async function readFileUtf8(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const fs = /* @__PURE__ */ getFs();
+  return await fs.promises.readFile(filepath, {
+    signal: abortSignal,
+    ...opts,
+    encoding: "utf8"
+  });
+}
+// @__NO_SIDE_EFFECTS__
+function readFileBinarySync(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const fs = /* @__PURE__ */ getFs();
+  return fs.readFileSync(filepath, {
+    ...opts,
+    encoding: null
+  });
+}
+// @__NO_SIDE_EFFECTS__
+function readFileUtf8Sync(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const fs = /* @__PURE__ */ getFs();
+  return fs.readFileSync(filepath, {
+    ...opts,
+    encoding: "utf8"
+  });
+}
+// @__NO_SIDE_EFFECTS__
+async function readJson(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const { reviver, throws, ...fsOptions } = {
+    __proto__: null,
+    ...opts
+  };
+  const shouldThrow = throws === void 0 || !!throws;
+  const fs = /* @__PURE__ */ getFs();
+  let content = "";
+  try {
+    content = await fs.promises.readFile(filepath, {
+      __proto__: null,
+      encoding: "utf8",
+      ...fsOptions
+    });
+  } catch (e) {
+    if (shouldThrow) {
+      const code = e.code;
+      if (code === "ENOENT") {
+        throw new Error(
+          `JSON file not found: ${filepath}
+Ensure the file exists or create it with the expected structure.`,
+          { cause: e }
+        );
+      }
+      if (code === "EACCES" || code === "EPERM") {
+        throw new Error(
+          `Permission denied reading JSON file: ${filepath}
+Check file permissions or run with appropriate access.`,
+          { cause: e }
+        );
+      }
+      throw e;
+    }
+    return void 0;
+  }
+  return (0, import_json.jsonParse)(content, {
+    filepath: String(filepath),
+    reviver,
+    throws: shouldThrow
+  });
+}
+// @__NO_SIDE_EFFECTS__
+function readJsonSync(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const { reviver, throws, ...fsOptions } = {
+    __proto__: null,
+    ...opts
+  };
+  const shouldThrow = throws === void 0 || !!throws;
+  const fs = /* @__PURE__ */ getFs();
+  let content = "";
+  try {
+    content = fs.readFileSync(filepath, {
+      __proto__: null,
+      encoding: "utf8",
+      ...fsOptions
+    });
+  } catch (e) {
+    if (shouldThrow) {
+      const code = e.code;
+      if (code === "ENOENT") {
+        throw new Error(
+          `JSON file not found: ${filepath}
+Ensure the file exists or create it with the expected structure.`,
+          { cause: e }
+        );
+      }
+      if (code === "EACCES" || code === "EPERM") {
+        throw new Error(
+          `Permission denied reading JSON file: ${filepath}
+Check file permissions or run with appropriate access.`,
+          { cause: e }
+        );
+      }
+      throw e;
+    }
+    return void 0;
+  }
+  return (0, import_json.jsonParse)(content, {
+    filepath: String(filepath),
+    reviver,
+    throws: shouldThrow
+  });
+}
+let _cachedAllowedDirs;
+function getAllowedDirectories() {
+  if (_cachedAllowedDirs === void 0) {
+    const path = /* @__PURE__ */ getPath();
+    const {
+      getOsTmpDir,
+      getSocketCacacheDir,
+      getSocketUserDir
+    } = require("#lib/paths");
+    _cachedAllowedDirs = [
+      path.resolve(getOsTmpDir()),
+      path.resolve(getSocketCacacheDir()),
+      path.resolve(getSocketUserDir())
+    ];
+  }
+  return _cachedAllowedDirs;
+}
+function invalidatePathCache() {
+  _cachedAllowedDirs = void 0;
+}
+(0, import_rewire.registerCacheInvalidation)(invalidatePathCache);
+// @__NO_SIDE_EFFECTS__
+async function safeDelete(filepath, options) {
+  const del = require("./external/del");
+  const { deleteAsync } = del;
+  const opts = { __proto__: null, ...options };
+  const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_path.pathLikeToString) : [(0, import_path.pathLikeToString)(filepath)];
+  let shouldForce = opts.force !== false;
+  if (!shouldForce && patterns.length > 0) {
+    const path = /* @__PURE__ */ getPath();
+    const allowedDirs = getAllowedDirectories();
+    const allInAllowedDirs = patterns.every((pattern) => {
+      const resolvedPath = path.resolve(pattern);
+      for (const allowedDir of allowedDirs) {
+        const isInAllowedDir = resolvedPath.startsWith(allowedDir + path.sep) || resolvedPath === allowedDir;
+        const relativePath = path.relative(allowedDir, resolvedPath);
+        const isGoingBackward = relativePath.startsWith("..");
+        if (isInAllowedDir && !isGoingBackward) {
+          return true;
+        }
+      }
+      return false;
+    });
+    if (allInAllowedDirs) {
+      shouldForce = true;
+    }
+  }
+  await deleteAsync(patterns, {
+    concurrency: opts.maxRetries || defaultRemoveOptions.maxRetries,
+    dryRun: false,
+    force: shouldForce,
+    onlyFiles: false
+  });
+}
+// @__NO_SIDE_EFFECTS__
+function safeDeleteSync(filepath, options) {
+  const del = require("./external/del");
+  const { deleteSync } = del;
+  const opts = { __proto__: null, ...options };
+  const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_path.pathLikeToString) : [(0, import_path.pathLikeToString)(filepath)];
+  let shouldForce = opts.force !== false;
+  if (!shouldForce && patterns.length > 0) {
+    const path = /* @__PURE__ */ getPath();
+    const allowedDirs = getAllowedDirectories();
+    const allInAllowedDirs = patterns.every((pattern) => {
+      const resolvedPath = path.resolve(pattern);
+      for (const allowedDir of allowedDirs) {
+        const isInAllowedDir = resolvedPath.startsWith(allowedDir + path.sep) || resolvedPath === allowedDir;
+        const relativePath = path.relative(allowedDir, resolvedPath);
+        const isGoingBackward = relativePath.startsWith("..");
+        if (isInAllowedDir && !isGoingBackward) {
+          return true;
+        }
+      }
+      return false;
+    });
+    if (allInAllowedDirs) {
+      shouldForce = true;
+    }
+  }
+  deleteSync(patterns, {
+    concurrency: opts.maxRetries || defaultRemoveOptions.maxRetries,
+    dryRun: false,
+    force: shouldForce,
+    onlyFiles: false
+  });
+}
+// @__NO_SIDE_EFFECTS__
+async function safeMkdir(path, options) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    await fs.promises.mkdir(path, options);
+  } catch (e) {
+    if (typeof e === "object" && e !== null && "code" in e && e.code !== "EEXIST") {
+      throw e;
+    }
+  }
+}
+// @__NO_SIDE_EFFECTS__
+function safeMkdirSync(path, options) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    fs.mkdirSync(path, options);
+  } catch (e) {
+    if (typeof e === "object" && e !== null && "code" in e && e.code !== "EEXIST") {
+      throw e;
+    }
+  }
+}
+// @__NO_SIDE_EFFECTS__
+async function safeReadFile(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    return await fs.promises.readFile(filepath, {
+      signal: abortSignal,
+      ...opts
+    });
+  } catch {
+  }
+  return void 0;
+}
+// @__NO_SIDE_EFFECTS__
+function safeReadFileSync(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    return fs.readFileSync(filepath, {
+      __proto__: null,
+      ...opts
+    });
+  } catch {
+  }
+  return void 0;
+}
+// @__NO_SIDE_EFFECTS__
+async function safeStats(filepath) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    return await fs.promises.stat(filepath);
+  } catch {
+  }
+  return void 0;
+}
+// @__NO_SIDE_EFFECTS__
+function safeStatsSync(filepath, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    return fs.statSync(filepath, {
+      __proto__: null,
+      throwIfNoEntry: false,
+      ...opts
+    });
+  } catch {
+  }
+  return void 0;
+}
+// @__NO_SIDE_EFFECTS__
+function uniqueSync(filepath) {
+  const fs = /* @__PURE__ */ getFs();
+  const path = /* @__PURE__ */ getPath();
+  const filepathStr = String(filepath);
+  if (!fs.existsSync(filepathStr)) {
+    return (0, import_path.normalizePath)(filepathStr);
+  }
+  const dirname = path.dirname(filepathStr);
+  const ext = path.extname(filepathStr);
+  const basename = path.basename(filepathStr, ext);
+  let counter = 1;
+  let uniquePath;
+  do {
+    uniquePath = path.join(dirname, `${basename}-${counter}${ext}`);
+    counter++;
+  } while (fs.existsSync(uniquePath));
+  return (0, import_path.normalizePath)(uniquePath);
+}
+// @__NO_SIDE_EFFECTS__
+async function writeJson(filepath, jsonContent, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {
+    __proto__: null,
+    ...opts
+  };
+  const fs = /* @__PURE__ */ getFs();
+  const jsonString = /* @__PURE__ */ stringify(
+    jsonContent,
+    EOL || "\n",
+    finalEOL !== void 0 ? finalEOL : true,
+    replacer,
+    spaces
+  );
+  await fs.promises.writeFile(filepath, jsonString, {
+    encoding: "utf8",
+    ...fsOptions,
+    __proto__: null
+  });
+}
+// @__NO_SIDE_EFFECTS__
+function writeJsonSync(filepath, jsonContent, options) {
+  const opts = typeof options === "string" ? { encoding: options } : options;
+  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {
+    __proto__: null,
+    ...opts
+  };
+  const fs = /* @__PURE__ */ getFs();
+  const jsonString = /* @__PURE__ */ stringify(
+    jsonContent,
+    EOL || "\n",
+    finalEOL !== void 0 ? finalEOL : true,
+    replacer,
+    spaces
+  );
+  fs.writeFileSync(filepath, jsonString, {
+    encoding: "utf8",
+    ...fsOptions,
+    __proto__: null
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  findUp,
+  findUpSync,
+  invalidatePathCache,
+  isDir,
+  isDirEmptySync,
+  isDirSync,
+  isSymLinkSync,
+  readDirNames,
+  readDirNamesSync,
+  readFileBinary,
+  readFileBinarySync,
+  readFileUtf8,
+  readFileUtf8Sync,
+  readJson,
+  readJsonSync,
+  safeDelete,
+  safeDeleteSync,
+  safeMkdir,
+  safeMkdirSync,
+  safeReadFile,
+  safeReadFileSync,
+  safeStats,
+  safeStatsSync,
+  uniqueSync,
+  validateFiles,
+  writeJson,
+  writeJsonSync
+});
 //# sourceMappingURL=fs.js.map