@tuwaio/quasar-sdk 0.0.7 → 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-OJCR5A56.js

@@ -0,0 +1 @@
+'use strict';var zustand=require('zustand'),middleware=require('zustand/middleware');var d=(t=>(t.EVM="EVM",t.SOLANA="SOLANA",t))(d||{});var S=300*1e3,w=60*1e3,m=30*1e3;function y(e){return `Mini-Session Login: ${e}`}async function f(e){let r=new Date().toISOString(),t=y(r);if(e.chainType==="EVM"){let i=e.signer;try{return {signature:await i.signMessage({account:e.walletAddress,message:t}),timestamp:r}}catch(n){throw new Error(`[SDK] EVM signing failed: ${n.message}`,{cause:n})}}if(e.chainType==="SOLANA"){let i=e.signer,n;try{n=await import('gill');}catch(s){throw new Error('[SDK] Peer dependency "gill" is required for Solana signing.',{cause:s})}try{let a=n.getUtf8Encoder().encode(t),o;if(i.modifyAndSignMessages){let g=n.createSignableMessage(a),[p]=await i.modifyAndSignMessages([g]),u=p.signatures[i.address];if(!u)throw new Error(`[SDK] Signature missing for address: ${i.address}`);o=u;}else if(i.signMessages){let[g]=await i.signMessages([a]);if(!g?.signature)throw new Error("[SDK] Wallet returned invalid signMessages output.");o=g.signature;}else if(i.signMessage)o=await i.signMessage(a);else throw new Error("[SDK] Signer lacks message signing capabilities.");return {signature:n.getSignatureFromBytes(o),timestamp:r}}catch(s){throw new Error(`[SDK] Solana signing failed: ${s.message}`,{cause:s})}}throw new Error(`[SDK] Unsupported chain type: ${e.chainType}`)}async function b(e){let r=new Date(e.timestamp).getTime(),t=Date.now();if(isNaN(r))throw new Error("[SDK] Invalid timestamp format. Use ISO string.");let i=e.maxAge??S;if(t-r>i)throw new Error("[SDK] Signature expired. Please sign a fresh message.");if(r>t+w)throw new Error("[SDK] Timestamp is in the future. Check your system clock.");let n=y(e.timestamp);if(e.chainType==="EVM"){let s;try{s=await import('viem');}catch(a){throw new Error('[SDK] Peer dependency "viem" is required for EVM verification.',{cause:a})}return await s.verifyMessage({address:e.walletAddress,message:n,signature:e.signature})}if(e.chainType==="SOLANA"){let s;try{s=await import('gill');}catch(a){throw new Error('[SDK] Peer dependency "gill" is required for Solana verification.',{cause:a})}try{let a=s.address(e.walletAddress);return await s.verifySignatureForAddress(a,e.signature,n)}catch{return  false}}return  false}var c=null;function R(e="mini-session-storage"){return zustand.create()(middleware.persist(r=>({miniSession:null,setMiniSession:t=>r({miniSession:t}),clearSession:()=>r({miniSession:null})}),{name:e}))}async function C(e,r,t=S){let{isConnected:i,address:n,chainType:s,signer:a}=e;if(!i||!n)throw new Error("[SDK] Wallet not connected. Please connect your wallet first.");let o=r.miniSession;if(o&&o.walletAddress===n&&o.chainType===s){let l=Date.now(),g=new Date(o.timestamp).getTime();if(l-g<t-m)return o}return c||(c=f({signer:a,walletAddress:n,chainType:s}).then(l=>{let g={...l,chainType:s,walletAddress:n};return r.setMiniSession(g),g}).finally(()=>{c=null;})),c}exports.a=d;exports.b=S;exports.c=m;exports.d=y;exports.e=f;exports.f=b;exports.g=R;exports.h=C;

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-SF2BM2YA.mjs

