@formo/analytics-react-native 0.1.0

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

@@ -0,0 +1,54 @@
+/**
+ * Wagmi types for React Native SDK
+ */
+export interface WagmiState {
+    status: "connecting" | "connected" | "disconnected" | "reconnecting";
+    connections: Map<string, {
+        accounts: readonly string[];
+        chainId: number;
+        connector: {
+            name: string;
+            /** Connector ID - for EIP-6963 injected wallets, this is typically the rdns */
+            id: string;
+            type?: string;
+            icon?: string;
+        };
+    }>;
+    current?: string;
+    chainId?: number;
+}
+export interface WagmiConfig {
+    subscribe: <T>(selector: (state: WagmiState) => T, listener: (selectedState: T, prevSelectedState: T) => void) => () => void;
+    getState?: () => WagmiState;
+    state?: WagmiState;
+}
+export interface QueryClient {
+    getMutationCache: () => MutationCache;
+}
+export interface MutationCache {
+    subscribe: (callback: (event: MutationCacheEvent) => void) => () => void;
+}
+export interface MutationCacheEvent {
+    type: "added" | "updated" | "removed";
+    mutation: {
+        mutationId: number;
+        options: {
+            mutationKey?: readonly string[];
+        };
+        state: {
+            status: "idle" | "pending" | "success" | "error";
+            data?: unknown;
+            error?: unknown;
+            variables?: Record<string, unknown>;
+        };
+    };
+}
+export type UnsubscribeFn = () => void;
+export interface WagmiTrackingState {
+    isProcessing: boolean;
+    lastAddress?: string;
+    lastChainId?: number;
+    lastStatus?: WagmiState["status"];
+}
+export type WagmiMutationKey = "signMessage" | "signTypedData" | "sendTransaction" | "writeContract";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/wagmi/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;IACrE,WAAW,EAAE,GAAG,CACd,MAAM,EACN;QACE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;YACb,+EAA+E;YAC/E,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CACF,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,CAAC,CAAC,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,CAAC,EAClC,QAAQ,EAAE,CAAC,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,KAAK,IAAI,KACvD,MAAM,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,UAAU,CAAC;IAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,aAAa,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC1E;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YACP,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;SACjC,CAAC;QACF,KAAK,EAAE;YACL,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;YACjD,IAAI,CAAC,EAAE,OAAO,CAAC;YACf,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACrC,CAAC;KACH,CAAC;CACH;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,eAAe,CAAC"}

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

