@socketsecurity/lib 3.0.1 → 3.0.3

package/dist/prompts/index.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/prompts/index.ts"],
   "sourcesContent": ["/**\n * @fileoverview Themed interactive prompts for terminal input.\n * Provides type definitions and utilities for themed prompt interactions.\n *\n * Note: This module provides the theme-aware API structure.\n * Actual prompt implementations should be added based on project needs.\n */\n\nimport type { Theme } from '../themes/types'\nimport type { ThemeName } from '../themes/themes'\n\n/**\n * Base options for all prompts.\n */\nexport type PromptBaseOptions = {\n  /** Prompt message to display */\n  message: string\n  /** Theme to use (overrides global) */\n  theme?: Theme | ThemeName | undefined\n}\n\n/**\n * Options for text input prompts.\n */\nexport type InputPromptOptions = PromptBaseOptions & {\n  /** Default value */\n  default?: string | undefined\n  /** Validation function */\n  validate?: ((value: string) => boolean | string) | undefined\n  /** Placeholder text */\n  placeholder?: string | undefined\n}\n\n/**\n * Options for confirmation prompts.\n */\nexport type ConfirmPromptOptions = PromptBaseOptions & {\n  /** Default value */\n  default?: boolean | undefined\n}\n\n/**\n * Choice option for select prompts.\n */\nexport type Choice<T = string> = {\n  /** Display label */\n  label: string\n  /** Value to return */\n  value: T\n  /** Optional description */\n  description?: string | undefined\n  /** Whether this choice is disabled */\n  disabled?: boolean | undefined\n}\n\n/**\n * Options for selection prompts.\n */\nexport type SelectPromptOptions<T = string> = PromptBaseOptions & {\n  /** Array of choices */\n  choices: Array<Choice<T>>\n  /** Default selected value */\n  default?: T | undefined\n}\n\n/**\n * Text input prompt (themed).\n *\n * @param options - Input prompt configuration\n * @returns Promise resolving to user input\n *\n * @example\n * ```ts\n * import { input } from '@socketsecurity/lib/prompts'\n *\n * const name = await input({\n *   message: 'Enter your name:',\n *   default: 'User',\n *   validate: (v) => v.length > 0 || 'Name required'\n * })\n * ```\n */\nexport async function input(_options: InputPromptOptions): Promise<string> {\n  // Note: Implement actual prompt logic\n  // For now, return a mock implementation\n  throw new Error(\n    'input() not yet implemented - add prompt library integration',\n  )\n}\n\n/**\n * Confirmation prompt (themed).\n *\n * @param options - Confirm prompt configuration\n * @returns Promise resolving to boolean\n *\n * @example\n * ```ts\n * import { confirm } from '@socketsecurity/lib/prompts'\n *\n * const proceed = await confirm({\n *   message: 'Continue with installation?',\n *   default: true\n * })\n * ```\n */\nexport async function confirm(\n  _options: ConfirmPromptOptions,\n): Promise<boolean> {\n  // Note: Implement actual prompt logic\n  throw new Error(\n    'confirm() not yet implemented - add prompt library integration',\n  )\n}\n\n/**\n * Selection prompt (themed).\n *\n * @template T - Type of choice values\n * @param options - Select prompt configuration\n * @returns Promise resolving to selected value\n *\n * @example\n * ```ts\n * import { select } from '@socketsecurity/lib/prompts'\n *\n * const choice = await select({\n *   message: 'Select environment:',\n *   choices: [\n *     { label: 'Development', value: 'dev' },\n *     { label: 'Staging', value: 'staging' },\n *     { label: 'Production', value: 'prod' }\n *   ]\n * })\n * ```\n */\nexport async function select<T = string>(\n  _options: SelectPromptOptions<T>,\n): Promise<T> {\n  // Note: Implement actual prompt logic\n  throw new Error(\n    'select() not yet implemented - add prompt library integration',\n  )\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,UAAAC,EAAA,WAAAC,IAAA,eAAAC,EAAAL,GAkFA,eAAsBG,EAAMG,EAA+C,CAGzE,MAAM,IAAI,MACR,8DACF,CACF,CAkBA,eAAsBJ,EACpBI,EACkB,CAElB,MAAM,IAAI,MACR,gEACF,CACF,CAuBA,eAAsBF,EACpBE,EACY,CAEZ,MAAM,IAAI,MACR,+DACF,CACF",
-  "names": ["prompts_exports", "__export", "confirm", "input", "select", "__toCommonJS", "_options"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkFA,eAAsB,MAAM,UAA+C;AAGzE,QAAM,IAAI;AAAA,IACR;AAAA,EACF;AACF;AAkBA,eAAsB,QACpB,UACkB;AAElB,QAAM,IAAI;AAAA,IACR;AAAA,EACF;AACF;AAuBA,eAAsB,OACpB,UACY;AAEZ,QAAM,IAAI;AAAA,IACR;AAAA,EACF;AACF;",
+  "names": []
 }

package/dist/prompts.js

@@ -1,3 +1,60 @@
 /* Socket Lib - Built with esbuild */
-var d=Object.create;var s=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,h=Object.prototype.hasOwnProperty;var S=(r,e)=>{for(var t in e)s(r,t,{get:e[t],enumerable:!0})},p=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of m(e))!h.call(r,a)&&a!==t&&s(r,a,{get:()=>e[a],enumerable:!(n=g(e,a))||n.enumerable});return r};var o=(r,e,t)=>(t=r!=null?d(x(r)):{},p(e||!r||!r.__esModule?s(t,"default",{value:r,enumerable:!0}):t,r)),b=r=>p(s({},"__esModule",{value:!0}),r);var y={};S(y,{confirm:()=>i.default,createSeparator:()=>w,input:()=>f.default,password:()=>l.default,search:()=>u.default,select:()=>c.default});module.exports=b(y);var i=o(require('./external/@inquirer/confirm')),f=o(require('./external/@inquirer/input')),l=o(require('./external/@inquirer/password')),u=o(require('./external/@inquirer/search')),c=o(require('./external/@inquirer/select'));function w(r){return{type:"separator",separator:r||"\u2500\u2500\u2500\u2500\u2500\u2500\u2500",line:r||"\u2500\u2500\u2500\u2500\u2500\u2500\u2500"}}0&&(module.exports={confirm,createSeparator,input,password,search,select});
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var prompts_exports = {};
+__export(prompts_exports, {
+  confirm: () => import_confirm.default,
+  createSeparator: () => createSeparator,
+  input: () => import_input.default,
+  password: () => import_password.default,
+  search: () => import_search.default,
+  select: () => import_select.default
+});
+module.exports = __toCommonJS(prompts_exports);
+var import_confirm = __toESM(require('./external/@inquirer/confirm'));
+var import_input = __toESM(require('./external/@inquirer/input'));
+var import_password = __toESM(require('./external/@inquirer/password'));
+var import_search = __toESM(require('./external/@inquirer/search'));
+var import_select = __toESM(require('./external/@inquirer/select'));
+function createSeparator(text) {
+  return {
+    type: "separator",
+    separator: text || "\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    line: text || "\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  confirm,
+  createSeparator,
+  input,
+  password,
+  search,
+  select
+});
 //# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/prompts.ts"],
   "sourcesContent": ["/**\n * @fileoverview Interactive prompt utilities for CLI applications.\n * Re-exports commonly used prompt functions from inquirer packages.\n */\n\nexport { default as confirm } from '@inquirer/confirm'\nexport { default as input } from '@inquirer/input'\nexport { default as password } from '@inquirer/password'\nexport { default as search } from '@inquirer/search'\nexport { default as select } from '@inquirer/select'\n\n// Export types - Choice is a type interface, not a direct export\nexport interface Choice<Value = unknown> {\n  value: Value\n  name?: string\n  description?: string\n  short?: string\n  disabled?: boolean | string\n}\n\n// Create a Separator type that matches the expected interface\nexport interface Separator {\n  type: 'separator'\n  separator?: string\n  line?: string\n}\n\n/**\n * Create a separator for select prompts.\n */\nexport function createSeparator(text?: string): Separator {\n  return {\n    type: 'separator',\n    separator: text || '\u2500\u2500\u2500\u2500\u2500\u2500\u2500',\n    line: text || '\u2500\u2500\u2500\u2500\u2500\u2500\u2500',\n  }\n}\n"],
