@notabene/javascript-sdk 2.16.0 → 2.17.0-next.4

package/dist/cjs/notabene.d.ts

@@ -272,7 +272,6 @@ declare type BeneficiaryFields = {
 
 declare type BeneficiaryV2 = {
     beneficiaryPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -754,6 +753,26 @@ export declare type ConnectionResult<T extends ComponentRequest> = {
 
 export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
 
+/**
+ * Configuration for the contact support action.
+ *
+ * @remarks
+ * Contact support is **enabled** by including `'contact-support'` in
+ * `agentSections.main` or `agentSections.fallback`. This object only
+ * configures the behaviour when the feature is enabled.
+ *
+ * - With `contactSupport: { supportUrl: "..." }` — clicking sends an info
+ *   message to the host **and** attempts to open the URL as a fallback.
+ * - Without `contactSupport` — clicking only sends an info message; the
+ *   host decides what to do.
+ *
+ * @public
+ */
+export declare interface ContactSupportConfig {
+    /** URL to open when the user clicks the support button */
+    supportUrl: string;
+}
+
 /**
  * Metadata for Cosmos ownership proofs
  * @remarks
@@ -879,7 +898,7 @@ export declare interface DepositRequest extends DepositRequestFields, ComponentR
 declare type DepositRequestFields = {
     destination: BlockchainAddress | CAIP10;
     asset: TransactionAsset;
-    amountDecimal: number;
+    amountDecimal: string | number;
     travelAddress?: TravelAddress;
     cryptoCredential?: CryptoCredential;
 };
@@ -1157,14 +1176,24 @@ export declare enum IdentityVerificationMethod {
  * Represents an info component message
  * @param message - Info message
  * @param description - Description of the info message
+ * @param identifier - Identifier code of the info message
  * @public
  */
 declare type Info = {
     type: CMType.INFO;
     message: string;
     description?: string;
+    identifier?: InfoIdentifierCode;
 };
 
+/**
+ * Identifier codes for info messages
+ * @public
+ */
+export declare enum InfoIdentifierCode {
+    CONTACT_SUPPORT = "CONTACT_SUPPORT"
+}
+
 /**
  * Intermediary VASP
  * Represents an intermediary Virtual Asset Service Provider
@@ -2107,6 +2136,7 @@ declare type NaturalPersonNationalIdentifierTypeCode = Omit<NationalIdentifierTy
 
 declare type NaturalPersonV2 = Omit<NaturalPerson_2, 'name'> & {
     name: NaturalPersonNameV2;
+    customerIdentification?: string;
 };
 
 /**
@@ -2450,7 +2480,6 @@ declare type OriginatorFields = {
 
 declare type OriginatorV2 = {
     originatorPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -2925,13 +2954,14 @@ export declare interface ScreenshotProof extends OwnershipProof {
  * - `'signature'` — wallet connection for ownership proof via signature
  * - `'manual-signing'` — ownership proof via manual message signing
  * - `'add-vasp'` — manually add an unlisted exchange/VASP (hosted flow)
+ * - `'contact-support'` — show a contact support button
  *
  * Options are automatically filtered by flow (e.g. `add-vasp` is ignored in self-hosted).
  * Including an option implicitly enables that capability.
  *
  * @public
  */
-export declare type SectionOption = 'self-declaration' | 'screenshot' | 'microtransfer' | 'signature' | 'manual-signing' | 'add-vasp';
+export declare type SectionOption = 'self-declaration' | 'screenshot' | 'microtransfer' | 'signature' | 'manual-signing' | 'add-vasp' | 'contact-support';
 
 /**
  * Interface for signature-based ownership proofs that use cryptographic message signing
@@ -3220,7 +3250,7 @@ export declare interface Transaction extends ComponentRequest {
     agent: Agent;
     counterparty: Counterparty;
     asset: TransactionAsset;
-    amountDecimal: number;
+    amountDecimal: string | number;
     proof?: OwnershipProof;
     assetPrice?: {
         price: number;
@@ -3300,6 +3330,12 @@ export declare interface TransactionOptions {
     vasps?: VASPOptions;
     hide?: ValidationSections[];
     counterpartyAssist?: CounterpartyAssistConfig;
+    /**
+     * Configuration for the contact support button.
+     * Enablement is controlled via `agentSections` — include `'contact-support'`
+     * in `main` or `fallback` to show the button.
+     */
+    contactSupport?: ContactSupportConfig;
     autoSubmit?: boolean;
 }
 
@@ -3517,13 +3553,37 @@ export declare interface VASP extends Agent {
 }
 
 /**
- * Options for which VASPs to be searchable
+ * Options controlling which VASPs are listed and searchable in the picker.
+ *
+ * Two mutually exclusive variants:
+ *
+ * - **V1** — `addUnknown`, `onlyActive`, `searchable` (filters by {@link VASPSearchControl} status).
+ * - **V2** — `addUnknown`, `onlyActive`, `showTrustStatus` (filters by {@link VASPTrustStatus}).
+ *
+ * `searchable` (V1-only) cannot be combined with `showTrustStatus` (V2-only);
+ * TypeScript will reject the mix at compile time. `addUnknown` and `onlyActive` are valid in both variants.
+ *
+ * @example V1
+ * ```ts
+ * { addUnknown: true, onlyActive: true, searchable: [VASPSearchControl.ALLOWED] }
+ * ```
+ *
+ * @example V2
+ * ```ts
+ * { addUnknown: true, onlyActive: true, showTrustStatus: ['TRUSTED', 'NEW'] }
+ * ```
+ *
  * @public
  */
 export declare type VASPOptions = {
     addUnknown?: boolean;
     onlyActive?: boolean;
     searchable?: VASPSearchControl[];
+} | {
+    searchable?: undefined;
+    addUnknown?: boolean;
+    onlyActive?: boolean;
+    showTrustStatus?: VASPTrustStatus[];
 };
 
 /**
@@ -3539,6 +3599,15 @@ export declare enum VASPSearchControl {
     PENDING = "pending"
 }
 
+/**
+ * Trust status assigned to a VASP in the Notabene network.
+ *
+ * Used by {@link VASPOptions.showTrustStatus} to filter which VASPs are listed in the picker.
+ *
+ * @public
+ */
+export declare type VASPTrustStatus = 'TRUSTED' | 'NEW' | 'FLAGGED' | 'BANNED';
+
 /**
  * A wallet agent acting on behalf of the counterparty
  * @public

package/dist/cjs/package.json

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

package/dist/esm/notabene.d.ts

@@ -272,7 +272,6 @@ declare type BeneficiaryFields = {
 
 declare type BeneficiaryV2 = {
     beneficiaryPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -754,6 +753,26 @@ export declare type ConnectionResult<T extends ComponentRequest> = {
 
 export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
 
+/**
+ * Configuration for the contact support action.
+ *
+ * @remarks
+ * Contact support is **enabled** by including `'contact-support'` in
+ * `agentSections.main` or `agentSections.fallback`. This object only
+ * configures the behaviour when the feature is enabled.
+ *
+ * - With `contactSupport: { supportUrl: "..." }` — clicking sends an info
+ *   message to the host **and** attempts to open the URL as a fallback.
+ * - Without `contactSupport` — clicking only sends an info message; the
+ *   host decides what to do.
+ *
+ * @public
+ */
+export declare interface ContactSupportConfig {
+    /** URL to open when the user clicks the support button */
+    supportUrl: string;
+}
+
 /**
  * Metadata for Cosmos ownership proofs
  * @remarks
@@ -879,7 +898,7 @@ export declare interface DepositRequest extends DepositRequestFields, ComponentR
 declare type DepositRequestFields = {
     destination: BlockchainAddress | CAIP10;
     asset: TransactionAsset;
-    amountDecimal: number;
+    amountDecimal: string | number;
     travelAddress?: TravelAddress;
     cryptoCredential?: CryptoCredential;
 };
@@ -1157,14 +1176,24 @@ export declare enum IdentityVerificationMethod {
  * Represents an info component message
  * @param message - Info message
  * @param description - Description of the info message
+ * @param identifier - Identifier code of the info message
  * @public
  */
 declare type Info = {
     type: CMType.INFO;
     message: string;
     description?: string;
+    identifier?: InfoIdentifierCode;
 };
 
+/**
+ * Identifier codes for info messages
+ * @public
+ */
+export declare enum InfoIdentifierCode {
+    CONTACT_SUPPORT = "CONTACT_SUPPORT"
+}
+
 /**
  * Intermediary VASP
  * Represents an intermediary Virtual Asset Service Provider
@@ -2107,6 +2136,7 @@ declare type NaturalPersonNationalIdentifierTypeCode = Omit<NationalIdentifierTy
 
 declare type NaturalPersonV2 = Omit<NaturalPerson_2, 'name'> & {
     name: NaturalPersonNameV2;
+    customerIdentification?: string;
 };
 
 /**
@@ -2450,7 +2480,6 @@ declare type OriginatorFields = {
 
 declare type OriginatorV2 = {
     originatorPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -2925,13 +2954,14 @@ export declare interface ScreenshotProof extends OwnershipProof {
  * - `'signature'` — wallet connection for ownership proof via signature
  * - `'manual-signing'` — ownership proof via manual message signing
  * - `'add-vasp'` — manually add an unlisted exchange/VASP (hosted flow)
+ * - `'contact-support'` — show a contact support button
  *
  * Options are automatically filtered by flow (e.g. `add-vasp` is ignored in self-hosted).
  * Including an option implicitly enables that capability.
  *
  * @public
  */
-export declare type SectionOption = 'self-declaration' | 'screenshot' | 'microtransfer' | 'signature' | 'manual-signing' | 'add-vasp';
+export declare type SectionOption = 'self-declaration' | 'screenshot' | 'microtransfer' | 'signature' | 'manual-signing' | 'add-vasp' | 'contact-support';
 
 /**
  * Interface for signature-based ownership proofs that use cryptographic message signing
@@ -3220,7 +3250,7 @@ export declare interface Transaction extends ComponentRequest {
     agent: Agent;
     counterparty: Counterparty;
     asset: TransactionAsset;
-    amountDecimal: number;
+    amountDecimal: string | number;
     proof?: OwnershipProof;
     assetPrice?: {
         price: number;
@@ -3300,6 +3330,12 @@ export declare interface TransactionOptions {
     vasps?: VASPOptions;
     hide?: ValidationSections[];
     counterpartyAssist?: CounterpartyAssistConfig;
+    /**
+     * Configuration for the contact support button.
+     * Enablement is controlled via `agentSections` — include `'contact-support'`
+     * in `main` or `fallback` to show the button.
+     */
+    contactSupport?: ContactSupportConfig;
     autoSubmit?: boolean;
 }
 
@@ -3517,13 +3553,37 @@ export declare interface VASP extends Agent {
 }
 
 /**
- * Options for which VASPs to be searchable
+ * Options controlling which VASPs are listed and searchable in the picker.
+ *
+ * Two mutually exclusive variants:
+ *
+ * - **V1** — `addUnknown`, `onlyActive`, `searchable` (filters by {@link VASPSearchControl} status).
+ * - **V2** — `addUnknown`, `onlyActive`, `showTrustStatus` (filters by {@link VASPTrustStatus}).
+ *
+ * `searchable` (V1-only) cannot be combined with `showTrustStatus` (V2-only);
+ * TypeScript will reject the mix at compile time. `addUnknown` and `onlyActive` are valid in both variants.
+ *
+ * @example V1
+ * ```ts
+ * { addUnknown: true, onlyActive: true, searchable: [VASPSearchControl.ALLOWED] }
+ * ```
+ *
+ * @example V2
+ * ```ts
+ * { addUnknown: true, onlyActive: true, showTrustStatus: ['TRUSTED', 'NEW'] }
+ * ```
+ *
  * @public
  */
 export declare type VASPOptions = {
     addUnknown?: boolean;
     onlyActive?: boolean;
     searchable?: VASPSearchControl[];
+} | {
+    searchable?: undefined;
+    addUnknown?: boolean;
+    onlyActive?: boolean;
+    showTrustStatus?: VASPTrustStatus[];
 };
 
 /**
@@ -3539,6 +3599,15 @@ export declare enum VASPSearchControl {
     PENDING = "pending"
 }
 
+/**
+ * Trust status assigned to a VASP in the Notabene network.
+ *
+ * Used by {@link VASPOptions.showTrustStatus} to filter which VASPs are listed in the picker.
+ *
+ * @public
+ */
+export declare type VASPTrustStatus = 'TRUSTED' | 'NEW' | 'FLAGGED' | 'BANNED';
+
 /**
  * A wallet agent acting on behalf of the counterparty
  * @public