@fivenorth/loop-sdk 0.7.5 → 0.8.0

package/README.md

@@ -29,7 +29,7 @@ import { loop } from '@fivenorth/loop-sdk';
 Note that, If you don't want to implement a build process, you can include the file directly with `unpkg` such as 
 
 ```javascript
-import { loop } from 'https://unpkg.com/@fivenorth/loop-sdk@0.1.1/dist';
+import { loop } from 'https://unpkg.com/@fivenorth/loop-sdk@0.8.0/dist';
 ```
 
 An example of how we use it in that manner is on our [loopsdk demo](https://codepen.io/kureikain/pen/KwVGgLX)
@@ -42,6 +42,9 @@ Before you can connect, you need to initialize the SDK. This is typically done o
 loop.init({
     appName: 'My Awesome dApp',
     network: 'local', // or 'devnet', 'mainnet'
+    onTransactionUpdate: (payload) => {
+        console.log('Transaction update:', payload);
+    },
     options: {
         openMode: 'popup', // 'popup' (default) or 'tab'
         requestSigningMode: 'popup', // 'popup' (default) or 'tab'
@@ -60,6 +63,7 @@ loop.init({
 The `init` method takes a configuration object with the following properties:
 - `appName`: The name of your application, which will be displayed to the user in the Loop wallet.
 - `network`: The network to connect to. Can be `local`, `devnet`, or `mainnet`.
+- `onTransactionUpdate`: Called when a transaction update is finalized (includes `update_id` and optional `update_data`).
 - `options`: Optional object containing:
   - `openMode`: Controls how Loop opens: `'popup'` (default) or `'tab'`.
   - `requestSigningMode`: Controls how signing/transaction requests open the wallet UI after you're connected: `'popup'` (default) or `'tab'`.
@@ -145,6 +149,8 @@ try {
 }
 ```
 
+Transaction responses include `command_id`, `submission_id`, `transaction_data`, and `update_id` when available. For token transfers, `update_id` may arrive later (once indexed), in which case `onTransactionUpdate` fires with the finalized `update_id`. Non-transfer transactions do not receive an `update_id` via this mechanism.
+
 #### Sign a Message
 
 You can request the user to sign an arbitrary message:

package/dist/index.js

@@ -2321,7 +2321,7 @@ var MessageType;
   MessageType2["HANDSHAKE_ACCEPT"] = "handshake_accept";
   MessageType2["HANDSHAKE_REJECT"] = "handshake_reject";
   MessageType2["RUN_TRANSACTION"] = "run_transaction";
-  MessageType2["RUN_TRANSACTION_RESPONSE"] = "run_transaction_response";
+  MessageType2["TRANSACTION_COMPLETED"] = "transaction_completed";
   MessageType2["SIGN_RAW_MESSAGE"] = "sign_raw_message";
   MessageType2["SIGN_RAW_MESSAGE_RESPONSE"] = "sign_raw_message_response";
   MessageType2["REJECT_REQUEST"] = "reject_request";
@@ -2375,6 +2375,9 @@ class Provider {
   }
   handleResponse(message) {
     console.log("Received response:", message);
+    if (message?.type === "transaction_completed" /* TRANSACTION_COMPLETED */ && message?.payload?.update_id) {
+      this.hooks?.onTransactionUpdate?.(message.payload, message);
+    }
     if (message.request_id) {
       this.requests.set(message.request_id, message);
     }
@@ -2694,7 +2697,7 @@ class LoopWallet {
 
 // src/index.ts
 class LoopSDK {
-  version = "0.7.5";
+  version = "0.7.6";
   appName = "Unknown";
   connection = null;
   session = null;
@@ -2705,6 +2708,7 @@ class LoopSDK {
   redirectUrl;
   onAccept = null;
   onReject = null;
+  onTransactionUpdate = null;
   overlay = null;
   wallet;
   constructor() {
@@ -2717,6 +2721,7 @@ class LoopSDK {
     apiUrl,
     onAccept,
     onReject,
+    onTransactionUpdate,
     options
   }) {
     if (typeof window === "undefined" || typeof document === "undefined" || typeof localStorage === "undefined") {
@@ -2725,6 +2730,7 @@ class LoopSDK {
     this.appName = appName;
     this.onAccept = onAccept || null;
     this.onReject = onReject || null;
+    this.onTransactionUpdate = onTransactionUpdate || null;
     const resolvedOptions = {
       openMode: "popup",
       requestSigningMode: "popup",
@@ -2859,6 +2865,12 @@ class LoopSDK {
       this.provider.handleResponse(message);
     }
   }
+  getConnectUrl() {
+    if (!this.session?.ticketId) {
+      throw new Error("No ticket ID found. Please call connect() first.");
+    }
+    return this.buildConnectUrl(this.session.ticketId);
+  }
   buildConnectUrl(ticketId) {
     const url = new URL("/.connect/", this.connection.walletUrl);
     url.searchParams.set("ticketId", ticketId);
@@ -3109,7 +3121,8 @@ class LoopSDK {
             this.closePopupIfExists();
           }, 800);
         }
-      }
+      },
+      onTransactionUpdate: this.onTransactionUpdate ?? undefined
     };
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fivenorth/loop-sdk",
-	"version": "0.7.5",
+	"version": "0.8.0",
 	"author": "support@fivenorth.io",
 	"main": "dist/index.js",
 	"module": "dist/index.js",