@socketsecurity/lib 2.10.4 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "2.10.4",
+  "version": "3.0.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [
@@ -152,10 +152,6 @@
       "types": "./dist/dlx-package.d.ts",
       "default": "./dist/dlx-package.js"
     },
-    "./download-lock": {
-      "types": "./dist/download-lock.d.ts",
-      "default": "./dist/download-lock.js"
-    },
     "./effects/pulse-frames": {
       "types": "./dist/effects/pulse-frames.d.ts",
       "default": "./dist/effects/pulse-frames.js"
@@ -296,6 +292,14 @@
       "types": "./dist/json.d.ts",
       "default": "./dist/json.js"
     },
+    "./links": {
+      "types": "./dist/links/index.d.ts",
+      "default": "./dist/links/index.js"
+    },
+    "./links/index": {
+      "types": "./dist/links/index.d.ts",
+      "default": "./dist/links/index.js"
+    },
     "./logger": {
       "types": "./dist/logger.d.ts",
       "default": "./dist/logger.js"
@@ -397,8 +401,12 @@
       "default": "./dist/promises.js"
     },
     "./prompts": {
-      "types": "./dist/prompts.d.ts",
-      "default": "./dist/prompts.js"
+      "types": "./dist/prompts/index.d.ts",
+      "default": "./dist/prompts/index.js"
+    },
+    "./prompts/index": {
+      "types": "./dist/prompts/index.d.ts",
+      "default": "./dist/prompts/index.js"
     },
     "./regexps": {
       "types": "./dist/regexps.d.ts",
@@ -488,6 +496,30 @@
       "types": "./dist/temporary-executor.d.ts",
       "default": "./dist/temporary-executor.js"
     },
