@socketsecurity/lib 3.0.2 → 3.0.3

package/dist/performance.js

@@ -1,18 +1,219 @@
 /* Socket Lib - Built with esbuild */
-var u=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var b=(t,e)=>{for(var n in e)u(t,n,{get:e[n],enumerable:!0})},g=(t,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of d(e))!l.call(t,o)&&o!==n&&u(t,o,{get:()=>e[o],enumerable:!(r=p(e,o))||r.enumerable});return t};var h=t=>g(u({},"__esModule",{value:!0}),t);var k={};b(k,{clearPerformanceMetrics:()=>w,generatePerformanceReport:()=>v,getPerformanceMetrics:()=>$,getPerformanceSummary:()=>f,measure:()=>x,measureSync:()=>M,perfCheckpoint:()=>T,perfTimer:()=>i,printPerformanceSummary:()=>P,trackMemory:()=>y});module.exports=h(k);var m=require("./debug");const s=[];function c(){return process.env.DEBUG?.includes("perf")||!1}function i(t,e){if(!c())return()=>{};const n=performance.now();return(0,m.debugLog)(`[perf] [START] ${t}`),r=>{const o=performance.now()-n,a={operation:t,duration:Math.round(o*100)/100,timestamp:Date.now(),metadata:{...e,...r}};s.push(a),(0,m.debugLog)(`[perf] [END] ${t} - ${a.duration}ms`)}}async function x(t,e,n){const r=i(t,n);try{const o=await e();r({success:!0});const a=s[s.length-1];return{result:o,duration:a?.duration||0}}catch(o){throw r({success:!1,error:o instanceof Error?o.message:"Unknown"}),o}}function M(t,e,n){const r=i(t,n);try{const o=e();r({success:!0});const a=s[s.length-1];return{result:o,duration:a?.duration||0}}catch(o){throw r({success:!1,error:o instanceof Error?o.message:"Unknown"}),o}}function $(){return[...s]}function w(){s.length=0,(0,m.debugLog)("[perf] Cleared performance metrics")}function f(){const t=Object.create(null);for(const n of s){const{duration:r,operation:o}=n;t[o]||(t[o]={count:0,total:0,min:Number.POSITIVE_INFINITY,max:Number.NEGATIVE_INFINITY});const a=t[o];a.count++,a.total+=r,a.min=Math.min(a.min,r),a.max=Math.max(a.max,r)}const e=Object.create(null);for(const{0:n,1:r}of Object.entries(t))e[n]={count:r.count,total:Math.round(r.total*100)/100,avg:Math.round(r.total/r.count*100)/100,min:Math.round(r.min*100)/100,max:Math.round(r.max*100)/100};return e}function P(){if(!c()||s.length===0)return;const t=f(),e=Object.keys(t).sort();(0,m.debugLog)(`[perf]
-=== Performance Summary ===`);for(const n of e){const r=t[n];(0,m.debugLog)(`[perf] ${n}: ${r.count} calls, avg ${r.avg}ms (min ${r.min}ms, max ${r.max}ms, total ${r.total}ms)`)}(0,m.debugLog)(`[perf] =========================
-`)}function T(t,e){if(!c())return;const n={operation:`checkpoint:${t}`,duration:0,timestamp:Date.now(),...e?{metadata:e}:{}};s.push(n),(0,m.debugLog)(`[perf] [CHECKPOINT] ${t}`)}function y(t){if(!c())return 0;const e=process.memoryUsage(),n=Math.round(e.heapUsed/1024/1024*100)/100;(0,m.debugLog)(`[perf] [MEMORY] ${t}: ${n}MB heap used`);const r={operation:`checkpoint:memory:${t}`,duration:0,timestamp:Date.now(),metadata:{heapUsed:n,heapTotal:Math.round(e.heapTotal/1024/1024*100)/100,external:Math.round(e.external/1024/1024*100)/100}};return s.push(r),n}function v(){if(!c()||s.length===0)return"(no performance data collected - enable with DEBUG=perf)";const t=f(),e=Object.keys(t).sort();let n=`
-\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
-`;n+=`\u2551         Performance Report                    \u2551
-`,n+=`\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+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 performance_exports = {};
+__export(performance_exports, {
+  clearPerformanceMetrics: () => clearPerformanceMetrics,
+  generatePerformanceReport: () => generatePerformanceReport,
+  getPerformanceMetrics: () => getPerformanceMetrics,
+  getPerformanceSummary: () => getPerformanceSummary,
+  measure: () => measure,
+  measureSync: () => measureSync,
+  perfCheckpoint: () => perfCheckpoint,
+  perfTimer: () => perfTimer,
+  printPerformanceSummary: () => printPerformanceSummary,
+  trackMemory: () => trackMemory
+});
+module.exports = __toCommonJS(performance_exports);
+var import_debug = require("./debug");
+const performanceMetrics = [];
+function isPerfEnabled() {
+  return process.env["DEBUG"]?.includes("perf") || false;
+}
+function perfTimer(operation, metadata) {
+  if (!isPerfEnabled()) {
+    return () => {
+    };
+  }
+  const start = performance.now();
+  (0, import_debug.debugLog)(`[perf] [START] ${operation}`);
+  return (additionalMetadata) => {
+    const duration = performance.now() - start;
+    const metric = {
+      operation,
+      // Round to 2 decimals
+      duration: Math.round(duration * 100) / 100,
+      timestamp: Date.now(),
+      metadata: { ...metadata, ...additionalMetadata }
+    };
+    performanceMetrics.push(metric);
+    (0, import_debug.debugLog)(`[perf] [END] ${operation} - ${metric.duration}ms`);
+  };
+}
+async function measure(operation, fn, metadata) {
+  const stop = perfTimer(operation, metadata);
+  try {
+    const result = await fn();
+    stop({ success: true });
+    const metric = performanceMetrics[performanceMetrics.length - 1];
+    return { result, duration: metric?.duration || 0 };
+  } catch (e) {
+    stop({
+      success: false,
+      error: e instanceof Error ? e.message : "Unknown"
+    });
+    throw e;
+  }
+}
+function measureSync(operation, fn, metadata) {
+  const stop = perfTimer(operation, metadata);
+  try {
+    const result = fn();
+    stop({ success: true });
+    const metric = performanceMetrics[performanceMetrics.length - 1];
+    return { result, duration: metric?.duration || 0 };
+  } catch (e) {
+    stop({
+      success: false,
+      error: e instanceof Error ? e.message : "Unknown"
+    });
+    throw e;
+  }
+}
+function getPerformanceMetrics() {
+  return [...performanceMetrics];
+}
+function clearPerformanceMetrics() {
+  performanceMetrics.length = 0;
+  (0, import_debug.debugLog)("[perf] Cleared performance metrics");
+}
+function getPerformanceSummary() {
+  const summary = /* @__PURE__ */ Object.create(null);
+  for (const metric of performanceMetrics) {
+    const { duration, operation } = metric;
+    if (!summary[operation]) {
+      summary[operation] = {
+        count: 0,
+        total: 0,
+        min: Number.POSITIVE_INFINITY,
+        max: Number.NEGATIVE_INFINITY
+      };
+    }
+    const stats = summary[operation];
+    stats.count++;
+    stats.total += duration;
+    stats.min = Math.min(stats.min, duration);
+    stats.max = Math.max(stats.max, duration);
+  }
+  const result = /* @__PURE__ */ Object.create(null);
+  for (const { 0: operation, 1: stats } of Object.entries(summary)) {
+    result[operation] = {
+      count: stats.count,
+      total: Math.round(stats.total * 100) / 100,
+      avg: Math.round(stats.total / stats.count * 100) / 100,
+      min: Math.round(stats.min * 100) / 100,
+      max: Math.round(stats.max * 100) / 100
+    };
+  }
+  return result;
+}
+function printPerformanceSummary() {
+  if (!isPerfEnabled() || performanceMetrics.length === 0) {
+    return;
+  }
+  const summary = getPerformanceSummary();
+  const operations = Object.keys(summary).sort();
+  (0, import_debug.debugLog)("[perf]\n=== Performance Summary ===");
+  for (const operation of operations) {
+    const stats = summary[operation];
+    (0, import_debug.debugLog)(
+      `[perf] ${operation}: ${stats.count} calls, avg ${stats.avg}ms (min ${stats.min}ms, max ${stats.max}ms, total ${stats.total}ms)`
+    );
+  }
+  (0, import_debug.debugLog)("[perf] =========================\n");
+}
+function perfCheckpoint(checkpoint, metadata) {
+  if (!isPerfEnabled()) {
+    return;
+  }
+  const metric = {
+    operation: `checkpoint:${checkpoint}`,
+    duration: 0,
+    timestamp: Date.now(),
+    ...metadata ? { metadata } : {}
+  };
+  performanceMetrics.push(metric);
+  (0, import_debug.debugLog)(`[perf] [CHECKPOINT] ${checkpoint}`);
+}
+function trackMemory(label) {
+  if (!isPerfEnabled()) {
+    return 0;
+  }
+  const usage = process.memoryUsage();
+  const heapUsedMB = Math.round(usage.heapUsed / 1024 / 1024 * 100) / 100;
+  (0, import_debug.debugLog)(`[perf] [MEMORY] ${label}: ${heapUsedMB}MB heap used`);
+  const metric = {
+    operation: `checkpoint:memory:${label}`,
+    duration: 0,
+    timestamp: Date.now(),
+    metadata: {
+      heapUsed: heapUsedMB,
+      heapTotal: Math.round(usage.heapTotal / 1024 / 1024 * 100) / 100,
+      external: Math.round(usage.external / 1024 / 1024 * 100) / 100
+    }
+  };
+  performanceMetrics.push(metric);
+  return heapUsedMB;
+}
+function generatePerformanceReport() {
+  if (!isPerfEnabled() || performanceMetrics.length === 0) {
+    return "(no performance data collected - enable with DEBUG=perf)";
+  }
+  const summary = getPerformanceSummary();
+  const operations = Object.keys(summary).sort();
+  let report = "\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n";
+  report += "\u2551         Performance Report                    \u2551\n";
+  report += "\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n\n";
+  for (const operation of operations) {
+    const stats = summary[operation];
+    report += `${operation}:
+`;
+    report += `  Calls: ${stats.count}
+`;
+    report += `  Avg:   ${stats.avg}ms
+`;
+    report += `  Min:   ${stats.min}ms
+`;
+    report += `  Max:   ${stats.max}ms
+`;
+    report += `  Total: ${stats.total}ms
 
-`;for(const o of e){const a=t[o];n+=`${o}:
-`,n+=`  Calls: ${a.count}
-`,n+=`  Avg:   ${a.avg}ms
-`,n+=`  Min:   ${a.min}ms
-`,n+=`  Max:   ${a.max}ms
-`,n+=`  Total: ${a.total}ms
-
-`}const r=Object.values(t).reduce((o,a)=>o+a.total,0);return n+=`Total measured time: ${Math.round(r*100)/100}ms
-`,n}0&&(module.exports={clearPerformanceMetrics,generatePerformanceReport,getPerformanceMetrics,getPerformanceSummary,measure,measureSync,perfCheckpoint,perfTimer,printPerformanceSummary,trackMemory});
+`;
+  }
+  const totalDuration = Object.values(summary).reduce(
+    (sum, s) => sum + s.total,
+    0
+  );
+  report += `Total measured time: ${Math.round(totalDuration * 100) / 100}ms
+`;
+  return report;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearPerformanceMetrics,
+  generatePerformanceReport,
+  getPerformanceMetrics,
+  getPerformanceSummary,
+  measure,
+  measureSync,
+  perfCheckpoint,
+  perfTimer,
+  printPerformanceSummary,
+  trackMemory
+});
 //# sourceMappingURL=performance.js.map

