@cxpinsight/react-native 0.2.0

package/lib/core/deepLinkTracker.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDeepLinkTracking = startDeepLinkTracking;
+exports.stopDeepLinkTracking = stopDeepLinkTracking;
+exports.parseDeepLink = parseDeepLink;
+const react_native_1 = require("react-native");
+let callback = null;
+let subscription = null;
+let debugMode = false;
+function log(...args) {
+    if (debugMode)
+        console.log('[CXPinsight:DeepLink]', ...args);
+}
+/**
+ * Start tracking deep links (URL scheme + universal links).
+ * Checks the initial URL (cold start) and listens for incoming URLs (foreground).
+ */
+async function startDeepLinkTracking(onDeepLink, debug) {
+    debugMode = debug ?? false;
+    callback = onDeepLink;
+    // Check if app was opened via deep link (cold start)
+    try {
+        const initialUrl = await react_native_1.Linking.getInitialURL();
+        if (initialUrl) {
+            log('Cold start deep link:', initialUrl);
+            callback(initialUrl, 'cold_start');
+        }
+    }
+    catch (err) {
+        log('Failed to get initial URL:', err);
+    }
+    // Listen for deep links while app is running (foreground)
+    subscription?.remove();
+    subscription = react_native_1.Linking.addEventListener('url', (event) => {
+        if (event.url && callback) {
+            log('Foreground deep link:', event.url);
+            callback(event.url, 'foreground');
+        }
+    });
+}
+/** Stop tracking deep links */
+function stopDeepLinkTracking() {
+    subscription?.remove();
+    subscription = null;
+    callback = null;
+}
+/** Parse a deep link URL into components */
+function parseDeepLink(url) {
+    try {
+        const parsed = new URL(url);
+        const params = {};
+        parsed.searchParams.forEach((value, key) => {
+            params[key] = value;
+        });
+        return {
+            scheme: parsed.protocol.replace(':', ''),
+            host: parsed.host,
+            path: parsed.pathname,
+            params,
+        };
+    }
+    catch {
+        // Fallback for custom schemes like myapp://path
+        const schemeMatch = url.match(/^([^:]+):\/\/(.*)$/);
+        if (schemeMatch) {
+            const [, scheme, rest] = schemeMatch;
+            const [pathPart, queryPart] = rest.split('?');
+            const params = {};
+            if (queryPart) {
+                queryPart.split('&').forEach(pair => {
+                    const [key, value] = pair.split('=');
+                    if (key)
+                        params[decodeURIComponent(key)] = decodeURIComponent(value || '');
+                });
+            }
+            return { scheme, host: '', path: pathPart, params };
+        }
+        return { scheme: '', host: '', path: url, params: {} };
+    }
+}
+//# sourceMappingURL=deepLinkTracker.js.map

package/lib/core/deepLinkTracker.js.map

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

package/lib/core/deviceInfo.d.ts

@@ -0,0 +1,14 @@
+import type { DeviceInfo } from '../types';
+type PaletteMap = {
+    light?: Record<string, string>;
+    dark?: Record<string, string>;
+};
+export declare function setDeviceTheme(theme?: string): void;
+export declare function setDeviceBrandingPalette(pal?: PaletteMap, primary?: string): void;
+/** Collect device info from React Native APIs */
+export declare function getDeviceInfo(): DeviceInfo;
+export declare function canonicalDeviceContext(info: DeviceInfo): Record<string, unknown>;
+/** Clear cached info (useful on orientation change or reset) */
+export declare function clearDeviceInfoCache(): void;
+export {};
+//# sourceMappingURL=deviceInfo.d.ts.map

