@socketsecurity/lib 3.0.2 → 3.0.4

package/dist/debug.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/debug.ts"],
   "sourcesContent": ["/**\n * @fileoverview Debug logging utilities with lazy loading and environment-based control.\n * Provides Socket CLI specific debug functionality and logging formatters.\n */\n\nimport { getSpinner } from '#constants/process'\nimport { getDebug } from '#env/debug'\nimport { getSocketDebug } from '#env/socket'\nimport isUnicodeSupported from './external/@socketregistry/is-unicode-supported'\nimport debugJs from './external/debug'\n\nimport { getDefaultLogger } from './logger'\nimport { hasOwn } from './objects'\nimport { applyLinePrefix } from './strings'\n\nconst logger = getDefaultLogger()\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\nconst ReflectApply = Reflect.apply\n\n// Type definitions\ninterface DebugOptions {\n  namespaces?: string\n  spinner?: { isSpinning: boolean; stop(): void; start(): void }\n  [key: string]: unknown\n}\n\ntype NamespacesOrOptions = string | DebugOptions\n\ninterface InspectOptions {\n  depth?: number | null\n  colors?: boolean\n  [key: string]: unknown\n}\n\nexport type { DebugOptions, NamespacesOrOptions, InspectOptions }\n\nconst debugByNamespace = new Map()\n/**\n * Get or create a debug instance for a namespace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getDebugJsInstance(namespace: string) {\n  let inst = debugByNamespace.get(namespace)\n  if (inst) {\n    return inst\n  }\n  if (\n    !getDebug() &&\n    getSocketDebug() &&\n    (namespace === 'error' || namespace === 'notice')\n  ) {\n    debugJs.enable(namespace)\n  }\n  inst = debugJs(namespace)\n  inst.log = customLog\n  debugByNamespace.set(namespace, inst)\n  return inst\n}\n\nlet _util: typeof import('util') | undefined\n/**\n * Lazily load the util module.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getUtil() {\n  if (_util === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _util = /*@__PURE__*/ require('node:util')\n  }\n  return _util as typeof import('util')\n}\n\n/**\n * Extract caller information from the stack trace.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getCallerInfo(stackOffset: number = 3): string {\n  let name = ''\n  const captureStackTrace = Error.captureStackTrace\n  if (typeof captureStackTrace === 'function') {\n    const obj: { stack?: unknown } = {}\n    captureStackTrace(obj, getCallerInfo)\n    const stack = obj.stack\n    if (typeof stack === 'string') {\n      let lineCount = 0\n      let lineStart = 0\n      for (let i = 0, { length } = stack; i < length; i += 1) {\n        if (stack[i] === '\\n') {\n          lineCount += 1\n          if (lineCount < stackOffset) {\n            // Store the start index of the next line.\n            lineStart = i + 1\n          } else {\n            // Extract the full line and trim it.\n            const line = stack.slice(lineStart, i).trimStart()\n            // Match the function name portion (e.g., \"async runFix\").\n            const match = /(?<=^at\\s+).*?(?=\\s+\\(|$)/.exec(line)?.[0]\n            if (match) {\n              name = match\n                // Strip known V8 invocation prefixes to get the name.\n                .replace(/^(?:async|bound|get|new|set)\\s+/, '')\n              if (name.startsWith('Object.')) {\n                // Strip leading 'Object.' if not an own property of Object.\n                const afterDot = name.slice(7 /*'Object.'.length*/)\n                if (!hasOwn(Object, afterDot)) {\n                  name = afterDot\n                }\n              }\n            }\n            break\n          }\n        }\n      }\n    }\n  }\n  return name\n}\n\n/**\n * Custom log function for debug output.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction customLog(...args: unknown[]) {\n  const util = getUtil()\n  const inspectOpts = debugJs.inspectOpts\n    ? {\n        ...debugJs.inspectOpts,\n        showHidden:\n          debugJs.inspectOpts.showHidden === null\n            ? undefined\n            : debugJs.inspectOpts.showHidden,\n        depth:\n          debugJs.inspectOpts.depth === null ||\n          typeof debugJs.inspectOpts.depth === 'boolean'\n            ? undefined\n            : debugJs.inspectOpts.depth,\n      }\n    : {}\n  ReflectApply(logger.info, logger, [\n    util.formatWithOptions(inspectOpts, ...args),\n  ])\n}\n\n/**\n * Extract options from namespaces parameter.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction extractOptions(namespaces: NamespacesOrOptions): DebugOptions {\n  return namespaces !== null && typeof namespaces === 'object'\n    ? ({ __proto__: null, ...namespaces } as DebugOptions)\n    : ({ __proto__: null, namespaces } as DebugOptions)\n}\n\n/**\n * Check if debug is enabled for given namespaces.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isEnabled(namespaces: string | undefined) {\n  // Check if debugging is enabled at all\n  if (!getSocketDebug()) {\n    return false\n  }\n  if (typeof namespaces !== 'string' || !namespaces || namespaces === '*') {\n    return true\n  }\n  // Namespace splitting logic is based the 'debug' package implementation:\n  // https://github.com/debug-js/debug/blob/4.4.1/src/common.js#L169-L173.\n  const split = namespaces\n    .trim()\n    .replace(/\\s+/g, ',')\n    .split(',')\n    .filter(Boolean)\n  const names = []\n  const skips = []\n  for (const ns of split) {\n    if (ns.startsWith('-')) {\n      skips.push(ns.slice(1))\n    } else {\n      names.push(ns)\n    }\n  }\n  if (names.length && !names.some(ns => getDebugJsInstance(ns).enabled)) {\n    return false\n  }\n  return skips.every(ns => !getDebugJsInstance(ns).enabled)\n}\n\n/**\n * Debug output for object inspection with caller info.\n */\nfunction debugDirNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugDirNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  let opts: InspectOptions | undefined = inspectOpts\n  if (opts === undefined) {\n    const debugOpts = debugJs.inspectOpts\n    if (debugOpts) {\n      opts = {\n        ...debugOpts,\n        showHidden:\n          debugOpts.showHidden === null ? undefined : debugOpts.showHidden,\n        depth:\n          debugOpts.depth === null || typeof debugOpts.depth === 'boolean'\n            ? null\n            : debugOpts.depth,\n      } as InspectOptions\n    }\n  }\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  logger.info(`[DEBUG] ${callerName} ${pointingTriangle} object inspection:`)\n  logger.dir(obj, inspectOpts)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\nlet pointingTriangle: string | undefined\n/**\n * Debug output with caller info.\n */\nfunction debugNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugNs -> getCallerInfo).\n  const name = getCallerInfo(4) || 'anonymous'\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${name ? `${name} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : args\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug logging function with caller info.\n */\nfunction debugLogNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugLogNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'anonymous'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const text = args.at(0)\n  const logArgs =\n    typeof text === 'string'\n      ? [\n          applyLinePrefix(\n            `${callerName ? `${callerName} ${pointingTriangle} ` : ''}${text}`,\n            { prefix: '[DEBUG] ' },\n          ),\n          ...args.slice(1),\n        ]\n      : [`[DEBUG] ${callerName} ${pointingTriangle}`, ...args]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Debug output for cache operations with caller info.\n * First argument is the operation type (hit/miss/set/clear).\n * Second argument is the cache key or message.\n * Optional third argument is metadata object.\n */\nfunction debugCacheNs(\n  namespacesOrOpts: NamespacesOrOptions,\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n) {\n  const options = extractOptions(namespacesOrOpts)\n  const { namespaces } = options\n  if (!isEnabled(namespaces as string)) {\n    return\n  }\n  // Get caller info with stack offset of 4 (caller -> debugCacheNs -> getCallerInfo).\n  const callerName = getCallerInfo(4) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const logArgs = meta !== undefined ? [prefix, meta] : [prefix]\n\n  const spinnerInstance = options.spinner || getSpinner()\n  const wasSpinning = spinnerInstance?.isSpinning\n  spinnerInstance?.stop()\n  ReflectApply(logger.info, logger, logArgs)\n  if (wasSpinning) {\n    spinnerInstance?.start()\n  }\n}\n\n/**\n * Cache debug function with caller info.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function debugCache(\n  operation: string,\n  key: string,\n  meta?: unknown | undefined,\n): void {\n  if (!getSocketDebug()) {\n    return\n  }\n  // Get caller info with stack offset of 3 (caller -> debugCache -> getCallerInfo).\n  const callerName = getCallerInfo(3) || 'cache'\n\n  if (pointingTriangle === undefined) {\n    const supported = isUnicodeSupported()\n    pointingTriangle = supported ? '\u25B8' : '>'\n  }\n\n  const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`\n  const args = meta !== undefined ? [prefix, meta] : [prefix]\n  console.log(...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebugNs(namespaces: string | undefined): boolean {\n  return !!getSocketDebug() && isEnabled(namespaces)\n}\n\n/**\n * Debug output with caller info (wrapper for debugNs with default namespace).\n */\nfunction debug(...args: unknown[]): void {\n  debugNs('*', ...args)\n}\n\n/**\n * Debug output for object inspection (wrapper for debugDirNs with default namespace).\n */\nfunction debugDir(\n  obj: unknown,\n  inspectOpts?: InspectOptions | undefined,\n): void {\n  debugDirNs('*', obj, inspectOpts)\n}\n\n/**\n * Debug logging function (wrapper for debugLogNs with default namespace).\n */\nfunction debugLog(...args: unknown[]): void {\n  debugLogNs('*', ...args)\n}\n\n/**\n * Check if debug mode is enabled.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction isDebug(): boolean {\n  return !!getSocketDebug()\n}\n\n/**\n * Create a Node.js util.debuglog compatible function.\n * Returns a function that conditionally writes debug messages to stderr.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debuglog(section: string) {\n  const util = getUtil()\n  return util.debuglog(section)\n}\n\n/**\n * Create timing functions for measuring code execution time.\n * Returns an object with start() and end() methods, plus a callable function.\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction debugtime(label: string) {\n  const util = getUtil()\n  // Node.js util doesn't have debugtime - create a custom implementation\n  let startTime: number | undefined\n  const impl = () => {\n    if (startTime === undefined) {\n      startTime = Date.now()\n    } else {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  impl.start = () => {\n    startTime = Date.now()\n  }\n  impl.end = () => {\n    if (startTime !== undefined) {\n      const duration = Date.now() - startTime\n      util.debuglog('time')(`${label}: ${duration}ms`)\n      startTime = undefined\n    }\n  }\n  return impl\n}\n\n// Export main debug functions with caller info.\nexport { debug }\n// debugCache is already exported directly above\nexport { debugCacheNs }\nexport { debugDir }\nexport { debugDirNs }\nexport { debugLog }\nexport { debuglog }\nexport { debugLogNs }\nexport { debugNs }\nexport { debugtime }\nexport { isDebug }\nexport { isDebugNs }\n"],
