@socketsecurity/lib 5.18.2 → 5.19.0

package/dist/stdio/footer.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Console footer/summary formatting utilities.
+ * Provides consistent footer and summary formatting for CLI applications.
+ */
 export interface FooterOptions {
     /**
      * Width of the footer border in characters.
@@ -90,3 +94,19 @@ export declare function createFooter(message?: string | undefined, options?: Foo
  * ```
  */
 export declare function createSummaryFooter(stats: SummaryStats, options?: FooterOptions): string;
+/**
+ * Print a footer with optional success message.
+ * Uses `─` border character for a lighter appearance.
+ * Fixed width of 55 characters to match `printHeader()`.
+ *
+ * @param message - Optional message to display (shown in green)
+ *
+ * @example
+ * ```ts
+ * printFooter('Analysis complete')
+ * // Output:
+ * // ───────────────────────────────────────────────────
+ * // Analysis complete (in green)
+ * ```
+ */
+export declare function printFooter(message?: string | undefined): void;

package/dist/stdio/footer.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -30,7 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var footer_exports = {};
 __export(footer_exports, {
   createFooter: () => createFooter,
-  createSummaryFooter: () => createSummaryFooter
+  createSummaryFooter: () => createSummaryFooter,
+  printFooter: () => printFooter
 });
 module.exports = __toCommonJS(footer_exports);
 var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
@@ -89,8 +91,16 @@ function createSummaryFooter(stats, options) {
     ...stats.duration !== void 0 && { startTime: stats.duration }
   });
 }
+function printFooter(message) {
+  const border = (0, import_strings.repeatString)("\u2500", 55);
+  console.log(border);
+  if (message) {
+    console.log(import_yoctocolors_cjs.default.green(message));
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createFooter,
-  createSummaryFooter
+  createSummaryFooter,
+  printFooter
 });

package/dist/stdio/header.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Console header/banner formatting utilities.
+ * Provides consistent header formatting for CLI applications.
+ */
 export interface HeaderOptions {
     /**
      * Width of the header in characters.
@@ -88,19 +92,3 @@ export declare function createSectionHeader(title: string, options?: HeaderOptio
  * ```
  */
 export declare function printHeader(title: string): void;
-/**
- * Print a footer with optional success message.
- * Uses `─` border character for a lighter appearance.
- * Fixed width of 55 characters to match `printHeader()`.
- *
- * @param message - Optional message to display (shown in green)
- *
- * @example
- * ```ts
- * printFooter('Analysis complete')
- * // Output:
- * // ───────────────────────────────────────────────────
- * // Analysis complete (in green)
- * ```
- */
-export declare function printFooter(message?: string | undefined): void;

package/dist/stdio/header.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -31,7 +32,6 @@ var header_exports = {};
 __export(header_exports, {
   createHeader: () => createHeader,
   createSectionHeader: () => createSectionHeader,
-  printFooter: () => printFooter,
   printHeader: () => printHeader
 });
 module.exports = __toCommonJS(header_exports);
@@ -86,17 +86,9 @@ function printHeader(title) {
   console.log(`  ${title}`);
   console.log(border);
 }
-function printFooter(message) {
-  const border = (0, import_strings.repeatString)("\u2500", 55);
-  console.log(border);
-  if (message) {
-    console.log(import_yoctocolors_cjs.default.green(message));
-  }
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createHeader,
   createSectionHeader,
-  printFooter,
   printHeader
 });

package/dist/stdio/stderr.d.ts

@@ -2,21 +2,7 @@
  * @fileoverview Standard error stream utilities.
  * Provides utilities for writing to stderr with formatting and control.
  */
-// Get the actual stderr stream
 declare const stderr: NodeJS.WriteStream;
-export declare function writeErrorLine(text?: string): void;
-/**
- * Write text to stderr without adding a newline.
- *
- * @param text - Text to write
- *
- * @example
- * ```ts
- * writeError('Downloading...')
- * // Later update progress
- * ```
- */
-export declare function writeError(text: string): void;
 /**
  * Clear the current line on stderr.
  * Only works in TTY environments.
@@ -43,21 +29,6 @@ export declare function clearLine(): void;
  * ```
  */
 export declare function cursorTo(x: number, y?: number | undefined): void;
