@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/perf/timer.js

@@ -1,137 +1,191 @@
 "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 timer_exports = {};
-__export(timer_exports, {
-  measure: () => measure,
-  measureSync: () => measureSync,
-  perfCheckpoint: () => perfCheckpoint,
-  perfTimer: () => perfTimer,
-  trackMemory: () => trackMemory
-});
-module.exports = __toCommonJS(timer_exports);
-var import_node_process = __toESM(require("node:process"));
-var import_output = require("../debug/output");
-var import_message = require("../errors/message");
-var import_date = require("../primordials/date");
-var import_math = require("../primordials/math");
-var import_internal = require("./_internal");
-var import_enabled = require("./enabled");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_primordials_math = require('../primordials/math.js');
+const require_primordials_date = require('../primordials/date.js');
+const require_errors_message = require('../errors/message.js');
+const require_debug_output = require('../debug/output.js');
+const require_perf__internal = require('./_internal.js');
+const require_perf_enabled = require('./enabled.js');
+let node_process = require("node:process");
+node_process = require_runtime.__toESM(node_process);
+
+//#region src/perf/timer.ts
+/**
+* @file Recording-side helpers — `perfTimer` (returns a stop() closure),
+*   `measure` / `measureSync` (timed wrappers around an async / sync function),
+*   `perfCheckpoint` (zero-duration marker), and `trackMemory` (records
+*   heap-used at a label). All push rows into the shared metrics array when
+*   `isPerfEnabled()` is true.
+*/
+/**
+* Measure execution time of an async function.
+*
+* @example
+*   import { measure } from '@socketsecurity/lib/perf/timer'
+*
+*   const { result, duration } = await measure('fetch-packages', async () => {
+*     return await fetchPackages()
+*   })
+*   console.log(`Fetched packages in ${duration}ms`)
+*
+* @param operation - Name of the operation.
+* @param fn - Async function to measure.
+* @param metadata - Optional metadata.
+*
+* @returns Result of the function and duration
+*/
 async function measure(operation, fn, metadata) {
-  const stop = perfTimer(operation, metadata);
-  try {
-    const result = await fn();
-    stop({ success: true });
-    const metric = import_internal.performanceMetrics[import_internal.performanceMetrics.length - 1];
-    return { result, duration: metric?.duration || 0 };
-  } catch (e) {
-    stop({
-      success: false,
-      error: (0, import_message.errorMessage)(e)
-    });
-    throw e;
-  }
+	const stop = perfTimer(operation, metadata);
+	try {
+		const result = await fn();
+		stop({ success: true });
+		return {
+			result,
+			duration: require_perf__internal.performanceMetrics[require_perf__internal.performanceMetrics.length - 1]?.duration || 0
+		};
+	} catch (e) {
+		stop({
+			success: false,
+			error: require_errors_message.errorMessage(e)
+		});
+		throw e;
+	}
 }
+/**
+* Measure synchronous function execution time.
+*
+* @example
+*   import { measureSync } from '@socketsecurity/lib/perf/timer'
+*
+*   const { result, duration } = measureSync('parse-json', () => {
+*     return JSON.parse(data)
+*   })
+*
+* @param operation - Name of the operation.
+* @param fn - Synchronous function to measure.
+* @param metadata - Optional metadata.
+*
+* @returns Result of the function and duration
+*/
 function measureSync(operation, fn, metadata) {
-  const stop = perfTimer(operation, metadata);
-  try {
-    const result = fn();
-    stop({ success: true });
-    const metric = import_internal.performanceMetrics[import_internal.performanceMetrics.length - 1];
-    return { result, duration: metric?.duration || 0 };
-  } catch (e) {
-    stop({
-      success: false,
-      error: (0, import_message.errorMessage)(e)
-    });
-    throw e;
-  }
+	const stop = perfTimer(operation, metadata);
+	try {
+		const result = fn();
+		stop({ success: true });
+		return {
+			result,
+			duration: require_perf__internal.performanceMetrics[require_perf__internal.performanceMetrics.length - 1]?.duration || 0
+		};
+	} catch (e) {
+		stop({
+			success: false,
+			error: require_errors_message.errorMessage(e)
+		});
+		throw e;
+	}
 }
