@tuwaio/quasar-sdk 1.0.0-fix-docs-alpha.2.908b7c0 → 1.0.0-fix-docs-alpha.4.494fbc9

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 import { FetchOptions } from 'ofetch';
 import { Transaction } from '@tuwaio/pulsar-core';
 export { Transaction, UpdatableTransactionFields } from '@tuwaio/pulsar-core';
+import * as zustand_middleware from 'zustand/middleware';
+import * as zustand from 'zustand';
 
 /**
  * @module types
@@ -137,6 +139,81 @@ interface PaginatedResult<T> {
     hasPrevPage: boolean;
 }
 
+/**
+ * Supported blockchain ecosystems for authentication.
+ * @public
+ */
+declare enum ChainType {
+    EVM = "EVM",
+    SOLANA = "SOLANA"
+}
+/**
+ * Result of the Mini-Session signing process.
+ * Used for both frontend-side caching and backend-side verification.
+ * @public
+ */
+interface MiniSessionAuth {
+    /** The cryptographic signature (hex for EVM, base58 for Solana). */
+    signature: string;
+    /** ISO string timestamp used in the signed message. */
+    timestamp: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+    /** The wallet address that signed the message. */
+    walletAddress: string;
+}
+/**
+ * Parameters for verifying a mini-session signature.
+ * @public
+ */
+interface VerifySessionParams extends Omit<MiniSessionAuth, 'walletAddress'> {
+    /** The wallet address that allegedly signed the message. */
+    walletAddress: string;
+    /**
+     * Maximum allowed age for the signature in milliseconds.
+     * Default: 5 minutes (300,000ms).
+     */
+    maxAge?: number;
+}
+/**
+ * Parameters for signing a mini-session message.
+ * @public
+ */
+interface SignSessionParams {
+    /** The signer object. For EVM, a `WalletClient`. For Solana, a `KeyPairSigner` or `TransactionSendingSigner`. */
+    signer: any;
+    /** The wallet address to sign with (required for EVM). */
+    walletAddress?: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+}
+/**
+ * Zustand store interface for managing Mini-Sessions.
+ * @public
+ */
+interface MiniSessionStore {
+    /** Current active session or null. */
+    miniSession: MiniSessionAuth | null;
+    /** Sets the active session. */
+    setMiniSession: (session: MiniSessionAuth | null) => void;
+    /** Clears the current session. */
+    clearSession: () => void;
+}
+/**
+ * Minimum connection data required for Mini-Session signing.
+ * @public
+ */
+interface ConnectionData {
+    /** Whether a wallet is currently connected. */
+    isConnected: boolean;
+    /** The active wallet address. */
+    address: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+    /** The wallet signer object (WalletClient for EVM, TransactionSendingSigner for Solana). */
+    signer: any;
+}
+
 /**
  * @module core/client
  * @description Core HTTP client for the Quasar SDK.
@@ -331,21 +408,9 @@ declare class PulsarModule {
  * @module utils/auth
  * @description Security utilities for Mini-Session signature verification.
  */
+
 /**
- * Parameters for verifying a mini-session signature.
- */
-interface VerifySessionParams {
-    /** The wallet address that allegedly signed the message. */
-    walletAddress: string;
-    /** ISO string timestamp matching the one used in the message. */
-    timestamp: string;
-    /** The cryptographic signature (hex for EVM, base58 for Solana). */
-    signature: string;
-    /** The blockchain ecosystem type. */
-    chainType: 'evm' | 'solana';
-}
-/**
- * Standardizes the message format for Quasar Mini-Session login.
+ * Standardizes the message format for Mini-Session login.
  * Both frontend and backend must use this exact template.
  *
  * @param timestamp - ISO string timestamp (e.g., `new Date().toISOString()`).
@@ -354,21 +419,10 @@ interface VerifySessionParams {
  * @example
  * ```typescript
  * const msg = createMiniSessionMessage(new Date().toISOString());
- * // msg -> "Quasar Login: 2026-05-13T10:00:00.000Z"
+ * // msg -> "Mini-Session Login: 2026-05-13T10:00:00.000Z"
  * ```
  */
 declare function createMiniSessionMessage(timestamp: string): string;
-/**
- * Parameters for signing a mini-session message.
- */
-interface SignSessionParams {
-    /** The signer object. For EVM, a `WalletClient`. For Solana, a `KeyPairSigner` or `TransactionSendingSigner`. */
-    signer: any;
-    /** The wallet address to sign with (required for EVM). */
-    walletAddress?: string;
-    /** The blockchain ecosystem type. */
-    chainType: 'evm' | 'solana';
-}
 /**
  * Result of a mini-session signing operation.
  */