-/**
- * Check if stderr is connected to a TTY (terminal).
- *
- * @returns `true` if stderr is a TTY, `false` if piped/redirected
- *
- * @example
- * ```ts
- * if (isTTY()) {
- *   // Show colored error messages
- * } else {
- *   // Use plain text
- * }
- * ```
- */
-export declare function isTTY(): boolean;
 /**
  * Get the number of columns (width) in the terminal.
  *
@@ -85,22 +56,32 @@ export declare function getColumns(): number;
  */
 export declare function getRows(): number;
 /**
- * Write a formatted warning message to stderr.
+ * Check if stderr is connected to a TTY (terminal).
  *
- * @param message - Warning message text
- * @param prefix - Prefix label for the warning
- * @default prefix 'Warning'
+ * @returns `true` if stderr is a TTY, `false` if piped/redirected
  *
  * @example
  * ```ts
- * writeWarning('Deprecated API usage')
- * // Output: 'Warning: Deprecated API usage'
+ * if (isTTY()) {
+ *   // Show colored error messages
+ * } else {
+ *   // Use plain text
+ * }
+ * ```
+ */
+export declare function isTTY(): boolean;
+/**
+ * Write text to stderr without adding a newline.
  *
- * writeWarning('Invalid config', 'Config')
- * // Output: 'Config: Invalid config'
+ * @param text - Text to write
+ *
+ * @example
+ * ```ts
+ * writeError('Downloading...')
+ * // Later update progress
  * ```
  */
-export declare function writeWarning(message: string, prefix?: string): void;
+export declare function writeError(text: string): void;
 /**
  * Write a formatted error message to stderr.
  *
@@ -118,6 +99,21 @@ export declare function writeWarning(message: string, prefix?: string): void;
  * ```
  */
 export declare function writeErrorFormatted(message: string, prefix?: string): void;
+/**
+ * Write a line to stderr with trailing newline.
+ * Used for error messages, warnings, and diagnostic output.
+ * Passing no argument writes an empty line.
+ *
+ * @param text - Text to write (defaults to the empty string)
+ * @default text ''
+ *
+ * @example
+ * ```ts
+ * writeErrorLine('Error: File not found')
+ * writeErrorLine() // Write empty line
+ * ```
+ */
+export declare function writeErrorLine(text?: string): void;
 /**
  * Write an error's stack trace to stderr.
  * Falls back to formatted error message if no stack is available.
@@ -134,5 +130,21 @@ export declare function writeErrorFormatted(message: string, prefix?: string): v
  * ```
  */
 export declare function writeStackTrace(error: Error): void;
-// Export the raw stream for advanced usage
+/**
+ * Write a formatted warning message to stderr.
+ *
+ * @param message - Warning message text
+ * @param prefix - Prefix label for the warning
+ * @default prefix 'Warning'
+ *
+ * @example
+ * ```ts
+ * writeWarning('Deprecated API usage')
+ * // Output: 'Warning: Deprecated API usage'
+ *
+ * writeWarning('Invalid config', 'Config')
+ * // Output: 'Config: Invalid config'
+ * ```
+ */
+export declare function writeWarning(message: string, prefix?: string): void;
 export { stderr };

package/dist/stdio/stderr.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -43,42 +44,34 @@ __export(stderr_exports, {
 });
 module.exports = __toCommonJS(stderr_exports);
 var import_node_process = __toESM(require("node:process"));
+var import_stream = require("./_stream");
 const stderr = import_node_process.default.stderr;
-function writeErrorLine(text = "") {
-  stderr.write(`${text}
-`);
-}
-function writeError(text) {
-  stderr.write(text);
-}
 function clearLine() {
-  if (stderr.isTTY) {
-    stderr.cursorTo(0);
-    stderr.clearLine(0);
-  }
+  (0, import_stream.clearLineOn)(stderr);
 }
 function cursorTo(x, y) {
-  if (stderr.isTTY) {
-    stderr.cursorTo(x, y);
-  }
-}
-function isTTY() {
-  return stderr.isTTY || false;
+  (0, import_stream.cursorToOn)(stderr, x, y);
 }
 function getColumns() {
-  return stderr.columns || 80;
+  return (0, import_stream.getColumnsOf)(stderr);
 }
 function getRows() {
-  return stderr.rows || 24;
+  return (0, import_stream.getRowsOf)(stderr);
 }
