@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/url/search-params.js

@@ -1,115 +1,147 @@
 "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_params_exports = {};
-__export(search_params_exports, {
-  urlSearchParamsAsArray: () => urlSearchParamsAsArray,
-  urlSearchParamsAsBoolean: () => urlSearchParamsAsBoolean,
-  urlSearchParamsAsNumber: () => urlSearchParamsAsNumber,
-  urlSearchParamsAsString: () => urlSearchParamsAsString,
-  urlSearchParamsGetArray: () => urlSearchParamsGetArray,
-  urlSearchParamsGetBoolean: () => urlSearchParamsGetBoolean
-});
-module.exports = __toCommonJS(search_params_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/url/search-params.ts
+/**
+* @file URL search-param coercion helpers — `urlSearchParamsAs*` normalise a
+*   raw `string | null | undefined` value into a typed shape (array / boolean /
+*   number / string) with a default. `urlSearchParamsGet*` take a
+*   `URLSearchParams` instance and a key.
+*/
 const BooleanCtor = Boolean;
-// @__NO_SIDE_EFFECTS__
+/**
+* Convert a URL search parameter to an array.
+*
+* @example
+*   ;```typescript
+*   urlSearchParamsAsArray('a, b, c') // ['a', 'b', 'c']
+*   urlSearchParamsAsArray(null) // []
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsArray(value) {
-  return typeof value === "string" ? value.trim().split(/, */).map((v) => v.trim()).filter(BooleanCtor) : [];
+	return typeof value === "string" ? value.trim().split(/, */).map((v) => v.trim()).filter(BooleanCtor) : [];
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Convert a URL search parameter to a boolean.
+*
+* @example
+*   ;```typescript
+*   urlSearchParamsAsBoolean('true') // true
+*   urlSearchParamsAsBoolean('0') // false
+*   urlSearchParamsAsBoolean(null) // false
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsBoolean(value, options) {
-  const { defaultValue = false } = {
-    __proto__: null,
-    ...options
-  };
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    if (trimmed === "") {
-      return !!defaultValue;
-    }
-    const lowered = trimmed.toLowerCase();
-    return lowered === "1" || lowered === "true" || lowered === "yes" || lowered === "on";
-  }
-  if (value === null || value === void 0) {
-    return !!defaultValue;
-  }
-  return !!value;
+	const { defaultValue = false } = {
+		__proto__: null,
+		...options
+	};
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		if (trimmed === "") return !!defaultValue;
+		const lowered = trimmed.toLowerCase();
+		return lowered === "1" || lowered === "true" || lowered === "yes" || lowered === "on";
+	}
+	if (value === null || value === void 0) return !!defaultValue;
+	return !!value;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Get number value from URLSearchParams with a default.
+*
+* @example
+*   ;```typescript
+*   const params = new URLSearchParams('limit=10')
+*   urlSearchParamsAsNumber(params, 'limit') // 10
+*   urlSearchParamsAsNumber(params, 'other') // 0
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsNumber(params, key, options) {
-  const { defaultValue = 0 } = {
-    __proto__: null,
-    ...options
-  };
-  if (params && typeof params.get === "function") {
-    const value = params.get(key);
-    if (value !== null) {
-      const num = Number(value);
-      return !(0, import_number.NumberIsNaN)(num) ? num : defaultValue;
-    }
-  }
-  return defaultValue;
+	const { defaultValue = 0 } = {
+		__proto__: null,
+		...options
+	};
+	if (params && typeof params.get === "function") {
+		const value = params.get(key);
+		if (value !== null) {
+			const num = Number(value);
+			return !require_primordials_number.NumberIsNaN(num) ? num : defaultValue;
+		}
+	}
+	return defaultValue;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Get string value from URLSearchParams with a default.
+*
+* @example
+*   ;```typescript
+*   const params = new URLSearchParams('name=socket')
+*   urlSearchParamsAsString(params, 'name') // 'socket'
+*   urlSearchParamsAsString(params, 'other') // ''
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsString(params, key, options) {
-  const { defaultValue = "" } = {
-    __proto__: null,
-    ...options
-  };
-  if (params && typeof params.get === "function") {
-    const value = params.get(key);
-    return value !== null ? value : defaultValue;
-  }
-  return defaultValue;
+	const { defaultValue = "" } = {
+		__proto__: null,
+		...options
+	};
+	if (params && typeof params.get === "function") {
+		const value = params.get(key);
+		return value !== null ? value : defaultValue;
+	}
+	return defaultValue;
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Helper to get array from URLSearchParams.
+*
+* @example
+*   ;```typescript
+*   const params = new URLSearchParams('tags=a,b,c')
+*   urlSearchParamsGetArray(params, 'tags') // ['a', 'b', 'c']
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsGetArray(params, key) {
-  if (params && typeof params.getAll === "function") {
-    const values = params.getAll(key);
-    const firstValue = values[0];
-    if (values.length === 1 && firstValue && firstValue.includes(",")) {
-      return /* @__PURE__ */ urlSearchParamsAsArray(firstValue);
-    }
-    return values;
-  }
-  return [];
+	if (params && typeof params.getAll === "function") {
+		const values = params.getAll(key);
+		const firstValue = values[0];
+		if (values.length === 1 && firstValue && firstValue.includes(",")) return /* @__PURE__ */ urlSearchParamsAsArray(firstValue);
+		return values;
+	}
+	return [];
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Helper to get boolean from URLSearchParams.
+*
+* @example
+*   ;```typescript
+*   const params = new URLSearchParams('debug=true')
+*   urlSearchParamsGetBoolean(params, 'debug') // true
+*   urlSearchParamsGetBoolean(params, 'other') // false
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsGetBoolean(params, key, options) {
-  const { defaultValue = false } = {
-    __proto__: null,
-    ...options
-  };
-  if (params && typeof params.get === "function") {
-    const value = params.get(key);
-    return value !== null ? /* @__PURE__ */ urlSearchParamsAsBoolean(value, { defaultValue }) : defaultValue;
-  }
-  return defaultValue;
+	const { defaultValue = false } = {
+		__proto__: null,
+		...options
+	};
+	if (params && typeof params.get === "function") {
+		const value = params.get(key);
+		return value !== null ? /* @__PURE__ */ urlSearchParamsAsBoolean(value, { defaultValue }) : defaultValue;
+	}
+	return defaultValue;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  urlSearchParamsAsArray,
-  urlSearchParamsAsBoolean,
-  urlSearchParamsAsNumber,
-  urlSearchParamsAsString,
-  urlSearchParamsGetArray,
-  urlSearchParamsGetBoolean
-});
+
+//#endregion
+exports.urlSearchParamsAsArray = urlSearchParamsAsArray;
+exports.urlSearchParamsAsBoolean = urlSearchParamsAsBoolean;
+exports.urlSearchParamsAsNumber = urlSearchParamsAsNumber;
+exports.urlSearchParamsAsString = urlSearchParamsAsString;
+exports.urlSearchParamsGetArray = urlSearchParamsGetArray;
+exports.urlSearchParamsGetBoolean = urlSearchParamsGetBoolean;

package/dist/url/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/versions/_internal.js

@@ -1,37 +1,35 @@
 "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, {
-  getSemver: () => getSemver,
-  impl: () => impl
-});
-module.exports = __toCommonJS(internal_exports);
-var import_versions = require("../smol/versions");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_smol_versions = require('../smol/versions.js');
+
+//#region src/versions/_internal.ts
+/**
+* @file Private internals for `versions/*` modules — eagerly picks the right
+*   implementation at module load. On socket-btm's smol Node binary, prefers
+*   `node:smol-versions` (C++-accelerated via
+*   `internalBinding('smol_versions_native')`); on stock Node, falls through to
+*   the vendored JS `semver`. Both expose a strict-superset surface for the ops
+*   `versions/*` calls, so leaves can forward to `impl.<op>` directly without
+*   per-call branching. `getMajorVersion`-style helpers need the parsed object
+*   shape (`{major, minor, patch}`) which only `semver.parse` exposes — those
+*   leaves use `getSemver()` directly instead of going through `impl`.
+*/
 const _semver = require("../external/semver");
+/**
+* The vendored `semver` JS implementation. Always available — used directly by
+* the leaves that need the parsed `{major, minor, patch}` shape (which
+* smol-versions doesn't expose).
+*/
 function getSemver() {
-  return _semver;
+	return _semver;
 }
-const impl = (0, import_versions.getSmolVersions)() ?? _semver;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getSemver,
-  impl
-});
+/**
+* Resolved version implementation: smol-versions on the smol Node binary,
+* otherwise the vendored `semver`. Bound once at module load.
+*/
+const impl = /* @__PURE__ */ require_smol_versions.getSmolVersions() ?? _semver;
+
+//#endregion
+exports.getSemver = getSemver;
+exports.impl = impl;