@@ -383,29 +437,13 @@ interface SignSessionResult {
  *
  * This is a frontend-friendly helper that:
  * 1. Generates a fresh ISO timestamp.
- * 2. Formats the standard Quasar login message.
+ * 2. Formats the standard login message.
  * 3. Triggers the wallet's signMessage method.
  * 4. Returns the signature and timestamp for verification on the backend.
  *
  * @param params - The signing parameters including the signer and ecosystem type.
  * @returns A promise that resolves to the signature and timestamp.
  * @throws {Error} If the required peer dependencies are missing or signing fails.
- *
- * @example
- * ```typescript
- * // EVM (viem)
- * const { signature, timestamp } = await signMiniSession({
- *   signer: walletClient,
- *   walletAddress: '0x...',
- *   chainType: 'evm',
- * });
- *
- * // Solana (gill)
- * const { signature, timestamp } = await signMiniSession({
- *   signer: keypairSigner,
- *   chainType: 'solana',
- * });
- * ```
  */
 declare function signMiniSession(params: SignSessionParams): Promise<SignSessionResult>;
 /**
@@ -414,25 +452,51 @@ declare function signMiniSession(params: SignSessionParams): Promise<SignSession
  * This utility performs three checks:
  * 1. Timestamp freshness (rejects if older than 5 minutes or in the future).
  * 2. Cryptographic validity (checks if the signature matches the wallet address and message).
- * 3. ecosystem-specific logic (EVM via `viem`, Solana via `gill`).
+ * 3. Ecosystem-specific logic (EVM via `viem`, Solana via `gill`).
  *
  * @param params - The verification parameters including address, signature, and timestamp.
  * @returns A promise that resolves to `true` if the signature is valid and fresh.
  * @throws {Error} If the required peer dependencies (`viem` or `gill`) are missing.
  * @throws {Error} If the timestamp is invalid or expired.
- *
- * @example
- * ```typescript
- * const isValid = await verifyMiniSession({
- *   walletAddress: '0x...',
- *   timestamp: '2026-05-13T10:00:00.000Z',
- *   signature: '0x...',
- *   chainType: 'evm',
- * });
- * ```
  */
 declare function verifyMiniSession(params: VerifySessionParams): Promise<boolean>;
 
+/**
+ * Creates a persistent Zustand store to cache Mini-Session signatures.
+ * Requires `zustand` to be installed as a peer dependency.
+ *
+ * @param storageName - Key name for localStorage persistence.
+ * @returns A Zustand store instance.
+ */
+declare function createMiniSessionStore(storageName?: string): zustand.UseBoundStore<Omit<zustand.StoreApi<MiniSessionStore>, "setState" | "persist"> & {
+    setState(partial: MiniSessionStore | Partial<MiniSessionStore> | ((state: MiniSessionStore) => MiniSessionStore | Partial<MiniSessionStore>), replace?: false | undefined): unknown;
+    setState(state: MiniSessionStore | ((state: MiniSessionStore) => MiniSessionStore), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<zustand_middleware.PersistOptions<MiniSessionStore, MiniSessionStore, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: MiniSessionStore) => void) => () => void;
+        onFinishHydration: (fn: (state: MiniSessionStore) => void) => () => void;
+        getOptions: () => Partial<zustand_middleware.PersistOptions<MiniSessionStore, MiniSessionStore, unknown>>;
+    };
+}>;
+/**
+ * Generic helper to manage Mini-Session signing and caching.
+ *
+ * Checks the provided store for an existing session matching the current connection.
+ * If no session is found, it triggers a signature request using the provided signer.
+ *
+ * @param connection - Current active connection state.
+ * @param store - An object compatible with MiniSessionStore to read/write the session.
+ * @returns A promise resolving to the authenticated session.
+ * @throws {Error} If no wallet is connected or signing fails.
+ */
+declare function getMiniSessionAuth(connection: ConnectionData, store: {
+    miniSession: MiniSessionAuth | null;
+    setMiniSession: (s: MiniSessionAuth) => void;
+}): Promise<MiniSessionAuth>;
+
 declare const BASE_API_URL = "https://api.tuwa.io";
 declare const PULSAR_SYNC_ENDPOINT = "/v1/engine/pulsar/sync";
 declare const PULSAR_HISTORY_ENDPOINT = "/v1/engine/pulsar/history";
@@ -480,6 +544,16 @@ declare const utils: {
      * @see {@link signMiniSession}
      */
     signMiniSession: typeof signMiniSession;
+    /**
+     * Creates a persistent Zustand store for session management.
+     * @see {@link createMiniSessionStore}
+     */
+    createMiniSessionStore: typeof createMiniSessionStore;
+    /**
+     * Reusable helper to manage signing and session caching.
+     * @see {@link getMiniSessionAuth}
+     */
+    getMiniSessionAuth: typeof getMiniSessionAuth;
 };
 /**
  * Main entry point for the Quasar SDK.
@@ -526,6 +600,16 @@ declare class Quasar {
          * @see {@link signMiniSession}
          */
         signMiniSession: typeof signMiniSession;
