@amplitude/analytics-core 2.24.1 → 2.25.0

package/lib/esm/diagnostics/diagnostics-client.d.ts

@@ -0,0 +1,156 @@
+import { ILogger } from '../logger';
+import { IDiagnosticsStorage } from './diagnostics-storage';
+import { ServerZoneType } from '../types/server-zone';
+export declare const SAVE_INTERVAL_MS = 1000;
+export declare const FLUSH_INTERVAL_MS: number;
+export declare const DIAGNOSTICS_US_SERVER_URL = "https://diagnostics.prod.us-west-2.amplitude.com/v1/capture";
+export declare const DIAGNOSTICS_EU_SERVER_URL = "https://diagnostics.prod.eu-central-1.amplitude.com/v1/capture";
+export declare const MAX_MEMORY_STORAGE_COUNT = 10000;
+export declare const MAX_MEMORY_STORAGE_EVENTS_COUNT = 10;
+/**
+ * Key-value pairs for environment/context information
+ */
+type DiagnosticsTags = Record<string, string>;
+/**
+ * Numeric counters that can be incremented
+ */
+type DiagnosticsCounters = Record<string, number>;
+/**
+ * Properties for diagnostic events
+ */
+type EventProperties = Record<string, any>;
+/**
+ * Individual diagnostic event
+ */
+interface DiagnosticsEvent {
+    readonly event_name: string;
+    readonly time: number;
+    readonly event_properties: EventProperties;
+}
+/**
+ * Computed histogram statistics for final payload
+ */
+interface HistogramResult {
+    readonly count: number;
+    readonly min: number;
+    readonly max: number;
+    readonly avg: number;
+}
+/**
+ * Internal histogram statistics with sum for efficient incremental updates
+ */
+export interface HistogramStats {
+    count: number;
+    min: number;
+    max: number;
+    sum: number;
+}
+/**
+ * Collection of histogram results keyed by histogram name
+ */
+type DiagnosticsHistograms = Record<string, HistogramResult>;
+/**
+ * Collection of histogram stats keyed by histogram name (internal use for memory + persistence storage)
+ */
+type DiagnosticsHistogramStats = Record<string, HistogramStats>;
+/**
+ * Complete diagnostics payload sent to backend
+ */
+interface FlushPayload {
+    readonly tags: DiagnosticsTags;
+    readonly histogram: DiagnosticsHistograms;
+    readonly counters: DiagnosticsCounters;
+    readonly events: readonly DiagnosticsEvent[];
+}
+/**
+ * Amplitude Diagnostics Client
+ *
+ * A client for collecting and managing diagnostics data including tags, counters,
+ * histograms, and events. Data is stored persistently using IndexedDB to survive browser restarts and offline scenarios.
+ *
+ * Key Features:
+ * - IndexedDB storage
+ * - Time-based persistent storage flush interval (5 minutes since last flush)
+ * - 1 second time-based memory storage flush to persistent storage
+ * - Histogram statistics calculation (min, max, avg)
+ */
+export interface IDiagnosticsClient {
+    /**
+     * Set or update a tag
+     *
+     * @example
+     * ```typescript
+     * // Set environment tags
+     * diagnostics.setTag('library', 'amplitude-typescript/2.0.0');
+     * diagnostics.setTag('user_agent', navigator.userAgent);
+     * ```
+     */
+    setTag(name: string, value: string): void;
+    /**
+     * Increment a counter. If doesn't exist, create a counter and set value to 1
+     *
+     * @example
+     * ```typescript
+     * // Track counters
+     * diagnostics.increment('analytics.fileNotFound');
+     * diagnostics.increment('network.retry', 3);
+     * ```
+     */
+    increment(name: string, size?: number): void;
+    /**
+     * Record a histogram value
+     *
+     * @example
+     * ```typescript
+     * // Record performance metrics
+     * diagnostics.recordHistogram('sr.time', 5.2);
+     * diagnostics.recordHistogram('network.latency', 150);
+     * ```
+     */
+    recordHistogram(name: string, value: number): void;
+    /**
+     * Record an event
+     *
+     * @example
+     * ```typescript
+     * // Record diagnostic events
+     * diagnostics.recordEvent('error', {
+     *   stack_trace: '...',
+     * });
+     * ```
+     */
+    recordEvent(name: string, properties: EventProperties): void;
+    _flush(): void;
+}
+export declare class DiagnosticsClient implements IDiagnosticsClient {
+    storage?: IDiagnosticsStorage;
+    logger: ILogger;
+    serverUrl: string;
+    apiKey: string;
+    inMemoryTags: DiagnosticsTags;
+    inMemoryCounters: DiagnosticsCounters;
+    inMemoryHistograms: DiagnosticsHistogramStats;
+    inMemoryEvents: DiagnosticsEvent[];
+    saveTimer: ReturnType<typeof setTimeout> | null;
+    flushTimer: ReturnType<typeof setTimeout> | null;
+    constructor(apiKey: string, logger: ILogger, serverZone?: ServerZoneType);
+    setTag(name: string, value: string): void;
+    increment(name: string, size?: number): void;
+    recordHistogram(name: string, value: number): void;
+    recordEvent(name: string, properties: EventProperties): void;
+    startTimersIfNeeded(): void;
+    saveAllDataToStorage(): Promise<void>;
+    _flush(): Promise<void>;
+    /**
+     * Send diagnostics data to the server
+     */
+    fetch(payload: FlushPayload): Promise<void>;
+    /**
+     * Initialize flush interval logic.
+     * Check if 5 minutes has passed since last flush, if so flush immediately.
+     * Otherwise set a timer to flush when the interval is reached.
+     */
+    initializeFlushInterval(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=diagnostics-client.d.ts.map

package/lib/esm/diagnostics/diagnostics-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-client.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/diagnostics-client.ts"],"names":[],"mappings":"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"}

package/lib/esm/diagnostics/diagnostics-client.js

@@ -0,0 +1,302 @@
+import { __assign, __awaiter, __generator, __read, __spreadArray } from "tslib";
+import { DiagnosticsStorage } from './diagnostics-storage';
+import { getGlobalScope } from '../global-scope';
+export var SAVE_INTERVAL_MS = 1000; // 1 second
+export var FLUSH_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+export var DIAGNOSTICS_US_SERVER_URL = 'https://diagnostics.prod.us-west-2.amplitude.com/v1/capture';
+export var DIAGNOSTICS_EU_SERVER_URL = 'https://diagnostics.prod.eu-central-1.amplitude.com/v1/capture';
+// In-memory storage limits
+export var MAX_MEMORY_STORAGE_COUNT = 10000; // for tags, counters, histograms separately
+export var MAX_MEMORY_STORAGE_EVENTS_COUNT = 10;
+var DiagnosticsClient = /** @class */ (function () {
+    function DiagnosticsClient(apiKey, logger, serverZone) {
+        if (serverZone === void 0) { serverZone = 'US'; }
+        // In-memory storages
+        this.inMemoryTags = {};
+        this.inMemoryCounters = {};
+        this.inMemoryHistograms = {};
+        this.inMemoryEvents = [];
+        // Timer for 1-second persistence
+        this.saveTimer = null;
+        // Timer for flush interval
+        this.flushTimer = null;
+        this.apiKey = apiKey;
+        this.logger = logger;
+        this.serverUrl = serverZone === 'US' ? DIAGNOSTICS_US_SERVER_URL : DIAGNOSTICS_EU_SERVER_URL;
+        if (DiagnosticsStorage.isSupported()) {
+            this.storage = new DiagnosticsStorage(apiKey, logger);
+        }
+        else {
+            this.logger.debug('DiagnosticsClient: IndexedDB is not supported');
+        }
+        void this.initializeFlushInterval();
+    }
+    DiagnosticsClient.prototype.setTag = function (name, value) {
+        if (!this.storage) {
+            return;
+        }
+        if (Object.keys(this.inMemoryTags).length >= MAX_MEMORY_STORAGE_COUNT) {
+            this.logger.debug('DiagnosticsClient: Early return setTags as reaching memory limit');
+            return;
+        }
+        this.inMemoryTags[name] = value;
+        this.startTimersIfNeeded();
+    };
+    DiagnosticsClient.prototype.increment = function (name, size) {
+        if (size === void 0) { size = 1; }
+        if (!this.storage) {
+            return;
+        }
+        if (Object.keys(this.inMemoryCounters).length >= MAX_MEMORY_STORAGE_COUNT) {
+            this.logger.debug('DiagnosticsClient: Early return increment as reaching memory limit');
+            return;
+        }
+        this.inMemoryCounters[name] = (this.inMemoryCounters[name] || 0) + size;
+        this.startTimersIfNeeded();
+    };
+    DiagnosticsClient.prototype.recordHistogram = function (name, value) {
+        if (!this.storage) {
+            return;
+        }
+        if (Object.keys(this.inMemoryHistograms).length >= MAX_MEMORY_STORAGE_COUNT) {
+            this.logger.debug('DiagnosticsClient: Early return recordHistogram as reaching memory limit');
+            return;
+        }
+        var existing = this.inMemoryHistograms[name];
+        if (existing) {
+            // Update existing stats incrementally
+            existing.count += 1;
+            existing.min = Math.min(existing.min, value);
+            existing.max = Math.max(existing.max, value);
+            existing.sum += value;
+        }
+        else {
+            // Create new stats
+            this.inMemoryHistograms[name] = {
+                count: 1,
+                min: value,
+                max: value,
+                sum: value,
+            };
+        }
+        this.startTimersIfNeeded();
+    };
+    DiagnosticsClient.prototype.recordEvent = function (name, properties) {
+        if (!this.storage) {
+            return;
+        }
+        if (this.inMemoryEvents.length >= MAX_MEMORY_STORAGE_EVENTS_COUNT) {
+            this.logger.debug('DiagnosticsClient: Early return recordEvent as reaching memory limit');
+            return;
+        }
+        this.inMemoryEvents.push({
+            event_name: name,
+            time: Date.now(),
+            event_properties: properties,
+        });
+        this.startTimersIfNeeded();
+    };
+    DiagnosticsClient.prototype.startTimersIfNeeded = function () {
+        var _this = this;
+        if (!this.saveTimer) {
+            this.saveTimer = setTimeout(function () {
+                _this.saveAllDataToStorage()
+                    .catch(function (error) {
+                    _this.logger.debug('DiagnosticsClient: Failed to save all data to storage', error);
+                })
+                    .finally(function () {
+                    _this.saveTimer = null;
+                });
+            }, SAVE_INTERVAL_MS);
+        }
+        if (!this.flushTimer) {
+            this.flushTimer = setTimeout(function () {
+                _this._flush()
+                    .catch(function (error) {
+                    _this.logger.debug('DiagnosticsClient: Failed to flush', error);
+                })
+                    .finally(function () {
+                    _this.flushTimer = null;
+                });
+            }, FLUSH_INTERVAL_MS);
+        }
+    };
+    DiagnosticsClient.prototype.saveAllDataToStorage = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var tagsToSave, countersToSave, histogramsToSave, eventsToSave;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.storage) {
+                            return [2 /*return*/];
+                        }
+                        tagsToSave = __assign({}, this.inMemoryTags);
+                        countersToSave = __assign({}, this.inMemoryCounters);
+                        histogramsToSave = __assign({}, this.inMemoryHistograms);
+                        eventsToSave = __spreadArray([], __read(this.inMemoryEvents), false);
+                        this.inMemoryEvents = [];
+                        this.inMemoryTags = {};
+                        this.inMemoryCounters = {};
+                        this.inMemoryHistograms = {};
+                        return [4 /*yield*/, Promise.all([
+                                this.storage.setTags(tagsToSave),
+                                this.storage.incrementCounters(countersToSave),
+                                this.storage.setHistogramStats(histogramsToSave),
+                                this.storage.addEventRecords(eventsToSave),
+                            ])];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    DiagnosticsClient.prototype._flush = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, tagRecords, counterRecords, histogramStatsRecords, eventRecords, tags, counters, histogram, events, payload;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (!this.storage) {
+                            return [2 /*return*/];
+                        }
+                        return [4 /*yield*/, this.saveAllDataToStorage()];
+                    case 1:
+                        _b.sent();
+                        this.saveTimer = null;
+                        this.flushTimer = null;
+                        return [4 /*yield*/, this.storage.getAllAndClear()];
+                    case 2:
+                        _a = _b.sent(), tagRecords = _a.tags, counterRecords = _a.counters, histogramStatsRecords = _a.histogramStats, eventRecords = _a.events;
+                        // Update the last flush timestamp
+                        void this.storage.setLastFlushTimestamp(Date.now());
+                        tags = {};
+                        tagRecords.forEach(function (record) {
+                            tags[record.key] = record.value;
+                        });
+                        counters = {};
+                        counterRecords.forEach(function (record) {
+                            counters[record.key] = record.value;
+                        });
+                        histogram = {};
+                        histogramStatsRecords.forEach(function (stats) {
+                            histogram[stats.key] = {
+                                count: stats.count,
+                                min: stats.min,
+                                max: stats.max,
+                                avg: Math.round((stats.sum / stats.count) * 100) / 100, // round the average to 2 decimal places.
+                            };
+                        });
+                        events = eventRecords.map(function (record) { return ({
+                            event_name: record.event_name,
+                            time: record.time,
+                            event_properties: record.event_properties,
+                        }); });
+                        // Early return if all data collections are empty
+                        if (Object.keys(tags).length === 0 &&
+                            Object.keys(counters).length === 0 &&
+                            Object.keys(histogram).length === 0 &&
+                            events.length === 0) {
+                            return [2 /*return*/];
+                        }
+                        payload = {
+                            tags: tags,
+                            histogram: histogram,
+                            counters: counters,
+                            events: events,
+                        };
+                        // Send payload to diagnostics server
+                        void this.fetch(payload);
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Send diagnostics data to the server
+     */
+    DiagnosticsClient.prototype.fetch = function (payload) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        if (!getGlobalScope()) {
+                            throw new Error('DiagnosticsClient: Fetch is not supported');
+                        }
+                        return [4 /*yield*/, fetch(this.serverUrl, {
+                                method: 'POST',
+                                headers: {
+                                    'X-ApiKey': this.apiKey,
+                                    'Content-Type': 'application/json',
+                                },
+                                body: JSON.stringify(payload),
+                            })];
+                    case 1:
+                        response = _a.sent();
+                        if (!response.ok) {
+                            this.logger.debug('DiagnosticsClient: Failed to send diagnostics data.');
+                            return [2 /*return*/];
+                        }
+                        this.logger.debug('DiagnosticsClient: Successfully sent diagnostics data');
+                        return [3 /*break*/, 3];
+                    case 2:
+                        error_1 = _a.sent();
+                        this.logger.debug('DiagnosticsClient: Failed to send diagnostics data. ', error_1);
+                        return [3 /*break*/, 3];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Initialize flush interval logic.
+     * Check if 5 minutes has passed since last flush, if so flush immediately.
+     * Otherwise set a timer to flush when the interval is reached.
+     */
+    DiagnosticsClient.prototype.initializeFlushInterval = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var now, lastFlushTimestamp, timeSinceLastFlush, remainingTime;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.storage) {
+                            return [2 /*return*/];
+                        }
+                        now = Date.now();
+                        return [4 /*yield*/, this.storage.getLastFlushTimestamp()];
+                    case 1:
+                        lastFlushTimestamp = (_a.sent()) || -1;
+                        timeSinceLastFlush = now - lastFlushTimestamp;
+                        // If last flush timestamp is -1, it means this is a new client
+                        if (lastFlushTimestamp === -1) {
+                            return [2 /*return*/];
+                        }
+                        else if (timeSinceLastFlush >= FLUSH_INTERVAL_MS) {
+                            // More than 5 minutes has passed, flush immediately
+                            void this._flush();
+                            return [2 /*return*/];
+                        }
+                        else {
+                            remainingTime = FLUSH_INTERVAL_MS - timeSinceLastFlush;
+                            this.flushTimer = setTimeout(function () {
+                                _this._flush()
+                                    .catch(function (error) {
+                                    _this.logger.debug('DiagnosticsClient: Failed to flush', error);
+                                })
+                                    .finally(function () {
+                                    _this.flushTimer = null;
+                                });
+                            }, remainingTime);
+                        }
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return DiagnosticsClient;
+}());
+export { DiagnosticsClient };
+//# sourceMappingURL=diagnostics-client.js.map

