@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/archives/_internal.js

@@ -1,87 +1,78 @@
 "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 internal_exports = {};
-__export(internal_exports, {
-  DEFAULT_MAX_ENTRIES: () => DEFAULT_MAX_ENTRIES,
-  DEFAULT_MAX_FILE_SIZE: () => DEFAULT_MAX_FILE_SIZE,
-  DEFAULT_MAX_TOTAL_SIZE: () => DEFAULT_MAX_TOTAL_SIZE,
-  assertArchiveExists: () => assertArchiveExists,
-  getAdmZip: () => getAdmZip,
-  getPath: () => import_path2.getNodePath,
-  getTarFs: () => getTarFs,
-  validatePathWithinBase: () => validatePathWithinBase
-});
-module.exports = __toCommonJS(internal_exports);
-var import_node_fs = require("node:fs");
-var import_error = require("../primordials/error");
-var import_string = require("../primordials/string");
-var import_path = require("../node/path");
-var import_path2 = require("../node/path");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_error = require('../primordials/error.js');
+const require_primordials_string = require('../primordials/string.js');
+const require_node_path = require('../node/path.js');
+let node_fs = require("node:fs");
+
+//#region src/archives/_internal.ts
+/**
+* @file Private internals for `archives/*` modules — defaults, lazy module
+*   accessors (adm-zip, tar-fs, node:path), shared pre-extraction validators
+*   (`assertArchiveExists`, `validatePathWithinBase`).
+*/
 const DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024;
 const DEFAULT_MAX_TOTAL_SIZE = 1024 * 1024 * 1024;
 const DEFAULT_MAX_ENTRIES = 1e5;
 let _AdmZip;
 let _tarFs;
+/**
+* Assert that an archive file exists on disk before handing it to the
+* underlying extractor. Normalizes the "missing archive" surface across all
+* three extractors (zip/tar/tar.gz): each now throws a Node-style `ENOENT`
+* error with the archive path. Without this preflight, `zip` goes through
+* adm-zip and surfaces as `"Invalid filename"`, while `tar`/`tar.gz` surface
+* the raw Node `ENOENT` — inconsistent, and adm-zip's message didn't include
+* the path.
+*
+* @private
+*
+* @throws Error with `code: 'ENOENT'` if archivePath doesn't exist.
+*/
 function assertArchiveExists(archivePath) {
-  if (!(0, import_node_fs.existsSync)(archivePath)) {
-    const err = new import_error.ErrorCtor(
-      `ENOENT: no such file or directory, open '${archivePath}'`
-    );
-    err.code = "ENOENT";
-    err.path = archivePath;
-    throw err;
-  }
+	if (!(0, node_fs.existsSync)(archivePath)) {
+		const err = new require_primordials_error.ErrorCtor(`ENOENT: no such file or directory, open '${archivePath}'`);
+		err.code = "ENOENT";
+		err.path = archivePath;
+		throw err;
+	}
 }
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getAdmZip() {
-  if (_AdmZip === void 0) {
-    _AdmZip = require("../external/adm-zip.js");
-  }
-  return _AdmZip;
+	if (_AdmZip === void 0) _AdmZip = /* @__PURE__ */ require("../external/adm-zip.js");
+	return _AdmZip;
 }
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getTarFs() {
-  if (_tarFs === void 0) {
-    _tarFs = require("../external/tar-fs.js");
-  }
-  return _tarFs;
+	if (_tarFs === void 0) _tarFs = /* @__PURE__ */ require("../external/tar-fs.js");
+	return _tarFs;
 }
+/**
+* Validate that a resolved path is within the target directory. Prevents path
+* traversal attacks.
+*
+* @private
+*
+* @param targetPath - The resolved path to validate.
+* @param baseDir - The base directory that should contain the path.
+* @param entryName - Original entry name for error reporting.
+*
+* @throws Error if path is outside the base directory
+*/
 function validatePathWithinBase(targetPath, baseDir, entryName) {
-  const path = (0, import_path.getNodePath)();
-  const resolvedTarget = path.resolve(targetPath);
-  const resolvedBase = path.resolve(baseDir);
-  if (!(0, import_string.StringPrototypeStartsWith)(resolvedTarget, resolvedBase + path.sep) && resolvedTarget !== resolvedBase) {
-    throw new import_error.ErrorCtor(
-      `Path traversal attempt detected: entry "${entryName}" would extract to "${resolvedTarget}" outside target directory "${resolvedBase}"`
-    );
-  }
+	const path = /* @__PURE__ */ require_node_path.getNodePath();
+	const resolvedTarget = path.resolve(targetPath);
+	const resolvedBase = path.resolve(baseDir);
+	if (!require_primordials_string.StringPrototypeStartsWith(resolvedTarget, resolvedBase + path.sep) && resolvedTarget !== resolvedBase) throw new require_primordials_error.ErrorCtor(`Path traversal attempt detected: entry "${entryName}" would extract to "${resolvedTarget}" outside target directory "${resolvedBase}"`);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  DEFAULT_MAX_ENTRIES,
-  DEFAULT_MAX_FILE_SIZE,
-  DEFAULT_MAX_TOTAL_SIZE,
-  assertArchiveExists,
-  getAdmZip,
-  getPath,
-  getTarFs,
-  validatePathWithinBase
-});
+
+//#endregion
+exports.DEFAULT_MAX_ENTRIES = DEFAULT_MAX_ENTRIES;
+exports.DEFAULT_MAX_FILE_SIZE = DEFAULT_MAX_FILE_SIZE;
+exports.DEFAULT_MAX_TOTAL_SIZE = DEFAULT_MAX_TOTAL_SIZE;
+exports.assertArchiveExists = assertArchiveExists;
+exports.getAdmZip = getAdmZip;
+exports.getPath = require_node_path.getNodePath;
+exports.getTarFs = getTarFs;
+exports.validatePathWithinBase = validatePathWithinBase;