package/dist/performance.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/performance.ts"],
   "sourcesContent": ["/**\n * @fileoverview Performance monitoring utilities for profiling and optimization.\n * Provides timing, profiling, and performance metric collection for identifying bottlenecks.\n */\n\nimport { debugLog } from './debug'\n\n/**\n * Performance metrics collected during execution.\n */\ntype PerformanceMetrics = {\n  operation: string\n  duration: number\n  timestamp: number\n  metadata?: Record<string, unknown>\n}\n\n/**\n * Global metrics collection (only in debug mode).\n */\nconst performanceMetrics: PerformanceMetrics[] = []\n\n/**\n * Check if performance tracking is enabled.\n */\nfunction isPerfEnabled(): boolean {\n  return process.env['DEBUG']?.includes('perf') || false\n}\n\n/**\n * Start a performance timer for an operation.\n * Returns a stop function that records the duration.\n *\n * @param operation - Name of the operation being timed\n * @param metadata - Optional metadata to attach to the metric\n * @returns Stop function that completes the timing\n *\n * @example\n * import { perfTimer } from '@socketsecurity/lib/performance'\n *\n * const stop = perfTimer('api-call')\n * await fetchData()\n * stop({ endpoint: '/npm/lodash/score' })\n */\nexport function perfTimer(\n  operation: string,\n  metadata?: Record<string, unknown>,\n): (additionalMetadata?: Record<string, unknown>) => void {\n  if (!isPerfEnabled()) {\n    // No-op if perf tracking disabled\n    return () => {}\n  }\n\n  const start = performance.now()\n  debugLog(`[perf] [START] ${operation}`)\n\n  return (additionalMetadata?: Record<string, unknown>) => {\n    const duration = performance.now() - start\n    const metric: PerformanceMetrics = {\n      operation,\n      // Round to 2 decimals\n      duration: Math.round(duration * 100) / 100,\n      timestamp: Date.now(),\n      metadata: { ...metadata, ...additionalMetadata },\n    }\n\n    performanceMetrics.push(metric)\n    debugLog(`[perf] [END] ${operation} - ${metric.duration}ms`)\n  }\n}\n\n/**\n * Measure execution time of an async function.\n *\n * @param operation - Name of the operation\n * @param fn - Async function to measure\n * @param metadata - Optional metadata\n * @returns Result of the function and duration\n *\n * @example\n * import { measure } from '@socketsecurity/lib/performance'\n *\n * const { result, duration } = await measure('fetch-packages', async () => {\n *   return await fetchPackages()\n * })\n * console.log(`Fetched packages in ${duration}ms`)\n */\nexport async function measure<T>(\n  operation: string,\n  fn: () => Promise<T>,\n  metadata?: Record<string, unknown>,\n): Promise<{ result: T; duration: number }> {\n  const stop = perfTimer(operation, metadata)\n\n  try {\n    const result = await fn()\n    stop({ success: true })\n\n    const metric = performanceMetrics[performanceMetrics.length - 1]\n    return { result, duration: metric?.duration || 0 }\n  } catch (e) {\n    stop({\n      success: false,\n      error: e instanceof Error ? e.message : 'Unknown',\n    })\n    throw e\n  }\n}\n\n/**\n * Measure synchronous function execution time.\n *\n * @param operation - Name of the operation\n * @param fn - Synchronous function to measure\n * @param metadata - Optional metadata\n * @returns Result of the function and duration\n *\n * @example\n * import { measureSync } from '@socketsecurity/lib/performance'\n *\n * const { result, duration } = measureSync('parse-json', () => {\n *   return JSON.parse(data)\n * })\n */\nexport function measureSync<T>(\n  operation: string,\n  fn: () => T,\n  metadata?: Record<string, unknown>,\n): { result: T; duration: number } {\n  const stop = perfTimer(operation, metadata)\n\n  try {\n    const result = fn()\n    stop({ success: true })\n\n    const metric = performanceMetrics[performanceMetrics.length - 1]\n    return { result, duration: metric?.duration || 0 }\n  } catch (e) {\n    stop({\n      success: false,\n      error: e instanceof Error ? e.message : 'Unknown',\n    })\n    throw e\n  }\n}\n\n/**\n * Get all collected performance metrics.\n * Only available when DEBUG=perf is enabled.\n *\n * @returns Array of performance metrics\n *\n * @example\n * import { getPerformanceMetrics } from '@socketsecurity/lib/performance'\n *\n * const metrics = getPerformanceMetrics()\n * console.log(metrics)\n */\nexport function getPerformanceMetrics(): PerformanceMetrics[] {\n  return [...performanceMetrics]\n}\n\n/**\n * Clear all collected performance metrics.\n *\n * @example\n * import { clearPerformanceMetrics } from '@socketsecurity/lib/performance'\n *\n * clearPerformanceMetrics()\n */\nexport function clearPerformanceMetrics(): void {\n  performanceMetrics.length = 0\n  debugLog('[perf] Cleared performance metrics')\n}\n\n/**\n * Get performance summary statistics.\n *\n * @returns Summary of metrics grouped by operation\n *\n * @example\n * import { getPerformanceSummary } from '@socketsecurity/lib/performance'\n *\n * const summary = getPerformanceSummary()\n * console.log(summary)\n * // {\n * //   'api-call': { count: 5, total: 1234, avg: 246.8, min: 100, max: 500 },\n * //   'file-read': { count: 10, total: 50, avg: 5, min: 2, max: 15 }\n * // }\n */\nexport function getPerformanceSummary(): Record<\n  string,\n  {\n    count: number\n    total: number\n    avg: number\n    min: number\n    max: number\n  }\n> {\n  const summary: Record<\n    string,\n    { count: number; total: number; min: number; max: number }\n  > = Object.create(null)\n\n  for (const metric of performanceMetrics) {\n    const { duration, operation } = metric\n\n    if (!summary[operation]) {\n      summary[operation] = {\n        count: 0,\n        total: 0,\n        min: Number.POSITIVE_INFINITY,\n        max: Number.NEGATIVE_INFINITY,\n      }\n    }\n\n    const stats = summary[operation] as {\n      count: number\n      total: number\n      min: number\n      max: number\n    }\n    stats.count++\n    stats.total += duration\n    stats.min = Math.min(stats.min, duration)\n    stats.max = Math.max(stats.max, duration)\n  }\n\n  // Calculate averages and return with proper typing\n  const result: Record<\n    string,\n    { count: number; total: number; avg: number; min: number; max: number }\n  > = Object.create(null)\n\n  for (const { 0: operation, 1: stats } of Object.entries(summary)) {\n    result[operation] = {\n      count: stats.count,\n      total: Math.round(stats.total * 100) / 100,\n      avg: Math.round((stats.total / stats.count) * 100) / 100,\n      min: Math.round(stats.min * 100) / 100,\n      max: Math.round(stats.max * 100) / 100,\n    }\n  }\n\n  return result\n}\n\n/**\n * Print performance summary to console.\n * Only prints when DEBUG=perf is enabled.\n *\n * @example\n * import { printPerformanceSummary } from '@socketsecurity/lib/performance'\n *\n * printPerformanceSummary()\n * // Performance Summary:\n * // api-call: 5 calls, avg 246.8ms (min 100ms, max 500ms, total 1234ms)\n * // file-read: 10 calls, avg 5ms (min 2ms, max 15ms, total 50ms)\n */\nexport function printPerformanceSummary(): void {\n  if (!isPerfEnabled() || performanceMetrics.length === 0) {\n    return\n  }\n\n  const summary = getPerformanceSummary()\n  const operations = Object.keys(summary).sort()\n\n  debugLog('[perf]\\n=== Performance Summary ===')\n\n  for (const operation of operations) {\n    const stats = summary[operation] as {\n      count: number\n      total: number\n      avg: number\n      min: number\n      max: number\n    }\n    debugLog(\n      `[perf] ${operation}: ${stats.count} calls, avg ${stats.avg}ms (min ${stats.min}ms, max ${stats.max}ms, total ${stats.total}ms)`,\n    )\n  }\n\n  debugLog('[perf] =========================\\n')\n}\n\n/**\n * Mark a checkpoint in performance tracking.\n * Useful for tracking progress through complex operations.\n *\n * @param checkpoint - Name of the checkpoint\n * @param metadata - Optional metadata\n *\n * @example\n * import { perfCheckpoint } from '@socketsecurity/lib/performance'\n *\n * perfCheckpoint('start-scan')\n * // ... do work ...\n * perfCheckpoint('fetch-packages', { count: 50 })\n * // ... do work ...\n * perfCheckpoint('analyze-issues', { issueCount: 10 })\n * perfCheckpoint('end-scan')\n */\nexport function perfCheckpoint(\n  checkpoint: string,\n  metadata?: Record<string, unknown>,\n): void {\n  if (!isPerfEnabled()) {\n    return\n  }\n\n  const metric: PerformanceMetrics = {\n    operation: `checkpoint:${checkpoint}`,\n    duration: 0,\n    timestamp: Date.now(),\n    ...(metadata ? { metadata } : {}),\n  }\n\n  performanceMetrics.push(metric)\n  debugLog(`[perf] [CHECKPOINT] ${checkpoint}`)\n}\n\n/**\n * Track memory usage at a specific point.\n * Only available when DEBUG=perf is enabled.\n *\n * @param label - Label for this memory snapshot\n * @returns Memory usage in MB\n *\n * @example\n * import { trackMemory } from '@socketsecurity/lib/performance'\n *\n * const memBefore = trackMemory('before-operation')\n * await heavyOperation()\n * const memAfter = trackMemory('after-operation')\n * console.log(`Memory increased by ${memAfter - memBefore}MB`)\n */\nexport function trackMemory(label: string): number {\n  if (!isPerfEnabled()) {\n    return 0\n  }\n\n  const usage = process.memoryUsage()\n  const heapUsedMB = Math.round((usage.heapUsed / 1024 / 1024) * 100) / 100\n\n  debugLog(`[perf] [MEMORY] ${label}: ${heapUsedMB}MB heap used`)\n\n  const metric: PerformanceMetrics = {\n    operation: `checkpoint:memory:${label}`,\n    duration: 0,\n    timestamp: Date.now(),\n    metadata: {\n      heapUsed: heapUsedMB,\n      heapTotal: Math.round((usage.heapTotal / 1024 / 1024) * 100) / 100,\n      external: Math.round((usage.external / 1024 / 1024) * 100) / 100,\n    },\n  }\n\n  performanceMetrics.push(metric)\n\n  return heapUsedMB\n}\n\n/**\n * Create a performance report for the current execution.\n * Only available when DEBUG=perf is enabled.\n *\n * @returns Formatted performance report\n *\n * @example\n * import { generatePerformanceReport } from '@socketsecurity/lib/performance'\n *\n * console.log(generatePerformanceReport())\n * // \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n * // \u2551         Performance Report                    \u2551\n * // \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n * //\n * // api-call:\n * //   Calls: 5\n * //   Avg:   246.8ms\n * //   Min:   100ms\n * //   Max:   500ms\n * //   Total: 1234ms\n */\nexport function generatePerformanceReport(): string {\n  if (!isPerfEnabled() || performanceMetrics.length === 0) {\n    return '(no performance data collected - enable with DEBUG=perf)'\n  }\n\n  const summary = getPerformanceSummary()\n  const operations = Object.keys(summary).sort()\n\n  let report = '\\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\\n'\n  report += '\u2551         Performance Report                    \u2551\\n'\n  report += '\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\\n\\n'\n\n  for (const operation of operations) {\n    const stats = summary[operation] as {\n      count: number\n      total: number\n      avg: number\n      min: number\n      max: number\n    }\n    report += `${operation}:\\n`\n    report += `  Calls: ${stats.count}\\n`\n    report += `  Avg:   ${stats.avg}ms\\n`\n    report += `  Min:   ${stats.min}ms\\n`\n    report += `  Max:   ${stats.max}ms\\n`\n    report += `  Total: ${stats.total}ms\\n\\n`\n  }\n\n  const totalDuration = Object.values(summary).reduce(\n    (sum, s) => sum + s.total,\n    0,\n  )\n  report += `Total measured time: ${Math.round(totalDuration * 100) / 100}ms\\n`\n\n  return report\n}\n"],