package/lib/esm/diagnostics/diagnostics-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-client.js","sourceRoot":"","sources":["../../../src/diagnostics/diagnostics-client.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,IAAM,gBAAgB,GAAG,IAAI,CAAC,CAAC,WAAW;AACjD,MAAM,CAAC,IAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAC5D,MAAM,CAAC,IAAM,yBAAyB,GAAG,6DAA6D,CAAC;AACvG,MAAM,CAAC,IAAM,yBAAyB,GAAG,gEAAgE,CAAC;AAE1G,2BAA2B;AAC3B,MAAM,CAAC,IAAM,wBAAwB,GAAG,KAAK,CAAC,CAAC,4CAA4C;AAC3F,MAAM,CAAC,IAAM,+BAA+B,GAAG,EAAE,CAAC;AAwIlD;IAiBE,2BAAY,MAAc,EAAE,MAAe,EAAE,UAAiC;QAAjC,2BAAA,EAAA,iBAAiC;QAX9E,qBAAqB;QACrB,iBAAY,GAAoB,EAAE,CAAC;QACnC,qBAAgB,GAAwB,EAAE,CAAC;QAC3C,uBAAkB,GAA8B,EAAE,CAAC;QACnD,mBAAc,GAAuB,EAAE,CAAC;QAExC,iCAAiC;QACjC,cAAS,GAAyC,IAAI,CAAC;QACvD,2BAA2B;QAC3B,eAAU,GAAyC,IAAI,CAAC;QAGtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,yBAAyB,CAAC;QAE7F,IAAI,kBAAkB,CAAC,WAAW,EAAE,EAAE;YACpC,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACvD;aAAM;YACL,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;SACpE;QAED,KAAK,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACtC,CAAC;IAED,kCAAM,GAAN,UAAO,IAAY,EAAE,KAAa;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,OAAO;SACR;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,IAAI,wBAAwB,EAAE;YACrE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,OAAO;SACR;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAChC,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED,qCAAS,GAAT,UAAU,IAAY,EAAE,IAAQ;QAAR,qBAAA,EAAA,QAAQ;QAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,OAAO;SACR;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,wBAAwB,EAAE;YACzE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;YACxF,OAAO;SACR;QAED,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QACxE,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED,2CAAe,GAAf,UAAgB,IAAY,EAAE,KAAa;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,OAAO;SACR;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,IAAI,wBAAwB,EAAE;YAC3E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;YAC9F,OAAO;SACR;QAED,IAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE;YACZ,sCAAsC;YACtC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;YACpB,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7C,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7C,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC;SACvB;aAAM;YACL,mBAAmB;YACnB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG;gBAC9B,KAAK,EAAE,CAAC;gBACR,GAAG,EAAE,KAAK;gBACV,GAAG,EAAE,KAAK;gBACV,GAAG,EAAE,KAAK;aACX,CAAC;SACH;QACD,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED,uCAAW,GAAX,UAAY,IAAY,EAAE,UAA2B;QACnD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,OAAO;SACR;QAED,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,IAAI,+BAA+B,EAAE;YACjE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;YAC1F,OAAO;SACR;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;YACvB,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;YAChB,gBAAgB,EAAE,UAAU;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED,+CAAmB,GAAnB;QAAA,iBAwBC;QAvBC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACnB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC;gBAC1B,KAAI,CAAC,oBAAoB,EAAE;qBACxB,KAAK,CAAC,UAAC,KAAK;oBACX,KAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAC;gBACpF,CAAC,CAAC;qBACD,OAAO,CAAC;oBACP,KAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACxB,CAAC,CAAC,CAAC;YACP,CAAC,EAAE,gBAAgB,CAAC,CAAC;SACtB;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YACpB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;gBAC3B,KAAI,CAAC,MAAM,EAAE;qBACV,KAAK,CAAC,UAAC,KAAK;oBACX,KAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;gBACjE,CAAC,CAAC;qBACD,OAAO,CAAC;oBACP,KAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACzB,CAAC,CAAC,CAAC;YACP,CAAC,EAAE,iBAAiB,CAAC,CAAC;SACvB;IACH,CAAC;IAEK,gDAAoB,GAA1B;;;;;;wBACE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;4BACjB,sBAAO;yBACR;wBACK,UAAU,gBAAQ,IAAI,CAAC,YAAY,CAAE,CAAC;wBACtC,cAAc,gBAAQ,IAAI,CAAC,gBAAgB,CAAE,CAAC;wBAC9C,gBAAgB,gBAAQ,IAAI,CAAC,kBAAkB,CAAE,CAAC;wBAClD,YAAY,4BAAO,IAAI,CAAC,cAAc,SAAC,CAAC;wBAE9C,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;wBACzB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;wBACvB,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;wBAC3B,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;wBAE7B,qBAAM,OAAO,CAAC,GAAG,CAAC;gCAChB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;gCAChC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC;gCAC9C,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;gCAChD,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC;6BAC3C,CAAC,EAAA;;wBALF,SAKE,CAAC;;;;;KACJ;IAEK,kCAAM,GAAZ;;;;;;wBACE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;4BACjB,sBAAO;yBACR;wBAED,qBAAM,IAAI,CAAC,oBAAoB,EAAE,EAAA;;wBAAjC,SAAiC,CAAC;wBAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;wBACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;wBAQnB,qBAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAA;;wBALjC,KAKF,SAAmC,EAJ/B,UAAU,UAAA,EACN,cAAc,cAAA,EACR,qBAAqB,oBAAA,EAC7B,YAAY,YAAA;wBAGtB,kCAAkC;wBAClC,KAAK,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;wBAG9C,IAAI,GAAoB,EAAE,CAAC;wBACjC,UAAU,CAAC,OAAO,CAAC,UAAC,MAAM;4BACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;wBAClC,CAAC,CAAC,CAAC;wBAEG,QAAQ,GAAwB,EAAE,CAAC;wBACzC,cAAc,CAAC,OAAO,CAAC,UAAC,MAAM;4BAC5B,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;wBACtC,CAAC,CAAC,CAAC;wBAEG,SAAS,GAA0B,EAAE,CAAC;wBAC5C,qBAAqB,CAAC,OAAO,CAAC,UAAC,KAAK;4BAClC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG;gCACrB,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,GAAG,EAAE,KAAK,CAAC,GAAG;gCACd,GAAG,EAAE,KAAK,CAAC,GAAG;gCACd,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,yCAAyC;6BAClG,CAAC;wBACJ,CAAC,CAAC,CAAC;wBAEG,MAAM,GAAuB,YAAY,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,CAAC;4BAC/D,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;yBAC1C,CAAC,EAJ8D,CAI9D,CAAC,CAAC;wBAEJ,iDAAiD;wBACjD,IACE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;4BAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;4BAClC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;4BACnC,MAAM,CAAC,MAAM,KAAK,CAAC,EACnB;4BACA,sBAAO;yBACR;wBAGK,OAAO,GAAiB;4BAC5B,IAAI,MAAA;4BACJ,SAAS,WAAA;4BACT,QAAQ,UAAA;4BACR,MAAM,QAAA;yBACP,CAAC;wBAEF,qCAAqC;wBACrC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;;;;KAC1B;IAED;;OAEG;IACG,iCAAK,GAAX,UAAY,OAAqB;;;;;;;wBAE7B,IAAI,CAAC,cAAc,EAAE,EAAE;4BACrB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;yBAC9D;wBAEgB,qBAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;gCAC3C,MAAM,EAAE,MAAM;gCACd,OAAO,EAAE;oCACP,UAAU,EAAE,IAAI,CAAC,MAAM;oCACvB,cAAc,EAAE,kBAAkB;iCACnC;gCACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;6BAC9B,CAAC,EAAA;;wBAPI,QAAQ,GAAG,SAOf;wBAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;4BAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;4BACzE,sBAAO;yBACR;wBAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;;;;wBAE3E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,EAAE,OAAK,CAAC,CAAC;;;;;;KAEpF;IAED;;;;OAIG;IACG,mDAAuB,GAA7B;;;;;;;wBACE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;4BACjB,sBAAO;yBACR;wBACK,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBACK,qBAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAA;;wBAAhE,kBAAkB,GAAG,CAAC,SAA0C,CAAC,IAAI,CAAC,CAAC;wBACvE,kBAAkB,GAAG,GAAG,GAAG,kBAAkB,CAAC;wBAEpD,+DAA+D;wBAC/D,IAAI,kBAAkB,KAAK,CAAC,CAAC,EAAE;4BAC7B,sBAAO;yBACR;6BAAM,IAAI,kBAAkB,IAAI,iBAAiB,EAAE;4BAClD,oDAAoD;4BACpD,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;4BACnB,sBAAO;yBACR;6BAAM;4BAEC,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;4BAC7D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;gCAC3B,KAAI,CAAC,MAAM,EAAE;qCACV,KAAK,CAAC,UAAC,KAAK;oCACX,KAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;gCACjE,CAAC,CAAC;qCACD,OAAO,CAAC;oCACP,KAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gCACzB,CAAC,CAAC,CAAC;4BACP,CAAC,EAAE,aAAa,CAAC,CAAC;yBACnB;;;;;KACF;IACH,wBAAC;AAAD,CAAC,AA9RD,IA8RC","sourcesContent":["import { ILogger } from '../logger';\nimport { DiagnosticsStorage, IDiagnosticsStorage } from './diagnostics-storage';\nimport { ServerZoneType } from '../types/server-zone';\nimport { getGlobalScope } from '../global-scope';\n\nexport const SAVE_INTERVAL_MS = 1000; // 1 second\nexport const FLUSH_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes\nexport const DIAGNOSTICS_US_SERVER_URL = 'https://diagnostics.prod.us-west-2.amplitude.com/v1/capture';\nexport const DIAGNOSTICS_EU_SERVER_URL = 'https://diagnostics.prod.eu-central-1.amplitude.com/v1/capture';\n\n// In-memory storage limits\nexport const MAX_MEMORY_STORAGE_COUNT = 10000; // for tags, counters, histograms separately\nexport const MAX_MEMORY_STORAGE_EVENTS_COUNT = 10;\n\n// === Core Data Types ===\n\n/**\n * Key-value pairs for environment/context information\n */\ntype DiagnosticsTags = Record<string, string>;\n\n/**\n * Numeric counters that can be incremented\n */\ntype DiagnosticsCounters = Record<string, number>;\n\n/**\n * Properties for diagnostic events\n */\ntype EventProperties = Record<string, any>;\n\n/**\n * Individual diagnostic event\n */\ninterface DiagnosticsEvent {\n  readonly event_name: string;\n  readonly time: number;\n  readonly event_properties: EventProperties;\n}\n\n/**\n * Computed histogram statistics for final payload\n */\ninterface HistogramResult {\n  readonly count: number;\n  readonly min: number;\n  readonly max: number;\n  readonly avg: number;\n}\n\n/**\n * Internal histogram statistics with sum for efficient incremental updates\n */\nexport interface HistogramStats {\n  count: number;\n  min: number;\n  max: number;\n  sum: number; // Used for avg calculation\n}\n\n/**\n * Collection of histogram results keyed by histogram name\n */\ntype DiagnosticsHistograms = Record<string, HistogramResult>;\n\n/**\n * Collection of histogram stats keyed by histogram name (internal use for memory + persistence storage)\n */\ntype DiagnosticsHistogramStats = Record<string, HistogramStats>;\n\n// === Payload Types ===\n\n/**\n * Complete diagnostics payload sent to backend\n */\ninterface FlushPayload {\n  readonly tags: DiagnosticsTags;\n  readonly histogram: DiagnosticsHistograms;\n  readonly counters: DiagnosticsCounters;\n  readonly events: readonly DiagnosticsEvent[];\n}\n\n/**\n * Amplitude Diagnostics Client\n *\n * A client for collecting and managing diagnostics data including tags, counters,\n * histograms, and events. Data is stored persistently using IndexedDB to survive browser restarts and offline scenarios.\n *\n * Key Features:\n * - IndexedDB storage\n * - Time-based persistent storage flush interval (5 minutes since last flush)\n * - 1 second time-based memory storage flush to persistent storage\n * - Histogram statistics calculation (min, max, avg)\n */\nexport interface IDiagnosticsClient {\n  /**\n   * Set or update a tag\n   *\n   * @example\n   * ```typescript\n   * // Set environment tags\n   * diagnostics.setTag('library', 'amplitude-typescript/2.0.0');\n   * diagnostics.setTag('user_agent', navigator.userAgent);\n   * ```\n   */\n  setTag(name: string, value: string): void;\n\n  /**\n   * Increment a counter. If doesn't exist, create a counter and set value to 1\n   *\n   * @example\n   * ```typescript\n   * // Track counters\n   * diagnostics.increment('analytics.fileNotFound');\n   * diagnostics.increment('network.retry', 3);\n   * ```\n   */\n  increment(name: string, size?: number): void;\n\n  /**\n   * Record a histogram value\n   *\n   * @example\n   * ```typescript\n   * // Record performance metrics\n   * diagnostics.recordHistogram('sr.time', 5.2);\n   * diagnostics.recordHistogram('network.latency', 150);\n   * ```\n   */\n  recordHistogram(name: string, value: number): void;\n\n  /**\n   * Record an event\n   *\n   * @example\n   * ```typescript\n   * // Record diagnostic events\n   * diagnostics.recordEvent('error', {\n   *   stack_trace: '...',\n   * });\n   * ```\n   */\n  recordEvent(name: string, properties: EventProperties): void;\n\n  // Flush storage\n  _flush(): void;\n}\n\nexport class DiagnosticsClient implements IDiagnosticsClient {\n  storage?: IDiagnosticsStorage;\n  logger: ILogger;\n  serverUrl: string;\n  apiKey: string;\n\n  // In-memory storages\n  inMemoryTags: DiagnosticsTags = {};\n  inMemoryCounters: DiagnosticsCounters = {};\n  inMemoryHistograms: DiagnosticsHistogramStats = {};\n  inMemoryEvents: DiagnosticsEvent[] = [];\n\n  // Timer for 1-second persistence\n  saveTimer: ReturnType<typeof setTimeout> | null = null;\n  // Timer for flush interval\n  flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(apiKey: string, logger: ILogger, serverZone: ServerZoneType = 'US') {\n    this.apiKey = apiKey;\n    this.logger = logger;\n    this.serverUrl = serverZone === 'US' ? DIAGNOSTICS_US_SERVER_URL : DIAGNOSTICS_EU_SERVER_URL;\n\n    if (DiagnosticsStorage.isSupported()) {\n      this.storage = new DiagnosticsStorage(apiKey, logger);\n    } else {\n      this.logger.debug('DiagnosticsClient: IndexedDB is not supported');\n    }\n\n    void this.initializeFlushInterval();\n  }\n\n  setTag(name: string, value: string) {\n    if (!this.storage) {\n      return;\n    }\n\n    if (Object.keys(this.inMemoryTags).length >= MAX_MEMORY_STORAGE_COUNT) {\n      this.logger.debug('DiagnosticsClient: Early return setTags as reaching memory limit');\n      return;\n    }\n\n    this.inMemoryTags[name] = value;\n    this.startTimersIfNeeded();\n  }\n\n  increment(name: string, size = 1) {\n    if (!this.storage) {\n      return;\n    }\n\n    if (Object.keys(this.inMemoryCounters).length >= MAX_MEMORY_STORAGE_COUNT) {\n      this.logger.debug('DiagnosticsClient: Early return increment as reaching memory limit');\n      return;\n    }\n\n    this.inMemoryCounters[name] = (this.inMemoryCounters[name] || 0) + size;\n    this.startTimersIfNeeded();\n  }\n\n  recordHistogram(name: string, value: number) {\n    if (!this.storage) {\n      return;\n    }\n\n    if (Object.keys(this.inMemoryHistograms).length >= MAX_MEMORY_STORAGE_COUNT) {\n      this.logger.debug('DiagnosticsClient: Early return recordHistogram as reaching memory limit');\n      return;\n    }\n\n    const existing = this.inMemoryHistograms[name];\n    if (existing) {\n      // Update existing stats incrementally\n      existing.count += 1;\n      existing.min = Math.min(existing.min, value);\n      existing.max = Math.max(existing.max, value);\n      existing.sum += value;\n    } else {\n      // Create new stats\n      this.inMemoryHistograms[name] = {\n        count: 1,\n        min: value,\n        max: value,\n        sum: value,\n      };\n    }\n    this.startTimersIfNeeded();\n  }\n\n  recordEvent(name: string, properties: EventProperties) {\n    if (!this.storage) {\n      return;\n    }\n\n    if (this.inMemoryEvents.length >= MAX_MEMORY_STORAGE_EVENTS_COUNT) {\n      this.logger.debug('DiagnosticsClient: Early return recordEvent as reaching memory limit');\n      return;\n    }\n\n    this.inMemoryEvents.push({\n      event_name: name,\n      time: Date.now(),\n      event_properties: properties,\n    });\n    this.startTimersIfNeeded();\n  }\n\n  startTimersIfNeeded() {\n    if (!this.saveTimer) {\n      this.saveTimer = setTimeout(() => {\n        this.saveAllDataToStorage()\n          .catch((error) => {\n            this.logger.debug('DiagnosticsClient: Failed to save all data to storage', error);\n          })\n          .finally(() => {\n            this.saveTimer = null;\n          });\n      }, SAVE_INTERVAL_MS);\n    }\n\n    if (!this.flushTimer) {\n      this.flushTimer = setTimeout(() => {\n        this._flush()\n          .catch((error) => {\n            this.logger.debug('DiagnosticsClient: Failed to flush', error);\n          })\n          .finally(() => {\n            this.flushTimer = null;\n          });\n      }, FLUSH_INTERVAL_MS);\n    }\n  }\n\n  async saveAllDataToStorage() {\n    if (!this.storage) {\n      return;\n    }\n    const tagsToSave = { ...this.inMemoryTags };\n    const countersToSave = { ...this.inMemoryCounters };\n    const histogramsToSave = { ...this.inMemoryHistograms };\n    const eventsToSave = [...this.inMemoryEvents];\n\n    this.inMemoryEvents = [];\n    this.inMemoryTags = {};\n    this.inMemoryCounters = {};\n    this.inMemoryHistograms = {};\n\n    await Promise.all([\n      this.storage.setTags(tagsToSave),\n      this.storage.incrementCounters(countersToSave),\n      this.storage.setHistogramStats(histogramsToSave),\n      this.storage.addEventRecords(eventsToSave),\n    ]);\n  }\n\n  async _flush() {\n    if (!this.storage) {\n      return;\n    }\n\n    await this.saveAllDataToStorage();\n    this.saveTimer = null;\n    this.flushTimer = null;\n\n    // Get all data from storage and clear it\n    const {\n      tags: tagRecords,\n      counters: counterRecords,\n      histogramStats: histogramStatsRecords,\n      events: eventRecords,\n    } = await this.storage.getAllAndClear();\n\n    // Update the last flush timestamp\n    void this.storage.setLastFlushTimestamp(Date.now());\n\n    // Convert metrics to the expected format\n    const tags: DiagnosticsTags = {};\n    tagRecords.forEach((record) => {\n      tags[record.key] = record.value;\n    });\n\n    const counters: DiagnosticsCounters = {};\n    counterRecords.forEach((record) => {\n      counters[record.key] = record.value;\n    });\n\n    const histogram: DiagnosticsHistograms = {};\n    histogramStatsRecords.forEach((stats) => {\n      histogram[stats.key] = {\n        count: stats.count,\n        min: stats.min,\n        max: stats.max,\n        avg: Math.round((stats.sum / stats.count) * 100) / 100, // round the average to 2 decimal places.\n      };\n    });\n\n    const events: DiagnosticsEvent[] = eventRecords.map((record) => ({\n      event_name: record.event_name,\n      time: record.time,\n      event_properties: record.event_properties,\n    }));\n\n    // Early return if all data collections are empty\n    if (\n      Object.keys(tags).length === 0 &&\n      Object.keys(counters).length === 0 &&\n      Object.keys(histogram).length === 0 &&\n      events.length === 0\n    ) {\n      return;\n    }\n\n    // Create flush payload\n    const payload: FlushPayload = {\n      tags,\n      histogram,\n      counters,\n      events,\n    };\n\n    // Send payload to diagnostics server\n    void this.fetch(payload);\n  }\n\n  /**\n   * Send diagnostics data to the server\n   */\n  async fetch(payload: FlushPayload) {\n    try {\n      if (!getGlobalScope()) {\n        throw new Error('DiagnosticsClient: Fetch is not supported');\n      }\n\n      const response = await fetch(this.serverUrl, {\n        method: 'POST',\n        headers: {\n          'X-ApiKey': this.apiKey,\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (!response.ok) {\n        this.logger.debug('DiagnosticsClient: Failed to send diagnostics data.');\n        return;\n      }\n\n      this.logger.debug('DiagnosticsClient: Successfully sent diagnostics data');\n    } catch (error) {\n      this.logger.debug('DiagnosticsClient: Failed to send diagnostics data. ', error);\n    }\n  }\n\n  /**\n   * Initialize flush interval logic.\n   * Check if 5 minutes has passed since last flush, if so flush immediately.\n   * Otherwise set a timer to flush when the interval is reached.\n   */\n  async initializeFlushInterval() {\n    if (!this.storage) {\n      return;\n    }\n    const now = Date.now();\n    const lastFlushTimestamp = (await this.storage.getLastFlushTimestamp()) || -1;\n    const timeSinceLastFlush = now - lastFlushTimestamp;\n\n    // If last flush timestamp is -1, it means this is a new client\n    if (lastFlushTimestamp === -1) {\n      return;\n    } else if (timeSinceLastFlush >= FLUSH_INTERVAL_MS) {\n      // More than 5 minutes has passed, flush immediately\n      void this._flush();\n      return;\n    } else {\n      // Set timer for remaining time\n      const remainingTime = FLUSH_INTERVAL_MS - timeSinceLastFlush;\n      this.flushTimer = setTimeout(() => {\n        this._flush()\n          .catch((error) => {\n            this.logger.debug('DiagnosticsClient: Failed to flush', error);\n          })\n          .finally(() => {\n            this.flushTimer = null;\n          });\n      }, remainingTime);\n    }\n  }\n}\n"]}

