@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/node/os.js

@@ -1,34 +1,13 @@
 "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 os_exports = {};
-__export(os_exports, {
-  getNodeOs: () => getNodeOs
-});
-module.exports = __toCommonJS(os_exports);
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/node/os.ts
 let _os;
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getNodeOs() {
-  return _os ??= require("node:os");
+	return _os ??= /* @__PURE__ */ require("node:os");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNodeOs
-});
+
+//#endregion
+exports.getNodeOs = getNodeOs;

package/dist/node/path.js

@@ -1,34 +1,13 @@
 "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 path_exports = {};
-__export(path_exports, {
-  getNodePath: () => getNodePath
-});
-module.exports = __toCommonJS(path_exports);
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/node/path.ts
 let _path;
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getNodePath() {
-  return _path ??= require("node:path");
+	return _path ??= /* @__PURE__ */ require("node:path");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNodePath
-});
+
+//#endregion
+exports.getNodePath = getNodePath;

package/dist/node/timers-promises.js

@@ -1,34 +1,13 @@
 "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 timers_promises_exports = {};
-__export(timers_promises_exports, {
-  getNodeTimersPromises: () => getNodeTimersPromises
-});
-module.exports = __toCommonJS(timers_promises_exports);
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/node/timers-promises.ts
 let _timersPromises;
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getNodeTimersPromises() {
-  return _timersPromises ??= require("node:timers/promises");
+	return _timersPromises ??= /* @__PURE__ */ require("node:timers/promises");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNodeTimersPromises
-});
+
+//#endregion
+exports.getNodeTimersPromises = getNodeTimersPromises;

package/dist/node/url.js

@@ -1,34 +1,13 @@
 "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 url_exports = {};
-__export(url_exports, {
-  getNodeUrl: () => getNodeUrl
-});
-module.exports = __toCommonJS(url_exports);
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/node/url.ts
 let _url;
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getNodeUrl() {
-  return _url ??= require("node:url");
+	return _url ??= /* @__PURE__ */ require("node:url");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNodeUrl
-});
+
+//#endregion
+exports.getNodeUrl = getNodeUrl;

package/dist/node/util.js

@@ -1,34 +1,13 @@
 "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 util_exports = {};
-__export(util_exports, {
-  getNodeUtil: () => getNodeUtil
-});
-module.exports = __toCommonJS(util_exports);
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/node/util.ts
 let _util;
-// @__NO_SIDE_EFFECTS__
+/* @__NO_SIDE_EFFECTS__ */
 function getNodeUtil() {
-  return _util ??= require("node:util");
+	return _util ??= /* @__PURE__ */ require("node:util");
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getNodeUtil
-});
+
+//#endregion
+exports.getNodeUtil = getNodeUtil;

package/dist/objects/getters.js

@@ -1,137 +1,196 @@
 "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 getters_exports = {};
