@n1xyz/wallet-widget 0.0.4 → 0.0.5

package/dist/WalletConnectionFlow/constants.js

@@ -0,0 +1,223 @@
+import { FlowState } from './types';
+export var ANIMATION_EASE = 'cubic-bezier(0.16, 1, 0.3, 1)';
+export var TYPING_INTERVAL = 50;
+export var ANIMATION_DURATION = 3000;
+export var MIN_DEPOSIT = 1;
+export var MAX_DEPOSIT = 10000;
+export var INITIAL_APPS = Array.from({ length: 20 }, function (_, i) { return ({
+    name: "App".concat(i + 1),
+    color: '#ff2b1f',
+    progress: 0,
+}); });
+/**
+ * Available chains for deposit
+ */
+export var AVAILABLE_CHAINS = [
+    {
+        id: 'ethereum',
+        name: 'Ethereum',
+        logo: 'ethereum-logo.svg',
+    },
+    {
+        id: 'solana',
+        name: 'Solana',
+        logo: 'solana-logo.svg',
+    },
+];
+export var CHAINS = [
+    {
+        id: 'ethereum',
+        name: 'Ethereum',
+        logo: '/images/chains/ethereum.svg',
+    },
+    {
+        id: 'polygon',
+        name: 'Polygon',
+        logo: '/images/chains/polygon.svg',
+    },
+    {
+        id: 'arbitrum',
+        name: 'Arbitrum',
+        logo: '/images/chains/arbitrum.svg',
+    },
+    {
+        id: 'optimism',
+        name: 'Optimism',
+        logo: '/images/chains/optimism.svg',
+    },
+];
+/**
+ * State machine transitions
+ * Defines all possible transitions between states and their conditions
+ */
+export var STATE_TRANSITIONS = [
+    // From IDLE state
+    {
+        from: FlowState.IDLE,
+        to: FlowState.CONNECTING_WALLET,
+        condition: function (context) { return !context.walletType; }, // Only if wallet is not connected
+    },
+    {
+        from: FlowState.IDLE,
+        to: FlowState.WALLET_CONNECTED,
+        condition: function (context) { return !!context.walletType; }, // If wallet is already connected
+    },
+    // From CONNECTING_WALLET state
+    {
+        from: FlowState.CONNECTING_WALLET,
+        to: FlowState.WALLET_CONNECTED,
+        // When wallet connection is successful
+    },
+    {
+        from: FlowState.CONNECTING_WALLET,
+        to: FlowState.ERROR,
+        // When wallet connection fails
+    },
+    // From WALLET_CONNECTED state
+    {
+        from: FlowState.WALLET_CONNECTED,
+        to: FlowState.ETH_TO_SOL_AUTH,
+        condition: function (context) { return context.walletType === 'ethereum'; }, // If Ethereum wallet
+    },
+    {
+        from: FlowState.WALLET_CONNECTED,
+        to: FlowState.CHAIN_SELECTION,
+        condition: function (context) {
+            return context.walletType === 'solana' && !context.hasNordAccount;
+        }, // If Solana wallet and no Nord account
+    },
+    {
+        from: FlowState.WALLET_CONNECTED,
+        to: FlowState.NORD_AUTH,
+        condition: function (context) {
+            return context.walletType === 'solana' &&
+                context.hasNordAccount &&
+                !context.hasActiveSession;
+        },
+        // If Solana wallet, has Nord account but no active session
+    },
+    {
+        from: FlowState.WALLET_CONNECTED,
+        to: FlowState.FINAL_SUCCESS,
+        condition: function (context) {
+            return context.walletType === 'solana' &&
+                context.hasNordAccount &&
+                context.hasActiveSession;
+        },
+        // If Solana wallet, has Nord account and active session
+    },
+    // From ETH_TO_SOL_AUTH state
+    {
+        from: FlowState.ETH_TO_SOL_AUTH,
+        to: FlowState.CHAIN_SELECTION,
+        condition: function (context) { return !context.hasNordAccount; }, // After ETH auth, if no Nord account
+    },
+    {
+        from: FlowState.ETH_TO_SOL_AUTH,
+        to: FlowState.NORD_AUTH,
+        condition: function (context) { return context.hasNordAccount && !context.hasActiveSession; },
+        // After ETH auth, if has Nord account but no active session
+    },
+    {
+        from: FlowState.ETH_TO_SOL_AUTH,
+        to: FlowState.FINAL_SUCCESS,
+        condition: function (context) { return context.hasNordAccount && context.hasActiveSession; },
+        // After ETH auth, if has Nord account and active session
+    },
+    {
+        from: FlowState.ETH_TO_SOL_AUTH,
+        to: FlowState.ERROR,
+        // If ETH to SOL auth fails
+    },
+    // From CHAIN_SELECTION state
+    {
+        from: FlowState.CHAIN_SELECTION,
+        to: FlowState.AMOUNT_INPUT,
+        // After chain selection
+    },
+    // From AMOUNT_INPUT state
+    {
+        from: FlowState.AMOUNT_INPUT,
+        to: FlowState.DEPOSIT_PROGRESS,
+        // After amount input
+    },
+    {
+        from: FlowState.AMOUNT_INPUT,
+        to: FlowState.CHAIN_SELECTION,
+        // If user goes back to chain selection
+    },
+    // From DEPOSIT_PROGRESS state
+    {
+        from: FlowState.DEPOSIT_PROGRESS,
+        to: FlowState.DEPOSIT_SUCCESS,
+        // When deposit is successful
+    },
+    {
+        from: FlowState.DEPOSIT_PROGRESS,
+        to: FlowState.ERROR,
+        // When deposit fails
+    },
+    // From DEPOSIT_SUCCESS state
+    {
+        from: FlowState.DEPOSIT_SUCCESS,
+        to: FlowState.NORD_AUTH,
+        condition: function (context) { return !context.hasActiveSession; }, // If no active Nord session
+    },
+    {
+        from: FlowState.DEPOSIT_SUCCESS,
+        to: FlowState.FINAL_SUCCESS,
+        condition: function (context) { return context.hasActiveSession; }, // If active Nord session exists
+    },
+    // From NORD_AUTH state
+    {
+        from: FlowState.NORD_AUTH,
+        to: FlowState.AUTH_LOADING,
+        // When Nord auth starts
+    },
+    {
+        from: FlowState.NORD_AUTH,
+        to: FlowState.ERROR,
+        // When Nord auth fails to start
+    },
+    // From AUTH_LOADING state
+    {
+        from: FlowState.AUTH_LOADING,
+        to: FlowState.FINAL_SUCCESS,
+        // When auth is successful
+    },
+    {
+        from: FlowState.AUTH_LOADING,
+        to: FlowState.ERROR,
+        // When auth fails
+    },
+    // From ERROR state
+    {
+        from: FlowState.ERROR,
+        to: FlowState.IDLE,
+        // When restarting after error
+    },
+    // Global recovery transition (can happen from any state upon recovery)
+    {
+        from: [
+            FlowState.CONNECTING_WALLET,
+            FlowState.WALLET_CONNECTED,
+            FlowState.ETH_TO_SOL_AUTH,
+            FlowState.CHAIN_SELECTION,
+            FlowState.AMOUNT_INPUT,
+            FlowState.DEPOSIT_PROGRESS,
+            FlowState.DEPOSIT_SUCCESS,
+            FlowState.NORD_AUTH,
+            FlowState.AUTH_LOADING,
+        ],
+        to: FlowState.IDLE,
+        // For recovery after interruption
+    },
+];
+/**
+ * Local storage key for persisting flow state
+ */
+export var FLOW_STATE_STORAGE_KEY = 'n1_wallet_connection_flow_state';
+/**
+ * Time in milliseconds after which a persisted state is considered stale
+ */
+export var STATE_EXPIRY_TIME = 30 * 60 * 1000; // 30 minutes

