@socketsecurity/lib 5.27.0 → 6.0.0

package/dist/{ssri.js → ssri/convert.js}

@@ -18,58 +18,35 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var ssri_exports = {};
-__export(ssri_exports, {
+var convert_exports = {};
+__export(convert_exports, {
   hexToSsri: () => hexToSsri,
-  isValidHex: () => isValidHex,
-  isValidSsri: () => isValidSsri,
-  parseSsri: () => parseSsri,
   ssriToHex: () => ssriToHex
 });
-module.exports = __toCommonJS(ssri_exports);
-var import_primordials = require("./primordials");
+module.exports = __toCommonJS(convert_exports);
+var import_buffer = require("../primordials/buffer");
+var import_error = require("../primordials/error");
 // @__NO_SIDE_EFFECTS__
 function hexToSsri(hex, algorithm = "sha256") {
   if (!/^[a-f0-9]+$/i.test(hex)) {
-    throw new import_primordials.ErrorCtor(`Invalid hex format: ${hex}`);
+    throw new import_error.ErrorCtor(`Invalid hex format: ${hex}`);
   }
-  const buffer = (0, import_primordials.BufferFrom)(hex, "hex");
-  const base64Hash = (0, import_primordials.BufferPrototypeToString)(buffer, "base64");
+  const buffer = (0, import_buffer.BufferFrom)(hex, "hex");
+  const base64Hash = (0, import_buffer.BufferPrototypeToString)(buffer, "base64");
   return `${algorithm}-${base64Hash}`;
 }
 // @__NO_SIDE_EFFECTS__
-function isValidHex(value) {
-  return /^[a-f0-9]+$/i.test(value);
-}
-// @__NO_SIDE_EFFECTS__
-function isValidSsri(value) {
-  return /^[a-z0-9]+-[A-Za-z0-9+/]{2,}=*$/i.test(value);
-}
-// @__NO_SIDE_EFFECTS__
-function parseSsri(ssri) {
-  const match = /^([a-z0-9]+)-([A-Za-z0-9+/]+=*)$/i.exec(ssri);
-  if (!match || !match[1] || !match[2] || match[2].length < 2) {
-    throw new import_primordials.ErrorCtor(`Invalid SSRI format: ${ssri}`);
-  }
-  const algorithm = match[1];
-  const base64Hash = match[2];
-  return { algorithm, base64Hash };
-}
-// @__NO_SIDE_EFFECTS__
 function ssriToHex(ssri) {
   const match = /^([a-z0-9]+)-([A-Za-z0-9+/]+=*)$/i.exec(ssri);
   if (!match || !match[2] || match[2].length < 2) {
-    throw new import_primordials.ErrorCtor(`Invalid SSRI format: ${ssri}`);
+    throw new import_error.ErrorCtor(`Invalid SSRI format: ${ssri}`);
   }
   const base64Hash = match[2];
-  const buffer = (0, import_primordials.BufferFrom)(base64Hash, "base64");
-  return (0, import_primordials.BufferPrototypeToString)(buffer, "hex");
+  const buffer = (0, import_buffer.BufferFrom)(base64Hash, "base64");
+  return (0, import_buffer.BufferPrototypeToString)(buffer, "hex");
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   hexToSsri,
-  isValidHex,
-  isValidSsri,
-  parseSsri,
   ssriToHex
 });

package/dist/ssri/parse.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file SSRI parser — splits a `<algorithm>-<base64hash>` string into its
+ *   component fields.
+ */
+/**
+ * Parse SSRI format into components.
+ *
+ * Extracts the algorithm and base64 hash from an SSRI string.
+ *
+ * @example
+ *   ;```typescript
+ *   const { algorithm, base64Hash } = parseSsri(
+ *     'sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=',
+ *   )
+ *   // Returns: { algorithm: 'sha256', base64Hash: 'dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=' }
+ *   ```
+ *
+ * @param ssri - Hash in SSRI format.
+ *
+ * @returns Object with algorithm and base64Hash properties
+ *
+ * @throws Error if SSRI format is invalid
+ */
+export declare function parseSsri(ssri: string): {
+    algorithm: string;
+    base64Hash: string;
+};

package/dist/ssri/parse.js

@@ -0,0 +1,40 @@
+"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 parse_exports = {};
+__export(parse_exports, {
+  parseSsri: () => parseSsri
+});
+module.exports = __toCommonJS(parse_exports);
+var import_error = require("../primordials/error");
+// @__NO_SIDE_EFFECTS__
+function parseSsri(ssri) {
+  const match = /^([a-z0-9]+)-([A-Za-z0-9+/]+=*)$/i.exec(ssri);
+  if (!match || !match[1] || !match[2] || match[2].length < 2) {
+    throw new import_error.ErrorCtor(`Invalid SSRI format: ${ssri}`);
+  }
+  const algorithm = match[1];
+  const base64Hash = match[2];
+  return { algorithm, base64Hash };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  parseSsri
+});

