@notabene/javascript-sdk 2.0.0-next.16 → 2.0.0-next.18

package/README.md

@@ -83,7 +83,7 @@ Create a new Notabene instance:
 const notabene = new Notabene({
   nodeUrl: 'https://api.notabene.id', // use `https://api.notabene.dev` for testing
   authToken: '{CUSTOMER_TOKEN}',
-  locale: 'de' // default locale = `en`
+  locale: 'de', // default locale = `en`
 });
 ```
 
@@ -107,19 +107,20 @@ Instantiate the withdrawal element and mount it using the id from above
 
 ```js
 const withdrawal = notabene.createWithdrawalAssist(tx, options);
-withdrawal.mount("nb-withdrawal");
+withdrawal.mount('nb-withdrawal');
 ```
 
 The simplest way to get the result is to use:
 
 ```js
 try {
- const { valid, value, txCreate, ivms101, proof } = await withdrawal.completion()
- if (valid) {
-  // Submit result to your backend
- }
+  const { valid, value, txCreate, ivms101, proof } =
+    await withdrawal.completion();
+  if (valid) {
+    // Submit result to your backend
+  }
 } catch (e) {
- console.error(e)
+  console.error(e);
 }
 ```
 
@@ -131,7 +132,7 @@ To update the component as users enter transaction details:
 withdrawal.update({
   asset: 'ETH',
   destination: '0x8d12a197cb00d4747a1fe03395095ce2a5cc6819',
-  amountDecimal: 1.12
+  amountDecimal: 1.12,
 });
 ```
 
@@ -218,13 +219,12 @@ The `asset` field the following types of assets specified:
 - [CAIP-19](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md_) is a chain agnostic format allows you to support the widest amount of assets and blockchains including NFTs.
 - [DTI](https://www.iso.org/standard/80601.html) is the ISO Digital Token Identifier format. See [DTI registry](https://dtif.org/registry-search/) for supported tokens.
 
-
 ### Modal
 
 Instantiate the modal and open it
 
 ```js
-const connect = notabene.createConnectWallet({asset:'ETH'}, options);
+const connect = notabene.createConnectWallet({ asset: 'ETH' }, options);
 const { valid, value, txCreate, ivms101, proof } = await connect.openModal();
 ```
 
@@ -269,10 +269,10 @@ The following shows the full set of options in typescript:
 
 ```ts
 import Notabene, {
-		AgentType,
-		PersonType,
-		ProofTypes,
-	} from '@notabene/javascript-sdk';
+  AgentType,
+  PersonType,
+  ProofTypes,
+} from '@notabene/javascript-sdk';
 
 const options: TransactionOptions = {
   proofs: {
@@ -313,13 +313,32 @@ const options: TransactionOptions = {
     },
     vasps: {
       addUnknown: true, // Allow users to add a missing VASP - Defaults to false
-      onlyActive: true // Only list active VASPs - Default false
-    }
+      onlyActive: true, // Only list active VASPs - Default false
+    },
   },
 };
 const withdrawal = notabene.createWithdrawalAssist(tx, options);
 ```
 
+The options can additionally be updated dynamically with the `update()` function.
+
+```js
+withdrawal.update({
+  asset: 'ETH',
+  destination: '0x8d12a197cb00d4747a1fe03395095ce2a5cc6819',
+  amountDecimal: 1.12,
+}, {
+  proofs: {
+    microTransfer: {
+      destination: '0x...',
+      amountSubunits: '12344',
+      timeout: 86440,
+    }
+  }
+});
+```
+
+
 ### Common use cases
 
 #### Only allow first party transactions
@@ -352,7 +371,6 @@ const options: TransactionOptions = {
 
 By default components support message signing proofs.
 
-
 #### Supporting Micro Transactions (aka Satoshi tests)
 
 You can support Micro Transfers (aka Satoshi tests) by adding a deposit address for the test.
@@ -368,8 +386,8 @@ const options: TransactionOptions = {
       timeout: 86440, // Optional timeout in seconds, which is displayed to the user
     },
     fallbacks: [ProofTypes.Screenshot, ProofTypes.SelfDeclaration], // js ['screenshot','self_declaration']
-  }
-}
+  },
+};
 ```
 
 Notabene does not currently verify these tests automatically as you likely already have the infrastructure to do so.
@@ -396,9 +414,10 @@ You may accept a few options if none of the other are available. We do not recom
 const options: TransactionOptions = {
   proofs: {
     fallbacks: [ProofTypes.Screenshot, ProofTypes.SelfDeclaration], // js ['screenshot','self_declaration']
-  }
-}
+  },
+};
 ```
