@socketsecurity/lib 3.0.1 → 3.0.3

package/dist/dlx.js

@@ -1,13 +1,220 @@
 /* Socket Lib - Built with esbuild */
-var p=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var S=(e,r)=>{for(var t in r)p(e,t,{get:r[t],enumerable:!0})},b=(e,r,t,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of w(r))!E.call(e,n)&&n!==t&&p(e,n,{get:()=>r[n],enumerable:!(s=v(r,n))||s.enumerable});return e};var $=e=>b(p({},"__esModule",{value:!0}),e);var J={};S(J,{clearDlx:()=>j,clearDlxSync:()=>F,dlxDirExists:()=>M,dlxDirExistsAsync:()=>A,ensureDlxDir:()=>I,ensureDlxDirSync:()=>L,generateCacheKey:()=>C,getDlxInstalledPackageDir:()=>f,getDlxPackageDir:()=>l,getDlxPackageJsonPath:()=>T,getDlxPackageNodeModulesDir:()=>m,isDlxPackageInstalled:()=>_,isDlxPackageInstalledAsync:()=>q,isInSocketDlx:()=>X,listDlxPackages:()=>h,listDlxPackagesAsync:()=>D,removeDlxPackage:()=>P,removeDlxPackageSync:()=>k});module.exports=$(J);var x=require("crypto"),i=require("./fs"),c=require("./path"),o=require("./paths"),y=require("./promises");let g;function a(){return g===void 0&&(g=require("node:fs")),g}function C(e){return(0,x.createHash)("sha512").update(e).digest("hex").substring(0,16)}let d;function u(){return d===void 0&&(d=require("node:path")),d}async function j(){const e=await D();await(0,y.pEach)(e,r=>P(r))}function F(){const e=h();for(const r of e)k(r)}function M(){return a().existsSync((0,o.getSocketDlxDir)())}async function A(){const e=a();try{return await e.promises.access((0,o.getSocketDlxDir)()),!0}catch{return!1}}async function I(){await(0,i.safeMkdir)((0,o.getSocketDlxDir)(),{recursive:!0})}function L(){(0,i.safeMkdirSync)((0,o.getSocketDlxDir)(),{recursive:!0})}function f(e){return(0,c.normalizePath)(u().join(m(e),e))}function l(e){return(0,c.normalizePath)(u().join((0,o.getSocketDlxDir)(),e))}function T(e){return(0,c.normalizePath)(u().join(f(e),"package.json"))}function m(e){return(0,c.normalizePath)(u().join(l(e),"node_modules"))}function X(e){if(!e)return!1;const r=u(),t=(0,o.getSocketDlxDir)();return r.resolve(e).startsWith(t+r.sep)}function _(e){return a().existsSync(f(e))}async function q(e){const r=a();try{return await r.promises.access(f(e)),!0}catch{return!1}}function h(){try{return(0,i.readDirNamesSync)((0,o.getSocketDlxDir)(),{sort:!0})}catch{return[]}}async function D(){const e=a();try{return(await e.promises.readdir((0,o.getSocketDlxDir)(),{withFileTypes:!0})).filter(t=>t.isDirectory()).map(t=>t.name).sort()}catch{return[]}}async function P(e){const r=l(e);try{await(0,i.safeDelete)(r,{recursive:!0,force:!0})}catch(t){throw new Error(`Failed to remove DLX package "${e}"`,{cause:t})}}function k(e){const r=a(),t=l(e);try{r.rmSync(t,{recursive:!0,force:!0})}catch(s){const n=s.code;throw n==="EACCES"||n==="EPERM"?new Error(`Permission denied removing DLX package "${e}"
-Directory: ${t}
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var dlx_exports = {};
+__export(dlx_exports, {
+  clearDlx: () => clearDlx,
+  clearDlxSync: () => clearDlxSync,
+  dlxDirExists: () => dlxDirExists,
+  dlxDirExistsAsync: () => dlxDirExistsAsync,
+  ensureDlxDir: () => ensureDlxDir,
+  ensureDlxDirSync: () => ensureDlxDirSync,
+  generateCacheKey: () => generateCacheKey,
+  getDlxInstalledPackageDir: () => getDlxInstalledPackageDir,
+  getDlxPackageDir: () => getDlxPackageDir,
+  getDlxPackageJsonPath: () => getDlxPackageJsonPath,
+  getDlxPackageNodeModulesDir: () => getDlxPackageNodeModulesDir,
+  isDlxPackageInstalled: () => isDlxPackageInstalled,
+  isDlxPackageInstalledAsync: () => isDlxPackageInstalledAsync,
+  isInSocketDlx: () => isInSocketDlx,
+  listDlxPackages: () => listDlxPackages,
+  listDlxPackagesAsync: () => listDlxPackagesAsync,
+  removeDlxPackage: () => removeDlxPackage,
+  removeDlxPackageSync: () => removeDlxPackageSync
+});
+module.exports = __toCommonJS(dlx_exports);
+var import_crypto = require("crypto");
+var import_fs = require("./fs");
+var import_path = require("./path");
+var import_paths = require("./paths");
+var import_promises = require("./promises");
+let _fs;
+// @__NO_SIDE_EFFECTS__
+function getFs() {
+  if (_fs === void 0) {
+    _fs = require("node:fs");
+  }
+  return _fs;
+}
+function generateCacheKey(spec) {
+  return (0, import_crypto.createHash)("sha512").update(spec).digest("hex").substring(0, 16);
+}
+let _path;
+// @__NO_SIDE_EFFECTS__
+function getPath() {
+  if (_path === void 0) {
+    _path = require("node:path");
+  }
+  return _path;
+}
+async function clearDlx() {
+  const packages = await listDlxPackagesAsync();
+  await (0, import_promises.pEach)(packages, (pkg) => removeDlxPackage(pkg));
+}
+function clearDlxSync() {
+  const packages = listDlxPackages();
+  for (const pkg of packages) {
+    removeDlxPackageSync(pkg);
+  }
+}
+function dlxDirExists() {
+  const fs = /* @__PURE__ */ getFs();
+  return fs.existsSync((0, import_paths.getSocketDlxDir)());
+}
+async function dlxDirExistsAsync() {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    await fs.promises.access((0, import_paths.getSocketDlxDir)());
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function ensureDlxDir() {
+  await (0, import_fs.safeMkdir)((0, import_paths.getSocketDlxDir)(), { recursive: true });
+}
+function ensureDlxDirSync() {
+  (0, import_fs.safeMkdirSync)((0, import_paths.getSocketDlxDir)(), { recursive: true });
+}
+function getDlxInstalledPackageDir(packageName) {
+  const path = /* @__PURE__ */ getPath();
+  return (0, import_path.normalizePath)(
+    path.join(getDlxPackageNodeModulesDir(packageName), packageName)
+  );
+}
+function getDlxPackageDir(packageName) {
+  const path = /* @__PURE__ */ getPath();
+  return (0, import_path.normalizePath)(path.join((0, import_paths.getSocketDlxDir)(), packageName));
+}
+function getDlxPackageJsonPath(packageName) {
+  const path = /* @__PURE__ */ getPath();
+  return (0, import_path.normalizePath)(
+    path.join(getDlxInstalledPackageDir(packageName), "package.json")
+  );
+}
+function getDlxPackageNodeModulesDir(packageName) {
+  const path = /* @__PURE__ */ getPath();
+  return (0, import_path.normalizePath)(path.join(getDlxPackageDir(packageName), "node_modules"));
+}
+function isInSocketDlx(filePath) {
+  if (!filePath) {
+    return false;
+  }
+  const path = /* @__PURE__ */ getPath();
+  const dlxDir = (0, import_paths.getSocketDlxDir)();
+  const absolutePath = (0, import_path.normalizePath)(path.resolve(filePath));
+  return absolutePath.startsWith(dlxDir + "/");
+}
+function isDlxPackageInstalled(packageName) {
+  const fs = /* @__PURE__ */ getFs();
+  return fs.existsSync(getDlxInstalledPackageDir(packageName));
+}
+async function isDlxPackageInstalledAsync(packageName) {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    await fs.promises.access(getDlxInstalledPackageDir(packageName));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function listDlxPackages() {
+  try {
+    return (0, import_fs.readDirNamesSync)((0, import_paths.getSocketDlxDir)(), { sort: true });
+  } catch {
+    return [];
+  }
+}
+async function listDlxPackagesAsync() {
+  const fs = /* @__PURE__ */ getFs();
+  try {
+    const entries = await fs.promises.readdir((0, import_paths.getSocketDlxDir)(), {
+      withFileTypes: true
+    });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
+  } catch {
+    return [];
+  }
+}
+async function removeDlxPackage(packageName) {
+  const packageDir = getDlxPackageDir(packageName);
+  try {
+    await (0, import_fs.safeDelete)(packageDir, { recursive: true, force: true });
+  } catch (e) {
+    throw new Error(`Failed to remove DLX package "${packageName}"`, {
+      cause: e
+    });
+  }
+}
+function removeDlxPackageSync(packageName) {
+  const fs = /* @__PURE__ */ getFs();
+  const packageDir = getDlxPackageDir(packageName);
+  try {
+    fs.rmSync(packageDir, { recursive: true, force: true });
+  } catch (e) {
+    const code = e.code;
+    if (code === "EACCES" || code === "EPERM") {
+      throw new Error(
+        `Permission denied removing DLX package "${packageName}"
+Directory: ${packageDir}
 To resolve:
   1. Check file/directory permissions
   2. Close any programs using files in this directory
   3. Try running with elevated privileges if necessary
-  4. Manually remove: rm -rf "${t}"`,{cause:s}):n==="EROFS"?new Error(`Cannot remove DLX package "${e}" from read-only filesystem
-Directory: ${t}
-The filesystem is mounted read-only.`,{cause:s}):new Error(`Failed to remove DLX package "${e}"
-Directory: ${t}
-Check permissions and ensure no programs are using this directory.`,{cause:s})}}0&&(module.exports={clearDlx,clearDlxSync,dlxDirExists,dlxDirExistsAsync,ensureDlxDir,ensureDlxDirSync,generateCacheKey,getDlxInstalledPackageDir,getDlxPackageDir,getDlxPackageJsonPath,getDlxPackageNodeModulesDir,isDlxPackageInstalled,isDlxPackageInstalledAsync,isInSocketDlx,listDlxPackages,listDlxPackagesAsync,removeDlxPackage,removeDlxPackageSync});
+  4. Manually remove: rm -rf "${packageDir}"`,
+        { cause: e }
+      );
+    }
+    if (code === "EROFS") {
+      throw new Error(
+        `Cannot remove DLX package "${packageName}" from read-only filesystem
+Directory: ${packageDir}
+The filesystem is mounted read-only.`,
+        { cause: e }
+      );
+    }
+    throw new Error(
+      `Failed to remove DLX package "${packageName}"
+Directory: ${packageDir}
+Check permissions and ensure no programs are using this directory.`,
+      { cause: e }
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearDlx,
+  clearDlxSync,
+  dlxDirExists,
+  dlxDirExistsAsync,
+  ensureDlxDir,
+  ensureDlxDirSync,
+  generateCacheKey,
+  getDlxInstalledPackageDir,
+  getDlxPackageDir,
+  getDlxPackageJsonPath,
+  getDlxPackageNodeModulesDir,
+  isDlxPackageInstalled,
+  isDlxPackageInstalledAsync,
+  isInSocketDlx,
+  listDlxPackages,
+  listDlxPackagesAsync,
+  removeDlxPackage,
+  removeDlxPackageSync
+});
 //# sourceMappingURL=dlx.js.map

