@tuwaio/quasar-sdk 0.0.8 → 0.0.9

package/README.md

@@ -43,14 +43,18 @@ const history = await quasar.pulsar.getHistory({ chainId: 1 });
 
 ## React Authentication Bridge
 
-The SDK provides a unified component to handle multi-chain authentication (EVM & Solana) with zero boilerplate.
+The SDK provides React components to handle authentication with zero boilerplate. To prevent issues with missing optional peer dependencies at build time, the SDK exposes separate ecosystem entry points:
+
+### 1. EVM-Only Bridge (No Solana dependencies required)
+
+If your project only supports EVM chains, import from the `/react/evm` subpath. This avoids compile-time errors if `@solana/react` is not installed.
 
 ```tsx
-import { QuasarAuthBridge } from '@tuwaio/quasar-sdk/react';
+import { QuasarEvmAuthBridge } from '@tuwaio/quasar-sdk/react/evm';
 
 function MyApp() {
   return (
-    <QuasarAuthBridge
+    <QuasarEvmAuthBridge
       activeConnection={activeConnection} // Structural interface for wallet state
       store={store}                      // Zustand store API
       wagmiConfig={config}               // Wagmi config
@@ -61,6 +65,45 @@ function MyApp() {
 }
 ```
 
+### 2. Solana-Only Bridge (No EVM dependencies required)
+
+If your project only supports Solana, import from the `/react/solana` subpath. This avoids compile-time errors if `@wagmi/core` is not installed.
+
+```tsx
+import { QuasarSolanaAuthBridge } from '@tuwaio/quasar-sdk/react/solana';
+
+function MyApp() {
+  return (
+    <QuasarSolanaAuthBridge
+      activeConnection={activeConnection} // Structural interface for wallet state
+      store={store}                      // Zustand store API
+      session={miniSession}              // Current session state
+      setSession={setMiniSession}        // Session setter
+    />
+  );
+}
+```
+
+### 3. Unified Cross-Chain Bridge
+
+If your project supports both ecosystems and has all peer dependencies installed, you can use the unified bridge:
+
+```tsx
+import { QuasarAuthBridge } from '@tuwaio/quasar-sdk/react';
+
+function MyApp() {
+  return (
+    <QuasarAuthBridge
+      activeConnection={activeConnection}
+      store={store}
+      wagmiConfig={config}
+      session={miniSession}
+      setSession={setMiniSession}
+    />
+  );
+}
+```
+
 ## Modules
 
 ### Pulsar — `quasar.pulsar`

package/dist/chunk-7F6I4FHE.js