+    "./themes": {
+      "types": "./dist/themes/index.d.ts",
+      "default": "./dist/themes/index.js"
+    },
+    "./themes/context": {
+      "types": "./dist/themes/context.d.ts",
+      "default": "./dist/themes/context.js"
+    },
+    "./themes/index": {
+      "types": "./dist/themes/index.d.ts",
+      "default": "./dist/themes/index.js"
+    },
+    "./themes/themes": {
+      "types": "./dist/themes/themes.d.ts",
+      "default": "./dist/themes/themes.js"
+    },
+    "./themes/types": {
+      "types": "./dist/themes/types.d.ts",
+      "default": "./dist/themes/types.js"
+    },
+    "./themes/utils": {
+      "types": "./dist/themes/utils.d.ts",
+      "default": "./dist/themes/utils.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "default": "./dist/types.js"

package/dist/download-lock.d.ts

@@ -1,49 +0,0 @@
-import type { HttpDownloadOptions, HttpDownloadResult } from './http-request';
-export interface DownloadLockInfo {
-    pid: number;
-    startTime: number;
-    url: string;
-}
-export interface DownloadWithLockOptions extends HttpDownloadOptions {
-    /**
-     * Maximum time to wait for lock acquisition in milliseconds.
-     * @default 60000 (1 minute)
-     */
-    lockTimeout?: number | undefined;
-    /**
-     * Directory where lock files are stored.
-     * @default '<destPath>.locks'
-     */
-    locksDir?: string | undefined;
-    /**
-     * Interval for checking stale locks in milliseconds.
-     * @default 1000 (1 second)
-     */
-    pollInterval?: number | undefined;
-    /**
-     * Maximum age of a lock before it's considered stale in milliseconds.
-     * Aligned with npm's npx locking strategy (5-10 seconds).
-     * @default 10000 (10 seconds)
-     */
-    staleTimeout?: number | undefined;
-}
-/**
- * Download a file with locking to prevent concurrent downloads of the same resource.
- * If another process is already downloading to the same destination, this will wait
- * for the download to complete (up to lockTimeout) before proceeding.
- *
- * @throws {Error} When download fails or lock cannot be acquired.
- *
- * @example
- * ```typescript
- * const result = await downloadWithLock(
- *   'https://example.com/file.tar.gz',
- *   '/tmp/downloads/file.tar.gz',
- *   {
- *     retries: 3,
- *     lockTimeout: 60000, // Wait up to 1 minute for other downloads
- *   }
- * )
- * ```
- */
-export declare function downloadWithLock(url: string, destPath: string, options?: DownloadWithLockOptions | undefined): Promise<HttpDownloadResult>;

package/dist/download-lock.js

@@ -1,10 +0,0 @@
-/* Socket Lib - Built with esbuild */
-var D=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var y=(o,t)=>{for(var n in t)D(o,n,{get:t[n],enumerable:!0})},I=(o,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of h(t))!L.call(o,r)&&r!==n&&D(o,r,{get:()=>t[r],enumerable:!(i=T(t,r))||i.enumerable});return o};var b=o=>I(D({},"__esModule",{value:!0}),o);var z={};y(z,{downloadWithLock:()=>x});module.exports=b(z);var f=require("node:fs"),e=require("node:fs/promises"),u=require("node:path"),g=require("./http-request");function O(o,t){const n=o.replace(/[^\w.-]/g,"_"),i=t||(0,u.join)((0,u.dirname)(o),".locks",n);return(0,u.join)(i,"concurrency.lock")}function S(o,t){if(Date.now()-o.startTime>t)return!0;try{return process.kill(o.pid,0),!1}catch{return!0}}async function $(o,t,n){const{lockTimeout:i,locksDir:r,pollInterval:m,staleTimeout:p}=n,s=O(o,r),w=(0,u.dirname)(s);await(0,e.mkdir)(w,{recursive:!0});const c=Date.now();for(;;)try{if((0,f.existsSync)(s)){const d=await(0,e.readFile)(s,"utf8"),l=JSON.parse(d);if(S(l,p))await(0,e.rm)(s,{force:!0});else{if(Date.now()-c>i){const k=Date.now()-l.startTime;throw new Error(`Download lock timed out after ${i}ms
-Lock held by process ${l.pid} for ${k}ms
-Resource: ${l.url}
-Started: ${new Date(l.startTime).toISOString()}
-To resolve:
-  1. Check if process ${l.pid} is still running: ps -p ${l.pid}
-  2. If stale, remove lock file: rm "${s}"
-  3. Or increase lockTimeout option`)}await new Promise(k=>setTimeout(k,m));continue}}const a={pid:process.pid,startTime:Date.now(),url:t};return await(0,e.writeFile)(s,JSON.stringify(a,null,2),{flag:"wx"}),s}catch(a){if(a.code==="EEXIST"){if(Date.now()-c>i)throw new Error(`Lock acquisition timed out after ${i}ms`);await new Promise(d=>setTimeout(d,m));continue}throw a}}async function v(o){try{await(0,e.rm)(o,{force:!0})}catch{}}async function x(o,t,n){const{lockTimeout:i=6e4,locksDir:r,pollInterval:m=1e3,staleTimeout:p=1e4,...s}={__proto__:null,...n};if((0,f.existsSync)(t)){const c=await(0,e.stat)(t).catch(()=>null);if(c&&c.size>0)return{path:t,size:c.size}}const w=await $(t,o,{lockTimeout:i,locksDir:r,pollInterval:m,staleTimeout:p});try{if((0,f.existsSync)(t)){const a=await(0,e.stat)(t).catch(()=>null);if(a&&a.size>0)return{path:t,size:a.size}}return await(0,g.httpDownload)(o,t,s)}finally{await v(w)}}0&&(module.exports={downloadWithLock});
-//# sourceMappingURL=download-lock.js.map

