@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/packages/specs.js

@@ -1,95 +1,105 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var specs_exports = {};
-__export(specs_exports, {
-  getRepoUrlDetails: () => getRepoUrlDetails,
-  gitHubTagRefUrl: () => gitHubTagRefUrl,
-  gitHubTgzUrl: () => gitHubTgzUrl,
-  isGitHubTgzSpec: () => isGitHubTgzSpec,
-  isGitHubUrlSpec: () => isGitHubUrlSpec
-});
-module.exports = __toCommonJS(specs_exports);
-var import_npm_package_arg = __toESM(require("../external/npm-package-arg"));
-var import_predicates = require("../objects/predicates");
-var import_predicates2 = require("../strings/predicates");
-var import_string = require("../primordials/string");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_string = require('../primordials/string.js');
+const require_strings_predicates = require('../strings/predicates.js');
+const require_objects_predicates = require('../objects/predicates.js');
+let src_external_npm_package_arg = require("../external/npm-package-arg");
+src_external_npm_package_arg = require_runtime.__toESM(src_external_npm_package_arg);
+
+//#region src/packages/specs.ts
+/**
+* @file Package spec parsing and GitHub URL utilities.
+*/
+/**
+* Extract user and project from GitHub repository URL.
+*
+* @example
+*   ;```typescript
+*   getRepoUrlDetails('https://github.com/lodash/lodash.git')
+*   // { user: 'lodash', project: 'lodash' }
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getRepoUrlDetails(repoUrl = "") {
-  const match = /^(?:[a-z][a-z+]*:\/\/)(?:[^/@]+@)?github\.com\/([^?#]+)(?:[?#]|$)/i.exec(
-    repoUrl
-  );
-  if (!match || !match[1]) {
-    return { user: "", project: "" };
-  }
-  const userAndRepo = match[1].split("/");
-  const user = userAndRepo[0] || "";
-  const rawProject = userAndRepo[1] ?? "";
-  const project = (0, import_string.StringPrototypeEndsWith)(rawProject, ".git") ? rawProject.slice(0, -4) : rawProject;
-  return { user, project };
+	const match = /^(?:[a-z][a-z+]*:\/\/)(?:[^/@]+@)?github\.com\/([^?#]+)(?:[?#]|$)/i.exec(repoUrl);
+	if (!match || !match[1]) return {
+		user: "",
+		project: ""
+	};
+	const userAndRepo = match[1].split("/");
+	const user = userAndRepo[0] || "";
+	const rawProject = userAndRepo[1] ?? "";
+	return {
+		user,
+		project: require_primordials_string.StringPrototypeEndsWith(rawProject, ".git") ? rawProject.slice(0, -4) : rawProject
+	};
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Generate GitHub API URL for a tag reference.
+*
+* @example
+*   ;```typescript
+*   gitHubTagRefUrl('lodash', 'lodash', 'v4.17.21')
+*   // 'https://api.github.com/repos/lodash/lodash/git/ref/tags/v4.17.21'
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function gitHubTagRefUrl(user, project, tag) {
-  return `https://api.github.com/repos/${user}/${project}/git/ref/tags/${tag}`;
+	return `https://api.github.com/repos/${user}/${project}/git/ref/tags/${tag}`;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Generate GitHub tarball download URL for a commit SHA.
+*
+* @example
+*   ;```typescript
+*   gitHubTgzUrl('lodash', 'lodash', 'abc123')
+*   // 'https://github.com/lodash/lodash/archive/abc123.tar.gz'
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function gitHubTgzUrl(user, project, sha) {
-  return `https://github.com/${user}/${project}/archive/${sha}.tar.gz`;
+	return `https://github.com/${user}/${project}/archive/${sha}.tar.gz`;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Check if a package specifier is a GitHub tarball URL.
+*
+* @example
+*   ;```typescript
+*   isGitHubTgzSpec('https://github.com/user/repo/archive/abc123.tar.gz') // true
+*   isGitHubTgzSpec('lodash@4.17.21') // false
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isGitHubTgzSpec(spec, where) {
-  let parsedSpec;
-  if ((0, import_predicates.isPlainObject)(spec)) {
-    parsedSpec = spec;
-  } else {
-    parsedSpec = (0, import_npm_package_arg.default)(spec, where);
-  }
-  const typedSpec = parsedSpec;
-  return typedSpec.type === "remote" && !!typedSpec.saveSpec?.endsWith(".tar.gz");
+	let parsedSpec;
+	if (/* @__PURE__ */ require_objects_predicates.isPlainObject(spec)) parsedSpec = spec;
+	else parsedSpec = (0, src_external_npm_package_arg.default)(spec, where);
+	const typedSpec = parsedSpec;
+	return typedSpec.type === "remote" && !!typedSpec.saveSpec?.endsWith(".tar.gz");
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Check if a package specifier is a GitHub URL with committish.
+*
+* @example
+*   ;```typescript
+*   isGitHubUrlSpec('github:user/repo#v1.0.0') // true
+*   isGitHubUrlSpec('lodash@4.17.21') // false
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isGitHubUrlSpec(spec, where) {
-  let parsedSpec;
-  if ((0, import_predicates.isPlainObject)(spec)) {
-    parsedSpec = spec;
-  } else {
-    parsedSpec = (0, import_npm_package_arg.default)(spec, where);
-  }
-  const typedSpec = parsedSpec;
-  return typedSpec.type === "git" && typedSpec.hosted?.domain === "github.com" && (0, import_predicates2.isNonEmptyString)(typedSpec.gitCommittish);
+	let parsedSpec;
+	if (/* @__PURE__ */ require_objects_predicates.isPlainObject(spec)) parsedSpec = spec;
+	else parsedSpec = (0, src_external_npm_package_arg.default)(spec, where);
+	const typedSpec = parsedSpec;
+	return typedSpec.type === "git" && typedSpec.hosted?.domain === "github.com" && /* @__PURE__ */ require_strings_predicates.isNonEmptyString(typedSpec.gitCommittish);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getRepoUrlDetails,
-  gitHubTagRefUrl,
-  gitHubTgzUrl,
-  isGitHubTgzSpec,
-  isGitHubUrlSpec
-});
+
+//#endregion
+exports.getRepoUrlDetails = getRepoUrlDetails;
+exports.gitHubTagRefUrl = gitHubTagRefUrl;
+exports.gitHubTgzUrl = gitHubTgzUrl;
+exports.isGitHubTgzSpec = isGitHubTgzSpec;
+exports.isGitHubUrlSpec = isGitHubUrlSpec;

package/dist/packages/types.js

@@ -1,18 +1,2 @@
 "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 __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 types_exports = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/packages/validation.js

@@ -1,57 +1,56 @@
 "use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var validation_exports = {};
-__export(validation_exports, {
-  isBlessedPackageName: () => isBlessedPackageName,
-  isRegistryFetcherType: () => isRegistryFetcherType,
-  isValidPackageName: () => isValidPackageName
-});
-module.exports = __toCommonJS(validation_exports);
-var import_validate_npm_package_name = __toESM(require("../external/validate-npm-package-name"));
-var import_string = require("../primordials/string");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_string = require('../primordials/string.js');
+let src_external_validate_npm_package_name = require("../external/validate-npm-package-name");
+src_external_validate_npm_package_name = require_runtime.__toESM(src_external_validate_npm_package_name);
+
+//#region src/packages/validation.ts
+/**
+* @file Package name validation utilities.
+*/
+/**
+* Check if package name is a blessed Socket.dev package.
+*
+* @example
+*   ;```typescript
+*   isBlessedPackageName('@socketregistry/is-number') // true
+*   isBlessedPackageName('lodash') // false
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isBlessedPackageName(name) {
-  return typeof name === "string" && (name === "sfw" || name === "socket" || (0, import_string.StringPrototypeStartsWith)(name, "@socketoverride/") || (0, import_string.StringPrototypeStartsWith)(name, "@socketregistry/") || (0, import_string.StringPrototypeStartsWith)(name, "@socketsecurity/"));
+	return typeof name === "string" && (name === "sfw" || name === "socket" || require_primordials_string.StringPrototypeStartsWith(name, "@socketoverride/") || require_primordials_string.StringPrototypeStartsWith(name, "@socketregistry/") || require_primordials_string.StringPrototypeStartsWith(name, "@socketsecurity/"));
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Check if a type string represents a registry fetcher type.
+*
+* @example
+*   ;```typescript
+*   isRegistryFetcherType('range') // true
+*   isRegistryFetcherType('git') // false
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isRegistryFetcherType(type) {
-  return type === "alias" || type === "range" || type === "tag" || type === "version";
+	return type === "alias" || type === "range" || type === "tag" || type === "version";
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Check if a package name is valid according to npm naming rules.
+*
+* @example
+*   ;```typescript
+*   isValidPackageName('my-package') // true
+*   isValidPackageName('.invalid') // false
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function isValidPackageName(name) {
-  return (0, import_validate_npm_package_name.default)(name).validForOldPackages;
+	return (0, src_external_validate_npm_package_name.default)(name).validForOldPackages;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  isBlessedPackageName,
-  isRegistryFetcherType,
-  isValidPackageName
-});
+
+//#endregion
+exports.isBlessedPackageName = isBlessedPackageName;
+exports.isRegistryFetcherType = isRegistryFetcherType;
+exports.isValidPackageName = isValidPackageName;

