@tuwaio/quasar-sdk 0.0.18 → 0.1.1

package/dist/index.d.cts

@@ -1,10 +1,69 @@
 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-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';
-import * as zustand from 'zustand';
+
+/**
+ * @module types
+ * @description Shared type definitions for the Quasar SDK.
+ * Contains configuration interfaces, query parameters, and authentication structures.
+ */
+
+/**
+ * Configuration options for initializing the {@link Quasar} SDK client.
+ *
+ * @public
+ */
+interface QuasarConfig {
+    /** Your secret API key starting with `sk_live_`. */
+    secretKey: string;
+    /** Optional internal secret for system-to-system communication. */
+    internalSecret?: string;
+    /** The base URL of the Quasar Cloud API. Defaults to 'https://api.tuwa.io'. */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 10000. */
+    timeout?: number;
+}
+/**
+ * Query parameters for filtering and paginating transaction history.
+ *
+ * @public
+ */
+interface HistoryQuery {
+    /** Page number for pagination (1-indexed). */
+    page?: number;
+    /** Maximum number of results to return per page. */
+    limit?: number;
+    /** Filter by blockchain chain ID (e.g., 1, 'solana'). */
+    chainId?: string | number;
+    /** Filter by transaction status (e.g., 'Success', 'Failed'). */
+    status?: string;
+    /** Filter by a specific Quasar transaction key. */
+    txKey?: string;
+    /** Filter by the application name. */
+    appName?: string;
+    /** Filter by the sender's wallet address. */
+    walletAddress?: string;
+}
+/**
+ * Generic wrapper for paginated API responses.
+ *
+ * @typeParam T - The type of the documents contained in the result set.
+ * @public
+ */
+interface PaginatedResult<T> {
+    /** Array of documents for the current page. */
+    docs: T[];
+    /** Total number of documents matching the query. */
+    totalDocs: number;
+    /** Total number of available pages. */
+    totalPages: number;
+    /** The current page number (1-indexed). */
+    page: number;
+    /** Indicates if a subsequent page is available. */
+    hasNextPage: boolean;
+    /** Indicates if a preceding page is available. */
+    hasPrevPage: boolean;
+}
 
 /**
  * @module core/client
@@ -196,110 +255,6 @@ declare class PulsarModule {
     getHistory(query?: HistoryQuery): Promise<PaginatedResult<Transaction>>;
 }
 
-/**
- * @module utils/auth
- * @description Security utilities for Mini-Session signature creation and verification.
- * Supports dual-ecosystem (EVM & Solana) authentication flows with strict type safety.
- */
-
-/**
- * Default maximum allowed age for a signature (5 minutes).
- * Prevents replay attacks using stale signatures.
- * @internal
- */
-declare const DEFAULT_MAX_AGE: number;
-/**
- * Safety buffer subtracted from DEFAULT_MAX_AGE during cache validation.
- * Ensures the session is refreshed before it expires on the server,
- * accounting for network round-trip latency between client cache check
- * and server-side verifyMiniSession call.
- * @public
- */
-declare const NETWORK_SAFETY_BUFFER: number;
-/**
- * Standardizes the message format for Mini-Session authentication.
- * Both frontend and backend MUST use this exact template for verification to pass.
- *
- * @param timestamp - ISO string timestamp (e.g., `new Date().toISOString()`).
- * @returns The formatted message string to be signed.
- *
- * @example
- * ```typescript
- * const msg = createMiniSessionMessage(new Date().toISOString());
- * // msg -> "Mini-Session Login: 2026-05-13T10:00:00.000Z"
- * ```
- */
-declare function createMiniSessionMessage(timestamp: string): string;
-/**
- * Triggers a signature request in the connected wallet to create a Mini-Session.
- *
- * This function detects the signer's capabilities and uses the most appropriate
- * signing method available (e.g., Web3 v2, Standard, or Legacy).
- *
- * @param params - Parameters containing the signer and target ecosystem.
- * @returns A promise resolving to the signature and timestamp.
- * @throws {Error} If signing fails or the signer lacks required methods.
- *
- * @public
- */
-declare function signMiniSession(params: SignSessionParams): Promise<SignSessionResult>;
-/**
- * Verifies a Mini-Session signature for authenticity and freshness.
- *
- * Performs cryptographic verification against the provided wallet address and
- * ensures the signature hasn't expired according to the `maxAge` parameter.
- *
- * @param params - Verification data including signature and timestamp.
- * @returns A promise resolving to true if the session is valid.
- *
- * @public
- */
-declare function verifyMiniSession(params: VerifySessionParams): Promise<boolean>;
-
-/**
- * Creates a persistent Zustand store to cache Mini-Session signatures.
- * This is the recommended way to manage sessions in React applications.
- *
- * @param storageName - The localStorage key for persistence. Defaults to 'mini-session-storage'.
- * @returns A Zustand store instance initialized with MiniSessionStore interface.
- *
- * @public
- */
-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>>;
-    };
-}>;
-/**
- * High-level orchestrator to retrieve an existing Mini-Session or trigger a new signature.
- *
- * This function checks the provided store for a valid, non-expired session matching
- * the current wallet connection. If no session is found or it has expired, it
- * triggers a signature request through the wallet.
- *
- * @param connection - The current active wallet connection data (address, signer, etc).
- * @param store - A store implementation (Zustand or compatible) for session persistence.
- * @param maxAge - Maximum allowed session age in milliseconds. Must match the value
- *   passed to `verifyMiniSession` to keep cache and verification in sync.
- *   Defaults to `DEFAULT_MAX_AGE` (5 minutes).
- * @returns A promise resolving to a valid MiniSessionAuth object.
- * @throws {Error} If the wallet is disconnected or signing fails.
- *
- * @public
- */
-declare function getMiniSessionAuth(connection: ConnectionData, store: {
-    miniSession: MiniSessionAuth | null;
-    setMiniSession: (session: MiniSessionAuth | null) => void;
-}, maxAge?: number): 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";
@@ -324,40 +279,15 @@ declare const PULSAR_HISTORY_ENDPOINT = "/v1/engine/pulsar/history";
  */
 
 /**
- * Security and authentication utilities.
+ * Pre-flight check before initiating a transaction.
+ * Ensures the local SIWX Session is valid and verifies Quasar Engine health.
  *
- * Includes methods for creating, signing, and verifying Mini-Session signatures
- * to protect your API quota. These can be used without initializing the Quasar class.
+ * @param customApiUrl - Optional custom API URL to override the default.
+ * @throws {Error} If the session check fails or Quasar is unreachable.
  *
  * @public
  */
