@soamee/perf-monitor 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Soamee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/browser/correlation.d.ts

@@ -0,0 +1,4 @@
+export declare function generateCorrelationId(prefix?: string): string;
+export declare function isValidCorrelationId(id: string): boolean;
+export declare function getOrCreateCorrelationId(incoming?: string): string;
+//# sourceMappingURL=correlation.d.ts.map

package/dist/browser/correlation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../../src/browser/correlation.ts"],"names":[],"mappings":"AAIA,wBAAgB,qBAAqB,CAAC,MAAM,SAAQ,GAAG,MAAM,CAK5D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKlE"}

package/dist/browser/correlation.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCorrelationId = generateCorrelationId;
+exports.isValidCorrelationId = isValidCorrelationId;
+exports.getOrCreateCorrelationId = getOrCreateCorrelationId;
+const CORRELATION_ID_RE = /^[A-Za-z0-9._:-]{8,128}$/;
+let counter = 0;
+function generateCorrelationId(prefix = 'web') {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).slice(2, 8);
+    const seq = (counter++).toString(36);
+    return `${prefix}-${timestamp}-${random}-${seq}`;
+}
+function isValidCorrelationId(id) {
+    return CORRELATION_ID_RE.test(id);
+}
+function getOrCreateCorrelationId(incoming) {
+    if (incoming && isValidCorrelationId(incoming)) {
+        return incoming;
+    }
+    return generateCorrelationId();
+}
+//# sourceMappingURL=correlation.js.map

package/dist/browser/correlation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.js","sourceRoot":"","sources":["../../src/browser/correlation.ts"],"names":[],"mappings":";;AAIA,sDAKC;AAED,oDAEC;AAED,4DAKC;AApBD,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAErD,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,SAAgB,qBAAqB,CAAC,MAAM,GAAG,KAAK;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrC,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;AACnD,CAAC;AAED,SAAgB,oBAAoB,CAAC,EAAU;IAC7C,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,wBAAwB,CAAC,QAAiB;IACxD,IAAI,QAAQ,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,qBAAqB,EAAE,CAAC;AACjC,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,3 @@
+export { PerfClient } from './perf-client';
+export { generateCorrelationId, isValidCorrelationId, getOrCreateCorrelationId } from './correlation';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrCreateCorrelationId = exports.isValidCorrelationId = exports.generateCorrelationId = exports.PerfClient = void 0;
+var perf_client_1 = require("./perf-client");
+Object.defineProperty(exports, "PerfClient", { enumerable: true, get: function () { return perf_client_1.PerfClient; } });
+var correlation_1 = require("./correlation");
+Object.defineProperty(exports, "generateCorrelationId", { enumerable: true, get: function () { return correlation_1.generateCorrelationId; } });
+Object.defineProperty(exports, "isValidCorrelationId", { enumerable: true, get: function () { return correlation_1.isValidCorrelationId; } });
+Object.defineProperty(exports, "getOrCreateCorrelationId", { enumerable: true, get: function () { return correlation_1.getOrCreateCorrelationId; } });
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,6CAAsG;AAA7F,oHAAA,qBAAqB,OAAA;AAAE,mHAAA,oBAAoB,OAAA;AAAE,uHAAA,wBAAwB,OAAA"}

package/dist/browser/perf-client.d.ts

@@ -0,0 +1,38 @@
+import type { ClientRecorder, ClientRecorderConfig, ClientMetrics } from '../core/interfaces/client-recorder';
+export declare class PerfClient implements ClientRecorder {
+    private static instance;
+    private config;
+    private apiCalls;
+    private webVitals;
+    private observers;
+    private originalFetch?;
+    private destroyed;
+    private constructor();
+    static getInstance(): PerfClient;
+    /**
+     * Initialize the performance client. Call once at app startup.
+     *
+     * @example
+     * ```typescript
+     * import { PerfClient } from '@soamee/perf-monitor/browser';
+     *
+     * PerfClient.init({
+     *   apiOrigin: process.env.NEXT_PUBLIC_API_URL,
+     *   injectCorrelationIds: true,
+     *   collectWebVitals: true,
+     *   onReport: (metrics) => navigator.sendBeacon('/api/perf', JSON.stringify(metrics)),
+     * });
+     * ```
+     */
+    static init(config: ClientRecorderConfig): PerfClient;
+    init(config: ClientRecorderConfig): void;
+    private initInstance;
+    destroy(): void;
+    injectCorrelationId(request: Request): Request;
+    collectMetrics(): ClientMetrics;
+    private interceptFetch;
+    private observeWebVitals;
+    private safeObserve;
+    private parseServerTiming;
+}
+//# sourceMappingURL=perf-client.d.ts.map

