@socketsecurity/lib 5.28.0 → 6.0.1

package/dist/constants/platform.js

@@ -29,25 +29,18 @@ __export(platform_exports, {
   getPlatform: () => getPlatform
 });
 module.exports = __toCommonJS(platform_exports);
-let _os;
-// @__NO_SIDE_EFFECTS__
-function getOs() {
-  if (_os === void 0) {
-    _os = require("node:os");
-  }
-  return _os;
-}
+var import_os = require("../node/os");
 let _arch;
 function getArch() {
   if (_arch === void 0) {
-    _arch = (/* @__PURE__ */ getOs()).arch();
+    _arch = (0, import_os.getNodeOs)().arch();
   }
   return _arch;
 }
 let _platform;
 function getPlatform() {
   if (_platform === void 0) {
-    _platform = (/* @__PURE__ */ getOs()).platform();
+    _platform = (0, import_os.getNodeOs)().platform();
   }
   return _platform;
 }

package/dist/constants/{core.d.ts → sentinels.d.ts}

@@ -1,8 +1,8 @@
 /**
- * @fileoverview Core primitives and fundamental constants.
- * Holds sentinels, unknown/empty tokens, the internals symbol, and a few
- * shared env-var name strings. Intentionally kept small - prefer moving
- * constants to a more specific `src/constants/*` module when possible.
+ * @file Core primitives and fundamental constants. Holds sentinels,
+ *   unknown/empty tokens, the internals symbol, and a few shared env-var name
+ *   strings. Intentionally kept small - prefer moving constants to a more
+ *   specific `src/constants/*` module when possible.
  */
 export declare const kInternalsSymbol: unique symbol;
 export declare const LOOP_SENTINEL = 1000000;

package/dist/constants/{core.js → sentinels.js}