package/dist/ssri/validate.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file SSRI/hex format validators — predicates that report whether a string
+ *   looks like a hex digest or an SSRI integrity string. Validation is purely
+ *   lexical; the predicates do not verify algorithm strength or digest length.
+ */
+/**
+ * Check if a string is valid hex format.
+ *
+ * Validates that a string contains only hexadecimal characters (0-9, a-f). Does
+ * not verify hash length or algorithm.
+ *
+ * @example
+ *   ;```typescript
+ *   isValidHex(
+ *     '76682a9fc3bbe62975176e2541f39a8168877d828d5cad8b56461fc36ac2b856',
+ *   ) // true
+ *   isValidHex('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=') // false
+ *   ```
+ *
+ * @param value - String to validate.
+ *
+ * @returns True if string is valid hex format
+ */
+export declare function isValidHex(value: string): boolean;
+/**
+ * Check if a string is valid SSRI format.
+ *
+ * Validates that a string matches the SSRI format pattern (algorithm-base64).
+ * Does not verify that the base64 encoding is valid.
+ *
+ * @example
+ *   ;```typescript
+ *   isValidSsri('sha256-dmgqn8O75il1F24lQfOagWiHfYKNXK2LVkYfw2rCuFY=') // true
+ *   isValidSsri('76682a9f...') // false
+ *   ```
+ *
+ * @param value - String to validate.
+ *
+ * @returns True if string matches SSRI format
+ */
+export declare function isValidSsri(value: string): boolean;

package/dist/ssri/validate.js

@@ -0,0 +1,39 @@
+"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 validate_exports = {};
+__export(validate_exports, {
+  isValidHex: () => isValidHex,
+  isValidSsri: () => isValidSsri
+});
+module.exports = __toCommonJS(validate_exports);
+// @__NO_SIDE_EFFECTS__
+function isValidHex(value) {
+  return /^[a-f0-9]+$/i.test(value);
+}
+// @__NO_SIDE_EFFECTS__
+function isValidSsri(value) {
+  return /^[a-z0-9]+-[A-Za-z0-9+/]{2,}=*$/i.test(value);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isValidHex,
+  isValidSsri
+});

package/dist/stdio/{_stream.d.ts → _internal.d.ts}

@@ -1,31 +1,36 @@
 /**
- * @fileoverview Shared TTY primitives for stdio/stdout.ts + stdio/stderr.ts.
  * @private
+ *
+ * @file Shared TTY primitives for stdio/stdout.ts + stdio/stderr.ts.
  */
 /**
- * Clear the current line on the given stream.
- * Only works in TTY environments.
+ * Clear the current line on the given stream. Only works in TTY environments.
+ *
  * @private
  */
 export declare function clearLineOn(stream: NodeJS.WriteStream): void;
 /**
- * Move cursor to specific position on the given stream.
- * Only works in TTY environments.
+ * Move cursor to specific position on the given stream. Only works in TTY
+ * environments.
+ *
  * @private
  */
 export declare function cursorToOn(stream: NodeJS.WriteStream, x: number, y?: number | undefined): void;
 /**
  * Get the number of columns on the given stream (or 80 fallback).
+ *
  * @private
  */
 export declare function getColumnsOf(stream: NodeJS.WriteStream): number;
 /**
  * Get the number of rows on the given stream (or 24 fallback).
+ *
  * @private
  */
 export declare function getRowsOf(stream: NodeJS.WriteStream): number;
 /**
  * Check if the given stream is connected to a TTY.
+ *
  * @private
  */
 export declare function isTTYOf(stream: NodeJS.WriteStream): boolean;

