@tuwaio/satellite-react 0.5.0 → 0.6.0

package/dist/solana/index.d.ts

@@ -8,41 +8,52 @@ import { SatelliteSiwxState } from '@tuwaio/satellite-core';
  */
 interface SolanaConnectorsWatcherProps {
     /**
-     * Optional Sign-In With X (SIWX) session state.
-     * If provided, the watcher will manage updates and disconnections based on SIWX status.
-     * Directly compatible with `useSiwxSession()` from `@tuwaio/siwx-react`.
+     * Optional Sign-In With X (SIWX) session state, for example the result of `useSiwxSession()` from
+     * `@tuwaio/siwx-react`. The watcher runs again when one of its fields changes.
      */
     siwx?: SatelliteSiwxState;
 }
 /**
- * A dynamic version of the SolanaConnectorsWatcher component that avoids static imports.
- * This component dynamically imports the dependencies only when they are available.
+ * Headless component that keeps the Satellite Connect store in sync with the Solana wallets of the Wallet Standard.
+ * Render it once inside `SatelliteConnectProvider`, next to a Solana adapter.
  *
- * @param props - Component props containing optional SIWX session state.
- * @returns null - This is a headless component
+ * After mount it loads `@tuwaio/satellite-solana` and `@wallet-standard/react` with dynamic imports. Whenever the list
+ * of registered wallets (from `useWallets`) changes, it runs `createSolanaConnectionsWatcher`: an account change in
+ * the connected wallet updates the active connection and a wallet without accounts is disconnected. With `siwx`, the
+ * connection is disconnected when the SIWX sign-in is rejected or fails, or when the account no longer matches the
+ * signed-in session. It also runs when a field of `siwx`, the active connector or the connection error changes. If an
+ * import fails, a warning is logged and nothing is watched.
+ *
+ * @param props - The component props. See {@link SolanaConnectorsWatcherProps}.
+ * @returns `null`; the component renders nothing.
  *
  * @example
  * ```tsx
- * import { useSiwxSession } from '@tuwaio/siwx-react';
  * import { SolanaConnectorsWatcher } from '@tuwaio/satellite-react/solana';
+ * import { useSiwxSession } from '@tuwaio/siwx-react';
  *
- * function WatcherContainer() {
+ * export function WatcherContainer() {
  *   const siwxSession = useSiwxSession();
  *   return <SolanaConnectorsWatcher siwx={siwxSession} />;
  * }
  * ```
- *
- * @remarks
- * Monitors Wallet Standard account changes. Automatically disconnects wallet state if SIWX
- * session validation fails or is rejected.
  */
 declare function SolanaConnectorsWatcher(props?: SolanaConnectorsWatcherProps): react.JSX.Element | null;
 
+/**
+ * The Solana watcher component, imported from `@tuwaio/satellite-react/solana`. Importing this entry point also adds
+ * `SolanaConnection` and `ConnectorSolana` from `@tuwaio/satellite-solana` to `AllConnections` and `AllConnectors`.
+ *
+ * @module solana
+ */
+
 declare module '@tuwaio/satellite-react' {
     interface AllConnections {
+        /** Solana connections (`SolanaConnection` from `@tuwaio/satellite-solana`), added by `@tuwaio/satellite-react/solana`. */
         [OrbitAdapter.SOLANA]: SolanaConnection;
     }
     interface AllConnectors {
+        /** Wallet Standard wallets (`ConnectorSolana` from `@tuwaio/satellite-solana`), added by `@tuwaio/satellite-react/solana`. */
         [OrbitAdapter.SOLANA]: ConnectorSolana;
     }
 }

package/dist/solana/index.js

