@socketsecurity/lib 6.0.3 → 6.0.5

package/dist/cover/type.js

@@ -1,79 +1,53 @@
 "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 type_exports = {};
-__export(type_exports, {
-  getTypeCoverage: () => getTypeCoverage
-});
-module.exports = __toCommonJS(type_exports);
-var import_node_process = __toESM(require("node:process"));
-var import_child = require("../process/spawn/child");
-var import_error = require("../primordials/error");
-var import_number = require("../primordials/number");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_error = require('../primordials/error.js');
+const require_primordials_number = require('../primordials/number.js');
+const require_process_spawn_child = require('../process/spawn/child.js');
+let node_process = require("node:process");
+node_process = require_runtime.__toESM(node_process);
+
+//#region src/cover/type.ts
+/**
+* @file TypeScript type coverage utilities.
+*/
+/**
+* Get TypeScript type coverage metrics.
+*
+* @throws {Error} When type-coverage command fails (if generateIfMissing is
+*   false).
+*/
 async function getTypeCoverage(options) {
-  const opts = {
-    __proto__: null,
-    cwd: import_node_process.default.cwd(),
-    generateIfMissing: false,
-    ...options
-  };
-  const { cwd, generateIfMissing } = opts;
-  if (!cwd) {
-    throw new import_error.ErrorCtor("Working directory is required.");
-  }
-  try {
-    const result = await (0, import_child.spawn)("type-coverage", ["--detail"], {
-      cwd,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    const outputText = result.stdout ? result.stdout.toString() : "";
-    const match = /(\d+) \/ (\d+) ([\d.]+)%/.exec(outputText);
-    if (!match || !match[1] || !match[2] || !match[3]) {
-      return void 0;
-    }
-    return {
-      covered: (0, import_number.NumberParseInt)(match[1], 10),
-      percent: match[3],
-      total: (0, import_number.NumberParseInt)(match[2], 10)
-    };
-  } catch (e) {
-    if (generateIfMissing) {
-      throw new import_error.ErrorCtor(
-        "Unable to generate type coverage. Ensure type-coverage is installed.",
-        { cause: e }
-      );
-    }
-    return void 0;
-  }
+	const { cwd, generateIfMissing } = {
+		__proto__: null,
+		cwd: node_process.default.cwd(),
+		generateIfMissing: false,
+		...options
+	};
+	if (!cwd) throw new require_primordials_error.ErrorCtor("Working directory is required.");
+	try {
+		const result = await require_process_spawn_child.spawn("type-coverage", ["--detail"], {
+			cwd,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		const outputText = result.stdout ? result.stdout.toString() : "";
+		const match = /(\d+) \/ (\d+) ([\d.]+)%/.exec(outputText);
+		if (!match || !match[1] || !match[2] || !match[3]) return;
+		return {
+			covered: require_primordials_number.NumberParseInt(match[1], 10),
+			percent: match[3],
+			total: require_primordials_number.NumberParseInt(match[2], 10)
+		};
+	} catch (e) {
+		if (generateIfMissing) throw new require_primordials_error.ErrorCtor("Unable to generate type coverage. Ensure type-coverage is installed.", { cause: e });
+		return;
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getTypeCoverage
-});
+
+//#endregion
+exports.getTypeCoverage = getTypeCoverage;

package/dist/cover/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/crypto/hash.js

@@ -1,53 +1,61 @@
 "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 hash_exports = {};
-__export(hash_exports, {
-  hash: () => hash,
-  nativeHash: () => nativeHash
-});
-module.exports = __toCommonJS(hash_exports);
-var import_crypto = require("../node/crypto");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_node_crypto = require('../node/crypto.js');
+
+//#region src/crypto/hash.ts
+/**
+* @file Crypto hash helpers that prefer Node builtins where available. Probes
+*   `node:crypto.hash()` (added v21.7.0 / v20.12.0) and falls back to the
+*   streaming `createHash().update().digest()` chain on older runtimes.
+*/
 let _hash;
 let _hashProbed = false;
-// @__NO_SIDE_EFFECTS__
+/**
+* Compute a one-shot cryptographic hash.
+*
+* Prefers Node's `crypto.hash(algorithm, data, outputEncoding)` (added v21.7.0
+* / v20.12.0), which is ~30% faster than the `createHash().update().digest()`
+* chain on small-to-medium inputs because it skips constructing the streaming
+* `Hash` object. Falls back to that chain on older runtimes.
+*
+* Use this only for the one-shot case where the entire input is available as a
+* single buffer or string; if you need to feed chunks, stay on `createHash()`.
+*
+* @example
+*   ;```typescript
+*   import { hash } from '@socketsecurity/lib/crypto/hash'
+*
+*   hash('sha256', 'hello', 'hex')
+*   // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+*
+*   hash('sha512', someBuffer, 'base64')
+*   // 'z4PhNX7vuL3xVChQ1m2AB9Yg5AULVxXcg/SpIdNs6c5H0NE8XYXysP+DGNKHfuwvY7kxvUdBeoGlODJ6+SfaPg=='
+*   ```
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function hash(algorithm, data, outputEncoding) {
-  const native = /* @__PURE__ */ nativeHash();
-  if (native !== void 0) {
-    return native(algorithm, data, outputEncoding);
-  }
-  return (0, import_crypto.getNodeCrypto)().createHash(algorithm).update(data).digest(outputEncoding);
+	const native = /* @__PURE__ */ nativeHash();
+	if (native !== void 0) return native(algorithm, data, outputEncoding);
+	return (/* @__PURE__ */ require_node_crypto.getNodeCrypto()).createHash(algorithm).update(data).digest(outputEncoding);
 }
-// @__NO_SIDE_EFFECTS__
+/**
+* Resolve `crypto.hash` (or `undefined` if the runtime predates it).
+*
+* Exported for unit tests; not part of the public API.
+*
+* @internal
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function nativeHash() {
-  if (!_hashProbed) {
-    const fn = (0, import_crypto.getNodeCrypto)().hash;
-    if (typeof fn === "function") {
-      _hash = fn;
-    }
-    _hashProbed = true;
-  }
-  return _hash;
+	if (!_hashProbed) {
+		const fn = (/* @__PURE__ */ require_node_crypto.getNodeCrypto()).hash;
+		if (typeof fn === "function") _hash = fn;
+		_hashProbed = true;
+	}
+	return _hash;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  hash,
-  nativeHash
-});
+
+//#endregion
+exports.hash = hash;
+exports.nativeHash = nativeHash;

