@socketsecurity/lib 2.10.1 → 2.10.3

package/dist/memoization.d.ts

@@ -24,7 +24,7 @@ type MemoizeOptions<Args extends unknown[], _Result = unknown> = {
  * @returns Memoized version of the function
  *
  * @example
- * import { memoize } from '@socketsecurity/registry/lib/memoization'
+ * import { memoize } from '@socketsecurity/lib/memoization'
  *
  * const expensiveOperation = memoize((n: number) => {
  *   // Heavy computation
@@ -44,7 +44,7 @@ export declare function memoize<Args extends unknown[], Result>(fn: (...args: Ar
  * @returns Memoized version of the async function
  *
  * @example
- * import { memoizeAsync } from '@socketsecurity/registry/lib/memoization'
+ * import { memoizeAsync } from '@socketsecurity/lib/memoization'
  *
  * const fetchUser = memoizeAsync(async (id: string) => {
  *   const response = await fetch(`/api/users/${id}`)
@@ -65,7 +65,7 @@ export declare function memoizeAsync<Args extends unknown[], Result>(fn: (...arg
  * @returns Modified descriptor with memoized method
  *
  * @example
- * import { Memoize } from '@socketsecurity/registry/lib/memoization'
+ * import { Memoize } from '@socketsecurity/lib/memoization'
  *
  * class Calculator {
  *   @Memoize()
@@ -90,7 +90,7 @@ export declare function clearAllMemoizationCaches(): void;
  * @returns Memoized version using WeakMap
  *
  * @example
- * import { memoizeWeak } from '@socketsecurity/registry/lib/memoization'
+ * import { memoizeWeak } from '@socketsecurity/lib/memoization'
  *
  * const processConfig = memoizeWeak((config: Config) => {
  *   return expensiveTransform(config)
@@ -109,7 +109,7 @@ export declare function memoizeWeak<K extends object, Result>(fn: (key: K) => Re
  * @returns Memoized version that only executes once
  *
  * @example
- * import { once } from '@socketsecurity/registry/lib/memoization'
+ * import { once } from '@socketsecurity/lib/memoization'
  *
  * const initialize = once(() => {
  *   console.log('Initializing…')
@@ -130,7 +130,7 @@ export declare function once<Result>(fn: () => Result): () => Result;
  * @returns Debounced memoized function
  *
  * @example
- * import { memoizeDebounced } from '@socketsecurity/registry/lib/memoization'
+ * import { memoizeDebounced } from '@socketsecurity/lib/memoization'
  *
  * const search = memoizeDebounced(
  *   (query: string) => performSearch(query),

package/dist/memoization.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/memoization.ts"],
-  "sourcesContent": ["/**\n * @fileoverview Memoization utilities for caching function results.\n * Provides function result caching to optimize repeated computations and expensive operations.\n */\n\nimport { debugLog } from './debug'\n\n/**\n * Options for memoization behavior.\n */\ntype MemoizeOptions<Args extends unknown[], _Result = unknown> = {\n  /** Custom cache key generator (defaults to JSON.stringify) */\n  keyGen?: (...args: Args) => string\n  /** Maximum cache size (LRU eviction when exceeded) */\n  maxSize?: number\n  /** TTL in milliseconds (cache entries expire after this time) */\n  ttl?: number\n  /** Cache name for debugging */\n  name?: string\n  /** Weak cache for object keys (enables GC) */\n  weak?: boolean\n  /** Custom equality check for cache hits */\n  equals?: (a: Args, b: Args) => boolean\n}\n\n/**\n * Cache entry with metadata.\n */\ntype CacheEntry<T> = {\n  value: T\n  timestamp: number\n  hits: number\n}\n\n/**\n * Memoize a function with configurable caching behavior.\n * Caches function results to avoid repeated computation.\n *\n * @param fn - Function to memoize\n * @param options - Memoization options\n * @returns Memoized version of the function\n *\n * @example\n * import { memoize } from '@socketsecurity/registry/lib/memoization'\n *\n * const expensiveOperation = memoize((n: number) => {\n *   // Heavy computation\n *   return Array(n).fill(0).reduce((a, _, i) => a + i, 0)\n * }, { maxSize: 100, ttl: 60000, name: 'sum' })\n *\n * expensiveOperation(1000) // Computed\n * expensiveOperation(1000) // Cached\n */\nexport function memoize<Args extends unknown[], Result>(\n  fn: (...args: Args) => Result,\n  options: MemoizeOptions<Args, Result> = {},\n): (...args: Args) => Result {\n  const {\n    keyGen = (...args) => JSON.stringify(args),\n    maxSize = Number.POSITIVE_INFINITY,\n    name = fn.name || 'anonymous',\n    ttl = Number.POSITIVE_INFINITY,\n  } = options\n\n  const cache = new Map<string, CacheEntry<Result>>()\n  const accessOrder: string[] = []\n\n  function evictLRU(): void {\n    if (cache.size >= maxSize && accessOrder.length > 0) {\n      const oldest = accessOrder.shift()\n      if (oldest) {\n        cache.delete(oldest)\n        debugLog(`[memoize:${name}] clear`, {\n          key: oldest,\n          reason: 'LRU',\n        })\n      }\n    }\n  }\n\n  function isExpired(entry: CacheEntry<Result>): boolean {\n    if (ttl === Number.POSITIVE_INFINITY) {\n      return false\n    }\n    return Date.now() - entry.timestamp > ttl\n  }\n\n  return function memoized(...args: Args): Result {\n    const key = keyGen(...args)\n\n    // Check cache\n    const cached = cache.get(key)\n    if (cached && !isExpired(cached)) {\n      cached.hits++\n      // Move to end of access order (LRU)\n      const index = accessOrder.indexOf(key)\n      if (index !== -1) {\n        accessOrder.splice(index, 1)\n      }\n      accessOrder.push(key)\n\n      debugLog(`[memoize:${name}] hit`, { key, hits: cached.hits })\n      return cached.value\n    }\n\n    // Cache miss - compute value\n    debugLog(`[memoize:${name}] miss`, { key })\n    const value = fn(...args)\n\n    // Store in cache\n    evictLRU()\n    cache.set(key, {\n      value,\n      timestamp: Date.now(),\n      hits: 0,\n    })\n    accessOrder.push(key)\n\n    debugLog(`[memoize:${name}] set`, { key, cacheSize: cache.size })\n    return value\n  }\n}\n\n/**\n * Memoize an async function.\n * Similar to memoize() but handles promises properly.\n *\n * @param fn - Async function to memoize\n * @param options - Memoization options\n * @returns Memoized version of the async function\n *\n * @example\n * import { memoizeAsync } from '@socketsecurity/registry/lib/memoization'\n *\n * const fetchUser = memoizeAsync(async (id: string) => {\n *   const response = await fetch(`/api/users/${id}`)\n *   return response.json()\n * }, { ttl: 300000, name: 'fetchUser' })\n *\n * await fetchUser('123') // Fetches from API\n * await fetchUser('123') // Returns cached result\n */\nexport function memoizeAsync<Args extends unknown[], Result>(\n  fn: (...args: Args) => Promise<Result>,\n  options: MemoizeOptions<Args, Result> = {},\n): (...args: Args) => Promise<Result> {\n  const {\n    keyGen = (...args) => JSON.stringify(args),\n    maxSize = Number.POSITIVE_INFINITY,\n    name = fn.name || 'anonymous',\n    ttl = Number.POSITIVE_INFINITY,\n  } = options\n\n  const cache = new Map<string, CacheEntry<Promise<Result>>>()\n  const accessOrder: string[] = []\n\n  function evictLRU(): void {\n    if (cache.size >= maxSize && accessOrder.length > 0) {\n      const oldest = accessOrder.shift()\n      if (oldest) {\n        cache.delete(oldest)\n        debugLog(`[memoizeAsync:${name}] clear`, {\n          key: oldest,\n          reason: 'LRU',\n        })\n      }\n    }\n  }\n\n  function isExpired(entry: CacheEntry<Promise<Result>>): boolean {\n    if (ttl === Number.POSITIVE_INFINITY) {\n      return false\n    }\n    return Date.now() - entry.timestamp > ttl\n  }\n\n  return async function memoized(...args: Args): Promise<Result> {\n    const key = keyGen(...args)\n\n    // Check cache\n    const cached = cache.get(key)\n    if (cached && !isExpired(cached)) {\n      cached.hits++\n      // Move to end of access order (LRU)\n      const index = accessOrder.indexOf(key)\n      if (index !== -1) {\n        accessOrder.splice(index, 1)\n      }\n      accessOrder.push(key)\n\n      debugLog(`[memoizeAsync:${name}] hit`, { key, hits: cached.hits })\n      return await cached.value\n    }\n\n    // Cache miss - compute value\n    debugLog(`[memoizeAsync:${name}] miss`, { key })\n    const promise = fn(...args)\n\n    // Store promise in cache (handles concurrent calls)\n    evictLRU()\n    cache.set(key, {\n      value: promise,\n      timestamp: Date.now(),\n      hits: 0,\n    })\n    accessOrder.push(key)\n\n    debugLog(`[memoizeAsync:${name}] set`, { key, cacheSize: cache.size })\n\n    try {\n      const result = await promise\n      return result\n    } catch (e) {\n      // Remove failed promise from cache\n      cache.delete(key)\n      const orderIndex = accessOrder.indexOf(key)\n      if (orderIndex !== -1) {\n        accessOrder.splice(orderIndex, 1)\n      }\n      debugLog(`[memoizeAsync:${name}] clear`, { key, reason: 'error' })\n      throw e\n    }\n  }\n}\n\n/**\n * Create a memoized version of a method.\n * Preserves 'this' context for class methods.\n *\n * @param target - Object containing the method\n * @param propertyKey - Method name\n * @param descriptor - Property descriptor\n * @returns Modified descriptor with memoized method\n *\n * @example\n * import { Memoize } from '@socketsecurity/registry/lib/memoization'\n *\n * class Calculator {\n *   @Memoize()\n *   fibonacci(n: number): number {\n *     if (n <= 1) return n\n *     return this.fibonacci(n - 1) + this.fibonacci(n - 2)\n *   }\n * }\n */\nexport function Memoize(options: MemoizeOptions<unknown[], unknown> = {}) {\n  return (\n    _target: unknown,\n    propertyKey: string,\n    descriptor: PropertyDescriptor,\n  ): PropertyDescriptor => {\n    const originalMethod = descriptor.value as (...args: unknown[]) => unknown\n\n    descriptor.value = memoize(originalMethod, {\n      ...options,\n      name: options.name || propertyKey,\n    })\n\n    return descriptor\n  }\n}\n\n/**\n * Clear all memoization caches.\n * Useful for testing or when you need to force recomputation.\n */\nexport function clearAllMemoizationCaches(): void {\n  // Note: This requires the memoized functions to be tracked globally.\n  // For now, this is a placeholder that logs the intent.\n  debugLog('[memoize:all] clear', { action: 'clear-all-caches' })\n}\n\n/**\n * Memoize with WeakMap for object keys.\n * Allows garbage collection when objects are no longer referenced.\n * Only works when first argument is an object.\n *\n * @param fn - Function to memoize\n * @returns Memoized version using WeakMap\n *\n * @example\n * import { memoizeWeak } from '@socketsecurity/registry/lib/memoization'\n *\n * const processConfig = memoizeWeak((config: Config) => {\n *   return expensiveTransform(config)\n * })\n *\n * processConfig(config1) // Computed\n * processConfig(config1) // Cached\n * // When config1 is no longer referenced, cache entry is GC'd\n */\nexport function memoizeWeak<K extends object, Result>(\n  fn: (key: K) => Result,\n): (key: K) => Result {\n  const cache = new WeakMap<K, Result>()\n\n  return function memoized(key: K): Result {\n    const cached = cache.get(key)\n    if (cached !== undefined) {\n      debugLog(`[memoizeWeak:${fn.name}] hit`)\n      return cached\n    }\n\n    debugLog(`[memoizeWeak:${fn.name}] miss`)\n    const result = fn(key)\n    cache.set(key, result)\n    return result\n  }\n}\n\n/**\n * Simple once() implementation - caches single result forever.\n * Useful for initialization functions that should only run once.\n *\n * @param fn - Function to run once\n * @returns Memoized version that only executes once\n *\n * @example\n * import { once } from '@socketsecurity/registry/lib/memoization'\n *\n * const initialize = once(() => {\n *   console.log('Initializing\u2026')\n *   return loadConfig()\n * })\n *\n * initialize() // Logs \"Initializing\u2026\" and returns config\n * initialize() // Returns cached config (no log)\n */\nexport function once<Result>(fn: () => Result): () => Result {\n  let called = false\n  let result: Result\n\n  return function memoized(): Result {\n    if (!called) {\n      result = fn()\n      called = true\n      debugLog(`[once:${fn.name}] set`)\n    } else {\n      debugLog(`[once:${fn.name}] hit`)\n    }\n    return result\n  }\n}\n\n/**\n * Create a debounced memoized function.\n * Combines memoization with debouncing for expensive operations.\n *\n * @param fn - Function to memoize and debounce\n * @param wait - Debounce wait time in milliseconds\n * @param options - Memoization options\n * @returns Debounced memoized function\n *\n * @example\n * import { memoizeDebounced } from '@socketsecurity/registry/lib/memoization'\n *\n * const search = memoizeDebounced(\n *   (query: string) => performSearch(query),\n *   300,\n *   { name: 'search' }\n * )\n */\nexport function memoizeDebounced<Args extends unknown[], Result>(\n  fn: (...args: Args) => Result,\n  wait: number,\n  options: MemoizeOptions<Args, Result> = {},\n): (...args: Args) => Result {\n  const memoized = memoize(fn, options)\n  let timeoutId: NodeJS.Timeout | undefined\n\n  return function debounced(...args: Args): Result {\n    if (timeoutId) {\n      clearTimeout(timeoutId)\n    }\n\n    timeoutId = setTimeout(() => {\n      memoized(...args)\n    }, wait)\n\n    // For immediate return, try cached value or compute synchronously\n    return memoized(...args)\n  }\n}\n"],
+  "sourcesContent": ["/**\n * @fileoverview Memoization utilities for caching function results.\n * Provides function result caching to optimize repeated computations and expensive operations.\n */\n\nimport { debugLog } from './debug'\n\n/**\n * Options for memoization behavior.\n */\ntype MemoizeOptions<Args extends unknown[], _Result = unknown> = {\n  /** Custom cache key generator (defaults to JSON.stringify) */\n  keyGen?: (...args: Args) => string\n  /** Maximum cache size (LRU eviction when exceeded) */\n  maxSize?: number\n  /** TTL in milliseconds (cache entries expire after this time) */\n  ttl?: number\n  /** Cache name for debugging */\n  name?: string\n  /** Weak cache for object keys (enables GC) */\n  weak?: boolean\n  /** Custom equality check for cache hits */\n  equals?: (a: Args, b: Args) => boolean\n}\n\n/**\n * Cache entry with metadata.\n */\ntype CacheEntry<T> = {\n  value: T\n  timestamp: number\n  hits: number\n}\n\n/**\n * Memoize a function with configurable caching behavior.\n * Caches function results to avoid repeated computation.\n *\n * @param fn - Function to memoize\n * @param options - Memoization options\n * @returns Memoized version of the function\n *\n * @example\n * import { memoize } from '@socketsecurity/lib/memoization'\n *\n * const expensiveOperation = memoize((n: number) => {\n *   // Heavy computation\n *   return Array(n).fill(0).reduce((a, _, i) => a + i, 0)\n * }, { maxSize: 100, ttl: 60000, name: 'sum' })\n *\n * expensiveOperation(1000) // Computed\n * expensiveOperation(1000) // Cached\n */\nexport function memoize<Args extends unknown[], Result>(\n  fn: (...args: Args) => Result,\n  options: MemoizeOptions<Args, Result> = {},\n): (...args: Args) => Result {\n  const {\n    keyGen = (...args) => JSON.stringify(args),\n    maxSize = Number.POSITIVE_INFINITY,\n    name = fn.name || 'anonymous',\n    ttl = Number.POSITIVE_INFINITY,\n  } = options\n\n  const cache = new Map<string, CacheEntry<Result>>()\n  const accessOrder: string[] = []\n\n  function evictLRU(): void {\n    if (cache.size >= maxSize && accessOrder.length > 0) {\n      const oldest = accessOrder.shift()\n      if (oldest) {\n        cache.delete(oldest)\n        debugLog(`[memoize:${name}] clear`, {\n          key: oldest,\n          reason: 'LRU',\n        })\n      }\n    }\n  }\n\n  function isExpired(entry: CacheEntry<Result>): boolean {\n    if (ttl === Number.POSITIVE_INFINITY) {\n      return false\n    }\n    return Date.now() - entry.timestamp > ttl\n  }\n\n  return function memoized(...args: Args): Result {\n    const key = keyGen(...args)\n\n    // Check cache\n    const cached = cache.get(key)\n    if (cached && !isExpired(cached)) {\n      cached.hits++\n      // Move to end of access order (LRU)\n      const index = accessOrder.indexOf(key)\n      if (index !== -1) {\n        accessOrder.splice(index, 1)\n      }\n      accessOrder.push(key)\n\n      debugLog(`[memoize:${name}] hit`, { key, hits: cached.hits })\n      return cached.value\n    }\n\n    // Cache miss - compute value\n    debugLog(`[memoize:${name}] miss`, { key })\n    const value = fn(...args)\n\n    // Store in cache\n    evictLRU()\n    cache.set(key, {\n      value,\n      timestamp: Date.now(),\n      hits: 0,\n    })\n    accessOrder.push(key)\n\n    debugLog(`[memoize:${name}] set`, { key, cacheSize: cache.size })\n    return value\n  }\n}\n\n/**\n * Memoize an async function.\n * Similar to memoize() but handles promises properly.\n *\n * @param fn - Async function to memoize\n * @param options - Memoization options\n * @returns Memoized version of the async function\n *\n * @example\n * import { memoizeAsync } from '@socketsecurity/lib/memoization'\n *\n * const fetchUser = memoizeAsync(async (id: string) => {\n *   const response = await fetch(`/api/users/${id}`)\n *   return response.json()\n * }, { ttl: 300000, name: 'fetchUser' })\n *\n * await fetchUser('123') // Fetches from API\n * await fetchUser('123') // Returns cached result\n */\nexport function memoizeAsync<Args extends unknown[], Result>(\n  fn: (...args: Args) => Promise<Result>,\n  options: MemoizeOptions<Args, Result> = {},\n): (...args: Args) => Promise<Result> {\n  const {\n    keyGen = (...args) => JSON.stringify(args),\n    maxSize = Number.POSITIVE_INFINITY,\n    name = fn.name || 'anonymous',\n    ttl = Number.POSITIVE_INFINITY,\n  } = options\n\n  const cache = new Map<string, CacheEntry<Promise<Result>>>()\n  const accessOrder: string[] = []\n\n  function evictLRU(): void {\n    if (cache.size >= maxSize && accessOrder.length > 0) {\n      const oldest = accessOrder.shift()\n      if (oldest) {\n        cache.delete(oldest)\n        debugLog(`[memoizeAsync:${name}] clear`, {\n          key: oldest,\n          reason: 'LRU',\n        })\n      }\n    }\n  }\n\n  function isExpired(entry: CacheEntry<Promise<Result>>): boolean {\n    if (ttl === Number.POSITIVE_INFINITY) {\n      return false\n    }\n    return Date.now() - entry.timestamp > ttl\n  }\n\n  return async function memoized(...args: Args): Promise<Result> {\n    const key = keyGen(...args)\n\n    // Check cache\n    const cached = cache.get(key)\n    if (cached && !isExpired(cached)) {\n      cached.hits++\n      // Move to end of access order (LRU)\n      const index = accessOrder.indexOf(key)\n      if (index !== -1) {\n        accessOrder.splice(index, 1)\n      }\n      accessOrder.push(key)\n\n      debugLog(`[memoizeAsync:${name}] hit`, { key, hits: cached.hits })\n      return await cached.value\n    }\n\n    // Cache miss - compute value\n    debugLog(`[memoizeAsync:${name}] miss`, { key })\n    const promise = fn(...args)\n\n    // Store promise in cache (handles concurrent calls)\n    evictLRU()\n    cache.set(key, {\n      value: promise,\n      timestamp: Date.now(),\n      hits: 0,\n    })\n    accessOrder.push(key)\n\n    debugLog(`[memoizeAsync:${name}] set`, { key, cacheSize: cache.size })\n\n    try {\n      const result = await promise\n      return result\n    } catch (e) {\n      // Remove failed promise from cache\n      cache.delete(key)\n      const orderIndex = accessOrder.indexOf(key)\n      if (orderIndex !== -1) {\n        accessOrder.splice(orderIndex, 1)\n      }\n      debugLog(`[memoizeAsync:${name}] clear`, { key, reason: 'error' })\n      throw e\n    }\n  }\n}\n\n/**\n * Create a memoized version of a method.\n * Preserves 'this' context for class methods.\n *\n * @param target - Object containing the method\n * @param propertyKey - Method name\n * @param descriptor - Property descriptor\n * @returns Modified descriptor with memoized method\n *\n * @example\n * import { Memoize } from '@socketsecurity/lib/memoization'\n *\n * class Calculator {\n *   @Memoize()\n *   fibonacci(n: number): number {\n *     if (n <= 1) return n\n *     return this.fibonacci(n - 1) + this.fibonacci(n - 2)\n *   }\n * }\n */\nexport function Memoize(options: MemoizeOptions<unknown[], unknown> = {}) {\n  return (\n    _target: unknown,\n    propertyKey: string,\n    descriptor: PropertyDescriptor,\n  ): PropertyDescriptor => {\n    const originalMethod = descriptor.value as (...args: unknown[]) => unknown\n\n    descriptor.value = memoize(originalMethod, {\n      ...options,\n      name: options.name || propertyKey,\n    })\n\n    return descriptor\n  }\n}\n\n/**\n * Clear all memoization caches.\n * Useful for testing or when you need to force recomputation.\n */\nexport function clearAllMemoizationCaches(): void {\n  // Note: This requires the memoized functions to be tracked globally.\n  // For now, this is a placeholder that logs the intent.\n  debugLog('[memoize:all] clear', { action: 'clear-all-caches' })\n}\n\n/**\n * Memoize with WeakMap for object keys.\n * Allows garbage collection when objects are no longer referenced.\n * Only works when first argument is an object.\n *\n * @param fn - Function to memoize\n * @returns Memoized version using WeakMap\n *\n * @example\n * import { memoizeWeak } from '@socketsecurity/lib/memoization'\n *\n * const processConfig = memoizeWeak((config: Config) => {\n *   return expensiveTransform(config)\n * })\n *\n * processConfig(config1) // Computed\n * processConfig(config1) // Cached\n * // When config1 is no longer referenced, cache entry is GC'd\n */\nexport function memoizeWeak<K extends object, Result>(\n  fn: (key: K) => Result,\n): (key: K) => Result {\n  const cache = new WeakMap<K, Result>()\n\n  return function memoized(key: K): Result {\n    const cached = cache.get(key)\n    if (cached !== undefined) {\n      debugLog(`[memoizeWeak:${fn.name}] hit`)\n      return cached\n    }\n\n    debugLog(`[memoizeWeak:${fn.name}] miss`)\n    const result = fn(key)\n    cache.set(key, result)\n    return result\n  }\n}\n\n/**\n * Simple once() implementation - caches single result forever.\n * Useful for initialization functions that should only run once.\n *\n * @param fn - Function to run once\n * @returns Memoized version that only executes once\n *\n * @example\n * import { once } from '@socketsecurity/lib/memoization'\n *\n * const initialize = once(() => {\n *   console.log('Initializing\u2026')\n *   return loadConfig()\n * })\n *\n * initialize() // Logs \"Initializing\u2026\" and returns config\n * initialize() // Returns cached config (no log)\n */\nexport function once<Result>(fn: () => Result): () => Result {\n  let called = false\n  let result: Result\n\n  return function memoized(): Result {\n    if (!called) {\n      result = fn()\n      called = true\n      debugLog(`[once:${fn.name}] set`)\n    } else {\n      debugLog(`[once:${fn.name}] hit`)\n    }\n    return result\n  }\n}\n\n/**\n * Create a debounced memoized function.\n * Combines memoization with debouncing for expensive operations.\n *\n * @param fn - Function to memoize and debounce\n * @param wait - Debounce wait time in milliseconds\n * @param options - Memoization options\n * @returns Debounced memoized function\n *\n * @example\n * import { memoizeDebounced } from '@socketsecurity/lib/memoization'\n *\n * const search = memoizeDebounced(\n *   (query: string) => performSearch(query),\n *   300,\n *   { name: 'search' }\n * )\n */\nexport function memoizeDebounced<Args extends unknown[], Result>(\n  fn: (...args: Args) => Result,\n  wait: number,\n  options: MemoizeOptions<Args, Result> = {},\n): (...args: Args) => Result {\n  const memoized = memoize(fn, options)\n  let timeoutId: NodeJS.Timeout | undefined\n\n  return function debounced(...args: Args): Result {\n    if (timeoutId) {\n      clearTimeout(timeoutId)\n    }\n\n    timeoutId = setTimeout(() => {\n      memoized(...args)\n    }, wait)\n\n    // For immediate return, try cached value or compute synchronously\n    return memoized(...args)\n  }\n}\n"],
   "mappings": "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",
   "names": ["memoization_exports", "__export", "Memoize", "clearAllMemoizationCaches", "memoize", "memoizeAsync", "memoizeDebounced", "memoizeWeak", "once", "__toCommonJS", "import_debug", "fn", "options", "keyGen", "args", "maxSize", "name", "ttl", "cache", "accessOrder", "evictLRU", "oldest", "isExpired", "entry", "key", "cached", "index", "value", "promise", "e", "orderIndex", "_target", "propertyKey", "descriptor", "originalMethod", "result", "called", "wait", "memoized", "timeoutId"]
 }

package/dist/performance.d.ts

@@ -16,7 +16,7 @@ type PerformanceMetrics = {
  * @returns Stop function that completes the timing
  *
  * @example
- * import { perfTimer } from '@socketsecurity/registry/lib/performance'
+ * import { perfTimer } from '@socketsecurity/lib/performance'
  *
  * const stop = perfTimer('api-call')
  * await fetchData()
@@ -32,7 +32,7 @@ export declare function perfTimer(operation: string, metadata?: Record<string, u
  * @returns Result of the function and duration
  *
  * @example
- * import { measure } from '@socketsecurity/registry/lib/performance'
+ * import { measure } from '@socketsecurity/lib/performance'
  *
  * const { result, duration } = await measure('fetch-packages', async () => {
  *   return await fetchPackages()
@@ -52,7 +52,7 @@ export declare function measure<T>(operation: string, fn: () => Promise<T>, meta
  * @returns Result of the function and duration
  *
  * @example
- * import { measureSync } from '@socketsecurity/registry/lib/performance'
+ * import { measureSync } from '@socketsecurity/lib/performance'
  *
  * const { result, duration } = measureSync('parse-json', () => {
  *   return JSON.parse(data)
@@ -69,7 +69,7 @@ export declare function measureSync<T>(operation: string, fn: () => T, metadata?
  * @returns Array of performance metrics
  *
  * @example
- * import { getPerformanceMetrics } from '@socketsecurity/registry/lib/performance'
+ * import { getPerformanceMetrics } from '@socketsecurity/lib/performance'
  *
  * const metrics = getPerformanceMetrics()
  * console.log(metrics)
@@ -79,7 +79,7 @@ export declare function getPerformanceMetrics(): PerformanceMetrics[];
  * Clear all collected performance metrics.
  *
  * @example
- * import { clearPerformanceMetrics } from '@socketsecurity/registry/lib/performance'
+ * import { clearPerformanceMetrics } from '@socketsecurity/lib/performance'
  *
  * clearPerformanceMetrics()
  */
@@ -90,7 +90,7 @@ export declare function clearPerformanceMetrics(): void;
  * @returns Summary of metrics grouped by operation
  *
  * @example
- * import { getPerformanceSummary } from '@socketsecurity/registry/lib/performance'
+ * import { getPerformanceSummary } from '@socketsecurity/lib/performance'
  *
  * const summary = getPerformanceSummary()
  * console.log(summary)
@@ -111,7 +111,7 @@ export declare function getPerformanceSummary(): Record<string, {
  * Only prints when DEBUG=perf is enabled.
  *
  * @example
- * import { printPerformanceSummary } from '@socketsecurity/registry/lib/performance'
+ * import { printPerformanceSummary } from '@socketsecurity/lib/performance'
  *
  * printPerformanceSummary()
  * // Performance Summary:
@@ -127,7 +127,7 @@ export declare function printPerformanceSummary(): void;
  * @param metadata - Optional metadata
  *
  * @example
- * import { perfCheckpoint } from '@socketsecurity/registry/lib/performance'
+ * import { perfCheckpoint } from '@socketsecurity/lib/performance'
  *
  * perfCheckpoint('start-scan')
  * // ... do work ...
@@ -145,7 +145,7 @@ export declare function perfCheckpoint(checkpoint: string, metadata?: Record<str
  * @returns Memory usage in MB
  *
  * @example
- * import { trackMemory } from '@socketsecurity/registry/lib/performance'
+ * import { trackMemory } from '@socketsecurity/lib/performance'
  *
  * const memBefore = trackMemory('before-operation')
  * await heavyOperation()
@@ -160,7 +160,7 @@ export declare function trackMemory(label: string): number;
  * @returns Formatted performance report
  *
  * @example
- * import { generatePerformanceReport } from '@socketsecurity/registry/lib/performance'
+ * import { generatePerformanceReport } from '@socketsecurity/lib/performance'
  *
  * console.log(generatePerformanceReport())
  * // ╔═══════════════════════════════════════════════╗

package/dist/performance.js.map

@@ -1,7 +1,7 @@
 {
   "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/registry/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/registry/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/registry/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/registry/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/registry/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/registry/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/registry/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/registry/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/registry/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/registry/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"],
+  "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"]
 }

package/dist/spinner.d.ts

@@ -61,7 +61,7 @@ export type ShimmerInfo = ShimmerState & {
  *
  * @example
  * ```ts
- * import { Spinner } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner } from '@socketsecurity/lib/spinner'
  *
  * const spinner = Spinner({ text: 'Loading…' })
  * spinner.start()
@@ -243,7 +243,7 @@ export declare function getCliSpinners(styleName?: string | undefined): SpinnerS
  *
  * @example
  * ```ts
- * import { Spinner } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner } from '@socketsecurity/lib/spinner'
  *
  * // Basic usage
  * const spinner = Spinner({ text: 'Loading data…' })
@@ -279,7 +279,7 @@ export declare function Spinner(options?: SpinnerOptions | undefined): Spinner;
  *
  * @example
  * ```ts
- * import { getDefaultSpinner } from '@socketsecurity/registry/lib/spinner'
+ * import { getDefaultSpinner } from '@socketsecurity/lib/spinner'
  *
  * const spinner = getDefaultSpinner()
  * spinner.start('Loading…')
@@ -294,11 +294,11 @@ export declare function getDefaultSpinner(): ReturnType<typeof Spinner>;
  * @example
  * ```ts
  * // Old (deprecated):
- * import { spinner } from '@socketsecurity/registry/lib/spinner'
+ * import { spinner } from '@socketsecurity/lib/spinner'
  * spinner.start('Loading…')
  *
  * // New (recommended):
- * import { getDefaultSpinner } from '@socketsecurity/registry/lib/spinner'
+ * import { getDefaultSpinner } from '@socketsecurity/lib/spinner'
  * const spinner = getDefaultSpinner()
  * spinner.start('Loading…')
  * ```
@@ -334,7 +334,7 @@ export type WithSpinnerOptions<T> = {
  *
  * @example
  * ```ts
- * import { Spinner, withSpinner } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner, withSpinner } from '@socketsecurity/lib/spinner'
  *
  * const spinner = Spinner()
  *
@@ -384,7 +384,7 @@ export type WithSpinnerRestoreOptions<T> = {
  *
  * @example
  * ```ts
- * import { getDefaultSpinner, withSpinnerRestore } from '@socketsecurity/registry/lib/spinner'
+ * import { getDefaultSpinner, withSpinnerRestore } from '@socketsecurity/lib/spinner'
  *
  * const spinner = getDefaultSpinner()
  * const wasSpinning = spinner.isSpinning
@@ -432,7 +432,7 @@ export type WithSpinnerSyncOptions<T> = {
  *
  * @example
  * ```ts
- * import { Spinner, withSpinnerSync } from '@socketsecurity/registry/lib/spinner'
+ * import { Spinner, withSpinnerSync } from '@socketsecurity/lib/spinner'
  *
  * const spinner = Spinner()
  *