package/dist/browser/perf-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-client.d.ts","sourceRoot":"","sources":["../../src/browser/perf-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,aAAa,EAEd,MAAM,oCAAoC,CAAC;AAW5C,qBAAa,UAAW,YAAW,cAAc;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAElD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,UAAU;IAOhC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,UAAU;IAMrD,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAIxC,OAAO,CAAC,YAAY;IAapB,OAAO,IAAI,IAAI;IAqBf,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAO9C,cAAc,IAAI,aAAa;IAS/B,OAAO,CAAC,cAAc;IAmDtB,OAAO,CAAC,gBAAgB;IAiExB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,iBAAiB;CAmB1B"}

package/dist/browser/perf-client.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerfClient = void 0;
+const correlation_1 = require("./correlation");
+class PerfClient {
+    static instance = null;
+    config = {};
+    apiCalls = [];
+    webVitals = { cls: 0 };
+    observers = [];
+    originalFetch;
+    destroyed = false;
+    constructor() { }
+    static getInstance() {
+        if (!PerfClient.instance) {
+            PerfClient.instance = new PerfClient();
+        }
+        return PerfClient.instance;
+    }
+    /**
+     * Initialize the performance client. Call once at app startup.
+     *
+     * @example
+     * ```typescript
+     * import { PerfClient } from '@soamee/perf-monitor/browser';
+     *
+     * PerfClient.init({
+     *   apiOrigin: process.env.NEXT_PUBLIC_API_URL,
+     *   injectCorrelationIds: true,
+     *   collectWebVitals: true,
+     *   onReport: (metrics) => navigator.sendBeacon('/api/perf', JSON.stringify(metrics)),
+     * });
+     * ```
+     */
+    static init(config) {
+        const instance = PerfClient.getInstance();
+        instance.initInstance(config);
+        return instance;
+    }
+    init(config) {
+        this.initInstance(config);
+    }
+    initInstance(config) {
+        this.config = config;
+        this.destroyed = false;
+        if (config.injectCorrelationIds) {
+            this.interceptFetch();
+        }
+        if (config.collectWebVitals) {
+            this.observeWebVitals();
+        }
+    }
+    destroy() {
+        this.destroyed = true;
+        // Restore original fetch
+        if (this.originalFetch && typeof window !== 'undefined') {
+            window.fetch = this.originalFetch;
+            this.originalFetch = undefined;
+        }
+        // Disconnect observers
+        for (const observer of this.observers) {
+            observer.disconnect();
+        }
+        this.observers = [];
+        this.apiCalls = [];
+        this.webVitals = { cls: 0 };
+        PerfClient.instance = null;
+    }
+    injectCorrelationId(request) {
+        const correlationId = (0, correlation_1.generateCorrelationId)();
+        const headers = new Headers(request.headers);
+        headers.set('X-Correlation-Id', correlationId);
+        return new Request(request, { headers });
+    }
+    collectMetrics() {
+        return {
+            url: typeof window !== 'undefined' ? window.location.href : '',
+            timestamp: Date.now(),
+            webVitals: { ...this.webVitals },
+            apiCalls: [...this.apiCalls],
+        };
+    }
+    interceptFetch() {
+        if (typeof window === 'undefined' || typeof fetch === 'undefined')
+            return;
+        this.originalFetch = window.fetch;
+        const self = this;
+        const apiOrigin = this.config.apiOrigin || '';
+        window.fetch = async function perfMonitorFetch(input, init) {
+            const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+            // Only intercept API calls
+            if (apiOrigin && !url.startsWith(apiOrigin)) {
+                return self.originalFetch.call(window, input, init);
+            }
+            const correlationId = (0, correlation_1.generateCorrelationId)();
+            const headers = new Headers(init?.headers);
+            headers.set('X-Correlation-Id', correlationId);
+            const start = performance.now();
+            const response = await self.originalFetch.call(window, input, { ...init, headers });
+            const durationMs = performance.now() - start;
+            if (!self.destroyed) {
+                const serverTimingHeader = response.headers.get('Server-Timing') || '';
+                const serverTiming = self.parseServerTiming(serverTimingHeader);
+                const metric = {
+                    method: init?.method || 'GET',
+                    url: url.replace(apiOrigin, ''),
+                    status: response.status,
+                    durationMs: Math.round(durationMs),
+                    correlationId,
+                    serverTiming,
+                };
+                self.apiCalls.push(metric);
+                // Keep bounded
+                if (self.apiCalls.length > 1000) {
+                    self.apiCalls = self.apiCalls.slice(-500);
+                }
+            }
+            return response;
+        };
+    }
+    observeWebVitals() {
+        if (typeof window === 'undefined' || typeof PerformanceObserver === 'undefined')
+            return;
+        // LCP
+        this.safeObserve('largest-contentful-paint', (entries) => {
+            const last = entries[entries.length - 1];
+            if (last)
+                this.webVitals.lcp = last.startTime;
+        });
+        // CLS
+        this.safeObserve('layout-shift', (entries) => {
+            for (const entry of entries) {
+                if (!entry.hadRecentInput) {
+                    this.webVitals.cls += entry.value;
+                }
+            }
+        });
+        // FID (first-input)
+        this.safeObserve('first-input', (entries) => {
+            const first = entries[0];
+            if (first) {
+                this.webVitals.fid = first.processingStart - first.startTime;
+            }
+        });
+        // INP (event with interactionId)
+        let maxInp = 0;
+        this.safeObserve('event', (entries) => {
+            for (const entry of entries) {
+                if (entry.interactionId) {
+                    const duration = entry.duration;
+                    if (duration > maxInp) {
+                        maxInp = duration;
+                        this.webVitals.inp = duration;
+                    }
+                }
+            }
+        }, { durationThreshold: 40 });
+        // TTFB
+        if (typeof performance !== 'undefined' && performance.getEntriesByType) {
+            const nav = performance.getEntriesByType('navigation')[0];
+            if (nav) {
+                this.webVitals.ttfb = nav.responseStart - nav.requestStart;
+            }
+        }
+        // Report on page unload
+        if (typeof window !== 'undefined') {
+            const reportOnUnload = () => {
+                if (this.config.onReport && !this.destroyed) {
+                    const metrics = this.collectMetrics();
+                    this.config.onReport(metrics);
+                }
+            };
+            window.addEventListener('visibilitychange', () => {
+                if (document.visibilityState === 'hidden') {
+                    reportOnUnload();
+                }
+            });
+        }
+    }
+    safeObserve(type, callback, options) {
+        try {
+            const observer = new PerformanceObserver((list) => {
+                callback(list.getEntries());
+            });
+            observer.observe({ type, buffered: true, ...options });
+            this.observers.push(observer);
+        }
+        catch {
+            // Observer type not supported — skip silently
+        }
+    }
+    parseServerTiming(header) {
+        if (!header)
+            return undefined;
+        const result = {};
+        for (const part of header.split(',')) {
+            const trimmed = part.trim();
+            const durMatch = trimmed.match(/(\w+);dur=([\d.]+)/);
+            if (durMatch) {
+                const [, name, dur] = durMatch;
+                if (name === 'app')
+                    result.appMs = parseFloat(dur);
+                if (name === 'db')
+                    result.dbMs = parseFloat(dur);
+            }
+            const descMatch = trimmed.match(/desc="(\d+) queries"/);
+            if (descMatch) {
+                result.queryCount = parseInt(descMatch[1], 10);
+            }
+        }
+        return Object.keys(result).length > 0 ? result : undefined;
+    }
+}
+exports.PerfClient = PerfClient;
+//# sourceMappingURL=perf-client.js.map

