@tuwaio/quasar-sdk 0.2.1 → 0.4.0

package/README.md

@@ -25,8 +25,8 @@ pnpm add @tuwaio/quasar-sdk @tuwaio/pulsar-core
 
 | Import path                | Provides                                                                     | Peer dependencies                                        |
 | -------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------- |
-| `@tuwaio/quasar-sdk`       | `Quasar`, `PulsarModule`, `QuasarSDKError`, the endpoint constants and types | `@tuwaio/pulsar-core` (>=0.7), for the transaction types |
-| `@tuwaio/quasar-sdk/react` | `preFlightTxCheck`                                                           | Also `@tuwaio/siwx-react` (>=0.3, optional for the root) |
+| `@tuwaio/quasar-sdk`       | `Quasar`, `PulsarModule`, `QuasarSDKError`, the endpoint constants and types | `@tuwaio/pulsar-core` (>=0.9), for the transaction types |
+| `@tuwaio/quasar-sdk/react` | `preFlightTxCheck`                                                           | Also `@tuwaio/siwx-react` (>=0.5, optional for the root) |
 
 The root entry point imports neither React nor SIWX packages, so it runs in Node.js, Next.js Server Actions and route handlers, and Edge runtimes. Its HTTP client, `ofetch`, is a dependency.
 

package/dist/cli.cjs

