@socketsecurity/lib 5.27.0 → 6.0.0

package/dist/stdio/header.d.ts

@@ -1,94 +1,105 @@
 /**
- * @fileoverview Console header/banner formatting utilities.
- * Provides consistent header formatting for CLI applications.
+ * @file Console header/banner formatting utilities. Provides consistent header
+ *   formatting for CLI applications.
  */
 export interface HeaderOptions {
     /**
      * Width of the header in characters.
+     *
      * @default 80
      */
     width?: number | undefined;
     /**
      * Character to use for border lines.
+     *
      * @default '='
      */
     borderChar?: string | undefined;
     /**
      * Number of blank lines above and below title.
+     *
      * @default 1
      */
     padding?: number | undefined;
     /**
      * Color to apply to the title text.
+     *
      * @default 'cyan'
      */
     color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta' | 'red' | 'gray' | undefined;
     /**
      * Apply bold styling to title.
+     *
      * @default true
      */
     bold?: boolean | undefined;
 }
 /**
- * Create a formatted header/banner with borders and centered title.
- * Useful for marking the start of CLI output or creating visual sections.
- *
- * @param title - Title text to display in header
- * @param options - Header formatting options
- * @returns Formatted header string with borders and centered title
+ * Create a formatted header/banner with borders and centered title. Useful for
+ * marking the start of CLI output or creating visual sections.
  *
  * @example
- * ```ts
- * console.log(createHeader('Socket Security Analysis', {
- *   width: 70,
- *   color: 'cyan',
- *   bold: true,
- *   padding: 2
- * }))
- * // Output:
- * // ======================================================================
- * //
- * //                    Socket Security Analysis
- * //
- * // ======================================================================
- * ```
+ *   ;```ts
+ *   console.log(
+ *     createHeader('Socket Security Analysis', {
+ *       width: 70,
+ *       color: 'cyan',
+ *       bold: true,
+ *       padding: 2,
+ *     }),
+ *   )
+ *   // Output:
+ *   // ======================================================================
+ *   //
+ *   //                    Socket Security Analysis
+ *   //
+ *   // ======================================================================
+ *   ```
+ *
+ * @param title - Title text to display in header.
+ * @param options - Header formatting options.
+ *
+ * @returns Formatted header string with borders and centered title
  */
 export declare function createHeader(title: string, options?: HeaderOptions): string;
 /**
- * Create a simple section header without padding.
- * A lighter-weight alternative to `createHeader()` for subsections.
- *
- * @param title - Title text to display in header
- * @param options - Header formatting options
- * @returns Formatted section header string
+ * Create a simple section header without padding. A lighter-weight alternative
+ * to `createHeader()` for subsections.
  *
  * @example
- * ```ts
- * console.log(createSectionHeader('Dependencies', {
- *   width: 50,
- *   color: 'blue'
- * }))
- * // Output:
- * // --------------------------------------------------
- * //                   Dependencies
- * // --------------------------------------------------
- * ```
+ *   ;```ts
+ *   console.log(
+ *     createSectionHeader('Dependencies', {
+ *       width: 50,
+ *       color: 'blue',
+ *     }),
+ *   )
+ *   // Output:
+ *   // --------------------------------------------------
+ *   //                   Dependencies
+ *   // --------------------------------------------------
+ *   ```
+ *
+ * @param title - Title text to display in header.
+ * @param options - Header formatting options.
+ *
+ * @returns Formatted section header string
  */
 export declare function createSectionHeader(title: string, options?: HeaderOptions): string;
 /**
- * Print a header directly to stdout with standard formatting.
- * Uses fixed width of 55 characters with `═` borders.
- * Simpler alternative to `createHeader()` for quick headers.
- *
- * @param title - Title text to display
+ * Print a header directly to stdout with standard formatting. Uses fixed width
+ * of 55 characters with `═` borders. Simpler alternative to `createHeader()`
+ * for quick headers.
  *
  * @example
- * ```ts
- * printHeader('Package Analysis')
- * // Output:
- * // ═══════════════════════════════════════════════════
- * //   Package Analysis
- * // ═══════════════════════════════════════════════════
- * ```
+ *   ;```ts
+ *   printHeader('Package Analysis')
+ *   // Output:
+ *   // ═══════════════════════════════════════════════════
+ *   //   Package Analysis
+ *   // ═══════════════════════════════════════════════════
+ *   ```
+ *
+ * @param title - Title text to display.
  */
 export declare function printHeader(title: string): void;

package/dist/stdio/header.js