@@ -0,0 +1 @@
+import {create}from'zustand';import {persist}from'zustand/middleware';var d=(t=>(t.EVM="EVM",t.SOLANA="SOLANA",t))(d||{});var S=300*1e3,w=60*1e3,m=30*1e3;function y(e){return `Mini-Session Login: ${e}`}async function f(e){let r=new Date().toISOString(),t=y(r);if(e.chainType==="EVM"){let i=e.signer;try{return {signature:await i.signMessage({account:e.walletAddress,message:t}),timestamp:r}}catch(n){throw new Error(`[SDK] EVM signing failed: ${n.message}`,{cause:n})}}if(e.chainType==="SOLANA"){let i=e.signer,n;try{n=await import('gill');}catch(s){throw new Error('[SDK] Peer dependency "gill" is required for Solana signing.',{cause:s})}try{let a=n.getUtf8Encoder().encode(t),o;if(i.modifyAndSignMessages){let g=n.createSignableMessage(a),[p]=await i.modifyAndSignMessages([g]),u=p.signatures[i.address];if(!u)throw new Error(`[SDK] Signature missing for address: ${i.address}`);o=u;}else if(i.signMessages){let[g]=await i.signMessages([a]);if(!g?.signature)throw new Error("[SDK] Wallet returned invalid signMessages output.");o=g.signature;}else if(i.signMessage)o=await i.signMessage(a);else throw new Error("[SDK] Signer lacks message signing capabilities.");return {signature:n.getSignatureFromBytes(o),timestamp:r}}catch(s){throw new Error(`[SDK] Solana signing failed: ${s.message}`,{cause:s})}}throw new Error(`[SDK] Unsupported chain type: ${e.chainType}`)}async function b(e){let r=new Date(e.timestamp).getTime(),t=Date.now();if(isNaN(r))throw new Error("[SDK] Invalid timestamp format. Use ISO string.");let i=e.maxAge??S;if(t-r>i)throw new Error("[SDK] Signature expired. Please sign a fresh message.");if(r>t+w)throw new Error("[SDK] Timestamp is in the future. Check your system clock.");let n=y(e.timestamp);if(e.chainType==="EVM"){let s;try{s=await import('viem');}catch(a){throw new Error('[SDK] Peer dependency "viem" is required for EVM verification.',{cause:a})}return await s.verifyMessage({address:e.walletAddress,message:n,signature:e.signature})}if(e.chainType==="SOLANA"){let s;try{s=await import('gill');}catch(a){throw new Error('[SDK] Peer dependency "gill" is required for Solana verification.',{cause:a})}try{let a=s.address(e.walletAddress);return await s.verifySignatureForAddress(a,e.signature,n)}catch{return  false}}return  false}var c=null;function R(e="mini-session-storage"){return create()(persist(r=>({miniSession:null,setMiniSession:t=>r({miniSession:t}),clearSession:()=>r({miniSession:null})}),{name:e}))}async function C(e,r,t=S){let{isConnected:i,address:n,chainType:s,signer:a}=e;if(!i||!n)throw new Error("[SDK] Wallet not connected. Please connect your wallet first.");let o=r.miniSession;if(o&&o.walletAddress===n&&o.chainType===s){let l=Date.now(),g=new Date(o.timestamp).getTime();if(l-g<t-m)return o}return c||(c=f({signer:a,walletAddress:n,chainType:s}).then(l=>{let g={...l,chainType:s,walletAddress:n};return r.setMiniSession(g),g}).finally(()=>{c=null;})),c}export{d as a,S as b,m as c,y as d,f as e,b as f,R as g,C as h};

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/index.d.mts

@@ -287,6 +287,9 @@ declare function createMiniSessionStore(storageName?: string): zustand.UseBoundS
  *
  * @param connection - The current active wallet connection data (address, signer, etc).
  * @param store - A store implementation (Zustand or compatible) for session persistence.
+ * @param maxAge - Maximum allowed session age in milliseconds. Must match the value
+ *   passed to `verifyMiniSession` to keep cache and verification in sync.
+ *   Defaults to `DEFAULT_MAX_AGE` (5 minutes).
  * @returns A promise resolving to a valid MiniSessionAuth object.
  * @throws {Error} If the wallet is disconnected or signing fails.
  *
