@notabene/javascript-sdk 2.9.0-next.1 → 2.9.0-next.2

package/dist/cjs/notabene.cjs

@@ -1 +1 @@
-"use strict";var N=Object.defineProperty;var U=(t,e,n)=>e in t?N(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n;var a=(t,e,n)=>U(t,typeof e!="symbol"?e+"":e,n);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var p=(t=>(t.PRIVATE="WALLET",t.VASP="VASP",t))(p||{}),E=(t=>(t.NATURAL="natural",t.LEGAL="legal",t.SELF="self",t))(E||{}),f=(t=>(t.EMPTY="empty",t.VERIFY="verify",t.PENDING="pending",t.VERIFIED="verified",t.BANNED="banned",t))(f||{}),w=(t=>(t.ALLOWED="allowed",t.PENDING="pending",t))(w||{}),v=(t=>(t.ASSET="asset",t.DESTINATION="destination",t.COUNTERPARTY="counterparty",t.AGENT="agent",t))(v||{}),l=(t=>(t.COMPLETE="complete",t.RESIZE="resize",t.RESULT="result",t.READY="ready",t.INVALID="invalid",t.ERROR="error",t.CANCEL="cancel",t))(l||{}),g=(t=>(t.SERVICE_UNAVAILABLE="SERVICE_UNAVAILABLE",t.WALLET_CONNECTION_FAILED="WALLET_CONNECTION_FAILED",t.WALLET_NOT_SUPPORTED="WALLET_NOT_SUPPORTED",t.TOKEN_INVALID="TOKEN_INVALID",t))(g||{}),d=(t=>(t.UPDATE="update",t.REQUEST_RESPONSE="requestResponse",t))(d||{}),A=(t=>(t.PENDING="pending",t.FAILED="rejected",t.FLAGGED="flagged",t.VERIFIED="verified",t))(A||{}),y=(t=>(t.SelfDeclaration="self-declaration",t.SIWE="siwe",t.SIWX="siwx",t.EIP191="eip-191",t.EIP712="eip-712",t.EIP1271="eip-1271",t.BIP137="bip-137",t.BIP322="bip-322",t.BIP137_XPUB="xpub",t.TIP191="tip-191",t.ED25519="ed25519",t.XRP_ED25519="xrp-ed25519",t.XLM_ED25519="xlm-ed25519",t.CIP8="cip-8",t.MicroTransfer="microtransfer",t.Screenshot="screenshot",t.Connect="connect",t))(y||{});class _{constructor(){a(this,"listeners",new Map);a(this,"port");this.handleMessage=this.handleMessage.bind(this)}setPort(e){this.port=e,this.port.onmessage=this.handleMessage,this.port.start()}on(e,n){return this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(n),()=>this.off(e,n)}off(e,n){const r=this.listeners.get(e);r&&(r.delete(n),r.size===0&&this.listeners.delete(e))}handleMessage(e){const n=e.data;if(typeof n=="object"&&n!==null&&"type"in n){const r=n.type,i=this.listeners.get(r);i&&i.forEach(s=>s(n))}}send(e){this.port&&this.port.postMessage(e)}}class C{constructor(e,n,r){a(this,"_url");a(this,"_value");a(this,"_options");a(this,"_errors",[]);a(this,"iframe");a(this,"eventManager");a(this,"modal");this._url=e,this._value=n,this._options=r,this.eventManager=new _,this.on(l.INVALID,i=>{i.type===l.INVALID&&(this._errors=i.errors,this._value=i.value)}),this.on(l.RESIZE,i=>{i.type===l.RESIZE&&this.iframe&&(this.iframe.style.height=`${i.height}px`)})}get url(){return this._url}get value(){return this._value}get options(){return this._options}get errors(){return this._errors}open(){document.location.href=this.url}mount(e){const n=document.querySelector(e);if(!n)throw new Error(`parentID ${e} not found`);this.embed(n)}embed(e,n=!1){var r,i;this.removeEmbed(),this.iframe=document.createElement("iframe"),this.iframe.src=this.url+(n?"":"&embedded=true"),this.iframe.allow="web-share; clipboard-write; hid; bluetooth;",this.iframe.style.width="100%",this.iframe.style.height="0px",this.iframe.style.border="none",this.iframe.style.overflow="hidden",this.iframe.scrolling="no",e.appendChild(this.iframe),window.addEventListener("message",s=>{var o,c;s.source===((o=this.iframe)==null?void 0:o.contentWindow)&&((c=this.eventManager)==null||c.setPort(s.ports[0]))}),(i=(r=this.iframe)==null?void 0:r.contentWindow)==null||i.focus()}removeEmbed(){this.iframe&&this.iframe.remove()}send(e){this.eventManager.send(e)}on(e,n){return this.eventManager.on(e,n)}off(e,n){this.eventManager.off(e,n)}update(e,n){this._value=e,n&&(this._options=n),this.send({type:d.UPDATE,value:e,options:this._options})}completion(){return new Promise((e,n)=>{let r,i,s;function o(){r&&r(),i&&i(),s&&s()}r=this.on(l.COMPLETE,c=>{e(c.response),o()}),i=this.on(l.CANCEL,()=>{n(new Error("User cancelled")),o()}),s=this.on("error",c=>{n(new Error(c.message)),o()})})}async openModal(){this.modal&&this.closeModal(),this.modal=document.createElement("dialog"),this.modal.style.border="none",this.modal.style.backgroundColor="white",this.modal.style.maxWidth="100vw",this.modal.style.maxHeight="100vh",this.modal.style.width="600px",this.modal.style.height="600px",document.body.appendChild(this.modal),this.embed(this.modal,!0);const e=this.on(l.CANCEL,()=>{this.closeModal()}),n=this.on(l.COMPLETE,()=>{this.closeModal()});return this.modal.showModal(),this.modal.addEventListener("click",()=>{this.closeModal()}),this.completion().finally(()=>{e(),n()})}closeModal(){var e;this.modal&&((e=this.modal)==null||e.close(),this.modal.remove(),this.modal=void 0)}async popup(){const e=window.open(this.url,"_blank","popup=true,width=600,height=600");window.addEventListener("message",i=>{var s;i.source===e&&(console.log("received message from popup",i.data),(s=this.eventManager)==null||s.setPort(i.ports[0]))});const n=this.on(l.CANCEL,()=>{e==null||e.close()}),r=this.on(l.COMPLETE,()=>{e==null||e.close()});return this.completion().finally(()=>{n(),r()})}}function S(t){return Object.entries(t).map(([e,n])=>{if(n==null)return;const r=encodeURIComponent(e),i=encodeURIComponent(typeof n=="object"?JSON.stringify(n):String(n));return`${r}=${i}`}).filter(e=>e!==void 0).join("&")}function M(t){const e=t.slice(1);return e?e.split("&").filter(Boolean).reduce((r,i)=>{const[s,o]=i.split("=");return s&&(r[decodeURIComponent(s)]=o?decodeURIComponent(o):""),r},{}):{}}async function u(t){const e=JSON.stringify(t),n=new TextEncoder,r=crypto.getRandomValues(new Uint8Array(32)),i=await crypto.subtle.importKey("raw",r,{name:"AES-GCM"},!1,["encrypt"]),s=crypto.getRandomValues(new Uint8Array(12)),o=await crypto.subtle.encrypt({name:"AES-GCM",iv:s},i,n.encode(e));return{ciphertext:`${h(s)}-${h(o)}`,key:h(r)}}async function O({ciphertext:t,key:e}){const[n,r]=t.split("-"),i=new Uint8Array(atob(e).split("").map(L=>L.charCodeAt(0))),s=m(n),o=m(r),c=await crypto.subtle.importKey("raw",i,{name:"AES-GCM"},!1,["decrypt"]),b=new TextDecoder,I=await crypto.subtle.decrypt({name:"AES-GCM",iv:new Uint8Array(s)},c,o);return JSON.parse(b.decode(I))}function h(t){const e=new Uint8Array(t);let n="";for(let r=0;r<e.length;r++)n+=String.fromCharCode(e[r]);return btoa(n)}function m(t){const e=atob(t),n=new Uint8Array(e.length);for(let r=0;r<e.length;r++)n[r]=e.charCodeAt(r);return n}class D{constructor(e){a(this,"endpoint");this.endpoint=e}async create(e,n){const r=await u(e),i={metadata:n,sealed:r.ciphertext},s=await fetch(this.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(i)});if(!s.ok)throw new Error(`Failed to create connection: ${await s.text()}`);const o=await s.json();return{id:o.id,version:o.version,metadata:n,data:e,key:r.key}}async update(e,n,r){const i=await u(n),s={sealed:i.ciphertext,version:r},o=await fetch(`${this.endpoint}/${e}`,{method:"PATCH",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)});if(!o.ok)throw new Error(`Failed to update connection: ${await o.text()}`);const c=await o.json();return{id:c.id,metadata:c.metadata,version:c.version,data:n,key:i.key}}async get(e,n){const r=await fetch(`${this.endpoint}/${e}`,{method:"GET"});if(!r.ok)throw new Error(`Failed to get connection: ${await r.text()}`);const i=await r.json(),s=i.sealed[i.sealed.length-1],o=await O({ciphertext:s,key:n});return{id:i.id,version:i.version,metadata:i.metadata,data:o,key:n}}async close(e){const n=await fetch(`${this.endpoint}/${e}`,{method:"DELETE"});if(!n.ok)throw new Error(`Failed to close connection: ${await n.text()}`)}}class R{constructor(e){a(this,"nodeUrl");a(this,"authToken");a(this,"uxUrl");a(this,"theme");a(this,"locale");this.uxUrl=e.uxUrl||"https://connect.notabene.id",this.nodeUrl=e.nodeUrl,this.authToken=e.authToken,this.theme=e.theme,this.locale=e.locale}componentUrl(e,n,r,i){const s=new URL(this.uxUrl);s.pathname=e;const o=S({authToken:this.authToken,value:n,configuration:r});return s.hash=o,this.nodeUrl&&s.searchParams.set("nodeUrl",this.nodeUrl),this.theme&&s.searchParams.set("theme",JSON.stringify(this.theme)),this.locale&&s.searchParams.set("locale",this.locale),i&&(i.callback&&s.searchParams.set("callback_url",i.callback),i.redirectUri&&s.searchParams.set("redirect_uri",i.redirectUri)),s.toString()}createComponent(e,n,r,i){return new C(this.componentUrl(e,n,r,i),n,r)}createWithdrawalAssist(e,n,r){return this.createComponent("withdrawal-assist",e,n,r)}createConnectWallet(e,n,r){return this.createComponent("connect",e,n,r)}createDepositRequest(e,n,r){return this.createComponent("deposit-request",e,n,r)}createDepositAssist(e,n,r){return this.createComponent("deposit-assist",e,n,r)}}exports.AgentType=p;exports.CMType=l;exports.ConnectionManager=D;exports.EmbeddedComponent=C;exports.ErrorIdentifierCode=g;exports.HMType=d;exports.PersonType=E;exports.ProofStatus=A;exports.ProofTypes=y;exports.Status=f;exports.VASPSearchControl=w;exports.ValidationSections=v;exports.decodeFragmentToObject=M;exports.default=R;
+"use strict";var U=Object.defineProperty;var _=(t,e,n)=>e in t?U(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n;var a=(t,e,n)=>_(t,typeof e!="symbol"?e+"":e,n);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var f=(t=>(t.PRIVATE="WALLET",t.VASP="VASP",t))(f||{}),w=(t=>(t.NATURAL="natural",t.LEGAL="legal",t.SELF="self",t))(w||{}),g=(t=>(t.EMPTY="empty",t.VERIFY="verify",t.PENDING="pending",t.VERIFIED="verified",t.BANNED="banned",t))(g||{}),v=(t=>(t.ALLOWED="allowed",t.PENDING="pending",t))(v||{}),y=(t=>(t.ASSET="asset",t.DESTINATION="destination",t.COUNTERPARTY="counterparty",t.AGENT="agent",t))(y||{}),l=(t=>(t.COMPLETE="complete",t.RESIZE="resize",t.RESULT="result",t.READY="ready",t.INVALID="invalid",t.ERROR="error",t.CANCEL="cancel",t))(l||{}),A=(t=>(t.SERVICE_UNAVAILABLE="SERVICE_UNAVAILABLE",t.WALLET_CONNECTION_FAILED="WALLET_CONNECTION_FAILED",t.WALLET_NOT_SUPPORTED="WALLET_NOT_SUPPORTED",t.TOKEN_INVALID="TOKEN_INVALID",t))(A||{}),p=(t=>(t.UPDATE="update",t.REQUEST_RESPONSE="requestResponse",t))(p||{}),C=(t=>(t.PENDING="pending",t.FAILED="rejected",t.FLAGGED="flagged",t.VERIFIED="verified",t))(C||{}),b=(t=>(t.SelfDeclaration="self-declaration",t.SIWE="siwe",t.SIWX="siwx",t.EIP191="eip-191",t.EIP712="eip-712",t.EIP1271="eip-1271",t.BIP137="bip-137",t.BIP322="bip-322",t.BIP137_XPUB="xpub",t.TIP191="tip-191",t.ED25519="ed25519",t.XRP_ED25519="xrp-ed25519",t.XLM_ED25519="xlm-ed25519",t.CIP8="cip-8",t.MicroTransfer="microtransfer",t.Screenshot="screenshot",t.Connect="connect",t))(b||{});class R{constructor(){a(this,"listeners",new Map);a(this,"port");this.handleMessage=this.handleMessage.bind(this)}setPort(e){this.port=e,this.port.onmessage=this.handleMessage,this.port.start()}on(e,n){return this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(n),()=>this.off(e,n)}off(e,n){const r=this.listeners.get(e);r&&(r.delete(n),r.size===0&&this.listeners.delete(e))}handleMessage(e){const n=e.data;if(typeof n=="object"&&n!==null&&"type"in n){const r=n.type,s=this.listeners.get(r);s&&s.forEach(o=>o(n))}}send(e){this.port&&this.port.postMessage(e)}}class I{constructor(e,n,r){a(this,"_url");a(this,"_value");a(this,"_options");a(this,"_errors",[]);a(this,"iframe");a(this,"eventManager");a(this,"modal");this._url=e,this._value=n,this._options=r,this.eventManager=new R,this.on(l.INVALID,s=>{s.type===l.INVALID&&(this._errors=s.errors,this._value=s.value)}),this.on(l.RESIZE,s=>{s.type===l.RESIZE&&this.iframe&&(this.iframe.style.height=`${s.height}px`)})}get url(){return this._url}get value(){return this._value}get options(){return this._options}get errors(){return this._errors}open(){document.location.href=this.url}mount(e){const n=document.querySelector(e);if(!n)throw new Error(`parentID ${e} not found`);this.embed(n)}embed(e,n=!1){var r,s;this.removeEmbed(),this.iframe=document.createElement("iframe"),this.iframe.src=this.url+(n?"":"&embedded=true"),this.iframe.allow="web-share; clipboard-write; hid; bluetooth;",this.iframe.style.width="100%",this.iframe.style.height="0px",this.iframe.style.border="none",this.iframe.style.overflow="hidden",this.iframe.scrolling="no",e.appendChild(this.iframe),window.addEventListener("message",o=>{var i,c;o.source===((i=this.iframe)==null?void 0:i.contentWindow)&&((c=this.eventManager)==null||c.setPort(o.ports[0]))}),(s=(r=this.iframe)==null?void 0:r.contentWindow)==null||s.focus()}removeEmbed(){this.iframe&&this.iframe.remove()}send(e){this.eventManager.send(e)}on(e,n){return this.eventManager.on(e,n)}off(e,n){this.eventManager.off(e,n)}update(e,n){this._value=e,n&&(this._options=n),this.send({type:p.UPDATE,value:e,options:this._options})}completion(){return new Promise((e,n)=>{let r,s,o;function i(){r&&r(),s&&s(),o&&o()}r=this.on(l.COMPLETE,c=>{e(c.response),i()}),s=this.on(l.CANCEL,()=>{n(new Error("User cancelled")),i()}),o=this.on("error",c=>{n(new Error(c.message)),i()})})}async openModal(){this.modal&&this.closeModal(),this.modal=document.createElement("dialog"),this.modal.style.border="none",this.modal.style.backgroundColor="white",this.modal.style.maxWidth="100vw",this.modal.style.maxHeight="100vh",this.modal.style.width="600px",this.modal.style.height="600px",document.body.appendChild(this.modal),this.embed(this.modal,!0);const e=this.on(l.CANCEL,()=>{this.closeModal()}),n=this.on(l.COMPLETE,()=>{this.closeModal()});return this.modal.showModal(),this.modal.addEventListener("click",()=>{this.closeModal()}),this.completion().finally(()=>{e(),n()})}closeModal(){var e;this.modal&&((e=this.modal)==null||e.close(),this.modal.remove(),this.modal=void 0)}async popup(){const e=window.open(this.url,"_blank","popup=true,width=600,height=600");window.addEventListener("message",s=>{var o;s.source===e&&(console.log("received message from popup",s.data),(o=this.eventManager)==null||o.setPort(s.ports[0]))});const n=this.on(l.CANCEL,()=>{e==null||e.close()}),r=this.on(l.COMPLETE,()=>{e==null||e.close()});return this.completion().finally(()=>{n(),r()})}}function x(t){return Object.entries(t).map(([e,n])=>{if(n==null)return;const r=encodeURIComponent(e),s=encodeURIComponent(typeof n=="object"?JSON.stringify(n):String(n));return`${r}=${s}`}).filter(e=>e!==void 0).join("&")}function S(t){const e=t.slice(1);return e?e.split("&").filter(Boolean).reduce((r,s)=>{const[o,i]=s.split("=");return o&&(r[decodeURIComponent(o)]=i?decodeURIComponent(i):""),r},{}):{}}async function E(t,e){const n=JSON.stringify(t),r=new TextEncoder,s=e?m(e):crypto.getRandomValues(new Uint8Array(32)),o=await crypto.subtle.importKey("raw",s,{name:"AES-GCM"},!1,["encrypt"]),i=crypto.getRandomValues(new Uint8Array(12)),c=await crypto.subtle.encrypt({name:"AES-GCM",iv:i},o,r.encode(n));return{ciphertext:`${u(i)}-${u(c)}`,key:u(s)}}async function L({ciphertext:t,key:e}){const[n,r]=t.split("-"),s=new Uint8Array(atob(e).split("").map(N=>N.charCodeAt(0))),o=m(n),i=m(r),c=await crypto.subtle.importKey("raw",s,{name:"AES-GCM"},!1,["decrypt"]),d=new TextDecoder,h=await crypto.subtle.decrypt({name:"AES-GCM",iv:new Uint8Array(o)},c,i);return JSON.parse(d.decode(h))}function u(t){const e=new Uint8Array(t);let n="";for(let r=0;r<e.length;r++)n+=String.fromCharCode(e[r]);return btoa(n)}function m(t){const e=atob(t),n=new Uint8Array(e.length);for(let r=0;r<e.length;r++)n[r]=e.charCodeAt(r);return n}async function M(t){const e=await fetch(t.url,{method:"GET"});if(!e.ok)throw new Error(`Failed to get connection: ${await e.text()}`);const n=await e.json();if(!n.sealed)throw new Error("No data found");const r=n.sealed[n.sealed.length-1],s=await L({ciphertext:r,key:t.key});return{id:n.id,metadata:n.metadata,status:n.status,tx:s.tx,result:s.result}}class O{constructor(e){a(this,"endpoint");this.endpoint=e}async create(e,n){const r=await E(e),s={metadata:n,sealed:r.ciphertext},o=await fetch(this.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)});if(!o.ok)throw new Error(`Failed to create connection: ${await o.text()}`);const i=await o.json();return{id:i.id,version:i.version,status:i.status,metadata:n,data:e,key:r.key}}async update(e,n,r,s,o){const i=await E(n,o),c={sealed:i.ciphertext,version:r,status:s},d=await fetch(`${this.endpoint}/${e}`,{method:"PATCH",headers:{"Content-Type":"application/json"},body:JSON.stringify(c)});if(!d.ok)throw new Error(`Failed to update connection: ${await d.text()}`);const h=await d.json();return{id:h.id,metadata:h.metadata,version:h.version,status:h.status,data:n,key:i.key}}async get(e,n){const r=await fetch(`${this.endpoint}/${e}`,{method:"GET"});if(!r.ok)throw new Error(`Failed to get connection: ${await r.text()}`);const s=await r.json(),o=s.sealed[s.sealed.length-1],i=await L({ciphertext:o,key:n});return{id:s.id,status:s.status,version:s.version,metadata:s.metadata,data:i,key:n}}async close(e){const n=await fetch(`${this.endpoint}/${e}`,{method:"DELETE"});if(!n.ok)throw new Error(`Failed to close connection: ${await n.text()}`)}}class D{constructor(e){a(this,"nodeUrl");a(this,"authToken");a(this,"uxUrl");a(this,"theme");a(this,"locale");this.uxUrl=e.uxUrl||"https://connect.notabene.id",this.nodeUrl=e.nodeUrl,this.authToken=e.authToken,this.theme=e.theme,this.locale=e.locale}componentUrl(e,n,r,s){const o=new URL(this.uxUrl);o.pathname=e;const i=x({authToken:this.authToken,value:n,configuration:r});return o.hash=i,this.nodeUrl&&o.searchParams.set("nodeUrl",this.nodeUrl),this.theme&&o.searchParams.set("theme",JSON.stringify(this.theme)),this.locale&&o.searchParams.set("locale",this.locale),s&&(s.callback&&o.searchParams.set("callback_url",s.callback),s.redirectUri&&o.searchParams.set("redirect_uri",s.redirectUri)),o.toString()}createComponent(e,n,r,s){return new I(this.componentUrl(e,n,r,s),n,r)}createWithdrawalAssist(e,n,r){return this.createComponent("withdrawal-assist",e,n,r)}createConnectWallet(e,n,r){return this.createComponent("connect",e,n,r)}createDepositRequest(e,n,r){return this.createComponent("deposit-request",e,n,r)}createDepositAssist(e,n,r){return this.createComponent("deposit-assist",e,n,r)}}exports.AgentType=f;exports.CMType=l;exports.ConnectionManager=O;exports.EmbeddedComponent=I;exports.ErrorIdentifierCode=A;exports.HMType=p;exports.PersonType=w;exports.ProofStatus=C;exports.ProofTypes=b;exports.Status=g;exports.VASPSearchControl=v;exports.ValidationSections=y;exports.decodeFragmentToObject=S;exports.default=D;exports.getRefreshResult=M;

