@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/regexps/escape.js

@@ -1,32 +1,34 @@
 "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 escape_exports = {};
-__export(escape_exports, {
-  escapeRegExp: () => escapeRegExp
-});
-module.exports = __toCommonJS(escape_exports);
-var import_spec = require("./spec");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_regexps_spec = require('./spec.js');
+
+//#region src/regexps/escape.ts
+/**
+* @file Public `escapeRegExp` entry — binds to native `RegExp.escape` (TC39
+*   Stage 4, Node 24+ / V8 13.7) when available, otherwise falls back to the
+*   spec-compliant implementation in `./spec`.
+*/
+/**
+* Escape special characters in a string so the result can be safely
+* concatenated into any regular-expression Pattern position without altering
+* the meaning of surrounding syntax.
+*
+* Bound to native `RegExp.escape` when available (TC39 Stage 4, Node 24+ / V8
+* 13.7); otherwise falls back to a spec-compliant implementation. Both paths
+* satisfy the spec guarantee: `new RegExp(escapeRegExp(s))` matches exactly the
+* literal string `s`.
+*
+* Reference: https://tc39.es/ecma262/#sec-regexp.escape.
+*
+* @example
+*   ;```typescript
+*   new RegExp(escapeRegExp('[test]')) // matches literal '[test]'
+*   new RegExp('[' + escapeRegExp('a-z') + ']') // matches 'a', '-', or 'z'
+*   ```
+*/
 const maybeNativeEscape = RegExp.escape;
-const escapeRegExp = typeof maybeNativeEscape === "function" ? maybeNativeEscape : import_spec.escapeRegExpFallback;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  escapeRegExp
-});
+const escapeRegExp = typeof maybeNativeEscape === "function" ? maybeNativeEscape : require_regexps_spec.escapeRegExpFallback;
+
+//#endregion
+exports.escapeRegExp = escapeRegExp;

package/dist/regexps/hex.js

@@ -1,38 +1,21 @@
 "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 hex_exports = {};
-__export(hex_exports, {
-  hex2: () => hex2,
-  hex4: () => hex4
-});
-module.exports = __toCommonJS(hex_exports);
-var import_number = require("../primordials/number");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_number = require('../primordials/number.js');
+
+//#region src/regexps/hex.ts
+/**
+* @file Hex-encoding helpers — fixed-width `\xHH` (`hex2`) and `\uHHHH`
+*   (`hex4`) producers used by the spec-compliant `RegExp.escape` fallback to
+*   emit canonical escape sequences.
+*/
 function hex2(n) {
-  return (0, import_number.NumberPrototypeToString)(n, 16).padStart(2, "0");
+	return require_primordials_number.NumberPrototypeToString(n, 16).padStart(2, "0");
 }
 function hex4(n) {
-  return (0, import_number.NumberPrototypeToString)(n, 16).padStart(4, "0");
+	return require_primordials_number.NumberPrototypeToString(n, 16).padStart(4, "0");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  hex2,
-  hex4
-});
+
+//#endregion
+exports.hex2 = hex2;
+exports.hex4 = hex4;

package/dist/regexps/spec.js

@@ -1,87 +1,59 @@
 "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 spec_exports = {};
