@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/eco/purl.js

@@ -1,63 +1,53 @@
 "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 purl_exports = {};
-__export(purl_exports, {
-  PURL_Type: () => PURL_Type
-});
-module.exports = __toCommonJS(purl_exports);
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/eco/purl.ts
+/**
+* @file PURL (Package URL) ecosystem identifiers shared across every package
+*   manager Socket understands.
+*
+*   - `PURL_Type` — runtime const mapping uppercase keys to lowercase ecosystem
+*     slugs (e.g. `PURL_Type.NPM === 'npm'`)
+*   - `PURLString` — string-union of every PURL ecosystem slug
+*   - `EcosystemString` — semantic alias of `PURLString` for places where
+*     "ecosystem" reads more naturally than "PURL string" Based on
+*     SocketPURL_Type from socket-sdk-js.
+*/
 const PURL_Type = {
-  ALPM: "alpm",
-  APK: "apk",
-  BITBUCKET: "bitbucket",
-  COCOAPODS: "cocoapods",
-  CARGO: "cargo",
-  CHROME: "chrome",
-  COMPOSER: "composer",
-  CONAN: "conan",
-  CONDA: "conda",
-  CRAN: "cran",
-  DEB: "deb",
-  DOCKER: "docker",
-  GEM: "gem",
-  GENERIC: "generic",
-  GITHUB: "github",
-  GOLANG: "golang",
-  HACKAGE: "hackage",
-  HEX: "hex",
-  HUGGINGFACE: "huggingface",
-  MAVEN: "maven",
-  MLFLOW: "mlflow",
-  NPM: "npm",
-  NUGET: "nuget",
-  OCI: "oci",
-  PUB: "pub",
-  PYPI: "pypi",
-  QPKG: "qpkg",
-  RPM: "rpm",
-  SWID: "swid",
-  SWIFT: "swift",
-  VCS: "vcs",
-  VSCODE: "vscode"
+	ALPM: "alpm",
+	APK: "apk",
+	BITBUCKET: "bitbucket",
+	COCOAPODS: "cocoapods",
+	CARGO: "cargo",
+	CHROME: "chrome",
+	COMPOSER: "composer",
+	CONAN: "conan",
+	CONDA: "conda",
+	CRAN: "cran",
+	DEB: "deb",
+	DOCKER: "docker",
+	GEM: "gem",
+	GENERIC: "generic",
+	GITHUB: "github",
+	GOLANG: "golang",
+	HACKAGE: "hackage",
+	HEX: "hex",
+	HUGGINGFACE: "huggingface",
+	MAVEN: "maven",
+	MLFLOW: "mlflow",
+	NPM: "npm",
+	NUGET: "nuget",
+	OCI: "oci",
+	PUB: "pub",
+	PYPI: "pypi",
+	QPKG: "qpkg",
+	RPM: "rpm",
+	SWID: "swid",
+	SWIFT: "swift",
+	VCS: "vcs",
+	VSCODE: "vscode"
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PURL_Type
-});
+
+//#endregion
+exports.PURL_Type = PURL_Type;

package/dist/eco/types.js

@@ -1,18 +1,2 @@
 "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 __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 types_exports = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/effects/pulse-frames.js

@@ -1,68 +1,67 @@
 "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 pulse_frames_exports = {};
-__export(pulse_frames_exports, {
-  generateSocketSpinnerFrames: () => generateSocketSpinnerFrames
-});
-module.exports = __toCommonJS(pulse_frames_exports);
-var import_constants = require("../ansi/constants");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_ansi_constants = require('../ansi/constants.js');
+
+//#region src/effects/pulse-frames.ts
+/**
+* @file Socket pulse animation frames generator. Generates themeable pulsing
+*   animation frames using sparkles (✧ ✦) and lightning (⚡). Follows the
+*   cli-spinners format: https://github.com/sindresorhus/cli-spinners.
+*/
+/**
+* Generate Socket pulse animation frames. Creates a pulsing throbber using
+* Unicode sparkles and lightning symbols. Frames use brightness modifiers
+* (bold/dim) but no embedded colors. Yocto-spinner applies the current spinner
+* color to each frame.
+*
+* Returns a spinner definition compatible with cli-spinners format.
+*
+* @example
+*   ;```typescript
+*   const { frames, interval } = generateSocketSpinnerFrames()
+*   console.log(frames.length, interval) // 18 50
+*   ```
+*
+* @see https://github.com/sindresorhus/cli-spinners/blob/main/spinners.json
+*/
 function generateSocketSpinnerFrames(options) {
-  const opts = { __proto__: null, ...options };
-  const interval = opts.interval ?? 50;
-  const bold = import_constants.ANSI_BOLD;
-  const dim = import_constants.ANSI_DIM;
-  const reset = import_constants.ANSI_RESET;
-  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
-  };
+	const interval = {
+		__proto__: null,
+		...options
+	}.interval ?? 50;
+	const bold = require_ansi_constants.ANSI_BOLD;
+	const dim = require_ansi_constants.ANSI_DIM;
+	const reset = require_ansi_constants.ANSI_RESET;
+	const lightning = "⚡︎";
+	const starFilled = "✦︎ ";
+	const starOutline = "✧︎ ";
+	const starTiny = "⋆︎ ";
+	return {
+		__proto__: null,
+		frames: [
+			`${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}`,
+			`${bold}${lightning}${reset}`,
+			`${bold}${lightning}${reset}`,
+			`${bold}${starFilled}${reset}`,
+			`${bold}${starFilled}${reset}`,
+			`${starFilled}${reset}`,
+			`${starFilled}${reset}`,
+			`${dim}${starTiny}${reset}`,
+			`${dim}${starOutline}${reset}`
+		],
+		interval
+	};
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  generateSocketSpinnerFrames
-});
+
+//#endregion
+exports.generateSocketSpinnerFrames = generateSocketSpinnerFrames;

