@socketsecurity/lib 5.26.0 → 5.27.0

package/dist/releases/github.js

@@ -1,417 +0,0 @@
-"use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-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 github_exports = {};
-__export(github_exports, {
-  createAssetMatcher: () => createAssetMatcher,
-  downloadAndExtractArchive: () => downloadAndExtractArchive,
-  downloadAndExtractZip: () => downloadAndExtractZip,
-  downloadGitHubRelease: () => downloadGitHubRelease,
-  downloadReleaseAsset: () => downloadReleaseAsset,
-  getAuthHeaders: () => getAuthHeaders,
-  getLatestRelease: () => getLatestRelease,
-  getReleaseAssetUrl: () => getReleaseAssetUrl
-});
-module.exports = __toCommonJS(github_exports);
-var import_node_process = __toESM(require("node:process"));
-var import_picomatch = __toESM(require("../external/picomatch"));
-var import_archives = require("../archives");
-var import_errors = require("../errors");
-var import_fs = require("../fs");
-var import_http_request = require("../http-request");
-var import_logger = require("../logger");
-var import_promises = require("../promises");
-var import_spawn = require("../spawn");
-const RETRY_CONFIG = Object.freeze({
-  __proto__: null,
-  // Exponential backoff: delay doubles with each retry (5s, 10s, 20s).
-  backoffFactor: 2,
-  // Initial delay before first retry.
-  baseDelayMs: 5e3,
-  // Maximum number of retry attempts (excluding initial request).
-  retries: 2
-});
-const logger = (0, import_logger.getDefaultLogger)();
-let _fs;
-let _path;
-// @__NO_SIDE_EFFECTS__
-function getFs() {
-  if (_fs === void 0) {
-    _fs = require("node:fs");
-  }
-  return _fs;
-}
-// @__NO_SIDE_EFFECTS__
-function getPath() {
-  if (_path === void 0) {
-    _path = require("node:path");
-  }
-  return _path;
-}
-function createAssetMatcher(pattern) {
-  if (typeof pattern === "string") {
-    const isMatch = (0, import_picomatch.default)(pattern);
-    return (input) => isMatch(input);
-  }
-  if (pattern instanceof RegExp) {
-    return (input) => pattern.test(input);
-  }
-  const { prefix, suffix } = pattern;
-  return (input) => input.startsWith(prefix) && input.endsWith(suffix);
-}
-async function downloadAndExtractArchive(tag, assetPattern, outputDir, repoConfig, options = {}) {
-  const { cleanup = true, format, quiet = false, strip } = options;
-  const path = /* @__PURE__ */ getPath();
-  const fs = /* @__PURE__ */ getFs();
-  await (0, import_fs.safeMkdir)(outputDir);
-  let ext = ".archive";
-  if (format) {
-    ext = format === "tar.gz" ? ".tar.gz" : `.${format}`;
-  } else if (typeof assetPattern === "string") {
-    const detectedFormat = (0, import_archives.detectArchiveFormat)(assetPattern);
-    if (detectedFormat) {
-      ext = detectedFormat === "tar.gz" ? ".tar.gz" : `.${detectedFormat}`;
-    }
-  }
-  const archivePath = path.join(outputDir, `__temp_download__${ext}`);
-  if (!quiet) {
-    logger.info(`Downloading archive from release ${tag}...`);
-  }
-  await downloadReleaseAsset(tag, assetPattern, archivePath, repoConfig, {
-    quiet
-  });
-  if (!quiet) {
-    logger.info(`Extracting archive to ${outputDir}...`);
-  }
-  try {
-    await (0, import_archives.extractArchive)(archivePath, outputDir, { quiet, strip });
-    if (!quiet) {
-      logger.info(`Extracted archive contents to ${outputDir}`);
-    }
-  } catch (cause) {
-    throw new Error(`Failed to extract archive: ${archivePath}`, { cause });
-  } finally {
-    if (cleanup) {
-      try {
-        await fs.promises.unlink(archivePath);
-        if (!quiet) {
-          logger.info("Cleaned up temporary archive file");
-        }
-      } catch (e) {
-        if (!quiet) {
-          logger.warn(`Failed to cleanup archive file: ${e}`);
-        }
-      }
-    }
-  }
-  return outputDir;
-}
-async function downloadAndExtractZip(tag, assetPattern, outputDir, repoConfig, options = {}) {
-  const { cleanup = true, quiet = false } = options;
-  const path = /* @__PURE__ */ getPath();
-  const fs = /* @__PURE__ */ getFs();
-  await (0, import_fs.safeMkdir)(outputDir);
-  const zipPath = path.join(outputDir, "__temp_download__.zip");
-  if (!quiet) {
-    logger.info(`Downloading zip asset from release ${tag}...`);
-  }
-  await downloadReleaseAsset(tag, assetPattern, zipPath, repoConfig, { quiet });
-  if (!quiet) {
-    logger.info(`Extracting zip to ${outputDir}...`);
-  }
-  try {
-    await (0, import_archives.extractArchive)(zipPath, outputDir, { quiet });
-    if (!quiet) {
-      logger.info(`Extracted zip contents to ${outputDir}`);
-    }
-  } catch (cause) {
-    throw new Error(`Failed to extract zip file: ${zipPath}`, { cause });
-  } finally {
-    if (cleanup) {
-      try {
-        await fs.promises.unlink(zipPath);
-        if (!quiet) {
-          logger.info("Cleaned up temporary zip file");
-        }
-      } catch (e) {
-        if (!quiet) {
-          logger.warn(`Failed to cleanup zip file: ${e}`);
-        }
-      }
-    }
-  }
-  return outputDir;
-}
-async function downloadGitHubRelease(config) {
-  const {
-    assetName,
-    binaryName,
-    cwd = import_node_process.default.cwd(),
-    downloadDir = "build/downloaded",
-    owner,
-    platformArch,
-    quiet = false,
-    removeMacOSQuarantine = true,
-    repo,
-    tag: explicitTag,
-    toolName,
-    toolPrefix
-  } = config;
-  let tag;
-  if (explicitTag) {
-    tag = explicitTag;
-  } else if (toolPrefix) {
-    const latestTag = await getLatestRelease(
-      toolPrefix,
-      { owner, repo },
-      { quiet }
-    );
-    if (!latestTag) {
-      throw new Error(`No ${toolPrefix} release found in ${owner}/${repo}`);
-    }
-    tag = latestTag;
-  } else {
-    throw new Error("Either toolPrefix or tag must be provided");
-  }
-  const path = /* @__PURE__ */ getPath();
-  const resolvedDownloadDir = path.isAbsolute(downloadDir) ? downloadDir : path.join(cwd, downloadDir);
-  const binaryDir = resolvedDownloadDir;
-  const binaryPath = path.join(binaryDir, binaryName);
-  const versionPath = path.join(binaryDir, ".version");
-  const fs = /* @__PURE__ */ getFs();
-  if (fs.existsSync(versionPath) && fs.existsSync(binaryPath)) {
-    const cachedVersion = (await fs.promises.readFile(versionPath, "utf8")).trim();
-    if (cachedVersion === tag && fs.existsSync(binaryPath)) {
-      if (!quiet) {
-        logger.info(`Using cached ${toolName} (${platformArch}): ${binaryPath}`);
-      }
-      return binaryPath;
-    }
-  }
-  if (!quiet) {
-    logger.info(`Downloading ${toolName} for ${platformArch}...`);
-  }
-  await downloadReleaseAsset(
-    tag,
-    assetName,
-    binaryPath,
-    { owner, repo },
-    { quiet }
-  );
-  const isWindows = binaryName.endsWith(".exe");
-  if (!isWindows) {
-    fs.chmodSync(binaryPath, 493);
-    if (removeMacOSQuarantine && import_node_process.default.platform === "darwin" && platformArch.startsWith("darwin")) {
-      try {
-        await (0, import_spawn.spawn)("xattr", ["-d", "com.apple.quarantine", binaryPath], {
-          stdio: "ignore"
-        });
-      } catch {
-      }
-    }
-  }
-  await fs.promises.writeFile(versionPath, tag, "utf8");
-  if (!quiet) {
-    logger.info(`Downloaded ${toolName} to ${binaryPath}`);
-  }
-  return binaryPath;
-}
-async function downloadReleaseAsset(tag, assetPattern, outputPath, repoConfig, options = {}) {
-  const { owner, repo } = repoConfig;
-  const { quiet = false } = options;
-  const downloadUrl = await getReleaseAssetUrl(
-    tag,
-    assetPattern,
-    { owner, repo },
-    { quiet }
-  );
-  if (!downloadUrl) {
-    const patternDesc = typeof assetPattern === "string" ? assetPattern : "matching pattern";
-    throw new Error(`Asset ${patternDesc} not found in release ${tag}`);
-  }
-  const path = /* @__PURE__ */ getPath();
-  await (0, import_fs.safeMkdir)(path.dirname(outputPath));
-  await (0, import_http_request.httpDownload)(downloadUrl, outputPath, {
-    logger: quiet ? void 0 : logger,
-    progressInterval: 10,
-    retries: 2,
-    retryDelay: 5e3
-  });
-}
-function getAuthHeaders() {
-  const token = import_node_process.default.env["GH_TOKEN"] || import_node_process.default.env["GITHUB_TOKEN"];
-  const headers = {
-    Accept: "application/vnd.github+json",
-    "X-GitHub-Api-Version": "2022-11-28"
-  };
-  if (token) {
-    headers["Authorization"] = `Bearer ${token}`;
-  }
-  return headers;
-}
-async function getLatestRelease(toolPrefix, repoConfig, options = {}) {
-  const { assetPattern, quiet = false } = options;
-  const { owner, repo } = repoConfig;
-  const isMatch = assetPattern ? createAssetMatcher(assetPattern) : void 0;
-  return await (0, import_promises.pRetry)(
-    async () => {
-      const response = await (0, import_http_request.httpRequest)(
-        `https://api.github.com/repos/${owner}/${repo}/releases?per_page=100`,
-        {
-          headers: getAuthHeaders()
-        }
-      );
-      if (!response.ok) {
-        throw new Error(`Failed to fetch releases: ${response.status}`);
-      }
-      let releases;
-      try {
-        releases = JSON.parse(response.body.toString("utf8"));
-      } catch (cause) {
-        throw new Error(
-          `Failed to parse GitHub releases response from https://api.github.com/repos/${owner}/${repo}/releases`,
-          { cause }
-        );
-      }
-      const matchingReleases = releases.filter((release) => {
-        const { assets, tag_name: tag2 } = release;
-        if (!tag2.startsWith(toolPrefix)) {
-          return false;
-        }
-        if (!assets || assets.length === 0) {
-          return false;
-        }
-        if (isMatch) {
-          const hasMatchingAsset = assets.some(
-            (a) => isMatch(a.name)
-          );
-          if (!hasMatchingAsset) {
-            return false;
-          }
-        }
-        return true;
-      });
-      if (matchingReleases.length === 0) {
-        if (!quiet) {
-          logger.info(`No ${toolPrefix} release found in latest 100 releases`);
-        }
-        return null;
-      }
-      matchingReleases.sort(
-        (a, b) => new Date(b.published_at).getTime() - new Date(a.published_at).getTime()
-      );
-      const latestRelease = matchingReleases[0];
-      const tag = latestRelease.tag_name;
-      if (!quiet) {
-        logger.info(`Found release: ${tag}`);
-      }
-      return tag;
-    },
-    {
-      ...RETRY_CONFIG,
-      onRetry: (attempt, error) => {
-        if (!quiet) {
-          logger.info(
-            `Retry attempt ${attempt + 1}/${RETRY_CONFIG.retries + 1} for ${toolPrefix} release...`
-          );
-          logger.warn(
-            `Attempt ${attempt + 1}/${RETRY_CONFIG.retries + 1} failed: ${(0, import_errors.errorMessage)(error)}`
-          );
-        }
-        return void 0;
-      }
-    }
-  ) ?? null;
-}
-async function getReleaseAssetUrl(tag, assetPattern, repoConfig, options = {}) {
-  const { owner, repo } = repoConfig;
-  const { quiet = false } = options;
-  const isMatch = typeof assetPattern === "string" && !assetPattern.includes("*") && !assetPattern.includes("{") ? (input) => input === assetPattern : createAssetMatcher(assetPattern);
-  return await (0, import_promises.pRetry)(
-    async () => {
-      const response = await (0, import_http_request.httpRequest)(
-        `https://api.github.com/repos/${owner}/${repo}/releases/tags/${tag}`,
-        {
-          headers: getAuthHeaders()
-        }
-      );
-      if (!response.ok) {
-        throw new Error(`Failed to fetch release ${tag}: ${response.status}`);
-      }
-      let release;
-      try {
-        release = JSON.parse(response.body.toString("utf8"));
-      } catch (cause) {
-        throw new Error(
-          `Failed to parse GitHub release response for tag ${tag}`,
-          { cause }
-        );
-      }
-      const assets = release.assets;
-      if (!Array.isArray(assets)) {
-        throw new Error(`Release ${tag} has no assets`);
-      }
-      const asset = assets.find((a) => isMatch(a.name));
-      if (!asset) {
-        const patternDesc = typeof assetPattern === "string" ? assetPattern : "matching pattern";
-        throw new Error(`Asset ${patternDesc} not found in release ${tag}`);
-      }
-      if (!quiet) {
-        logger.info(`Found asset: ${asset.name}`);
-      }
-      return asset.browser_download_url;
-    },
-    {
-      ...RETRY_CONFIG,
-      onRetry: (attempt, error) => {
-        if (!quiet) {
-          logger.info(
-            `Retry attempt ${attempt + 1}/${RETRY_CONFIG.retries + 1} for asset URL...`
-          );
-          logger.warn(
-            `Attempt ${attempt + 1}/${RETRY_CONFIG.retries + 1} failed: ${(0, import_errors.errorMessage)(error)}`
-          );
-        }
-        return void 0;
-      }
-    }
-  ) ?? null;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createAssetMatcher,
-  downloadAndExtractArchive,
-  downloadAndExtractZip,
-  downloadGitHubRelease,
-  downloadReleaseAsset,
-  getAuthHeaders,
-  getLatestRelease,
-  getReleaseAssetUrl
-});

