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

package/dist/utils/validation.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Validation utilities for WDK provider props and inputs
+ *
+ * These functions throw errors for invalid inputs.
+ * Uses Zod schemas for validation with better error messages.
+ * For type guards (boolean returns), see typeGuards.ts
+ */
+import type { NetworkConfigs, TokenConfigs } from '../types';
+/**
+ * Validate network configuration
+ */
+export declare function validateNetworkConfigs(networkConfigs: NetworkConfigs): void;
+/**
+ * Validate token configuration
+ */
+export declare function validateTokenConfigs(tokenConfigs: TokenConfigs): void;
+/**
+ * Validate balance refresh interval
+ */
+export declare function validateBalanceRefreshInterval(interval: number | undefined): void;
+/**
+ * Validate that an object has required methods
+ *
+ * @param obj - Object to validate
+ * @param requiredMethods - Array of required method names
+ * @param objectName - Name of the object for error messages
+ */
+export declare function validateRequiredMethods(obj: unknown, requiredMethods: string[], objectName: string): void;
+/**
+ * Validate account index
+ */
+export declare function validateAccountIndex(accountIndex: number): void;
+/**
+ * Validate network name
+ */
+export declare function validateNetworkName(network: string): void;
+/**
+ * Validate token address (can be null for native tokens)
+ */
+export declare function validateTokenAddress(tokenAddress: string | null): void;
+/**
+ * Validate balance string
+ */
+export declare function validateBalance(balance: string): void;
+/**
+ * Validate wallet parameters (network, accountIndex, optional tokenAddress)
+ * Convenience function to validate common wallet operation parameters
+ *
+ * @param network - Network name
+ * @param accountIndex - Account index
+ * @param tokenAddress - Optional token address (null for native tokens)
+ */
+export declare function validateWalletParams(network: string, accountIndex: number, tokenAddress?: string | null): void;

package/dist/utils/validation.js