package/dist/debug/_internal.js

@@ -1,77 +1,68 @@
 "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 internal_exports = {};
-__export(internal_exports, {
-  customLog: () => customLog,
-  debugByNamespace: () => debugByNamespace,
-  getPointingTriangle: () => getPointingTriangle,
-  getUtil: () => import_util2.getNodeUtil,
-  logger: () => logger
-});
-module.exports = __toCommonJS(internal_exports);
-var import_is_unicode_supported = __toESM(require("../external/@socketregistry/is-unicode-supported"));
-var import_debug = __toESM(require("../external/debug"));
-var import_default = require("../logger/default");
-var import_map_set = require("../primordials/map-set");
-var import_reflect = require("../primordials/reflect");
-var import_util = require("../node/util");
-var import_util2 = require("../node/util");
-const logger = (0, import_default.getDefaultLogger)();
-const debugByNamespace = new import_map_set.MapCtor();
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_map_set = require('../primordials/map-set.js');
+const require_primordials_reflect = require('../primordials/reflect.js');
+const require_logger_default = require('../logger/default.js');
+const require_node_util = require('../node/util.js');
+let src_external__socketregistry_is_unicode_supported = require("../external/@socketregistry/is-unicode-supported");
+src_external__socketregistry_is_unicode_supported = require_runtime.__toESM(src_external__socketregistry_is_unicode_supported);
+let src_external_debug = require("../external/debug");
+src_external_debug = require_runtime.__toESM(src_external_debug);
+
+//#region src/debug/_internal.ts
+/**
+* @file Private internals for `debug/*` modules — the cached logger instance,
+*   lazy `node:util` accessor, the `debugByNamespace` cache that
+*   `namespace.getDebugJsInstance` fills, the lazy `pointingTriangle` glyph
+*   used by every output function, and `customLog` (the `debug-js` log-writer
+*   override). Co-located so the namespace / output / caller-info leaves don't
+*   fragment ownership of this shared module state.
+*/
+const logger = require_logger_default.getDefaultLogger();
+const debugByNamespace = new require_primordials_map_set.MapCtor();
 let _pointingTriangle;
-// @__NO_SIDE_EFFECTS__
+/**
+* Custom log function for debug output.
+*
+* @private
+*/
+/* c8 ignore start - customLog is assigned to debugJs instances and
+only fires when debugJs emits, which requires DEBUG=* env var
+set at the right module-load timing. Tests use the SOCKET_DEBUG
+path which writes via logger.info directly. */
+/* @__NO_SIDE_EFFECTS__ */
 function customLog(...args) {
-  const util = (0, import_util.getNodeUtil)();
-  const inspectOpts = import_debug.default.inspectOpts ? {
-    ...import_debug.default.inspectOpts,
-    showHidden: import_debug.default.inspectOpts.showHidden === null ? void 0 : import_debug.default.inspectOpts.showHidden,
-    depth: import_debug.default.inspectOpts.depth === null || typeof import_debug.default.inspectOpts.depth === "boolean" ? void 0 : import_debug.default.inspectOpts.depth
-  } : {};
-  (0, import_reflect.ReflectApply)(logger.info, logger, [
-    util.formatWithOptions(inspectOpts, ...args)
-  ]);
+	const util = /* @__PURE__ */ require_node_util.getNodeUtil();
+	const inspectOpts = src_external_debug.default.inspectOpts ? {
+		...src_external_debug.default.inspectOpts,
+		showHidden: src_external_debug.default.inspectOpts.showHidden === null ? void 0 : src_external_debug.default.inspectOpts.showHidden,
+		depth: src_external_debug.default.inspectOpts.depth === null || typeof src_external_debug.default.inspectOpts.depth === "boolean" ? void 0 : src_external_debug.default.inspectOpts.depth
+	} : {};
+	require_primordials_reflect.ReflectApply(logger.info, logger, [util.formatWithOptions(inspectOpts, ...args)]);
 }