+
 The two options are:
 
 - `screenshot` Where a user is requested to upload a screenshot of their wallet
@@ -418,6 +437,7 @@ Each field can be configured like this:
 - `{ transmit: true }` Include in beneficiary field of IVMS101 to be transmitted to counterparty
 
 Eg:
+
 ```ts
 {
   naturalPerson: {
@@ -427,13 +447,13 @@ Eg:
   }
 }
 ```
+
 The above will always ask the user for the following for natural persons:
 
 - `name` since it is on by default (you can disable it explicitly by setting it to `false`)
 - `website` is show but is optional
 - `email` is required
 
-
 #### Full Example
 
 ```ts
@@ -447,7 +467,7 @@ const options: TransactionOptions = {
       geographicAddress: false,
       nationalIdentification: false,
       dateOfBirth: {
-        transmit: true
+        transmit: true,
       },
       placeOfBirth: false,
       countryOfResidence: true,
@@ -469,7 +489,7 @@ const options: TransactionOptions = {
 #### Field reference
 
 | Field name               | Natural | Legal | IVMS101 | Transmitted | description                                   |
-|--------------------------|---------|-------|---------|-------------|-----------------------------------------------|
+| ------------------------ | ------- | ----- | ------- | ----------- | --------------------------------------------- |
 | `name`                   | ✅      | ✅    | ✅      | ✅          | Full name                                     |
 | `email`                  | 🟩      | 🟩    | --      | --          | Email (for your internal purposes)            |
 | `website`                | --      | ✅    | --      | --          | Business Website (for your internal purposes) |

package/dist/notabene.cjs

@@ -1 +1 @@
-"use strict";var E=Object.defineProperty;var g=(t,e,s)=>e in t?E(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var o=(t,e,s)=>g(t,typeof e!="symbol"?e+"":e,s);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var d=(t=>(t.PRIVATE="WALLET",t.VASP="VASP",t))(d||{}),c=(t=>(t.NATURAL="natural",t.LEGAL="legal",t.SELF="self",t))(c||{}),m=(t=>(t.EMPTY="empty",t.VERIFY="verify",t.PENDING="pending",t.VERIFIED="verified",t.BANNED="banned",t))(m||{}),a=(t=>(t.COMPLETE="complete",t.RESIZE="resize",t.RESULT="result",t.READY="ready",t.INVALID="invalid",t.MODAL="openModal",t.ERROR="error",t.CLOSE="closeModal",t.CANCEL="cancel",t))(a||{}),u=(t=>(t.UPDATE="update",t.REQUEST_RESPONSE="requestResponse",t))(u||{}),f=(t=>(t.PENDING="pending",t.FAILED="rejected",t.FLAGGED="flagged",t.VERIFIED="verified",t))(f||{}),p=(t=>(t.SelfDeclaration="self-declaration",t.PersonalSignEIP191="eip-191",t.PersonalSignEIP712="eip-712",t.PersonalSignBIP137="bip-137",t.PersonalSignXPUB="xpub",t.MicroTransfer="microtransfer",t.Screenshot="screenshot",t))(p||{});class v{constructor(){o(this,"listeners",new Map);o(this,"port");this.handleMessage=this.handleMessage.bind(this)}setPort(e){this.port=e,this.port.onmessage=this.handleMessage,this.port.start()}on(e,s){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(s)}off(e,s){const r=this.listeners.get(e);r&&(r.delete(s),r.size===0&&this.listeners.delete(e))}handleMessage(e){const s=e.data;if(typeof s=="object"&&s!==null&&"type"in s){const r=s.type,i=this.listeners.get(r);i&&i.forEach(n=>n(s))}}send(e){this.port&&this.port.postMessage(e)}}class I{constructor(e,s){o(this,"_url");o(this,"_value");o(this,"_errors",[]);o(this,"iframe");o(this,"eventManager");o(this,"modal");this._url=e,this._value=s,this.eventManager=new v,this.on(a.INVALID,r=>{r.type===a.INVALID&&(this._errors=r.errors,this._value=r.value)}),this.on(a.RESIZE,r=>{r.type===a.RESIZE&&this.iframe&&(this.iframe.style.height=`${r.height}px`)})}get url(){return this._url}get value(){return this._value}get errors(){return this._errors}open(){document.location.href=this.url}mount(e){const s=document.querySelector(e);if(!s)throw new Error(`parentID ${e} not found`);this.embed(s)}embed(e,s=!1){var r,i;this.iframe=document.createElement("iframe"),this.iframe.src=this.url+(s?"":"&embedded=true"),this.iframe.allow="web-share",this.iframe.style.width="100%",this.iframe.style.height="100px",this.iframe.style.border="none",this.iframe.style.overflow="hidden",e.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=(r=this.iframe)==null?void 0:r.contentWindow)==null||i.focus()}send(e){this.eventManager.send(e)}on(e,s){this.eventManager.on(e,s)}off(e,s){this.eventManager.off(e,s)}update(e){this._value=e,this.send({type:u.UPDATE,value:e})}completion(){return new Promise((e,s)=>{this.on(a.COMPLETE,r=>{e(r.response)}),this.on("error",r=>{s(new Error(r.message))})})}openModal(){return this.modal&&this.closeModal(),this.modal=document.createElement("dialog"),this.modal.style.border="none",this.modal.style.backgroundColor="transparent",this.modal.style.maxWidth="100vw",this.modal.style.maxHeight="100vh",this.modal.style.width="600px",this.modal.style.height="800px",document.body.appendChild(this.modal),this.embed(this.modal,!0),this.on(a.CANCEL,()=>{this.closeModal()}),this.on(a.CLOSE,()=>{this.closeModal()}),this.on(a.COMPLETE,()=>{this.closeModal()}),this.modal.showModal(),this.modal.addEventListener("click",()=>{this.closeModal()}),this.completion()}closeModal(){var e;this.modal&&((e=this.modal)==null||e.close(),this.modal.remove(),this.modal=void 0)}}function U(t){return Object.entries(t).map(([e,s])=>{if(!(e&&s))return;const r=encodeURIComponent(e),i=encodeURIComponent(typeof s=="object"?JSON.stringify(s):s);return`${r}=${i}`}).filter(e=>!!e).join("&")}class w{constructor(e){o(this,"nodeUrl");o(this,"authToken");o(this,"uxUrl");o(this,"theme");o(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,s,r,i){const n=new URL(this.uxUrl);n.pathname=e;const l=U({authToken:this.authToken,value:s,configuration:r});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(e,s,r,i){return new I(this.componentUrl(e,s,r,i),s)}createWithdrawalAssist(e,s,r){return this.createComponent("withdrawal-assist",e,s,r)}createWalletAssist(e,s,r){return this.createComponent("wallet-assist",e,s,r)}createDepositAssist(e,s,r){return this.createComponent("deposit-assist",e,s,r)}createConnectWallet(e,s,r){return this.createComponent("connect",e,s,r)}createDepositRequest(e,s,r){return this.createComponent("deposit-request",e,s,r)}decodeFragmentToObject(e){return e.slice(1).split("&").reduce((r,i)=>{const[n,l]=i.split("=");return r[decodeURIComponent(n)]=decodeURIComponent(l),r},{})}}exports.AgentType=d;exports.CMType=a;exports.PersonType=c;exports.ProofStatus=f;exports.ProofTypes=p;exports.Status=m;exports.default=w;
+"use strict";var g=Object.defineProperty;var v=(t,e,s)=>e in t?g(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var o=(t,e,s)=>v(t,typeof e!="symbol"?e+"":e,s);Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var d=(t=>(t.PRIVATE="WALLET",t.VASP="VASP",t))(d||{}),c=(t=>(t.NATURAL="natural",t.LEGAL="legal",t.SELF="self",t))(c||{}),m=(t=>(t.EMPTY="empty",t.VERIFY="verify",t.PENDING="pending",t.VERIFIED="verified",t.BANNED="banned",t))(m||{}),a=(t=>(t.COMPLETE="complete",t.RESIZE="resize",t.RESULT="result",t.READY="ready",t.INVALID="invalid",t.ERROR="error",t.CANCEL="cancel",t))(a||{}),u=(t=>(t.UPDATE="update",t.REQUEST_RESPONSE="requestResponse",t))(u||{}),p=(t=>(t.PENDING="pending",t.FAILED="rejected",t.FLAGGED="flagged",t.VERIFIED="verified",t))(p||{}),f=(t=>(t.SelfDeclaration="self-declaration",t.PersonalSignEIP191="eip-191",t.SIWE="siwe",t.PersonalSignEIP712="eip-712",t.PersonalSignBIP137="bip-137",t.PersonalSignXPUB="xpub",t.MicroTransfer="microtransfer",t.Screenshot="screenshot",t))(f||{});class b{constructor(){o(this,"listeners",new Map);o(this,"port");this.handleMessage=this.handleMessage.bind(this)}setPort(e){this.port=e,this.port.onmessage=this.handleMessage,this.port.start()}on(e,s){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(s)}off(e,s){const r=this.listeners.get(e);r&&(r.delete(s),r.size===0&&this.listeners.delete(e))}handleMessage(e){const s=e.data;if(typeof s=="object"&&s!==null&&"type"in s){const r=s.type,i=this.listeners.get(r);i&&i.forEach(n=>n(s))}}send(e){this.port&&this.port.postMessage(e)}}class E{constructor(e,s,r){o(this,"_url");o(this,"_value");o(this,"_options");o(this,"_errors",[]);o(this,"iframe");o(this,"eventManager");o(this,"modal");this._url=e,this._value=s,this._options=r,this.eventManager=new b,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(e){const s=document.querySelector(e);if(!s)throw new Error(`parentID ${e} not found`);this.embed(s)}embed(e,s=!1){var r,i;this.removeEmbed(),this.iframe=document.createElement("iframe"),this.iframe.src=this.url+(s?"":"&embedded=true"),this.iframe.allow="web-share",this.iframe.style.width="100%",this.iframe.style.height="100px",this.iframe.style.border="none",this.iframe.style.overflow="hidden",e.appendChild(this.iframe),window.addEventListener("message",n=>{var h,l;n.source===((h=this.iframe)==null?void 0:h.contentWindow)&&((l=this.eventManager)==null||l.setPort(n.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,s){this.eventManager.on(e,s)}off(e,s){this.eventManager.off(e,s)}update(e,s){this._value=e,s&&(this._options=s),this.send({type:u.UPDATE,value:e,options:this._options})}completion(){return new Promise((e,s)=>{this.on(a.COMPLETE,r=>{e(r.response)}),this.on("error",r=>{s(new Error(r.message))})})}openModal(){return 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),this.on(a.CANCEL,()=>{this.closeModal()}),this.on(a.COMPLETE,()=>{this.closeModal()}),this.modal.showModal(),this.modal.addEventListener("click",()=>{this.closeModal()}),this.completion()}closeModal(){var e;this.modal&&((e=this.modal)==null||e.close(),this.modal.remove(),this.modal=void 0)}}function w(t){return Object.entries(t).map(([e,s])=>{if(!(e&&s))return;const r=encodeURIComponent(e),i=encodeURIComponent(typeof s=="object"?JSON.stringify(s):s);return`${r}=${i}`}).filter(e=>!!e).join("&")}class I{constructor(e){o(this,"nodeUrl");o(this,"authToken");o(this,"uxUrl");o(this,"theme");o(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,s,r,i){const n=new URL(this.uxUrl);n.pathname=e;const h=w({authToken:this.authToken,value:s,configuration:r});return n.hash=h,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(e,s,r,i){return new E(this.componentUrl(e,s,r,i),s,r)}createWithdrawalAssist(e,s,r){return this.createComponent("withdrawal-assist",e,s,r)}createWalletAssist(e,s,r){return this.createComponent("wallet-assist",e,s,r)}createDepositAssist(e,s,r){return this.createComponent("deposit-assist",e,s,r)}createConnectWallet(e,s,r){return this.createComponent("connect",e,s,r)}createDepositRequest(e,s,r){return this.createComponent("deposit-request",e,s,r)}decodeFragmentToObject(e){return e.slice(1).split("&").reduce((r,i)=>{const[n,h]=i.split("=");return r[decodeURIComponent(n)]=decodeURIComponent(h),r},{})}}exports.AgentType=d;exports.CMType=a;exports.EmbeddedComponent=E;exports.PersonType=c;exports.ProofStatus=p;exports.ProofTypes=f;exports.Status=m;exports.default=I;

package/dist/notabene.d.ts

@@ -141,7 +141,7 @@ export declare interface CallbackOptions {
 
 /**
  * Represents a cancel component message
- * @public
+ * @internal
  */
 declare type Cancel = {
     type: CMType.CANCEL;
@@ -157,26 +157,26 @@ export declare const enum CMType {
     RESULT = "result",
     READY = "ready",
     INVALID = "invalid",
-    MODAL = "openModal",
     ERROR = "error",
-    CLOSE = "closeModal",
     CANCEL = "cancel"
 }
 
 /**
  * Represents a completed component message
+ * @typeParam T - The overall Value type being returned
+ * @param response - The Response object which wraps T
  * @public
  */
-declare type Completed = {
+declare type Completed<T> = {
     type: CMType.COMPLETE;
-    response: ComponentResponse;
+    response: TransactionResponse<T>;
 };
 
 /**
  * Component Message
  * @public
  */
-export declare type ComponentMessage = Completed | Cancel | Error_2 | Ready | ResizeRequest | InvalidValue;
+export declare type ComponentMessage<T> = Completed<T> | Cancel | Error_2 | Ready | ResizeRequest | InvalidValue<T>;
 
 /**
  * An abstract request for communicating with a component
@@ -202,17 +202,6 @@ export declare interface ConnectionRequest extends ComponentRequest {
     asset: TransactionAsset;
 }
 
-/**
- * An object representing a connection response
- * @public
- */
-export declare interface ConnectionResponse extends ComponentResponse {
-    value: ConnectionRequest;
-    ivms: IVMS101;
-    proof?: OwnershipProof;
-    txCreate?: V1Transaction;
-}
-
 /**
  * The counterparty of a transaction.
  * @public
@@ -304,9 +293,10 @@ declare type DTI = string;
  * An embedded Notabene component
  * @public
  */
-export declare class EmbeddedComponent<V, R> {
+export declare class EmbeddedComponent<V, O> {
     private _url;
     private _value;
+    private _options?;
     private _errors;
     private iframe?;
     private eventManager;
@@ -316,7 +306,7 @@ export declare class EmbeddedComponent<V, R> {
      * @param url - The URL of the embedded component
      * @param value - The initial transaction value
      */
-    constructor(url: string, value: V);
+    constructor(url: string, value: Partial<V>, options?: O);
     /**
      * Gets the URL of the embedded component
      * @returns The URL of the embedded component
@@ -326,7 +316,8 @@ export declare class EmbeddedComponent<V, R> {
      * Gets the current transaction value
      * @returns The current transaction value
      */
-    get value(): V;
+    get value(): Partial<V>;
+    get options(): O | undefined;
     get errors(): ValidationError[];
     /**
      * Opens the component URL in the current window
@@ -343,37 +334,38 @@ export declare class EmbeddedComponent<V, R> {
      * @param parent - The parent element to embed the component into
      */
     embed(parent: Element, modal?: boolean): void;
+    removeEmbed(): void;
     /**
      * Sends a message to the embedded component
      * @param message - The message to send
      */
-    send(message: HostMessage): void;
+    send(message: HostMessage<V, O>): void;
     /**
      * Adds an event listener for a specific message type
      * @param messageType - The type of message to listen for
      * @param callback - The callback function to execute when the message is received
      */
-    on(messageType: string, callback: MessageCallback): void;
+    on(messageType: string, callback: MessageCallback<V>): void;
     /**
      * Removes an event listener for a specific message type
      * @param messageType - The type of message to stop listening for
      * @param callback - The callback function to remove
      */
-    off(messageType: string, callback: MessageCallback): void;
+    off(messageType: string, callback: MessageCallback<V>): void;
     /**
      * Updates the transaction value and sends an update message to the component
      * @param value - The new transaction value
      */
-    update(value: V): void;
+    update(value: Partial<V>, options?: O): void;
     /**
      * Waits for the component to complete and returns the transaction response
      * @returns A promise that resolves with the transaction response
      */
-    completion(): Promise<R>;
+    completion(): Promise<TransactionResponse<V>>;
     /**
      * Opens the component in a modal dialog
      */
-    openModal(): Promise<R>;
+    openModal(): Promise<TransactionResponse<V>>;
     /**
      * Closes the modal dialog
      *
@@ -383,6 +375,7 @@ export declare class EmbeddedComponent<V, R> {
 
 /**
  * Represents an error component message
+ * @param message - Error message
  * @public
  */
 declare type Error_2 = {
@@ -417,7 +410,7 @@ declare const enum HMType {
  * Host Messages
  * @public
  */
-export declare type HostMessage = UpdateValue;
+export declare type HostMessage<T, O> = UpdateValue<T, O>;
 
 /**
  * Intermediary VASP
@@ -433,11 +426,14 @@ declare type IntermediaryVASP = {
 
 /**
  * Represents an invalid value component message
- * @public
+ * @typeParam T - The overall Value type being returned
+ * @param value - The current Partial value
+ * @param errors - Array of validation errors
+ * @internal
  */
-declare type InvalidValue = {
+declare type InvalidValue<T> = {
     type: CMType.INVALID;
-    value: any;
+    value: Partial<T>;
     errors: ValidationError[];
 };
 
@@ -573,7 +569,7 @@ declare type LocalNaturalPersonNameID = {
     nameIdentifierType?: NaturalPersonNameTypeCode;
 };
 
-declare type MessageCallback = (message: ComponentMessage) => void;
+declare type MessageCallback<T> = (message: ComponentMessage<T>) => void;
 
 /**
  * Ownership Proof using Micro Transfer
@@ -710,7 +706,7 @@ declare class Notabene {
      * @returns component URL
      * @internal
      */
-    componentUrl<V>(path: string, value: V, configuration?: TransactionOptions, callbacks?: CallbackOptions): string;
+    componentUrl<V, O>(path: string, value: V, configuration?: O, callbacks?: CallbackOptions): string;
     /**
      * Creates a new embedded component
      *
@@ -721,7 +717,7 @@ declare class Notabene {
      * @returns A new EmbeddedComponent instance
      * @internal
      */
-    createComponent<V, R>(path: string, value: V, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<V, R>;
+    createComponent<V, O>(path: string, value: Partial<V>, options?: O, callbacks?: CallbackOptions): EmbeddedComponent<V, O>;
     /**
      * Creates a withdrawal assist component
      *
@@ -730,7 +726,7 @@ declare class Notabene {
      * @param callbacks - Optional callback configuration
      * @returns A new EmbeddedComponent instance for withdrawal assistance
      */
-    createWithdrawalAssist(value: Partial<Withdrawal>, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<Partial<Withdrawal>, TransactionResponse<Withdrawal>>;
+    createWithdrawalAssist(value: Partial<Withdrawal>, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<Withdrawal, TransactionOptions>;
     /**
      * Creates a wallet assist component
      *
@@ -740,7 +736,7 @@ declare class Notabene {
      * @returns A new EmbeddedComponent instance for withdrawal assistance
      * @alpha
      */
-    createWalletAssist(value: Partial<Withdrawal>, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<Partial<Withdrawal>, TransactionResponse<Withdrawal>>;
+    createWalletAssist(value: Partial<Withdrawal>, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<Withdrawal, TransactionOptions>;
     /**
      * Creates a deposit assist component
      *
@@ -750,7 +746,7 @@ declare class Notabene {
      * @returns A new EmbeddedComponent instance for deposit assistance
      * @alpha
      */
-    createDepositAssist(value: Partial<Deposit>, options?: any, callbacks?: CallbackOptions): EmbeddedComponent<Partial<Deposit>, TransactionResponse<Deposit>>;
+    createDepositAssist(value: Partial<Deposit>, options?: any, callbacks?: CallbackOptions): EmbeddedComponent<Deposit, any>;
     /**
      * Creates a connect component
      *
@@ -760,7 +756,7 @@ declare class Notabene {
      * @returns A new EmbeddedComponent instance for connection
      * @alpha
      */
-    createConnectWallet(value: ConnectionRequest, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<ConnectionRequest, ConnectionResponse>;
+    createConnectWallet(value: ConnectionRequest, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<ConnectionRequest, TransactionOptions>;
     /**
      * Creates a deposit request component
      *
@@ -770,7 +766,7 @@ declare class Notabene {
      * @returns A new EmbeddedComponent instance for deposit requests
      * @public
      */
-    createDepositRequest(value: DepositRequest, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<DepositRequest, TransactionResponse<DepositRequest>>;
+    createDepositRequest(value: DepositRequest, options?: TransactionOptions, callbacks?: CallbackOptions): EmbeddedComponent<DepositRequest, TransactionOptions>;
     /**
      * Decodes a URL fragment into an object
      *
@@ -923,6 +919,7 @@ export declare enum ProofStatus {
 export declare enum ProofTypes {
     SelfDeclaration = "self-declaration",
     PersonalSignEIP191 = "eip-191",
+    SIWE = "siwe",
     PersonalSignEIP712 = "eip-712",
     PersonalSignBIP137 = "bip-137",
     PersonalSignXPUB = "xpub",
@@ -941,8 +938,8 @@ declare type Ready = {
 declare type RequestID = UUID;
 
 /**
- * Represents a resize request component message
- * @public
+ * Represents a resize request component message. This is handled by the library.
+ * @internal
  */
 declare type ResizeRequest = {
     type: CMType.RESIZE;
@@ -963,7 +960,7 @@ export declare interface ScreenshotProof extends OwnershipProof {
  * @public
  */
 export declare interface SignatureProof extends OwnershipProof {
-    type: ProofTypes.PersonalSignEIP191 | ProofTypes.PersonalSignEIP712 | ProofTypes.PersonalSignBIP137 | ProofTypes.PersonalSignXPUB;
+    type: ProofTypes.PersonalSignEIP191 | ProofTypes.PersonalSignEIP712 | ProofTypes.PersonalSignBIP137 | ProofTypes.SIWE | ProofTypes.PersonalSignXPUB;
     proof: string;
     attestation: string;
     wallet_provider: string;
@@ -1074,12 +1071,15 @@ declare type TransliterationMethodCode = 'arab' | 'aran' | 'armn' | 'cyrl' | 'de
 declare type TravelAddress = `ta${string}`;
 
 /**
- * Represents an update value host message
+ * Represents an update value host message. This is sent from Host to component.
+ * @typeParam T - The overall Value type being sent
+ * @typeParam O - The Option type being sent
  * @public
  */
-declare type UpdateValue = {
+declare type UpdateValue<T, O> = {
     type: HMType.UPDATE;
-    value: ComponentRequest;
+    value: Partial<T>;
+    options?: O;
 };
 
 /**