@tuwaio/satellite-react 0.0.3

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 FOP Tkach Oleksandr
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,142 @@
+# Satellite Connect React
+
+[![NPM Version](https://img.shields.io/npm/v/@tuwaio/satellite-react.svg)](https://www.npmjs.com/package/@tuwaio/satellite-react)
+[![License](https://img.shields.io/npm/l/@tuwaio/satellite-react.svg)](./LICENSE)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/satellite-react/release.yml?branch=main)](https://github.com/TuwaIO/satellite-react/actions)
+
+React components and hooks for the Satellite Connect ecosystem, providing an easy-to-use interface for integrating Web3 wallet functionality into React applications.
+
+---
+
+## 🏛️ What is `@tuwaio/satellite-react`?
+
+`@tuwaio/satellite-react` is the React integration layer for the Satellite Connect ecosystem. It provides a collection of React hooks and components that make it easy to integrate Web3 wallet functionality into your React applications.
+
+Built on top of `@tuwaio/satellite-core`, this package offers a seamless developer experience for React applications requiring Web3 wallet integration.
+
+---
+
+## ✨ Key Features
+
+- **Type Safety:** Full TypeScript support with proper type definitions
+- **Chain Agnostic:** Unified support for both EVM and Solana wallets
+- **Modern React:** Built with React 19+ features and best practices
+- **Multi-Chain Support:** Seamless integration with multiple blockchain networks
+- **State Management:** Zustand-based store for efficient state handling
+
+---
+
+## 💾 Installation
+
+### Requirements
+- React 19+
+- Node.js 20+
+- TypeScript 5.9+
+
+```bash
+# Using pnpm (recommended)
+pnpm add @tuwaio/satellite-react @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/react gill react immer zustand
+
+# Using npm
+npm install @tuwaio/satellite-react @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/react gill react immer zustand
+
+# Using yarn
+yarn add @tuwaio/satellite-react @tuwaio/satellite-core @tuwaio/orbit-core @wagmi/core @wallet-standard/react gill react immer zustand
+```
+---
+
+## 🚀 Quick Start
+
+### Basic Setup
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { satelliteEVMAdapter } from '@tuwaio/satellite-evm';
+import { EVMWalletsWatcher, SatelliteConnectProvider, SolanaWalletsWatcher } from '@tuwaio/satellite-react';
+import { initializeSolanaMobileConnectors, satelliteSolanaAdapter } from '@tuwaio/satellite-solana';
+import { ReactNode } from 'react';
+import { WagmiProvider } from 'wagmi';
+import { createWagmiConfig } from '@tuwaio/satellite-evm';
+import { Chain, mainnet, sepolia } from 'viem/chains';
+
+export const appConfig = {
+  appName: 'Satellite EVM Test App',
+};
+
+export const solanaRPCUrls = {
+  devnet: 'https://api.devnet.solana.com',
+};
+
+export const appEVMChains = [mainnet, sepolia] as readonly [Chain, ...Chain[]];
+
+export const wagmiConfig = createWagmiConfig({
+  ...appConfig,
+  chains: appEVMChains,
+  ssr: true,
+  syncConnectedChain: true,
+});
+
+
+const queryClient = new QueryClient();
+
+initializeSolanaMobileConnectors({
+  rpcUrls: solanaRPCUrls,
+  ...appConfig,
+});
+
+export function Providers({ children }: { children: ReactNode }) {
+  return (
+    <WagmiProvider config={wagmiConfig}>
+      <QueryClientProvider client={queryClient}>
+        <SatelliteConnectProvider
+          adapter={[satelliteEVMAdapter(wagmiConfig), satelliteSolanaAdapter({ rpcUrls: solanaRPCUrls })]}
+          autoConnect={true}
+        >
+          <EVMWalletsWatcher wagmiConfig={wagmiConfig} />
+          <SolanaWalletsWatcher />
+          {children}
+        </SatelliteConnectProvider>
+      </QueryClientProvider>
+    </WagmiProvider>
+  );
+}
+```
+
+### Using Hooks
+```tsx
+import { useSatelliteConnectStore } from '@tuwaio/satellite-react';
+
+function ExampleGettingActiveWalletFromStore() {
+  const activeWallet = useSatelliteConnectStore((state) => state.activeWallet);
+  return <div>{activeWallet?.address}</div>
+}
+```
+---
+
+### Core Components
+
+1. **Store Access**
+    - `useSatelliteConnectStore`: Access to satellite connect store with full type safety
+    - Provides access to wallet state, connection methods, and chain management
+
+2. **Provider Components**
+    - `SatelliteConnectProvider`: Global context provider with all necessary configurations
+    - `EVMWalletsWatcher`: EVM wallet connection state management
+    - `SolanaWalletsWatcher`: Solana wallet connection state management
+
+---
+
+## 🤝 Contributing & Support
+
+Contributions are welcome! Please read our main **[Contribution Guidelines](https://github.com/TuwaIO/workflows/blob/main/CONTRIBUTING.md)**.
+
+If you find this library useful, please consider supporting its development. Every contribution helps!
+
+[**➡️ View Support Options**](https://github.com/TuwaIO/workflows/blob/main/Donation.md)
+
+## 📄 License
+
+This project is licensed under the **Apache-2.0 License** - see the [LICENSE](./LICENSE) file for details.
+
+## 👥 Contributors
+
+- **Oleksandr Tkach** - [GitHub](https://github.com/Argeare5)

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var orbitCore=require('@tuwaio/orbit-core'),core=require('@wagmi/core'),react=require('react'),zustand=require('zustand'),react$1=require('@wallet-standard/react'),satelliteCore=require('@tuwaio/satellite-core'),jsxRuntime=require('react/jsx-runtime');var i=react.createContext(null),r=t=>{let o=react.useContext(i);if(!o)throw new Error("useSatelliteConnectStore must be used within a SatelliteConnectProvider");return zustand.useStore(o,t)};function b({wagmiConfig:t}){let o=r(e=>e.updateActiveWallet);return core.watchAccount(t,{onChange:async e=>{o({walletType:`${orbitCore.OrbitAdapter.EVM}:${e?.connector?.type}`,address:e.address,chainId:e.chainId,rpcURL:e.chain?.rpcUrls.default.http[0],isConnected:e.isConnected});}}),null}function V(){let t=react$1.useWallets(),o=r(e=>e.updateActiveWallet);return react.useEffect(()=>{let e=t.filter(n=>n.accounts.length>0)[0];e&&o({address:e.accounts[0].address,isConnected:true,connectedAccount:e.accounts[0],connectedWallet:e});},[t]),null}var l=({initializeAppConnectors:t,onError:o})=>{react.useEffect(()=>{(async()=>{try{await t();}catch(n){(o??(c=>console.error("Failed to initialize connectors:",c)))(n);}})();},[]);};function a({autoConnect:t}){let o=r(e=>e.initializeAppConnectors);return l({initializeAppConnectors:()=>o({autoConnect:t})}),null}function K({children:t,autoConnect:o,...e}){let n=react.useMemo(()=>satelliteCore.createSatelliteConnectStore({...e}),[]);return jsxRuntime.jsxs(i.Provider,{value:n,children:[jsxRuntime.jsx(a,{autoConnect:o}),t]})}exports.EVMWalletsWatcher=b;exports.InitializeConnectorsProvider=a;exports.SatelliteConnectProvider=K;exports.SatelliteStoreContext=i;exports.SolanaWalletsWatcher=V;exports.useInitializeAppConnectors=l;exports.useSatelliteConnectStore=r;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/satteliteHook.ts","../src/components/EVMWalletsWatcher.tsx","../src/components/SolanaWalletsWatcher.tsx","../src/hooks/useInitializeConnectors.tsx","../src/providers/InitializeConnectorsProvider.tsx","../src/providers/SatelliteConnectProvider.tsx"],"names":["SatelliteStoreContext","createContext","useSatelliteConnectStore","selector","store","useContext","useStore","EVMWalletsWatcher","wagmiConfig","updateActiveWallet","state","watchAccount","account","OrbitAdapter","SolanaWalletsWatcher","wallets","useWallets","useEffect","activeWallet","wallet","useInitializeAppConnectors","initializeAppConnectors","onError","error","e","InitializeConnectorsProvider","autoConnect","SatelliteConnectProvider","children","parameters","useMemo","createSatelliteConnectStore","jsxs","jsx"],"mappings":"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","file":"index.cjs","sourcesContent":["import { ISatelliteConnectStore } from '@tuwaio/satellite-core';\nimport { createContext, useContext } from 'react';\nimport { StoreApi, useStore } from 'zustand';\n\n/**\n * React Context for providing Satellite Connect store throughout the application\n * @internal\n */\nexport const SatelliteStoreContext = createContext<StoreApi<ISatelliteConnectStore> | null>(null);\n\n/**\n * Custom hook for accessing the Satellite Connect store state\n *\n * @remarks\n * This hook provides type-safe access to the Satellite store state and must be used\n * within a component that is wrapped by SatelliteConnectProvider.\n *\n * @typeParam T - The type of the selected state slice\n * @param selector - Function that selects a slice of the store state\n * @returns Selected state slice\n *\n * @throws Error if used outside of SatelliteConnectProvider\n *\n * @example\n * ```tsx\n * // Get the active wallet\n * const activeWallet = useSatelliteConnectStore((state) => state.activeWallet);\n * ```\n */\nexport const useSatelliteConnectStore = <T>(selector: (state: ISatelliteConnectStore) => T): T => {\n  // Get store instance from context\n  const store = useContext(SatelliteStoreContext);\n\n  // Ensure hook is used within provider\n  if (!store) {\n    throw new Error('useSatelliteConnectStore must be used within a SatelliteConnectProvider');\n  }\n\n  // Return selected state using Zustand's useStore\n  return useStore(store, selector);\n};\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\nimport { WalletType } from '@tuwaio/satellite-core';\nimport { Config, watchAccount } from '@wagmi/core';\n\nimport { useSatelliteConnectStore } from '../hooks/satteliteHook';\n\n/**\n * React component that watches for EVM wallet account changes and updates the Satellite store\n *\n * @remarks\n * This component acts as a bridge between Wagmi account state and Satellite store.\n * It doesn't render anything visible but maintains wallet state synchronization.\n *\n * @param props - Component properties\n * @param props.wagmiConfig - Wagmi configuration instance\n *\n * @returns null - This is a headless component\n **/\nexport function EVMWalletsWatcher({ wagmiConfig }: { wagmiConfig: Config }) {\n  // Get the updateActiveWallet function from the Satellite store\n  const updateActiveWallet = useSatelliteConnectStore((state) => state.updateActiveWallet);\n\n  // Set up account change watcher\n  watchAccount(wagmiConfig, {\n    onChange: async (account) => {\n      // Update the Satellite store with the new account information\n      updateActiveWallet({\n        // Combine EVM adapter key with connector type for wallet identification\n        walletType: `${OrbitAdapter.EVM}:${account?.connector?.type}` as WalletType,\n        // Update wallet address\n        address: account.address,\n        // Update chain ID\n        chainId: account.chainId,\n        // Update RPC URL using the first available HTTP URL\n        rpcURL: account.chain?.rpcUrls.default.http[0],\n        // Update connection status\n        isConnected: account.isConnected,\n      });\n    },\n  });\n\n  // This is a headless component, so return null\n  return null;\n}\n","import { useWallets } from '@wallet-standard/react';\nimport { useEffect } from 'react';\n\nimport { useSatelliteConnectStore } from '../hooks/satteliteHook';\n\n/**\n * React component that monitors Solana wallet connections and updates the Satellite store\n *\n * @remarks\n * This component watches for changes in connected Solana wallets using the Wallet Standard.\n * Currently handles the first active wallet only, with multi-wallet support planned for future.\n * It's a headless component that manages state synchronization between Wallet Standard and Satellite store.\n *\n * @returns null - This is a headless component\n *\n */\nexport function SolanaWalletsWatcher() {\n  // Get all connected Solana wallets\n  const wallets = useWallets();\n\n  // Get the updateActiveWallet function from the Satellite store\n  const updateActiveWallet = useSatelliteConnectStore((state) => state.updateActiveWallet);\n\n  // Watch for changes in connected wallets\n  useEffect(() => {\n    // Currently only handling the first wallet with active accounts\n    const activeWallet = wallets.filter((wallet) => wallet.accounts.length > 0)[0];\n\n    if (activeWallet) {\n      // Update the Satellite store with the active wallet information\n      updateActiveWallet({\n        // Use the first account's address\n        // TODO: Implement support for multiple connected wallets\n        address: activeWallet.accounts[0].address,\n        // Set connection status\n        isConnected: true,\n        // Store Wallet Standard specific information\n        connectedAccount: activeWallet.accounts[0],\n        connectedWallet: activeWallet,\n      });\n    }\n  }, [wallets]); // Re-run effect when wallets array changes\n\n  // This is a headless component, so return null\n  return null;\n}\n","import { useEffect } from 'react';\n\n/**\n * Props for useInitializeAppConnectors hook\n */\ninterface InitializeConnectorsProps {\n  /** Function to initialize wallet connectors */\n  initializeAppConnectors: () => Promise<void>;\n  /** Optional error handler callback */\n  onError?: (error: Error) => void;\n}\n\n/**\n * Custom hook for initializing wallet connectors with error handling\n *\n * @remarks\n * This hook handles the initialization of blockchain wallet connectors when a component mounts.\n * It provides default error handling with console.error if no custom handler is provided.\n * The initialization runs only once when the component mounts.\n *\n * @param props - Hook configuration\n * @param props.initializeAppConnectors - Async function that initializes the connectors\n * @param props.onError - Optional custom error handler\n *\n * @example\n * ```tsx\n * // Basic usage with default error handling\n * useInitializeAppConnectors({\n *   initializeAppConnectors: store.initializeAppConnectors\n * });\n * // With custom error handling\n * useInitializeAppConnectors({\n *   initializeAppConnectors: store.initializeAppConnectors,\n *   onError: (error) => {\n *     toast.error(`Failed to initialize wallets: ${error.message}`);\n *   }\n * });\n * ```\n */\nexport const useInitializeAppConnectors = ({ initializeAppConnectors, onError }: InitializeConnectorsProps): void => {\n  useEffect(() => {\n    const initializeConnectors = async () => {\n      try {\n        await initializeAppConnectors();\n      } catch (error) {\n        // Use provided error handler or fallback to default console.error\n        const errorHandler = onError ?? ((e: Error) => console.error('Failed to initialize connectors:', e));\n        errorHandler(error as Error);\n      }\n    };\n\n    // Initialize connectors when component mounts\n    initializeConnectors();\n  }, []); // Empty dependency array ensures single execution\n};\n","import { useSatelliteConnectStore } from '../hooks/satteliteHook';\nimport { useInitializeAppConnectors } from '../hooks/useInitializeConnectors';\n\n/**\n * Props for InitializeConnectorsProvider component\n */\ninterface InitializeConnectorsProviderProps {\n  /** Whether to automatically connect to the last used wallet */\n  autoConnect?: boolean;\n}\n\n/**\n * Provider component that handles wallet connectors initialization\n *\n * @remarks\n * This is a headless component that initializes wallet connectors when mounted.\n * It integrates with the Satellite Connect store and supports automatic reconnection\n * to the last used wallet via the autoConnect prop.\n *\n * @param props - Component properties\n * @param props.autoConnect - Optional flag to enable automatic wallet reconnection\n *\n * @returns null - This is a headless component\n *\n **/\nexport function InitializeConnectorsProvider({ autoConnect }: InitializeConnectorsProviderProps) {\n  // Get the initialization function from the store\n  const initializeAppConnectors = useSatelliteConnectStore((state) => state.initializeAppConnectors);\n\n  // Initialize connectors with autoConnect configuration\n  useInitializeAppConnectors({\n    initializeAppConnectors: () => initializeAppConnectors({ autoConnect }),\n  });\n\n  // This is a headless component\n  return null;\n}\n","import { createSatelliteConnectStore, SatelliteConnectStoreInitialParameters } from '@tuwaio/satellite-core';\nimport { useMemo } from 'react';\n\nimport { SatelliteStoreContext } from '../hooks/satteliteHook';\nimport { InitializeConnectorsProvider } from './InitializeConnectorsProvider';\n\n/**\n * Props for SatelliteConnectProvider component\n */\ninterface SatelliteConnectProviderProps extends SatelliteConnectStoreInitialParameters {\n  /** React child components */\n  children: React.ReactNode;\n  /** Whether to automatically connect to last used wallet */\n  autoConnect?: boolean;\n}\n\n/**\n * Provider component that manages wallet connections and state\n *\n * @remarks\n * This component creates and provides the Satellite Connect store context to its children.\n * It handles wallet connections, state management, and automatic reconnection functionality.\n * The store is memoized to ensure stable reference across renders.\n *\n * @param props - Component properties including store parameters and children\n * @param props.children - Child components that will have access to the store\n * @param props.autoConnect - Optional flag to enable automatic wallet reconnection\n * @param props.adapter - Blockchain adapter(s) for wallet interactions\n * @param props.callbackAfterConnected - Optional callback for successful connections\n *\n * @example\n * ```tsx\n * // Basic usage with single adapter\n * <SatelliteConnectProvider adapter={solanaAdapter}>\n *   <App />\n * </SatelliteConnectProvider>\n *\n * // With auto-connect and multiple adapters\n * <SatelliteConnectProvider\n *   adapter={[solanaAdapter, evmAdapter]}\n *   autoConnect={true}\n *   callbackAfterConnected={(wallet) => {\n *     console.log('Wallet connected:', wallet.address);\n *   }}\n * >\n *   <App />\n * </SatelliteConnectProvider>\n * ```\n */\nexport function SatelliteConnectProvider({ children, autoConnect, ...parameters }: SatelliteConnectProviderProps) {\n  // Create and memoize the store instance\n  const store = useMemo(() => {\n    return createSatelliteConnectStore({\n      ...parameters,\n    });\n  }, []); // Empty dependency array as store should be created only once\n\n  return (\n    <SatelliteStoreContext.Provider value={store}>\n      <InitializeConnectorsProvider autoConnect={autoConnect} />\n      {children}\n    </SatelliteStoreContext.Provider>\n  );\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,167 @@
+import { Config } from '@wagmi/core';
+import * as react from 'react';
+import { ISatelliteConnectStore, SatelliteConnectStoreInitialParameters } from '@tuwaio/satellite-core';
+import { StoreApi } from 'zustand';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * React component that watches for EVM wallet account changes and updates the Satellite store
+ *
+ * @remarks
+ * This component acts as a bridge between Wagmi account state and Satellite store.
+ * It doesn't render anything visible but maintains wallet state synchronization.
+ *
+ * @param props - Component properties
+ * @param props.wagmiConfig - Wagmi configuration instance
+ *
+ * @returns null - This is a headless component
+ **/
+declare function EVMWalletsWatcher({ wagmiConfig }: {
+    wagmiConfig: Config;
+}): null;
+
+/**
+ * React component that monitors Solana wallet connections and updates the Satellite store
+ *
+ * @remarks
+ * This component watches for changes in connected Solana wallets using the Wallet Standard.
+ * Currently handles the first active wallet only, with multi-wallet support planned for future.
+ * It's a headless component that manages state synchronization between Wallet Standard and Satellite store.
+ *
+ * @returns null - This is a headless component
+ *
+ */
+declare function SolanaWalletsWatcher(): null;
+
+/**
+ * React Context for providing Satellite Connect store throughout the application
+ * @internal
+ */
+declare const SatelliteStoreContext: react.Context<StoreApi<ISatelliteConnectStore> | null>;
+/**
+ * Custom hook for accessing the Satellite Connect store state
+ *
+ * @remarks
+ * This hook provides type-safe access to the Satellite store state and must be used
+ * within a component that is wrapped by SatelliteConnectProvider.
+ *
+ * @typeParam T - The type of the selected state slice
+ * @param selector - Function that selects a slice of the store state
+ * @returns Selected state slice
+ *
+ * @throws Error if used outside of SatelliteConnectProvider
+ *
+ * @example
+ * ```tsx
+ * // Get the active wallet
+ * const activeWallet = useSatelliteConnectStore((state) => state.activeWallet);
+ * ```
+ */
+declare const useSatelliteConnectStore: <T>(selector: (state: ISatelliteConnectStore) => T) => T;
+
+/**
+ * Props for useInitializeAppConnectors hook
+ */
+interface InitializeConnectorsProps {
+    /** Function to initialize wallet connectors */
+    initializeAppConnectors: () => Promise<void>;
+    /** Optional error handler callback */
+    onError?: (error: Error) => void;
+}
+/**
+ * Custom hook for initializing wallet connectors with error handling
+ *
+ * @remarks
+ * This hook handles the initialization of blockchain wallet connectors when a component mounts.
+ * It provides default error handling with console.error if no custom handler is provided.
+ * The initialization runs only once when the component mounts.
+ *
+ * @param props - Hook configuration
+ * @param props.initializeAppConnectors - Async function that initializes the connectors
+ * @param props.onError - Optional custom error handler
+ *
+ * @example
+ * ```tsx
+ * // Basic usage with default error handling
+ * useInitializeAppConnectors({
+ *   initializeAppConnectors: store.initializeAppConnectors
+ * });
+ * // With custom error handling
+ * useInitializeAppConnectors({
+ *   initializeAppConnectors: store.initializeAppConnectors,
+ *   onError: (error) => {
+ *     toast.error(`Failed to initialize wallets: ${error.message}`);
+ *   }
+ * });
+ * ```
+ */
+declare const useInitializeAppConnectors: ({ initializeAppConnectors, onError }: InitializeConnectorsProps) => void;
+
+/**
+ * Props for InitializeConnectorsProvider component
+ */
+interface InitializeConnectorsProviderProps {
+    /** Whether to automatically connect to the last used wallet */
+    autoConnect?: boolean;
+}
+/**
+ * Provider component that handles wallet connectors initialization
+ *
+ * @remarks
+ * This is a headless component that initializes wallet connectors when mounted.
+ * It integrates with the Satellite Connect store and supports automatic reconnection
+ * to the last used wallet via the autoConnect prop.
+ *
+ * @param props - Component properties
+ * @param props.autoConnect - Optional flag to enable automatic wallet reconnection
+ *
+ * @returns null - This is a headless component
+ *
+ **/
+declare function InitializeConnectorsProvider({ autoConnect }: InitializeConnectorsProviderProps): null;
+
+/**
+ * Props for SatelliteConnectProvider component
+ */
+interface SatelliteConnectProviderProps extends SatelliteConnectStoreInitialParameters {
+    /** React child components */
+    children: React.ReactNode;
+    /** Whether to automatically connect to last used wallet */
+    autoConnect?: boolean;
+}
+/**
+ * Provider component that manages wallet connections and state
+ *
+ * @remarks
+ * This component creates and provides the Satellite Connect store context to its children.
+ * It handles wallet connections, state management, and automatic reconnection functionality.
+ * The store is memoized to ensure stable reference across renders.
+ *
+ * @param props - Component properties including store parameters and children
+ * @param props.children - Child components that will have access to the store
+ * @param props.autoConnect - Optional flag to enable automatic wallet reconnection
+ * @param props.adapter - Blockchain adapter(s) for wallet interactions
+ * @param props.callbackAfterConnected - Optional callback for successful connections
+ *
+ * @example
+ * ```tsx
+ * // Basic usage with single adapter
+ * <SatelliteConnectProvider adapter={solanaAdapter}>
+ *   <App />
+ * </SatelliteConnectProvider>
+ *
+ * // With auto-connect and multiple adapters
+ * <SatelliteConnectProvider
+ *   adapter={[solanaAdapter, evmAdapter]}
+ *   autoConnect={true}
+ *   callbackAfterConnected={(wallet) => {
+ *     console.log('Wallet connected:', wallet.address);
+ *   }}
+ * >
+ *   <App />
+ * </SatelliteConnectProvider>
+ * ```
+ */
+declare function SatelliteConnectProvider({ children, autoConnect, ...parameters }: SatelliteConnectProviderProps): react_jsx_runtime.JSX.Element;
+
+export { EVMWalletsWatcher, InitializeConnectorsProvider, SatelliteConnectProvider, SatelliteStoreContext, SolanaWalletsWatcher, useInitializeAppConnectors, useSatelliteConnectStore };

package/dist/index.d.ts

@@ -0,0 +1,167 @@
+import { Config } from '@wagmi/core';
+import * as react from 'react';
+import { ISatelliteConnectStore, SatelliteConnectStoreInitialParameters } from '@tuwaio/satellite-core';
+import { StoreApi } from 'zustand';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * React component that watches for EVM wallet account changes and updates the Satellite store
+ *
+ * @remarks
+ * This component acts as a bridge between Wagmi account state and Satellite store.
+ * It doesn't render anything visible but maintains wallet state synchronization.
+ *
+ * @param props - Component properties
+ * @param props.wagmiConfig - Wagmi configuration instance
+ *
+ * @returns null - This is a headless component
+ **/
+declare function EVMWalletsWatcher({ wagmiConfig }: {
+    wagmiConfig: Config;
+}): null;
+
+/**
+ * React component that monitors Solana wallet connections and updates the Satellite store
+ *
+ * @remarks
+ * This component watches for changes in connected Solana wallets using the Wallet Standard.
+ * Currently handles the first active wallet only, with multi-wallet support planned for future.
+ * It's a headless component that manages state synchronization between Wallet Standard and Satellite store.
+ *
+ * @returns null - This is a headless component
+ *
+ */
+declare function SolanaWalletsWatcher(): null;
+
+/**
+ * React Context for providing Satellite Connect store throughout the application
+ * @internal
+ */
+declare const SatelliteStoreContext: react.Context<StoreApi<ISatelliteConnectStore> | null>;
+/**
+ * Custom hook for accessing the Satellite Connect store state
+ *
+ * @remarks
+ * This hook provides type-safe access to the Satellite store state and must be used
+ * within a component that is wrapped by SatelliteConnectProvider.
+ *
+ * @typeParam T - The type of the selected state slice
+ * @param selector - Function that selects a slice of the store state
+ * @returns Selected state slice
+ *
+ * @throws Error if used outside of SatelliteConnectProvider
+ *
+ * @example
+ * ```tsx
+ * // Get the active wallet
+ * const activeWallet = useSatelliteConnectStore((state) => state.activeWallet);
+ * ```
+ */
+declare const useSatelliteConnectStore: <T>(selector: (state: ISatelliteConnectStore) => T) => T;
+
+/**
+ * Props for useInitializeAppConnectors hook
+ */
+interface InitializeConnectorsProps {
+    /** Function to initialize wallet connectors */
+    initializeAppConnectors: () => Promise<void>;
+    /** Optional error handler callback */
+    onError?: (error: Error) => void;
+}
+/**
+ * Custom hook for initializing wallet connectors with error handling
+ *
+ * @remarks
+ * This hook handles the initialization of blockchain wallet connectors when a component mounts.
+ * It provides default error handling with console.error if no custom handler is provided.
+ * The initialization runs only once when the component mounts.
+ *
+ * @param props - Hook configuration
+ * @param props.initializeAppConnectors - Async function that initializes the connectors
+ * @param props.onError - Optional custom error handler
+ *
+ * @example
+ * ```tsx
+ * // Basic usage with default error handling
+ * useInitializeAppConnectors({
+ *   initializeAppConnectors: store.initializeAppConnectors
+ * });
+ * // With custom error handling
+ * useInitializeAppConnectors({
+ *   initializeAppConnectors: store.initializeAppConnectors,
+ *   onError: (error) => {
+ *     toast.error(`Failed to initialize wallets: ${error.message}`);
+ *   }
+ * });
+ * ```
+ */
+declare const useInitializeAppConnectors: ({ initializeAppConnectors, onError }: InitializeConnectorsProps) => void;
+
+/**
+ * Props for InitializeConnectorsProvider component
+ */
+interface InitializeConnectorsProviderProps {
+    /** Whether to automatically connect to the last used wallet */
+    autoConnect?: boolean;
+}
+/**
+ * Provider component that handles wallet connectors initialization
+ *
+ * @remarks
+ * This is a headless component that initializes wallet connectors when mounted.
+ * It integrates with the Satellite Connect store and supports automatic reconnection
+ * to the last used wallet via the autoConnect prop.
+ *
+ * @param props - Component properties
+ * @param props.autoConnect - Optional flag to enable automatic wallet reconnection
+ *
+ * @returns null - This is a headless component
+ *
+ **/
+declare function InitializeConnectorsProvider({ autoConnect }: InitializeConnectorsProviderProps): null;
+
+/**
+ * Props for SatelliteConnectProvider component
+ */
+interface SatelliteConnectProviderProps extends SatelliteConnectStoreInitialParameters {
+    /** React child components */
+    children: React.ReactNode;
+    /** Whether to automatically connect to last used wallet */
+    autoConnect?: boolean;
+}
+/**
+ * Provider component that manages wallet connections and state
+ *
+ * @remarks
+ * This component creates and provides the Satellite Connect store context to its children.
+ * It handles wallet connections, state management, and automatic reconnection functionality.
+ * The store is memoized to ensure stable reference across renders.
+ *
+ * @param props - Component properties including store parameters and children
+ * @param props.children - Child components that will have access to the store
+ * @param props.autoConnect - Optional flag to enable automatic wallet reconnection
+ * @param props.adapter - Blockchain adapter(s) for wallet interactions
+ * @param props.callbackAfterConnected - Optional callback for successful connections
+ *
+ * @example
+ * ```tsx
+ * // Basic usage with single adapter
+ * <SatelliteConnectProvider adapter={solanaAdapter}>
+ *   <App />
+ * </SatelliteConnectProvider>
+ *
+ * // With auto-connect and multiple adapters
+ * <SatelliteConnectProvider
+ *   adapter={[solanaAdapter, evmAdapter]}
+ *   autoConnect={true}
+ *   callbackAfterConnected={(wallet) => {
+ *     console.log('Wallet connected:', wallet.address);
+ *   }}
+ * >
+ *   <App />
+ * </SatelliteConnectProvider>
+ * ```
+ */
+declare function SatelliteConnectProvider({ children, autoConnect, ...parameters }: SatelliteConnectProviderProps): react_jsx_runtime.JSX.Element;
+
+export { EVMWalletsWatcher, InitializeConnectorsProvider, SatelliteConnectProvider, SatelliteStoreContext, SolanaWalletsWatcher, useInitializeAppConnectors, useSatelliteConnectStore };

package/dist/index.js

@@ -0,0 +1,2 @@
+import {OrbitAdapter}from'@tuwaio/orbit-core';import {watchAccount}from'@wagmi/core';import {createContext,useContext,useEffect,useMemo}from'react';import {useStore}from'zustand';import {useWallets}from'@wallet-standard/react';import {createSatelliteConnectStore}from'@tuwaio/satellite-core';import {jsxs,jsx}from'react/jsx-runtime';var i=createContext(null),r=t=>{let o=useContext(i);if(!o)throw new Error("useSatelliteConnectStore must be used within a SatelliteConnectProvider");return useStore(o,t)};function b({wagmiConfig:t}){let o=r(e=>e.updateActiveWallet);return watchAccount(t,{onChange:async e=>{o({walletType:`${OrbitAdapter.EVM}:${e?.connector?.type}`,address:e.address,chainId:e.chainId,rpcURL:e.chain?.rpcUrls.default.http[0],isConnected:e.isConnected});}}),null}function V(){let t=useWallets(),o=r(e=>e.updateActiveWallet);return useEffect(()=>{let e=t.filter(n=>n.accounts.length>0)[0];e&&o({address:e.accounts[0].address,isConnected:true,connectedAccount:e.accounts[0],connectedWallet:e});},[t]),null}var l=({initializeAppConnectors:t,onError:o})=>{useEffect(()=>{(async()=>{try{await t();}catch(n){(o??(c=>console.error("Failed to initialize connectors:",c)))(n);}})();},[]);};function a({autoConnect:t}){let o=r(e=>e.initializeAppConnectors);return l({initializeAppConnectors:()=>o({autoConnect:t})}),null}function K({children:t,autoConnect:o,...e}){let n=useMemo(()=>createSatelliteConnectStore({...e}),[]);return jsxs(i.Provider,{value:n,children:[jsx(a,{autoConnect:o}),t]})}export{b as EVMWalletsWatcher,a as InitializeConnectorsProvider,K as SatelliteConnectProvider,i as SatelliteStoreContext,V as SolanaWalletsWatcher,l as useInitializeAppConnectors,r as useSatelliteConnectStore};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/satteliteHook.ts","../src/components/EVMWalletsWatcher.tsx","../src/components/SolanaWalletsWatcher.tsx","../src/hooks/useInitializeConnectors.tsx","../src/providers/InitializeConnectorsProvider.tsx","../src/providers/SatelliteConnectProvider.tsx"],"names":["SatelliteStoreContext","createContext","useSatelliteConnectStore","selector","store","useContext","useStore","EVMWalletsWatcher","wagmiConfig","updateActiveWallet","state","watchAccount","account","OrbitAdapter","SolanaWalletsWatcher","wallets","useWallets","useEffect","activeWallet","wallet","useInitializeAppConnectors","initializeAppConnectors","onError","error","e","InitializeConnectorsProvider","autoConnect","SatelliteConnectProvider","children","parameters","useMemo","createSatelliteConnectStore","jsxs","jsx"],"mappings":"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","file":"index.js","sourcesContent":["import { ISatelliteConnectStore } from '@tuwaio/satellite-core';\nimport { createContext, useContext } from 'react';\nimport { StoreApi, useStore } from 'zustand';\n\n/**\n * React Context for providing Satellite Connect store throughout the application\n * @internal\n */\nexport const SatelliteStoreContext = createContext<StoreApi<ISatelliteConnectStore> | null>(null);\n\n/**\n * Custom hook for accessing the Satellite Connect store state\n *\n * @remarks\n * This hook provides type-safe access to the Satellite store state and must be used\n * within a component that is wrapped by SatelliteConnectProvider.\n *\n * @typeParam T - The type of the selected state slice\n * @param selector - Function that selects a slice of the store state\n * @returns Selected state slice\n *\n * @throws Error if used outside of SatelliteConnectProvider\n *\n * @example\n * ```tsx\n * // Get the active wallet\n * const activeWallet = useSatelliteConnectStore((state) => state.activeWallet);\n * ```\n */\nexport const useSatelliteConnectStore = <T>(selector: (state: ISatelliteConnectStore) => T): T => {\n  // Get store instance from context\n  const store = useContext(SatelliteStoreContext);\n\n  // Ensure hook is used within provider\n  if (!store) {\n    throw new Error('useSatelliteConnectStore must be used within a SatelliteConnectProvider');\n  }\n\n  // Return selected state using Zustand's useStore\n  return useStore(store, selector);\n};\n","import { OrbitAdapter } from '@tuwaio/orbit-core';\nimport { WalletType } from '@tuwaio/satellite-core';\nimport { Config, watchAccount } from '@wagmi/core';\n\nimport { useSatelliteConnectStore } from '../hooks/satteliteHook';\n\n/**\n * React component that watches for EVM wallet account changes and updates the Satellite store\n *\n * @remarks\n * This component acts as a bridge between Wagmi account state and Satellite store.\n * It doesn't render anything visible but maintains wallet state synchronization.\n *\n * @param props - Component properties\n * @param props.wagmiConfig - Wagmi configuration instance\n *\n * @returns null - This is a headless component\n **/\nexport function EVMWalletsWatcher({ wagmiConfig }: { wagmiConfig: Config }) {\n  // Get the updateActiveWallet function from the Satellite store\n  const updateActiveWallet = useSatelliteConnectStore((state) => state.updateActiveWallet);\n\n  // Set up account change watcher\n  watchAccount(wagmiConfig, {\n    onChange: async (account) => {\n      // Update the Satellite store with the new account information\n      updateActiveWallet({\n        // Combine EVM adapter key with connector type for wallet identification\n        walletType: `${OrbitAdapter.EVM}:${account?.connector?.type}` as WalletType,\n        // Update wallet address\n        address: account.address,\n        // Update chain ID\n        chainId: account.chainId,\n        // Update RPC URL using the first available HTTP URL\n        rpcURL: account.chain?.rpcUrls.default.http[0],\n        // Update connection status\n        isConnected: account.isConnected,\n      });\n    },\n  });\n\n  // This is a headless component, so return null\n  return null;\n}\n","import { useWallets } from '@wallet-standard/react';\nimport { useEffect } from 'react';\n\nimport { useSatelliteConnectStore } from '../hooks/satteliteHook';\n\n/**\n * React component that monitors Solana wallet connections and updates the Satellite store\n *\n * @remarks\n * This component watches for changes in connected Solana wallets using the Wallet Standard.\n * Currently handles the first active wallet only, with multi-wallet support planned for future.\n * It's a headless component that manages state synchronization between Wallet Standard and Satellite store.\n *\n * @returns null - This is a headless component\n *\n */\nexport function SolanaWalletsWatcher() {\n  // Get all connected Solana wallets\n  const wallets = useWallets();\n\n  // Get the updateActiveWallet function from the Satellite store\n  const updateActiveWallet = useSatelliteConnectStore((state) => state.updateActiveWallet);\n\n  // Watch for changes in connected wallets\n  useEffect(() => {\n    // Currently only handling the first wallet with active accounts\n    const activeWallet = wallets.filter((wallet) => wallet.accounts.length > 0)[0];\n\n    if (activeWallet) {\n      // Update the Satellite store with the active wallet information\n      updateActiveWallet({\n        // Use the first account's address\n        // TODO: Implement support for multiple connected wallets\n        address: activeWallet.accounts[0].address,\n        // Set connection status\n        isConnected: true,\n        // Store Wallet Standard specific information\n        connectedAccount: activeWallet.accounts[0],\n        connectedWallet: activeWallet,\n      });\n    }\n  }, [wallets]); // Re-run effect when wallets array changes\n\n  // This is a headless component, so return null\n  return null;\n}\n","import { useEffect } from 'react';\n\n/**\n * Props for useInitializeAppConnectors hook\n */\ninterface InitializeConnectorsProps {\n  /** Function to initialize wallet connectors */\n  initializeAppConnectors: () => Promise<void>;\n  /** Optional error handler callback */\n  onError?: (error: Error) => void;\n}\n\n/**\n * Custom hook for initializing wallet connectors with error handling\n *\n * @remarks\n * This hook handles the initialization of blockchain wallet connectors when a component mounts.\n * It provides default error handling with console.error if no custom handler is provided.\n * The initialization runs only once when the component mounts.\n *\n * @param props - Hook configuration\n * @param props.initializeAppConnectors - Async function that initializes the connectors\n * @param props.onError - Optional custom error handler\n *\n * @example\n * ```tsx\n * // Basic usage with default error handling\n * useInitializeAppConnectors({\n *   initializeAppConnectors: store.initializeAppConnectors\n * });\n * // With custom error handling\n * useInitializeAppConnectors({\n *   initializeAppConnectors: store.initializeAppConnectors,\n *   onError: (error) => {\n *     toast.error(`Failed to initialize wallets: ${error.message}`);\n *   }\n * });\n * ```\n */\nexport const useInitializeAppConnectors = ({ initializeAppConnectors, onError }: InitializeConnectorsProps): void => {\n  useEffect(() => {\n    const initializeConnectors = async () => {\n      try {\n        await initializeAppConnectors();\n      } catch (error) {\n        // Use provided error handler or fallback to default console.error\n        const errorHandler = onError ?? ((e: Error) => console.error('Failed to initialize connectors:', e));\n        errorHandler(error as Error);\n      }\n    };\n\n    // Initialize connectors when component mounts\n    initializeConnectors();\n  }, []); // Empty dependency array ensures single execution\n};\n","import { useSatelliteConnectStore } from '../hooks/satteliteHook';\nimport { useInitializeAppConnectors } from '../hooks/useInitializeConnectors';\n\n/**\n * Props for InitializeConnectorsProvider component\n */\ninterface InitializeConnectorsProviderProps {\n  /** Whether to automatically connect to the last used wallet */\n  autoConnect?: boolean;\n}\n\n/**\n * Provider component that handles wallet connectors initialization\n *\n * @remarks\n * This is a headless component that initializes wallet connectors when mounted.\n * It integrates with the Satellite Connect store and supports automatic reconnection\n * to the last used wallet via the autoConnect prop.\n *\n * @param props - Component properties\n * @param props.autoConnect - Optional flag to enable automatic wallet reconnection\n *\n * @returns null - This is a headless component\n *\n **/\nexport function InitializeConnectorsProvider({ autoConnect }: InitializeConnectorsProviderProps) {\n  // Get the initialization function from the store\n  const initializeAppConnectors = useSatelliteConnectStore((state) => state.initializeAppConnectors);\n\n  // Initialize connectors with autoConnect configuration\n  useInitializeAppConnectors({\n    initializeAppConnectors: () => initializeAppConnectors({ autoConnect }),\n  });\n\n  // This is a headless component\n  return null;\n}\n","import { createSatelliteConnectStore, SatelliteConnectStoreInitialParameters } from '@tuwaio/satellite-core';\nimport { useMemo } from 'react';\n\nimport { SatelliteStoreContext } from '../hooks/satteliteHook';\nimport { InitializeConnectorsProvider } from './InitializeConnectorsProvider';\n\n/**\n * Props for SatelliteConnectProvider component\n */\ninterface SatelliteConnectProviderProps extends SatelliteConnectStoreInitialParameters {\n  /** React child components */\n  children: React.ReactNode;\n  /** Whether to automatically connect to last used wallet */\n  autoConnect?: boolean;\n}\n\n/**\n * Provider component that manages wallet connections and state\n *\n * @remarks\n * This component creates and provides the Satellite Connect store context to its children.\n * It handles wallet connections, state management, and automatic reconnection functionality.\n * The store is memoized to ensure stable reference across renders.\n *\n * @param props - Component properties including store parameters and children\n * @param props.children - Child components that will have access to the store\n * @param props.autoConnect - Optional flag to enable automatic wallet reconnection\n * @param props.adapter - Blockchain adapter(s) for wallet interactions\n * @param props.callbackAfterConnected - Optional callback for successful connections\n *\n * @example\n * ```tsx\n * // Basic usage with single adapter\n * <SatelliteConnectProvider adapter={solanaAdapter}>\n *   <App />\n * </SatelliteConnectProvider>\n *\n * // With auto-connect and multiple adapters\n * <SatelliteConnectProvider\n *   adapter={[solanaAdapter, evmAdapter]}\n *   autoConnect={true}\n *   callbackAfterConnected={(wallet) => {\n *     console.log('Wallet connected:', wallet.address);\n *   }}\n * >\n *   <App />\n * </SatelliteConnectProvider>\n * ```\n */\nexport function SatelliteConnectProvider({ children, autoConnect, ...parameters }: SatelliteConnectProviderProps) {\n  // Create and memoize the store instance\n  const store = useMemo(() => {\n    return createSatelliteConnectStore({\n      ...parameters,\n    });\n  }, []); // Empty dependency array as store should be created only once\n\n  return (\n    <SatelliteStoreContext.Provider value={store}>\n      <InitializeConnectorsProvider autoConnect={autoConnect} />\n      {children}\n    </SatelliteStoreContext.Provider>\n  );\n}\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@tuwaio/satellite-react",
+  "version": "0.0.3",
+  "private": false,
+  "author": "Oleksandr Tkach",
+  "license": "Apache-2.0",
+  "description": "An provider and hook with for React for satellite based wallets.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "web3",
+    "connect",
+    "wallet",
+    "wagmi",
+    "viem",
+    "zustand"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TuwaIO/satellite-connect.git",
+    "directory": "packages/satellite-react"
+  },
+  "homepage": "https://github.com/TuwaIO/satellite-connect",
+  "bugs": {
+    "url": "https://github.com/TuwaIO/satellite-connect/issues"
+  },
+  "contributors": [
+    {
+      "name": "Oleksandr Tkach",
+      "url": "https://github.com/Argeare5"
+    }
+  ],
+  "peerDependencies": {
+    "@tuwaio/orbit-core": ">=0",
+    "@tuwaio/satellite-core": ">=0",
+    "@wagmi/core": ">=2",
+    "@wallet-standard/react": ">=1",
+    "gill": ">=0.11",
+    "react": ">=19",
+    "immer": ">=10",
+    "zustand": ">=5"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.12",
+    "@wagmi/core": "^2.21.1",
+    "@wallet-standard/react": "^1.0.1",
+    "gill": "^0.11.0",
+    "immer": "^10.1.3",
+    "react": "^19.1.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "zustand": "^5.0.8",
+    "@tuwaio/orbit-core": "^0.0.3",
+    "@tuwaio/satellite-core": "^0.0.3",
+    "@tuwaio/orbit-solana": "^0.0.3"
+  },
+  "scripts": {
+    "start": "tsup src/index.ts --watch",
+    "build": "tsup",
+    "test": "vitest"
+  }
+}