@@ -1 +1 @@
-import {b}from'../chunk-EYVLQZ24.js';import {useState,useEffect}from'react';import {jsx}from'react/jsx-runtime';function y(o={}){let[c,m]=useState(null);return useEffect(()=>{(async()=>{try{let e=!1,l=null,i=null;try{let[r,a]=await Promise.all([import('@tuwaio/satellite-solana'),import('@wallet-standard/react')]);l=r.createSolanaConnectionsWatcher,i=a.useWallets,e=!0;}catch{e=!1;}if(e){let r=()=>{let a=i(),s=b(t=>t.activeConnection),p=b(t=>t.updateActiveConnection),u=b(t=>t.connectionError),S=b(t=>t.disconnect);return useEffect(()=>l({wallets:a,siwx:o.siwx},{activeConnection:s,disconnect:S,connectionError:u,updateActiveConnection:p}),[s?.connectorType,a,o.siwx,u,p,S]),null};m(()=>r);}}catch(e){console.warn("Failed to load Solana watcher:",e);}})();},[o.siwx]),c?jsx(c,{...o}):null}export{y as SolanaConnectorsWatcher};
+import {a as a$1}from'../chunk-FBHCKH6M.js';import {b,a}from'../chunk-4A4PSLAK.js';import {useState,useEffect,useContext}from'react';import {jsx}from'react/jsx-runtime';function w({modules:a$2,siwx:r}){let l=a$2.useWallets(),o=b(t=>t.activeConnection),e=b(t=>t.updateActiveConnection),c=b(t=>t.connectionError),s=b(t=>t.disconnect),i=useContext(a),S=a$1(r),{createWatcher:p}=a$2;return useEffect(()=>p({wallets:l,siwx:S},{disconnect:s,updateActiveConnection:e,getState:()=>i?.getState()??{activeConnection:o,connectionError:c}}),[p,i,l,S,o?.connectorType,c,e,s]),null}function v(a={}){let[r,l]=useState(null);return useEffect(()=>{let o=true;return Promise.all([import('@tuwaio/satellite-solana'),import('@wallet-standard/react')]).then(([e,c])=>{o&&l({createWatcher:e.createSolanaConnectionsWatcher,useWallets:c.useWallets});}).catch(e=>console.warn("Failed to load Solana watcher:",e)),()=>{o=false;}},[]),r?jsx(w,{modules:r,...a}):null}export{v as SolanaConnectorsWatcher};

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tuwaio/satellite-react",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
-  "description": "Layer 4 (L4) of the TUWA Ecosystem. React state hooks and context providers for orchestrating framework-agnostic Satellite wallet connector instances.",
+  "description": "L4 React package of Satellite Connect (TUWA): provider, store hook and EVM and Solana watcher components that keep wallet connections in sync with wallets and SIWX sessions.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -37,12 +37,16 @@
     "socket.json"
   ],
   "keywords": [
+    "tuwa",
+    "satellite-connect",
+    "wallet-connection",
     "web3",
-    "connect",
-    "wallet",
-    "wagmi",
-    "viem",
-    "zustand"
+    "react",
+    "hooks",
+    "evm",
+    "solana",
+    "siwx",
+    "typescript"
   ],
   "repository": {
     "type": "git",
@@ -61,91 +65,42 @@
   ],
   "peerDependencies": {
     "@tuwaio/orbit-core": ">=0.3",
-    "@tuwaio/orbit-evm": ">=0.3",
-    "@tuwaio/orbit-solana": ">=0.3",
     "@tuwaio/satellite-core": ">=0.5",
     "@tuwaio/satellite-evm": ">=0.5",
     "@tuwaio/satellite-solana": ">=0.5",
-    "@tuwaio/siwx-core": ">=0.3",
-    "@tuwaio/siwx-react": ">=0.3",
     "@wagmi/core": "3.x.x",
-    "viem": "2.x.x",
     "@wallet-standard/react": "1.x.x",
-    "@solana/kit": ">=8.2",
     "react": ">=19.2.3",
-    "immer": "11.x.x",
     "zustand": "5.x.x"
   },
   "peerDependenciesMeta": {
     "@tuwaio/orbit-core": {
-      "optional": false
-    },
-    "@tuwaio/satellite-core": {
-      "optional": false
-    },
-    "react": {
-      "optional": false
-    },
-    "immer": {
-      "optional": false
-    },
-    "zustand": {
-      "optional": false
-    },
-    "@tuwaio/orbit-evm": {
       "optional": true
     },
     "@tuwaio/satellite-evm": {
       "optional": true
     },
-    "@wagmi/core": {
-      "optional": true
-    },
-    "viem": {
-      "optional": true
-    },
-    "@tuwaio/orbit-solana": {
-      "optional": true
-    },
     "@tuwaio/satellite-solana": {
       "optional": true
     },
-    "@tuwaio/siwx-core": {
-      "optional": true
-    },
-    "@tuwaio/siwx-react": {
+    "@wagmi/core": {
       "optional": true
     },
     "@wallet-standard/react": {
       "optional": true
-    },
-    "@solana/kit": {
-      "optional": true
     }
   },
   "devDependencies": {
-    "@types/react": "^19.2.18",
-    "@tuwaio/orbit-core": "^0.3.0",
-    "@tuwaio/orbit-evm": "^0.3.0",
-    "@tuwaio/orbit-solana": "^0.3.0",
-    "@tuwaio/satellite-core": "^0.5.0",
-    "@tuwaio/satellite-evm": "^0.5.0",
-    "@tuwaio/satellite-solana": "^0.5.0",
-    "@tuwaio/siwx-core": "^0.3.0",
-    "@tuwaio/siwx-react": "^0.3.0",
+    "@types/react": "^19.3.0",
+    "@tuwaio/orbit-core": "^0.3.1",
+    "@tuwaio/satellite-core": "^0.6.0",
+    "@tuwaio/satellite-evm": "^0.6.0",
+    "@tuwaio/satellite-solana": "^0.6.0",
     "@wagmi/core": "^3.6.5",
     "@wallet-standard/react": "^1.0.3",
-    "@wallet-standard/app": "^1.1.1",
-    "@wallet-standard/base": "^1.1.1",
-    "@wallet-standard/features": "^1.1.1",
-    "@wallet-standard/core": "^1.1.2",
-    "@wallet-standard/ui": "^1.0.3",
-    "@wallet-standard/ui-registry": "^1.1.1",
-    "@solana/kit": "^8.2.0",
-    "immer": "^11.1.18",
-    "react": "^19.2.8",
+    "react": "^19.3.0",
     "tsup": "^8.5.1",
-    "viem": "^2.56.3",
+    "viem": "^2.56.9",
     "typescript": "6.0.3",
     "zustand": "^5.0.15"
   },

package/dist/chunk-UDS7MUYZ.js

@@ -1 +0,0 @@
-import {a}from'./chunk-EYVLQZ24.js';import {useEffect,useMemo}from'react';import {createSatelliteConnectStore}from'@tuwaio/satellite-core';import {jsx}from'react/jsx-runtime';var l=({initializeAutoConnect:t,onError:n})=>{useEffect(()=>{(async()=>{try{await t();}catch(o){(n??(a=>console.error("Failed to initialize auto connect:",a)))(o);}})();},[]);};function E({children:t,autoConnect:n,...e}){let o=useMemo(()=>createSatelliteConnectStore({...e}),[]);return useEffect(()=>{o.getState().updateParameters(e);},[e,o]),l({initializeAutoConnect:()=>o.getState().initializeAutoConnect(n??!1)}),jsx(a.Provider,{value:o,children:t})}export{l as a,E as b};

package/dist/chunk-YTP4ADBV.cjs

@@ -1 +0,0 @@
-'use strict';var chunkG2YC6JBO_cjs=require('./chunk-G2YC6JBO.cjs'),react=require('react'),satelliteCore=require('@tuwaio/satellite-core'),jsxRuntime=require('react/jsx-runtime');var c=({initializeAutoConnect:t,onError:n})=>{react.useEffect(()=>{(async()=>{try{await t();}catch(o){(n??(l=>console.error("Failed to initialize auto connect:",l)))(o);}})();},[]);};function y({children:t,autoConnect:n,...e}){let o=react.useMemo(()=>satelliteCore.createSatelliteConnectStore({...e}),[]);return react.useEffect(()=>{o.getState().updateParameters(e);},[e,o]),c({initializeAutoConnect:()=>o.getState().initializeAutoConnect(n??!1)}),jsxRuntime.jsx(chunkG2YC6JBO_cjs.a.Provider,{value:o,children:t})}exports.a=c;exports.b=y;