package/lib/core/deviceInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceInfo.d.ts","sourceRoot":"","sources":["../../src/core/deviceInfo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,KAAK,UAAU,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAMpF,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAGnD;AAOD,wBAAgB,wBAAwB,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAIjF;AAED,iDAAiD;AACjD,wBAAgB,aAAa,IAAI,UAAU,CAiF1C;AAQD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAahF;AAoBD,gEAAgE;AAChE,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/lib/core/deviceInfo.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setDeviceTheme = setDeviceTheme;
+exports.setDeviceBrandingPalette = setDeviceBrandingPalette;
+exports.getDeviceInfo = getDeviceInfo;
+exports.canonicalDeviceContext = canonicalDeviceContext;
+exports.clearDeviceInfoCache = clearDeviceInfoCache;
+const react_native_1 = require("react-native");
+let cachedInfo = null;
+// Host user's theme preference, supplied via CXPinsight.init({ theme }). Reported
+// as deviceInfo.theme → device.theme on the server. Set once at init.
+let configuredTheme;
+function setDeviceTheme(theme) {
+    configuredTheme = theme || undefined;
+    if (cachedInfo)
+        cachedInfo.theme = configuredTheme;
+}
+// The app's palette, supplied via CXPinsight.init({ brandingPalette: { light, dark } }).
+// Reported (resolved to the current theme mode) as deviceInfo.themePalette so the
+// dashboard's "Themes reported by SDK" panel can show real colours per (platform, theme).
+let configuredBrandingPalette;
+let configuredPrimary; // app's accent/brand colour
+function setDeviceBrandingPalette(pal, primary) {
+    configuredBrandingPalette = pal || undefined;
+    configuredPrimary = (primary && /^#[0-9a-f]{3,8}$/i.test(primary)) ? primary : undefined;
+    cachedInfo = null; // recompute so themePalette refreshes
+}
+/** Collect device info from React Native APIs */
+function getDeviceInfo() {
+    if (cachedInfo)
+        return cachedInfo;
+    const { width, height } = react_native_1.Dimensions.get('window');
+    const osName = react_native_1.Platform.OS === 'ios' ? 'iOS' : react_native_1.Platform.OS === 'android' ? 'Android' : react_native_1.Platform.OS;
+    const osVersion = typeof react_native_1.Platform.Version === 'number' ? String(react_native_1.Platform.Version) : react_native_1.Platform.Version;
+    // Attempt to read app version from expo-constants or expo-application if available
+    let appVersion = '1.0.0';
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const Constants = require('expo-constants').default;
+        appVersion = Constants.expoConfig?.version ?? Constants.manifest?.version ?? '1.0.0';
+    }
+    catch {
+        // Not available — use fallback
+    }
+    let language = 'en-US';
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { getLocales } = require('expo-localization');
+        const locales = getLocales();
+        if (locales?.[0]?.languageTag) {
+            language = locales[0].languageTag;
+        }
+    }
+    catch {
+        // Fallback — expo-localization not installed
+        if (react_native_1.Platform.OS === 'ios') {
+            // @ts-expect-error — RN internal
+            const settings = react_native_1.Platform.constants?.settings;
+            if (settings?.AppleLanguages?.[0]) {
+                language = settings.AppleLanguages[0];
+            }
+        }
+    }
+    // IANA timezone — same key/format as the web SDK's deviceInfo.timezone, so a
+    // `device.timezone` targeting condition resolves on both channels. RN Hermes
+    // ships Intl; guard for engines/builds without it.
+    let timezone;
+    try {
+        timezone = Intl?.DateTimeFormat?.().resolvedOptions?.().timeZone || undefined;
+    }
+    catch {
+        timezone = undefined;
+    }
+    // Resolve the app's palette for the current theme mode (+ accent), if the host
+    // passed either. Accent (primaryColor) is folded in under the `accent` key.
+    let themePalette;
+    if (configuredBrandingPalette || configuredPrimary) {
+        let mode = 'light';
+        const t = (configuredTheme || '').toLowerCase();
+        if (t === 'light' || t === 'dark')
+            mode = t;
+        else {
+            try {
+                mode = react_native_1.Appearance.getColorScheme() === 'dark' ? 'dark' : 'light';
+            }
+            catch { /* default light */ }
+        }
+        const surfaces = configuredBrandingPalette
+            ? (configuredBrandingPalette[mode] || configuredBrandingPalette.light || configuredBrandingPalette.dark || {})
+            : {};
+        const merged = { ...surfaces };
+        if (configuredPrimary)
+            merged.accent = configuredPrimary;
+        themePalette = Object.keys(merged).length ? merged : undefined;
+    }
+    const extras = deviceExtras();
+    cachedInfo = {
+        platform: 'mobile',
+        os: osName, // canonical key (matches web deviceInfo)
+        osVersion,
+        deviceType: extras.deviceType, // canonical: 'mobile' | 'tablet' | ...
+        // Object {width,height} to match web + the Event.deviceInfo schema (a string here
+        // causes a Mongoose CastError → the event is rejected).
+        screenResolution: { width: Math.round(width), height: Math.round(height) },
+        language,
+        timezone,
+        appVersion,
+        deviceModel: extras.deviceModel,
+        manufacturer: extras.manufacturer,
+        theme: configuredTheme, // host user's theme preference → device.theme
+        themePalette, // app's colours for the current theme → reported-themes panel
+    };
+    return cachedInfo;
+}
+// Raw deviceInfo → the canonical namespaced `device.*` values used for targeting.
+// The wire payload keeps raw keys (deviceType/deviceModel/manufacturer) — the server
+// remaps them — but the CLIENT-side targeting context must produce the SAME keys the
+// server does, or a condition matches in one tier and misses in the other. Keep this
+// mapping in lockstep with the server's eventAttributes() dmap in
+// services/engagement/src/lib/eventSignature.js.
+function canonicalDeviceContext(info) {
+    const out = {};
+    if (info.os)
+        out.os = info.os;
+    if (info.osVersion)
+        out.osVersion = info.osVersion;
+    if (info.deviceType)
+        out.type = String(info.deviceType).toLowerCase(); // → device.type
+    out.platform = info.platform ? String(info.platform).toLowerCase() : 'mobile'; // → device.platform
+    if (info.language)
+        out.language = String(info.language).toLowerCase();
+    if (info.timezone)
+        out.timezone = info.timezone;
+    if (info.deviceModel)
+        out.model = info.deviceModel; // → device.model
+    if (info.manufacturer)
+        out.brand = info.manufacturer; // → device.brand
+    if (info.appVersion)
+        out.appVersion = info.appVersion;
+    if (info.theme)
+        out.theme = String(info.theme); // → device.theme
+    return out;
+}
+/** Device model + type (best-effort via expo-device if the app installed it). */
+function deviceExtras() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const Device = require('expo-device');
+        // expo-device DeviceType enum: 1 phone, 2 tablet, 3 desktop, 4 tv. Map to the
+        // canonical Device.deviceType values ('mobile' | 'tablet' | 'desktop' | 'tv').
+        const dt = Device.deviceType;
+        return {
+            deviceModel: Device.modelName || undefined,
+            manufacturer: Device.manufacturer || undefined,
+            deviceType: dt === 1 ? 'mobile' : dt === 2 ? 'tablet' : dt === 3 ? 'desktop' : dt === 4 ? 'tv' : 'mobile',
+        };
+    }
+    catch {
+        return { deviceType: 'mobile' }; // expo-device not installed — sensible default
+    }
+}
+/** Clear cached info (useful on orientation change or reset) */
+function clearDeviceInfoCache() {
+    cachedInfo = null;
+}
+//# sourceMappingURL=deviceInfo.js.map

