@mostly-good-metrics/javascript 0.1.0

package/dist/cjs/utils.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUUID = generateUUID;
+exports.getISOTimestamp = getISOTimestamp;
+exports.isValidEventName = isValidEventName;
+exports.validateEventName = validateEventName;
+exports.sanitizeProperties = sanitizeProperties;
+exports.resolveConfiguration = resolveConfiguration;
+exports.detectPlatform = detectPlatform;
+exports.detectDeviceType = detectDeviceType;
+exports.getOSVersion = getOSVersion;
+exports.getDeviceModel = getDeviceModel;
+exports.delay = delay;
+const logger_1 = require("./logger");
+const types_1 = require("./types");
+/**
+ * Generate a UUID v4 string.
+ */
+function generateUUID() {
+    // Use crypto.randomUUID if available (modern browsers and Node.js 19+)
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    // Fallback implementation
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Get the current timestamp in ISO8601 format.
+ */
+function getISOTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Validate an event name.
+ * Must match pattern: ^$?[a-zA-Z][a-zA-Z0-9_]*$
+ * Max 255 characters.
+ */
+function isValidEventName(name) {
+    if (!name || name.length > types_1.Constraints.MAX_EVENT_NAME_LENGTH) {
+        return false;
+    }
+    return types_1.EVENT_NAME_REGEX.test(name);
+}
+/**
+ * Validate an event name and throw if invalid.
+ */
+function validateEventName(name) {
+    if (!name) {
+        throw new types_1.MGMError('INVALID_EVENT_NAME', 'Event name is required');
+    }
+    if (name.length > types_1.Constraints.MAX_EVENT_NAME_LENGTH) {
+        throw new types_1.MGMError('INVALID_EVENT_NAME', `Event name must be ${types_1.Constraints.MAX_EVENT_NAME_LENGTH} characters or less`);
+    }
+    if (!types_1.EVENT_NAME_REGEX.test(name)) {
+        throw new types_1.MGMError('INVALID_EVENT_NAME', 'Event name must start with a letter (or $ for system events) and contain only alphanumeric characters and underscores');
+    }
+}
+/**
+ * Sanitize event properties by truncating strings and limiting depth.
+ */
+function sanitizeProperties(properties, maxDepth = types_1.Constraints.MAX_PROPERTY_DEPTH) {
+    if (!properties || typeof properties !== 'object') {
+        return undefined;
+    }
+    const sanitized = sanitizeValue(properties, 0, maxDepth);
+    if (typeof sanitized === 'object' && sanitized !== null && !Array.isArray(sanitized)) {
+        return sanitized;
+    }
+    return undefined;
+}
+/**
+ * Recursively sanitize a property value.
+ */
+function sanitizeValue(value, depth, maxDepth) {
+    // Null is valid
+    if (value === null) {
+        return null;
+    }
+    // Primitives
+    if (typeof value === 'boolean' || typeof value === 'number') {
+        return value;
+    }
+    // Strings - truncate if needed
+    if (typeof value === 'string') {
+        if (value.length > types_1.Constraints.MAX_STRING_PROPERTY_LENGTH) {
+            logger_1.logger.debug(`Truncating string property from ${value.length} to ${types_1.Constraints.MAX_STRING_PROPERTY_LENGTH} characters`);
+            return value.substring(0, types_1.Constraints.MAX_STRING_PROPERTY_LENGTH);
+        }
+        return value;
+    }
+    // Arrays
+    if (Array.isArray(value)) {
+        if (depth >= maxDepth) {
+            logger_1.logger.debug(`Max property depth reached, omitting nested array`);
+            return null;
+        }
+        return value.map((item) => sanitizeValue(item, depth + 1, maxDepth));
+    }
+    // Objects
+    if (typeof value === 'object') {
+        if (depth >= maxDepth) {
+            logger_1.logger.debug(`Max property depth reached, omitting nested object`);
+            return null;
+        }
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            result[key] = sanitizeValue(val, depth + 1, maxDepth);
+        }
+        return result;
+    }
+    // Unknown type - convert to null
+    return null;
+}
+/**
+ * Resolve configuration with defaults.
+ */
+function resolveConfiguration(config) {
+    const maxBatchSize = Math.min(Math.max(config.maxBatchSize ?? types_1.DefaultConfiguration.maxBatchSize, types_1.Constraints.MIN_BATCH_SIZE), types_1.Constraints.MAX_BATCH_SIZE);
+    const flushInterval = Math.max(config.flushInterval ?? types_1.DefaultConfiguration.flushInterval, types_1.Constraints.MIN_FLUSH_INTERVAL);
+    const maxStoredEvents = Math.max(config.maxStoredEvents ?? types_1.DefaultConfiguration.maxStoredEvents, types_1.Constraints.MIN_STORED_EVENTS);
+    return {
+        apiKey: config.apiKey,
+        baseURL: config.baseURL ?? types_1.DefaultConfiguration.baseURL,
+        environment: config.environment ?? types_1.DefaultConfiguration.environment,
+        maxBatchSize,
+        flushInterval,
+        maxStoredEvents,
+        enableDebugLogging: config.enableDebugLogging ?? types_1.DefaultConfiguration.enableDebugLogging,
+        trackAppLifecycleEvents: config.trackAppLifecycleEvents ?? types_1.DefaultConfiguration.trackAppLifecycleEvents,
+        bundleId: config.bundleId ?? detectBundleId(),
+        appVersion: config.appVersion ?? '',
+        osVersion: config.osVersion ?? '',
+        storage: config.storage,
+        networkClient: config.networkClient,
+    };
+}
+/**
+ * Detect the bundle ID from the current environment.
+ */
+function detectBundleId() {
+    // In browser, use the hostname
+    if (typeof window !== 'undefined' && window.location) {
+        return window.location.hostname;
+    }
+    // In Node.js, could use package.json name but that requires fs access
+    return '';
+}
+/**
+ * Detect the current platform.
+ */
+function detectPlatform() {
+    // Check for React Native / Expo
+    if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+        // Could check for Expo-specific globals here
+        return 'react-native';
+    }
+    // Check for Node.js
+    if (typeof process !== 'undefined' && process.versions?.node) {
+        return 'node';
+    }
+    // Default to web for browser environments
+    return 'web';
+}
+/**
+ * Detect the device type from user agent.
+ */
+function detectDeviceType() {
+    if (typeof navigator === 'undefined' || !navigator.userAgent) {
+        return 'unknown';
+    }
+    const ua = navigator.userAgent.toLowerCase();
+    // Check for specific device types
+    if (/tablet|ipad|playbook|silk/i.test(ua)) {
+        return 'tablet';
+    }
+    if (/mobile|iphone|ipod|android.*mobile|blackberry|opera mini|opera mobi/i.test(ua)) {
+        return 'phone';
+    }
+    if (/smart-tv|smarttv|googletv|appletv|hbbtv|pov_tv|netcast.tv/i.test(ua)) {
+        return 'tv';
+    }
+    // Default to desktop for other browsers
+    if (typeof window !== 'undefined') {
+        return 'desktop';
+    }
+    return 'unknown';
+}
+/**
+ * Get the OS version string.
+ */
+function getOSVersion() {
+    if (typeof navigator === 'undefined' || !navigator.userAgent) {
+        return '';
+    }
+    const ua = navigator.userAgent;
+    // Try to extract OS version from user agent
+    const patterns = [
+        [/Windows NT ([\d.]+)/i, 'Windows'],
+        [/Mac OS X ([\d_.]+)/i, 'macOS'],
+        [/iPhone OS ([\d_]+)/i, 'iOS'],
+        [/iPad.*OS ([\d_]+)/i, 'iPadOS'],
+        [/Android ([\d.]+)/i, 'Android'],
+        [/Linux/i, 'Linux'],
+    ];
+    for (const [pattern, osName] of patterns) {
+        const match = ua.match(pattern);
+        if (match) {
+            const version = match[1]?.replace(/_/g, '.') ?? '';
+            return version ? `${osName} ${version}` : osName;
+        }
+    }
+    return '';
+}
+/**
+ * Get the browser/device model.
+ */
+function getDeviceModel() {
+    if (typeof navigator === 'undefined' || !navigator.userAgent) {
+        return '';
+    }
+    const ua = navigator.userAgent;
+    // Try to extract browser name and version
+    const patterns = [
+        [/Chrome\/([\d.]+)/i, 'Chrome'],
+        [/Firefox\/([\d.]+)/i, 'Firefox'],
+        [/Safari\/([\d.]+)/i, 'Safari'],
+        [/Edge\/([\d.]+)/i, 'Edge'],
+        [/MSIE ([\d.]+)/i, 'IE'],
+        [/Trident.*rv:([\d.]+)/i, 'IE'],
+    ];
+    for (const [pattern, browserName] of patterns) {
+        const match = ua.match(pattern);
+        if (match) {
+            return `${browserName} ${match[1]}`;
+        }
+    }
+    return '';
+}
+/**
+ * Delay execution for a specified number of milliseconds.
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=utils.js.map

package/dist/cjs/utils.js.map

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

package/dist/esm/client.js

@@ -0,0 +1,412 @@
+import { logger, setDebugLogging } from './logger';
+import { createDefaultNetworkClient } from './network';
+import { createDefaultStorage, persistence } from './storage';
+import { SystemEvents, SystemProperties, } from './types';
+import { delay, detectDeviceType, detectPlatform, generateUUID, getDeviceModel, getISOTimestamp, getOSVersion, resolveConfiguration, sanitizeProperties, validateEventName, } from './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.
+ */
+export 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(SystemEvents.APP_BACKGROUNDED);
+                void this.flush(); // Flush when going to background
+            }
+            else {
+                // App foregrounded
+                this.track(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 = resolveConfiguration(config);
+        this.sessionIdValue = generateUUID();
+        // Set up logging
+        setDebugLogging(this.config.enableDebugLogging);
+        // Initialize storage
+        this.storage = this.config.storage ?? createDefaultStorage(this.config.maxStoredEvents);
+        // Initialize network client
+        this.networkClient = this.config.networkClient ?? createDefaultNetworkClient();
+        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.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 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 {
+            validateEventName(name);
+        }
+        catch (e) {
+            logger.error(`Invalid event name: ${name}`, e);
+            return;
+        }
+        const sanitizedProperties = sanitizeProperties(properties);
+        // Add system properties
+        const mergedProperties = {
+            [SystemProperties.DEVICE_TYPE]: detectDeviceType(),
+            [SystemProperties.DEVICE_MODEL]: getDeviceModel(),
+            ...sanitizedProperties,
+        };
+        const event = {
+            name,
+            timestamp: getISOTimestamp(),
+            userId: this.userId ?? undefined,
+            sessionId: this.sessionIdValue,
+            platform: detectPlatform(),
+            appVersion: this.config.appVersion || undefined,
+            osVersion: this.config.osVersion || getOSVersion() || undefined,
+            environment: this.config.environment,
+            properties: Object.keys(mergedProperties).length > 0 ? mergedProperties : undefined,
+        };
+        logger.debug(`Tracking event: ${name}`, event);
+        // Store event asynchronously
+        this.storage.store(event).catch((e) => {
+            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.warn('identify called with empty userId');
+            return;
+        }
+        logger.debug(`Identifying user: ${userId}`);
+        persistence.setUserId(userId);
+    }
+    /**
+     * Reset user identity.
+     */
+    resetIdentity() {
+        logger.debug('Resetting user identity');
+        persistence.setUserId(null);
+    }
+    /**
+     * Start a new session.
+     */
+    startNewSession() {
+        this.sessionIdValue = generateUUID();
+        logger.debug(`Started new session: ${this.sessionIdValue}`);
+    }
+    /**
+     * Flush pending events to the server.
+     */
+    async flush() {
+        if (this.isFlushingInternal) {
+            logger.debug('Flush already in progress');
+            return;
+        }
+        this.isFlushingInternal = true;
+        logger.debug('Starting flush');
+        try {
+            await this.performFlush();
+        }
+        finally {
+            this.isFlushingInternal = false;
+        }
+    }
+    /**
+     * Clear all pending events.
+     */
+    async clearPendingEvents() {
+        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.debug('MostlyGoodMetrics instance destroyed');
+    }
+    // ============================================================
+    // Private methods
+    // ============================================================
+    async checkBatchSize() {
+        const count = await this.storage.eventCount();
+        if (count >= this.config.maxBatchSize) {
+            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.debug('No events to flush');
+                break;
+            }
+            // Check rate limiting
+            if (this.networkClient.isRateLimited()) {
+                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.debug(`Successfully sent ${events.length} events`);
+                await this.storage.removeEvents(events.length);
+            }
+            else {
+                logger.warn(`Failed to send events: ${result.error.message}`);
+                if (!result.shouldRetry) {
+                    // Drop events on non-retryable errors (4xx)
+                    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 delay(FLUSH_DELAY_MS);
+        }
+    }
+    buildPayload(events) {
+        const context = {
+            platform: detectPlatform(),
+            appVersion: this.config.appVersion || undefined,
+            osVersion: this.config.osVersion || 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.debug(`Started flush timer (${this.config.flushInterval}s interval)`);
+    }
+    stopFlushTimer() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+            logger.debug('Stopped flush timer');
+        }
+    }
+    setupLifecycleTracking() {
+        if (this.lifecycleSetup) {
+            return;
+        }
+        if (typeof window === 'undefined' || typeof document === 'undefined') {
+            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.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 = persistence.getAppVersion();
+        if (!currentVersion) {
+            // No version configured, skip install/update tracking
+            return;
+        }
+        if (persistence.isFirstLaunch()) {
+            // First launch ever - track install
+            this.track(SystemEvents.APP_INSTALLED, {
+                [SystemProperties.VERSION]: currentVersion,
+            });
+            persistence.setAppVersion(currentVersion);
+        }
+        else if (previousVersion && previousVersion !== currentVersion) {
+            // Version changed - track update
+            this.track(SystemEvents.APP_UPDATED, {
+                [SystemProperties.VERSION]: currentVersion,
+                [SystemProperties.PREVIOUS_VERSION]: previousVersion,
+            });
+            persistence.setAppVersion(currentVersion);
+        }
+        else if (!previousVersion) {
+            // First time with version tracking
+            persistence.setAppVersion(currentVersion);
+        }
+    }
+    trackAppOpened() {
+        this.track(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.debug('Page unloading, attempting beacon flush');
+    }
+}
+MostlyGoodMetrics.instance = null;
+//# sourceMappingURL=client.js.map