+/**
+* Mark a checkpoint in performance tracking. Useful for tracking progress
+* through complex operations.
+*
+* @example
+*   import { perfCheckpoint } from '@socketsecurity/lib/perf/timer'
+*
+*   perfCheckpoint('start-scan')
+*   // ... do work ...
+*   perfCheckpoint('fetch-packages', { count: 50 })
+*   // ... do work ...
+*   perfCheckpoint('analyze-issues', { issueCount: 10 })
+*   perfCheckpoint('end-scan')
+*
+* @param checkpoint - Name of the checkpoint.
+* @param metadata - Optional metadata.
+*/
 function perfCheckpoint(checkpoint, metadata) {
-  if (!(0, import_enabled.isPerfEnabled)()) {
-    return;
-  }
-  const metric = {
-    operation: `checkpoint:${checkpoint}`,
-    duration: 0,
-    timestamp: (0, import_date.DateNow)(),
-    ...metadata ? { metadata } : {}
-  };
-  import_internal.performanceMetrics.push(metric);
-  (0, import_output.debugLog)(`[perf] [CHECKPOINT] ${checkpoint}`);
+	if (!require_perf_enabled.isPerfEnabled()) return;
+	const metric = {
+		operation: `checkpoint:${checkpoint}`,
+		duration: 0,
+		timestamp: require_primordials_date.DateNow(),
+		...metadata ? { metadata } : {}
+	};
+	require_perf__internal.performanceMetrics.push(metric);
+	require_debug_output.debugLog(`[perf] [CHECKPOINT] ${checkpoint}`);
 }
+/**
+* Start a performance timer for an operation. Returns a stop function that
+* records the duration.
+*
+* @example
+*   import { perfTimer } from '@socketsecurity/lib/perf/timer'
+*
+*   const stop = perfTimer('api-call')
+*   await fetchData()
+*   stop({ endpoint: '/npm/lodash/score' })
+*
+* @param operation - Name of the operation being timed.
+* @param metadata - Optional metadata to attach to the metric.
+*
+* @returns Stop function that completes the timing
+*/
 function perfTimer(operation, metadata) {
-  if (!(0, import_enabled.isPerfEnabled)()) {
-    return () => {
-    };
-  }
-  const start = performance.now();
-  (0, import_output.debugLog)(`[perf] [START] ${operation}`);
-  return (additionalMetadata) => {
-    const duration = performance.now() - start;
-    const metric = {
-      operation,
-      // Round to 2 decimals
-      duration: (0, import_math.MathRound)(duration * 100) / 100,
-      timestamp: (0, import_date.DateNow)(),
-      metadata: { ...metadata, ...additionalMetadata }
-    };
-    import_internal.performanceMetrics.push(metric);
-    (0, import_output.debugLog)(`[perf] [END] ${operation} - ${metric.duration}ms`);
-  };
+	if (!require_perf_enabled.isPerfEnabled()) return () => {};
+	const start = performance.now();
+	require_debug_output.debugLog(`[perf] [START] ${operation}`);
+	return (additionalMetadata) => {
+		const metric = {
+			operation,
+			duration: require_primordials_math.MathRound((performance.now() - start) * 100) / 100,
+			timestamp: require_primordials_date.DateNow(),
+			metadata: {
+				...metadata,
+				...additionalMetadata
+			}
+		};
+		require_perf__internal.performanceMetrics.push(metric);
+		require_debug_output.debugLog(`[perf] [END] ${operation} - ${metric.duration}ms`);
+	};
 }
