@mostly-good-metrics/javascript 0.1.0

package/dist/cjs/client.js

@@ -0,0 +1,416 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MostlyGoodMetrics = void 0;
+const logger_1 = require("./logger");
+const network_1 = require("./network");
+const storage_1 = require("./storage");
+const types_1 = require("./types");
+const utils_1 = require("./utils");
+const FLUSH_DELAY_MS = 100; // Delay between batch sends
+/**
+ * Main client for MostlyGoodMetrics.
+ * Use the static `configure` method to initialize, then use static methods or the instance.
+ */
+class MostlyGoodMetrics {
+    /**
+     * Private constructor - use `configure` to create an instance.
+     */
+    constructor(config) {
+        this.flushTimer = null;
+        this.isFlushingInternal = false;
+        this.lifecycleSetup = false;
+        this.handleVisibilityChange = () => {
+            if (document.hidden) {
+                // App backgrounded
+                this.track(types_1.SystemEvents.APP_BACKGROUNDED);
+                void this.flush(); // Flush when going to background
+            }
+            else {
+                // App foregrounded
+                this.track(types_1.SystemEvents.APP_OPENED);
+            }
+        };
+        this.handleBeforeUnload = () => {
+            // Best-effort flush using sendBeacon if available
+            this.flushWithBeacon();
+        };
+        this.handlePageHide = () => {
+            // Best-effort flush using sendBeacon if available
+            this.flushWithBeacon();
+        };
+        this.config = (0, utils_1.resolveConfiguration)(config);
+        this.sessionIdValue = (0, utils_1.generateUUID)();
+        // Set up logging
+        (0, logger_1.setDebugLogging)(this.config.enableDebugLogging);
+        // Initialize storage
+        this.storage = this.config.storage ?? (0, storage_1.createDefaultStorage)(this.config.maxStoredEvents);
+        // Initialize network client
+        this.networkClient = this.config.networkClient ?? (0, network_1.createDefaultNetworkClient)();
+        logger_1.logger.info(`MostlyGoodMetrics initialized with environment: ${this.config.environment}`);
+        // Start auto-flush timer
+        this.startFlushTimer();
+        // Set up lifecycle tracking
+        if (this.config.trackAppLifecycleEvents) {
+            this.setupLifecycleTracking();
+        }
+    }
+    /**
+     * Configure and initialize the SDK.
+     * Returns the singleton instance.
+     */
+    static configure(config) {
+        if (!config.apiKey) {
+            throw new Error('API key is required');
+        }
+        if (MostlyGoodMetrics.instance) {
+            logger_1.logger.warn('MostlyGoodMetrics.configure called multiple times. Using existing instance.');
+            return MostlyGoodMetrics.instance;
+        }
+        MostlyGoodMetrics.instance = new MostlyGoodMetrics(config);
+        return MostlyGoodMetrics.instance;
+    }
+    /**
+     * Get the shared instance, or null if not configured.
+     */
+    static get shared() {
+        return MostlyGoodMetrics.instance;
+    }
+    /**
+     * Check if the SDK has been configured.
+     */
+    static get isConfigured() {
+        return MostlyGoodMetrics.instance !== null;
+    }
+    /**
+     * Reset the SDK (primarily for testing).
+     */
+    static reset() {
+        if (MostlyGoodMetrics.instance) {
+            MostlyGoodMetrics.instance.destroy();
+            MostlyGoodMetrics.instance = null;
+        }
+    }
+    // ============================================================
+    // Static convenience methods (delegate to shared instance)
+    // ============================================================
+    /**
+     * Track an event with the given name and optional properties.
+     */
+    static track(name, properties) {
+        MostlyGoodMetrics.instance?.track(name, properties);
+    }
+    /**
+     * Identify the current user.
+     */
+    static identify(userId) {
+        MostlyGoodMetrics.instance?.identify(userId);
+    }
+    /**
+     * Reset user identity.
+     */
+    static resetIdentity() {
+        MostlyGoodMetrics.instance?.resetIdentity();
+    }
+    /**
+     * Flush pending events to the server.
+     */
+    static flush() {
+        return MostlyGoodMetrics.instance?.flush() ?? Promise.resolve();
+    }
+    /**
+     * Start a new session.
+     */
+    static startNewSession() {
+        MostlyGoodMetrics.instance?.startNewSession();
+    }
+    /**
+     * Clear all pending events.
+     */
+    static clearPendingEvents() {
+        return MostlyGoodMetrics.instance?.clearPendingEvents() ?? Promise.resolve();
+    }
+    /**
+     * Get the count of pending events.
+     */
+    static getPendingEventCount() {
+        return MostlyGoodMetrics.instance?.getPendingEventCount() ?? Promise.resolve(0);
+    }
+    // ============================================================
+    // Instance properties
+    // ============================================================
+    /**
+     * Get the current user ID.
+     */
+    get userId() {
+        return storage_1.persistence.getUserId();
+    }
+    /**
+     * Get the current session ID.
+     */
+    get sessionId() {
+        return this.sessionIdValue;
+    }
+    /**
+     * Check if a flush operation is in progress.
+     */
+    get isFlushing() {
+        return this.isFlushingInternal;
+    }
+    /**
+     * Get the resolved configuration.
+     */
+    get configuration() {
+        return { ...this.config };
+    }
+    // ============================================================
+    // Instance methods
+    // ============================================================
+    /**
+     * Track an event with the given name and optional properties.
+     */
+    track(name, properties) {
+        try {
+            (0, utils_1.validateEventName)(name);
+        }
+        catch (e) {
+            logger_1.logger.error(`Invalid event name: ${name}`, e);
+            return;
+        }
+        const sanitizedProperties = (0, utils_1.sanitizeProperties)(properties);
+        // Add system properties
+        const mergedProperties = {
+            [types_1.SystemProperties.DEVICE_TYPE]: (0, utils_1.detectDeviceType)(),
+            [types_1.SystemProperties.DEVICE_MODEL]: (0, utils_1.getDeviceModel)(),
+            ...sanitizedProperties,
+        };
+        const event = {
+            name,
+            timestamp: (0, utils_1.getISOTimestamp)(),
+            userId: this.userId ?? undefined,
+            sessionId: this.sessionIdValue,
+            platform: (0, utils_1.detectPlatform)(),
+            appVersion: this.config.appVersion || undefined,
+            osVersion: this.config.osVersion || (0, utils_1.getOSVersion)() || undefined,
+            environment: this.config.environment,
+            properties: Object.keys(mergedProperties).length > 0 ? mergedProperties : undefined,
+        };
+        logger_1.logger.debug(`Tracking event: ${name}`, event);
+        // Store event asynchronously
+        this.storage.store(event).catch((e) => {
+            logger_1.logger.error('Failed to store event', e);
+        });
+        // Check if we should flush due to batch size
+        void this.checkBatchSize();
+    }
+    /**
+     * Identify the current user.
+     */
+    identify(userId) {
+        if (!userId) {
+            logger_1.logger.warn('identify called with empty userId');
+            return;
+        }
+        logger_1.logger.debug(`Identifying user: ${userId}`);
+        storage_1.persistence.setUserId(userId);
+    }
+    /**
+     * Reset user identity.
+     */
+    resetIdentity() {
+        logger_1.logger.debug('Resetting user identity');
+        storage_1.persistence.setUserId(null);
+    }
+    /**
+     * Start a new session.
+     */
+    startNewSession() {
+        this.sessionIdValue = (0, utils_1.generateUUID)();
+        logger_1.logger.debug(`Started new session: ${this.sessionIdValue}`);
+    }
+    /**
+     * Flush pending events to the server.
+     */
+    async flush() {
+        if (this.isFlushingInternal) {
+            logger_1.logger.debug('Flush already in progress');
+            return;
+        }
+        this.isFlushingInternal = true;
+        logger_1.logger.debug('Starting flush');
+        try {
+            await this.performFlush();
+        }
+        finally {
+            this.isFlushingInternal = false;
+        }
+    }
+    /**
+     * Clear all pending events.
+     */
+    async clearPendingEvents() {
+        logger_1.logger.debug('Clearing all pending events');
+        await this.storage.clear();
+    }
+    /**
+     * Get the count of pending events.
+     */
+    async getPendingEventCount() {
+        return this.storage.eventCount();
+    }
+    /**
+     * Clean up resources (stop timers, etc.).
+     */
+    destroy() {
+        this.stopFlushTimer();
+        this.removeLifecycleListeners();
+        logger_1.logger.debug('MostlyGoodMetrics instance destroyed');
+    }
+    // ============================================================
+    // Private methods
+    // ============================================================
+    async checkBatchSize() {
+        const count = await this.storage.eventCount();
+        if (count >= this.config.maxBatchSize) {
+            logger_1.logger.debug('Batch size threshold reached, triggering flush');
+            void this.flush();
+        }
+    }
+    async performFlush() {
+        let hasMoreEvents = true;
+        while (hasMoreEvents) {
+            const eventCount = await this.storage.eventCount();
+            if (eventCount === 0) {
+                logger_1.logger.debug('No events to flush');
+                break;
+            }
+            // Check rate limiting
+            if (this.networkClient.isRateLimited()) {
+                logger_1.logger.debug('Rate limited, skipping flush');
+                break;
+            }
+            const events = await this.storage.fetchEvents(this.config.maxBatchSize);
+            if (events.length === 0) {
+                break;
+            }
+            const payload = this.buildPayload(events);
+            const result = await this.networkClient.sendEvents(payload, this.config);
+            if (result.success) {
+                logger_1.logger.debug(`Successfully sent ${events.length} events`);
+                await this.storage.removeEvents(events.length);
+            }
+            else {
+                logger_1.logger.warn(`Failed to send events: ${result.error.message}`);
+                if (!result.shouldRetry) {
+                    // Drop events on non-retryable errors (4xx)
+                    logger_1.logger.warn('Dropping events due to non-retryable error');
+                    await this.storage.removeEvents(events.length);
+                }
+                else {
+                    // Keep events for retry on retryable errors
+                    hasMoreEvents = false;
+                }
+            }
+            // Small delay between batches to avoid overwhelming the server
+            await (0, utils_1.delay)(FLUSH_DELAY_MS);
+        }
+    }
+    buildPayload(events) {
+        const context = {
+            platform: (0, utils_1.detectPlatform)(),
+            appVersion: this.config.appVersion || undefined,
+            osVersion: this.config.osVersion || (0, utils_1.getOSVersion)() || undefined,
+            userId: this.userId ?? undefined,
+            sessionId: this.sessionIdValue,
+            environment: this.config.environment,
+        };
+        return { events, context };
+    }
+    startFlushTimer() {
+        if (this.flushTimer) {
+            return;
+        }
+        this.flushTimer = setInterval(() => {
+            void this.flush();
+        }, this.config.flushInterval * 1000);
+        logger_1.logger.debug(`Started flush timer (${this.config.flushInterval}s interval)`);
+    }
+    stopFlushTimer() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+            logger_1.logger.debug('Stopped flush timer');
+        }
+    }
+    setupLifecycleTracking() {
+        if (this.lifecycleSetup) {
+            return;
+        }
+        if (typeof window === 'undefined' || typeof document === 'undefined') {
+            logger_1.logger.debug('Not in browser environment, skipping lifecycle tracking');
+            return;
+        }
+        this.lifecycleSetup = true;
+        // Track app installed/updated
+        this.trackInstallOrUpdate();
+        // Track app opened
+        this.trackAppOpened();
+        // Track visibility changes (background/foreground)
+        document.addEventListener('visibilitychange', this.handleVisibilityChange);
+        // Flush on page unload
+        window.addEventListener('beforeunload', this.handleBeforeUnload);
+        window.addEventListener('pagehide', this.handlePageHide);
+        logger_1.logger.debug('Lifecycle tracking enabled');
+    }
+    removeLifecycleListeners() {
+        if (typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.handleVisibilityChange);
+        }
+        if (typeof window !== 'undefined') {
+            window.removeEventListener('beforeunload', this.handleBeforeUnload);
+            window.removeEventListener('pagehide', this.handlePageHide);
+        }
+    }
+    trackInstallOrUpdate() {
+        const currentVersion = this.config.appVersion;
+        const previousVersion = storage_1.persistence.getAppVersion();
+        if (!currentVersion) {
+            // No version configured, skip install/update tracking
+            return;
+        }
+        if (storage_1.persistence.isFirstLaunch()) {
+            // First launch ever - track install
+            this.track(types_1.SystemEvents.APP_INSTALLED, {
+                [types_1.SystemProperties.VERSION]: currentVersion,
+            });
+            storage_1.persistence.setAppVersion(currentVersion);
+        }
+        else if (previousVersion && previousVersion !== currentVersion) {
+            // Version changed - track update
+            this.track(types_1.SystemEvents.APP_UPDATED, {
+                [types_1.SystemProperties.VERSION]: currentVersion,
+                [types_1.SystemProperties.PREVIOUS_VERSION]: previousVersion,
+            });
+            storage_1.persistence.setAppVersion(currentVersion);
+        }
+        else if (!previousVersion) {
+            // First time with version tracking
+            storage_1.persistence.setAppVersion(currentVersion);
+        }
+    }
+    trackAppOpened() {
+        this.track(types_1.SystemEvents.APP_OPENED);
+    }
+    flushWithBeacon() {
+        // Use sendBeacon for reliable delivery during page unload
+        if (typeof navigator === 'undefined' || !navigator.sendBeacon) {
+            return;
+        }
+        // Note: This is a synchronous, best-effort send
+        // We can't use async storage operations here, so we rely on
+        // the regular flush mechanism for most events
+        logger_1.logger.debug('Page unloading, attempting beacon flush');
+    }
+}
+exports.MostlyGoodMetrics = MostlyGoodMetrics;
+MostlyGoodMetrics.instance = null;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;;AAAA,qCAAmD;AACnD,uCAAuD;AACvD,uCAA8D;AAC9D,mCAWiB;AACjB,mCAWiB;AAEjB,MAAM,cAAc,GAAG,GAAG,CAAC,CAAC,4BAA4B;AAExD;;;GAGG;AACH,MAAa,iBAAiB;IAW5B;;OAEG;IACH,YAAoB,MAAwB;QARpC,eAAU,GAA0C,IAAI,CAAC;QACzD,uBAAkB,GAAG,KAAK,CAAC;QAE3B,mBAAc,GAAG,KAAK,CAAC;QAkbvB,2BAAsB,GAAG,GAAS,EAAE;YAC1C,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpB,mBAAmB;gBACnB,IAAI,CAAC,KAAK,CAAC,oBAAY,CAAC,gBAAgB,CAAC,CAAC;gBAC1C,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,iCAAiC;YACtD,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,IAAI,CAAC,KAAK,CAAC,oBAAY,CAAC,UAAU,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC;QAEM,uBAAkB,GAAG,GAAS,EAAE;YACtC,kDAAkD;YAClD,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC,CAAC;QAEM,mBAAc,GAAG,GAAS,EAAE;YAClC,kDAAkD;YAClD,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC,CAAC;QA/bA,IAAI,CAAC,MAAM,GAAG,IAAA,4BAAoB,EAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,cAAc,GAAG,IAAA,oBAAY,GAAE,CAAC;QAErC,iBAAiB;QACjB,IAAA,wBAAe,EAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAEhD,qBAAqB;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAA,8BAAoB,EAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAExF,4BAA4B;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,IAAA,oCAA0B,GAAE,CAAC;QAE/E,eAAM,CAAC,IAAI,CAAC,mDAAmD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAE1F,yBAAyB;QACzB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,4BAA4B;QAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;YACxC,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAwB;QACvC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC/B,eAAM,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;YAC3F,OAAO,iBAAiB,CAAC,QAAQ,CAAC;QACpC,CAAC;QAED,iBAAiB,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC3D,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,KAAK,MAAM;QACf,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,KAAK,YAAY;QACrB,OAAO,iBAAiB,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC/B,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAAC;QACpC,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,2DAA2D;IAC3D,+DAA+D;IAE/D;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,UAA4B;QACrD,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAc;QAC5B,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,OAAO,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB;QACvB,OAAO,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB;QACzB,OAAO,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IAED,+DAA+D;IAC/D,sBAAsB;IACtB,+DAA+D;IAE/D;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,qBAAW,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,mBAAmB;IACnB,+DAA+D;IAE/D;;OAEG;IACH,KAAK,CAAC,IAAY,EAAE,UAA4B;QAC9C,IAAI,CAAC;YACH,IAAA,yBAAiB,EAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,eAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,mBAAmB,GAAG,IAAA,0BAAkB,EAAC,UAAU,CAAC,CAAC;QAE3D,wBAAwB;QACxB,MAAM,gBAAgB,GAAoB;YACxC,CAAC,wBAAgB,CAAC,WAAW,CAAC,EAAE,IAAA,wBAAgB,GAAE;YAClD,CAAC,wBAAgB,CAAC,YAAY,CAAC,EAAE,IAAA,sBAAc,GAAE;YACjD,GAAG,mBAAmB;SACvB,CAAC;QAEF,MAAM,KAAK,GAAa;YACtB,IAAI;YACJ,SAAS,EAAE,IAAA,uBAAe,GAAE;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,QAAQ,EAAE,IAAA,sBAAc,GAAE;YAC1B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,SAAS;YAC/C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAA,oBAAY,GAAE,IAAI,SAAS;YAC/D,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACpC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;SACpF,CAAC;QAEF,eAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAE/C,6BAA6B;QAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,eAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,6CAA6C;QAC7C,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,eAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,eAAM,CAAC,KAAK,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC;QAC5C,qBAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,eAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACxC,qBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,cAAc,GAAG,IAAA,oBAAY,GAAE,CAAC;QACrC,eAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,eAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/B,eAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,eAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChC,eAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACvD,CAAC;IAED,+DAA+D;IAC/D,kBAAkB;IAClB,+DAA+D;IAEvD,KAAK,CAAC,cAAc;QAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACtC,eAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAC/D,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,OAAO,aAAa,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACnD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,eAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBACnC,MAAM;YACR,CAAC;YAED,sBAAsB;YACtB,IAAI,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,CAAC;gBACvC,eAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;gBAC7C,MAAM;YACR,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACxE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM;YACR,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAEzE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,eAAM,CAAC,KAAK,CAAC,qBAAqB,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;gBAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,eAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAE9D,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;oBACxB,4CAA4C;oBAC5C,eAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;oBAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACjD,CAAC;qBAAM,CAAC;oBACN,4CAA4C;oBAC5C,aAAa,GAAG,KAAK,CAAC;gBACxB,CAAC;YACH,CAAC;YAED,+DAA+D;YAC/D,MAAM,IAAA,aAAK,EAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAAkB;QACrC,MAAM,OAAO,GAAoB;YAC/B,QAAQ,EAAE,IAAA,sBAAc,GAAE;YAC1B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,SAAS;YAC/C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAA,oBAAY,GAAE,IAAI,SAAS;YAC/D,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;SACrC,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAEO,eAAe;QACrB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;QAErC,eAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,MAAM,CAAC,aAAa,aAAa,CAAC,CAAC;IAC/E,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,eAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAEO,sBAAsB;QAC5B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACrE,eAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAE3B,8BAA8B;QAC9B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5B,mBAAmB;QACnB,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,mDAAmD;QACnD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAE3E,uBAAuB;QACvB,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjE,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAEzD,eAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC7C,CAAC;IAEO,wBAAwB;QAC9B,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACpE,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAEO,oBAAoB;QAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAC9C,MAAM,eAAe,GAAG,qBAAW,CAAC,aAAa,EAAE,CAAC;QAEpD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,sDAAsD;YACtD,OAAO;QACT,CAAC;QAED,IAAI,qBAAW,CAAC,aAAa,EAAE,EAAE,CAAC;YAChC,oCAAoC;YACpC,IAAI,CAAC,KAAK,CAAC,oBAAY,CAAC,aAAa,EAAE;gBACrC,CAAC,wBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc;aAC3C,CAAC,CAAC;YACH,qBAAW,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,eAAe,IAAI,eAAe,KAAK,cAAc,EAAE,CAAC;YACjE,iCAAiC;YACjC,IAAI,CAAC,KAAK,CAAC,oBAAY,CAAC,WAAW,EAAE;gBACnC,CAAC,wBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc;gBAC1C,CAAC,wBAAgB,CAAC,gBAAgB,CAAC,EAAE,eAAe;aACrD,CAAC,CAAC;YACH,qBAAW,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5B,mCAAmC;YACnC,qBAAW,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,KAAK,CAAC,oBAAY,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAuBO,eAAe;QACrB,0DAA0D;QAC1D,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,gDAAgD;QAChD,4DAA4D;QAC5D,8CAA8C;QAC9C,eAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC1D,CAAC;;AA1dH,8CA2dC;AA1dgB,0BAAQ,GAA6B,IAAI,AAAjC,CAAkC"}