-__export(spec_exports, {
-  escapeRegExpFallback: () => escapeRegExpFallback,
-  isSpecHexEscapeCp: () => isSpecHexEscapeCp
-});
-module.exports = __toCommonJS(spec_exports);
-var import_map_set = require("../primordials/map-set");
-var import_string = require("../primordials/string");
-var import_hex = require("./hex");
-const SYNTAX_CHARACTERS = new import_map_set.SetCtor("^$\\.*+?()[]{}|/");
-const CONTROL_ESCAPES = new import_map_set.MapCtor([
-  [9, "\\t"],
-  [10, "\\n"],
-  [11, "\\v"],
-  [12, "\\f"],
-  [13, "\\r"]
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_primordials_map_set = require('../primordials/map-set.js');
+const require_regexps_hex = require('./hex.js');
+
+//#region src/regexps/spec.ts
+/**
+* @file Spec-compliant fallback for the TC39 `RegExp.escape`
+*   (https://tc39.es/ecma262/#sec-regexp.escape). Implements
+*   `escapeRegExpFallback` plus the `isSpecHexEscapeCp` classifier used by both
+*   the fallback and downstream callers. The fallback handles every branch of
+*   the spec `EncodeForRegExpEscape` algorithm: leading [0-9A-Za-z] are always
+*   `\xHH`-escaped (guards against `\0..\9` / `\c` merging in a larger
+*   pattern), syntax characters (and `/`) get a plain backslash prefix, the
+*   `ControlEscape` set maps to its `\t \n \v \f \r` names, the other
+*   punctuators and the whitespace / line-terminator / lone-surrogate code
+*   points route through `\xHH` or `\uHHHH`. Every other code point is emitted
+*   verbatim.
+*/
+const SYNTAX_CHARACTERS = new require_primordials_map_set.SetCtor("^$\\.*+?()[]{}|/");
+const CONTROL_ESCAPES = new require_primordials_map_set.MapCtor([
+	[9, "\\t"],
+	[10, "\\n"],
+	[11, "\\v"],
+	[12, "\\f"],
+	[13, "\\r"]
 ]);
-const OTHER_PUNCTUATORS = new import_map_set.SetCtor(",-=<>#&!%:;@~'`\"");
+const OTHER_PUNCTUATORS = new require_primordials_map_set.SetCtor(",-=<>#&!%:;@~'`\"");
 function escapeRegExpFallback(str) {
-  let out = "";
-  let isFirst = true;
-  for (const char of str) {
-    const cp = (0, import_string.StringPrototypeCodePointAt)(char, 0);
-    if (isFirst && (cp >= 48 && cp <= 57 || cp >= 65 && cp <= 90 || cp >= 97 && cp <= 122)) {
-      out += "\\x" + (0, import_hex.hex2)(cp);
-    } else if (SYNTAX_CHARACTERS.has(char)) {
-      out += "\\" + char;
-    } else {
-      const ctrl = CONTROL_ESCAPES.get(cp);
-      if (ctrl !== void 0) {
-        out += ctrl;
-      } else if (isSpecHexEscapeCp(cp)) {
-        if (cp <= 255) {
-          out += "\\x" + (0, import_hex.hex2)(cp);
-        } else {
-          for (let i = 0; i < char.length; i++) {
-            out += "\\u" + (0, import_hex.hex4)((0, import_string.StringPrototypeCharCodeAt)(char, i));
-          }
-        }
-      } else {
-        out += char;
-      }
-    }
-    isFirst = false;
-  }
-  return out;
+	let out = "";
+	let isFirst = true;
+	for (const char of str) {
+		const cp = require_primordials_string.StringPrototypeCodePointAt(char, 0);
+		if (isFirst && (cp >= 48 && cp <= 57 || cp >= 65 && cp <= 90 || cp >= 97 && cp <= 122)) out += "\\x" + require_regexps_hex.hex2(cp);
+		else if (SYNTAX_CHARACTERS.has(char)) out += "\\" + char;
+		else {
+			const ctrl = CONTROL_ESCAPES.get(cp);
+			if (ctrl !== void 0) out += ctrl;
+			else if (isSpecHexEscapeCp(cp)) if (cp <= 255) out += "\\x" + require_regexps_hex.hex2(cp);
+			else for (let i = 0; i < char.length; i++) out += "\\u" + require_regexps_hex.hex4(require_primordials_string.StringPrototypeCharCodeAt(char, i));
+			else out += char;
+		}
+		isFirst = false;
+	}
+	return out;
 }
 function isSpecHexEscapeCp(cp) {
-  if (OTHER_PUNCTUATORS.has((0, import_string.StringFromCodePoint)(cp))) {
-    return true;
-  }
-  if (cp === 10 || cp === 13 || cp === 8232 || cp === 8233) {
-    return true;
-  }
-  if (cp === 9 || cp === 11 || cp === 12 || cp === 32 || cp === 160 || cp === 65279) {
-    return true;
-  }
-  if (cp >= 55296 && cp <= 57343) {
-    return true;
-  }
-  return false;
+	if (OTHER_PUNCTUATORS.has(require_primordials_string.StringFromCodePoint(cp))) return true;
+	if (cp === 10 || cp === 13 || cp === 8232 || cp === 8233) return true;
+	if (cp === 9 || cp === 11 || cp === 12 || cp === 32 || cp === 160 || cp === 65279) return true;
+	if (cp >= 55296 && cp <= 57343) return true;
+	return false;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  escapeRegExpFallback,
-  isSpecHexEscapeCp
-});
+
+//#endregion
+exports.escapeRegExpFallback = escapeRegExpFallback;
+exports.isSpecHexEscapeCp = isSpecHexEscapeCp;

package/dist/releases/github-archives.js

@@ -1,122 +1,131 @@
 "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 github_archives_exports = {};
-__export(github_archives_exports, {
-  downloadAndExtractArchive: () => downloadAndExtractArchive,
-  downloadAndExtractZip: () => downloadAndExtractZip
-});
-module.exports = __toCommonJS(github_archives_exports);
-var import_detect = require("../archives/detect");
-var import_extract = require("../archives/extract");
-var import_safe = require("../fs/safe");
-var import_default = require("../logger/default");
-var import_error = require("../primordials/error");
-var import_github_downloads = require("./github-downloads");
-var import_path = require("../node/path");
-const logger = (0, import_default.getDefaultLogger)();
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_error = require('../primordials/error.js');
+const require_node_path = require('../node/path.js');
+const require_logger_default = require('../logger/default.js');
+const require_archives_detect = require('../archives/detect.js');
+const require_fs_safe = require('../fs/safe.js');
+const require_archives_extract = require('../archives/extract.js');
+const require_releases_github_downloads = require('./github-downloads.js');
+
+//#region src/releases/github-archives.ts
+/**
+* @file GitHub release archive download + extraction.
+*/
+const logger = require_logger_default.getDefaultLogger();
+/**
+* Download and extract an archive from a GitHub release. Supports zip, tar,
+* tar.gz, and tgz formats. Automatically handles downloading, extracting, and
+* cleanup.
+*
+* @example
+*   ;```typescript
+*   const outputDir = await downloadAndExtractArchive(
+*     'v1.0.0',
+*     'data-*.tar.gz',
+*     '/tmp/data',
+*     { owner: 'SocketDev', repo: 'socket-btm' },
+*   )
+*   ```
+*
+* @param tag - Release tag name.
+* @param assetPattern - Asset name or pattern (glob string, prefix/suffix
+*   object, or RegExp)
+* @param outputDir - Directory to extract the archive contents to.
+* @param repoConfig - Repository configuration (owner/repo)
+* @param options - Additional options.
+* @param options.quiet - Suppress log messages.
+* @param options.cleanup - Remove downloaded archive after extraction (default:
+*   true)
+* @param options.strip - Strip leading path components (like tar
+*   --strip-components)
+* @param options.format - Archive format (auto-detected if not specified)
+*
+* @returns Path to the extraction directory
+*/
 async function downloadAndExtractArchive(tag, assetPattern, outputDir, repoConfig, options = { __proto__: null }) {
-  const { cleanup = true, format, quiet = false, strip } = options;
-  const path = (0, import_path.getNodePath)();
-  await (0, import_safe.safeMkdir)(outputDir);
-  let ext = ".archive";
-  if (format) {
-    ext = format === "tar.gz" ? ".tar.gz" : `.${format}`;
-  } else if (typeof assetPattern === "string") {
-    const detectedFormat = (0, import_detect.detectArchiveFormat)(assetPattern);
-    if (detectedFormat) {
-      ext = detectedFormat === "tar.gz" ? ".tar.gz" : `.${detectedFormat}`;
-    }
-  }
-  const archivePath = path.join(outputDir, `__temp_download__${ext}`);
-  if (!quiet) {
-    logger.info(`Downloading archive from release ${tag}...`);
-  }
-  await (0, import_github_downloads.downloadReleaseAsset)(tag, assetPattern, archivePath, repoConfig, {
-    quiet
-  });
-  if (!quiet) {
-    logger.info(`Extracting archive to ${outputDir}...`);
-  }
-  try {
-    await (0, import_extract.extractArchive)(archivePath, outputDir, { quiet, strip });
-    if (!quiet) {
-      logger.info(`Extracted archive contents to ${outputDir}`);
-    }
-  } catch (cause) {
-    throw new import_error.ErrorCtor(`Failed to extract archive: ${archivePath}`, { cause });
-  } finally {
-    if (cleanup) {
-      try {
-        await (0, import_safe.safeDelete)(archivePath);
-        if (!quiet) {
-          logger.info("Cleaned up temporary archive file");
-        }
-      } catch (e) {
-        if (!quiet) {
-          logger.warn(`Failed to cleanup archive file: ${e}`);
-        }
-      }
-    }
-  }
-  return outputDir;
+	const { cleanup = true, format, quiet = false, strip } = options;
+	const path = /* @__PURE__ */ require_node_path.getNodePath();
+	await require_fs_safe.safeMkdir(outputDir);
+	let ext = ".archive";
+	if (format) ext = format === "tar.gz" ? ".tar.gz" : `.${format}`;
+	else if (typeof assetPattern === "string") {
+		const detectedFormat = require_archives_detect.detectArchiveFormat(assetPattern);
+		if (detectedFormat) ext = detectedFormat === "tar.gz" ? ".tar.gz" : `.${detectedFormat}`;
+	}
+	const archivePath = path.join(outputDir, `__temp_download__${ext}`);
+	if (!quiet) logger.info(`Downloading archive from release ${tag}...`);
+	await require_releases_github_downloads.downloadReleaseAsset(tag, assetPattern, archivePath, repoConfig, { quiet });
+	if (!quiet) logger.info(`Extracting archive to ${outputDir}...`);
+	try {
+		await require_archives_extract.extractArchive(archivePath, outputDir, {
+			quiet,
+			strip
+		});
+		if (!quiet) logger.info(`Extracted archive contents to ${outputDir}`);
+	} catch (cause) {
+		throw new require_primordials_error.ErrorCtor(`Failed to extract archive: ${archivePath}`, { cause });
+	} finally {
+		if (cleanup) try {
+			await require_fs_safe.safeDelete(archivePath);
+			if (!quiet) logger.info("Cleaned up temporary archive file");
+		} catch (e) {
+			if (!quiet) logger.warn(`Failed to cleanup archive file: ${e}`);
+		}
+	}
+	return outputDir;
 }
-async function downloadAndExtractZip(tag, assetPattern, outputDir, repoConfig, options = {
-  __proto__: null
-}) {
-  const { cleanup = true, quiet = false } = options;
-  const path = (0, import_path.getNodePath)();
-  await (0, import_safe.safeMkdir)(outputDir);
-  const zipPath = path.join(outputDir, "__temp_download__.zip");
-  if (!quiet) {
-    logger.info(`Downloading zip asset from release ${tag}...`);
-  }
-  await (0, import_github_downloads.downloadReleaseAsset)(tag, assetPattern, zipPath, repoConfig, { quiet });
-  if (!quiet) {
-    logger.info(`Extracting zip to ${outputDir}...`);
-  }
-  try {
-    await (0, import_extract.extractArchive)(zipPath, outputDir, { quiet });
-    if (!quiet) {
-      logger.info(`Extracted zip contents to ${outputDir}`);
-    }
-  } catch (cause) {
-    throw new import_error.ErrorCtor(`Failed to extract zip file: ${zipPath}`, { cause });
-  } finally {
-    if (cleanup) {
-      try {
-        await (0, import_safe.safeDelete)(zipPath);
-        if (!quiet) {
-          logger.info("Cleaned up temporary zip file");
-        }
-      } catch (e) {
-        if (!quiet) {
-          logger.warn(`Failed to cleanup zip file: ${e}`);
-        }
-      }
-    }
-  }
-  return outputDir;
+/**
+* Download and extract a zip file from a GitHub release. Automatically handles
+* downloading, extracting, and cleanup.
+*
+* @example
+*   ;```typescript
+*   const outputDir = await downloadAndExtractZip(
+*     'v1.0.0',
+*     'models-*.zip',
+*     '/tmp/models',
+*     { owner: 'SocketDev', repo: 'socket-btm' },
+*   )
+*   ```
+*
+* @param tag - Release tag name.
+* @param assetPattern - Asset name or pattern (glob string, prefix/suffix
+*   object, or RegExp)
+* @param outputDir - Directory to extract the zip contents to.
+* @param repoConfig - Repository configuration (owner/repo)
+* @param options - Additional options.
+* @param options.quiet - Suppress log messages.
+* @param options.cleanup - Remove downloaded zip file after extraction
+*   (default: true)
+*
+* @returns Path to the extraction directory
+*/
+async function downloadAndExtractZip(tag, assetPattern, outputDir, repoConfig, options = { __proto__: null }) {
+	const { cleanup = true, quiet = false } = options;
+	const path = /* @__PURE__ */ require_node_path.getNodePath();
+	await require_fs_safe.safeMkdir(outputDir);
+	const zipPath = path.join(outputDir, "__temp_download__.zip");
+	if (!quiet) logger.info(`Downloading zip asset from release ${tag}...`);
+	await require_releases_github_downloads.downloadReleaseAsset(tag, assetPattern, zipPath, repoConfig, { quiet });
+	if (!quiet) logger.info(`Extracting zip to ${outputDir}...`);
+	try {
+		await require_archives_extract.extractArchive(zipPath, outputDir, { quiet });
+		if (!quiet) logger.info(`Extracted zip contents to ${outputDir}`);
+	} catch (cause) {
+		throw new require_primordials_error.ErrorCtor(`Failed to extract zip file: ${zipPath}`, { cause });
+	} finally {
+		if (cleanup) try {
+			await require_fs_safe.safeDelete(zipPath);
+			if (!quiet) logger.info("Cleaned up temporary zip file");
+		} catch (e) {
+			if (!quiet) logger.warn(`Failed to cleanup zip file: ${e}`);
+		}
+	}
+	return outputDir;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  downloadAndExtractArchive,
-  downloadAndExtractZip
-});
+
+//#endregion
+exports.downloadAndExtractArchive = downloadAndExtractArchive;
+exports.downloadAndExtractZip = downloadAndExtractZip;