@formo/analytics-react-native 0.1.4 → 1.0.0

package/lib/typescript/commonjs/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AA6BD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAoBxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,CAAC,CA2BH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC1C,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBtD"}

package/lib/typescript/commonjs/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/lib/typescript/commonjs/utils/timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../../../src/utils/timestamp.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAOnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/lib/typescript/{utils → commonjs/utils}/trafficSource.d.ts

@@ -27,4 +27,20 @@ export declare function clearTrafficSource(): void;
  * Stored traffic source is used as fallback - current context takes priority
  */
 export declare function mergeWithStoredTrafficSource(context?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Update stored traffic source with incoming values. Per-field last-touch with
+ * fallback: non-empty incoming fields win, empty incoming fields preserve the
+ * previously stored value. This matches the Formo web SDK's behavior and
+ * prevents a non-marketing deep link (e.g. "myapp://home" with only a referrer
+ * and no UTM/ref) from destroying existing attribution data written by the
+ * Install Referrer flow or an earlier marketing deep link.
+ */
+export declare function updateStoredTrafficSource(incoming: Partial<ITrafficSource>): void;
+/**
+ * Merge a partial traffic source into the stored one, only filling in fields
+ * that are currently empty. Used by the Install Referrer flow so campaign data
+ * from the Play Store install referrer cannot clobber a deep-link attribution
+ * that arrived earlier in the same cold start.
+ */
+export declare function mergeTrafficSourceFill(incoming: Partial<ITrafficSource>): void;
 //# sourceMappingURL=trafficSource.d.ts.map

package/lib/typescript/commonjs/utils/trafficSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trafficSource.d.ts","sourceRoot":"","sources":["../../../../src/utils/trafficSource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,CAAC,CA8DzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAkB/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAU5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAaD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,IAAI,CAmBN;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,IAAI,CAqBN"}

package/lib/typescript/commonjs/version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/lib/typescript/commonjs/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/lib/typescript/module/FormoAnalytics.d.ts

@@ -0,0 +1,182 @@
+/**
+ * FormoAnalytics for React Native
+ *
+ * Main SDK class for tracking wallet events and user analytics in mobile dApps
+ */
+import { AsyncStorageInterface } from "./lib/storage";
+import { Address, ChainID, Config, IFormoAnalytics, IFormoEventContext, IFormoEventProperties, Options, SignatureStatus, TransactionStatus } from "./types";
+export declare class FormoAnalytics implements IFormoAnalytics {
+    readonly writeKey: string;
+    options: Options;
+    private session;
+    private eventManager;
+    private eventQueue;
+    private wagmiHandler?;
+    private lifecycleManager?;
+    private linkingSubscription?;
+    config: Config;
+    currentChainId?: ChainID;
+    currentAddress?: Address;
+    currentUserId?: string;
+    private constructor();
+    /**
+     * Initialize the SDK
+     * @param writeKey - Your Formo write key
+     * @param options - Configuration options
+     * @param asyncStorage - AsyncStorage instance from @react-native-async-storage/async-storage
+     */
+    static init(writeKey: string, options?: Options, asyncStorage?: AsyncStorageInterface): Promise<FormoAnalytics>;
+    /**
+     * Hook into React Native's Linking API to auto-capture traffic source from
+     * the launch URL and any subsequent deep-link opens. Awaits the initial URL
+     * so attribution is in storage before the first lifecycle event fires.
+     */
+    private startDeepLinkCapture;
+    /**
+     * Track a screen view (mobile equivalent of page view)
+     */
+    screen(name: string, category?: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Set traffic source from deep link URL
+     * Parses UTM parameters and referrer information from URL
+     * This is automatically persisted for the session
+     *
+     * @param url - Deep link URL (e.g., "myapp://product?utm_source=facebook&ref=friend123")
+     *
+     * @example
+     * ```tsx
+     * import { Linking } from 'react-native';
+     *
+     * // Listen for deep links
+     * Linking.addEventListener('url', (event) => {
+     *   formo.setTrafficSourceFromUrl(event.url);
+     * });
+     *
+     * // Or get initial URL
+     * Linking.getInitialURL().then((url) => {
+     *   if (url) formo.setTrafficSourceFromUrl(url);
+     * });
+     * ```
+     */
+    setTrafficSourceFromUrl(url: string): void;
+    /**
+     * Reset the current user session
+     */
+    reset(): void;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Track wallet connect event
+     */
+    connect({ chainId, address }: {
+        chainId: ChainID;
+        address: Address;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Track wallet disconnect event
+     */
+    disconnect(params?: {
+        chainId?: ChainID;
+        address?: Address;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Track chain change event
+     */
+    chain({ chainId, address }: {
+        chainId: ChainID;
+        address?: Address;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Track signature event
+     */
+    signature({ status, chainId, address, message, }: {
+        status: SignatureStatus;
+        chainId?: ChainID;
+        address: Address;
+        message: string;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Track transaction event
+     */
+    transaction({ status, chainId, address, data, to, value, transactionHash, function_name, function_args, }: {
+        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, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Track identify event
+     */
+    identify(params: {
+        address: Address;
+        providerName?: string;
+        userId?: string;
+        rdns?: string;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Track detect wallet event
+     */
+    detect({ providerName, rdns }: {
+        providerName: string;
+        rdns: string;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Track custom event
+     */
+    track(event: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    /**
+     * Opt out of tracking
+     */
+    optOutTracking(): void;
+    /**
+     * Opt back into tracking
+     */
+    optInTracking(): void;
+    /**
+     * Check if user has opted out
+     */
+    hasOptedOutTracking(): boolean;
+    /**
+     * Check if autocapture is enabled for a given event type.
+     * Applies only to event-generating behaviors (wallet events, lifecycle
+     * events). Attribution is controlled separately via `options.attribution`
+     * because it enriches events rather than generating them.
+     */
+    isAutocaptureEnabled(eventType: "connect" | "disconnect" | "signature" | "transaction" | "chain" | "lifecycle"): boolean;
+    /**
+     * Check if an attribution source is enabled. Attribution is not an event
+     * type — it decorates every tracked event with `utm_*`, `ref`, and
+     * `referrer` context fields.
+     */
+    isAttributionEnabled(source: "deeplinks" | "installReferrer"): boolean;
+    /**
+     * Internal method to track events
+     * This is the single enforcement point for shouldTrack() - all public tracking
+     * methods (track, screen, connect, etc.) route through here
+     */
+    private trackEvent;
+    /**
+     * Check if tracking should be enabled
+     */
+    private shouldTrack;
+    /**
+     * Validate and normalize an address for the given chain.
+     *
+     * EVM addresses are returned in EIP-55 checksum format.
+     * Solana addresses are returned as-is (Base58 is case-sensitive).
+     * When chainId is omitted, EVM is tried first with Solana as fallback.
+     */
+    private validateAndChecksumAddress;
+    /**
+     * Flush pending events
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=FormoAnalytics.d.ts.map

package/lib/typescript/module/FormoAnalytics.d.ts.map

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

package/lib/typescript/module/FormoAnalyticsProvider.d.ts

@@ -0,0 +1,29 @@
+import React, { FC } from "react";
+import { FormoAnalyticsProviderProps, IFormoAnalytics } from "./types";
+export declare const FormoAnalyticsContext: React.Context<IFormoAnalytics>;
+/**
+ * Formo Analytics Provider for React Native
+ *
+ * Wraps your app to provide analytics context
+ *
+ * @example
+ * ```tsx
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * import { FormoAnalyticsProvider } from '@formo/analytics-react-native';
+ *
+ * function App() {
+ *   return (
+ *     <FormoAnalyticsProvider
+ *       writeKey="your-write-key"
+ *       asyncStorage={AsyncStorage}
+ *       options={{ wagmi: { config, queryClient } }}
+ *     >
+ *       <YourApp />
+ *     </FormoAnalyticsProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare const FormoAnalyticsProvider: FC<FormoAnalyticsProviderProps>;
+export declare const useFormo: () => IFormoAnalytics;
+//# sourceMappingURL=FormoAnalyticsProvider.d.ts.map

package/lib/typescript/module/FormoAnalyticsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormoAnalyticsProvider.d.ts","sourceRoot":"","sources":["../../../src/FormoAnalyticsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAOZ,EAAE,EACH,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAsBvE,eAAO,MAAM,qBAAqB,gCACc,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,EAAE,EAAE,CAAC,2BAA2B,CAwBlE,CAAC;AAgMF,eAAO,MAAM,QAAQ,QAAO,eAmB3B,CAAC"}

package/lib/typescript/module/constants/config.d.ts

@@ -0,0 +1,8 @@
+export declare const EVENTS_API_ORIGIN = "https://events.formo.so";
+export declare const EVENTS_API_HOST = "https://events.formo.so/v0/raw_events";
+export declare const EVENTS_API_REQUEST_HEADER: (writeKey: string) => {
+    "Content-Type": string;
+    Authorization: string;
+};
+export declare const COUNTRY_LIST: Record<string, string>;
+//# sourceMappingURL=config.d.ts.map

package/lib/typescript/module/constants/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/constants/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,eAAO,MAAM,eAAe,0CAAuC,CAAC;AAEpE,eAAO,MAAM,yBAAyB,GAAI,UAAU,MAAM;;;CAGxD,CAAC;AAGH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoD/C,CAAC"}

package/lib/typescript/module/constants/events.d.ts

@@ -0,0 +1,24 @@
+export declare enum EventType {
+    PAGE = "page",
+    SCREEN = "screen",
+    IDENTIFY = "identify",
+    DETECT = "detect",
+    CONNECT = "connect",
+    DISCONNECT = "disconnect",
+    CHAIN = "chain",
+    SIGNATURE = "signature",
+    TRANSACTION = "transaction",
+    TRACK = "track"
+}
+export declare enum EventChannel {
+    WEB = "web",
+    MOBILE = "mobile",
+    SERVER = "server",
+    SOURCE = "source"
+}
+export type TEventType = Lowercase<EventType>;
+export type TEventChannel = Lowercase<EventChannel>;
+export declare const CHANNEL: TEventChannel;
+export declare const VERSION = "0";
+export declare const SESSION_TIMEOUT_MS: number;
+//# sourceMappingURL=events.d.ts.map

package/lib/typescript/module/constants/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/constants/events.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;CAChB;AAED,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;AAGpD,eAAO,MAAM,OAAO,EAAE,aAAwB,CAAC;AAC/C,eAAO,MAAM,OAAO,MAAM,CAAC;AAI3B,eAAO,MAAM,kBAAkB,QAAiB,CAAC"}

package/lib/typescript/module/constants/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./events";
+export * from "./config";
+export * from "./storage";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/lib/typescript/module/constants/storage.d.ts

@@ -0,0 +1,13 @@
+export declare const STORAGE_PREFIX = "formo_rn_";
+export declare const LOCAL_ANONYMOUS_ID_KEY = "anonymous_id";
+export declare const LOCAL_APP_VERSION_KEY = "app_version";
+export declare const LOCAL_APP_BUILD_KEY = "app_build";
+export declare const LOCAL_SESSION_ID_KEY = "session_id";
+export declare const LOCAL_SESSION_LAST_ACTIVITY_KEY = "session_last_activity";
+export declare const LOCAL_INSTALL_REFERRER_RESOLVED_KEY = "install_referrer_resolved";
+export declare const SESSION_USER_ID_KEY = "user_id";
+export declare const SESSION_TRAFFIC_SOURCE_KEY = "traffic_source";
+export declare const SESSION_WALLET_DETECTED_KEY = "wallet_detected";
+export declare const SESSION_WALLET_IDENTIFIED_KEY = "wallet_identified";
+export declare const CONSENT_OPT_OUT_KEY = "opt_out_tracking";
+//# sourceMappingURL=storage.d.ts.map

package/lib/typescript/module/constants/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/constants/storage.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,cAAc,CAAC;AAG1C,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAG/C,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,+BAA+B,0BAA0B,CAAC;AAGvE,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAG/E,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAC3D,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAC7D,eAAO,MAAM,6BAA6B,sBAAsB,CAAC;AAGjE,eAAO,MAAM,mBAAmB,qBAAqB,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Formo Analytics SDK for React Native
+ *
+ * Track wallet events and user analytics in mobile dApps
+ *
+ * @example
+ * ```tsx
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * import { FormoAnalyticsProvider, useFormo } from '@formo/analytics-react-native';
+ *
+ * // Wrap your app with the provider
+ * function App() {
+ *   return (
+ *     <FormoAnalyticsProvider
+ *       writeKey="your-write-key"
+ *       asyncStorage={AsyncStorage}
+ *       options={{
+ *         wagmi: { config, queryClient },
+ *         app: { name: 'MyApp', version: '1.0.0' },
+ *       }}
+ *     >
+ *       <YourApp />
+ *     </FormoAnalyticsProvider>
+ *   );
+ * }
+ *
+ * // Use the hook in your components
+ * function MyScreen() {
+ *   const formo = useFormo();
+ *
+ *   useEffect(() => {
+ *     formo.screen('Home');
+ *   }, []);
+ *
+ *   return <View>...</View>;
+ * }
+ * ```
+ */
+export { FormoAnalytics } from "./FormoAnalytics";
+export { FormoAnalyticsProvider, FormoAnalyticsContext, useFormo, } from "./FormoAnalyticsProvider";
+export * from "./types";
+export { SignatureStatus, TransactionStatus } from "./types/events";
+export type { AsyncStorageInterface } from "./lib/storage";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,QAAQ,GACT,MAAM,0BAA0B,CAAC;AAGlC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/module/lib/consent/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Set a consent flag
+ */
+export declare function setConsentFlag(writeKey: string, key: string, value: string): void;
+/**
+ * Get a consent flag
+ */
+export declare function getConsentFlag(writeKey: string, key: string): string | null;
+/**
+ * Remove a consent flag
+ */
+export declare function removeConsentFlag(writeKey: string, key: string): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/lib/consent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/consent/index.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAOrE"}

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

@@ -0,0 +1,99 @@
+import { Address, APIEvent, ChainID, IFormoEvent, IFormoEventContext, IFormoEventProperties, Nullable, Options, SignatureStatus, TransactionStatus } from "../../types";
+import { IEventFactory } from "./types";
+/**
+ * Get the current session id, or start a new one.
+ *
+ * A session persists across app restarts but expires after SESSION_TIMEOUT_MS of
+ * inactivity, at which point a fresh id is minted. Every call refreshes the
+ * last-activity marker.
+ *
+ * The mobile SDK owns its session_id rather than letting ingestion derive one.
+ * The events-gateway authorizer computes
+ * `hash(dailySalt + domain + sourceIp + userAgent)` — a design built for the
+ * web, where all three inputs carry real entropy. For a native app they all
+ * degenerate at once: there is no Origin header (so `domain` is the constant
+ * "unknown"), the HTTP User-Agent is the client library's (`okhttp/…`,
+ * `CFNetwork/… Darwin/…`) and is near-identical across users on the same app
+ * build, and carrier CGNAT puts many users behind one IP — so unrelated users
+ * collapse into a single session. Ingestion honours a body-provided session_id
+ * (`obj?.session_id || session_id` in handlerV0), which is the path used here.
+ */
+export declare function getSessionId(): string;
+/**
+ * Build a representative User-Agent string from structured device info.
+ *
+ * The ingestion pipeline classifies device / os / browser purely from the
+ * user_agent string; a mobile event with an empty UA is bucketed as "unknown".
+ * Platforms without a native UA (e.g. Expo, where DeviceInfo.getUserAgent() is
+ * unavailable) would otherwise report device=os=unknown. We synthesize a UA
+ * containing the tokens the classifier keys off (iphone/ipad/android + version)
+ * so mobile device and OS resolve correctly. Returns "" for unknown platforms.
+ */
+export declare function synthesizeUserAgent(info: {
+    os_name: string;
+    os_version: string;
+    device_model: string;
+    device_type: string;
+}): string;
+/**
+ * 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 as a page event for unified analytics.
+     * Maps screen name to page-equivalent context fields (page_title, page_path, page_url)
+     * so Tinybird materializations (process_sessions, process_sources) can process mobile
+     * screen views alongside web page views. The channel="mobile" distinguishes the source.
+     */
+    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, 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/module/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/module/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/module/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/module/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/module/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;IAgEhB;;;;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/module/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/module/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"}