package/lib/core/deviceInfo.js.map

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

package/lib/core/eventQueue.d.ts

@@ -0,0 +1,23 @@
+import type { TrackEvent } from '../types';
+/** Start the event queue with optional config */
+export declare function startQueue(options?: {
+    flushInterval?: number;
+    flushThreshold?: number;
+    debug?: boolean;
+}): Promise<void>;
+/** Enqueue an event */
+export declare function enqueue(event: TrackEvent): void;
+/** Flush queued events to the server. */
+export declare function flush(): Promise<void>;
+/** Stop the queue and clean up */
+export declare function stopQueue(): Promise<void>;
+/** Clear queue without flushing */
+export declare function clearQueue(): Promise<void>;
+/** Queue diagnostics — used by tests and the debug command. */
+export declare function queueStats(): {
+    pending: number;
+    dropped: number;
+    consecutiveFailures: number;
+    backingOffFor: number;
+};
+//# sourceMappingURL=eventQueue.d.ts.map

package/lib/core/eventQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventQueue.d.ts","sourceRoot":"","sources":["../../src/core/eventQueue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAsE3C,iDAAiD;AACjD,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB;AAeD,uBAAuB;AACvB,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAY/C;AAED,yCAAyC;AACzC,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+C3C;AAED,kCAAkC;AAClC,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAU/C;AAED,mCAAmC;AACnC,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAShD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,IAAI;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,CAOA"}

package/lib/core/eventQueue.js