@@ -0,0 +1 @@
+'use strict';var chunkHVUZ52OX_js=require('./chunk-HVUZ52OX.js'),chunkOJCR5A56_js=require('./chunk-OJCR5A56.js'),core=require('@wagmi/core'),react=require('react'),jsxRuntime=require('react/jsx-runtime');function R({activeConnection:n,store:i,wagmiConfig:r,session:e,setSession:t,maxAge:s,onAddressMismatch:o}){return react.useEffect(()=>{e&&n?.address&&e.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),t(null),o?.());},[n?.address,e,t,o]),!n?.isConnected||!i?null:jsxRuntime.jsx(S,{wagmiConfig:r,store:i,session:e,setSession:t,maxAge:s})}function S({wagmiConfig:n,store:i,session:r,setSession:e,maxAge:t}){let s=react.useRef(r),o=react.useRef(e);react.useEffect(()=>{s.current=r;},[r]),react.useEffect(()=>{o.current=e;},[e]);let l=react.useCallback(async()=>{let u=i.getState().activeConnection;if(!u?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let d=await core.getWalletClient(n);if(!d)throw new Error("[QuasarSDK] EVM Signer not found");return chunkOJCR5A56_js.h({isConnected:u.isConnected,address:u.address,chainType:"EVM",signer:d},{miniSession:s.current,setMiniSession:o.current},t)},[i,n,t]);return react.useEffect(()=>(chunkHVUZ52OX_js.a(l),()=>{chunkHVUZ52OX_js.a(null);}),[l]),null}exports.a=R;

package/dist/chunk-EDXCZKX7.mjs

@@ -0,0 +1 @@
+import {a}from'./chunk-UW6TWEYM.mjs';import {h}from'./chunk-SF2BM2YA.mjs';import {getWalletClient}from'@wagmi/core';import {useEffect,useRef,useCallback}from'react';import {jsx}from'react/jsx-runtime';function R({activeConnection:n,store:i,wagmiConfig:r,session:e,setSession:t,maxAge:s,onAddressMismatch:o}){return useEffect(()=>{e&&n?.address&&e.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),t(null),o?.());},[n?.address,e,t,o]),!n?.isConnected||!i?null:jsx(S,{wagmiConfig:r,store:i,session:e,setSession:t,maxAge:s})}function S({wagmiConfig:n,store:i,session:r,setSession:e,maxAge:t}){let s=useRef(r),o=useRef(e);useEffect(()=>{s.current=r;},[r]),useEffect(()=>{o.current=e;},[e]);let l=useCallback(async()=>{let u=i.getState().activeConnection;if(!u?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let d=await getWalletClient(n);if(!d)throw new Error("[QuasarSDK] EVM Signer not found");return h({isConnected:u.isConnected,address:u.address,chainType:"EVM",signer:d},{miniSession:s.current,setMiniSession:o.current},t)},[i,n,t]);return useEffect(()=>(a(l),()=>{a(null);}),[l]),null}export{R as a};

package/dist/chunk-ERWWKRPN.mjs

@@ -0,0 +1 @@
+import {a}from'./chunk-UW6TWEYM.mjs';import {h}from'./chunk-SF2BM2YA.mjs';import {useWalletAccountMessageSigner}from'@solana/react';import {useEffect,useRef,useCallback}from'react';import {jsx}from'react/jsx-runtime';function D({activeConnection:n,store:r,session:e,setSession:t,maxAge:i,onAddressMismatch:o}){return useEffect(()=>{e&&n?.address&&e.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),t(null),o?.());},[n?.address,e,t,o]),!n?.isConnected||!r?null:jsx(p,{connectedAccount:n.connectedAccount,store:r,session:e,setSession:t,maxAge:i})}function p({connectedAccount:n,store:r,session:e,setSession:t,maxAge:i}){let o=useWalletAccountMessageSigner(n),l=useRef(o),d=useRef(e),A=useRef(t);useEffect(()=>{l.current=o;},[o]),useEffect(()=>{d.current=e;},[e]),useEffect(()=>{A.current=t;},[t]);let S=useCallback(async()=>{let a=r.getState().activeConnection;if(!a?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let f=l.current;if(!f)throw new Error("[QuasarSDK] Solana Message Signer not initialized.");return h({isConnected:a.isConnected,address:a.address,chainType:"SOLANA",signer:f},{miniSession:d.current,setMiniSession:A.current},i)},[r,i]);return useEffect(()=>(a(S),()=>{a(null);}),[S]),null}export{D as a};

package/dist/chunk-HVUZ52OX.js

@@ -0,0 +1 @@
+'use strict';var n=null;function t(e){n=e;}async function r(){for(let e=0;e<15;e++){if(n)return n();await new Promise(i=>setTimeout(i,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}exports.a=t;exports.b=r;

package/dist/chunk-RZ4TLBSP.js

@@ -0,0 +1 @@
+'use strict';var chunkHVUZ52OX_js=require('./chunk-HVUZ52OX.js'),chunkOJCR5A56_js=require('./chunk-OJCR5A56.js'),react$1=require('@solana/react'),react=require('react'),jsxRuntime=require('react/jsx-runtime');function D({activeConnection:n,store:r,session:e,setSession:t,maxAge:i,onAddressMismatch:o}){return react.useEffect(()=>{e&&n?.address&&e.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),t(null),o?.());},[n?.address,e,t,o]),!n?.isConnected||!r?null:jsxRuntime.jsx(p,{connectedAccount:n.connectedAccount,store:r,session:e,setSession:t,maxAge:i})}function p({connectedAccount:n,store:r,session:e,setSession:t,maxAge:i}){let o=react$1.useWalletAccountMessageSigner(n),l=react.useRef(o),d=react.useRef(e),A=react.useRef(t);react.useEffect(()=>{l.current=o;},[o]),react.useEffect(()=>{d.current=e;},[e]),react.useEffect(()=>{A.current=t;},[t]);let S=react.useCallback(async()=>{let a=r.getState().activeConnection;if(!a?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let f=l.current;if(!f)throw new Error("[QuasarSDK] Solana Message Signer not initialized.");return chunkOJCR5A56_js.h({isConnected:a.isConnected,address:a.address,chainType:"SOLANA",signer:f},{miniSession:d.current,setMiniSession:A.current},i)},[r,i]);return react.useEffect(()=>(chunkHVUZ52OX_js.a(S),()=>{chunkHVUZ52OX_js.a(null);}),[S]),null}exports.a=D;

package/dist/chunk-UW6TWEYM.mjs

@@ -0,0 +1 @@
+var n=null;function t(e){n=e;}async function r(){for(let e=0;e<15;e++){if(n)return n();await new Promise(i=>setTimeout(i,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}export{t as a,r as b};

package/dist/react/evm.d.mts

@@ -0,0 +1,56 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Config } from '@wagmi/core';
+import { StoreApi } from 'zustand';
+import { b as MiniSessionAuth } from '../types-Ctaain6g.mjs';
+import { Q as QuasarActiveConnection } from '../shared-CFhEPXTt.mjs';
+export { g as getMiniSessionAuth } from '../shared-CFhEPXTt.mjs';
+
+/**
+ * Props for the QuasarEvmAuthBridge component.
+ *
+ * @public
+ */
+interface QuasarEvmAuthBridgeProps {
+    /** The active connection object (usually from useSatelliteConnectStore). */
+    activeConnection: QuasarActiveConnection | null | undefined;
+    /** The state store API (usually from SatelliteStoreContext). */
+    store: StoreApi<unknown>;
+    /** The Wagmi configuration instance for EVM signing. */
+    wagmiConfig: Config;
+    /** The current Mini-Session authentication data from your state store. */
+    session: MiniSessionAuth | null;
+    /** Callback to update the session in your state store. */
+    setSession: (session: MiniSessionAuth | null) => void;
+    /**
+     * Maximum session age in milliseconds. Must be the same value passed to
+     * `verifyMiniSession` — this is the single source of truth for session lifetime.
+     * Defaults to 5 minutes.
+     */
+    maxAge?: number;
+    /** Optional callback triggered when an address mismatch is detected. */
+    onAddressMismatch?: () => void;
+}
+/**
+ * The Quasar EVM Authentication Bridge.
+ *
+ * This component orchestrates signature requests specifically for EVM wallets,
+ * avoiding any Solana library dependencies.
+ *
+ * @example
+ * ```tsx
+ * import { QuasarEvmAuthBridge } from '@tuwaio/quasar-sdk/react/evm';
+ *
+ * <QuasarEvmAuthBridge
+ *   activeConnection={activeConnection}
+ *   store={store}
+ *   wagmiConfig={config}
+ *   session={auth.miniSession}
+ *   setSession={auth.setMiniSession}
+ * />
+ * ```
+ *
+ * @public
+ */
+declare function QuasarEvmAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarEvmAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+
+export { QuasarActiveConnection, QuasarEvmAuthBridge, type QuasarEvmAuthBridgeProps };

package/dist/react/evm.d.ts

@@ -0,0 +1,56 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Config } from '@wagmi/core';
+import { StoreApi } from 'zustand';
+import { b as MiniSessionAuth } from '../types-Ctaain6g.js';
+import { Q as QuasarActiveConnection } from '../shared-BeprN_w-.js';
+export { g as getMiniSessionAuth } from '../shared-BeprN_w-.js';
+
+/**
+ * Props for the QuasarEvmAuthBridge component.
+ *
+ * @public
+ */
+interface QuasarEvmAuthBridgeProps {
+    /** The active connection object (usually from useSatelliteConnectStore). */
+    activeConnection: QuasarActiveConnection | null | undefined;
+    /** The state store API (usually from SatelliteStoreContext). */
+    store: StoreApi<unknown>;
+    /** The Wagmi configuration instance for EVM signing. */
+    wagmiConfig: Config;
+    /** The current Mini-Session authentication data from your state store. */
+    session: MiniSessionAuth | null;
+    /** Callback to update the session in your state store. */
+    setSession: (session: MiniSessionAuth | null) => void;
+    /**
+     * Maximum session age in milliseconds. Must be the same value passed to
+     * `verifyMiniSession` — this is the single source of truth for session lifetime.
+     * Defaults to 5 minutes.
+     */
+    maxAge?: number;
+    /** Optional callback triggered when an address mismatch is detected. */
+    onAddressMismatch?: () => void;
+}
+/**
+ * The Quasar EVM Authentication Bridge.
+ *
+ * This component orchestrates signature requests specifically for EVM wallets,
+ * avoiding any Solana library dependencies.
+ *
+ * @example
+ * ```tsx
+ * import { QuasarEvmAuthBridge } from '@tuwaio/quasar-sdk/react/evm';
+ *
+ * <QuasarEvmAuthBridge
+ *   activeConnection={activeConnection}
+ *   store={store}
+ *   wagmiConfig={config}
+ *   session={auth.miniSession}
+ *   setSession={auth.setMiniSession}
+ * />
+ * ```
+ *
+ * @public
+ */
+declare function QuasarEvmAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarEvmAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+
+export { QuasarActiveConnection, QuasarEvmAuthBridge, type QuasarEvmAuthBridgeProps };

package/dist/react/evm.js

@@ -0,0 +1 @@
+'use strict';var chunk7F6I4FHE_js=require('../chunk-7F6I4FHE.js'),chunkHVUZ52OX_js=require('../chunk-HVUZ52OX.js');require('../chunk-OJCR5A56.js');Object.defineProperty(exports,"QuasarEvmAuthBridge",{enumerable:true,get:function(){return chunk7F6I4FHE_js.a}});Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkHVUZ52OX_js.b}});

package/dist/react/evm.mjs

@@ -0,0 +1 @@
+export{a as QuasarEvmAuthBridge}from'../chunk-EDXCZKX7.mjs';export{b as getMiniSessionAuth}from'../chunk-UW6TWEYM.mjs';import'../chunk-SF2BM2YA.mjs';

package/dist/react/solana.d.mts

@@ -0,0 +1,52 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { StoreApi } from 'zustand';
+import { b as MiniSessionAuth } from '../types-Ctaain6g.mjs';
+import { Q as QuasarActiveConnection } from '../shared-CFhEPXTt.mjs';
+export { g as getMiniSessionAuth } from '../shared-CFhEPXTt.mjs';
+
+/**
+ * Props for the QuasarSolanaAuthBridge component.
+ *
+ * @public
+ */
+interface QuasarSolanaAuthBridgeProps {
+    /** The active connection object (usually from useSatelliteConnectStore). */
+    activeConnection: QuasarActiveConnection | null | undefined;
+    /** The state store API (usually from SatelliteStoreContext). */
+    store: StoreApi<unknown>;
+    /** The current Mini-Session authentication data from your state store. */
+    session: MiniSessionAuth | null;
+    /** Callback to update the session in your state store. */
+    setSession: (session: MiniSessionAuth | null) => void;
+    /**
+     * Maximum session age in milliseconds. Must be the same value passed to
+     * `verifyMiniSession` — this is the single source of truth for session lifetime.
+     * Defaults to 5 minutes.
+     */
+    maxAge?: number;
+    /** Optional callback triggered when an address mismatch is detected. */
+    onAddressMismatch?: () => void;
+}
+/**
+ * The Quasar Solana Authentication Bridge.
+ *
+ * This component orchestrates signature requests specifically for Solana wallets,
+ * avoiding any EVM / Wagmi library dependencies.
+ *
+ * @example
+ * ```tsx
+ * import { QuasarSolanaAuthBridge } from '@tuwaio/quasar-sdk/react/solana';
+ *
+ * <QuasarSolanaAuthBridge
+ *   activeConnection={activeConnection}
+ *   store={store}
+ *   session={auth.miniSession}
+ *   setSession={auth.setMiniSession}
+ * />
+ * ```
+ *
+ * @public
+ */
+declare function QuasarSolanaAuthBridge({ activeConnection, store, session, setSession, maxAge, onAddressMismatch, }: QuasarSolanaAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+
+export { QuasarActiveConnection, QuasarSolanaAuthBridge, type QuasarSolanaAuthBridgeProps };

package/dist/react/solana.d.ts

@@ -0,0 +1,52 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { StoreApi } from 'zustand';
+import { b as MiniSessionAuth } from '../types-Ctaain6g.js';
+import { Q as QuasarActiveConnection } from '../shared-BeprN_w-.js';
+export { g as getMiniSessionAuth } from '../shared-BeprN_w-.js';
+
+/**
+ * Props for the QuasarSolanaAuthBridge component.
+ *
+ * @public
+ */
+interface QuasarSolanaAuthBridgeProps {
+    /** The active connection object (usually from useSatelliteConnectStore). */
+    activeConnection: QuasarActiveConnection | null | undefined;
+    /** The state store API (usually from SatelliteStoreContext). */
+    store: StoreApi<unknown>;
+    /** The current Mini-Session authentication data from your state store. */
+    session: MiniSessionAuth | null;
+    /** Callback to update the session in your state store. */
+    setSession: (session: MiniSessionAuth | null) => void;
+    /**
+     * Maximum session age in milliseconds. Must be the same value passed to
+     * `verifyMiniSession` — this is the single source of truth for session lifetime.
+     * Defaults to 5 minutes.
+     */
+    maxAge?: number;
+    /** Optional callback triggered when an address mismatch is detected. */
+    onAddressMismatch?: () => void;
+}
+/**
+ * The Quasar Solana Authentication Bridge.
+ *
+ * This component orchestrates signature requests specifically for Solana wallets,
+ * avoiding any EVM / Wagmi library dependencies.
+ *
+ * @example
+ * ```tsx
+ * import { QuasarSolanaAuthBridge } from '@tuwaio/quasar-sdk/react/solana';
+ *
+ * <QuasarSolanaAuthBridge
+ *   activeConnection={activeConnection}
+ *   store={store}
+ *   session={auth.miniSession}
+ *   setSession={auth.setMiniSession}
+ * />
+ * ```
+ *
+ * @public
+ */
+declare function QuasarSolanaAuthBridge({ activeConnection, store, session, setSession, maxAge, onAddressMismatch, }: QuasarSolanaAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+
+export { QuasarActiveConnection, QuasarSolanaAuthBridge, type QuasarSolanaAuthBridgeProps };

package/dist/react/solana.js

@@ -0,0 +1 @@
+'use strict';var chunkRZ4TLBSP_js=require('../chunk-RZ4TLBSP.js'),chunkHVUZ52OX_js=require('../chunk-HVUZ52OX.js');require('../chunk-OJCR5A56.js');Object.defineProperty(exports,"QuasarSolanaAuthBridge",{enumerable:true,get:function(){return chunkRZ4TLBSP_js.a}});Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkHVUZ52OX_js.b}});

