@geenius/tools 0.1.0 → 0.3.0

package/packages/logger/dist/index.js

@@ -0,0 +1,216 @@
+// src/index.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
+  LogLevel2[LogLevel2["INFO"] = 1] = "INFO";
+  LogLevel2[LogLevel2["WARN"] = 2] = "WARN";
+  LogLevel2[LogLevel2["ERROR"] = 3] = "ERROR";
+  LogLevel2[LogLevel2["FATAL"] = 4] = "FATAL";
+  return LogLevel2;
+})(LogLevel || {});
+var Logger = class _Logger {
+  level;
+  formatter;
+  transports;
+  timestamps;
+  sourceLocation;
+  context = /* @__PURE__ */ new Map();
+  constructor(config = {}) {
+    this.level = config.level ?? 1 /* INFO */;
+    this.formatter = config.formatter ?? defaultFormatter;
+    this.transports = config.transports ?? [consoleTransport];
+    this.timestamps = config.timestamps !== false;
+    this.sourceLocation = config.sourceLocation ?? false;
+  }
+  /**
+   * Logs with debug level
+   */
+  debug(message, context) {
+    this.log(0 /* DEBUG */, message, context);
+  }
+  /**
+   * Logs with info level
+   */
+  info(message, context) {
+    this.log(1 /* INFO */, message, context);
+  }
+  /**
+   * Logs with warn level
+   */
+  warn(message, context) {
+    this.log(2 /* WARN */, message, context);
+  }
+  /**
+   * Logs with error level
+   */
+  error(message, error, context) {
+    this.log(3 /* ERROR */, message, context, error);
+  }
+  /**
+   * Logs with fatal level
+   */
+  fatal(message, error, context) {
+    this.log(4 /* FATAL */, message, context, error);
+  }
+  /**
+   * Core logging method
+   */
+  log(level, message, context, error) {
+    if (level < this.level) {
+      return;
+    }
+    const mergedContext = {
+      ...Object.fromEntries(this.context),
+      ...context
+    };
+    const entry = {
+      level,
+      message,
+      context: Object.keys(mergedContext).length > 0 ? mergedContext : void 0,
+      error,
+      timestamp: /* @__PURE__ */ new Date()
+    };
+    if (this.sourceLocation) {
+      entry.metadata = {
+        ...entry.metadata,
+        location: this.getSourceLocation()
+      };
+    }
+    const formatted = this.formatter(entry);
+    for (const transport of this.transports) {
+      try {
+        void transport.log(entry);
+      } catch {
+      }
+    }
+  }
+  /**
+   * Sets context for all subsequent logs
+   */
+  setContext(key, value) {
+    this.context.set(key, value);
+    return this;
+  }
+  /**
+   * Gets current context
+   */
+  getContext() {
+    return Object.fromEntries(this.context);
+  }
+  /**
+   * Clears context
+   */
+  clearContext() {
+    this.context.clear();
+    return this;
+  }
+  /**
+   * Creates a child logger with inherited context
+   */
+  child(context) {
+    const child = new _Logger({
+      level: this.level,
+      formatter: this.formatter,
+      transports: this.transports,
+      timestamps: this.timestamps,
+      sourceLocation: this.sourceLocation
+    });
+    for (const [key, value] of this.context) {
+      child.setContext(key, value);
+    }
+    for (const [key, value] of Object.entries(context)) {
+      child.setContext(key, value);
+    }
+    return child;
+  }
+  /**
+   * Gets source location from stack trace
+   */
+  getSourceLocation() {
+    const stack = new Error().stack || "";
+    const lines = stack.split("\n");
+    for (let i = 2; i < lines.length; i++) {
+      const line = lines[i];
+      if (line.includes("Logger.") || line.includes("logger.")) {
+        continue;
+      }
+      const match = line.match(/at\s+(?:.*?\s+)?\(?([^:\)]+):(\d+)/);
+      if (match) {
+        return {
+          file: match[1],
+          line: parseInt(match[2])
+        };
+      }
+    }
+    return { file: "unknown", line: 0 };
+  }
+};
+var defaultFormatter = (entry) => {
+  const levelName = LogLevel[entry.level];
+  const timestamp = entry.timestamp.toISOString();
+  let output = `[${timestamp}] [${levelName}] ${entry.message}`;
+  if (entry.context && Object.keys(entry.context).length > 0) {
+    output += ` ${JSON.stringify(entry.context)}`;
+  }
+  if (entry.error) {
+    const errorStr = entry.error instanceof Error ? `${entry.error.name}: ${entry.error.message}` : String(entry.error);
+    output += ` Error: ${errorStr}`;
+  }
+  return output;
+};
+var consoleTransport = {
+  log(entry) {
+    const formatted = defaultFormatter(entry);
+    if (entry.level >= 3 /* ERROR */) {
+      console.error(formatted);
+    } else if (entry.level === 2 /* WARN */) {
+      console.warn(formatted);
+    } else {
+      console.log(formatted);
+    }
+  }
+};
+function createLogger(config) {
+  return new Logger(config);
+}
+var globalLogger = null;
+function getGlobalLogger(config) {
+  if (!globalLogger) {
+    globalLogger = createLogger(config);
+  }
+  return globalLogger;
+}
+function resetGlobalLogger() {
+  globalLogger = null;
+}
+var MemoryTransport = class {
+  entries = [];
+  log(entry) {
+    this.entries.push(entry);
+  }
+  /** Gets all logged entries */
+  getEntries() {
+    return [...this.entries];
+  }
+  /** Gets entries by level */
+  getByLevel(level) {
+    return this.entries.filter((e) => e.level === level);
+  }
+  /** Clears all entries */
+  clear() {
+    this.entries = [];
+  }
+  /** Gets count of entries */
+  size() {
+    return this.entries.length;
+  }
+};
+export {
+  LogLevel,
+  Logger,
+  MemoryTransport,
+  consoleTransport,
+  createLogger,
+  getGlobalLogger,
+  resetGlobalLogger
+};
+//# sourceMappingURL=index.js.map

