@socketsecurity/lib 1.3.4 → 2.0.0

package/dist/env/socket.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/socket.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Socket Security environment variable getters.\n */\n\nimport { envAsBoolean, envAsNumber } from '#env/helpers'\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * SOCKET_ACCEPT_RISKS environment variable getter.\n * Whether to accept all Socket Security risks.\n */\nexport function getSocketAcceptRisks(): boolean {\n  return envAsBoolean(getEnvValue('SOCKET_ACCEPT_RISKS'))\n}\n\n/**\n * SOCKET_API_BASE_URL environment variable getter.\n * Socket Security API base URL.\n */\nexport function getSocketApiBaseUrl(): string | undefined {\n  return getEnvValue('SOCKET_API_BASE_URL')\n}\n\n/**\n * SOCKET_API_PROXY environment variable getter.\n * Proxy URL for Socket Security API requests.\n */\nexport function getSocketApiProxy(): string | undefined {\n  return getEnvValue('SOCKET_API_PROXY')\n}\n\n/**\n * SOCKET_API_TIMEOUT environment variable getter.\n * Timeout in milliseconds for Socket Security API requests.\n */\nexport function getSocketApiTimeout(): number {\n  return envAsNumber(getEnvValue('SOCKET_API_TIMEOUT'))\n}\n\n/**\n * SOCKET_API_TOKEN environment variable getter.\n * Socket Security API authentication token.\n */\nexport function getSocketApiToken(): string | undefined {\n  return getEnvValue('SOCKET_API_TOKEN')\n}\n\n/**\n * SOCKET_CACACHE_DIR environment variable getter.\n * Overrides the default Socket cacache directory location.\n */\nexport function getSocketCacacheDir(): string | undefined {\n  return getEnvValue('SOCKET_CACACHE_DIR')\n}\n\n/**\n * SOCKET_CONFIG environment variable getter.\n * Socket Security configuration file path.\n */\nexport function getSocketConfig(): string | undefined {\n  return getEnvValue('SOCKET_CONFIG')\n}\n\n/**\n * SOCKET_DEBUG environment variable getter.\n * Controls Socket-specific debug output.\n */\nexport function getSocketDebug(): string | undefined {\n  return getEnvValue('SOCKET_DEBUG')\n}\n\n/**\n * SOCKET_DLX_DIR environment variable getter.\n * Overrides the default Socket DLX directory location.\n */\nexport function getSocketDlxDirEnv(): string | undefined {\n  return getEnvValue('SOCKET_DLX_DIR')\n}\n\n/**\n * SOCKET_HOME environment variable getter.\n * Socket Security home directory path.\n */\nexport function getSocketHome(): string | undefined {\n  return getEnvValue('SOCKET_HOME')\n}\n\n/**\n * SOCKET_NO_API_TOKEN environment variable getter.\n * Whether to skip Socket Security API token requirement.\n */\nexport function getSocketNoApiToken(): boolean {\n  return envAsBoolean(getEnvValue('SOCKET_NO_API_TOKEN'))\n}\n\n/**\n * SOCKET_NPM_REGISTRY environment variable getter.\n * Socket NPM registry URL (alternative name).\n */\nexport function getSocketNpmRegistry(): string | undefined {\n  return getEnvValue('SOCKET_NPM_REGISTRY')\n}\n\n/**\n * SOCKET_ORG_SLUG environment variable getter.\n * Socket Security organization slug identifier.\n */\nexport function getSocketOrgSlug(): string | undefined {\n  return getEnvValue('SOCKET_ORG_SLUG')\n}\n\n/**\n * SOCKET_REGISTRY_URL environment variable getter.\n * Socket Registry URL for package installation.\n */\nexport function getSocketRegistryUrl(): string | undefined {\n  return getEnvValue('SOCKET_REGISTRY_URL')\n}\n\n/**\n * SOCKET_VIEW_ALL_RISKS environment variable getter.\n * Whether to view all Socket Security risks.\n */\nexport function getSocketViewAllRisks(): boolean {\n  return envAsBoolean(getEnvValue('SOCKET_VIEW_ALL_RISKS'))\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,0BAAAE,EAAA,wBAAAC,EAAA,sBAAAC,EAAA,wBAAAC,EAAA,sBAAAC,EAAA,wBAAAC,EAAA,oBAAAC,EAAA,mBAAAC,EAAA,uBAAAC,EAAA,kBAAAC,EAAA,wBAAAC,EAAA,yBAAAC,EAAA,qBAAAC,EAAA,yBAAAC,EAAA,0BAAAC,IAAA,eAAAC,EAAAjB,GAIA,IAAAkB,EAA0C,wBAC1CC,EAA4B,uBAMrB,SAASjB,GAAgC,CAC9C,SAAO,mBAAa,eAAY,qBAAqB,CAAC,CACxD,CAMO,SAASC,GAA0C,CACxD,SAAO,eAAY,qBAAqB,CAC1C,CAMO,SAASC,GAAwC,CACtD,SAAO,eAAY,kBAAkB,CACvC,CAMO,SAASC,GAA8B,CAC5C,SAAO,kBAAY,eAAY,oBAAoB,CAAC,CACtD,CAMO,SAASC,GAAwC,CACtD,SAAO,eAAY,kBAAkB,CACvC,CAMO,SAASC,GAA0C,CACxD,SAAO,eAAY,oBAAoB,CACzC,CAMO,SAASC,GAAsC,CACpD,SAAO,eAAY,eAAe,CACpC,CAMO,SAASC,GAAqC,CACnD,SAAO,eAAY,cAAc,CACnC,CAMO,SAASC,GAAyC,CACvD,SAAO,eAAY,gBAAgB,CACrC,CAMO,SAASC,GAAoC,CAClD,SAAO,eAAY,aAAa,CAClC,CAMO,SAASC,GAA+B,CAC7C,SAAO,mBAAa,eAAY,qBAAqB,CAAC,CACxD,CAMO,SAASC,GAA2C,CACzD,SAAO,eAAY,qBAAqB,CAC1C,CAMO,SAASC,GAAuC,CACrD,SAAO,eAAY,iBAAiB,CACtC,CAMO,SAASC,GAA2C,CACzD,SAAO,eAAY,qBAAqB,CAC1C,CAMO,SAASC,GAAiC,CAC/C,SAAO,mBAAa,eAAY,uBAAuB,CAAC,CAC1D",
+  "names": ["socket_exports", "__export", "getSocketAcceptRisks", "getSocketApiBaseUrl", "getSocketApiProxy", "getSocketApiTimeout", "getSocketApiToken", "getSocketCacacheDir", "getSocketConfig", "getSocketDebug", "getSocketDlxDirEnv", "getSocketHome", "getSocketNoApiToken", "getSocketNpmRegistry", "getSocketOrgSlug", "getSocketRegistryUrl", "getSocketViewAllRisks", "__toCommonJS", "import_helpers", "import_rewire"]
+}

package/dist/env/temp-dir.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TMPDIR environment variable.
+ * Unix/macOS temporary directory path.
+ */
+export declare function getTmpdir(): string | undefined;
+/**
+ * TEMP environment variable.
+ * Windows temporary directory path.
+ */
+export declare function getTemp(): string | undefined;
+/**
+ * TMP environment variable.
+ * Alternative temporary directory path.
+ */
+export declare function getTmp(): string | undefined;

package/dist/env/temp-dir.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var u=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(e,n)=>{for(var r in n)u(e,r,{get:n[r],enumerable:!0})},T=(e,n,r,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of f(n))!g.call(e,t)&&t!==r&&u(e,t,{get:()=>n[t],enumerable:!(o=d(n,t))||o.enumerable});return e};var m=e=>T(u({},"__esModule",{value:!0}),e);var M={};p(M,{getTemp:()=>s,getTmp:()=>x,getTmpdir:()=>c});module.exports=m(M);var i=require("#env/rewire");function c(){return(0,i.getEnvValue)("TMPDIR")}function s(){return(0,i.getEnvValue)("TEMP")}function x(){return(0,i.getEnvValue)("TMP")}0&&(module.exports={getTemp,getTmp,getTmpdir});
+//# sourceMappingURL=temp-dir.js.map