-  "mappings": ";6iBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,2CAAAE,EAAA,sGAAAC,EAAAH,GAKA,IAAAI,EAAmC,gCACnCC,EAAiC,8BACjCC,EAAoC,iCACpCC,EAAkC,+BAClCC,EAAkC,+BAqB3B,SAASN,EAAgBO,EAA0B,CACxD,MAAO,CACL,KAAM,YACN,UAAWA,GAAQ,6CACnB,KAAMA,GAAQ,4CAChB,CACF",
-  "names": ["prompts_exports", "__export", "createSeparator", "__toCommonJS", "import_confirm", "import_input", "import_password", "import_search", "import_select", "text"]
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAAmC;AACnC,mBAAiC;AACjC,sBAAoC;AACpC,oBAAkC;AAClC,oBAAkC;AAqB3B,SAAS,gBAAgB,MAA0B;AACxD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,WAAW,QAAQ;AAAA,IACnB,MAAM,QAAQ;AAAA,EAChB;AACF;",
+  "names": []
 }

package/dist/regexps.js

@@ -1,3 +1,32 @@
 /* Socket Lib - Built with esbuild */
-var g=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var a=(e,r)=>{for(var t in r)g(e,t,{get:r[t],enumerable:!0})},o=(e,r,t,p)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of i(r))!s.call(e,n)&&n!==t&&g(e,n,{get:()=>r[n],enumerable:!(p=c(r,n))||p.enumerable});return e};var u=e=>o(g({},"__esModule",{value:!0}),e);var $={};a($,{escapeRegExp:()=>x});module.exports=u($);function x(e){return e.replace(/[\\|{}()[\]^$+*?.]/g,"\\$&")}0&&(module.exports={escapeRegExp});
+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 regexps_exports = {};
+__export(regexps_exports, {
+  escapeRegExp: () => escapeRegExp
+});
+module.exports = __toCommonJS(regexps_exports);
+// @__NO_SIDE_EFFECTS__
+function escapeRegExp(str) {
+  return str.replace(/[\\|{}()[\]^$+*?.]/g, "\\$&");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  escapeRegExp
+});
 //# sourceMappingURL=regexps.js.map