package/dist/WalletConnectionFlow/hooks/index.d.ts

@@ -0,0 +1,8 @@
+export * from './useNordSession';
+export * from './useDepositFlow';
+export * from './useWalletConnect';
+export * from './useInterruptHandler';
+export * from './useFlowState';
+export * from './useWaitingMessage';
+export * from './useTableValues';
+export * from './useButtonTyping';

package/dist/WalletConnectionFlow/hooks/index.js

@@ -0,0 +1,8 @@
+export * from './useNordSession';
+export * from './useDepositFlow';
+export * from './useWalletConnect';
+export * from './useInterruptHandler';
+export * from './useFlowState';
+export * from './useWaitingMessage';
+export * from './useTableValues';
+export * from './useButtonTyping';

package/dist/WalletConnectionFlow/hooks/useButtonTyping.d.ts

@@ -0,0 +1,7 @@
+import { Dispatch, SetStateAction } from 'react';
+import { ButtonKey, ButtonStates } from '../types';
+interface ButtonConfig {
+    text: string;
+}
+export declare function useButtonTyping(buttonStates: ButtonStates, setButtonStates: Dispatch<SetStateAction<ButtonStates>>, buttonConfigs?: Record<ButtonKey, ButtonConfig>): void;
+export {};

package/dist/WalletConnectionFlow/hooks/useButtonTyping.js

