@socketsecurity/lib 3.0.1 → 3.0.3

package/dist/arrays.js

@@ -1,3 +1,87 @@
 /* Socket Lib - Built with esbuild */
-var u=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var m=(n,t)=>{for(var e in t)u(n,e,{get:t[e],enumerable:!0})},y=(n,t,e,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of d(t))!f.call(n,r)&&r!==e&&u(n,r,{get:()=>t[r],enumerable:!(o=l(t,r))||o.enumerable});return n};var g=n=>y(u({},"__esModule",{value:!0}),n);var x={};m(x,{arrayChunk:()=>j,arrayUnique:()=>p,isArray:()=>F,joinAnd:()=>k,joinOr:()=>w});module.exports=g(x);let s;function h(){return s===void 0&&(s=new Intl.ListFormat("en",{style:"long",type:"conjunction"})),s}let a;function T(){return a===void 0&&(a=new Intl.ListFormat("en",{style:"long",type:"disjunction"})),a}function j(n,t){const e=t??2;if(e<=0)throw new Error("Chunk size must be greater than 0");const{length:o}=n,r=Math.min(o,e),c=[];for(let i=0;i<o;i+=r)c.push(n.slice(i,i+r));return c}function p(n){return[...new Set(n)]}const F=Array.isArray;function k(n){return h().format(n)}function w(n){return T().format(n)}0&&(module.exports={arrayChunk,arrayUnique,isArray,joinAnd,joinOr});
+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 arrays_exports = {};
+__export(arrays_exports, {
+  arrayChunk: () => arrayChunk,
+  arrayUnique: () => arrayUnique,
+  isArray: () => isArray,
+  joinAnd: () => joinAnd,
+  joinOr: () => joinOr
+});
+module.exports = __toCommonJS(arrays_exports);
+let _conjunctionFormatter;
+// @__NO_SIDE_EFFECTS__
+function getConjunctionFormatter() {
+  if (_conjunctionFormatter === void 0) {
+    _conjunctionFormatter = new Intl.ListFormat("en", {
+      style: "long",
+      // "and" lists.
+      type: "conjunction"
+    });
+  }
+  return _conjunctionFormatter;
+}
+let _disjunctionFormatter;
+// @__NO_SIDE_EFFECTS__
+function getDisjunctionFormatter() {
+  if (_disjunctionFormatter === void 0) {
+    _disjunctionFormatter = new Intl.ListFormat("en", {
+      style: "long",
+      // "or" lists.
+      type: "disjunction"
+    });
+  }
+  return _disjunctionFormatter;
+}
+// @__NO_SIDE_EFFECTS__
+function arrayChunk(arr, size) {
+  const chunkSize = size ?? 2;
+  if (chunkSize <= 0) {
+    throw new Error("Chunk size must be greater than 0");
+  }
+  const { length } = arr;
+  const actualChunkSize = Math.min(length, chunkSize);
+  const chunks = [];
+  for (let i = 0; i < length; i += actualChunkSize) {
+    chunks.push(arr.slice(i, i + actualChunkSize));
+  }
+  return chunks;
+}
+// @__NO_SIDE_EFFECTS__
+function arrayUnique(arr) {
+  return [...new Set(arr)];
+}
+const isArray = Array.isArray;
+// @__NO_SIDE_EFFECTS__
+function joinAnd(arr) {
+  return (/* @__PURE__ */ getConjunctionFormatter()).format(arr);
+}
+// @__NO_SIDE_EFFECTS__
+function joinOr(arr) {
+  return (/* @__PURE__ */ getDisjunctionFormatter()).format(arr);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  arrayChunk,
+  arrayUnique,
+  isArray,
+  joinAnd,
+  joinOr
+});
 //# sourceMappingURL=arrays.js.map