@@ -0,0 +1,240 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startQueue = startQueue;
+exports.enqueue = enqueue;
+exports.flush = flush;
+exports.stopQueue = stopQueue;
+exports.clearQueue = clearQueue;
+exports.queueStats = queueStats;
+const react_native_1 = require("react-native");
+const types_1 = require("../types");
+const storage = __importStar(require("./storage"));
+const network_1 = require("./network");
+const DEFAULT_FLUSH_INTERVAL = 30000; // 30s
+const DEFAULT_FLUSH_THRESHOLD = 10;
+const MAX_BATCH_SIZE = 100;
+// Upper bound on the backlog. MAX_BATCH_SIZE caps how many events go out in one
+// request; it does NOT cap how many pile up. Without this a long offline stretch
+// grows the queue until AsyncStorage or memory gives out — and every enqueue
+// re-serializes the whole thing, so the cost is quadratic on the way there.
+const MAX_QUEUE_SIZE = 1000;
+// Retry backoff. On failure the batch goes back on the queue, and the previous
+// implementation immediately called flush() again whenever the queue was at or
+// above the threshold — a tight recursive loop against a dead network that
+// drained the battery and the radio until the app was backgrounded.
+const RETRY_BASE_MS = 1000;
+const RETRY_MAX_MS = 5 * 60000; // 5 min ceiling
+// Writing the entire queue to AsyncStorage on every single event is O(n) per
+// event and hits the bridge each time. Coalesce writes into a short window
+// instead. Durability is preserved where it actually matters: the AppState
+// handler persists synchronously when the app leaves the foreground, which is
+// how a session normally ends. The exposure is events from the last <500ms
+// before an outright process kill from the foreground.
+const PERSIST_DEBOUNCE_MS = 500;
+let queue = [];
+let flushTimer = null;
+let persistTimer = null;
+let flushThreshold = DEFAULT_FLUSH_THRESHOLD;
+let isFlushing = false;
+let appStateSubscription = null;
+let debugMode = false;
+// Backoff state
+let consecutiveFailures = 0;
+let nextRetryAt = 0;
+let droppedCount = 0;
+function log(...args) {
+    if (debugMode)
+        console.log('[CXPinsight:Queue]', ...args);
+}
+/** Full-jitter exponential backoff, bounded. */
+function backoffDelay(failures) {
+    const ceiling = Math.min(RETRY_BASE_MS * 2 ** (failures - 1), RETRY_MAX_MS);
+    return Math.random() * ceiling;
+}
+function schedulePersist() {
+    if (persistTimer)
+        return;
+    persistTimer = setTimeout(() => {
+        persistTimer = null;
+        void storage.set(types_1.STORAGE_KEYS.EVENT_QUEUE, queue);
+    }, PERSIST_DEBOUNCE_MS);
+}
+/** Write the queue out now, cancelling any pending debounced write. */
+async function persistNow() {
+    if (persistTimer) {
+        clearTimeout(persistTimer);
+        persistTimer = null;
+    }
+    await storage.set(types_1.STORAGE_KEYS.EVENT_QUEUE, queue);
+}
+/** Start the event queue with optional config */
+async function startQueue(options) {
+    debugMode = options?.debug ?? false;
+    flushThreshold = options?.flushThreshold ?? DEFAULT_FLUSH_THRESHOLD;
+    const interval = options?.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
+    // Restore any persisted events from a previous session
+    const persisted = await storage.get(types_1.STORAGE_KEYS.EVENT_QUEUE);
+    if (persisted?.length) {
+        queue.push(...persisted);
+        trimToCap();
+        log(`Restored ${persisted.length} events from storage`);
+    }
+    consecutiveFailures = 0;
+    nextRetryAt = 0;
+    // Periodic flush
+    stopTimer();
+    flushTimer = setInterval(() => void flush(), interval);
+    // Flush on background
+    appStateSubscription?.remove();
+    appStateSubscription = react_native_1.AppState.addEventListener('change', handleAppState);
+}
+/**
+ * Drop from the FRONT when over the cap. The newest events are the ones a
+ * respondent's current session depends on (triggers, targeting, the survey they
+ * are about to be shown), so an old backlog is what gives way.
+ */
+function trimToCap() {
+    if (queue.length <= MAX_QUEUE_SIZE)
+        return;
+    const overflow = queue.length - MAX_QUEUE_SIZE;
+    queue.splice(0, overflow);
+    droppedCount += overflow;
+    log(`Queue over ${MAX_QUEUE_SIZE} — dropped ${overflow} oldest (${droppedCount} total)`);
+}
+/** Enqueue an event */
+function enqueue(event) {
+    queue.push(event);
+    trimToCap();
+    log(`Enqueued: ${event.eventName} (${queue.length} pending)`);
+    schedulePersist();
+    // Auto-flush at the threshold — but never while backing off, or the threshold
+    // itself becomes the retry loop.
+    if (queue.length >= flushThreshold && Date.now() >= nextRetryAt) {
+        void flush();
+    }
+}
+/** Flush queued events to the server. */
+async function flush() {
+    if (isFlushing || queue.length === 0)
+        return;
+    if (Date.now() < nextRetryAt) {
+        log(`Backing off — next attempt in ${Math.round((nextRetryAt - Date.now()) / 1000)}s`);
+        return;
+    }
+    isFlushing = true;
+    const eventsToSend = queue.splice(0, MAX_BATCH_SIZE);
+    log(`Flushing ${eventsToSend.length} events`);
+    let ok = false;
+    let error;
+    try {
+        const result = eventsToSend.length === 1
+            ? await (0, network_1.sdkFetch)('POST', '/api/engagement/events/track', eventsToSend[0])
+            : await (0, network_1.sdkFetch)('POST', '/api/engagement/events/track-batch', { events: eventsToSend });
+        ok = result.success;
+        error = result.error;
+    }
+    catch (err) {
+        ok = false;
+        error = err instanceof Error ? err.message : 'network error';
+    }
+    if (ok) {
+        consecutiveFailures = 0;
+        nextRetryAt = 0;
+        log(`Flush success: ${eventsToSend.length} events sent`);
+    }
+    else {
+        // Put the batch back at the front, preserving order, then back off.
+        queue.unshift(...eventsToSend);
+        trimToCap();
+        consecutiveFailures += 1;
+        const delay = backoffDelay(consecutiveFailures);
+        nextRetryAt = Date.now() + delay;
+        log(`Flush failed (${error ?? 'unknown'}) — attempt ${consecutiveFailures}, retrying in ${Math.round(delay)}ms`);
+    }
+    await persistNow();
+    isFlushing = false;
+    // Keep draining only while things are working. On failure the periodic timer
+    // is the retry mechanism, gated by nextRetryAt.
+    if (ok && queue.length >= flushThreshold) {
+        void flush();
+    }
+}
+/** Stop the queue and clean up */
+async function stopQueue() {
+    stopTimer();
+    appStateSubscription?.remove();
+    appStateSubscription = null;
+    await flush();
+    queue = [];
+    consecutiveFailures = 0;
+    nextRetryAt = 0;
+    await persistNow();
+    await storage.remove(types_1.STORAGE_KEYS.EVENT_QUEUE);
+}
+/** Clear queue without flushing */
+async function clearQueue() {
+    queue = [];
+    consecutiveFailures = 0;
+    nextRetryAt = 0;
+    if (persistTimer) {
+        clearTimeout(persistTimer);
+        persistTimer = null;
+    }
+    await storage.remove(types_1.STORAGE_KEYS.EVENT_QUEUE);
+}
+/** Queue diagnostics — used by tests and the debug command. */
+function queueStats() {
+    return {
+        pending: queue.length,
+        dropped: droppedCount,
+        consecutiveFailures,
+        backingOffFor: Math.max(0, nextRetryAt - Date.now()),
+    };
+}
+function stopTimer() {
+    if (flushTimer) {
+        clearInterval(flushTimer);
+        flushTimer = null;
+    }
+}
+function handleAppState(state) {
+    if (state === 'background' || state === 'inactive') {
+        // Leaving the foreground is how a session normally ends, so this is the
+        // durability point: persist unconditionally, then try to send.
+        void persistNow().then(() => flush());
+    }
+}
+//# sourceMappingURL=eventQueue.js.map