-  "mappings": "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",
-  "names": ["debug_exports", "__export", "debug", "debugCache", "debugCacheNs", "debugDir", "debugDirNs", "debugLog", "debugLogNs", "debugNs", "debuglog", "debugtime", "isDebug", "isDebugNs", "__toCommonJS", "import_process", "import_debug", "import_socket", "import_is_unicode_supported", "import_logger", "import_objects", "import_strings", "logger", "ReflectApply", "debugByNamespace", "getDebugJsInstance", "namespace", "inst", "debugJs", "customLog", "_util", "getUtil", "getCallerInfo", "stackOffset", "name", "captureStackTrace", "obj", "stack", "lineCount", "lineStart", "i", "length", "line", "match", "afterDot", "args", "util", "inspectOpts", "extractOptions", "namespaces", "isEnabled", "split", "names", "skips", "ns", "namespacesOrOpts", "options", "callerName", "pointingTriangle", "isUnicodeSupported", "opts", "debugOpts", "spinnerInstance", "wasSpinning", "text", "logArgs", "operation", "key", "meta", "prefix", "section", "label", "startTime", "impl", "duration"]
+  "mappings": "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",
+  "names": ["import_debug", "debugJs", "isUnicodeSupported"]
 }

package/dist/dlx-binary.js

@@ -1,9 +1,410 @@
 /* Socket Lib - Built with esbuild */