package/dist/download-lock.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/download-lock.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Download locking utilities to prevent concurrent downloads of the same resource. Uses file-based locking for cross-process synchronization.\n * @deprecated This module is deprecated in favor of `process-lock.ts` which uses\n * directory-based locking (via `mkdir()`) that's more reliable across all filesystems\n * including NFS. See process-lock.ts for detailed explanation of why directory-based\n * locking is superior to file-based locking.\n *\n * Migration: Use `processLock.withLock()` from `./process-lock` instead of\n * `downloadWithLock()` from this module.\n */\n\nimport { existsSync } from 'node:fs'\n\nimport { mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises'\n\nimport { dirname, join } from 'node:path'\nimport type { HttpDownloadOptions, HttpDownloadResult } from './http-request'\nimport { httpDownload } from './http-request'\n\nexport interface DownloadLockInfo {\n  pid: number\n  startTime: number\n  url: string\n}\n\nexport interface DownloadWithLockOptions extends HttpDownloadOptions {\n  /**\n   * Maximum time to wait for lock acquisition in milliseconds.\n   * @default 60000 (1 minute)\n   */\n  lockTimeout?: number | undefined\n  /**\n   * Directory where lock files are stored.\n   * @default '<destPath>.locks'\n   */\n  locksDir?: string | undefined\n  /**\n   * Interval for checking stale locks in milliseconds.\n   * @default 1000 (1 second)\n   */\n  pollInterval?: number | undefined\n  /**\n   * Maximum age of a lock before it's considered stale in milliseconds.\n   * Aligned with npm's npx locking strategy (5-10 seconds).\n   * @default 10000 (10 seconds)\n   */\n  staleTimeout?: number | undefined\n}\n\n/**\n * Get the path to the lock file for a destination path.\n * Uses npm npx's concurrency.lock naming convention.\n * For downloads, we use a subdirectory per destination to isolate locks.\n */\nfunction getLockFilePath(destPath: string, locksDir?: string): string {\n  // Create a unique subdirectory for each destination using sanitized path.\n  const sanitized = destPath.replace(/[^\\w.-]/g, '_')\n  const dir = locksDir || join(dirname(destPath), '.locks', sanitized)\n  return join(dir, 'concurrency.lock')\n}\n\n/**\n * Check if a lock is stale (process no longer exists or too old).\n */\nfunction isLockStale(\n  lockInfo: DownloadLockInfo,\n  staleTimeout: number,\n): boolean {\n  // Check if lock is too old\n  const age = Date.now() - lockInfo.startTime\n  if (age > staleTimeout) {\n    return true\n  }\n\n  // Check if process still exists (Node.js specific)\n  try {\n    // process.kill(pid, 0) doesn't actually kill the process\n    // It just checks if the process exists\n    process.kill(lockInfo.pid, 0)\n    return false\n  } catch {\n    // Process doesn't exist\n    return true\n  }\n}\n\n/**\n * Acquire a lock for downloading to a destination path.\n * @throws {Error} When lock cannot be acquired within timeout.\n */\nasync function acquireLock(\n  destPath: string,\n  url: string,\n  options: {\n    lockTimeout: number\n    locksDir?: string | undefined\n    pollInterval: number\n    staleTimeout: number\n  },\n): Promise<string> {\n  const { lockTimeout, locksDir, pollInterval, staleTimeout } = options\n  const lockPath = getLockFilePath(destPath, locksDir)\n  const lockDir = dirname(lockPath)\n\n  // Ensure lock directory exists\n  await mkdir(lockDir, { recursive: true })\n\n  const startTime = Date.now()\n\n  while (true) {\n    try {\n      // Try to read existing lock\n      if (existsSync(lockPath)) {\n        // eslint-disable-next-line no-await-in-loop\n        const lockContent = await readFile(lockPath, 'utf8')\n        const lockInfo: DownloadLockInfo = JSON.parse(lockContent)\n\n        // Check if lock is stale\n        if (isLockStale(lockInfo, staleTimeout)) {\n          // Remove stale lock\n          // eslint-disable-next-line no-await-in-loop\n          await rm(lockPath, { force: true })\n        } else {\n          // Lock is valid, check timeout\n          if (Date.now() - startTime > lockTimeout) {\n            const lockAge = Date.now() - lockInfo.startTime\n            throw new Error(\n              `Download lock timed out after ${lockTimeout}ms\\n` +\n                `Lock held by process ${lockInfo.pid} for ${lockAge}ms\\n` +\n                `Resource: ${lockInfo.url}\\n` +\n                `Started: ${new Date(lockInfo.startTime).toISOString()}\\n` +\n                'To resolve:\\n' +\n                `  1. Check if process ${lockInfo.pid} is still running: ps -p ${lockInfo.pid}\\n` +\n                `  2. If stale, remove lock file: rm \"${lockPath}\"\\n` +\n                '  3. Or increase lockTimeout option',\n            )\n          }\n\n          // Wait and retry\n          // eslint-disable-next-line no-await-in-loop\n          await new Promise(resolve => setTimeout(resolve, pollInterval))\n          continue\n        }\n      }\n\n      // Try to create lock file\n      const lockInfo: DownloadLockInfo = {\n        pid: process.pid,\n        startTime: Date.now(),\n        url,\n      }\n\n      // eslint-disable-next-line no-await-in-loop\n      await writeFile(lockPath, JSON.stringify(lockInfo, null, 2), {\n        // Use 'wx' flag to fail if file exists (atomic operation)\n        flag: 'wx',\n      })\n\n      // Successfully acquired lock\n      return lockPath\n    } catch (e) {\n      // If file already exists, another process created it first\n      if ((e as NodeJS.ErrnoException).code === 'EEXIST') {\n        if (Date.now() - startTime > lockTimeout) {\n          throw new Error(`Lock acquisition timed out after ${lockTimeout}ms`)\n        }\n        // eslint-disable-next-line no-await-in-loop\n        await new Promise(resolve => setTimeout(resolve, pollInterval))\n        continue\n      }\n\n      // Other error\n      throw e\n    }\n  }\n}\n\n/**\n * Release a lock by removing the lock file.\n */\nasync function releaseLock(lockPath: string): Promise<void> {\n  try {\n    await rm(lockPath, { force: true })\n  } catch {\n    // Ignore errors when releasing lock\n  }\n}\n\n/**\n * Download a file with locking to prevent concurrent downloads of the same resource.\n * If another process is already downloading to the same destination, this will wait\n * for the download to complete (up to lockTimeout) before proceeding.\n *\n * @throws {Error} When download fails or lock cannot be acquired.\n *\n * @example\n * ```typescript\n * const result = await downloadWithLock(\n *   'https://example.com/file.tar.gz',\n *   '/tmp/downloads/file.tar.gz',\n *   {\n *     retries: 3,\n *     lockTimeout: 60000, // Wait up to 1 minute for other downloads\n *   }\n * )\n * ```\n */\nexport async function downloadWithLock(\n  url: string,\n  destPath: string,\n  options?: DownloadWithLockOptions | undefined,\n): Promise<HttpDownloadResult> {\n  const {\n    lockTimeout = 60_000,\n    locksDir,\n    pollInterval = 1000,\n    // Aligned with npm's npx locking (5-10s range).\n    staleTimeout = 10_000,\n    ...downloadOptions\n  } = { __proto__: null, ...options } as DownloadWithLockOptions\n\n  // If file already exists and has content, return immediately\n  if (existsSync(destPath)) {\n    const statResult = await stat(destPath).catch(() => null)\n    if (statResult && statResult.size > 0) {\n      return {\n        path: destPath,\n        size: statResult.size,\n      }\n    }\n  }\n\n  // Acquire lock\n  const lockPath = await acquireLock(destPath, url, {\n    lockTimeout,\n    locksDir,\n    pollInterval,\n    staleTimeout,\n  })\n\n  try {\n    // Check again if file was created while we were waiting for lock\n    if (existsSync(destPath)) {\n      const statResult = await stat(destPath).catch(() => null)\n      if (statResult && statResult.size > 0) {\n        return {\n          path: destPath,\n          size: statResult.size,\n        }\n      }\n    }\n\n    // Perform download\n    const result = await httpDownload(url, destPath, downloadOptions)\n\n    return result\n  } finally {\n    // Always release lock\n    await releaseLock(lockPath)\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["download_lock_exports", "__export", "downloadWithLock", "__toCommonJS", "import_node_fs", "import_promises", "import_node_path", "import_http_request", "getLockFilePath", "destPath", "locksDir", "sanitized", "dir", "isLockStale", "lockInfo", "staleTimeout", "acquireLock", "url", "options", "lockTimeout", "pollInterval", "lockPath", "lockDir", "startTime", "lockContent", "lockAge", "resolve", "e", "releaseLock", "downloadOptions", "statResult"]
-}