package/dist/sea.d.ts

@@ -1,30 +0,0 @@
-/**
- * @fileoverview SEA (Single Executable Application) detection utilities for Socket ecosystem.
- * Provides reliable detection of whether the current process is running
- * as a Node.js Single Executable Application.
- */
-/**
- * Get the current SEA binary path.
- * Only valid when running as a SEA binary.
- *
- * @example
- * ```typescript
- * const binPath = getSeaBinaryPath()
- * if (binPath) {
- *   console.log(`Running as SEA binary: ${binPath}`)
- * }
- * ```
- */
-export declare function getSeaBinaryPath(): string | undefined;
-/**
- * Detect if the current process is running as a SEA binary.
- * Uses Node.js 24+ native API with caching for performance.
- *
- * @example
- * ```typescript
- * if (isSeaBinary()) {
- *   console.log('Running as a Single Executable Application')
- * }
- * ```
- */
-export declare function isSeaBinary(): boolean;

package/dist/themes/index.d.ts

@@ -1,49 +0,0 @@
-/**
- * @fileoverview Elegant theming system for Socket libraries.
- * Unified visual language across spinners, loggers, prompts, and links.
- *
- * @example
- * ```ts
- * import { setTheme, THEMES } from '@socketsecurity/lib/themes'
- *
- * // Set global theme
- * setTheme('terracotta')
- * ```
- *
- * @example
- * ```ts
- * import { withTheme } from '@socketsecurity/lib/themes'
- *
- * // Scoped theme context
- * await withTheme('ultra', async () => {
- *   // All operations inherit Ultra theme
- * })
- * ```
- *
- * @example
- * ```ts
- * import { createTheme } from '@socketsecurity/lib/themes'
- *
- * // Custom theme creation
- * const myTheme = createTheme({
- *   name: 'custom',
- *   displayName: 'Custom Theme',
- *   colors: {
- *     primary: [255, 100, 200],
- *     success: 'greenBright',
- *     error: 'redBright',
- *     warning: 'yellowBright',
- *     info: 'blueBright',
- *     step: 'cyanBright',
- *     text: 'white',
- *     textDim: 'gray',
- *     link: 'cyanBright',
- *     prompt: 'primary'
- *   }
- * })
- * ```
- */
-export type { ColorReference, Theme, ThemeColors, ThemeEffects, ThemeMeta, } from './types';
-export { LUSH_THEME, SOCKET_THEME, SUNSET_THEME, TERRACOTTA_THEME, THEMES, ULTRA_THEME, type ThemeName, } from './themes';
-export { getTheme, onThemeChange, setTheme, withTheme, withThemeSync, type ThemeChangeListener, } from './context';
-export { createTheme, extendTheme, resolveColor, resolveShimmerColor, } from './utils';