-// @__NO_SIDE_EFFECTS__
+/* c8 ignore stop */
+/**
+* Lazily resolve the "pointing triangle" glyph — `▸` on terminals with unicode
+* support, `>` everywhere else. Initialised on first call by the output
+* functions.
+*
+* @private
+*/
+/* c8 ignore start - First-call init for module-level glyph; only
+one of the 5 debug functions hits the body. The unicode-fallback
+arm also fires only on terminals without unicode support. */
+/* @__NO_SIDE_EFFECTS__ */
 function getPointingTriangle() {
-  if (_pointingTriangle === void 0) {
-    const supported = (0, import_is_unicode_supported.default)();
-    _pointingTriangle = supported ? "\u25B8" : ">";
-  }
-  return _pointingTriangle;
+	if (_pointingTriangle === void 0) _pointingTriangle = (0, src_external__socketregistry_is_unicode_supported.default)() ? "▸" : ">";
+	return _pointingTriangle;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  customLog,
-  debugByNamespace,
-  getPointingTriangle,
-  getUtil,
-  logger
-});
+/* c8 ignore stop */
+
+//#endregion
+exports.customLog = customLog;
+exports.debugByNamespace = debugByNamespace;
+exports.getPointingTriangle = getPointingTriangle;
+exports.getUtil = require_node_util.getNodeUtil;
+exports.logger = logger;

package/dist/debug/caller-info.js

@@ -1,67 +1,56 @@
 "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 caller_info_exports = {};
-__export(caller_info_exports, {
-  getCallerInfo: () => getCallerInfo
-});
-module.exports = __toCommonJS(caller_info_exports);
-var import_predicates = require("../objects/predicates");
-var import_string = require("../primordials/string");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_objects_predicates = require('../objects/predicates.js');
+
+//#region src/debug/caller-info.ts
+/**
+* @file `getCallerInfo` — extract the caller's function name from the V8 stack
+*   trace at a given offset. Used by every output function to prefix the debug
+*   line with the calling site. Strips V8-injected prefixes (`async`, `bound`,
+*   `Object.`, etc.) so the printed name matches what the developer typed.
+*/
+/**
+* Extract caller information from the stack trace.
+*
+* @private
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function getCallerInfo(stackOffset = 3) {
-  let name = "";
-  const captureStackTrace = Error.captureStackTrace;
-  if (typeof captureStackTrace === "function") {
-    const obj = {};
-    captureStackTrace(obj, getCallerInfo);
-    const stack = obj.stack;
-    if (typeof stack === "string") {
-      let lineCount = 0;
-      let lineStart = 0;
-      for (let i = 0, { length } = stack; i < length; i += 1) {
-        if (stack[i] === "\n") {
-          lineCount += 1;
-          if (lineCount < stackOffset) {
-            lineStart = i + 1;
-          } else {
-            const line = stack.slice(lineStart, i).trimStart();
-            const match = /(?<=^at\s+).*?(?=\s+\(|$)/.exec(line)?.[0];
-            if (match) {
-              name = match.replace(/^(?:async|bound|get|new|set)\s+/, "");
-              if ((0, import_string.StringPrototypeStartsWith)(name, "Object.")) {
-                const afterDot = (0, import_string.StringPrototypeSlice)(name, 7);
-                if (!(0, import_predicates.hasOwn)(Object, afterDot)) {
-                  name = afterDot;
-                }
-              }
-            }
-            break;
-          }
-        }
-      }
-    }
-  }
-  return name;
+	let name = "";
+	const captureStackTrace = Error.captureStackTrace;
+	/* c8 ignore start */
+	if (typeof captureStackTrace === "function") {
+		const obj = {};
+		captureStackTrace(obj, getCallerInfo);
+		const stack = obj.stack;
+		if (typeof stack === "string") {
+			let lineCount = 0;
+			let lineStart = 0;
+			for (let i = 0, { length } = stack; i < length; i += 1) if (stack[i] === "\n") {
+				lineCount += 1;
+				if (lineCount < stackOffset) lineStart = i + 1;
+				else {
+					const line = stack.slice(lineStart, i).trimStart();
+					const match = /(?<=^at\s+).*?(?=\s+\(|$)/.exec(line)?.[0];
+					/* c8 ignore next - Defensive guard; real V8 stack frames
+					always start with 'at '. */
+					if (match) {
+						name = match.replace(/^(?:async|bound|get|new|set)\s+/, "");
+						if (require_primordials_string.StringPrototypeStartsWith(name, "Object.")) {
+							const afterDot = require_primordials_string.StringPrototypeSlice(name, 7);
+							if (!/* @__PURE__ */ require_objects_predicates.hasOwn(Object, afterDot)) name = afterDot;
+						}
+					}
+					break;
+				}
+			}
+		}
+	}
+	/* c8 ignore stop */
+	return name;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getCallerInfo
-});
+
+//#endregion
+exports.getCallerInfo = getCallerInfo;