@@ -18,8 +18,8 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var core_exports = {};
-__export(core_exports, {
+var sentinels_exports = {};
+__export(sentinels_exports, {
   COLUMN_LIMIT: () => COLUMN_LIMIT,
   EMPTY_FILE: () => EMPTY_FILE,
   EMPTY_VALUE: () => EMPTY_VALUE,
@@ -32,7 +32,7 @@ __export(core_exports, {
   V: () => V,
   kInternalsSymbol: () => kInternalsSymbol
 });
-module.exports = __toCommonJS(core_exports);
+module.exports = __toCommonJS(sentinels_exports);
 const kInternalsSymbol = Symbol("@socketregistry.constants.internals");
 const LOOP_SENTINEL = 1e6;
 const UNKNOWN_ERROR = "Unknown error";

package/dist/constants/socket.d.ts

@@ -1,8 +1,7 @@
 /**
- * @fileoverview Socket.dev branding and identifier constants.
- * Centralizes API base URLs, the public API key, website/docs URLs, npm
- * scopes, GitHub org/repo names, and app name strings used across the
- * Socket toolchain.
+ * @file Socket.dev branding and identifier constants. Centralizes API base
+ *   URLs, the public API key, website/docs URLs, npm scopes, GitHub org/repo
+ *   names, and app name strings used across the Socket toolchain.
  */
 export declare const SOCKET_API_BASE_URL = "https://api.socket.dev/v0";
 export declare const SOCKET_PUBLIC_API_KEY = "sktsec_t_--RAN5U4ivauy4w37-6aoKyYPDt5ZbaT5JBVMqiwKo_api";
@@ -26,11 +25,10 @@ export declare const SOCKET_CLI_APP_NAME = "socket";
 export declare const SOCKET_DLX_APP_NAME = "dlx";
 export declare const SOCKET_FIREWALL_APP_NAME = "sfw";
 export declare const SOCKET_REGISTRY_APP_NAME = "registry";
+export declare const SOCKET_WHEELHOUSE_APP_NAME = "wheelhouse";
 export declare const SOCKET_APP_PREFIX = "_";
 export declare const SOCKET_LIB_NAME = "@socketsecurity/lib";
 export declare const SOCKET_LIB_VERSION: string;
-export declare const SOCKET_LIB_URL = "https://github.com/SocketDev/socket-lib";
-export declare const SOCKET_LIB_USER_AGENT: string;
 export declare const SOCKET_IPC_HANDSHAKE = "SOCKET_IPC_HANDSHAKE";
 export declare const CACHE_SOCKET_API_DIR = "socket-api";
 export declare const REGISTRY = "registry";

package/dist/constants/socket.js

@@ -36,8 +36,6 @@ __export(socket_exports, {
   SOCKET_GITHUB_ORG: () => SOCKET_GITHUB_ORG,
   SOCKET_IPC_HANDSHAKE: () => SOCKET_IPC_HANDSHAKE,
   SOCKET_LIB_NAME: () => SOCKET_LIB_NAME,
-  SOCKET_LIB_URL: () => SOCKET_LIB_URL,
-  SOCKET_LIB_USER_AGENT: () => SOCKET_LIB_USER_AGENT,
   SOCKET_LIB_VERSION: () => SOCKET_LIB_VERSION,
   SOCKET_OVERRIDE_SCOPE: () => SOCKET_OVERRIDE_SCOPE,
   SOCKET_PRICING_URL: () => SOCKET_PRICING_URL,
@@ -50,7 +48,8 @@ __export(socket_exports, {
   SOCKET_REGISTRY_SCOPE: () => SOCKET_REGISTRY_SCOPE,
   SOCKET_SECURITY_SCOPE: () => SOCKET_SECURITY_SCOPE,
   SOCKET_STATUS_URL: () => SOCKET_STATUS_URL,
-  SOCKET_WEBSITE_URL: () => SOCKET_WEBSITE_URL
+  SOCKET_WEBSITE_URL: () => SOCKET_WEBSITE_URL,
+  SOCKET_WHEELHOUSE_APP_NAME: () => SOCKET_WHEELHOUSE_APP_NAME
 });
 module.exports = __toCommonJS(socket_exports);
 const SOCKET_API_BASE_URL = "https://api.socket.dev/v0";
@@ -75,11 +74,10 @@ const SOCKET_CLI_APP_NAME = "socket";
 const SOCKET_DLX_APP_NAME = "dlx";
 const SOCKET_FIREWALL_APP_NAME = "sfw";
 const SOCKET_REGISTRY_APP_NAME = "registry";
+const SOCKET_WHEELHOUSE_APP_NAME = "wheelhouse";
 const SOCKET_APP_PREFIX = "_";
 const SOCKET_LIB_NAME = "@socketsecurity/lib";
-const SOCKET_LIB_VERSION = "5.28.0";
-const SOCKET_LIB_URL = "https://github.com/SocketDev/socket-lib";
-const SOCKET_LIB_USER_AGENT = `socketsecurity-lib/${SOCKET_LIB_VERSION} (${SOCKET_LIB_URL})`;
+const SOCKET_LIB_VERSION = "6.0.1";
 const SOCKET_IPC_HANDSHAKE = "SOCKET_IPC_HANDSHAKE";
 const CACHE_SOCKET_API_DIR = "socket-api";
 const REGISTRY = "registry";
@@ -102,8 +100,6 @@ const REGISTRY_SCOPE_DELIMITER = "__";
   SOCKET_GITHUB_ORG,
   SOCKET_IPC_HANDSHAKE,
   SOCKET_LIB_NAME,
-  SOCKET_LIB_URL,
-  SOCKET_LIB_USER_AGENT,
   SOCKET_LIB_VERSION,
   SOCKET_OVERRIDE_SCOPE,
   SOCKET_PRICING_URL,
@@ -116,5 +112,6 @@ const REGISTRY_SCOPE_DELIMITER = "__";
   SOCKET_REGISTRY_SCOPE,
   SOCKET_SECURITY_SCOPE,
   SOCKET_STATUS_URL,
-  SOCKET_WEBSITE_URL
+  SOCKET_WEBSITE_URL,
+  SOCKET_WHEELHOUSE_APP_NAME
 });

package/dist/constants/testing.d.ts

@@ -1,7 +1,7 @@
 /**
- * @fileoverview Testing framework and CI-related string constants.
- * Exports the canonical `TEST`, `VITEST`, `CI`, and `PRE_COMMIT` name
- * strings referenced by env checks and configuration.
+ * @file Testing framework and CI-related string constants. Exports the
+ *   canonical `TEST`, `VITEST`, `CI`, and `PRE_COMMIT` name strings referenced
+ *   by env checks and configuration.
  */
 export declare const TEST = "test";
 export declare const VITEST = "VITEST";

package/dist/constants/time.d.ts

@@ -1,7 +1,7 @@
 /**
- * @fileoverview Time-related numeric constants.
- * Provides millisecond-per-unit multipliers (second/minute/hour/day) and
- * derived cache TTLs such as the DLX binary cache expiration.
+ * @file Time-related numeric constants. Provides millisecond-per-unit
+ *   multipliers (second/minute/hour/day) and derived cache TTLs such as the DLX
+ *   binary cache expiration.
  */
 export declare const MILLISECONDS_PER_SECOND = 1000;
 export declare const MILLISECONDS_PER_MINUTE: number;

package/dist/constants/typescript.d.ts

@@ -1,7 +1,7 @@
 /**
- * @fileoverview TypeScript availability detection.
- * Exports small getters that probe whether the `typescript` package's type
- * definitions and lib files are resolvable from the current project.
+ * @file TypeScript availability detection. Exports small getters that probe
+ *   whether the `typescript` package's type definitions and lib files are
+ *   resolvable from the current project.
  */
 /**
  * Check whether TypeScript's `lib/` directory is resolvable from the current

package/dist/cover/code.d.ts

@@ -1,11 +1,19 @@
 /**
- * @fileoverview Code coverage utilities for parsing v8 coverage data.
+ * @file Code coverage utilities for parsing v8 coverage data.
  */
-import type { CodeCoverageResult, GetCodeCoverageOptions } from './types';
+import type { CodeCoverageResult, CoverageMetric, GetCodeCoverageOptions } from './types';
+/**
+ * Calculate coverage metric with percentage.
+ */
+export declare function calculateMetric(data: {
+    covered: number;
+    total: number;
+}): CoverageMetric;
 /**
  * Get code coverage metrics from v8 coverage-final.json.
  *
- * @throws {Error} When coverage file doesn't exist and generateIfMissing is false.
+ * @throws {Error} When coverage file doesn't exist and generateIfMissing is
+ *   false.
  * @throws {Error} When coverage data format is invalid.
  */
 export declare function getCodeCoverage(options?: GetCodeCoverageOptions | undefined): Promise<CodeCoverageResult>;

package/dist/cover/code.js

@@ -30,16 +30,19 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var code_exports = {};
 __export(code_exports, {
+  calculateMetric: () => calculateMetric,
   getCodeCoverage: () => getCodeCoverage
 });
 module.exports = __toCommonJS(code_exports);
 var import_node_process = __toESM(require("node:process"));
-var import_fs = require("../fs");
-var import_objects = require("../objects");
-var import_spawn = require("../spawn");
-var import_primordials = require("../primordials");
-let _fs;
-let _path;
+var import_read_json = require("../fs/read-json");
+var import_predicates = require("../objects/predicates");
+var import_child = require("../process/spawn/child");
+var import_array = require("../primordials/array");
+var import_error = require("../primordials/error");
+var import_object = require("../primordials/object");
+var import_fs = require("../node/fs");
+var import_path = require("../node/path");
 function calculateMetric(data) {
   const percent = data.total === 0 ? "0.00" : (data.covered / data.total * 100).toFixed(2);
   return {
@@ -48,22 +51,8 @@ function calculateMetric(data) {
     total: data.total
   };
 }
-// @__NO_SIDE_EFFECTS__
-function getFs() {
-  if (_fs === void 0) {
-    _fs = require("node:fs");
-  }
-  return _fs;
-}
-// @__NO_SIDE_EFFECTS__
-function getPath() {
-  if (_path === void 0) {
-    _path = require("node:path");
-  }
-  return _path;
-}
 async function getCodeCoverage(options) {
-  const path = /* @__PURE__ */ getPath();
+  const path = (0, import_path.getNodePath)();
   const opts = {
     __proto__: null,
     coveragePath: path.join(import_node_process.default.cwd(), "coverage/coverage-final.json"),
@@ -72,24 +61,24 @@ async function getCodeCoverage(options) {
   };
   const { coveragePath, generateIfMissing } = opts;
   if (!coveragePath) {
-    throw new import_primordials.ErrorCtor("Coverage path is required");
+    throw new import_error.ErrorCtor("Coverage path is required");
   }
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   if (!fs.existsSync(coveragePath)) {
     if (generateIfMissing) {
-      await (0, import_spawn.spawn)("vitest", ["run", "--coverage"], {
+      await (0, import_child.spawn)("vitest", ["run", "--coverage"], {
         cwd: import_node_process.default.cwd(),
         stdio: "inherit"
       });
     } else {
-      throw new import_primordials.ErrorCtor(
+      throw new import_error.ErrorCtor(
         `Coverage file not found at "${coveragePath}". Run tests with coverage first.`
       );
     }
   }
-  const coverageData = await (0, import_fs.readJson)(coveragePath);
-  if (!(0, import_objects.isObjectObject)(coverageData)) {
-    throw new import_primordials.ErrorCtor(`Invalid coverage data format in "${coveragePath}"`);
+  const coverageData = await (0, import_read_json.readJson)(coveragePath);
+  if (!(0, import_predicates.isPlainObject)(coverageData)) {
+    throw new import_error.ErrorCtor(`Invalid coverage data format in "${coveragePath}"`);
   }
   const totals = {
     __proto__: null,
@@ -99,13 +88,13 @@ async function getCodeCoverage(options) {
     statements: { __proto__: null, covered: 0, total: 0 }
   };
   const v8Data = coverageData;
-  for (const fileCoverage of (0, import_primordials.ObjectValues)(v8Data)) {
-    if (!(0, import_objects.isObjectObject)(fileCoverage)) {
+  for (const fileCoverage of (0, import_object.ObjectValues)(v8Data)) {
+    if (!(0, import_predicates.isPlainObject)(fileCoverage)) {
       continue;
     }
     const fc = fileCoverage;
-    if (fc.s && (0, import_objects.isObjectObject)(fc.s)) {
-      const statementCounts = (0, import_primordials.ObjectValues)(fc.s);
+    if (fc.s && (0, import_predicates.isPlainObject)(fc.s)) {
+      const statementCounts = (0, import_object.ObjectValues)(fc.s);
       for (const count of statementCounts) {
         if (typeof count === "number") {
           totals.statements.total += 1;
@@ -115,10 +104,10 @@ async function getCodeCoverage(options) {
         }
       }
     }
-    if (fc.b && (0, import_objects.isObjectObject)(fc.b)) {
-      const branchCounts = (0, import_primordials.ObjectValues)(fc.b);
+    if (fc.b && (0, import_predicates.isPlainObject)(fc.b)) {
+      const branchCounts = (0, import_object.ObjectValues)(fc.b);
       for (const branches of branchCounts) {
-        if ((0, import_primordials.ArrayIsArray)(branches)) {
+        if ((0, import_array.ArrayIsArray)(branches)) {
           for (const count of branches) {
             if (typeof count === "number") {
               totals.branches.total += 1;
@@ -130,8 +119,8 @@ async function getCodeCoverage(options) {
         }
       }
     }
-    if (fc.f && (0, import_objects.isObjectObject)(fc.f)) {
-      const functionCounts = (0, import_primordials.ObjectValues)(fc.f);
+    if (fc.f && (0, import_predicates.isPlainObject)(fc.f)) {
+      const functionCounts = (0, import_object.ObjectValues)(fc.f);
       for (const count of functionCounts) {
         if (typeof count === "number") {
           totals.functions.total += 1;
@@ -153,5 +142,6 @@ async function getCodeCoverage(options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  calculateMetric,
   getCodeCoverage
 });

package/dist/cover/formatters.d.ts

@@ -1,30 +1,34 @@
 /**
- * @fileoverview Coverage output formatters.
+ * @file Coverage output formatters.
  */
 import type { FormatCoverageOptions } from './types';
+/**
+ * Calculate overall coverage percentage.
+ */
+export declare function calculateOverall(code: FormatCoverageOptions['code'], type: FormatCoverageOptions['type']): string;
 /**
  * Format coverage data for console output.
  *
  * @example
- * ```typescript
- * const output = formatCoverage({
- *   code: {
- *     statements: { percent: '85.00' },
- *     branches: { percent: '80.00' },
- *     functions: { percent: '90.00' },
- *     lines: { percent: '88.00' },
- *   },
- * })
- * ```
+ *   ;```typescript
+ *   const output = formatCoverage({
+ *     code: {
+ *       statements: { percent: '85.00' },
+ *       branches: { percent: '80.00' },
+ *       functions: { percent: '90.00' },
+ *       lines: { percent: '88.00' },
+ *     },
+ *   })
+ *   ```
  */
 export declare function formatCoverage(options: FormatCoverageOptions): string;
 /**
  * Get emoji for coverage percentage.
  *
  * @example
- * ```typescript
- * getCoverageEmoji(95)  // ' \u{1F3AF}'
- * getCoverageEmoji(50)  // ' \u{1F528}'
- * ```
+ *   ;```typescript
+ *   getCoverageEmoji(95) // ' \u{1F3AF}'
+ *   getCoverageEmoji(50) // ' \u{1F528}'
+ *   ```
  */
 export declare function getCoverageEmoji(percent: number): string;

package/dist/cover/formatters.js

@@ -20,12 +20,14 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var formatters_exports = {};
 __export(formatters_exports, {
+  calculateOverall: () => calculateOverall,
   formatCoverage: () => formatCoverage,
   getCoverageEmoji: () => getCoverageEmoji
 });
 module.exports = __toCommonJS(formatters_exports);
-var import_strings = require("../strings");
-var import_primordials = require("../primordials");
+var import_format = require("../strings/format");
+var import_json = require("../primordials/json");
+var import_number = require("../primordials/number");
 const COVERAGE_EMOJI_THRESHOLDS = [
   { emoji: " \u{1F680}", threshold: 99 },
   { emoji: " \u{1F3AF}", threshold: 95 },
@@ -39,17 +41,17 @@ const COVERAGE_EMOJI_THRESHOLDS = [
 ];
 function calculateOverall(code, type) {
   const metrics = [
-    (0, import_primordials.NumberParseFloat)(code.statements.percent),
-    (0, import_primordials.NumberParseFloat)(code.branches.percent),
-    (0, import_primordials.NumberParseFloat)(code.functions.percent),
-    (0, import_primordials.NumberParseFloat)(code.lines.percent)
-  ].map((val) => (0, import_primordials.NumberIsNaN)(val) ? 0 : val);
+    (0, import_number.NumberParseFloat)(code.statements.percent),
+    (0, import_number.NumberParseFloat)(code.branches.percent),
+    (0, import_number.NumberParseFloat)(code.functions.percent),
+    (0, import_number.NumberParseFloat)(code.lines.percent)
+  ].map((val) => (0, import_number.NumberIsNaN)(val) ? 0 : val);
   if (type) {
-    const typePercent = (0, import_primordials.NumberParseFloat)(type.percent);
-    metrics.push((0, import_primordials.NumberIsNaN)(typePercent) ? 0 : typePercent);
+    const typePercent = (0, import_number.NumberParseFloat)(type.percent);
+    metrics.push((0, import_number.NumberIsNaN)(typePercent) ? 0 : typePercent);
   }
   const average = metrics.reduce((sum, val) => sum + val, 0) / metrics.length;
-  return (0, import_primordials.NumberPrototypeToFixed)(average, 2);
+  return (0, import_number.NumberPrototypeToFixed)(average, 2);
 }
 function formatCoverage(options) {
   const opts = {
@@ -59,7 +61,7 @@ function formatCoverage(options) {
   };
   const { code, format, type } = opts;
   if (format === "json") {
-    return (0, import_primordials.JSONStringify)({ code, type }, null, 2);
+    return (0, import_json.JSONStringify)({ code, type }, void 0, 2);
   }
   const overall = calculateOverall(code, type);
   if (format === "simple") {
@@ -67,28 +69,28 @@ function formatCoverage(options) {
   }
   let output = "";
   output += "Code Coverage:\n";
-  output += (0, import_strings.indentString)(`Statements: ${code.statements.percent}%
+  output += (0, import_format.indentString)(`Statements: ${code.statements.percent}%
 `, {
     count: 2
   });
-  output += (0, import_strings.indentString)(`Branches: ${code.branches.percent}%
+  output += (0, import_format.indentString)(`Branches: ${code.branches.percent}%
 `, { count: 2 });
-  output += (0, import_strings.indentString)(`Functions: ${code.functions.percent}%
+  output += (0, import_format.indentString)(`Functions: ${code.functions.percent}%
 `, {
     count: 2
   });
-  output += (0, import_strings.indentString)(`Lines: ${code.lines.percent}%
+  output += (0, import_format.indentString)(`Lines: ${code.lines.percent}%
 `, { count: 2 });
   if (type) {
     output += "\nType Coverage:\n";
-    output += (0, import_strings.indentString)(
+    output += (0, import_format.indentString)(
       `${type.percent}% (${type.covered}/${type.total})
 `,
       { count: 2 }
     );
   }
-  const overallValue = (0, import_primordials.NumberParseFloat)(overall);
-  const emoji = getCoverageEmoji((0, import_primordials.NumberIsNaN)(overallValue) ? 0 : overallValue);
+  const overallValue = (0, import_number.NumberParseFloat)(overall);
+  const emoji = getCoverageEmoji((0, import_number.NumberIsNaN)(overallValue) ? 0 : overallValue);
   output += `
 Overall: ${overall}%${emoji}
 `;
@@ -102,6 +104,7 @@ function getCoverageEmoji(percent) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  calculateOverall,
   formatCoverage,
   getCoverageEmoji
 });

package/dist/cover/type.d.ts

@@ -1,10 +1,11 @@
 /**
- * @fileoverview TypeScript type coverage utilities.
+ * @file TypeScript type coverage utilities.
  */
 import type { GetTypeCoverageOptions, TypeCoverageResult } from './types';
 /**
  * Get TypeScript type coverage metrics.
  *
- * @throws {Error} When type-coverage command fails (if generateIfMissing is false).
+ * @throws {Error} When type-coverage command fails (if generateIfMissing is
+ *   false).
  */
-export declare function getTypeCoverage(options?: GetTypeCoverageOptions | undefined): Promise<TypeCoverageResult | null>;
+export declare function getTypeCoverage(options?: GetTypeCoverageOptions | undefined): Promise<TypeCoverageResult | undefined>;

package/dist/cover/type.js

@@ -34,8 +34,9 @@ __export(type_exports, {
 });
 module.exports = __toCommonJS(type_exports);
 var import_node_process = __toESM(require("node:process"));
-var import_spawn = require("../spawn");
-var import_primordials = require("../primordials");
+var import_child = require("../process/spawn/child");
+var import_error = require("../primordials/error");
+var import_number = require("../primordials/number");
 async function getTypeCoverage(options) {
   const opts = {
     __proto__: null,
@@ -45,31 +46,31 @@ async function getTypeCoverage(options) {
   };
   const { cwd, generateIfMissing } = opts;
   if (!cwd) {
-    throw new import_primordials.ErrorCtor("Working directory is required.");
+    throw new import_error.ErrorCtor("Working directory is required.");
   }
   try {
-    const result = await (0, import_spawn.spawn)("type-coverage", ["--detail"], {
+    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 null;
+      return void 0;
     }
     return {
-      covered: (0, import_primordials.NumberParseInt)(match[1], 10),
+      covered: (0, import_number.NumberParseInt)(match[1], 10),
       percent: match[3],
-      total: (0, import_primordials.NumberParseInt)(match[2], 10)
+      total: (0, import_number.NumberParseInt)(match[2], 10)
     };
   } catch (e) {
     if (generateIfMissing) {
-      throw new import_primordials.ErrorCtor(
+      throw new import_error.ErrorCtor(
         "Unable to generate type coverage. Ensure type-coverage is installed.",
         { cause: e }
       );
     }
-    return null;
+    return void 0;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cover/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Type definitions for coverage utilities.
+ * @file Type definitions for coverage utilities.
  */
 /**
  * Code coverage metrics for a single category.

package/dist/crypto/hash.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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.
+ */
+/**
+ * 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=='
+ *   ```
+ */
+export declare function hash(algorithm: string, data: string | NodeJS.ArrayBufferView, outputEncoding: 'hex' | 'base64' | 'base64url' | 'binary'): string;
+/**
+ * Resolve `crypto.hash` (or `undefined` if the runtime predates it).
+ *
+ * Exported for unit tests; not part of the public API.
+ *
+ * @internal
+ */
+export declare function nativeHash(): typeof import('node:crypto').hash | undefined;

package/dist/{crypto.js → crypto/hash.js}

@@ -18,17 +18,25 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var crypto_exports = {};
-__export(crypto_exports, {
-  getNativeHash: () => getNativeHash,
-  hash: () => hash
+var hash_exports = {};
+__export(hash_exports, {
+  hash: () => hash,
+  nativeHash: () => nativeHash
 });
-module.exports = __toCommonJS(crypto_exports);
-var import_crypto = require("./node/crypto");
+module.exports = __toCommonJS(hash_exports);
+var import_crypto = require("../node/crypto");
 let _hash;
 let _hashProbed = false;
 // @__NO_SIDE_EFFECTS__
-function getNativeHash() {
+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);
+}
+// @__NO_SIDE_EFFECTS__
+function nativeHash() {
   if (!_hashProbed) {
     const fn = (0, import_crypto.getNodeCrypto)().hash;
     if (typeof fn === "function") {
@@ -38,16 +46,8 @@ function getNativeHash() {
   }
   return _hash;
 }
-// @__NO_SIDE_EFFECTS__
-function hash(algorithm, data, outputEncoding) {
-  const native = /* @__PURE__ */ getNativeHash();
-  if (native !== void 0) {
-    return native(algorithm, data, outputEncoding);
-  }
-  return (0, import_crypto.getNodeCrypto)().createHash(algorithm).update(data).digest(outputEncoding);
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  getNativeHash,
-  hash
+  hash,
+  nativeHash
 });