@scpxl/nodejs-framework 1.0.13

package/dist/performance/performance-monitor.js

@@ -0,0 +1,270 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { PerformanceObserver, performance } from "perf_hooks";
+import { Logger } from "../logger/index.js";
+class PerformanceMonitor {
+  static {
+    __name(this, "PerformanceMonitor");
+  }
+  static instance;
+  observer;
+  metrics = [];
+  thresholds = {
+    http: 1e3,
+    // 1 second
+    database: 500,
+    // 500ms
+    cache: 100,
+    // 100ms
+    queue: 2e3,
+    // 2 seconds
+    websocket: 200,
+    // 200ms
+    custom: 1e3
+    // 1 second
+  };
+  maxMetricsHistory = 1e4;
+  isEnabled = true;
+  logSlowOperations = true;
+  logAllOperations = false;
+  constructor(options = {}) {
+    this.isEnabled = options.enabled ?? true;
+    this.maxMetricsHistory = options.maxMetricsHistory ?? 1e4;
+    this.logSlowOperations = options.logSlowOperations ?? true;
+    this.logAllOperations = options.logAllOperations ?? false;
+    if (options.thresholds) {
+      this.thresholds = { ...this.thresholds, ...options.thresholds };
+    }
+    if (this.isEnabled) {
+      this.initializeObserver();
+    }
+  }
+  static getInstance(options) {
+    if (!PerformanceMonitor.instance) {
+      PerformanceMonitor.instance = new PerformanceMonitor(options);
+    }
+    return PerformanceMonitor.instance;
+  }
+  static initialize(options = {}) {
+    PerformanceMonitor.instance = new PerformanceMonitor(options);
+    return PerformanceMonitor.instance;
+  }
+  initializeObserver() {
+    this.observer = new PerformanceObserver((items) => {
+      items.getEntries().forEach((entry) => {
+        if (entry.name.startsWith("pxl-performance:")) {
+          this.handlePerformanceEntry(entry);
+        }
+      });
+    });
+    this.observer.observe({ entryTypes: ["measure"] });
+  }
+  handlePerformanceEntry(entry) {
+    if (!this.isEnabled) return;
+    const [, type, name] = entry.name.split(":");
+    const metricType = type;
+    const metric = {
+      name,
+      duration: entry.duration,
+      timestamp: Date.now(),
+      type: metricType,
+      metadata: entry.detail
+    };
+    this.metrics.push(metric);
+    if (this.metrics.length > this.maxMetricsHistory) {
+      this.metrics = this.metrics.slice(-this.maxMetricsHistory);
+    }
+    const threshold = this.thresholds[metricType];
+    if (this.logSlowOperations && entry.duration > threshold) {
+      Logger.warn({
+        message: `Performance threshold exceeded`,
+        meta: {
+          operation: entry.name,
+          duration: `${entry.duration.toFixed(2)}ms`,
+          threshold: `${threshold}ms`,
+          type: metricType
+        }
+      });
+    }
+    if (this.logAllOperations) {
+      Logger.debug({
+        message: `Performance metric`,
+        meta: {
+          operation: entry.name,
+          duration: `${entry.duration.toFixed(2)}ms`,
+          type: metricType
+        }
+      });
+    }
+  }
+  startMeasure(name, type = "custom") {
+    if (!this.isEnabled) return "";
+    const measureName = `pxl-performance:${type}:${name}`;
+    const startMark = `${measureName}-start`;
+    performance.mark(startMark);
+    return startMark;
+  }
+  endMeasure(startMark, _metadata) {
+    if (!this.isEnabled || !startMark) return;
+    const endMark = `${startMark.replace("-start", "")}-end`;
+    const measureName = startMark.replace("-start", "");
+    performance.mark(endMark);
+    try {
+      performance.measure(measureName, startMark, endMark);
+      performance.clearMarks(startMark);
+      performance.clearMarks(endMark);
+    } catch (error) {
+      Logger.error({
+        error: error instanceof Error ? error : new Error(String(error)),
+        message: "Error measuring performance"
+      });
+    }
+  }
+  async measureAsync({
+    name,
+    type,
+    fn,
+    metadata
+  }) {
+    if (!this.isEnabled) {
+      return fn();
+    }
+    const startMark = this.startMeasure(name, type);
+    try {
+      const result = await fn();
+      this.endMeasure(startMark, metadata);
+      return result;
+    } catch (error) {
+      this.endMeasure(startMark, { ...metadata, error: error instanceof Error ? error.message : String(error) });
+      throw error;
+    }
+  }
+  measureSync(name, type, fn, metadata) {
+    if (!this.isEnabled) {
+      return fn();
+    }
+    const startMark = this.startMeasure(name, type);
+    try {
+      const result = fn();
+      this.endMeasure(startMark, metadata);
+      return result;
+    } catch (error) {
+      this.endMeasure(startMark, { ...metadata, error: error instanceof Error ? error.message : String(error) });
+      throw error;
+    }
+  }
+  getMetrics(type, limit) {
+    let filteredMetrics = this.metrics;
+    if (type) {
+      filteredMetrics = filteredMetrics.filter((m) => m.type === type);
+    }
+    if (limit) {
+      filteredMetrics = filteredMetrics.slice(-limit);
+    }
+    return filteredMetrics;
+  }
+  getAverageMetrics(type) {
+    const metrics = this.getMetrics(type);
+    const groups = metrics.reduce(
+      (acc, metric) => {
+        if (!acc[metric.name]) {
+          acc[metric.name] = [];
+        }
+        acc[metric.name].push(metric.duration);
+        return acc;
+      },
+      {}
+    );
+    return Object.entries(groups).reduce(
+      (acc, [name, durations]) => {
+        acc[name] = durations.reduce((sum, duration) => sum + duration, 0) / durations.length;
+        return acc;
+      },
+      {}
+    );
+  }
+  getMemoryUsage() {
+    return process.memoryUsage();
+  }
+  getDetailedMemoryUsage() {
+    const usage = process.memoryUsage();
+    return {
+      rss: Math.round(usage.rss / 1024 / 1024),
+      // MB
+      heapTotal: Math.round(usage.heapTotal / 1024 / 1024),
+      // MB
+      heapUsed: Math.round(usage.heapUsed / 1024 / 1024),
+      // MB
+      external: Math.round(usage.external / 1024 / 1024),
+      // MB
+      arrayBuffers: Math.round(usage.arrayBuffers / 1024 / 1024)
+      // MB
+    };
+  }
+  getCpuUsage() {
+    return process.cpuUsage();
+  }
+  setThresholds(thresholds) {
+    this.thresholds = { ...this.thresholds, ...thresholds };
+  }
+  setEnabled(enabled) {
+    this.isEnabled = enabled;
+    if (enabled && !this.observer) {
+      this.initializeObserver();
+    } else if (!enabled && this.observer) {
+      this.observer.disconnect();
+      this.observer = void 0;
+    }
+  }
+  clearMetrics() {
+    this.metrics = [];
+  }
+  generateReport() {
+    return {
+      summary: {
+        totalMetrics: this.metrics.length,
+        averages: this.getAverageMetrics(),
+        thresholds: this.thresholds,
+        enabled: this.isEnabled
+      },
+      metrics: this.getMetrics(void 0, 100),
+      // Last 100 metrics
+      memory: this.getDetailedMemoryUsage(),
+      cpu: this.getCpuUsage()
+    };
+  }
+  generateFormattedReport(format = "detailed") {
+    const report = this.generateReport();
+    if (format === "simple") {
+      const memoryUsed = report.memory.heapUsed;
+      const cpuPercent = Math.round((report.cpu.user + report.cpu.system) / 1e6);
+      const avgDurations = Object.values(report.summary.averages);
+      const avgMetric = avgDurations.length > 0 ? Math.round(avgDurations.reduce((sum, val) => sum + val, 0) / avgDurations.length) : 0;
+      return `Performance Report (summary: ${report.summary.totalMetrics} ops, avg: ${avgMetric}ms | metrics: ${report.metrics.length} | memory: ${memoryUsed}mb | cpu: ${cpuPercent}%)`;
+    }
+    const lines = [
+      "Performance Report:",
+      `Summary: ${report.summary.totalMetrics} operations tracked, enabled: ${report.summary.enabled}`,
+      `Metrics: ${report.metrics.length} recent operations recorded`,
+      `Memory: RSS: ${report.memory.rss}mb, Heap: ${report.memory.heapUsed}/${report.memory.heapTotal}mb`,
+      `CPU: User: ${Math.round(report.cpu.user / 1e3)}ms, System: ${Math.round(report.cpu.system / 1e3)}ms`
+    ];
+    if (Object.keys(report.summary.averages).length > 0) {
+      lines.push(
+        `Averages: ${Object.entries(report.summary.averages).map(([name, avg]) => `${name}: ${Math.round(avg)}ms`).join(", ")}`
+      );
+    }
+    return lines.join("\n");
+  }
+  destroy() {
+    if (this.observer) {
+      this.observer.disconnect();
+      this.observer = void 0;
+    }
+    this.metrics = [];
+  }
+}
+export {
+  PerformanceMonitor
+};
+//# sourceMappingURL=performance-monitor.js.map