-__export(getters_exports, {
-  createConstantsObject: () => createConstantsObject,
-  createLazyGetter: () => createLazyGetter,
-  defineGetter: () => defineGetter,
-  defineLazyGetter: () => defineLazyGetter,
-  defineLazyGetters: () => defineLazyGetters
-});
-module.exports = __toCommonJS(getters_exports);
-var import_sentinels = require("../constants/sentinels");
-var import_map_set = require("../primordials/map-set");
-var import_object = require("../primordials/object");
-var import_reflect = require("../primordials/reflect");
-var import_sort = require("./sort");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_map_set = require('../primordials/map-set.js');
+const require_primordials_object = require('../primordials/object.js');
+const require_constants_sentinels = require('../constants/sentinels.js');
+const require_primordials_reflect = require('../primordials/reflect.js');
+const require_objects_sort = require('./sort.js');
+
+//#region src/objects/getters.ts
+/**
+* @file Lazy-getter primitives + `createConstantsObject`.
+*   `createConstantsObject` is the most-used factory in this module — fleet
+*   repos use it to assemble frozen settings objects with a mix of eager
+*   values, lazy-computed values, and internals reachable through
+*   `kInternalsSymbol`. The `defineLazyGetter*` helpers underneath are the
+*   building blocks; `createLazyGetter` is the memoizing primitive. Cycle:
+*   `defineLazyGetters` → `defineLazyGetter` → `defineGetter` +
+*   `createLazyGetter`. All function-only references, no eager top- level
+*   evaluation between siblings, so ESM tolerates.
+*/
+/**
+* Create a frozen constants object with lazy getters and internal properties.
+*
+* This function creates an immutable object with: - Regular properties from
+* `props` - Lazy getters that compute values on first access - Internal
+* properties accessible via `kInternalsSymbol` - Mixin properties (lower
+* priority, won't override existing) - Alphabetically sorted keys for
+* consistency.
+*
+* The resulting object is deeply frozen and cannot be modified.
+*
+* @example
+*   ;```ts
+*   const config = createConstantsObject(
+*     { apiUrl: 'https://api.example.com' },
+*     {
+*       getters: { client: () => new APIClient() },
+*       internals: { version: '1.0.0' },
+*     },
+*   )
+*   console.log(config.apiUrl) // 'https://api.example.com'
+*   console.log(config.client) // APIClient (lazy)
+*   console.log(config[kInternalsSymbol].version) // '1.0.0'
+*   ```
+*
+* @param props - Regular properties to include on the object.
+* @param options_ - Configuration options.
+*
+* @returns A frozen object with all specified properties
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function createConstantsObject(props, options_) {
-  const options = { __proto__: null, ...options_ };
-  const attributes = (0, import_object.ObjectFreeze)({
-    __proto__: null,
-    getters: options.getters ? (0, import_object.ObjectFreeze)(
-      // oxlint-disable-next-line socket/prefer-undefined-over-null -- Object.setPrototypeOf requires `null` for null-prototype objects.
-      (0, import_object.ObjectSetPrototypeOf)((0, import_sort.toSortedObject)(options.getters), null)
-    ) : void 0,
-    internals: options.internals ? (0, import_object.ObjectFreeze)(
-      // oxlint-disable-next-line socket/prefer-undefined-over-null
-      (0, import_object.ObjectSetPrototypeOf)((0, import_sort.toSortedObject)(options.internals), null)
-    ) : void 0,
-    mixin: options.mixin ? (0, import_object.ObjectFreeze)(
-      (0, import_object.ObjectDefineProperties)(
-        { __proto__: null },
-        (0, import_object.ObjectGetOwnPropertyDescriptors)(options.mixin)
-      )
-    ) : void 0,
-    props: props ? (
-      // oxlint-disable-next-line socket/prefer-undefined-over-null
-      (0, import_object.ObjectFreeze)((0, import_object.ObjectSetPrototypeOf)((0, import_sort.toSortedObject)(props), null))
-    ) : void 0
-  });
-  const lazyGetterStats = (0, import_object.ObjectFreeze)({
-    __proto__: null,
-    initialized: new import_map_set.SetCtor()
-  });
-  const object = defineLazyGetters(
-    {
-      __proto__: null,
-      [import_sentinels.kInternalsSymbol]: (0, import_object.ObjectFreeze)({
-        __proto__: null,
-        get attributes() {
-          return attributes;
-        },
-        get lazyGetterStats() {
-          return lazyGetterStats;
-        },
-        ...attributes.internals
-      }),
-      kInternalsSymbol: import_sentinels.kInternalsSymbol,
-      ...attributes.props
-    },
-    attributes.getters,
-    lazyGetterStats
-  );
-  if (attributes.mixin) {
-    (0, import_object.ObjectDefineProperties)(
-      object,
-      (0, import_sort.toSortedObjectFromEntries)(
-        (0, import_sort.objectEntries)((0, import_object.ObjectGetOwnPropertyDescriptors)(attributes.mixin)).filter(
-          (p) => !(0, import_object.ObjectHasOwn)(object, p[0])
-        )
-      )
-    );
-  }
-  return (0, import_object.ObjectFreeze)(object);
+	const options = {
+		__proto__: null,
+		...options_
+	};
+	const attributes = require_primordials_object.ObjectFreeze({
+		__proto__: null,
+		getters: options.getters ? require_primordials_object.ObjectFreeze(require_primordials_object.ObjectSetPrototypeOf(/* @__PURE__ */ require_objects_sort.toSortedObject(options.getters), null)) : void 0,
+		internals: options.internals ? require_primordials_object.ObjectFreeze(require_primordials_object.ObjectSetPrototypeOf(/* @__PURE__ */ require_objects_sort.toSortedObject(options.internals), null)) : void 0,
+		mixin: options.mixin ? require_primordials_object.ObjectFreeze(require_primordials_object.ObjectDefineProperties({ __proto__: null }, require_primordials_object.ObjectGetOwnPropertyDescriptors(options.mixin))) : void 0,
+		props: props ? require_primordials_object.ObjectFreeze(require_primordials_object.ObjectSetPrototypeOf(/* @__PURE__ */ require_objects_sort.toSortedObject(props), null)) : void 0
+	});
+	const lazyGetterStats = require_primordials_object.ObjectFreeze({
+		__proto__: null,
+		initialized: new require_primordials_map_set.SetCtor()
+	});
+	const object = defineLazyGetters({
+		__proto__: null,
+		[require_constants_sentinels.kInternalsSymbol]: require_primordials_object.ObjectFreeze({
+			__proto__: null,
+			get attributes() {
+				return attributes;
+			},
+			get lazyGetterStats() {
+				return lazyGetterStats;
+			},
+			...attributes.internals
+		}),
+		kInternalsSymbol: require_constants_sentinels.kInternalsSymbol,
+		...attributes.props
+	}, attributes.getters, lazyGetterStats);
+	if (attributes.mixin) require_primordials_object.ObjectDefineProperties(object, /* @__PURE__ */ require_objects_sort.toSortedObjectFromEntries((/* @__PURE__ */ require_objects_sort.objectEntries(require_primordials_object.ObjectGetOwnPropertyDescriptors(attributes.mixin))).filter((p) => !require_primordials_object.ObjectHasOwn(object, p[0]))));
+	return require_primordials_object.ObjectFreeze(object);
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Create a lazy getter function that memoizes its result.
+*
+* The returned function will only call the getter once, caching the result for
+* subsequent calls. This is useful for expensive computations or operations
+* that should only happen when needed.
+*
+* @example
+*   ;```ts
+*   const stats = { initialized: new Set() }
+*   const getLargeData = createLazyGetter('data', () => expensive(), stats)
+*   getLargeData() // Computes and caches
+*   getLargeData() // Returns cached
+*   stats.initialized.has('data') // true
+*   ```
+*
+* @param name - The property key name for the getter (used for debugging and
+*   stats)
+* @param getter - Function that computes the value on first access.
+* @param stats - Optional stats object to track initialization.
+*
+* @returns A memoized getter function
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function createLazyGetter(name, getter, stats) {
-  const UNCOMPUTED = {};
-  let lazyValue = UNCOMPUTED;
-  const { [name]: lazyGetter } = {
-    [name]() {
-      if (lazyValue === UNCOMPUTED) {
-        stats?.initialized?.add(name);
-        lazyValue = getter();
-      }
-      return lazyValue;
-    }
-  };
-  return lazyGetter;
+	const UNCOMPUTED = {};
+	let lazyValue = UNCOMPUTED;
+	const { [name]: lazyGetter } = { [name]() {
+		if (lazyValue === UNCOMPUTED) {
+			stats?.initialized?.add(name);
+			lazyValue = getter();
+		}
+		return lazyValue;
+	} };
+	return lazyGetter;
 }
