@notabene/javascript-sdk 2.7.0 → 2.8.0-next.1

package/dist/notabene.cjs

@@ -1 +1 @@
-"use strict";var L=Object.defineProperty;var A=(e,t,r)=>t in e?L(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r;var o=(e,t,r)=>A(e,typeof t!="symbol"?t+"":t,r);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var c=(e=>(e.PRIVATE="WALLET",e.VASP="VASP",e))(c||{}),m=(e=>(e.NATURAL="natural",e.LEGAL="legal",e.SELF="self",e))(m||{}),u=(e=>(e.EMPTY="empty",e.VERIFY="verify",e.PENDING="pending",e.VERIFIED="verified",e.BANNED="banned",e))(u||{}),E=(e=>(e.ALLOWED="allowed",e.PENDING="pending",e))(E||{}),p=(e=>(e.ASSET="asset",e.DESTINATION="destination",e.COUNTERPARTY="counterparty",e.AGENT="agent",e))(p||{}),a=(e=>(e.COMPLETE="complete",e.RESIZE="resize",e.RESULT="result",e.READY="ready",e.INVALID="invalid",e.ERROR="error",e.CANCEL="cancel",e))(a||{}),f=(e=>(e.SERVICE_UNAVAILABLE="SERVICE_UNAVAILABLE",e.WALLET_CONNECTION_FAILED="WALLET_CONNECTION_FAILED",e.WALLET_NOT_SUPPORTED="WALLET_NOT_SUPPORTED",e.TOKEN_INVALID="TOKEN_INVALID",e))(f||{}),d=(e=>(e.UPDATE="update",e.REQUEST_RESPONSE="requestResponse",e))(d||{}),v=(e=>(e.PENDING="pending",e.FAILED="rejected",e.FLAGGED="flagged",e.VERIFIED="verified",e))(v||{}),I=(e=>(e.SelfDeclaration="self-declaration",e.SIWE="siwe",e.SIWX="siwx",e.EIP191="eip-191",e.EIP712="eip-712",e.EIP1271="eip-1271",e.BIP137="bip-137",e.BIP322="bip-322",e.BIP137_XPUB="xpub",e.TIP191="tip-191",e.ED25519="ed25519",e.CIP8="cip-8",e.MicroTransfer="microtransfer",e.Screenshot="screenshot",e.Connect="connect",e))(I||{});class N{constructor(){o(this,"listeners",new Map);o(this,"port");this.handleMessage=this.handleMessage.bind(this)}setPort(t){this.port=t,this.port.onmessage=this.handleMessage,this.port.start()}on(t,r){return this.listeners.has(t)||this.listeners.set(t,new Set),this.listeners.get(t).add(r),()=>this.off(t,r)}off(t,r){const s=this.listeners.get(t);s&&(s.delete(r),s.size===0&&this.listeners.delete(t))}handleMessage(t){const r=t.data;if(typeof r=="object"&&r!==null&&"type"in r){const s=r.type,i=this.listeners.get(s);i&&i.forEach(n=>n(r))}}send(t){this.port&&this.port.postMessage(t)}}class g{constructor(t,r,s){o(this,"_url");o(this,"_value");o(this,"_options");o(this,"_errors",[]);o(this,"iframe");o(this,"eventManager");o(this,"modal");this._url=t,this._value=r,this._options=s,this.eventManager=new N,this.on(a.INVALID,i=>{i.type===a.INVALID&&(this._errors=i.errors,this._value=i.value)}),this.on(a.RESIZE,i=>{i.type===a.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(t){const r=document.querySelector(t);if(!r)throw new Error(`parentID ${t} not found`);this.embed(r)}embed(t,r=!1){var s,i;this.removeEmbed(),this.iframe=document.createElement("iframe"),this.iframe.src=this.url+(r?"":"&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",t.appendChild(this.iframe),window.addEventListener("message",n=>{var l,h;n.source===((l=this.iframe)==null?void 0:l.contentWindow)&&((h=this.eventManager)==null||h.setPort(n.ports[0]))}),(i=(s=this.iframe)==null?void 0:s.contentWindow)==null||i.focus()}removeEmbed(){this.iframe&&this.iframe.remove()}send(t){this.eventManager.send(t)}on(t,r){return this.eventManager.on(t,r)}off(t,r){this.eventManager.off(t,r)}update(t,r){this._value=t,r&&(this._options=r),this.send({type:d.UPDATE,value:t,options:this._options})}completion(){return new Promise((t,r)=>{let s,i,n;function l(){s&&s(),i&&i(),n&&n()}s=this.on(a.COMPLETE,h=>{t(h.response),l()}),i=this.on(a.CANCEL,()=>{r(new Error("User cancelled")),l()}),n=this.on("error",h=>{r(new Error(h.message)),l()})})}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 t=this.on(a.CANCEL,()=>{this.closeModal()}),r=this.on(a.COMPLETE,()=>{this.closeModal()});return this.modal.showModal(),this.modal.addEventListener("click",()=>{this.closeModal()}),this.completion().finally(()=>{t(),r()})}closeModal(){var t;this.modal&&((t=this.modal)==null||t.close(),this.modal.remove(),this.modal=void 0)}async popup(){const t=window.open(this.url,"_blank","popup=true,width=600,height=600");window.addEventListener("message",i=>{var n;i.source===t&&(console.log("received message from popup",i.data),(n=this.eventManager)==null||n.setPort(i.ports[0]))});const r=this.on(a.CANCEL,()=>{t==null||t.close()}),s=this.on(a.COMPLETE,()=>{t==null||t.close()});return this.completion().finally(()=>{r(),s()})}}function w(e){return Object.entries(e).map(([t,r])=>{if(r==null)return;const s=encodeURIComponent(t),i=encodeURIComponent(typeof r=="object"?JSON.stringify(r):String(r));return`${s}=${i}`}).filter(t=>t!==void 0).join("&")}function C(e){const t=e.slice(1);return t?t.split("&").filter(Boolean).reduce((s,i)=>{const[n,l]=i.split("=");return n&&(s[decodeURIComponent(n)]=l?decodeURIComponent(l):""),s},{}):{}}class _{constructor(t){o(this,"nodeUrl");o(this,"authToken");o(this,"uxUrl");o(this,"theme");o(this,"locale");this.uxUrl=t.uxUrl||"https://connect.notabene.id",this.nodeUrl=t.nodeUrl,this.authToken=t.authToken,this.theme=t.theme,this.locale=t.locale}componentUrl(t,r,s,i){const n=new URL(this.uxUrl);n.pathname=t;const l=w({authToken:this.authToken,value:r,configuration:s});return n.hash=l,this.nodeUrl&&n.searchParams.set("nodeUrl",this.nodeUrl),this.theme&&n.searchParams.set("theme",JSON.stringify(this.theme)),this.locale&&n.searchParams.set("locale",this.locale),i&&(i.callback&&n.searchParams.set("callback_url",i.callback),i.redirectUri&&n.searchParams.set("redirect_uri",i.redirectUri)),n.toString()}createComponent(t,r,s,i){return new g(this.componentUrl(t,r,s,i),r,s)}createWithdrawalAssist(t,r,s){return this.createComponent("withdrawal-assist",t,r,s)}createConnectWallet(t,r,s){return this.createComponent("connect",t,r,s)}createDepositRequest(t,r,s){return this.createComponent("deposit-request",t,r,s)}createDepositAssist(t,r,s){return this.createComponent("deposit-assist",t,r,s)}}exports.AgentType=c;exports.CMType=a;exports.EmbeddedComponent=g;exports.ErrorIdentifierCode=f;exports.HMType=d;exports.PersonType=m;exports.ProofStatus=v;exports.ProofTypes=I;exports.Status=u;exports.VASPSearchControl=E;exports.ValidationSections=p;exports.decodeFragmentToObject=C;exports.default=_;
+"use strict";var L=Object.defineProperty;var A=(e,t,r)=>t in e?L(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r;var o=(e,t,r)=>A(e,typeof t!="symbol"?t+"":t,r);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var c=(e=>(e.PRIVATE="WALLET",e.VASP="VASP",e))(c||{}),m=(e=>(e.NATURAL="natural",e.LEGAL="legal",e.SELF="self",e))(m||{}),u=(e=>(e.EMPTY="empty",e.VERIFY="verify",e.PENDING="pending",e.VERIFIED="verified",e.BANNED="banned",e))(u||{}),E=(e=>(e.ALLOWED="allowed",e.PENDING="pending",e))(E||{}),p=(e=>(e.ASSET="asset",e.DESTINATION="destination",e.COUNTERPARTY="counterparty",e.AGENT="agent",e))(p||{}),a=(e=>(e.COMPLETE="complete",e.RESIZE="resize",e.RESULT="result",e.READY="ready",e.INVALID="invalid",e.ERROR="error",e.CANCEL="cancel",e))(a||{}),f=(e=>(e.SERVICE_UNAVAILABLE="SERVICE_UNAVAILABLE",e.WALLET_CONNECTION_FAILED="WALLET_CONNECTION_FAILED",e.WALLET_NOT_SUPPORTED="WALLET_NOT_SUPPORTED",e.TOKEN_INVALID="TOKEN_INVALID",e))(f||{}),d=(e=>(e.UPDATE="update",e.REQUEST_RESPONSE="requestResponse",e))(d||{}),v=(e=>(e.PENDING="pending",e.FAILED="rejected",e.FLAGGED="flagged",e.VERIFIED="verified",e))(v||{}),I=(e=>(e.SelfDeclaration="self-declaration",e.SIWE="siwe",e.SIWX="siwx",e.EIP191="eip-191",e.EIP712="eip-712",e.EIP1271="eip-1271",e.BIP137="bip-137",e.BIP322="bip-322",e.BIP137_XPUB="xpub",e.TIP191="tip-191",e.ED25519="ed25519",e.XRP_ED25519="xrp-ed25519",e.CIP8="cip-8",e.MicroTransfer="microtransfer",e.Screenshot="screenshot",e.Connect="connect",e))(I||{});class N{constructor(){o(this,"listeners",new Map);o(this,"port");this.handleMessage=this.handleMessage.bind(this)}setPort(t){this.port=t,this.port.onmessage=this.handleMessage,this.port.start()}on(t,r){return this.listeners.has(t)||this.listeners.set(t,new Set),this.listeners.get(t).add(r),()=>this.off(t,r)}off(t,r){const i=this.listeners.get(t);i&&(i.delete(r),i.size===0&&this.listeners.delete(t))}handleMessage(t){const r=t.data;if(typeof r=="object"&&r!==null&&"type"in r){const i=r.type,s=this.listeners.get(i);s&&s.forEach(n=>n(r))}}send(t){this.port&&this.port.postMessage(t)}}class g{constructor(t,r,i){o(this,"_url");o(this,"_value");o(this,"_options");o(this,"_errors",[]);o(this,"iframe");o(this,"eventManager");o(this,"modal");this._url=t,this._value=r,this._options=i,this.eventManager=new N,this.on(a.INVALID,s=>{s.type===a.INVALID&&(this._errors=s.errors,this._value=s.value)}),this.on(a.RESIZE,s=>{s.type===a.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(t){const r=document.querySelector(t);if(!r)throw new Error(`parentID ${t} not found`);this.embed(r)}embed(t,r=!1){var i,s;this.removeEmbed(),this.iframe=document.createElement("iframe"),this.iframe.src=this.url+(r?"":"&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",t.appendChild(this.iframe),window.addEventListener("message",n=>{var l,h;n.source===((l=this.iframe)==null?void 0:l.contentWindow)&&((h=this.eventManager)==null||h.setPort(n.ports[0]))}),(s=(i=this.iframe)==null?void 0:i.contentWindow)==null||s.focus()}removeEmbed(){this.iframe&&this.iframe.remove()}send(t){this.eventManager.send(t)}on(t,r){return this.eventManager.on(t,r)}off(t,r){this.eventManager.off(t,r)}update(t,r){this._value=t,r&&(this._options=r),this.send({type:d.UPDATE,value:t,options:this._options})}completion(){return new Promise((t,r)=>{let i,s,n;function l(){i&&i(),s&&s(),n&&n()}i=this.on(a.COMPLETE,h=>{t(h.response),l()}),s=this.on(a.CANCEL,()=>{r(new Error("User cancelled")),l()}),n=this.on("error",h=>{r(new Error(h.message)),l()})})}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 t=this.on(a.CANCEL,()=>{this.closeModal()}),r=this.on(a.COMPLETE,()=>{this.closeModal()});return this.modal.showModal(),this.modal.addEventListener("click",()=>{this.closeModal()}),this.completion().finally(()=>{t(),r()})}closeModal(){var t;this.modal&&((t=this.modal)==null||t.close(),this.modal.remove(),this.modal=void 0)}async popup(){const t=window.open(this.url,"_blank","popup=true,width=600,height=600");window.addEventListener("message",s=>{var n;s.source===t&&(console.log("received message from popup",s.data),(n=this.eventManager)==null||n.setPort(s.ports[0]))});const r=this.on(a.CANCEL,()=>{t==null||t.close()}),i=this.on(a.COMPLETE,()=>{t==null||t.close()});return this.completion().finally(()=>{r(),i()})}}function _(e){return Object.entries(e).map(([t,r])=>{if(r==null)return;const i=encodeURIComponent(t),s=encodeURIComponent(typeof r=="object"?JSON.stringify(r):String(r));return`${i}=${s}`}).filter(t=>t!==void 0).join("&")}function w(e){const t=e.slice(1);return t?t.split("&").filter(Boolean).reduce((i,s)=>{const[n,l]=s.split("=");return n&&(i[decodeURIComponent(n)]=l?decodeURIComponent(l):""),i},{}):{}}class C{constructor(t){o(this,"nodeUrl");o(this,"authToken");o(this,"uxUrl");o(this,"theme");o(this,"locale");this.uxUrl=t.uxUrl||"https://connect.notabene.id",this.nodeUrl=t.nodeUrl,this.authToken=t.authToken,this.theme=t.theme,this.locale=t.locale}componentUrl(t,r,i,s){const n=new URL(this.uxUrl);n.pathname=t;const l=_({authToken:this.authToken,value:r,configuration:i});return n.hash=l,this.nodeUrl&&n.searchParams.set("nodeUrl",this.nodeUrl),this.theme&&n.searchParams.set("theme",JSON.stringify(this.theme)),this.locale&&n.searchParams.set("locale",this.locale),s&&(s.callback&&n.searchParams.set("callback_url",s.callback),s.redirectUri&&n.searchParams.set("redirect_uri",s.redirectUri)),n.toString()}createComponent(t,r,i,s){return new g(this.componentUrl(t,r,i,s),r,i)}createWithdrawalAssist(t,r,i){return this.createComponent("withdrawal-assist",t,r,i)}createConnectWallet(t,r,i){return this.createComponent("connect",t,r,i)}createDepositRequest(t,r,i){return this.createComponent("deposit-request",t,r,i)}createDepositAssist(t,r,i){return this.createComponent("deposit-assist",t,r,i)}}exports.AgentType=c;exports.CMType=a;exports.EmbeddedComponent=g;exports.ErrorIdentifierCode=f;exports.HMType=d;exports.PersonType=m;exports.ProofStatus=v;exports.ProofTypes=I;exports.Status=u;exports.VASPSearchControl=E;exports.ValidationSections=p;exports.decodeFragmentToObject=w;exports.default=C;

package/dist/notabene.d.ts

@@ -383,7 +383,7 @@ export declare function decodeFragmentToObject(fragment: string): Record<string,
  * An object representing a deposit transaction
  * @public
  */
-export declare interface Deposit extends OriginatorFields, DepositTransaction {
+export declare interface Deposit extends OriginatorFields, DepositTransaction, Refreshable {
 }
 
 /**
@@ -1225,6 +1225,7 @@ export declare enum ProofStatus {
  * - BIP322: Bitcoin message signature following BIP-322
  * - TIP191: Tron message signing
  * - ED25519: Ed25519 signature (used in Solana)
+ * - XRP_ED25519: Ed25519 signature (used in XRP)
  * - XPUB: Extended public key signature for HD wallets
  * - MicroTransfer: Proof via small blockchain transaction
  * - Screenshot: Image proof of ownership/access
@@ -1248,6 +1249,7 @@ export declare enum ProofTypes {
     BIP137_XPUB = "xpub",
     TIP191 = "tip-191",
     ED25519 = "ed25519",
+    XRP_ED25519 = "xrp-ed25519",
     CIP8 = "cip-8",
     MicroTransfer = "microtransfer",
     Screenshot = "screenshot",
@@ -1262,6 +1264,15 @@ export declare type Ready = {
     type: CMType.READY;
 };
 
+declare interface Refreshable {
+    refreshSource?: RefreshSource;
+}
+
+declare interface RefreshSource {
+    url: URI;
+    key: string;
+}
+
 declare type RequestID = UUID;
 
 /**
@@ -1628,7 +1639,7 @@ export declare interface Wallet extends Agent {
  * An object representing a withdrawal transaction
  * @public
  */
-export declare interface Withdrawal extends BeneficiaryFields, Transaction {
+export declare interface Withdrawal extends BeneficiaryFields, Transaction, Refreshable {
 }
 
 export { }

package/dist/notabene.js

@@ -1,7 +1,7 @@
 var c = Object.defineProperty;
 var m = (e, t, r) => t in e ? c(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
 var o = (e, t, r) => m(e, typeof t != "symbol" ? t + "" : t, r);
-var u = /* @__PURE__ */ ((e) => (e.PRIVATE = "WALLET", e.VASP = "VASP", e))(u || {}), E = /* @__PURE__ */ ((e) => (e.NATURAL = "natural", e.LEGAL = "legal", e.SELF = "self", e))(E || {}), f = /* @__PURE__ */ ((e) => (e.EMPTY = "empty", e.VERIFY = "verify", e.PENDING = "pending", e.VERIFIED = "verified", e.BANNED = "banned", e))(f || {}), p = /* @__PURE__ */ ((e) => (e.ALLOWED = "allowed", e.PENDING = "pending", e))(p || {}), v = /* @__PURE__ */ ((e) => (e.ASSET = "asset", e.DESTINATION = "destination", e.COUNTERPARTY = "counterparty", e.AGENT = "agent", e))(v || {}), h = /* @__PURE__ */ ((e) => (e.COMPLETE = "complete", e.RESIZE = "resize", e.RESULT = "result", e.READY = "ready", e.INVALID = "invalid", e.ERROR = "error", e.CANCEL = "cancel", e))(h || {}), I = /* @__PURE__ */ ((e) => (e.SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE", e.WALLET_CONNECTION_FAILED = "WALLET_CONNECTION_FAILED", e.WALLET_NOT_SUPPORTED = "WALLET_NOT_SUPPORTED", e.TOKEN_INVALID = "TOKEN_INVALID", e))(I || {}), d = /* @__PURE__ */ ((e) => (e.UPDATE = "update", e.REQUEST_RESPONSE = "requestResponse", e))(d || {}), L = /* @__PURE__ */ ((e) => (e.PENDING = "pending", e.FAILED = "rejected", e.FLAGGED = "flagged", e.VERIFIED = "verified", e))(L || {}), g = /* @__PURE__ */ ((e) => (e.SelfDeclaration = "self-declaration", e.SIWE = "siwe", e.SIWX = "siwx", e.EIP191 = "eip-191", e.EIP712 = "eip-712", e.EIP1271 = "eip-1271", e.BIP137 = "bip-137", e.BIP322 = "bip-322", e.BIP137_XPUB = "xpub", e.TIP191 = "tip-191", e.ED25519 = "ed25519", e.CIP8 = "cip-8", e.MicroTransfer = "microtransfer", e.Screenshot = "screenshot", e.Connect = "connect", e))(g || {});
+var u = /* @__PURE__ */ ((e) => (e.PRIVATE = "WALLET", e.VASP = "VASP", e))(u || {}), E = /* @__PURE__ */ ((e) => (e.NATURAL = "natural", e.LEGAL = "legal", e.SELF = "self", e))(E || {}), p = /* @__PURE__ */ ((e) => (e.EMPTY = "empty", e.VERIFY = "verify", e.PENDING = "pending", e.VERIFIED = "verified", e.BANNED = "banned", e))(p || {}), f = /* @__PURE__ */ ((e) => (e.ALLOWED = "allowed", e.PENDING = "pending", e))(f || {}), v = /* @__PURE__ */ ((e) => (e.ASSET = "asset", e.DESTINATION = "destination", e.COUNTERPARTY = "counterparty", e.AGENT = "agent", e))(v || {}), h = /* @__PURE__ */ ((e) => (e.COMPLETE = "complete", e.RESIZE = "resize", e.RESULT = "result", e.READY = "ready", e.INVALID = "invalid", e.ERROR = "error", e.CANCEL = "cancel", e))(h || {}), I = /* @__PURE__ */ ((e) => (e.SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE", e.WALLET_CONNECTION_FAILED = "WALLET_CONNECTION_FAILED", e.WALLET_NOT_SUPPORTED = "WALLET_NOT_SUPPORTED", e.TOKEN_INVALID = "TOKEN_INVALID", e))(I || {}), d = /* @__PURE__ */ ((e) => (e.UPDATE = "update", e.REQUEST_RESPONSE = "requestResponse", e))(d || {}), L = /* @__PURE__ */ ((e) => (e.PENDING = "pending", e.FAILED = "rejected", e.FLAGGED = "flagged", e.VERIFIED = "verified", e))(L || {}), g = /* @__PURE__ */ ((e) => (e.SelfDeclaration = "self-declaration", e.SIWE = "siwe", e.SIWX = "siwx", e.EIP191 = "eip-191", e.EIP712 = "eip-712", e.EIP1271 = "eip-1271", e.BIP137 = "bip-137", e.BIP322 = "bip-322", e.BIP137_XPUB = "xpub", e.TIP191 = "tip-191", e.ED25519 = "ed25519", e.XRP_ED25519 = "xrp-ed25519", e.CIP8 = "cip-8", e.MicroTransfer = "microtransfer", e.Screenshot = "screenshot", e.Connect = "connect", e))(g || {});
 class A {
   constructor() {
     o(this, "listeners", /* @__PURE__ */ new Map());
@@ -385,8 +385,8 @@ export {
   E as PersonType,
   L as ProofStatus,
   g as ProofTypes,
-  f as Status,
-  p as VASPSearchControl,
+  p as Status,
+  f as VASPSearchControl,
   v as ValidationSections,
   C as decodeFragmentToObject,
   U as default

package/package.json

@@ -10,7 +10,7 @@
   "author": "Notabene <developers@notabene.id>",
   "license": "MIT",
   "packageManager": "yarn@4.5.1",
-  "version": "2.7.0",
+  "version": "2.8.0-next.1",
   "source": "src/notabene.ts",
   "main": "dist/notabene.js",
   "types": "dist/notabene.d.ts",

package/src/__tests__/EmbeddedComponent.test.ts

@@ -0,0 +1,222 @@
+import { beforeEach, describe, expect, test, vi } from 'vitest';
+import EmbeddedComponent from '../components/EmbeddedComponent';
+import { CMType, HMType } from '../types';
+
+// Simple test interfaces
+interface TestValue {
+  name?: string;
+  amount?: number;
+}
+
+interface TestOptions {
+  currency?: string;
+}
+
+// Mock MessageEventManager
+vi.mock('../utils/MessageEventManager', () => {
+  return {
+    MessageEventManager: vi.fn().mockImplementation(() => ({
+      on: vi.fn((type, callback) => {
+        callbacks.set(type, callback);
+        return () => callbacks.delete(type);
+      }),
+      send: vi.fn((message) => {
+        const callback = callbacks.get(message.type);
+        if (callback) callback(message);
+      }),
+      off: vi.fn(),
+      setPort: vi.fn(),
+    })),
+  };
+});
+
+// Store callbacks for testing
+const callbacks = new Map();
+
+describe('EmbeddedComponent', () => {
+  let mockParent: HTMLElement;
+  let mockAppendChild: ReturnType<typeof vi.fn>;
+
+  beforeEach(() => {
+    // Clear callbacks before each test
+    callbacks.clear();
+
+    mockParent = document.createElement('div');
+    vi.spyOn(document, 'querySelector').mockReturnValue(mockParent);
+    mockAppendChild = vi.fn().mockImplementation((node: Node) => node);
+    vi.spyOn(mockParent, 'appendChild').mockImplementation(mockAppendChild);
+  });
+
+  describe('initialization', () => {
+    test('should initialize with basic values', () => {
+      const url = 'https://example.com';
+      const value = { name: 'Test' };
+      const options = { currency: 'USD' };
+
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        url,
+        value,
+        options,
+      );
+
+      expect(component.url).toBe(url);
+      expect(component.value).toEqual(value);
+      expect(component.options).toEqual(options);
+      expect(component.errors).toEqual([]);
+    });
+
+    test('should initialize without options', () => {
+      const url = 'https://example.com';
+      const value = { name: 'Test' };
+
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        url,
+        value,
+      );
+
+      expect(component.url).toBe(url);
+      expect(component.value).toEqual(value);
+      expect(component.options).toBeUndefined();
+      expect(component.errors).toEqual([]);
+    });
+  });
+
+  describe('value updates', () => {
+    test('should update value', () => {
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+      const newValue = { name: 'Updated', amount: 100 };
+
+      component.update(newValue);
+
+      expect(component.value).toEqual(newValue);
+    });
+
+    test('should update value and options', () => {
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+      const newValue = { name: 'Updated', amount: 100 };
+      const newOptions = { currency: 'EUR' };
+
+      component.update(newValue, newOptions);
+
+      expect(component.value).toEqual(newValue);
+      expect(component.options).toEqual(newOptions);
+    });
+  });
+
+  describe('mounting', () => {
+    test('should mount component to parent element', () => {
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+
+      component.mount('#parent');
+
+      expect(document.querySelector).toHaveBeenCalledWith('#parent');
+      const iframe = mockAppendChild.mock.calls[0][0] as HTMLIFrameElement;
+      expect(iframe).toBeTruthy();
+      expect(iframe.src).toBe('https://example.com&embedded=true/');
+      expect(iframe.style.width).toBe('100%');
+      expect(iframe.style.height).toBe('0px');
+      expect(iframe.style.border).toBe('');
+    });
+
+    test('should throw error if parent element not found', () => {
+      vi.spyOn(document, 'querySelector').mockReturnValue(null);
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+
+      expect(() => component.mount('#nonexistent')).toThrow(
+        'parentID #nonexistent not found',
+      );
+    });
+
+    test('should remove existing iframe when mounting again', () => {
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+
+      // First mount
+      component.mount('#parent');
+      const firstIframe = mockAppendChild.mock.calls[0][0] as HTMLIFrameElement;
+      const removeSpy = vi.spyOn(firstIframe, 'remove');
+
+      // Second mount
+      component.mount('#parent');
+
+      expect(removeSpy).toHaveBeenCalled();
+      expect(mockAppendChild).toHaveBeenCalledTimes(2);
+    });
+  });
+
+  describe('event handling', () => {
+    test('should register and unregister event listeners', () => {
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+      const mockCallback = vi.fn();
+
+      // Register event listener
+      const unsubscribe = component.on(HMType.UPDATE, mockCallback);
+
+      // Send a message
+      component.send({ type: HMType.UPDATE, value: { name: 'test' } });
+      expect(mockCallback).toHaveBeenCalledTimes(1);
+      expect(mockCallback).toHaveBeenCalledWith({
+        type: HMType.UPDATE,
+        value: { name: 'test' },
+      });
+
+      // Unsubscribe and send again
+      unsubscribe();
+      component.send({ type: HMType.UPDATE, value: { name: 'test2' } });
+      expect(mockCallback).toHaveBeenCalledTimes(1); // Still 1, not called again
+    });
+
+    test('should handle resize events', () => {
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+      component.mount('#parent');
+
+      const iframe = mockAppendChild.mock.calls[0][0] as HTMLIFrameElement;
+
+      // Get the resize callback and trigger it directly
+      const resizeCallback = callbacks.get(CMType.RESIZE);
+      resizeCallback({ type: CMType.RESIZE, height: 500 });
+
+      expect(iframe.style.height).toBe('500px');
+    });
+
+    test('should handle validation errors', () => {
+      const component = new EmbeddedComponent<TestValue, TestOptions>(
+        'https://example.com',
+        {},
+      );
+      const mockErrors = [{ field: 'name', message: 'Required' }];
+      const mockValue = { name: '' };
+
+      // Get the validation callback and trigger it directly
+      const validationCallback = callbacks.get(CMType.INVALID);
+      validationCallback({
+        type: CMType.INVALID,
+        errors: mockErrors,
+        value: mockValue,
+      });
+
+      expect(component.errors).toEqual(mockErrors);
+      expect(component.value).toEqual(mockValue);
+    });
+  });
+});

package/src/types.ts

@@ -531,6 +531,15 @@ export interface Transaction extends ComponentRequest {
   };
 }
 
+export interface RefreshSource {
+  url: URI;
+  key: string;
+}
+
+export interface Refreshable {
+  refreshSource?: RefreshSource;
+}
+
 /**
  * Extended transaction interface for deposits
  * @public
@@ -543,13 +552,19 @@ export interface DepositTransaction extends Transaction {
  * An object representing a withdrawal transaction
  * @public
  */
-export interface Withdrawal extends BeneficiaryFields, Transaction {}
+export interface Withdrawal
+  extends BeneficiaryFields,
+    Transaction,
+    Refreshable {}
 
 /**
  * An object representing a deposit transaction
  * @public
  */
-export interface Deposit extends OriginatorFields, DepositTransaction {}
+export interface Deposit
+  extends OriginatorFields,
+    DepositTransaction,
+    Refreshable {}
 
 /**
  * An object representing a request for a deposit
@@ -1010,6 +1025,7 @@ export enum ProofStatus {
  * - BIP322: Bitcoin message signature following BIP-322
  * - TIP191: Tron message signing
  * - ED25519: Ed25519 signature (used in Solana)
+ * - XRP_ED25519: Ed25519 signature (used in XRP)
  * - XPUB: Extended public key signature for HD wallets
  * - MicroTransfer: Proof via small blockchain transaction
  * - Screenshot: Image proof of ownership/access
@@ -1033,6 +1049,7 @@ export enum ProofTypes {
   BIP137_XPUB = 'xpub',
   TIP191 = 'tip-191',
   ED25519 = 'ed25519',
+  XRP_ED25519 = 'xrp-ed25519',
   CIP8 = 'cip-8',
   MicroTransfer = 'microtransfer',
   Screenshot = 'screenshot',