@apex-inc/capacitor-plugin 0.1.0

package/dist/offline-queue.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Offline event queue with durable storage and FIFO eviction.
+ *
+ * Every event tracked through the plugin gets enqueued here first. A batch
+ * sender drains the queue in the background (`batch-sender.ts`). When the
+ * user is offline (flights, subways, dead zones), events accumulate safely
+ * up to `maxSize`; the oldest events are dropped rather than crashing the
+ * app or silently failing.
+ *
+ * Pluggable `Storage` interface supports three implementations:
+ *   - `InMemoryStorage` — used in tests and as the default for SSR/Node
+ *   - `IndexedDBStorage` — used in browser + Capacitor WebView contexts
+ *   - `NativeBridgeStorage` — used when Capacitor native plugin is active
+ *     (persists through the native OfflineQueue on iOS Core Data / Android Room)
+ *
+ * This keeps the queue logic pure (no DOM/Native API dependencies in the
+ * algorithmic core), which makes testing trivial.
+ */
+import type { ApexEvent } from "./definitions";
+/** A single queued event ready for delivery to the server. */
+export interface QueuedEvent {
+    event: ApexEvent;
+    /** Attempt count so the batch sender can apply exponential backoff. */
+    attempts: number;
+    /** ISO timestamp when enqueued. Used for queue-age metrics + eviction. */
+    enqueuedAt: string;
+}
+/**
+ * Storage backend for the offline queue. Implementations persist events
+ * across app restarts and may be synchronous (in-memory) or asynchronous
+ * (IndexedDB, native bridge).
+ */
+export interface OfflineQueueStorage {
+    /** Read all queued events in insertion order. */
+    readAll(): Promise<QueuedEvent[]>;
+    /** Append one event to the queue. */
+    append(event: QueuedEvent): Promise<void>;
+    /** Replace the entire queue contents (used for flush + eviction). */
+    replaceAll(events: QueuedEvent[]): Promise<void>;
+    /** Remove all events matching the given event IDs. */
+    removeByIds(eventIds: string[]): Promise<void>;
+    /** Number of events currently persisted. */
+    size(): Promise<number>;
+    /** Best-effort clear — used on test mode toggle + uninstall cleanup. */
+    clear(): Promise<void>;
+}
+/** Options for {@link OfflineQueue}. */
+export interface OfflineQueueOptions {
+    storage: OfflineQueueStorage;
+    /** Maximum events to hold before FIFO eviction. Default 1000. */
+    maxSize?: number;
+    /** Called when an event is evicted due to queue overflow. */
+    onEvicted?: (event: QueuedEvent) => void;
+}
+export declare class OfflineQueue {
+    private readonly storage;
+    private readonly maxSize;
+    private readonly onEvicted?;
+    constructor(options: OfflineQueueOptions);
+    /**
+     * Enqueue an event. If the queue is at `maxSize`, the oldest event is
+     * evicted first (FIFO) so the new event can be recorded.
+     */
+    enqueue(event: ApexEvent): Promise<void>;
+    /** Enqueue many events in a single storage write. */
+    enqueueMany(events: ApexEvent[]): Promise<void>;
+    /** Read the next batch of events without removing them from the queue. */
+    peek(batchSize: number): Promise<QueuedEvent[]>;
+    /** Mark events as successfully delivered and remove them from the queue. */
+    markSent(eventIds: string[]): Promise<void>;
+    /** Increment attempt count for events that failed to send (for backoff). */
+    markFailed(eventIds: string[]): Promise<void>;
+    /** Current queue size. */
+    size(): Promise<number>;
+    /** ISO timestamp of the oldest queued event, or null if queue is empty. */
+    oldestEventAt(): Promise<string | null>;
+    /** Empty the queue. Typically called when toggling test mode. */
+    clear(): Promise<void>;
+}
+/**
+ * In-memory storage. Used in tests and as a fallback where neither IndexedDB
+ * nor the native bridge is available (e.g. SSR contexts).
+ */
+export declare class InMemoryStorage implements OfflineQueueStorage {
+    private events;
+    readAll(): Promise<QueuedEvent[]>;
+    append(event: QueuedEvent): Promise<void>;
+    replaceAll(events: QueuedEvent[]): Promise<void>;
+    removeByIds(eventIds: string[]): Promise<void>;
+    size(): Promise<number>;
+    clear(): Promise<void>;
+}
+/**
+ * IndexedDB-backed storage for browser + Capacitor WebView contexts.
+ * Persists events across app restarts using a single object store keyed by
+ * event ID.
+ */
+export declare class IndexedDBStorage implements OfflineQueueStorage {
+    private readonly dbName;
+    private readonly storeName;
+    private dbPromise?;
+    constructor(dbName?: string, storeName?: string);
+    private openDb;
+    readAll(): Promise<QueuedEvent[]>;
+    append(event: QueuedEvent): Promise<void>;
+    replaceAll(events: QueuedEvent[]): Promise<void>;
+    removeByIds(eventIds: string[]): Promise<void>;
+    size(): Promise<number>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=offline-queue.d.ts.map

package/dist/offline-queue.d.ts.map

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

package/dist/offline-queue.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Offline event queue with durable storage and FIFO eviction.
+ *
+ * Every event tracked through the plugin gets enqueued here first. A batch
+ * sender drains the queue in the background (`batch-sender.ts`). When the
+ * user is offline (flights, subways, dead zones), events accumulate safely
+ * up to `maxSize`; the oldest events are dropped rather than crashing the
+ * app or silently failing.
+ *
+ * Pluggable `Storage` interface supports three implementations:
+ *   - `InMemoryStorage` — used in tests and as the default for SSR/Node
+ *   - `IndexedDBStorage` — used in browser + Capacitor WebView contexts
+ *   - `NativeBridgeStorage` — used when Capacitor native plugin is active
+ *     (persists through the native OfflineQueue on iOS Core Data / Android Room)
+ *
+ * This keeps the queue logic pure (no DOM/Native API dependencies in the
+ * algorithmic core), which makes testing trivial.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexedDBStorage = exports.InMemoryStorage = exports.OfflineQueue = void 0;
+class OfflineQueue {
+    constructor(options) {
+        this.storage = options.storage;
+        this.maxSize = options.maxSize ?? 1000;
+        this.onEvicted = options.onEvicted;
+        if (this.maxSize < 1) {
+            throw new Error(`OfflineQueue maxSize must be >= 1, got ${this.maxSize}`);
+        }
+    }
+    /**
+     * Enqueue an event. If the queue is at `maxSize`, the oldest event is
+     * evicted first (FIFO) so the new event can be recorded.
+     */
+    async enqueue(event) {
+        if (!event.id) {
+            throw new Error("OfflineQueue.enqueue: event.id is required (set via event-id.generateEventId)");
+        }
+        const existing = await this.storage.readAll();
+        const queued = {
+            event,
+            attempts: 0,
+            enqueuedAt: new Date().toISOString(),
+        };
+        const next = [...existing, queued];
+        if (next.length > this.maxSize) {
+            const overflow = next.splice(0, next.length - this.maxSize);
+            if (this.onEvicted) {
+                for (const ev of overflow) {
+                    this.onEvicted(ev);
+                }
+            }
+        }
+        await this.storage.replaceAll(next);
+    }
+    /** Enqueue many events in a single storage write. */
+    async enqueueMany(events) {
+        if (events.length === 0)
+            return;
+        const existing = await this.storage.readAll();
+        const now = new Date().toISOString();
+        const queued = events.map((event) => {
+            if (!event.id) {
+                throw new Error("OfflineQueue.enqueueMany: every event must have an id");
+            }
+            return { event, attempts: 0, enqueuedAt: now };
+        });
+        const next = [...existing, ...queued];
+        if (next.length > this.maxSize) {
+            const overflow = next.splice(0, next.length - this.maxSize);
+            if (this.onEvicted) {
+                for (const ev of overflow) {
+                    this.onEvicted(ev);
+                }
+            }
+        }
+        await this.storage.replaceAll(next);
+    }
+    /** Read the next batch of events without removing them from the queue. */
+    async peek(batchSize) {
+        if (batchSize < 1)
+            return [];
+        const all = await this.storage.readAll();
+        return all.slice(0, batchSize);
+    }
+    /** Mark events as successfully delivered and remove them from the queue. */
+    async markSent(eventIds) {
+        if (eventIds.length === 0)
+            return;
+        await this.storage.removeByIds(eventIds);
+    }
+    /** Increment attempt count for events that failed to send (for backoff). */
+    async markFailed(eventIds) {
+        if (eventIds.length === 0)
+            return;
+        const idSet = new Set(eventIds);
+        const all = await this.storage.readAll();
+        const next = all.map((q) => q.event.id && idSet.has(q.event.id) ? { ...q, attempts: q.attempts + 1 } : q);
+        await this.storage.replaceAll(next);
+    }
+    /** Current queue size. */
+    async size() {
+        return this.storage.size();
+    }
+    /** ISO timestamp of the oldest queued event, or null if queue is empty. */
+    async oldestEventAt() {
+        const all = await this.storage.readAll();
+        return all.length > 0 ? all[0].enqueuedAt : null;
+    }
+    /** Empty the queue. Typically called when toggling test mode. */
+    async clear() {
+        await this.storage.clear();
+    }
+}
+exports.OfflineQueue = OfflineQueue;
+// ── Storage implementations ────────────────────────────────────────────────
+/**
+ * In-memory storage. Used in tests and as a fallback where neither IndexedDB
+ * nor the native bridge is available (e.g. SSR contexts).
+ */
+class InMemoryStorage {
+    constructor() {
+        this.events = [];
+    }
+    async readAll() {
+        return [...this.events];
+    }
+    async append(event) {
+        this.events.push(event);
+    }
+    async replaceAll(events) {
+        this.events = [...events];
+    }
+    async removeByIds(eventIds) {
+        const idSet = new Set(eventIds);
+        this.events = this.events.filter((q) => !q.event.id || !idSet.has(q.event.id));
+    }
+    async size() {
+        return this.events.length;
+    }
+    async clear() {
+        this.events = [];
+    }
+}
+exports.InMemoryStorage = InMemoryStorage;
+/**
+ * IndexedDB-backed storage for browser + Capacitor WebView contexts.
+ * Persists events across app restarts using a single object store keyed by
+ * event ID.
+ */
+class IndexedDBStorage {
+    constructor(dbName = "apex-capacitor-queue", storeName = "events") {
+        this.dbName = dbName;
+        this.storeName = storeName;
+    }
+    async openDb() {
+        if (this.dbPromise)
+            return this.dbPromise;
+        const db = await new Promise((resolve, reject) => {
+            const idb = globalThis.indexedDB;
+            if (!idb) {
+                reject(new Error("IndexedDB not available in this environment"));
+                return;
+            }
+            const req = idb.open(this.dbName, 1);
+            req.onupgradeneeded = () => {
+                const database = req.result;
+                if (!database.objectStoreNames.contains(this.storeName)) {
+                    database.createObjectStore(this.storeName, { keyPath: "key", autoIncrement: true });
+                }
+            };
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+        });
+        this.dbPromise = Promise.resolve(db);
+        return db;
+    }
+    async readAll() {
+        const db = await this.openDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readonly");
+            const store = tx.objectStore(this.storeName);
+            const req = store.getAll();
+            req.onsuccess = () => {
+                const rows = req.result ?? [];
+                // Strip internal autoIncrement key for caller.
+                resolve(rows
+                    .sort((a, b) => (a.key ?? 0) - (b.key ?? 0))
+                    .map(({ key: _k, ...rest }) => rest));
+            };
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async append(event) {
+        const db = await this.openDb();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readwrite");
+            const store = tx.objectStore(this.storeName);
+            store.add(event);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async replaceAll(events) {
+        const db = await this.openDb();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readwrite");
+            const store = tx.objectStore(this.storeName);
+            store.clear();
+            for (const ev of events) {
+                store.add(ev);
+            }
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async removeByIds(eventIds) {
+        if (eventIds.length === 0)
+            return;
+        const idSet = new Set(eventIds);
+        const all = await this.readAll();
+        const kept = all.filter((q) => !q.event.id || !idSet.has(q.event.id));
+        await this.replaceAll(kept);
+    }
+    async size() {
+        const db = await this.openDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readonly");
+            const store = tx.objectStore(this.storeName);
+            const req = store.count();
+            req.onsuccess = () => resolve(req.result ?? 0);
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async clear() {
+        const db = await this.openDb();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(this.storeName, "readwrite");
+            tx.objectStore(this.storeName).clear();
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+}
+exports.IndexedDBStorage = IndexedDBStorage;
+//# sourceMappingURL=offline-queue.js.map

package/dist/offline-queue.js.map

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

package/dist/session-manager.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Mobile session manager.
+ *
+ * Defines the boundaries of a user's interaction with the app. A session
+ * starts on the first event after inactivity and ends when either
+ *   (a) no events arrive for `timeoutMinutes` (default 30), or
+ *   (b) the app is force-backgrounded and the OS reclaims memory.
+ *
+ * Emits `session_start` and `session_end` events that plug directly into the
+ * server's MSESSION# rollup (Phase 1c). The timeout is configurable and the
+ * clock is injectable for deterministic testing.
+ */
+export interface SessionSnapshot {
+    sessionId: string;
+    startedAt: string;
+    lastActivityAt: string;
+    eventCount: number;
+    endedAt?: string;
+    durationSeconds?: number;
+}
+export interface SessionManagerOptions {
+    /** Inactivity window after which a session ends. Default 30 minutes. */
+    timeoutMinutes?: number;
+    /** Called when a new session starts (emits `session_start` server-side). */
+    onSessionStart?: (session: SessionSnapshot) => void;
+    /** Called when a session ends (emits `session_end` server-side). */
+    onSessionEnd?: (session: SessionSnapshot) => void;
+    /** Injectable clock for deterministic testing. Defaults to `Date.now()`. */
+    now?: () => number;
+    /** Injectable `setTimeout` / `clearTimeout` for deterministic testing. */
+    scheduler?: {
+        setTimeout: (callback: () => void, ms: number) => number;
+        clearTimeout: (handle: number) => void;
+    };
+}
+export declare class SessionManager {
+    private readonly timeoutMs;
+    private readonly onSessionStart?;
+    private readonly onSessionEnd?;
+    private readonly now;
+    private readonly setTimeoutFn;
+    private readonly clearTimeoutFn;
+    private current;
+    private timeoutHandle;
+    constructor(options?: SessionManagerOptions);
+    /**
+     * Records user activity. Starts a new session if none is active, otherwise
+     * resets the inactivity timeout. Returns the current session snapshot.
+     */
+    recordActivity(): SessionSnapshot;
+    /**
+     * Explicitly ends the current session immediately. Fires `onSessionEnd`.
+     * No-op if no session is active.
+     */
+    endSession(): void;
+    /** Returns the current session snapshot, or null. */
+    getCurrent(): SessionSnapshot | null;
+    /** Force-starts a new session, ending any current one. */
+    forceStart(): SessionSnapshot;
+    private scheduleTimeout;
+    private clearTimeout;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD,oEAAoE;IACpE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAClD,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE;QACV,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;QACzD,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;KACxC,CAAC;CACH;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAqC;IACnE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,aAAa,CAAuB;gBAEhC,OAAO,GAAE,qBAA0B;IAgB/C;;;OAGG;IACH,cAAc,IAAI,eAAe;IAwBjC;;;OAGG;IACH,UAAU,IAAI,IAAI;IAkBlB,qDAAqD;IACrD,UAAU,IAAI,eAAe,GAAG,IAAI;IAIpC,0DAA0D;IAC1D,UAAU,IAAI,eAAe;IAK7B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,YAAY;CAMrB"}

package/dist/session-manager.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Mobile session manager.
+ *
+ * Defines the boundaries of a user's interaction with the app. A session
+ * starts on the first event after inactivity and ends when either
+ *   (a) no events arrive for `timeoutMinutes` (default 30), or
+ *   (b) the app is force-backgrounded and the OS reclaims memory.
+ *
+ * Emits `session_start` and `session_end` events that plug directly into the
+ * server's MSESSION# rollup (Phase 1c). The timeout is configurable and the
+ * clock is injectable for deterministic testing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const event_id_1 = require("./event-id");
+class SessionManager {
+    constructor(options = {}) {
+        this.current = null;
+        this.timeoutHandle = null;
+        this.timeoutMs = (options.timeoutMinutes ?? 30) * 60 * 1000;
+        this.onSessionStart = options.onSessionStart;
+        this.onSessionEnd = options.onSessionEnd;
+        this.now = options.now ?? (() => Date.now());
+        const defaultScheduler = {
+            setTimeout: (cb, ms) => setTimeout(cb, ms),
+            clearTimeout: (handle) => clearTimeout(handle),
+        };
+        const scheduler = options.scheduler ?? defaultScheduler;
+        this.setTimeoutFn = scheduler.setTimeout;
+        this.clearTimeoutFn = scheduler.clearTimeout;
+    }
+    /**
+     * Records user activity. Starts a new session if none is active, otherwise
+     * resets the inactivity timeout. Returns the current session snapshot.
+     */
+    recordActivity() {
+        const nowMs = this.now();
+        const isoNow = new Date(nowMs).toISOString();
+        if (!this.current) {
+            this.current = {
+                sessionId: (0, event_id_1.generateEventId)(),
+                startedAt: isoNow,
+                lastActivityAt: isoNow,
+                eventCount: 1,
+            };
+            if (this.onSessionStart)
+                this.onSessionStart({ ...this.current });
+        }
+        else {
+            this.current = {
+                ...this.current,
+                lastActivityAt: isoNow,
+                eventCount: this.current.eventCount + 1,
+            };
+        }
+        this.scheduleTimeout();
+        return { ...this.current };
+    }
+    /**
+     * Explicitly ends the current session immediately. Fires `onSessionEnd`.
+     * No-op if no session is active.
+     */
+    endSession() {
+        if (!this.current)
+            return;
+        this.clearTimeout();
+        const nowMs = this.now();
+        const startedMs = Date.parse(this.current.startedAt);
+        const durationSeconds = Math.max(0, Math.floor((nowMs - startedMs) / 1000));
+        const ended = {
+            ...this.current,
+            endedAt: new Date(nowMs).toISOString(),
+            durationSeconds,
+        };
+        if (this.onSessionEnd)
+            this.onSessionEnd(ended);
+        this.current = null;
+    }
+    /** Returns the current session snapshot, or null. */
+    getCurrent() {
+        return this.current ? { ...this.current } : null;
+    }
+    /** Force-starts a new session, ending any current one. */
+    forceStart() {
+        if (this.current)
+            this.endSession();
+        return this.recordActivity();
+    }
+    scheduleTimeout() {
+        this.clearTimeout();
+        this.timeoutHandle = this.setTimeoutFn(() => {
+            this.endSession();
+        }, this.timeoutMs);
+    }
+    clearTimeout() {
+        if (this.timeoutHandle !== null) {
+            this.clearTimeoutFn(this.timeoutHandle);
+            this.timeoutHandle = null;
+        }
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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

package/dist/web.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Web fallback implementation of `ApexCapacitorPlugin`.
+ *
+ * Runs when the app is in a browser or Capacitor PWA context where no native
+ * iOS/Android bridge is present. Provides best-effort behavior for every
+ * method — identifiers return null, ATT is a no-op (returns `authorized`),
+ * SKAN is a no-op, deep links come from `window.location`, and events are
+ * batched + sent over fetch via the normal offline queue.
+ *
+ * This module deliberately keeps the heavy lifting (queue, session, batch)
+ * in separate files so unit tests can cover them without DOM mocking.
+ */
+import { WebPlugin } from "@capacitor/core";
+import type { AdvertisingIdResult, ApexCapacitorPlugin, ApexEvent, AttStatus, DeviceInfo, FlushResult, InitializeOptions, QueueStatus, SessionInfo, SkanCoarseValue } from "./definitions";
+export declare class ApexCapacitorWeb extends WebPlugin implements ApexCapacitorPlugin {
+    private queue?;
+    private session?;
+    private sender?;
+    private visitorId?;
+    private testMode;
+    private debug;
+    private initialized;
+    initialize(options: InitializeOptions): Promise<void>;
+    requestTrackingAuthorization(): Promise<{
+        status: AttStatus;
+    }>;
+    getTrackingStatus(): Promise<{
+        status: AttStatus;
+    }>;
+    getAdvertisingId(): Promise<AdvertisingIdResult>;
+    getInstallReferrer(): Promise<{
+        referrer: string | null;
+    }>;
+    getVisitorId(): Promise<{
+        visitorId: string;
+    }>;
+    setVisitorId(options: {
+        visitorId: string;
+    }): Promise<void>;
+    updateConversionValue(_options: {
+        fineValue: number;
+        coarseValue?: SkanCoarseValue;
+    }): Promise<void>;
+    getInitialDeepLink(): Promise<{
+        url: string | null;
+    }>;
+    getDeviceInfo(): Promise<DeviceInfo>;
+    startSession(): Promise<{
+        sessionId: string;
+    }>;
+    endSession(): Promise<void>;
+    getCurrentSession(): Promise<SessionInfo>;
+    track(event: ApexEvent): Promise<void>;
+    getQueueSize(): Promise<QueueStatus>;
+    flushQueue(): Promise<FlushResult>;
+    setTestMode(options: {
+        enabled: boolean;
+    }): Promise<void>;
+    removeAllListeners(): Promise<void>;
+    private emitSession;
+    private loadOrCreateVisitorId;
+    private saveVisitorId;
+    private ensureInitialized;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,eAAe,EAChB,MAAM,eAAe,CAAC;AAQvB,qBAAa,gBAAiB,SAAQ,SAAU,YAAW,mBAAmB;IAC5E,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCrD,4BAA4B,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAI9D,iBAAiB,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAInD,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIhD,kBAAkB,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAI1D,YAAY,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAO9C,YAAY,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,qBAAqB,CAAC,QAAQ,EAAE;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,eAAe,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC;IAIX,kBAAkB,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAOrD,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAiBpC,YAAY,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAM9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC;IAQzC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BtC,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IASpC,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAMlC,WAAW,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzC,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,iBAAiB;CAK1B"}