@spacesops/wdk-react-native-core 1.0.0-beta.40

package/dist/services/workletLifecycleService.js

@@ -0,0 +1,433 @@
+/**
+ * Worklet Lifecycle Service
+ *
+ * Handles worklet lifecycle operations: starting, initializing, and cleaning up worklets.
+ * This service is focused solely on worklet lifecycle management.
+ */
+import { HRPC } from '@spacesops/pear-wrk-wdk';
+import { Worklet } from '@spacesops/react-native-bare-kit';
+import { getWalletStore } from '../store/walletStore';
+import { getWorkletStore } from '../store/workletStore';
+import { asExtendedHRPC } from '../types/hrpc';
+import { DEFAULT_MNEMONIC_WORD_COUNT } from '../utils/constants';
+import { handleServiceError } from '../utils/errorHandling';
+import { normalizeError } from '../utils/errorUtils';
+import { log, logWarn } from '../utils/logger';
+import { isInitialized as isWorkletInitialized } from '../utils/storeHelpers';
+/**
+ * Type guard to check if HRPC has cleanup method
+ */
+function hasHRPCCleanup(hrpc) {
+    return 'cleanup' in hrpc && typeof hrpc.cleanup === 'function';
+}
+/**
+ * Type guard to check if Worklet has cleanup methods
+ */
+function hasWorkletCleanup(worklet) {
+    const w = worklet;
+    return ((typeof w.cleanup === 'function') ||
+        (typeof w.destroy === 'function') ||
+        (typeof w.stop === 'function'));
+}
+/**
+ * Worklet Lifecycle Service
+ *
+ * Provides methods for managing worklet lifecycle: start, initialize, cleanup, reset.
+ */
+export class WorkletLifecycleService {
+    /**
+     * Cleanup a resource by trying cleanup methods in order
+     * Handles cleanup gracefully, continuing even if individual steps fail
+     */
+    static async cleanupResource(resource, cleanupMethods) {
+        if (!resource)
+            return;
+        const r = resource;
+        const method = cleanupMethods.find((m) => typeof r[m] === 'function');
+        if (method) {
+            try {
+                await r[method]();
+            }
+            catch (error) {
+                logWarn(`Error calling ${method} on resource:`, error);
+            }
+        }
+    }
+    /**
+     * Cleanup worklet resources (HRPC and Worklet instances)
+     * Handles cleanup gracefully, continuing even if individual steps fail
+     */
+    static async cleanupWorkletResources(hrpc, worklet) {
+        try {
+            // Cleanup HRPC if it has a cleanup method
+            await this.cleanupResource(hrpc, ['cleanup']);
+            // Cleanup worklet - try cleanup, destroy, or stop in that order
+            await this.cleanupResource(worklet, ['cleanup', 'destroy', 'stop']);
+        }
+        catch (error) {
+            logWarn('Error cleaning up worklet resources:', error);
+            // Continue even if cleanup fails
+        }
+    }
+    /**
+     * Start the worklet with network configurations
+     */
+    static async startWorklet(networkConfigs) {
+        const store = getWorkletStore();
+        const state = store.getState();
+        if (state.isLoading) {
+            logWarn('Worklet initialization already in progress');
+            return;
+        }
+        if (state.isWorkletStarted) {
+            log('Worklet already started');
+            return;
+        }
+        try {
+            store.setState({
+                error: null,
+                isLoading: true,
+            });
+            // Cleanup existing worklet if present
+            const { worklet: existingWorklet, hrpc: existingHrpc } = store.getState();
+            if (existingWorklet || existingHrpc) {
+                await this.cleanupWorkletResources(existingHrpc, existingWorklet);
+            }
+            const worklet = new Worklet();
+            // Dynamic import of @spacesops/pear-wrk-wdk bundle
+            const pearWrkWdk = await import('@spacesops/pear-wrk-wdk');
+            const bundle = pearWrkWdk.bundle;
+            if (!bundle) {
+                throw new Error('Failed to load @spacesops/pear-wrk-wdk bundle');
+            }
+            // Bundle file (mobile bundle for React Native) - worklet.start expects bundle parameter
+            ;
+            worklet.start('/wdk-worklet.bundle', bundle);
+            const { IPC } = worklet;
+            if (!IPC) {
+                throw new Error('IPC not available from worklet');
+            }
+            const hrpcInstance = new HRPC(IPC);
+            const result = await hrpcInstance.workletStart({
+                config: JSON.stringify(networkConfigs),
+            });
+            store.setState({
+                worklet,
+                hrpc: hrpcInstance,
+                ipc: IPC,
+                isWorkletStarted: true,
+                isLoading: false,
+                networkConfigs,
+                workletStartResult: result,
+                error: null,
+            });
+        }
+        catch (error) {
+            this.handleErrorWithStateUpdate(error, 'startWorklet', (normalizedError) => ({
+                error: normalizedError.message,
+                isLoading: false,
+                worklet: null,
+                hrpc: null,
+                ipc: null,
+                isWorkletStarted: false,
+            }));
+        }
+    }
+    /**
+     * Ensure worklet is started, starting it if needed
+     *
+     * @param networkConfigs - Network configs (required if autoStart=true)
+     * @param options - Options
+     * @param options.autoStart - If true, start worklet if not started (default: false)
+     * @throws Error if worklet not started and autoStart=false or networkConfigs not provided
+     */
+    static async ensureWorkletStarted(networkConfigs, options) {
+        const store = getWorkletStore();
+        const state = store.getState();
+        if (state.isWorkletStarted) {
+            return; // Already started
+        }
+        const autoStart = options?.autoStart ?? false;
+        if (!autoStart || !networkConfigs) {
+            throw new Error('Worklet must be started before this operation');
+        }
+        await this.startWorklet(networkConfigs);
+    }
+    /**
+     * Initialize WDK with encrypted seed (ONLY encrypted approach)
+     */
+    static async initializeWDK(options) {
+        const store = getWorkletStore();
+        const state = store.getState();
+        if (!state.isWorkletStarted) {
+            throw new Error('Worklet must be started before initializing WDK');
+        }
+        if (state.isInitialized &&
+            state.encryptionKey === options.encryptionKey &&
+            state.encryptedSeed === options.encryptedSeed) {
+            log('WDK already initialized with the same encrypted seed');
+            return;
+        }
+        try {
+            store.setState({
+                error: null,
+                isLoading: true,
+            });
+            // Get HRPC directly from store instead of using requireExtendedHRPC()
+            // requireExtendedHRPC() requires isInitialized to be true, but we're setting it here
+            const currentState = store.getState();
+            if (!currentState.hrpc) {
+                throw new Error('HRPC instance not available. Worklet may not be fully started.');
+            }
+            const extendedHrpc = asExtendedHRPC(currentState.hrpc);
+            const result = await extendedHrpc.initializeWDK({
+                encryptionKey: options.encryptionKey,
+                encryptedSeed: options.encryptedSeed,
+                config: JSON.stringify(currentState.networkConfigs || {}),
+            });
+            // NEVER store seed phrase
+            // Extract status from result
+            const wdkInitResult = this.extractWdkInitResult(result);
+            store.setState({
+                isInitialized: true,
+                isLoading: false,
+                encryptedSeed: options.encryptedSeed,
+                encryptionKey: options.encryptionKey,
+                wdkInitResult,
+                error: null,
+            });
+        }
+        catch (error) {
+            this.handleErrorWithStateUpdate(error, 'initializeWDK', (normalizedError) => ({
+                error: normalizedError.message,
+                isLoading: false,
+                isInitialized: false,
+            }));
+        }
+    }
+    /**
+     * Generate entropy and encrypt (for creating new wallets)
+     */
+    static async generateEntropyAndEncrypt(wordCount = DEFAULT_MNEMONIC_WORD_COUNT) {
+        const store = getWorkletStore();
+        const state = store.getState();
+        if (!state.isWorkletStarted) {
+            throw new Error('Worklet must be started before generating entropy');
+        }
+        try {
+            // Get HRPC directly from store instead of using requireExtendedHRPC()
+            // These methods may be called before WDK is initialized
+            const currentState = store.getState();
+            if (!currentState.hrpc) {
+                throw new Error('HRPC instance not available. Worklet may not be fully started.');
+            }
+            const extendedHrpc = asExtendedHRPC(currentState.hrpc);
+            const result = await extendedHrpc.generateEntropyAndEncrypt({
+                wordCount,
+            });
+            return {
+                encryptionKey: result.encryptionKey,
+                encryptedSeedBuffer: result.encryptedSeedBuffer,
+                encryptedEntropyBuffer: result.encryptedEntropyBuffer,
+            };
+        }
+        catch (error) {
+            this.handleAndThrowError(error, 'generateEntropyAndEncrypt', 'Failed to generate entropy');
+        }
+    }
+    /**
+     * Get mnemonic from encrypted entropy (for display purposes only - never stored)
+     */
+    static async getMnemonicFromEntropy(encryptedEntropy, encryptionKey) {
+        const store = getWorkletStore();
+        const state = store.getState();
+        if (!state.isWorkletStarted) {
+            throw new Error('Worklet must be started before getting mnemonic');
+        }
+        try {
+            // Get HRPC directly from store instead of using requireExtendedHRPC()
+            // These methods may be called before WDK is initialized
+            const currentState = store.getState();
+            if (!currentState.hrpc) {
+                throw new Error('HRPC instance not available. Worklet may not be fully started.');
+            }
+            const extendedHrpc = asExtendedHRPC(currentState.hrpc);
+            const result = await extendedHrpc.getMnemonicFromEntropy({
+                encryptedEntropy,
+                encryptionKey,
+            });
+            return {
+                mnemonic: result.mnemonic,
+            };
+        }
+        catch (error) {
+            this.handleAndThrowError(error, 'getMnemonicFromEntropy', 'Failed to get mnemonic');
+        }
+    }
+    /**
+     * Get seed and entropy from mnemonic phrase (for importing existing wallets)
+     */
+    static async getSeedAndEntropyFromMnemonic(mnemonic) {
+        const store = getWorkletStore();
+        const state = store.getState();
+        if (!state.isWorkletStarted) {
+            throw new Error('Worklet must be started before getting seed and entropy from mnemonic');
+        }
+        try {
+            // Get HRPC directly from store instead of using requireExtendedHRPC()
+            // These methods may be called before WDK is initialized
+            const currentState = store.getState();
+            if (!currentState.hrpc) {
+                throw new Error('HRPC instance not available. Worklet may not be fully started.');
+            }
+            const extendedHrpc = asExtendedHRPC(currentState.hrpc);
+            const result = await extendedHrpc.getSeedAndEntropyFromMnemonic({
+                mnemonic,
+            });
+            return {
+                encryptionKey: result.encryptionKey,
+                encryptedSeedBuffer: result.encryptedSeedBuffer,
+                encryptedEntropyBuffer: result.encryptedEntropyBuffer,
+            };
+        }
+        catch (error) {
+            this.handleAndThrowError(error, 'getSeedAndEntropyFromMnemonic', 'Failed to get seed and entropy from mnemonic');
+        }
+    }
+    /**
+     * Initialize both worklet and WDK in one call (convenience method) - ONLY encrypted
+     */
+    static async initializeWorklet(options) {
+        // Convenience method that does both steps - ONLY encrypted approach
+        await this.startWorklet(options.networkConfigs);
+        await this.initializeWDK({
+            encryptionKey: options.encryptionKey,
+            encryptedSeed: options.encryptedSeed,
+        });
+    }
+    /**
+     * Handle error for methods that throw with a message prefix
+     * Normalizes error, logs it, and throws a new error with operation context
+     */
+    static handleAndThrowError(error, operation, errorMessagePrefix) {
+        const normalizedError = normalizeError(error, false, {
+            component: 'WorkletLifecycleService',
+            operation,
+        });
+        handleServiceError(error, 'WorkletLifecycleService', operation);
+        throw new Error(`${errorMessagePrefix}: ${normalizedError.message}`);
+    }
+    /**
+     * Handle error for methods that update store state
+     * Normalizes error, updates store state, and re-throws
+     */
+    static handleErrorWithStateUpdate(error, operation, stateUpdate) {
+        const normalizedError = normalizeError(error, false, {
+            component: 'WorkletLifecycleService',
+            operation,
+        });
+        const store = getWorkletStore();
+        store.setState(stateUpdate(normalizedError));
+        handleServiceError(error, 'WorkletLifecycleService', operation);
+        throw normalizedError;
+    }
+    /**
+     * Extract WDK initialization result status
+     * Safely extracts status from result object
+     */
+    static extractWdkInitResult(result) {
+        if (result && typeof result === 'object' && 'status' in result) {
+            const status = result.status;
+            if (status === null || status === undefined || typeof status === 'string') {
+                return { status: status ?? null };
+            }
+        }
+        return null;
+    }
+    /**
+     * Reset both worklet and wallet stores
+     */
+    static resetStores() {
+        const workletStore = getWorkletStore();
+        const walletStore = getWalletStore();
+        workletStore.setState({
+            worklet: null,
+            hrpc: null,
+            ipc: null,
+            isWorkletStarted: false,
+            isInitialized: false,
+            isLoading: false,
+            error: null,
+            encryptedSeed: null,
+            encryptionKey: null,
+            networkConfigs: null,
+            workletStartResult: null,
+            wdkInitResult: null,
+        });
+        walletStore.setState({
+            addresses: {},
+            walletLoading: {},
+            balances: {},
+            balanceLoading: {},
+            lastBalanceUpdate: {},
+        });
+    }
+    /**
+     * Cleanup worklet resources
+     * Clears only addresses, seed, and WDK instance - does NOT terminate the worklet
+     * The worklet continues running for faster re-initialization
+     */
+    static async cleanup() {
+        const workletStore = getWorkletStore();
+        const walletStore = getWalletStore();
+        // Clear only sensitive data - addresses, seed, and WDK instance
+        // Do NOT terminate worklet, hrpc, or ipc - keep them running
+        workletStore.setState({
+            encryptedSeed: null,
+            encryptionKey: null,
+            isInitialized: false,
+            wdkInitResult: null,
+        });
+        // Clear addresses from wallet store
+        walletStore.setState({
+            addresses: {},
+        });
+    }
+    /**
+     * Reset worklet state (synchronous)
+     * Clears only addresses, seed, and WDK instance - does NOT terminate the worklet
+     * The worklet continues running for faster re-initialization
+     * For async cleanup, use cleanup() instead
+     */
+    static reset() {
+        const workletStore = getWorkletStore();
+        const walletStore = getWalletStore();
+        // Clear only sensitive data - addresses, seed, and WDK instance
+        // Do NOT terminate worklet, hrpc, or ipc - keep them running
+        workletStore.setState({
+            encryptedSeed: null,
+            encryptionKey: null,
+            isInitialized: false,
+            wdkInitResult: null,
+        });
+        // Clear addresses from wallet store
+        walletStore.setState({
+            addresses: {},
+        });
+    }
+    /**
+     * Clear error state
+     */
+    static clearError() {
+        const store = getWorkletStore();
+        store.setState({ error: null });
+    }
+    /**
+     * Check if wallet is initialized
+     * Returns true if worklet is started and WDK is initialized
+     */
+    static isInitialized() {
+        return isWorkletInitialized();
+    }
+}
+//# sourceMappingURL=workletLifecycleService.js.map