package/dist/browser/perf-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-client.js","sourceRoot":"","sources":["../../src/browser/perf-client.ts"],"names":[],"mappings":";;;AAMA,+CAAsD;AAUtD,MAAa,UAAU;IACb,MAAM,CAAC,QAAQ,GAAsB,IAAI,CAAC;IAE1C,MAAM,GAAyB,EAAE,CAAC;IAClC,QAAQ,GAAoB,EAAE,CAAC;IAC/B,SAAS,GAAmB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACvC,SAAS,GAA0B,EAAE,CAAC;IACtC,aAAa,CAAgB;IAC7B,SAAS,GAAG,KAAK,CAAC;IAE1B,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzB,UAAU,CAAC,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;QACzC,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAI,CAAC,MAA4B;QACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAC1C,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,MAA4B;QAC/B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAEO,YAAY,CAAC,MAA4B;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;YAChC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;QAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,yBAAyB;QACzB,IAAI,IAAI,CAAC,aAAa,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACvD,MAAc,CAAC,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC;YAC3C,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,uBAAuB;QACvB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QAEpB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QAE5B,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,mBAAmB,CAAC,OAAgB;QAClC,MAAM,aAAa,GAAG,IAAA,mCAAqB,GAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;QAC/C,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,cAAc;QACZ,OAAO;YACL,GAAG,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YAC9D,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE;YAChC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;SAC7B,CAAC;IACJ,CAAC;IAEO,cAAc;QACpB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,KAAK,KAAK,WAAW;YAAE,OAAO;QAE1E,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QAE7C,MAAc,CAAC,KAAK,GAAG,KAAK,UAAU,gBAAgB,CACrD,KAAwB,EACxB,IAAkB;YAElB,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;YAEpG,2BAA2B;YAC3B,IAAI,SAAS,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC,aAAc,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACvD,CAAC;YAED,MAAM,aAAa,GAAG,IAAA,mCAAqB,GAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;YAE/C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAc,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACrF,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAE7C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;gBACvE,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;gBAEhE,MAAM,MAAM,GAAkB;oBAC5B,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;oBAC7B,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;oBAClC,aAAa;oBACb,YAAY;iBACb,CAAC;gBAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAE3B,eAAe;gBACf,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;oBAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC;IAEO,gBAAgB;QACtB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,mBAAmB,KAAK,WAAW;YAAE,OAAO;QAExF,MAAM;QACN,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,CAAC,OAAO,EAAE,EAAE;YACvD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzC,IAAI,IAAI;gBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,MAAM;QACN,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;YAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAE,KAAa,CAAC,cAAc,EAAE,CAAC;oBACnC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAK,KAAa,CAAC,KAAK,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,SAAS,CAAC,GAAG,GAAI,KAAa,CAAC,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC;YACxE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iCAAiC;QACjC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAK,KAAa,CAAC,aAAa,EAAE,CAAC;oBACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;oBAChC,IAAI,QAAQ,GAAG,MAAM,EAAE,CAAC;wBACtB,MAAM,GAAG,QAAQ,CAAC;wBAClB,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,QAAQ,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;QAE9B,OAAO;QACP,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;YACvE,MAAM,GAAG,GAAG,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,CAA4C,CAAC;YACrG,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,YAAY,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,cAAc,GAAG,GAAG,EAAE;gBAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;gBAC/C,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;oBAC1C,cAAc,EAAE,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,WAAW,CACjB,IAAY,EACZ,QAAiD,EACjD,OAAiC;QAEjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE,EAAE;gBAChD,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,EAAS,CAAC,CAAC;YAC9D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,MAAc;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAE9B,MAAM,MAAM,GAA+C,EAAE,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACrD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC;gBAC/B,IAAI,IAAI,KAAK,KAAK;oBAAE,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;gBACnD,IAAI,IAAI,KAAK,IAAI;oBAAE,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACxD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;;AApPH,gCAqPC"}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { MetricsRegistry, metricsRegistry } from './metrics-registry';
+export type { RequestSample, RouteStats, QueryShapeStats, OperationStats, MetricsSnapshot } from './metrics-registry';
+export { createRequestContext, resolveCorrelationId, runWithRequestContext, getRequestContext, requestContextProvider, } from './request-context';
+export type { RequestContext, RequestContextProvider } from './request-context';
+export * from './interfaces';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEtH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestContextProvider = exports.getRequestContext = exports.runWithRequestContext = exports.resolveCorrelationId = exports.createRequestContext = exports.metricsRegistry = exports.MetricsRegistry = void 0;
+var metrics_registry_1 = require("./metrics-registry");
+Object.defineProperty(exports, "MetricsRegistry", { enumerable: true, get: function () { return metrics_registry_1.MetricsRegistry; } });
+Object.defineProperty(exports, "metricsRegistry", { enumerable: true, get: function () { return metrics_registry_1.metricsRegistry; } });
+var request_context_1 = require("./request-context");
+Object.defineProperty(exports, "createRequestContext", { enumerable: true, get: function () { return request_context_1.createRequestContext; } });
+Object.defineProperty(exports, "resolveCorrelationId", { enumerable: true, get: function () { return request_context_1.resolveCorrelationId; } });
+Object.defineProperty(exports, "runWithRequestContext", { enumerable: true, get: function () { return request_context_1.runWithRequestContext; } });
+Object.defineProperty(exports, "getRequestContext", { enumerable: true, get: function () { return request_context_1.getRequestContext; } });
+Object.defineProperty(exports, "requestContextProvider", { enumerable: true, get: function () { return request_context_1.requestContextProvider; } });
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAsE;AAA7D,mHAAA,eAAe,OAAA;AAAE,mHAAA,eAAe,OAAA;AAGzC,qDAM2B;AALzB,uHAAA,oBAAoB,OAAA;AACpB,uHAAA,oBAAoB,OAAA;AACpB,wHAAA,qBAAqB,OAAA;AACrB,oHAAA,iBAAiB,OAAA;AACjB,yHAAA,sBAAsB,OAAA;AAIxB,+CAA6B;AAC7B,0CAAwB"}