package/dist/env/temp-dir.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/temp-dir.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Temporary directory environment variable getters.\n * Different platforms use different environment variables for temp directories.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * TMPDIR environment variable.\n * Unix/macOS temporary directory path.\n */\nexport function getTmpdir(): string | undefined {\n  return getEnvValue('TMPDIR')\n}\n\n/**\n * TEMP environment variable.\n * Windows temporary directory path.\n */\nexport function getTemp(): string | undefined {\n  return getEnvValue('TEMP')\n}\n\n/**\n * TMP environment variable.\n * Alternative temporary directory path.\n */\nexport function getTmp(): string | undefined {\n  return getEnvValue('TMP')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,WAAAC,EAAA,cAAAC,IAAA,eAAAC,EAAAL,GAKA,IAAAM,EAA4B,uBAMrB,SAASF,GAAgC,CAC9C,SAAO,eAAY,QAAQ,CAC7B,CAMO,SAASF,GAA8B,CAC5C,SAAO,eAAY,MAAM,CAC3B,CAMO,SAASC,GAA6B,CAC3C,SAAO,eAAY,KAAK,CAC1B",
+  "names": ["temp_dir_exports", "__export", "getTemp", "getTmp", "getTmpdir", "__toCommonJS", "import_rewire"]
+}

package/dist/env/term.d.ts

@@ -1 +1 @@
-export declare const TERM: string;
+export declare function getTerm(): string | undefined;

package/dist/env/term.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var m=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var T=(r,o)=>{for(var e in o)m(r,e,{get:o[e],enumerable:!0})},c=(r,o,e,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of M(o))!R.call(r,t)&&t!==e&&m(r,t,{get:()=>o[t],enumerable:!(n=E(o,t))||n.enumerable});return r};var f=r=>c(m({},"__esModule",{value:!0}),r);var s={};T(s,{TERM:()=>i});module.exports=f(s);var p=require("node:process");const i=p.env.TERM;0&&(module.exports={TERM});
+var i=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var d=(n,e)=>{for(var t in e)i(n,t,{get:e[t],enumerable:!0})},p=(n,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of g(e))!m.call(n,r)&&r!==t&&i(n,r,{get:()=>e[r],enumerable:!(o=f(e,r))||o.enumerable});return n};var E=n=>p(i({},"__esModule",{value:!0}),n);var a={};d(a,{getTerm:()=>T});module.exports=E(a);var u=require("#env/rewire");function T(){return(0,u.getEnvValue)("TERM")}0&&(module.exports={getTerm});
 //# sourceMappingURL=term.js.map

package/dist/env/term.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/env/term.ts"],
-  "sourcesContent": ["/**\n * TERM environment variable snapshot.\n * Terminal type identifier.\n */\n\nimport { env } from 'node:process'\n\nexport const TERM = env['TERM']\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,UAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAAoB,wBAEb,MAAMF,EAAO,MAAI",
-  "names": ["term_exports", "__export", "TERM", "__toCommonJS", "import_node_process"]
+  "sourcesContent": ["/**\n * TERM environment variable getter.\n * Terminal type identifier.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\nexport function getTerm(): string | undefined {\n  return getEnvValue('TERM')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,IAAA,eAAAC,EAAAH,GAKA,IAAAI,EAA4B,uBAErB,SAASF,GAA8B,CAC5C,SAAO,eAAY,MAAM,CAC3B",
+  "names": ["term_exports", "__export", "getTerm", "__toCommonJS", "import_rewire"]
 }

package/dist/env/test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * JEST_WORKER_ID environment variable.
+ * Set when running tests with Jest.
+ */
+export declare function getJestWorkerId(): string;
+/**
+ * VITEST environment variable.
+ * Set when running tests with Vitest.
+ */
+export declare function getVitest(): boolean;
+/**
+ * Check if code is running in a test environment.
+ * Checks NODE_ENV, VITEST, and JEST_WORKER_ID.
+ */
+export declare function isTest(): boolean;

package/dist/env/test.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var i=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var a=(e,t)=>{for(var r in t)i(e,r,{get:t[r],enumerable:!0})},c=(e,t,r,u)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of p(t))!v.call(e,n)&&n!==r&&i(e,n,{get:()=>t[n],enumerable:!(u=m(t,n))||u.enumerable});return e};var d=e=>c(i({},"__esModule",{value:!0}),e);var T={};a(T,{getJestWorkerId:()=>f,getVitest:()=>g,isTest:()=>l});module.exports=d(T);var o=require("#env/helpers"),E=require("#env/node-env"),s=require("#env/rewire");function f(){return(0,o.envAsString)((0,s.getEnvValue)("JEST_WORKER_ID"))}function g(){return(0,o.envAsBoolean)((0,s.getEnvValue)("VITEST"))}function l(){return(0,o.envAsString)((0,E.getNodeEnv)())==="test"||g()||!!f()}0&&(module.exports={getJestWorkerId,getVitest,isTest});
+//# sourceMappingURL=test.js.map

package/dist/env/test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/test.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Test environment variable getters and detection.\n * Provides access to test framework environment variables and utilities.\n */\n\nimport { envAsBoolean, envAsString } from '#env/helpers'\nimport { getNodeEnv } from '#env/node-env'\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * JEST_WORKER_ID environment variable.\n * Set when running tests with Jest.\n */\nexport function getJestWorkerId(): string {\n  return envAsString(getEnvValue('JEST_WORKER_ID'))\n}\n\n/**\n * VITEST environment variable.\n * Set when running tests with Vitest.\n */\nexport function getVitest(): boolean {\n  return envAsBoolean(getEnvValue('VITEST'))\n}\n\n/**\n * Check if code is running in a test environment.\n * Checks NODE_ENV, VITEST, and JEST_WORKER_ID.\n */\nexport function isTest(): boolean {\n  const nodeEnv = envAsString(getNodeEnv())\n  return nodeEnv === 'test' || getVitest() || !!getJestWorkerId()\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,EAAA,cAAAC,EAAA,WAAAC,IAAA,eAAAC,EAAAL,GAKA,IAAAM,EAA0C,wBAC1CC,EAA2B,yBAC3BC,EAA4B,uBAMrB,SAASN,GAA0B,CACxC,SAAO,kBAAY,eAAY,gBAAgB,CAAC,CAClD,CAMO,SAASC,GAAqB,CACnC,SAAO,mBAAa,eAAY,QAAQ,CAAC,CAC3C,CAMO,SAASC,GAAkB,CAEhC,SADgB,kBAAY,cAAW,CAAC,IACrB,QAAUD,EAAU,GAAK,CAAC,CAACD,EAAgB,CAChE",
+  "names": ["test_exports", "__export", "getJestWorkerId", "getVitest", "isTest", "__toCommonJS", "import_helpers", "import_node_env", "import_rewire"]
+}

package/dist/env/windows.d.ts

@@ -0,0 +1,20 @@
+/**
+ * APPDATA environment variable.
+ * Points to the Application Data directory on Windows.
+ */
+export declare function getAppdata(): string | undefined;
+/**
+ * LOCALAPPDATA environment variable.
+ * Points to the Local Application Data directory on Windows.
+ */
+export declare function getLocalappdata(): string | undefined;
+/**
+ * USERPROFILE environment variable.
+ * Windows user home directory path.
+ */
+export declare function getUserprofile(): string | undefined;
+/**
+ * COMSPEC environment variable.
+ * Points to the Windows command processor (typically cmd.exe).
+ */
+export declare function getComspec(): string | undefined;