@@ -48,7 +48,7 @@ var path = __toESM(require("path"), 1);
 // package.json
 var package_default = {
   name: "@tuwaio/quasar-sdk",
-  version: "0.2.1",
+  version: "0.4.0",
   private: false,
   author: "Oleksandr Tkach",
   license: "Apache-2.0",
@@ -122,8 +122,8 @@ var package_default = {
     ofetch: "^1.5.1"
   },
   peerDependencies: {
-    "@tuwaio/pulsar-core": ">=0.7",
-    "@tuwaio/siwx-react": ">=0.3"
+    "@tuwaio/pulsar-core": ">=0.9",
+    "@tuwaio/siwx-react": ">=0.5"
   },
   peerDependenciesMeta: {
     "@tuwaio/siwx-react": {
@@ -131,10 +131,10 @@ var package_default = {
     }
   },
   devDependencies: {
-    "@tuwaio/pulsar-core": "^0.8.3",
+    "@tuwaio/pulsar-core": "^0.9.1",
     tsup: "^8.5.1",
     typescript: "6.0.3",
-    "@tuwaio/siwx-react": "^0.4.1"
+    "@tuwaio/siwx-react": "^0.6.0"
   }
 };
 

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var chunkNJH5FYLU_cjs=require('./chunk-NJH5FYLU.cjs'),ofetch=require('ofetch'),pulsarCore=require('@tuwaio/pulsar-core');var a=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 the secretKey of your Quasar app (sk_live_ or sk_test_).");this.secretKey=r.secretKey,this.internalSecret=r.internalSecret,this.baseUrl=r.baseUrl||chunkNJH5FYLU_cjs.a,this.timeout=r.timeout||1e4;}async request(r,e={}){try{return await ofetch.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 a(`[Quasar SDK] Request Failed (${t}): ${p}`,t,e)}};var s=class{constructor(r){this.client=r;}async syncCreate(r,e){return this.client.request(chunkNJH5FYLU_cjs.b,{method:"POST",body:{...r,appName:e}})}async getHistory(r={}){return this.client.request(chunkNJH5FYLU_cjs.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 n=class{client;pulsar;constructor(r){this.client=new o(r),this.pulsar=new s(this.client);}};Object.defineProperty(exports,"BASE_API_URL",{enumerable:true,get:function(){return chunkNJH5FYLU_cjs.a}});Object.defineProperty(exports,"PULSAR_HISTORY_ENDPOINT",{enumerable:true,get:function(){return chunkNJH5FYLU_cjs.c}});Object.defineProperty(exports,"PULSAR_SYNC_ENDPOINT",{enumerable:true,get:function(){return chunkNJH5FYLU_cjs.b}});Object.defineProperty(exports,"TransactionStatus",{enumerable:true,get:function(){return pulsarCore.TransactionStatus}});Object.defineProperty(exports,"TransactionTracker",{enumerable:true,get:function(){return pulsarCore.TransactionTracker}});exports.PulsarModule=s;exports.Quasar=n;exports.QuasarSDKError=a;
+'use strict';var chunkNJH5FYLU_cjs=require('./chunk-NJH5FYLU.cjs'),ofetch=require('ofetch'),pulsarCore=require('@tuwaio/pulsar-core');var a=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 the secretKey of your Quasar app (sk_live_ or sk_test_).");this.secretKey=r.secretKey,this.internalSecret=r.internalSecret,this.baseUrl=r.baseUrl||chunkNJH5FYLU_cjs.a,this.timeout=r.timeout||1e4;}async request(r,e={}){try{return await ofetch.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 a(`[Quasar SDK] Request Failed (${t}): ${p}`,t,e)}};var s=class{constructor(r){this.client=r;}client;async syncCreate(r,e){return this.client.request(chunkNJH5FYLU_cjs.b,{method:"POST",body:{...r,appName:e}})}async getHistory(r={}){return this.client.request(chunkNJH5FYLU_cjs.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 n=class{client;pulsar;constructor(r){this.client=new o(r),this.pulsar=new s(this.client);}};Object.defineProperty(exports,"BASE_API_URL",{enumerable:true,get:function(){return chunkNJH5FYLU_cjs.a}});Object.defineProperty(exports,"PULSAR_HISTORY_ENDPOINT",{enumerable:true,get:function(){return chunkNJH5FYLU_cjs.c}});Object.defineProperty(exports,"PULSAR_SYNC_ENDPOINT",{enumerable:true,get:function(){return chunkNJH5FYLU_cjs.b}});Object.defineProperty(exports,"TransactionStatus",{enumerable:true,get:function(){return pulsarCore.TransactionStatus}});Object.defineProperty(exports,"TransactionTracker",{enumerable:true,get:function(){return pulsarCore.TransactionTracker}});exports.PulsarModule=s;exports.Quasar=n;exports.QuasarSDKError=a;

package/dist/index.d.cts

@@ -43,7 +43,12 @@ interface HistoryQuery {
     page?: number;
     /** Number of transactions per page. Defaults to `10`. */
     limit?: number;
-    /** Chain of the transactions: an EVM chain ID (`1`) or a Solana cluster (`'mainnet'`). */
+    /**
+     * Chain of the transactions: an EVM chain ID (`1`), or a Solana chain ID — the CAIP-2 chain ID with the genesis hash
+     * that Pulsar 0.9 saves (`'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp'`, `SOLANA_CHAIN_IDS.mainnet` of
+     * `@tuwaio/orbit-core`) or `'solana:mainnet'`. The API matches a Solana cluster under both forms, so transactions
+     * synced by older Pulsar versions are found too.
+     */
     chainId?: string | number;
     /** Final status of the transactions (`'Success'`, `'Failed'` or `'Replaced'`, see `TransactionStatus`). */
     status?: string;
@@ -51,7 +56,7 @@ interface HistoryQuery {
     txKey?: string;
     /** Application name that was passed to {@link PulsarModule.syncCreate}. */
     appName?: string;
-    /** Address of the wallet that sent the transactions. */
+    /** Address of the wallet that sent the transactions. EVM addresses match in any letter case, Solana addresses exactly. */
     walletAddress?: string;
 }
 /**
@@ -203,8 +208,9 @@ declare class PulsarModule {
     /**
      * Reads the transactions of your app, newest first (`GET /v1/engine/pulsar/history`).
      *
-     * @param query - Filters and pagination. `walletAddress` is compared with the sender address exactly as it was
-     *   synced; the API returns at most 100 transactions per page.
+     * @param query - Filters and pagination. `walletAddress` matches EVM addresses in any letter case and Solana
+     *   addresses exactly; a Solana `chainId` matches its cluster under both chain ID forms. The API returns at most 100
+     *   transactions per page.
      * @returns One page of transactions.
      * @throws {QuasarSDKError} On an invalid key (401, 403), a timeout or a network error.
      *

package/dist/index.d.ts

@@ -43,7 +43,12 @@ interface HistoryQuery {
     page?: number;
     /** Number of transactions per page. Defaults to `10`. */
     limit?: number;
-    /** Chain of the transactions: an EVM chain ID (`1`) or a Solana cluster (`'mainnet'`). */
+    /**
+     * Chain of the transactions: an EVM chain ID (`1`), or a Solana chain ID — the CAIP-2 chain ID with the genesis hash
+     * that Pulsar 0.9 saves (`'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp'`, `SOLANA_CHAIN_IDS.mainnet` of
+     * `@tuwaio/orbit-core`) or `'solana:mainnet'`. The API matches a Solana cluster under both forms, so transactions
+     * synced by older Pulsar versions are found too.
+     */
     chainId?: string | number;
     /** Final status of the transactions (`'Success'`, `'Failed'` or `'Replaced'`, see `TransactionStatus`). */
     status?: string;
@@ -51,7 +56,7 @@ interface HistoryQuery {
     txKey?: string;
     /** Application name that was passed to {@link PulsarModule.syncCreate}. */
     appName?: string;
-    /** Address of the wallet that sent the transactions. */
+    /** Address of the wallet that sent the transactions. EVM addresses match in any letter case, Solana addresses exactly. */
     walletAddress?: string;
 }
 /**
@@ -203,8 +208,9 @@ declare class PulsarModule {
     /**
      * Reads the transactions of your app, newest first (`GET /v1/engine/pulsar/history`).
      *
-     * @param query - Filters and pagination. `walletAddress` is compared with the sender address exactly as it was
-     *   synced; the API returns at most 100 transactions per page.
+     * @param query - Filters and pagination. `walletAddress` matches EVM addresses in any letter case and Solana
+     *   addresses exactly; a Solana `chainId` matches its cluster under both chain ID forms. The API returns at most 100
+     *   transactions per page.
      * @returns One page of transactions.
      * @throws {QuasarSDKError} On an invalid key (401, 403), a timeout or a network error.
      *

package/dist/index.js

@@ -1 +1 @@
-import {b,c,a as a$1}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';export{TransactionStatus,TransactionTracker}from'@tuwaio/pulsar-core';var a=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 the secretKey of your Quasar app (sk_live_ or sk_test_).");this.secretKey=r.secretKey,this.internalSecret=r.internalSecret,this.baseUrl=r.baseUrl||a$1,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 a(`[Quasar SDK] Request Failed (${t}): ${p}`,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 n=class{client;pulsar;constructor(r){this.client=new o(r),this.pulsar=new s(this.client);}};export{s as PulsarModule,n as Quasar,a as QuasarSDKError};
+import {b,c,a as a$1}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';export{TransactionStatus,TransactionTracker}from'@tuwaio/pulsar-core';var a=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 the secretKey of your Quasar app (sk_live_ or sk_test_).");this.secretKey=r.secretKey,this.internalSecret=r.internalSecret,this.baseUrl=r.baseUrl||a$1,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 a(`[Quasar SDK] Request Failed (${t}): ${p}`,t,e)}};var s=class{constructor(r){this.client=r;}client;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 n=class{client;pulsar;constructor(r){this.client=new o(r),this.pulsar=new s(this.client);}};export{s as PulsarModule,n as Quasar,a as QuasarSDKError};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/quasar-sdk",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -69,8 +69,8 @@
     "ofetch": "^1.5.1"
   },
   "peerDependencies": {
-    "@tuwaio/pulsar-core": ">=0.7",
-    "@tuwaio/siwx-react": ">=0.3"
+    "@tuwaio/pulsar-core": ">=0.9",
+    "@tuwaio/siwx-react": ">=0.5"
   },
   "peerDependenciesMeta": {
     "@tuwaio/siwx-react": {
@@ -78,10 +78,10 @@
     }
   },
   "devDependencies": {
-    "@tuwaio/pulsar-core": "^0.8.3",
+    "@tuwaio/pulsar-core": "^0.9.1",
     "tsup": "^8.5.1",
     "typescript": "6.0.3",
-    "@tuwaio/siwx-react": "^0.4.1"
+    "@tuwaio/siwx-react": "^0.6.0"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",