package/dist/cjs/notabene.d.ts

@@ -294,6 +294,7 @@ export declare interface ConnectionData<T extends ComponentRequest> {
     tx: T;
     authToken?: string;
     txOptions?: TransactionOptions;
+    result?: TransactionResponse<T>;
 }
 
 /**
@@ -316,7 +317,7 @@ export declare class ConnectionManager {
      * @param version Current version number
      * @returns Promise resolving to updated connection details including new encryption key
      */
-    update<T extends ComponentRequest>(id: UUID, data: ConnectionData<T>, version: number): Promise<ConnectionResponse<T>>;
+    update<T extends ComponentRequest>(id: UUID, data: ConnectionData<T>, version: number, status: ConnectionStatus, key: string): Promise<ConnectionResponse<T>>;
     /**
      * Retrieves and decrypts connection data
      * @param id Connection ID
@@ -354,11 +355,22 @@ export declare interface ConnectionRequest extends ComponentRequest {
 export declare interface ConnectionResponse<T extends ComponentRequest> {
     id: UUID;
     version: number;
+    status: ConnectionStatus;
     metadata: ConnectionMetadata;
     data: ConnectionData<T>;
     key: string;
 }
 
+export declare interface ConnectionResult<T extends ComponentRequest> {
+    id: UUID;
+    metadata: ConnectionMetadata;
+    status: ConnectionStatus;
+    tx: T;
+    result?: TransactionResponse<T>;
+}
+
+export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
+
 /**
  * The counterparty of a transaction.
  * @public
@@ -642,6 +654,8 @@ export declare type FieldTypes = {
     legalPerson?: LegalPersonFields;
 };
 
+export declare function getRefreshResult<T extends ComponentRequest>(refreshSource: RefreshSource): Promise<ConnectionResult<T>>;
+
 /**
  * Host Message Type enum representing different message types that can be sent
  * from the host application.
@@ -1352,7 +1366,7 @@ declare interface Refreshable {
     refreshSource?: RefreshSource;
 }
 
-declare interface RefreshSource {
+export declare interface RefreshSource {
     url: URI;
     key: string;
 }

package/dist/cjs/package.json

@@ -10,7 +10,7 @@
   "author": "Notabene <developers@notabene.id>",
   "license": "MIT",
   "packageManager": "yarn@4.5.1",
-  "version": "2.9.0-next.1",
+  "version": "2.9.0-next.2",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",

package/dist/esm/notabene.d.ts

@@ -294,6 +294,7 @@ export declare interface ConnectionData<T extends ComponentRequest> {
     tx: T;
     authToken?: string;
     txOptions?: TransactionOptions;
+    result?: TransactionResponse<T>;
 }
 
 /**
@@ -316,7 +317,7 @@ export declare class ConnectionManager {
      * @param version Current version number
      * @returns Promise resolving to updated connection details including new encryption key
      */