package/dist/env/windows.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var o=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var g=(n,e)=>{for(var i in e)o(n,i,{get:e[i],enumerable:!0})},A=(n,e,i,u)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of d(e))!f.call(n,t)&&t!==i&&o(n,t,{get:()=>e[t],enumerable:!(u=p(e,t))||u.enumerable});return n};var a=n=>A(o({},"__esModule",{value:!0}),n);var C={};g(C,{getAppdata:()=>c,getComspec:()=>x,getLocalappdata:()=>s,getUserprofile:()=>P});module.exports=a(C);var r=require("#env/rewire");function c(){return(0,r.getEnvValue)("APPDATA")}function s(){return(0,r.getEnvValue)("LOCALAPPDATA")}function P(){return(0,r.getEnvValue)("USERPROFILE")}function x(){return(0,r.getEnvValue)("COMSPEC")}0&&(module.exports={getAppdata,getComspec,getLocalappdata,getUserprofile});
+//# sourceMappingURL=windows.js.map

package/dist/env/windows.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/windows.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Windows environment variable getters.\n * Provides access to Windows-specific user directory paths.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * APPDATA environment variable.\n * Points to the Application Data directory on Windows.\n */\nexport function getAppdata(): string | undefined {\n  return getEnvValue('APPDATA')\n}\n\n/**\n * LOCALAPPDATA environment variable.\n * Points to the Local Application Data directory on Windows.\n */\nexport function getLocalappdata(): string | undefined {\n  return getEnvValue('LOCALAPPDATA')\n}\n\n/**\n * USERPROFILE environment variable.\n * Windows user home directory path.\n */\nexport function getUserprofile(): string | undefined {\n  return getEnvValue('USERPROFILE')\n}\n\n/**\n * COMSPEC environment variable.\n * Points to the Windows command processor (typically cmd.exe).\n */\nexport function getComspec(): string | undefined {\n  return getEnvValue('COMSPEC')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,gBAAAE,EAAA,eAAAC,EAAA,oBAAAC,EAAA,mBAAAC,IAAA,eAAAC,EAAAN,GAKA,IAAAO,EAA4B,uBAMrB,SAASL,GAAiC,CAC/C,SAAO,eAAY,SAAS,CAC9B,CAMO,SAASE,GAAsC,CACpD,SAAO,eAAY,cAAc,CACnC,CAMO,SAASC,GAAqC,CACnD,SAAO,eAAY,aAAa,CAClC,CAMO,SAASF,GAAiC,CAC/C,SAAO,eAAY,SAAS,CAC9B",
+  "names": ["windows_exports", "__export", "getAppdata", "getComspec", "getLocalappdata", "getUserprofile", "__toCommonJS", "import_rewire"]
+}

package/dist/env/xdg.d.ts

@@ -0,0 +1,15 @@
+/**
+ * XDG_CACHE_HOME environment variable.
+ * XDG Base Directory specification cache directory.
+ */
+export declare function getXdgCacheHome(): string | undefined;
+/**
+ * XDG_CONFIG_HOME environment variable.
+ * XDG Base Directory specification config directory.
+ */
+export declare function getXdgConfigHome(): string | undefined;
+/**
+ * XDG_DATA_HOME environment variable.
+ * Points to the user's data directory on Unix systems.
+ */
+export declare function getXdgDataHome(): string | undefined;

package/dist/env/xdg.js

@@ -0,0 +1,3 @@
+/* Socket Lib - Built with esbuild */
+var g=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var H=(n,e)=>{for(var r in e)g(n,r,{get:e[r],enumerable:!0})},X=(n,e,r,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of d(e))!f.call(n,t)&&t!==r&&g(n,t,{get:()=>e[t],enumerable:!(i=u(e,t))||i.enumerable});return n};var _=n=>X(g({},"__esModule",{value:!0}),n);var E={};H(E,{getXdgCacheHome:()=>m,getXdgConfigHome:()=>C,getXdgDataHome:()=>D});module.exports=_(E);var o=require("#env/rewire");function m(){return(0,o.getEnvValue)("XDG_CACHE_HOME")}function C(){return(0,o.getEnvValue)("XDG_CONFIG_HOME")}function D(){return(0,o.getEnvValue)("XDG_DATA_HOME")}0&&(module.exports={getXdgCacheHome,getXdgConfigHome,getXdgDataHome});
+//# sourceMappingURL=xdg.js.map

package/dist/env/xdg.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/env/xdg.ts"],
+  "sourcesContent": ["/**\n * @fileoverview XDG Base Directory Specification environment variable getters.\n * Provides access to XDG user directories on Unix systems.\n */\n\nimport { getEnvValue } from '#env/rewire'\n\n/**\n * XDG_CACHE_HOME environment variable.\n * XDG Base Directory specification cache directory.\n */\nexport function getXdgCacheHome(): string | undefined {\n  return getEnvValue('XDG_CACHE_HOME')\n}\n\n/**\n * XDG_CONFIG_HOME environment variable.\n * XDG Base Directory specification config directory.\n */\nexport function getXdgConfigHome(): string | undefined {\n  return getEnvValue('XDG_CONFIG_HOME')\n}\n\n/**\n * XDG_DATA_HOME environment variable.\n * Points to the user's data directory on Unix systems.\n */\nexport function getXdgDataHome(): string | undefined {\n  return getEnvValue('XDG_DATA_HOME')\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,EAAA,qBAAAC,EAAA,mBAAAC,IAAA,eAAAC,EAAAL,GAKA,IAAAM,EAA4B,uBAMrB,SAASJ,GAAsC,CACpD,SAAO,eAAY,gBAAgB,CACrC,CAMO,SAASC,GAAuC,CACrD,SAAO,eAAY,iBAAiB,CACtC,CAMO,SAASC,GAAqC,CACnD,SAAO,eAAY,eAAe,CACpC",
+  "names": ["xdg_exports", "__export", "getXdgCacheHome", "getXdgConfigHome", "getXdgDataHome", "__toCommonJS", "import_rewire"]
+}

package/dist/env.d.ts

@@ -1,3 +1,38 @@
+/**
+ * Create a case-insensitive environment variable Proxy for Windows compatibility.
+ * On Windows, environment variables are case-insensitive (PATH vs Path vs path).
+ * This Proxy provides consistent access regardless of case, with priority given
+ * to exact matches, then case-insensitive matches for known vars.
+ *
+ * **Use Cases:**
+ * - Cross-platform test environments needing consistent env var access
+ * - Windows compatibility when passing env to child processes
+ * - Merging environment overrides while preserving case-insensitive lookups
+ *
+ * **Performance Note:**
+ * Proxy operations have runtime overhead. Only use when Windows case-insensitive
+ * access is required. For most use cases, process.env directly is sufficient.
+ *
+ * @param base - Base environment object (usually process.env)
+ * @param overrides - Optional overrides to merge
+ * @returns Proxy that handles case-insensitive env var access
+ *
+ * @example
+ * // Create a Proxy with overrides
+ * const env = createEnvProxy(process.env, { NODE_ENV: 'test' })
+ * console.log(env.PATH)  // Works with any case: PATH, Path, path
+ * console.log(env.NODE_ENV)  // 'test'
+ *
+ * @example
+ * // Pass to child process spawn
+ * import { createEnvProxy } from '@socketsecurity/lib/env'
+ * import { spawn } from '@socketsecurity/lib/spawn'
+ *
+ * spawn('node', ['script.js'], {
+ *   env: createEnvProxy(process.env, { NODE_ENV: 'test' })
+ * })
+ */
+export declare function createEnvProxy(base: NodeJS.ProcessEnv, overrides?: Record<string, string | undefined>): NodeJS.ProcessEnv;
 /**
  * Convert an environment variable value to a boolean.
  */
