@formo/analytics 1.28.4 → 1.28.6

package/dist/esm/src/solana/storeTypes.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Type definitions for framework-kit's zustand store integration.
+ *
+ * These types mirror the state shape of @solana-foundation/framework-kit's
+ * vanilla zustand store, allowing the SDK to subscribe to wallet and
+ * transaction state changes without wrapping any wallet methods.
+ *
+ * @see https://github.com/solana-foundation/framework-kit
+ */
+/**
+ * The complete framework-kit client state shape.
+ * We only type the fields we subscribe to.
+ */
+export interface SolanaClientState {
+    transactions: SolanaTransactionState;
+    wallet: SolanaWalletStatus;
+    cluster: SolanaClusterState;
+    lastUpdatedAt: number;
+}
+/**
+ * Transaction records keyed by signature.
+ */
+export type SolanaTransactionState = Record<string, SolanaTransactionRecord>;
+/**
+ * Individual transaction record in the store.
+ */
+export interface SolanaTransactionRecord {
+    readonly error?: unknown;
+    readonly lastUpdatedAt: number;
+    readonly signature?: string;
+    readonly status: "idle" | "sending" | "waiting" | "confirmed" | "failed";
+}
+/**
+ * Wallet status — discriminated union.
+ */
+export type SolanaWalletStatus = SolanaWalletDisconnected | SolanaWalletConnecting | SolanaWalletConnected | SolanaWalletError;
+export interface SolanaWalletDisconnected {
+    readonly status: "disconnected";
+}
+export interface SolanaWalletConnecting {
+    readonly status: "connecting";
+    readonly connectorId: string;
+    readonly autoConnect?: boolean;
+}
+export interface SolanaWalletConnected {
+    readonly status: "connected";
+    readonly connectorId: string;
+    readonly session: SolanaWalletSession;
+    readonly autoConnect?: boolean;
+}
+export interface SolanaWalletError {
+    readonly status: "error";
+    readonly connectorId?: string;
+    readonly error: unknown;
+    readonly autoConnect?: boolean;
+}
+/**
+ * Wallet session — carries the connected wallet's capabilities and account.
+ */
+export interface SolanaWalletSession {
+    readonly account: SolanaWalletAccount;
+    readonly connector: SolanaWalletConnectorMetadata;
+    disconnect(): Promise<void>;
+}
+export interface SolanaWalletAccount {
+    readonly address: string;
+    readonly label?: string;
+    readonly publicKey?: unknown;
+}
+export interface SolanaWalletConnectorMetadata {
+    readonly id: string;
+    readonly name: string;
+    readonly icon?: string;
+}
+/**
+ * Cluster state from the store.
+ */
+export interface SolanaClusterState {
+    readonly endpoint: string;
+    readonly commitment?: string;
+    readonly status: "idle" | "connecting" | "ready" | "error";
+}
+/**
+ * The zustand vanilla store API that framework-kit exposes via `client.store`.
+ *
+ * Note: framework-kit's store uses vanilla zustand without the
+ * `subscribeWithSelector` middleware, so only the single-argument
+ * subscribe form (full-state listener) is supported.
+ */
+export interface SolanaClientStore {
+    getState(): SolanaClientState;
+    /**
+     * Subscribe to all state changes.
+     */
+    subscribe(listener: (state: SolanaClientState, prevState: SolanaClientState) => void): () => void;
+}
+/**
+ * Options for configuring the store-based Solana integration.
+ */
+export interface SolanaStoreOptions {
+    /**
+     * The framework-kit client store (client.store).
+     * This is a vanilla zustand store that tracks wallet, transaction, and cluster state.
+     */
+    store: SolanaClientStore;
+}
+//# sourceMappingURL=storeTypes.d.ts.map

package/dist/esm/src/solana/storeTypes.js

@@ -0,0 +1,11 @@
+/**
+ * Type definitions for framework-kit's zustand store integration.
+ *
+ * These types mirror the state shape of @solana-foundation/framework-kit's
+ * vanilla zustand store, allowing the SDK to subscribe to wallet and
+ * transaction state changes without wrapping any wallet methods.
+ *
+ * @see https://github.com/solana-foundation/framework-kit
+ */
+export {};
+//# sourceMappingURL=storeTypes.js.map

package/dist/esm/src/solana/types.d.ts