package/dist/themes/index.js

@@ -1,60 +0,0 @@
-"use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-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 themes_exports = {};
-__export(themes_exports, {
-  LUSH_THEME: () => import_themes.LUSH_THEME,
-  SOCKET_THEME: () => import_themes.SOCKET_THEME,
-  SUNSET_THEME: () => import_themes.SUNSET_THEME,
-  TERRACOTTA_THEME: () => import_themes.TERRACOTTA_THEME,
-  THEMES: () => import_themes.THEMES,
-  ULTRA_THEME: () => import_themes.ULTRA_THEME,
-  createTheme: () => import_utils.createTheme,
-  extendTheme: () => import_utils.extendTheme,
-  getTheme: () => import_context.getTheme,
-  onThemeChange: () => import_context.onThemeChange,
-  resolveColor: () => import_utils.resolveColor,
-  resolveShimmerColor: () => import_utils.resolveShimmerColor,
-  setTheme: () => import_context.setTheme,
-  withTheme: () => import_context.withTheme,
-  withThemeSync: () => import_context.withThemeSync
-});
-module.exports = __toCommonJS(themes_exports);
-var import_themes = require("./themes");
-var import_context = require("./context");
-var import_utils = require("./utils");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  LUSH_THEME,
-  SOCKET_THEME,
-  SUNSET_THEME,
-  TERRACOTTA_THEME,
-  THEMES,
-  ULTRA_THEME,
-  createTheme,
-  extendTheme,
-  getTheme,
-  onThemeChange,
-  resolveColor,
-  resolveShimmerColor,
-  setTheme,
-  withTheme,
-  withThemeSync
-});