package/lib/core/eventQueue.js.map

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

package/lib/core/lifecycle.d.ts

@@ -0,0 +1,18 @@
+type LifecycleEventType = 'app_opened' | 'app_foregrounded' | 'app_backgrounded' | 'app_installed' | 'app_updated';
+interface LifecycleEvent {
+    type: LifecycleEventType;
+    data: Record<string, unknown>;
+}
+type LifecycleListener = (event: LifecycleEvent) => void;
+/**
+ * Start lifecycle tracking. Call once during SDK init.
+ * Emits app_opened, app_installed, app_updated immediately,
+ * then listens for foreground/background transitions.
+ */
+export declare function startLifecycleTracking(onEvent: LifecycleListener, debug?: boolean): Promise<void>;
+/** Stop lifecycle tracking */
+export declare function stopLifecycleTracking(): void;
+/** Increment the session event count (called by CXPinsight.track) */
+export declare function incrementEventCount(): void;
+export {};
+//# sourceMappingURL=lifecycle.d.ts.map

package/lib/core/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAOA,KAAK,kBAAkB,GACnB,YAAY,GACZ,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,aAAa,CAAC;AAElB,UAAU,cAAc;IACtB,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAYzD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,iBAAiB,EAC1B,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,8BAA8B;AAC9B,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}