@@ -1,10 +1,10 @@
 /**
  * Solana-specific type definitions for wallet event tracking
  *
- * These types provide TypeScript interfaces for Solana Wallet Adapter integration,
- * allowing the SDK to hook into Solana wallet events to track wallet interactions.
+ * Core types for the Solana integration: cluster mappings, chain ID utilities,
+ * and configuration options. Framework-kit store types are in storeTypes.ts.
  *
- * @see https://github.com/anza-xyz/wallet-adapter
+ * @see https://github.com/solana-foundation/framework-kit
  */
 /**
  * Solana cluster/network types
@@ -33,7 +33,7 @@ export declare const DEFAULT_SOLANA_CHAIN_ID: number;
 export declare function isSolanaChainId(chainId: number | undefined | null): boolean;
 /**
  * Solana PublicKey interface
- * Represents a Solana public key (32 bytes, Base58 encoded)
+ * Used by address validation utilities.
  */
 export interface SolanaPublicKey {
     toBase58(): string;
@@ -42,165 +42,34 @@ export interface SolanaPublicKey {
     equals(other: SolanaPublicKey): boolean;
 }
 /**
- * Solana transaction signature (64 bytes, Base58 encoded)
- */
-export type TransactionSignature = string;
-/**
- * Solana wallet adapter state
- */
-export type WalletAdapterState = "connected" | "disconnected" | "connecting" | "disconnecting";
-/**
- * Solana wallet adapter interface
- * Based on @solana/wallet-adapter-base WalletAdapter
- */
-export interface ISolanaAdapter {
-    name: string;
-    url: string;
-    icon: string;
-    readyState: WalletReadyState;
-    publicKey: SolanaPublicKey | null;
-    connecting: boolean;
-    connected: boolean;
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    sendTransaction?(transaction: SolanaTransaction, connection: SolanaConnection, options?: SendTransactionOptions): Promise<TransactionSignature>;
-    signTransaction?(transaction: SolanaTransaction): Promise<SolanaTransaction>;
-    signAllTransactions?(transactions: SolanaTransaction[]): Promise<SolanaTransaction[]>;
-    signMessage?(message: Uint8Array): Promise<Uint8Array>;
-    on(event: "connect", listener: (publicKey: SolanaPublicKey) => void): void;
-    on(event: "disconnect", listener: () => void): void;
-    on(event: "error", listener: (error: WalletError) => void): void;
-    on(event: "readyStateChange", listener: (readyState: WalletReadyState) => void): void;
-    off(event: string, listener: (...args: unknown[]) => void): void;
-    removeAllListeners?(event?: string): void;
-}
-/**
- * Solana wallet ready state
- */
-export declare enum WalletReadyState {
-    Installed = "Installed",
-    NotDetected = "NotDetected",
-    Loadable = "Loadable",
-    Unsupported = "Unsupported"
-}
-/**
- * Solana wallet error
- */
-export interface WalletError extends Error {
-    error?: unknown;
-}
-/**
- * Solana transaction interface (minimal)
- */
-export interface SolanaTransaction {
-    signature?: Uint8Array;
-    serialize(): Uint8Array;
-    feePayer?: SolanaPublicKey;
-    recentBlockhash?: string;
-}
-/**
- * Solana connection interface (minimal)
- */
-export interface SolanaConnection {
-    rpcEndpoint: string;
-    commitment?: string;
-    getSignatureStatus?(signature: string): Promise<{
-        value: SignatureStatus | null;
-    }>;
-    getSignatureStatuses?(signatures: string[]): Promise<{
-        value: (SignatureStatus | null)[];
-    }>;
-}
-/**
- * Solana signature status
- */
-export interface SignatureStatus {
-    slot: number;
-    confirmations: number | null;
-    err: unknown | null;
-    confirmationStatus?: "processed" | "confirmed" | "finalized";
-}
-/**
- * Send transaction options
- */
-export interface SendTransactionOptions {
-    skipPreflight?: boolean;
-    preflightCommitment?: string;
-    maxRetries?: number;
-    minContextSlot?: number;
-}
-/**
- * Wallet entry as returned by @solana/wallet-adapter-react useWallet().wallet
- * This is { adapter, readyState }, not a direct adapter.
- */
-export interface SolanaWalletEntry {
-    adapter: ISolanaAdapter;
-    readyState: WalletReadyState;
-}
-/**
- * @deprecated Use SolanaWalletEntry instead
- */
-export type SolanaWallet = SolanaWalletEntry;
-/**
- * Solana Wallet Context interface
- * Based on @solana/wallet-adapter-react useWallet hook
- * @see https://github.com/anza-xyz/wallet-adapter/blob/master/packages/core/react/src/useWallet.ts
+ * Unsubscribe function type
  */
-export interface SolanaWalletContext {
-    autoConnect: boolean;
-    wallets: SolanaWalletEntry[];
-    wallet: SolanaWalletEntry | null;
-    publicKey: SolanaPublicKey | null;
-    connecting: boolean;
-    connected: boolean;
-    disconnecting: boolean;
-    select(walletName: string | null): void;
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    sendTransaction(transaction: SolanaTransaction, connection: SolanaConnection, options?: SendTransactionOptions): Promise<TransactionSignature>;
-    signTransaction?(transaction: SolanaTransaction): Promise<SolanaTransaction>;
-    signAllTransactions?(transactions: SolanaTransaction[]): Promise<SolanaTransaction[]>;
-    signMessage?(message: Uint8Array): Promise<Uint8Array>;
-}
+export type UnsubscribeFn = () => void;
 /**
  * Solana options for FormoAnalytics
  */
 export interface SolanaOptions {
     /**
-     * The Solana wallet adapter instance or wallet context
-     * Can be a single wallet adapter or the useWallet() context
-     */
-    wallet?: ISolanaAdapter | SolanaWalletContext;
-    /**
-     * The Solana connection for tracking transaction confirmations
+     * The framework-kit client store (client.store) for automatic event tracking.
+     * When provided, wallet connect/disconnect and transaction events are tracked
+     * automatically by subscribing to zustand store state changes.
+     *
+     * This is the recommended approach for apps using @solana-foundation/framework-kit.
+     *
+     * @example
+     * ```tsx
+     * import { createClient } from '@solana-foundation/framework-kit';
+     * const client = createClient({ endpoint, walletConnectors: autoDiscover() });
+     * const formo = await Formo.init(writeKey, { solana: { store: client.store } });
+     * ```
      */
-    connection?: SolanaConnection;
+    store?: import("./storeTypes").SolanaClientStore;
     /**
-     * The Solana cluster/network
-     * @default "mainnet-beta"
+     * The Solana cluster/network.
+     * Usually auto-detected from the store's endpoint URL.
+     * Only needed for custom RPC URLs that don't contain a recognizable cluster name.
+     * @default auto-detected, or "mainnet-beta" if detection fails
      */
     cluster?: SolanaCluster;
 }
-/**
- * Internal connection state for Solana event handler.
- * Tracks the last known wallet connection for disconnect event payloads
- * and provides a reentrancy guard for concurrent event handling.
- */
-export interface SolanaConnectionState {
-    lastAddress?: string;
-    lastChainId?: number;
-    isProcessing: boolean;
-}
-/**
- * Unsubscribe function type
- */
-export type UnsubscribeFn = () => void;
-/**
- * Check if an object is a SolanaWalletContext (has wallets array)
- */
-export declare function isSolanaWalletContext(obj: ISolanaAdapter | SolanaWalletContext | undefined | null): obj is SolanaWalletContext;
-/**
- * Check if an object is a ISolanaAdapter
- */
-export declare function isSolanaAdapter(obj: ISolanaAdapter | SolanaWalletContext | undefined | null): obj is ISolanaAdapter;
 //# sourceMappingURL=types.d.ts.map

package/dist/esm/src/solana/types.js

@@ -1,10 +1,10 @@
 /**
  * Solana-specific type definitions for wallet event tracking
  *
- * These types provide TypeScript interfaces for Solana Wallet Adapter integration,
- * allowing the SDK to hook into Solana wallet events to track wallet interactions.
+ * Core types for the Solana integration: cluster mappings, chain ID utilities,
+ * and configuration options. Framework-kit store types are in storeTypes.ts.
  *
- * @see https://github.com/anza-xyz/wallet-adapter
+ * @see https://github.com/solana-foundation/framework-kit
  */
 /**
  * Mapping of Solana clusters to numeric chain IDs for consistency with EVM events
@@ -40,35 +40,4 @@ export function isSolanaChainId(chainId) {
         return false;
     return Object.values(SOLANA_CHAIN_IDS).includes(chainId);
 }
-/**
- * Solana wallet ready state
- */
-export var WalletReadyState;
-(function (WalletReadyState) {
-    WalletReadyState["Installed"] = "Installed";
-    WalletReadyState["NotDetected"] = "NotDetected";
-    WalletReadyState["Loadable"] = "Loadable";
-    WalletReadyState["Unsupported"] = "Unsupported";
-})(WalletReadyState || (WalletReadyState = {}));
-/**
- * Check if an object is a SolanaWalletContext (has wallets array)
- */
-export function isSolanaWalletContext(obj) {
-    return (obj !== null &&
-        obj !== undefined &&
-        typeof obj === "object" &&
-        "wallets" in obj &&
-        Array.isArray(obj.wallets));
-}
-/**
- * Check if an object is a ISolanaAdapter
- */
-export function isSolanaAdapter(obj) {
-    return (obj !== null &&
-        obj !== undefined &&
-        typeof obj === "object" &&
-        "name" in obj &&
-        "connect" in obj &&
-        !("wallets" in obj));
-}
 //# sourceMappingURL=types.js.map

package/dist/esm/src/storage/StorageManager.d.ts

@@ -5,5 +5,6 @@ export declare class StorageManager {
     constructor(writeKey: string);
     getStorage(type: StorageType): IStorage;
     private createStorage;
+    private getWebStorage;
 }
 //# sourceMappingURL=StorageManager.d.ts.map

package/dist/esm/src/storage/StorageManager.js

@@ -41,14 +41,22 @@ var StorageManager = /** @class */ (function () {
             case "cookieStorage":
                 return new CookieStorage(this.writeKey);
             case "localStorage":
-                return new WebStorage(this.writeKey, localStorage);
             case "sessionStorage":
-                return new WebStorage(this.writeKey, sessionStorage);
+                return new WebStorage(this.writeKey, this.getWebStorage(type));
             case "memoryStorage":
             default:
                 return new MemoryStorage(this.writeKey);
         }
     };
+    StorageManager.prototype.getWebStorage = function (type) {
+        try {
+            var storage = type === "localStorage" ? localStorage : sessionStorage;
+            return storage !== null && storage !== void 0 ? storage : null;
+        }
+        catch (_a) {
+            return null;
+        }
+    };
     return StorageManager;
 }());
 export { StorageManager };