@@ -0,0 +1,219 @@
+import { ReactNode } from "react";
+import { LogLevel } from "../lib/logger";
+import { IFormoEventContext, IFormoEventProperties, SignatureStatus, TransactionStatus } from "./events";
+export type Nullable<T> = T | null;
+export type ChainID = number;
+export type Address = string;
+export type ValidInputTypes = Uint8Array | bigint | string | number | boolean;
+export interface IFormoAnalytics {
+    screen(name: string, category?: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    reset(): void;
+    cleanup(): Promise<void>;
+    detect(params: {
+        rdns: string;
+        providerName: string;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    connect(params: {
+        chainId: ChainID;
+        address: Address;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    disconnect(params?: {
+        chainId?: ChainID;
+        address?: Address;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    chain(params: {
+        chainId: ChainID;
+        address?: Address;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    signature(params: {
+        status: SignatureStatus;
+        chainId?: ChainID;
+        address: Address;
+        message: string;
+        signatureHash?: string;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    transaction(params: {
+        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>;
+    identify(params: {
+        address: Address;
+        providerName?: string;
+        userId?: string;
+        rdns?: string;
+    }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    track(event: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
+    setTrafficSourceFromUrl(url: string): void;
+    optOutTracking(): void;
+    optInTracking(): void;
+    hasOptedOutTracking(): boolean;
+}
+export interface Config {
+    writeKey: string;
+}
+/**
+ * Configuration options for controlling tracking exclusions
+ */
+export interface TrackingOptions {
+    excludeChains?: ChainID[];
+}
+/**
+ * Configuration options for controlling wallet event autocapture
+ * All events are enabled by default unless explicitly set to false
+ */
+export interface AutocaptureOptions {
+    /**
+     * Track wallet connect events
+     * @default true
+     */
+    connect?: boolean;
+    /**
+     * Track wallet disconnect events
+     * @default true
+     */
+    disconnect?: boolean;
+    /**
+     * Track wallet signature events (personal_sign, eth_signTypedData_v4)
+     * @default true
+     */
+    signature?: boolean;
+    /**
+     * Track wallet transaction events (eth_sendTransaction)
+     * @default true
+     */
+    transaction?: boolean;
+    /**
+     * Track wallet chain change events
+     * @default true
+     */
+    chain?: boolean;
+    /**
+     * Track application lifecycle events (installed, updated, opened, backgrounded)
+     * @default true
+     */
+    lifecycle?: boolean;
+}
+/**
+ * Configuration options for Wagmi integration
+ * Allows the SDK to hook into Wagmi v2 wallet events
+ */
+export interface WagmiOptions {
+    /**
+     * Wagmi config instance from createConfig()
+     * The SDK will subscribe to this config's state changes to track wallet events
+     */
+    config: any;
+    /**
+     * Optional QueryClient instance from @tanstack/react-query
+     * Required for tracking signature and transaction events via mutation cache
+     * If not provided, only connection/disconnection/chain events will be tracked
+     */
+    queryClient?: any;
+}
+/**
+ * App information for context enrichment
+ */
+export interface AppInfo {
+    /**
+     * App name
+     */
+    name?: string;
+    /**
+     * App version
+     */
+    version?: string;
+    /**
+     * App build number
+     */
+    build?: string;
+    /**
+     * Bundle/package identifier
+     */
+    bundleId?: string;
+}
+/**
+ * Configuration options for custom referral query parameter parsing
+ */
+export interface ReferralOptions {
+    /**
+     * Custom query parameter names to check for referral codes
+     * These are checked in addition to the defaults: ref, referral, refcode, referrer_code
+     */
+    queryParams?: string[];
+    /**
+     * Path pattern for extracting referral codes from URL paths
+     */
+    pathPattern?: string;
+}
+export interface Options {
+    tracking?: boolean | TrackingOptions;
+    /**
+     * Control wallet event autocapture
+     * - `false`: Disable all wallet autocapture
+     * - `true`: Enable all wallet events (default)
+     * - `AutocaptureOptions`: Granular control over specific events
+     * @default true
+     */
+    autocapture?: boolean | AutocaptureOptions;
+    /**
+     * Wagmi integration configuration
+     * When provided, the SDK will hook into Wagmi's event system
+     * @requires wagmi@>=2.0.0
+     * @requires @tanstack/react-query@>=5.0.0 (for mutation tracking)
+     */
+    wagmi?: WagmiOptions;
+    /**
+     * Custom API host for sending events
+     */
+    apiHost?: string;
+    flushAt?: number;
+    flushInterval?: number;
+    retryCount?: number;
+    maxQueueSize?: number;
+    logger?: {
+        enabled?: boolean;
+        levels?: LogLevel[];
+    };
+    /**
+     * App information for context enrichment
+     */
+    app?: AppInfo;
+    /**
+     * Custom referral query parameter configuration
+     */
+    referral?: ReferralOptions;
+    /**
+     * Global error handler for SDK errors
+     */
+    errorHandler?: (err: Error) => void;
+    ready?: (formo: IFormoAnalytics) => void;
+}
+export interface FormoAnalyticsProviderProps {
+    writeKey: string;
+    options?: Options;
+    disabled?: boolean;
+    /**
+     * AsyncStorage instance from @react-native-async-storage/async-storage
+     * Required for persistent storage
+     */
+    asyncStorage?: import("../lib/storage").AsyncStorageInterface;
+    /**
+     * Callback when SDK is ready
+     * Note: Use useCallback to avoid re-initialization on every render
+     */
+    onReady?: (sdk: IFormoAnalytics) => void;
+    /**
+     * Callback when SDK initialization fails
+     * Note: Use useCallback to avoid re-initialization on every render
+     */
+    onError?: (error: Error) => void;
+    children: ReactNode;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/types/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEnC,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAG7B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,CACJ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAC9C,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,CACL,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAC9C,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CACR,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EACjD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CACH,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EAC/C,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,SAAS,CACP,MAAM,EAAE;QACN,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,WAAW,CACT,MAAM,EAAE;QACN,MAAM,EAAE,iBAAiB,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACzC,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,QAAQ,CACN,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CACH,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAG3C,cAAc,IAAI,IAAI,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC;IACtB,mBAAmB,IAAI,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,EAAE,GAAG,CAAC;IAEZ;;;;OAIG;IACH,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;IACrC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC3C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;KACrB,CAAC;IACF;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,gBAAgB,EAAE,qBAAqB,CAAC;IAC9D;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,SAAS,CAAC;CACrB"}

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

@@ -0,0 +1,111 @@
+import { Address, ChainID, Nullable } from "./base";
+import { TEventChannel, TEventType } from "../constants";
+export type AnonymousID = string;
+export interface ICommonProperties {
+    anonymous_id: AnonymousID;
+    user_id: Nullable<string>;
+    address: Nullable<string>;
+    type: TEventType;
+    channel: TEventChannel;
+    version: string;
+    original_timestamp: string;
+    event?: Nullable<string>;
+}
+export type IFormoEventProperties = Record<string, unknown>;
+export type IFormoEventContext = Record<string, unknown>;
+export type UTMParameters = {
+    utm_source: string;
+    utm_medium: string;
+    utm_campaign: string;
+    utm_term: string;
+    utm_content: string;
+};
+export type ITrafficSource = UTMParameters & {
+    ref: string;
+    referrer: string;
+};
+export interface IFormoEvent extends ICommonProperties {
+    context: Nullable<IFormoEventContext>;
+    properties: Nullable<IFormoEventProperties>;
+}
+export type IFormoEventPayload = IFormoEvent & {
+    message_id: string;
+};
+export interface ScreenAPIEvent {
+    type: "screen";
+    name: string;
+    category?: string;
+}
+export interface DetectAPIEvent {
+    type: "detect";
+    providerName: string;
+    rdns: string;
+}
+export interface IdentifyAPIEvent {
+    type: "identify";
+    address: string;
+    providerName: string;
+    rdns: string;
+    userId?: Nullable<string>;
+}
+export interface ChainAPIEvent {
+    type: "chain";
+    chainId: ChainID;
+    address: Address;
+}
+export interface TransactionAPIEvent {
+    type: "transaction";
+    status: TransactionStatus;
+    chainId: ChainID;
+    address: Address;
+    data?: string;
+    to?: string;
+    value?: string;
+    transactionHash?: string;
+    function_name?: string;
+    function_args?: Record<string, unknown>;
+}
+export interface SignatureAPIEvent {
+    type: "signature";
+    status: SignatureStatus;
+    chainId?: ChainID;
+    address: Address;
+    message: string;
+    signatureHash?: string;
+}
+export interface ConnectAPIEvent {
+    type: "connect";
+    chainId: ChainID;
+    address: Address;
+}
+export interface DisconnectAPIEvent {
+    type: "disconnect";
+    chainId?: ChainID;
+    address?: Address;
+}
+export interface TrackAPIEvent {
+    type: "track";
+    event: string;
+    volume?: number;
+    revenue?: number;
+    currency?: string;
+    points?: number;
+}
+export type APIEvent = {
+    properties?: IFormoEventProperties;
+    context?: IFormoEventContext;
+    callback?: (...args: unknown[]) => void;
+} & (ScreenAPIEvent | DetectAPIEvent | IdentifyAPIEvent | ChainAPIEvent | TransactionAPIEvent | SignatureAPIEvent | ConnectAPIEvent | DisconnectAPIEvent | TrackAPIEvent);
+export declare enum SignatureStatus {
+    REQUESTED = "requested",
+    REJECTED = "rejected",
+    CONFIRMED = "confirmed"
+}
+export declare enum TransactionStatus {
+    STARTED = "started",
+    REJECTED = "rejected",
+    BROADCASTED = "broadcasted",
+    CONFIRMED = "confirmed",
+    REVERTED = "reverted"
+}
+//# sourceMappingURL=events.d.ts.map

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

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

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

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

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

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

package/lib/typescript/utils/address.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Address validation and checksum utilities
+ *
+ * Uses ethereum-cryptography for proper EIP-55 checksum computation
+ */
+/**
+ * Check if a string is a valid Ethereum address
+ */
+export declare function isValidAddress(address: string): boolean;
+/**
+ * Convert address to EIP-55 checksum format
+ *
+ * Uses keccak256 from ethereum-cryptography for correct checksumming
+ * See: https://eips.ethereum.org/EIPS/eip-55
+ */
+export declare function toChecksumAddress(address: string): string;
+/**
+ * Get valid address or null
+ */
+export declare function getValidAddress(address: string | undefined | null): string | null;
+/**
+ * Check if address is in blocked list
+ */
+export declare function isBlockedAddress(address: string): boolean;
+//# sourceMappingURL=address.d.ts.map

package/lib/typescript/utils/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../src/utils/address.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACjC,MAAM,GAAG,IAAI,CAKf;AAWD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/lib/typescript/utils/hash.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generate a SHA-256 hash for event deduplication
+ * Returns full 64 hex chars to match web SDK format
+ */
+export declare function hash(input: string): Promise<string>;
+/**
+ * Generate a UUID v4
+ */
+export declare function generateUUID(): string;
+//# sourceMappingURL=hash.d.ts.map

package/lib/typescript/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Clamp a number between min and max values
+ */
+export declare function clampNumber(value: number, max: number, min: number): number;
+/**
+ * Check if value is undefined
+ */
+export declare function isUndefined(value: unknown): value is undefined;
+/**
+ * Convert object keys to snake_case (recursively handles nested objects and arrays)
+ * Preserves Date, Map, Set, RegExp, and other built-in objects unchanged
+ */
+export declare function toSnakeCase<T extends Record<string, unknown>>(obj: T): T;
+/**
+ * Deep merge two objects
+ */
+export declare function mergeDeepRight<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+/**
+ * Get action descriptor for logging
+ */
+export declare function getActionDescriptor(type: string, properties?: Record<string, unknown> | null): string;
+/**
+ * Check if error is a network error
+ */
+export declare function isNetworkError(error: unknown): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/typescript/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/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./address";
+export * from "./hash";
+export * from "./timestamp";
+export * from "./helpers";
+export * from "./trafficSource";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/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/utils/timestamp.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get current time in ISO format
+ */
+export declare function getCurrentTimeFormatted(): string;
+/**
+ * Format date to YYYY-MM-DD HH:mm format for hashing
+ */
+export declare function toDateHourMinute(date: Date): string;
+/**
+ * Convert milliseconds to seconds
+ */
+export declare function millisecondsToSecond(ms: number): number;
+//# sourceMappingURL=timestamp.d.ts.map

package/lib/typescript/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/trafficSource.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Traffic Source Utilities
+ * Parse UTM parameters and referral information from URLs
+ */
+import type { ITrafficSource } from "../types";
+/**
+ * Parse UTM parameters and referral info from URL
+ * Supports both web URLs (https://) and deep link URLs (myapp://)
+ */
+export declare function parseTrafficSource(url: string, customRefParams?: string[], pathPattern?: string): Partial<ITrafficSource>;
+/**
+ * Store traffic source in session storage
+ * Only stores if we have actual UTM or ref data
+ */
+export declare function storeTrafficSource(trafficSource: Partial<ITrafficSource>): void;
+/**
+ * Get stored traffic source from session
+ * Returns undefined if no traffic source is stored
+ */
+export declare function getStoredTrafficSource(): Partial<ITrafficSource> | undefined;
+/**
+ * Clear stored traffic source from session
+ */
+export declare function clearTrafficSource(): void;
+/**
+ * Merge stored traffic source with current context
+ * Stored traffic source is used as fallback - current context takes priority
+ */
+export declare function mergeWithStoredTrafficSource(context?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=trafficSource.d.ts.map

package/lib/typescript/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"}

package/lib/typescript/version.d.ts

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

package/lib/typescript/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"}