+/**
+* Define a getter property on an object.
+*
+* The getter is non-enumerable and configurable, meaning it won't show up in
+* `for...in` loops or `Object.keys()`, but can be redefined later.
+*
+* @example
+*   ;```ts
+*   const obj = {}
+*   defineGetter(obj, 'timestamp', () => Date.now())
+*   obj.timestamp // Current timestamp (computed each access)
+*   Object.keys(obj) // [] (non-enumerable)
+*   ```
+*
+* @param object - The object to define the getter on.
+* @param propKey - The property key for the getter.
+* @param getter - Function that computes the property value.
+*
+* @returns The modified object (for chaining)
+*/
 function defineGetter(object, propKey, getter) {
-  (0, import_object.ObjectDefineProperty)(object, propKey, {
-    get: getter,
-    enumerable: false,
-    configurable: true
-  });
-  return object;
+	require_primordials_object.ObjectDefineProperty(object, propKey, {
+		get: getter,
+		enumerable: false,
+		configurable: true
+	});
+	return object;
 }
+/**
+* Define a lazy getter property on an object.
+*
+* Unlike `defineGetter()`, this version memoizes the result so the getter
+* function is only called once. Subsequent accesses return the cached value.
+*
+* @param object - The object to define the lazy getter on.
+* @param propKey - The property key for the lazy getter.
+* @param getter - Function that computes the value on first access.
+* @param stats - Optional stats object to track initialization.
+*
+* @returns The modified object (for chaining)
+*/
 function defineLazyGetter(object, propKey, getter, stats) {
-  return defineGetter(object, propKey, /* @__PURE__ */ createLazyGetter(propKey, getter, stats));
+	return defineGetter(object, propKey, /* @__PURE__ */ createLazyGetter(propKey, getter, stats));
 }
+/**
+* Define multiple lazy getter properties on an object.
+*
+* Each getter in the provided object will be converted to a lazy getter and
+* attached to the target object. All getters share the same stats object for
+* tracking initialization.
+*
+* @param object - The object to define lazy getters on.
+* @param getterDefObj - Object mapping property keys to getter functions.
+* @param stats - Optional stats object to track initialization.
+*
+* @returns The modified object (for chaining)
+*/
 function defineLazyGetters(object, getterDefObj, stats) {
-  if (getterDefObj !== null && typeof getterDefObj === "object") {
-    const keys = (0, import_reflect.ReflectOwnKeys)(getterDefObj);
-    for (let i = 0, { length } = keys; i < length; i += 1) {
-      const key = keys[i];
-      defineLazyGetter(object, key, getterDefObj[key], stats);
-    }
-  }
-  return object;
+	if (getterDefObj !== null && typeof getterDefObj === "object") {
+		const keys = require_primordials_reflect.ReflectOwnKeys(getterDefObj);
+		for (let i = 0, { length } = keys; i < length; i += 1) {
+			const key = keys[i];
+			defineLazyGetter(object, key, getterDefObj[key], stats);
+		}
+	}
+	return object;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createConstantsObject,
-  createLazyGetter,
-  defineGetter,
-  defineLazyGetter,
-  defineLazyGetters
-});
+
+//#endregion
+exports.createConstantsObject = createConstantsObject;
+exports.createLazyGetter = createLazyGetter;
+exports.defineGetter = defineGetter;
+exports.defineLazyGetter = defineLazyGetter;
+exports.defineLazyGetters = defineLazyGetters;