@@ -13,3 +48,35 @@ export declare function envAsNumber(value: unknown, defaultValue?: number): numb
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function envAsString(value: unknown, defaultValue?: string): string;
+/**
+ * Find a case-insensitive environment variable key match.
+ * Searches for an environment variable key that matches the given uppercase name,
+ * using optimized fast-path checks to minimize expensive toUpperCase() calls.
+ *
+ * **Use Cases:**
+ * - Finding PATH when env object has "Path" or "path"
+ * - Cross-platform env var access where case may vary
+ * - Custom case-insensitive env lookups
+ *
+ * **Performance:**
+ * - Fast path: Checks length first (O(1)) before toUpperCase (expensive)
+ * - Only converts to uppercase when length matches
+ * - Early exit on first match
+ *
+ * @param env - Environment object or env-like record to search
+ * @param upperEnvVarName - Uppercase environment variable name to find (e.g., 'PATH')
+ * @returns The actual key from env that matches (e.g., 'Path'), or undefined
+ *
+ * @example
+ * // Find PATH regardless of case
+ * const envObj = { Path: 'C:\\Windows', NODE_ENV: 'test' }
+ * const key = findCaseInsensitiveEnvKey(envObj, 'PATH')
+ * console.log(key)  // 'Path'
+ * console.log(envObj[key])  // 'C:\\Windows'
+ *
+ * @example
+ * // Not found returns undefined
+ * const key = findCaseInsensitiveEnvKey({}, 'MISSING')
+ * console.log(key)  // undefined
+ */
+export declare function findCaseInsensitiveEnvKey(env: Record<string, string | undefined>, upperEnvVarName: string): string | undefined;

package/dist/env.js

@@ -1,3 +1,3 @@
 /* Socket Lib - Built with esbuild */
-var i=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var N=Object.prototype.hasOwnProperty;var c=(n,r)=>{for(var t in r)i(n,t,{get:r[t],enumerable:!0})},f=(n,r,t,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of u(r))!N.call(n,e)&&e!==t&&i(n,e,{get:()=>r[e],enumerable:!(o=m(r,e))||o.enumerable});return n};var b=n=>f(i({},"__esModule",{value:!0}),n);var k={};c(k,{envAsBoolean:()=>y,envAsNumber:()=>S,envAsString:()=>d});module.exports=b(k);const g=Number,p=Number.isFinite,w=Number.parseInt,s=String;function y(n,r=!1){if(typeof n=="string"){const t=n.trim();return t==="1"||t.toLowerCase()==="true"}return n==null?!!r:!!n}function S(n,r=0){const t=w(String(n),10);return(p(t)?t:g(r))||0}function d(n,r=""){return typeof n=="string"?n.trim():n==null?r===""?r:s(r).trim():s(n).trim()}0&&(module.exports={envAsBoolean,envAsNumber,envAsString});
+var f=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var m=(t,n)=>{for(var r in n)f(t,r,{get:n[r],enumerable:!0})},N=(t,n,r,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of y(n))!P.call(t,i)&&i!==r&&f(t,i,{get:()=>n[i],enumerable:!(e=d(n,i))||e.enumerable});return t};var S=t=>N(f({},"__esModule",{value:!0}),t);var b={};m(b,{createEnvProxy:()=>k,envAsBoolean:()=>a,envAsNumber:()=>w,envAsString:()=>C,findCaseInsensitiveEnvKey:()=>u});module.exports=S(b);const A=Number,E=Number.isFinite,O=Number.parseInt,c=String,g=new Set(["APPDATA","COMSPEC","HOME","LOCALAPPDATA","PATH","PATHEXT","PROGRAMFILES","SYSTEMROOT","TEMP","TMP","USERPROFILE","WINDIR"]);function k(t,n){return new Proxy({},{get(r,e){if(typeof e!="string")return;if(n&&e in n)return n[e];if(e in t)return t[e];const i=e.toUpperCase();if(g.has(i)){if(n){const o=u(n,i);if(o!==void 0)return n[o]}const s=u(t,i);if(s!==void 0)return t[s]}},ownKeys(r){return[...new Set([...Object.keys(t),...n?Object.keys(n):[]])]},getOwnPropertyDescriptor(r,e){if(typeof e!="string")return;const i=this.get?.(r,e,r);return i!==void 0?{enumerable:!0,configurable:!0,writable:!0,value:i}:void 0},has(r,e){if(typeof e!="string")return!1;if(n&&e in n||e in t)return!0;const i=e.toUpperCase();return!!(g.has(i)&&(n&&u(n,i)!==void 0||u(t,i)!==void 0))},set(r,e,i){return typeof e=="string"&&n?(n[e]=i,!0):!1}})}function a(t,n=!1){if(typeof t=="string"){const r=t.trim();return r==="1"||r.toLowerCase()==="true"}return t==null?!!n:!!t}function w(t,n=0){const r=O(String(t),10);return(E(r)?r:A(n))||0}function C(t,n=""){return typeof t=="string"?t.trim():t==null?n===""?n:c(n).trim():c(t).trim()}function u(t,n){const r=n.length;for(const e of Object.keys(t))if(e.length===r&&e.toUpperCase()===n)return e}0&&(module.exports={createEnvProxy,envAsBoolean,envAsNumber,envAsString,findCaseInsensitiveEnvKey});
 //# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/env.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Environment variable parsing and conversion utilities.\n * Provides type-safe conversion functions for boolean, number, and string values.\n */\n\nconst NumberCtor = Number\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\nconst NumberIsFinite = Number.isFinite\nconst NumberParseInt = Number.parseInt\nconst StringCtor = String\n\n/**\n * Convert an environment variable value to a boolean.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function envAsBoolean(value: unknown, defaultValue = false): boolean {\n  if (typeof value === 'string') {\n    const trimmed = value.trim()\n    return trimmed === '1' || trimmed.toLowerCase() === 'true'\n  }\n  if (value === null || value === undefined) {\n    return !!defaultValue\n  }\n  return !!value\n}\n\n/**\n * Convert an environment variable value to a number.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function envAsNumber(value: unknown, defaultValue = 0): number {\n  const numOrNaN = NumberParseInt(String(value), 10)\n  const numMayBeNegZero = NumberIsFinite(numOrNaN)\n    ? numOrNaN\n    : NumberCtor(defaultValue)\n  // Ensure -0 is treated as 0.\n  return numMayBeNegZero || 0\n}\n\n/**\n * Convert an environment variable value to a trimmed string.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function envAsString(value: unknown, defaultValue = ''): string {\n  if (typeof value === 'string') {\n    return value.trim()\n  }\n  if (value === null || value === undefined) {\n    return defaultValue === '' ? defaultValue : StringCtor(defaultValue).trim()\n  }\n  return StringCtor(value).trim()\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,EAAA,gBAAAC,EAAA,gBAAAC,IAAA,eAAAC,EAAAL,GAKA,MAAMM,EAAa,OAKbC,EAAiB,OAAO,SACxBC,EAAiB,OAAO,SACxBC,EAAa,OAMZ,SAASP,EAAaQ,EAAgBC,EAAe,GAAgB,CAC1E,GAAI,OAAOD,GAAU,SAAU,CAC7B,MAAME,EAAUF,EAAM,KAAK,EAC3B,OAAOE,IAAY,KAAOA,EAAQ,YAAY,IAAM,MACtD,CACA,OAAIF,GAAU,KACL,CAAC,CAACC,EAEJ,CAAC,CAACD,CACX,CAMO,SAASP,EAAYO,EAAgBC,EAAe,EAAW,CACpE,MAAME,EAAWL,EAAe,OAAOE,CAAK,EAAG,EAAE,EAKjD,OAJwBH,EAAeM,CAAQ,EAC3CA,EACAP,EAAWK,CAAY,IAED,CAC5B,CAMO,SAASP,EAAYM,EAAgBC,EAAe,GAAY,CACrE,OAAI,OAAOD,GAAU,SACZA,EAAM,KAAK,EAEhBA,GAAU,KACLC,IAAiB,GAAKA,EAAeF,EAAWE,CAAY,EAAE,KAAK,EAErEF,EAAWC,CAAK,EAAE,KAAK,CAChC",