-var Y=Object.create;var P=Object.defineProperty;var V=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var U=Object.getPrototypeOf,G=Object.prototype.hasOwnProperty;var Q=(t,e)=>{for(var n in e)P(t,n,{get:e[n],enumerable:!0})},F=(t,e,n,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of W(e))!G.call(t,r)&&r!==n&&P(t,r,{get:()=>e[r],enumerable:!(s=V(e,r))||s.enumerable});return t};var I=(t,e,n)=>(n=t!=null?Y(U(t)):{},F(e||!t||!t.__esModule?P(n,"default",{value:t,enumerable:!0}):n,t)),Z=t=>F(P({},"__esModule",{value:!0}),t);var ae={};Q(ae,{cleanDlxCache:()=>ee,dlxBinary:()=>te,downloadBinary:()=>ne,executeBinary:()=>re,getDlxCachePath:()=>_,listDlxCache:()=>se});module.exports=Z(ae);var T=require("crypto"),k=I(require("os")),p=I(require("path")),$=require("#constants/platform"),j=require("./dlx"),N=require("./http-request"),f=require("./fs"),L=require("./objects"),B=require("./path"),z=require("./paths"),H=require("./process-lock"),v=require("./spawn");let A;function b(){return A===void 0&&(A=require("node:fs")),A}function S(t){return p.default.join(t,".dlx-metadata.json")}async function M(t,e){const n=b();try{const s=S(t);if(!n.existsSync(s))return!1;const r=await(0,f.readJson)(s,{throws:!1});if(!(0,L.isObjectObject)(r))return!1;const a=Date.now(),o=r.timestamp;return typeof o!="number"||o<=0?!1:a-o<e}catch{return!1}}async function q(t,e,n){const s=p.default.dirname(e),r=p.default.join(s,"concurrency.lock");return await H.processLock.withLock(r,async()=>{const a=b();if(a.existsSync(e)&&(await a.promises.stat(e)).size>0){const u=await a.promises.readFile(e),d=(0,T.createHash)("sha256");return d.update(u),d.digest("hex")}try{await(0,N.httpDownload)(t,e)}catch(i){throw new Error(`Failed to download binary from ${t}
-Destination: ${e}
-Check your internet connection or verify the URL is accessible.`,{cause:i})}const o=await a.promises.readFile(e),c=(0,T.createHash)("sha256");c.update(o);const m=c.digest("hex");if(n&&m!==n)throw await(0,f.safeDelete)(e),new Error(`Checksum mismatch: expected ${n}, got ${m}`);return $.WIN32||await a.promises.chmod(e,493),m},{staleMs:5e3,touchIntervalMs:2e3})}async function K(t,e,n,s,r){const a=S(t),o={version:"1.0.0",cache_key:e,timestamp:Date.now(),checksum:s,checksum_algorithm:"sha256",platform:k.default.platform(),arch:k.default.arch(),size:r,source:{type:"download",url:n}};await b().promises.writeFile(a,JSON.stringify(o,null,2))}async function ee(t=require("#constants/time").DLX_BINARY_CACHE_TTL){const e=_(),n=b();if(!n.existsSync(e))return 0;let s=0;const r=Date.now(),a=await n.promises.readdir(e);for(const o of a){const c=p.default.join(e,o),m=S(c);try{if(!await(0,f.isDir)(c))continue;const i=await(0,f.readJson)(m,{throws:!1});if(!i||typeof i!="object"||Array.isArray(i))continue;const u=i.timestamp;(typeof u=="number"&&u>0?r-u:Number.POSITIVE_INFINITY)>t&&(await(0,f.safeDelete)(c,{force:!0,recursive:!0}),s+=1)}catch{try{(await n.promises.readdir(c)).length||(await(0,f.safeDelete)(c),s+=1)}catch{}}}return s}async function te(t,e,n){const{cacheTtl:s=require("#constants/time").DLX_BINARY_CACHE_TTL,checksum:r,force:a=!1,name:o,spawnOptions:c,url:m,yes:i}={__proto__:null,...e},u=i===!0?!0:a,d=_(),x=o||`binary-${process.platform}-${k.default.arch()}`,w=`${m}:${x}`,g=(0,j.generateCacheKey)(w),l=p.default.join(d,g),h=(0,B.normalizePath)(p.default.join(l,x)),E=b();let D=!1,C=r;if(!u&&E.existsSync(l)&&await M(l,s))try{const O=S(l),y=await(0,f.readJson)(O,{throws:!1});y&&typeof y=="object"&&!Array.isArray(y)&&typeof y.checksum=="string"?C=y.checksum:D=!0}catch{D=!0}else D=!0;if(D){try{await(0,f.safeMkdir)(l,{recursive:!0})}catch(y){const R=y.code;throw R==="EACCES"||R==="EPERM"?new Error(`Permission denied creating binary cache directory: ${l}
-Please check directory permissions or run with appropriate access.`,{cause:y}):R==="EROFS"?new Error(`Cannot create binary cache directory on read-only filesystem: ${l}
-Ensure the filesystem is writable or set SOCKET_DLX_DIR to a writable location.`,{cause:y}):new Error(`Failed to create binary cache directory: ${l}`,{cause:y})}C=await q(m,h,r);const O=await E.promises.stat(h);await K(l,g,m,C||"",O.size)}const X=$.WIN32&&/\.(?:bat|cmd|ps1)$/i.test(h)?{...c,env:{...c?.env,PATH:`${l}${p.default.delimiter}${process.env.PATH||""}`},shell:!0}:c,J=(0,v.spawn)(h,t,X,n);return{binaryPath:h,downloaded:D,spawnPromise:J}}async function ne(t){const{cacheTtl:e=require("#constants/time").DLX_BINARY_CACHE_TTL,checksum:n,force:s=!1,name:r,url:a}={__proto__:null,...t},o=_(),c=r||`binary-${process.platform}-${k.default.arch()}`,m=`${a}:${c}`,i=(0,j.generateCacheKey)(m),u=p.default.join(o,i),d=(0,B.normalizePath)(p.default.join(u,c)),x=b();let w=!1;if(!s&&x.existsSync(u)&&await M(u,e))w=!1;else{try{await(0,f.safeMkdir)(u,{recursive:!0})}catch(h){const E=h.code;throw E==="EACCES"||E==="EPERM"?new Error(`Permission denied creating binary cache directory: ${u}
-Please check directory permissions or run with appropriate access.`,{cause:h}):E==="EROFS"?new Error(`Cannot create binary cache directory on read-only filesystem: ${u}
-Ensure the filesystem is writable or set SOCKET_DLX_DIR to a writable location.`,{cause:h}):new Error(`Failed to create binary cache directory: ${u}`,{cause:h})}const g=await q(a,d,n),l=await x.promises.stat(d);await K(u,i,a,g||"",l.size),w=!0}return{binaryPath:d,downloaded:w}}function re(t,e,n,s){const r=$.WIN32&&/\.(?:bat|cmd|ps1)$/i.test(t),a=p.default.dirname(t),o=r?{...n,env:{...n?.env,PATH:`${a}${p.default.delimiter}${process.env.PATH||""}`},shell:!0}:n;return(0,v.spawn)(t,e,o,s)}function _(){return(0,z.getSocketDlxDir)()}async function se(){const t=_(),e=b();if(!e.existsSync(t))return[];const n=[],s=Date.now(),r=await e.promises.readdir(t);for(const a of r){const o=p.default.join(t,a);try{if(!await(0,f.isDir)(o))continue;const c=S(o),m=await(0,f.readJson)(c,{throws:!1});if(!m||typeof m!="object"||Array.isArray(m))continue;const i=m,d=i.source?.url||i.url||"",w=(await e.promises.readdir(o)).find(g=>!g.startsWith("."));if(w){const g=p.default.join(o,w),l=await e.promises.stat(g);n.push({age:s-(i.timestamp||0),arch:i.arch||"unknown",checksum:i.checksum||"",name:w,platform:i.platform||"unknown",size:l.size,url:d})}}catch{}}return n}0&&(module.exports={cleanDlxCache,dlxBinary,downloadBinary,executeBinary,getDlxCachePath,listDlxCache});
+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 dlx_binary_exports = {};
+__export(dlx_binary_exports, {
+  cleanDlxCache: () => cleanDlxCache,
+  dlxBinary: () => dlxBinary,
+  downloadBinary: () => downloadBinary,
+  executeBinary: () => executeBinary,
+  getDlxCachePath: () => getDlxCachePath,
+  listDlxCache: () => listDlxCache
+});
+module.exports = __toCommonJS(dlx_binary_exports);
+var import_crypto = require("crypto");
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+var import_platform = require("#constants/platform");
+var import_dlx = require("./dlx");
+var import_http_request = require("./http-request");
+var import_fs = require("./fs");
+var import_objects = require("./objects");
+var import_path2 = require("./path");
+var import_paths = require("./paths");
+var import_process_lock = require("./process-lock");
+var import_spawn = require("./spawn");
+let _fs;
+// @__NO_SIDE_EFFECTS__
+function getFs() {
+  if (_fs === void 0) {
+    _fs = require("node:fs");
+  }
+  return _fs;
+}
+function getMetadataPath(cacheEntryPath) {
+  return import_path.default.join(cacheEntryPath, ".dlx-metadata.json");
+}
+async function isCacheValid(cacheEntryPath, cacheTtl) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    const metaPath = getMetadataPath(cacheEntryPath);
+    if (!fs.existsSync(metaPath)) {
+      return false;
+    }
+    const metadata = await (0, import_fs.readJson)(metaPath, { throws: false });
+    if (!(0, import_objects.isObjectObject)(metadata)) {
+      return false;
+    }
+    const now = Date.now();
+    const timestamp = metadata["timestamp"];
+    if (typeof timestamp !== "number" || timestamp <= 0) {
+      return false;
+    }
+    const age = now - timestamp;
+    return age < cacheTtl;
+  } catch {
+    return false;
+  }
+}
+async function downloadBinaryFile(url, destPath, checksum) {
+  const cacheEntryDir = import_path.default.dirname(destPath);
+  const lockPath = import_path.default.join(cacheEntryDir, "concurrency.lock");
+  return await import_process_lock.processLock.withLock(
+    lockPath,
+    async () => {
+      const fs = /* @__PURE__ */ getFs();
+      if (fs.existsSync(destPath)) {
+        const stats = await fs.promises.stat(destPath);
+        if (stats.size > 0) {
+          const fileBuffer2 = await fs.promises.readFile(destPath);
+          const hasher2 = (0, import_crypto.createHash)("sha256");
+          hasher2.update(fileBuffer2);
+          return hasher2.digest("hex");
+        }
+      }
+      try {
+        await (0, import_http_request.httpDownload)(url, destPath);
+      } catch (e) {
+        throw new Error(
+          `Failed to download binary from ${url}
+Destination: ${destPath}
+Check your internet connection or verify the URL is accessible.`,
+          { cause: e }
+        );
+      }
+      const fileBuffer = await fs.promises.readFile(destPath);
+      const hasher = (0, import_crypto.createHash)("sha256");
+      hasher.update(fileBuffer);
+      const actualChecksum = hasher.digest("hex");
+      if (checksum && actualChecksum !== checksum) {
+        await (0, import_fs.safeDelete)(destPath);
+        throw new Error(
+          `Checksum mismatch: expected ${checksum}, got ${actualChecksum}`
+        );
+      }
+      if (!import_platform.WIN32) {
+        await fs.promises.chmod(destPath, 493);
+      }
+      return actualChecksum;
+    },
+    {
+      // Align with npm npx locking strategy.
+      staleMs: 5e3,
+      touchIntervalMs: 2e3
+    }
+  );
+}
+async function writeMetadata(cacheEntryPath, cacheKey, url, checksum, size) {
+  const metaPath = getMetadataPath(cacheEntryPath);
+  const metadata = {
+    version: "1.0.0",
+    cache_key: cacheKey,
+    timestamp: Date.now(),
+    checksum,
+    checksum_algorithm: "sha256",
+    platform: import_os.default.platform(),
+    arch: import_os.default.arch(),
+    size,
+    source: {
+      type: "download",
+      url
+    }
+  };
+  const fs = /* @__PURE__ */ getFs();
+  await fs.promises.writeFile(metaPath, JSON.stringify(metadata, null, 2));
+}
+async function cleanDlxCache(maxAge = (
+  /*@__INLINE__*/
+  require("#constants/time").DLX_BINARY_CACHE_TTL
+)) {
+  const cacheDir = getDlxCachePath();
+  const fs = /* @__PURE__ */ getFs();
+  if (!fs.existsSync(cacheDir)) {
+    return 0;
+  }
+  let cleaned = 0;
+  const now = Date.now();
+  const entries = await fs.promises.readdir(cacheDir);
+  for (const entry of entries) {
+    const entryPath = import_path.default.join(cacheDir, entry);
+    const metaPath = getMetadataPath(entryPath);
+    try {
+      if (!await (0, import_fs.isDir)(entryPath)) {
+        continue;
+      }
+      const metadata = await (0, import_fs.readJson)(metaPath, { throws: false });
+      if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+        continue;
+      }
+      const timestamp = metadata["timestamp"];
+      const age = typeof timestamp === "number" && timestamp > 0 ? now - timestamp : Number.POSITIVE_INFINITY;
+      if (age > maxAge) {
+        await (0, import_fs.safeDelete)(entryPath, { force: true, recursive: true });
+        cleaned += 1;
+      }
+    } catch {
+      try {
+        const contents = await fs.promises.readdir(entryPath);
+        if (!contents.length) {
+          await (0, import_fs.safeDelete)(entryPath);
+          cleaned += 1;
+        }
+      } catch {
+      }
+    }
+  }
+  return cleaned;
+}
+async function dlxBinary(args, options, spawnExtra) {
+  const {
+    cacheTtl = (
+      /*@__INLINE__*/
+      require("#constants/time").DLX_BINARY_CACHE_TTL
+    ),
+    checksum,
+    force: userForce = false,
+    name,
+    spawnOptions,
+    url,
+    yes
+  } = { __proto__: null, ...options };
+  const force = yes === true ? true : userForce;
+  const cacheDir = getDlxCachePath();
+  const binaryName = name || `binary-${process.platform}-${import_os.default.arch()}`;
+  const spec = `${url}:${binaryName}`;
+  const cacheKey = (0, import_dlx.generateCacheKey)(spec);
+  const cacheEntryDir = import_path.default.join(cacheDir, cacheKey);
+  const binaryPath = (0, import_path2.normalizePath)(import_path.default.join(cacheEntryDir, binaryName));
+  const fs = /* @__PURE__ */ getFs();
+  let downloaded = false;
+  let computedChecksum = checksum;
+  if (!force && fs.existsSync(cacheEntryDir) && await isCacheValid(cacheEntryDir, cacheTtl)) {
+    try {
+      const metaPath = getMetadataPath(cacheEntryDir);
+      const metadata = await (0, import_fs.readJson)(metaPath, { throws: false });
+      if (metadata && typeof metadata === "object" && !Array.isArray(metadata) && typeof metadata["checksum"] === "string") {
+        computedChecksum = metadata["checksum"];
+      } else {
+        downloaded = true;
+      }
+    } catch {
+      downloaded = true;
+    }
+  } else {
+    downloaded = true;
+  }
+  if (downloaded) {
+    try {
+      await (0, import_fs.safeMkdir)(cacheEntryDir, { recursive: true });
+    } catch (e) {
+      const code = e.code;
+      if (code === "EACCES" || code === "EPERM") {
+        throw new Error(
+          `Permission denied creating binary cache directory: ${cacheEntryDir}
+Please check directory permissions or run with appropriate access.`,
+          { cause: e }
+        );
+      }
+      if (code === "EROFS") {
+        throw new Error(
+          `Cannot create binary cache directory on read-only filesystem: ${cacheEntryDir}
+Ensure the filesystem is writable or set SOCKET_DLX_DIR to a writable location.`,
+          { cause: e }
+        );
+      }
+      throw new Error(
+        `Failed to create binary cache directory: ${cacheEntryDir}`,
+        { cause: e }
+      );
+    }
+    computedChecksum = await downloadBinaryFile(url, binaryPath, checksum);
+    const stats = await fs.promises.stat(binaryPath);
+    await writeMetadata(
+      cacheEntryDir,
+      cacheKey,
+      url,
+      computedChecksum || "",
+      stats.size
+    );
+  }
+  const needsShell = import_platform.WIN32 && /\.(?:bat|cmd|ps1)$/i.test(binaryPath);
+  const finalSpawnOptions = needsShell ? {
+    ...spawnOptions,
+    env: {
+      ...spawnOptions?.env,
+      PATH: `${cacheEntryDir}${import_path.default.delimiter}${process.env["PATH"] || ""}`
+    },
+    shell: true
+  } : spawnOptions;
+  const spawnPromise = (0, import_spawn.spawn)(binaryPath, args, finalSpawnOptions, spawnExtra);
+  return {
+    binaryPath,
+    downloaded,
+    spawnPromise
+  };
+}
+async function downloadBinary(options) {
+  const {
+    cacheTtl = (
+      /*@__INLINE__*/
+      require("#constants/time").DLX_BINARY_CACHE_TTL
+    ),
+    checksum,
+    force = false,
+    name,
+    url
+  } = { __proto__: null, ...options };
+  const cacheDir = getDlxCachePath();
+  const binaryName = name || `binary-${process.platform}-${import_os.default.arch()}`;
+  const spec = `${url}:${binaryName}`;
+  const cacheKey = (0, import_dlx.generateCacheKey)(spec);
+  const cacheEntryDir = import_path.default.join(cacheDir, cacheKey);
+  const binaryPath = (0, import_path2.normalizePath)(import_path.default.join(cacheEntryDir, binaryName));
+  const fs = /* @__PURE__ */ getFs();
+  let downloaded = false;
+  if (!force && fs.existsSync(cacheEntryDir) && await isCacheValid(cacheEntryDir, cacheTtl)) {
+    downloaded = false;
+  } else {
+    try {
+      await (0, import_fs.safeMkdir)(cacheEntryDir, { recursive: true });
+    } catch (e) {
+      const code = e.code;
+      if (code === "EACCES" || code === "EPERM") {
+        throw new Error(
+          `Permission denied creating binary cache directory: ${cacheEntryDir}
+Please check directory permissions or run with appropriate access.`,
+          { cause: e }
+        );
+      }
+      if (code === "EROFS") {
+        throw new Error(
+          `Cannot create binary cache directory on read-only filesystem: ${cacheEntryDir}
+Ensure the filesystem is writable or set SOCKET_DLX_DIR to a writable location.`,
+          { cause: e }
+        );
+      }
+      throw new Error(
+        `Failed to create binary cache directory: ${cacheEntryDir}`,
+        { cause: e }
+      );
+    }
+    const computedChecksum = await downloadBinaryFile(url, binaryPath, checksum);
+    const stats = await fs.promises.stat(binaryPath);
+    await writeMetadata(
+      cacheEntryDir,
+      cacheKey,
+      url,
+      computedChecksum || "",
+      stats.size
+    );
+    downloaded = true;
+  }
+  return {
+    binaryPath,
+    downloaded
+  };
+}
+function executeBinary(binaryPath, args, spawnOptions, spawnExtra) {
+  const needsShell = import_platform.WIN32 && /\.(?:bat|cmd|ps1)$/i.test(binaryPath);
+  const cacheEntryDir = import_path.default.dirname(binaryPath);
+  const finalSpawnOptions = needsShell ? {
+    ...spawnOptions,
+    env: {
+      ...spawnOptions?.env,
+      PATH: `${cacheEntryDir}${import_path.default.delimiter}${process.env["PATH"] || ""}`
+    },
+    shell: true
+  } : spawnOptions;
+  return (0, import_spawn.spawn)(binaryPath, args, finalSpawnOptions, spawnExtra);
+}
+function getDlxCachePath() {
+  return (0, import_paths.getSocketDlxDir)();
+}
+async function listDlxCache() {
+  const cacheDir = getDlxCachePath();
+  const fs = /* @__PURE__ */ getFs();
+  if (!fs.existsSync(cacheDir)) {
+    return [];
+  }
+  const results = [];
+  const now = Date.now();
+  const entries = await fs.promises.readdir(cacheDir);
+  for (const entry of entries) {
+    const entryPath = import_path.default.join(cacheDir, entry);
+    try {
+      if (!await (0, import_fs.isDir)(entryPath)) {
+        continue;
+      }
+      const metaPath = getMetadataPath(entryPath);
+      const metadata = await (0, import_fs.readJson)(metaPath, { throws: false });
+      if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+        continue;
+      }
+      const metaObj = metadata;
+      const source = metaObj["source"];
+      const url = source?.["url"] || metaObj["url"] || "";
+      const files = await fs.promises.readdir(entryPath);
+      const binaryFile = files.find((f) => !f.startsWith("."));
+      if (binaryFile) {
+        const binaryPath = import_path.default.join(entryPath, binaryFile);
+        const binaryStats = await fs.promises.stat(binaryPath);
+        results.push({
+          age: now - (metaObj["timestamp"] || 0),
+          arch: metaObj["arch"] || "unknown",
+          checksum: metaObj["checksum"] || "",
+          name: binaryFile,
+          platform: metaObj["platform"] || "unknown",
+          size: binaryStats.size,
+          url
+        });
+      }
+    } catch {
+    }
+  }
+  return results;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cleanDlxCache,
+  dlxBinary,
+  downloadBinary,
+  executeBinary,
+  getDlxCachePath,
+  listDlxCache
+});
 //# sourceMappingURL=dlx-binary.js.map