package/dist/dlx.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/dlx.ts"],
-  "sourcesContent": ["/** @fileoverview DLX (execute package) utilities for Socket ecosystem shared installations. */\n\nimport { createHash } from 'crypto'\n\nimport { readDirNamesSync, safeDelete, safeMkdir, safeMkdirSync } from './fs'\nimport { normalizePath } from './path'\nimport { getSocketDlxDir } from './paths'\nimport { pEach } from './promises'\n\nlet _fs: typeof import('fs') | undefined\n/**\n * Lazily load the fs module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js fs module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFs() {\n  if (_fs === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _fs = /*@__PURE__*/ require('node:fs')\n  }\n  return _fs as typeof import('fs')\n}\n\n/**\n * Generate a cache directory name using npm/npx approach.\n * Uses first 16 characters of SHA-512 hash (like npm/npx).\n *\n * Rationale for SHA-512 truncated (vs full SHA-256):\n * - Matches npm/npx ecosystem behavior\n * - Shorter paths for Windows MAX_PATH compatibility (260 chars)\n * - 16 hex chars = 64 bits = acceptable collision risk for local cache\n * - Collision probability ~1 in 18 quintillion with 1000 entries\n *\n * Input strategy (aligned with npx):\n * - npx uses package spec strings (e.g., '@scope/pkg@1.0.0', 'prettier@3.0.0')\n * - Caller provides complete spec string with version for accurate cache keying\n * - For package installs: Use PURL-style spec with version\n *   Examples: 'npm:prettier@3.0.0', 'pypi:requests@2.31.0', 'gem:rails@7.0.0'\n *   Note: Socket uses shorthand format without 'pkg:' prefix\n *   (handled by @socketregistry/packageurl-js)\n * - For binary downloads: Use URL:name for uniqueness\n *\n * Reference: npm/cli v11.6.2 libnpmexec/lib/index.js#L233-L244\n * https://github.com/npm/cli/blob/v11.6.2/workspaces/libnpmexec/lib/index.js#L233-L244\n * Implementation: packages.map().sort().join('\\n') \u2192 SHA-512 \u2192 slice(0,16)\n * npx hashes the package spec (name@version), not just name\n */\nexport function generateCacheKey(spec: string): string {\n  return createHash('sha512').update(spec).digest('hex').substring(0, 16)\n}\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path!\n}\n\n/**\n * Clear all DLX package installations.\n */\nexport async function clearDlx(): Promise<void> {\n  const packages = await listDlxPackagesAsync()\n  await pEach(packages, pkg => removeDlxPackage(pkg))\n}\n\n/**\n * Clear all DLX package installations synchronously.\n */\nexport function clearDlxSync(): void {\n  const packages = listDlxPackages()\n  for (const pkg of packages) {\n    removeDlxPackageSync(pkg)\n  }\n}\n\n/**\n * Check if the DLX directory exists.\n */\nexport function dlxDirExists(): boolean {\n  const fs = getFs()\n  return fs.existsSync(getSocketDlxDir())\n}\n\n/**\n * Check if the DLX directory exists asynchronously.\n */\nexport async function dlxDirExistsAsync(): Promise<boolean> {\n  const fs = getFs()\n  try {\n    await fs.promises.access(getSocketDlxDir())\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Ensure the DLX directory exists, creating it if necessary.\n */\nexport async function ensureDlxDir(): Promise<void> {\n  await safeMkdir(getSocketDlxDir(), { recursive: true })\n}\n\n/**\n * Ensure the DLX directory exists synchronously, creating it if necessary.\n */\nexport function ensureDlxDirSync(): void {\n  safeMkdirSync(getSocketDlxDir(), { recursive: true })\n}\n\n/**\n * Get the installed package directory within DLX node_modules.\n */\nexport function getDlxInstalledPackageDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(\n    path.join(getDlxPackageNodeModulesDir(packageName), packageName),\n  )\n}\n\n/**\n * Get the DLX installation directory for a specific package.\n */\nexport function getDlxPackageDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(path.join(getSocketDlxDir(), packageName))\n}\n\n/**\n * Get the package.json path for a DLX installed package.\n */\nexport function getDlxPackageJsonPath(packageName: string): string {\n  const path = getPath()\n  return normalizePath(\n    path.join(getDlxInstalledPackageDir(packageName), 'package.json'),\n  )\n}\n\n/**\n * Get the node_modules directory for a DLX package installation.\n */\nexport function getDlxPackageNodeModulesDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(path.join(getDlxPackageDir(packageName), 'node_modules'))\n}\n\n/**\n * Check if a file path is within the Socket DLX directory.\n * This is useful for determining if a binary or file is managed by Socket's DLX system.\n *\n * @param filePath - Absolute or relative path to check\n * @returns true if the path is within ~/.socket/_dlx/, false otherwise\n *\n * @example\n * ```typescript\n * isInSocketDlx('/home/user/.socket/_dlx/abc123/bin/socket') // true\n * isInSocketDlx('/usr/local/bin/socket') // false\n * isInSocketDlx(process.argv[0]) // Check if current binary is in DLX\n * ```\n */\nexport function isInSocketDlx(filePath: string): boolean {\n  if (!filePath) {\n    return false\n  }\n\n  const path = getPath()\n  const dlxDir = getSocketDlxDir()\n  const absolutePath = path.resolve(filePath)\n\n  // Check if the absolute path starts with the DLX directory.\n  return absolutePath.startsWith(dlxDir + path.sep)\n}\n\n/**\n * Check if a package is installed in DLX.\n */\nexport function isDlxPackageInstalled(packageName: string): boolean {\n  const fs = getFs()\n  return fs.existsSync(getDlxInstalledPackageDir(packageName))\n}\n\n/**\n * Check if a package is installed in DLX asynchronously.\n */\nexport async function isDlxPackageInstalledAsync(\n  packageName: string,\n): Promise<boolean> {\n  const fs = getFs()\n  try {\n    await fs.promises.access(getDlxInstalledPackageDir(packageName))\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * List all packages installed in DLX.\n */\nexport function listDlxPackages(): string[] {\n  try {\n    return readDirNamesSync(getSocketDlxDir(), { sort: true })\n  } catch {\n    return []\n  }\n}\n\n/**\n * List all packages installed in DLX asynchronously.\n */\nexport async function listDlxPackagesAsync(): Promise<string[]> {\n  const fs = getFs()\n  try {\n    const entries = await fs.promises.readdir(getSocketDlxDir(), {\n      withFileTypes: true,\n    })\n    return entries\n      .filter(e => e.isDirectory())\n      .map(e => e.name)\n      .sort()\n  } catch {\n    return []\n  }\n}\n\n/**\n * Remove a DLX package installation.\n */\nexport async function removeDlxPackage(packageName: string): Promise<void> {\n  const packageDir = getDlxPackageDir(packageName)\n  try {\n    await safeDelete(packageDir, { recursive: true, force: true })\n  } catch (e) {\n    throw new Error(`Failed to remove DLX package \"${packageName}\"`, {\n      cause: e,\n    })\n  }\n}\n\n/**\n * Remove a DLX package installation synchronously.\n */\nexport function removeDlxPackageSync(packageName: string): void {\n  const fs = getFs()\n  const packageDir = getDlxPackageDir(packageName)\n  try {\n    fs.rmSync(packageDir, { recursive: true, force: true })\n  } catch (e) {\n    const code = (e as NodeJS.ErrnoException).code\n    if (code === 'EACCES' || code === 'EPERM') {\n      throw new Error(\n        `Permission denied removing DLX package \"${packageName}\"\\n` +\n          `Directory: ${packageDir}\\n` +\n          'To resolve:\\n' +\n          '  1. Check file/directory permissions\\n' +\n          '  2. Close any programs using files in this directory\\n' +\n          '  3. Try running with elevated privileges if necessary\\n' +\n          `  4. Manually remove: rm -rf \"${packageDir}\"`,\n        { cause: e },\n      )\n    }\n    if (code === 'EROFS') {\n      throw new Error(\n        `Cannot remove DLX package \"${packageName}\" from read-only filesystem\\n` +\n          `Directory: ${packageDir}\\n` +\n          'The filesystem is mounted read-only.',\n        { cause: e },\n      )\n    }\n    throw new Error(\n      `Failed to remove DLX package \"${packageName}\"\\n` +\n        `Directory: ${packageDir}\\n` +\n        'Check permissions and ensure no programs are using this directory.',\n      { cause: e },\n    )\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["dlx_exports", "__export", "clearDlx", "clearDlxSync", "dlxDirExists", "dlxDirExistsAsync", "ensureDlxDir", "ensureDlxDirSync", "generateCacheKey", "getDlxInstalledPackageDir", "getDlxPackageDir", "getDlxPackageJsonPath", "getDlxPackageNodeModulesDir", "isDlxPackageInstalled", "isDlxPackageInstalledAsync", "isInSocketDlx", "listDlxPackages", "listDlxPackagesAsync", "removeDlxPackage", "removeDlxPackageSync", "__toCommonJS", "import_crypto", "import_fs", "import_path", "import_paths", "import_promises", "_fs", "getFs", "spec", "_path", "getPath", "packages", "pkg", "fs", "packageName", "filePath", "path", "dlxDir", "e", "packageDir", "code"]
+  "sourcesContent": ["/** @fileoverview DLX (execute package) utilities for Socket ecosystem shared installations. */\n\nimport { createHash } from 'crypto'\n\nimport { readDirNamesSync, safeDelete, safeMkdir, safeMkdirSync } from './fs'\nimport { normalizePath } from './path'\nimport { getSocketDlxDir } from './paths'\nimport { pEach } from './promises'\n\nlet _fs: typeof import('fs') | undefined\n/**\n * Lazily load the fs module to avoid Webpack errors.\n * Uses non-'node:' prefixed require to prevent Webpack bundling issues.\n *\n * @returns The Node.js fs module\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getFs() {\n  if (_fs === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _fs = /*@__PURE__*/ require('node:fs')\n  }\n  return _fs as typeof import('fs')\n}\n\n/**\n * Generate a cache directory name using npm/npx approach.\n * Uses first 16 characters of SHA-512 hash (like npm/npx).\n *\n * Rationale for SHA-512 truncated (vs full SHA-256):\n * - Matches npm/npx ecosystem behavior\n * - Shorter paths for Windows MAX_PATH compatibility (260 chars)\n * - 16 hex chars = 64 bits = acceptable collision risk for local cache\n * - Collision probability ~1 in 18 quintillion with 1000 entries\n *\n * Input strategy (aligned with npx):\n * - npx uses package spec strings (e.g., '@scope/pkg@1.0.0', 'prettier@3.0.0')\n * - Caller provides complete spec string with version for accurate cache keying\n * - For package installs: Use PURL-style spec with version\n *   Examples: 'npm:prettier@3.0.0', 'pypi:requests@2.31.0', 'gem:rails@7.0.0'\n *   Note: Socket uses shorthand format without 'pkg:' prefix\n *   (handled by @socketregistry/packageurl-js)\n * - For binary downloads: Use URL:name for uniqueness\n *\n * Reference: npm/cli v11.6.2 libnpmexec/lib/index.js#L233-L244\n * https://github.com/npm/cli/blob/v11.6.2/workspaces/libnpmexec/lib/index.js#L233-L244\n * Implementation: packages.map().sort().join('\\n') \u2192 SHA-512 \u2192 slice(0,16)\n * npx hashes the package spec (name@version), not just name\n */\nexport function generateCacheKey(spec: string): string {\n  return createHash('sha512').update(spec).digest('hex').substring(0, 16)\n}\n\nlet _path: typeof import('path') | undefined\n/**\n * Lazily load the path module to avoid Webpack errors.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getPath() {\n  if (_path === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    _path = /*@__PURE__*/ require('node:path')\n  }\n  return _path!\n}\n\n/**\n * Clear all DLX package installations.\n */\nexport async function clearDlx(): Promise<void> {\n  const packages = await listDlxPackagesAsync()\n  await pEach(packages, pkg => removeDlxPackage(pkg))\n}\n\n/**\n * Clear all DLX package installations synchronously.\n */\nexport function clearDlxSync(): void {\n  const packages = listDlxPackages()\n  for (const pkg of packages) {\n    removeDlxPackageSync(pkg)\n  }\n}\n\n/**\n * Check if the DLX directory exists.\n */\nexport function dlxDirExists(): boolean {\n  const fs = getFs()\n  return fs.existsSync(getSocketDlxDir())\n}\n\n/**\n * Check if the DLX directory exists asynchronously.\n */\nexport async function dlxDirExistsAsync(): Promise<boolean> {\n  const fs = getFs()\n  try {\n    await fs.promises.access(getSocketDlxDir())\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Ensure the DLX directory exists, creating it if necessary.\n */\nexport async function ensureDlxDir(): Promise<void> {\n  await safeMkdir(getSocketDlxDir(), { recursive: true })\n}\n\n/**\n * Ensure the DLX directory exists synchronously, creating it if necessary.\n */\nexport function ensureDlxDirSync(): void {\n  safeMkdirSync(getSocketDlxDir(), { recursive: true })\n}\n\n/**\n * Get the installed package directory within DLX node_modules.\n */\nexport function getDlxInstalledPackageDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(\n    path.join(getDlxPackageNodeModulesDir(packageName), packageName),\n  )\n}\n\n/**\n * Get the DLX installation directory for a specific package.\n */\nexport function getDlxPackageDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(path.join(getSocketDlxDir(), packageName))\n}\n\n/**\n * Get the package.json path for a DLX installed package.\n */\nexport function getDlxPackageJsonPath(packageName: string): string {\n  const path = getPath()\n  return normalizePath(\n    path.join(getDlxInstalledPackageDir(packageName), 'package.json'),\n  )\n}\n\n/**\n * Get the node_modules directory for a DLX package installation.\n */\nexport function getDlxPackageNodeModulesDir(packageName: string): string {\n  const path = getPath()\n  return normalizePath(path.join(getDlxPackageDir(packageName), 'node_modules'))\n}\n\n/**\n * Check if a file path is within the Socket DLX directory.\n * This is useful for determining if a binary or file is managed by Socket's DLX system.\n *\n * @param filePath - Absolute or relative path to check\n * @returns true if the path is within ~/.socket/_dlx/, false otherwise\n *\n * @example\n * ```typescript\n * isInSocketDlx('/home/user/.socket/_dlx/abc123/bin/socket') // true\n * isInSocketDlx('/usr/local/bin/socket') // false\n * isInSocketDlx(process.argv[0]) // Check if current binary is in DLX\n * ```\n */\nexport function isInSocketDlx(filePath: string): boolean {\n  if (!filePath) {\n    return false\n  }\n\n  const path = getPath()\n  const dlxDir = getSocketDlxDir()\n  const absolutePath = normalizePath(path.resolve(filePath))\n\n  // Check if the absolute path starts with the DLX directory.\n  // Both paths are normalized to use forward slashes for consistent comparison.\n  return absolutePath.startsWith(dlxDir + '/')\n}\n\n/**\n * Check if a package is installed in DLX.\n */\nexport function isDlxPackageInstalled(packageName: string): boolean {\n  const fs = getFs()\n  return fs.existsSync(getDlxInstalledPackageDir(packageName))\n}\n\n/**\n * Check if a package is installed in DLX asynchronously.\n */\nexport async function isDlxPackageInstalledAsync(\n  packageName: string,\n): Promise<boolean> {\n  const fs = getFs()\n  try {\n    await fs.promises.access(getDlxInstalledPackageDir(packageName))\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * List all packages installed in DLX.\n */\nexport function listDlxPackages(): string[] {\n  try {\n    return readDirNamesSync(getSocketDlxDir(), { sort: true })\n  } catch {\n    return []\n  }\n}\n\n/**\n * List all packages installed in DLX asynchronously.\n */\nexport async function listDlxPackagesAsync(): Promise<string[]> {\n  const fs = getFs()\n  try {\n    const entries = await fs.promises.readdir(getSocketDlxDir(), {\n      withFileTypes: true,\n    })\n    return entries\n      .filter(e => e.isDirectory())\n      .map(e => e.name)\n      .sort()\n  } catch {\n    return []\n  }\n}\n\n/**\n * Remove a DLX package installation.\n */\nexport async function removeDlxPackage(packageName: string): Promise<void> {\n  const packageDir = getDlxPackageDir(packageName)\n  try {\n    await safeDelete(packageDir, { recursive: true, force: true })\n  } catch (e) {\n    throw new Error(`Failed to remove DLX package \"${packageName}\"`, {\n      cause: e,\n    })\n  }\n}\n\n/**\n * Remove a DLX package installation synchronously.\n */\nexport function removeDlxPackageSync(packageName: string): void {\n  const fs = getFs()\n  const packageDir = getDlxPackageDir(packageName)\n  try {\n    fs.rmSync(packageDir, { recursive: true, force: true })\n  } catch (e) {\n    const code = (e as NodeJS.ErrnoException).code\n    if (code === 'EACCES' || code === 'EPERM') {\n      throw new Error(\n        `Permission denied removing DLX package \"${packageName}\"\\n` +\n          `Directory: ${packageDir}\\n` +\n          'To resolve:\\n' +\n          '  1. Check file/directory permissions\\n' +\n          '  2. Close any programs using files in this directory\\n' +\n          '  3. Try running with elevated privileges if necessary\\n' +\n          `  4. Manually remove: rm -rf \"${packageDir}\"`,\n        { cause: e },\n      )\n    }\n    if (code === 'EROFS') {\n      throw new Error(\n        `Cannot remove DLX package \"${packageName}\" from read-only filesystem\\n` +\n          `Directory: ${packageDir}\\n` +\n          'The filesystem is mounted read-only.',\n        { cause: e },\n      )\n    }\n    throw new Error(\n      `Failed to remove DLX package \"${packageName}\"\\n` +\n        `Directory: ${packageDir}\\n` +\n        'Check permissions and ensure no programs are using this directory.',\n      { cause: e },\n    )\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,oBAA2B;AAE3B,gBAAuE;AACvE,kBAA8B;AAC9B,mBAAgC;AAChC,sBAAsB;AAEtB,IAAI;AAAA;AASJ,SAAS,QAAQ;AACf,MAAI,QAAQ,QAAW;AAGrB,UAAoB,QAAQ,SAAS;AAAA,EACvC;AACA,SAAO;AACT;AA0BO,SAAS,iBAAiB,MAAsB;AACrD,aAAO,0BAAW,QAAQ,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK,EAAE,UAAU,GAAG,EAAE;AACxE;AAEA,IAAI;AAAA;AAMJ,SAAS,UAAU;AACjB,MAAI,UAAU,QAAW;AAGvB,YAAsB,QAAQ,WAAW;AAAA,EAC3C;AACA,SAAO;AACT;AAKA,eAAsB,WAA0B;AAC9C,QAAM,WAAW,MAAM,qBAAqB;AAC5C,YAAM,uBAAM,UAAU,SAAO,iBAAiB,GAAG,CAAC;AACpD;AAKO,SAAS,eAAqB;AACnC,QAAM,WAAW,gBAAgB;AACjC,aAAW,OAAO,UAAU;AAC1B,yBAAqB,GAAG;AAAA,EAC1B;AACF;AAKO,SAAS,eAAwB;AACtC,QAAM,KAAK,sBAAM;AACjB,SAAO,GAAG,eAAW,8BAAgB,CAAC;AACxC;AAKA,eAAsB,oBAAsC;AAC1D,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,UAAM,GAAG,SAAS,WAAO,8BAAgB,CAAC;AAC1C,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKA,eAAsB,eAA8B;AAClD,YAAM,yBAAU,8BAAgB,GAAG,EAAE,WAAW,KAAK,CAAC;AACxD;AAKO,SAAS,mBAAyB;AACvC,mCAAc,8BAAgB,GAAG,EAAE,WAAW,KAAK,CAAC;AACtD;AAKO,SAAS,0BAA0B,aAA6B;AACrE,QAAM,OAAO,wBAAQ;AACrB,aAAO;AAAA,IACL,KAAK,KAAK,4BAA4B,WAAW,GAAG,WAAW;AAAA,EACjE;AACF;AAKO,SAAS,iBAAiB,aAA6B;AAC5D,QAAM,OAAO,wBAAQ;AACrB,aAAO,2BAAc,KAAK,SAAK,8BAAgB,GAAG,WAAW,CAAC;AAChE;AAKO,SAAS,sBAAsB,aAA6B;AACjE,QAAM,OAAO,wBAAQ;AACrB,aAAO;AAAA,IACL,KAAK,KAAK,0BAA0B,WAAW,GAAG,cAAc;AAAA,EAClE;AACF;AAKO,SAAS,4BAA4B,aAA6B;AACvE,QAAM,OAAO,wBAAQ;AACrB,aAAO,2BAAc,KAAK,KAAK,iBAAiB,WAAW,GAAG,cAAc,CAAC;AAC/E;AAgBO,SAAS,cAAc,UAA2B;AACvD,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,wBAAQ;AACrB,QAAM,aAAS,8BAAgB;AAC/B,QAAM,mBAAe,2BAAc,KAAK,QAAQ,QAAQ,CAAC;AAIzD,SAAO,aAAa,WAAW,SAAS,GAAG;AAC7C;AAKO,SAAS,sBAAsB,aAA8B;AAClE,QAAM,KAAK,sBAAM;AACjB,SAAO,GAAG,WAAW,0BAA0B,WAAW,CAAC;AAC7D;AAKA,eAAsB,2BACpB,aACkB;AAClB,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,UAAM,GAAG,SAAS,OAAO,0BAA0B,WAAW,CAAC;AAC/D,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,kBAA4B;AAC1C,MAAI;AACF,eAAO,gCAAiB,8BAAgB,GAAG,EAAE,MAAM,KAAK,CAAC;AAAA,EAC3D,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAKA,eAAsB,uBAA0C;AAC9D,QAAM,KAAK,sBAAM;AACjB,MAAI;AACF,UAAM,UAAU,MAAM,GAAG,SAAS,YAAQ,8BAAgB,GAAG;AAAA,MAC3D,eAAe;AAAA,IACjB,CAAC;AACD,WAAO,QACJ,OAAO,OAAK,EAAE,YAAY,CAAC,EAC3B,IAAI,OAAK,EAAE,IAAI,EACf,KAAK;AAAA,EACV,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAKA,eAAsB,iBAAiB,aAAoC;AACzE,QAAM,aAAa,iBAAiB,WAAW;AAC/C,MAAI;AACF,cAAM,sBAAW,YAAY,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,EAC/D,SAAS,GAAG;AACV,UAAM,IAAI,MAAM,iCAAiC,WAAW,KAAK;AAAA,MAC/D,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AACF;AAKO,SAAS,qBAAqB,aAA2B;AAC9D,QAAM,KAAK,sBAAM;AACjB,QAAM,aAAa,iBAAiB,WAAW;AAC/C,MAAI;AACF,OAAG,OAAO,YAAY,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,EACxD,SAAS,GAAG;AACV,UAAM,OAAQ,EAA4B;AAC1C,QAAI,SAAS,YAAY,SAAS,SAAS;AACzC,YAAM,IAAI;AAAA,QACR,2CAA2C,WAAW;AAAA,aACtC,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA,gCAKS,UAAU;AAAA,QAC7C,EAAE,OAAO,EAAE;AAAA,MACb;AAAA,IACF;AACA,QAAI,SAAS,SAAS;AACpB,YAAM,IAAI;AAAA,QACR,8BAA8B,WAAW;AAAA,aACzB,UAAU;AAAA;AAAA,QAE1B,EAAE,OAAO,EAAE;AAAA,MACb;AAAA,IACF;AACA,UAAM,IAAI;AAAA,MACR,iCAAiC,WAAW;AAAA,aAC5B,UAAU;AAAA;AAAA,MAE1B,EAAE,OAAO,EAAE;AAAA,IACb;AAAA,EACF;AACF;",
+  "names": []
 }

package/dist/effects/pulse-frames.js

@@ -1,3 +1,66 @@
 /* Socket Lib - Built with esbuild */
-var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var b=(r,t)=>{for(var s in t)l(r,s,{get:t[s],enumerable:!0})},p=(r,t,s,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of c(t))!d.call(r,e)&&e!==s&&l(r,e,{get:()=>t[e],enumerable:!(n=u(t,e))||n.enumerable});return r};var F=r=>p(l({},"__esModule",{value:!0}),r);var E={};b(E,{generateSocketSpinnerFrames:()=>f});module.exports=F(E);function f(r){const s={__proto__:null,...r}.interval??50,n="\x1B[1m",e="\x1B[2m",$="\x1B[0m",a="\u26A1\uFE0E",o="\u2726\uFE0E",i="\u2727\uFE0E",m="\u22C6\uFE0E";return{__proto__:null,frames:[`${e}${i}${$}`,`${e}${i}${$}`,`${e}${m}${$}`,`${o}${$}`,`${o}${$}`,`${n}${o}${$}`,`${n}${o}${$}`,`${n}${a}${$}`,`${n}${a}${$}`,`${n}${a}${$}`,`${n}${a}${$}`,`${n}${a}${$}`,`${n}${o}${$}`,`${n}${o}${$}`,`${o}${$}`,`${o}${$}`,`${e}${m}${$}`,`${e}${i}${$}`],interval:s}}0&&(module.exports={generateSocketSpinnerFrames});
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pulse_frames_exports = {};
+__export(pulse_frames_exports, {
+  generateSocketSpinnerFrames: () => generateSocketSpinnerFrames
+});
+module.exports = __toCommonJS(pulse_frames_exports);
+function generateSocketSpinnerFrames(options) {
+  const opts = { __proto__: null, ...options };
+  const interval = opts.interval ?? 50;
+  const bold = "\x1B[1m";
+  const dim = "\x1B[2m";
+  const reset = "\x1B[0m";
+  const lightning = "\u26A1\uFE0E";
+  const starFilled = "\u2726\uFE0E";
+  const starOutline = "\u2727\uFE0E";
+  const starTiny = "\u22C6\uFE0E";
+  const frames = [
+    // Build up from dim to bright
+    `${dim}${starOutline}${reset}`,
+    `${dim}${starOutline}${reset}`,
+    `${dim}${starTiny}${reset}`,
+    `${starFilled}${reset}`,
+    `${starFilled}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${bold}${lightning}${reset}`,
+    `${bold}${lightning}${reset}`,
+    `${bold}${lightning}${reset}`,
+    // Fade down
+    `${bold}${lightning}${reset}`,
+    `${bold}${lightning}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${bold}${starFilled}${reset}`,
+    `${starFilled}${reset}`,
+    `${starFilled}${reset}`,
+    `${dim}${starTiny}${reset}`,
+    `${dim}${starOutline}${reset}`
+  ];
+  return {
+    __proto__: null,
+    frames,
+    interval
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateSocketSpinnerFrames
+});
 //# sourceMappingURL=pulse-frames.js.map