package/dist/effects/shimmer-keyframes.js

@@ -1,55 +1,74 @@
 "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 shimmer_keyframes_exports = {};
-__export(shimmer_keyframes_exports, {
-  toShimmerKeyframes: () => toShimmerKeyframes
-});
-module.exports = __toCommonJS(shimmer_keyframes_exports);
-var import_shimmer = require("./shimmer");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_effects_shimmer = require('./shimmer.js');
+
+//#region src/effects/shimmer-keyframes.ts
+/**
+* @file SVG keyframe batcher for the shimmer engine. Pre-renders N frames of
+*   the engine and emits per-character keyTimes / values arrays suitable for
+*   SVG SMIL `<animate>` elements. The output is deduplicated (consecutive
+*   identical colors collapse to a single keyframe) and closed with a `t=1`
+*   anchor so the animation loops cleanly. Use with `calcMode="discrete"` to
+*   reproduce the engine's output exactly — no SMIL interpolation between
+*   frames, each frame holds until the next changes.
+*
+* @example
+*   ;```ts
+*   import { configToSpec } from '@socketsecurity/lib/effects/shimmer'
+*   import { toShimmerKeyframes } from '@socketsecurity/lib/effects/shimmer-keyframes'
+*   const spec = configToSpec({ color: RAINBOW_GRADIENT, dir: 'ltr' }, 10)
+*   const tracks = toShimmerKeyframes(spec, 10, 60)
+*   // Emit one <animate> per char in your SVG:
+*   //   <animate attributeName="fill" calcMode="discrete"
+*   //            keyTimes={tracks[i].times.join(';')}
+*   //            values={tracks[i].values.join(';')}
+*   //            dur="3s" repeatCount="indefinite" />
+*   ```
+*/
+/**
+* Render N frames of a shimmer spec into per-character keyframe tracks.
+*
+* Output is one {@link Keyframes} object per char. Consecutive identical colors
+* collapse — only the first occurrence emits a keyframe, the rest are implicit
+* (SMIL holds the previous value). A final keyframe at `t=1` closes the loop
+* with the same value as `t=0` so playback wraps cleanly.
+*
+* Use with `calcMode="discrete"` to reproduce the engine's per-frame output
+* exactly (no SMIL interpolation between frames).
+*
+* @param spec Functional shimmer specification.
+* @param textLength Number of chars to colorize.
+* @param frames Total frame count to bake into the loop.
+*
+* @returns One Keyframes track per char index, in order
+*/
 function toShimmerKeyframes(spec, textLength, frames) {
-  const tracks = [];
-  for (let i = 0; i < textLength; i++) {
-    tracks.push({ times: [], values: [] });
-  }
-  for (let f = 0; f < frames; f++) {
-    const t = f / frames;
-    const colors = (0, import_shimmer.frameColors)(spec, textLength, f);
-    for (let i = 0; i < textLength; i++) {
-      const c = colors[i];
-      const v = `rgb(${c[0]},${c[1]},${c[2]})`;
-      const track = tracks[i];
-      if (track.values[track.values.length - 1] !== v) {
-        track.times.push(t);
-        track.values.push(v);
-      }
-    }
-  }
-  for (let i = 0; i < textLength; i++) {
-    const track = tracks[i];
-    track.times.push(1);
-    track.values.push(track.values[0] ?? "rgb(0,0,0)");
-  }
-  return tracks;
+	const tracks = [];
+	for (let i = 0; i < textLength; i++) tracks.push({
+		times: [],
+		values: []
+	});
+	for (let f = 0; f < frames; f++) {
+		const t = f / frames;
+		const colors = require_effects_shimmer.frameColors(spec, textLength, f);
+		for (let i = 0; i < textLength; i++) {
+			const c = colors[i];
+			const v = `rgb(${c[0]},${c[1]},${c[2]})`;
+			const track = tracks[i];
+			if (track.values[track.values.length - 1] !== v) {
+				track.times.push(t);
+				track.values.push(v);
+			}
+		}
+	}
+	for (let i = 0; i < textLength; i++) {
+		const track = tracks[i];
+		track.times.push(1);
+		track.values.push(track.values[0] ?? "rgb(0,0,0)");
+	}
+	return tracks;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  toShimmerKeyframes
-});
+
+//#endregion
+exports.toShimmerKeyframes = toShimmerKeyframes;