+        /**
+         * Creates a persistent Zustand store for session management.
+         * @see {@link createMiniSessionStore}
+         */
+        createMiniSessionStore: typeof createMiniSessionStore;
+        /**
+         * Reusable helper to manage signing and session caching.
+         * @see {@link getMiniSessionAuth}
+         */
+        getMiniSessionAuth: typeof getMiniSessionAuth;
     };
     /**
      * The internal HTTP client used for authenticated requests.
@@ -555,4 +639,4 @@ declare class Quasar {
     constructor(config: QuasarConfig);
 }
 
-export { BASE_API_URL, type HistoryQuery, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, type PaginatedResult, PulsarModule, Quasar, type QuasarConfig, QuasarSDKError, type SignSessionParams, type SignSessionResult, type VerifySessionParams, createMiniSessionMessage, signMiniSession, utils, verifyMiniSession };
+export { BASE_API_URL, ChainType, type ConnectionData, type HistoryQuery, type MiniSessionAuth, type MiniSessionStore, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, type PaginatedResult, PulsarModule, Quasar, type QuasarConfig, QuasarSDKError, type SignSessionParams, type SignSessionResult, type VerifySessionParams, createMiniSessionMessage, createMiniSessionStore, getMiniSessionAuth, signMiniSession, utils, verifyMiniSession };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { FetchOptions } from 'ofetch';
 import { Transaction } from '@tuwaio/pulsar-core';
 export { Transaction, UpdatableTransactionFields } from '@tuwaio/pulsar-core';
+import * as zustand_middleware from 'zustand/middleware';
+import * as zustand from 'zustand';
 
 /**
  * @module types
@@ -137,6 +139,81 @@ interface PaginatedResult<T> {
     hasPrevPage: boolean;
 }
 
+/**
+ * Supported blockchain ecosystems for authentication.
+ * @public
+ */
+declare enum ChainType {
+    EVM = "EVM",
+    SOLANA = "SOLANA"
+}
+/**
+ * Result of the Mini-Session signing process.
+ * Used for both frontend-side caching and backend-side verification.
+ * @public
+ */
+interface MiniSessionAuth {
+    /** The cryptographic signature (hex for EVM, base58 for Solana). */
+    signature: string;
+    /** ISO string timestamp used in the signed message. */
+    timestamp: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+    /** The wallet address that signed the message. */
+    walletAddress: string;
+}
+/**
+ * Parameters for verifying a mini-session signature.
+ * @public
+ */
+interface VerifySessionParams extends Omit<MiniSessionAuth, 'walletAddress'> {
+    /** The wallet address that allegedly signed the message. */
+    walletAddress: string;
+    /**
+     * Maximum allowed age for the signature in milliseconds.
+     * Default: 5 minutes (300,000ms).
+     */
+    maxAge?: number;
+}
+/**
+ * Parameters for signing a mini-session message.
+ * @public
+ */
+interface SignSessionParams {
+    /** The signer object. For EVM, a `WalletClient`. For Solana, a `KeyPairSigner` or `TransactionSendingSigner`. */
+    signer: any;
+    /** The wallet address to sign with (required for EVM). */
+    walletAddress?: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+}
+/**
+ * Zustand store interface for managing Mini-Sessions.
+ * @public
+ */
+interface MiniSessionStore {
+    /** Current active session or null. */
+    miniSession: MiniSessionAuth | null;
+    /** Sets the active session. */
+    setMiniSession: (session: MiniSessionAuth | null) => void;
+    /** Clears the current session. */
+    clearSession: () => void;
+}
+/**
+ * Minimum connection data required for Mini-Session signing.
+ * @public
+ */
+interface ConnectionData {
+    /** Whether a wallet is currently connected. */
+    isConnected: boolean;
+    /** The active wallet address. */
+    address: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+    /** The wallet signer object (WalletClient for EVM, TransactionSendingSigner for Solana). */
+    signer: any;
+}
+
 /**
  * @module core/client
  * @description Core HTTP client for the Quasar SDK.
@@ -331,21 +408,9 @@ declare class PulsarModule {
  * @module utils/auth
  * @description Security utilities for Mini-Session signature verification.
  */
+
 /**
- * Parameters for verifying a mini-session signature.
- */
-interface VerifySessionParams {
-    /** The wallet address that allegedly signed the message. */
-    walletAddress: string;
-    /** ISO string timestamp matching the one used in the message. */
-    timestamp: string;
-    /** The cryptographic signature (hex for EVM, base58 for Solana). */
-    signature: string;
-    /** The blockchain ecosystem type. */
-    chainType: 'evm' | 'solana';
-}
-/**
- * Standardizes the message format for Quasar Mini-Session login.
+ * Standardizes the message format for Mini-Session login.
  * Both frontend and backend must use this exact template.
  *
  * @param timestamp - ISO string timestamp (e.g., `new Date().toISOString()`).
@@ -354,21 +419,10 @@ interface VerifySessionParams {
  * @example
  * ```typescript
  * const msg = createMiniSessionMessage(new Date().toISOString());
- * // msg -> "Quasar Login: 2026-05-13T10:00:00.000Z"
+ * // msg -> "Mini-Session Login: 2026-05-13T10:00:00.000Z"
  * ```
  */
 declare function createMiniSessionMessage(timestamp: string): string;