package/dist/react/solana.mjs

@@ -0,0 +1 @@
+export{a as QuasarSolanaAuthBridge}from'../chunk-ERWWKRPN.mjs';export{b as getMiniSessionAuth}from'../chunk-UW6TWEYM.mjs';import'../chunk-SF2BM2YA.mjs';

package/dist/react.d.mts

@@ -1,37 +1,15 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Config } from '@wagmi/core';
-import { UiWalletAccount } from '@wallet-standard/react';
 import { StoreApi } from 'zustand';
 import { b as MiniSessionAuth } from './types-Ctaain6g.mjs';
+import { Q as QuasarActiveConnection } from './shared-CFhEPXTt.mjs';
+export { g as getMiniSessionAuth } from './shared-CFhEPXTt.mjs';
 
 /**
- * Structural interface for an active wallet connection.
- * @public
- */
-interface QuasarActiveConnection {
-    /** Whether the wallet is currently connected. */
-    isConnected: boolean;
-    /** The active wallet address. */
-    address: string;
-    /** The chain ID (number for EVM, string for Solana). */
-    chainId: string | number;
-    /** The UiWalletAccount object (required for Solana signing). */
-    connectedAccount?: UiWalletAccount;
-}
-/**
- * Static utility to retrieve or trigger a Mini-Session authentication.
- * This is the primary way for services outside the React tree to get an auth token.
- *
- * @returns A promise resolving to the valid Mini-Session Auth.
- * @throws {Error} If the bridge is not mounted or the wallet is disconnected.
+ * Props for the unified QuasarAuthBridge component.
  *
  * @public
  */