package/packages/logger/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @geenius/tools-logger — Structured logging\n *\n * Provides structured logging with levels, formatting, and contextual data.\n * Suitable for both client and server environments.\n */\n\n/**\n * Log levels in order of severity\n */\nexport enum LogLevel {\n  DEBUG = 0,\n  INFO = 1,\n  WARN = 2,\n  ERROR = 3,\n  FATAL = 4,\n}\n\n/**\n * Log entry structure\n */\nexport interface LogEntry {\n  /** Log level */\n  level: LogLevel\n  /** Log message */\n  message: string\n  /** Contextual data */\n  context?: Record<string, unknown>\n  /** Error object if applicable */\n  error?: Error | unknown\n  /** Timestamp */\n  timestamp: Date\n  /** Additional metadata */\n  metadata?: Record<string, unknown>\n}\n\n/**\n * Log formatter function\n */\nexport type LogFormatter = (entry: LogEntry) => string\n\n/**\n * Logger transport (where logs go)\n */\nexport interface LogTransport {\n  /** Log handler function */\n  log(entry: LogEntry): void | Promise<void>\n}\n\n/**\n * Logger configuration\n */\nexport interface LoggerConfig {\n  /** Minimum log level to output (default: INFO) */\n  level?: LogLevel\n  /** Custom formatter (default: pretty print) */\n  formatter?: LogFormatter\n  /** Log transports */\n  transports?: LogTransport[]\n  /** Whether to include timestamps (default: true) */\n  timestamps?: boolean\n  /** Whether to include source location (default: false) */\n  sourceLocation?: boolean\n}\n\n/**\n * Structured logger with context and levels\n *\n * @example\n * ```ts\n * const logger = createLogger({ level: LogLevel.DEBUG })\n *\n * logger.info('User signed in', { userId: '123' })\n * logger.error('Database error', { error })\n * logger.debug('Cache hit', { key: 'user:123' })\n * ```\n */\nexport class Logger {\n  private level: LogLevel\n  private formatter: LogFormatter\n  private transports: LogTransport[]\n  private timestamps: boolean\n  private sourceLocation: boolean\n  private context: Map<string, unknown> = new Map()\n\n  constructor(config: LoggerConfig = {}) {\n    this.level = config.level ?? LogLevel.INFO\n    this.formatter = config.formatter ?? defaultFormatter\n    this.transports = config.transports ?? [consoleTransport]\n    this.timestamps = config.timestamps !== false\n    this.sourceLocation = config.sourceLocation ?? false\n  }\n\n  /**\n   * Logs with debug level\n   */\n  debug(message: string, context?: Record<string, unknown>) {\n    this.log(LogLevel.DEBUG, message, context)\n  }\n\n  /**\n   * Logs with info level\n   */\n  info(message: string, context?: Record<string, unknown>) {\n    this.log(LogLevel.INFO, message, context)\n  }\n\n  /**\n   * Logs with warn level\n   */\n  warn(message: string, context?: Record<string, unknown>) {\n    this.log(LogLevel.WARN, message, context)\n  }\n\n  /**\n   * Logs with error level\n   */\n  error(message: string, error?: Error | unknown, context?: Record<string, unknown>) {\n    this.log(LogLevel.ERROR, message, context, error)\n  }\n\n  /**\n   * Logs with fatal level\n   */\n  fatal(message: string, error?: Error | unknown, context?: Record<string, unknown>) {\n    this.log(LogLevel.FATAL, message, context, error)\n  }\n\n  /**\n   * Core logging method\n   */\n  private log(\n    level: LogLevel,\n    message: string,\n    context?: Record<string, unknown>,\n    error?: Error | unknown\n  ) {\n    if (level < this.level) {\n      return\n    }\n\n    const mergedContext = {\n      ...Object.fromEntries(this.context),\n      ...context,\n    }\n\n    const entry: LogEntry = {\n      level,\n      message,\n      context: Object.keys(mergedContext).length > 0 ? mergedContext : undefined,\n      error,\n      timestamp: new Date(),\n    }\n\n    if (this.sourceLocation) {\n      entry.metadata = {\n        ...entry.metadata,\n        location: this.getSourceLocation(),\n      }\n    }\n\n    const formatted = this.formatter(entry)\n\n    for (const transport of this.transports) {\n      try {\n        void transport.log(entry)\n      } catch {\n        // Silently fail to prevent logger errors from breaking app\n      }\n    }\n  }\n\n  /**\n   * Sets context for all subsequent logs\n   */\n  setContext(key: string, value: unknown) {\n    this.context.set(key, value)\n    return this\n  }\n\n  /**\n   * Gets current context\n   */\n  getContext(): Record<string, unknown> {\n    return Object.fromEntries(this.context)\n  }\n\n  /**\n   * Clears context\n   */\n  clearContext() {\n    this.context.clear()\n    return this\n  }\n\n  /**\n   * Creates a child logger with inherited context\n   */\n  child(context: Record<string, unknown>): Logger {\n    const child = new Logger({\n      level: this.level,\n      formatter: this.formatter,\n      transports: this.transports,\n      timestamps: this.timestamps,\n      sourceLocation: this.sourceLocation,\n    })\n\n    // Inherit context\n    for (const [key, value] of this.context) {\n      child.setContext(key, value)\n    }\n\n    // Add child context\n    for (const [key, value] of Object.entries(context)) {\n      child.setContext(key, value)\n    }\n\n    return child\n  }\n\n  /**\n   * Gets source location from stack trace\n   */\n  private getSourceLocation(): { file: string; line: number } {\n    const stack = new Error().stack || ''\n    const lines = stack.split('\\n')\n\n    // Skip error message and this method\n    for (let i = 2; i < lines.length; i++) {\n      const line = lines[i]\n      if (line.includes('Logger.') || line.includes('logger.')) {\n        continue\n      }\n\n      const match = line.match(/at\\s+(?:.*?\\s+)?\\(?([^:\\)]+):(\\d+)/)\n      if (match) {\n        return {\n          file: match[1],\n          line: parseInt(match[2]),\n        }\n      }\n    }\n\n    return { file: 'unknown', line: 0 }\n  }\n}\n\n/**\n * Default log formatter with colors (for terminal)\n */\nconst defaultFormatter: LogFormatter = (entry: LogEntry) => {\n  const levelName = LogLevel[entry.level]\n  const timestamp = entry.timestamp.toISOString()\n\n  let output = `[${timestamp}] [${levelName}] ${entry.message}`\n\n  if (entry.context && Object.keys(entry.context).length > 0) {\n    output += ` ${JSON.stringify(entry.context)}`\n  }\n\n  if (entry.error) {\n    const errorStr =\n      entry.error instanceof Error\n        ? `${entry.error.name}: ${entry.error.message}`\n        : String(entry.error)\n    output += ` Error: ${errorStr}`\n  }\n\n  return output\n}\n\n/**\n * Console transport for logging to stdout/stderr\n */\nexport const consoleTransport: LogTransport = {\n  log(entry: LogEntry) {\n    const formatted = defaultFormatter(entry)\n\n    if (entry.level >= LogLevel.ERROR) {\n      console.error(formatted)\n    } else if (entry.level === LogLevel.WARN) {\n      console.warn(formatted)\n    } else {\n      console.log(formatted)\n    }\n  },\n}\n\n/**\n * Creates a new logger instance\n *\n * @param config Logger configuration\n * @returns Configured logger\n *\n * @example\n * ```ts\n * const logger = createLogger({\n *   level: LogLevel.DEBUG,\n *   timestamps: true\n * })\n * ```\n */\nexport function createLogger(config?: LoggerConfig): Logger {\n  return new Logger(config)\n}\n\n/**\n * Global default logger instance\n */\nlet globalLogger: Logger | null = null\n\n/**\n * Gets or creates global logger\n *\n * @param config Configuration for initial creation\n * @returns Global logger instance\n */\nexport function getGlobalLogger(config?: LoggerConfig): Logger {\n  if (!globalLogger) {\n    globalLogger = createLogger(config)\n  }\n  return globalLogger\n}\n\n/**\n * Resets global logger (for testing)\n */\nexport function resetGlobalLogger() {\n  globalLogger = null\n}\n\n/**\n * Memory transport for testing and analysis\n */\nexport class MemoryTransport implements LogTransport {\n  private entries: LogEntry[] = []\n\n  log(entry: LogEntry) {\n    this.entries.push(entry)\n  }\n\n  /** Gets all logged entries */\n  getEntries(): LogEntry[] {\n    return [...this.entries]\n  }\n\n  /** Gets entries by level */\n  getByLevel(level: LogLevel): LogEntry[] {\n    return this.entries.filter((e) => e.level === level)\n  }\n\n  /** Clears all entries */\n  clear() {\n    this.entries = []\n  }\n\n  /** Gets count of entries */\n  size(): number {\n    return this.entries.length\n  }\n}\n"],"mappings":"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","names":["LogLevel"]}

package/packages/logger/react/README.md

@@ -1 +1 @@
-# ✦ @geenius-tools/logger-react\n\n> React hooks for @geenius-tools/logger\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-tools/logger-react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-tools/logger-react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/tools-logger-react\n\n> React hooks for @geenius/tools-logger\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/tools-logger-react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/tools-logger-react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/logger/solidjs/README.md

@@ -1 +1 @@
-# ✦ @geenius-tools/logger-solidjs\n\n> SolidJS primitives for @geenius-tools/logger\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-tools/logger-solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-tools/logger-solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/tools-logger-solidjs\n\n> SolidJS primitives for @geenius/tools-logger\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/tools-logger-solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/tools-logger-solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/perf/dist/index.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @geenius/tools-perf — Performance monitoring
+ *
+ * Provides utilities for measuring and tracking performance metrics.
+ * Supports timing, memory profiling, and metric collection.
+ */
+/**
+ * Performance metric entry
+ */
+interface PerfMetric {
+    /** Metric name */
+    name: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** When metric was recorded */
+    timestamp: Date;
+    /** Metric tags */
+    tags?: Record<string, string>;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Performance monitor callback
+ */
+type PerfCallback = (metric: PerfMetric) => void | Promise<void>;
+/**
+ * Simple timer for measuring duration
+ *
+ * @example
+ * ```ts
+ * const timer = new Timer()
+ * // ... do work ...
+ * console.log(timer.elapsed()) // duration in ms
+ * ```
+ */
+declare class Timer {
+    private startTime;
+    constructor();
+    /**
+     * Gets elapsed time in milliseconds
+     */
+    elapsed(): number;
+    /**
+     * Resets timer
+     */
+    reset(): void;
+    /**
+     * Gets current time in milliseconds
+     */
+    private now;
+}
+/**
+ * Performance tracker for named metrics
+ *
+ * @example
+ * ```ts
+ * const perf = new PerfTracker()
+ * perf.mark('fetch-start')
+ * // ... fetch data ...
+ * perf.measure('api-call', 'fetch-start')
+ * ```
+ */
+declare class PerfTracker {
+    private marks;
+    private metrics;
+    private callbacks;
+    /**
+     * Records a performance mark at current time
+     */
+    mark(name: string, tags?: Record<string, string>): void;
+    /**
+     * Measures duration from mark to now
+     */
+    measure(name: string, startMark: string, endMark?: string, metadata?: Record<string, unknown>): number;
+    /**
+     * Times a function execution
+     *
+     * @example
+     * ```ts
+     * const duration = await perf.time('fetch', async () => {
+     *   return fetch('/api/data')
+     * })
+     * ```
+     */
+    time<T>(name: string, fn: () => T | Promise<T>, metadata?: Record<string, unknown>): Promise<{
+        duration: number;
+        result: T;
+    }>;
+    /**
+     * Times a sync function execution
+     */
+    timeSync<T>(name: string, fn: () => T, metadata?: Record<string, unknown>): {
+        duration: number;
+        result: T;
+    };
+    /**
+     * Registers callback for metric events
+     */
+    on(callback: PerfCallback): () => void;
+    /**
+     * Emits metric to registered callbacks
+     */
+    private emit;
+    /**
+     * Gets all recorded metrics
+     */
+    getMetrics(): PerfMetric[];
+    /**
+     * Gets metrics by name
+     */
+    getByName(name: string): PerfMetric[];
+    /**
+     * Gets average duration for named metric
+     */
+    getAverage(name: string): number;
+    /**
+     * Clears all metrics
+     */
+    clear(): void;
+    /**
+     * Gets current time in ms
+     */
+    private now;
+}
+/**
+ * Creates a performance tracker instance
+ *
+ * @example
+ * ```ts
+ * const perf = createPerfTracker()
+ * await perf.time('api-call', () => fetch('/api/data'))
+ * ```
+ */
+declare function createPerfTracker(): PerfTracker;
+/**
+ * Measures memory usage (Node.js only)
+ *
+ * @returns Memory usage in bytes
+ */
+declare function getMemoryUsage(): {
+    heapUsed: number;
+    heapTotal: number;
+    external: number;
+};
+/**
+ * Decorator for automatic function timing
+ *
+ * @example
+ * ```ts
+ * class DataService {
+ *   @Timed()
+ *   async fetchData() {
+ *     return fetch('/api/data')
+ *   }
+ * }
+ * ```
+ */
+declare function Timed(name?: string): MethodDecorator;
+/**
+ * Debounce function with performance tracking
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, wait: number, name?: string): T;
+/**
+ * Throttle function with performance tracking
+ */
+declare function throttle<T extends (...args: any[]) => any>(fn: T, wait: number, name?: string): T;
+
+export { type PerfCallback, type PerfMetric, PerfTracker, Timed, Timer, createPerfTracker, debounce, getMemoryUsage, throttle };

package/packages/perf/dist/index.js

@@ -0,0 +1,265 @@
+// src/index.ts
+var Timer = class {
+  startTime;
+  constructor() {
+    this.startTime = this.now();
+  }
+  /**
+   * Gets elapsed time in milliseconds
+   */
+  elapsed() {
+    return this.now() - this.startTime;
+  }
+  /**
+   * Resets timer
+   */
+  reset() {
+    this.startTime = this.now();
+  }
+  /**
+   * Gets current time in milliseconds
+   */
+  now() {
+    if (typeof performance !== "undefined" && performance.now) {
+      return performance.now();
+    }
+    return Date.now();
+  }
+};
+var PerfTracker = class {
+  marks = /* @__PURE__ */ new Map();
+  metrics = [];
+  callbacks = [];
+  /**
+   * Records a performance mark at current time
+   */
+  mark(name, tags) {
+    const now = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+    this.marks.set(name, now);
+  }
+  /**
+   * Measures duration from mark to now
+   */
+  measure(name, startMark, endMark, metadata) {
+    const startTime = this.marks.get(startMark);
+    if (startTime === void 0) {
+      console.warn(`Mark "${startMark}" not found`);
+      return 0;
+    }
+    let endTime;
+    if (endMark) {
+      endTime = this.marks.get(endMark) ?? this.now();
+    } else {
+      endTime = this.now();
+    }
+    const duration = endTime - startTime;
+    const metric = {
+      name,
+      duration,
+      timestamp: /* @__PURE__ */ new Date(),
+      metadata
+    };
+    this.metrics.push(metric);
+    this.emit(metric);
+    return duration;
+  }
+  /**
+   * Times a function execution
+   *
+   * @example
+   * ```ts
+   * const duration = await perf.time('fetch', async () => {
+   *   return fetch('/api/data')
+   * })
+   * ```
+   */
+  async time(name, fn, metadata) {
+    const timer = new Timer();
+    try {
+      const result = await Promise.resolve(fn());
+      const duration = timer.elapsed();
+      const metric = {
+        name,
+        duration,
+        timestamp: /* @__PURE__ */ new Date(),
+        metadata
+      };
+      this.metrics.push(metric);
+      this.emit(metric);
+      return { duration, result };
+    } catch (error) {
+      const duration = timer.elapsed();
+      const metric = {
+        name,
+        duration,
+        timestamp: /* @__PURE__ */ new Date(),
+        metadata: {
+          ...metadata,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      };
+      this.metrics.push(metric);
+      this.emit(metric);
+      throw error;
+    }
+  }
+  /**
+   * Times a sync function execution
+   */
+  timeSync(name, fn, metadata) {
+    const timer = new Timer();
+    try {
+      const result = fn();
+      const duration = timer.elapsed();
+      const metric = {
+        name,
+        duration,
+        timestamp: /* @__PURE__ */ new Date(),
+        metadata
+      };
+      this.metrics.push(metric);
+      this.emit(metric);
+      return { duration, result };
+    } catch (error) {
+      const duration = timer.elapsed();
+      const metric = {
+        name,
+        duration,
+        timestamp: /* @__PURE__ */ new Date(),
+        metadata: {
+          ...metadata,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      };
+      this.metrics.push(metric);
+      this.emit(metric);
+      throw error;
+    }
+  }
+  /**
+   * Registers callback for metric events
+   */
+  on(callback) {
+    this.callbacks.push(callback);
+    return () => {
+      this.callbacks = this.callbacks.filter((cb) => cb !== callback);
+    };
+  }
+  /**
+   * Emits metric to registered callbacks
+   */
+  emit(metric) {
+    for (const callback of this.callbacks) {
+      try {
+        void callback(metric);
+      } catch {
+      }
+    }
+  }
+  /**
+   * Gets all recorded metrics
+   */
+  getMetrics() {
+    return [...this.metrics];
+  }
+  /**
+   * Gets metrics by name
+   */
+  getByName(name) {
+    return this.metrics.filter((m) => m.name === name);
+  }
+  /**
+   * Gets average duration for named metric
+   */
+  getAverage(name) {
+    const metrics = this.getByName(name);
+    if (metrics.length === 0) return 0;
+    const total = metrics.reduce((sum, m) => sum + m.duration, 0);
+    return total / metrics.length;
+  }
+  /**
+   * Clears all metrics
+   */
+  clear() {
+    this.marks.clear();
+    this.metrics = [];
+  }
+  /**
+   * Gets current time in ms
+   */
+  now() {
+    if (typeof performance !== "undefined" && performance.now) {
+      return performance.now();
+    }
+    return Date.now();
+  }
+};
+function createPerfTracker() {
+  return new PerfTracker();
+}
+function getMemoryUsage() {
+  if (typeof process !== "undefined" && process.memoryUsage) {
+    const usage = process.memoryUsage();
+    return {
+      heapUsed: usage.heapUsed,
+      heapTotal: usage.heapTotal,
+      external: usage.external
+    };
+  }
+  return {
+    heapUsed: 0,
+    heapTotal: 0,
+    external: 0
+  };
+}
+function Timed(name) {
+  return function(target, prop, descriptor) {
+    if (!descriptor || typeof descriptor.value !== "function") {
+      return descriptor;
+    }
+    const originalFn = descriptor.value;
+    const metricName = name ?? String(prop);
+    const tracker = createPerfTracker();
+    descriptor.value = async function(...args) {
+      const { duration, result } = await tracker.time(
+        metricName,
+        () => originalFn.apply(this, args)
+      );
+      return result;
+    };
+    return descriptor;
+  };
+}
+function debounce(fn, wait, name) {
+  let timeout = null;
+  const tracker = createPerfTracker();
+  return ((...args) => {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+    timeout = setTimeout(() => {
+      void tracker.timeSync(name ?? fn.name, () => fn(...args));
+    }, wait);
+  });
+}
+function throttle(fn, wait, name) {
+  let last = 0;
+  const tracker = createPerfTracker();
+  return ((...args) => {
+    const now = Date.now();
+    if (now - last >= wait) {
+      last = now;
+      void tracker.timeSync(name ?? fn.name, () => fn(...args));
+    }
+  });
+}
+export {
+  PerfTracker,
+  Timed,
+  Timer,
+  createPerfTracker,
+  debounce,
+  getMemoryUsage,
+  throttle
+};
+//# sourceMappingURL=index.js.map