@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/constants/typescript.js

@@ -1,57 +1,37 @@
 "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 typescript_exports = {};
-__export(typescript_exports, {
-  getTsLibsAvailable: () => getTsLibsAvailable,
-  getTsTypesAvailable: () => getTsTypesAvailable
-});
-module.exports = __toCommonJS(typescript_exports);
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/constants/typescript.ts
+/**
+* @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
+* project by probing `typescript/lib`.
+*
+* @returns `true` when the `typescript` package's libs can be resolved.
+*/
 function getTsLibsAvailable() {
-  try {
-    require.resolve("typescript/lib");
-    return true;
-  } catch {
-    return false;
-  }
+	try {
+		require.resolve("typescript/lib");
+		return true;
+	} catch {
+		return false;
+	}
 }
 function getTsTypesAvailable() {
-  try {
-    require.resolve("typescript/lib/lib.d.ts");
-    return true;
-  } catch {
-    return false;
-  }
+	try {
+		require.resolve("typescript/lib/lib.d.ts");
+		return true;
+	} catch {
+		return false;
+	}
+	/* c8 ignore stop */
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getTsLibsAvailable,
-  getTsTypesAvailable
-});
+
+//#endregion
+exports.getTsLibsAvailable = getTsLibsAvailable;
+exports.getTsTypesAvailable = getTsTypesAvailable;

package/dist/cover/code.js

@@ -1,147 +1,116 @@
 "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 code_exports = {};
-__export(code_exports, {
-  calculateMetric: () => calculateMetric,
-  getCodeCoverage: () => getCodeCoverage
-});
-module.exports = __toCommonJS(code_exports);
-var import_node_process = __toESM(require("node:process"));
-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");
+/* 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_array = require('../primordials/array.js');
+const require_node_fs = require('../node/fs.js');
+const require_node_path = require('../node/path.js');
+const require_primordials_object = require('../primordials/object.js');
+const require_fs_read_json = require('../fs/read-json.js');
+const require_objects_predicates = require('../objects/predicates.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/code.ts
+/**
+* @file Code coverage utilities for parsing v8 coverage data.
+*/
+/**
+* Calculate coverage metric with percentage.
+*/
 function calculateMetric(data) {
-  const percent = data.total === 0 ? "0.00" : (data.covered / data.total * 100).toFixed(2);
-  return {
-    covered: data.covered,
-    percent,
-    total: data.total
-  };
+	const percent = data.total === 0 ? "0.00" : (data.covered / data.total * 100).toFixed(2);
+	return {
+		covered: data.covered,
+		percent,
+		total: data.total
+	};
 }