-declare const utils: {
-    /**
-     * Standardizes the message format for Quasar Mini-Session login.
-     * @see {@link createMiniSessionMessage}
-     */
-    createMiniSessionMessage: typeof createMiniSessionMessage;
-    /**
-     * Verifies a Mini-Session signature (EVM or Solana).
-     * @see {@link verifyMiniSession}
-     */
-    verifyMiniSession: typeof verifyMiniSession;
-    /**
-     * Triggers a signature request in the connected wallet.
-     * @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;
-};
+declare function preFlightTxCheck(customApiUrl?: string): Promise<void>;
 /**
  * Main entry point for the Quasar SDK.
  *
@@ -383,37 +313,6 @@ declare const utils: {
  * @public
  */
 declare class Quasar {
-    /**
-     * Security and authentication utilities.
-     * Shared across all instances and available statically.
-     */
-    static readonly utils: {
-        /**
-         * Standardizes the message format for Quasar Mini-Session login.
-         * @see {@link createMiniSessionMessage}
-         */
-        createMiniSessionMessage: typeof createMiniSessionMessage;
-        /**
-         * Verifies a Mini-Session signature (EVM or Solana).
-         * @see {@link verifyMiniSession}
-         */
-        verifyMiniSession: typeof verifyMiniSession;
-        /**
-         * Triggers a signature request in the connected wallet.
-         * @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.
      * @internal
@@ -442,4 +341,4 @@ declare class Quasar {
     constructor(config: QuasarConfig);
 }
 
-export { BASE_API_URL, ConnectionData, DEFAULT_MAX_AGE, HistoryQuery, MiniSessionAuth, MiniSessionStore, NETWORK_SAFETY_BUFFER, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, PaginatedResult, PulsarModule, Quasar, QuasarConfig, QuasarSDKError, SignSessionParams, SignSessionResult, VerifySessionParams, createMiniSessionMessage, createMiniSessionStore, getMiniSessionAuth, signMiniSession, utils, verifyMiniSession };
+export { BASE_API_URL, type HistoryQuery, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, type PaginatedResult, PulsarModule, Quasar, type QuasarConfig, QuasarSDKError, preFlightTxCheck };

package/dist/index.d.ts

@@ -1,10 +1,69 @@
 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-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';
-import * as zustand from 'zustand';
+
+/**
+ * @module types
+ * @description Shared type definitions for the Quasar SDK.
+ * Contains configuration interfaces, query parameters, and authentication structures.
+ */
+
+/**
+ * Configuration options for initializing the {@link Quasar} SDK client.
+ *
+ * @public
+ */
+interface QuasarConfig {
+    /** Your secret API key starting with `sk_live_`. */
+    secretKey: string;
+    /** Optional internal secret for system-to-system communication. */
+    internalSecret?: string;
+    /** The base URL of the Quasar Cloud API. Defaults to 'https://api.tuwa.io'. */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 10000. */
+    timeout?: number;
+}
+/**
+ * Query parameters for filtering and paginating transaction history.
+ *
+ * @public
+ */
+interface HistoryQuery {
+    /** Page number for pagination (1-indexed). */
+    page?: number;
+    /** Maximum number of results to return per page. */
+    limit?: number;
+    /** Filter by blockchain chain ID (e.g., 1, 'solana'). */
+    chainId?: string | number;
+    /** Filter by transaction status (e.g., 'Success', 'Failed'). */
+    status?: string;
+    /** Filter by a specific Quasar transaction key. */
+    txKey?: string;
+    /** Filter by the application name. */
+    appName?: string;
+    /** Filter by the sender's wallet address. */
+    walletAddress?: string;
+}
+/**
+ * Generic wrapper for paginated API responses.
+ *
+ * @typeParam T - The type of the documents contained in the result set.
+ * @public
+ */
+interface PaginatedResult<T> {
+    /** Array of documents for the current page. */
+    docs: T[];
+    /** Total number of documents matching the query. */
+    totalDocs: number;
+    /** Total number of available pages. */
+    totalPages: number;
+    /** The current page number (1-indexed). */
+    page: number;
+    /** Indicates if a subsequent page is available. */
+    hasNextPage: boolean;
+    /** Indicates if a preceding page is available. */
+    hasPrevPage: boolean;
+}
 
 /**
  * @module core/client
@@ -196,110 +255,6 @@ declare class PulsarModule {
     getHistory(query?: HistoryQuery): Promise<PaginatedResult<Transaction>>;
 }
 
-/**
- * @module utils/auth
- * @description Security utilities for Mini-Session signature creation and verification.
- * Supports dual-ecosystem (EVM & Solana) authentication flows with strict type safety.
- */
-
-/**
- * Default maximum allowed age for a signature (5 minutes).
- * Prevents replay attacks using stale signatures.
- * @internal
- */
-declare const DEFAULT_MAX_AGE: number;
-/**
- * Safety buffer subtracted from DEFAULT_MAX_AGE during cache validation.
- * Ensures the session is refreshed before it expires on the server,
- * accounting for network round-trip latency between client cache check
- * and server-side verifyMiniSession call.
- * @public
- */
-declare const NETWORK_SAFETY_BUFFER: number;
-/**
- * Standardizes the message format for Mini-Session authentication.
- * Both frontend and backend MUST use this exact template for verification to pass.
- *
- * @param timestamp - ISO string timestamp (e.g., `new Date().toISOString()`).
- * @returns The formatted message string to be signed.
- *
- * @example
- * ```typescript
- * const msg = createMiniSessionMessage(new Date().toISOString());
- * // msg -> "Mini-Session Login: 2026-05-13T10:00:00.000Z"
- * ```
- */
-declare function createMiniSessionMessage(timestamp: string): string;
-/**
- * Triggers a signature request in the connected wallet to create a Mini-Session.
- *
- * This function detects the signer's capabilities and uses the most appropriate
- * signing method available (e.g., Web3 v2, Standard, or Legacy).
- *
- * @param params - Parameters containing the signer and target ecosystem.
- * @returns A promise resolving to the signature and timestamp.
- * @throws {Error} If signing fails or the signer lacks required methods.
- *
- * @public
- */
-declare function signMiniSession(params: SignSessionParams): Promise<SignSessionResult>;
-/**
- * Verifies a Mini-Session signature for authenticity and freshness.
- *
- * Performs cryptographic verification against the provided wallet address and
- * ensures the signature hasn't expired according to the `maxAge` parameter.
- *
- * @param params - Verification data including signature and timestamp.
- * @returns A promise resolving to true if the session is valid.
- *
- * @public
- */
-declare function verifyMiniSession(params: VerifySessionParams): Promise<boolean>;
-
-/**
- * Creates a persistent Zustand store to cache Mini-Session signatures.
- * This is the recommended way to manage sessions in React applications.
- *
- * @param storageName - The localStorage key for persistence. Defaults to 'mini-session-storage'.
- * @returns A Zustand store instance initialized with MiniSessionStore interface.
- *
- * @public
- */
-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>>;
-    };
-}>;
-/**
- * High-level orchestrator to retrieve an existing Mini-Session or trigger a new signature.
- *
- * This function checks the provided store for a valid, non-expired session matching
- * the current wallet connection. If no session is found or it has expired, it
- * triggers a signature request through the wallet.
- *
- * @param connection - The current active wallet connection data (address, signer, etc).
- * @param store - A store implementation (Zustand or compatible) for session persistence.
- * @param maxAge - Maximum allowed session age in milliseconds. Must match the value
- *   passed to `verifyMiniSession` to keep cache and verification in sync.
- *   Defaults to `DEFAULT_MAX_AGE` (5 minutes).
- * @returns A promise resolving to a valid MiniSessionAuth object.
- * @throws {Error} If the wallet is disconnected or signing fails.
- *
- * @public
- */
-declare function getMiniSessionAuth(connection: ConnectionData, store: {
-    miniSession: MiniSessionAuth | null;
-    setMiniSession: (session: MiniSessionAuth | null) => void;
-}, maxAge?: number): 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";
@@ -324,40 +279,15 @@ declare const PULSAR_HISTORY_ENDPOINT = "/v1/engine/pulsar/history";
  */
 
 /**
- * Security and authentication utilities.
+ * Pre-flight check before initiating a transaction.
+ * Ensures the local SIWX Session is valid and verifies Quasar Engine health.
  *
- * Includes methods for creating, signing, and verifying Mini-Session signatures
- * to protect your API quota. These can be used without initializing the Quasar class.
+ * @param customApiUrl - Optional custom API URL to override the default.
+ * @throws {Error} If the session check fails or Quasar is unreachable.
  *
  * @public
  */
-declare const utils: {
-    /**
-     * Standardizes the message format for Quasar Mini-Session login.
-     * @see {@link createMiniSessionMessage}
-     */
-    createMiniSessionMessage: typeof createMiniSessionMessage;
-    /**
-     * Verifies a Mini-Session signature (EVM or Solana).
-     * @see {@link verifyMiniSession}
-     */
-    verifyMiniSession: typeof verifyMiniSession;
-    /**
-     * Triggers a signature request in the connected wallet.
-     * @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;
-};
+declare function preFlightTxCheck(customApiUrl?: string): Promise<void>;
 /**
  * Main entry point for the Quasar SDK.
  *
@@ -383,37 +313,6 @@ declare const utils: {
  * @public
  */
 declare class Quasar {
-    /**
-     * Security and authentication utilities.
-     * Shared across all instances and available statically.
-     */
-    static readonly utils: {
-        /**
-         * Standardizes the message format for Quasar Mini-Session login.
-         * @see {@link createMiniSessionMessage}
-         */
-        createMiniSessionMessage: typeof createMiniSessionMessage;
-        /**
-         * Verifies a Mini-Session signature (EVM or Solana).
-         * @see {@link verifyMiniSession}
-         */
-        verifyMiniSession: typeof verifyMiniSession;
-        /**
-         * Triggers a signature request in the connected wallet.
-         * @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.
      * @internal
@@ -442,4 +341,4 @@ declare class Quasar {
     constructor(config: QuasarConfig);
 }
 
-export { BASE_API_URL, ConnectionData, DEFAULT_MAX_AGE, HistoryQuery, MiniSessionAuth, MiniSessionStore, NETWORK_SAFETY_BUFFER, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, PaginatedResult, PulsarModule, Quasar, QuasarConfig, QuasarSDKError, SignSessionParams, SignSessionResult, VerifySessionParams, createMiniSessionMessage, createMiniSessionStore, getMiniSessionAuth, signMiniSession, utils, verifyMiniSession };
+export { BASE_API_URL, type HistoryQuery, PULSAR_HISTORY_ENDPOINT, PULSAR_SYNC_ENDPOINT, type PaginatedResult, PulsarModule, Quasar, type QuasarConfig, QuasarSDKError, preFlightTxCheck };

package/dist/index.js

@@ -1 +1,2 @@
-import {h,g,e,f,d}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 {b,c,a}from'./chunk-YPUBFZPR.js';export{a as BASE_API_URL,c as PULSAR_HISTORY_ENDPOINT,b as PULSAR_SYNC_ENDPOINT}from'./chunk-YPUBFZPR.js';import {ofetch}from'ofetch';var i=class extends Error{status;originalError;constructor(r,e,t){super(r),this.name="QuasarSDKError",this.status=e,this.originalError=t;}},o=class{secretKey;internalSecret;baseUrl;timeout;constructor(r){if(!r.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=r.secretKey,this.internalSecret=r.internalSecret,this.baseUrl=r.baseUrl||a,this.timeout=r.timeout||1e4;}async request(r,e={}){try{return await ofetch(r,{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(t){throw this.buildError(t)}}buildError(r){let e=r,t=e.statusCode??e.response?.status,S=(e.data??e.response?._data)?.error??e.message??"Unknown Error";return (t===401||t===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new i(`[Quasar SDK] Request Failed (${t}): ${S}`,t,e)}};var s=class{constructor(r){this.client=r;}async syncCreate(r,e){return this.client.request(b,{method:"POST",body:{...r,appName:e}})}async getHistory(r={}){return this.client.request(c,{method:"GET",query:{page:r.page??1,limit:r.limit??10,chainId:r.chainId,status:r.status,txKey:r.txKey,appName:r.appName,walletAddress:r.walletAddress}})}};var E={createMiniSessionMessage:d,verifyMiniSession:f,signMiniSession:e,createMiniSessionStore:g,getMiniSessionAuth:h},y=class{static utils=E;client;pulsar;constructor(r){this.client=new o(r),this.pulsar=new s(this.client);}};export{s as PulsarModule,y as Quasar,i as QuasarSDKError,E as utils};
+import {useSiwxSessionStore}from'@tuwaio/siwx-react';import {ofetch}from'ofetch';var a="https://api.tuwa.io",c="/v1/engine/pulsar/sync",u="/v1/engine/pulsar/history";var i=class extends Error{status;originalError;constructor(r,e,t){super(r),this.name="QuasarSDKError",this.status=e,this.originalError=t;}},n=class{secretKey;internalSecret;baseUrl;timeout;constructor(r){if(!r.secretKey)throw new Error("[Quasar SDK] Missing API Key. Provide a secretKey starting with sk_live_.");this.secretKey=r.secretKey,this.internalSecret=r.internalSecret,this.baseUrl=r.baseUrl||a,this.timeout=r.timeout||1e4;}async request(r,e={}){try{return await ofetch(r,{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(t){throw this.buildError(t)}}buildError(r){let e=r,t=e.statusCode??e.response?.status,p=(e.data??e.response?._data)?.error??e.message??"Unknown Error";return (t===401||t===403)&&console.error("\u{1F6A8} [Quasar SDK] Auth Error. Check your Secret Key and scopes."),new i(`[Quasar SDK] Request Failed (${t}): ${p}`,t,e)}};var o=class{constructor(r){this.client=r;}async syncCreate(r,e){return this.client.request(c,{method:"POST",body:{...r,appName:e}})}async getHistory(r={}){return this.client.request(u,{method:"GET",query:{page:r.page??1,limit:r.limit??10,chainId:r.chainId,status:r.status,txKey:r.txKey,appName:r.appName,walletAddress:r.walletAddress}})}};async function Q(s){if(!useSiwxSessionStore.getState().session)throw new Error("[QuasarSDK] No SIWX Session found. User must be signed in.");let e=s||a;try{let t=await fetch(`${e}/v1/engine/monitoring/health`,{method:"GET",cache:"no-store"});if(!t.ok)throw new Error(`[QuasarSDK] API Health check failed with status: ${t.status}`)}catch(t){throw new Error("[QuasarSDK] Quasar Cloud Engine is currently unreachable.",{cause:t})}}var l=class{client;pulsar;constructor(r){this.client=new n(r),this.pulsar=new o(this.client);}};
+export{a as BASE_API_URL,u as PULSAR_HISTORY_ENDPOINT,c as PULSAR_SYNC_ENDPOINT,o as PulsarModule,l as Quasar,i as QuasarSDKError,Q as preFlightTxCheck};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/quasar-sdk",
-  "version": "0.0.18",
+  "version": "0.1.1",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -14,26 +14,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
-    },
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js",
-      "require": "./dist/react.cjs"
-    },
-    "./react/evm": {
-      "types": "./dist/react/evm.d.ts",
-      "import": "./dist/react/evm.js",
-      "require": "./dist/react/evm.cjs"
-    },
-    "./react/solana": {
-      "types": "./dist/react/solana.d.ts",
-      "import": "./dist/react/solana.js",
-      "require": "./dist/react/solana.cjs"
-    },
-    "./react/shared": {
-      "types": "./dist/react/shared.d.ts",
-      "import": "./dist/react/shared.js",
-      "require": "./dist/react/shared.cjs"
     }
   },
   "publishConfig": {
@@ -79,7 +59,6 @@
     "quasar",
     "cloud",
     "sdk",
-    "siwe",
     "next-auth",
     "cosmos",
     "playground",
@@ -101,15 +80,9 @@
     }
   ],
   "peerDependencies": {
-    "@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",
-    "viem": "2.x.x",
-    "zustand": "5.x.x"
+    "@tuwaio/siwx-react": ">=0.1.0"
   },
   "peerDependenciesMeta": {
     "@tuwaio/pulsar-core": {
@@ -118,39 +91,20 @@
     "ofetch": {
       "optional": false
     },
-    "viem": {
-      "optional": true
-    },
-    "gill": {
-      "optional": true
-    },
-    "zustand": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "@solana/react": {
-      "optional": true
-    },
-    "@wagmi/core": {
-      "optional": true
-    },
-    "@wallet-standard/react": {
+    "@tuwaio/siwx-react": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@solana/react": "^6.9.0",
-    "@tuwaio/pulsar-core": "^0.6.10",
-    "@types/react": "^19.2.18",
-    "@wagmi/core": "^3.6.4",
-    "@wallet-standard/react": "^1.0.3",
+    "@tuwaio/pulsar-core": "^0.6.11",
     "ofetch": "^1.5.1",
-    "react": "^19.2.8",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "zustand": "^5.0.14"
+    "@tuwaio/siwx-react": "^0.1.0"
+  },
+  "dependencies": {
+    "@tuwaio/siwx-core": "^0.1.0",
+    "@tuwaio/siwx-server": "^0.1.0"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",

package/dist/chunk-C3D4A4ZL.cjs

@@ -1 +0,0 @@
-'use strict';var chunkNJH5FYLU_cjs=require('./chunk-NJH5FYLU.cjs');exports.a=null;function a(e){exports.a=e;}async function o(){for(let e=0;e<15;e++){if(exports.a)return exports.a();await new Promise(n=>setTimeout(n,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}async function u(e){await o();let n=e||chunkNJH5FYLU_cjs.a;try{let t=await fetch(`${n}/v1/engine/monitoring/health`,{method:"GET",cache:"no-store"});if(!t.ok)throw new Error(`[QuasarSDK] API Health check failed with status: ${t.status}`)}catch(t){throw new Error("[QuasarSDK] Quasar Cloud Engine is currently unreachable.",{cause:t})}}exports.b=a;exports.c=o;exports.d=u;

package/dist/chunk-C6JAMIC3.js

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