@@ -0,0 +1,152 @@
+/**
+ * Validation utilities for WDK provider props and inputs
+ *
+ * These functions throw errors for invalid inputs.
+ * Uses Zod schemas for validation with better error messages.
+ * For type guards (boolean returns), see typeGuards.ts
+ */
+import { z } from 'zod';
+import { networkConfigsSchema, tokenConfigsSchema, accountIndexSchema, networkNameSchema, balanceStringSchema, ethereumAddressSchema, } from './schemas';
+/**
+ * Extract error message from Zod error
+ */
+function getZodErrorMessage(error) {
+    if (error instanceof z.ZodError) {
+        // Get the first error message for simplicity
+        const firstIssue = error.issues[0];
+        if (firstIssue) {
+            return firstIssue.message;
+        }
+        return 'Validation failed';
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Validate network configuration
+ */
+export function validateNetworkConfigs(networkConfigs) {
+    try {
+        networkConfigsSchema.parse(networkConfigs);
+    }
+    catch (error) {
+        throw new Error(`Invalid networkConfigs: ${getZodErrorMessage(error)}`);
+    }
+}
+/**
+ * Validate token configuration
+ */
+export function validateTokenConfigs(tokenConfigs) {
+    try {
+        tokenConfigsSchema.parse(tokenConfigs);
+    }
+    catch (error) {
+        throw new Error(`Invalid tokenConfigs: ${getZodErrorMessage(error)}`);
+    }
+}
+/**
+ * Validate balance refresh interval
+ */
+export function validateBalanceRefreshInterval(interval) {
+    if (interval !== undefined) {
+        if (typeof interval !== 'number') {
+            throw new Error('balanceRefreshInterval must be a number');
+        }
+        if (interval < 0) {
+            throw new Error('balanceRefreshInterval must be a non-negative number');
+        }
+        if (!Number.isFinite(interval)) {
+            throw new Error('balanceRefreshInterval must be a finite number');
+        }
+    }
+}
+/**
+ * Validate that an object has required methods
+ *
+ * @param obj - Object to validate
+ * @param requiredMethods - Array of required method names
+ * @param objectName - Name of the object for error messages
+ */
+export function validateRequiredMethods(obj, requiredMethods, objectName) {
+    if (!obj || typeof obj !== 'object') {
+        throw new Error(`${objectName} must be an object`);
+    }
+    for (const methodName of requiredMethods) {
+        if (typeof obj[methodName] !== 'function') {
+            throw new Error(`${objectName} must have a ${methodName} method`);
+        }
+    }
+}
+/**
+ * Validate account index
+ */
+export function validateAccountIndex(accountIndex) {
+    try {
+        accountIndexSchema.parse(accountIndex);
+    }
+    catch (error) {
+        const message = getZodErrorMessage(error);
+        throw new Error(`Invalid accountIndex: ${message}`);
+    }
+}
+/**
+ * Validate network name
+ */
+export function validateNetworkName(network) {
+    try {
+        networkNameSchema.parse(network);
+    }
+    catch (error) {
+        const message = getZodErrorMessage(error);
+        // Provide a fallback message if Zod error doesn't have a clear message
+        if (message === 'Validation failed' || !message) {
+            throw new Error('network must be a non-empty string containing only alphanumeric characters, hyphens, and underscores');
+        }
+        throw new Error(`Invalid network name: ${message}`);
+    }
+}
+/**
+ * Validate token address (can be null for native tokens)
+ */
+export function validateTokenAddress(tokenAddress) {
+    if (tokenAddress === null) {
+        return;
+    }
+    try {
+        ethereumAddressSchema.parse(tokenAddress);
+    }
+    catch (error) {
+        const message = getZodErrorMessage(error);
+        throw new Error(`Invalid tokenAddress: ${message}`);
+    }
+}
+/**
+ * Validate balance string
+ */
+export function validateBalance(balance) {
+    try {
+        balanceStringSchema.parse(balance);
+    }
+    catch (error) {
+        const message = getZodErrorMessage(error);
+        throw new Error(`Invalid balance: ${message}`);
+    }
+}
+/**
+ * Validate wallet parameters (network, accountIndex, optional tokenAddress)
+ * Convenience function to validate common wallet operation parameters
+ *
+ * @param network - Network name
+ * @param accountIndex - Account index
+ * @param tokenAddress - Optional token address (null for native tokens)
+ */
+export function validateWalletParams(network, accountIndex, tokenAddress) {
+    validateNetworkName(network);
+    validateAccountIndex(accountIndex);
+    if (tokenAddress !== undefined) {
+        validateTokenAddress(tokenAddress);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/dist/utils/walletStateHelpers.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Wallet State Helper Functions
+ *
+ * Pure functions that determine wallet state transition decisions.
+ * These helpers are used by WdkAppProvider for wallet state synchronization logic.
+ *
+ * These functions are extracted for:
+ * - Readability: Complex state logic separated from component orchestration
+ * - Testability: Pure functions can be tested in isolation
+ * - Reusability: Can be used elsewhere if needed
+ *
+ * Note: The effect that uses these functions must remain consolidated to prevent race conditions.
+ */
+import type { WalletLoadingState } from '../store/walletStore';
+/**
+ * Determine if wallet state should be reset to not_loaded
+ * This happens when activeWalletId is cleared (null)
+ *
+ * @param activeWalletId - Currently active wallet identifier (null if none)
+ * @param walletLoadingState - Current wallet loading state
+ * @returns true if state should be reset to not_loaded
+ */
+export declare function shouldResetToNotLoaded(activeWalletId: string | null, walletLoadingState: WalletLoadingState): boolean;
+/**
+ * Determine wallet switch decision when activeWalletId changes
+ * Returns whether a switch should occur and whether the new wallet should be marked ready
+ *
+ * @param currentWalletId - Wallet ID currently tracked in loading state
+ * @param activeWalletId - New active wallet ID
+ * @param hasAddresses - Whether the new wallet has addresses available
+ * @returns Object with shouldSwitch and shouldMarkReady flags
+ */
+export declare function getWalletSwitchDecision(currentWalletId: string | null, activeWalletId: string | null, hasAddresses: boolean): {
+    shouldSwitch: boolean;
+    shouldMarkReady: boolean;
+};
+/**
+ * Determine if wallet should be marked as ready
+ * This checks if wallet is in loading/checking state, addresses exist, and worklet is initialized with seed
+ *
+ * Note: If addresses exist but state is not_loaded, we need to go through loading first.
+ * This is handled by useWalletManager.initializeWallet() or useOnboarding.
+ *
+ * @param walletLoadingState - Current wallet loading state
+ * @param hasAddresses - Whether wallet has addresses available
+ * @param currentWalletId - Wallet ID currently tracked in loading state
+ * @param activeWalletId - Currently active wallet identifier
+ * @param isWorkletInitialized - Whether the worklet is initialized with wallet credentials (seed loaded)
+ * @returns true if wallet should be marked as ready
+ */
+export declare function shouldMarkWalletAsReady(walletLoadingState: WalletLoadingState, hasAddresses: boolean, currentWalletId: string | null, activeWalletId: string | null, isWorkletInitialized: boolean): boolean;
+/**
+ * Determine if an error should be handled for the current wallet
+ * Only handle errors if they're for the wallet we're currently tracking
+ *
+ * @param walletManagerError - Error message from wallet manager (null if no error)
+ * @param currentWalletId - Wallet ID currently tracked in loading state
+ * @param activeWalletId - Currently active wallet identifier
+ * @param walletLoadingState - Current wallet loading state
+ * @returns true if error should be handled for current wallet
+ */
+export declare function shouldHandleError(walletManagerError: string | null, currentWalletId: string | null, activeWalletId: string | null, walletLoadingState: WalletLoadingState): boolean;

package/dist/utils/walletStateHelpers.js

@@ -0,0 +1,81 @@
+/**
+ * Wallet State Helper Functions
+ *
+ * Pure functions that determine wallet state transition decisions.
+ * These helpers are used by WdkAppProvider for wallet state synchronization logic.
+ *
+ * These functions are extracted for:
+ * - Readability: Complex state logic separated from component orchestration
+ * - Testability: Pure functions can be tested in isolation
+ * - Reusability: Can be used elsewhere if needed
+ *
+ * Note: The effect that uses these functions must remain consolidated to prevent race conditions.
+ */
+import { isWalletLoadingState } from '../store/walletStore';
+/**
+ * Determine if wallet state should be reset to not_loaded
+ * This happens when activeWalletId is cleared (null)
+ *
+ * @param activeWalletId - Currently active wallet identifier (null if none)
+ * @param walletLoadingState - Current wallet loading state
+ * @returns true if state should be reset to not_loaded
+ */
+export function shouldResetToNotLoaded(activeWalletId, walletLoadingState) {
+    return !activeWalletId && walletLoadingState.type !== 'not_loaded';
+}
+/**
+ * Determine wallet switch decision when activeWalletId changes
+ * Returns whether a switch should occur and whether the new wallet should be marked ready
+ *
+ * @param currentWalletId - Wallet ID currently tracked in loading state
+ * @param activeWalletId - New active wallet ID
+ * @param hasAddresses - Whether the new wallet has addresses available
+ * @returns Object with shouldSwitch and shouldMarkReady flags
+ */
+export function getWalletSwitchDecision(currentWalletId, activeWalletId, hasAddresses) {
+    if (currentWalletId !== activeWalletId) {
+        return { shouldSwitch: true, shouldMarkReady: hasAddresses };
+    }
+    return { shouldSwitch: false, shouldMarkReady: false };
+}
+/**
+ * Determine if wallet should be marked as ready
+ * This checks if wallet is in loading/checking state, addresses exist, and worklet is initialized with seed
+ *
+ * Note: If addresses exist but state is not_loaded, we need to go through loading first.
+ * This is handled by useWalletManager.initializeWallet() or useOnboarding.
+ *
+ * @param walletLoadingState - Current wallet loading state
+ * @param hasAddresses - Whether wallet has addresses available
+ * @param currentWalletId - Wallet ID currently tracked in loading state
+ * @param activeWalletId - Currently active wallet identifier
+ * @param isWorkletInitialized - Whether the worklet is initialized with wallet credentials (seed loaded)
+ * @returns true if wallet should be marked as ready
+ */
+export function shouldMarkWalletAsReady(walletLoadingState, hasAddresses, currentWalletId, activeWalletId, isWorkletInitialized) {
+    // Only allow ready transition from loading/checking states
+    // AND worklet must be initialized with seed (not just addresses cached)
+    // If addresses exist but state is not_loaded, we need to go through loading first
+    // This is handled by useWalletManager.initializeWallet() or useOnboarding
+    if (isWalletLoadingState(walletLoadingState) && currentWalletId === activeWalletId && hasAddresses && isWorkletInitialized) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Determine if an error should be handled for the current wallet
+ * Only handle errors if they're for the wallet we're currently tracking
+ *
+ * @param walletManagerError - Error message from wallet manager (null if no error)
+ * @param currentWalletId - Wallet ID currently tracked in loading state
+ * @param activeWalletId - Currently active wallet identifier
+ * @param walletLoadingState - Current wallet loading state
+ * @returns true if error should be handled for current wallet
+ */
+export function shouldHandleError(walletManagerError, currentWalletId, activeWalletId, walletLoadingState) {
+    if (!walletManagerError)
+        return false;
+    // Only update error if we're tracking this wallet
+    return currentWalletId === activeWalletId || walletLoadingState.type === 'not_loaded';
+}
+//# sourceMappingURL=walletStateHelpers.js.map

package/dist/utils/walletStateHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletStateHelpers.js","sourceRoot":"","sources":["../../src/utils/walletStateHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAA6B,EAC7B,kBAAsC;IAEtC,OAAO,CAAC,cAAc,IAAI,kBAAkB,CAAC,IAAI,KAAK,YAAY,CAAA;AACpE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,eAA8B,EAC9B,cAA6B,EAC7B,YAAqB;IAErB,IAAI,eAAe,KAAK,cAAc,EAAE,CAAC;QACvC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,YAAY,EAAE,CAAA;IAC9D,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,CAAA;AACxD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,kBAAsC,EACtC,YAAqB,EACrB,eAA8B,EAC9B,cAA6B,EAC7B,oBAA6B;IAE7B,2DAA2D;IAC3D,wEAAwE;IACxE,kFAAkF;IAClF,0EAA0E;IAC1E,IAAI,oBAAoB,CAAC,kBAAkB,CAAC,IAAI,eAAe,KAAK,cAAc,IAAI,YAAY,IAAI,oBAAoB,EAAE,CAAC;QAC3H,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,kBAAiC,EACjC,eAA8B,EAC9B,cAA6B,EAC7B,kBAAsC;IAEtC,IAAI,CAAC,kBAAkB;QAAE,OAAO,KAAK,CAAA;IACrC,kDAAkD;IAClD,OAAO,eAAe,KAAK,cAAc,IAAI,kBAAkB,CAAC,IAAI,KAAK,YAAY,CAAA;AACvF,CAAC"}

package/dist/utils/walletUtils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Wallet Utilities
+ *
+ * Helper functions for working with wallets and retrieving addresses from walletStore.
+ */
+import type { WalletStore as WalletStoreType } from '../store/walletStore';
+import type { WalletStore } from '../types';
+/**
+ * Get addresses for a wallet from walletStore
+ *
+ * This helper function retrieves addresses for a specific accountIndex from the walletStore.
+ * Addresses are stored in walletStore as: { [network]: { [accountIndex]: address } }
+ * This converts them to: { [network]: address } for a specific accountIndex
+ *
+ * NOTE: walletStore is the ONLY place where addresses are actually stored.
+ * This function simply retrieves/looks up addresses from walletStore.
+ *
+ * @param walletStore - The wallet store instance (Zustand store) - the source of truth for addresses
+ * @param accountIndex - The account index to get addresses for
+ * @returns Record of network -> address for the given accountIndex
+ */
+export declare function getWalletAddresses(walletStore: {
+    getState: () => WalletStoreType;
+}, accountIndex: number): Record<string, string>;
+/**
+ * Create a base wallet store that wraps the worklet and wallet stores
+ *
+ * This provides the worklet methods (callAccountMethod, isWalletInitialized)
+ * and helper functions for retrieving addresses from walletStore.
+ * Apps should extend this with their own wallet metadata and balance management.
+ *
+ * Always uses the default MMKV storage adapter.
+ *
+ * @returns Base wallet store implementation
+ */
+export declare function createBaseWalletStore(): Pick<WalletStore, 'callAccountMethod' | 'isWalletInitialized'> & {
+    getWalletAddresses: (accountIndex: number) => Record<string, string>;
+};

package/dist/utils/walletUtils.js

@@ -0,0 +1,87 @@
+/**
+ * Wallet Utilities
+ *
+ * Helper functions for working with wallets and retrieving addresses from walletStore.
+ */
+import { AccountService } from '../services/accountService';
+import { getWalletStore } from '../store/walletStore';
+import { getWorkletStore } from '../store/workletStore';
+/**
+ * Get addresses for a wallet from walletStore
+ *
+ * This helper function retrieves addresses for a specific accountIndex from the walletStore.
+ * Addresses are stored in walletStore as: { [network]: { [accountIndex]: address } }
+ * This converts them to: { [network]: address } for a specific accountIndex
+ *
+ * NOTE: walletStore is the ONLY place where addresses are actually stored.
+ * This function simply retrieves/looks up addresses from walletStore.
+ *
+ * @param walletStore - The wallet store instance (Zustand store) - the source of truth for addresses
+ * @param accountIndex - The account index to get addresses for
+ * @returns Record of network -> address for the given accountIndex
+ */
+export function getWalletAddresses(walletStore, accountIndex) {
+    const state = walletStore.getState();
+    const addresses = {};
+    // Get active wallet ID or use all wallets
+    const activeWalletId = state.activeWalletId;
+    // Retrieve addresses for this accountIndex from walletStore
+    // state.addresses is WalletAddressesByWallet: { [walletId]: { [network]: { [accountIndex]: address } } }
+    if (activeWalletId && state.addresses[activeWalletId]) {
+        // Use active wallet if available
+        const walletAddresses = state.addresses[activeWalletId];
+        // walletAddresses is WalletAddresses: { [network]: { [accountIndex]: address } }
+        Object.entries(walletAddresses).forEach(([network, networkAddresses]) => {
+            if (networkAddresses && typeof networkAddresses === 'object') {
+                const address = networkAddresses[accountIndex];
+                if (address) {
+                    addresses[network] = address;
+                }
+            }
+        });
+    }
+    else {
+        // Fallback: iterate over all wallets (for backward compatibility or when no active wallet)
+        Object.values(state.addresses).forEach((walletAddresses) => {
+            if (walletAddresses && typeof walletAddresses === 'object') {
+                // walletAddresses is WalletAddresses: { [network]: { [accountIndex]: address } }
+                Object.entries(walletAddresses).forEach(([network, networkAddresses]) => {
+                    if (networkAddresses && typeof networkAddresses === 'object') {
+                        const address = networkAddresses[accountIndex];
+                        if (address) {
+                            addresses[network] = address;
+                        }
+                    }
+                });
+            }
+        });
+    }
+    return addresses;
+}
+/**
+ * Create a base wallet store that wraps the worklet and wallet stores
+ *
+ * This provides the worklet methods (callAccountMethod, isWalletInitialized)
+ * and helper functions for retrieving addresses from walletStore.
+ * Apps should extend this with their own wallet metadata and balance management.
+ *
+ * Always uses the default MMKV storage adapter.
+ *
+ * @returns Base wallet store implementation
+ */
+export function createBaseWalletStore() {
+    const workletStore = getWorkletStore();
+    const walletStore = getWalletStore();
+    return {
+        callAccountMethod: async (network, accountIndex, methodName, args) => {
+            return AccountService.callAccountMethod(network, accountIndex, methodName, args);
+        },
+        isWalletInitialized: () => {
+            return workletStore.getState().isInitialized;
+        },
+        getWalletAddresses: (accountIndex) => {
+            return getWalletAddresses(walletStore, accountIndex);
+        },
+    };
+}
+//# sourceMappingURL=walletUtils.js.map

package/dist/utils/walletUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletUtils.js","sourceRoot":"","sources":["../../src/utils/walletUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAIvD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAgD,EAChD,YAAoB;IAEpB,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,SAAS,GAA2B,EAAE,CAAA;IAE5C,0CAA0C;IAC1C,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAA;IAE3C,4DAA4D;IAC5D,yGAAyG;IACzG,IAAI,cAAc,IAAI,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;QACtD,iCAAiC;QACjC,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QACvD,iFAAiF;QACjF,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,EAAE;YACtE,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;gBAC7D,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAA;gBAC9C,IAAI,OAAO,EAAE,CAAC;oBACZ,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;SAAM,CAAC;QACN,2FAA2F;QAC3F,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,EAAE;YACzD,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;gBAC3D,iFAAiF;gBACjF,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,EAAE;oBACtE,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;wBAC7D,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAA;wBAC9C,IAAI,OAAO,EAAE,CAAC;4BACZ,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;wBAC9B,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB;IAGnC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAA;IACtC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,OAAO;QACL,iBAAiB,EAAE,KAAK,EACtB,OAAe,EACf,YAAoB,EACpB,UAAkB,EAClB,IAAc,EACF,EAAE;YACd,OAAO,cAAc,CAAC,iBAAiB,CAAI,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;QACrF,CAAC;QAED,mBAAmB,EAAE,GAAG,EAAE;YACxB,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAA;QAC9C,CAAC;QAED,kBAAkB,EAAE,CAAC,YAAoB,EAAE,EAAE;YAC3C,OAAO,kBAAkB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;QACtD,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@spacesops/wdk-react-native-core",
+  "version": "1.0.0-beta.40",
+  "description": "Core functionality for React Native wallets - wallet management, balance fetching, and worklet operations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./src/index.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spacesops/wdk-react-native-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/spacesops/wdk-react-native-core/issues"
+  },
+  "homepage": "https://github.com/spacesops/wdk-react-native-core#readme",
+  "scripts": {
+    "build": "tsc || true",
+    "build:strict": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepack": "npm run build",
+    "postinstall": "npm run build"
+  },
+  "keywords": [
+    "wallet",
+    "react-native",
+    "core",
+    "crypto",
+    "blockchain",
+    "balance"
+  ],
+  "author": "Spacesops",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@tetherto/wdk-react-native-secure-storage": "github:tetherto/wdk-react-native-secure-storage",
+    "@tanstack/react-query": "^5.0.0",
+    "expo-crypto": "^15.0.8",
+    "@spacesops/pear-wrk-wdk": "1.1.1-beta.40",
+    "@spacesops/react-native-bare-kit": "0.11.0-beta.40",
+    "react-native-mmkv": "^4.1.0",
+    "zod": "^3.22.0",
+    "zustand": "^5.0.9"
+  },
+  "devDependencies": {
+    "@testing-library/jest-native": "^5.4.3",
+    "@testing-library/react-native": "^12.4.0",
+    "@types/jest": "^29.5.0",
+    "@types/react": "^19.0.0",
+    "@types/react-native": "^0.73.0",
+    "bufferutil": "^4.1.0",
+    "jest": "^29.7.0",
+    "jest-environment-node": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.70.0"
+  }
+}

package/src/__mocks__/react.ts

@@ -0,0 +1,34 @@
+/**
+ * Mock React module for Jest tests
+ * Required by Zustand v5 which imports React
+ */
+
+export const useState = jest.fn((initial: any) => [initial, jest.fn()])
+export const useEffect = jest.fn()
+export const useCallback = jest.fn((fn: any) => fn)
+export const useMemo = jest.fn((fn: any) => fn())
+export const useRef = jest.fn((initial: any) => ({ current: initial }))
+export const createContext = jest.fn(() => ({
+  Provider: ({ children }: any) => children,
+  Consumer: ({ children }: any) => children,
+}))
+export const useContext = jest.fn()
+export const useReducer = jest.fn((reducer: any, initial: any) => [initial, jest.fn()])
+export class Component {}
+export const Fragment = ({ children }: any) => children
+export const version = '18.0.0'
+
+export default {
+  useState,
+  useEffect,
+  useCallback,
+  useMemo,
+  useRef,
+  createContext,
+  useContext,
+  useReducer,
+  Component,
+  Fragment,
+  version,
+}
+