@@ -0,0 +1,43 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { useEffect } from 'react';
+import { TYPING_INTERVAL } from '../constants';
+var DEFAULT_BUTTON_CONFIGS = {
+    deposit: { text: 'Deposit' },
+    continue: { text: 'Continue' },
+    openApp: { text: 'Launch' },
+};
+export function useButtonTyping(buttonStates, setButtonStates, buttonConfigs) {
+    if (buttonConfigs === void 0) { buttonConfigs = DEFAULT_BUTTON_CONFIGS; }
+    useEffect(function () {
+        Object.entries(buttonStates).forEach(function (_a) {
+            var key = _a[0], state = _a[1];
+            if (state.isTyping) {
+                var config_1 = buttonConfigs[key];
+                var index_1 = 0;
+                var interval_1 = setInterval(function () {
+                    if (index_1 <= config_1.text.length) {
+                        setButtonStates(function (prev) {
+                            var _a;
+                            return (__assign(__assign({}, prev), (_a = {}, _a[key] = __assign(__assign({}, prev[key]), { text: config_1.text.slice(0, index_1) }), _a)));
+                        });
+                        index_1++;
+                    }
+                    else {
+                        clearInterval(interval_1);
+                    }
+                }, TYPING_INTERVAL);
+                return function () { return clearInterval(interval_1); };
+            }
+        });
+    }, [buttonStates, setButtonStates, buttonConfigs]);
+}

package/dist/WalletConnectionFlow/hooks/useDepositFlow.d.ts

@@ -0,0 +1,38 @@
+import { FlowContext, FlowState } from '../types';
+/**
+ * Hook for handling the deposit flow
+ *
+ * @param options Configuration options
+ * @returns Deposit flow methods and state
+ */
+export declare const useDepositFlow: (options: {
+    /**
+     * Flow state
+     */
+    state: FlowState;
+    /**
+     * Flow context
+     */
+    context: FlowContext;
+    /**
+     * Transition to a new state
+     */
+    transition: (newState: FlowState, contextUpdates?: Partial<FlowContext>) => boolean;
+    /**
+     * Handle errors
+     */
+    handleError: (error: Error) => void;
+    /**
+     * Update context
+     */
+    updateContext?: (contextUpdates: Partial<FlowContext>) => void;
+}) => {
+    selectedChain: string | null;
+    amount: string;
+    isDepositing: boolean;
+    transactionId: string | null;
+    selectChain: (chainId: string) => void;
+    updateAmount: (newAmount: string) => void;
+    startDeposit: () => Promise<void>;
+    goBackToChainSelection: () => void;
+};

package/dist/WalletConnectionFlow/hooks/useDepositFlow.js