package/dist/versions/compare.js

@@ -1,65 +1,87 @@
 "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 compare_exports = {};
-__export(compare_exports, {
-  compare: () => compare,
-  eq: () => eq,
-  gt: () => gt,
-  gte: () => gte,
-  lt: () => lt,
-  lte: () => lte,
-  neq: () => neq,
-  rsort: () => rsort,
-  sort: () => sort
-});
-module.exports = __toCommonJS(compare_exports);
-var import_internal = require("./_internal");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_versions__internal = require('./_internal.js');
+
+//#region src/versions/compare.ts
+/**
+* @file Version comparison operators aligned with `node:smol-versions` (the
+*   C++-accelerated multi-ecosystem version helper shipped by the smol Node
+*   binary). The same names + signatures also match the vendored `semver` JS
+*   lib — both impls expose this surface, so we pick one at module load (`impl
+*   = smol ?? semver`) and each export just forwards to it.
+*
+*   - `compare(a, b)` — returns `-1 | 0 | 1` (undefined on invalid input)
+*   - `eq(a, b)`, `neq(a, b)` — equality / inequality
+*   - `lt(a, b)`, `lte(a, b)` — less-than / less-or-equal
+*   - `gt(a, b)`, `gte(a, b)` — greater-than / greater-or-equal
+*   - `sort(versions)` — ascending sort
+*   - `rsort(versions)` — descending sort `compare()` swallows the smol/semver
+*     "invalid version" throw into `undefined` for the caller's convenience;
+*     all other ops surface whatever the underlying impl returns. The vendored
+*     `semver` export has no `neq` helper, so when we fall back to it we route
+*     `neq` through `!eq` to match smol's semantics.
+*/
+/**
+* Compare two semantic version strings.
+*
+* @returns -1 if a < b, 0 if a === b, 1 if a > b, or undefined if invalid.
+*/
 function compare(a, b) {
-  try {
-    return import_internal.impl.compare(a, b);
-  } catch {
-    return void 0;
-  }
+	try {
+		return require_versions__internal.impl.compare(a, b);
+	} catch {
+		return;
+	}
 }
