@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/streams/transform.js

@@ -1,48 +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 transform_exports = {};
-__export(transform_exports, {
-  transform: () => transform
-});
-module.exports = __toCommonJS(transform_exports);
-var import_streaming_iterables = require("../external/streaming-iterables");
-var import_options = require("../promises/options");
-var import_retry = require("../promises/retry");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_promises_options = require('../promises/options.js');
+const require_promises_retry = require('../promises/retry.js');
+let src_external_streaming_iterables = require("../external/streaming-iterables");
+
+//#region src/streams/transform.ts
+/**
+* @file Streaming transform helper — `transform()` wraps
+*   `streaming-iterables.transform` with the project's `pRetry` per-item retry
+*   policy.
+*/
+/**
+* Transform an iterable with a function.
+*
+* @example
+*   ;```typescript
+*   const lines = ['hello', 'world']
+*   for await (const upper of transform(lines, async line => {
+*     return line.toUpperCase()
+*   })) {
+*     console.log(upper) // 'HELLO', 'WORLD'
+*   }
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function transform(iterable, func, options) {
-  const opts = (0, import_options.normalizeIterationOptions)(options);
-  const result = (0, import_streaming_iterables.transform)(
-    opts.concurrency,
-    async (item) => {
-      const result2 = await (0, import_retry.pRetry)((...args) => func(args[0]), {
-        ...opts.retries,
-        args: [item]
-      });
-      return result2;
-    },
-    iterable
-  );
-  return result;
+	const opts = /* @__PURE__ */ require_promises_options.normalizeIterationOptions(options);
+	return (0, src_external_streaming_iterables.transform)(opts.concurrency, async (item) => {
+		return await /* @__PURE__ */ require_promises_retry.pRetry((...args) => func(args[0]), {
+			...opts.retries,
+			args: [item]
+		});
+	}, iterable);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  transform
-});
+
+//#endregion
+exports.transform = transform;

package/dist/strings/format.js

@@ -1,73 +1,155 @@
 "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 format_exports = {};
-__export(format_exports, {
-  applyLinePrefix: () => applyLinePrefix,
-  centerText: () => centerText,
-  fromCharCode: () => fromCharCode,
-  indentString: () => indentString,
-  repeatString: () => repeatString
-});
-module.exports = __toCommonJS(format_exports);
-var import_strip = require("../ansi/strip");
-var import_math = require("../primordials/math");
-var import_string = require("../primordials/string");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_primordials_math = require('../primordials/math.js');
+const require_ansi_strip = require('../ansi/strip.js');
+
+//#region src/strings/format.ts
+/**
+* @file Line formatting helpers: `applyLinePrefix`, `centerText`,
+*   `indentString`, `repeatString`. Plus the `fromCharCode` re-export so
+*   callers don't have to reach into `primordials/string` for the most common
+*   use case.
+*/
 const fromCharCode = String.fromCharCode;
