@formo/analytics-react-native 0.1.4 → 1.0.0

package/lib/typescript/module/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, 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/module/lib/event/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/event/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,MAAM,CACJ,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,yBAAyB,CACvB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,qBAAqB,CACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,oBAAoB,CAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,uBAAuB,CACrB,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,OAAO,EACjB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,yBAAyB,CACvB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,sBAAsB,CACpB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,wBAAwB,CACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,kBAAkB,CAChB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CACL,KAAK,EAAE,WAAW,EAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

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

@@ -0,0 +1,39 @@
+/**
+ * Install Referrer / attribution capture (Android)
+ *
+ * Populates the existing traffic source fields (utm_source, utm_medium,
+ * utm_campaign, utm_term, utm_content, ref, referrer) from the Google Play
+ * Install Referrer on first launch. This is what enables web-to-mobile
+ * attribution: a user who tapped a link on example.com before installing shows
+ * up with that referrer on their first events (see P-2207).
+ *
+ * - Android: Google Play Install Referrer API via react-native-play-install-referrer
+ *   (optional peer dep). Returns a URL-encoded query string like
+ *   "utm_source=example.com&utm_campaign=spring_sale&..." which we parse with
+ *   parseTrafficSource.
+ *
+ * - iOS: NOT supported. Apple exposes no install-referrer API, so an install
+ *   cannot be attributed to a referring website from the SDK. Doing so requires
+ *   a third-party attribution service (Branch/AppsFlyer) or fingerprint
+ *   matching — out of scope. On iOS this capture is a no-op.
+ *
+ * The native module is lazy-required and capture silently no-ops when it is not
+ * installed (keeps Expo Go and minimal integrations working).
+ *
+ * Result is merged with mergeTrafficSourceFill so a deep link that arrived
+ * via Linking.getInitialURL() takes precedence over install-referrer data.
+ *
+ * The resolution is one-shot: on success we set LOCAL_INSTALL_REFERRER_RESOLVED_KEY
+ * so we never call the native API again (Play returns meaningful data only on
+ * the first fetch).
+ */
+export interface CaptureOptions {
+    customRefParams?: string[];
+    pathPattern?: string;
+}
+/**
+ * Capture install-time attribution and merge into the stored traffic source.
+ * One-shot: returns immediately if already resolved on a previous launch.
+ */
+export declare function captureInstallReferrer(options?: CaptureOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/installReferrer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA0CH,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/lib/typescript/module/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/module/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;AAWH,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;IAkDnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/lib/typescript/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/lib/wagmi/WagmiEventHandler.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 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;
+    }): 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/module/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;KACjB,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;IAsE/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/module/lib/wagmi/index.d.ts

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

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

package/lib/typescript/module/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/module/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/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/module/solana/address.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Solana address validation utilities
+ *
+ * Solana uses Base58 encoded 32-byte public keys as addresses.
+ * Format: FDKJvWcJNe6wecbgDYDFPCfgs14aJnVsUfWQRYWLn4Tn (32-44 characters)
+ *
+ * @see https://solana.com/developers/courses/intro-to-solana/interact-with-wallets
+ */
+import { SolanaPublicKey } from "./types";
+/**
+ * System program addresses and other special Solana addresses
+ * These are valid addresses but may not represent user wallets
+ */
+export declare const SOLANA_SYSTEM_ADDRESSES: {
+    readonly SYSTEM_PROGRAM: "11111111111111111111111111111111";
+    readonly TOKEN_PROGRAM: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+    readonly TOKEN_2022_PROGRAM: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+    readonly ASSOCIATED_TOKEN_PROGRAM: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+    readonly RENT_SYSVAR: "SysvarRent111111111111111111111111111111111";
+    readonly CLOCK_SYSVAR: "SysvarC1ock11111111111111111111111111111111";
+};
+/**
+ * Check if a string is a valid Solana address format
+ *
+ * Performs format validation only (length and character set). Does not
+ * verify that the address is a valid point on the Ed25519 curve.
+ */
+export declare function isSolanaAddress(value: unknown): value is string;
+/**
+ * Get a valid Solana address from a string or PublicKey
+ */
+export declare function getValidSolanaAddress(address: string | SolanaPublicKey | null | undefined): string | null;
+/**
+ * Check if a Solana address is a system program or well-known program address
+ */
+export declare function isSolanaSystemAddress(address: string): boolean;
+/**
+ * Check if a Solana address is blocked (should not emit events).
+ * Blocks system program addresses since they don't represent user wallets.
+ */
+export declare function isBlockedSolanaAddress(address: string | SolanaPublicKey | null | undefined): boolean;
+//# sourceMappingURL=address.d.ts.map

package/lib/typescript/module/solana/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../../src/solana/address.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAa1C;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;CAO1B,CAAC;AAWX;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAe/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,GAAG,SAAS,GACnD,MAAM,GAAG,IAAI,CAoBf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAS9D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,GAAG,SAAS,GACnD,OAAO,CAOT"}

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

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

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

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