-  "mappings": "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",
-  "names": ["performance_exports", "__export", "clearPerformanceMetrics", "generatePerformanceReport", "getPerformanceMetrics", "getPerformanceSummary", "measure", "measureSync", "perfCheckpoint", "perfTimer", "printPerformanceSummary", "trackMemory", "__toCommonJS", "import_debug", "performanceMetrics", "isPerfEnabled", "operation", "metadata", "start", "additionalMetadata", "duration", "metric", "fn", "stop", "result", "e", "summary", "stats", "operations", "checkpoint", "label", "usage", "heapUsedMB", "report", "totalDuration", "sum", "s"]
+  "mappings": "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",
+  "names": []
 }

package/dist/process-lock.js

@@ -1,14 +1,293 @@
 /* Socket Lib - Built with esbuild */
-var m=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var T=(n,e)=>{for(var r in e)m(n,r,{get:e[r],enumerable:!0})},x=(n,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of g(e))!E.call(n,i)&&i!==r&&m(n,i,{get:()=>e[i],enumerable:!(s=v(e,i))||s.enumerable});return n};var S=n=>x(m({},"__esModule",{value:!0}),n);var M={};T(M,{processLock:()=>L});module.exports=S(M);var t=require("fs"),u=require("./fs"),p=require("./logger"),y=require("./promises"),h=require("./signal-exit");const f=(0,p.getDefaultLogger)();class ${activeLocks=new Set;touchTimers=new Map;exitHandlerRegistered=!1;ensureExitHandler(){this.exitHandlerRegistered||((0,h.onExit)(()=>{for(const e of this.touchTimers.values())clearInterval(e);this.touchTimers.clear();for(const e of this.activeLocks)try{(0,t.existsSync)(e)&&(0,u.safeDeleteSync)(e,{recursive:!0})}catch{}}),this.exitHandlerRegistered=!0)}touchLock(e){try{if((0,t.existsSync)(e)){const r=new Date;(0,t.utimesSync)(e,r,r)}}catch(r){f.warn(`Failed to touch lock ${e}: ${r instanceof Error?r.message:String(r)}`)}}startTouchTimer(e,r){if(r<=0||this.touchTimers.has(e))return;const s=setInterval(()=>{this.touchLock(e)},r);s.unref(),this.touchTimers.set(e,s)}stopTouchTimer(e){const r=this.touchTimers.get(e);r&&(clearInterval(r),this.touchTimers.delete(e))}isStale(e,r){try{if(!(0,t.existsSync)(e))return!1;const s=(0,t.statSync)(e),i=Math.floor((Date.now()-s.mtime.getTime())/1e3),d=Math.floor(r/1e3);return i>d}catch{return!1}}async acquire(e,r={}){const{baseDelayMs:s=100,maxDelayMs:i=1e3,retries:d=3,staleMs:l=5e3,touchIntervalMs:w=2e3}=r;return this.ensureExitHandler(),await(0,y.pRetry)(async()=>{try{if((0,t.existsSync)(e)&&this.isStale(e,l)){f.log(`Removing stale lock: ${e}`);try{(0,u.safeDeleteSync)(e,{recursive:!0})}catch{}}if((0,t.existsSync)(e))throw new Error(`Lock already exists: ${e}`);return(0,t.mkdirSync)(e,{recursive:!0}),this.activeLocks.add(e),this.startTouchTimer(e,w),()=>this.release(e)}catch(o){const a=o.code;if(a==="EEXIST")throw this.isStale(e,l)?new Error(`Stale lock detected: ${e}`):new Error(`Lock already exists: ${e}`);if(a==="EACCES"||a==="EPERM")throw new Error(`Permission denied creating lock: ${e}. Check directory permissions or run with appropriate access.`,{cause:o});if(a==="EROFS")throw new Error(`Cannot create lock on read-only filesystem: ${e}`,{cause:o});if(a==="ENOTDIR"){const c=e.slice(0,e.lastIndexOf("/"));throw new Error(`Cannot create lock directory: ${e}
+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 process_lock_exports = {};
+__export(process_lock_exports, {
+  processLock: () => processLock
+});
+module.exports = __toCommonJS(process_lock_exports);
+var import_fs = require("fs");
+var import_fs2 = require("./fs");
+var import_logger = require("./logger");
+var import_promises = require("./promises");
+var import_signal_exit = require("./signal-exit");
+const logger = (0, import_logger.getDefaultLogger)();
+class ProcessLockManager {
+  activeLocks = /* @__PURE__ */ new Set();
+  touchTimers = /* @__PURE__ */ new Map();
+  exitHandlerRegistered = false;
+  /**
+   * Ensure process exit handler is registered for cleanup.
+   * Registers a handler that cleans up all active locks when the process exits.
+   */
+  ensureExitHandler() {
+    if (this.exitHandlerRegistered) {
+      return;
+    }
+    (0, import_signal_exit.onExit)(() => {
+      for (const timer of this.touchTimers.values()) {
+        clearInterval(timer);
+      }
+      this.touchTimers.clear();
+      for (const lockPath of this.activeLocks) {
+        try {
+          if ((0, import_fs.existsSync)(lockPath)) {
+            (0, import_fs2.safeDeleteSync)(lockPath, { recursive: true });
+          }
+        } catch {
+        }
+      }
+    });
+    this.exitHandlerRegistered = true;
+  }
+  /**
+   * Touch a lock file to update its mtime.
+   * This prevents the lock from being detected as stale during long operations.
+   *
+   * @param lockPath - Path to the lock directory
+   */
+  touchLock(lockPath) {
+    try {
+      if ((0, import_fs.existsSync)(lockPath)) {
+        const now = /* @__PURE__ */ new Date();
+        (0, import_fs.utimesSync)(lockPath, now, now);
+      }
+    } catch (error) {
+      logger.warn(
+        `Failed to touch lock ${lockPath}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Start periodic touching of a lock file.
+   * Aligned with npm npx strategy to prevent false stale detection.
+   *
+   * @param lockPath - Path to the lock directory
+   * @param intervalMs - Touch interval in milliseconds
+   */
+  startTouchTimer(lockPath, intervalMs) {
+    if (intervalMs <= 0 || this.touchTimers.has(lockPath)) {
+      return;
+    }
+    const timer = setInterval(() => {
+      this.touchLock(lockPath);
+    }, intervalMs);
+    timer.unref();
+    this.touchTimers.set(lockPath, timer);
+  }
+  /**
+   * Stop periodic touching of a lock file.
+   *
+   * @param lockPath - Path to the lock directory
+   */
+  stopTouchTimer(lockPath) {
+    const timer = this.touchTimers.get(lockPath);
+    if (timer) {
+      clearInterval(timer);
+      this.touchTimers.delete(lockPath);
+    }
+  }
+  /**
+   * Check if a lock is stale based on mtime.
+   * Uses second-level granularity to avoid APFS floating-point precision issues.
+   * Aligned with npm's npx locking strategy.
+   *
+   * @param lockPath - Path to the lock directory
+   * @param staleMs - Stale timeout in milliseconds
+   * @returns True if lock exists and is stale
+   */
+  isStale(lockPath, staleMs) {
+    try {
+      if (!(0, import_fs.existsSync)(lockPath)) {
+        return false;
+      }
+      const stats = (0, import_fs.statSync)(lockPath);
+      const ageSeconds = Math.floor((Date.now() - stats.mtime.getTime()) / 1e3);
+      const staleSeconds = Math.floor(staleMs / 1e3);
+      return ageSeconds > staleSeconds;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Acquire a lock using mkdir for atomic operation.
+   * Handles stale locks and includes exit cleanup.
+   *
+   * This method attempts to create a lock directory atomically. If the lock
+   * already exists, it checks if it's stale and removes it before retrying.
+   * Uses exponential backoff with jitter for retry attempts.
+   *
+   * @param lockPath - Path to the lock directory
+   * @param options - Lock acquisition options
+   * @returns Release function to unlock
+   * @throws Error if lock cannot be acquired after all retries
+   *
+   * @example
+   * ```typescript
+   * const release = await processLock.acquire('/tmp/my-lock')
+   * try {
+   *   // Critical section
+   * } finally {
+   *   release()
+   * }
+   * ```
+   */
+  async acquire(lockPath, options = {}) {
+    const {
+      baseDelayMs = 100,
+      maxDelayMs = 1e3,
+      retries = 3,
+      staleMs = 5e3,
+      touchIntervalMs = 2e3
+    } = options;
+    this.ensureExitHandler();
+    return await (0, import_promises.pRetry)(
+      async () => {
+        try {
+          if ((0, import_fs.existsSync)(lockPath) && this.isStale(lockPath, staleMs)) {
+            logger.log(`Removing stale lock: ${lockPath}`);
+            try {
+              (0, import_fs2.safeDeleteSync)(lockPath, { recursive: true });
+            } catch {
+            }
+          }
+          if ((0, import_fs.existsSync)(lockPath)) {
+            throw new Error(`Lock already exists: ${lockPath}`);
+          }
+          (0, import_fs.mkdirSync)(lockPath, { recursive: true });
+          this.activeLocks.add(lockPath);
+          this.startTouchTimer(lockPath, touchIntervalMs);
+          return () => this.release(lockPath);
+        } catch (error) {
+          const code = error.code;
+          if (code === "EEXIST") {
+            if (this.isStale(lockPath, staleMs)) {
+              throw new Error(`Stale lock detected: ${lockPath}`);
+            }
+            throw new Error(`Lock already exists: ${lockPath}`);
+          }
+          if (code === "EACCES" || code === "EPERM") {
+            throw new Error(
+              `Permission denied creating lock: ${lockPath}. Check directory permissions or run with appropriate access.`,
+              { cause: error }
+            );
+          }
+          if (code === "EROFS") {
+            throw new Error(
+              `Cannot create lock on read-only filesystem: ${lockPath}`,
+              { cause: error }
+            );
+          }
+          if (code === "ENOTDIR") {
+            const parentDir = lockPath.slice(0, lockPath.lastIndexOf("/"));
+            throw new Error(
+              `Cannot create lock directory: ${lockPath}
 A path component is a file when it should be a directory.
-Parent path: ${c}
+Parent path: ${parentDir}
 To resolve:
-  1. Check if "${c}" contains a file instead of a directory
+  1. Check if "${parentDir}" contains a file instead of a directory
   2. Remove any conflicting files in the path
-  3. Ensure the full parent directory structure exists`,{cause:o})}if(a==="ENOENT"){const c=e.slice(0,e.lastIndexOf("/"));throw new Error(`Cannot create lock directory: ${e}
-Parent directory does not exist: ${c}
+  3. Ensure the full parent directory structure exists`,
+              { cause: error }
+            );
+          }
+          if (code === "ENOENT") {
+            const parentDir = lockPath.slice(0, lockPath.lastIndexOf("/"));
+            throw new Error(
+              `Cannot create lock directory: ${lockPath}
+Parent directory does not exist: ${parentDir}
 To resolve:
-  1. Ensure the parent directory "${c}" exists
-  2. Create the directory structure: mkdir -p "${c}"
-  3. Check filesystem permissions allow directory creation`,{cause:o})}throw new Error(`Failed to acquire lock: ${e}`,{cause:o})}},{retries:d,baseDelayMs:s,maxDelayMs:i,jitter:!0})}release(e){this.stopTouchTimer(e);try{(0,t.existsSync)(e)&&(0,u.safeDeleteSync)(e,{recursive:!0}),this.activeLocks.delete(e)}catch(r){f.warn(`Failed to release lock ${e}: ${r instanceof Error?r.message:String(r)}`)}}async withLock(e,r,s){const i=await this.acquire(e,s);try{return await r()}finally{i()}}}const L=new $;0&&(module.exports={processLock});
+  1. Ensure the parent directory "${parentDir}" exists
+  2. Create the directory structure: mkdir -p "${parentDir}"
+  3. Check filesystem permissions allow directory creation`,
+              { cause: error }
+            );
+          }
+          throw new Error(`Failed to acquire lock: ${lockPath}`, {
+            cause: error
+          });
+        }
+      },
+      {
+        retries,
+        baseDelayMs,
+        maxDelayMs,
+        jitter: true
+      }
+    );
+  }
+  /**
+   * Release a lock and remove from tracking.
+   * Stops periodic touching and removes the lock directory.
+   *
+   * @param lockPath - Path to the lock directory
+   *
+   * @example
+   * ```typescript
+   * processLock.release('/tmp/my-lock')
+   * ```
+   */
+  release(lockPath) {
+    this.stopTouchTimer(lockPath);
+    try {
+      if ((0, import_fs.existsSync)(lockPath)) {
+        (0, import_fs2.safeDeleteSync)(lockPath, { recursive: true });
+      }
+      this.activeLocks.delete(lockPath);
+    } catch (error) {
+      logger.warn(
+        `Failed to release lock ${lockPath}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Execute a function with exclusive lock protection.
+   * Automatically handles lock acquisition, execution, and cleanup.
+   *
+   * This is the recommended way to use process locks, as it guarantees
+   * cleanup even if the callback throws an error.
+   *
+   * @param lockPath - Path to the lock directory
+   * @param fn - Function to execute while holding the lock
+   * @param options - Lock acquisition options
+   * @returns Result of the callback function
+   * @throws Error from callback or lock acquisition failure
+   *
+   * @example
+   * ```typescript
+   * const result = await processLock.withLock('/tmp/my-lock', async () => {
+   *   // Critical section
+   *   return someValue
+   * })
+   * ```
+   */
+  async withLock(lockPath, fn, options) {
+    const release = await this.acquire(lockPath, options);
+    try {
+      return await fn();
+    } finally {
+      release();
+    }
+  }
+}
+const processLock = new ProcessLockManager();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  processLock
+});
 //# sourceMappingURL=process-lock.js.map