package/dist/regexps.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/regexps.ts"],
   "sourcesContent": ["/**\n * @fileoverview Regular expression utilities including escape-string-regexp implementation.\n * Provides regex escaping and pattern matching helpers.\n */\n\n// Inlined escape-string-regexp:\n// https://socket.dev/npm/package/escape-string-regexp/overview/5.0.0\n// MIT License\n// Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)\n\n/**\n * Escape special characters in a string for use in a regular expression.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function escapeRegExp(str: string): string {\n  // Escape characters with special meaning either inside or outside character sets.\n  // Use a simple backslash escape when it's always valid, and a `\\xnn` escape when\n  // the simpler form would be disallowed by Unicode patterns' stricter grammar.\n  return str.replace(/[\\\\|{}()[\\]^$+*?.]/g, '\\\\$&')\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,IAAA,eAAAC,EAAAH,GAcO,SAASE,EAAaE,EAAqB,CAIhD,OAAOA,EAAI,QAAQ,sBAAuB,MAAM,CAClD",
-  "names": ["regexps_exports", "__export", "escapeRegExp", "__toCommonJS", "str"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcO,SAAS,aAAa,KAAqB;AAIhD,SAAO,IAAI,QAAQ,uBAAuB,MAAM;AAClD;",
+  "names": []
 }

package/dist/sea.js

@@ -1,3 +1,46 @@
 /* Socket Lib - Built with esbuild */
-var o=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var c=(n,e)=>{for(var a in e)o(n,a,{get:e[a],enumerable:!0})},p=(n,e,a,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of f(e))!l.call(n,r)&&r!==a&&o(n,r,{get:()=>e[r],enumerable:!(t=d(e,r))||t.enumerable});return n};var g=n=>p(o({},"__esModule",{value:!0}),n);var h={};c(h,{getSeaBinaryPath:()=>S,isSeaBinary:()=>u});module.exports=g(h);var s=require("./path");let i;function S(){return u()&&process.argv[0]?(0,s.normalizePath)(process.argv[0]):void 0}function u(){if(i===void 0)try{i=require("node:sea").isSea()}catch{i=!1}return i??!1}0&&(module.exports={getSeaBinaryPath,isSeaBinary});
+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 sea_exports = {};
+__export(sea_exports, {
+  getSeaBinaryPath: () => getSeaBinaryPath,
+  isSeaBinary: () => isSeaBinary
+});
+module.exports = __toCommonJS(sea_exports);
+var import_path = require("./path");
+let _isSea;
+function getSeaBinaryPath() {
+  return isSeaBinary() && process.argv[0] ? (0, import_path.normalizePath)(process.argv[0]) : void 0;
+}
+function isSeaBinary() {
+  if (_isSea === void 0) {
+    try {
+      const seaModule = require("node:sea");
+      _isSea = seaModule.isSea();
+    } catch {
+      _isSea = false;
+    }
+  }
+  return _isSea ?? false;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getSeaBinaryPath,
+  isSeaBinary
+});
 //# sourceMappingURL=sea.js.map