-const eq = import_internal.impl.eq.bind(import_internal.impl);
-const neq = typeof import_internal.impl.neq === "function" ? import_internal.impl.neq.bind(import_internal.impl) : (a, b) => !import_internal.impl.eq(a, b);
-const gt = import_internal.impl.gt.bind(import_internal.impl);
-const gte = import_internal.impl.gte.bind(import_internal.impl);
-const lt = import_internal.impl.lt.bind(import_internal.impl);
-const lte = import_internal.impl.lte.bind(import_internal.impl);
+/**
+* Check if a equals b.
+*/
+const eq = require_versions__internal.impl.eq.bind(require_versions__internal.impl);
+/**
+* Check if a does not equal b.
+*/
+/* c8 ignore start - smol-versions exposes .neq, so the bind arm is taken;
+the polyfill fallback fires only on a hypothetical impl that lacks .neq. */
+const neq = typeof require_versions__internal.impl.neq === "function" ? require_versions__internal.impl.neq.bind(require_versions__internal.impl) : (a, b) => !require_versions__internal.impl.eq(a, b);
+/* c8 ignore stop */
+/**
+* Check if a is greater than b.
+*/
+const gt = require_versions__internal.impl.gt.bind(require_versions__internal.impl);
+/**
+* Check if a is greater than or equal to b.
+*/
+const gte = require_versions__internal.impl.gte.bind(require_versions__internal.impl);
+/**
+* Check if a is less than b.
+*/
+const lt = require_versions__internal.impl.lt.bind(require_versions__internal.impl);
+/**
+* Check if a is less than or equal to b.
+*/
+const lte = require_versions__internal.impl.lte.bind(require_versions__internal.impl);
+/**
+* Sort versions in descending order.
+*/
 function rsort(versions) {
-  return import_internal.impl.rsort([...versions]);
+	return require_versions__internal.impl.rsort([...versions]);
 }