package/dist/paths/_internal.js

@@ -1,42 +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 internal_exports = {};
-__export(internal_exports, {
-  CHAR_BACKWARD_SLASH: () => CHAR_BACKWARD_SLASH,
-  CHAR_COLON: () => CHAR_COLON,
-  CHAR_FORWARD_SLASH: () => CHAR_FORWARD_SLASH,
-  CHAR_LOWERCASE_A: () => CHAR_LOWERCASE_A,
-  CHAR_LOWERCASE_Z: () => CHAR_LOWERCASE_Z,
-  CHAR_UPPERCASE_A: () => CHAR_UPPERCASE_A,
-  CHAR_UPPERCASE_Z: () => CHAR_UPPERCASE_Z,
-  getUrl: () => getUrl,
-  msysDriveRegExp: () => msysDriveRegExp,
-  nodeModulesPathRegExp: () => nodeModulesPathRegExp,
-  pathLikeToString: () => pathLikeToString,
-  slashRegExp: () => slashRegExp
-});
-module.exports = __toCommonJS(internal_exports);
-var import_platform = require("../constants/platform");
-var import_buffer = require("../primordials/buffer");
-var import_string = require("../primordials/string");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_buffer = require('../primordials/buffer.js');
+const require_primordials_string = require('../primordials/string.js');
+const require_constants_platform = require('../constants/platform.js');
+
+//#region src/paths/_internal.ts
+/**
+* @file Shared internals for the `paths/` module — the leaf-level primitives
+*   every other path leaf depends on. Kept as a single file so `normalize`,
+*   `predicates`, `conversion`, and `resolve` can layer above it without
+*   circular imports.
+*
+*   - char-code constants + shared regexps
+*   - `getUrl` — lazy `node:url` loader
+*   - `pathLikeToString` — `string | Buffer | URL` → `string`
+*/
 const CHAR_BACKWARD_SLASH = 92;
 const CHAR_COLON = 58;
 const CHAR_FORWARD_SLASH = 47;