package/dist/archives/detect.js

@@ -1,46 +1,33 @@
 "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 detect_exports = {};
-__export(detect_exports, {
-  detectArchiveFormat: () => detectArchiveFormat
-});
-module.exports = __toCommonJS(detect_exports);
-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');
+
+//#region src/archives/detect.ts
+/**
+* @file Format detection by file extension.
+*/
+/**
+* Detect archive format from file path.
+*
+* @example
+*   ;```typescript
+*   detectArchiveFormat('package.tar.gz') // 'tar.gz'
+*   detectArchiveFormat('archive.zip') // 'zip'
+*   detectArchiveFormat('data.csv') // undefined
+*   ```
+*
+* @param filePath - Path to archive file.
+*
+* @returns Archive format or undefined if unknown
+*/
 function detectArchiveFormat(filePath) {
-  const lower = filePath.toLowerCase();
-  if ((0, import_string.StringPrototypeEndsWith)(lower, ".tar.gz")) {
-    return "tar.gz";
-  }
-  if ((0, import_string.StringPrototypeEndsWith)(lower, ".tgz")) {
-    return "tgz";
-  }
-  if ((0, import_string.StringPrototypeEndsWith)(lower, ".tar")) {
-    return "tar";
-  }
-  if ((0, import_string.StringPrototypeEndsWith)(lower, ".zip")) {
-    return "zip";
-  }
-  return void 0;
+	const lower = filePath.toLowerCase();
+	if (require_primordials_string.StringPrototypeEndsWith(lower, ".tar.gz")) return "tar.gz";
+	if (require_primordials_string.StringPrototypeEndsWith(lower, ".tgz")) return "tgz";
+	if (require_primordials_string.StringPrototypeEndsWith(lower, ".tar")) return "tar";
+	if (require_primordials_string.StringPrototypeEndsWith(lower, ".zip")) return "zip";
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  detectArchiveFormat
-});
+
+//#endregion
+exports.detectArchiveFormat = detectArchiveFormat;

package/dist/archives/extract.js

@@ -1,53 +1,46 @@
 "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 extract_exports = {};
-__export(extract_exports, {
-  extractArchive: () => extractArchive
-});
-module.exports = __toCommonJS(extract_exports);
-var import_error = require("../primordials/error");
-var import_detect = require("./detect");
-var import_internal = require("./_internal");
-var import_tar = require("./tar");
-var import_zip = require("./zip");
+/* 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_archives_detect = require('./detect.js');
+const require_archives_tar = require('./tar.js');
+const require_archives_zip = require('./zip.js');
+
+//#region src/archives/extract.ts
+/**
+* @file `extractArchive` — format-detecting dispatcher that routes to
+*   `extractTar` / `extractTarGz` / `extractZip`.
+*/
+/**
+* Extract an archive to a directory. Automatically detects format from file
+* extension.
+*
+* @example
+*   ;```typescript
+*   await extractArchive('/tmp/package.tar.gz', '/tmp/output')
+*   await extractArchive('/tmp/release.zip', '/tmp/output', { strip: 1 })
+*   ```
+*
+* @param archivePath - Path to archive file.
+* @param outputDir - Directory to extract to.
+* @param options - Extraction options.
+*
+* @throws Error if archive format is not supported
+*/
 async function extractArchive(archivePath, outputDir, options = {}) {
-  const format = (0, import_detect.detectArchiveFormat)(archivePath);
-  if (!format) {
-    const path = (0, import_internal.getPath)();
-    const ext = path.extname(archivePath).toLowerCase();
-    throw new import_error.ErrorCtor(
-      `Unsupported archive format${ext ? ` (extension: ${ext})` : ""}: ${archivePath}. Supported formats: .zip, .tar, .tar.gz, .tgz`
-    );
-  }
-  switch (format) {
-    case "zip":
-      return await (0, import_zip.extractZip)(archivePath, outputDir, options);
-    case "tar":
-      return await (0, import_tar.extractTar)(archivePath, outputDir, options);
-    case "tar.gz":
-    case "tgz":
-      return await (0, import_tar.extractTarGz)(archivePath, outputDir, options);
-  }
+	const format = require_archives_detect.detectArchiveFormat(archivePath);
+	if (!format) {
+		const ext = (/* @__PURE__ */ require_node_path.getNodePath()).extname(archivePath).toLowerCase();
+		throw new require_primordials_error.ErrorCtor(`Unsupported archive format${ext ? ` (extension: ${ext})` : ""}: ${archivePath}. Supported formats: .zip, .tar, .tar.gz, .tgz`);
+	}
+	switch (format) {
+		case "zip": return await require_archives_zip.extractZip(archivePath, outputDir, options);
+		case "tar": return await require_archives_tar.extractTar(archivePath, outputDir, options);
+		case "tar.gz":
+		case "tgz": return await require_archives_tar.extractTarGz(archivePath, outputDir, options);
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  extractArchive
-});
+
+//#endregion
+exports.extractArchive = extractArchive;