package/dist/effects/shimmer-terminal.js

@@ -1,57 +1,88 @@
 "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 shimmer_terminal_exports = {};
-__export(shimmer_terminal_exports, {
-  ANSI_RESET: () => import_constants.ANSI_RESET,
-  ansiTruecolor: () => ansiTruecolor,
-  colorsToAnsi: () => colorsToAnsi,
-  renderFrame: () => renderFrame
-});
-module.exports = __toCommonJS(shimmer_terminal_exports);
-var import_constants = require("../ansi/constants");
-var import_shimmer = require("./shimmer");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_ansi_constants = require('../ansi/constants.js');
+const require_effects_shimmer = require('./shimmer.js');
+
+//#region src/effects/shimmer-terminal.ts
+/**
+* @file Terminal renderer for the shimmer engine. Turns the engine's `RGB[]`
+*   output into a single ANSI-escaped string ready to write to stdout/stderr.
+*   Uses 24-bit truecolor escape sequences (`\x1b[38;2;R;G;Bm`) which most
+*   modern terminals (iTerm2, Terminal.app, Windows Terminal, Alacritty,
+*   Ghostty, kitty, gnome-terminal) support natively. Terminals that lack
+*   truecolor (basic `xterm`, some serial consoles) will display the raw escape
+*   codes — call sites that need to support those terminals should fall back to
+*   {@link colorsToAnsi}'s "no colors" path or skip rendering entirely. The
+*   high-level {@link renderFrame} convenience runs the full pipeline (engine →
+*   ANSI) in one call. {@link colorsToAnsi} is the lower-level helper for when
+*   you already have an `RGB[]` from {@link frameColors}.
+*
+* @example
+*   ;```ts
+*   import { configToSpec } from '@socketsecurity/lib/effects/shimmer'
+*   import { renderFrame } from '@socketsecurity/lib/effects/shimmer-terminal'
+*   const spec = configToSpec(
+*     { color: [140, 82, 255], dir: 'ltr' },
+*     'Loading'.length,
+*   )
+*   process.stdout.write(renderFrame(spec, 'Loading', frame))
+*   ```
+*/
+/**
+* Build the 24-bit truecolor foreground escape for an RGB tuple. Returns
+* `\x1b[38;2;R;G;Bm`. Exported so callers building ANSI by hand can use the
+* same helper.
+*/
 function ansiTruecolor([r, g, b]) {
-  return `\x1B[38;2;${r};${g};${b}m`;
+	return `\x1b[38;2;${r};${g};${b}m`;
 }
+/**
+* Wrap each char of `text` in a 24-bit truecolor ANSI escape using the matching
+* color from `colors`. Each char is followed by an ANSI reset so adjacent
+* uncolored output isn't tinted.
+*
+* Caller is responsible for grapheme segmentation if the text contains complex
+* graphemes (combining marks, ZWJ sequences). This function uses spread
+* iteration which handles BMP code points and surrogate pairs but treats each
+* grapheme cluster as multiple "chars."
+*
+* If `colors.length` is shorter than the text's char count, surplus chars are
+* emitted without color (uncolored tail).
+*
+* @param text Input string to color.
+* @param colors Per-char colors; index `i` colors char `i`
+*
+* @returns ANSI-escaped string
+*/
 function colorsToAnsi(text, colors) {
-  const chars = [...text];
-  let out = "";
-  for (let i = 0; i < chars.length; i++) {
-    const c = colors[i];
-    if (c === void 0) {
-      out += chars[i];
-      continue;
-    }
-    out += `${ansiTruecolor(c)}${chars[i]}${import_constants.ANSI_RESET}`;
-  }
-  return out;
+	const chars = [...text];
+	let out = "";
+	for (let i = 0; i < chars.length; i++) {
+		const c = colors[i];
+		if (c === void 0) {
+			out += chars[i];
+			continue;
+		}
+		out += `${ansiTruecolor(c)}${chars[i]}${require_ansi_constants.ANSI_RESET}`;
+	}
+	return out;
 }
+/**
+* Render a single shimmer frame as ANSI-escaped text. Convenience wrapper over
+* {@link frameColors} + {@link colorsToAnsi} for callers that don't need the
+* intermediate `RGB[]`.
+*
+* @param spec Functional shimmer specification (see {@link ShimmerSpec})
+* @param text The string to colorize.
+* @param frame Caller-controlled frame counter.
+*/
 function renderFrame(spec, text, frame) {
-  const chars = [...text];
-  return colorsToAnsi(text, (0, import_shimmer.frameColors)(spec, chars.length, frame));
+	return colorsToAnsi(text, require_effects_shimmer.frameColors(spec, [...text].length, frame));
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ANSI_RESET,
-  ansiTruecolor,
-  colorsToAnsi,
-  renderFrame
-});
+
+//#endregion
+exports.ANSI_RESET = require_ansi_constants.ANSI_RESET;
+exports.ansiTruecolor = ansiTruecolor;
+exports.colorsToAnsi = colorsToAnsi;
+exports.renderFrame = renderFrame;