@socketsecurity/lib 0.0.0 → 1.0.1

package/dist/logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/logger.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Console logging utilities with line prefix support.\n * Provides enhanced console methods with formatted output capabilities.\n */\n\nimport isUnicodeSupported from './external/@socketregistry/is-unicode-supported'\nimport yoctocolorsCjs from './external/yoctocolors-cjs'\nimport { objectAssign, objectFreeze } from './objects'\nimport { applyLinePrefix, isBlankString } from './strings'\n\n// Type definitions\ntype LogSymbols = {\n  fail: string\n  info: string\n  success: string\n  warn: string\n}\n\ntype LoggerMethods = {\n  [K in keyof typeof console]: (typeof console)[K] extends (\n    ...args: infer A\n    // biome-ignore lint/suspicious/noExplicitAny: Console method return types are dynamic.\n  ) => any\n    ? (...args: A) => Logger\n    : (typeof console)[K]\n}\n\ninterface Task {\n  run<T>(f: () => T): T\n}\n\nexport type { LogSymbols, LoggerMethods, Task }\n\nconst globalConsole = console\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst ReflectApply = Reflect.apply\nconst ReflectConstruct = Reflect.construct\n\nlet _Console: typeof import('console').Console | undefined\n/**\n * Construct a new Console instance.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction constructConsole(...args: unknown[]) {\n  if (_Console === undefined) {\n    // Use non-'node:' prefixed require to avoid Webpack errors.\n\n    const nodeConsole = /*@__PURE__*/ require('node:console')\n    _Console = nodeConsole.Console\n  }\n  return ReflectConstruct(\n    // biome-ignore lint/style/noNonNullAssertion: Initialized above.\n    _Console! as new (\n      ...args: unknown[]\n    ) => Console, // eslint-disable-line no-undef\n    args,\n  )\n}\n\n/**\n * Get the yoctocolors module for terminal colors.\n * @private\n */\n/*@__NO_SIDE_EFFECTS__*/\nfunction getYoctocolors() {\n  return yoctocolorsCjs\n}\n\nexport const LOG_SYMBOLS = /*@__PURE__*/ (() => {\n  const target: Record<string, string> = {\n    __proto__: null,\n  } as unknown as Record<string, string>\n  // Mutable handler to simulate a frozen target.\n  const handler: ProxyHandler<Record<string, string>> = {\n    __proto__: null,\n  } as unknown as ProxyHandler<Record<string, string>>\n  const init = () => {\n    const supported = isUnicodeSupported()\n    const colors = getYoctocolors()\n    objectAssign(target, {\n      fail: colors.red(supported ? '\u2716' : '\u00D7'),\n      info: colors.blue(supported ? '\u2139' : 'i'),\n      success: colors.green(supported ? '\u2714' : '\u221A'),\n      warn: colors.yellow(supported ? '\u26A0' : '\u203C'),\n    })\n    objectFreeze(target)\n    // The handler of a Proxy is mutable after proxy instantiation.\n    // We delete the traps to defer to native behavior.\n    for (const trapName in handler) {\n      delete handler[trapName as keyof ProxyHandler<Record<string, string>>]\n    }\n  }\n  for (const trapName of Reflect.ownKeys(Reflect)) {\n    const fn = (Reflect as Record<PropertyKey, unknown>)[trapName]\n    if (typeof fn === 'function') {\n      ;(handler as Record<string, (...args: unknown[]) => unknown>)[\n        trapName as string\n      ] = (...args: unknown[]) => {\n        init()\n        return fn(...args)\n      }\n    }\n  }\n  return new Proxy(target, handler)\n})()\n\nconst boundConsoleEntries = [\n  // Add bound properties from console[kBindProperties](ignoreErrors, colorMode, groupIndentation).\n  // https://github.com/nodejs/node/blob/v24.0.1/lib/internal/console/constructor.js#L230-L265\n  '_stderrErrorHandler',\n  '_stdoutErrorHandler',\n  // Add methods that need to be bound to function properly.\n  'assert',\n  'clear',\n  'count',\n  'countReset',\n  'createTask',\n  'debug',\n  'dir',\n  'dirxml',\n  'error',\n  // Skip group methods because in at least Node 20 with the Node --frozen-intrinsics\n  // flag it triggers a readonly property for Symbol(kGroupIndent). Instead, we\n  // implement these methods ourselves.\n  //'group',\n  //'groupCollapsed',\n  //'groupEnd',\n  'info',\n  'log',\n  'table',\n  'time',\n  'timeEnd',\n  'timeLog',\n  'trace',\n  'warn',\n]\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic console method access.\n  .filter(n => typeof (globalConsole as any)[n] === 'function')\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic console method access.\n  .map(n => [n, (globalConsole as any)[n].bind(globalConsole)])\n\nconst consolePropAttributes = {\n  __proto__: null,\n  writable: true,\n  enumerable: false,\n  configurable: true,\n}\nconst maxIndentation = 1000\nconst privateConsole = new WeakMap()\n\nconst consoleSymbols = Object.getOwnPropertySymbols(globalConsole)\nexport const incLogCallCountSymbol = Symbol.for('logger.logCallCount++')\nconst kGroupIndentationWidthSymbol =\n  // biome-ignore lint/suspicious/noExplicitAny: Symbol property access.\n  consoleSymbols.find(s => (s as any).label === 'kGroupIndentWidth') ??\n  Symbol('kGroupIndentWidth')\nexport const lastWasBlankSymbol = Symbol.for('logger.lastWasBlank')\n\n/**\n * Custom Logger class that wraps console with additional features.\n * Supports indentation, symbols, and blank line tracking.\n */\n/*@__PURE__*/\nexport class Logger {\n  static LOG_SYMBOLS = LOG_SYMBOLS\n\n  #parent?: Logger\n  #boundStream?: 'stderr' | 'stdout'\n  #stderrLogger?: Logger\n  #stdoutLogger?: Logger\n  #stderrIndention = ''\n  #stdoutIndention = ''\n  #lastWasBlank = false\n  #logCallCount = 0\n  #constructorArgs: unknown[]\n  #options: Record<string, unknown>\n\n  constructor(...args: unknown[]) {\n    // Store constructor args for child loggers\n    this.#constructorArgs = args\n\n    // Store options if provided (for future extensibility)\n    const options = args['0']\n    if (typeof options === 'object' && options !== null) {\n      this.#options = { __proto__: null, ...options }\n    } else {\n      this.#options = { __proto__: null }\n    }\n\n    if (args.length) {\n      privateConsole.set(this, constructConsole(...args))\n    } else {\n      // Create a new console that acts like the builtin one so that it will\n      // work with Node's --frozen-intrinsics flag.\n      const con = constructConsole({\n        stdout: process.stdout,\n        stderr: process.stderr,\n      }) as typeof console & Record<string, unknown>\n      for (const { 0: key, 1: method } of boundConsoleEntries) {\n        con[key] = method\n      }\n      privateConsole.set(this, con)\n    }\n  }\n\n  /**\n   * Get a logger instance bound to stderr.\n   * All operations on this instance will use stderr.\n   */\n  get stderr(): Logger {\n    if (!this.#stderrLogger) {\n      // Pass parent's constructor args to maintain config\n      const instance = new Logger(...this.#constructorArgs)\n      instance.#parent = this\n      instance.#boundStream = 'stderr'\n      instance.#options = { __proto__: null, ...this.#options }\n      this.#stderrLogger = instance\n    }\n    return this.#stderrLogger\n  }\n\n  /**\n   * Get a logger instance bound to stdout.\n   * All operations on this instance will use stdout.\n   */\n  get stdout(): Logger {\n    if (!this.#stdoutLogger) {\n      // Pass parent's constructor args to maintain config\n      const instance = new Logger(...this.#constructorArgs)\n      instance.#parent = this\n      instance.#boundStream = 'stdout'\n      instance.#options = { __proto__: null, ...this.#options }\n      this.#stdoutLogger = instance\n    }\n    return this.#stdoutLogger\n  }\n\n  /**\n   * Get the root logger (for accessing shared indentation state).\n   * @private\n   */\n  #getRoot(): Logger {\n    return this.#parent || this\n  }\n\n  /**\n   * Get indentation for a specific stream.\n   * @private\n   */\n  #getIndent(stream: 'stderr' | 'stdout'): string {\n    const root = this.#getRoot()\n    return stream === 'stderr' ? root.#stderrIndention : root.#stdoutIndention\n  }\n\n  /**\n   * Set indentation for a specific stream.\n   * @private\n   */\n  #setIndent(stream: 'stderr' | 'stdout', value: string): void {\n    const root = this.#getRoot()\n    if (stream === 'stderr') {\n      root.#stderrIndention = value\n    } else {\n      root.#stdoutIndention = value\n    }\n  }\n\n  /**\n   * Get the target stream for this logger instance.\n   * @private\n   */\n  #getTargetStream(): 'stderr' | 'stdout' {\n    return this.#boundStream || 'stderr'\n  }\n\n  /**\n   * Apply a console method with indentation.\n   * @private\n   */\n  #apply(\n    methodName: string,\n    args: unknown[],\n    stream?: 'stderr' | 'stdout',\n  ): this {\n    const con = privateConsole.get(this) as typeof console &\n      Record<string, unknown>\n    const text = args.at(0)\n    const hasText = typeof text === 'string'\n    // Determine which stream this method writes to\n    const targetStream = stream || (methodName === 'log' ? 'stdout' : 'stderr')\n    const indent = this.#getIndent(targetStream)\n    const logArgs = hasText\n      ? [applyLinePrefix(text, { prefix: indent }), ...args.slice(1)]\n      : args\n    ReflectApply(\n      con[methodName] as (...args: unknown[]) => unknown,\n      con,\n      logArgs,\n    )\n    this[lastWasBlankSymbol](hasText && isBlankString(logArgs[0]))\n    // biome-ignore lint/suspicious/noExplicitAny: Symbol method access.\n    ;(this as any)[incLogCallCountSymbol]()\n    return this\n  }\n\n  /**\n   * Strip log symbols from the start of text.\n   * @private\n   */\n  #stripSymbols(text: string): string {\n    // Strip both unicode and emoji forms of log symbols from the start.\n    // Matches: \u2716, \u2717, \u00D7, \u2716\uFE0F, \u26A0, \u203C, \u26A0\uFE0F, \u2714, \u2713, \u221A, \u2714\uFE0F, \u2713\uFE0F, \u2139, \u2139\uFE0F\n    // Also handles variation selectors (U+FE0F) and whitespace after symbol.\n    // Note: We don't strip standalone 'i' to avoid breaking words like 'info'.\n    return text.replace(/^[\u2716\u2717\u00D7\u26A0\u203C\u2714\u2713\u221A\u2139]\\uFE0F?\\s*/u, '')\n  }\n\n  /**\n   * Apply a method with a symbol prefix.\n   * @private\n   */\n  #symbolApply(symbolType: string, args: unknown[]): this {\n    const con = privateConsole.get(this)\n    let text = args.at(0)\n    // biome-ignore lint/suspicious/noImplicitAnyLet: Flexible argument handling.\n    let extras\n    if (typeof text === 'string') {\n      text = this.#stripSymbols(text)\n      extras = args.slice(1)\n    } else {\n      extras = args\n      text = ''\n    }\n    // Note: Meta status messages (info/fail/etc) always go to stderr.\n    const indent = this.#getIndent('stderr')\n    con.error(\n      applyLinePrefix(`${LOG_SYMBOLS[symbolType]} ${text}`, {\n        prefix: indent,\n      }),\n      ...extras,\n    )\n    this.#lastWasBlank = false\n    // biome-ignore lint/suspicious/noExplicitAny: Symbol method access.\n    ;(this as any)[incLogCallCountSymbol]()\n    return this\n  }\n\n  /**\n   * Get the current log call count.\n   */\n  get logCallCount() {\n    return this.#logCallCount\n  }\n\n  /**\n   * Increment the log call count.\n   */\n  [incLogCallCountSymbol]() {\n    this.#logCallCount += 1\n    return this\n  }\n\n  /**\n   * Set whether the last logged line was blank.\n   */\n  [lastWasBlankSymbol](value: unknown): this {\n    this.#lastWasBlank = !!value\n    return this\n  }\n\n  /**\n   * Log an assertion.\n   */\n  assert(value: unknown, ...message: unknown[]): this {\n    const con = privateConsole.get(this)\n    con.assert(value, ...message)\n    this[lastWasBlankSymbol](false)\n    return value ? this : this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * Clear the visible terminal screen.\n   * Only available on the main logger instance.\n   */\n  clearVisible() {\n    if (this.#boundStream) {\n      throw new Error(\n        'clearVisible() is only available on the main logger instance, not on stream-bound instances',\n      )\n    }\n    const con = privateConsole.get(this)\n    con.clear()\n    // biome-ignore lint/suspicious/noExplicitAny: Internal console property access.\n    if ((con as any)._stdout.isTTY) {\n      // biome-ignore lint/suspicious/noExplicitAny: Symbol method access.\n      ;(this as any)[lastWasBlankSymbol](true)\n      this.#logCallCount = 0\n    }\n    return this\n  }\n\n  /**\n   * Log a count for the given label.\n   */\n  count(label?: string): this {\n    const con = privateConsole.get(this)\n    con.count(label)\n    this[lastWasBlankSymbol](false)\n    return this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * Create a task with a given name.\n   */\n  createTask(name: string): Task {\n    return {\n      run: <T>(f: () => T): T => {\n        this.log(`Starting task: ${name}`)\n        const result = f()\n        this.log(`Completed task: ${name}`)\n        return result\n      },\n    }\n  }\n\n  /**\n   * Decrease indentation level.\n   * If called on main logger, affects both streams.\n   * If called on stream-bound logger, affects only that stream.\n   */\n  dedent(spaces = 2) {\n    if (this.#boundStream) {\n      // Only affect bound stream\n      const current = this.#getIndent(this.#boundStream)\n      this.#setIndent(this.#boundStream, current.slice(0, -spaces))\n    } else {\n      // Affect both streams\n      const stderrCurrent = this.#getIndent('stderr')\n      const stdoutCurrent = this.#getIndent('stdout')\n      this.#setIndent('stderr', stderrCurrent.slice(0, -spaces))\n      this.#setIndent('stdout', stdoutCurrent.slice(0, -spaces))\n    }\n    return this\n  }\n\n  /**\n   * Display an object's properties.\n   */\n  dir(obj: unknown, options?: unknown): this {\n    const con = privateConsole.get(this)\n    con.dir(obj, options)\n    this[lastWasBlankSymbol](false)\n    return this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * Display data as XML.\n   */\n  dirxml(...data: unknown[]): this {\n    const con = privateConsole.get(this)\n    con.dirxml(data)\n    this[lastWasBlankSymbol](false)\n    return this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * Log an error message.\n   */\n  error(...args: unknown[]): this {\n    return this.#apply('error', args)\n  }\n\n  /**\n   * Log a newline to stderr if last line wasn't blank.\n   */\n  errorNewline() {\n    return this.#lastWasBlank ? this : this.error('')\n  }\n\n  /**\n   * Log a failure message with symbol.\n   */\n  fail(...args: unknown[]): this {\n    return this.#symbolApply('fail', args)\n  }\n\n  /**\n   * Start a new log group.\n   */\n  group(...label: unknown[]): this {\n    const { length } = label\n    if (length) {\n      ReflectApply(this.log, this, label)\n    }\n    // biome-ignore lint/suspicious/noExplicitAny: Symbol property access.\n    this.indent((this as any)[kGroupIndentationWidthSymbol])\n    if (length) {\n      // biome-ignore lint/suspicious/noExplicitAny: Symbol method access.\n      ;(this as any)[lastWasBlankSymbol](false)\n      // biome-ignore lint/suspicious/noExplicitAny: Symbol method access.\n      ;(this as any)[incLogCallCountSymbol]()\n    }\n    return this\n  }\n\n  /**\n   * Start a new collapsed log group (alias for group).\n   */\n  // groupCollapsed is an alias of group.\n  // https://nodejs.org/api/console.html#consolegroupcollapsed\n  groupCollapsed(...label: unknown[]): this {\n    return ReflectApply(this.group, this, label)\n  }\n\n  /**\n   * End the current log group.\n   */\n  groupEnd() {\n    // biome-ignore lint/suspicious/noExplicitAny: Symbol property access.\n    this.dedent((this as any)[kGroupIndentationWidthSymbol])\n    return this\n  }\n\n  /**\n   * Increase indentation level.\n   * If called on main logger, affects both streams.\n   * If called on stream-bound logger, affects only that stream.\n   */\n  indent(spaces = 2) {\n    const spacesToAdd = ' '.repeat(Math.min(spaces, maxIndentation))\n    if (this.#boundStream) {\n      // Only affect bound stream\n      const current = this.#getIndent(this.#boundStream)\n      this.#setIndent(this.#boundStream, current + spacesToAdd)\n    } else {\n      // Affect both streams\n      const stderrCurrent = this.#getIndent('stderr')\n      const stdoutCurrent = this.#getIndent('stdout')\n      this.#setIndent('stderr', stderrCurrent + spacesToAdd)\n      this.#setIndent('stdout', stdoutCurrent + spacesToAdd)\n    }\n    return this\n  }\n\n  /**\n   * Log an info message with symbol.\n   */\n  info(...args: unknown[]): this {\n    return this.#symbolApply('info', args)\n  }\n\n  /**\n   * Log a message.\n   */\n  log(...args: unknown[]): this {\n    return this.#apply('log', args)\n  }\n\n  /**\n   * Log a newline to stdout if last line wasn't blank.\n   */\n  logNewline() {\n    return this.#lastWasBlank ? this : this.log('')\n  }\n\n  /**\n   * Reset indentation to zero.\n   * If called on main logger, resets both streams.\n   * If called on stream-bound logger, resets only that stream.\n   */\n  resetIndent() {\n    if (this.#boundStream) {\n      // Only reset bound stream\n      this.#setIndent(this.#boundStream, '')\n    } else {\n      // Reset both streams\n      this.#setIndent('stderr', '')\n      this.#setIndent('stdout', '')\n    }\n    return this\n  }\n\n  /**\n   * Log a main step with blank line before (stateless).\n   */\n  step(msg: string, ...extras: unknown[]): this {\n    // Add blank line before the step message.\n    if (!this.#lastWasBlank) {\n      // Use this.log() to properly track the blank line.\n      this.log('')\n    }\n    // Let log() handle all tracking.\n    return this.log(msg, ...extras)\n  }\n\n  /**\n   * Log an indented substep (stateless).\n   */\n  substep(msg: string, ...extras: unknown[]): this {\n    // Add 2-space indent to the message.\n    const indentedMsg = `  ${msg}`\n    // Let log() handle all tracking.\n    return this.log(indentedMsg, ...extras)\n  }\n\n  /**\n   * Log a success message with symbol.\n   */\n  success(...args: unknown[]): this {\n    return this.#symbolApply('success', args)\n  }\n\n  /**\n   * Log a done message (alias for success).\n   * Does NOT auto-clear. Call clearLine() first if needed after progress().\n   */\n  done(...args: unknown[]): this {\n    return this.#symbolApply('success', args)\n  }\n\n  /**\n   * Display data in a table format.\n   */\n  table(tabularData: unknown, properties?: readonly string[]): this {\n    const con = privateConsole.get(this)\n    con.table(tabularData, properties)\n    this[lastWasBlankSymbol](false)\n    return this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * End a timer and log the elapsed time.\n   */\n  timeEnd(label?: string): this {\n    const con = privateConsole.get(this)\n    con.timeEnd(label)\n    this[lastWasBlankSymbol](false)\n    return this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * Log the current timer value.\n   */\n  timeLog(label?: string, ...data: unknown[]): this {\n    const con = privateConsole.get(this)\n    con.timeLog(label, ...data)\n    this[lastWasBlankSymbol](false)\n    return this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * Log a stack trace.\n   */\n  trace(message?: unknown, ...args: unknown[]): this {\n    const con = privateConsole.get(this)\n    con.trace(message, ...args)\n    this[lastWasBlankSymbol](false)\n    return this[incLogCallCountSymbol]()\n  }\n\n  /**\n   * Log a warning message with symbol.\n   */\n  warn(...args: unknown[]): this {\n    return this.#symbolApply('warn', args)\n  }\n\n  /**\n   * Write to stdout without a newline or indentation.\n   */\n  write(text: string): this {\n    const con = privateConsole.get(this)\n    con._stdout.write(text)\n    this[lastWasBlankSymbol](false)\n    return this\n  }\n\n  /**\n   * Show a progress indicator (can be cleared with clearLine).\n   * Simple status message without spinner animation.\n   */\n  progress(text: string): this {\n    const con = privateConsole.get(this)\n    const stream = this.#getTargetStream()\n    const streamObj = stream === 'stderr' ? con._stderr : con._stdout\n    streamObj.write(`\u2234 ${text}`)\n    this[lastWasBlankSymbol](false)\n    return this\n  }\n\n  /**\n   * Clear the current line.\n   */\n  clearLine(): this {\n    const con = privateConsole.get(this)\n    const stream = this.#getTargetStream()\n    const streamObj = stream === 'stderr' ? con._stderr : con._stdout\n    if (streamObj.isTTY) {\n      streamObj.cursorTo(0)\n      streamObj.clearLine(0)\n    } else {\n      streamObj.write('\\r\\x1b[K')\n    }\n    return this\n  }\n}\n\nObject.defineProperties(\n  Logger.prototype,\n  Object.fromEntries(\n    (() => {\n      const entries: Array<[string | symbol, PropertyDescriptor]> = [\n        [\n          kGroupIndentationWidthSymbol,\n          {\n            ...consolePropAttributes,\n            value: 2,\n          },\n        ],\n        [\n          Symbol.toStringTag,\n          {\n            __proto__: null,\n            configurable: true,\n            value: 'logger',\n          } as PropertyDescriptor,\n        ],\n      ]\n      for (const { 0: key, 1: value } of Object.entries(globalConsole)) {\n        // biome-ignore lint/suspicious/noExplicitAny: Dynamic prototype check.\n        if (!(Logger.prototype as any)[key] && typeof value === 'function') {\n          // Dynamically name the log method without using Object.defineProperty.\n          const { [key]: func } = {\n            [key](...args: unknown[]) {\n              const con = privateConsole.get(this)\n              // biome-ignore lint/suspicious/noExplicitAny: Dynamic console method access.\n              const result = (con as any)[key](...args)\n              return result === undefined || result === con ? this : result\n            },\n          }\n          entries.push([\n            key,\n            {\n              ...consolePropAttributes,\n              value: func,\n            },\n          ])\n        }\n      }\n      return entries\n    })(),\n  ),\n)\n\nexport const logger = new Logger()\n"],
+  "mappings": "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",
+  "names": ["yoctocolorsCjs", "isUnicodeSupported"]
+}