package/dist/esm/src/types/base.d.ts

@@ -164,6 +164,14 @@ export interface Options {
      * @default true
      */
     autocapture?: boolean | AutocaptureOptions;
+    /**
+     * EVM provider tracking.
+     * Set to `false` to disable all EVM provider detection and tracking
+     * (EIP-1193, EIP-6963, window.ethereum). Useful for Solana-only apps
+     * that don't need EVM wallet event capture.
+     * @default true
+     */
+    evm?: boolean;
     /**
      * Wagmi integration configuration
      * When provided, the SDK will hook into Wagmi's event system instead of wrapping EIP-1193 providers
@@ -173,11 +181,14 @@ export interface Options {
      */
     wagmi?: WagmiOptions;
     /**
-     * Solana Wallet Adapter integration configuration
-     * When provided, the SDK will track Solana wallet events in addition to EVM wallet events
-     * This works alongside EIP-1193/Wagmi tracking - you can track both EVM and Solana wallets
-     * @requires @solana/wallet-adapter-base (optional peer dependency)
-     * @requires @solana/wallet-adapter-react (optional peer dependency, for React apps)
+     * Solana integration configuration.
+     * Pass `store: client.store` from framework-kit for automatic tracking of
+     * wallet connect/disconnect and transaction events.
+     *
+     * For signMessage/signTransaction, use formo.signature() directly
+     * (framework-kit doesn't track these in the store).
+     *
+     * @see https://github.com/solana-foundation/framework-kit
      */
     solana?: SolanaOptions;
     /**

package/dist/esm/src/version.d.ts

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

package/dist/esm/src/version.js

@@ -1,4 +1,4 @@
 // This file is auto-generated by scripts/update-version.js during npm version
 // Do not edit manually - it will be overwritten
-export var version = '1.28.4';
+export var version = '1.28.6';
 //# sourceMappingURL=version.js.map