-declare function getMiniSessionAuth(): Promise<MiniSessionAuth>;
-/**
- * Props for the QuasarAuthBridge component.
- * @public
- */
 interface QuasarAuthBridgeProps {
     /** The active connection object (usually from useSatelliteConnectStore). */
     activeConnection: QuasarActiveConnection | null | undefined;
@@ -47,36 +25,24 @@ interface QuasarAuthBridgeProps {
      * Maximum session age in milliseconds. Must be the same value passed to
      * `verifyMiniSession` — this is the single source of truth for session lifetime.
      * Defaults to 5 minutes.
-     *
-     * @example
-     * ```tsx
-     * const TOKEN_EXPIRATION = 86400 * 1000; // 24 hours in ms
-     *
-     * <QuasarAuthBridge maxAge={TOKEN_EXPIRATION} ... />
-     *
-     * // Later, for verification:
-     * verifyMiniSession({ ...auth, maxAge: TOKEN_EXPIRATION });
-     * ```
      */
     maxAge?: number;
     /** Optional callback triggered when an address mismatch is detected. */
     onAddressMismatch?: () => void;
 }
 /**
- * The Quasar Authentication Bridge.
- *
- * This component orchestrates signature requests across Solana and EVM ecosystems.
- * It decouples the SDK from specific library hooks by accepting connection data as props.
+ * The Unified Quasar Authentication Bridge.
  *
- * It automatically handles:
- * 1. Signature generation for both Solana and EVM wallets.
- * 2. Session caching and synchronization with your state store.
- * 3. Address mismatch protection (clearing sessions when the wallet changes).
+ * This component acts as a unified cross-chain coordinator. It dynamically
+ * renders either the EVM or Solana specific bridges based on the connection type.
+ * Note: importing this component requires having both `@wagmi/core` and `@solana/react` installed.
+ * If you only need EVM or Solana bindings, import directly from the corresponding subpath:
+ * - `@tuwaio/quasar-sdk/react/evm`
+ * - `@tuwaio/quasar-sdk/react/solana`
  *
  * @example
  * ```tsx
- * const activeConnection = useSatelliteConnectStore(s => s.activeConnection);
- * const store = useContext(SatelliteStoreContext);
+ * import { QuasarAuthBridge } from '@tuwaio/quasar-sdk/react';
  *
  * <QuasarAuthBridge
  *   activeConnection={activeConnection}
@@ -91,4 +57,4 @@ interface QuasarAuthBridgeProps {
  */
 declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
 
-export { type QuasarActiveConnection, QuasarAuthBridge, type QuasarAuthBridgeProps, getMiniSessionAuth };
+export { QuasarActiveConnection, QuasarAuthBridge, type QuasarAuthBridgeProps };

package/dist/react.d.ts

@@ -1,37 +1,15 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Config } from '@wagmi/core';
-import { UiWalletAccount } from '@wallet-standard/react';
 import { StoreApi } from 'zustand';
 import { b as MiniSessionAuth } from './types-Ctaain6g.js';