package/dist/cjs/index.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * MostlyGoodMetrics JavaScript SDK
+ *
+ * A lightweight, framework-agnostic analytics library for web applications.
+ *
+ * @example
+ * ```typescript
+ * import { MostlyGoodMetrics } from '@mostly-good-metrics/javascript';
+ *
+ * // Initialize the SDK
+ * MostlyGoodMetrics.configure({
+ *   apiKey: 'mgm_proj_your_api_key',
+ *   environment: 'production',
+ * });
+ *
+ * // Track events
+ * MostlyGoodMetrics.track('button_clicked', {
+ *   button_id: 'submit',
+ *   page: '/checkout',
+ * });
+ *
+ * // Identify users
+ * MostlyGoodMetrics.identify('user_123');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.getDeviceModel = exports.getOSVersion = exports.detectDeviceType = exports.detectPlatform = exports.sanitizeProperties = exports.validateEventName = exports.isValidEventName = exports.getISOTimestamp = exports.generateUUID = exports.createDefaultNetworkClient = exports.FetchNetworkClient = exports.createDefaultStorage = exports.LocalStorageEventStorage = exports.InMemoryEventStorage = exports.EVENT_NAME_REGEX = exports.Constraints = exports.DefaultConfiguration = exports.SystemProperties = exports.SystemEvents = exports.MGMError = exports.MostlyGoodMetrics = void 0;
+// Main client
+var client_1 = require("./client");
+Object.defineProperty(exports, "MostlyGoodMetrics", { enumerable: true, get: function () { return client_1.MostlyGoodMetrics; } });
+// Error class
+var types_1 = require("./types");
+Object.defineProperty(exports, "MGMError", { enumerable: true, get: function () { return types_1.MGMError; } });
+// Constants
+var types_2 = require("./types");
+Object.defineProperty(exports, "SystemEvents", { enumerable: true, get: function () { return types_2.SystemEvents; } });
+Object.defineProperty(exports, "SystemProperties", { enumerable: true, get: function () { return types_2.SystemProperties; } });
+Object.defineProperty(exports, "DefaultConfiguration", { enumerable: true, get: function () { return types_2.DefaultConfiguration; } });
+Object.defineProperty(exports, "Constraints", { enumerable: true, get: function () { return types_2.Constraints; } });
+Object.defineProperty(exports, "EVENT_NAME_REGEX", { enumerable: true, get: function () { return types_2.EVENT_NAME_REGEX; } });
+// Storage implementations (for custom storage adapters)
+var storage_1 = require("./storage");
+Object.defineProperty(exports, "InMemoryEventStorage", { enumerable: true, get: function () { return storage_1.InMemoryEventStorage; } });
+Object.defineProperty(exports, "LocalStorageEventStorage", { enumerable: true, get: function () { return storage_1.LocalStorageEventStorage; } });
+Object.defineProperty(exports, "createDefaultStorage", { enumerable: true, get: function () { return storage_1.createDefaultStorage; } });
+// Network client (for custom network implementations)
+var network_1 = require("./network");
+Object.defineProperty(exports, "FetchNetworkClient", { enumerable: true, get: function () { return network_1.FetchNetworkClient; } });
+Object.defineProperty(exports, "createDefaultNetworkClient", { enumerable: true, get: function () { return network_1.createDefaultNetworkClient; } });
+// Utilities (for advanced usage)
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "generateUUID", { enumerable: true, get: function () { return utils_1.generateUUID; } });
+Object.defineProperty(exports, "getISOTimestamp", { enumerable: true, get: function () { return utils_1.getISOTimestamp; } });
+Object.defineProperty(exports, "isValidEventName", { enumerable: true, get: function () { return utils_1.isValidEventName; } });
+Object.defineProperty(exports, "validateEventName", { enumerable: true, get: function () { return utils_1.validateEventName; } });
+Object.defineProperty(exports, "sanitizeProperties", { enumerable: true, get: function () { return utils_1.sanitizeProperties; } });
+Object.defineProperty(exports, "detectPlatform", { enumerable: true, get: function () { return utils_1.detectPlatform; } });
+Object.defineProperty(exports, "detectDeviceType", { enumerable: true, get: function () { return utils_1.detectDeviceType; } });
+Object.defineProperty(exports, "getOSVersion", { enumerable: true, get: function () { return utils_1.getOSVersion; } });
+Object.defineProperty(exports, "getDeviceModel", { enumerable: true, get: function () { return utils_1.getDeviceModel; } });
+// Logger (for debugging)
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAEH,cAAc;AACd,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA;AAmB1B,cAAc;AACd,iCAAmC;AAA1B,iGAAA,QAAQ,OAAA;AAEjB,YAAY;AACZ,iCAMiB;AALf,qGAAA,YAAY,OAAA;AACZ,yGAAA,gBAAgB,OAAA;AAChB,6GAAA,oBAAoB,OAAA;AACpB,oGAAA,WAAW,OAAA;AACX,yGAAA,gBAAgB,OAAA;AAGlB,wDAAwD;AACxD,qCAAiG;AAAxF,+GAAA,oBAAoB,OAAA;AAAE,mHAAA,wBAAwB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAE7E,sDAAsD;AACtD,qCAA2E;AAAlE,6GAAA,kBAAkB,OAAA;AAAE,qHAAA,0BAA0B,OAAA;AAEvD,iCAAiC;AACjC,iCAUiB;AATf,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,yGAAA,gBAAgB,OAAA;AAChB,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,uGAAA,cAAc,OAAA;AACd,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AAGhB,yBAAyB;AACzB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}

package/dist/cjs/logger.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Internal logger for the MostlyGoodMetrics SDK.
+ * Only outputs when debug logging is enabled.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.setDebugLogging = setDebugLogging;
+exports.isDebugEnabled = isDebugEnabled;
+exports.debug = debug;
+exports.info = info;
+exports.warn = warn;
+exports.error = error;
+const LOG_PREFIX = '[MostlyGoodMetrics]';
+let debugEnabled = false;
+/**
+ * Enable or disable debug logging.
+ */
+function setDebugLogging(enabled) {
+    debugEnabled = enabled;
+}
+/**
+ * Check if debug logging is enabled.
+ */
+function isDebugEnabled() {
+    return debugEnabled;
+}
+/**
+ * Log a debug message (only when debug logging is enabled).
+ */
+function debug(message, ...args) {
+    if (debugEnabled) {
+        console.log(`${LOG_PREFIX} [DEBUG]`, message, ...args);
+    }
+}
+/**
+ * Log an info message (only when debug logging is enabled).
+ */
+function info(message, ...args) {
+    if (debugEnabled) {
+        console.info(`${LOG_PREFIX} [INFO]`, message, ...args);
+    }
+}
+/**
+ * Log a warning message (always shown).
+ */
+function warn(message, ...args) {
+    console.warn(`${LOG_PREFIX} [WARN]`, message, ...args);
+}
+/**
+ * Log an error message (always shown).
+ */
+function error(message, ...args) {
+    console.error(`${LOG_PREFIX} [ERROR]`, message, ...args);
+}
+exports.logger = {
+    setDebugLogging,
+    isDebugEnabled,
+    debug,
+    info,
+    warn,
+    error,
+};
+//# sourceMappingURL=logger.js.map

package/dist/cjs/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AASH,0CAEC;AAKD,wCAEC;AAKD,sBAIC;AAKD,oBAIC;AAKD,oBAEC;AAKD,sBAEC;AAhDD,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAEzC,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB;;GAEG;AACH,SAAgB,eAAe,CAAC,OAAgB;IAC9C,YAAY,GAAG,OAAO,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IACvD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;IACtD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;IACtD,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IACvD,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAC3D,CAAC;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe;IACf,cAAc;IACd,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;CACN,CAAC"}