@amplitude/analytics-core 2.24.1 → 2.26.0

package/lib/cjs/types/config/core-config.d.ts

@@ -7,6 +7,7 @@ import { ServerZoneType } from '../server-zone';
 import { Transport } from '../transport';
 import { Storage } from '../storage';
 import { Event } from '../event/event';
+import { IIdentify } from '../../identify';
 export interface IConfig {
     /**
      * Your Amplitude Project API key.
@@ -85,6 +86,10 @@ export interface IConfig {
      * Metrics of the SDK.
      */
     requestMetadata?: IRequestMetadata;
+    /**
+     * Invokes identify on this Identify object prior to initializing the SDK.
+     */
+    identify?: IIdentify;
 }
 export interface IRequestMetadata {
     sdk: {

package/lib/cjs/types/config/core-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-config.d.ts","sourceRoot":"","sources":["../../../../src/types/config/core-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,eAAe,CAAC;IAC3C;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACnC;;OAEG;IACH,iBAAiB,EAAE,SAAS,CAAC;IAC7B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE;QACH,OAAO,EAAE;YACP,SAAS,EAAE,iBAAiB,CAAC;SAC9B,CAAC;KACH,CAAC;IAEF,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,iBAAiB;IAChC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,oCAAoC,CAAC,EAAE,MAAM,CAAC;IAC9C,iCAAiC,CAAC,EAAE,MAAM,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,OAAO,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,SAAS,CAAC;CAC9B"}
+{"version":3,"file":"core-config.d.ts","sourceRoot":"","sources":["../../../../src/types/config/core-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,eAAe,CAAC;IAC3C;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACnC;;OAEG;IACH,iBAAiB,EAAE,SAAS,CAAC;IAC7B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE;QACH,OAAO,EAAE;YACP,SAAS,EAAE,iBAAiB,CAAC;SAC9B,CAAC;KACH,CAAC;IAEF,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,iBAAiB;IAChC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,oCAAoC,CAAC,EAAE,MAAM,CAAC;IAC9C,iCAAiC,CAAC,EAAE,MAAM,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,OAAO,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,SAAS,CAAC;CAC9B"}

package/lib/cjs/types/config/core-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"core-config.js","sourceRoot":"","sources":["../../../../src/types/config/core-config.ts"],"names":[],"mappings":"","sourcesContent":["import { LogLevel } from '../loglevel';\nimport { ILogger } from '../../logger';\nimport { OfflineDisabled } from '../offline';\nimport { Plan } from '../event/plan';\nimport { IngestionMetadata } from '../event/ingestion-metadata';\nimport { ServerZoneType } from '../server-zone';\nimport { Transport } from '../transport';\nimport { Storage } from '../storage';\nimport { Event } from '../event/event';\n\nexport interface IConfig {\n  /**\n   * Your Amplitude Project API key.\n   */\n  apiKey: string;\n  /**\n   * The interval of uploading events to Amplitude in milliseconds.\n   */\n  flushIntervalMillis: number;\n  /**\n   * The maximum number of retries for failed upload attempts. This is only applicable to retryable errors.\n   */\n  flushMaxRetries: number;\n  /**\n   * The maximum number of events that are batched in a single upload attempt.\n   */\n  flushQueueSize: number;\n  /**\n   * The instance name. For tracking events to multiple Amplitude projects in your application.\n   */\n  instanceName?: string;\n  /**\n   * Level of logs to be printed in the developer console.\n   * Valid values are `LogLevel.None`, `LogLevel.Error`, `LogLevel.Warn`, `LogLevel.Verbose`,  `LogLevel.Debug`\n   */\n  logLevel: LogLevel;\n  /**\n   * A custom Logger class to emit log messages to desired destination.\n   */\n  loggerProvider: ILogger;\n  /**\n   * The minimum length for the value of userId and deviceId properties.\n   */\n  minIdLength?: number;\n  /**\n   * Whether the SDK is connected to network.\n   */\n  offline?: boolean | typeof OfflineDisabled;\n  /**\n   *  The flag to opt this device out of Amplitude tracking.\n   *  If this flag is set, no additional information will be stored for the user.\n   */\n  optOut: boolean;\n  /**\n   * Tracking plan properties.\n   * Amplitude internal use.\n   */\n  plan?: Plan;\n  /**\n   * Ingestion metadata.\n   * Amplitude internal use.\n   */\n  ingestionMetadata?: IngestionMetadata;\n  /**\n   * The URL where events are upload to.\n   */\n  serverUrl?: string;\n  /**\n   * The Amplitude server zone.\n   * Set this to EU for Amplitude projects created in EU data center.\n   */\n  serverZone?: ServerZoneType;\n  /**\n   *  The storage provider to persist unsent events.\n   */\n  storageProvider?: Storage<Event[]>;\n  /**\n   * A customer Transport Class for sending data to a server.\n   */\n  transportProvider: Transport;\n  /**\n   * The flag of whether to upload events to Batch API instead of the default HTTP V2 API.\n   */\n  useBatch: boolean;\n  /**\n   * Metrics of the SDK.\n   */\n  requestMetadata?: IRequestMetadata;\n}\n\nexport interface IRequestMetadata {\n  sdk: {\n    metrics: {\n      histogram: IHistogramOptions;\n    };\n  };\n\n  recordHistogram<T extends HistogramKey>(key: T, value: IHistogramOptions[T]): void;\n}\n\nexport interface IHistogramOptions {\n  remote_config_fetch_time_IDB?: number;\n  remote_config_fetch_time_API_success?: number;\n  remote_config_fetch_time_API_fail?: number;\n}\n\nexport type HistogramKey = keyof IHistogramOptions;\n\nexport interface ConfigOptions extends Partial<IConfig> {\n  apiKey: string;\n  transportProvider: Transport;\n}\n"]}
+{"version":3,"file":"core-config.js","sourceRoot":"","sources":["../../../../src/types/config/core-config.ts"],"names":[],"mappings":"","sourcesContent":["import { LogLevel } from '../loglevel';\nimport { ILogger } from '../../logger';\nimport { OfflineDisabled } from '../offline';\nimport { Plan } from '../event/plan';\nimport { IngestionMetadata } from '../event/ingestion-metadata';\nimport { ServerZoneType } from '../server-zone';\nimport { Transport } from '../transport';\nimport { Storage } from '../storage';\nimport { Event } from '../event/event';\nimport { IIdentify } from '../../identify';\n\nexport interface IConfig {\n  /**\n   * Your Amplitude Project API key.\n   */\n  apiKey: string;\n  /**\n   * The interval of uploading events to Amplitude in milliseconds.\n   */\n  flushIntervalMillis: number;\n  /**\n   * The maximum number of retries for failed upload attempts. This is only applicable to retryable errors.\n   */\n  flushMaxRetries: number;\n  /**\n   * The maximum number of events that are batched in a single upload attempt.\n   */\n  flushQueueSize: number;\n  /**\n   * The instance name. For tracking events to multiple Amplitude projects in your application.\n   */\n  instanceName?: string;\n  /**\n   * Level of logs to be printed in the developer console.\n   * Valid values are `LogLevel.None`, `LogLevel.Error`, `LogLevel.Warn`, `LogLevel.Verbose`,  `LogLevel.Debug`\n   */\n  logLevel: LogLevel;\n  /**\n   * A custom Logger class to emit log messages to desired destination.\n   */\n  loggerProvider: ILogger;\n  /**\n   * The minimum length for the value of userId and deviceId properties.\n   */\n  minIdLength?: number;\n  /**\n   * Whether the SDK is connected to network.\n   */\n  offline?: boolean | typeof OfflineDisabled;\n  /**\n   *  The flag to opt this device out of Amplitude tracking.\n   *  If this flag is set, no additional information will be stored for the user.\n   */\n  optOut: boolean;\n  /**\n   * Tracking plan properties.\n   * Amplitude internal use.\n   */\n  plan?: Plan;\n  /**\n   * Ingestion metadata.\n   * Amplitude internal use.\n   */\n  ingestionMetadata?: IngestionMetadata;\n  /**\n   * The URL where events are upload to.\n   */\n  serverUrl?: string;\n  /**\n   * The Amplitude server zone.\n   * Set this to EU for Amplitude projects created in EU data center.\n   */\n  serverZone?: ServerZoneType;\n  /**\n   *  The storage provider to persist unsent events.\n   */\n  storageProvider?: Storage<Event[]>;\n  /**\n   * A customer Transport Class for sending data to a server.\n   */\n  transportProvider: Transport;\n  /**\n   * The flag of whether to upload events to Batch API instead of the default HTTP V2 API.\n   */\n  useBatch: boolean;\n  /**\n   * Metrics of the SDK.\n   */\n  requestMetadata?: IRequestMetadata;\n  /**\n   * Invokes identify on this Identify object prior to initializing the SDK.\n   */\n  identify?: IIdentify;\n}\n\nexport interface IRequestMetadata {\n  sdk: {\n    metrics: {\n      histogram: IHistogramOptions;\n    };\n  };\n\n  recordHistogram<T extends HistogramKey>(key: T, value: IHistogramOptions[T]): void;\n}\n\nexport interface IHistogramOptions {\n  remote_config_fetch_time_IDB?: number;\n  remote_config_fetch_time_API_success?: number;\n  remote_config_fetch_time_API_fail?: number;\n}\n\nexport type HistogramKey = keyof IHistogramOptions;\n\nexport interface ConfigOptions extends Partial<IConfig> {\n  apiKey: string;\n  transportProvider: Transport;\n}\n"]}

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":"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","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"]}