@@ -0,0 +1,166 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { useCallback, useEffect, useState } from 'react';
+import { FlowState } from '../types';
+import { AVAILABLE_CHAINS } from '../constants';
+/**
+ * Hook for handling the deposit flow
+ *
+ * @param options Configuration options
+ * @returns Deposit flow methods and state
+ */
+export var useDepositFlow = function (options) {
+    var state = options.state, context = options.context, transition = options.transition, handleError = options.handleError;
+    var _a = useState(context.selectedChain), selectedChain = _a[0], setSelectedChain = _a[1];
+    var _b = useState(context.amount), amount = _b[0], setAmount = _b[1];
+    var _c = useState(false), isDepositing = _c[0], setIsDepositing = _c[1];
+    var _d = useState(context.transactionId), transactionId = _d[0], setTransactionId = _d[1];
+    /**
+     * Select a chain for deposit
+     */
+    var selectChain = useCallback(function (chainId) {
+        var validChain = AVAILABLE_CHAINS.find(function (chain) { return chain.id === chainId; });
+        if (!validChain) {
+            handleError(new Error("Invalid chain: ".concat(chainId)));
+            return;
+        }
+        setSelectedChain(chainId);
+        transition(FlowState.AMOUNT_INPUT, { selectedChain: chainId });
+    }, [transition, handleError]);
+    /**
+     * Update amount for deposit
+     */
+    var updateAmount = useCallback(function (newAmount) {
+        setAmount(newAmount);
+        // Only update the context without transitioning to the same state
+        // This prevents the "Transition from AMOUNT_INPUT to AMOUNT_INPUT is not allowed" error
+        if (state === FlowState.AMOUNT_INPUT) {
+            // Use updateContext function if available to update without state transition
+            if (options.updateContext) {
+                options.updateContext({ amount: newAmount });
+            }
+        }
+        else {
+            transition(state, { amount: newAmount });
+        }
+    }, [state, transition, options.updateContext]);
+    /**
+     * Start deposit process
+     */
+    var startDeposit = useCallback(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            if (isDepositing)
+                return [2 /*return*/];
+            // Validate input
+            if (!selectedChain) {
+                handleError(new Error('No chain selected'));
+                return [2 /*return*/];
+            }
+            if (!amount || parseFloat(amount) <= 0) {
+                handleError(new Error('Invalid amount'));
+                return [2 /*return*/];
+            }
+            setIsDepositing(true);
+            transition(FlowState.DEPOSIT_PROGRESS);
+            try {
+                // In the real implementation, this would call the API to initiate the deposit
+                // For now, simulate the deposit with a timeout
+                setTimeout(function () {
+                    // Generate a mock transaction ID
+                    var mockTxId = "tx_".concat(Math.random().toString(36).substr(2, 9));
+                    setTransactionId(mockTxId);
+                    // Update context and transition to success
+                    transition(FlowState.DEPOSIT_SUCCESS, { transactionId: mockTxId });
+                    setIsDepositing(false);
+                }, 3000);
+            }
+            catch (error) {
+                setIsDepositing(false);
+                handleError(error instanceof Error ? error : new Error('Failed to process deposit'));
+            }
+            return [2 /*return*/];
+        });
+    }); }, [isDepositing, selectedChain, amount, transition, handleError]);
+    /**
+     * Go back to chain selection
+     */
+    var goBackToChainSelection = useCallback(function () {
+        setAmount('');
+        transition(FlowState.CHAIN_SELECTION, { amount: '' });
+    }, [transition]);
+    /**
+     * Update state based on context changes
+     */
+    useEffect(function () {
+        if (context.selectedChain !== selectedChain) {
+            setSelectedChain(context.selectedChain);
+        }
+        if (context.amount !== amount) {
+            setAmount(context.amount);
+        }
+        if (context.transactionId !== transactionId) {
+            setTransactionId(context.transactionId);
+        }
+    }, [
+        context.selectedChain,
+        context.amount,
+        context.transactionId,
+        selectedChain,
+        amount,
+        transactionId,
+    ]);
+    /**
+     * Auto-start deposit if in deposit progress state
+     */
+    useEffect(function () {
+        if (state === FlowState.DEPOSIT_PROGRESS &&
+            !isDepositing &&
+            !transactionId) {
+            startDeposit();
+        }
+    }, [state, isDepositing, transactionId, startDeposit]);
+    return {
+        selectedChain: selectedChain,
+        amount: amount,
+        isDepositing: isDepositing,
+        transactionId: transactionId,
+        selectChain: selectChain,
+        updateAmount: updateAmount,
+        startDeposit: startDeposit,
+        goBackToChainSelection: goBackToChainSelection,
+    };
+};

package/dist/WalletConnectionFlow/hooks/useFlowState.d.ts

@@ -0,0 +1,32 @@
+import { FlowContext, FlowState } from '../types';
+/**
+ * Custom hook for managing the wallet connection flow state machine
+ * @param options Configuration options
+ * @returns Flow state management methods and properties
+ */
+export declare const useFlowState: (options: {
+    /**
+     * Whether to automatically recover saved state on initialization
+     */
+    autoRecover?: boolean;
+    /**
+     * Callback when state changes
+     */
+    onStateChange?: (newState: FlowState, prevState: FlowState | null) => void;
+    /**
+     * Callback when an error occurs
+     */
+    onError?: (error: Error) => void;
+}) => {
+    state: FlowState;
+    prevState: FlowState | null;
+    context: FlowContext;
+    isTransitioning: boolean;
+    isRecoveryAvailable: boolean;
+    transition: (targetState: FlowState, contextUpdates?: Partial<FlowContext>) => boolean;
+    updateContext: (updates: Partial<FlowContext>) => void;
+    reset: () => void;
+    recover: () => boolean;
+    recordInterruption: () => void;
+    handleError: (error: Error) => void;
+};