@tuwaio/quasar-sdk 0.0.3 → 0.0.5

package/dist/react.js

@@ -0,0 +1 @@
+'use strict';var chunkA52BVTJ6_js=require('./chunk-A52BVTJ6.js'),react$1=require('@solana/react'),core=require('@wagmi/core'),react=require('react'),jsxRuntime=require('react/jsx-runtime');var s=null;async function P(){for(let n=0;n<15;n++){if(s)return s();await new Promise(t=>setTimeout(t,200));}throw new Error("[QuasarSDK] Auth helper not initialized. Ensure QuasarAuthBridge is mounted and wallet is connected.")}function k({activeConnection:n,store:t,wagmiConfig:r,session:i,setSession:e,onAddressMismatch:a}){let o=typeof n?.chainId=="string"?"SOLANA":"EVM";return react.useEffect(()=>{i&&n?.address&&i.walletAddress!==n.address&&(console.log("[QuasarSDK] Address mismatch detected, clearing session..."),e(null),a?.());},[n?.address,i,e,a]),!n?.isConnected||!t?null:o==="SOLANA"?jsxRuntime.jsx(h,{connectedAccount:n.connectedAccount,store:t,session:i,setSession:e}):jsxRuntime.jsx(f,{wagmiConfig:r,store:t,session:i,setSession:e})}function h({connectedAccount:n,store:t,session:r,setSession:i}){let e=react$1.useWalletAccountMessageSigner(n),a=react.useCallback(async()=>{let o=t.getState().activeConnection;if(!o?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");if(!e)throw new Error("[QuasarSDK] Solana Message Signer not initialized.");return chunkA52BVTJ6_js.g({isConnected:o.isConnected,address:o.address,chainType:"SOLANA",signer:e},{miniSession:r,setMiniSession:i})},[t,e,r,i]);return react.useEffect(()=>(s=a,()=>{s===a&&(s=null);}),[a]),null}function f({wagmiConfig:n,store:t,session:r,setSession:i}){let e=react.useCallback(async()=>{let u=t.getState().activeConnection;if(!u?.isConnected)throw new Error("[QuasarSDK] Wallet disconnected");let o=await core.getWalletClient(n);if(!o)throw new Error("[QuasarSDK] EVM Signer not found");return chunkA52BVTJ6_js.g({isConnected:u.isConnected,address:u.address,chainType:"EVM",signer:o},{miniSession:r,setMiniSession:i})},[t,n,r,i]);return react.useEffect(()=>(s=e,()=>{s===e&&(s=null);}),[e]),null}exports.QuasarAuthBridge=k;exports.getMiniSessionAuth=P;

package/dist/react.mjs

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

package/dist/types-Ctaain6g.d.mts

@@ -0,0 +1,188 @@
+/**
+ * @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;
+}
+
+/**
+ * Supported blockchain ecosystems for authentication.
+ * @public
+ */
+declare enum ChainType {
+    /** Ethereum and compatible L2s. */
+    EVM = "EVM",
+    /** Solana blockchain. */
+    SOLANA = "SOLANA"
+}
+/**
+ * Result structure for a signed message.
+ * @public
+ */
+interface SignSessionResult {
+    /** The cryptographic signature string. */
+    signature: string;
+    /** The ISO timestamp used to generate the message. */
+    timestamp: string;
+}
+/**
+ * Result of the Mini-Session signing process.
+ * Used for both frontend-side caching and backend-side verification.
+ * @public
+ */
+interface MiniSessionAuth extends SignSessionResult {
+    /** 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. Defaults to 5 minutes. */
+    maxAge?: number;
+}
+/**
+ * Interface for an EVM signer (compatible with Viem WalletClient).
+ * @public
+ */
+interface EvmSigner {
+    /** Signs a message using the specified account. */
+    signMessage: (params: {
+        account: `0x${string}`;
+        message: string;
+    }) => Promise<`0x${string}`>;
+}
+/**
+ * Result structure for a signed Solana message in Web3 v2.
+ * @public
+ */
+interface SolanaSignedMessage {
+    /** A map of public addresses to their corresponding signature bytes. */
+    readonly signatures: Readonly<Record<string, Uint8Array>>;
+}
+/**
+ * Interface for a Solana signer.
+ * Optimized to handle modern Web3 v2 (MessageModifyingSigner), Standard, and Legacy interfaces.
+ * @public
+ */
+interface SolanaSigner {
+    /** The public address of the signer. */
+    readonly address: string;
+    /**
+     * Modern Web3 v2 method to modify and sign messages.
+     * Used by latest @solana/react hooks.
+     */
+    modifyAndSignMessages?: (messages: readonly unknown[]) => Promise<readonly SolanaSignedMessage[]>;
+    /**
+     * Plural signing method (Wallet Standard).
+     */
+    signMessages?: (messages: readonly Uint8Array[]) => Promise<readonly {
+        signature: Uint8Array;
+    }[]>;
+    /**
+     * Singular signing method (Legacy).
+     */
+    signMessage?: (message: Uint8Array) => Promise<Uint8Array>;
+}
+/**
+ * Parameters for signing a mini-session message.
+ * @public
+ */
+interface SignSessionParams {
+    /** The signer object for the respective ecosystem. */
+    signer: EvmSigner | SolanaSigner;
+    /** The wallet address to sign with. */
+    walletAddress: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+}
+/**
+ * Interface for a store that manages Mini-Session persistence.
+ * Designed to be compatible with Zustand.
+ * @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. */
+    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 };

package/dist/types-Ctaain6g.d.ts

@@ -0,0 +1,188 @@
+/**
+ * @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;
+}
+
+/**
+ * Supported blockchain ecosystems for authentication.
+ * @public
+ */
+declare enum ChainType {
+    /** Ethereum and compatible L2s. */
+    EVM = "EVM",
+    /** Solana blockchain. */
+    SOLANA = "SOLANA"
+}
+/**
+ * Result structure for a signed message.
+ * @public
+ */
+interface SignSessionResult {
+    /** The cryptographic signature string. */
+    signature: string;
+    /** The ISO timestamp used to generate the message. */
+    timestamp: string;
+}
+/**
+ * Result of the Mini-Session signing process.
+ * Used for both frontend-side caching and backend-side verification.
+ * @public
+ */
+interface MiniSessionAuth extends SignSessionResult {
+    /** 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. Defaults to 5 minutes. */
+    maxAge?: number;
+}
+/**
+ * Interface for an EVM signer (compatible with Viem WalletClient).
+ * @public
+ */
+interface EvmSigner {
+    /** Signs a message using the specified account. */
+    signMessage: (params: {
+        account: `0x${string}`;
+        message: string;
+    }) => Promise<`0x${string}`>;
+}
+/**
+ * Result structure for a signed Solana message in Web3 v2.
+ * @public
+ */
+interface SolanaSignedMessage {
+    /** A map of public addresses to their corresponding signature bytes. */
+    readonly signatures: Readonly<Record<string, Uint8Array>>;
+}
+/**
+ * Interface for a Solana signer.
+ * Optimized to handle modern Web3 v2 (MessageModifyingSigner), Standard, and Legacy interfaces.
+ * @public
+ */
+interface SolanaSigner {
+    /** The public address of the signer. */
+    readonly address: string;
+    /**
+     * Modern Web3 v2 method to modify and sign messages.
+     * Used by latest @solana/react hooks.
+     */
+    modifyAndSignMessages?: (messages: readonly unknown[]) => Promise<readonly SolanaSignedMessage[]>;
+    /**
+     * Plural signing method (Wallet Standard).
+     */
+    signMessages?: (messages: readonly Uint8Array[]) => Promise<readonly {
+        signature: Uint8Array;
+    }[]>;
+    /**
+     * Singular signing method (Legacy).
+     */
+    signMessage?: (message: Uint8Array) => Promise<Uint8Array>;
+}
+/**
+ * Parameters for signing a mini-session message.
+ * @public
+ */
+interface SignSessionParams {
+    /** The signer object for the respective ecosystem. */
+    signer: EvmSigner | SolanaSigner;
+    /** The wallet address to sign with. */
+    walletAddress: string;
+    /** The blockchain ecosystem type. */
+    chainType: ChainType;
+}
+/**
+ * Interface for a store that manages Mini-Session persistence.
+ * Designed to be compatible with Zustand.
+ * @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. */
+    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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/quasar-sdk",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -8,6 +8,18 @@
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -36,17 +48,53 @@
     }
   ],
   "peerDependencies": {
+    "@solana/react": ">=6.9.0",
     "@tuwaio/pulsar-core": ">=0.6.0",
-    "ofetch": ">=1.5.1"
+    "@wagmi/core": "3.x.x",
+    "@wallet-standard/react": "1.x.x",
+    "ofetch": ">=1.5.1",
+    "react": ">=19.2.0",
+    "gill": ">=0.14",
+    "viem": "2.x.x",
+    "zustand": "5.x.x"
+  },
+  "peerDependenciesMeta": {
+    "viem": {
+      "optional": true
+    },
+    "gill": {
+      "optional": true
+    },
+    "zustand": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "@solana/react": {
+      "optional": true
+    },
+    "@wagmi/core": {
+      "optional": true
+    },
+    "@wallet-standard/react": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@tuwaio/pulsar-core": "^0.6.1",
+    "@solana/react": "^6.9.0",
+    "@tuwaio/pulsar-core": "^0.6.2",
+    "@types/react": "^19.2.14",
+    "@wagmi/core": "^3.4.11",
+    "@wallet-standard/react": "^1.0.2",
     "ofetch": "^1.5.1",
+    "react": "^19.2.6",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "zustand": "^5.0.13"
   },
   "scripts": {
-    "start": "tsup src/index.ts --watch",
+    "start": "tsup --watch",
     "build": "tsup"
   }
 }