+/**
+* Sort versions in ascending order. The input is spread so callers can pass a
+* `readonly string[]` even when the impl mutates internally.
+*/
 function sort(versions) {
-  return import_internal.impl.sort([...versions]);
+	return require_versions__internal.impl.sort([...versions]);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  compare,
-  eq,
-  gt,
-  gte,
-  lt,
-  lte,
-  neq,
-  rsort,
-  sort
-});
+
+//#endregion
+exports.compare = compare;
+exports.eq = eq;
+exports.gt = gt;
+exports.gte = gte;
+exports.lt = lt;
+exports.lte = lte;
+exports.neq = neq;
+exports.rsort = rsort;
+exports.sort = sort;

package/dist/versions/modify.js

@@ -1,44 +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 modify_exports = {};
-__export(modify_exports, {
-  incrementVersion: () => incrementVersion,
-  versionDiff: () => versionDiff
-});
-module.exports = __toCommonJS(modify_exports);
-var import_internal = require("./_internal");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_versions__internal = require('./_internal.js');
+
+//#region src/versions/modify.ts
+/**
+* @file Mutation helpers — `incrementVersion` bumps a version by release type
+*   ('major' | 'minor' | 'patch' | 'pre*'), and `versionDiff` returns the kind
+*   of step between two versions. Both use the vendored `semver` directly
+*   because the increment / diff APIs aren't on the smol-versions surface.
+*/
+/**
+* Increment a version by the specified release type.
+*
+* @example
+*   ;```typescript
+*   incrementVersion('1.2.3', 'patch') // '1.2.4'
+*   incrementVersion('1.2.3', 'minor') // '1.3.0'
+*   incrementVersion('1.2.3', 'major') // '2.0.0'
+*   ```
+*/
 function incrementVersion(version, release, identifier) {
-  const semver = (0, import_internal.getSemver)();
-  return semver.inc(version, release, identifier) || void 0;
+	return require_versions__internal.getSemver().inc(version, release, identifier) || void 0;
 }
+/**
+* Get the difference between two versions.
+*
+* @example
+*   ;```typescript
+*   versionDiff('1.0.0', '2.0.0') // 'major'
+*   versionDiff('1.0.0', '1.1.0') // 'minor'
+*   versionDiff('1.0.0', '1.0.1') // 'patch'
+*   ```
+*/
 function versionDiff(version1, version2) {
-  try {
-    const semver = (0, import_internal.getSemver)();
-    return semver.diff(version1, version2) || void 0;
-  } catch {
-    return void 0;
-  }
+	try {
+		return require_versions__internal.getSemver().diff(version1, version2) || void 0;
+	} catch {
+		return;
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  incrementVersion,
-  versionDiff
-});
+
+//#endregion
+exports.incrementVersion = incrementVersion;
+exports.versionDiff = versionDiff;