@tuwaio/quasar-sdk 0.0.10 → 0.0.11

package/README.md

@@ -1,168 +1,496 @@
-# Quasar SDK
+# @tuwaio/quasar-sdk
 
 [![NPM Version](https://img.shields.io/npm/v/@tuwaio/quasar-sdk.svg)](https://www.npmjs.com/package/@tuwaio/quasar-sdk)
 [![License](https://img.shields.io/npm/l/@tuwaio/quasar-sdk.svg)](./LICENSE)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/sdk/release.yml?branch=main)](https://github.com/TuwaIO/sdk/actions)
 
-> The official server-side Node.js & Edge SDK for the **TUWA Quasar Cloud**, featuring built-in React authentication bridges.
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/TuwaIO/workflows@main/preview/repos/quasar_sdk.png" alt="Quasar SDK Architecture" width="100%" />
+</p>
 
-## Installation
+> The official **Layer 5 (L5)** server-side Node.js & Edge SDK for the **TUWA Quasar Cloud**, featuring built-in React authentication bridges.
+
+---
+
+## 🏛️ What is `@tuwaio/quasar-sdk`?
+
+`@tuwaio/quasar-sdk` is **Layer 5 (L5)** of the TUWA ecosystem architecture — the official backend companion to the TUWA client libraries. It serves as the gateway to the **Quasar Cloud Engine**, allowing your server to securely push transaction logs, query paginated transaction histories, and cryptographically verify client signatures.
+
+It operates strictly on the server (Node.js, Next.js Server Actions, or Edge functions) and uses Secret Keys to communicate with Quasar's iron-dome guarded endpoints. It also includes React Bridges for establishing secure "Mini-Session" authentication on the client side.
+
+---
+
+## ✨ Key Features
+
+- **☁️ Cloud Sync**: Automatically persist pending and terminal transaction states to the Quasar Database for cross-device history.
+- **🔐 Mini-Session Auth**: Built-in cryptographic verification and React bridges (`QuasarAuthBridge`) to handle mini-session authentication across EVM and Solana with zero boilerplate.
+- **⚡ Edge Ready**: Uses `ofetch` and lightweight cryptography to run seamlessly in Cloudflare Workers and Vercel Edge.
+- **📦 InMemory Sync**: Perfectly pairs with `@tuwaio/sdk/pulsar` (`createTxInMemoryStore`) to fetch history and hydrate local React states.
+- **⛓️ Multi-Chain Support**: Provides separate lightweight bridges for EVM (`react/evm`) and Solana (`react/solana`), ensuring minimal bundle sizes.
+
+---
+
+## 💾 Installation
 
 ```bash
-# Using pnpm (recommended)
-pnpm add @tuwaio/quasar-sdk ofetch
+pnpm add @tuwaio/quasar-sdk ofetch @tuwaio/pulsar-core
 ```
 
-### Peer Dependencies
+_Note: `ofetch` and `@tuwaio/pulsar-core` are required as peer dependencies to ensure ultra-fast HTTP requests and strict TypeScript compatibility._
 
-| Package                    | Version    | Requirement                                |
-| -------------------------- | ---------- | ------------------------------------------ |
-| `@tuwaio/pulsar-core`      | `>=0.6.0`  | **Required** (Core types)                  |
-| `ofetch`                   | `>=1.5.1`  | **Required** (Transport)                   |
-| `react`                    | `>=18.0.0` | Optional (React Bridge support)            |
-| `@solana/react`            | `>=6.9.0`  | Optional (Solana signing)                  |
-| `@wallet-standard/react`   | `>=1.0.2`  | Optional (Wallet Standard)                 |
-| `@wagmi/core`              | `>=3.0.0`  | Optional (EVM signing)                     |
-| `viem`                     | `^2.0.0`   | Optional (EVM Auth primitives)             |
-| `gill`                     | `^0.14.0`  | Optional (Solana Auth primitives)          |
-| `zustand`                  | `^5.0.0`   | Optional (Session state management)        |
+---
 
-## Quick Start
+## 🚀 Quick Start (Node.js / Edge)
+
+This is a basic example of how to interact with the Quasar Cloud directly from your secure backend environments (like Next.js API Routes, Server Actions, or NestJS).
 
 ```typescript
-import { Quasar } from '@tuwaio/quasar-sdk';
+import { Quasar, MiniSessionAuth, utils } from '@tuwaio/quasar-sdk';
+import type { Transaction } from '@tuwaio/sdk/pulsar';
+
+// Initialize Quasar with your Secret Key from the Dashboard
+const quasar = new Quasar({ secretKey: process.env.QUASAR_SDK_SK ?? '' });
+
+/**
+ * Example Next.js Server Action to Sync a Transaction
+ */
+export async function syncTransaction(tx: Transaction, authData: MiniSessionAuth) {
+  // 1. Verify the client's signature (prevent unauthorized spoofing)
+  const isValid = await utils.verifyMiniSession(authData);
+  if (!isValid) throw new Error('Invalid signature.');
+
+  // 2. Sync the transaction securely to the Quasar Cloud
+  await quasar.pulsar.syncCreate(tx, 'My Application');
+  return { success: true };
+}
 
-const quasar = new Quasar({ secretKey: 'sk_live_your_secret_key' });
+/**
+ * Example Next.js Server Action to Fetch History
+ */
+export async function getHistory(
+  params: { walletAddress: string; page: number; limit: number; appName: string },
+  authData: MiniSessionAuth,
+) {
+  const isValid = await utils.verifyMiniSession(authData);
+  if (!isValid) throw new Error('Invalid signature.');
+
+  // Return the paginated transaction history
+  return quasar.pulsar.getHistory(params);
+}
+```
 
-// Sync a pending transaction to the cloud
-const { txKey } = await quasar.pulsar.syncCreate(transaction, 'My Application');
+---
 
-// Query transaction history
-const history = await quasar.pulsar.getHistory({ chainId: 1 });
-```
+## 🔐 React Authentication Bridge
 
-## React Authentication Bridge
+The SDK provides React components to handle mini-session authentication with zero boilerplate. This bridges the gap between your frontend (where the wallet is) and your backend (where the Quasar Secret Key lives).
 
-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. Create the Auth Store
 
-### 1. EVM-Only Bridge (No Solana dependencies required)
+Before using the bridge, create a persistent Zustand store using the provided utility to manage the signature lifecycle.
 
-If your project only supports EVM chains, import from the `/react/evm` subpath. This avoids compile-time errors if `@solana/react` is not installed.
+```ts
+// src/hooks/useAuthStore.ts
+import { utils } from '@tuwaio/quasar-sdk';
+
+export const useAuthStore = utils.createMiniSessionStore('quasar-mini-session-storage');
+```
+
+To prevent issues with missing optional peer dependencies at build time, the SDK exposes separate ecosystem entry points for the Bridge:
+
+### EVM-Only Bridge (No Solana dependencies required)
+
+If your project only supports EVM chains, import from the `/react/evm` subpath.
 
 ```tsx
 import { QuasarEvmAuthBridge } from '@tuwaio/quasar-sdk/react/evm';
+import { useAuthStore } from '@/hooks/useAuthStore';
+
+export function MyApp({ activeConnection, store, wagmiConfig }) {
+  const session = useAuthStore((s) => s.miniSession);
+  const setSession = useAuthStore((s) => s.setMiniSession);
 
-function MyApp() {
   return (
     <QuasarEvmAuthBridge
       activeConnection={activeConnection} // Structural interface for wallet state
-      store={store}                      // Zustand store API
-      wagmiConfig={config}               // Wagmi config
-      session={miniSession}              // Current session state
-      setSession={setMiniSession}        // Session setter
+      store={store} // Zustand store API
+      wagmiConfig={wagmiConfig} // Wagmi config
+      session={session} // Current session state
+      setSession={setSession} // Session setter
     />
   );
 }
 ```
 
-### 2. Solana-Only Bridge (No EVM dependencies required)
+### 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.
+If your project only supports Solana, import from the `/react/solana` subpath.
 
 ```tsx
 import { QuasarSolanaAuthBridge } from '@tuwaio/quasar-sdk/react/solana';
+import { useAuthStore } from '@/hooks/useAuthStore';
+
+export function MyApp({ activeConnection, store }) {
+  const session = useAuthStore((s) => s.miniSession);
+  const setSession = useAuthStore((s) => s.setMiniSession);
 
-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
+      activeConnection={activeConnection}
+      store={store}
+      session={session}
+      setSession={setSession}
     />
   );
 }
 ```
 
-### 3. Unified Cross-Chain Bridge
+### Unified Cross-Chain Bridge
 
-If your project supports both ecosystems and has all peer dependencies installed, you can use the unified bridge:
+If your project supports both ecosystems and has all peer dependencies installed (`@wagmi/core`, `@solana/react`, etc.), you can use the unified bridge:
 
 ```tsx
 import { QuasarAuthBridge } from '@tuwaio/quasar-sdk/react';
+```
+
+---
+
+## 🌍 The Full Flow (Production Architecture)
+
+To see how incredibly powerful `@tuwaio/quasar-sdk` is when combined with `@tuwaio/sdk`, here is a complete architectural overview without any skipped steps. Notice how the **Auth Store**, **Pulsar Store**, and **QuasarAuthBridge** dance together effortlessly:
+
+### 1. Define Your Transaction Types (`types.ts`)
+
+First, define the strict union of all possible transactions your app supports.
+
+```ts
+// src/types.ts
+import type { Transaction } from '@tuwaio/sdk/pulsar';
+
+export enum AppTxType {
+  SWAP = 'SWAP',
+}
+
+export type SwapTx = Transaction & {
+  type: AppTxType.SWAP;
+  payload: { tokenIn: string; tokenOut: string; amount: number };
+};
+
+export type TransactionUnion = SwapTx;
+```
+
+### 2. Secure Server Proxy (`actions.ts`)
+
+Proxy calls to Quasar Cloud using your backend to protect secret keys.
+
+```ts
+// src/app/actions.ts
+'use server';
+
+import { Quasar, MiniSessionAuth, utils } from '@tuwaio/quasar-sdk';
+import { TransactionUnion } from '@/types';
+
+const quasar = new Quasar({ secretKey: process.env.QUASAR_SDK_SK ?? '' });
+
+export async function syncTransaction(tx: TransactionUnion, authData: MiniSessionAuth) {
+  const isValid = await utils.verifyMiniSession(authData);
+  if (!isValid) throw new Error('Invalid signature.');
+
+  await quasar.pulsar.syncCreate(tx, 'My App');
+  return { success: true };
+}
+
+export async function getHistory(params: any, authData: MiniSessionAuth) {
+  const isValid = await utils.verifyMiniSession(authData);
+  if (!isValid) throw new Error('Invalid signature.');
+
+  return quasar.pulsar.getHistory(params);
+}
+```
+
+### 3. The Client Auth Store (`useAuthStore.ts`)
+
+```tsx
+// src/hooks/useAuthStore.ts
+import { utils } from '@tuwaio/quasar-sdk';
+
+// Automatically persists the verified signature in localStorage
+export const useAuthStore = utils.createMiniSessionStore('quasar-mini-session-storage');
+```
+
+### 4. The Headless Tracking Store (`usePulsarStore.ts`)
+
+```ts
+// src/hooks/usePulsarStore.ts
+'use client';
+
+import { createPulsarStore, createTxInMemoryStore, createBoundedUseStore } from '@tuwaio/sdk/pulsar';
+import { pulsarEvmAdapter } from '@tuwaio/evm-sdk/pulsar';
+import { pulsarSolanaAdapter } from '@tuwaio/solana-sdk/pulsar';
+import { getMiniSessionAuth } from '@tuwaio/quasar-sdk/react';
+
+import { getHistory, syncTransaction } from '@/app/actions';
+import { wagmiConfig, appEVMChains, solanaRPCUrls } from '@/configs/appConfig';
+import { TransactionUnion } from '@/types';
+
+const storageName = 'transactions-tracking-storage';
+
+const initialStore = createPulsarStore<TransactionUnion>({
+  name: storageName,
+  adapter: [pulsarEvmAdapter(wagmiConfig, appEVMChains), pulsarSolanaAdapter({ rpcUrls: solanaRPCUrls })],
+  beforeTxProcess: async () => {
+    // Ensures we have a valid signature before executing any blockchain logic
+    await getMiniSessionAuth();
+  },
+  onRemoteCreate: async (tx) => {
+    try {
+      // Syncs the new transaction to Quasar via Next.js Server Actions
+      const auth = await getMiniSessionAuth();
+      await syncTransaction(tx as TransactionUnion, auth);
+    } catch (err) {
+      console.error('[PulsarHook] Remote sync failed:', err);
+    }
+  },
+});
+
+export const usePulsarStore = createBoundedUseStore(initialStore);
+
+// Wrap with inMemoryStore to enable remote history fetching & pagination
+const pulsarInMemoryStore = createTxInMemoryStore<TransactionUnion>({
+  localTransactionsPool: initialStore.getState().transactionsPool,
+  getHistory: async ({ page, walletAddress }) => {
+    try {
+      const auth = await getMiniSessionAuth();
+      const history = await getHistory({ walletAddress, page, limit: 10, appName: 'My App' }, auth);
+
+      if (!history) return null;
+
+      return { ...history, docs: history.docs as TransactionUnion[] };
+    } catch (error) {
+      console.error('[PulsarHook] Failed to fetch history:', error);
+      throw error;
+    }
+  },
+  onHistoryFetched: async (remoteTxs) => {
+    await initialStore.getState().injectExternalPendingTxs(remoteTxs);
+  },
+});
+
+initialStore.subscribe((state) => pulsarInMemoryStore.getState().syncWithLocalPool(state.transactionsPool));
+
+export const usePulsarInMemoryStore = createBoundedUseStore(pulsarInMemoryStore);
+```
+
+### 5. The Quasar Auth Bridge (`QuasarSDKAuthProvider.tsx`)
+
+```tsx
+// src/providers/QuasarSDKAuthProvider.tsx
+'use client';
+
+import { useContext, useEffect } from 'react';
+import { useSatelliteConnectStore, SatelliteStoreContext } from '@tuwaio/sdk/satellite';
+import { QuasarActiveConnection, QuasarAuthBridge as QuasarSDKAuthBridge } from '@tuwaio/quasar-sdk/react';
+
+import { wagmiConfig } from '@/configs/appConfig';
+import { useAuthStore } from '@/hooks/useAuthStore';
+
+export function QuasarAuthBridge() {
+  const activeConnection = useSatelliteConnectStore((s) => s.activeConnection);
+  const store = useContext(SatelliteStoreContext);
+
+  const session = useAuthStore((s) => s.miniSession);
+  const setSession = useAuthStore((s) => s.setMiniSession);
+  const clearSession = useAuthStore((s) => s.clearSession);
+
+  // Clear Quasar Mini-Session when wallet disconnects
+  useEffect(() => {
+    if (!activeConnection?.isConnected) {
+      clearSession();
+    }
+  }, [activeConnection?.isConnected, clearSession]);
+
+  if (!activeConnection || !store) return null;
 
-function MyApp() {
   return (
-    <QuasarAuthBridge
-      activeConnection={activeConnection}
-      store={store}
-      wagmiConfig={config}
-      session={miniSession}
-      setSession={setMiniSession}
+    <QuasarSDKAuthBridge
+      activeConnection={activeConnection as QuasarActiveConnection}
+      store={store as any}
+      wagmiConfig={wagmiConfig}
+      session={session}
+      setSession={setSession}
     />
   );
 }
 ```
 
-## Modules
+### 6. Nova Transactions Provider (`NovaTransactionsProvider.tsx`)
+
+```tsx
+// src/providers/NovaTransactionsProvider.tsx
+'use client';
 
-### Pulsar — `quasar.pulsar`
+import { useSatelliteConnectStore } from '@tuwaio/sdk/satellite';
+import { useInitializeTransactionsPool, type TxInMemoryPagination } from '@tuwaio/sdk/pulsar';
+import { getAdapterFromConnectorType } from '@tuwaio/sdk/orbit';
+import { NovaTransactionsProvider as NTP } from '@tuwaio/sdk/nova-transactions/providers';
+import { usePulsarInMemoryStore, usePulsarStore } from '@/hooks/usePulsarStore';
 
-| Method                     | Description                                         |
-| -------------------------- | --------------------------------------------------- |
-| `syncCreate(tx, appName?)` | Sync a new pending transaction to the cloud         |
-| `getHistory(query?)`       | Retrieve paginated transaction history with filters |
+export function NovaTransactionsProvider({ pagination }: { pagination: TxInMemoryPagination }) {
+  const initialTx = usePulsarStore((state) => state.initialTx);
+  const closeTxTrackedModal = usePulsarStore((state) => state.closeTxTrackedModal);
+  const executeTxAction = usePulsarStore((state) => state.executeTxAction);
+  const initializeTransactionsPool = usePulsarStore((state) => state.initializeTransactionsPool);
 
-### Utils — `utils`
+  const activeConnection = useSatelliteConnectStore((state) => state.activeConnection);
+  const getAdapter = usePulsarStore((state) => state.getAdapter);
+  const transactionsPool = usePulsarInMemoryStore((state) => state.transactionsPool);
 
-Security and authentication utilities for signature verification and session management.
+  useInitializeTransactionsPool({ initializeTransactionsPool });
 
-```typescript
-import { utils, ChainType } from '@tuwaio/quasar-sdk';
-
-// Verify a Mini-Session signature on the server
-const isValid = await utils.verifyMiniSession({
-  walletAddress: '0x...',
-  signature,
-  timestamp,
-  chainType: ChainType.EVM
-});
+  return (
+    <NTP
+      transactionsPool={transactionsPool}
+      initialTx={initialTx}
+      closeTxTrackedModal={closeTxTrackedModal}
+      executeTxAction={executeTxAction}
+      connectedWalletAddress={activeConnection?.isConnected ? activeConnection.address : undefined}
+      connectedAdapterType={getAdapterFromConnectorType(activeConnection?.connectorType ?? 'evm:')}
+      adapter={getAdapter()}
+      pagination={pagination}
+    />
+  );
+}
 ```
 
-| Method                         | Description                                            |
-| ------------------------------ | ------------------------------------------------------ |
-| `createMiniSessionMessage(ts)` | Format a standard login message for signing            |
-| `signMiniSession(params)`      | Trigger signature request in the connected wallet      |
-| `verifyMiniSession(params)`    | Verify an EVM or Solana signature with expiration check |
-| `createMiniSessionStore(name)` | Create a persistent Zustand store for session caching  |
-| `getMiniSessionAuth(conn, st)` | Core logic for signing and caching a mini-session      |
+### 7. The Seamless UI Integration (`AppProviders.tsx`)
 
-## Error Handling
+```tsx
+// src/providers/AppProviders.tsx
+'use client';
+
+import { SatelliteConnectProvider } from '@tuwaio/sdk/satellite';
+import { NovaConnectProvider } from '@tuwaio/sdk/nova-connect';
+import { satelliteEVMAdapter } from '@tuwaio/evm-sdk/satellite';
+import { EVMConnectorsWatcher } from '@tuwaio/evm-sdk/nova-connect';
+import { satelliteSolanaAdapter } from '@tuwaio/solana-sdk/satellite';
+import { SolanaConnectorsWatcher } from '@tuwaio/solana-sdk/nova-connect';
+import { getMiniSessionAuth } from '@tuwaio/quasar-sdk/react';
+
+import { appEVMChains, solanaRPCUrls, wagmiConfig } from '@/configs/appConfig';
+import { usePulsarInMemoryStore, usePulsarStore } from '@/hooks/usePulsarStore';
+import { NovaTransactionsProvider } from '@/providers/NovaTransactionsProvider';
+import { QuasarAuthBridge } from '@/providers/QuasarSDKAuthProvider';
+
+export function AppProviders({ children }: { children: React.ReactNode }) {
+  const getAdapter = usePulsarStore((state) => state.getAdapter);
+  const transactionsPool = usePulsarInMemoryStore((state) => state.transactionsPool);
+
+  const isLoading = usePulsarInMemoryStore((state) => state.isLoading);
+  const isError = usePulsarInMemoryStore((state) => state.isError);
+  const currentPage = usePulsarInMemoryStore((state) => state.currentPage);
+  const hasMore = usePulsarInMemoryStore((state) => state.hasMore);
+  const fetchNextPage = usePulsarInMemoryStore((state) => state.fetchNextPage);
+  const fetchInitial = usePulsarInMemoryStore((state) => state.fetchInitial);
+
+  const pagination = { isLoading, isError, currentPage, hasMore, fetchNextPage };
 
-```typescript
-import { QuasarSDKError } from '@tuwaio/quasar-sdk';
-
-try {
-  await quasar.pulsar.getHistory();
-} catch (err) {
-  if (err instanceof QuasarSDKError) {
-    console.error(err.status); // HTTP status code
-    console.error(err.message); // Formatted error message
-  }
+  return (
+    <SatelliteConnectProvider
+      adapter={[satelliteEVMAdapter(wagmiConfig, appEVMChains), satelliteSolanaAdapter({ rpcUrls: solanaRPCUrls })]}
+      autoConnect={true}
+      callbackAfterConnected={async (connection) => {
+        try {
+          await getMiniSessionAuth();
+          setTimeout(() => fetchInitial(connection.address), 2000);
+        } catch (err) {
+          console.error('[QuasarAuth] Auto-authentication failed:', err);
+          setTimeout(() => fetchInitial(connection.address), 2000);
+        }
+      }}
+    >
+      <EVMConnectorsWatcher wagmiConfig={wagmiConfig} />
+      <SolanaConnectorsWatcher />
+
+      <QuasarAuthBridge />
+      <NovaTransactionsProvider pagination={pagination} />
+
+      <NovaConnectProvider
+        appChains={appEVMChains}
+        solanaRPCUrls={solanaRPCUrls}
+        transactionPool={transactionsPool}
+        pulsarAdapter={getAdapter() as any}
+        withImpersonated
+        withBalance
+        withChain
+        pagination={pagination}
+      >
+        {children}
+      </NovaConnectProvider>
+    </SatelliteConnectProvider>
+  );
+}
+```
+
+### 8. Creating a Transaction (Usage)
+
+Now you can safely execute strictly-typed, cross-chain transactions anywhere in your app. The store automatically routes the transaction to the correct adapter, and Quasar syncs it to the cloud.
+
+```tsx
+// src/components/SwapButton.tsx
+'use client';
+
+import { getAdapterFromConnectorType, OrbitAdapter } from '@tuwaio/sdk/orbit';
+import { useSatelliteConnectStore } from '@tuwaio/sdk/satellite';
+import { TxActionButton } from '@tuwaio/sdk/nova-transactions';
+import { usePulsarStore, usePulsarInMemoryStore } from '@/hooks/usePulsarStore';
+import { AppTxType } from '@/types';
+
+export function SwapButton() {
+  const executeTxAction = usePulsarStore((s) => s.executeTxAction);
+  const getLastTxKey = usePulsarStore((s) => s.getLastTxKey);
+  const transactionsPool = usePulsarInMemoryStore((s) => s.transactionsPool);
+  const activeConnection = useSatelliteConnectStore((s) => s.activeConnection);
+
+  const handleSwapAction = async () => {
+    // Dynamically determine the adapter based on the currently connected wallet
+    const adapterType = getAdapterFromConnectorType(activeConnection?.connectorType ?? 'evm:');
+
+    await executeTxAction({
+      actionFunction: async () => {
+        /* your wagmi/solana contract call */
+      },
+      params: {
+        adapter: adapterType,
+        type: AppTxType.SWAP,
+        title: 'Token Swap',
+        desiredChainID: adapterType === OrbitAdapter.EVM ? 1 : undefined,
+        payload: { tokenIn: 'USDC', tokenOut: adapterType === OrbitAdapter.EVM ? 'ETH' : 'SOL', amount: 100 },
+      },
+    });
+  };
+
+  return (
+    <TxActionButton
+      action={handleSwapAction}
+      getLastTxKey={getLastTxKey}
+      transactionsPool={transactionsPool}
+      walletAddress={activeConnection?.address}
+    >
+      Cross-Chain Swap
+    </TxActionButton>
+  );
 }
 ```
 
-## Configuration
+---
 
-| Property    | Type     | Required | Default               | Description                       |
-| ----------- | -------- | -------- | --------------------- | --------------------------------- |
-| `secretKey` | `string` | ✅       | —                     | Server-side API key (`sk_live_*`) |
-| `baseUrl`   | `string` | ❌       | `https://api.tuwa.io` | API base URL                      |
-| `timeout`   | `number` | ❌       | `10000`               | Request timeout (ms)              |
+## 📦 Available Namespaces
 
-## Documentation
+This package provides the following server-side utilities and React bridges:
 
-Full API reference: [sdk.docs.tuwa.io](https://sdk.docs.tuwa.io/)
+- `Quasar` — The main server-side client class instance used to access `quasar.pulsar.*` methods.
+- `utils` — Security and authentication utilities for signature verification (`verifyMiniSession`, `signMiniSession`, `createMiniSessionStore`).
+- `QuasarAuthBridge` (exported via subpaths) — The client-side React component for triggering and managing the signature flow automatically when the wallet connects.
+- `MiniSessionAuth` — The strict type definition mapping the structure of the authentication payload.
 
 ---
 

package/dist/chunk-2MHRTJOV.js

@@ -0,0 +1 @@
+import {a}from'./chunk-HVUZ52OX.js';import {h}from'./chunk-C6JAMIC3.js';import {useWalletAccountMessageSigner}from'@solana/react';import {useEffect,useRef,useCallback}from'react';import {jsx}from'react/jsx-runtime';function K({activeConnection:n,store:i,session:e,setSession:t,maxAge:s,onAddressMismatch:r}){return useEffect(()=>{e&&n?.address&&e.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),t(null),r?.());},[n?.address,e,t,r]),!n?.isConnected||!i?null:jsx(p,{connectedAccount:n.connectedAccount,store:i,session:e,setSession:t,maxAge:s})}function p({connectedAccount:n,store:i,session:e,setSession:t,maxAge:s}){let r=useWalletAccountMessageSigner(n),c=useRef(r),d=useRef(e),A=useRef(t);useEffect(()=>{c.current=r;},[r]),useEffect(()=>{d.current=e;},[e]),useEffect(()=>{A.current=t;},[t]);let S=useCallback(async()=>{let a=i.getState().activeConnection;if(!a?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let g=c.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:d.current,setMiniSession:A.current},s)},[i,s]);return useEffect(()=>(a(S),()=>{a(null);}),[S]),null}export{K as a};

package/dist/chunk-2VPVIX5M.js

@@ -0,0 +1 @@
+import {a}from'./chunk-HVUZ52OX.js';import {h}from'./chunk-C6JAMIC3.js';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-AQEHRYJP.cjs

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

package/dist/chunk-C6JAMIC3.js

@@ -0,0 +1 @@
+import {create}from'zustand';import {persist}from'zustand/middleware';var m=(t=>(t.EVM="EVM",t.SOLANA="SOLANA",t))(m||{});var u=300*1e3,w=60*1e3,y=30*1e3;function f(e){return `Mini-Session Login: ${e}`}async function p(e){let r=new Date().toISOString(),t=f(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),d=(await i.modifyAndSignMessages([g]))[0].signatures[i.address];if(!d)throw new Error(`[SDK] Signature missing for address: ${i.address}`);o=d;}else if(i.signMessages){let S=(await i.signMessages([a]))[0];if(!S?.signature)throw new Error("[SDK] Wallet returned invalid signMessages output.");o=S.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 v(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??u;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=f(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 C(e="mini-session-storage"){return create()(persist(r=>({miniSession:null,setMiniSession:t=>r({miniSession:t}),clearSession:()=>r({miniSession:null})}),{name:e}))}async function N(e,r,t=u){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-y)return o}return c||(c=p({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{m as a,u as b,y as c,f as d,p as e,v as f,C as g,N as h};

package/dist/chunk-HVUZ52OX.js

@@ -1 +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;
+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/chunk-NIIKETIK.cjs

@@ -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-UIDJZGQ7.cjs

@@ -0,0 +1 @@
+'use strict';var zustand=require('zustand'),middleware=require('zustand/middleware');var m=(t=>(t.EVM="EVM",t.SOLANA="SOLANA",t))(m||{});var u=300*1e3,w=60*1e3,y=30*1e3;function f(e){return `Mini-Session Login: ${e}`}async function p(e){let r=new Date().toISOString(),t=f(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),d=(await i.modifyAndSignMessages([g]))[0].signatures[i.address];if(!d)throw new Error(`[SDK] Signature missing for address: ${i.address}`);o=d;}else if(i.signMessages){let S=(await i.signMessages([a]))[0];if(!S?.signature)throw new Error("[SDK] Wallet returned invalid signMessages output.");o=S.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 v(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??u;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=f(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 C(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 N(e,r,t=u){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-y)return o}return c||(c=p({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=m;exports.b=u;exports.c=y;exports.d=f;exports.e=p;exports.f=v;exports.g=C;exports.h=N;

package/dist/chunk-ZVKFOJG3.cjs

@@ -0,0 +1 @@
+'use strict';var chunkNIIKETIK_cjs=require('./chunk-NIIKETIK.cjs'),chunkUIDJZGQ7_cjs=require('./chunk-UIDJZGQ7.cjs'),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 chunkUIDJZGQ7_cjs.h({isConnected:u.isConnected,address:u.address,chainType:"EVM",signer:d},{miniSession:s.current,setMiniSession:o.current},t)},[i,n,t]);return react.useEffect(()=>(chunkNIIKETIK_cjs.a(l),()=>{chunkNIIKETIK_cjs.a(null);}),[l]),null}exports.a=R;

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkUIDJZGQ7_cjs=require('./chunk-UIDJZGQ7.cjs'),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:chunkUIDJZGQ7_cjs.d,verifyMiniSession:chunkUIDJZGQ7_cjs.f,signMiniSession:chunkUIDJZGQ7_cjs.e,createMiniSessionStore:chunkUIDJZGQ7_cjs.g,getMiniSessionAuth:chunkUIDJZGQ7_cjs.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 chunkUIDJZGQ7_cjs.a}});Object.defineProperty(exports,"DEFAULT_MAX_AGE",{enumerable:true,get:function(){return chunkUIDJZGQ7_cjs.b}});Object.defineProperty(exports,"NETWORK_SAFETY_BUFFER",{enumerable:true,get:function(){return chunkUIDJZGQ7_cjs.c}});Object.defineProperty(exports,"createMiniSessionMessage",{enumerable:true,get:function(){return chunkUIDJZGQ7_cjs.d}});Object.defineProperty(exports,"createMiniSessionStore",{enumerable:true,get:function(){return chunkUIDJZGQ7_cjs.g}});Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkUIDJZGQ7_cjs.h}});Object.defineProperty(exports,"signMiniSession",{enumerable:true,get:function(){return chunkUIDJZGQ7_cjs.e}});Object.defineProperty(exports,"verifyMiniSession",{enumerable:true,get:function(){return chunkUIDJZGQ7_cjs.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.d.mts → index.d.cts}

@@ -1,6 +1,6 @@
 import { FetchOptions } from 'ofetch';
-import { Q as QuasarConfig, H as HistoryQuery, P as PaginatedResult, V as VerifySessionParams, S as SignSessionParams, a as SignSessionResult, M as MiniSessionStore, C as ConnectionData, b as MiniSessionAuth } from './types-Ctaain6g.mjs';
-export { c as ChainType, E as EvmSigner, d as SolanaSignedMessage, e as SolanaSigner } from './types-Ctaain6g.mjs';
+import { Q as QuasarConfig, H as HistoryQuery, P as PaginatedResult, V as VerifySessionParams, S as SignSessionParams, a as SignSessionResult, M as MiniSessionStore, C as ConnectionData, b as MiniSessionAuth } from './types-C4cwIvHT.cjs';
+export { c as ChainType, E as EvmSigner, d as SolanaSignableMessage, e as SolanaSigner } from './types-C4cwIvHT.cjs';
 import { Transaction } from '@tuwaio/pulsar-core';
 export { Transaction, UpdatableTransactionFields } from '@tuwaio/pulsar-core';
 import * as zustand_middleware from 'zustand/middleware';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { FetchOptions } from 'ofetch';
-import { Q as QuasarConfig, H as HistoryQuery, P as PaginatedResult, V as VerifySessionParams, S as SignSessionParams, a as SignSessionResult, M as MiniSessionStore, C as ConnectionData, b as MiniSessionAuth } from './types-Ctaain6g.js';
-export { c as ChainType, E as EvmSigner, d as SolanaSignedMessage, e as SolanaSigner } from './types-Ctaain6g.js';
+import { Q as QuasarConfig, H as HistoryQuery, P as PaginatedResult, V as VerifySessionParams, S as SignSessionParams, a as SignSessionResult, M as MiniSessionStore, C as ConnectionData, b as MiniSessionAuth } from './types-C4cwIvHT.js';
+export { c as ChainType, E as EvmSigner, d as SolanaSignableMessage, e as SolanaSigner } from './types-C4cwIvHT.js';
 import { Transaction } from '@tuwaio/pulsar-core';
 export { Transaction, UpdatableTransactionFields } from '@tuwaio/pulsar-core';
 import * as zustand_middleware from 'zustand/middleware';

package/dist/index.js

@@ -1,2 +1,2 @@
-'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;
+import {h as h$1,g,e,f,d as d$1}from'./chunk-C6JAMIC3.js';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-C6JAMIC3.js';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.cjs

@@ -0,0 +1 @@
+'use strict';var chunkZVKFOJG3_cjs=require('../chunk-ZVKFOJG3.cjs'),chunkNIIKETIK_cjs=require('../chunk-NIIKETIK.cjs');require('../chunk-UIDJZGQ7.cjs');Object.defineProperty(exports,"QuasarEvmAuthBridge",{enumerable:true,get:function(){return chunkZVKFOJG3_cjs.a}});Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkNIIKETIK_cjs.b}});

package/dist/react/{evm.d.mts → evm.d.cts}

@@ -1,9 +1,9 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 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';
+import { b as MiniSessionAuth } from '../types-C4cwIvHT.cjs';
+import { Q as QuasarActiveConnection } from '../shared-D2uX4Ua8.cjs';
+export { g as getMiniSessionAuth } from '../shared-D2uX4Ua8.cjs';
 
 /**
  * Props for the QuasarEvmAuthBridge component.
@@ -51,6 +51,6 @@ interface QuasarEvmAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarEvmAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarEvmAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+declare function QuasarEvmAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarEvmAuthBridgeProps): react.JSX.Element | null;
 
 export { QuasarActiveConnection, QuasarEvmAuthBridge, type QuasarEvmAuthBridgeProps };

package/dist/react/evm.d.ts

@@ -1,9 +1,9 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 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';
+import { b as MiniSessionAuth } from '../types-C4cwIvHT.js';
+import { Q as QuasarActiveConnection } from '../shared-BDH89Mck.js';
+export { g as getMiniSessionAuth } from '../shared-BDH89Mck.js';
 
 /**
  * Props for the QuasarEvmAuthBridge component.
@@ -51,6 +51,6 @@ interface QuasarEvmAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarEvmAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarEvmAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+declare function QuasarEvmAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarEvmAuthBridgeProps): react.JSX.Element | null;
 
 export { QuasarActiveConnection, QuasarEvmAuthBridge, type QuasarEvmAuthBridgeProps };

package/dist/react/evm.js

@@ -1 +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}});
+export{a as QuasarEvmAuthBridge}from'../chunk-2VPVIX5M.js';export{b as getMiniSessionAuth}from'../chunk-HVUZ52OX.js';import'../chunk-C6JAMIC3.js';

package/dist/react/solana.cjs

@@ -0,0 +1 @@
+'use strict';var chunkAQEHRYJP_cjs=require('../chunk-AQEHRYJP.cjs'),chunkNIIKETIK_cjs=require('../chunk-NIIKETIK.cjs');require('../chunk-UIDJZGQ7.cjs');Object.defineProperty(exports,"QuasarSolanaAuthBridge",{enumerable:true,get:function(){return chunkAQEHRYJP_cjs.a}});Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkNIIKETIK_cjs.b}});

package/dist/react/{solana.d.mts → solana.d.cts}

@@ -1,8 +1,8 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from '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';
+import { b as MiniSessionAuth } from '../types-C4cwIvHT.cjs';
+import { Q as QuasarActiveConnection } from '../shared-D2uX4Ua8.cjs';
+export { g as getMiniSessionAuth } from '../shared-D2uX4Ua8.cjs';
 
 /**
  * Props for the QuasarSolanaAuthBridge component.
@@ -47,6 +47,6 @@ interface QuasarSolanaAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarSolanaAuthBridge({ activeConnection, store, session, setSession, maxAge, onAddressMismatch, }: QuasarSolanaAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+declare function QuasarSolanaAuthBridge({ activeConnection, store, session, setSession, maxAge, onAddressMismatch, }: QuasarSolanaAuthBridgeProps): react.JSX.Element | null;
 
 export { QuasarActiveConnection, QuasarSolanaAuthBridge, type QuasarSolanaAuthBridgeProps };

package/dist/react/solana.d.ts

@@ -1,8 +1,8 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from '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';
+import { b as MiniSessionAuth } from '../types-C4cwIvHT.js';
+import { Q as QuasarActiveConnection } from '../shared-BDH89Mck.js';
+export { g as getMiniSessionAuth } from '../shared-BDH89Mck.js';
 
 /**
  * Props for the QuasarSolanaAuthBridge component.
@@ -47,6 +47,6 @@ interface QuasarSolanaAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarSolanaAuthBridge({ activeConnection, store, session, setSession, maxAge, onAddressMismatch, }: QuasarSolanaAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+declare function QuasarSolanaAuthBridge({ activeConnection, store, session, setSession, maxAge, onAddressMismatch, }: QuasarSolanaAuthBridgeProps): react.JSX.Element | null;
 
 export { QuasarActiveConnection, QuasarSolanaAuthBridge, type QuasarSolanaAuthBridgeProps };

package/dist/react/solana.js

@@ -1 +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}});
+export{a as QuasarSolanaAuthBridge}from'../chunk-2MHRTJOV.js';export{b as getMiniSessionAuth}from'../chunk-HVUZ52OX.js';import'../chunk-C6JAMIC3.js';

package/dist/react.cjs

@@ -0,0 +1 @@
+'use strict';var chunkZVKFOJG3_cjs=require('./chunk-ZVKFOJG3.cjs'),chunkAQEHRYJP_cjs=require('./chunk-AQEHRYJP.cjs'),chunkNIIKETIK_cjs=require('./chunk-NIIKETIK.cjs');require('./chunk-UIDJZGQ7.cjs');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(chunkAQEHRYJP_cjs.a,{activeConnection:r,store:e,session:i,setSession:o,maxAge:n}):jsxRuntime.jsx(chunkZVKFOJG3_cjs.a,{activeConnection:r,store:e,wagmiConfig:d,session:i,setSession:o,maxAge:n})}Object.defineProperty(exports,"getMiniSessionAuth",{enumerable:true,get:function(){return chunkNIIKETIK_cjs.b}});exports.QuasarAuthBridge=C;

package/dist/{react.d.mts → react.d.cts}

@@ -1,9 +1,9 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 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';
+import { b as MiniSessionAuth } from './types-C4cwIvHT.cjs';
+import { Q as QuasarActiveConnection } from './shared-D2uX4Ua8.cjs';
+export { g as getMiniSessionAuth } from './shared-D2uX4Ua8.cjs';
 
 /**
  * Props for the unified QuasarAuthBridge component.
@@ -55,6 +55,6 @@ interface QuasarAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarAuthBridgeProps): react.JSX.Element | null;
 
 export { QuasarActiveConnection, QuasarAuthBridge, type QuasarAuthBridgeProps };

package/dist/react.d.ts

@@ -1,9 +1,9 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 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';
+import { b as MiniSessionAuth } from './types-C4cwIvHT.js';
+import { Q as QuasarActiveConnection } from './shared-BDH89Mck.js';
+export { g as getMiniSessionAuth } from './shared-BDH89Mck.js';
 
 /**
  * Props for the unified QuasarAuthBridge component.
@@ -55,6 +55,6 @@ interface QuasarAuthBridgeProps {
  *
  * @public
  */
-declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarAuthBridgeProps): react_jsx_runtime.JSX.Element | null;
+declare function QuasarAuthBridge({ activeConnection, store, wagmiConfig, session, setSession, maxAge, onAddressMismatch, }: QuasarAuthBridgeProps): react.JSX.Element | null;
 
 export { QuasarActiveConnection, QuasarAuthBridge, type QuasarAuthBridgeProps };

package/dist/react.js

@@ -1 +1 @@
-'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;
+import {a as a$1}from'./chunk-2VPVIX5M.js';import {a}from'./chunk-2MHRTJOV.js';export{b as getMiniSessionAuth}from'./chunk-HVUZ52OX.js';import'./chunk-C6JAMIC3.js';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 → shared-BDH89Mck.d.ts}

@@ -1,4 +1,4 @@
-import { b as MiniSessionAuth } from './types-Ctaain6g.js';
+import { b as MiniSessionAuth } from './types-C4cwIvHT.js';
 
 /**
  * @module react/shared

package/dist/{shared-CFhEPXTt.d.mts → shared-D2uX4Ua8.d.cts}

@@ -1,4 +1,4 @@
-import { b as MiniSessionAuth } from './types-Ctaain6g.mjs';
+import { b as MiniSessionAuth } from './types-C4cwIvHT.cjs';
 
 /**
  * @module react/shared

package/dist/{types-Ctaain6g.d.mts → types-C4cwIvHT.d.cts}

@@ -117,7 +117,9 @@ interface EvmSigner {
  * Result structure for a signed Solana message in Web3 v2.
  * @public
  */
-interface SolanaSignedMessage {
+interface SolanaSignableMessage {
+    /** The content of the message as bytes. */
+    readonly content: Uint8Array;
     /** A map of public addresses to their corresponding signature bytes. */
     readonly signatures: Readonly<Record<string, Uint8Array>>;
 }
@@ -133,7 +135,7 @@ interface SolanaSigner {
      * Modern Web3 v2 method to modify and sign messages.
      * Used by latest @solana/react hooks.
      */
-    modifyAndSignMessages?: (messages: readonly unknown[]) => Promise<readonly SolanaSignedMessage[]>;
+    modifyAndSignMessages?: (messages: readonly SolanaSignableMessage[]) => Promise<readonly SolanaSignableMessage[]>;
     /**
      * Plural signing method (Wallet Standard).
      */
@@ -185,4 +187,4 @@ interface ConnectionData {
     signer: EvmSigner | SolanaSigner;
 }
 
-export { type ConnectionData as C, type EvmSigner as E, type HistoryQuery as H, type MiniSessionStore as M, type PaginatedResult as P, type QuasarConfig as Q, type SignSessionParams as S, type VerifySessionParams as V, type SignSessionResult as a, type MiniSessionAuth as b, ChainType as c, type SolanaSignedMessage as d, type SolanaSigner as e };
+export { type ConnectionData as C, type EvmSigner as E, type HistoryQuery as H, type MiniSessionStore as M, type PaginatedResult as P, type QuasarConfig as Q, type SignSessionParams as S, type VerifySessionParams as V, type SignSessionResult as a, type MiniSessionAuth as b, ChainType as c, type SolanaSignableMessage as d, type SolanaSigner as e };

package/dist/{types-Ctaain6g.d.ts → types-C4cwIvHT.d.ts}

@@ -117,7 +117,9 @@ interface EvmSigner {
  * Result structure for a signed Solana message in Web3 v2.
  * @public
  */
-interface SolanaSignedMessage {
+interface SolanaSignableMessage {
+    /** The content of the message as bytes. */
+    readonly content: Uint8Array;
     /** A map of public addresses to their corresponding signature bytes. */
     readonly signatures: Readonly<Record<string, Uint8Array>>;
 }
@@ -133,7 +135,7 @@ interface SolanaSigner {
      * Modern Web3 v2 method to modify and sign messages.
      * Used by latest @solana/react hooks.
      */
-    modifyAndSignMessages?: (messages: readonly unknown[]) => Promise<readonly SolanaSignedMessage[]>;
+    modifyAndSignMessages?: (messages: readonly SolanaSignableMessage[]) => Promise<readonly SolanaSignableMessage[]>;
     /**
      * Plural signing method (Wallet Standard).
      */
@@ -185,4 +187,4 @@ interface ConnectionData {
     signer: EvmSigner | SolanaSigner;
 }
 
-export { type ConnectionData as C, type EvmSigner as E, type HistoryQuery as H, type MiniSessionStore as M, type PaginatedResult as P, type QuasarConfig as Q, type SignSessionParams as S, type VerifySessionParams as V, type SignSessionResult as a, type MiniSessionAuth as b, ChainType as c, type SolanaSignedMessage as d, type SolanaSigner as e };
+export { type ConnectionData as C, type EvmSigner as E, type HistoryQuery as H, type MiniSessionStore as M, type PaginatedResult as P, type QuasarConfig as Q, type SignSessionParams as S, type VerifySessionParams as V, type SignSessionResult as a, type MiniSessionAuth as b, ChainType as c, type SolanaSignableMessage as d, type SolanaSigner as e };

package/package.json

@@ -1,33 +1,34 @@
 {
   "name": "@tuwaio/quasar-sdk",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
-  "description": "The official server-side Node.js & Edge SDK for the TUWA Quasar Cloud.",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
+  "description": "Layer 5 (L5) of the TUWA Ecosystem. The Quasar Cloud SDK providing server-side Node.js & Edge utilities for transaction indexing, billing, and backend API integration.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     },
     "./react": {
       "types": "./dist/react.d.ts",
-      "import": "./dist/react.mjs",
-      "require": "./dist/react.js"
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
     },
     "./react/evm": {
       "types": "./dist/react/evm.d.ts",
-      "import": "./dist/react/evm.mjs",
-      "require": "./dist/react/evm.js"
+      "import": "./dist/react/evm.js",
+      "require": "./dist/react/evm.cjs"
     },
     "./react/solana": {
       "types": "./dist/react/solana.d.ts",
-      "import": "./dist/react/solana.mjs",
-      "require": "./dist/react/solana.js"
+      "import": "./dist/react/solana.js",
+      "require": "./dist/react/solana.cjs"
     }
   },
   "publishConfig": {
@@ -37,10 +38,46 @@
     "dist"
   ],
   "keywords": [
+    "tuwa",
     "web3",
+    "evm",
+    "ethereum",
+    "solana",
+    "wagmi",
+    "viem",
+    "gill",
+    "wallet-standard",
+    "wallet",
+    "wallet-connect",
+    "wallets",
     "transaction",
     "tracking",
-    "sdk"
+    "transaction-tracking",
+    "react",
+    "ui",
+    "ui-kit",
+    "design-system",
+    "hooks",
+    "utils",
+    "components",
+    "tailwind",
+    "tailwindcss",
+    "typescript",
+    "core",
+    "headless",
+    "zustand",
+    "immer",
+    "i18n",
+    "modal",
+    "toast",
+    "quasar",
+    "cloud",
+    "sdk",
+    "siwe",
+    "next-auth",
+    "cosmos",
+    "playground",
+    "cli"
   ],
   "repository": {
     "type": "git",
@@ -58,17 +95,23 @@
     }
   ],
   "peerDependencies": {
-    "@solana/react": ">=6.9.0",
+    "@solana/react": "6.x.x",
     "@tuwaio/pulsar-core": ">=0.6.0",
     "@wagmi/core": "3.x.x",
     "@wallet-standard/react": "1.x.x",
+    "gill": ">=0.14.0",
     "ofetch": ">=1.5.1",
     "react": ">=19.2.0",
-    "gill": ">=0.14",
     "viem": "2.x.x",
     "zustand": "5.x.x"
   },
   "peerDependenciesMeta": {
+    "@tuwaio/pulsar-core": {
+      "optional": false
+    },
+    "ofetch": {
+      "optional": false
+    },
     "viem": {
       "optional": true
     },
@@ -93,18 +136,18 @@
   },
   "devDependencies": {
     "@solana/react": "^6.9.0",
-    "@tuwaio/pulsar-core": "^0.6.4",
-    "@types/react": "^19.2.15",
-    "@wagmi/core": "^3.5.0",
-    "@wallet-standard/react": "^1.0.2",
+    "@tuwaio/pulsar-core": "^0.6.7",
+    "@types/react": "^19.2.17",
+    "@wagmi/core": "^3.6.3",
+    "@wallet-standard/react": "^1.0.3",
     "ofetch": "^1.5.1",
-    "react": "^19.2.6",
+    "react": "^19.2.7",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "zustand": "^5.0.13"
+    "zustand": "^5.0.14"
   },
   "scripts": {
-    "start": "tsup --watch",
+    "start": "tsup src/index.ts --watch",
     "build": "tsup"
   }
 }

package/dist/chunk-7F6I4FHE.js

@@ -1 +0,0 @@
-'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

@@ -1 +0,0 @@
-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

@@ -1 +0,0 @@
-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-OJCR5A56.js

@@ -1 +0,0 @@
-'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

@@ -1 +0,0 @@
-'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

@@ -1 +0,0 @@
-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

@@ -1 +0,0 @@
-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.mjs

@@ -1,2 +0,0 @@
-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.mjs

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

package/dist/react/solana.mjs

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

package/dist/react.mjs

@@ -1 +0,0 @@
-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};