package/dist/effects/pulse-frames.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/effects/pulse-frames.ts"],
   "sourcesContent": ["/**\n * @fileoverview Socket pulse animation frames generator.\n * Generates themeable pulsing animation frames using sparkles (\u2727 \u2726) and lightning (\u26A1).\n * Follows the cli-spinners format: https://github.com/sindresorhus/cli-spinners\n */\n\nexport type SocketFramesOptions = {\n  readonly baseColor?: readonly [number, number, number] | undefined\n  readonly interval?: number | undefined\n}\n\n/**\n * Generate Socket pulse animation frames.\n * Creates a pulsing throbber using Unicode sparkles and lightning symbols.\n * Frames use brightness modifiers (bold/dim) but no embedded colors.\n * Yocto-spinner applies the current spinner color to each frame.\n *\n * Returns a spinner definition compatible with cli-spinners format.\n *\n * @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json\n */\nexport function generateSocketSpinnerFrames(\n  options?: SocketFramesOptions | undefined,\n): {\n  frames: string[]\n  interval: number\n} {\n  const opts = { __proto__: null, ...options } as SocketFramesOptions\n  const interval = opts.interval ?? 50\n\n  // ANSI codes for brightness modifiers only (no colors).\n  // Yocto-spinner will apply the spinner's current color to each frame.\n  const bold = '\\x1b[1m'\n  const dim = '\\x1b[2m'\n  const reset = '\\x1b[0m'\n\n  // Using VS15 (\\uFE0E) to force text-style rendering.\n  // Lightning bolt (\u26A1) is wider than stars. To keep consistent spacing:\n  // - All frames have NO internal padding\n  // - Yocto-spinner adds 1 space after each frame\n  // - Success/fail symbols also get 1 space (consistent)\n  const lightning = '\u26A1\\uFE0E'\n  const starFilled = '\u2726\\uFE0E'\n  const starOutline = '\u2727\\uFE0E'\n  const starTiny = '\u22C6\\uFE0E'\n\n  // Pulse frames with brightness modifiers only.\n  // Each frame gets colored by yocto-spinner based on current spinner.color.\n  // Yocto-spinner adds 1 space after the frame automatically.\n  const frames = [\n    // Build up from dim to bright\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starOutline}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    // Fade down\n    `${bold}${lightning}${reset}`,\n    `${bold}${lightning}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${bold}${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${starFilled}${reset}`,\n    `${dim}${starTiny}${reset}`,\n    `${dim}${starOutline}${reset}`,\n  ]\n\n  return {\n    __proto__: null,\n    frames,\n    interval,\n  } as { frames: string[]; interval: number }\n}\n"],