package/dist/sea.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/sea.ts"],
   "sourcesContent": ["/**\n * @fileoverview SEA (Single Executable Application) detection utilities for Socket ecosystem.\n * Provides reliable detection of whether the current process is running\n * as a Node.js Single Executable Application.\n */\n\nimport { normalizePath } from './path'\n\n/**\n * Cached SEA detection result.\n */\nlet _isSea: boolean | undefined\n\n/**\n * Get the current SEA binary path.\n * Only valid when running as a SEA binary.\n */\nexport function getSeaBinaryPath(): string | undefined {\n  return isSeaBinary() && process.argv[0]\n    ? normalizePath(process.argv[0])\n    : undefined\n}\n\n/**\n * Detect if the current process is running as a SEA binary.\n * Uses Node.js 24+ native API with caching for performance.\n */\nexport function isSeaBinary(): boolean {\n  if (_isSea === undefined) {\n    try {\n      // Use Node.js 24+ native SEA detection API.\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      const seaModule = require('node:sea')\n      _isSea = seaModule.isSea()\n    } catch {\n      // Node.js < 24 or SEA module not available.\n      _isSea = false\n    }\n  }\n  return _isSea ?? false\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,sBAAAE,EAAA,gBAAAC,IAAA,eAAAC,EAAAJ,GAMA,IAAAK,EAA8B,kBAK9B,IAAIC,EAMG,SAASJ,GAAuC,CACrD,OAAOC,EAAY,GAAK,QAAQ,KAAK,CAAC,KAClC,iBAAc,QAAQ,KAAK,CAAC,CAAC,EAC7B,MACN,CAMO,SAASA,GAAuB,CACrC,GAAIG,IAAW,OACb,GAAI,CAIFA,EADkB,QAAQ,UAAU,EACjB,MAAM,CAC3B,MAAQ,CAENA,EAAS,EACX,CAEF,OAAOA,GAAU,EACnB",
-  "names": ["sea_exports", "__export", "getSeaBinaryPath", "isSeaBinary", "__toCommonJS", "import_path", "_isSea"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,kBAA8B;AAK9B,IAAI;AAMG,SAAS,mBAAuC;AACrD,SAAO,YAAY,KAAK,QAAQ,KAAK,CAAC,QAClC,2BAAc,QAAQ,KAAK,CAAC,CAAC,IAC7B;AACN;AAMO,SAAS,cAAuB;AACrC,MAAI,WAAW,QAAW;AACxB,QAAI;AAGF,YAAM,YAAY,QAAQ,UAAU;AACpC,eAAS,UAAU,MAAM;AAAA,IAC3B,QAAQ;AAEN,eAAS;AAAA,IACX;AAAA,EACF;AACA,SAAO,UAAU;AACnB;",
+  "names": []
 }

package/dist/shadow.js

@@ -1,3 +1,60 @@
 /* Socket Lib - Built with esbuild */
-var r=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var f=(e,n)=>{for(var o in n)r(e,o,{get:n[o],enumerable:!0})},m=(e,n,o,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of l(n))!u.call(e,t)&&t!==o&&r(e,t,{get:()=>n[t],enumerable:!(s=p(n,t))||s.enumerable});return e};var w=e=>m(r({},"__esModule",{value:!0}),e);var h={};f(h,{shouldSkipShadow:()=>_});module.exports=w(h);var i=require("./path");function _(e,n){const{cwd:o=process.cwd(),win32:s=!1}={__proto__:null,...n};if(s&&e)return!0;const t=process.env.npm_config_user_agent;if(t?.includes("exec")||t?.includes("npx")||t?.includes("dlx"))return!0;const a=(0,i.normalizePath)(o),c=process.env.npm_config_cache;return c&&a.includes((0,i.normalizePath)(c))?!0:["_npx",".pnpm-store","dlx-",".yarn/$$","AppData/Local/Temp/xfs-"].some(d=>a.includes(d))}0&&(module.exports={shouldSkipShadow});
+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 shadow_exports = {};
+__export(shadow_exports, {
+  shouldSkipShadow: () => shouldSkipShadow
+});
+module.exports = __toCommonJS(shadow_exports);
+var import_path = require("./path");
+function shouldSkipShadow(binPath, options) {
+  const { cwd = process.cwd(), win32 = false } = {
+    __proto__: null,
+    ...options
+  };
+  if (win32 && binPath) {
+    return true;
+  }
+  const userAgent = process.env["npm_config_user_agent"];
+  if (userAgent?.includes("exec") || userAgent?.includes("npx") || userAgent?.includes("dlx")) {
+    return true;
+  }
+  const normalizedCwd = (0, import_path.normalizePath)(cwd);
+  const npmCache = process.env["npm_config_cache"];
+  if (npmCache && normalizedCwd.includes((0, import_path.normalizePath)(npmCache))) {
+    return true;
+  }
+  const tempPatterns = [
+    // npm's npx cache directory
+    "_npx",
+    // pnpm dlx temporary store
+    ".pnpm-store",
+    // Common dlx directory prefix
+    "dlx-",
+    // Yarn Berry PnP virtual packages.
+    ".yarn/$$",
+    // Yarn on Windows uses normalized forward slash paths.
+    "AppData/Local/Temp/xfs-"
+  ];
+  return tempPatterns.some((pattern) => normalizedCwd.includes(pattern));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  shouldSkipShadow
+});
 //# sourceMappingURL=shadow.js.map