package/dist/arrays.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/arrays.ts"],
   "sourcesContent": ["/**\n * @fileoverview Array utility functions for formatting lists and collections.\n * Provides conjunction and disjunction formatters using Intl.ListFormat.\n */\n\nlet _conjunctionFormatter: Intl.ListFormat | undefined\n/**\n * Get a cached Intl.ListFormat instance for conjunction (and) formatting.\n *\n * Creates a singleton formatter for English \"and\" lists using the long style.\n * The formatter is lazily initialized on first use and reused for performance.\n *\n * @returns Cached Intl.ListFormat instance configured for conjunction formatting\n *\n * @example\n * ```ts\n * const formatter = getConjunctionFormatter()\n * formatter.format(['apple', 'banana', 'cherry'])\n * // Returns: \"apple, banana, and cherry\"\n * ```\n *\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getConjunctionFormatter() {\n  if (_conjunctionFormatter === undefined) {\n    _conjunctionFormatter = new Intl.ListFormat('en', {\n      style: 'long',\n      // \"and\" lists.\n      type: 'conjunction',\n    })\n  }\n  return _conjunctionFormatter\n}\n\nlet _disjunctionFormatter: Intl.ListFormat | undefined\n/**\n * Get a cached Intl.ListFormat instance for disjunction (or) formatting.\n *\n * Creates a singleton formatter for English \"or\" lists using the long style.\n * The formatter is lazily initialized on first use and reused for performance.\n *\n * @returns Cached Intl.ListFormat instance configured for disjunction formatting\n *\n * @example\n * ```ts\n * const formatter = getDisjunctionFormatter()\n * formatter.format(['red', 'blue', 'green'])\n * // Returns: \"red, blue, or green\"\n * ```\n *\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getDisjunctionFormatter() {\n  if (_disjunctionFormatter === undefined) {\n    _disjunctionFormatter = new Intl.ListFormat('en', {\n      style: 'long',\n      // \"or\" lists.\n      type: 'disjunction',\n    })\n  }\n  return _disjunctionFormatter\n}\n\n/**\n * Split an array into chunks of a specified size.\n *\n * Divides an array into smaller arrays of the specified chunk size.\n * The last chunk may contain fewer elements if the array length is not\n * evenly divisible by the chunk size.\n *\n * @param arr - The array to split into chunks (can be readonly)\n * @param size - Size of each chunk. Must be greater than 0.\n * @default 2\n * @returns Array of chunks, where each chunk is an array of elements\n * @throws {Error} If chunk size is less than or equal to 0\n *\n * @example\n * ```ts\n * // Split into pairs (default)\n * arrayChunk([1, 2, 3, 4, 5])\n * // Returns: [[1, 2], [3, 4], [5]]\n *\n * // Split into groups of 3\n * arrayChunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3)\n * // Returns: [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]\n *\n * // Works with readonly arrays\n * const readonlyArr = [1, 2, 3] as const\n * arrayChunk(readonlyArr)\n * // Returns: [[1, 2], [3]]\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function arrayChunk<T>(\n  arr: T[] | readonly T[],\n  size?: number | undefined,\n): T[][] {\n  const chunkSize = size ?? 2\n  if (chunkSize <= 0) {\n    throw new Error('Chunk size must be greater than 0')\n  }\n  const { length } = arr\n  const actualChunkSize = Math.min(length, chunkSize)\n  const chunks = []\n  for (let i = 0; i < length; i += actualChunkSize) {\n    chunks.push(arr.slice(i, i + actualChunkSize) as T[])\n  }\n  return chunks\n}\n\n/**\n * Get unique values from an array.\n *\n * Returns a new array containing only the unique values from the input array.\n * Uses `Set` internally for efficient deduplication. Order of first occurrence\n * is preserved.\n *\n * @param arr - The array to deduplicate (can be readonly)\n * @returns New array with duplicate values removed\n *\n * @example\n * ```ts\n * // Remove duplicate numbers\n * arrayUnique([1, 2, 2, 3, 1, 4])\n * // Returns: [1, 2, 3, 4]\n *\n * // Remove duplicate strings\n * arrayUnique(['apple', 'banana', 'apple', 'cherry'])\n * // Returns: ['apple', 'banana', 'cherry']\n *\n * // Works with readonly arrays\n * const readonlyArr = [1, 1, 2] as const\n * arrayUnique(readonlyArr)\n * // Returns: [1, 2]\n *\n * // Empty arrays return empty\n * arrayUnique([])\n * // Returns: []\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function arrayUnique<T>(arr: T[] | readonly T[]): T[] {\n  return [...new Set(arr)]\n}\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\n\n/**\n * Alias for native Array.isArray.\n * Determines whether the passed value is an array.\n *\n * This is a direct reference to the native `Array.isArray` method,\n * providing a type guard that narrows the type to an array type.\n * Exported for consistency with other array utilities in this module.\n *\n * @param value - The value to check\n * @returns `true` if the value is an array, `false` otherwise\n *\n * @example\n * ```ts\n * // Check if value is an array\n * isArray([1, 2, 3])\n * // Returns: true\n *\n * isArray('not an array')\n * // Returns: false\n *\n * isArray(null)\n * // Returns: false\n *\n * // Type guard usage\n * function processValue(value: unknown) {\n *   if (isArray(value)) {\n *     // TypeScript knows value is an array here\n *     console.log(value.length)\n *   }\n * }\n * ```\n */\nexport const isArray = Array.isArray\n\n/**\n * Join array elements with proper \"and\" conjunction formatting.\n *\n * Formats an array of strings into a grammatically correct list using\n * \"and\" as the conjunction. Uses `Intl.ListFormat` for proper English\n * formatting with Oxford comma support.\n *\n * @param arr - Array of strings to join (can be readonly)\n * @returns Formatted string with proper \"and\" conjunction\n *\n * @example\n * ```ts\n * // Two items\n * joinAnd(['apples', 'oranges'])\n * // Returns: \"apples and oranges\"\n *\n * // Three or more items (Oxford comma)\n * joinAnd(['apples', 'oranges', 'bananas'])\n * // Returns: \"apples, oranges, and bananas\"\n *\n * // Single item\n * joinAnd(['apples'])\n * // Returns: \"apples\"\n *\n * // Empty array\n * joinAnd([])\n * // Returns: \"\"\n *\n * // Usage in messages\n * const items = ['React', 'Vue', 'Angular']\n * console.log(`You can choose ${joinAnd(items)}`)\n * // Outputs: \"You can choose React, Vue, and Angular\"\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function joinAnd(arr: string[] | readonly string[]): string {\n  return getConjunctionFormatter().format(arr)\n}\n\n/**\n * Join array elements with proper \"or\" disjunction formatting.\n *\n * Formats an array of strings into a grammatically correct list using\n * \"or\" as the disjunction. Uses `Intl.ListFormat` for proper English\n * formatting with Oxford comma support.\n *\n * @param arr - Array of strings to join (can be readonly)\n * @returns Formatted string with proper \"or\" disjunction\n *\n * @example\n * ```ts\n * // Two items\n * joinOr(['yes', 'no'])\n * // Returns: \"yes or no\"\n *\n * // Three or more items (Oxford comma)\n * joinOr(['red', 'green', 'blue'])\n * // Returns: \"red, green, or blue\"\n *\n * // Single item\n * joinOr(['maybe'])\n * // Returns: \"maybe\"\n *\n * // Empty array\n * joinOr([])\n * // Returns: \"\"\n *\n * // Usage in prompts\n * const options = ['npm', 'yarn', 'pnpm']\n * console.log(`Choose a package manager: ${joinOr(options)}`)\n * // Outputs: \"Choose a package manager: npm, yarn, or pnpm\"\n * ```\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function joinOr(arr: string[] | readonly string[]): string {\n  return getDisjunctionFormatter().format(arr)\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,gBAAAE,EAAA,gBAAAC,EAAA,YAAAC,EAAA,YAAAC,EAAA,WAAAC,IAAA,eAAAC,EAAAP,GAKA,IAAIQ,EAmBJ,SAASC,GAA0B,CACjC,OAAID,IAA0B,SAC5BA,EAAwB,IAAI,KAAK,WAAW,KAAM,CAChD,MAAO,OAEP,KAAM,aACR,CAAC,GAEIA,CACT,CAEA,IAAIE,EAmBJ,SAASC,GAA0B,CACjC,OAAID,IAA0B,SAC5BA,EAAwB,IAAI,KAAK,WAAW,KAAM,CAChD,MAAO,OAEP,KAAM,aACR,CAAC,GAEIA,CACT,CAgCO,SAASR,EACdU,EACAC,EACO,CACP,MAAMC,EAAYD,GAAQ,EAC1B,GAAIC,GAAa,EACf,MAAM,IAAI,MAAM,mCAAmC,EAErD,KAAM,CAAE,OAAAC,CAAO,EAAIH,EACbI,EAAkB,KAAK,IAAID,EAAQD,CAAS,EAC5CG,EAAS,CAAC,EAChB,QAAS,EAAI,EAAG,EAAIF,EAAQ,GAAKC,EAC/BC,EAAO,KAAKL,EAAI,MAAM,EAAG,EAAII,CAAe,CAAQ,EAEtD,OAAOC,CACT,CAiCO,SAASd,EAAeS,EAA8B,CAC3D,MAAO,CAAC,GAAG,IAAI,IAAIA,CAAG,CAAC,CACzB,CAuCO,MAAMR,EAAU,MAAM,QAqCtB,SAASC,EAAQO,EAA2C,CACjE,OAAOH,EAAwB,EAAE,OAAOG,CAAG,CAC7C,CAqCO,SAASN,EAAOM,EAA2C,CAChE,OAAOD,EAAwB,EAAE,OAAOC,CAAG,CAC7C",
-  "names": ["arrays_exports", "__export", "arrayChunk", "arrayUnique", "isArray", "joinAnd", "joinOr", "__toCommonJS", "_conjunctionFormatter", "getConjunctionFormatter", "_disjunctionFormatter", "getDisjunctionFormatter", "arr", "size", "chunkSize", "length", "actualChunkSize", "chunks"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,IAAI;AAAA;AAmBJ,SAAS,0BAA0B;AACjC,MAAI,0BAA0B,QAAW;AACvC,4BAAwB,IAAI,KAAK,WAAW,MAAM;AAAA,MAChD,OAAO;AAAA;AAAA,MAEP,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,IAAI;AAAA;AAmBJ,SAAS,0BAA0B;AACjC,MAAI,0BAA0B,QAAW;AACvC,4BAAwB,IAAI,KAAK,WAAW,MAAM;AAAA,MAChD,OAAO;AAAA;AAAA,MAEP,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAAA;AAgCO,SAAS,WACd,KACA,MACO;AACP,QAAM,YAAY,QAAQ;AAC1B,MAAI,aAAa,GAAG;AAClB,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AACA,QAAM,EAAE,OAAO,IAAI;AACnB,QAAM,kBAAkB,KAAK,IAAI,QAAQ,SAAS;AAClD,QAAM,SAAS,CAAC;AAChB,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK,iBAAiB;AAChD,WAAO,KAAK,IAAI,MAAM,GAAG,IAAI,eAAe,CAAQ;AAAA,EACtD;AACA,SAAO;AACT;AAAA;AAiCO,SAAS,YAAe,KAA8B;AAC3D,SAAO,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC;AACzB;AAuCO,MAAM,UAAU,MAAM;AAAA;AAqCtB,SAAS,QAAQ,KAA2C;AACjE,UAAO,wCAAwB,GAAE,OAAO,GAAG;AAC7C;AAAA;AAqCO,SAAS,OAAO,KAA2C;AAChE,UAAO,wCAAwB,GAAE,OAAO,GAAG;AAC7C;",
+  "names": []
 }

package/dist/bin.js

@@ -1,11 +1,425 @@
 /* Socket Lib - Built with esbuild */
-var j=Object.defineProperty;var J=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var T=(n,e)=>{for(var r in e)j(n,r,{get:e[r],enumerable:!0})},k=(n,e,r,c)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of W(e))!F.call(n,s)&&s!==r&&j(n,s,{get:()=>e[s],enumerable:!(c=J(e,s))||c.enumerable});return n};var H=n=>k(j({},"__esModule",{value:!0}),n);var V={};T(V,{execBin:()=>X,findRealBin:()=>_,findRealNpm:()=>M,findRealPnpm:()=>z,findRealYarn:()=>U,isShadowBinPath:()=>A,resolveBinPathSync:()=>g,which:()=>q,whichBin:()=>D,whichBinSync:()=>P,whichSync:()=>R});module.exports=H(V);var y=require("#env/home"),x=require("#env/windows"),O=require("#env/xdg"),S=require("#constants/platform"),N=require("./fs"),m=require("./path"),E=require("./spawn");let I;function C(){return I===void 0&&(I=require("node:fs")),I}let v;function h(){return v===void 0&&(v=require("node:path")),v}let B;function w(){return B===void 0&&(B=require("./external/which")),B}async function X(n,e,r){const c=(0,m.isPath)(n)?g(n):await D(n);if(!c){const i=new Error(`Binary not found: ${n}
+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 bin_exports = {};
+__export(bin_exports, {
+  execBin: () => execBin,
+  findRealBin: () => findRealBin,
+  findRealNpm: () => findRealNpm,
+  findRealPnpm: () => findRealPnpm,
+  findRealYarn: () => findRealYarn,
+  isShadowBinPath: () => isShadowBinPath,
+  resolveBinPathSync: () => resolveBinPathSync,
+  which: () => which,
+  whichBin: () => whichBin,
+  whichBinSync: () => whichBinSync,
+  whichSync: () => whichSync
+});
+module.exports = __toCommonJS(bin_exports);
+var import_home = require("#env/home");
+var import_windows = require("#env/windows");
+var import_xdg = require("#env/xdg");
+var import_platform = require("#constants/platform");
+var import_fs = require("./fs");
+var import_path = require("./path");
+var import_spawn = require("./spawn");
+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;
+}
+let _which;
+// @__NO_SIDE_EFFECTS__
+function getWhich() {
+  if (_which === void 0) {
+    _which = require("./external/which");
+  }
+  return _which;
+}
+// @__NO_SIDE_EFFECTS__
+async function execBin(binPath, args, options) {
+  const resolvedPath = (0, import_path.isPath)(binPath) ? /* @__PURE__ */ resolveBinPathSync(binPath) : await whichBin(binPath);
+  if (!resolvedPath) {
+    const error = new Error(
+      `Binary not found: ${binPath}
 Possible causes:
-  - Binary "${n}" is not installed or not in PATH
+  - Binary "${binPath}" is not installed or not in PATH
   - Binary name is incorrect or misspelled
   - Installation directory is not in system PATH
 To resolve:
-  1. Verify "${n}" is installed: which ${n} (Unix) or where ${n} (Windows)
-  2. Install the binary if missing, ex: npm install -g ${n}
-  3. Check PATH environment variable includes the binary location`);throw i.code="ENOENT",i}const s=Array.isArray(c)?c[0]:c;return await(0,E.spawn)(s,e??[],{shell:S.WIN32,...r})}async function q(n,e){return await w()(n,e)}function R(n,e){return w().sync(n,e)}async function D(n,e){const r=w(),c={nothrow:!0,...e},s=await r(n,c);if(c?.all){const i=Array.isArray(s)?s:typeof s=="string"?[s]:void 0;return i?.length?i.map(p=>g(p)):i}if(s)return g(s)}function P(n,e){const r={nothrow:!0,...e},c=R(n,r);if(r.all){const s=Array.isArray(c)?c:typeof c=="string"?[c]:void 0;return s?.length?s.map(i=>g(i)):s}if(c)return g(c)}function A(n){return n?n.replace(/\\/g,"/").includes("node_modules/.bin"):!1}function _(n,e=[]){const r=C(),c=h(),s=w();for(const p of e)if(r?.existsSync(p))return p;const i=s?.sync(n,{nothrow:!0});if(i){const p=c?.dirname(i);if(A(p)){const a=s?.sync(n,{all:!0,nothrow:!0})||[],l=Array.isArray(a)?a:typeof a=="string"?[a]:[];for(const d of l){const o=c?.dirname(d);if(!A(o))return d}}return i}}function M(){const n=C(),e=h(),r=e?.dirname(process.execPath),c=e?.join(r,"npm");if(n?.existsSync(c))return c;const i=_("npm",["/usr/local/bin/npm","/usr/bin/npm"]);if(i&&n?.existsSync(i))return i;const p=P("npm",{nothrow:!0});return p&&typeof p=="string"&&n?.existsSync(p)?p:"npm"}function z(){const n=h(),e=S.WIN32?[n?.join((0,x.getAppdata)(),"npm","pnpm.cmd"),n?.join((0,x.getAppdata)(),"npm","pnpm"),n?.join((0,x.getLocalappdata)(),"pnpm","pnpm.cmd"),n?.join((0,x.getLocalappdata)(),"pnpm","pnpm"),"C:\\Program Files\\nodejs\\pnpm.cmd","C:\\Program Files\\nodejs\\pnpm"].filter(Boolean):["/usr/local/bin/pnpm","/usr/bin/pnpm",n?.join((0,O.getXdgDataHome)()||`${(0,y.getHome)()}/.local/share`,"pnpm/pnpm"),n?.join((0,y.getHome)(),".pnpm/pnpm")].filter(Boolean);return _("pnpm",e)??""}function U(){const n=h(),e=["/usr/local/bin/yarn","/usr/bin/yarn",n?.join((0,y.getHome)(),".yarn/bin/yarn"),n?.join((0,y.getHome)(),".config/yarn/global/node_modules/.bin/yarn")].filter(Boolean);return _("yarn",e)??""}function g(n){const e=C(),r=h();if(!r?.isAbsolute(n))try{const a=P(n);a&&(n=a)}catch{}if(n=(0,m.normalizePath)(n),n===".")return n;const c=r?.extname(n),s=c.toLowerCase(),i=r?.basename(n,c),p=i==="node"?-1:/(?<=\/)\.volta\//i.exec(n)?.index??-1;if(p!==-1){const a=n.slice(0,p),l=r?.join(a,"tools"),d=r?.join(l,"image"),o=r?.join(l,"user"),t=(0,N.readJsonSync)(r?.join(o,"platform.json"),{throws:!1}),u=t?.node?.runtime,L=t?.node?.npm;let f="";if(i==="npm"||i==="npx"){if(L){const $=`bin/${i}-cli.js`;f=r?.join(d,`npm/${L}/${$}`),u&&!e?.existsSync(f)&&(f=r?.join(d,`node/${u}/lib/node_modules/npm/${$}`),e?.existsSync(f)||(f=""))}}else{const $=r?.join(o,"bin"),b=(0,N.readJsonSync)(r?.join($,`${i}.json`),{throws:!1})?.package;b&&(f=r?.join(d,`packages/${b}/bin/${i}`),e?.existsSync(f)||(f=`${f}.cmd`,e?.existsSync(f)||(f="")))}if(f){try{return(0,m.normalizePath)(e?.realpathSync.native(f))}catch{}return f}}if(S.WIN32){const a=s===""||s===".cmd"||s===".exe"||s===".ps1",l=i==="npm"||i==="npx",d=i==="pnpm"||i==="yarn";if(a&&l){const t=r?.join(r?.dirname(n),`node_modules/npm/bin/${i}-cli.js`);if(e?.existsSync(t)){try{return e?.realpathSync.native(t)}catch{}return t}}let o="";if(a&&s!==".exe"&&e?.existsSync(n)){const t=e?.readFileSync(n,"utf8");l?s===".cmd"?o=i==="npm"?/(?<="NPM_CLI_JS=%~dp0\\).*(?=")/.exec(t)?.[0]||"":/(?<="NPX_CLI_JS=%~dp0\\).*(?=")/.exec(t)?.[0]||"":s===""?o=i==="npm"?/(?<=NPM_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(t)?.[0]||"":/(?<=NPX_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(t)?.[0]||"":s===".ps1"&&(o=i==="npm"?/(?<=\$NPM_CLI_JS="\$PSScriptRoot\/).*(?=")/.exec(t)?.[0]||"":/(?<=\$NPX_CLI_JS="\$PSScriptRoot\/).*(?=")/.exec(t)?.[0]||""):d?s===".cmd"?(o=/(?<=node\s+")%~dp0\\([^"]+)(?="\s+%\*)/.exec(t)?.[1]||"",o||(o=/(?<="%~dp0\\[^"]*node[^"]*"\s+")%~dp0\\([^"]+)(?="\s+%\*)/.exec(t)?.[1]||""),o||(o=/(?<="%dp0%\\).*(?=" %\*\r\n)/.exec(t)?.[0]||"")):s===""?(o=/(?<="\$basedir\/)\.tools\/pnpm\/[^"]+(?="\s+"\$@")/.exec(t)?.[0]||"",o||(o=/(?<=exec\s+node\s+"\$basedir\/)\.tools\/pnpm\/[^"]+(?="\s+"\$@")/.exec(t)?.[0]||""),o||(o=/(?<="\$basedir\/).*(?=" "\$@"\n)/.exec(t)?.[0]||"")):s===".ps1"&&(o=/(?<="\$basedir\/).*(?=" $args\n)/.exec(t)?.[0]||""):s===".cmd"?o=/(?<="%dp0%\\).*(?=" %\*\r\n)/.exec(t)?.[0]||"":s===""?o=/(?<="$basedir\/).*(?=" "\$@"\n)/.exec(t)?.[0]||"":s===".ps1"&&(o=/(?<="\$basedir\/).*(?=" $args\n)/.exec(t)?.[0]||""),o&&(n=(0,m.normalizePath)(r?.resolve(r?.dirname(n),o)))}}else{let a=s==="";const l=i==="pnpm"||i==="yarn",d=i==="npm"||i==="npx";if(l&&n.includes("/.bin/pnpm/bin/")){const o=n.indexOf("/.bin/pnpm");if(o!==-1){const t=n.slice(0,o+10);try{(e?.statSync(t)).isFile()&&(n=(0,m.normalizePath)(t),a=!r?.extname(n))}catch{}}}if(a&&(l||d)&&e?.existsSync(n)){const o=e?.readFileSync(n,"utf8");let t="";if(l){if(t=/(?<="\$basedir\/)\.tools\/[^"]+(?="\s+"\$@")/.exec(o)?.[0]||"",t||(t=/(?<="\$basedir\/)[^"]+(?="\s+"\$@")/.exec(o)?.[0]||""),!t){const u=/exec\s+node\s+"?\$basedir\/([^"]+)"?\s+"\$@"/.exec(o);u&&(t=u[1]||"")}t&&i==="pnpm"&&t.startsWith("pnpm/")&&(t=`../${t}`)}else d&&(t=i==="npm"?/(?<=NPM_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(o)?.[0]||"":/(?<=NPX_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(o)?.[0]||"");t&&(n=(0,m.normalizePath)(r?.resolve(r?.dirname(n),t)))}}try{const a=e?.realpathSync.native(n);return(0,m.normalizePath)(a)}catch{}return(0,m.normalizePath)(n)}0&&(module.exports={execBin,findRealBin,findRealNpm,findRealPnpm,findRealYarn,isShadowBinPath,resolveBinPathSync,which,whichBin,whichBinSync,whichSync});
+  1. Verify "${binPath}" is installed: which ${binPath} (Unix) or where ${binPath} (Windows)
+  2. Install the binary if missing, ex: npm install -g ${binPath}
+  3. Check PATH environment variable includes the binary location`
+    );
+    error.code = "ENOENT";
+    throw error;
+  }
+  const binCommand = Array.isArray(resolvedPath) ? resolvedPath[0] : resolvedPath;
+  return await (0, import_spawn.spawn)(binCommand, args ?? [], {
+    shell: import_platform.WIN32,
+    ...options
+  });
+}
+async function which(binName, options) {
+  return await (/* @__PURE__ */ getWhich())(binName, options);
+}
+function whichSync(binName, options) {
+  return (/* @__PURE__ */ getWhich()).sync(binName, options);
+}
+async function whichBin(binName, options) {
+  const which2 = /* @__PURE__ */ getWhich();
+  const opts = { nothrow: true, ...options };
+  const result = await which2(binName, opts);
+  if (opts?.all) {
+    const paths = Array.isArray(result) ? result : typeof result === "string" ? [result] : void 0;
+    return paths?.length ? paths.map((p) => /* @__PURE__ */ resolveBinPathSync(p)) : paths;
+  }
+  if (!result) {
+    return void 0;
+  }
+  return /* @__PURE__ */ resolveBinPathSync(result);
+}
+function whichBinSync(binName, options) {
+  const opts = { nothrow: true, ...options };
+  const result = whichSync(binName, opts);
+  if (opts.all) {
+    const paths = Array.isArray(result) ? result : typeof result === "string" ? [result] : void 0;
+    return paths?.length ? paths.map((p) => /* @__PURE__ */ resolveBinPathSync(p)) : paths;
+  }
+  if (!result) {
+    return void 0;
+  }
+  return /* @__PURE__ */ resolveBinPathSync(result);
+}
+function isShadowBinPath(dirPath) {
+  if (!dirPath) {
+    return false;
+  }
+  const normalized = dirPath.replace(/\\/g, "/");
+  return normalized.includes("node_modules/.bin");
+}
+function findRealBin(binName, commonPaths = []) {
+  const fs = /* @__PURE__ */ getFs();
+  const path = /* @__PURE__ */ getPath();
+  const which2 = /* @__PURE__ */ getWhich();
+  for (const binPath2 of commonPaths) {
+    if (fs?.existsSync(binPath2)) {
+      return binPath2;
+    }
+  }
+  const binPath = which2?.sync(binName, { nothrow: true });
+  if (binPath) {
+    const binDir = path?.dirname(binPath);
+    if (isShadowBinPath(binDir)) {
+      const allPaths = which2?.sync(binName, { all: true, nothrow: true }) || [];
+      const pathsArray = Array.isArray(allPaths) ? allPaths : typeof allPaths === "string" ? [allPaths] : [];
+      for (const altPath of pathsArray) {
+        const altDir = path?.dirname(altPath);
+        if (!isShadowBinPath(altDir)) {
+          return altPath;
+        }
+      }
+    }
+    return binPath;
+  }
+  return void 0;
+}
+function findRealNpm() {
+  const fs = /* @__PURE__ */ getFs();
+  const path = /* @__PURE__ */ getPath();
+  const nodeDir = path?.dirname(process.execPath);
+  const npmInNodeDir = path?.join(nodeDir, "npm");
+  if (fs?.existsSync(npmInNodeDir)) {
+    return npmInNodeDir;
+  }
+  const commonPaths = ["/usr/local/bin/npm", "/usr/bin/npm"];
+  const result = findRealBin("npm", commonPaths);
+  if (result && fs?.existsSync(result)) {
+    return result;
+  }
+  const npmPath = whichBinSync("npm", { nothrow: true });
+  if (npmPath && typeof npmPath === "string" && fs?.existsSync(npmPath)) {
+    return npmPath;
+  }
+  return "npm";
+}
+function findRealPnpm() {
+  const path = /* @__PURE__ */ getPath();
+  const commonPaths = import_platform.WIN32 ? [
+    // Windows common paths.
+    path?.join((0, import_windows.getAppdata)(), "npm", "pnpm.cmd"),
+    path?.join((0, import_windows.getAppdata)(), "npm", "pnpm"),
+    path?.join((0, import_windows.getLocalappdata)(), "pnpm", "pnpm.cmd"),
+    path?.join((0, import_windows.getLocalappdata)(), "pnpm", "pnpm"),
+    "C:\\Program Files\\nodejs\\pnpm.cmd",
+    "C:\\Program Files\\nodejs\\pnpm"
+  ].filter(Boolean) : [
+    // Unix common paths.
+    "/usr/local/bin/pnpm",
+    "/usr/bin/pnpm",
+    path?.join(
+      (0, import_xdg.getXdgDataHome)() || `${(0, import_home.getHome)()}/.local/share`,
+      "pnpm/pnpm"
+    ),
+    path?.join((0, import_home.getHome)(), ".pnpm/pnpm")
+  ].filter(Boolean);
+  return findRealBin("pnpm", commonPaths) ?? "";
+}
+function findRealYarn() {
+  const path = /* @__PURE__ */ getPath();
+  const commonPaths = [
+    "/usr/local/bin/yarn",
+    "/usr/bin/yarn",
+    path?.join((0, import_home.getHome)(), ".yarn/bin/yarn"),
+    path?.join(
+      (0, import_home.getHome)(),
+      ".config/yarn/global/node_modules/.bin/yarn"
+    )
+  ].filter(Boolean);
+  return findRealBin("yarn", commonPaths) ?? "";
+}
+// @__NO_SIDE_EFFECTS__
+function resolveBinPathSync(binPath) {
+  const fs = /* @__PURE__ */ getFs();
+  const path = /* @__PURE__ */ getPath();
+  if (!path?.isAbsolute(binPath)) {
+    try {
+      const resolved = whichBinSync(binPath);
+      if (resolved) {
+        binPath = resolved;
+      }
+    } catch {
+    }
+  }
+  binPath = (0, import_path.normalizePath)(binPath);
+  if (binPath === ".") {
+    return binPath;
+  }
+  const ext = path?.extname(binPath);
+  const extLowered = ext.toLowerCase();
+  const basename = path?.basename(binPath, ext);
+  const voltaIndex = basename === "node" ? -1 : /(?<=\/)\.volta\//i.exec(binPath)?.index ?? -1;
+  if (voltaIndex !== -1) {
+    const voltaPath = binPath.slice(0, voltaIndex);
+    const voltaToolsPath = path?.join(voltaPath, "tools");
+    const voltaImagePath = path?.join(voltaToolsPath, "image");
+    const voltaUserPath = path?.join(voltaToolsPath, "user");
+    const voltaPlatform = (0, import_fs.readJsonSync)(
+      path?.join(voltaUserPath, "platform.json"),
+      { throws: false }
+    );
+    const voltaNodeVersion = voltaPlatform?.node?.runtime;
+    const voltaNpmVersion = voltaPlatform?.node?.npm;
+    let voltaBinPath = "";
+    if (basename === "npm" || basename === "npx") {
+      if (voltaNpmVersion) {
+        const relCliPath = `bin/${basename}-cli.js`;
+        voltaBinPath = path?.join(
+          voltaImagePath,
+          `npm/${voltaNpmVersion}/${relCliPath}`
+        );
+        if (voltaNodeVersion && !fs?.existsSync(voltaBinPath)) {
+          voltaBinPath = path?.join(
+            voltaImagePath,
+            `node/${voltaNodeVersion}/lib/node_modules/npm/${relCliPath}`
+          );
+          if (!fs?.existsSync(voltaBinPath)) {
+            voltaBinPath = "";
+          }
+        }
+      }
+    } else {
+      const voltaUserBinPath = path?.join(voltaUserPath, "bin");
+      const binInfo = (0, import_fs.readJsonSync)(
+        path?.join(voltaUserBinPath, `${basename}.json`),
+        { throws: false }
+      );
+      const binPackage = binInfo?.package;
+      if (binPackage) {
+        voltaBinPath = path?.join(
+          voltaImagePath,
+          `packages/${binPackage}/bin/${basename}`
+        );
+        if (!fs?.existsSync(voltaBinPath)) {
+          voltaBinPath = `${voltaBinPath}.cmd`;
+          if (!fs?.existsSync(voltaBinPath)) {
+            voltaBinPath = "";
+          }
+        }
+      }
+    }
+    if (voltaBinPath) {
+      try {
+        return (0, import_path.normalizePath)(fs?.realpathSync.native(voltaBinPath));
+      } catch {
+      }
+      return voltaBinPath;
+    }
+  }
+  if (import_platform.WIN32) {
+    const hasKnownExt = extLowered === "" || extLowered === ".cmd" || extLowered === ".exe" || extLowered === ".ps1";
+    const isNpmOrNpx = basename === "npm" || basename === "npx";
+    const isPnpmOrYarn = basename === "pnpm" || basename === "yarn";
+    if (hasKnownExt && isNpmOrNpx) {
+      const quickPath = path?.join(
+        path?.dirname(binPath),
+        `node_modules/npm/bin/${basename}-cli.js`
+      );
+      if (fs?.existsSync(quickPath)) {
+        try {
+          return fs?.realpathSync.native(quickPath);
+        } catch {
+        }
+        return quickPath;
+      }
+    }
+    let relPath = "";
+    if (hasKnownExt && // Only parse shell scripts and batch files, not actual executables.
+    // .exe files are already executables and don't need path resolution from wrapper scripts.
+    extLowered !== ".exe" && // Check if file exists before attempting to read it to avoid ENOENT errors.
+    fs?.existsSync(binPath)) {
+      const source = fs?.readFileSync(binPath, "utf8");
+      if (isNpmOrNpx) {
+        if (extLowered === ".cmd") {
+          relPath = basename === "npm" ? /(?<="NPM_CLI_JS=%~dp0\\).*(?=")/.exec(source)?.[0] || "" : /(?<="NPX_CLI_JS=%~dp0\\).*(?=")/.exec(source)?.[0] || "";
+        } else if (extLowered === "") {
+          relPath = basename === "npm" ? /(?<=NPM_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(source)?.[0] || "" : /(?<=NPX_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(source)?.[0] || "";
+        } else if (extLowered === ".ps1") {
+          relPath = basename === "npm" ? /(?<=\$NPM_CLI_JS="\$PSScriptRoot\/).*(?=")/.exec(
+            source
+          )?.[0] || "" : /(?<=\$NPX_CLI_JS="\$PSScriptRoot\/).*(?=")/.exec(
+            source
+          )?.[0] || "";
+        }
+      } else if (isPnpmOrYarn) {
+        if (extLowered === ".cmd") {
+          relPath = /(?<=node\s+")%~dp0\\([^"]+)(?="\s+%\*)/.exec(source)?.[1] || "";
+          if (!relPath) {
+            relPath = /(?<="%~dp0\\[^"]*node[^"]*"\s+")%~dp0\\([^"]+)(?="\s+%\*)/.exec(
+              source
+            )?.[1] || "";
+          }
+          if (!relPath) {
+            relPath = /(?<="%dp0%\\).*(?=" %\*\r\n)/.exec(source)?.[0] || "";
+          }
+        } else if (extLowered === "") {
+          relPath = /(?<="\$basedir\/)\.tools\/pnpm\/[^"]+(?="\s+"\$@")/.exec(
+            source
+          )?.[0] || "";
+          if (!relPath) {
+            relPath = /(?<=exec\s+node\s+"\$basedir\/)\.tools\/pnpm\/[^"]+(?="\s+"\$@")/.exec(
+              source
+            )?.[0] || "";
+          }
+          if (!relPath) {
+            relPath = /(?<="\$basedir\/).*(?=" "\$@"\n)/.exec(source)?.[0] || "";
+          }
+        } else if (extLowered === ".ps1") {
+          relPath = /(?<="\$basedir\/).*(?=" $args\n)/.exec(source)?.[0] || "";
+        }
+      } else if (extLowered === ".cmd") {
+        relPath = /(?<="%dp0%\\).*(?=" %\*\r\n)/.exec(source)?.[0] || "";
+      } else if (extLowered === "") {
+        relPath = /(?<="$basedir\/).*(?=" "\$@"\n)/.exec(source)?.[0] || "";
+      } else if (extLowered === ".ps1") {
+        relPath = /(?<="\$basedir\/).*(?=" $args\n)/.exec(source)?.[0] || "";
+      }
+      if (relPath) {
+        binPath = (0, import_path.normalizePath)(path?.resolve(path?.dirname(binPath), relPath));
+      }
+    }
+  } else {
+    let hasNoExt = extLowered === "";
+    const isPnpmOrYarn = basename === "pnpm" || basename === "yarn";
+    const isNpmOrNpx = basename === "npm" || basename === "npx";
+    if (isPnpmOrYarn && binPath.includes("/.bin/pnpm/bin/")) {
+      const binIndex = binPath.indexOf("/.bin/pnpm");
+      if (binIndex !== -1) {
+        const baseBinPath = binPath.slice(0, binIndex + "/.bin/pnpm".length);
+        try {
+          const stats = fs?.statSync(baseBinPath);
+          if (stats.isFile()) {
+            binPath = (0, import_path.normalizePath)(baseBinPath);
+            hasNoExt = !path?.extname(binPath);
+          }
+        } catch {
+        }
+      }
+    }
+    if (hasNoExt && (isPnpmOrYarn || isNpmOrNpx) && // For extensionless files (Unix shell scripts), verify existence before reading.
+    // This prevents ENOENT errors when the bin path doesn't exist.
+    fs?.existsSync(binPath)) {
+      const source = fs?.readFileSync(binPath, "utf8");
+      let relPath = "";
+      if (isPnpmOrYarn) {
+        relPath = /(?<="\$basedir\/)\.tools\/[^"]+(?="\s+"\$@")/.exec(source)?.[0] || "";
+        if (!relPath) {
+          relPath = /(?<="\$basedir\/)[^"]+(?="\s+"\$@")/.exec(source)?.[0] || "";
+        }
+        if (!relPath) {
+          const match = /exec\s+node\s+"?\$basedir\/([^"]+)"?\s+"\$@"/.exec(
+            source
+          );
+          if (match) {
+            relPath = match[1] || "";
+          }
+        }
+        if (relPath && basename === "pnpm" && relPath.startsWith("pnpm/")) {
+          relPath = `../${relPath}`;
+        }
+      } else if (isNpmOrNpx) {
+        relPath = basename === "npm" ? /(?<=NPM_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(source)?.[0] || "" : /(?<=NPX_CLI_JS="\$CLI_BASEDIR\/).*(?=")/.exec(source)?.[0] || "";
+      }
+      if (relPath) {
+        binPath = (0, import_path.normalizePath)(path?.resolve(path?.dirname(binPath), relPath));
+      }
+    }
+  }
+  try {
+    const realPath = fs?.realpathSync.native(binPath);
+    return (0, import_path.normalizePath)(realPath);
+  } catch {
+  }
+  return (0, import_path.normalizePath)(binPath);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  execBin,
+  findRealBin,
+  findRealNpm,
+  findRealPnpm,
+  findRealYarn,
+  isShadowBinPath,
+  resolveBinPathSync,
+  which,
+  whichBin,
+  whichBinSync,
+  whichSync
+});
 //# sourceMappingURL=bin.js.map