@@ -295,7 +298,7 @@ declare function createMiniSessionStore(storageName?: string): zustand.UseBoundS
 declare function getMiniSessionAuth(connection: ConnectionData, store: {
     miniSession: MiniSessionAuth | null;
     setMiniSession: (session: MiniSessionAuth | null) => void;
-}): Promise<MiniSessionAuth>;
+}, maxAge?: number): Promise<MiniSessionAuth>;
 
 declare const BASE_API_URL = "https://api.tuwa.io";
 declare const PULSAR_SYNC_ENDPOINT = "/v1/engine/pulsar/sync";

package/dist/index.d.ts

@@ -287,6 +287,9 @@ declare function createMiniSessionStore(storageName?: string): zustand.UseBoundS
  *
  * @param connection - The current active wallet connection data (address, signer, etc).
  * @param store - A store implementation (Zustand or compatible) for session persistence.
+ * @param maxAge - Maximum allowed session age in milliseconds. Must match the value
+ *   passed to `verifyMiniSession` to keep cache and verification in sync.
+ *   Defaults to `DEFAULT_MAX_AGE` (5 minutes).
  * @returns A promise resolving to a valid MiniSessionAuth object.
  * @throws {Error} If the wallet is disconnected or signing fails.
  *
@@ -295,7 +298,7 @@ declare function createMiniSessionStore(storageName?: string): zustand.UseBoundS
 declare function getMiniSessionAuth(connection: ConnectionData, store: {
     miniSession: MiniSessionAuth | null;
     setMiniSession: (session: MiniSessionAuth | null) => void;
-}): Promise<MiniSessionAuth>;
+}, maxAge?: number): Promise<MiniSessionAuth>;
 
 declare const BASE_API_URL = "https://api.tuwa.io";
 declare const PULSAR_SYNC_ENDPOINT = "/v1/engine/pulsar/sync";

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var chunkM56HRFZC_js=require('./chunk-M56HRFZC.js'),ofetch=require('ofetch');var m="https://api.tuwa.io",h="/v1/engine/pulsar/sync",d="/v1/engine/pulsar/history";var i=class extends Error{status;originalError;constructor(t,e,r){super(t),this.name="QuasarSDKError",this.status=e,this.originalError=r;}},o=class{secretKey;internalSecret;baseUrl;timeout;constructor(t){if(!t.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=t.secretKey,this.internalSecret=t.internalSecret,this.baseUrl=t.baseUrl||m,this.timeout=t.timeout||1e4;}async request(t,e={}){try{return await ofetch.ofetch(t,{baseURL:this.baseUrl,timeout:this.timeout,...e,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...e.headers}})}catch(r){throw this.buildError(r)}}buildError(t){let e=t,r=e.statusCode??e.response?.status,S=(e.data??e.response?._data)?.error??e.message??"Unknown Error";return (r===401||r===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new i(`[Quasar SDK] Request Failed (${r}): ${S}`,r,e)}};var s=class{constructor(t){this.client=t;}async syncCreate(t,e){return this.client.request(h,{method:"POST",body:{...t,appName:e}})}async getHistory(t={}){return this.client.request(d,{method:"GET",query:{page:t.page??1,limit:t.limit??10,chainId:t.chainId,status:t.status,txKey:t.txKey,appName:t.appName,walletAddress:t.walletAddress}})}};var E={createMiniSessionMessage:chunkM56HRFZC_js.d,verifyMiniSession:chunkM56HRFZC_js.f,signMiniSession:chunkM56HRFZC_js.e,createMiniSessionStore:chunkM56HRFZC_js.g,getMiniSessionAuth:chunkM56HRFZC_js.h},y=class{static utils=E;client;pulsar;constructor(t){this.client=new o(t),this.pulsar=new s(this.client);}};
-Object.defineProperty(exports,"ChainType",{enumerable:true,get:function(){return chunkM56HRFZC_js.a}});Object.defineProperty(exports,"DEFAULT_MAX_AGE",{enumerable:true,get:function(){return chunkM56HRFZC_js.b}});Object.defineProperty(exports,"NETWORK_SAFETY_BUFFER",{enumerable:true,get:function(){return chunkM56HRFZC_js.c}});Object.defineProperty(exports,"createMiniSessionMessage",{enumerable:true,get:function(){return chunkM56HRFZC_js.d}});Object.defineProperty(exports,"createMiniSessionStore",{enumerable:true,get:function(){return chunkM56HRFZC_js.g}});Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkM56HRFZC_js.h}});Object.defineProperty(exports,"signMiniSession",{enumerable:true,get:function(){return chunkM56HRFZC_js.e}});Object.defineProperty(exports,"verifyMiniSession",{enumerable:true,get:function(){return chunkM56HRFZC_js.f}});exports.BASE_API_URL=m;exports.PULSAR_HISTORY_ENDPOINT=d;exports.PULSAR_SYNC_ENDPOINT=h;exports.PulsarModule=s;exports.Quasar=y;exports.QuasarSDKError=i;exports.utils=E;
+'use strict';var chunkOJCR5A56_js=require('./chunk-OJCR5A56.js'),ofetch=require('ofetch');var m="https://api.tuwa.io",h="/v1/engine/pulsar/sync",d="/v1/engine/pulsar/history";var i=class extends Error{status;originalError;constructor(t,e,r){super(t),this.name="QuasarSDKError",this.status=e,this.originalError=r;}},o=class{secretKey;internalSecret;baseUrl;timeout;constructor(t){if(!t.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=t.secretKey,this.internalSecret=t.internalSecret,this.baseUrl=t.baseUrl||m,this.timeout=t.timeout||1e4;}async request(t,e={}){try{return await ofetch.ofetch(t,{baseURL:this.baseUrl,timeout:this.timeout,...e,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...e.headers}})}catch(r){throw this.buildError(r)}}buildError(t){let e=t,r=e.statusCode??e.response?.status,S=(e.data??e.response?._data)?.error??e.message??"Unknown Error";return (r===401||r===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new i(`[Quasar SDK] Request Failed (${r}): ${S}`,r,e)}};var s=class{constructor(t){this.client=t;}async syncCreate(t,e){return this.client.request(h,{method:"POST",body:{...t,appName:e}})}async getHistory(t={}){return this.client.request(d,{method:"GET",query:{page:t.page??1,limit:t.limit??10,chainId:t.chainId,status:t.status,txKey:t.txKey,appName:t.appName,walletAddress:t.walletAddress}})}};var E={createMiniSessionMessage:chunkOJCR5A56_js.d,verifyMiniSession:chunkOJCR5A56_js.f,signMiniSession:chunkOJCR5A56_js.e,createMiniSessionStore:chunkOJCR5A56_js.g,getMiniSessionAuth:chunkOJCR5A56_js.h},y=class{static utils=E;client;pulsar;constructor(t){this.client=new o(t),this.pulsar=new s(this.client);}};
+Object.defineProperty(exports,"ChainType",{enumerable:true,get:function(){return chunkOJCR5A56_js.a}});Object.defineProperty(exports,"DEFAULT_MAX_AGE",{enumerable:true,get:function(){return chunkOJCR5A56_js.b}});Object.defineProperty(exports,"NETWORK_SAFETY_BUFFER",{enumerable:true,get:function(){return chunkOJCR5A56_js.c}});Object.defineProperty(exports,"createMiniSessionMessage",{enumerable:true,get:function(){return chunkOJCR5A56_js.d}});Object.defineProperty(exports,"createMiniSessionStore",{enumerable:true,get:function(){return chunkOJCR5A56_js.g}});Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkOJCR5A56_js.h}});Object.defineProperty(exports,"signMiniSession",{enumerable:true,get:function(){return chunkOJCR5A56_js.e}});Object.defineProperty(exports,"verifyMiniSession",{enumerable:true,get:function(){return chunkOJCR5A56_js.f}});exports.BASE_API_URL=m;exports.PULSAR_HISTORY_ENDPOINT=d;exports.PULSAR_SYNC_ENDPOINT=h;exports.PulsarModule=s;exports.Quasar=y;exports.QuasarSDKError=i;exports.utils=E;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {h as h$1,g,e,f,d as d$1}from'./chunk-HJ3SAN77.mjs';export{a as ChainType,b as DEFAULT_MAX_AGE,c as NETWORK_SAFETY_BUFFER,d as createMiniSessionMessage,g as createMiniSessionStore,h as getMiniSessionAuth,e as signMiniSession,f as verifyMiniSession}from'./chunk-HJ3SAN77.mjs';import {ofetch}from'ofetch';var m="https://api.tuwa.io",h="/v1/engine/pulsar/sync",d="/v1/engine/pulsar/history";var i=class extends Error{status;originalError;constructor(t,e,r){super(t),this.name="QuasarSDKError",this.status=e,this.originalError=r;}},o=class{secretKey;internalSecret;baseUrl;timeout;constructor(t){if(!t.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=t.secretKey,this.internalSecret=t.internalSecret,this.baseUrl=t.baseUrl||m,this.timeout=t.timeout||1e4;}async request(t,e={}){try{return await ofetch(t,{baseURL:this.baseUrl,timeout:this.timeout,...e,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...e.headers}})}catch(r){throw this.buildError(r)}}buildError(t){let e=t,r=e.statusCode??e.response?.status,S=(e.data??e.response?._data)?.error??e.message??"Unknown Error";return (r===401||r===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new i(`[Quasar SDK] Request Failed (${r}): ${S}`,r,e)}};var s=class{constructor(t){this.client=t;}async syncCreate(t,e){return this.client.request(h,{method:"POST",body:{...t,appName:e}})}async getHistory(t={}){return this.client.request(d,{method:"GET",query:{page:t.page??1,limit:t.limit??10,chainId:t.chainId,status:t.status,txKey:t.txKey,appName:t.appName,walletAddress:t.walletAddress}})}};var E={createMiniSessionMessage:d$1,verifyMiniSession:f,signMiniSession:e,createMiniSessionStore:g,getMiniSessionAuth:h$1},y=class{static utils=E;client;pulsar;constructor(t){this.client=new o(t),this.pulsar=new s(this.client);}};
+import {h as h$1,g,e,f,d as d$1}from'./chunk-SF2BM2YA.mjs';export{a as ChainType,b as DEFAULT_MAX_AGE,c as NETWORK_SAFETY_BUFFER,d as createMiniSessionMessage,g as createMiniSessionStore,h as getMiniSessionAuth,e as signMiniSession,f as verifyMiniSession}from'./chunk-SF2BM2YA.mjs';import {ofetch}from'ofetch';var m="https://api.tuwa.io",h="/v1/engine/pulsar/sync",d="/v1/engine/pulsar/history";var i=class extends Error{status;originalError;constructor(t,e,r){super(t),this.name="QuasarSDKError",this.status=e,this.originalError=r;}},o=class{secretKey;internalSecret;baseUrl;timeout;constructor(t){if(!t.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=t.secretKey,this.internalSecret=t.internalSecret,this.baseUrl=t.baseUrl||m,this.timeout=t.timeout||1e4;}async request(t,e={}){try{return await ofetch(t,{baseURL:this.baseUrl,timeout:this.timeout,...e,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...e.headers}})}catch(r){throw this.buildError(r)}}buildError(t){let e=t,r=e.statusCode??e.response?.status,S=(e.data??e.response?._data)?.error??e.message??"Unknown Error";return (r===401||r===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new i(`[Quasar SDK] Request Failed (${r}): ${S}`,r,e)}};var s=class{constructor(t){this.client=t;}async syncCreate(t,e){return this.client.request(h,{method:"POST",body:{...t,appName:e}})}async getHistory(t={}){return this.client.request(d,{method:"GET",query:{page:t.page??1,limit:t.limit??10,chainId:t.chainId,status:t.status,txKey:t.txKey,appName:t.appName,walletAddress:t.walletAddress}})}};var E={createMiniSessionMessage:d$1,verifyMiniSession:f,signMiniSession:e,createMiniSessionStore:g,getMiniSessionAuth:h$1},y=class{static utils=E;client;pulsar;constructor(t){this.client=new o(t),this.pulsar=new s(this.client);}};
 export{m as BASE_API_URL,d as PULSAR_HISTORY_ENDPOINT,h as PULSAR_SYNC_ENDPOINT,s as PulsarModule,y as Quasar,i as QuasarSDKError,E as utils};

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;
@@ -43,24 +21,28 @@ interface QuasarAuthBridgeProps {
     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 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}
@@ -73,6 +55,6 @@ interface QuasarAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, onAddressMismatch, }: QuasarAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+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;
@@ -43,24 +21,28 @@ interface QuasarAuthBridgeProps {
     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 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}
@@ -73,6 +55,6 @@ interface QuasarAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, onAddressMismatch, }: QuasarAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+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 chunkM56HRFZC_js=require('./chunk-M56HRFZC.js'),react$1=require('@solana/react'),core=require('@wagmi/core'),react=require('react'),jsxRuntime=require('react/jsx-runtime');var a=null;async function K(){for(let n=0;n<15;n++){if(a)return a();await new Promise(t=>setTimeout(t,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}function T({activeConnection:n,store:t,wagmiConfig:o,session:e,setSession:i,onAddressMismatch:s}){let l=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:l==="SOLANA"?jsxRuntime.jsx(w,{connectedAccount:n.connectedAccount,store:t,session:e,setSession:i}):jsxRuntime.jsx(M,{wagmiConfig:o,store:t,session:e,setSession:i})}function w({connectedAccount:n,store:t,session:o,setSession:e}){let i=react$1.useWalletAccountMessageSigner(n),s=react.useRef(i),u=react.useRef(o),l=react.useRef(e);react.useEffect(()=>{s.current=i;},[i]),react.useEffect(()=>{u.current=o;},[o]),react.useEffect(()=>{l.current=e;},[e]);let c=react.useCallback(async()=>{let A=t.getState().activeConnection;if(!A?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let g=s.current;if(!g)throw new Error("[QuasarSDK] Solana Message Signer not initialized.");return chunkM56HRFZC_js.h({isConnected:A.isConnected,address:A.address,chainType:"SOLANA",signer:g},{miniSession:u.current,setMiniSession:l.current})},[t]);return react.useEffect(()=>(a=c,()=>{a===c&&(a=null);}),[c]),null}function M({wagmiConfig:n,store:t,session:o,setSession:e}){let i=react.useRef(o),s=react.useRef(e);react.useEffect(()=>{i.current=o;},[o]),react.useEffect(()=>{s.current=e;},[e]);let u=react.useCallback(async()=>{let c=t.getState().activeConnection;if(!c?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let S=await core.getWalletClient(n);if(!S)throw new Error("[QuasarSDK] EVM Signer not found");return chunkM56HRFZC_js.h({isConnected:c.isConnected,address:c.address,chainType:"EVM",signer:S},{miniSession:i.current,setMiniSession:s.current})},[t,n]);return react.useEffect(()=>(a=u,()=>{a===u&&(a=null);}),[u]),null}exports.QuasarAuthBridge=T;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-HJ3SAN77.mjs';import {useWalletAccountMessageSigner}from'@solana/react';import {getWalletClient}from'@wagmi/core';import {useEffect,useRef,useCallback}from'react';import {jsx}from'react/jsx-runtime';var a=null;async function K(){for(let n=0;n<15;n++){if(a)return a();await new Promise(t=>setTimeout(t,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}function T({activeConnection:n,store:t,wagmiConfig:o,session:e,setSession:i,onAddressMismatch:s}){let l=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:l==="SOLANA"?jsx(w,{connectedAccount:n.connectedAccount,store:t,session:e,setSession:i}):jsx(M,{wagmiConfig:o,store:t,session:e,setSession:i})}function w({connectedAccount:n,store:t,session:o,setSession:e}){let i=useWalletAccountMessageSigner(n),s=useRef(i),u=useRef(o),l=useRef(e);useEffect(()=>{s.current=i;},[i]),useEffect(()=>{u.current=o;},[o]),useEffect(()=>{l.current=e;},[e]);let c=useCallback(async()=>{let A=t.getState().activeConnection;if(!A?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let g=s.current;if(!g)throw new Error("[QuasarSDK] Solana Message Signer not initialized.");return h({isConnected:A.isConnected,address:A.address,chainType:"SOLANA",signer:g},{miniSession:u.current,setMiniSession:l.current})},[t]);return useEffect(()=>(a=c,()=>{a===c&&(a=null);}),[c]),null}function M({wagmiConfig:n,store:t,session:o,setSession:e}){let i=useRef(o),s=useRef(e);useEffect(()=>{i.current=o;},[o]),useEffect(()=>{s.current=e;},[e]);let u=useCallback(async()=>{let c=t.getState().activeConnection;if(!c?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let S=await getWalletClient(n);if(!S)throw new Error("[QuasarSDK] EVM Signer not found");return h({isConnected:c.isConnected,address:c.address,chainType:"EVM",signer:S},{miniSession:i.current,setMiniSession:s.current})},[t,n]);return useEffect(()=>(a=u,()=>{a===u&&(a=null);}),[u]),null}export{T 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.7",
+  "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": {

package/dist/chunk-HJ3SAN77.mjs

@@ -1 +0,0 @@
-import {create}from'zustand';import {persist}from'zustand/middleware';var d=(a=>(a.EVM="EVM",a.SOLANA="SOLANA",a))(d||{});var S=300*1e3,w=60*1e3,m=30*1e3;function y(e){return `Mini-Session Login: ${e}`}async function f(e){let t=new Date().toISOString(),a=y(t);if(e.chainType==="EVM"){let n=e.signer;try{return {signature:await n.signMessage({account:e.walletAddress,message:a}),timestamp:t}}catch(s){throw new Error(`[SDK] EVM signing failed: ${s.message}`,{cause:s})}}if(e.chainType==="SOLANA"){let n=e.signer,s;try{s=await import('gill');}catch(r){throw new Error('[SDK] Peer dependency "gill" is required for Solana signing.',{cause:r})}try{let i=s.getUtf8Encoder().encode(a),o;if(n.modifyAndSignMessages){let l=s.createSignableMessage(i),[p]=await n.modifyAndSignMessages([l]),u=p.signatures[n.address];if(!u)throw new Error(`[SDK] Signature missing for address: ${n.address}`);o=u;}else if(n.signMessages){let[l]=await n.signMessages([i]);if(!l?.signature)throw new Error("[SDK] Wallet returned invalid signMessages output.");o=l.signature;}else if(n.signMessage)o=await n.signMessage(i);else throw new Error("[SDK] Signer lacks message signing capabilities.");return {signature:s.getSignatureFromBytes(o),timestamp:t}}catch(r){throw new Error(`[SDK] Solana signing failed: ${r.message}`,{cause:r})}}throw new Error(`[SDK] Unsupported chain type: ${e.chainType}`)}async function v(e){let t=new Date(e.timestamp).getTime(),a=Date.now();if(isNaN(t))throw new Error("[SDK] Invalid timestamp format. Use ISO string.");let n=e.maxAge??S;if(a-t>n)throw new Error("[SDK] Signature expired. Please sign a fresh message.");if(t>a+w)throw new Error("[SDK] Timestamp is in the future. Check your system clock.");let s=y(e.timestamp);if(e.chainType==="EVM"){let r;try{r=await import('viem');}catch(i){throw new Error('[SDK] Peer dependency "viem" is required for EVM verification.',{cause:i})}return await r.verifyMessage({address:e.walletAddress,message:s,signature:e.signature})}if(e.chainType==="SOLANA"){let r;try{r=await import('gill');}catch(i){throw new Error('[SDK] Peer dependency "gill" is required for Solana verification.',{cause:i})}try{let i=r.address(e.walletAddress);return await r.verifySignatureForAddress(i,e.signature,s)}catch{return  false}}return  false}var c=null;function R(e="mini-session-storage"){return create()(persist(t=>({miniSession:null,setMiniSession:a=>t({miniSession:a}),clearSession:()=>t({miniSession:null})}),{name:e}))}async function C(e,t){let{isConnected:a,address:n,chainType:s,signer:r}=e;if(!a||!n)throw new Error("[SDK] Wallet not connected. Please connect your wallet first.");let i=t.miniSession;if(i&&i.walletAddress===n&&i.chainType===s){let o=Date.now(),g=new Date(i.timestamp).getTime();if(o-g<S-m)return i}return c||(c=f({signer:r,walletAddress:n,chainType:s}).then(o=>{let g={...o,chainType:s,walletAddress:n};return t.setMiniSession(g),g}).finally(()=>{c=null;})),c}export{d as a,S as b,m as c,y as d,f as e,v as f,R as g,C as h};

package/dist/chunk-M56HRFZC.js

@@ -1 +0,0 @@
-'use strict';var zustand=require('zustand'),middleware=require('zustand/middleware');var d=(a=>(a.EVM="EVM",a.SOLANA="SOLANA",a))(d||{});var S=300*1e3,w=60*1e3,m=30*1e3;function y(e){return `Mini-Session Login: ${e}`}async function f(e){let t=new Date().toISOString(),a=y(t);if(e.chainType==="EVM"){let n=e.signer;try{return {signature:await n.signMessage({account:e.walletAddress,message:a}),timestamp:t}}catch(s){throw new Error(`[SDK] EVM signing failed: ${s.message}`,{cause:s})}}if(e.chainType==="SOLANA"){let n=e.signer,s;try{s=await import('gill');}catch(r){throw new Error('[SDK] Peer dependency "gill" is required for Solana signing.',{cause:r})}try{let i=s.getUtf8Encoder().encode(a),o;if(n.modifyAndSignMessages){let l=s.createSignableMessage(i),[p]=await n.modifyAndSignMessages([l]),u=p.signatures[n.address];if(!u)throw new Error(`[SDK] Signature missing for address: ${n.address}`);o=u;}else if(n.signMessages){let[l]=await n.signMessages([i]);if(!l?.signature)throw new Error("[SDK] Wallet returned invalid signMessages output.");o=l.signature;}else if(n.signMessage)o=await n.signMessage(i);else throw new Error("[SDK] Signer lacks message signing capabilities.");return {signature:s.getSignatureFromBytes(o),timestamp:t}}catch(r){throw new Error(`[SDK] Solana signing failed: ${r.message}`,{cause:r})}}throw new Error(`[SDK] Unsupported chain type: ${e.chainType}`)}async function v(e){let t=new Date(e.timestamp).getTime(),a=Date.now();if(isNaN(t))throw new Error("[SDK] Invalid timestamp format. Use ISO string.");let n=e.maxAge??S;if(a-t>n)throw new Error("[SDK] Signature expired. Please sign a fresh message.");if(t>a+w)throw new Error("[SDK] Timestamp is in the future. Check your system clock.");let s=y(e.timestamp);if(e.chainType==="EVM"){let r;try{r=await import('viem');}catch(i){throw new Error('[SDK] Peer dependency "viem" is required for EVM verification.',{cause:i})}return await r.verifyMessage({address:e.walletAddress,message:s,signature:e.signature})}if(e.chainType==="SOLANA"){let r;try{r=await import('gill');}catch(i){throw new Error('[SDK] Peer dependency "gill" is required for Solana verification.',{cause:i})}try{let i=r.address(e.walletAddress);return await r.verifySignatureForAddress(i,e.signature,s)}catch{return  false}}return  false}var c=null;function R(e="mini-session-storage"){return zustand.create()(middleware.persist(t=>({miniSession:null,setMiniSession:a=>t({miniSession:a}),clearSession:()=>t({miniSession:null})}),{name:e}))}async function C(e,t){let{isConnected:a,address:n,chainType:s,signer:r}=e;if(!a||!n)throw new Error("[SDK] Wallet not connected. Please connect your wallet first.");let i=t.miniSession;if(i&&i.walletAddress===n&&i.chainType===s){let o=Date.now(),g=new Date(i.timestamp).getTime();if(o-g<S-m)return i}return c||(c=f({signer:r,walletAddress:n,chainType:s}).then(o=>{let g={...o,chainType:s,walletAddress:n};return t.setMiniSession(g),g}).finally(()=>{c=null;})),c}exports.a=d;exports.b=S;exports.c=m;exports.d=y;exports.e=f;exports.f=v;exports.g=R;exports.h=C;