-  "mappings": ";4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,iCAAAE,IAAA,eAAAC,EAAAH,GAqBO,SAASE,EACdE,EAIA,CAEA,MAAMC,EADO,CAAE,UAAW,KAAM,GAAGD,CAAQ,EACrB,UAAY,GAI5BE,EAAO,UACPC,EAAM,UACNC,EAAQ,UAORC,EAAY,eACZC,EAAa,eACbC,EAAc,eACdC,EAAW,eA4BjB,MAAO,CACL,UAAW,KACX,OAzBa,CAEb,GAAGL,CAAG,GAAGI,CAAW,GAAGH,CAAK,GAC5B,GAAGD,CAAG,GAAGI,CAAW,GAAGH,CAAK,GAC5B,GAAGD,CAAG,GAAGK,CAAQ,GAAGJ,CAAK,GACzB,GAAGE,CAAU,GAAGF,CAAK,GACrB,GAAGE,CAAU,GAAGF,CAAK,GACrB,GAAGF,CAAI,GAAGI,CAAU,GAAGF,CAAK,GAC5B,GAAGF,CAAI,GAAGI,CAAU,GAAGF,CAAK,GAC5B,GAAGF,CAAI,GAAGG,CAAS,GAAGD,CAAK,GAC3B,GAAGF,CAAI,GAAGG,CAAS,GAAGD,CAAK,GAC3B,GAAGF,CAAI,GAAGG,CAAS,GAAGD,CAAK,GAE3B,GAAGF,CAAI,GAAGG,CAAS,GAAGD,CAAK,GAC3B,GAAGF,CAAI,GAAGG,CAAS,GAAGD,CAAK,GAC3B,GAAGF,CAAI,GAAGI,CAAU,GAAGF,CAAK,GAC5B,GAAGF,CAAI,GAAGI,CAAU,GAAGF,CAAK,GAC5B,GAAGE,CAAU,GAAGF,CAAK,GACrB,GAAGE,CAAU,GAAGF,CAAK,GACrB,GAAGD,CAAG,GAAGK,CAAQ,GAAGJ,CAAK,GACzB,GAAGD,CAAG,GAAGI,CAAW,GAAGH,CAAK,EAC9B,EAKE,SAAAH,CACF,CACF",
-  "names": ["pulse_frames_exports", "__export", "generateSocketSpinnerFrames", "__toCommonJS", "options", "interval", "bold", "dim", "reset", "lightning", "starFilled", "starOutline", "starTiny"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBO,SAAS,4BACd,SAIA;AACA,QAAM,OAAO,EAAE,WAAW,MAAM,GAAG,QAAQ;AAC3C,QAAM,WAAW,KAAK,YAAY;AAIlC,QAAM,OAAO;AACb,QAAM,MAAM;AACZ,QAAM,QAAQ;AAOd,QAAM,YAAY;AAClB,QAAM,aAAa;AACnB,QAAM,cAAc;AACpB,QAAM,WAAW;AAKjB,QAAM,SAAS;AAAA;AAAA,IAEb,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,IAC5B,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA;AAAA,IAE3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK;AAAA,IAC3B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,IAAI,GAAG,UAAU,GAAG,KAAK;AAAA,IAC5B,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,UAAU,GAAG,KAAK;AAAA,IACrB,GAAG,GAAG,GAAG,QAAQ,GAAG,KAAK;AAAA,IACzB,GAAG,GAAG,GAAG,WAAW,GAAG,KAAK;AAAA,EAC9B;AAEA,SAAO;AAAA,IACL,WAAW;AAAA,IACX;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
 }