-// @__NO_SIDE_EFFECTS__
+/**
+* Apply a prefix to each line of a string.
+*
+* Prepends the specified prefix to the beginning of each line in the input
+* string. If the string contains newlines, the prefix is added after each
+* newline as well. When no prefix is provided or prefix is empty, returns the
+* original string unchanged.
+*
+* @example
+*   ;```ts
+*   applyLinePrefix('hello\nworld', { prefix: '> ' })
+*   // Returns: '> hello\n> world'
+*
+*   applyLinePrefix('single line', { prefix: '  ' })
+*   // Returns: '  single line'
+*
+*   applyLinePrefix('no prefix')
+*   // Returns: 'no prefix'
+*   ```
+*
+* @param str - The string to add prefixes to.
+* @param options - Configuration options.
+*
+* @returns The string with prefix applied to each line
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function applyLinePrefix(str, options) {
-  const { prefix = "" } = {
-    __proto__: null,
-    ...options
-  };
-  return prefix.length ? `${prefix}${(0, import_string.StringPrototypeIncludes)(str, "\n") ? str.replace(/\n/g, `
-${prefix}`) : str}` : str;
+	const { prefix = "" } = {
+		__proto__: null,
+		...options
+	};
+	return prefix.length ? `${prefix}${require_primordials_string.StringPrototypeIncludes(str, "\n") ? str.replace(/\n/g, `\n${prefix}`) : str}` : str;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Center text within a given width.
+*
+* Adds spaces before and after the text to center it within the specified
+* width. Distributes padding evenly on both sides. When the padding is odd, the
+* extra space is added to the right side. Strips ANSI codes before calculating
+* text length to ensure accurate centering of colored text.
+*
+* If the text is already wider than or equal to the target width, returns the
+* original text unchanged (no truncation occurs).
+*
+* @example
+*   ;```ts
+*   centerText('hello', 11)
+*   // Returns: '   hello   '
+*
+*   centerText('hi', 10)
+*   // Returns: '    hi    '
+*
+*   centerText('odd', 8)
+*   // Returns: '  odd   ' (2 left, 3 right)
+*
+*   centerText('\x1b[31mred\x1b[0m', 7)
+*   // Returns: '  \x1b[31mred\x1b[0m  '
+*
+*   centerText('too long text', 5)
+*   // Returns: 'too long text' (no truncation)
+*   ```
+*
+* @param text - The text to center (may include ANSI codes)
+* @param width - The target width in columns.
+*
+* @returns The centered text with padding
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function centerText(text, width) {
-  const textLength = (0, import_strip.stripAnsi)(text).length;
-  if (textLength >= width) {
-    return text;
-  }
-  const padding = width - textLength;
-  const leftPad = (0, import_math.MathFloor)(padding / 2);
-  const rightPad = padding - leftPad;
-  return " ".repeat(leftPad) + text + " ".repeat(rightPad);
+	const textLength = (/* @__PURE__ */ require_ansi_strip.stripAnsi(text)).length;
+	if (textLength >= width) return text;
+	const padding = width - textLength;
+	const leftPad = require_primordials_math.MathFloor(padding / 2);
+	const rightPad = padding - leftPad;
+	return " ".repeat(leftPad) + text + " ".repeat(rightPad);
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Indent each line of a string with spaces.
+*
+* Adds the specified number of spaces to the beginning of each non-empty line
+* in the input string. Empty lines (containing only whitespace) are not
+* indented. Uses a regular expression to efficiently handle multi-line
+* strings.
+*
+* @example
+*   ;```ts
+*   indentString('hello\nworld', { count: 2 })
+*   // Returns: '  hello\n  world'
+*
+*   indentString('line1\n\nline3', { count: 4 })
+*   // Returns: '    line1\n\n    line3'
+*
+*   indentString('single line')
+*   // Returns: ' single line' (default: 1 space)
+*   ```
+*
+* @param str - The string to indent.
+* @param options - Configuration options.
+*
+* @returns The indented string
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function indentString(str, options) {
-  const { count = 1 } = { __proto__: null, ...options };
-  return str.replace(/^(?!\s*$)/gm, " ".repeat(count));
+	const { count = 1 } = {
+		__proto__: null,
+		...options
+	};
+	return str.replace(/^(?!\s*$)/gm, " ".repeat(count));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Repeat a string a specified number of times.
+*
+* Creates a new string by repeating the input string `count` times. Returns an
+* empty string if count is 0 or negative.
+*
+* @example
+*   ;```ts
+*   repeatString('hello', 3) // 'hellohellohello'
+*   repeatString('x', 5) // 'xxxxx'
+*   repeatString('hello', 0) // ''
+*   repeatString('hello', -1) // ''
+*   ```
+*
+* @param str - The string to repeat.
+* @param count - The number of times to repeat the string.
+*
+* @returns The repeated string, or empty string if count <= 0
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function repeatString(str, count) {
-  if (count <= 0) {
-    return "";
-  }
-  return (0, import_string.StringPrototypeRepeat)(str, count);
+	if (count <= 0) return "";
+	return require_primordials_string.StringPrototypeRepeat(str, count);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  applyLinePrefix,
-  centerText,
-  fromCharCode,
-  indentString,
-  repeatString
-});
+
+//#endregion
+exports.applyLinePrefix = applyLinePrefix;
+exports.centerText = centerText;
+exports.fromCharCode = fromCharCode;
+exports.indentString = indentString;
+exports.repeatString = repeatString;

package/dist/strings/predicates.js

@@ -1,39 +1,61 @@
 "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 predicates_exports = {};