-/**
- * Parameters for signing a mini-session message.
- */
-interface SignSessionParams {
-    /** The signer object. For EVM, a `WalletClient`. For Solana, a `KeyPairSigner` or `TransactionSendingSigner`. */
-    signer: any;
-    /** The wallet address to sign with (required for EVM). */
-    walletAddress?: string;
-    /** The blockchain ecosystem type. */
-    chainType: 'evm' | 'solana';
-}
 /**
  * Result of a mini-session signing operation.
  */
@@ -383,29 +437,13 @@ interface SignSessionResult {
  *
  * This is a frontend-friendly helper that:
  * 1. Generates a fresh ISO timestamp.
- * 2. Formats the standard Quasar login message.
+ * 2. Formats the standard login message.
  * 3. Triggers the wallet's signMessage method.
  * 4. Returns the signature and timestamp for verification on the backend.
  *
  * @param params - The signing parameters including the signer and ecosystem type.
  * @returns A promise that resolves to the signature and timestamp.
  * @throws {Error} If the required peer dependencies are missing or signing fails.
- *
- * @example
- * ```typescript
- * // EVM (viem)
- * const { signature, timestamp } = await signMiniSession({
- *   signer: walletClient,
- *   walletAddress: '0x...',
- *   chainType: 'evm',
- * });
- *
- * // Solana (gill)
- * const { signature, timestamp } = await signMiniSession({
- *   signer: keypairSigner,
- *   chainType: 'solana',
- * });
- * ```
  */
 declare function signMiniSession(params: SignSessionParams): Promise<SignSessionResult>;
 /**
@@ -414,25 +452,51 @@ declare function signMiniSession(params: SignSessionParams): Promise<SignSession
  * This utility performs three checks:
  * 1. Timestamp freshness (rejects if older than 5 minutes or in the future).
  * 2. Cryptographic validity (checks if the signature matches the wallet address and message).
- * 3. ecosystem-specific logic (EVM via `viem`, Solana via `gill`).
+ * 3. Ecosystem-specific logic (EVM via `viem`, Solana via `gill`).
  *
  * @param params - The verification parameters including address, signature, and timestamp.
  * @returns A promise that resolves to `true` if the signature is valid and fresh.
  * @throws {Error} If the required peer dependencies (`viem` or `gill`) are missing.
  * @throws {Error} If the timestamp is invalid or expired.
- *
- * @example
- * ```typescript
- * const isValid = await verifyMiniSession({
- *   walletAddress: '0x...',
- *   timestamp: '2026-05-13T10:00:00.000Z',
- *   signature: '0x...',
- *   chainType: 'evm',
- * });
- * ```
  */
 declare function verifyMiniSession(params: VerifySessionParams): Promise<boolean>;
 
+/**
+ * Creates a persistent Zustand store to cache Mini-Session signatures.
+ * Requires `zustand` to be installed as a peer dependency.
+ *
+ * @param storageName - Key name for localStorage persistence.
+ * @returns A Zustand store instance.
+ */
+declare function createMiniSessionStore(storageName?: string): zustand.UseBoundStore<Omit<zustand.StoreApi<MiniSessionStore>, "setState" | "persist"> & {
+    setState(partial: MiniSessionStore | Partial<MiniSessionStore> | ((state: MiniSessionStore) => MiniSessionStore | Partial<MiniSessionStore>), replace?: false | undefined): unknown;
+    setState(state: MiniSessionStore | ((state: MiniSessionStore) => MiniSessionStore), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<zustand_middleware.PersistOptions<MiniSessionStore, MiniSessionStore, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: MiniSessionStore) => void) => () => void;
+        onFinishHydration: (fn: (state: MiniSessionStore) => void) => () => void;
+        getOptions: () => Partial<zustand_middleware.PersistOptions<MiniSessionStore, MiniSessionStore, unknown>>;
+    };
+}>;
+/**
+ * Generic helper to manage Mini-Session signing and caching.
+ *
+ * Checks the provided store for an existing session matching the current connection.
+ * If no session is found, it triggers a signature request using the provided signer.
+ *
+ * @param connection - Current active connection state.
+ * @param store - An object compatible with MiniSessionStore to read/write the session.
+ * @returns A promise resolving to the authenticated session.
+ * @throws {Error} If no wallet is connected or signing fails.
+ */
+declare function getMiniSessionAuth(connection: ConnectionData, store: {
+    miniSession: MiniSessionAuth | null;
+    setMiniSession: (s: MiniSessionAuth) => void;
+}): Promise<MiniSessionAuth>;
+
 declare const BASE_API_URL = "https://api.tuwa.io";
 declare const PULSAR_SYNC_ENDPOINT = "/v1/engine/pulsar/sync";
 declare const PULSAR_HISTORY_ENDPOINT = "/v1/engine/pulsar/history";
@@ -480,6 +544,16 @@ declare const utils: {
      * @see {@link signMiniSession}
      */
     signMiniSession: typeof signMiniSession;
+    /**
+     * Creates a persistent Zustand store for session management.
+     * @see {@link createMiniSessionStore}
+     */
+    createMiniSessionStore: typeof createMiniSessionStore;
+    /**
+     * Reusable helper to manage signing and session caching.
+     * @see {@link getMiniSessionAuth}
+     */
+    getMiniSessionAuth: typeof getMiniSessionAuth;
 };
 /**
  * Main entry point for the Quasar SDK.
@@ -526,6 +600,16 @@ declare class Quasar {
          * @see {@link signMiniSession}
          */
         signMiniSession: typeof signMiniSession;