@@ -36,8 +36,10 @@ __export(header_exports, {
 });
 module.exports = __toCommonJS(header_exports);
 var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-var import_strings = require("../strings");
-var import_primordials = require("../primordials");
+var import_format = require("../strings/format");
+var import_logger = require("../logger/logger");
+var import_array = require("../primordials/array");
+const logger = (0, import_logger.getDefaultLogger)();
 function createHeader(title, options) {
   const {
     bold = true,
@@ -46,7 +48,7 @@ function createHeader(title, options) {
     padding = 1,
     width = 80
   } = { __proto__: null, ...options };
-  const border = (0, import_strings.repeatString)(borderChar, width);
+  const border = (0, import_format.repeatString)(borderChar, width);
   let formattedTitle = title;
   if (color && import_yoctocolors_cjs.default[color]) {
     formattedTitle = import_yoctocolors_cjs.default[color](formattedTitle);
@@ -54,17 +56,17 @@ function createHeader(title, options) {
   if (bold && import_yoctocolors_cjs.default.bold) {
     formattedTitle = import_yoctocolors_cjs.default.bold(formattedTitle);
   }
-  const centeredTitle = (0, import_strings.centerText)(formattedTitle, width);
-  const paddingLine = (0, import_strings.repeatString)(" ", width);
+  const centeredTitle = (0, import_format.centerText)(formattedTitle, width);
+  const paddingLine = (0, import_format.repeatString)(" ", width);
   const lines = [border];
   for (let i = 0; i < padding; i++) {
-    (0, import_primordials.ArrayPrototypePush)(lines, paddingLine);
+    (0, import_array.ArrayPrototypePush)(lines, paddingLine);
   }
-  (0, import_primordials.ArrayPrototypePush)(lines, centeredTitle);
+  (0, import_array.ArrayPrototypePush)(lines, centeredTitle);
   for (let i = 0; i < padding; i++) {
-    (0, import_primordials.ArrayPrototypePush)(lines, paddingLine);
+    (0, import_array.ArrayPrototypePush)(lines, paddingLine);
   }
-  (0, import_primordials.ArrayPrototypePush)(lines, border);
+  (0, import_array.ArrayPrototypePush)(lines, border);
   return lines.join("\n");
 }
 function createSectionHeader(title, options) {
@@ -82,10 +84,10 @@ function createSectionHeader(title, options) {
   });
 }
 function printHeader(title) {
-  const border = (0, import_strings.repeatString)("\u2550", 55);
-  console.log(border);
-  console.log(`  ${title}`);
-  console.log(border);
+  const border = (0, import_format.repeatString)("\u2550", 55);
+  logger.log(border);
+  logger.log(`  ${title}`);
+  logger.log(border);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/stdio/progress.d.ts

@@ -1,57 +1,66 @@
 /**
- * @fileoverview Progress bar utilities for CLI applications.
- * Provides various progress indicators including bars, percentages, and spinners.
+ * @file Progress bar utilities for CLI applications. Provides various progress
+ *   indicators including bars, percentages, and spinners.
  */
 export interface ProgressBarOptions {
     /**
      * Width of the progress bar in characters.
+     *
      * @default 40
      */
     width?: number | undefined;
     /**
-     * Format template for progress bar display.
-     * Available tokens: `:bar`, `:percent`, `:current`, `:total`, `:elapsed`, `:eta`.
-     * Custom tokens can be passed via the `tokens` parameter in `update()` or `tick()`.
-     * @default ':bar :percent :current/:total'
+     * Format template for progress bar display. Available tokens: `:bar`,
+     * `:percent`, `:current`, `:total`, `:elapsed`, `:eta`. Custom tokens can be
+     * passed via the `tokens` parameter in `update()` or `tick()`.
+     *
      * @example
-     * ```ts
-     * format: ':bar :percent :current/:total :eta'
-     * ```
+     *   ;```ts
+     *   format: ':bar :percent :current/:total :eta'
+     *   ```
+     *
+     * @default ':bar :percent :current/:total'
      */
     format?: string | undefined;
     /**
      * Character(s) to use for completed portion of bar.
+     *
      * @default '█'
      */
     complete?: string | undefined;
     /**
      * Character(s) to use for incomplete portion of bar.
+     *
      * @default '░'
      */
     incomplete?: string | undefined;
     /**
      * Character(s) to use for the head of the progress bar.
+     *
      * @default ''
      */
     head?: string | undefined;
     /**
      * Clear the progress bar when complete.
+     *
      * @default false
      */
     clear?: boolean | undefined;
     /**
-     * Minimum time between renders in milliseconds.
-     * ~60fps = 16ms throttle.
+     * Minimum time between renders in milliseconds. ~60fps = 16ms throttle.
+     *
      * @default 16
      */
     renderThrottle?: number | undefined;
     /**
      * Stream to write progress bar output to.
+     *
      * @default process.stderr
      */
     stream?: NodeJS.WriteStream | undefined;
     /**
      * Color to apply to the completed portion of the bar.
+     *
      * @default 'cyan'
      */
     color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta' | undefined;
@@ -68,47 +77,48 @@ export declare class ProgressBar {
     /**
      * Create a new progress bar instance.
      *
-     * @param total - Total number of units for the progress bar
-     * @param options - Configuration options for the progress bar
-     *
      * @example
-     * ```ts
-     * const bar = new ProgressBar(100, {
-     *   width: 50,
-     *   format: ':bar :percent :current/:total :eta',
-     *   color: 'green'
-     * })
-     * ```
+     *   ;```ts
+     *   const bar = new ProgressBar(100, {
+     *     width: 50,
+     *     format: ':bar :percent :current/:total :eta',
+     *     color: 'green',
+     *   })
+     *   ```
+     *
+     * @param total - Total number of units for the progress bar.
+     * @param options - Configuration options for the progress bar.
      */
     constructor(total: number, options?: ProgressBarOptions);
     /**
-     * Update progress to a specific value and redraw the bar.
-     * Updates are throttled to prevent excessive rendering (default ~60fps).
-     *
-     * @param current - Current progress value (will be clamped to total)
-     * @param tokens - Optional custom tokens to replace in format string
+     * Update progress to a specific value and redraw the bar. Updates are
+     * throttled to prevent excessive rendering (default ~60fps).
      *
      * @example
-     * ```ts
-     * bar.update(50)
-     * bar.update(75, { status: 'Processing...' })
-     * ```
+     *   ;```ts
+     *   bar.update(50)
+     *   bar.update(75, { status: 'Processing...' })
+     *   ```
+     *
+     * @param current - Current progress value (will be clamped to total)
+     * @param tokens - Optional custom tokens to replace in format string.
      */
     update(current: number, tokens?: Record<string, unknown>): void;
     /**
-     * Increment progress by a specified amount.
-     * Convenience method for `update(current + amount)`.
+     * Increment progress by a specified amount. Convenience method for
+     * `update(current + amount)`.
+     *
+     * @example
+     *   ;```ts
+     *   bar.tick() // Increment by 1
+     *   bar.tick(5) // Increment by 5
+     *   bar.tick(1, { file: 'data.json' })
+     *   ```
      *
-     * @param amount - Amount to increment by
-     * @param tokens - Optional custom tokens to replace in format string
      * @default amount 1
      *
-     * @example
-     * ```ts
-     * bar.tick() // Increment by 1
-     * bar.tick(5) // Increment by 5
-     * bar.tick(1, { file: 'data.json' })
-     * ```
+     * @param amount - Amount to increment by.
+     * @param tokens - Optional custom tokens to replace in format string.
      */
     tick(amount?: number, tokens?: Record<string, unknown>): void;
     /**
@@ -124,29 +134,29 @@ export declare class ProgressBar {
      */
     private formatTime;
     /**
-     * Terminate the progress bar and optionally clear it.
-     * Called automatically when progress reaches 100%.
-     * If `clear` option is true, removes the bar from terminal.
-     * Otherwise, moves to next line to preserve the final state.
+     * Terminate the progress bar and optionally clear it. Called automatically
+     * when progress reaches 100%. If `clear` option is true, removes the bar from
+     * terminal. Otherwise, moves to next line to preserve the final state.
      */
     terminate(): void;
 }
 /**
- * Create a simple progress indicator without a graphical bar.
- * Returns a formatted string showing progress as percentage and fraction.
- *
- * @param current - Current progress value
- * @param total - Total progress value
- * @param label - Optional label prefix
- * @returns Formatted progress indicator string
+ * Create a simple progress indicator without a graphical bar. Returns a
+ * formatted string showing progress as percentage and fraction.
  *
  * @example
- * ```ts
- * createProgressIndicator(50, 100)
- * // Returns: '[50%] 50/100'
+ *   ;```ts
+ *   createProgressIndicator(50, 100)
+ *   // Returns: '[50%] 50/100'
  *
- * createProgressIndicator(3, 10, 'Files')
- * // Returns: 'Files: [30%] 3/10'
- * ```
+ *   createProgressIndicator(3, 10, 'Files')
+ *   // Returns: 'Files: [30%] 3/10'
+ *   ```
+ *
+ * @param current - Current progress value.
+ * @param total - Total progress value.
+ * @param label - Optional label prefix.
+ *
+ * @returns Formatted progress indicator string
  */
 export declare function createProgressIndicator(current: number, total: number, label?: string | undefined): string;

package/dist/stdio/progress.js

@@ -36,8 +36,12 @@ __export(progress_exports, {
 module.exports = __toCommonJS(progress_exports);
 var import_node_process = __toESM(require("node:process"));
 var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
-var import_strings = require("../strings");
-var import_primordials = require("../primordials");
+var import_strip = require("../ansi/strip");
+var import_format = require("../strings/format");
+var import_date = require("../primordials/date");
+var import_math = require("../primordials/math");
+var import_object = require("../primordials/object");
+var import_string = require("../primordials/string");
 class ProgressBar {
   current = 0;
   total;
@@ -50,21 +54,21 @@ class ProgressBar {
   /**
    * Create a new progress bar instance.
    *
-   * @param total - Total number of units for the progress bar
-   * @param options - Configuration options for the progress bar
-   *
    * @example
-   * ```ts
-   * const bar = new ProgressBar(100, {
-   *   width: 50,
-   *   format: ':bar :percent :current/:total :eta',
-   *   color: 'green'
-   * })
-   * ```
+   *   ;```ts
+   *   const bar = new ProgressBar(100, {
+   *     width: 50,
+   *     format: ':bar :percent :current/:total :eta',
+   *     color: 'green',
+   *   })
+   *   ```
+   *
+   * @param total - Total number of units for the progress bar.
+   * @param options - Configuration options for the progress bar.
    */
   constructor(total, options) {
     this.total = total;
-    this.startTime = (0, import_primordials.DateNow)();
+    this.startTime = (0, import_date.DateNow)();
     this.stream = options?.stream || import_node_process.default.stderr;
     this.options = {
       width: 40,
@@ -81,24 +85,24 @@ class ProgressBar {
     };
   }
   /**
-   * Update progress to a specific value and redraw the bar.
-   * Updates are throttled to prevent excessive rendering (default ~60fps).
-   *
-   * @param current - Current progress value (will be clamped to total)
-   * @param tokens - Optional custom tokens to replace in format string
+   * Update progress to a specific value and redraw the bar. Updates are
+   * throttled to prevent excessive rendering (default ~60fps).
    *
    * @example
-   * ```ts
-   * bar.update(50)
-   * bar.update(75, { status: 'Processing...' })
-   * ```
+   *   ;```ts
+   *   bar.update(50)
+   *   bar.update(75, { status: 'Processing...' })
+   *   ```
+   *
+   * @param current - Current progress value (will be clamped to total)
+   * @param tokens - Optional custom tokens to replace in format string.
    */
   update(current, tokens) {
     if (this.terminated) {
       return;
     }
-    this.current = (0, import_primordials.MathMin)(current, this.total);
-    const now = (0, import_primordials.DateNow)();
+    this.current = (0, import_math.MathMin)(current, this.total);
+    const now = (0, import_date.DateNow)();
     if (now - this.lastRender < (this.options.renderThrottle ?? 16) && this.current < this.total) {
       return;
     }
@@ -109,19 +113,20 @@ class ProgressBar {
     }
   }
   /**
-   * Increment progress by a specified amount.
-   * Convenience method for `update(current + amount)`.
+   * Increment progress by a specified amount. Convenience method for
+   * `update(current + amount)`.
+   *
+   * @example
+   *   ;```ts
+   *   bar.tick() // Increment by 1
+   *   bar.tick(5) // Increment by 5
+   *   bar.tick(1, { file: 'data.json' })
+   *   ```
    *
-   * @param amount - Amount to increment by
-   * @param tokens - Optional custom tokens to replace in format string
    * @default amount 1
    *
-   * @example
-   * ```ts
-   * bar.tick() // Increment by 1
-   * bar.tick(5) // Increment by 5
-   * bar.tick(1, { file: 'data.json' })
-   * ```
+   * @param amount - Amount to increment by.
+   * @param tokens - Optional custom tokens to replace in format string.
    */
   tick(amount = 1, tokens) {
     this.update(this.current + amount, tokens);
@@ -132,33 +137,33 @@ class ProgressBar {
   render(tokens) {
     const colorName = this.options.color ?? "cyan";
     const colorFn = import_yoctocolors_cjs.default[colorName] || ((s) => s);
-    const percent = this.total === 0 ? 0 : (0, import_primordials.MathFloor)(this.current / this.total * 100);
-    const elapsed = (0, import_primordials.DateNow)() - this.startTime;
+    const percent = this.total === 0 ? 0 : (0, import_math.MathFloor)(this.current / this.total * 100);
+    const elapsed = (0, import_date.DateNow)() - this.startTime;
     const eta = this.current === 0 ? 0 : elapsed / this.current * (this.total - this.current);
     const availableWidth = this.options.width ?? 40;
-    const filledWidth = this.total === 0 ? 0 : (0, import_primordials.MathMin)(
+    const filledWidth = this.total === 0 ? 0 : (0, import_math.MathMin)(
       availableWidth,
       Math.floor(this.current / this.total * availableWidth)
     );
-    const emptyWidth = (0, import_primordials.MathMax)(0, availableWidth - filledWidth);
-    const filled = (0, import_strings.repeatString)(this.options.complete ?? "\u2588", filledWidth);
-    const empty = (0, import_strings.repeatString)(this.options.incomplete ?? "\u2591", emptyWidth);
+    const emptyWidth = (0, import_math.MathMax)(0, availableWidth - filledWidth);
+    const filled = (0, import_format.repeatString)(this.options.complete ?? "\u2588", filledWidth);
+    const empty = (0, import_format.repeatString)(this.options.incomplete ?? "\u2591", emptyWidth);
     const bar = colorFn(filled) + empty;
     let output = this.options.format ?? ":bar :percent :current/:total";
-    output = (0, import_primordials.StringPrototypeReplace)(output, ":bar", bar);
+    output = (0, import_string.StringPrototypeReplace)(output, ":bar", bar);
     output = output.replace(":percent", `${percent}%`);
     output = output.replace(":current", String(this.current));
     output = output.replace(":total", String(this.total));
     output = output.replace(":elapsed", this.formatTime(elapsed));
     output = output.replace(":eta", this.formatTime(eta));
     if (tokens) {
-      for (const [key, value] of (0, import_primordials.ObjectEntries)(tokens)) {
+      for (const [key, value] of (0, import_object.ObjectEntries)(tokens)) {
         output = output.replace(`:${key}`, String(value));
       }
     }
     this.clearLine();
     this.stream.write(output);
-    this.lastDrawnWidth = (0, import_strings.stripAnsi)(output).length;
+    this.lastDrawnWidth = (0, import_strip.stripAnsi)(output).length;
   }
   /**
    * Clear the current line.
@@ -168,26 +173,25 @@ class ProgressBar {
       this.stream.cursorTo(0);
       this.stream.clearLine(0);
     } else if (this.lastDrawnWidth > 0) {
-      this.stream.write(`\r${(0, import_strings.repeatString)(" ", this.lastDrawnWidth)}\r`);
+      this.stream.write(`\r${(0, import_format.repeatString)(" ", this.lastDrawnWidth)}\r`);
     }
   }
   /**
    * Format time in seconds to human readable.
    */
   formatTime(ms) {
-    const seconds = (0, import_primordials.MathMax)(0, Math.round(ms / 1e3));
+    const seconds = (0, import_math.MathMax)(0, Math.round(ms / 1e3));
     if (seconds < 60) {
       return `${seconds}s`;
     }
-    const minutes = (0, import_primordials.MathFloor)(seconds / 60);
+    const minutes = (0, import_math.MathFloor)(seconds / 60);
     const remainingSeconds = seconds % 60;
     return `${minutes}m${remainingSeconds}s`;
   }
   /**
-   * Terminate the progress bar and optionally clear it.
-   * Called automatically when progress reaches 100%.
-   * If `clear` option is true, removes the bar from terminal.
-   * Otherwise, moves to next line to preserve the final state.
+   * Terminate the progress bar and optionally clear it. Called automatically
+   * when progress reaches 100%. If `clear` option is true, removes the bar from
+   * terminal. Otherwise, moves to next line to preserve the final state.
    */
   terminate() {
     if (this.terminated) {
@@ -202,7 +206,7 @@ class ProgressBar {
   }
 }
 function createProgressIndicator(current, total, label) {
-  const percent = total === 0 ? 0 : (0, import_primordials.MathFloor)(current / total * 100);
+  const percent = total === 0 ? 0 : (0, import_math.MathFloor)(current / total * 100);
   const progress = `${current}/${total}`;
   let output = "";
   if (label) {