@caatinga/client 2.1.0 → 2.2.1

package/dist/stellar-wallets-kit.cjs

@@ -20,81 +20,94 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/stellar-wallets-kit.ts
 var stellar_wallets_kit_exports = {};
 __export(stellar_wallets_kit_exports, {
-  WalletNetwork: () => import_stellar_wallets_kit.WalletNetwork,
+  WalletNetwork: () => import_types.Networks,
   createStellarWalletsKitAdapter: () => createStellarWalletsKitAdapter
 });
 module.exports = __toCommonJS(stellar_wallets_kit_exports);
 
 // src/adapters/stellar-wallets-kit.ts
-var import_stellar_wallets_kit = require("@creit.tech/stellar-wallets-kit");
-var import_walletconnect = require("@creit.tech/stellar-wallets-kit/modules/walletconnect.module");
+var import_sdk = require("@creit.tech/stellar-wallets-kit/sdk");
+var import_types = require("@creit.tech/stellar-wallets-kit/types");
+var import_utils = require("@creit.tech/stellar-wallets-kit/modules/utils");
+var import_freighter = require("@creit.tech/stellar-wallets-kit/modules/freighter");
+var import_hotwallet = require("@creit.tech/stellar-wallets-kit/modules/hotwallet");
+var import_wallet_connect = require("@creit.tech/stellar-wallets-kit/modules/wallet-connect");
+var kitInitialized = false;
 function createStellarWalletsKitAdapter(options = {}) {
-  const network = options.network ?? import_stellar_wallets_kit.WalletNetwork.TESTNET;
-  const kit = options.kit ?? new import_stellar_wallets_kit.StellarWalletsKit({
-    network,
-    selectedWalletId: options.selectedWalletId ?? import_stellar_wallets_kit.FREIGHTER_ID,
-    modules: options.modules ?? buildModules(network, options.walletConnectMetadata)
-  });
+  const network = options.network ?? import_types.Networks.TESTNET;
+  if (!kitInitialized) {
+    import_sdk.StellarWalletsKit.init({
+      network,
+      selectedWalletId: options.selectedWalletId ?? import_freighter.FREIGHTER_ID,
+      modules: options.modules ?? buildModules(options.walletConnectMetadata),
+      ...options.initParams
+    });
+    kitInitialized = true;
+  } else if (options.network !== void 0) {
+    import_sdk.StellarWalletsKit.setNetwork(network);
+  }
   let address;
   return {
-    kit,
+    kit: import_sdk.StellarWalletsKit,
     setWallet(walletId) {
-      kit.setWallet(walletId);
+      import_sdk.StellarWalletsKit.setWallet(walletId);
       address = void 0;
     },
+    getWalletId() {
+      try {
+        return import_sdk.StellarWalletsKit.selectedModule.productId;
+      } catch {
+        return void 0;
+      }
+    },
     getSupportedWallets() {
-      return kit.getSupportedWallets();
+      return import_sdk.StellarWalletsKit.refreshSupportedWallets();
     },
-    openModal(modalOptions = {}) {
-      return new Promise((resolve, reject) => {
-        void kit.openModal({
-          ...modalOptions.modalTitle ? { modalTitle: modalOptions.modalTitle } : {},
-          ...modalOptions.notAvailableText ? { notAvailableText: modalOptions.notAvailableText } : {},
-          onWalletSelected: (option) => {
-            kit.setWallet(option.id);
-            kit.getAddress().then((result) => {
-              address = result.address;
-              resolve(result.address);
-            }).catch((error) => {
-              reject(error instanceof Error ? error : new Error(String(error)));
-            });
-          },
-          onClosed: (error) => {
-            modalOptions.onClosed?.(error);
-            reject(error);
-          }
-        });
-      });
+    async openModal(modalOptions = {}) {
+      try {
+        const result = await import_sdk.StellarWalletsKit.authModal();
+        address = result.address;
+        return result.address;
+      } catch (error) {
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        modalOptions.onClosed?.(normalized);
+        throw normalized;
+      }
     },
     async getPublicKey() {
-      const result = await kit.getAddress();
-      address = result.address;
-      return result.address;
+      try {
+        const cached = await import_sdk.StellarWalletsKit.getAddress();
+        address = cached.address;
+        return cached.address;
+      } catch {
+        const fetched = await import_sdk.StellarWalletsKit.fetchAddress();
+        address = fetched.address;
+        return fetched.address;
+      }
     },
     async signTransaction({ xdr, networkPassphrase }) {
-      const result = await kit.signTransaction(xdr, {
+      const result = await import_sdk.StellarWalletsKit.signTransaction(xdr, {
         networkPassphrase,
         ...address ? { address } : {}
       });
       return result.signedTxXdr;
     },
     async disconnect() {
-      await kit.disconnect();
+      await import_sdk.StellarWalletsKit.disconnect();
       address = void 0;
     }
   };
 }
-var HOTWALLET_ID = "hot-wallet";
-function buildModules(network, walletConnectMetadata) {
-  const modules = (0, import_stellar_wallets_kit.allowAllModules)({
-    filterBy: (module2) => module2.productId !== HOTWALLET_ID
+function buildModules(walletConnectMetadata) {
+  const modules = (0, import_utils.defaultModules)({
+    filterBy: (module2) => module2.productId !== import_hotwallet.HOTWALLET_ID
   });
   if (walletConnectMetadata) {
+    const { projectId, name, description, url, icons } = walletConnectMetadata;
     modules.push(
-      new import_walletconnect.WalletConnectModule({
-        ...walletConnectMetadata,
-        network,
-        method: import_walletconnect.WalletConnectAllowedMethods.SIGN
+      new import_wallet_connect.WalletConnectModule({
+        projectId,
+        metadata: { name, description, url, icons }
       })
     );
   }

package/dist/stellar-wallets-kit.d.cts

@@ -1,5 +1,6 @@
-import { StellarWalletsKit, ISupportedWallet, WalletNetwork, ModuleInterface } from '@creit.tech/stellar-wallets-kit';
-export { WalletNetwork } from '@creit.tech/stellar-wallets-kit';
+import { StellarWalletsKit } from '@creit.tech/stellar-wallets-kit/sdk';
+import { ISupportedWallet, Networks, ModuleInterface, StellarWalletsKitInitParams } from '@creit.tech/stellar-wallets-kit/types';
+export { Networks as WalletNetwork } from '@creit.tech/stellar-wallets-kit/types';
 import { C as CaatingaWalletAdapter } from './types-D4XEyX4J.cjs';
 import '@caatinga/core/browser';
 
@@ -15,13 +16,14 @@ interface StellarWalletsKitMetadata {
     projectId: string;
 }
 interface StellarWalletsKitAdapterOptions {
-    kit?: StellarWalletsKit;
-    network?: WalletNetwork;
+    network?: Networks;
     /** Wallet pre-selected before the user opens the modal. Defaults to Freighter. */
     selectedWalletId?: string;
     /** Override the registered modules. Defaults to every auto-detectable wallet. */
     modules?: ModuleInterface[];
     walletConnectMetadata?: StellarWalletsKitMetadata;
+    /** Extra SWK init options (theme, authModal flags, etc.). */
+    initParams?: Omit<StellarWalletsKitInitParams, "modules" | "network" | "selectedWalletId">;
 }
 interface StellarWalletsKitOpenModalOptions {
     modalTitle?: string;
@@ -29,7 +31,8 @@ interface StellarWalletsKitOpenModalOptions {
     onClosed?: (error: Error) => void;
 }
 interface StellarWalletsKitAdapter extends CaatingaWalletAdapter {
-    kit: StellarWalletsKit;
+    /** SWK 2.x uses static methods on this class (no per-app instance). */
+    kit: typeof StellarWalletsKit;
     /**
      * Opens the wallet-selection modal (lists only installed/available wallets),
      * sets the chosen wallet as active, and resolves with the connected address.
@@ -37,6 +40,8 @@ interface StellarWalletsKitAdapter extends CaatingaWalletAdapter {
      */
     openModal(options?: StellarWalletsKitOpenModalOptions): Promise<string>;
     setWallet(walletId: string): void;
+    /** Id of the wallet currently selected in the kit, or undefined before any selection. */
+    getWalletId(): string | undefined;
     getSupportedWallets(): Promise<ISupportedWallet[]>;
     disconnect(): Promise<void>;
 }

package/dist/stellar-wallets-kit.d.ts

@@ -1,5 +1,6 @@
-import { StellarWalletsKit, ISupportedWallet, WalletNetwork, ModuleInterface } from '@creit.tech/stellar-wallets-kit';
-export { WalletNetwork } from '@creit.tech/stellar-wallets-kit';
+import { StellarWalletsKit } from '@creit.tech/stellar-wallets-kit/sdk';
+import { ISupportedWallet, Networks, ModuleInterface, StellarWalletsKitInitParams } from '@creit.tech/stellar-wallets-kit/types';
+export { Networks as WalletNetwork } from '@creit.tech/stellar-wallets-kit/types';
 import { C as CaatingaWalletAdapter } from './types-D4XEyX4J.js';
 import '@caatinga/core/browser';
 
@@ -15,13 +16,14 @@ interface StellarWalletsKitMetadata {
     projectId: string;
 }
 interface StellarWalletsKitAdapterOptions {
-    kit?: StellarWalletsKit;
-    network?: WalletNetwork;
+    network?: Networks;
     /** Wallet pre-selected before the user opens the modal. Defaults to Freighter. */
     selectedWalletId?: string;
     /** Override the registered modules. Defaults to every auto-detectable wallet. */
     modules?: ModuleInterface[];
     walletConnectMetadata?: StellarWalletsKitMetadata;
+    /** Extra SWK init options (theme, authModal flags, etc.). */
+    initParams?: Omit<StellarWalletsKitInitParams, "modules" | "network" | "selectedWalletId">;
 }
 interface StellarWalletsKitOpenModalOptions {
     modalTitle?: string;
@@ -29,7 +31,8 @@ interface StellarWalletsKitOpenModalOptions {
     onClosed?: (error: Error) => void;
 }
 interface StellarWalletsKitAdapter extends CaatingaWalletAdapter {
-    kit: StellarWalletsKit;
+    /** SWK 2.x uses static methods on this class (no per-app instance). */
+    kit: typeof StellarWalletsKit;
     /**
      * Opens the wallet-selection modal (lists only installed/available wallets),
      * sets the chosen wallet as active, and resolves with the connected address.
@@ -37,6 +40,8 @@ interface StellarWalletsKitAdapter extends CaatingaWalletAdapter {
      */
     openModal(options?: StellarWalletsKitOpenModalOptions): Promise<string>;
     setWallet(walletId: string): void;
+    /** Id of the wallet currently selected in the kit, or undefined before any selection. */
+    getWalletId(): string | undefined;
     getSupportedWallets(): Promise<ISupportedWallet[]>;
     disconnect(): Promise<void>;
 }

package/dist/stellar-wallets-kit.js

@@ -1,87 +1,94 @@
 // src/adapters/stellar-wallets-kit.ts
+import { StellarWalletsKit } from "@creit.tech/stellar-wallets-kit/sdk";
 import {
-  StellarWalletsKit,
-  WalletNetwork,
-  allowAllModules,
-  FREIGHTER_ID
-} from "@creit.tech/stellar-wallets-kit";
-import {
-  WalletConnectAllowedMethods,
-  WalletConnectModule
-} from "@creit.tech/stellar-wallets-kit/modules/walletconnect.module";
+  Networks
+} from "@creit.tech/stellar-wallets-kit/types";
+import { defaultModules } from "@creit.tech/stellar-wallets-kit/modules/utils";
+import { FREIGHTER_ID } from "@creit.tech/stellar-wallets-kit/modules/freighter";
+import { HOTWALLET_ID } from "@creit.tech/stellar-wallets-kit/modules/hotwallet";
+import { WalletConnectModule } from "@creit.tech/stellar-wallets-kit/modules/wallet-connect";
+var kitInitialized = false;
 function createStellarWalletsKitAdapter(options = {}) {
-  const network = options.network ?? WalletNetwork.TESTNET;
-  const kit = options.kit ?? new StellarWalletsKit({
-    network,
-    selectedWalletId: options.selectedWalletId ?? FREIGHTER_ID,
-    modules: options.modules ?? buildModules(network, options.walletConnectMetadata)
-  });
+  const network = options.network ?? Networks.TESTNET;
+  if (!kitInitialized) {
+    StellarWalletsKit.init({
+      network,
+      selectedWalletId: options.selectedWalletId ?? FREIGHTER_ID,
+      modules: options.modules ?? buildModules(options.walletConnectMetadata),
+      ...options.initParams
+    });
+    kitInitialized = true;
+  } else if (options.network !== void 0) {
+    StellarWalletsKit.setNetwork(network);
+  }
   let address;
   return {
-    kit,
+    kit: StellarWalletsKit,
     setWallet(walletId) {
-      kit.setWallet(walletId);
+      StellarWalletsKit.setWallet(walletId);
       address = void 0;
     },
+    getWalletId() {
+      try {
+        return StellarWalletsKit.selectedModule.productId;
+      } catch {
+        return void 0;
+      }
+    },
     getSupportedWallets() {
-      return kit.getSupportedWallets();
+      return StellarWalletsKit.refreshSupportedWallets();
     },
-    openModal(modalOptions = {}) {
-      return new Promise((resolve, reject) => {
-        void kit.openModal({
-          ...modalOptions.modalTitle ? { modalTitle: modalOptions.modalTitle } : {},
-          ...modalOptions.notAvailableText ? { notAvailableText: modalOptions.notAvailableText } : {},
-          onWalletSelected: (option) => {
-            kit.setWallet(option.id);
-            kit.getAddress().then((result) => {
-              address = result.address;
-              resolve(result.address);
-            }).catch((error) => {
-              reject(error instanceof Error ? error : new Error(String(error)));
-            });
-          },
-          onClosed: (error) => {
-            modalOptions.onClosed?.(error);
-            reject(error);
-          }
-        });
-      });
+    async openModal(modalOptions = {}) {
+      try {
+        const result = await StellarWalletsKit.authModal();
+        address = result.address;
+        return result.address;
+      } catch (error) {
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        modalOptions.onClosed?.(normalized);
+        throw normalized;
+      }
     },
     async getPublicKey() {
-      const result = await kit.getAddress();
-      address = result.address;
-      return result.address;
+      try {
+        const cached = await StellarWalletsKit.getAddress();
+        address = cached.address;
+        return cached.address;
+      } catch {
+        const fetched = await StellarWalletsKit.fetchAddress();
+        address = fetched.address;
+        return fetched.address;
+      }
     },
     async signTransaction({ xdr, networkPassphrase }) {
-      const result = await kit.signTransaction(xdr, {
+      const result = await StellarWalletsKit.signTransaction(xdr, {
         networkPassphrase,
         ...address ? { address } : {}
       });
       return result.signedTxXdr;
     },
     async disconnect() {
-      await kit.disconnect();
+      await StellarWalletsKit.disconnect();
       address = void 0;
     }
   };
 }
-var HOTWALLET_ID = "hot-wallet";
-function buildModules(network, walletConnectMetadata) {
-  const modules = allowAllModules({
+function buildModules(walletConnectMetadata) {
+  const modules = defaultModules({
     filterBy: (module) => module.productId !== HOTWALLET_ID
   });
   if (walletConnectMetadata) {
+    const { projectId, name, description, url, icons } = walletConnectMetadata;
     modules.push(
       new WalletConnectModule({
-        ...walletConnectMetadata,
-        network,
-        method: WalletConnectAllowedMethods.SIGN
+        projectId,
+        metadata: { name, description, url, icons }
       })
     );
   }
   return modules;
 }
 export {
-  WalletNetwork,
+  Networks as WalletNetwork,
   createStellarWalletsKitAdapter
 };

package/dist/wallet-session-DeLp8S1c.d.ts

@@ -0,0 +1,56 @@
+import { C as CaatingaWalletAdapter } from './types-D4XEyX4J.js';
+
+/**
+ * Optional adapter capabilities the session takes advantage of when present.
+ * The minimal {@link CaatingaWalletAdapter} contract stays untouched: adapters
+ * that only implement `getPublicKey`/`signTransaction` (e.g. Freighter) work,
+ * richer adapters (e.g. Stellar Wallets Kit) get modal-based connect, real
+ * disconnect, and wallet-id persistence for free.
+ */
+interface CaatingaWalletCapabilities {
+    openModal?(): Promise<string>;
+    disconnect?(): Promise<void>;
+    setWallet?(walletId: string): void;
+    getWalletId?(): string | undefined;
+}
+type WalletSessionStatus = "disconnected" | "connecting" | "connected";
+interface WalletSessionState {
+    status: WalletSessionStatus;
+    publicKey: string | null;
+    error: Error | null;
+}
+/** Minimal storage contract so tests and non-browser hosts can inject their own. */
+interface WalletSessionStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+interface WalletSessionOptions {
+    /** Persist the connection across page loads so `restore()` can reconnect silently. */
+    persist?: boolean;
+    /** Storage backend for persistence. Defaults to `window.localStorage` when available. */
+    storage?: WalletSessionStorage;
+    /** Persistence key. Defaults to {@link WALLET_SESSION_STORAGE_KEY}. */
+    storageKey?: string;
+    /** Optional timeout (ms) applied to connect/restore wallet calls. */
+    timeout?: number;
+}
+interface WalletSession {
+    adapter: CaatingaWalletAdapter;
+    getState(): WalletSessionState;
+    /** Subscribe to state transitions. Returns an unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    /** Connect via the adapter modal when available, else `getPublicKey()`. */
+    connect(): Promise<string>;
+    disconnect(): Promise<void>;
+    /**
+     * Silent reconnect from persisted state. Resolves the public key on success,
+     * `null` when nothing was persisted or reconnection failed — never rejects
+     * and never sets `state.error` (no error toast on page load).
+     */
+    restore(): Promise<string | null>;
+}
+declare const WALLET_SESSION_STORAGE_KEY = "caatinga:wallet-session";
+declare function createWalletSession(adapter: CaatingaWalletAdapter, options?: WalletSessionOptions): WalletSession;
+
+export { type CaatingaWalletCapabilities as C, WALLET_SESSION_STORAGE_KEY as W, type WalletSession as a, type WalletSessionOptions as b, type WalletSessionState as c, type WalletSessionStatus as d, type WalletSessionStorage as e, createWalletSession as f };

package/dist/wallet-session-ed2Dgs9A.d.cts

@@ -0,0 +1,56 @@
+import { C as CaatingaWalletAdapter } from './types-D4XEyX4J.cjs';
+
+/**
+ * Optional adapter capabilities the session takes advantage of when present.
+ * The minimal {@link CaatingaWalletAdapter} contract stays untouched: adapters
+ * that only implement `getPublicKey`/`signTransaction` (e.g. Freighter) work,
+ * richer adapters (e.g. Stellar Wallets Kit) get modal-based connect, real
+ * disconnect, and wallet-id persistence for free.
+ */
+interface CaatingaWalletCapabilities {
+    openModal?(): Promise<string>;
+    disconnect?(): Promise<void>;
+    setWallet?(walletId: string): void;
+    getWalletId?(): string | undefined;
+}
+type WalletSessionStatus = "disconnected" | "connecting" | "connected";
+interface WalletSessionState {
+    status: WalletSessionStatus;
+    publicKey: string | null;
+    error: Error | null;
+}
+/** Minimal storage contract so tests and non-browser hosts can inject their own. */
+interface WalletSessionStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+interface WalletSessionOptions {
+    /** Persist the connection across page loads so `restore()` can reconnect silently. */
+    persist?: boolean;
+    /** Storage backend for persistence. Defaults to `window.localStorage` when available. */
+    storage?: WalletSessionStorage;
+    /** Persistence key. Defaults to {@link WALLET_SESSION_STORAGE_KEY}. */
+    storageKey?: string;
+    /** Optional timeout (ms) applied to connect/restore wallet calls. */
+    timeout?: number;
+}
+interface WalletSession {
+    adapter: CaatingaWalletAdapter;
+    getState(): WalletSessionState;
+    /** Subscribe to state transitions. Returns an unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    /** Connect via the adapter modal when available, else `getPublicKey()`. */
+    connect(): Promise<string>;
+    disconnect(): Promise<void>;
+    /**
+     * Silent reconnect from persisted state. Resolves the public key on success,
+     * `null` when nothing was persisted or reconnection failed — never rejects
+     * and never sets `state.error` (no error toast on page load).
+     */
+    restore(): Promise<string | null>;
+}
+declare const WALLET_SESSION_STORAGE_KEY = "caatinga:wallet-session";
+declare function createWalletSession(adapter: CaatingaWalletAdapter, options?: WalletSessionOptions): WalletSession;
+
+export { type CaatingaWalletCapabilities as C, WALLET_SESSION_STORAGE_KEY as W, type WalletSession as a, type WalletSessionOptions as b, type WalletSessionState as c, type WalletSessionStatus as d, type WalletSessionStorage as e, createWalletSession as f };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/client",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Browser and Node client for Soroban smart contracts — connects generated bindings, Caatinga artifacts, and wallet adapters",
   "keywords": [
     "stellar",
@@ -43,6 +43,11 @@
       "types": "./dist/stellar-wallets-kit.d.ts",
       "import": "./dist/stellar-wallets-kit.js",
       "require": "./dist/stellar-wallets-kit.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
     }
   },
   "files": [
@@ -51,17 +56,24 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@caatinga/core": "^2.1.0"
+    "@caatinga/core": "^2.2.1"
   },
   "devDependencies": {
     "tsup": "^8.3.5",
-    "@creit.tech/stellar-wallets-kit": "^1.9.5",
+    "@creit.tech/stellar-wallets-kit": "^2.3.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^18.3.18",
+    "jsdom": "^25.0.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },
   "peerDependencies": {
     "@stellar/freighter-api": "^4.0.0",
-    "@creit.tech/stellar-wallets-kit": "^1.9.5"
+    "@creit.tech/stellar-wallets-kit": "^2.3.0",
+    "react": ">=18"
   },
   "peerDependenciesMeta": {
     "@stellar/freighter-api": {
@@ -69,10 +81,13 @@
     },
     "@creit.tech/stellar-wallets-kit": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts src/freighter.ts src/stellar-wallets-kit.ts --format esm,cjs --dts",
+    "build": "tsup src/index.ts src/freighter.ts src/stellar-wallets-kit.ts src/react.ts --format esm,cjs --dts",
     "test": "vitest run --pool=threads",
     "pretypecheck": "pnpm --filter @caatinga/core run build",
     "typecheck": "tsc --noEmit"