+/**
+* 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 data format is invalid.
+*/
 async function getCodeCoverage(options) {
-  const path = (0, import_path.getNodePath)();
-  const opts = {
-    __proto__: null,
-    coveragePath: path.join(import_node_process.default.cwd(), "coverage/coverage-final.json"),
-    generateIfMissing: false,
-    ...options
-  };
-  const { coveragePath, generateIfMissing } = opts;
-  if (!coveragePath) {
-    throw new import_error.ErrorCtor("Coverage path is required");
-  }
-  const fs = (0, import_fs.getNodeFs)();
-  if (!fs.existsSync(coveragePath)) {
-    if (generateIfMissing) {
-      await (0, import_child.spawn)("vitest", ["run", "--coverage"], {
-        cwd: import_node_process.default.cwd(),
-        stdio: "inherit"
-      });
-    } else {
-      throw new import_error.ErrorCtor(
-        `Coverage file not found at "${coveragePath}". Run tests with coverage first.`
-      );
-    }
-  }
-  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,
-    branches: { __proto__: null, covered: 0, total: 0 },
-    functions: { __proto__: null, covered: 0, total: 0 },
-    lines: { __proto__: null, covered: 0, total: 0 },
-    statements: { __proto__: null, covered: 0, total: 0 }
-  };
-  const v8Data = coverageData;
-  for (const fileCoverage of (0, import_object.ObjectValues)(v8Data)) {
-    if (!(0, import_predicates.isPlainObject)(fileCoverage)) {
-      continue;
-    }
-    const fc = fileCoverage;
-    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;
-          if (count > 0) {
-            totals.statements.covered += 1;
-          }
-        }
-      }
-    }
-    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_array.ArrayIsArray)(branches)) {
-          for (const count of branches) {
-            if (typeof count === "number") {
-              totals.branches.total += 1;
-              if (count > 0) {
-                totals.branches.covered += 1;
-              }
-            }
-          }
-        }
-      }
-    }
-    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;
-          if (count > 0) {
-            totals.functions.covered += 1;
-          }
-        }
-      }
-    }
-    totals.lines.covered = totals.statements.covered;
-    totals.lines.total = totals.statements.total;
-  }
-  return {
-    branches: calculateMetric(totals.branches),
-    functions: calculateMetric(totals.functions),
-    lines: calculateMetric(totals.lines),
-    statements: calculateMetric(totals.statements)
-  };
+	const { coveragePath, generateIfMissing } = {
+		__proto__: null,
+		coveragePath: (/* @__PURE__ */ require_node_path.getNodePath()).join(node_process.default.cwd(), "coverage/coverage-final.json"),
+		generateIfMissing: false,
+		...options
+	};
+	if (!coveragePath) throw new require_primordials_error.ErrorCtor("Coverage path is required");
+	if (!(/* @__PURE__ */ require_node_fs.getNodeFs()).existsSync(coveragePath)) if (generateIfMissing) await require_process_spawn_child.spawn("vitest", ["run", "--coverage"], {
+		cwd: node_process.default.cwd(),
+		stdio: "inherit"
+	});
+	else throw new require_primordials_error.ErrorCtor(`Coverage file not found at "${coveragePath}". Run tests with coverage first.`);
+	const coverageData = await /* @__PURE__ */ require_fs_read_json.readJson(coveragePath);
+	if (!/* @__PURE__ */ require_objects_predicates.isPlainObject(coverageData)) throw new require_primordials_error.ErrorCtor(`Invalid coverage data format in "${coveragePath}"`);
+	const totals = {
+		__proto__: null,
+		branches: {
+			__proto__: null,
+			covered: 0,
+			total: 0
+		},
+		functions: {
+			__proto__: null,
+			covered: 0,
+			total: 0
+		},
+		lines: {
+			__proto__: null,
+			covered: 0,
+			total: 0
+		},
+		statements: {
+			__proto__: null,
+			covered: 0,
+			total: 0
+		}
+	};
+	const v8Data = coverageData;
+	for (const fileCoverage of require_primordials_object.ObjectValues(v8Data)) {
+		if (!/* @__PURE__ */ require_objects_predicates.isPlainObject(fileCoverage)) continue;
+		const fc = fileCoverage;
+		if (fc.s && /* @__PURE__ */ require_objects_predicates.isPlainObject(fc.s)) {
+			const statementCounts = require_primordials_object.ObjectValues(fc.s);
+			for (const count of statementCounts) if (typeof count === "number") {
+				totals.statements.total += 1;
+				if (count > 0) totals.statements.covered += 1;
+			}
+		}
+		if (fc.b && /* @__PURE__ */ require_objects_predicates.isPlainObject(fc.b)) {
+			const branchCounts = require_primordials_object.ObjectValues(fc.b);
+			for (const branches of branchCounts) if (require_primordials_array.ArrayIsArray(branches)) {
+				for (const count of branches) if (typeof count === "number") {
+					totals.branches.total += 1;
+					if (count > 0) totals.branches.covered += 1;
+				}
+			}
+		}
+		if (fc.f && /* @__PURE__ */ require_objects_predicates.isPlainObject(fc.f)) {
+			const functionCounts = require_primordials_object.ObjectValues(fc.f);
+			for (const count of functionCounts) if (typeof count === "number") {
+				totals.functions.total += 1;
+				if (count > 0) totals.functions.covered += 1;
+			}
+		}
+		totals.lines.covered = totals.statements.covered;
+		totals.lines.total = totals.statements.total;
+	}
+	return {
+		branches: calculateMetric(totals.branches),
+		functions: calculateMetric(totals.functions),
+		lines: calculateMetric(totals.lines),
+		statements: calculateMetric(totals.statements)
+	};
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  calculateMetric,
-  getCodeCoverage
-});
+
+//#endregion
+exports.calculateMetric = calculateMetric;
+exports.getCodeCoverage = getCodeCoverage;

package/dist/cover/formatters.js

@@ -1,110 +1,127 @@
 "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 formatters_exports = {};
-__export(formatters_exports, {
-  calculateOverall: () => calculateOverall,
-  formatCoverage: () => formatCoverage,
-  getCoverageEmoji: () => getCoverageEmoji
-});
-module.exports = __toCommonJS(formatters_exports);
-var import_format = require("../strings/format");
-var import_json = require("../primordials/json");
-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');
+const require_primordials_json = require('../primordials/json.js');
+const require_strings_format = require('../strings/format.js');
+
+//#region src/cover/formatters.ts
+/**
+* @file Coverage output formatters.
+*/
+/**
+* Coverage emoji thresholds for visual feedback.
+*/
 const COVERAGE_EMOJI_THRESHOLDS = [
-  { emoji: " \u{1F680}", threshold: 99 },
-  { emoji: " \u{1F3AF}", threshold: 95 },
-  { emoji: " \u2728", threshold: 90 },
-  { emoji: " \u{1F49A}", threshold: 85 },
-  { emoji: " \u2705", threshold: 80 },
-  { emoji: " \u{1F7E2}", threshold: 70 },
-  { emoji: " \u{1F7E1}", threshold: 60 },
-  { emoji: " \u{1F528}", threshold: 50 },
-  { emoji: " \u26A0\uFE0F", threshold: 0 }
+	{
+		emoji: " 🚀",
+		threshold: 99
+	},
+	{
+		emoji: " 🎯",
+		threshold: 95
+	},
+	{
+		emoji: " ✨",
+		threshold: 90
+	},
+	{
+		emoji: " 💚",
+		threshold: 85
+	},
+	{
+		emoji: " ✅",
+		threshold: 80
+	},
+	{
+		emoji: " 🟢",
+		threshold: 70
+	},
+	{
+		emoji: " 🟡",
+		threshold: 60
+	},
+	{
+		emoji: " 🔨",
+		threshold: 50
+	},
+	{
+		emoji: " ⚠️",
+		threshold: 0
+	}
 ];