@@ -48,55 +27,72 @@ const msysDriveRegExp = /^\/([a-zA-Z])(\/|$)/;
 const nodeModulesPathRegExp = /(?:^|[/\\])node_modules(?:[/\\]|$)/;
 const slashRegExp = /[/\\]/;
 let _url;
-// @__NO_SIDE_EFFECTS__
+/**
+* Lazily load the url module.
+*
+* Performs on-demand loading of Node.js url module to avoid initialization
+* overhead and potential Webpack bundling errors.
+*
+* @private
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getUrl() {
-  if (_url === void 0) {
-    _url = require("node:url");
-  }
-  return _url;
+	if (_url === void 0) _url = /* @__PURE__ */ require("node:url");
+	return _url;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Convert a path-like value to a string.
+*
+* Converts various path-like types (string, Buffer, URL) into a normalized
+* string representation. Handles different input formats and provides
+* consistent string output for path operations.
+*
+* @example
+*   ;```typescript
+*   pathLikeToString('/home/user') // '/home/user'
+*   pathLikeToString(Buffer.from('/tmp/file')) // '/tmp/file'
+*   pathLikeToString(new URL('file:///home/user')) // '/home/user'
+*   pathLikeToString(null) // ''
+*   ```
+*
+* @param {string | Buffer | URL | null | undefined} pathLike - The value to
+*   convert.
+*
+* @returns {string} The string representation, or empty string for
+*   null/undefined.
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function pathLikeToString(pathLike) {
-  if (pathLike === null || pathLike === void 0) {
-    return "";
-  }
-  if (typeof pathLike === "string") {
-    return pathLike;
-  }
-  if ((0, import_buffer.BufferIsBuffer)(pathLike)) {
-    return pathLike.toString("utf8");
-  }
-  const url = /* @__PURE__ */ getUrl();
-  if (pathLike instanceof URL) {
-    try {
-      return url.fileURLToPath(pathLike);
-    } catch {
-      const pathname = pathLike.pathname;
-      const decodedPathname = decodeURIComponent(pathname);
-      if (import_platform.WIN32 && (0, import_string.StringPrototypeStartsWith)(decodedPathname, "/")) {
-        const letter = (0, import_string.StringPrototypeCharCodeAt)(decodedPathname, 1) | 32;
-        const hasValidDriveLetter = decodedPathname.length >= 3 && letter >= 97 && letter <= 122 && (0, import_string.StringPrototypeCharAt)(decodedPathname, 2) === ":";
-        if (!hasValidDriveLetter) {
-          return decodedPathname;
-        }
-      }
-      return decodedPathname;
-    }
-  }
-  return String(pathLike);
+	if (pathLike === null || pathLike === void 0) return "";
+	if (typeof pathLike === "string") return pathLike;
+	if (require_primordials_buffer.BufferIsBuffer(pathLike)) return pathLike.toString("utf8");
+	const url = /* @__PURE__ */ getUrl();
+	if (pathLike instanceof URL) try {
+		return url.fileURLToPath(pathLike);
+	} catch {
+		const pathname = pathLike.pathname;
+		const decodedPathname = decodeURIComponent(pathname);
+		/* c8 ignore start - Windows-only URL drive-letter handling. */
+		if (require_constants_platform.WIN32 && require_primordials_string.StringPrototypeStartsWith(decodedPathname, "/")) {
+			const letter = require_primordials_string.StringPrototypeCharCodeAt(decodedPathname, 1) | 32;
+			if (!(decodedPathname.length >= 3 && letter >= 97 && letter <= 122 && require_primordials_string.StringPrototypeCharAt(decodedPathname, 2) === ":")) return decodedPathname;
+		}
+		/* c8 ignore stop */
+		return decodedPathname;
+	}
+	return String(pathLike);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  CHAR_BACKWARD_SLASH,
-  CHAR_COLON,
-  CHAR_FORWARD_SLASH,
-  CHAR_LOWERCASE_A,
-  CHAR_LOWERCASE_Z,
-  CHAR_UPPERCASE_A,
-  CHAR_UPPERCASE_Z,
-  getUrl,
-  msysDriveRegExp,
-  nodeModulesPathRegExp,
-  pathLikeToString,
-  slashRegExp
-});
+
+//#endregion
+exports.CHAR_BACKWARD_SLASH = CHAR_BACKWARD_SLASH;
+exports.CHAR_COLON = CHAR_COLON;
+exports.CHAR_FORWARD_SLASH = CHAR_FORWARD_SLASH;
+exports.CHAR_LOWERCASE_A = CHAR_LOWERCASE_A;
+exports.CHAR_LOWERCASE_Z = CHAR_LOWERCASE_Z;
+exports.CHAR_UPPERCASE_A = CHAR_UPPERCASE_A;
+exports.CHAR_UPPERCASE_Z = CHAR_UPPERCASE_Z;
+exports.getUrl = getUrl;
+exports.msysDriveRegExp = msysDriveRegExp;
+exports.nodeModulesPathRegExp = nodeModulesPathRegExp;
+exports.pathLikeToString = pathLikeToString;
+exports.slashRegExp = slashRegExp;