package/dist/maintained-node-versions.d.ts

@@ -0,0 +1,7 @@
+declare const _default: readonly string[] & {
+    current: string;
+    last: string;
+    next: string;
+    previous: string;
+};
+export default _default;

package/dist/maintained-node-versions.js

@@ -0,0 +1,37 @@
+/* Socket Lib - Built with esbuild */
+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 maintained_node_versions_exports = {};
+__export(maintained_node_versions_exports, {
+  default: () => maintained_node_versions_default
+});
+module.exports = __toCommonJS(maintained_node_versions_exports);
+const ObjectFreeze = Object.freeze;
+const next = "25.0.0";
+const current = "22.20.0";
+const previous = "20.19.5";
+const last = "18.20.8";
+var maintained_node_versions_default = ObjectFreeze(
+  Object.assign([last, previous, current, next], {
+    current,
+    last,
+    next,
+    previous
+  })
+);
+//# sourceMappingURL=maintained-node-versions.js.map

package/dist/maintained-node-versions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/maintained-node-versions.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Maintained Node.js versions without external dependencies.\n */\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst ObjectFreeze = Object.freeze\n\n// Manually maintained Node.js version list.\n// https://nodejs.org/en/about/previous-releases#looking-for-latest-release-of-a-version-branch\n//\n// Updated October 16th, 2025.\n// - v25: 25.0.0 (Current)\n// - v24: 24.10.0 (Current)\n// - v22: 22.20.0 (Active LTS)\n// - v20: 20.19.5 (Maintenance LTS)\n// - v18: 18.20.8 (End-of-life)\nconst next = '25.0.0'\nconst current = '22.20.0'\nconst previous = '20.19.5'\nconst last = '18.20.8'\n\nexport default ObjectFreeze(\n  Object.assign([last, previous, current, next], {\n    current,\n    last,\n    next,\n    previous,\n  }),\n) as readonly string[] & {\n  current: string\n  last: string\n  next: string\n  previous: string\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,MAAM,eAAe,OAAO;AAW5B,MAAM,OAAO;AACb,MAAM,UAAU;AAChB,MAAM,WAAW;AACjB,MAAM,OAAO;AAEb,IAAO,mCAAQ;AAAA,EACb,OAAO,OAAO,CAAC,MAAM,UAAU,SAAS,IAAI,GAAG;AAAA,IAC7C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/memoization.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Options for memoization behavior.
+ */
+type MemoizeOptions<Args extends unknown[], _Result = unknown> = {
+    /** Custom cache key generator (defaults to JSON.stringify) */
+    keyGen?: (...args: Args) => string;
+    /** Maximum cache size (LRU eviction when exceeded) */
+    maxSize?: number;
+    /** TTL in milliseconds (cache entries expire after this time) */
+    ttl?: number;
+    /** Cache name for debugging */
+    name?: string;
+    /** Weak cache for object keys (enables GC) */
+    weak?: boolean;
+    /** Custom equality check for cache hits */
+    equals?: (a: Args, b: Args) => boolean;
+};
+/**
+ * Memoize a function with configurable caching behavior.
+ * Caches function results to avoid repeated computation.
+ *
+ * @param fn - Function to memoize
+ * @param options - Memoization options
+ * @returns Memoized version of the function
+ *
+ * @example
+ * import { memoize } from '@socketsecurity/registry/lib/memoization'
+ *
+ * const expensiveOperation = memoize((n: number) => {
+ *   // Heavy computation
+ *   return Array(n).fill(0).reduce((a, _, i) => a + i, 0)
+ * }, { maxSize: 100, ttl: 60000, name: 'sum' })
+ *
+ * expensiveOperation(1000) // Computed
+ * expensiveOperation(1000) // Cached
+ */
+export declare function memoize<Args extends unknown[], Result>(fn: (...args: Args) => Result, options?: MemoizeOptions<Args, Result>): (...args: Args) => Result;
+/**
+ * Memoize an async function.
+ * Similar to memoize() but handles promises properly.
+ *
+ * @param fn - Async function to memoize
+ * @param options - Memoization options
+ * @returns Memoized version of the async function
+ *
+ * @example
+ * import { memoizeAsync } from '@socketsecurity/registry/lib/memoization'
+ *
+ * const fetchUser = memoizeAsync(async (id: string) => {
+ *   const response = await fetch(`/api/users/${id}`)
+ *   return response.json()
+ * }, { ttl: 300000, name: 'fetchUser' })
+ *
+ * await fetchUser('123') // Fetches from API
+ * await fetchUser('123') // Returns cached result
+ */
+export declare function memoizeAsync<Args extends unknown[], Result>(fn: (...args: Args) => Promise<Result>, options?: MemoizeOptions<Args, Result>): (...args: Args) => Promise<Result>;
+/**
+ * Create a memoized version of a method.
+ * Preserves 'this' context for class methods.
+ *
+ * @param target - Object containing the method
+ * @param propertyKey - Method name
+ * @param descriptor - Property descriptor
+ * @returns Modified descriptor with memoized method
+ *
+ * @example
+ * import { Memoize } from '@socketsecurity/registry/lib/memoization'
+ *
+ * class Calculator {
+ *   @Memoize()
+ *   fibonacci(n: number): number {
+ *     if (n <= 1) return n
+ *     return this.fibonacci(n - 1) + this.fibonacci(n - 2)
+ *   }
+ * }
+ */
+export declare function Memoize(options?: MemoizeOptions<unknown[], unknown>): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Clear all memoization caches.
+ * Useful for testing or when you need to force recomputation.
+ */
+export declare function clearAllMemoizationCaches(): void;
+/**
+ * Memoize with WeakMap for object keys.
+ * Allows garbage collection when objects are no longer referenced.
+ * Only works when first argument is an object.
+ *
+ * @param fn - Function to memoize
+ * @returns Memoized version using WeakMap
+ *
+ * @example
+ * import { memoizeWeak } from '@socketsecurity/registry/lib/memoization'
+ *
+ * const processConfig = memoizeWeak((config: Config) => {
+ *   return expensiveTransform(config)
+ * })
+ *
+ * processConfig(config1) // Computed
+ * processConfig(config1) // Cached
+ * // When config1 is no longer referenced, cache entry is GC'd
+ */
+export declare function memoizeWeak<K extends object, Result>(fn: (key: K) => Result): (key: K) => Result;
+/**
+ * Simple once() implementation - caches single result forever.
+ * Useful for initialization functions that should only run once.
+ *
+ * @param fn - Function to run once
+ * @returns Memoized version that only executes once
+ *
+ * @example
+ * import { once } from '@socketsecurity/registry/lib/memoization'
+ *
+ * const initialize = once(() => {
+ *   console.log('Initializing…')
+ *   return loadConfig()
+ * })
+ *
+ * initialize() // Logs "Initializing…" and returns config
+ * initialize() // Returns cached config (no log)
+ */
+export declare function once<Result>(fn: () => Result): () => Result;
+/**
+ * Create a debounced memoized function.
+ * Combines memoization with debouncing for expensive operations.
+ *
+ * @param fn - Function to memoize and debounce
+ * @param wait - Debounce wait time in milliseconds
+ * @param options - Memoization options
+ * @returns Debounced memoized function
+ *
+ * @example
+ * import { memoizeDebounced } from '@socketsecurity/registry/lib/memoization'
+ *
+ * const search = memoizeDebounced(
+ *   (query: string) => performSearch(query),
+ *   300,
+ *   { name: 'search' }
+ * )
+ */
+export declare function memoizeDebounced<Args extends unknown[], Result>(fn: (...args: Args) => Result, wait: number, options?: MemoizeOptions<Args, Result>): (...args: Args) => Result;
+export {};