+/**
+* Calculate overall coverage percentage.
+*/
 function calculateOverall(code, type) {
-  const metrics = [
-    (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_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_number.NumberPrototypeToFixed)(average, 2);
+	const metrics = [
+		require_primordials_number.NumberParseFloat(code.statements.percent),
+		require_primordials_number.NumberParseFloat(code.branches.percent),
+		require_primordials_number.NumberParseFloat(code.functions.percent),
+		require_primordials_number.NumberParseFloat(code.lines.percent)
+	].map((val) => require_primordials_number.NumberIsNaN(val) ? 0 : val);
+	if (type) {
+		const typePercent = require_primordials_number.NumberParseFloat(type.percent);
+		metrics.push(require_primordials_number.NumberIsNaN(typePercent) ? 0 : typePercent);
+	}
+	return require_primordials_number.NumberPrototypeToFixed(metrics.reduce((sum, val) => sum + val, 0) / metrics.length, 2);
 }
+/**
+* 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' },
+*     },
+*   })
+*   ```
+*/
 function formatCoverage(options) {
-  const opts = {
-    __proto__: null,
-    format: "default",
-    ...options
-  };
-  const { code, format, type } = opts;
-  if (format === "json") {
-    return (0, import_json.JSONStringify)({ code, type }, void 0, 2);
-  }
-  const overall = calculateOverall(code, type);
-  if (format === "simple") {
-    return overall;
-  }
-  let output = "";
-  output += "Code Coverage:\n";
-  output += (0, import_format.indentString)(`Statements: ${code.statements.percent}%
-`, {
-    count: 2
-  });
-  output += (0, import_format.indentString)(`Branches: ${code.branches.percent}%
-`, { count: 2 });
-  output += (0, import_format.indentString)(`Functions: ${code.functions.percent}%
-`, {
-    count: 2
-  });
-  output += (0, import_format.indentString)(`Lines: ${code.lines.percent}%
-`, { count: 2 });
-  if (type) {
-    output += "\nType Coverage:\n";
-    output += (0, import_format.indentString)(
-      `${type.percent}% (${type.covered}/${type.total})
-`,
-      { count: 2 }
-    );
-  }
-  const overallValue = (0, import_number.NumberParseFloat)(overall);
-  const emoji = getCoverageEmoji((0, import_number.NumberIsNaN)(overallValue) ? 0 : overallValue);
-  output += `
-Overall: ${overall}%${emoji}
-`;
-  return output;
+	const { code, format, type } = {
+		__proto__: null,
+		format: "default",
+		...options
+	};
+	if (format === "json") return require_primordials_json.JSONStringify({
+		code,
+		type
+	}, void 0, 2);
+	const overall = calculateOverall(code, type);
+	if (format === "simple") return overall;
+	let output = "";
+	output += "Code Coverage:\n";
+	output += /* @__PURE__ */ require_strings_format.indentString(`Statements: ${code.statements.percent}%\n`, { count: 2 });
+	output += /* @__PURE__ */ require_strings_format.indentString(`Branches: ${code.branches.percent}%\n`, { count: 2 });
+	output += /* @__PURE__ */ require_strings_format.indentString(`Functions: ${code.functions.percent}%\n`, { count: 2 });
+	output += /* @__PURE__ */ require_strings_format.indentString(`Lines: ${code.lines.percent}%\n`, { count: 2 });
+	if (type) {
+		output += "\nType Coverage:\n";
+		output += /* @__PURE__ */ require_strings_format.indentString(`${type.percent}% (${type.covered}/${type.total})\n`, { count: 2 });
+	}
+	const overallValue = require_primordials_number.NumberParseFloat(overall);
+	const emoji = getCoverageEmoji(require_primordials_number.NumberIsNaN(overallValue) ? 0 : overallValue);
+	output += `\nOverall: ${overall}%${emoji}\n`;
+	return output;
 }
+/**
+* Get emoji for coverage percentage.
+*
+* @example
+*   ;```typescript
+*   getCoverageEmoji(95) // ' \u{1F3AF}'
+*   getCoverageEmoji(50) // ' \u{1F528}'
+*   ```
+*/
 function getCoverageEmoji(percent) {
-  const entry = COVERAGE_EMOJI_THRESHOLDS.find(
-    ({ threshold }) => percent >= threshold
-  );
-  return entry?.emoji || "";
+	return COVERAGE_EMOJI_THRESHOLDS.find(({ threshold }) => percent >= threshold)?.emoji || "";
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  calculateOverall,
-  formatCoverage,
-  getCoverageEmoji
-});
+
+//#endregion
+exports.calculateOverall = calculateOverall;
+exports.formatCoverage = formatCoverage;
+exports.getCoverageEmoji = getCoverageEmoji;