package/dist/stdio/{_stream.js → _internal.js}

@@ -18,15 +18,15 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var stream_exports = {};
-__export(stream_exports, {
+var internal_exports = {};
+__export(internal_exports, {
   clearLineOn: () => clearLineOn,
   cursorToOn: () => cursorToOn,
   getColumnsOf: () => getColumnsOf,
   getRowsOf: () => getRowsOf,
   isTTYOf: () => isTTYOf
 });
-module.exports = __toCommonJS(stream_exports);
+module.exports = __toCommonJS(internal_exports);
 function clearLineOn(stream) {
   if (stream.isTTY) {
     stream.cursorTo(0);

package/dist/stdio/clear.d.ts

@@ -1,163 +1,177 @@
 /**
- * @fileoverview Terminal clearing and cursor utilities.
- * Provides functions for clearing lines, screens, and managing cursor position.
+ * @file Terminal clearing and cursor utilities. Provides functions for clearing
+ *   lines, screens, and managing cursor position.
  */
 /**
- * Clear the current line in the terminal.
- * Uses native TTY methods when available, falls back to ANSI escape codes.
- * Uses native TTY methods when available and falls back to `\r\x1b[K` ANSI
- * escapes on non-TTY streams.
+ * Clear the current line in the terminal. Uses native TTY methods when
+ * available, falls back to ANSI escape codes. Uses native TTY methods when
+ * available and falls back to `\r\x1b[K` ANSI escapes on non-TTY streams.
  *
  * ANSI Sequences:
+ *
  * - `\r`: Carriage return (move to line start)
  * - `\x1b[K`: Clear from cursor to end of line
  *
- * @param stream - Output stream to clear (defaults to `process.stdout`)
+ * @example
+ *   ;```ts
+ *   clearLine() // Clear current line on stdout
+ *   clearLine(process.stderr) // Clear on stderr
+ *   ```
+ *
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * clearLine() // Clear current line on stdout
- * clearLine(process.stderr) // Clear on stderr
- * ```
+ * @param stream - Output stream to clear (defaults to `process.stdout`)
  */
 export declare function clearLine(stream?: NodeJS.WriteStream): void;
 /**
- * Clear multiple lines above the current cursor position.
- * Useful for clearing multi-line output like progress bars or status messages.
+ * Clear multiple lines above the current cursor position. Useful for clearing
+ * multi-line output like progress bars or status messages.
  *
  * ANSI Sequences:
+ *
  * - `\x1b[1A`: Move cursor up one line
  * - `\x1b[2K`: Erase entire line
  *
- * @param count - Number of lines to clear
- * @param stream - Output stream to clear
+ * @example
+ *   ;```ts
+ *   console.log('Line 1')
+ *   console.log('Line 2')
+ *   console.log('Line 3')
+ *   clearLines(2) // Clears lines 2 and 3
+ *   ```
+ *
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * console.log('Line 1')
- * console.log('Line 2')
- * console.log('Line 3')
- * clearLines(2) // Clears lines 2 and 3
- * ```
+ * @param count - Number of lines to clear.
+ * @param stream - Output stream to clear.
  */
 export declare function clearLines(count: number, stream?: NodeJS.WriteStream): void;
 /**
- * Clear the entire screen and reset cursor to top-left.
- * Only works in TTY environments.
+ * Clear the entire screen and reset cursor to top-left. Only works in TTY
+ * environments.
  *
  * ANSI Sequence:
+ *
  * - `\x1bc`: Full reset (clear screen and move cursor home)
  *
- * @param stream - Output stream to clear
+ * @example
+ *   ;```ts
+ *   clearScreen() // Clear entire terminal
+ *   ```
+ *
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * clearScreen() // Clear entire terminal
- * ```
+ * @param stream - Output stream to clear.
  */
 export declare function clearScreen(stream?: NodeJS.WriteStream): void;
 /**
- * Clear the visible terminal screen.
- * Alias for `clearScreen()`.
+ * Clear the visible terminal screen. Alias for `clearScreen()`.
+ *
+ * @example
+ *   ;```ts
+ *   clearVisible() // Same as clearScreen()
+ *   ```
  *
- * @param stream - Output stream to clear
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * clearVisible() // Same as clearScreen()
- * ```
+ * @param stream - Output stream to clear.
  */
 export declare function clearVisible(stream?: NodeJS.WriteStream): void;
 /**
- * Move cursor to the beginning of the current line.
- * Uses native TTY methods when available, falls back to carriage return.
+ * Move cursor to the beginning of the current line. Uses native TTY methods
+ * when available, falls back to carriage return.
+ *
+ * @example
+ *   ;```ts
+ *   process.stdout.write('Some text...')
+ *   cursorToStart()
+ *   process.stdout.write('New text') // Overwrites from start
+ *   ```
  *
- * @param stream - Output stream to manipulate
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * process.stdout.write('Some text...')
- * cursorToStart()
- * process.stdout.write('New text') // Overwrites from start
- * ```
+ * @param stream - Output stream to manipulate.
  */
 export declare function cursorToStart(stream?: NodeJS.WriteStream): void;
 /**
- * Hide the terminal cursor.
- * Useful for cleaner output during animations or progress indicators.
+ * Hide the terminal cursor. Useful for cleaner output during animations or
+ * progress indicators.
  *
  * ANSI Sequence:
+ *
  * - `\x1b[?25l`: DECTCEM hide cursor
  *
- * @param stream - Output stream to manipulate
+ * @example
+ *   ;```ts
+ *   hideCursor()
+ *   // ... show animation
+ *   showCursor()
+ *   ```
+ *
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * hideCursor()
- * // ... show animation
- * showCursor()
- * ```
+ * @param stream - Output stream to manipulate.
  */
 export declare function hideCursor(stream?: NodeJS.WriteStream): void;
 /**
- * Restore cursor to previously saved position.
- * Must be called after `saveCursor()`.
+ * Restore cursor to previously saved position. Must be called after
+ * `saveCursor()`.
  *
  * ANSI Sequence:
+ *
  * - `\x1b8`: DECRC restore cursor
  *
- * @param stream - Output stream to manipulate
+ * @example
+ *   ;```ts
+ *   saveCursor()
+ *   console.log('Temporary text')
+ *   restoreCursor()
+ *   console.log('Back at saved position')
+ *   ```
+ *
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * saveCursor()
- * console.log('Temporary text')
- * restoreCursor()
- * console.log('Back at saved position')
- * ```
+ * @param stream - Output stream to manipulate.
  */
 export declare function restoreCursor(stream?: NodeJS.WriteStream): void;
 /**
- * Save the current cursor position.
- * Can be restored later with `restoreCursor()`.
+ * Save the current cursor position. Can be restored later with
+ * `restoreCursor()`.
  *
  * ANSI Sequence:
+ *
  * - `\x1b7`: DECSC save cursor
  *
- * @param stream - Output stream to manipulate
+ * @example
+ *   ;```ts
+ *   saveCursor()
+ *   console.log('Temporary text')
+ *   restoreCursor()
+ *   console.log('Back at saved position')
+ *   ```
+ *
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * saveCursor()
- * console.log('Temporary text')
- * restoreCursor()
- * console.log('Back at saved position')
- * ```
+ * @param stream - Output stream to manipulate.
  */
 export declare function saveCursor(stream?: NodeJS.WriteStream): void;
 /**
- * Show the terminal cursor.
- * Should be called after `hideCursor()` to restore normal cursor visibility.
+ * Show the terminal cursor. Should be called after `hideCursor()` to restore
+ * normal cursor visibility.
  *
  * ANSI Sequence:
+ *
  * - `\x1b[?25h`: DECTCEM show cursor
  *
- * @param stream - Output stream to manipulate
+ * @example
+ *   ;```ts
+ *   hideCursor()
+ *   // ... show animation
+ *   showCursor()
+ *   ```
+ *
  * @default stream process.stdout
  *
- * @example
- * ```ts
- * hideCursor()
- * // ... show animation
- * showCursor()
- * ```
+ * @param stream - Output stream to manipulate.
  */
 export declare function showCursor(stream?: NodeJS.WriteStream): void;