package/dist/core/interfaces/client-recorder.d.ts

@@ -0,0 +1,38 @@
+export interface ClientRecorderConfig {
+    apiOrigin?: string;
+    injectCorrelationIds?: boolean;
+    collectWebVitals?: boolean;
+    onReport?: (metrics: ClientMetrics) => void | Promise<void>;
+}
+export interface ClientMetrics {
+    url: string;
+    timestamp: number;
+    correlationId?: string;
+    webVitals?: {
+        lcp?: number;
+        fid?: number;
+        cls?: number;
+        inp?: number;
+        ttfb?: number;
+    };
+    apiCalls?: ApiCallMetric[];
+}
+export interface ApiCallMetric {
+    method: string;
+    url: string;
+    status: number;
+    durationMs: number;
+    correlationId: string;
+    serverTiming?: {
+        appMs?: number;
+        dbMs?: number;
+        queryCount?: number;
+    };
+}
+export interface ClientRecorder {
+    init(config: ClientRecorderConfig): void;
+    destroy(): void;
+    injectCorrelationId(request: Request): Request;
+    collectMetrics(): ClientMetrics;
+}
+//# sourceMappingURL=client-recorder.d.ts.map

package/dist/core/interfaces/client-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-recorder.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/client-recorder.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE;QACV,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;IAChB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/C,cAAc,IAAI,aAAa,CAAC;CACjC"}