+/**
+* Track memory usage at a specific point. Only available when DEBUG=perf is
+* enabled.
+*
+* @example
+*   import { trackMemory } from '@socketsecurity/lib/perf/timer'
+*
+*   const memBefore = trackMemory('before-operation')
+*   await heavyOperation()
+*   const memAfter = trackMemory('after-operation')
+*   console.log(`Memory increased by ${memAfter - memBefore}MB`)
+*
+* @param label - Label for this memory snapshot.
+*
+* @returns Memory usage in MB
+*/
 function trackMemory(label) {
-  if (!(0, import_enabled.isPerfEnabled)()) {
-    return 0;
-  }
-  const usage = import_node_process.default.memoryUsage();
-  const heapUsedMB = (0, import_math.MathRound)(usage.heapUsed / 1024 / 1024 * 100) / 100;
-  (0, import_output.debugLog)(`[perf] [MEMORY] ${label}: ${heapUsedMB}MB heap used`);
-  const metric = {
-    operation: `checkpoint:memory:${label}`,
-    duration: 0,
-    timestamp: (0, import_date.DateNow)(),
-    metadata: {
-      heapUsed: heapUsedMB,
-      heapTotal: (0, import_math.MathRound)(usage.heapTotal / 1024 / 1024 * 100) / 100,
-      external: (0, import_math.MathRound)(usage.external / 1024 / 1024 * 100) / 100
-    }
-  };
-  import_internal.performanceMetrics.push(metric);
-  return heapUsedMB;
+	if (!require_perf_enabled.isPerfEnabled()) return 0;
+	const usage = node_process.default.memoryUsage();
+	const heapUsedMB = require_primordials_math.MathRound(usage.heapUsed / 1024 / 1024 * 100) / 100;
+	require_debug_output.debugLog(`[perf] [MEMORY] ${label}: ${heapUsedMB}MB heap used`);
+	const metric = {
+		operation: `checkpoint:memory:${label}`,
+		duration: 0,
+		timestamp: require_primordials_date.DateNow(),
+		metadata: {
+			heapUsed: heapUsedMB,
+			heapTotal: require_primordials_math.MathRound(usage.heapTotal / 1024 / 1024 * 100) / 100,
+			external: require_primordials_math.MathRound(usage.external / 1024 / 1024 * 100) / 100
+		}
+	};
+	require_perf__internal.performanceMetrics.push(metric);
+	return heapUsedMB;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  measure,
-  measureSync,
-  perfCheckpoint,
-  perfTimer,
-  trackMemory
-});
+
+//#endregion
+exports.measure = measure;
+exports.measureSync = measureSync;
+exports.perfCheckpoint = perfCheckpoint;
+exports.perfTimer = perfTimer;
+exports.trackMemory = trackMemory;

package/dist/perf/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/pkg-ext/data.js

@@ -1,84 +1,31 @@
 "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 data_exports = {};
-__export(data_exports, {
-  packageExtensions: () => packageExtensions
-});
-module.exports = __toCommonJS(data_exports);
-var yarnPkgExtensions = __toESM(require("../external/@yarnpkg/extensions"));
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+let src_external__yarnpkg_extensions = require("../external/@yarnpkg/extensions");
+src_external__yarnpkg_extensions = require_runtime.__toESM(src_external__yarnpkg_extensions);
+
+//#region src/pkg-ext/data.ts
+/**
+* @file Package extensions for compatibility adjustments. Package extensions
+*   allow modifying package.json fields of dependencies to fix compatibility
+*   issues, missing peer dependencies, etc.
+*/
 const { freeze: ObjectFreeze } = Object;
-const packageExtensions = ObjectFreeze(
-  [
-    /* c8 ignore next - External @yarnpkg/extensions data */
-    ...yarnPkgExtensions.packageExtensions,
-    [
-      "@yarnpkg/extensions@>=1.1.0",
-      {
-        // Properties with undefined values are omitted when saved as JSON.
-        peerDependencies: void 0
-      }
-    ],
-    [
-      "abab@>=2.0.0",
-      {
-        devDependencies: {
-          // Lower the Webpack from v4.x to one supported by abab's peers.
-          webpack: "^3.12.0"
-        }
-      }
-    ],
-    [
-      "is-generator-function@>=1.0.7",
-      {
-        scripts: {
-          // Make the script a silent no-op.
-          "test:uglified": ""
-        }
-      }
-    ]
-  ].sort((a_, b_) => {
-    const aIndex = a_[0].lastIndexOf("@");
-    const bIndex = b_[0].lastIndexOf("@");
-    const a = aIndex === -1 ? a_[0] : a_[0].slice(0, aIndex);
-    const b = bIndex === -1 ? b_[0] : b_[0].slice(0, bIndex);
-    if (a < b) {
-      return -1;
-    }
-    if (a > b) {
-      return 1;
-    }
-    return 0;
-  })
-);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  packageExtensions
-});
+const packageExtensions = ObjectFreeze([
+	...src_external__yarnpkg_extensions.packageExtensions,
+	["@yarnpkg/extensions@>=1.1.0", { peerDependencies: void 0 }],
+	["abab@>=2.0.0", { devDependencies: { webpack: "^3.12.0" } }],
+	["is-generator-function@>=1.0.7", { scripts: { "test:uglified": "" } }]
+].sort((a_, b_) => {
+	const aIndex = a_[0].lastIndexOf("@");
+	const bIndex = b_[0].lastIndexOf("@");
+	const a = aIndex === -1 ? a_[0] : a_[0].slice(0, aIndex);
+	const b = bIndex === -1 ? b_[0] : b_[0].slice(0, bIndex);
+	if (a < b) return -1;
+	if (a > b) return 1;
+	return 0;
+}));
+
+//#endregion
+exports.packageExtensions = packageExtensions;

package/dist/pkg-ext/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 */