package/lib/esm/diagnostics/diagnostics-storage.d.ts

@@ -0,0 +1,123 @@
+import { ILogger } from '../logger';
+import { HistogramStats } from './diagnostics-client';
+export declare const TABLE_NAMES: {
+    readonly TAGS: "tags";
+    readonly COUNTERS: "counters";
+    readonly HISTOGRAMS: "histograms";
+    readonly EVENTS: "events";
+    readonly INTERNAL: "internal";
+};
+export declare const INTERNAL_KEYS: {
+    readonly LAST_FLUSH_TIMESTAMP: "last_flush_timestamp";
+};
+export interface TagRecord {
+    key: string;
+    value: string;
+}
+export interface CounterRecord {
+    key: string;
+    value: number;
+}
+export interface HistogramRecord {
+    key: string;
+    count: number;
+    min: number;
+    max: number;
+    sum: number;
+}
+export interface EventRecord {
+    id?: number;
+    event_name: string;
+    time: number;
+    event_properties: Record<string, any>;
+}
+export interface InternalRecord {
+    key: string;
+    value: string;
+}
+export interface IDiagnosticsStorage {
+    /**
+     * Set multiple tags in a single transaction (batch operation)
+     * Promise never rejects - errors are logged and operation continues gracefully
+     */
+    setTags(tags: Record<string, string>): Promise<void>;
+    /**
+     * Increment multiple counters in a single transaction (batch operation)
+     * Uses read-modify-write pattern to accumulate with existing values
+     * Promise never rejects - errors are logged and operation continues gracefully
+     */
+    incrementCounters(counters: Record<string, number>): Promise<void>;
+    /**
+     * Set multiple histogram stats in a single transaction (batch operation)
+     * Uses read-modify-write pattern to accumulate count/sum and update min/max with existing values
+     * Promise never rejects - errors are logged and operation continues gracefully
+     */
+    setHistogramStats(histogramStats: Record<string, {
+        count: number;
+        min: number;
+        max: number;
+        sum: number;
+    }>): Promise<void>;
+    /**
+     * Add multiple event records in a single transaction (batch operation)
+     * Promise never rejects - errors are logged and operation continues gracefully
+     */
+    addEventRecords(events: Array<{
+        event_name: string;
+        time: number;
+        event_properties: Record<string, any>;
+    }>): Promise<void>;
+    setLastFlushTimestamp(timestamp: number): Promise<void>;
+    getLastFlushTimestamp(): Promise<number | undefined>;
+    /**
+     * Get all data except internal data from storage and clear it
+     */
+    getAllAndClear(): Promise<{
+        tags: TagRecord[];
+        counters: CounterRecord[];
+        histogramStats: HistogramRecord[];
+        events: EventRecord[];
+    }>;
+}
+/**
+ * Purpose-specific IndexedDB storage for diagnostics data
+ * Provides optimized methods for each type of diagnostics data
+ */
+export declare class DiagnosticsStorage implements IDiagnosticsStorage {
+    dbPromise: Promise<IDBDatabase> | null;
+    dbName: string;
+    logger: ILogger;
+    constructor(apiKey: string, logger: ILogger);
+    /**
+     * Check if IndexedDB is supported in the current environment
+     * @returns true if IndexedDB is available, false otherwise
+     */
+    static isSupported(): boolean;
+    getDB(): Promise<IDBDatabase>;
+    openDB(): Promise<IDBDatabase>;
+    createTables(db: IDBDatabase): void;
+    setTags(tags: Record<string, string>): Promise<void>;
+    incrementCounters(counters: Record<string, number>): Promise<void>;
+    setHistogramStats(histogramStats: Record<string, HistogramStats>): Promise<void>;
+    addEventRecords(events: Array<{
+        event_name: string;
+        time: number;
+        event_properties: Record<string, any>;
+    }>): Promise<void>;
+    setInternal(key: string, value: string): Promise<void>;
+    getInternal(key: string): Promise<InternalRecord | undefined>;
+    getLastFlushTimestamp(): Promise<number | undefined>;
+    setLastFlushTimestamp(timestamp: number): Promise<void>;
+    clearTable(transaction: IDBTransaction, tableName: string): Promise<void>;
+    getAllAndClear(): Promise<{
+        tags: TagRecord[];
+        counters: CounterRecord[];
+        histogramStats: HistogramRecord[];
+        events: EventRecord[];
+    }>;
+    /**
+     * Helper method to get all records from a store within a transaction
+     */
+    private getAllFromStore;
+}
+//# sourceMappingURL=diagnostics-storage.d.ts.map

package/lib/esm/diagnostics/diagnostics-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-storage.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/diagnostics-storage.ts"],"names":[],"mappings":"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"}