package/dist/core/interfaces/client-recorder.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=client-recorder.js.map

package/dist/core/interfaces/client-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-recorder.js","sourceRoot":"","sources":["../../../src/core/interfaces/client-recorder.ts"],"names":[],"mappings":""}

package/dist/core/interfaces/database-adapter.d.ts

@@ -0,0 +1,7 @@
+import type { MetricsRegistry } from '../metrics-registry';
+import type { RequestContextProvider } from '../request-context';
+export interface DatabaseAdapter {
+    init(registry: MetricsRegistry, contextProvider: RequestContextProvider): void;
+    destroy(): void;
+}
+//# sourceMappingURL=database-adapter.d.ts.map

package/dist/core/interfaces/database-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/database-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC/E,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/core/interfaces/database-adapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=database-adapter.js.map

package/dist/core/interfaces/database-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-adapter.js","sourceRoot":"","sources":["../../../src/core/interfaces/database-adapter.ts"],"names":[],"mappings":""}

package/dist/core/interfaces/http-adapter.d.ts

@@ -0,0 +1,15 @@
+import type { RequestContext } from '../request-context';
+export interface IncomingRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+}
+export interface OutgoingResponse {
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+}
+export interface HttpAdapter {
+    onRequest(req: IncomingRequest): RequestContext;
+    onResponse(req: IncomingRequest, res: OutgoingResponse, context: RequestContext, durationMs: number): void;
+}
+//# sourceMappingURL=http-adapter.d.ts.map