-    update<T extends ComponentRequest>(id: UUID, data: ConnectionData<T>, version: number): Promise<ConnectionResponse<T>>;
+    update<T extends ComponentRequest>(id: UUID, data: ConnectionData<T>, version: number, status: ConnectionStatus, key: string): Promise<ConnectionResponse<T>>;
     /**
      * Retrieves and decrypts connection data
      * @param id Connection ID
@@ -354,11 +355,22 @@ export declare interface ConnectionRequest extends ComponentRequest {
 export declare interface ConnectionResponse<T extends ComponentRequest> {
     id: UUID;
     version: number;
+    status: ConnectionStatus;
     metadata: ConnectionMetadata;
     data: ConnectionData<T>;
     key: string;
 }
 
+export declare interface ConnectionResult<T extends ComponentRequest> {
+    id: UUID;
+    metadata: ConnectionMetadata;
+    status: ConnectionStatus;
+    tx: T;
+    result?: TransactionResponse<T>;
+}
+
+export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
+
 /**
  * The counterparty of a transaction.
  * @public
@@ -642,6 +654,8 @@ export declare type FieldTypes = {
     legalPerson?: LegalPersonFields;
 };
 
+export declare function getRefreshResult<T extends ComponentRequest>(refreshSource: RefreshSource): Promise<ConnectionResult<T>>;
+
 /**
  * Host Message Type enum representing different message types that can be sent
  * from the host application.
@@ -1352,7 +1366,7 @@ declare interface Refreshable {
     refreshSource?: RefreshSource;
 }
 
-declare interface RefreshSource {
+export declare interface RefreshSource {
     url: URI;
     key: string;
 }

package/dist/esm/notabene.js

@@ -1,8 +1,8 @@
-var w = Object.defineProperty;
-var v = (t, e, n) => e in t ? w(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
-var a = (t, e, n) => v(t, typeof e != "symbol" ? e + "" : e, n);
-var A = /* @__PURE__ */ ((t) => (t.PRIVATE = "WALLET", t.VASP = "VASP", t))(A || {}), g = /* @__PURE__ */ ((t) => (t.NATURAL = "natural", t.LEGAL = "legal", t.SELF = "self", t))(g || {}), y = /* @__PURE__ */ ((t) => (t.EMPTY = "empty", t.VERIFY = "verify", t.PENDING = "pending", t.VERIFIED = "verified", t.BANNED = "banned", t))(y || {}), I = /* @__PURE__ */ ((t) => (t.ALLOWED = "allowed", t.PENDING = "pending", t))(I || {}), L = /* @__PURE__ */ ((t) => (t.ASSET = "asset", t.DESTINATION = "destination", t.COUNTERPARTY = "counterparty", t.AGENT = "agent", t))(L || {}), l = /* @__PURE__ */ ((t) => (t.COMPLETE = "complete", t.RESIZE = "resize", t.RESULT = "result", t.READY = "ready", t.INVALID = "invalid", t.ERROR = "error", t.CANCEL = "cancel", t))(l || {}), C = /* @__PURE__ */ ((t) => (t.SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE", t.WALLET_CONNECTION_FAILED = "WALLET_CONNECTION_FAILED", t.WALLET_NOT_SUPPORTED = "WALLET_NOT_SUPPORTED", t.TOKEN_INVALID = "TOKEN_INVALID", t))(C || {}), u = /* @__PURE__ */ ((t) => (t.UPDATE = "update", t.REQUEST_RESPONSE = "requestResponse", t))(u || {}), b = /* @__PURE__ */ ((t) => (t.PENDING = "pending", t.FAILED = "rejected", t.FLAGGED = "flagged", t.VERIFIED = "verified", t))(b || {}), N = /* @__PURE__ */ ((t) => (t.SelfDeclaration = "self-declaration", t.SIWE = "siwe", t.SIWX = "siwx", t.EIP191 = "eip-191", t.EIP712 = "eip-712", t.EIP1271 = "eip-1271", t.BIP137 = "bip-137", t.BIP322 = "bip-322", t.BIP137_XPUB = "xpub", t.TIP191 = "tip-191", t.ED25519 = "ed25519", t.XRP_ED25519 = "xrp-ed25519", t.XLM_ED25519 = "xlm-ed25519", t.CIP8 = "cip-8", t.MicroTransfer = "microtransfer", t.Screenshot = "screenshot", t.Connect = "connect", t))(N || {});
-class U {
+var v = Object.defineProperty;
+var g = (t, e, n) => e in t ? v(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
+var a = (t, e, n) => g(t, typeof e != "symbol" ? e + "" : e, n);
+var A = /* @__PURE__ */ ((t) => (t.PRIVATE = "WALLET", t.VASP = "VASP", t))(A || {}), y = /* @__PURE__ */ ((t) => (t.NATURAL = "natural", t.LEGAL = "legal", t.SELF = "self", t))(y || {}), I = /* @__PURE__ */ ((t) => (t.EMPTY = "empty", t.VERIFY = "verify", t.PENDING = "pending", t.VERIFIED = "verified", t.BANNED = "banned", t))(I || {}), L = /* @__PURE__ */ ((t) => (t.ALLOWED = "allowed", t.PENDING = "pending", t))(L || {}), C = /* @__PURE__ */ ((t) => (t.ASSET = "asset", t.DESTINATION = "destination", t.COUNTERPARTY = "counterparty", t.AGENT = "agent", t))(C || {}), l = /* @__PURE__ */ ((t) => (t.COMPLETE = "complete", t.RESIZE = "resize", t.RESULT = "result", t.READY = "ready", t.INVALID = "invalid", t.ERROR = "error", t.CANCEL = "cancel", t))(l || {}), N = /* @__PURE__ */ ((t) => (t.SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE", t.WALLET_CONNECTION_FAILED = "WALLET_CONNECTION_FAILED", t.WALLET_NOT_SUPPORTED = "WALLET_NOT_SUPPORTED", t.TOKEN_INVALID = "TOKEN_INVALID", t))(N || {}), E = /* @__PURE__ */ ((t) => (t.UPDATE = "update", t.REQUEST_RESPONSE = "requestResponse", t))(E || {}), b = /* @__PURE__ */ ((t) => (t.PENDING = "pending", t.FAILED = "rejected", t.FLAGGED = "flagged", t.VERIFIED = "verified", t))(b || {}), U = /* @__PURE__ */ ((t) => (t.SelfDeclaration = "self-declaration", t.SIWE = "siwe", t.SIWX = "siwx", t.EIP191 = "eip-191", t.EIP712 = "eip-712", t.EIP1271 = "eip-1271", t.BIP137 = "bip-137", t.BIP322 = "bip-322", t.BIP137_XPUB = "xpub", t.TIP191 = "tip-191", t.ED25519 = "ed25519", t.XRP_ED25519 = "xrp-ed25519", t.XLM_ED25519 = "xlm-ed25519", t.CIP8 = "cip-8", t.MicroTransfer = "microtransfer", t.Screenshot = "screenshot", t.Connect = "connect", t))(U || {});
+class _ {
   constructor() {
     a(this, "listeners", /* @__PURE__ */ new Map());
     a(this, "port");
@@ -56,8 +56,8 @@ class U {
   handleMessage(e) {
     const n = e.data;
     if (typeof n == "object" && n !== null && "type" in n) {
-      const r = n.type, i = this.listeners.get(r);
-      i && i.forEach((s) => s(n));
+      const r = n.type, s = this.listeners.get(r);
+      s && s.forEach((i) => i(n));
     }
   }
   /**
@@ -68,7 +68,7 @@ class U {
     this.port && this.port.postMessage(e);
   }
 }
-class _ {
+class x {
   /**
    * Creates an instance of EmbeddedComponent.
    * @param url - The URL of the embedded component
@@ -82,10 +82,10 @@ class _ {
     a(this, "iframe");
     a(this, "eventManager");
     a(this, "modal");
-    this._url = e, this._value = n, this._options = r, this.eventManager = new U(), this.on(l.INVALID, (i) => {
-      i.type === l.INVALID && (this._errors = i.errors, this._value = i.value);
-    }), this.on(l.RESIZE, (i) => {
-      i.type === l.RESIZE && this.iframe && (this.iframe.style.height = `${i.height}px`);
+    this._url = e, this._value = n, this._options = r, this.eventManager = new _(), this.on(l.INVALID, (s) => {
+      s.type === l.INVALID && (this._errors = s.errors, this._value = s.value);
+    }), this.on(l.RESIZE, (s) => {
+      s.type === l.RESIZE && this.iframe && (this.iframe.style.height = `${s.height}px`);
     });
   }
   /**
@@ -129,11 +129,11 @@ class _ {
    * @param parent - The parent element to embed the component into
    */
   embed(e, n = !1) {
-    var r, i;
-    this.removeEmbed(), this.iframe = document.createElement("iframe"), this.iframe.src = this.url + (n ? "" : "&embedded=true"), this.iframe.allow = "web-share; clipboard-write; hid; bluetooth;", this.iframe.style.width = "100%", this.iframe.style.height = "0px", this.iframe.style.border = "none", this.iframe.style.overflow = "hidden", this.iframe.scrolling = "no", e.appendChild(this.iframe), window.addEventListener("message", (s) => {
+    var r, s;
+    this.removeEmbed(), this.iframe = document.createElement("iframe"), this.iframe.src = this.url + (n ? "" : "&embedded=true"), this.iframe.allow = "web-share; clipboard-write; hid; bluetooth;", this.iframe.style.width = "100%", this.iframe.style.height = "0px", this.iframe.style.border = "none", this.iframe.style.overflow = "hidden", this.iframe.scrolling = "no", e.appendChild(this.iframe), window.addEventListener("message", (i) => {
       var o, c;
-      s.source === ((o = this.iframe) == null ? void 0 : o.contentWindow) && ((c = this.eventManager) == null || c.setPort(s.ports[0]));
-    }), (i = (r = this.iframe) == null ? void 0 : r.contentWindow) == null || i.focus();
+      i.source === ((o = this.iframe) == null ? void 0 : o.contentWindow) && ((c = this.eventManager) == null || c.setPort(i.ports[0]));
+    }), (s = (r = this.iframe) == null ? void 0 : r.contentWindow) == null || s.focus();
   }
   removeEmbed() {
     this.iframe && this.iframe.remove();
@@ -166,7 +166,7 @@ class _ {
    * @param value - The new transaction value
    */
   update(e, n) {
-    this._value = e, n && (this._options = n), this.send({ type: u.UPDATE, value: e, options: this._options });
+    this._value = e, n && (this._options = n), this.send({ type: E.UPDATE, value: e, options: this._options });
   }
   /**
    * Waits for the component to complete and returns the transaction response
@@ -174,15 +174,15 @@ class _ {
    */
   completion() {
     return new Promise((e, n) => {
-      let r, i, s;
+      let r, s, i;
       function o() {
-        r && r(), i && i(), s && s();
+        r && r(), s && s(), i && i();
       }
       r = this.on(l.COMPLETE, (c) => {
         e(c.response), o();
-      }), i = this.on(l.CANCEL, () => {
+      }), s = this.on(l.CANCEL, () => {
         n(new Error("User cancelled")), o();
-      }), s = this.on("error", (c) => {
+      }), i = this.on("error", (c) => {
         n(new Error(c.message)), o();
       });
     });
@@ -223,9 +223,9 @@ class _ {
       "_blank",
       "popup=true,width=600,height=600"
     );
-    window.addEventListener("message", (i) => {
-      var s;
-      i.source === e && (console.log("received message from popup", i.data), (s = this.eventManager) == null || s.setPort(i.ports[0]));
+    window.addEventListener("message", (s) => {
+      var i;
+      s.source === e && (console.log("received message from popup", s.data), (i = this.eventManager) == null || i.setPort(s.ports[0]));
     });
     const n = this.on(l.CANCEL, () => {
       e == null || e.close();
@@ -237,60 +237,60 @@ class _ {
     });
   }
 }
-function x(t) {
+function R(t) {
   return Object.entries(t).map(([e, n]) => {
     if (n == null) return;
-    const r = encodeURIComponent(e), i = encodeURIComponent(
+    const r = encodeURIComponent(e), s = encodeURIComponent(
       typeof n == "object" ? JSON.stringify(n) : String(n)
       // Use String() to handle all primitive types
     );
-    return `${r}=${i}`;
+    return `${r}=${s}`;
   }).filter((e) => e !== void 0).join("&");
 }
 function O(t) {
   const e = t.slice(1);
   return e ? e.split("&").filter(Boolean).reduce(
-    (r, i) => {
-      const [s, o] = i.split("=");
-      return s && (r[decodeURIComponent(s)] = o ? decodeURIComponent(o) : ""), r;
+    (r, s) => {
+      const [i, o] = s.split("=");
+      return i && (r[decodeURIComponent(i)] = o ? decodeURIComponent(o) : ""), r;
     },
     {}
   ) : {};
 }
-async function d(t) {
-  const e = JSON.stringify(t), n = new TextEncoder(), r = crypto.getRandomValues(new Uint8Array(32)), i = await crypto.subtle.importKey(
+async function p(t, e) {
+  const n = JSON.stringify(t), r = new TextEncoder(), s = e ? m(e) : crypto.getRandomValues(new Uint8Array(32)), i = await crypto.subtle.importKey(
     "raw",
-    r,
+    s,
     { name: "AES-GCM" },
     !1,
     ["encrypt"]
-  ), s = crypto.getRandomValues(new Uint8Array(12)), o = await crypto.subtle.encrypt(
-    { name: "AES-GCM", iv: s },
+  ), o = crypto.getRandomValues(new Uint8Array(12)), c = await crypto.subtle.encrypt(
+    { name: "AES-GCM", iv: o },
     i,
-    n.encode(e)
+    r.encode(n)
   );
   return {
-    ciphertext: `${h(s)}-${h(o)}`,
-    key: h(r)
+    ciphertext: `${u(o)}-${u(c)}`,
+    key: u(s)
   };
 }
-async function D({ ciphertext: t, key: e }) {
-  const [n, r] = t.split("-"), i = new Uint8Array(
-    atob(e).split("").map((f) => f.charCodeAt(0))
-  ), s = m(n), o = m(r), c = await crypto.subtle.importKey(
+async function f({ ciphertext: t, key: e }) {
+  const [n, r] = t.split("-"), s = new Uint8Array(
+    atob(e).split("").map((w) => w.charCodeAt(0))
+  ), i = m(n), o = m(r), c = await crypto.subtle.importKey(
     "raw",
-    i,
+    s,
     { name: "AES-GCM" },
     !1,
     ["decrypt"]
-  ), p = new TextDecoder(), E = await crypto.subtle.decrypt(
-    { name: "AES-GCM", iv: new Uint8Array(s) },
+  ), h = new TextDecoder(), d = await crypto.subtle.decrypt(
+    { name: "AES-GCM", iv: new Uint8Array(i) },
     c,
     o
   );
-  return JSON.parse(p.decode(E));
+  return JSON.parse(h.decode(d));
 }
-function h(t) {
+function u(t) {
   const e = new Uint8Array(t);
   let n = "";
   for (let r = 0; r < e.length; r++)
@@ -303,7 +303,28 @@ function m(t) {
     n[r] = e.charCodeAt(r);
   return n;
 }
-class M {
+async function M(t) {
+  const e = await fetch(t.url, {
+    method: "GET"
+  });
+  if (!e.ok)
+    throw new Error(`Failed to get connection: ${await e.text()}`);
+  const n = await e.json();
+  if (!n.sealed)
+    throw new Error("No data found");
+  const r = n.sealed[n.sealed.length - 1], s = await f({
+    ciphertext: r,
+    key: t.key
+  });
+  return {
+    id: n.id,
+    metadata: n.metadata,
+    status: n.status,
+    tx: s.tx,
+    result: s.result
+  };
+}
+class S {
   constructor(e) {
     a(this, "endpoint");
     this.endpoint = e;
@@ -315,22 +336,23 @@ class M {
    * @returns Promise resolving to connection details including ID, version, and encryption key
    */
   async create(e, n) {
-    const r = await d(e), i = {
+    const r = await p(e), s = {
       metadata: n,
       sealed: r.ciphertext
-    }, s = await fetch(this.endpoint, {
+    }, i = await fetch(this.endpoint, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
-      body: JSON.stringify(i)
+      body: JSON.stringify(s)
     });
-    if (!s.ok)
-      throw new Error(`Failed to create connection: ${await s.text()}`);
-    const o = await s.json();
+    if (!i.ok)
+      throw new Error(`Failed to create connection: ${await i.text()}`);
+    const o = await i.json();
     return {
       id: o.id,
       version: o.version,
+      status: o.status,
       metadata: n,
       data: e,
       key: r.key
@@ -343,26 +365,28 @@ class M {
    * @param version Current version number
    * @returns Promise resolving to updated connection details including new encryption key
    */
-  async update(e, n, r) {
-    const i = await d(n), s = {
-      sealed: i.ciphertext,
-      version: r
-    }, o = await fetch(`${this.endpoint}/${e}`, {
+  async update(e, n, r, s, i) {
+    const o = await p(n, i), c = {
+      sealed: o.ciphertext,
+      version: r,
+      status: s
+    }, h = await fetch(`${this.endpoint}/${e}`, {
       method: "PATCH",
       headers: {
         "Content-Type": "application/json"
       },
-      body: JSON.stringify(s)
+      body: JSON.stringify(c)
     });
-    if (!o.ok)
-      throw new Error(`Failed to update connection: ${await o.text()}`);
-    const c = await o.json();
+    if (!h.ok)
+      throw new Error(`Failed to update connection: ${await h.text()}`);
+    const d = await h.json();
     return {
-      id: c.id,
-      metadata: c.metadata,
-      version: c.version,
+      id: d.id,
+      metadata: d.metadata,
+      version: d.version,
+      status: d.status,
       data: n,
-      key: i.key
+      key: o.key
     };
   }
   /**
@@ -377,14 +401,15 @@ class M {
     });
     if (!r.ok)
       throw new Error(`Failed to get connection: ${await r.text()}`);
-    const i = await r.json(), s = i.sealed[i.sealed.length - 1], o = await D({
-      ciphertext: s,
+    const s = await r.json(), i = s.sealed[s.sealed.length - 1], o = await f({
+      ciphertext: i,
       key: n
     });
     return {
-      id: i.id,
-      version: i.version,
-      metadata: i.metadata,
+      id: s.id,
+      status: s.status,
+      version: s.version,
+      metadata: s.metadata,
       data: o,
       key: n
     };
@@ -401,7 +426,7 @@ class M {
       throw new Error(`Failed to close connection: ${await n.text()}`);
   }
 }
-class S {
+class k {
   /**
    * Creates a new instance of the Notabene SDK
    *
@@ -425,15 +450,15 @@ class S {
    * @returns component URL
    * @internal
    */
-  componentUrl(e, n, r, i) {
-    const s = new URL(this.uxUrl);
-    s.pathname = e;
-    const o = x({
+  componentUrl(e, n, r, s) {
+    const i = new URL(this.uxUrl);
+    i.pathname = e;
+    const o = R({
       authToken: this.authToken,
       value: n,
       configuration: r
     });
-    return s.hash = o, this.nodeUrl && s.searchParams.set("nodeUrl", this.nodeUrl), this.theme && s.searchParams.set("theme", JSON.stringify(this.theme)), this.locale && s.searchParams.set("locale", this.locale), i && (i.callback && s.searchParams.set("callback_url", i.callback), i.redirectUri && s.searchParams.set("redirect_uri", i.redirectUri)), s.toString();
+    return i.hash = o, this.nodeUrl && i.searchParams.set("nodeUrl", this.nodeUrl), this.theme && i.searchParams.set("theme", JSON.stringify(this.theme)), this.locale && i.searchParams.set("locale", this.locale), s && (s.callback && i.searchParams.set("callback_url", s.callback), s.redirectUri && i.searchParams.set("redirect_uri", s.redirectUri)), i.toString();
   }
   /**
    * Creates a new embedded component
@@ -445,9 +470,9 @@ class S {
    * @returns A new EmbeddedComponent instance
    * @internal
    */
-  createComponent(e, n, r, i) {
-    return new _(
-      this.componentUrl(e, n, r, i),
+  createComponent(e, n, r, s) {
+    return new x(
+      this.componentUrl(e, n, r, s),
       n,
       r
     );
@@ -523,16 +548,17 @@ class S {
 export {
   A as AgentType,
   l as CMType,
-  M as ConnectionManager,
-  _ as EmbeddedComponent,
-  C as ErrorIdentifierCode,
-  u as HMType,
-  g as PersonType,
+  S as ConnectionManager,
+  x as EmbeddedComponent,
+  N as ErrorIdentifierCode,
+  E as HMType,
+  y as PersonType,
   b as ProofStatus,
-  N as ProofTypes,
-  y as Status,
-  I as VASPSearchControl,
-  L as ValidationSections,
+  U as ProofTypes,
+  I as Status,
+  L as VASPSearchControl,
+  C as ValidationSections,
   O as decodeFragmentToObject,
-  S as default
+  k as default,
+  M as getRefreshResult
 };

package/dist/esm/package.json

@@ -10,7 +10,7 @@
   "author": "Notabene <developers@notabene.id>",
   "license": "MIT",
   "packageManager": "yarn@4.5.1",
-  "version": "2.9.0-next.1",
+  "version": "2.9.0-next.2",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",

package/dist/notabene.d.ts

@@ -294,6 +294,7 @@ export declare interface ConnectionData<T extends ComponentRequest> {
     tx: T;
     authToken?: string;
     txOptions?: TransactionOptions;
+    result?: TransactionResponse<T>;
 }
 
 /**
@@ -316,7 +317,7 @@ export declare class ConnectionManager {
      * @param version Current version number
      * @returns Promise resolving to updated connection details including new encryption key
      */
-    update<T extends ComponentRequest>(id: UUID, data: ConnectionData<T>, version: number): Promise<ConnectionResponse<T>>;
+    update<T extends ComponentRequest>(id: UUID, data: ConnectionData<T>, version: number, status: ConnectionStatus, key: string): Promise<ConnectionResponse<T>>;
     /**
      * Retrieves and decrypts connection data
      * @param id Connection ID
@@ -354,11 +355,22 @@ export declare interface ConnectionRequest extends ComponentRequest {
 export declare interface ConnectionResponse<T extends ComponentRequest> {
     id: UUID;
     version: number;
+    status: ConnectionStatus;
     metadata: ConnectionMetadata;
     data: ConnectionData<T>;
     key: string;
 }
 
+export declare interface ConnectionResult<T extends ComponentRequest> {
+    id: UUID;
+    metadata: ConnectionMetadata;
+    status: ConnectionStatus;
+    tx: T;
+    result?: TransactionResponse<T>;
+}
+
+export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
+
 /**
  * The counterparty of a transaction.
  * @public
@@ -642,6 +654,8 @@ export declare type FieldTypes = {
     legalPerson?: LegalPersonFields;
 };
 
+export declare function getRefreshResult<T extends ComponentRequest>(refreshSource: RefreshSource): Promise<ConnectionResult<T>>;
+
 /**
  * Host Message Type enum representing different message types that can be sent
  * from the host application.
@@ -1352,7 +1366,7 @@ declare interface Refreshable {
     refreshSource?: RefreshSource;
 }
 
-declare interface RefreshSource {
+export declare interface RefreshSource {
     url: URI;
     key: string;
 }

package/dist/notabene.js

@@ -1,8 +1,8 @@
-var w = Object.defineProperty;
-var v = (t, e, n) => e in t ? w(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
-var a = (t, e, n) => v(t, typeof e != "symbol" ? e + "" : e, n);
-var A = /* @__PURE__ */ ((t) => (t.PRIVATE = "WALLET", t.VASP = "VASP", t))(A || {}), g = /* @__PURE__ */ ((t) => (t.NATURAL = "natural", t.LEGAL = "legal", t.SELF = "self", t))(g || {}), y = /* @__PURE__ */ ((t) => (t.EMPTY = "empty", t.VERIFY = "verify", t.PENDING = "pending", t.VERIFIED = "verified", t.BANNED = "banned", t))(y || {}), I = /* @__PURE__ */ ((t) => (t.ALLOWED = "allowed", t.PENDING = "pending", t))(I || {}), L = /* @__PURE__ */ ((t) => (t.ASSET = "asset", t.DESTINATION = "destination", t.COUNTERPARTY = "counterparty", t.AGENT = "agent", t))(L || {}), l = /* @__PURE__ */ ((t) => (t.COMPLETE = "complete", t.RESIZE = "resize", t.RESULT = "result", t.READY = "ready", t.INVALID = "invalid", t.ERROR = "error", t.CANCEL = "cancel", t))(l || {}), C = /* @__PURE__ */ ((t) => (t.SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE", t.WALLET_CONNECTION_FAILED = "WALLET_CONNECTION_FAILED", t.WALLET_NOT_SUPPORTED = "WALLET_NOT_SUPPORTED", t.TOKEN_INVALID = "TOKEN_INVALID", t))(C || {}), u = /* @__PURE__ */ ((t) => (t.UPDATE = "update", t.REQUEST_RESPONSE = "requestResponse", t))(u || {}), b = /* @__PURE__ */ ((t) => (t.PENDING = "pending", t.FAILED = "rejected", t.FLAGGED = "flagged", t.VERIFIED = "verified", t))(b || {}), N = /* @__PURE__ */ ((t) => (t.SelfDeclaration = "self-declaration", t.SIWE = "siwe", t.SIWX = "siwx", t.EIP191 = "eip-191", t.EIP712 = "eip-712", t.EIP1271 = "eip-1271", t.BIP137 = "bip-137", t.BIP322 = "bip-322", t.BIP137_XPUB = "xpub", t.TIP191 = "tip-191", t.ED25519 = "ed25519", t.XRP_ED25519 = "xrp-ed25519", t.XLM_ED25519 = "xlm-ed25519", t.CIP8 = "cip-8", t.MicroTransfer = "microtransfer", t.Screenshot = "screenshot", t.Connect = "connect", t))(N || {});
-class U {
+var v = Object.defineProperty;
+var g = (t, e, n) => e in t ? v(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
+var a = (t, e, n) => g(t, typeof e != "symbol" ? e + "" : e, n);
+var A = /* @__PURE__ */ ((t) => (t.PRIVATE = "WALLET", t.VASP = "VASP", t))(A || {}), y = /* @__PURE__ */ ((t) => (t.NATURAL = "natural", t.LEGAL = "legal", t.SELF = "self", t))(y || {}), I = /* @__PURE__ */ ((t) => (t.EMPTY = "empty", t.VERIFY = "verify", t.PENDING = "pending", t.VERIFIED = "verified", t.BANNED = "banned", t))(I || {}), L = /* @__PURE__ */ ((t) => (t.ALLOWED = "allowed", t.PENDING = "pending", t))(L || {}), C = /* @__PURE__ */ ((t) => (t.ASSET = "asset", t.DESTINATION = "destination", t.COUNTERPARTY = "counterparty", t.AGENT = "agent", t))(C || {}), l = /* @__PURE__ */ ((t) => (t.COMPLETE = "complete", t.RESIZE = "resize", t.RESULT = "result", t.READY = "ready", t.INVALID = "invalid", t.ERROR = "error", t.CANCEL = "cancel", t))(l || {}), N = /* @__PURE__ */ ((t) => (t.SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE", t.WALLET_CONNECTION_FAILED = "WALLET_CONNECTION_FAILED", t.WALLET_NOT_SUPPORTED = "WALLET_NOT_SUPPORTED", t.TOKEN_INVALID = "TOKEN_INVALID", t))(N || {}), E = /* @__PURE__ */ ((t) => (t.UPDATE = "update", t.REQUEST_RESPONSE = "requestResponse", t))(E || {}), b = /* @__PURE__ */ ((t) => (t.PENDING = "pending", t.FAILED = "rejected", t.FLAGGED = "flagged", t.VERIFIED = "verified", t))(b || {}), U = /* @__PURE__ */ ((t) => (t.SelfDeclaration = "self-declaration", t.SIWE = "siwe", t.SIWX = "siwx", t.EIP191 = "eip-191", t.EIP712 = "eip-712", t.EIP1271 = "eip-1271", t.BIP137 = "bip-137", t.BIP322 = "bip-322", t.BIP137_XPUB = "xpub", t.TIP191 = "tip-191", t.ED25519 = "ed25519", t.XRP_ED25519 = "xrp-ed25519", t.XLM_ED25519 = "xlm-ed25519", t.CIP8 = "cip-8", t.MicroTransfer = "microtransfer", t.Screenshot = "screenshot", t.Connect = "connect", t))(U || {});
+class _ {
   constructor() {
     a(this, "listeners", /* @__PURE__ */ new Map());
     a(this, "port");
@@ -56,8 +56,8 @@ class U {
   handleMessage(e) {
     const n = e.data;
     if (typeof n == "object" && n !== null && "type" in n) {
-      const r = n.type, i = this.listeners.get(r);
-      i && i.forEach((s) => s(n));
+      const r = n.type, s = this.listeners.get(r);
+      s && s.forEach((i) => i(n));
     }
   }
   /**
@@ -68,7 +68,7 @@ class U {
     this.port && this.port.postMessage(e);
   }
 }
-class _ {
+class x {
   /**
    * Creates an instance of EmbeddedComponent.
    * @param url - The URL of the embedded component
@@ -82,10 +82,10 @@ class _ {
     a(this, "iframe");
     a(this, "eventManager");
     a(this, "modal");
-    this._url = e, this._value = n, this._options = r, this.eventManager = new U(), this.on(l.INVALID, (i) => {
-      i.type === l.INVALID && (this._errors = i.errors, this._value = i.value);
-    }), this.on(l.RESIZE, (i) => {
-      i.type === l.RESIZE && this.iframe && (this.iframe.style.height = `${i.height}px`);
+    this._url = e, this._value = n, this._options = r, this.eventManager = new _(), this.on(l.INVALID, (s) => {
+      s.type === l.INVALID && (this._errors = s.errors, this._value = s.value);
+    }), this.on(l.RESIZE, (s) => {
+      s.type === l.RESIZE && this.iframe && (this.iframe.style.height = `${s.height}px`);
     });
   }
   /**
@@ -129,11 +129,11 @@ class _ {
    * @param parent - The parent element to embed the component into
    */
   embed(e, n = !1) {
-    var r, i;
-    this.removeEmbed(), this.iframe = document.createElement("iframe"), this.iframe.src = this.url + (n ? "" : "&embedded=true"), this.iframe.allow = "web-share; clipboard-write; hid; bluetooth;", this.iframe.style.width = "100%", this.iframe.style.height = "0px", this.iframe.style.border = "none", this.iframe.style.overflow = "hidden", this.iframe.scrolling = "no", e.appendChild(this.iframe), window.addEventListener("message", (s) => {
+    var r, s;
+    this.removeEmbed(), this.iframe = document.createElement("iframe"), this.iframe.src = this.url + (n ? "" : "&embedded=true"), this.iframe.allow = "web-share; clipboard-write; hid; bluetooth;", this.iframe.style.width = "100%", this.iframe.style.height = "0px", this.iframe.style.border = "none", this.iframe.style.overflow = "hidden", this.iframe.scrolling = "no", e.appendChild(this.iframe), window.addEventListener("message", (i) => {
       var o, c;
-      s.source === ((o = this.iframe) == null ? void 0 : o.contentWindow) && ((c = this.eventManager) == null || c.setPort(s.ports[0]));
-    }), (i = (r = this.iframe) == null ? void 0 : r.contentWindow) == null || i.focus();
+      i.source === ((o = this.iframe) == null ? void 0 : o.contentWindow) && ((c = this.eventManager) == null || c.setPort(i.ports[0]));
+    }), (s = (r = this.iframe) == null ? void 0 : r.contentWindow) == null || s.focus();
   }
   removeEmbed() {
     this.iframe && this.iframe.remove();
@@ -166,7 +166,7 @@ class _ {
    * @param value - The new transaction value
    */
   update(e, n) {
-    this._value = e, n && (this._options = n), this.send({ type: u.UPDATE, value: e, options: this._options });
+    this._value = e, n && (this._options = n), this.send({ type: E.UPDATE, value: e, options: this._options });
   }
   /**
    * Waits for the component to complete and returns the transaction response
@@ -174,15 +174,15 @@ class _ {
    */
   completion() {
     return new Promise((e, n) => {
-      let r, i, s;
+      let r, s, i;
       function o() {
-        r && r(), i && i(), s && s();
+        r && r(), s && s(), i && i();
       }
       r = this.on(l.COMPLETE, (c) => {
         e(c.response), o();
-      }), i = this.on(l.CANCEL, () => {
+      }), s = this.on(l.CANCEL, () => {
         n(new Error("User cancelled")), o();
-      }), s = this.on("error", (c) => {
+      }), i = this.on("error", (c) => {
         n(new Error(c.message)), o();
       });
     });
@@ -223,9 +223,9 @@ class _ {
       "_blank",
       "popup=true,width=600,height=600"
     );
-    window.addEventListener("message", (i) => {
-      var s;
-      i.source === e && (console.log("received message from popup", i.data), (s = this.eventManager) == null || s.setPort(i.ports[0]));
+    window.addEventListener("message", (s) => {
+      var i;
+      s.source === e && (console.log("received message from popup", s.data), (i = this.eventManager) == null || i.setPort(s.ports[0]));
     });
     const n = this.on(l.CANCEL, () => {
       e == null || e.close();
@@ -237,60 +237,60 @@ class _ {
     });
   }
 }
-function x(t) {
+function R(t) {
   return Object.entries(t).map(([e, n]) => {
     if (n == null) return;
-    const r = encodeURIComponent(e), i = encodeURIComponent(
+    const r = encodeURIComponent(e), s = encodeURIComponent(
       typeof n == "object" ? JSON.stringify(n) : String(n)
       // Use String() to handle all primitive types
     );
-    return `${r}=${i}`;
+    return `${r}=${s}`;
   }).filter((e) => e !== void 0).join("&");
 }
 function O(t) {
   const e = t.slice(1);
   return e ? e.split("&").filter(Boolean).reduce(
-    (r, i) => {
-      const [s, o] = i.split("=");
-      return s && (r[decodeURIComponent(s)] = o ? decodeURIComponent(o) : ""), r;
+    (r, s) => {
+      const [i, o] = s.split("=");
+      return i && (r[decodeURIComponent(i)] = o ? decodeURIComponent(o) : ""), r;
     },
     {}
   ) : {};
 }
-async function d(t) {
-  const e = JSON.stringify(t), n = new TextEncoder(), r = crypto.getRandomValues(new Uint8Array(32)), i = await crypto.subtle.importKey(
+async function p(t, e) {
+  const n = JSON.stringify(t), r = new TextEncoder(), s = e ? m(e) : crypto.getRandomValues(new Uint8Array(32)), i = await crypto.subtle.importKey(
     "raw",
-    r,
+    s,
     { name: "AES-GCM" },
     !1,
     ["encrypt"]
-  ), s = crypto.getRandomValues(new Uint8Array(12)), o = await crypto.subtle.encrypt(
-    { name: "AES-GCM", iv: s },
+  ), o = crypto.getRandomValues(new Uint8Array(12)), c = await crypto.subtle.encrypt(
+    { name: "AES-GCM", iv: o },
     i,
-    n.encode(e)
+    r.encode(n)
   );
   return {
-    ciphertext: `${h(s)}-${h(o)}`,
-    key: h(r)
+    ciphertext: `${u(o)}-${u(c)}`,
+    key: u(s)
   };
 }
-async function D({ ciphertext: t, key: e }) {
-  const [n, r] = t.split("-"), i = new Uint8Array(
-    atob(e).split("").map((f) => f.charCodeAt(0))
-  ), s = m(n), o = m(r), c = await crypto.subtle.importKey(
+async function f({ ciphertext: t, key: e }) {
+  const [n, r] = t.split("-"), s = new Uint8Array(
+    atob(e).split("").map((w) => w.charCodeAt(0))
+  ), i = m(n), o = m(r), c = await crypto.subtle.importKey(
     "raw",
-    i,
+    s,
     { name: "AES-GCM" },
     !1,
     ["decrypt"]
-  ), p = new TextDecoder(), E = await crypto.subtle.decrypt(
-    { name: "AES-GCM", iv: new Uint8Array(s) },
+  ), h = new TextDecoder(), d = await crypto.subtle.decrypt(
+    { name: "AES-GCM", iv: new Uint8Array(i) },
     c,
     o
   );
-  return JSON.parse(p.decode(E));
+  return JSON.parse(h.decode(d));
 }
-function h(t) {
+function u(t) {
   const e = new Uint8Array(t);
   let n = "";
   for (let r = 0; r < e.length; r++)
@@ -303,7 +303,28 @@ function m(t) {
     n[r] = e.charCodeAt(r);
   return n;
 }
-class M {
+async function M(t) {
+  const e = await fetch(t.url, {
+    method: "GET"
+  });
+  if (!e.ok)
+    throw new Error(`Failed to get connection: ${await e.text()}`);
+  const n = await e.json();
+  if (!n.sealed)
+    throw new Error("No data found");
+  const r = n.sealed[n.sealed.length - 1], s = await f({
+    ciphertext: r,
+    key: t.key
+  });
+  return {
+    id: n.id,
+    metadata: n.metadata,
+    status: n.status,
+    tx: s.tx,
+    result: s.result
+  };
+}
+class S {
   constructor(e) {
     a(this, "endpoint");
     this.endpoint = e;
@@ -315,22 +336,23 @@ class M {
    * @returns Promise resolving to connection details including ID, version, and encryption key
    */
   async create(e, n) {
-    const r = await d(e), i = {
+    const r = await p(e), s = {
       metadata: n,
       sealed: r.ciphertext
-    }, s = await fetch(this.endpoint, {
+    }, i = await fetch(this.endpoint, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
-      body: JSON.stringify(i)
+      body: JSON.stringify(s)
     });
-    if (!s.ok)
-      throw new Error(`Failed to create connection: ${await s.text()}`);
-    const o = await s.json();
+    if (!i.ok)
+      throw new Error(`Failed to create connection: ${await i.text()}`);
+    const o = await i.json();
     return {
       id: o.id,
       version: o.version,
+      status: o.status,
       metadata: n,
       data: e,
       key: r.key
@@ -343,26 +365,28 @@ class M {
    * @param version Current version number
    * @returns Promise resolving to updated connection details including new encryption key
    */
-  async update(e, n, r) {
-    const i = await d(n), s = {
-      sealed: i.ciphertext,
-      version: r
-    }, o = await fetch(`${this.endpoint}/${e}`, {
+  async update(e, n, r, s, i) {
+    const o = await p(n, i), c = {
+      sealed: o.ciphertext,
+      version: r,
+      status: s
+    }, h = await fetch(`${this.endpoint}/${e}`, {
       method: "PATCH",
       headers: {
         "Content-Type": "application/json"
       },
-      body: JSON.stringify(s)
+      body: JSON.stringify(c)
     });
-    if (!o.ok)
-      throw new Error(`Failed to update connection: ${await o.text()}`);
-    const c = await o.json();
+    if (!h.ok)
+      throw new Error(`Failed to update connection: ${await h.text()}`);
+    const d = await h.json();
     return {
-      id: c.id,
-      metadata: c.metadata,
-      version: c.version,
+      id: d.id,
+      metadata: d.metadata,
+      version: d.version,
+      status: d.status,
       data: n,
-      key: i.key
+      key: o.key
     };
   }
   /**
@@ -377,14 +401,15 @@ class M {
     });
     if (!r.ok)
       throw new Error(`Failed to get connection: ${await r.text()}`);
-    const i = await r.json(), s = i.sealed[i.sealed.length - 1], o = await D({
-      ciphertext: s,
+    const s = await r.json(), i = s.sealed[s.sealed.length - 1], o = await f({
+      ciphertext: i,
       key: n
     });
     return {
-      id: i.id,
-      version: i.version,
-      metadata: i.metadata,
+      id: s.id,
+      status: s.status,
+      version: s.version,
+      metadata: s.metadata,
       data: o,
       key: n
     };
@@ -401,7 +426,7 @@ class M {
       throw new Error(`Failed to close connection: ${await n.text()}`);
   }
 }
-class S {
+class k {
   /**
    * Creates a new instance of the Notabene SDK
    *
@@ -425,15 +450,15 @@ class S {
    * @returns component URL
    * @internal
    */
-  componentUrl(e, n, r, i) {
-    const s = new URL(this.uxUrl);
-    s.pathname = e;
-    const o = x({
+  componentUrl(e, n, r, s) {
+    const i = new URL(this.uxUrl);
+    i.pathname = e;
+    const o = R({
       authToken: this.authToken,
       value: n,
       configuration: r
     });
-    return s.hash = o, this.nodeUrl && s.searchParams.set("nodeUrl", this.nodeUrl), this.theme && s.searchParams.set("theme", JSON.stringify(this.theme)), this.locale && s.searchParams.set("locale", this.locale), i && (i.callback && s.searchParams.set("callback_url", i.callback), i.redirectUri && s.searchParams.set("redirect_uri", i.redirectUri)), s.toString();
+    return i.hash = o, this.nodeUrl && i.searchParams.set("nodeUrl", this.nodeUrl), this.theme && i.searchParams.set("theme", JSON.stringify(this.theme)), this.locale && i.searchParams.set("locale", this.locale), s && (s.callback && i.searchParams.set("callback_url", s.callback), s.redirectUri && i.searchParams.set("redirect_uri", s.redirectUri)), i.toString();
   }
   /**
    * Creates a new embedded component
@@ -445,9 +470,9 @@ class S {
    * @returns A new EmbeddedComponent instance
    * @internal
    */
-  createComponent(e, n, r, i) {
-    return new _(
-      this.componentUrl(e, n, r, i),
+  createComponent(e, n, r, s) {
+    return new x(
+      this.componentUrl(e, n, r, s),
       n,
       r
     );
@@ -523,16 +548,17 @@ class S {
 export {
   A as AgentType,
   l as CMType,
-  M as ConnectionManager,
-  _ as EmbeddedComponent,
-  C as ErrorIdentifierCode,
-  u as HMType,
-  g as PersonType,
+  S as ConnectionManager,
+  x as EmbeddedComponent,
+  N as ErrorIdentifierCode,
+  E as HMType,
+  y as PersonType,
   b as ProofStatus,
-  N as ProofTypes,
-  y as Status,
-  I as VASPSearchControl,
-  L as ValidationSections,
+  U as ProofTypes,
+  I as Status,
+  L as VASPSearchControl,
+  C as ValidationSections,
   O as decodeFragmentToObject,
-  S as default
+  k as default,
+  M as getRefreshResult
 };

package/package.json

@@ -10,7 +10,7 @@
   "author": "Notabene <developers@notabene.id>",
   "license": "MIT",
   "packageManager": "yarn@4.5.1",
-  "version": "2.9.0-next.1",
+  "version": "2.9.0-next.2",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",

package/src/notabene.ts

@@ -39,6 +39,7 @@ import type {
   NotabeneAsset,
   OwnershipProof,
   Ready,
+  RefreshSource,
   ResizeRequest,
   ScreenshotProof,
   SignatureProof,
@@ -75,9 +76,12 @@ import { decodeFragmentToObject, encodeObjectToFragment } from './utils/urls';
 export { default as EmbeddedComponent } from './components/EmbeddedComponent';
 export {
   ConnectionManager,
+  getRefreshResult,
   type ConnectionData,
   type ConnectionMetadata,
   type ConnectionResponse,
+  type ConnectionResult,
+  type ConnectionStatus,
   type TransactionType,
 } from './utils/connections';
 export {
@@ -134,6 +138,7 @@ export type {
   NotabeneAsset,
   OwnershipProof,
   Ready,
+  RefreshSource,
   ResizeRequest,
   ScreenshotProof,
   SignatureProof,

package/src/utils/__tests__/connections.test.ts

@@ -68,6 +68,7 @@ describe('ConnectionManager', () => {
             const mockResponse = {
               id: 'test-id',
               version: 1,
+              status: 'active',
               metadata,
               sealed: ['encrypted-data'],
             };
@@ -92,6 +93,7 @@ describe('ConnectionManager', () => {
             expect(result).toEqual({
               id: mockResponse.id,
               metadata: mockResponse.metadata,
+              status: mockResponse.status,
               version: mockResponse.version,
               data: request,
               key: expect.any(String),
@@ -124,6 +126,9 @@ describe('ConnectionManager', () => {
 
   describe('update', () => {
     it('should successfully update an existing connection', async () => {
+      const testData = { requestId: 'test-123' };
+      const sealed = await seal(testData);
+
       await fc.assert(
         fc.asyncProperty(
           fc.uuid(),
@@ -134,8 +139,9 @@ describe('ConnectionManager', () => {
             const mockResponse = {
               id,
               metadata: arbConnectionMetadata,
+              status: 'completed',
               version: version + 1,
-              sealed: ['new-encrypted-data'],
+              sealed: [sealed.ciphertext],
             };
 
             fetchMock.mockResolvedValueOnce({
@@ -143,7 +149,13 @@ describe('ConnectionManager', () => {
               json: async () => mockResponse,
             });
 
-            const result = await manager.update(id, request, version);
+            const result = await manager.update(
+              id,
+              request,
+              version,
+              'completed',
+              sealed.key,
+            );
 
             // Verify fetch was called correctly
             expect(fetchMock).toHaveBeenCalledWith(`${testEndpoint}/${id}`, {
@@ -158,16 +170,19 @@ describe('ConnectionManager', () => {
             expect(result).toEqual({
               id: mockResponse.id,
               version: mockResponse.version,
+              status: mockResponse.status,
               metadata: mockResponse.metadata,
               data: request,
-              key: expect.any(String),
+              key: sealed.key,
             });
           },
         ),
       );
     });
 
-    it('should throw error on failed update', async () => {
+    it('should throw error on failed update due to invalid key', async () => {
+      const { key: newKey } = await seal('testData');
+
       await fc.assert(
         fc.asyncProperty(
           fc.uuid(),
@@ -180,9 +195,9 @@ describe('ConnectionManager', () => {
               text: async () => 'Update failed',
             });
 
-            await expect(manager.update(id, request, version)).rejects.toThrow(
-              'Failed to update connection',
-            );
+            await expect(
+              manager.update(id, request, version, 'active', newKey),
+            ).rejects.toThrow('Failed to update connection');
           },
         ),
       );
@@ -201,6 +216,7 @@ describe('ConnectionManager', () => {
           const mockResponse = {
             id,
             version: 1,
+            status: 'active',
             metadata: arbConnectionMetadata,
             sealed: [sealed.ciphertext], // Use the real ciphertext
           };
@@ -221,6 +237,7 @@ describe('ConnectionManager', () => {
           expect(result).toEqual({
             id: mockResponse.id,
             version: mockResponse.version,
+            status: mockResponse.status,
             metadata: mockResponse.metadata,
             data: testData, // Should match our original test data
             key: sealed.key,

package/src/utils/connections.ts

@@ -1,11 +1,19 @@
-import type { ComponentRequest, TransactionOptions, UUID } from '../types';
+import type {
+  ComponentRequest,
+  RefreshSource,
+  TransactionOptions,
+  TransactionResponse,
+  UUID,
+} from '../types';
 import { seal, unseal } from './encryption';
 
 export type TransactionType = 'withdraw' | 'deposit';
+export type ConnectionStatus = 'active' | 'completed' | 'closed';
 export interface ConnectionData<T extends ComponentRequest> {
   tx: T;
   authToken?: string;
   txOptions?: TransactionOptions;
+  result?: TransactionResponse<T>;
 }
 
 export interface ConnectionMetadata {
@@ -16,11 +24,55 @@ export interface ConnectionMetadata {
 export interface ConnectionResponse<T extends ComponentRequest> {
   id: UUID;
   version: number;
+  status: ConnectionStatus;
   metadata: ConnectionMetadata;
   data: ConnectionData<T>;
   key: string;
 }
 
+export interface ConnectionResult<T extends ComponentRequest> {
+  id: UUID;
+  metadata: ConnectionMetadata;
+  status: ConnectionStatus;
+  tx: T;
+  result?: TransactionResponse<T>;
+}
+
+export async function getRefreshResult<T extends ComponentRequest>(
+  refreshSource: RefreshSource,
+): Promise<ConnectionResult<T>> {
+  const response = await fetch(refreshSource.url, {
+    method: 'GET',
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to get connection: ${await response.text()}`);
+  }
+
+  const result = await response.json();
+
+  if (!result.sealed) {
+    throw new Error('No data found');
+  }
+
+  // Get the latest sealed data
+  const latestSealed = result.sealed[result.sealed.length - 1];
+
+  // Decrypt the data
+  const data = await unseal<ConnectionData<T>>({
+    ciphertext: latestSealed,
+    key: refreshSource.key,
+  });
+
+  return {
+    id: result.id,
+    metadata: result.metadata,
+    status: result.status,
+    tx: data.tx,
+    result: data.result,
+  };
+}
+
 /**
  * Manages encrypted connections using Cloudflare Durable Objects
  */
@@ -68,6 +120,7 @@ export class ConnectionManager {
     return {
       id: result.id,
       version: result.version,
+      status: result.status,
       metadata: metadata,
       data: data,
       key: sealed.key,
@@ -85,14 +138,17 @@ export class ConnectionManager {
     id: UUID,
     data: ConnectionData<T>,
     version: number,
+    status: ConnectionStatus,
+    key: string,
   ): Promise<ConnectionResponse<T>> {
     // Encrypt the new data
-    const sealed = await seal(data);
+    const sealed = await seal(data, key);
 
     // Prepare the request body
     const body = {
       sealed: sealed.ciphertext,
       version,
+      status,
     };
 
     // Update the connection
@@ -114,6 +170,7 @@ export class ConnectionManager {
       id: result.id,
       metadata: result.metadata,
       version: result.version,
+      status: result.status,
       data: data,
       key: sealed.key,
     };
@@ -151,6 +208,7 @@ export class ConnectionManager {
 
     return {
       id: result.id,
+      status: result.status,
       version: result.version,
       metadata: result.metadata,
       data,

package/src/utils/encryption.ts

@@ -14,13 +14,15 @@ export interface Sealed {
  * @param data Data to encrypt
  * @returns Promise resolving to a Sealed object containing ciphertext and key
  */
-export async function seal<T>(data: T): Promise<Sealed> {
+export async function seal<T>(data: T, existingKey?: string): Promise<Sealed> {
   // Convert the object to a JSON string
   const plaintext = JSON.stringify(data);
   const encoder = new TextEncoder();
 
-  // Generate a random encryption key and IV
-  const rawKey = crypto.getRandomValues(new Uint8Array(32)); // 256-bit key
+  // Restore or generate a random encryption key
+  const rawKey = existingKey
+    ? base64ToUint8Array(existingKey)
+    : crypto.getRandomValues(new Uint8Array(32));
   const key = await crypto.subtle.importKey(
     'raw',
     rawKey,