package/dist/shadow.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/shadow.ts"],
   "sourcesContent": ["/**\n * @fileoverview Shadow binary installation utilities for Socket ecosystem.\n * Provides logic to determine when shadow binary installation should be skipped.\n */\n\nimport { normalizePath } from './path'\n\nexport interface ShadowInstallationOptions {\n  cwd?: string | undefined\n  win32?: boolean | undefined\n}\n\n/**\n * Determines if shadow binaries should be installed.\n * Shadows should NOT be installed when:\n * - Running in a temporary execution context (exec/npx/dlx)\n * - On Windows with an existing binary path (required for Windows to function)\n *\n * @param binPath - Path to the binary being shadowed\n * @param options - Configuration options\n * @param options.cwd - Current working directory path to check\n * @param options.win32 - Whether running on Windows\n * @returns true if shadow installation should be skipped\n */\nexport function shouldSkipShadow(\n  binPath: string,\n  options?: ShadowInstallationOptions | undefined,\n): boolean {\n  const { cwd = process.cwd(), win32 = false } = {\n    __proto__: null,\n    ...options,\n  } as ShadowInstallationOptions\n\n  // Windows compatibility: Skip shadow installation if binary is already found.\n  //\n  // This check is required because Windows handles executables differently than Unix:\n  // 1. File locking - Windows locks running executables, so cmd-shim creation would\n  //    fail with EBUSY/EACCES errors when trying to create wrapper files.\n  // 2. PATH conflicts - Attempting to shadow an already-resolved binary can create\n  //    circular references or ambiguous command resolution.\n  // 3. Registry integration - Windows package managers often use system-level\n  //    integrations beyond just PATH that our shadowing would interfere with.\n  //\n  // Without this check, users would see \"Access Denied\" or file locking errors\n  // that are difficult to debug. This is not a performance optimization - the\n  // shadow installation will fail without it.\n  if (win32 && binPath) {\n    return true\n  }\n\n  // Check environment variable for exec/npx/dlx indicators.\n  const userAgent = process.env['npm_config_user_agent']\n  if (\n    userAgent?.includes('exec') ||\n    userAgent?.includes('npx') ||\n    userAgent?.includes('dlx')\n  ) {\n    return true\n  }\n\n  // Normalize the cwd path for consistent checking across platforms.\n  const normalizedCwd = normalizePath(cwd)\n\n  // Check if running from npm's npx cache.\n  const npmCache = process.env['npm_config_cache']\n  if (npmCache && normalizedCwd.includes(normalizePath(npmCache))) {\n    return true\n  }\n\n  // Check common temporary execution path patterns.\n  const tempPatterns = [\n    // npm's npx cache directory\n    '_npx',\n    // pnpm dlx temporary store\n    '.pnpm-store',\n    // Common dlx directory prefix\n    'dlx-',\n    // Yarn Berry PnP virtual packages.\n    '.yarn/$$',\n    // Yarn on Windows uses normalized forward slash paths.\n    'AppData/Local/Temp/xfs-',\n  ]\n\n  return tempPatterns.some(pattern => normalizedCwd.includes(pattern))\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,sBAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA8B,kBAmBvB,SAASF,EACdG,EACAC,EACS,CACT,KAAM,CAAE,IAAAC,EAAM,QAAQ,IAAI,EAAG,MAAAC,EAAQ,EAAM,EAAI,CAC7C,UAAW,KACX,GAAGF,CACL,EAeA,GAAIE,GAASH,EACX,MAAO,GAIT,MAAMI,EAAY,QAAQ,IAAI,sBAC9B,GACEA,GAAW,SAAS,MAAM,GAC1BA,GAAW,SAAS,KAAK,GACzBA,GAAW,SAAS,KAAK,EAEzB,MAAO,GAIT,MAAMC,KAAgB,iBAAcH,CAAG,EAGjCI,EAAW,QAAQ,IAAI,iBAC7B,OAAIA,GAAYD,EAAc,YAAS,iBAAcC,CAAQ,CAAC,EACrD,GAIY,CAEnB,OAEA,cAEA,OAEA,WAEA,yBACF,EAEoB,KAAKC,GAAWF,EAAc,SAASE,CAAO,CAAC,CACrE",
-  "names": ["shadow_exports", "__export", "shouldSkipShadow", "__toCommonJS", "import_path", "binPath", "options", "cwd", "win32", "userAgent", "normalizedCwd", "npmCache", "pattern"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,kBAA8B;AAmBvB,SAAS,iBACd,SACA,SACS;AACT,QAAM,EAAE,MAAM,QAAQ,IAAI,GAAG,QAAQ,MAAM,IAAI;AAAA,IAC7C,WAAW;AAAA,IACX,GAAG;AAAA,EACL;AAeA,MAAI,SAAS,SAAS;AACpB,WAAO;AAAA,EACT;AAGA,QAAM,YAAY,QAAQ,IAAI,uBAAuB;AACrD,MACE,WAAW,SAAS,MAAM,KAC1B,WAAW,SAAS,KAAK,KACzB,WAAW,SAAS,KAAK,GACzB;AACA,WAAO;AAAA,EACT;AAGA,QAAM,oBAAgB,2BAAc,GAAG;AAGvC,QAAM,WAAW,QAAQ,IAAI,kBAAkB;AAC/C,MAAI,YAAY,cAAc,aAAS,2BAAc,QAAQ,CAAC,GAAG;AAC/D,WAAO;AAAA,EACT;AAGA,QAAM,eAAe;AAAA;AAAA,IAEnB;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA,EACF;AAEA,SAAO,aAAa,KAAK,aAAW,cAAc,SAAS,OAAO,CAAC;AACrE;",
+  "names": []
 }

package/dist/signal-exit.js

@@ -1,3 +1,250 @@
 /* Socket Lib - Built with esbuild */
-var g=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var T=(e,t)=>{for(var s in t)g(e,s,{get:t[s],enumerable:!0})},w=(e,t,s,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of h(t))!P.call(e,r)&&r!==s&&g(e,r,{get:()=>t[r],enumerable:!(n=G(t,r))||n.enumerable});return e};var R=e=>w(g({},"__esModule",{value:!0}),e);var U={};T(U,{load:()=>v,onExit:()=>k,signals:()=>C,unload:()=>E});module.exports=R(U);const S=Reflect.apply,i=globalThis.process,p=i?.emit,y=i?.platform??"",x=i?.reallyExit,b=y==="win32";let m;function N(){return m===void 0&&(m=require("node:events")),m}let o;function d(){if(o===void 0){if(i?.__signal_exit_emitter__)o=i.__signal_exit_emitter__;else if(i){const e=N().EventEmitter;o=i.__signal_exit_emitter__=new e,o.count=0,o.emitted={__proto__:null}}o&&!o.infinite&&(o.setMaxListeners(Number.POSITIVE_INFINITY),o.infinite=!0)}return o}let c;function L(){if(c===void 0){c={__proto__:null};const e=d(),t=_();for(const s of t)c[s]=function(){if((i?.listeners(s)||[]).length===e.count){const a=b&&s==="SIGHUP"?"SIGINT":s;i?.kill(i?.pid,a)}}}return c}let l;function _(){return l===void 0&&(l=["SIGABRT","SIGALRM","SIGHUP","SIGINT","SIGTERM"],b||l.push("SIGVTALRM","SIGXCPU","SIGXFSZ","SIGUSR2","SIGTRAP","SIGSYS","SIGQUIT","SIGIOT"),y==="linux"&&l.push("SIGIO","SIGPOLL","SIGPWR","SIGSTKFLT","SIGUNUSED")),l}function u(e,t,s){const n=d();n.emitted?.[e]||(n.emitted&&(n.emitted[e]=!0),n.emit(e,t,s))}let f=!1;function v(){if(f||!i)return;f=!0;const e=d();e.count!==void 0&&(e.count+=1);const t=_(),s=L();l=t.filter(n=>{try{return i.on(n,s[n]),!0}catch{}return!1}),i.emit=O,i.reallyExit=M}function O(e,t,...s){if(e==="exit"){let n=t;if(n===void 0){const I=i?.exitCode;n=typeof I=="number"?I:void 0}else i&&(i.exitCode=n);const r=S(p,this,[e,n,...s]),a=typeof n=="number"?n:null;return r}return S(p,this,[e,t,...s])}function M(e){const t=e||0;throw i&&(i.exitCode=t),S(x,i,[t]),new Error("processReallyExit should never return")}function k(e,t){if(!i)return function(){};if(typeof e!="function")throw new TypeError("a callback must be provided for exit handler");const{alwaysLast:s}={__proto__:null,...t};let n="exit";s&&(n="afterexit");const r=d();return r.on(n,e),function(){r.removeListener(n,e),!r.listeners("exit").length&&r.listeners("afterexit").length}}function C(){return l}function E(){if(!f||!i)return;f=!1;const e=_(),t=L();for(const n of e)try{i.removeListener(n,t[n])}catch{}i.emit=p,x!==void 0&&(i.reallyExit=x);const s=d();s.count!==void 0&&(s.count-=1)}0&&(module.exports={load,onExit,signals,unload});
+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 signal_exit_exports = {};
+__export(signal_exit_exports, {
+  load: () => load,
+  onExit: () => onExit,
+  signals: () => signals,
+  unload: () => unload
+});
+module.exports = __toCommonJS(signal_exit_exports);
+const ReflectApply = Reflect.apply;
+const globalProcess = globalThis.process;
+const originalProcessEmit = globalProcess?.emit;
+const platform = globalProcess?.platform ?? "";
+const originalProcessReallyExit = globalProcess?.reallyExit;
+const WIN32 = platform === "win32";
+let _events;
+// @__NO_SIDE_EFFECTS__
+function getEvents() {
+  if (_events === void 0) {
+    _events = require("node:events");
+  }
+  return _events;
+}
+let _emitter;
+// @__NO_SIDE_EFFECTS__
+function getEmitter() {
+  if (_emitter === void 0) {
+    if (globalProcess?.__signal_exit_emitter__) {
+      _emitter = globalProcess.__signal_exit_emitter__;
+    } else if (globalProcess) {
+      const EventEmitter = (/* @__PURE__ */ getEvents()).EventEmitter;
+      _emitter = globalProcess.__signal_exit_emitter__ = new EventEmitter();
+      _emitter.count = 0;
+      _emitter.emitted = { __proto__: null };
+    }
+    if (_emitter && !_emitter.infinite) {
+      _emitter.setMaxListeners(Number.POSITIVE_INFINITY);
+      _emitter.infinite = true;
+    }
+  }
+  return _emitter;
+}
+let _sigListeners;
+// @__NO_SIDE_EFFECTS__
+function getSignalListeners() {
+  if (_sigListeners === void 0) {
+    _sigListeners = { __proto__: null };
+    const emitter = /* @__PURE__ */ getEmitter();
+    const sigs = /* @__PURE__ */ getSignals();
+    for (const sig of sigs) {
+      _sigListeners[sig] = function listener() {
+        const listeners = globalProcess?.listeners(sig) || [];
+        if (listeners.length === emitter.count) {
+          /* @__PURE__ */ unload();
+          /* @__PURE__ */ emit("exit", null, sig);
+          /* @__PURE__ */ emit("afterexit", null, sig);
+          const killSig = WIN32 && sig === "SIGHUP" ? "SIGINT" : sig;
+          globalProcess?.kill(globalProcess?.pid, killSig);
+        }
+      };
+    }
+  }
+  return _sigListeners;
+}
+let _signals;
+// @__NO_SIDE_EFFECTS__
+function getSignals() {
+  if (_signals === void 0) {
+    _signals = ["SIGABRT", "SIGALRM", "SIGHUP", "SIGINT", "SIGTERM"];
+    if (!WIN32) {
+      _signals.push(
+        "SIGVTALRM",
+        "SIGXCPU",
+        "SIGXFSZ",
+        "SIGUSR2",
+        "SIGTRAP",
+        "SIGSYS",
+        "SIGQUIT",
+        "SIGIOT"
+        // should detect profiler and enable/disable accordingly.
+        // see #21
+        // 'SIGPROF'
+      );
+    }
+    if (platform === "linux") {
+      _signals.push("SIGIO", "SIGPOLL", "SIGPWR", "SIGSTKFLT", "SIGUNUSED");
+    }
+  }
+  return _signals;
+}
+// @__NO_SIDE_EFFECTS__
+function emit(event, code, signal) {
+  const emitter = /* @__PURE__ */ getEmitter();
+  if (emitter.emitted?.[event]) {
+    return;
+  }
+  if (emitter.emitted) {
+    emitter.emitted[event] = true;
+  }
+  emitter.emit(event, code, signal);
+}
+let loaded = false;
+// @__NO_SIDE_EFFECTS__
+function load() {
+  if (loaded || !globalProcess) {
+    return;
+  }
+  loaded = true;
+  const emitter = /* @__PURE__ */ getEmitter();
+  if (emitter.count !== void 0) {
+    emitter.count += 1;
+  }
+  const sigs = /* @__PURE__ */ getSignals();
+  const sigListeners = /* @__PURE__ */ getSignalListeners();
+  _signals = sigs.filter((sig) => {
+    try {
+      globalProcess.on(
+        sig,
+        sigListeners[sig]
+      );
+      return true;
+    } catch {
+    }
+    return false;
+  });
+  globalProcess.emit = processEmit;
+  globalProcess.reallyExit = processReallyExit;
+}
+// @__NO_SIDE_EFFECTS__
+function processEmit(eventName, exitCode, ...args) {
+  if (eventName === "exit") {
+    let actualExitCode = exitCode;
+    if (actualExitCode === void 0) {
+      const processExitCode = globalProcess?.exitCode;
+      actualExitCode = typeof processExitCode === "number" ? processExitCode : void 0;
+    } else if (globalProcess) {
+      globalProcess.exitCode = actualExitCode;
+    }
+    const result = ReflectApply(
+      originalProcessEmit,
+      this,
+      [eventName, actualExitCode, ...args]
+    );
+    const numExitCode = typeof actualExitCode === "number" ? actualExitCode : null;
+    /* @__PURE__ */ emit("exit", numExitCode, null);
+    /* @__PURE__ */ emit("afterexit", numExitCode, null);
+    return result;
+  }
+  return ReflectApply(
+    originalProcessEmit,
+    this,
+    [eventName, exitCode, ...args]
+  );
+}
+// @__NO_SIDE_EFFECTS__
+function processReallyExit(code) {
+  const exitCode = code || 0;
+  if (globalProcess) {
+    globalProcess.exitCode = exitCode;
+  }
+  /* @__PURE__ */ emit("exit", exitCode, null);
+  /* @__PURE__ */ emit("afterexit", exitCode, null);
+  ReflectApply(
+    originalProcessReallyExit,
+    globalProcess,
+    [exitCode]
+  );
+  throw new Error("processReallyExit should never return");
+}
+// @__NO_SIDE_EFFECTS__
+function onExit(cb, options) {
+  if (!globalProcess) {
+    return function remove() {
+    };
+  }
+  if (typeof cb !== "function") {
+    throw new TypeError("a callback must be provided for exit handler");
+  }
+  if (loaded === false) {
+    /* @__PURE__ */ load();
+  }
+  const { alwaysLast } = { __proto__: null, ...options };
+  let eventName = "exit";
+  if (alwaysLast) {
+    eventName = "afterexit";
+  }
+  const emitter = /* @__PURE__ */ getEmitter();
+  emitter.on(eventName, cb);
+  return function remove() {
+    emitter.removeListener(eventName, cb);
+    if (!emitter.listeners("exit").length && !emitter.listeners("afterexit").length) {
+      /* @__PURE__ */ unload();
+    }
+  };
+}
+// @__NO_SIDE_EFFECTS__
+function signals() {
+  return _signals;
+}
+// @__NO_SIDE_EFFECTS__
+function unload() {
+  if (!loaded || !globalProcess) {
+    return;
+  }
+  loaded = false;
+  const sigs = /* @__PURE__ */ getSignals();
+  const sigListeners = /* @__PURE__ */ getSignalListeners();
+  for (const sig of sigs) {
+    try {
+      globalProcess.removeListener(
+        sig,
+        sigListeners[sig]
+      );
+    } catch {
+    }
+  }
+  globalProcess.emit = originalProcessEmit;
+  if (originalProcessReallyExit !== void 0) {
+    globalProcess.reallyExit = originalProcessReallyExit;
+  }
+  const emitter = /* @__PURE__ */ getEmitter();
+  if (emitter.count !== void 0) {
+    emitter.count -= 1;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  load,
+  onExit,
+  signals,
+  unload
+});
 //# sourceMappingURL=signal-exit.js.map