package/dist/effects/text-shimmer.js

@@ -1,3 +1,176 @@
 /* Socket Lib - Built with esbuild */
-var y=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var A=(e,r)=>{for(var t in r)y(e,t,{get:r[t],enumerable:!0})},E=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of G(r))!M.call(e,o)&&o!==t&&y(e,o,{get:()=>r[o],enumerable:!(n=O(r,o))||n.enumerable});return e};var N=e=>E(y({},"__esModule",{value:!0}),e);var H={};A(H,{COLOR_INHERIT:()=>j,DIR_LTR:()=>p,DIR_NONE:()=>x,DIR_RANDOM:()=>a,DIR_RTL:()=>u,MODE_BI:()=>_,applyShimmer:()=>B});module.exports=N(H);var l=require("../ansi"),$=require("../arrays"),C=require("#env/ci");function k(e){return{__proto__:null,bold:/\x1b\[1m/.test(e),dim:/\x1b\[2m/.test(e),italic:/\x1b\[3m/.test(e),strikethrough:/\x1b\[9m/.test(e),underline:/\x1b\[4m/.test(e)}}function D(e){let r="";return e.bold&&(r+="\x1B[1m"),e.dim&&(r+="\x1B[2m"),e.italic&&(r+="\x1B[3m"),e.underline&&(r+="\x1B[4m"),e.strikethrough&&(r+="\x1B[9m"),r}const j="inherit",p="ltr",x="none",a="random",u="rtl",_="bi";function w(e,r=2.5){return e>r?0:(1-e/r)**2.5}function z(e,r,t){const n=Math.round(e[0]+(r[0]-e[0])*t),o=Math.round(e[1]+(r[1]-e[1])*t),s=Math.round(e[2]+(r[2]-e[2])*t);return[n,o,s]}function L(e,r,t,n,o){const s=Math.abs(r-t),m=w(s),b=D(o),i=(0,$.isArray)(n[0])?n[r%n.length]??[140,82,255]:n;if(m===0){const h=`\x1B[38;2;${i[0]};${i[1]};${i[2]}m`;return`${b}${h}${e}${l.ANSI_RESET}`}const d=z(i,[255,255,255],m),c=`\x1B[38;2;${d[0]};${d[1]};${d[2]}m`;return`${b}${c}${e}${l.ANSI_RESET}`}function P(e,r,t,n=2.5){const o=e+n+2;return t===u?e-r%o:r%o}function W(e){return e===a?Math.random()<.5?p:u:e===u?u:p}function B(e,r,t){const n={__proto__:null,...t},o=n.direction??x,s=n.shimmerWidth??2.5,m=n.color??[140,82,255],b=n.styles??k(e),i=(0,l.stripAnsi)(e);if((0,C.getCI)()||!i||o===x){const h=D(b),S=(0,$.isArray)(m[0]);return i.split("").map((R,T)=>{const f=S?m[T%m.length]??[140,82,255]:m,I=`\x1B[38;2;${f[0]};${f[1]};${f[2]}m`;return`${h}${I}${R}${l.ANSI_RESET}`}).join("")}const g=P(i.length,r.step,r.currentDir,s),d=i.split("").map((h,S)=>L(h,S,g,m,b)).join("");r.step+=r.speed;const c=i.length+s+2;return r.mode===_?r.step>=c&&(r.step=0,r.currentDir=r.currentDir===p?u:p):r.mode===a?r.step>=c&&(r.step=0,r.currentDir=W(a)):r.step>=c&&(r.step=0),d}0&&(module.exports={COLOR_INHERIT,DIR_LTR,DIR_NONE,DIR_RANDOM,DIR_RTL,MODE_BI,applyShimmer});
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var text_shimmer_exports = {};
+__export(text_shimmer_exports, {
+  COLOR_INHERIT: () => COLOR_INHERIT,
+  DIR_LTR: () => DIR_LTR,
+  DIR_NONE: () => DIR_NONE,
+  DIR_RANDOM: () => DIR_RANDOM,
+  DIR_RTL: () => DIR_RTL,
+  MODE_BI: () => MODE_BI,
+  applyShimmer: () => applyShimmer
+});
+module.exports = __toCommonJS(text_shimmer_exports);
+var import_ansi = require("../ansi");
+var import_arrays = require("../arrays");
+var import_ci = require("#env/ci");
+function detectStyles(text) {
+  return {
+    __proto__: null,
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    bold: /\x1b\[1m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    dim: /\x1b\[2m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    italic: /\x1b\[3m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    strikethrough: /\x1b\[9m/.test(text),
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence detection.
+    underline: /\x1b\[4m/.test(text)
+  };
+}
+function stylesToAnsi(styles) {
+  let codes = "";
+  if (styles.bold) {
+    codes += "\x1B[1m";
+  }
+  if (styles.dim) {
+    codes += "\x1B[2m";
+  }
+  if (styles.italic) {
+    codes += "\x1B[3m";
+  }
+  if (styles.underline) {
+    codes += "\x1B[4m";
+  }
+  if (styles.strikethrough) {
+    codes += "\x1B[9m";
+  }
+  return codes;
+}
+const COLOR_INHERIT = "inherit";
+const DIR_LTR = "ltr";
+const DIR_NONE = "none";
+const DIR_RANDOM = "random";
+const DIR_RTL = "rtl";
+const MODE_BI = "bi";
+function shimmerIntensity(distance, shimmerWidth = 2.5) {
+  if (distance > shimmerWidth) {
+    return 0;
+  }
+  const normalized = distance / shimmerWidth;
+  return (1 - normalized) ** 2.5;
+}
+function blendColors(color1, color2, factor) {
+  const r = Math.round(color1[0] + (color2[0] - color1[0]) * factor);
+  const g = Math.round(color1[1] + (color2[1] - color1[1]) * factor);
+  const b = Math.round(color1[2] + (color2[2] - color1[2]) * factor);
+  return [r, g, b];
+}
+function renderChar(char, index, shimmerPos, baseColor, styles) {
+  const distance = Math.abs(index - shimmerPos);
+  const intensity = shimmerIntensity(distance);
+  const styleCode = stylesToAnsi(styles);
+  const charColor = (0, import_arrays.isArray)(baseColor[0]) ? baseColor[index % baseColor.length] ?? [
+    140,
+    82,
+    255
+  ] : baseColor;
+  if (intensity === 0) {
+    const base = `\x1B[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`;
+    return `${styleCode}${base}${char}${import_ansi.ANSI_RESET}`;
+  }
+  const white = [255, 255, 255];
+  const blended = blendColors(charColor, white, intensity);
+  const color = `\x1B[38;2;${blended[0]};${blended[1]};${blended[2]}m`;
+  return `${styleCode}${color}${char}${import_ansi.ANSI_RESET}`;
+}
+function getShimmerPos(textLength, step, currentDir, shimmerWidth = 2.5) {
+  const totalSteps = textLength + shimmerWidth + 2;
+  if (currentDir === DIR_RTL) {
+    return textLength - step % totalSteps;
+  }
+  return step % totalSteps;
+}
+function pickDirection(direction) {
+  if (direction === DIR_RANDOM) {
+    return Math.random() < 0.5 ? DIR_LTR : DIR_RTL;
+  }
+  if (direction === DIR_RTL) {
+    return DIR_RTL;
+  }
+  return DIR_LTR;
+}
+function applyShimmer(text, state, options) {
+  const opts = { __proto__: null, ...options };
+  const direction = opts.direction ?? DIR_NONE;
+  const shimmerWidth = opts.shimmerWidth ?? 2.5;
+  const color = opts.color ?? [140, 82, 255];
+  const styles = opts.styles ?? detectStyles(text);
+  const plainText = (0, import_ansi.stripAnsi)(text);
+  if ((0, import_ci.getCI)() || !plainText || direction === DIR_NONE) {
+    const styleCode = stylesToAnsi(styles);
+    const isGradient = (0, import_arrays.isArray)(color[0]);
+    return plainText.split("").map((char, i) => {
+      const charColor = isGradient ? color[i % color.length] ?? [
+        140,
+        82,
+        255
+      ] : color;
+      const base = `\x1B[38;2;${charColor[0]};${charColor[1]};${charColor[2]}m`;
+      return `${styleCode}${base}${char}${import_ansi.ANSI_RESET}`;
+    }).join("");
+  }
+  const shimmerPos = getShimmerPos(
+    plainText.length,
+    state.step,
+    state.currentDir,
+    shimmerWidth
+  );
+  const result = plainText.split("").map((char, i) => renderChar(char, i, shimmerPos, color, styles)).join("");
+  state.step += state.speed;
+  const totalSteps = plainText.length + shimmerWidth + 2;
+  if (state.mode === MODE_BI) {
+    if (state.step >= totalSteps) {
+      state.step = 0;
+      state.currentDir = state.currentDir === DIR_LTR ? DIR_RTL : DIR_LTR;
+    }
+  } else if (state.mode === DIR_RANDOM) {
+    if (state.step >= totalSteps) {
+      state.step = 0;
+      state.currentDir = pickDirection(DIR_RANDOM);
+    }
+  } else {
+    if (state.step >= totalSteps) {
+      state.step = 0;
+    }
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  COLOR_INHERIT,
+  DIR_LTR,
+  DIR_NONE,
+  DIR_RANDOM,
+  DIR_RTL,
+  MODE_BI,
+  applyShimmer
+});
 //# sourceMappingURL=text-shimmer.js.map