-  "names": ["env_exports", "__export", "envAsBoolean", "envAsNumber", "envAsString", "__toCommonJS", "NumberCtor", "NumberIsFinite", "NumberParseInt", "StringCtor", "value", "defaultValue", "trimmed", "numOrNaN"]
+  "sourcesContent": ["/**\n * @fileoverview Environment variable parsing and conversion utilities.\n * Provides type-safe conversion functions for boolean, number, and string values.\n */\n\nconst NumberCtor = Number\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\nconst NumberIsFinite = Number.isFinite\nconst NumberParseInt = Number.parseInt\nconst StringCtor = String\n\n// Common environment variables that have case sensitivity issues on Windows.\n// These are checked with case-insensitive matching when exact matches fail.\nconst caseInsensitiveKeys = new Set([\n  'APPDATA',\n  'COMSPEC',\n  'HOME',\n  'LOCALAPPDATA',\n  'PATH',\n  'PATHEXT',\n  'PROGRAMFILES',\n  'SYSTEMROOT',\n  'TEMP',\n  'TMP',\n  'USERPROFILE',\n  'WINDIR',\n])\n\n/**\n * Create a case-insensitive environment variable Proxy for Windows compatibility.\n * On Windows, environment variables are case-insensitive (PATH vs Path vs path).\n * This Proxy provides consistent access regardless of case, with priority given\n * to exact matches, then case-insensitive matches for known vars.\n *\n * **Use Cases:**\n * - Cross-platform test environments needing consistent env var access\n * - Windows compatibility when passing env to child processes\n * - Merging environment overrides while preserving case-insensitive lookups\n *\n * **Performance Note:**\n * Proxy operations have runtime overhead. Only use when Windows case-insensitive\n * access is required. For most use cases, process.env directly is sufficient.\n *\n * @param base - Base environment object (usually process.env)\n * @param overrides - Optional overrides to merge\n * @returns Proxy that handles case-insensitive env var access\n *\n * @example\n * // Create a Proxy with overrides\n * const env = createEnvProxy(process.env, { NODE_ENV: 'test' })\n * console.log(env.PATH)  // Works with any case: PATH, Path, path\n * console.log(env.NODE_ENV)  // 'test'\n *\n * @example\n * // Pass to child process spawn\n * import { createEnvProxy } from '@socketsecurity/lib/env'\n * import { spawn } from '@socketsecurity/lib/spawn'\n *\n * spawn('node', ['script.js'], {\n *   env: createEnvProxy(process.env, { NODE_ENV: 'test' })\n * })\n */\nexport function createEnvProxy(\n  base: NodeJS.ProcessEnv,\n  overrides?: Record<string, string | undefined>,\n): NodeJS.ProcessEnv {\n  return new Proxy(\n    {},\n    {\n      get(_target, prop) {\n        if (typeof prop !== 'string') {\n          return undefined\n        }\n\n        // Priority 1: Check overrides for exact match.\n        if (overrides && prop in overrides) {\n          return overrides[prop]\n        }\n\n        // Priority 2: Check base for exact match.\n        if (prop in base) {\n          return base[prop]\n        }\n\n        // Priority 3: Case-insensitive lookup for known keys.\n        const upperProp = prop.toUpperCase()\n        if (caseInsensitiveKeys.has(upperProp)) {\n          // Check overrides with case variations.\n          if (overrides) {\n            const key = findCaseInsensitiveEnvKey(overrides, upperProp)\n            if (key !== undefined) {\n              return overrides[key]\n            }\n          }\n          // Check base with case variations.\n          const key = findCaseInsensitiveEnvKey(base, upperProp)\n          if (key !== undefined) {\n            return base[key]\n          }\n        }\n\n        return undefined\n      },\n\n      ownKeys(_target) {\n        const keys = new Set<string>([\n          ...Object.keys(base),\n          ...(overrides ? Object.keys(overrides) : []),\n        ])\n        return [...keys]\n      },\n\n      getOwnPropertyDescriptor(_target, prop) {\n        if (typeof prop !== 'string') {\n          return undefined\n        }\n\n        // Use the same lookup logic as get().\n        const value = this.get?.(_target, prop, _target)\n        return value !== undefined\n          ? {\n              enumerable: true,\n              configurable: true,\n              writable: true,\n              value,\n            }\n          : undefined\n      },\n\n      has(_target, prop) {\n        if (typeof prop !== 'string') {\n          return false\n        }\n\n        // Check overrides.\n        if (overrides && prop in overrides) {\n          return true\n        }\n\n        // Check base.\n        if (prop in base) {\n          return true\n        }\n\n        // Case-insensitive check.\n        const upperProp = prop.toUpperCase()\n        if (caseInsensitiveKeys.has(upperProp)) {\n          if (\n            overrides &&\n            findCaseInsensitiveEnvKey(overrides, upperProp) !== undefined\n          ) {\n            return true\n          }\n          if (findCaseInsensitiveEnvKey(base, upperProp) !== undefined) {\n            return true\n          }\n        }\n\n        return false\n      },\n\n      set(_target, prop, value) {\n        if (typeof prop === 'string' && overrides) {\n          overrides[prop] = value\n          return true\n        }\n        return false\n      },\n    },\n  ) as NodeJS.ProcessEnv\n}\n\n/**\n * Convert an environment variable value to a boolean.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function envAsBoolean(value: unknown, defaultValue = false): boolean {\n  if (typeof value === 'string') {\n    const trimmed = value.trim()\n    return trimmed === '1' || trimmed.toLowerCase() === 'true'\n  }\n  if (value === null || value === undefined) {\n    return !!defaultValue\n  }\n  return !!value\n}\n\n/**\n * Convert an environment variable value to a number.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function envAsNumber(value: unknown, defaultValue = 0): number {\n  const numOrNaN = NumberParseInt(String(value), 10)\n  const numMayBeNegZero = NumberIsFinite(numOrNaN)\n    ? numOrNaN\n    : NumberCtor(defaultValue)\n  // Ensure -0 is treated as 0.\n  return numMayBeNegZero || 0\n}\n\n/**\n * Convert an environment variable value to a trimmed string.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function envAsString(value: unknown, defaultValue = ''): string {\n  if (typeof value === 'string') {\n    return value.trim()\n  }\n  if (value === null || value === undefined) {\n    return defaultValue === '' ? defaultValue : StringCtor(defaultValue).trim()\n  }\n  return StringCtor(value).trim()\n}\n\n/**\n * Find a case-insensitive environment variable key match.\n * Searches for an environment variable key that matches the given uppercase name,\n * using optimized fast-path checks to minimize expensive toUpperCase() calls.\n *\n * **Use Cases:**\n * - Finding PATH when env object has \"Path\" or \"path\"\n * - Cross-platform env var access where case may vary\n * - Custom case-insensitive env lookups\n *\n * **Performance:**\n * - Fast path: Checks length first (O(1)) before toUpperCase (expensive)\n * - Only converts to uppercase when length matches\n * - Early exit on first match\n *\n * @param env - Environment object or env-like record to search\n * @param upperEnvVarName - Uppercase environment variable name to find (e.g., 'PATH')\n * @returns The actual key from env that matches (e.g., 'Path'), or undefined\n *\n * @example\n * // Find PATH regardless of case\n * const envObj = { Path: 'C:\\\\Windows', NODE_ENV: 'test' }\n * const key = findCaseInsensitiveEnvKey(envObj, 'PATH')\n * console.log(key)  // 'Path'\n * console.log(envObj[key])  // 'C:\\\\Windows'\n *\n * @example\n * // Not found returns undefined\n * const key = findCaseInsensitiveEnvKey({}, 'MISSING')\n * console.log(key)  // undefined\n */\nexport function findCaseInsensitiveEnvKey(\n  env: Record<string, string | undefined>,\n  upperEnvVarName: string,\n): string | undefined {\n  const targetLength = upperEnvVarName.length\n  for (const key of Object.keys(env)) {\n    // Fast path: bail early if lengths don't match.\n    if (key.length !== targetLength) {\n      continue\n    }\n    // Only call toUpperCase if length matches.\n    if (key.toUpperCase() === upperEnvVarName) {\n      return key\n    }\n  }\n  return undefined\n}\n"],
+  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,oBAAAE,EAAA,iBAAAC,EAAA,gBAAAC,EAAA,gBAAAC,EAAA,8BAAAC,IAAA,eAAAC,EAAAP,GAKA,MAAMQ,EAAa,OAKbC,EAAiB,OAAO,SACxBC,EAAiB,OAAO,SACxBC,EAAa,OAIbC,EAAsB,IAAI,IAAI,CAClC,UACA,UACA,OACA,eACA,OACA,UACA,eACA,aACA,OACA,MACA,cACA,QACF,CAAC,EAoCM,SAASV,EACdW,EACAC,EACmB,CACnB,OAAO,IAAI,MACT,CAAC,EACD,CACE,IAAIC,EAASC,EAAM,CACjB,GAAI,OAAOA,GAAS,SAClB,OAIF,GAAIF,GAAaE,KAAQF,EACvB,OAAOA,EAAUE,CAAI,EAIvB,GAAIA,KAAQH,EACV,OAAOA,EAAKG,CAAI,EAIlB,MAAMC,EAAYD,EAAK,YAAY,EACnC,GAAIJ,EAAoB,IAAIK,CAAS,EAAG,CAEtC,GAAIH,EAAW,CACb,MAAMI,EAAMZ,EAA0BQ,EAAWG,CAAS,EAC1D,GAAIC,IAAQ,OACV,OAAOJ,EAAUI,CAAG,CAExB,CAEA,MAAMA,EAAMZ,EAA0BO,EAAMI,CAAS,EACrD,GAAIC,IAAQ,OACV,OAAOL,EAAKK,CAAG,CAEnB,CAGF,EAEA,QAAQH,EAAS,CAKf,MAAO,CAAC,GAJK,IAAI,IAAY,CAC3B,GAAG,OAAO,KAAKF,CAAI,EACnB,GAAIC,EAAY,OAAO,KAAKA,CAAS,EAAI,CAAC,CAC5C,CAAC,CACc,CACjB,EAEA,yBAAyBC,EAASC,EAAM,CACtC,GAAI,OAAOA,GAAS,SAClB,OAIF,MAAMG,EAAQ,KAAK,MAAMJ,EAASC,EAAMD,CAAO,EAC/C,OAAOI,IAAU,OACb,CACE,WAAY,GACZ,aAAc,GACd,SAAU,GACV,MAAAA,CACF,EACA,MACN,EAEA,IAAIJ,EAASC,EAAM,CACjB,GAAI,OAAOA,GAAS,SAClB,MAAO,GAST,GALIF,GAAaE,KAAQF,GAKrBE,KAAQH,EACV,MAAO,GAIT,MAAMI,EAAYD,EAAK,YAAY,EACnC,MAAI,GAAAJ,EAAoB,IAAIK,CAAS,IAEjCH,GACAR,EAA0BQ,EAAWG,CAAS,IAAM,QAIlDX,EAA0BO,EAAMI,CAAS,IAAM,QAMvD,EAEA,IAAIF,EAASC,EAAMG,EAAO,CACxB,OAAI,OAAOH,GAAS,UAAYF,GAC9BA,EAAUE,CAAI,EAAIG,EACX,IAEF,EACT,CACF,CACF,CACF,CAMO,SAAShB,EAAagB,EAAgBC,EAAe,GAAgB,CAC1E,GAAI,OAAOD,GAAU,SAAU,CAC7B,MAAME,EAAUF,EAAM,KAAK,EAC3B,OAAOE,IAAY,KAAOA,EAAQ,YAAY,IAAM,MACtD,CACA,OAAIF,GAAU,KACL,CAAC,CAACC,EAEJ,CAAC,CAACD,CACX,CAMO,SAASf,EAAYe,EAAgBC,EAAe,EAAW,CACpE,MAAME,EAAWZ,EAAe,OAAOS,CAAK,EAAG,EAAE,EAKjD,OAJwBV,EAAea,CAAQ,EAC3CA,EACAd,EAAWY,CAAY,IAED,CAC5B,CAMO,SAASf,EAAYc,EAAgBC,EAAe,GAAY,CACrE,OAAI,OAAOD,GAAU,SACZA,EAAM,KAAK,EAEhBA,GAAU,KACLC,IAAiB,GAAKA,EAAeT,EAAWS,CAAY,EAAE,KAAK,EAErET,EAAWQ,CAAK,EAAE,KAAK,CAChC,CAiCO,SAASb,EACdiB,EACAC,EACoB,CACpB,MAAMC,EAAeD,EAAgB,OACrC,UAAWN,KAAO,OAAO,KAAKK,CAAG,EAE/B,GAAIL,EAAI,SAAWO,GAIfP,EAAI,YAAY,IAAMM,EACxB,OAAON,CAIb",
+  "names": ["env_exports", "__export", "createEnvProxy", "envAsBoolean", "envAsNumber", "envAsString", "findCaseInsensitiveEnvKey", "__toCommonJS", "NumberCtor", "NumberIsFinite", "NumberParseInt", "StringCtor", "caseInsensitiveKeys", "base", "overrides", "_target", "prop", "upperProp", "key", "value", "defaultValue", "trimmed", "numOrNaN", "env", "upperEnvVarName", "targetLength"]
 }

