@socketsecurity/lib 5.18.2 → 5.19.1

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;

package/dist/strings.d.ts

@@ -3,12 +3,7 @@
  * Provides string processing, prefix application, and terminal output utilities.
  */
 import { ansiRegex, stripAnsi } from './ansi';
-// Import get-east-asian-width from external wrapper.
-// This library implements Unicode Standard Annex #11 (East Asian Width).
-// https://www.unicode.org/reports/tr11/
-// Re-export ANSI utilities for backward compatibility.
 export { ansiRegex, stripAnsi };
-// Type definitions
 declare const BlankStringBrand: unique symbol;
 export type BlankString = string & {
     [BlankStringBrand]: true;
@@ -17,10 +12,6 @@ declare const EmptyStringBrand: unique symbol;
 export type EmptyString = string & {
     [EmptyStringBrand]: true;
 };
-// IMPORTANT: Do not use destructuring here - use direct assignment instead.
-// tsgo has a bug that incorrectly transpiles destructured exports, resulting in
-// `exports.SomeName = void 0;` which causes runtime errors.
-// See: https://github.com/SocketDev/socket-packageurl-js/issues/3
 export declare const fromCharCode: (...codes: number[]) => string;
 export interface ApplyLinePrefixOptions {
     /**
@@ -52,39 +43,7 @@ export interface ApplyLinePrefixOptions {
  * // Returns: 'no prefix'
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function applyLinePrefix(str: string, options?: ApplyLinePrefixOptions | undefined): string;
-/**
- * Convert a camelCase string to kebab-case.
- *
- * Transforms camelCase strings by converting uppercase letters to lowercase
- * and inserting hyphens before uppercase sequences. Handles consecutive
- * uppercase letters (like "XMLHttpRequest") by treating them as a single word.
- * Returns empty string for empty input.
- *
- * Note: This function only handles camelCase. For mixed formats including
- * snake_case, use `toKebabCase()` instead.
- *
- * @param str - The camelCase string to convert
- * @returns The kebab-case string
- *
- * @example
- * ```ts
- * camelToKebab('helloWorld')
- * // Returns: 'hello-world'
- *
- * camelToKebab('XMLHttpRequest')
- * // Returns: 'xmlhttprequest'
- *
- * camelToKebab('iOS')
- * // Returns: 'ios'
- *
- * camelToKebab('')
- * // Returns: ''
- * ```
- */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function camelToKebab(str: string): string;
 /**
  * Center text within a given width.
  *
@@ -118,7 +77,6 @@ export declare function camelToKebab(str: string): string;
  * // Returns: 'too long text' (no truncation, returned as-is)
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function centerText(text: string, width: number): string;
 export interface IndentStringOptions {
     /**
@@ -150,7 +108,6 @@ export interface IndentStringOptions {
  * // Returns: ' single line' (default: 1 space)
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function indentString(str: string, options?: IndentStringOptions | undefined): string;
 /**
  * Check if a value is a blank string (empty or only whitespace).
@@ -183,7 +140,6 @@ export declare function indentString(str: string, options?: IndentStringOptions
  * // Returns: false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function isBlankString(value: unknown): value is BlankString;
 /**
  * Check if a value is a non-empty string.
@@ -214,7 +170,6 @@ export declare function isBlankString(value: unknown): value is BlankString;
  * // Returns: false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function isNonEmptyString(value: unknown): value is Exclude<string, EmptyString>;
 /**
  * Repeat a string a specified number of times.
@@ -241,7 +196,6 @@ export declare function isNonEmptyString(value: unknown): value is Exclude<strin
  * // Returns: ''
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function repeatString(str: string, count: number): string;
 export interface SearchOptions {
     /**
@@ -283,38 +237,7 @@ export interface SearchOptions {
  * // Returns: -1 (starts searching from 'world', no match)
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function search(str: string, regexp: RegExp, options?: SearchOptions | undefined): number;
-/**
- * Strip the Byte Order Mark (BOM) from the beginning of a string.
- *
- * The BOM (U+FEFF) is a Unicode character that can appear at the start of
- * a text file to indicate byte order and encoding. In UTF-16 (JavaScript's
- * internal string representation), it appears as 0xFEFF. This function
- * removes it if present, leaving the rest of the string unchanged.
- *
- * Most text processing doesn't need to handle the BOM explicitly, but it
- * can cause issues when parsing JSON, CSV, or other structured data formats
- * that don't expect a leading invisible character.
- *
- * @param str - The string to strip BOM from
- * @returns The string without BOM
- *
- * @example
- * ```ts
- * stripBom('\uFEFFhello world')
- * // Returns: 'hello world'
- *
- * stripBom('hello world')
- * // Returns: 'hello world' (no BOM to strip)
- *
- * stripBom('')
- * // Returns: ''
- * ```
- */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function stripBom(str: string): string;
-/* c8 ignore stop */
 /**
  * Get the visual width of a string in terminal columns.
  *
@@ -392,11 +315,36 @@ export declare function stripBom(str: string): string;
  * stringWidth('')
  * // Returns: 0
  * ```
- *
- * @throws {TypeError} When input is not a string
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function stringWidth(text: string): number;
+/**
+ * Strip the Byte Order Mark (BOM) from the beginning of a string.
+ *
+ * The BOM (U+FEFF) is a Unicode character that can appear at the start of
+ * a text file to indicate byte order and encoding. In UTF-16 (JavaScript's
+ * internal string representation), it appears as 0xFEFF. This function
+ * removes it if present, leaving the rest of the string unchanged.
+ *
+ * Most text processing doesn't need to handle the BOM explicitly, but it
+ * can cause issues when parsing JSON, CSV, or other structured data formats
+ * that don't expect a leading invisible character.
+ *
+ * @param str - The string to strip BOM from
+ * @returns The string without BOM
+ *
+ * @example
+ * ```ts
+ * stripBom('\uFEFFhello world')
+ * // Returns: 'hello world'
+ *
+ * stripBom('hello world')
+ * // Returns: 'hello world' (no BOM to strip)
+ *
+ * stripBom('')
+ * // Returns: ''
+ * ```
+ */
+export declare function stripBom(str: string): string;
 /**
  * Convert a string to kebab-case (handles camelCase and snake_case).
  *
@@ -405,8 +353,8 @@ export declare function stringWidth(text: string): number;
  * - Inserting hyphens before uppercase letters (for camelCase)
  * - Replacing underscores with hyphens (for snake_case)
  *
- * This is more comprehensive than `camelToKebab()` as it handles mixed
- * formats including snake_case. Returns empty string for empty input.
+ * Handles mixed formats (camelCase, snake_case, acronyms) in one pass.
+ * Returns empty string for empty input.
  *
  * @param str - The string to convert
  * @returns The kebab-case string
@@ -423,13 +371,12 @@ export declare function stringWidth(text: string): number;
  * // Returns: 'xmlhttp-request'
  *
  * toKebabCase('iOS_Version')
- * // Returns: 'io-s-version'
+ * // Returns: 'i-os-version'
  *
  * toKebabCase('')
  * // Returns: ''
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function toKebabCase(str: string): string;
 /**
  * Trim newlines from the beginning and end of a string.
@@ -464,5 +411,4 @@ export declare function toKebabCase(str: string): string;
  * // Returns: 'hello'
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function trimNewlines(str: string): string;

package/dist/strings.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;
@@ -21,7 +22,6 @@ var strings_exports = {};
 __export(strings_exports, {
   ansiRegex: () => import_ansi.ansiRegex,
   applyLinePrefix: () => applyLinePrefix,
-  camelToKebab: () => camelToKebab,
   centerText: () => centerText,
   fromCharCode: () => fromCharCode,
   indentString: () => indentString,
@@ -56,49 +56,6 @@ function applyLinePrefix(str, options) {
 ${prefix}`) : str}` : str;
 }
 // @__NO_SIDE_EFFECTS__
-function camelToKebab(str) {
-  const { length } = str;
-  if (!length) {
-    return "";
-  }
-  let result = "";
-  let i = 0;
-  while (i < length) {
-    const char = str[i];
-    if (!char) {
-      break;
-    }
-    const charCode = char.charCodeAt(0);
-    const isUpperCase = charCode >= 65 && charCode <= 90;
-    if (isUpperCase) {
-      if (result.length > 0) {
-        result += "-";
-      }
-      while (i < length) {
-        const currChar = str[i];
-        if (!currChar) {
-          break;
-        }
-        const currCharCode = currChar.charCodeAt(0);
-        const isCurrUpper = currCharCode >= 65 && currCharCode <= 90;
-        if (isCurrUpper) {
-          result += fromCharCode(
-            currCharCode + 32
-            /*'a'-'A'*/
-          );
-          i += 1;
-        } else {
-          break;
-        }
-      }
-    } else {
-      result += char;
-      i += 1;
-    }
-  }
-  return result;
-}
-// @__NO_SIDE_EFFECTS__
 function centerText(text, width) {
   const textLength = (0, import_ansi.stripAnsi)(text).length;
   if (textLength >= width) {
@@ -143,10 +100,6 @@ function search(str, regexp, options) {
   const result = str.slice(offset).search(regexp);
   return result === -1 ? -1 : result + offset;
 }
-// @__NO_SIDE_EFFECTS__
-function stripBom(str) {
-  return str.length > 0 && str.charCodeAt(0) === 65279 ? str.slice(1) : str;
-}
 const segmenter = new Intl.Segmenter();
 let zeroWidthClusterRegex;
 let leadingNonPrintingRegex;
@@ -201,6 +154,10 @@ function stringWidth(text) {
   return width;
 }
 // @__NO_SIDE_EFFECTS__
+function stripBom(str) {
+  return str.length > 0 && str.charCodeAt(0) === 65279 ? str.slice(1) : str;
+}
+// @__NO_SIDE_EFFECTS__
 function toKebabCase(str) {
   if (!str.length) {
     return str;
@@ -245,7 +202,6 @@ function trimNewlines(str) {
 0 && (module.exports = {
   ansiRegex,
   applyLinePrefix,
-  camelToKebab,
   centerText,
   fromCharCode,
   indentString,

package/dist/suppress-warnings.d.ts

@@ -1,15 +1,18 @@
-export declare function suppressMaxListenersWarning(): void;
 /**
- * Suppress all process warnings of a specific type.
- *
- * @param warningType - The warning type to suppress (e.g., 'DeprecationWarning', 'ExperimentalWarning')
+ * @fileoverview Utilities to suppress specific process warnings.
+ */
+/**
+ * Restore the original process.emitWarning function.
+ * Call this to re-enable all warnings after suppressing them.
  *
  * @example
- * import { suppressWarningType } from '@socketsecurity/lib/suppress-warnings'
- *
- * suppressWarningType('ExperimentalWarning')
+ * ```typescript
+ * suppressMaxListenersWarning()
+ * // ... do work ...
+ * restoreWarnings() // Re-enable all warnings
+ * ```
  */
-export declare function suppressWarningType(warningType: string): void;
+export declare function restoreWarnings(): void;
 /**
  * Set max listeners on an EventTarget (like AbortSignal) to avoid TypeError.
  *
@@ -35,17 +38,31 @@ export declare function suppressWarningType(warningType: string): void;
  */
 export declare function setMaxEventTargetListeners(target: EventTarget | AbortSignal | undefined, maxListeners?: number): void;
 /**
- * Restore the original process.emitWarning function.
- * Call this to re-enable all warnings after suppressing them.
+ * Suppress MaxListenersExceededWarning messages.
+ * This is useful in tests or scripts where multiple listeners are expected.
  *
  * @example
- * ```typescript
+ * import { suppressMaxListenersWarning } from '@socketsecurity/lib/suppress-warnings'
+ *
  * suppressMaxListenersWarning()
- * // ... do work ...
- * restoreWarnings() // Re-enable all warnings
- * ```
  */
-export declare function restoreWarnings(): void;
+/**
+ * Silence `MaxListenersExceededWarning` messages from `process.emitWarning`.
+ * Installs a single shared wrapper around `process.emitWarning` on first call
+ * so repeat invocations are cheap.
+ */
+export declare function suppressMaxListenersWarning(): void;
+/**
+ * Suppress all process warnings of a specific type.
+ *
+ * @param warningType - The warning type to suppress (e.g., 'DeprecationWarning', 'ExperimentalWarning')
+ *
+ * @example
+ * import { suppressWarningType } from '@socketsecurity/lib/suppress-warnings'
+ *
+ * suppressWarningType('ExperimentalWarning')
+ */
+export declare function suppressWarningType(warningType: string): void;
 /**
  * Suppress warnings temporarily within a callback.
  *