package/dist/services/workletLifecycleService.js.map

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

package/dist/storage/mmkvStorage.d.ts

@@ -0,0 +1,44 @@
+import { type MMKV } from 'react-native-mmkv';
+/**
+ * Storage adapter interface for Zustand persistence
+ */
+export interface StorageAdapter {
+    getItem: (name: string) => string | null;
+    setItem: (name: string, value: string) => void;
+    removeItem: (name: string) => void;
+}
+/**
+ * Create MMKV storage instance for the wallet
+ *
+ * SECURITY NOTE: MMKV stores files in the app's document directory, which is app-scoped.
+ * Two different apps will NOT share data because each app has its own isolated document directory.
+ *
+ * This is for non-sensitive data persistence (wallet metadata, balances, addresses).
+ * For sensitive data (encrypted seeds, keys), use SecureStorage from wdk-react-native-secure-storage.
+ *
+ * The encryption key is derived from a device/app identifier to ensure each app instance
+ * has a unique encryption key. If no account identifier is provided, a default app-scoped
+ * identifier is used.
+ *
+ * @param accountIdentifier - Optional account identifier for per-account encryption keys.
+ *                            If not provided, uses a default app-scoped identifier.
+ * @returns Promise that resolves to MMKV storage instance
+ */
+export declare function createMMKVStorage(accountIdentifier?: string): Promise<MMKV>;
+/**
+ * Storage adapter factory for Zustand persistence
+ * This allows Zustand stores to use MMKV for persistence
+ *
+ * Uses lazy async initialization with synchronous API.
+ * Storage is initialized asynchronously when first accessed, then cached.
+ * Operations are queued during initialization to prevent race conditions.
+ *
+ * IMPORTANT: The synchronous API (getItem) may return null during initialization.
+ * This is expected behavior - Zustand will handle missing data gracefully on first load.
+ * Subsequent operations will be queued and processed once storage is ready.
+ *
+ * @param accountIdentifier - Optional account identifier for per-account encryption keys.
+ *                            If not provided, uses a default app-scoped identifier.
+ * @returns StorageAdapter with lazy async initialization
+ */
+export declare function createMMKVStorageAdapter(accountIdentifier?: string): StorageAdapter;