package/dist/performance/performance-monitor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/performance/performance-monitor.ts"],
+  "sourcesContent": ["import { PerformanceObserver, performance } from 'perf_hooks';\nimport { Logger } from '../logger/index.js';\n\nexport interface PerformanceMetrics {\n  name: string;\n  duration: number;\n  timestamp: number;\n  type: 'http' | 'database' | 'cache' | 'queue' | 'websocket' | 'custom';\n  metadata?: Record<string, any>;\n}\n\nexport interface PerformanceThresholds {\n  http: number;\n  database: number;\n  cache: number;\n  queue: number;\n  websocket: number;\n  custom: number;\n}\n\nexport interface PerformanceMonitorOptions {\n  enabled?: boolean;\n  maxMetricsHistory?: number;\n  thresholds?: Partial<PerformanceThresholds>;\n  logSlowOperations?: boolean;\n  logAllOperations?: boolean;\n}\n\nexport class PerformanceMonitor {\n  private static instance: PerformanceMonitor;\n  private observer: PerformanceObserver | undefined;\n  private metrics: PerformanceMetrics[] = [];\n  private thresholds: PerformanceThresholds = {\n    http: 1000, // 1 second\n    database: 500, // 500ms\n    cache: 100, // 100ms\n    queue: 2000, // 2 seconds\n    websocket: 200, // 200ms\n    custom: 1000, // 1 second\n  };\n  private maxMetricsHistory = 10000;\n  private isEnabled = true;\n  private logSlowOperations = true;\n  private logAllOperations = false;\n\n  private constructor(options: PerformanceMonitorOptions = {}) {\n    this.isEnabled = options.enabled ?? true;\n    this.maxMetricsHistory = options.maxMetricsHistory ?? 10000;\n    this.logSlowOperations = options.logSlowOperations ?? true;\n    this.logAllOperations = options.logAllOperations ?? false;\n\n    if (options.thresholds) {\n      this.thresholds = { ...this.thresholds, ...options.thresholds };\n    }\n\n    if (this.isEnabled) {\n      this.initializeObserver();\n    }\n  }\n\n  public static getInstance(options?: PerformanceMonitorOptions): PerformanceMonitor {\n    if (!PerformanceMonitor.instance) {\n      PerformanceMonitor.instance = new PerformanceMonitor(options);\n    }\n    return PerformanceMonitor.instance;\n  }\n\n  public static initialize(options: PerformanceMonitorOptions = {}): PerformanceMonitor {\n    PerformanceMonitor.instance = new PerformanceMonitor(options);\n    return PerformanceMonitor.instance;\n  }\n\n  private initializeObserver(): void {\n    this.observer = new PerformanceObserver(items => {\n      items.getEntries().forEach(entry => {\n        if (entry.name.startsWith('pxl-performance:')) {\n          this.handlePerformanceEntry(entry);\n        }\n      });\n    });\n\n    this.observer.observe({ entryTypes: ['measure'] });\n  }\n\n  private handlePerformanceEntry(entry: any): void {\n    if (!this.isEnabled) return;\n\n    const [, type, name] = entry.name.split(':');\n    const metricType = type as PerformanceMetrics['type'];\n\n    const metric: PerformanceMetrics = {\n      name,\n      duration: entry.duration,\n      timestamp: Date.now(),\n      type: metricType,\n      metadata: entry.detail,\n    };\n\n    this.metrics.push(metric);\n\n    // Keep only the most recent metrics\n    if (this.metrics.length > this.maxMetricsHistory) {\n      this.metrics = this.metrics.slice(-this.maxMetricsHistory);\n    }\n\n    // Check thresholds and log warnings\n    const threshold = this.thresholds[metricType];\n    if (this.logSlowOperations && entry.duration > threshold) {\n      Logger.warn({\n        message: `Performance threshold exceeded`,\n        meta: {\n          operation: entry.name,\n          duration: `${entry.duration.toFixed(2)}ms`,\n          threshold: `${threshold}ms`,\n          type: metricType,\n        },\n      });\n    }\n\n    // Log all operations if enabled\n    if (this.logAllOperations) {\n      Logger.debug({\n        message: `Performance metric`,\n        meta: {\n          operation: entry.name,\n          duration: `${entry.duration.toFixed(2)}ms`,\n          type: metricType,\n        },\n      });\n    }\n  }\n\n  public startMeasure(name: string, type: PerformanceMetrics['type'] = 'custom'): string {\n    if (!this.isEnabled) return '';\n\n    const measureName = `pxl-performance:${type}:${name}`;\n    const startMark = `${measureName}-start`;\n\n    performance.mark(startMark);\n    return startMark;\n  }\n\n  public endMeasure(startMark: string, _metadata?: Record<string, any>): void {\n    if (!this.isEnabled || !startMark) return;\n\n    const endMark = `${startMark.replace('-start', '')}-end`;\n    const measureName = startMark.replace('-start', '');\n\n    performance.mark(endMark);\n\n    try {\n      performance.measure(measureName, startMark, endMark);\n\n      // Clean up marks\n      performance.clearMarks(startMark);\n      performance.clearMarks(endMark);\n    } catch (error) {\n      Logger.error({\n        error: error instanceof Error ? error : new Error(String(error)),\n        message: 'Error measuring performance',\n      });\n    }\n  }\n\n  public async measureAsync<T>({\n    name,\n    type,\n    fn,\n    metadata,\n  }: {\n    name: string;\n    type: PerformanceMetrics['type'];\n    fn: () => Promise<T>;\n    metadata?: Record<string, any>;\n  }): Promise<T> {\n    if (!this.isEnabled) {\n      return fn();\n    }\n\n    const startMark = this.startMeasure(name, type);\n\n    try {\n      const result = await fn();\n      this.endMeasure(startMark, metadata);\n      return result;\n    } catch (error) {\n      this.endMeasure(startMark, { ...metadata, error: error instanceof Error ? error.message : String(error) });\n      throw error;\n    }\n  }\n\n  public measureSync<T>(\n    name: string,\n    type: PerformanceMetrics['type'],\n    fn: () => T,\n    metadata?: Record<string, any>,\n  ): T {\n    if (!this.isEnabled) {\n      return fn();\n    }\n\n    const startMark = this.startMeasure(name, type);\n\n    try {\n      const result = fn();\n      this.endMeasure(startMark, metadata);\n      return result;\n    } catch (error) {\n      this.endMeasure(startMark, { ...metadata, error: error instanceof Error ? error.message : String(error) });\n      throw error;\n    }\n  }\n\n  public getMetrics(type?: PerformanceMetrics['type'], limit?: number): PerformanceMetrics[] {\n    let filteredMetrics = this.metrics;\n\n    if (type) {\n      filteredMetrics = filteredMetrics.filter(m => m.type === type);\n    }\n\n    if (limit) {\n      filteredMetrics = filteredMetrics.slice(-limit);\n    }\n\n    return filteredMetrics;\n  }\n\n  public getAverageMetrics(type?: PerformanceMetrics['type']): Record<string, number> {\n    const metrics = this.getMetrics(type);\n    const groups = metrics.reduce(\n      (acc, metric) => {\n        if (!acc[metric.name]) {\n          acc[metric.name] = [];\n        }\n        acc[metric.name].push(metric.duration);\n        return acc;\n      },\n      {} as Record<string, number[]>,\n    );\n\n    return Object.entries(groups).reduce(\n      (acc, [name, durations]) => {\n        acc[name] = durations.reduce((sum, duration) => sum + duration, 0) / durations.length;\n        return acc;\n      },\n      {} as Record<string, number>,\n    );\n  }\n\n  public getMemoryUsage(): NodeJS.MemoryUsage {\n    return process.memoryUsage();\n  }\n\n  public getDetailedMemoryUsage(): Record<string, number> {\n    const usage = process.memoryUsage();\n    return {\n      rss: Math.round(usage.rss / 1024 / 1024), // MB\n      heapTotal: Math.round(usage.heapTotal / 1024 / 1024), // MB\n      heapUsed: Math.round(usage.heapUsed / 1024 / 1024), // MB\n      external: Math.round(usage.external / 1024 / 1024), // MB\n      arrayBuffers: Math.round(usage.arrayBuffers / 1024 / 1024), // MB\n    };\n  }\n\n  public getCpuUsage(): NodeJS.CpuUsage {\n    return process.cpuUsage();\n  }\n\n  public setThresholds(thresholds: Partial<PerformanceThresholds>): void {\n    this.thresholds = { ...this.thresholds, ...thresholds };\n  }\n\n  public setEnabled(enabled: boolean): void {\n    this.isEnabled = enabled;\n\n    if (enabled && !this.observer) {\n      this.initializeObserver();\n    } else if (!enabled && this.observer) {\n      this.observer.disconnect();\n      this.observer = undefined;\n    }\n  }\n\n  public clearMetrics(): void {\n    this.metrics = [];\n  }\n\n  public generateReport(): {\n    summary: {\n      totalMetrics: number;\n      averages: Record<string, number>;\n      thresholds: PerformanceThresholds;\n      enabled: boolean;\n    };\n    metrics: PerformanceMetrics[];\n    memory: Record<string, number>;\n    cpu: NodeJS.CpuUsage;\n  } {\n    return {\n      summary: {\n        totalMetrics: this.metrics.length,\n        averages: this.getAverageMetrics(),\n        thresholds: this.thresholds,\n        enabled: this.isEnabled,\n      },\n      metrics: this.getMetrics(undefined, 100), // Last 100 metrics\n      memory: this.getDetailedMemoryUsage(),\n      cpu: this.getCpuUsage(),\n    };\n  }\n\n  public generateFormattedReport(format: 'simple' | 'detailed' = 'detailed'): string {\n    const report = this.generateReport();\n\n    if (format === 'simple') {\n      const memoryUsed = report.memory.heapUsed;\n      const cpuPercent = Math.round((report.cpu.user + report.cpu.system) / 1000000); // Convert microseconds to rough percentage\n      const avgDurations = Object.values(report.summary.averages);\n      const avgMetric =\n        avgDurations.length > 0 ? Math.round(avgDurations.reduce((sum, val) => sum + val, 0) / avgDurations.length) : 0;\n\n      return `Performance Report (summary: ${report.summary.totalMetrics} ops, avg: ${avgMetric}ms | metrics: ${report.metrics.length} | memory: ${memoryUsed}mb | cpu: ${cpuPercent}%)`;\n    }\n    const lines = [\n      'Performance Report:',\n      `Summary: ${report.summary.totalMetrics} operations tracked, enabled: ${report.summary.enabled}`,\n      `Metrics: ${report.metrics.length} recent operations recorded`,\n      `Memory: RSS: ${report.memory.rss}mb, Heap: ${report.memory.heapUsed}/${report.memory.heapTotal}mb`,\n      `CPU: User: ${Math.round(report.cpu.user / 1000)}ms, System: ${Math.round(report.cpu.system / 1000)}ms`,\n    ];\n\n    if (Object.keys(report.summary.averages).length > 0) {\n      lines.push(\n        `Averages: ${Object.entries(report.summary.averages)\n          .map(([name, avg]) => `${name}: ${Math.round(avg)}ms`)\n          .join(', ')}`,\n      );\n    }\n\n    return lines.join('\\n');\n  }\n\n  public destroy(): void {\n    if (this.observer) {\n      this.observer.disconnect();\n      this.observer = undefined;\n    }\n    this.metrics = [];\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/performance/queue-performance.d.ts

@@ -0,0 +1,46 @@
+import { PerformanceMonitor } from './performance-monitor.js';
+export interface QueueOperationMetadata {
+    operation: string;
+    queueName?: string;
+    jobName?: string;
+    jobId?: string;
+    priority?: number;
+    delay?: number;
+    attempts?: number;
+    error?: string;
+    argumentCount?: number;
+}
+export declare class QueuePerformanceWrapper {
+    private static performanceMonitor;
+    static setPerformanceMonitor(monitor: PerformanceMonitor): void;
+    private static getPerformanceMonitor;
+    /**
+     * Monitor job processing
+     */
+    static monitorJobProcessing<T>(queueName: string, jobName: string, operation: () => Promise<T>, metadata?: Partial<QueueOperationMetadata>): Promise<T>;
+    /**
+     * Monitor job addition to queue
+     */
+    static monitorJobAddition<T>(queueName: string, jobName: string, operation: () => Promise<T>, metadata?: Partial<QueueOperationMetadata>): Promise<T>;
+    /**
+     * Monitor queue operations
+     */
+    static monitorQueueOperation<T>(queueName: string, operationName: string, operation: () => Promise<T>, metadata?: Partial<QueueOperationMetadata>): Promise<T>;
+    /**
+     * Monitor processor execution
+     */
+    static monitorProcessor<T>(processorName: string, operation: () => Promise<T>, metadata?: Partial<QueueOperationMetadata>): Promise<T>;
+    /**
+     * Monitor queue worker operations
+     */
+    static monitorWorker<T>(workerName: string, operation: () => Promise<T>, metadata?: Partial<QueueOperationMetadata>): Promise<T>;
+    /**
+     * Monitor job retry operations
+     */
+    static monitorJobRetry<T>(queueName: string, jobName: string, attempt: number, operation: () => Promise<T>, metadata?: Partial<QueueOperationMetadata>): Promise<T>;
+}
+/**
+ * Decorator for monitoring queue processor methods
+ */
+export declare function MonitorQueueProcessor(processorName?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=queue-performance.d.ts.map

package/dist/performance/queue-performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-performance.d.ts","sourceRoot":"","sources":["../../src/performance/queue-performance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAqB;WAExC,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAItE,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAOpC;;OAEG;WACiB,oBAAoB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;WACiB,kBAAkB,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;WACiB,qBAAqB,CAAC,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC;IAiBb;;OAEG;WACiB,gBAAgB,CAAC,CAAC,EACpC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC;IAiBb;;OAEG;WACiB,aAAa,CAAC,CAAC,EACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC;IAgBb;;OAEG;WACiB,eAAe,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC,OAAO,CAAC,CAAC,CAAC;CAkBd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,CAAC,EAAE,MAAM,IACzC,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAelF"}

package/dist/performance/queue-performance.js

@@ -0,0 +1,144 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { PerformanceMonitor } from "./performance-monitor.js";
+class QueuePerformanceWrapper {
+  static {
+    __name(this, "QueuePerformanceWrapper");
+  }
+  static performanceMonitor;
+  static setPerformanceMonitor(monitor) {
+    QueuePerformanceWrapper.performanceMonitor = monitor;
+  }
+  static getPerformanceMonitor() {
+    if (!QueuePerformanceWrapper.performanceMonitor) {
+      QueuePerformanceWrapper.performanceMonitor = PerformanceMonitor.getInstance();
+    }
+    return QueuePerformanceWrapper.performanceMonitor;
+  }
+  /**
+   * Monitor job processing
+   */
+  static async monitorJobProcessing(queueName, jobName, operation, metadata) {
+    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();
+    const operationMetadata = {
+      operation: "job_processing",
+      queueName,
+      jobName,
+      ...metadata
+    };
+    return monitor.measureAsync({
+      name: `${queueName}.${jobName}`,
+      type: "queue",
+      fn: operation,
+      metadata: operationMetadata
+    });
+  }
+  /**
+   * Monitor job addition to queue
+   */
+  static async monitorJobAddition(queueName, jobName, operation, metadata) {
+    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();
+    const operationMetadata = {
+      operation: "job_addition",
+      queueName,
+      jobName,
+      ...metadata
+    };
+    return monitor.measureAsync({
+      name: `add.${queueName}.${jobName}`,
+      type: "queue",
+      fn: operation,
+      metadata: operationMetadata
+    });
+  }
+  /**
+   * Monitor queue operations
+   */
+  static async monitorQueueOperation(queueName, operationName, operation, metadata) {
+    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();
+    const operationMetadata = {
+      operation: operationName,
+      queueName,
+      ...metadata
+    };
+    return monitor.measureAsync({
+      name: `queue.${queueName}.${operationName}`,
+      type: "queue",
+      fn: operation,
+      metadata: operationMetadata
+    });
+  }
+  /**
+   * Monitor processor execution
+   */
+  static async monitorProcessor(processorName, operation, metadata) {
+    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();
+    const operationMetadata = {
+      operation: "processor_execution",
+      jobName: processorName,
+      ...metadata
+    };
+    return monitor.measureAsync({
+      name: `processor.${processorName}`,
+      type: "queue",
+      fn: operation,
+      metadata: operationMetadata
+    });
+  }
+  /**
+   * Monitor queue worker operations
+   */
+  static async monitorWorker(workerName, operation, metadata) {
+    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();
+    const operationMetadata = {
+      operation: "worker_execution",
+      ...metadata
+    };
+    return monitor.measureAsync({
+      name: `worker.${workerName}`,
+      type: "queue",
+      fn: operation,
+      metadata: operationMetadata
+    });
+  }
+  /**
+   * Monitor job retry operations
+   */
+  static async monitorJobRetry(queueName, jobName, attempt, operation, metadata) {
+    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();
+    const operationMetadata = {
+      operation: "job_retry",
+      queueName,
+      jobName,
+      attempts: attempt,
+      ...metadata
+    };
+    return monitor.measureAsync({
+      name: `retry.${queueName}.${jobName}`,
+      type: "queue",
+      fn: operation,
+      metadata: operationMetadata
+    });
+  }
+}
+function MonitorQueueProcessor(processorName) {
+  return function(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    const className = target.constructor.name;
+    const operation = processorName ?? propertyKey;
+    descriptor.value = async function(...args) {
+      return QueuePerformanceWrapper.monitorProcessor(
+        `${className}.${operation}`,
+        () => originalMethod.apply(this, args),
+        { argumentCount: args.length }
+      );
+    };
+    return descriptor;
+  };
+}
+__name(MonitorQueueProcessor, "MonitorQueueProcessor");
+export {
+  MonitorQueueProcessor,
+  QueuePerformanceWrapper
+};
+//# sourceMappingURL=queue-performance.js.map

package/dist/performance/queue-performance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/performance/queue-performance.ts"],
+  "sourcesContent": ["import { PerformanceMonitor } from './performance-monitor.js';\n\nexport interface QueueOperationMetadata {\n  operation: string;\n  queueName?: string;\n  jobName?: string;\n  jobId?: string;\n  priority?: number;\n  delay?: number;\n  attempts?: number;\n  error?: string;\n  argumentCount?: number;\n}\n\nexport class QueuePerformanceWrapper {\n  private static performanceMonitor: PerformanceMonitor;\n\n  public static setPerformanceMonitor(monitor: PerformanceMonitor): void {\n    QueuePerformanceWrapper.performanceMonitor = monitor;\n  }\n\n  private static getPerformanceMonitor(): PerformanceMonitor {\n    if (!QueuePerformanceWrapper.performanceMonitor) {\n      QueuePerformanceWrapper.performanceMonitor = PerformanceMonitor.getInstance();\n    }\n    return QueuePerformanceWrapper.performanceMonitor;\n  }\n\n  /**\n   * Monitor job processing\n   */\n  public static async monitorJobProcessing<T>(\n    queueName: string,\n    jobName: string,\n    operation: () => Promise<T>,\n    metadata?: Partial<QueueOperationMetadata>,\n  ): Promise<T> {\n    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();\n\n    const operationMetadata: QueueOperationMetadata = {\n      operation: 'job_processing',\n      queueName,\n      jobName,\n      ...metadata,\n    };\n\n    return monitor.measureAsync({\n      name: `${queueName}.${jobName}`,\n      type: 'queue',\n      fn: operation,\n      metadata: operationMetadata,\n    });\n  }\n\n  /**\n   * Monitor job addition to queue\n   */\n  public static async monitorJobAddition<T>(\n    queueName: string,\n    jobName: string,\n    operation: () => Promise<T>,\n    metadata?: Partial<QueueOperationMetadata>,\n  ): Promise<T> {\n    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();\n\n    const operationMetadata: QueueOperationMetadata = {\n      operation: 'job_addition',\n      queueName,\n      jobName,\n      ...metadata,\n    };\n\n    return monitor.measureAsync({\n      name: `add.${queueName}.${jobName}`,\n      type: 'queue',\n      fn: operation,\n      metadata: operationMetadata,\n    });\n  }\n\n  /**\n   * Monitor queue operations\n   */\n  public static async monitorQueueOperation<T>(\n    queueName: string,\n    operationName: string,\n    operation: () => Promise<T>,\n    metadata?: Partial<QueueOperationMetadata>,\n  ): Promise<T> {\n    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();\n\n    const operationMetadata: QueueOperationMetadata = {\n      operation: operationName,\n      queueName,\n      ...metadata,\n    };\n\n    return monitor.measureAsync({\n      name: `queue.${queueName}.${operationName}`,\n      type: 'queue',\n      fn: operation,\n      metadata: operationMetadata,\n    });\n  }\n\n  /**\n   * Monitor processor execution\n   */\n  public static async monitorProcessor<T>(\n    processorName: string,\n    operation: () => Promise<T>,\n    metadata?: Partial<QueueOperationMetadata>,\n  ): Promise<T> {\n    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();\n\n    const operationMetadata: QueueOperationMetadata = {\n      operation: 'processor_execution',\n      jobName: processorName,\n      ...metadata,\n    };\n\n    return monitor.measureAsync({\n      name: `processor.${processorName}`,\n      type: 'queue',\n      fn: operation,\n      metadata: operationMetadata,\n    });\n  }\n\n  /**\n   * Monitor queue worker operations\n   */\n  public static async monitorWorker<T>(\n    workerName: string,\n    operation: () => Promise<T>,\n    metadata?: Partial<QueueOperationMetadata>,\n  ): Promise<T> {\n    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();\n\n    const operationMetadata: QueueOperationMetadata = {\n      operation: 'worker_execution',\n      ...metadata,\n    };\n\n    return monitor.measureAsync({\n      name: `worker.${workerName}`,\n      type: 'queue',\n      fn: operation,\n      metadata: operationMetadata,\n    });\n  }\n\n  /**\n   * Monitor job retry operations\n   */\n  public static async monitorJobRetry<T>(\n    queueName: string,\n    jobName: string,\n    attempt: number,\n    operation: () => Promise<T>,\n    metadata?: Partial<QueueOperationMetadata>,\n  ): Promise<T> {\n    const monitor = QueuePerformanceWrapper.getPerformanceMonitor();\n\n    const operationMetadata: QueueOperationMetadata = {\n      operation: 'job_retry',\n      queueName,\n      jobName,\n      attempts: attempt,\n      ...metadata,\n    };\n\n    return monitor.measureAsync({\n      name: `retry.${queueName}.${jobName}`,\n      type: 'queue',\n      fn: operation,\n      metadata: operationMetadata,\n    });\n  }\n}\n\n/**\n * Decorator for monitoring queue processor methods\n */\nexport function MonitorQueueProcessor(processorName?: string) {\n  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {\n    const originalMethod = descriptor.value;\n    const className = target.constructor.name;\n    const operation = processorName ?? propertyKey;\n\n    descriptor.value = async function (...args: any[]) {\n      return QueuePerformanceWrapper.monitorProcessor(\n        `${className}.${operation}`,\n        () => originalMethod.apply(this, args),\n        { argumentCount: args.length },\n      );\n    };\n\n    return descriptor;\n  };\n}\n"],
+  "mappings": ";;AAAA,SAAS,0BAA0B;AAc5B,MAAM,wBAAwB;AAAA,EAdrC,OAcqC;AAAA;AAAA;AAAA,EACnC,OAAe;AAAA,EAEf,OAAc,sBAAsB,SAAmC;AACrE,4BAAwB,qBAAqB;AAAA,EAC/C;AAAA,EAEA,OAAe,wBAA4C;AACzD,QAAI,CAAC,wBAAwB,oBAAoB;AAC/C,8BAAwB,qBAAqB,mBAAmB,YAAY;AAAA,IAC9E;AACA,WAAO,wBAAwB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,aAAoB,qBAClB,WACA,SACA,WACA,UACY;AACZ,UAAM,UAAU,wBAAwB,sBAAsB;AAE9D,UAAM,oBAA4C;AAAA,MAChD,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA,GAAG;AAAA,IACL;AAEA,WAAO,QAAQ,aAAa;AAAA,MAC1B,MAAM,GAAG,SAAS,IAAI,OAAO;AAAA,MAC7B,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAoB,mBAClB,WACA,SACA,WACA,UACY;AACZ,UAAM,UAAU,wBAAwB,sBAAsB;AAE9D,UAAM,oBAA4C;AAAA,MAChD,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA,GAAG;AAAA,IACL;AAEA,WAAO,QAAQ,aAAa;AAAA,MAC1B,MAAM,OAAO,SAAS,IAAI,OAAO;AAAA,MACjC,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAoB,sBAClB,WACA,eACA,WACA,UACY;AACZ,UAAM,UAAU,wBAAwB,sBAAsB;AAE9D,UAAM,oBAA4C;AAAA,MAChD,WAAW;AAAA,MACX;AAAA,MACA,GAAG;AAAA,IACL;AAEA,WAAO,QAAQ,aAAa;AAAA,MAC1B,MAAM,SAAS,SAAS,IAAI,aAAa;AAAA,MACzC,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAoB,iBAClB,eACA,WACA,UACY;AACZ,UAAM,UAAU,wBAAwB,sBAAsB;AAE9D,UAAM,oBAA4C;AAAA,MAChD,WAAW;AAAA,MACX,SAAS;AAAA,MACT,GAAG;AAAA,IACL;AAEA,WAAO,QAAQ,aAAa;AAAA,MAC1B,MAAM,aAAa,aAAa;AAAA,MAChC,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAoB,cAClB,YACA,WACA,UACY;AACZ,UAAM,UAAU,wBAAwB,sBAAsB;AAE9D,UAAM,oBAA4C;AAAA,MAChD,WAAW;AAAA,MACX,GAAG;AAAA,IACL;AAEA,WAAO,QAAQ,aAAa;AAAA,MAC1B,MAAM,UAAU,UAAU;AAAA,MAC1B,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAoB,gBAClB,WACA,SACA,SACA,WACA,UACY;AACZ,UAAM,UAAU,wBAAwB,sBAAsB;AAE9D,UAAM,oBAA4C;AAAA,MAChD,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA,UAAU;AAAA,MACV,GAAG;AAAA,IACL;AAEA,WAAO,QAAQ,aAAa;AAAA,MAC1B,MAAM,SAAS,SAAS,IAAI,OAAO;AAAA,MACnC,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AACF;AAKO,SAAS,sBAAsB,eAAwB;AAC5D,SAAO,SAAU,QAAa,aAAqB,YAAgC;AACjF,UAAM,iBAAiB,WAAW;AAClC,UAAM,YAAY,OAAO,YAAY;AACrC,UAAM,YAAY,iBAAiB;AAEnC,eAAW,QAAQ,kBAAmB,MAAa;AACjD,aAAO,wBAAwB;AAAA,QAC7B,GAAG,SAAS,IAAI,SAAS;AAAA,QACzB,MAAM,eAAe,MAAM,MAAM,IAAI;AAAA,QACrC,EAAE,eAAe,KAAK,OAAO;AAAA,MAC/B;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;AAhBgB;",
+  "names": []
+}

package/dist/performance/webserver-performance.d.ts

@@ -0,0 +1,69 @@
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import { PerformanceMonitor } from './performance-monitor.js';
+export interface WebServerPerformanceOptions {
+    logSlowRequests?: boolean;
+    slowRequestThreshold?: number;
+    includeHeaders?: boolean;
+    includeUserAgent?: boolean;
+    skipRoutes?: string[];
+    skipMethods?: string[];
+}
+export interface HttpRequestMetadata {
+    method: string;
+    url: string;
+    ip?: string;
+    userAgent?: string;
+    headers?: Record<string, string | string[] | undefined>;
+    statusCode?: number;
+    contentLength?: number;
+    error?: string;
+    errorName?: string;
+    argumentCount?: number;
+}
+export declare class WebServerPerformanceWrapper {
+    private static performanceMonitor;
+    static setPerformanceMonitor(monitor: PerformanceMonitor): void;
+    private static getPerformanceMonitor;
+    /**
+     * Create performance middleware for Fastify
+     */
+    static createPerformanceMiddleware(options?: WebServerPerformanceOptions): (request: FastifyRequest, _reply: FastifyReply) => Promise<void>;
+    /**
+     * Create Fastify hooks for performance monitoring
+     */
+    static createPerformanceHooks(_options?: WebServerPerformanceOptions): {
+        onSend: (request: FastifyRequest, reply: FastifyReply, payload: any) => Promise<any>;
+        onError: (request: FastifyRequest, reply: FastifyReply, error: Error) => Promise<void>;
+    };
+    /**
+     * Monitor controller method execution
+     */
+    static monitorControllerMethod<T>({ controllerName, methodName, operation, metadata, }: {
+        controllerName: string;
+        methodName: string;
+        operation: () => Promise<T>;
+        metadata?: Record<string, any>;
+    }): Promise<T>;
+    /**
+     * Monitor route handler execution
+     */
+    static monitorRouteHandler<T>({ route, method, operation, metadata, }: {
+        route: string;
+        method: string;
+        operation: () => Promise<T>;
+        metadata?: Record<string, any>;
+    }): Promise<T>;
+    /**
+     * Monitor middleware execution
+     */
+    static monitorMiddleware<T>({ middlewareName, operation, metadata, }: {
+        middlewareName: string;
+        operation: () => Promise<T>;
+        metadata?: Record<string, any>;
+    }): Promise<T>;
+}
+/**
+ * Decorator for monitoring controller methods
+ */
+export declare function MonitorControllerMethod(methodName?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=webserver-performance.d.ts.map

package/dist/performance/webserver-performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webserver-performance.d.ts","sourceRoot":"","sources":["../../src/performance/webserver-performance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,2BAA2B;IACtC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAqB;WAExC,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAItE,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAOpC;;OAEG;WACW,2BAA2B,CAAC,OAAO,GAAE,2BAAgC,IAanE,SAAS,cAAc,EAAE,QAAQ,YAAY;IA0B7D;;OAEG;WACW,sBAAsB,CAAC,QAAQ,GAAE,2BAAgC;0BAInD,cAAc,SAAS,YAAY,WAAW,GAAG;2BAgBhD,cAAc,SAAS,YAAY,SAAS,KAAK;;IAkB9E;;OAEG;WACiB,uBAAuB,CAAC,CAAC,EAAE,EAC7C,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,GACT,EAAE;QACD,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,CAAC,CAAC;IAed;;OAEG;WACiB,mBAAmB,CAAC,CAAC,EAAE,EACzC,KAAK,EACL,MAAM,EACN,SAAS,EACT,QAAQ,GACT,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,CAAC,CAAC;IAWd;;OAEG;WACiB,iBAAiB,CAAC,CAAC,EAAE,EACvC,cAAc,EACd,SAAS,EACT,QAAQ,GACT,EAAE;QACD,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,CAAC,CAAC;CAaf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,MAAM,IACxC,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAgBlF"}