+        /**
+         * Creates a persistent Zustand store for session management.
+         * @see {@link createMiniSessionStore}
+         */
+        createMiniSessionStore: typeof createMiniSessionStore;
+        /**
+         * Reusable helper to manage signing and session caching.
+         * @see {@link getMiniSessionAuth}
+         */
+        getMiniSessionAuth: typeof getMiniSessionAuth;
     };
     /**
      * The internal HTTP client used for authenticated requests.
@@ -555,4 +639,4 @@ declare class Quasar {
     constructor(config: QuasarConfig);
 }
 
-export { BASE_API_URL, type HistoryQuery, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, type PaginatedResult, PulsarModule, Quasar, type QuasarConfig, QuasarSDKError, type SignSessionParams, type SignSessionResult, type VerifySessionParams, createMiniSessionMessage, signMiniSession, utils, verifyMiniSession };
+export { BASE_API_URL, ChainType, type ConnectionData, type HistoryQuery, type MiniSessionAuth, type MiniSessionStore, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, type PaginatedResult, PulsarModule, Quasar, type QuasarConfig, QuasarSDKError, type SignSessionParams, type SignSessionResult, type VerifySessionParams, createMiniSessionMessage, createMiniSessionStore, getMiniSessionAuth, signMiniSession, utils, verifyMiniSession };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var ofetch=require('ofetch');var l="https://api.tuwa.io",g="/v1/engine/pulsar/sync",d="/v1/engine/pulsar/history";var o=class extends Error{status;originalError;constructor(e,t,s){super(e),this.name="QuasarSDKError",this.status=t,this.originalError=s;}},c=class{secretKey;internalSecret;baseUrl;timeout;constructor(e){if(!e.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=e.secretKey,this.internalSecret=e.internalSecret,this.baseUrl=e.baseUrl||l,this.timeout=e.timeout||1e4;}async request(e,t={}){try{return await ofetch.ofetch(e,{baseURL:this.baseUrl,timeout:this.timeout,...t,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...t.headers}})}catch(s){throw this.buildError(s)}}buildError(e){let t=e,s=t.statusCode??t.response?.status,n=(t.data??t.response?._data)?.error??t.message??"Unknown Error";return (s===401||s===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new o(`[Quasar SDK] Request Failed (${s}): ${n}`,s,t)}};var a=class{constructor(e){this.client=e;}async syncCreate(e,t){return this.client.request(g,{method:"POST",body:{...e,appName:t}})}async getHistory(e={}){return this.client.request(d,{method:"GET",query:{page:e.page??1,limit:e.limit??10,chainId:e.chainId,status:e.status,txKey:e.txKey,appName:e.appName,walletAddress:e.walletAddress}})}};function u(r){return `Quasar Login: ${r}`}async function p(r){let e=new Date().toISOString(),t=u(e);if(r.chainType==="evm"){if(!r.walletAddress)throw new Error("[Quasar SDK] walletAddress is required for EVM signing.");try{return {signature:await r.signer.signMessage({account:r.walletAddress,message:t}),timestamp:e}}catch(s){throw new Error(`[Quasar SDK] EVM signing failed: ${s.message}`,{cause:s})}}if(r.chainType==="solana"){let s;try{s=await import('gill');}catch(i){throw new Error('[Quasar SDK] Peer dependency "gill" is required for Solana signing.',{cause:i})}try{let n=s.getUtf8Encoder().encode(t),[y]=await r.signer.signMessages([n]);return {signature:s.getSignatureFromBytes(y),timestamp:e}}catch(i){throw new Error(`[Quasar SDK] Solana signing failed: ${i.message}`,{cause:i})}}throw new Error(`[Quasar SDK] Unsupported chain type: ${r.chainType}`)}async function m(r){let e=new Date(r.timestamp).getTime(),t=Date.now();if(isNaN(e))throw new Error("[Quasar SDK] Invalid timestamp format. Use ISO string.");if(t-e>3e5)throw new Error("[Quasar SDK] Signature expired. Please sign a fresh message.");if(e>t+6e4)throw new Error("[Quasar SDK] Timestamp is in the future. Check your system clock.");let s=u(r.timestamp);if(r.chainType==="evm"){let i;try{i=await import('viem');}catch(n){throw new Error('[Quasar SDK] Peer dependency "viem" is required for EVM verification.',{cause:n})}return await i.verifyMessage({address:r.walletAddress,message:s,signature:r.signature})}if(r.chainType==="solana"){let i;try{i=await import('gill');}catch(n){throw new Error('[Quasar SDK] Peer dependency "gill" is required for Solana verification.',{cause:n})}try{return await i.verifySignatureForAddress(i.address(r.walletAddress),r.signature,s)}catch{return  false}}return  false}var w={createMiniSessionMessage:u,verifyMiniSession:m,signMiniSession:p},h=class{static utils=w;client;pulsar;constructor(e){this.client=new c(e),this.pulsar=new a(this.client);}};
-exports.BASE_API_URL=l;exports.PULSAR_HISTORY_ENDPOINT=d;exports.PULSAR_SYNC_ENDPOINT=g;exports.PulsarModule=a;exports.Quasar=h;exports.QuasarSDKError=o;exports.createMiniSessionMessage=u;exports.signMiniSession=p;exports.utils=w;exports.verifyMiniSession=m;
+'use strict';var ofetch=require('ofetch'),zustand=require('zustand'),middleware=require('zustand/middleware');var d="https://api.tuwa.io",p="/v1/engine/pulsar/sync",m="/v1/engine/pulsar/history";var c=class extends Error{status;originalError;constructor(e,r,s){super(e),this.name="QuasarSDKError",this.status=r,this.originalError=s;}},l=class{secretKey;internalSecret;baseUrl;timeout;constructor(e){if(!e.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=e.secretKey,this.internalSecret=e.internalSecret,this.baseUrl=e.baseUrl||d,this.timeout=e.timeout||1e4;}async request(e,r={}){try{return await ofetch.ofetch(e,{baseURL:this.baseUrl,timeout:this.timeout,...r,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...r.headers}})}catch(s){throw this.buildError(s)}}buildError(e){let r=e,s=r.statusCode??r.response?.status,n=(r.data??r.response?._data)?.error??r.message??"Unknown Error";return (s===401||s===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new c(`[Quasar SDK] Request Failed (${s}): ${n}`,s,r)}};var a=class{constructor(e){this.client=e;}async syncCreate(e,r){return this.client.request(p,{method:"POST",body:{...e,appName:r}})}async getHistory(e={}){return this.client.request(m,{method:"GET",query:{page:e.page??1,limit:e.limit??10,chainId:e.chainId,status:e.status,txKey:e.txKey,appName:e.appName,walletAddress:e.walletAddress}})}};var S=(r=>(r.EVM="EVM",r.SOLANA="SOLANA",r))(S||{});var M=300*1e3,x=60*1e3;function u(t){return `Mini-Session Login: ${t}`}async function g(t){let e=new Date().toISOString(),r=u(e);if(t.chainType==="EVM"){if(!t.walletAddress)throw new Error("[SDK] walletAddress is required for EVM signing.");try{return {signature:await t.signer.signMessage({account:t.walletAddress,message:r}),timestamp:e}}catch(s){throw new Error(`[SDK] EVM signing failed: ${s.message}`,{cause:s})}}if(t.chainType==="SOLANA"){let s;try{s=await import('gill');}catch(i){throw new Error('[SDK] Peer dependency "gill" is required for Solana signing.',{cause:i})}try{let n=s.getUtf8Encoder().encode(r),[o]=await t.signer.signMessages([n]);return {signature:s.getSignatureFromBytes(o),timestamp:e}}catch(i){throw new Error(`[SDK] Solana signing failed: ${i.message}`,{cause:i})}}throw new Error(`[SDK] Unsupported chain type: ${t.chainType}`)}async function h(t){let e=new Date(t.timestamp).getTime(),r=Date.now();if(isNaN(e))throw new Error("[SDK] Invalid timestamp format. Use ISO string.");let s=t.maxAge??M;if(r-e>s)throw new Error("[SDK] Signature expired. Please sign a fresh message.");if(e>r+x)throw new Error("[SDK] Timestamp is in the future. Check your system clock.");let i=u(t.timestamp);if(t.chainType==="EVM"){let n;try{n=await import('viem');}catch(o){throw new Error('[SDK] Peer dependency "viem" is required for EVM verification.',{cause:o})}return await n.verifyMessage({address:t.walletAddress,message:i,signature:t.signature})}if(t.chainType==="SOLANA"){let n;try{n=await import('gill');}catch(o){throw new Error('[SDK] Peer dependency "gill" is required for Solana verification.',{cause:o})}try{return await n.verifySignatureForAddress(n.address(t.walletAddress),t.signature,i)}catch{return  false}}return  false}function y(t="mini-session-storage"){return zustand.create()(middleware.persist(e=>({miniSession:null,setMiniSession:r=>e({miniSession:r}),clearSession:()=>e({miniSession:null})}),{name:t}))}async function f(t,e){if(!t.isConnected||!t.address)throw new Error("Wallet not connected. Please connect your wallet first.");let{address:r,chainType:s,signer:i}=t;if(e.miniSession&&e.miniSession.walletAddress===r&&e.miniSession.chainType===s)return e.miniSession;let o={...await g({signer:i,walletAddress:r,chainType:s}),chainType:s,walletAddress:r};return e.setMiniSession(o),o}var b={createMiniSessionMessage:u,verifyMiniSession:h,signMiniSession:g,createMiniSessionStore:y,getMiniSessionAuth:f},w=class{static utils=b;client;pulsar;constructor(e){this.client=new l(e),this.pulsar=new a(this.client);}};
+exports.BASE_API_URL=d;exports.ChainType=S;exports.PULSAR_HISTORY_ENDPOINT=m;exports.PULSAR_SYNC_ENDPOINT=p;exports.PulsarModule=a;exports.Quasar=w;exports.QuasarSDKError=c;exports.createMiniSessionMessage=u;exports.createMiniSessionStore=y;exports.getMiniSessionAuth=f;exports.signMiniSession=g;exports.utils=b;exports.verifyMiniSession=h;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {ofetch}from'ofetch';var l="https://api.tuwa.io",g="/v1/engine/pulsar/sync",d="/v1/engine/pulsar/history";var o=class extends Error{status;originalError;constructor(e,t,s){super(e),this.name="QuasarSDKError",this.status=t,this.originalError=s;}},c=class{secretKey;internalSecret;baseUrl;timeout;constructor(e){if(!e.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=e.secretKey,this.internalSecret=e.internalSecret,this.baseUrl=e.baseUrl||l,this.timeout=e.timeout||1e4;}async request(e,t={}){try{return await ofetch(e,{baseURL:this.baseUrl,timeout:this.timeout,...t,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...t.headers}})}catch(s){throw this.buildError(s)}}buildError(e){let t=e,s=t.statusCode??t.response?.status,n=(t.data??t.response?._data)?.error??t.message??"Unknown Error";return (s===401||s===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new o(`[Quasar SDK] Request Failed (${s}): ${n}`,s,t)}};var a=class{constructor(e){this.client=e;}async syncCreate(e,t){return this.client.request(g,{method:"POST",body:{...e,appName:t}})}async getHistory(e={}){return this.client.request(d,{method:"GET",query:{page:e.page??1,limit:e.limit??10,chainId:e.chainId,status:e.status,txKey:e.txKey,appName:e.appName,walletAddress:e.walletAddress}})}};function u(r){return `Quasar Login: ${r}`}async function p(r){let e=new Date().toISOString(),t=u(e);if(r.chainType==="evm"){if(!r.walletAddress)throw new Error("[Quasar SDK] walletAddress is required for EVM signing.");try{return {signature:await r.signer.signMessage({account:r.walletAddress,message:t}),timestamp:e}}catch(s){throw new Error(`[Quasar SDK] EVM signing failed: ${s.message}`,{cause:s})}}if(r.chainType==="solana"){let s;try{s=await import('gill');}catch(i){throw new Error('[Quasar SDK] Peer dependency "gill" is required for Solana signing.',{cause:i})}try{let n=s.getUtf8Encoder().encode(t),[y]=await r.signer.signMessages([n]);return {signature:s.getSignatureFromBytes(y),timestamp:e}}catch(i){throw new Error(`[Quasar SDK] Solana signing failed: ${i.message}`,{cause:i})}}throw new Error(`[Quasar SDK] Unsupported chain type: ${r.chainType}`)}async function m(r){let e=new Date(r.timestamp).getTime(),t=Date.now();if(isNaN(e))throw new Error("[Quasar SDK] Invalid timestamp format. Use ISO string.");if(t-e>3e5)throw new Error("[Quasar SDK] Signature expired. Please sign a fresh message.");if(e>t+6e4)throw new Error("[Quasar SDK] Timestamp is in the future. Check your system clock.");let s=u(r.timestamp);if(r.chainType==="evm"){let i;try{i=await import('viem');}catch(n){throw new Error('[Quasar SDK] Peer dependency "viem" is required for EVM verification.',{cause:n})}return await i.verifyMessage({address:r.walletAddress,message:s,signature:r.signature})}if(r.chainType==="solana"){let i;try{i=await import('gill');}catch(n){throw new Error('[Quasar SDK] Peer dependency "gill" is required for Solana verification.',{cause:n})}try{return await i.verifySignatureForAddress(i.address(r.walletAddress),r.signature,s)}catch{return  false}}return  false}var w={createMiniSessionMessage:u,verifyMiniSession:m,signMiniSession:p},h=class{static utils=w;client;pulsar;constructor(e){this.client=new c(e),this.pulsar=new a(this.client);}};
-export{l as BASE_API_URL,d as PULSAR_HISTORY_ENDPOINT,g as PULSAR_SYNC_ENDPOINT,a as PulsarModule,h as Quasar,o as QuasarSDKError,u as createMiniSessionMessage,p as signMiniSession,w as utils,m as verifyMiniSession};
+import {ofetch}from'ofetch';import {create}from'zustand';import {persist}from'zustand/middleware';var d="https://api.tuwa.io",p="/v1/engine/pulsar/sync",m="/v1/engine/pulsar/history";var c=class extends Error{status;originalError;constructor(e,r,s){super(e),this.name="QuasarSDKError",this.status=r,this.originalError=s;}},l=class{secretKey;internalSecret;baseUrl;timeout;constructor(e){if(!e.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=e.secretKey,this.internalSecret=e.internalSecret,this.baseUrl=e.baseUrl||d,this.timeout=e.timeout||1e4;}async request(e,r={}){try{return await ofetch(e,{baseURL:this.baseUrl,timeout:this.timeout,...r,headers:{"Content-Type":"application/json","x-tuwa-secret-key":this.secretKey,...this.internalSecret?{"x-internal-secret":this.internalSecret}:{},...r.headers}})}catch(s){throw this.buildError(s)}}buildError(e){let r=e,s=r.statusCode??r.response?.status,n=(r.data??r.response?._data)?.error??r.message??"Unknown Error";return (s===401||s===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new c(`[Quasar SDK] Request Failed (${s}): ${n}`,s,r)}};var a=class{constructor(e){this.client=e;}async syncCreate(e,r){return this.client.request(p,{method:"POST",body:{...e,appName:r}})}async getHistory(e={}){return this.client.request(m,{method:"GET",query:{page:e.page??1,limit:e.limit??10,chainId:e.chainId,status:e.status,txKey:e.txKey,appName:e.appName,walletAddress:e.walletAddress}})}};var S=(r=>(r.EVM="EVM",r.SOLANA="SOLANA",r))(S||{});var M=300*1e3,x=60*1e3;function u(t){return `Mini-Session Login: ${t}`}async function g(t){let e=new Date().toISOString(),r=u(e);if(t.chainType==="EVM"){if(!t.walletAddress)throw new Error("[SDK] walletAddress is required for EVM signing.");try{return {signature:await t.signer.signMessage({account:t.walletAddress,message:r}),timestamp:e}}catch(s){throw new Error(`[SDK] EVM signing failed: ${s.message}`,{cause:s})}}if(t.chainType==="SOLANA"){let s;try{s=await import('gill');}catch(i){throw new Error('[SDK] Peer dependency "gill" is required for Solana signing.',{cause:i})}try{let n=s.getUtf8Encoder().encode(r),[o]=await t.signer.signMessages([n]);return {signature:s.getSignatureFromBytes(o),timestamp:e}}catch(i){throw new Error(`[SDK] Solana signing failed: ${i.message}`,{cause:i})}}throw new Error(`[SDK] Unsupported chain type: ${t.chainType}`)}async function h(t){let e=new Date(t.timestamp).getTime(),r=Date.now();if(isNaN(e))throw new Error("[SDK] Invalid timestamp format. Use ISO string.");let s=t.maxAge??M;if(r-e>s)throw new Error("[SDK] Signature expired. Please sign a fresh message.");if(e>r+x)throw new Error("[SDK] Timestamp is in the future. Check your system clock.");let i=u(t.timestamp);if(t.chainType==="EVM"){let n;try{n=await import('viem');}catch(o){throw new Error('[SDK] Peer dependency "viem" is required for EVM verification.',{cause:o})}return await n.verifyMessage({address:t.walletAddress,message:i,signature:t.signature})}if(t.chainType==="SOLANA"){let n;try{n=await import('gill');}catch(o){throw new Error('[SDK] Peer dependency "gill" is required for Solana verification.',{cause:o})}try{return await n.verifySignatureForAddress(n.address(t.walletAddress),t.signature,i)}catch{return  false}}return  false}function y(t="mini-session-storage"){return create()(persist(e=>({miniSession:null,setMiniSession:r=>e({miniSession:r}),clearSession:()=>e({miniSession:null})}),{name:t}))}async function f(t,e){if(!t.isConnected||!t.address)throw new Error("Wallet not connected. Please connect your wallet first.");let{address:r,chainType:s,signer:i}=t;if(e.miniSession&&e.miniSession.walletAddress===r&&e.miniSession.chainType===s)return e.miniSession;let o={...await g({signer:i,walletAddress:r,chainType:s}),chainType:s,walletAddress:r};return e.setMiniSession(o),o}var b={createMiniSessionMessage:u,verifyMiniSession:h,signMiniSession:g,createMiniSessionStore:y,getMiniSessionAuth:f},w=class{static utils=b;client;pulsar;constructor(e){this.client=new l(e),this.pulsar=new a(this.client);}};
+export{d as BASE_API_URL,S as ChainType,m as PULSAR_HISTORY_ENDPOINT,p as PULSAR_SYNC_ENDPOINT,a as PulsarModule,w as Quasar,c as QuasarSDKError,u as createMiniSessionMessage,y as createMiniSessionStore,f as getMiniSessionAuth,g as signMiniSession,b as utils,h as verifyMiniSession};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/quasar-sdk",
-  "version": "1.0.0-fix-docs-alpha.2.908b7c0",
+  "version": "1.0.0-fix-docs-alpha.4.494fbc9",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -39,7 +39,8 @@
     "@tuwaio/pulsar-core": ">=0.6.0",
     "ofetch": ">=1.5.1",
     "viem": "^2.0.0",
-    "gill": "^0.14.0"
+    "gill": "^0.14.0",
+    "zustand": "^5.0.0"
   },
   "peerDependenciesMeta": {
     "viem": {
@@ -47,6 +48,9 @@
     },
     "gill": {
       "optional": true
+    },
+    "zustand": {
+      "optional": true
     }
   },
   "devDependencies": {