package/dist/fs.d.ts

@@ -585,6 +585,13 @@ export declare function readJson(filepath: PathLike, options?: ReadJsonOptions |
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function readJsonSync(filepath: PathLike, options?: ReadJsonOptions | string | undefined): import("./json").JsonValue;
+/**
+ * Invalidate the cached allowed directories.
+ * Called automatically by the paths/rewire module when paths are overridden in tests.
+ *
+ * @internal Used for test rewiring
+ */
+export declare function invalidatePathCache(): void;
 /**
  * Safely delete a file or directory asynchronously with built-in protections.
  * Uses `del` for safer deletion that prevents removing cwd and above by default.

package/dist/fs.js

@@ -1,5 +1,5 @@
 /* Socket Lib - Built with esbuild */
-var P=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var z=Object.prototype.hasOwnProperty;var K=(n,e)=>{for(var t in e)P(n,t,{get:e[t],enumerable:!0})},H=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of M(e))!z.call(n,o)&&o!==t&&P(n,o,{get:()=>e[o],enumerable:!(i=G(e,o))||i.enumerable});return n};var Q=n=>H(P({},"__esModule",{value:!0}),n);var me={};K(me,{findUp:()=>X,findUpSync:()=>Y,isDir:()=>Z,isDirEmptySync:()=>B,isDirSync:()=>ee,isSymLinkSync:()=>ne,readDirNames:()=>re,readDirNamesSync:()=>ie,readFileBinary:()=>oe,readFileBinarySync:()=>ae,readFileUtf8:()=>se,readFileUtf8Sync:()=>ce,readJson:()=>de,readJsonSync:()=>fe,safeDelete:()=>le,safeDeleteSync:()=>ue,safeReadFile:()=>pe,safeReadFileSync:()=>ye,safeStats:()=>C,safeStatsSync:()=>N,uniqueSync:()=>ge,validateFiles:()=>te,writeJson:()=>he,writeJsonSync:()=>_e});module.exports=Q(me);var j=require("#constants/process"),S=require("./arrays"),D=require("./globs"),J=require("./json"),A=require("./objects"),l=require("./path"),U=require("./sorts");const w=(0,j.getAbortSignal)(),W=(0,A.objectFreeze)({__proto__:null,force:!0,maxRetries:3,recursive:!0,retryDelay:200});let k;function d(){return k===void 0&&(k=require("node:fs")),k}let L;function O(){return L===void 0&&(L=require("node:path")),L}let E;function I(){return E===void 0&&(E=require("node:os")),E}function q(n,e,t){const{ignore:i,includeEmpty:o=!0,sort:s=!0}={__proto__:null,...t},c=O(),a=n.filter(r=>r.isDirectory()&&(o||!B(c.join(e||r.parentPath,r.name),{ignore:i}))).map(r=>r.name);return s?a.sort(U.naturalCompare):a}function T(n,e,t,i,o=2){const s=t?e:"";return`${JSON.stringify(n,i,o).replace(/\n/g,e)}${s}`}async function X(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=d(),a=O();let r=a.resolve(t);const{root:f}=a.parse(r),p=(0,S.isArray)(n)?n:[n];for(;r&&r!==f;){for(const h of p){if(i?.aborted)return;const y=a.join(r,h);try{const u=await c.promises.stat(y);if(!o&&u.isFile())return(0,l.normalizePath)(y);if(!s&&u.isDirectory())return(0,l.normalizePath)(y)}catch{}}r=a.dirname(r)}}function Y(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=d(),a=O();let r=a.resolve(t);const{root:f}=a.parse(r),p=i?a.resolve(i):void 0,h=(0,S.isArray)(n)?n:[n];for(;r&&r!==f;){if(p&&r===p){for(const y of h){const u=a.join(r,y);try{const g=c.statSync(u);if(!o&&g.isFile())return(0,l.normalizePath)(u);if(!s&&g.isDirectory())return(0,l.normalizePath)(u)}catch{}}return}for(const y of h){const u=a.join(r,y);try{const g=c.statSync(u);if(!o&&g.isFile())return(0,l.normalizePath)(u);if(!s&&g.isDirectory())return(0,l.normalizePath)(u)}catch{}}r=a.dirname(r)}}async function Z(n){return!!(await C(n))?.isDirectory()}function ee(n){return!!N(n)?.isDirectory()}function B(n,e){const{ignore:t=D.defaultIgnore}={__proto__:null,...e},i=d();try{const o=i.readdirSync(n),{length:s}=o;if(s===0)return!0;const c=(0,D.getGlobMatcher)(t,{cwd:(0,l.pathLikeToString)(n)});let a=0;for(let r=0;r<s;r+=1){const f=o[r];f&&c(f)&&(a+=1)}return a===s}catch{return!1}}function ne(n){const e=d();try{return e.lstatSync(n).isSymbolicLink()}catch{}return!1}function te(n){const e=d(),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 re(n,e){const t=d();try{return q(await t.promises.readdir(n,{__proto__:null,encoding:"utf8",withFileTypes:!0}),String(n),e)}catch{}return[]}function ie(n,e){const t=d();try{return q(t.readdirSync(n,{__proto__:null,encoding:"utf8",withFileTypes:!0}),String(n),e)}catch{}return[]}async function oe(n,e){const t=typeof e=="string"?{encoding:e}:e;return await d().promises.readFile(n,{signal:w,...t,encoding:null})}async function se(n,e){const t=typeof e=="string"?{encoding:e}:e;return await d().promises.readFile(n,{signal:w,...t,encoding:"utf8"})}function ae(n,e){const t=typeof e=="string"?{encoding:e}:e;return d().readFileSync(n,{...t,encoding:null})}function ce(n,e){const t=typeof e=="string"?{encoding:e}:e;return d().readFileSync(n,{...t,encoding:"utf8"})}async function de(n,e){const t=typeof e=="string"?{encoding:e}:e,{reviver:i,throws:o,...s}={__proto__:null,...t},c=o===void 0||!!o,a=d();let r="";try{r=await a.promises.readFile(n,{__proto__:null,encoding:"utf8",...s})}catch(f){if(c)throw f;return}return(0,J.jsonParse)(r,{filepath:String(n),reviver:i,throws:c})}function fe(n,e){const t=typeof e=="string"?{encoding:e}:e,{reviver:i,throws:o,...s}={__proto__:null,...t},c=o===void 0||!!o,a=d();let r="";try{r=a.readFileSync(n,{__proto__:null,encoding:"utf8",...s})}catch(f){if(c)throw f;return}return(0,J.jsonParse)(r,{filepath:String(n),reviver:i,throws:c})}async function le(n,e){const t=require("./external/del"),{deleteAsync:i}=t,o={__proto__:null,...e},s=(0,S.isArray)(n)?n.map(l.pathLikeToString):[(0,l.pathLikeToString)(n)];let c=o.force!==!1;if(!c&&s.length>0){const a=I(),r=O(),{getSocketCacacheDir:f,getSocketUserDir:p}=require("./paths"),h=a.tmpdir(),y=r.resolve(h),u=f(),g=r.resolve(u),F=p(),v=r.resolve(F);s.every(x=>{const _=r.resolve(x);for(const m of[y,g,v]){const b=_.startsWith(m+r.sep)||_===m,R=r.relative(m,_).startsWith("..");if(b&&!R)return!0}return!1})&&(c=!0)}await i(s,{concurrency:o.maxRetries||W.maxRetries,dryRun:!1,force:c,onlyFiles:!1})}function ue(n,e){const t=require("./external/del"),{deleteSync:i}=t,o={__proto__:null,...e},s=(0,S.isArray)(n)?n.map(l.pathLikeToString):[(0,l.pathLikeToString)(n)];let c=o.force!==!1;if(!c&&s.length>0){const a=I(),r=O(),{getSocketCacacheDir:f,getSocketUserDir:p}=require("./paths"),h=a.tmpdir(),y=r.resolve(h),u=f(),g=r.resolve(u),F=p(),v=r.resolve(F);s.every(x=>{const _=r.resolve(x);for(const m of[y,g,v]){const b=_.startsWith(m+r.sep)||_===m,R=r.relative(m,_).startsWith("..");if(b&&!R)return!0}return!1})&&(c=!0)}i(s,{concurrency:o.maxRetries||W.maxRetries,dryRun:!1,force:c,onlyFiles:!1})}async function pe(n,e){const t=typeof e=="string"?{encoding:e}:e,i=d();try{return await i.promises.readFile(n,{signal:w,...t})}catch{}}async function C(n){const e=d();try{return await e.promises.stat(n)}catch{}}function N(n,e){const t=typeof e=="string"?{encoding:e}:e,i=d();try{return i.statSync(n,{__proto__:null,throwIfNoEntry:!1,...t})}catch{}}function ye(n,e){const t=typeof e=="string"?{encoding:e}:e,i=d();try{return i.readFileSync(n,{__proto__:null,...t})}catch{}}function ge(n){const e=d(),t=O(),i=String(n);if(!e.existsSync(i))return(0,l.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,l.normalizePath)(r)}async function he(n,e,t){const i=typeof t=="string"?{encoding:t}:t,{EOL:o,finalEOL:s,replacer:c,spaces:a,...r}={__proto__:null,...i},f=d(),p=T(e,o||`
-`,s!==void 0?s:!0,c,a);await f.promises.writeFile(n,p,{encoding:"utf8",...r,__proto__:null})}function _e(n,e,t){const i=typeof t=="string"?{encoding:t}:t,{EOL:o,finalEOL:s,replacer:c,spaces:a,...r}={__proto__:null,...i},f=d(),p=T(e,o||`
-`,s!==void 0?s:!0,c,a);f.writeFileSync(n,p,{encoding:"utf8",...r,__proto__:null})}0&&(module.exports={findUp,findUpSync,isDir,isDirEmptySync,isDirSync,isSymLinkSync,readDirNames,readDirNamesSync,readFileBinary,readFileBinarySync,readFileUtf8,readFileUtf8Sync,readJson,readJsonSync,safeDelete,safeDeleteSync,safeReadFile,safeReadFileSync,safeStats,safeStatsSync,uniqueSync,validateFiles,writeJson,writeJsonSync});
+var x=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var N=(n,e)=>{for(var t in e)x(n,t,{get:e[t],enumerable:!0})},$=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of q(e))!C.call(n,o)&&o!==t&&x(n,o,{get:()=>e[o],enumerable:!(i=T(e,o))||i.enumerable});return n};var V=n=>$(x({},"__esModule",{value:!0}),n);var ue={};N(ue,{findUp:()=>G,findUpSync:()=>M,invalidatePathCache:()=>I,isDir:()=>z,isDirEmptySync:()=>j,isDirSync:()=>K,isSymLinkSync:()=>H,readDirNames:()=>X,readDirNamesSync:()=>Y,readFileBinary:()=>Z,readFileBinarySync:()=>ne,readFileUtf8:()=>ee,readFileUtf8Sync:()=>te,readJson:()=>ie,readJsonSync:()=>re,safeDelete:()=>oe,safeDeleteSync:()=>se,safeReadFile:()=>ae,safeReadFileSync:()=>ce,safeStats:()=>W,safeStatsSync:()=>B,uniqueSync:()=>de,validateFiles:()=>Q,writeJson:()=>fe,writeJsonSync:()=>le});module.exports=V(ue);var D=require("#constants/process"),m=require("./arrays"),S=require("./globs"),R=require("./json"),P=require("./objects"),u=require("./path"),k=require("./paths/rewire"),L=require("./sorts");const w=(0,D.getAbortSignal)(),E=(0,P.objectFreeze)({__proto__:null,force:!0,maxRetries:3,recursive:!0,retryDelay:200});let b;function d(){return b===void 0&&(b=require("node:fs")),b}let v;function _(){return v===void 0&&(v=require("node:path")),v}function A(n,e,t){const{ignore:i,includeEmpty:o=!0,sort:s=!0}={__proto__:null,...t},c=_(),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(L.naturalCompare):a}function J(n,e,t,i,o=2){const s=t?e:"";return`${JSON.stringify(n,i,o).replace(/\n/g,e)}${s}`}async function G(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=d(),a=_();let r=a.resolve(t);const{root:f}=a.parse(r),g=(0,m.isArray)(n)?n:[n];for(;r&&r!==f;){for(const y of g){if(i?.aborted)return;const l=a.join(r,y);try{const p=await c.promises.stat(l);if(!o&&p.isFile())return(0,u.normalizePath)(l);if(!s&&p.isDirectory())return(0,u.normalizePath)(l)}catch{}}r=a.dirname(r)}}function M(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=d(),a=_();let r=a.resolve(t);const{root:f}=a.parse(r),g=i?a.resolve(i):void 0,y=(0,m.isArray)(n)?n:[n];for(;r&&r!==f;){if(g&&r===g){for(const l of y){const p=a.join(r,l);try{const h=c.statSync(p);if(!o&&h.isFile())return(0,u.normalizePath)(p);if(!s&&h.isDirectory())return(0,u.normalizePath)(p)}catch{}}return}for(const l of y){const p=a.join(r,l);try{const h=c.statSync(p);if(!o&&h.isFile())return(0,u.normalizePath)(p);if(!s&&h.isDirectory())return(0,u.normalizePath)(p)}catch{}}r=a.dirname(r)}}async function z(n){return!!(await W(n))?.isDirectory()}function K(n){return!!B(n)?.isDirectory()}function j(n,e){const{ignore:t=S.defaultIgnore}={__proto__:null,...e},i=d();try{const o=i.readdirSync(n),{length:s}=o;if(s===0)return!0;const c=(0,S.getGlobMatcher)(t,{cwd:(0,u.pathLikeToString)(n)});let a=0;for(let r=0;r<s;r+=1){const f=o[r];f&&c(f)&&(a+=1)}return a===s}catch{return!1}}function H(n){const e=d();try{return e.lstatSync(n).isSymbolicLink()}catch{}return!1}function Q(n){const e=d(),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 X(n,e){const t=d();try{return A(await t.promises.readdir(n,{__proto__:null,encoding:"utf8",withFileTypes:!0}),String(n),e)}catch{}return[]}function Y(n,e){const t=d();try{return A(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 d().promises.readFile(n,{signal:w,...t,encoding:null})}async function ee(n,e){const t=typeof e=="string"?{encoding:e}:e;return await d().promises.readFile(n,{signal:w,...t,encoding:"utf8"})}function ne(n,e){const t=typeof e=="string"?{encoding:e}:e;return d().readFileSync(n,{...t,encoding:null})}function te(n,e){const t=typeof e=="string"?{encoding:e}:e;return d().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=d();let r="";try{r=await a.promises.readFile(n,{__proto__:null,encoding:"utf8",...s})}catch(f){if(c)throw f;return}return(0,R.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=d();let r="";try{r=a.readFileSync(n,{__proto__:null,encoding:"utf8",...s})}catch(f){if(c)throw f;return}return(0,R.jsonParse)(r,{filepath:String(n),reviver:i,throws:c})}let O;function U(){if(O===void 0){const n=_(),{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,k.registerCacheInvalidation)(I);async function oe(n,e){const t=require("./external/del"),{deleteAsync:i}=t,o={__proto__:null,...e},s=(0,m.isArray)(n)?n.map(u.pathLikeToString):[(0,u.pathLikeToString)(n)];let c=o.force!==!1;if(!c&&s.length>0){const a=_(),r=U();s.every(g=>{const y=a.resolve(g);for(const l of r){const p=y.startsWith(l+a.sep)||y===l,F=a.relative(l,y).startsWith("..");if(p&&!F)return!0}return!1})&&(c=!0)}await i(s,{concurrency:o.maxRetries||E.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,m.isArray)(n)?n.map(u.pathLikeToString):[(0,u.pathLikeToString)(n)];let c=o.force!==!1;if(!c&&s.length>0){const a=_(),r=U();s.every(g=>{const y=a.resolve(g);for(const l of r){const p=y.startsWith(l+a.sep)||y===l,F=a.relative(l,y).startsWith("..");if(p&&!F)return!0}return!1})&&(c=!0)}i(s,{concurrency:o.maxRetries||E.maxRetries,dryRun:!1,force:c,onlyFiles:!1})}async function ae(n,e){const t=typeof e=="string"?{encoding:e}:e,i=d();try{return await i.promises.readFile(n,{signal:w,...t})}catch{}}async function W(n){const e=d();try{return await e.promises.stat(n)}catch{}}function B(n,e){const t=typeof e=="string"?{encoding:e}:e,i=d();try{return i.statSync(n,{__proto__:null,throwIfNoEntry:!1,...t})}catch{}}function ce(n,e){const t=typeof e=="string"?{encoding:e}:e,i=d();try{return i.readFileSync(n,{__proto__:null,...t})}catch{}}function de(n){const e=d(),t=_(),i=String(n);if(!e.existsSync(i))return(0,u.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,u.normalizePath)(r)}async function fe(n,e,t){const i=typeof t=="string"?{encoding:t}:t,{EOL:o,finalEOL:s,replacer:c,spaces:a,...r}={__proto__:null,...i},f=d(),g=J(e,o||`
+`,s!==void 0?s:!0,c,a);await f.promises.writeFile(n,g,{encoding:"utf8",...r,__proto__:null})}function le(n,e,t){const i=typeof t=="string"?{encoding:t}:t,{EOL:o,finalEOL:s,replacer:c,spaces:a,...r}={__proto__:null,...i},f=d(),g=J(e,o||`
+`,s!==void 0?s:!0,c,a);f.writeFileSync(n,g,{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,safeReadFile,safeReadFileSync,safeStats,safeStatsSync,uniqueSync,validateFiles,writeJson,writeJsonSync});
 //# sourceMappingURL=fs.js.map