package/dist/core/interfaces/http-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/http-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,cAAc,CAAC;IAChD,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5G"}

package/dist/core/interfaces/http-adapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=http-adapter.js.map

package/dist/core/interfaces/http-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.js","sourceRoot":"","sources":["../../../src/core/interfaces/http-adapter.ts"],"names":[],"mappings":""}

package/dist/core/interfaces/index.d.ts

@@ -0,0 +1,6 @@
+export * from './database-adapter';
+export * from './http-adapter';
+export * from './metrics-exporter';
+export * from './client-recorder';
+export * from './test-recorder';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/core/interfaces/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./database-adapter"), exports);
+__exportStar(require("./http-adapter"), exports);
+__exportStar(require("./metrics-exporter"), exports);
+__exportStar(require("./client-recorder"), exports);
+__exportStar(require("./test-recorder"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,iDAA+B;AAC/B,qDAAmC;AACnC,oDAAkC;AAClC,kDAAgC"}

package/dist/core/interfaces/metrics-exporter.d.ts

@@ -0,0 +1,6 @@
+import type { MetricsRegistry } from '../metrics-registry';
+export interface MetricsExporter {
+    readonly contentType: string;
+    export(registry: MetricsRegistry): string | Record<string, unknown>;
+}
+//# sourceMappingURL=metrics-exporter.d.ts.map

package/dist/core/interfaces/metrics-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-exporter.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/metrics-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrE"}

package/dist/core/interfaces/metrics-exporter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=metrics-exporter.js.map

package/dist/core/interfaces/metrics-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-exporter.js","sourceRoot":"","sources":["../../../src/core/interfaces/metrics-exporter.ts"],"names":[],"mappings":""}

package/dist/core/interfaces/test-recorder.d.ts

@@ -0,0 +1,64 @@
+export interface StepBudget {
+    maxMs?: number;
+    maxApiCalls?: number;
+    maxDuplicateCalls?: number;
+    maxLongTaskMs?: number;
+    maxTransferKb?: number;
+}
+export interface ApiTrace {
+    method: string;
+    url: string;
+    status: number;
+    durationMs: number;
+    correlationId: string;
+    serverTiming?: {
+        appMs?: number;
+        dbMs?: number;
+        queryCount?: number;
+    };
+}
+export interface LongTask {
+    duration: number;
+    scripts?: Array<{
+        sourceURL: string;
+        invoker: string;
+        duration: number;
+    }>;
+}
+export interface CdpMetrics {
+    jsHeapUsedMb: number;
+    jsHeapTotalMb: number;
+    domNodes: number;
+    eventListeners: number;
+    scriptDurationMs: number;
+    layoutDurationMs: number;
+}
+export interface StepResult {
+    name: string;
+    durationMs: number;
+    apiCalls: ApiTrace[];
+    duplicateCalls: Array<{
+        key: string;
+        count: number;
+    }>;
+    longTasks: LongTask[];
+    totalLongTaskMs: number;
+    transferKb: number;
+    cdpMetrics?: CdpMetrics;
+    webVitals?: {
+        lcp?: number;
+        cls?: number;
+    };
+}
+export interface TestResult {
+    testName: string;
+    steps: StepResult[];
+    totalDurationMs: number;
+    peakHeapMb?: number;
+}
+export interface TestRecorder {
+    start(page: unknown): Promise<void>;
+    step(name: string, action: () => Promise<void>): Promise<StepResult>;
+    finish(): Promise<TestResult>;
+}
+//# sourceMappingURL=test-recorder.d.ts.map

package/dist/core/interfaces/test-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-recorder.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/test-recorder.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,cAAc,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE;QACV,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/B"}