@socketsecurity/lib 5.26.0 → 5.27.0

package/dist/effects/text-shimmer.js

@@ -1,192 +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 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");
-var import_themes = require("../themes/themes");
-var import_utils = require("../themes/utils");
-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 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 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 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 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 shimmerIntensity(distance, shimmerWidth = 2.5) {
-  if (distance > shimmerWidth) {
-    return 0;
-  }
-  const normalized = distance / shimmerWidth;
-  return (1 - normalized) ** 2.5;
-}
-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;
-}
-function applyShimmer(text, state, options) {
-  const opts = { __proto__: null, ...options };
-  const direction = opts.direction ?? DIR_NONE;
-  const shimmerWidth = opts.shimmerWidth ?? 2.5;
-  let color;
-  if (opts.theme) {
-    const theme = typeof opts.theme === "string" ? import_themes.THEMES[opts.theme] : opts.theme;
-    if (!theme) {
-      throw new Error(`Unknown theme: ${opts.theme}`);
-    }
-    const themeColor = (0, import_utils.resolveColor)(
-      theme.colors.primary,
-      theme.colors
-    );
-    color = typeof themeColor === "string" ? [140, 82, 255] : themeColor;
-  } else {
-    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
-});

package/dist/effects/types.d.ts

@@ -1,47 +0,0 @@
-/**
- * @fileoverview Shared types for effects (shimmer, pulse, ultra, etc.).
- * Common type definitions used across multiple effect modules.
- */
-export type ShimmerColorInherit = 'inherit';
-export type ShimmerColorRgb = readonly [number, number, number];
-export type ShimmerColor = ShimmerColorInherit | ShimmerColorRgb;
-export type ShimmerColorGradient = readonly ShimmerColorRgb[];
-export type ShimmerDirection = 'ltr' | 'rtl' | 'bi' | 'random' | 'none';
-/**
- * Shimmer animation configuration.
- */
-export type ShimmerConfig = {
-    readonly color?: ShimmerColor | ShimmerColorGradient | undefined;
-    readonly dir?: ShimmerDirection | undefined;
-    /**
-     * Animation speed in steps per frame.
-     * Lower values = slower shimmer (e.g., 0.33 = ~150ms per step).
-     * Higher values = faster shimmer (e.g., 1.0 = 50ms per step).
-     * Default: 1/3 (~0.33).
-     */
-    readonly speed?: number | undefined;
-    /**
-     * Theme to use for shimmer colors.
-     * Can be a theme name ('socket', 'sunset', etc.) or a Theme object.
-     * If provided, overrides the color option.
-     */
-    readonly theme?: import('../themes/types').Theme | import('../themes/themes').ThemeName | undefined;
-};
-/**
- * Internal shimmer animation state.
- * Tracks current animation position and direction.
- */
-export type ShimmerState = {
-    currentDir: 'ltr' | 'rtl';
-    mode: ShimmerDirection;
-    /**
-     * Animation speed in steps per frame.
-     * The shimmer position advances by this amount every frame.
-     */
-    speed: number;
-    /**
-     * Current shimmer position.
-     * Can be fractional for smooth sub-character movement.
-     */
-    step: number;
-};

package/dist/effects/ultra.d.ts

@@ -1,22 +0,0 @@
-/**
- * @fileoverview Ultrathink rainbow gradient effect.
- * Provides rainbow gradient color generation for shimmer animations.
- * "Ultrathink" is Claude's intensive thinking mode for deep analysis.
- */
-import type { ShimmerColorGradient } from './types';
-/**
- * Rainbow gradient colors used for ultrathink effect.
- * This gradient cycles through the full color spectrum with smooth transitions.
- */
-export declare const RAINBOW_GRADIENT: ShimmerColorGradient;
-/**
- * Generate rainbow gradient colors for any text length.
- * Colors are distributed evenly across the text by cycling through the gradient.
- *
- * @example
- * ```typescript
- * const colors = generateRainbowGradient('Hello'.length)
- * console.log(colors.length) // 5
- * ```
- */
-export declare function generateRainbowGradient(textLength: number): ShimmerColorGradient;

package/dist/releases/github.d.ts