+import { Q as QuasarActiveConnection } from './shared-BeprN_w-.js';
+export { g as getMiniSessionAuth } from './shared-BeprN_w-.js';
 
 /**
- * Structural interface for an active wallet connection.
- * @public
- */
-interface QuasarActiveConnection {
-    /** Whether the wallet is currently connected. */
-    isConnected: boolean;
-    /** The active wallet address. */
-    address: string;
-    /** The chain ID (number for EVM, string for Solana). */
-    chainId: string | number;
-    /** The UiWalletAccount object (required for Solana signing). */
-    connectedAccount?: UiWalletAccount;
-}
-/**
- * Static utility to retrieve or trigger a Mini-Session authentication.
- * This is the primary way for services outside the React tree to get an auth token.
- *
- * @returns A promise resolving to the valid Mini-Session Auth.
- * @throws {Error} If the bridge is not mounted or the wallet is disconnected.
+ * Props for the unified QuasarAuthBridge component.
  *
  * @public
  */
-declare function getMiniSessionAuth(): Promise<MiniSessionAuth>;
-/**
- * Props for the QuasarAuthBridge component.
- * @public
- */
 interface QuasarAuthBridgeProps {
     /** The active connection object (usually from useSatelliteConnectStore). */
     activeConnection: QuasarActiveConnection | null | undefined;
@@ -47,36 +25,24 @@ interface QuasarAuthBridgeProps {
      * Maximum session age in milliseconds. Must be the same value passed to
      * `verifyMiniSession` — this is the single source of truth for session lifetime.
      * Defaults to 5 minutes.
-     *
-     * @example
-     * ```tsx
-     * const TOKEN_EXPIRATION = 86400 * 1000; // 24 hours in ms
-     *
-     * <QuasarAuthBridge maxAge={TOKEN_EXPIRATION} ... />
-     *
-     * // Later, for verification:
-     * verifyMiniSession({ ...auth, maxAge: TOKEN_EXPIRATION });
-     * ```
      */
     maxAge?: number;
     /** Optional callback triggered when an address mismatch is detected. */
     onAddressMismatch?: () => void;
 }
 /**
- * The Quasar Authentication Bridge.
- *
- * This component orchestrates signature requests across Solana and EVM ecosystems.
- * It decouples the SDK from specific library hooks by accepting connection data as props.
+ * The Unified Quasar Authentication Bridge.
  *
- * It automatically handles:
- * 1. Signature generation for both Solana and EVM wallets.
- * 2. Session caching and synchronization with your state store.
- * 3. Address mismatch protection (clearing sessions when the wallet changes).
+ * This component acts as a unified cross-chain coordinator. It dynamically
+ * renders either the EVM or Solana specific bridges based on the connection type.
+ * Note: importing this component requires having both `@wagmi/core` and `@solana/react` installed.
+ * If you only need EVM or Solana bindings, import directly from the corresponding subpath:
+ * - `@tuwaio/quasar-sdk/react/evm`
+ * - `@tuwaio/quasar-sdk/react/solana`
  *
  * @example
  * ```tsx
- * const activeConnection = useSatelliteConnectStore(s => s.activeConnection);
- * const store = useContext(SatelliteStoreContext);
+ * import { QuasarAuthBridge } from '@tuwaio/quasar-sdk/react';
  *
  * <QuasarAuthBridge
  *   activeConnection={activeConnection}
@@ -91,4 +57,4 @@ interface QuasarAuthBridgeProps {
  */
 declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
 
-export { type QuasarActiveConnection, QuasarAuthBridge, type QuasarAuthBridgeProps, getMiniSessionAuth };
+export { QuasarActiveConnection, QuasarAuthBridge, type QuasarAuthBridgeProps };

package/dist/react.js

@@ -1 +1 @@
-'use strict';var chunkOJCR5A56_js=require('./chunk-OJCR5A56.js'),react$1=require('@solana/react'),core=require('@wagmi/core'),react=require('react'),jsxRuntime=require('react/jsx-runtime');var u=null;async function K(){for(let n=0;n<15;n++){if(u)return u();await new Promise(t=>setTimeout(t,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}function x({activeConnection:n,store:t,wagmiConfig:r,session:e,setSession:i,maxAge:o,onAddressMismatch:s}){let d=typeof n?.chainId=="string"?"SOLANA":"EVM";return react.useEffect(()=>{e&&n?.address&&e.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),i(null),s?.());},[n?.address,e,i,s]),!n?.isConnected||!t?null:d==="SOLANA"?jsxRuntime.jsx(M,{connectedAccount:n.connectedAccount,store:t,session:e,setSession:i,maxAge:o}):jsxRuntime.jsx(Q,{wagmiConfig:r,store:t,session:e,setSession:i,maxAge:o})}function M({connectedAccount:n,store:t,session:r,setSession:e,maxAge:i}){let o=react$1.useWalletAccountMessageSigner(n),s=react.useRef(o),c=react.useRef(r),d=react.useRef(e);react.useEffect(()=>{s.current=o;},[o]),react.useEffect(()=>{c.current=r;},[r]),react.useEffect(()=>{d.current=e;},[e]);let l=react.useCallback(async()=>{let g=t.getState().activeConnection;if(!g?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let h=s.current;if(!h)throw new Error("[QuasarSDK] Solana Message Signer not initialized.");return chunkOJCR5A56_js.h({isConnected:g.isConnected,address:g.address,chainType:"SOLANA",signer:h},{miniSession:c.current,setMiniSession:d.current},i)},[t,i]);return react.useEffect(()=>(u=l,()=>{u===l&&(u=null);}),[l]),null}function Q({wagmiConfig:n,store:t,session:r,setSession:e,maxAge:i}){let o=react.useRef(r),s=react.useRef(e);react.useEffect(()=>{o.current=r;},[r]),react.useEffect(()=>{s.current=e;},[e]);let c=react.useCallback(async()=>{let l=t.getState().activeConnection;if(!l?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let A=await core.getWalletClient(n);if(!A)throw new Error("[QuasarSDK] EVM Signer not found");return chunkOJCR5A56_js.h({isConnected:l.isConnected,address:l.address,chainType:"EVM",signer:A},{miniSession:o.current,setMiniSession:s.current},i)},[t,n,i]);return react.useEffect(()=>(u=c,()=>{u===c&&(u=null);}),[c]),null}exports.QuasarAuthBridge=x;exports.getMiniSessionAuth=K;
+'use strict';var chunk7F6I4FHE_js=require('./chunk-7F6I4FHE.js'),chunkRZ4TLBSP_js=require('./chunk-RZ4TLBSP.js'),chunkHVUZ52OX_js=require('./chunk-HVUZ52OX.js');require('./chunk-OJCR5A56.js');var react=require('react'),jsxRuntime=require('react/jsx-runtime');function C({activeConnection:r,store:e,wagmiConfig:d,session:i,setSession:o,maxAge:n,onAddressMismatch:s}){let m=typeof r?.chainId=="string"?"SOLANA":"EVM";return react.useEffect(()=>{i&&r?.address&&i.walletAddress!==r.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),o(null),s?.());},[r?.address,i,o,s]),!r?.isConnected||!e?null:m==="SOLANA"?jsxRuntime.jsx(chunkRZ4TLBSP_js.a,{activeConnection:r,store:e,session:i,setSession:o,maxAge:n}):jsxRuntime.jsx(chunk7F6I4FHE_js.a,{activeConnection:r,store:e,wagmiConfig:d,session:i,setSession:o,maxAge:n})}Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkHVUZ52OX_js.b}});exports.QuasarAuthBridge=C;