-__export(predicates_exports, {
-  isBlankString: () => isBlankString,
-  isNonEmptyString: () => isNonEmptyString
-});
-module.exports = __toCommonJS(predicates_exports);
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/strings/predicates.ts
+/**
+* Check if a value is a blank string (empty or only whitespace).
+*
+* A blank string is defined as a string that is either: - Completely empty
+* (length 0) - Contains only whitespace characters (spaces, tabs, newlines,
+* etc.)
+*
+* This is useful for validation when you need to ensure user input contains
+* actual content, not just whitespace.
+*
+* @example
+*   ;```ts
+*   isBlankString('') // true
+*   isBlankString('   ') // true
+*   isBlankString('\n\t  ') // true
+*   isBlankString('hello') // false
+*   isBlankString(null) // false
+*   ```
+*
+* @param value - The value to check.
+*
+* @returns `true` if the value is a blank string, `false` otherwise
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isBlankString(value) {
-  return typeof value === "string" && (!value.length || /^\s+$/.test(value));
+	return typeof value === "string" && (!value.length || /^\s+$/.test(value));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Check if a value is a non-empty string.
+*
+* Returns `true` only if the value is a string with at least one character.
+* This includes strings containing only whitespace (use `isBlankString()` if
+* you want to exclude those). Type guard ensures TypeScript knows the value is
+* a string after this check.
+*
+* @example
+*   ;```ts
+*   isNonEmptyString('hello') // true
+*   isNonEmptyString('   ') // true (contains whitespace)
+*   isNonEmptyString('') // false
+*   isNonEmptyString(null) // false
+*   isNonEmptyString(123) // false
+*   ```
+*
+* @param value - The value to check.
+*
+* @returns `true` if the value is a non-empty string, `false` otherwise
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isNonEmptyString(value) {
-  return typeof value === "string" && value.length > 0;
+	return typeof value === "string" && value.length > 0;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  isBlankString,
-  isNonEmptyString
-});
+
+//#endregion
+exports.isBlankString = isBlankString;
+exports.isNonEmptyString = isNonEmptyString;

package/dist/strings/search.js

@@ -1,45 +1,55 @@
 "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 search_exports = {};
-__export(search_exports, {
-  search: () => search
-});
-module.exports = __toCommonJS(search_exports);
-var import_math = require("../primordials/math");
-var import_string = require("../primordials/string");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_primordials_math = require('../primordials/math.js');
+
+//#region src/strings/search.ts
+/**
+* @file `search` — like `String.prototype.search` but with a configurable
+*   starting index. The native `RegExp.exec` + `lastIndex` dance handles this,
+*   but with side-effect risk on shared regexes. This wrapper offers a clean,
+*   side-effect-free version.
+*/
+/**
+* Search for a regular expression in a string starting from an index.
+*
+* Similar to `String.prototype.search()` but allows specifying a starting
+* position. Returns the index of the first match at or after `fromIndex`, or -1
+* if no match is found. Negative `fromIndex` values count back from the end of
+* the string.
+*
+* This is more efficient than using `str.slice(fromIndex).search()` when you
+* need the absolute position in the original string, as it handles the offset
+* calculation for you.
+*
+* @example
+*   ;```ts
+*   search('hello world hello', /hello/, { fromIndex: 0 }) // 0
+*   search('hello world hello', /hello/, { fromIndex: 6 }) // 12
+*   search('hello world', /goodbye/, { fromIndex: 0 }) // -1
+*   search('hello world', /hello/, { fromIndex: -5 }) // -1
+*   ```
+*
+* @param str - The string to search in.
+* @param regexp - The regular expression to search for.
+* @param options - Configuration options.
+*
+* @returns The index of the first match, or -1 if not found
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function search(str, regexp, options) {
-  const { fromIndex = 0 } = { __proto__: null, ...options };
-  const { length } = str;
-  if (fromIndex >= length) {
-    return -1;
-  }
-  if (fromIndex === 0) {
-    return (0, import_string.StringPrototypeSearch)(str, regexp);
-  }
-  const offset = fromIndex < 0 ? (0, import_math.MathMax)(length + fromIndex, 0) : fromIndex;
-  const result = (0, import_string.StringPrototypeSlice)(str, offset).search(regexp);
-  return result === -1 ? -1 : result + offset;
+	const { fromIndex = 0 } = {
+		__proto__: null,
+		...options
+	};
+	const { length } = str;
+	if (fromIndex >= length) return -1;
+	if (fromIndex === 0) return require_primordials_string.StringPrototypeSearch(str, regexp);
+	const offset = fromIndex < 0 ? require_primordials_math.MathMax(length + fromIndex, 0) : fromIndex;
+	const result = require_primordials_string.StringPrototypeSlice(str, offset).search(regexp);
+	return result === -1 ? -1 : result + offset;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  search
-});
+
+//#endregion
+exports.search = search;