@@ -1,234 +0,0 @@
-/**
- * @fileoverview GitHub release download utilities.
- */
-import { type ArchiveFormat } from '../archives';
-/**
- * Pattern for matching release assets.
- * Can be either:
- * - A string with glob pattern syntax
- * - A prefix/suffix pair for explicit matching (backward compatible)
- * - A RegExp for complex patterns
- *
- * String patterns support full glob syntax via picomatch.
- * Examples:
- * - Simple wildcard: yoga-sync-*.mjs matches yoga-sync-abc123.mjs
- * - Complex: models-*.tar.gz matches models-2024-01-15.tar.gz
- * - Prefix wildcard: *-models.tar.gz matches foo-models.tar.gz
- * - Suffix wildcard: yoga-* matches yoga-layout
- * - Brace expansion: {yoga,models}-*.{mjs,js} matches yoga-abc.mjs or models-xyz.js
- *
- * For backward compatibility, prefix/suffix objects are still supported but glob patterns are recommended.
- */
-export type AssetPattern = string | {
-    prefix: string;
-    suffix: string;
-} | RegExp;
-/**
- * Configuration for downloading a GitHub release.
- */
-export interface DownloadGitHubReleaseConfig {
-    /** Asset name on GitHub. */
-    assetName: string;
-    /** Binary filename (e.g., 'node', 'binject'). */
-    binaryName: string;
-    /** Working directory (defaults to process.cwd()). */
-    cwd?: string;
-    /** Download destination directory. @default 'build/downloaded' */
-    downloadDir?: string;
-    /** GitHub repository owner/organization. */
-    owner: string;
-    /** Platform-arch identifier (e.g., 'linux-x64-musl'). */
-    platformArch: string;
-    /** Suppress log messages. @default false */
-    quiet?: boolean;
-    /** Remove macOS quarantine attribute after download. @default true */
-    removeMacOSQuarantine?: boolean;
-    /** GitHub repository name. */
-    repo: string;
-    /** Specific release tag to download. */
-    tag?: string;
-    /** Tool name for directory structure. */
-    toolName: string;
-    /** Tool prefix for finding latest release. */
-    toolPrefix?: string;
-}
-/**
- * Configuration for repository access.
- */
-export interface RepoConfig {
-    /**
-     * GitHub repository owner/organization.
-     */
-    owner: string;
-    /**
-     * GitHub repository name.
-     */
-    repo: string;
-}
-/**
- * Create a matcher function for a pattern using picomatch for glob patterns
- * or simple prefix/suffix matching for object patterns.
- *
- * @param pattern - Pattern to match (string glob, prefix/suffix object, or RegExp)
- * @returns Function that tests if a string matches the pattern
- *
- * @example
- * ```typescript
- * const isMatch = createAssetMatcher('tool-*-linux-x64')
- * isMatch('tool-v1.0-linux-x64')  // true
- * isMatch('tool-v1.0-darwin-arm64')  // false
- * ```
- */
-export declare function createAssetMatcher(pattern: string | {
-    prefix: string;
-    suffix: string;
-} | RegExp): (input: string) => boolean;
-/**
- * Download and extract an archive from a GitHub release.
- * Supports zip, tar, tar.gz, and tgz formats.
- * Automatically handles downloading, extracting, and cleanup.
- *
- * @param tag - Release tag name
- * @param assetPattern - Asset name or pattern (glob string, prefix/suffix object, or RegExp)
- * @param outputDir - Directory to extract the archive contents to
- * @param repoConfig - Repository configuration (owner/repo)
- * @param options - Additional options
- * @param options.quiet - Suppress log messages
- * @param options.cleanup - Remove downloaded archive after extraction (default: true)
- * @param options.strip - Strip leading path components (like tar --strip-components)
- * @param options.format - Archive format (auto-detected if not specified)
- * @returns Path to the extraction directory
- *
- * @example
- * ```typescript
- * const outputDir = await downloadAndExtractArchive(
- *   'v1.0.0', 'data-*.tar.gz', '/tmp/data',
- *   { owner: 'SocketDev', repo: 'socket-btm' },
- * )
- * ```
- */
-export declare function downloadAndExtractArchive(tag: string, assetPattern: string | AssetPattern, outputDir: string, repoConfig: RepoConfig, options?: {
-    cleanup?: boolean;
-    format?: ArchiveFormat;
-    quiet?: boolean;
-    strip?: number;
-}): Promise<string>;
-/**
- * Download and extract a zip file from a GitHub release.
- * Automatically handles downloading, extracting, and cleanup.
- *
- * @param tag - Release tag name
- * @param assetPattern - Asset name or pattern (glob string, prefix/suffix object, or RegExp)
- * @param outputDir - Directory to extract the zip contents to
- * @param repoConfig - Repository configuration (owner/repo)
- * @param options - Additional options
- * @param options.quiet - Suppress log messages
- * @param options.cleanup - Remove downloaded zip file after extraction (default: true)
- * @returns Path to the extraction directory
- *
- * @example
- * ```typescript
- * const outputDir = await downloadAndExtractZip(
- *   'v1.0.0', 'models-*.zip', '/tmp/models',
- *   { owner: 'SocketDev', repo: 'socket-btm' },
- * )
- * ```
- */
-export declare function downloadAndExtractZip(tag: string, assetPattern: string | AssetPattern, outputDir: string, repoConfig: RepoConfig, options?: {
-    cleanup?: boolean;
-    quiet?: boolean;
-}): Promise<string>;
-/**
- * Download a binary from any GitHub repository with version caching.
- *
- * @param config - Download configuration
- * @returns Path to the downloaded binary
- *
- * @example
- * ```typescript
- * const binaryPath = await downloadGitHubRelease({
- *   owner: 'SocketDev', repo: 'socket-btm',
- *   toolName: 'lief', toolPrefix: 'lief-',
- *   assetName: 'lief-linux-x64', binaryName: 'lief',
- *   platformArch: 'linux-x64',
- * })
- * ```
- */
-export declare function downloadGitHubRelease(config: DownloadGitHubReleaseConfig): Promise<string>;
-/**
- * Download a specific release asset.
- * Supports pattern matching for dynamic asset discovery.
- *
- * @param tag - Release tag name
- * @param assetPattern - Asset name or pattern (glob string, prefix/suffix object, or RegExp)
- * @param outputPath - Path to write the downloaded file
- * @param repoConfig - Repository configuration (owner/repo)
- * @param options - Additional options
- *
- * @example
- * ```typescript
- * await downloadReleaseAsset(
- *   'v1.0.0', 'tool-linux-x64', '/tmp/tool',
- *   { owner: 'SocketDev', repo: 'socket-btm' },
- * )
- * ```
- */
-export declare function downloadReleaseAsset(tag: string, assetPattern: string | AssetPattern, outputPath: string, repoConfig: RepoConfig, options?: {
-    quiet?: boolean;
-}): Promise<void>;
-/**
- * Get GitHub authentication headers if token is available.
- * Checks GH_TOKEN or GITHUB_TOKEN environment variables.
- *
- * @returns Headers object with Authorization header if token exists.
- *
- * @example
- * ```typescript
- * const headers = getAuthHeaders()
- * // { Accept: 'application/vnd.github+json', Authorization: 'Bearer ...' }
- * ```
- */
-export declare function getAuthHeaders(): Record<string, string>;
-/**
- * Get latest release tag matching a tool prefix.
- * Optionally filter by releases containing a matching asset.
- *
- * @param toolPrefix - Tool name prefix to search for (e.g., 'node-smol-')
- * @param repoConfig - Repository configuration (owner/repo)
- * @param options - Additional options
- * @param options.assetPattern - Optional pattern to filter releases by matching asset
- * @returns Latest release tag or null if not found
- *
- * @example
- * ```typescript
- * const tag = await getLatestRelease('lief-', {
- *   owner: 'SocketDev', repo: 'socket-btm',
- * })
- * console.log(tag) // 'lief-2025-01-15-abc1234'
- * ```
- */
-export declare function getLatestRelease(toolPrefix: string, repoConfig: RepoConfig, options?: {
-    assetPattern?: AssetPattern;
-    quiet?: boolean;
-}): Promise<string | null>;
-/**
- * Get download URL for a specific release asset.
- * Supports pattern matching for dynamic asset discovery.
- *
- * @param tag - Release tag name
- * @param assetPattern - Asset name or pattern (glob string, prefix/suffix object, or RegExp)
- * @param repoConfig - Repository configuration (owner/repo)
- * @param options - Additional options
- * @returns Browser download URL for the asset
- *
- * @example
- * ```typescript
- * const url = await getReleaseAssetUrl(
- *   'v1.0.0', 'tool-linux-x64',
- *   { owner: 'SocketDev', repo: 'socket-btm' },
- * )
- * ```
- */
-export declare function getReleaseAssetUrl(tag: string, assetPattern: string | AssetPattern, repoConfig: RepoConfig, options?: {
-    quiet?: boolean;
-}): Promise<string | null>;