-function writeWarning(message, prefix = "Warning") {
-  const formatted = `${prefix}: ${message}`;
-  writeErrorLine(formatted);
+function isTTY() {
+  return (0, import_stream.isTTYOf)(stderr);
+}
+function writeError(text) {
+  stderr.write(text);
 }
 function writeErrorFormatted(message, prefix = "Error") {
   const formatted = `${prefix}: ${message}`;
   writeErrorLine(formatted);
 }
+function writeErrorLine(text = "") {
+  stderr.write(`${text}
+`);
+}
 function writeStackTrace(error) {
   if (error.stack) {
     writeErrorLine(error.stack);
@@ -86,6 +79,10 @@ function writeStackTrace(error) {
     writeErrorFormatted(error.message);
   }
 }
+function writeWarning(message, prefix = "Warning") {
+  const formatted = `${prefix}: ${message}`;
+  writeErrorLine(formatted);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clearLine,

package/dist/stdio/stdout.d.ts

@@ -1,42 +1,31 @@
-// Get the actual stdout stream
-declare const stdout: NodeJS.WriteStream;
 /**
- * Write a line to stdout with trailing newline.
- *
- * @param text - Text to write
- * @default text ''
- *
- * @example
- * ```ts
- * writeLine('Hello, world!')
- * writeLine() // Write empty line
- * ```
+ * @fileoverview Standard output stream utilities.
+ * Provides utilities for writing to stdout with formatting and control.
  */
-export declare function writeLine(text?: string): void;
+declare const stdout: NodeJS.WriteStream;
 /**
- * Write text to stdout without adding a newline.
- *
- * @param text - Text to write
+ * Clear the current line on stdout.
+ * Only works in TTY environments.
  *
  * @example
  * ```ts
- * write('Loading...')
- * // Later: clear and update
+ * write('Processing...')
+ * clearLine()
+ * write('Done!')
  * ```
  */
-export declare function write(text: string): void;
+export declare function clearLine(): void;
 /**
- * Clear the current line on stdout.
+ * Clear screen from cursor position down to bottom.
  * Only works in TTY environments.
  *
  * @example
  * ```ts
- * write('Processing...')
- * clearLine()
- * write('Done!')
+ * cursorTo(0, 5)
+ * clearScreenDown() // Clear from row 5 to bottom
  * ```
  */
-export declare function clearLine(): void;
+export declare function clearScreenDown(): void;
 /**
  * Move cursor to specific position on stdout.
  * Only works in TTY environments.
@@ -52,31 +41,18 @@ export declare function clearLine(): void;
  */
 export declare function cursorTo(x: number, y?: number | undefined): void;
 /**
- * Clear screen from cursor position down to bottom.
- * Only works in TTY environments.
- *
- * @example
- * ```ts
- * cursorTo(0, 5)
- * clearScreenDown() // Clear from row 5 to bottom
- * ```
- */
-export declare function clearScreenDown(): void;
-/**
- * Check if stdout is connected to a TTY (terminal).
- *
- * @returns `true` if stdout is a TTY, `false` if piped/redirected
+ * Register handlers to ensure cursor is shown on process exit.
+ * Prevents hidden cursor after abnormal termination.
+ * Handles SIGINT (Ctrl+C) and SIGTERM signals.
  *
  * @example
  * ```ts
- * if (isTTY()) {
- *   // Show interactive UI
- * } else {
- *   // Use simple text output
- * }
+ * ensureCursorOnExit()
+ * hideCursor()
+ * // Even if process crashes, cursor will be restored
  * ```
  */
-export declare function isTTY(): boolean;
+export declare function ensureCursorOnExit(): void;
 /**
  * Get the number of columns (width) in the terminal.
  *
@@ -115,6 +91,21 @@ export declare function getRows(): number;
  * ```
  */
 export declare function hideCursor(): void;
+/**
+ * Check if stdout is connected to a TTY (terminal).
+ *
+ * @returns `true` if stdout is a TTY, `false` if piped/redirected
+ *
+ * @example
+ * ```ts
+ * if (isTTY()) {
+ *   // Show interactive UI
+ * } else {
+ *   // Use simple text output
+ * }
+ * ```
+ */
+export declare function isTTY(): boolean;
 /**
  * Show the cursor on stdout.
  * Should be called after `hideCursor()`.
@@ -128,17 +119,28 @@ export declare function hideCursor(): void;
  */
 export declare function showCursor(): void;
 /**
- * Register handlers to ensure cursor is shown on process exit.
- * Prevents hidden cursor after abnormal termination.
- * Handles SIGINT (Ctrl+C) and SIGTERM signals.
+ * Write text to stdout without adding a newline.
+ *
+ * @param text - Text to write
  *
  * @example
  * ```ts
- * ensureCursorOnExit()
- * hideCursor()
- * // Even if process crashes, cursor will be restored
+ * write('Loading...')
+ * // Later: clear and update
  * ```
  */
-export declare function ensureCursorOnExit(): void;
-// Export the raw stream for advanced usage
+export declare function write(text: string): void;
+/**
+ * Write a line to stdout with trailing newline.
+ *
+ * @param text - Text to write
+ * @default text ''
+ *
+ * @example
+ * ```ts
+ * writeLine('Hello, world!')
+ * writeLine() // Write empty line
+ * ```
+ */
+export declare function writeLine(text?: string): void;
 export { stdout };

package/dist/stdio/stdout.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -44,60 +45,61 @@ __export(stdout_exports, {
 });
 module.exports = __toCommonJS(stdout_exports);
 var import_node_process = __toESM(require("node:process"));
-var import_tty = require("tty");
+var import_node_tty = require("node:tty");
+var import_stream = require("./_stream");
 const stdout = import_node_process.default.stdout;
-function writeLine(text = "") {
-  stdout.write(`${text}
-`);
-}
-function write(text) {
-  stdout.write(text);
-}
+let _cursorExitRegistered = false;
 function clearLine() {
-  if (stdout.isTTY) {
-    stdout.cursorTo(0);
-    stdout.clearLine(0);
-  }
-}
-function cursorTo(x, y) {
-  if (stdout.isTTY) {
-    stdout.cursorTo(x, y);
-  }
+  (0, import_stream.clearLineOn)(stdout);
 }
 function clearScreenDown() {
   if (stdout.isTTY) {
     stdout.clearScreenDown();
   }
 }
-function isTTY() {
-  return stdout.isTTY || false;
+function cursorTo(x, y) {
+  (0, import_stream.cursorToOn)(stdout, x, y);
+}
+function ensureCursorOnExit() {
+  if (_cursorExitRegistered) {
+    return;
+  }
+  _cursorExitRegistered = true;
+  import_node_process.default.on("exit", showCursor);
+  import_node_process.default.on("SIGINT", () => {
+    showCursor();
+    import_node_process.default.exit(130);
+  });
+  import_node_process.default.on("SIGTERM", () => {
+    showCursor();
+    import_node_process.default.exit(143);
+  });
 }
 function getColumns() {
-  return stdout.columns || 80;
+  return (0, import_stream.getColumnsOf)(stdout);
 }
 function getRows() {
-  return stdout.rows || 24;
+  return (0, import_stream.getRowsOf)(stdout);
 }
 function hideCursor() {
-  if (stdout.isTTY && stdout instanceof import_tty.WriteStream) {
+  if (stdout.isTTY && stdout instanceof import_node_tty.WriteStream) {
     stdout.write("\x1B[?25l");
   }
 }
+function isTTY() {
+  return (0, import_stream.isTTYOf)(stdout);
+}
 function showCursor() {
-  if (stdout.isTTY && stdout instanceof import_tty.WriteStream) {
+  if (stdout.isTTY && stdout instanceof import_node_tty.WriteStream) {
     stdout.write("\x1B[?25h");
   }
 }
-function ensureCursorOnExit() {
-  import_node_process.default.on("exit", showCursor);
-  import_node_process.default.on("SIGINT", () => {
-    showCursor();
-    import_node_process.default.exit(130);
-  });
-  import_node_process.default.on("SIGTERM", () => {
-    showCursor();
-    import_node_process.default.exit(143);
-  });
+function write(text) {
+  stdout.write(text);
+}
+function writeLine(text = "") {
+  stdout.write(`${text}
+`);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/streams.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Stream processing utilities with streaming-iterables integration.
+ * Provides async stream handling and transformation functions.
+ */
 import type { IterationOptions } from './promises';
 /**
  * Execute a function for each item in an iterable in parallel.
@@ -10,7 +14,6 @@ import type { IterationOptions } from './promises';
  * }, { concurrency: 4 })
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function parallelEach<T>(iterable: Iterable<T> | AsyncIterable<T>, func: (item: T) => Promise<unknown>, options?: number | IterationOptions): Promise<void>;
 /**
  * Map over an iterable in parallel with concurrency control.
@@ -25,7 +28,6 @@ export declare function parallelEach<T>(iterable: Iterable<T> | AsyncIterable<T>
  * }
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function parallelMap<T, U>(iterable: Iterable<T> | AsyncIterable<T>, func: (item: T) => Promise<U>, options?: number | IterationOptions): AsyncIterable<U>;
 /**
  * Transform an iterable with a function.
@@ -40,5 +42,4 @@ export declare function parallelMap<T, U>(iterable: Iterable<T> | AsyncIterable<
  * }
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function transform<T, U>(iterable: Iterable<T> | AsyncIterable<T>, func: (item: T) => Promise<U>, options?: number | IterationOptions): AsyncIterable<U>;

package/dist/streams.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;