package/dist/react.mjs

@@ -1 +1 @@
-import {h}from'./chunk-SF2BM2YA.mjs';import {useWalletAccountMessageSigner}from'@solana/react';import {getWalletClient}from'@wagmi/core';import {useEffect,useRef,useCallback}from'react';import {jsx}from'react/jsx-runtime';var u=null;async function K(){for(let n=0;n<15;n++){if(u)return u();await new Promise(t=>setTimeout(t,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}function x({activeConnection:n,store:t,wagmiConfig:r,session:e,setSession:i,maxAge:o,onAddressMismatch:s}){let d=typeof n?.chainId=="string"?"SOLANA":"EVM";return useEffect(()=>{e&&n?.address&&e.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),i(null),s?.());},[n?.address,e,i,s]),!n?.isConnected||!t?null:d==="SOLANA"?jsx(M,{connectedAccount:n.connectedAccount,store:t,session:e,setSession:i,maxAge:o}):jsx(Q,{wagmiConfig:r,store:t,session:e,setSession:i,maxAge:o})}function M({connectedAccount:n,store:t,session:r,setSession:e,maxAge:i}){let o=useWalletAccountMessageSigner(n),s=useRef(o),c=useRef(r),d=useRef(e);useEffect(()=>{s.current=o;},[o]),useEffect(()=>{c.current=r;},[r]),useEffect(()=>{d.current=e;},[e]);let l=useCallback(async()=>{let g=t.getState().activeConnection;if(!g?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let h$1=s.current;if(!h$1)throw new Error("[QuasarSDK] Solana Message Signer not initialized.");return h({isConnected:g.isConnected,address:g.address,chainType:"SOLANA",signer:h$1},{miniSession:c.current,setMiniSession:d.current},i)},[t,i]);return useEffect(()=>(u=l,()=>{u===l&&(u=null);}),[l]),null}function Q({wagmiConfig:n,store:t,session:r,setSession:e,maxAge:i}){let o=useRef(r),s=useRef(e);useEffect(()=>{o.current=r;},[r]),useEffect(()=>{s.current=e;},[e]);let c=useCallback(async()=>{let l=t.getState().activeConnection;if(!l?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let A=await getWalletClient(n);if(!A)throw new Error("[QuasarSDK] EVM Signer not found");return h({isConnected:l.isConnected,address:l.address,chainType:"EVM",signer:A},{miniSession:o.current,setMiniSession:s.current},i)},[t,n,i]);return useEffect(()=>(u=c,()=>{u===c&&(u=null);}),[c]),null}export{x as QuasarAuthBridge,K as getMiniSessionAuth};
+import {a as a$1}from'./chunk-EDXCZKX7.mjs';import {a}from'./chunk-ERWWKRPN.mjs';export{b as getMiniSessionAuth}from'./chunk-UW6TWEYM.mjs';import'./chunk-SF2BM2YA.mjs';import {useEffect}from'react';import {jsx}from'react/jsx-runtime';function C({activeConnection:r,store:e,wagmiConfig:d,session:i,setSession:o,maxAge:n,onAddressMismatch:s}){let m=typeof r?.chainId=="string"?"SOLANA":"EVM";return useEffect(()=>{i&&r?.address&&i.walletAddress!==r.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),o(null),s?.());},[r?.address,i,o,s]),!r?.isConnected||!e?null:m==="SOLANA"?jsx(a,{activeConnection:r,store:e,session:i,setSession:o,maxAge:n}):jsx(a$1,{activeConnection:r,store:e,wagmiConfig:d,session:i,setSession:o,maxAge:n})}export{C as QuasarAuthBridge};

package/dist/shared-BeprN_w-.d.ts

@@ -0,0 +1,35 @@
+import { b as MiniSessionAuth } from './types-Ctaain6g.js';
+
+/**
+ * @module react/shared
+ * @description Shared React-agnostic state and type definitions for Quasar React Bridges.
+ */
+
+/**
+ * Structural interface for the active wallet connection state.
+ * Used to decoupling the SDK from specific library hooks.
+ *
+ * @public
+ */
+interface QuasarActiveConnection {
+    /** Whether the wallet is currently connected. */
+    isConnected: boolean;
+    /** The active wallet address. */
+    address: string;
+    /** The chain ID (number for EVM, string for Solana). */
+    chainId: string | number;
+    /** The UiWalletAccount object (required for Solana signing). */
+    connectedAccount?: any;
+}
+/**
+ * Static utility to retrieve or trigger a Mini-Session authentication.
+ * This is the primary way for services outside the React tree to get an auth token.
+ *
+ * @returns A promise resolving to the valid Mini-Session Auth.
+ * @throws {Error} If the bridge is not mounted or the wallet is disconnected.
+ *
+ * @public
+ */
+declare function getMiniSessionAuth(): Promise<MiniSessionAuth>;
+
+export { type QuasarActiveConnection as Q, getMiniSessionAuth as g };

package/dist/shared-CFhEPXTt.d.mts

@@ -0,0 +1,35 @@
+import { b as MiniSessionAuth } from './types-Ctaain6g.mjs';
+
+/**
+ * @module react/shared
+ * @description Shared React-agnostic state and type definitions for Quasar React Bridges.
+ */
+
+/**
+ * Structural interface for the active wallet connection state.
+ * Used to decoupling the SDK from specific library hooks.
+ *
+ * @public
+ */
+interface QuasarActiveConnection {
+    /** Whether the wallet is currently connected. */
+    isConnected: boolean;
+    /** The active wallet address. */
+    address: string;
+    /** The chain ID (number for EVM, string for Solana). */
+    chainId: string | number;
+    /** The UiWalletAccount object (required for Solana signing). */
+    connectedAccount?: any;
+}
+/**
+ * Static utility to retrieve or trigger a Mini-Session authentication.
+ * This is the primary way for services outside the React tree to get an auth token.
+ *
+ * @returns A promise resolving to the valid Mini-Session Auth.
+ * @throws {Error} If the bridge is not mounted or the wallet is disconnected.
+ *
+ * @public
+ */
+declare function getMiniSessionAuth(): Promise<MiniSessionAuth>;
+
+export { type QuasarActiveConnection as Q, getMiniSessionAuth as g };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/quasar-sdk",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -18,6 +18,16 @@
       "types": "./dist/react.d.ts",
       "import": "./dist/react.mjs",
       "require": "./dist/react.js"
+    },
+    "./react/evm": {
+      "types": "./dist/react/evm.d.ts",
+      "import": "./dist/react/evm.mjs",
+      "require": "./dist/react/evm.js"
+    },
+    "./react/solana": {
+      "types": "./dist/react/solana.d.ts",
+      "import": "./dist/react/solana.mjs",
+      "require": "./dist/react/solana.js"
     }
   },
   "publishConfig": {