package/dist/memoization.js

@@ -0,0 +1,212 @@
+/* Socket Lib - Built with esbuild */
+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 memoization_exports = {};
+__export(memoization_exports, {
+  Memoize: () => Memoize,
+  clearAllMemoizationCaches: () => clearAllMemoizationCaches,
+  memoize: () => memoize,
+  memoizeAsync: () => memoizeAsync,
+  memoizeDebounced: () => memoizeDebounced,
+  memoizeWeak: () => memoizeWeak,
+  once: () => once
+});
+module.exports = __toCommonJS(memoization_exports);
+var import_debug = require("./debug");
+function memoize(fn, options = {}) {
+  const {
+    keyGen = (...args) => JSON.stringify(args),
+    maxSize = Number.POSITIVE_INFINITY,
+    name = fn.name || "anonymous",
+    ttl = Number.POSITIVE_INFINITY
+  } = options;
+  const cache = /* @__PURE__ */ new Map();
+  const accessOrder = [];
+  function evictLRU() {
+    if (cache.size >= maxSize && accessOrder.length > 0) {
+      const oldest = accessOrder.shift();
+      if (oldest) {
+        cache.delete(oldest);
+        (0, import_debug.debugLog)(`[memoize:${name}] clear`, {
+          key: oldest,
+          reason: "LRU"
+        });
+      }
+    }
+  }
+  function isExpired(entry) {
+    if (ttl === Number.POSITIVE_INFINITY) {
+      return false;
+    }
+    return Date.now() - entry.timestamp > ttl;
+  }
+  return function memoized(...args) {
+    const key = keyGen(...args);
+    const cached = cache.get(key);
+    if (cached && !isExpired(cached)) {
+      cached.hits++;
+      const index = accessOrder.indexOf(key);
+      if (index !== -1) {
+        accessOrder.splice(index, 1);
+      }
+      accessOrder.push(key);
+      (0, import_debug.debugLog)(`[memoize:${name}] hit`, { key, hits: cached.hits });
+      return cached.value;
+    }
+    (0, import_debug.debugLog)(`[memoize:${name}] miss`, { key });
+    const value = fn(...args);
+    evictLRU();
+    cache.set(key, {
+      value,
+      timestamp: Date.now(),
+      hits: 0
+    });
+    accessOrder.push(key);
+    (0, import_debug.debugLog)(`[memoize:${name}] set`, { key, cacheSize: cache.size });
+    return value;
+  };
+}
+function memoizeAsync(fn, options = {}) {
+  const {
+    keyGen = (...args) => JSON.stringify(args),
+    maxSize = Number.POSITIVE_INFINITY,
+    name = fn.name || "anonymous",
+    ttl = Number.POSITIVE_INFINITY
+  } = options;
+  const cache = /* @__PURE__ */ new Map();
+  const accessOrder = [];
+  function evictLRU() {
+    if (cache.size >= maxSize && accessOrder.length > 0) {
+      const oldest = accessOrder.shift();
+      if (oldest) {
+        cache.delete(oldest);
+        (0, import_debug.debugLog)(`[memoizeAsync:${name}] clear`, {
+          key: oldest,
+          reason: "LRU"
+        });
+      }
+    }
+  }
+  function isExpired(entry) {
+    if (ttl === Number.POSITIVE_INFINITY) {
+      return false;
+    }
+    return Date.now() - entry.timestamp > ttl;
+  }
+  return async function memoized(...args) {
+    const key = keyGen(...args);
+    const cached = cache.get(key);
+    if (cached && !isExpired(cached)) {
+      cached.hits++;
+      const index = accessOrder.indexOf(key);
+      if (index !== -1) {
+        accessOrder.splice(index, 1);
+      }
+      accessOrder.push(key);
+      (0, import_debug.debugLog)(`[memoizeAsync:${name}] hit`, { key, hits: cached.hits });
+      return await cached.value;
+    }
+    (0, import_debug.debugLog)(`[memoizeAsync:${name}] miss`, { key });
+    const promise = fn(...args);
+    evictLRU();
+    cache.set(key, {
+      value: promise,
+      timestamp: Date.now(),
+      hits: 0
+    });
+    accessOrder.push(key);
+    (0, import_debug.debugLog)(`[memoizeAsync:${name}] set`, { key, cacheSize: cache.size });
+    try {
+      const result = await promise;
+      return result;
+    } catch (e) {
+      cache.delete(key);
+      const orderIndex = accessOrder.indexOf(key);
+      if (orderIndex !== -1) {
+        accessOrder.splice(orderIndex, 1);
+      }
+      (0, import_debug.debugLog)(`[memoizeAsync:${name}] clear`, { key, reason: "error" });
+      throw e;
+    }
+  };
+}
+function Memoize(options = {}) {
+  return (_target, propertyKey, descriptor) => {
+    const originalMethod = descriptor.value;
+    descriptor.value = memoize(originalMethod, {
+      ...options,
+      name: options.name || propertyKey
+    });
+    return descriptor;
+  };
+}
+function clearAllMemoizationCaches() {
+  (0, import_debug.debugLog)("[memoize:all] clear", { action: "clear-all-caches" });
+}
+function memoizeWeak(fn) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  return function memoized(key) {
+    const cached = cache.get(key);
+    if (cached !== void 0) {
+      (0, import_debug.debugLog)(`[memoizeWeak:${fn.name}] hit`);
+      return cached;
+    }
+    (0, import_debug.debugLog)(`[memoizeWeak:${fn.name}] miss`);
+    const result = fn(key);
+    cache.set(key, result);
+    return result;
+  };
+}
+function once(fn) {
+  let called = false;
+  let result;
+  return function memoized() {
+    if (!called) {
+      result = fn();
+      called = true;
+      (0, import_debug.debugLog)(`[once:${fn.name}] set`);
+    } else {
+      (0, import_debug.debugLog)(`[once:${fn.name}] hit`);
+    }
+    return result;
+  };
+}
+function memoizeDebounced(fn, wait, options = {}) {
+  const memoized = memoize(fn, options);
+  let timeoutId;
+  return function debounced(...args) {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(() => {
+      memoized(...args);
+    }, wait);
+    return memoized(...args);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Memoize,
+  clearAllMemoizationCaches,
+  memoize,
+  memoizeAsync,
+  memoizeDebounced,
+  memoizeWeak,
+  once
+});
+//# sourceMappingURL=memoization.js.map

package/dist/memoization.js.map

@@ -0,0 +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"],
+  "mappings": "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",
+  "names": []
+}