@formo/analytics-react-native 0.1.0

package/lib/typescript/lib/event/EventFactory.d.ts

@@ -0,0 +1,61 @@
+import { Address, APIEvent, ChainID, IFormoEvent, IFormoEventContext, IFormoEventProperties, Nullable, Options, SignatureStatus, TransactionStatus } from "../../types";
+import { IEventFactory } from "./types";
+/**
+ * Event factory for React Native
+ * Creates event payloads with mobile-specific context
+ */
+declare class EventFactory implements IEventFactory {
+    private options?;
+    constructor(options?: Options);
+    /**
+     * Get device timezone
+     */
+    private getTimezone;
+    /**
+     * Get location from timezone
+     */
+    private getLocation;
+    /**
+     * Get device language/locale
+     */
+    private getLanguage;
+    /**
+     * Get screen dimensions
+     */
+    private getScreen;
+    /**
+     * Get network information
+     */
+    private getNetworkInfo;
+    /**
+     * Get device information
+     * Supports both react-native-device-info (bare RN) and expo-device/expo-application (Expo Go)
+     */
+    private getDeviceInfo;
+    /**
+     * Generate context with mobile-specific metadata
+     */
+    private generateContext;
+    /**
+     * Create enriched event with common properties
+     */
+    private getEnrichedEvent;
+    /**
+     * Generate screen view event (mobile equivalent of page)
+     */
+    generateScreenEvent(name: string, category?: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateDetectWalletEvent(providerName: string, rdns: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateIdentifyEvent(providerName: string, rdns: string, address: Nullable<Address>, userId?: Nullable<string>, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateConnectEvent(chainId: ChainID, address: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateDisconnectEvent(chainId?: ChainID, address?: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateChainChangedEvent(chainId: ChainID, address: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateSignatureEvent(status: SignatureStatus, chainId: ChainID | undefined, address: Address, message: string, signatureHash?: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateTransactionEvent(status: TransactionStatus, chainId: ChainID, address: Address, data?: string, to?: string, value?: string, transactionHash?: string, function_name?: string, function_args?: Record<string, unknown>, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateTrackEvent(event: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    /**
+     * Create event from API event type
+     */
+    create(event: APIEvent, address?: Address, userId?: string): Promise<IFormoEvent>;
+}
+export { EventFactory };
+//# sourceMappingURL=EventFactory.d.ts.map

package/lib/typescript/lib/event/EventFactory.d.ts.map

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

package/lib/typescript/lib/event/EventManager.d.ts

@@ -0,0 +1,17 @@
+import { Address, APIEvent, Options } from "../../types";
+import { IEventFactory, IEventManager, IEventQueue } from "./types";
+/**
+ * Event manager for React Native SDK
+ * Generates valid event payloads and queues them for processing
+ */
+declare class EventManager implements IEventManager {
+    eventQueue: IEventQueue;
+    eventFactory: IEventFactory;
+    constructor(eventQueue: IEventQueue, options?: Options);
+    /**
+     * Add event to queue
+     */
+    addEvent(event: APIEvent, address?: Address, userId?: string): Promise<void>;
+}
+export { EventManager };
+//# sourceMappingURL=EventManager.d.ts.map

package/lib/typescript/lib/event/EventManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventManager.d.ts","sourceRoot":"","sources":["../../../../src/lib/event/EventManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGpE;;;GAGG;AACH,cAAM,YAAa,YAAW,aAAa;IACzC,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;gBAEhB,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO;IAKtD;;OAEG;IACG,QAAQ,CACZ,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;CAqBjB;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/lib/typescript/lib/event/EventQueue.d.ts

@@ -0,0 +1,74 @@
+import { IFormoEvent } from "../../types";
+import { IEventQueue } from "./types";
+interface Options {
+    apiHost: string;
+    flushAt?: number;
+    flushInterval?: number;
+    retryCount?: number;
+    maxQueueSize?: number;
+}
+/**
+ * Event queue for React Native
+ * Handles batching, flushing, and retries with app lifecycle awareness
+ */
+export declare class EventQueue implements IEventQueue {
+    private writeKey;
+    private apiHost;
+    private queue;
+    private timer;
+    private flushAt;
+    private flushIntervalMs;
+    private maxQueueSize;
+    private retryCount;
+    private payloadHashes;
+    private flushMutex;
+    private appStateSubscription;
+    constructor(writeKey: string, options: Options);
+    /**
+     * Set up listener for app state changes
+     * Flush events when app goes to background
+     */
+    private setupAppStateListener;
+    /**
+     * Handle app state changes
+     */
+    private handleAppStateChange;
+    /**
+     * Generate message ID for deduplication
+     */
+    private generateMessageId;
+    /**
+     * Check if event is a duplicate
+     */
+    private isDuplicate;
+    /**
+     * Add event to queue
+     */
+    enqueue(event: IFormoEvent, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Flush events to API
+     * Uses a mutex to ensure only one flush operation runs at a time,
+     * preventing race conditions with re-queued items on failure.
+     */
+    flush(callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Send events with retry logic
+     */
+    private sendWithRetry;
+    /**
+     * Check if error should be retried
+     */
+    private shouldRetry;
+    /**
+     * Discard all pending events without sending them.
+     * Used when the user opts out of tracking to prevent queued events
+     * from being sent after consent is revoked.
+     */
+    clear(): void;
+    /**
+     * Clean up resources, flushing any pending events first
+     */
+    cleanup(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=EventQueue.d.ts.map

package/lib/typescript/lib/event/EventQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventQueue.d.ts","sourceRoot":"","sources":["../../../../src/lib/event/EventQueue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAW9D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAYtC,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAoBD;;;GAGG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,oBAAoB,CAAuC;gBAEvD,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IA2B9C;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;YACW,iBAAiB;IAS/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,WAAW,EAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAkDhB;;;;OAIG;IACG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DnE;;OAEG;YACW,aAAa;IA+B3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;OAIG;IACI,KAAK,IAAI,IAAI;IAYpB;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAiDtC"}

package/lib/typescript/lib/event/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./EventFactory";
+export * from "./EventManager";
+export * from "./EventQueue";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/lib/event/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/event/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/lib/typescript/lib/event/types.d.ts

@@ -0,0 +1,23 @@
+import { Address, APIEvent, IFormoEvent, IFormoEventContext, IFormoEventProperties, Nullable, SignatureStatus, TransactionStatus, ChainID } from "../../types";
+export interface IEventFactory {
+    create(event: APIEvent, address?: Address, userId?: string): Promise<IFormoEvent>;
+    generateScreenEvent(name: string, category?: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateDetectWalletEvent(providerName: string, rdns: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateIdentifyEvent(providerName: string, rdns: string, address: Nullable<Address>, userId?: Nullable<string>, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateConnectEvent(chainId: ChainID, address: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateDisconnectEvent(chainId?: ChainID, address?: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateChainChangedEvent(chainId: ChainID, address: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateSignatureEvent(status: SignatureStatus, chainId: ChainID | undefined, address: Address, message: string, signatureHash?: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateTransactionEvent(status: TransactionStatus, chainId: ChainID, address: Address, data?: string, to?: string, value?: string, transactionHash?: string, function_name?: string, function_args?: Record<string, unknown>, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+    generateTrackEvent(event: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<IFormoEvent>;
+}
+export interface IEventManager {
+    addEvent(event: APIEvent, address?: Address, userId?: string): Promise<void>;
+}
+export interface IEventQueue {
+    enqueue(event: IFormoEvent, callback?: (...args: unknown[]) => void): Promise<void>;
+    flush(callback?: (...args: unknown[]) => void): Promise<void>;
+    clear(): void;
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/lib/event/types.d.ts.map

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

package/lib/typescript/lib/lifecycle/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Application Lifecycle Event Manager
+ *
+ * Tracks application lifecycle events following the Segment/RudderStack spec:
+ * - Application Installed (first launch)
+ * - Application Updated (version/build changed)
+ * - Application Opened (every cold start + foreground return)
+ * - Application Backgrounded (app goes to background)
+ *
+ * Detection is JS-side using AsyncStorage (no native modules required).
+ */
+/** Interface for the analytics instance to avoid circular deps */
+interface IAnalyticsInstance {
+    track(event: string, properties?: Record<string, unknown>): Promise<void>;
+}
+export declare class AppLifecycleManager {
+    private analytics;
+    private appStateSubscription;
+    private lastAppState;
+    private appVersionInfo;
+    constructor(analytics: IAnalyticsInstance);
+    /**
+     * Initialize lifecycle tracking.
+     * Detects install/update, fires Application Opened, and sets up AppState listener.
+     */
+    start(appOptions?: {
+        version?: string;
+        build?: string;
+    }): Promise<void>;
+    /**
+     * Compare stored version/build with current to detect install or update.
+     * Requires persistent storage (AsyncStorage) — skips if only MemoryStorage is available,
+     * since MemoryStorage is empty on every cold start and would false-positive as "installed".
+     */
+    private detectInstallOrUpdate;
+    /**
+     * Handle AppState transitions for foreground/background events.
+     */
+    private handleAppStateChange;
+    /**
+     * Clean up AppState listener.
+     */
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/lib/lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,kEAAkE;AAClE,UAAU,kBAAkB;IAC1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAgDD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,oBAAoB,CAAuC;IACnE,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,cAAc,CAA8C;gBAExD,SAAS,EAAE,kBAAkB;IAIzC;;;OAGG;IACG,KAAK,CACT,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;OAIG;YACW,qBAAqB;IA0CnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/lib/typescript/lib/logger/index.d.ts

@@ -0,0 +1,19 @@
+export type LogLevel = "debug" | "info" | "warn" | "error" | "log";
+interface LoggerConfig {
+    enabled?: boolean;
+    enabledLevels?: LogLevel[];
+}
+declare class LoggerClass {
+    private config;
+    init(config: LoggerConfig): void;
+    private shouldLog;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    log(...args: unknown[]): void;
+}
+export declare const Logger: LoggerClass;
+export declare const logger: LoggerClass;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/lib/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/logger/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEnE,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC5B;AAED,cAAM,WAAW;IACf,OAAO,CAAC,MAAM,CAGZ;IAEF,IAAI,CAAC,MAAM,EAAE,YAAY;IAIzB,OAAO,CAAC,SAAS;IAMjB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAMxB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAMvB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAMvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAMxB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;CAKvB;AAED,eAAO,MAAM,MAAM,aAAoB,CAAC;AACxC,eAAO,MAAM,MAAM,aAAS,CAAC"}

package/lib/typescript/lib/session/index.d.ts

@@ -0,0 +1,41 @@
+import { SESSION_WALLET_DETECTED_KEY, SESSION_WALLET_IDENTIFIED_KEY } from "../../constants";
+export { SESSION_WALLET_DETECTED_KEY, SESSION_WALLET_IDENTIFIED_KEY };
+/**
+ * Session manager for tracking wallet detection and identification
+ * Persists to session storage to avoid duplicate detection/identification events
+ * within the same session
+ */
+export declare class FormoAnalyticsSession {
+    private detectedWallets;
+    private identifiedWallets;
+    constructor();
+    /**
+     * Load session state from storage
+     */
+    private loadFromStorage;
+    /**
+     * Save session state to storage
+     */
+    private saveToStorage;
+    /**
+     * Check if a wallet has been detected in this session
+     */
+    isWalletDetected(rdns: string): boolean;
+    /**
+     * Mark a wallet as detected
+     */
+    markWalletDetected(rdns: string): void;
+    /**
+     * Check if a wallet + address combination has been identified
+     */
+    isWalletIdentified(address: string, rdns: string): boolean;
+    /**
+     * Mark a wallet + address combination as identified
+     */
+    markWalletIdentified(address: string, rdns: string): void;
+    /**
+     * Clear all session data
+     */
+    clear(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/lib/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,CAAC;AAEtE;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,iBAAiB,CAA0B;;IAMnD;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACI,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7C;;OAEG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjE;;OAEG;IACI,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMhE;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}

package/lib/typescript/lib/storage/AsyncStorageAdapter.d.ts

@@ -0,0 +1,48 @@
+import StorageBlueprint from "./StorageBlueprint";
+import { AsyncStorageInterface } from "./types";
+/**
+ * AsyncStorage adapter for React Native
+ * Provides persistent storage across app restarts
+ */
+declare class AsyncStorageAdapter extends StorageBlueprint {
+    private asyncStorage;
+    private cache;
+    constructor(writeKey: string, asyncStorage?: AsyncStorageInterface);
+    /**
+     * Initialize with AsyncStorage instance and preload all Formo keys
+     * This ensures consent flags and other critical data are available synchronously
+     */
+    initialize(asyncStorage: AsyncStorageInterface): Promise<void>;
+    isAvailable(): boolean;
+    /**
+     * Synchronous get from cache (may return stale data)
+     * Use getAsync for guaranteed fresh data
+     */
+    get(key: string): string | null;
+    /**
+     * Async get from storage
+     */
+    getAsync(key: string): Promise<string | null>;
+    /**
+     * Synchronous set (writes to cache immediately, persists async)
+     */
+    set(key: string, value: string): void;
+    /**
+     * Async set to storage
+     */
+    setAsync(key: string, value: string): Promise<void>;
+    /**
+     * Synchronous remove (removes from cache immediately, persists async)
+     */
+    remove(key: string): void;
+    /**
+     * Async remove from storage
+     */
+    removeAsync(key: string): Promise<void>;
+    /**
+     * Clear all cached data
+     */
+    clearCache(): void;
+}
+export default AsyncStorageAdapter;
+//# sourceMappingURL=AsyncStorageAdapter.d.ts.map

package/lib/typescript/lib/storage/AsyncStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncStorageAdapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/AsyncStorageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGhD;;;GAGG;AACH,cAAM,mBAAoB,SAAQ,gBAAgB;IAChD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,KAAK,CAAkC;gBAEnC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,qBAAqB;IAOlE;;;OAGG;IACU,UAAU,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCpE,WAAW,IAAI,OAAO;IAI7B;;;OAGG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IActC;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoB1D;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAU5C;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhE;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUhC;;OAEG;IACU,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD;;OAEG;IACI,UAAU,IAAI,IAAI;CAG1B;AAED,eAAe,mBAAmB,CAAC"}

package/lib/typescript/lib/storage/MemoryStorage.d.ts

@@ -0,0 +1,18 @@
+import StorageBlueprint from "./StorageBlueprint";
+/**
+ * In-memory storage fallback
+ * Data is lost when the app is closed
+ */
+declare class MemoryStorage extends StorageBlueprint {
+    private storage;
+    isAvailable(): boolean;
+    get(key: string): string | null;
+    getAsync(key: string): Promise<string | null>;
+    set(key: string, value: string): void;
+    setAsync(key: string, value: string): Promise<void>;
+    remove(key: string): void;
+    removeAsync(key: string): Promise<void>;
+    clear(): void;
+}
+export default MemoryStorage;
+//# sourceMappingURL=MemoryStorage.d.ts.map

package/lib/typescript/lib/storage/MemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorage.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/MemoryStorage.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,cAAM,aAAc,SAAQ,gBAAgB;IAC1C,OAAO,CAAC,OAAO,CAAkC;IAE1C,WAAW,IAAI,OAAO;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAInD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAInB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,KAAK,IAAI,IAAI;CAGrB;AAED,eAAe,aAAa,CAAC"}

package/lib/typescript/lib/storage/StorageBlueprint.d.ts

@@ -0,0 +1,21 @@
+import { IStorage } from "./types";
+/**
+ * Base storage class with key prefixing
+ */
+declare abstract class StorageBlueprint implements IStorage {
+    protected writeKey: string;
+    constructor(writeKey: string);
+    /**
+     * Generate storage key with prefix
+     */
+    getKey(key: string): string;
+    abstract isAvailable(): boolean;
+    abstract get(key: string): string | null;
+    abstract getAsync(key: string): Promise<string | null>;
+    abstract set(key: string, value: string): void;
+    abstract setAsync(key: string, value: string): Promise<void>;
+    abstract remove(key: string): void;
+    abstract removeAsync(key: string): Promise<void>;
+}
+export default StorageBlueprint;
+//# sourceMappingURL=StorageBlueprint.d.ts.map

package/lib/typescript/lib/storage/StorageBlueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageBlueprint.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/StorageBlueprint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;GAEG;AACH,uBAAe,gBAAiB,YAAW,QAAQ;IACjD,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEf,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIlC,QAAQ,CAAC,WAAW,IAAI,OAAO;IAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IACxC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAC9C,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5D,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAClC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACjD;AAED,eAAe,gBAAgB,CAAC"}

package/lib/typescript/lib/storage/StorageManager.d.ts

@@ -0,0 +1,45 @@
+import { IStorage, StorageType, AsyncStorageInterface } from "./types";
+/**
+ * Storage manager for React Native SDK
+ * Uses AsyncStorage as primary storage with MemoryStorage fallback
+ */
+export declare class StorageManager {
+    private readonly writeKey;
+    private storages;
+    constructor(writeKey: string);
+    /**
+     * Initialize with AsyncStorage instance
+     * This should be called during SDK initialization
+     */
+    initialize(asyncStorage: AsyncStorageInterface): Promise<void>;
+    /**
+     * Get storage instance by type
+     */
+    getStorage(type: StorageType): IStorage;
+    /**
+     * Create storage instance
+     */
+    private createStorage;
+    /**
+     * Get primary storage (AsyncStorage with fallback)
+     */
+    getPrimaryStorage(): IStorage;
+    /**
+     * Check if persistent storage (AsyncStorage) has been initialized.
+     * Returns false if only MemoryStorage is available.
+     */
+    hasPersistentStorage(): boolean;
+}
+/**
+ * Initialize global storage manager
+ */
+export declare function initStorageManager(writeKey: string): StorageManager;
+/**
+ * Get global storage manager instance
+ */
+export declare function getStorageManager(): StorageManager | null;
+/**
+ * Get primary storage
+ */
+export declare function storage(): IStorage;
+//# sourceMappingURL=StorageManager.d.ts.map

package/lib/typescript/lib/storage/StorageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/StorageManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEvE;;;GAGG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAyC;gBAE5B,QAAQ,EAAE,MAAM;IAE7C;;;OAGG;IACU,UAAU,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3E;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ;IAoB9C;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACI,iBAAiB,IAAI,QAAQ;IAQpC;;;OAGG;IACI,oBAAoB,IAAI,OAAO;CAIvC;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CASnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,QAAQ,CAKlC"}

package/lib/typescript/lib/storage/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./StorageManager";
+export * from "./types";
+export { default as AsyncStorageAdapter } from "./AsyncStorageAdapter";
+export { default as MemoryStorage } from "./MemoryStorage";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/lib/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/typescript/lib/storage/types.d.ts

@@ -0,0 +1,22 @@
+export type StorageType = "asyncStorage" | "memoryStorage";
+export interface IStorage {
+    isAvailable(): boolean;
+    get(key: string): string | null;
+    getAsync(key: string): Promise<string | null>;
+    set(key: string, value: string): void;
+    setAsync(key: string, value: string): Promise<void>;
+    remove(key: string): void;
+    removeAsync(key: string): Promise<void>;
+    getKey(key: string): string;
+}
+export interface AsyncStorageInterface {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    getAllKeys(): Promise<readonly string[]>;
+    multiGet(keys: readonly string[]): Promise<readonly [string, string | null][]>;
+    multiSet?(keyValuePairs: [string, string][]): Promise<void>;
+    multiRemove(keys: readonly string[]): Promise<void>;
+    clear?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/lib/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,eAAe,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,WAAW,IAAI,OAAO,CAAC;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,UAAU,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/E,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/lib/typescript/lib/wagmi/WagmiEventHandler.d.ts

@@ -0,0 +1,104 @@
+/**
+ * WagmiEventHandler for React Native
+ *
+ * Handles wallet event tracking by hooking into Wagmi v2's config.subscribe()
+ * and TanStack Query's MutationCache.
+ */
+import { SignatureStatus, TransactionStatus } from "../../types/events";
+import { WagmiConfig, QueryClient } from "./types";
+interface IFormoAnalyticsInstance {
+    connect(params: {
+        chainId: number;
+        address: string;
+    }, properties?: Record<string, unknown>): Promise<void>;
+    disconnect(params?: {
+        chainId?: number;
+        address?: string;
+    }): Promise<void>;
+    chain(params: {
+        chainId: number;
+        address?: string;
+    }): Promise<void>;
+    signature(params: {
+        status: SignatureStatus;
+        chainId: number;
+        address: string;
+        message: string;
+        signatureHash?: string;
+    }): Promise<void>;
+    transaction(params: {
+        status: TransactionStatus;
+        chainId: number;
+        address: string;
+        data?: string;
+        to?: string;
+        value?: string;
+        transactionHash?: string;
+    }): Promise<void>;
+    isAutocaptureEnabled(eventType: "connect" | "disconnect" | "signature" | "transaction" | "chain"): boolean;
+}
+export declare class WagmiEventHandler {
+    private formo;
+    private wagmiConfig;
+    private queryClient?;
+    private unsubscribers;
+    private trackingState;
+    private processedMutations;
+    private pendingStatusChanges;
+    constructor(formoAnalytics: IFormoAnalyticsInstance, wagmiConfig: WagmiConfig, queryClient?: QueryClient);
+    /**
+     * Set up listeners for wallet connection, disconnection, and chain changes
+     */
+    private setupConnectionListeners;
+    private static readonly MAX_PENDING_STATUS_CHANGES;
+    /**
+     * Handle status changes (connect/disconnect)
+     */
+    private handleStatusChange;
+    /**
+     * Process a single status change (extracted for iterative processing)
+     */
+    private processStatusChange;
+    /**
+     * Handle chain ID changes
+     */
+    private handleChainChange;
+    /**
+     * Set up mutation tracking for signatures and transactions
+     */
+    private setupMutationTracking;
+    /**
+     * Handle mutation cache events
+     */
+    private handleMutationEvent;
+    /**
+     * Handle signature mutations
+     */
+    private handleSignatureMutation;
+    /**
+     * Handle transaction mutations
+     */
+    private handleTransactionMutation;
+    /**
+     * Get current Wagmi state
+     */
+    private getState;
+    /**
+     * Get connected address from state
+     */
+    private getConnectedAddress;
+    /**
+     * Get connector name from state
+     */
+    private getConnectorName;
+    /**
+     * Get connector ID from state (typically the rdns for EIP-6963 wallets)
+     */
+    private getConnectorId;
+    /**
+     * Clean up subscriptions
+     */
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=WagmiEventHandler.d.ts.map

package/lib/typescript/lib/wagmi/WagmiEventHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WagmiEventHandler.d.ts","sourceRoot":"","sources":["../../../../src/lib/wagmi/WagmiEventHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EACL,WAAW,EAEX,WAAW,EAKZ,MAAM,SAAS,CAAC;AAGjB,UAAU,uBAAuB;IAC/B,OAAO,CACL,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAC5C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,MAAM,CAAC,EAAE;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,KAAK,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,SAAS,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,WAAW,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,oBAAoB,CAClB,SAAS,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,GAC1E,OAAO,CAAC;CACZ;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,aAAa,CAEnB;IACF,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,oBAAoB,CAGpB;gBAGN,cAAc,EAAE,uBAAuB,EACvC,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,WAAW;IAmB3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAM;IAExD;;OAEG;YACW,kBAAkB;IAkChC;;OAEG;YACW,mBAAmB;IAuDjC;;OAEG;YACW,iBAAiB;IAqC/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0D3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyE/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAgFjC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACI,OAAO,IAAI,IAAI;CAgBvB"}

package/lib/typescript/lib/wagmi/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./WagmiEventHandler";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/lib/wagmi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/wagmi/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}