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

package/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",
@@ -107,4 +107,4 @@
       "@commitlint/config-conventional"
     ]
   }
-}
+}

package/src/ivms/v2Types.ts

@@ -7,12 +7,10 @@ import type {
 
 export type OriginatorV2 = {
   originatorPerson: PersonV2[];
-  customerIdentification?: string;
 };
 
 export type BeneficiaryV2 = {
   beneficiaryPerson: PersonV2[];
-  customerIdentification?: string;
 };
 
 export type NaturalPersonNameIDV2 = {
@@ -27,6 +25,7 @@ export type NaturalPersonNameV2 = Omit<NaturalPersonName, 'nameIdentifier'> & {
 
 export type NaturalPersonV2 = Omit<NaturalPerson, 'name'> & {
   name: NaturalPersonNameV2;
+  customerIdentification?: string;
 };
 
 export type PersonV2 = Omit<Person, 'naturalPerson'> & {

package/src/notabene.ts

@@ -14,6 +14,7 @@ import type {
   ComponentResponse,
   ConnectionOptions,
   ConnectionRequest,
+  ContactSupportConfig,
   CosmosMetadata,
   Counterparty,
   CounterpartyAssistConfig,
@@ -63,6 +64,7 @@ import type {
   ValidationError,
   VASP,
   VASPOptions,
+  VASPTrustStatus,
   Wallet,
   Withdrawal,
 } from './types';
@@ -73,6 +75,7 @@ import {
   ErrorIdentifierCode,
   HMType,
   IdentityVerificationMethod,
+  InfoIdentifierCode,
   PersonType,
   ProofStatus,
   ProofTypes,
@@ -116,6 +119,7 @@ export {
   ErrorIdentifierCode,
   HMType,
   IdentityVerificationMethod,
+  InfoIdentifierCode,
   PersonType,
   ProofStatus,
   ProofTypes,
@@ -139,6 +143,7 @@ export type {
   ComponentResponse,
   ConnectionOptions,
   ConnectionRequest,
+  ContactSupportConfig,
   CosmosMetadata,
   Counterparty,
   CounterpartyAssistConfig,
@@ -189,6 +194,7 @@ export type {
   ValidationError,
   VASP,
   VASPOptions,
+  VASPTrustStatus,
   Wallet,
   Withdrawal,
 };

package/src/responseTransformer/transformer.ts

@@ -191,9 +191,7 @@ export function componentResponseToV1TxCreateRequest(
         ? txCreate.transactionAsset
         : txCreate.transactionAsset?.caip19) ||
       '',
-    amountDecimal:
-      value?.amountDecimal ||
-      (txCreate.transactionAmount ? parseFloat(txCreate.transactionAmount) : 0),
+    amountDecimal: value?.amountDecimal ?? txCreate.transactionAmount ?? 0,
     customer: value?.customer,
   } as Withdrawal;
 

package/src/types.ts

@@ -516,7 +516,7 @@ type BeneficiaryFields = {
 type DepositRequestFields = {
   destination: BlockchainAddress | CAIP10;
   asset: TransactionAsset;
-  amountDecimal: number;
+  amountDecimal: string | number;
   travelAddress?: TravelAddress;
   cryptoCredential?: CryptoCredential;
 };
@@ -572,7 +572,7 @@ export interface Transaction extends ComponentRequest {
   agent: Agent;
   counterparty: Counterparty;
   asset: TransactionAsset;
-  amountDecimal: number;
+  amountDecimal: string | number;
   proof?: OwnershipProof;
   assetPrice?: {
     price: number;
@@ -789,14 +789,53 @@ export enum VASPSearchControl {
 }
 
 /**
- * Options for which VASPs to be searchable
+ * 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 type VASPOptions = {
-  addUnknown?: boolean;
-  onlyActive?: boolean;
-  searchable?: VASPSearchControl[]; // If array left empty all VASPs will be searchable
-};
+export type VASPTrustStatus = 'TRUSTED' | 'NEW' | 'FLAGGED' | 'BANNED';
+
+/**
+ * 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 type VASPOptions =
+  // V1 vasps options
+  | {
+      addUnknown?: boolean;
+      onlyActive?: boolean;
+      searchable?: VASPSearchControl[]; // If array left empty all VASPs will be searchable
+    }
+  // V2 vasps options
+  | {
+      // Typing `searchable` as `undefined` (rather than omitting it) makes TS reject
+      // mixing V1 and V2 options, e.g. { searchable: [...], showTrustStatus: [...] }.
+      searchable?: undefined;
+      addUnknown?: boolean;
+      onlyActive?: boolean;
+      showTrustStatus?: VASPTrustStatus[];
+    };
 
 /**
  * Available methods for identity verification
@@ -883,6 +922,7 @@ export interface ThresholdOptions {
  * - `'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.
@@ -895,7 +935,28 @@ export type SectionOption =
   | 'microtransfer' // ProofTypes.MicroTransfer
   | 'signature'
   | 'manual-signing'
-  | 'add-vasp';
+  | 'add-vasp'
+  | 'contact-support';
+
+/**
+ * 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 interface ContactSupportConfig {
+  /** URL to open when the user clicks the support button */
+  supportUrl: string;
+}
 
 /**
  * Explicit layout configuration for the agent selection step.
@@ -944,6 +1005,12 @@ export interface TransactionOptions {
   vasps?: VASPOptions;
   hide?: ValidationSections[]; // You can hide a specific section of the component by listing it here
   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; // Defaults to false
 }
 /**
@@ -1072,16 +1139,26 @@ export type Warning = {
   identifier?: WarningIdentifierCode;
 };
 
+/**
+ * Identifier codes for info messages
+ * @public
+ */
+export enum InfoIdentifierCode {
+  CONTACT_SUPPORT = 'CONTACT_SUPPORT',
+}
+
 /**
  * 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
  */
 export type Info = {
   type: CMType.INFO;
   message: string;
   description?: string;
+  identifier?: InfoIdentifierCode;
 };
 
 /**

package/src/utils/arbitraries.ts

@@ -1,6 +1,7 @@
 import fc from 'fast-check';
 import type {
   Agent,
+  AgentSections,
   BlockchainAddress,
   CAIP10,
   CAIP19,
@@ -9,6 +10,7 @@ import type {
   CallbackOptions,
   ConnectionOptions,
   ConnectionRequest,
+  ContactSupportConfig,
   Counterparty,
   CryptoCredential,
   Deposit,
@@ -19,11 +21,13 @@ import type {
   ISOCurrency,
   ISODate,
   NaturalPerson,
+  SectionOption,
   ThresholdOptions,
   TransactionAsset,
   TransactionOptions,
   TravelAddress,
   VASPOptions,
+  VASPTrustStatus,
   Withdrawal,
 } from '../types';
 import {
@@ -31,6 +35,7 @@ import {
   PersonType,
   ProofTypes,
   ValidationSections,
+  VASPSearchControl,
 } from '../types';
 import {
   CAIP10_MATCHER,
@@ -91,6 +96,18 @@ export const arbitraryAgent = (): fc.Arbitrary<Agent> =>
     verified: fc.boolean(),
   });
 
+// Generates decimal strings with 18+ fractional digits to test precision beyond float64
+const arbitraryHighPrecisionDecimal = (): fc.Arbitrary<string> =>
+  fc
+    .tuple(
+      fc.integer({ min: 0, max: 999999 }),
+      fc.stringMatching(/^\d{18,24}$/),
+    )
+    .map(([integer, fractional]) => `${integer}.${fractional}`);
+
+const arbitraryAmountDecimal = (): fc.Arbitrary<string | number> =>
+  fc.oneof(fc.float({ min: 0, noNaN: true }), arbitraryHighPrecisionDecimal());
+
 export const arbitraryCounterparty = (): fc.Arbitrary<Counterparty> =>
   arbitraryNaturalPerson(); // For simplicity we'll just use NaturalPerson
 
@@ -99,7 +116,7 @@ export const arbitraryWithdrawal = (): fc.Arbitrary<Withdrawal> =>
     agent: arbitraryAgent(),
     counterparty: arbitraryCounterparty(),
     asset: arbitraryTransactionAsset(),
-    amountDecimal: fc.float(),
+    amountDecimal: arbitraryAmountDecimal(),
     destination: fc.oneof(arbitraryBlockchainAddress(), arbitraryCAIP10()),
   });
 
@@ -149,7 +166,7 @@ export const arbitraryDepositRequest = (): fc.Arbitrary<DepositRequest> =>
     agent: arbitraryAgent(),
     counterparty: arbitraryCounterparty(),
     asset: arbitraryTransactionAsset(),
-    amountDecimal: fc.float(),
+    amountDecimal: arbitraryAmountDecimal(),
     destination: fc.oneof(arbitraryBlockchainAddress(), arbitraryCAIP10()),
     travelAddress: fc.option(arbitraryTravelAddress()),
     cryptoCredential: fc.option(arbitraryCryptoCredential()),
@@ -194,14 +211,63 @@ export const arbitraryFieldTypes = (): fc.Arbitrary<FieldTypes> =>
   });
 
 export const arbitraryVASPOptions = (): fc.Arbitrary<VASPOptions> =>
+  fc.oneof(
+    fc.record({
+      addUnknown: fc.option(fc.boolean(), { nil: undefined }),
+      onlyActive: fc.option(fc.boolean(), { nil: undefined }),
+      searchable: fc.option(
+        fc.array(
+          fc.constantFrom(VASPSearchControl.ALLOWED, VASPSearchControl.PENDING),
+        ),
+        { nil: undefined },
+      ),
+    }),
+    fc.record({
+      addUnknown: fc.option(fc.boolean(), { nil: undefined }),
+      onlyActive: fc.option(fc.boolean(), { nil: undefined }),
+      showTrustStatus: fc.option(
+        fc.array(
+          fc.constantFrom<VASPTrustStatus>(
+            'TRUSTED',
+            'NEW',
+            'FLAGGED',
+            'BANNED',
+          ),
+        ),
+        { nil: undefined },
+      ),
+    }),
+  );
+
+const SECTION_OPTIONS: SectionOption[] = [
+  'self-declaration',
+  'screenshot',
+  'microtransfer',
+  'signature',
+  'manual-signing',
+  'add-vasp',
+  'contact-support',
+];
+
+export const arbitrarySectionOption = (): fc.Arbitrary<SectionOption> =>
+  fc.constantFrom(...SECTION_OPTIONS);
+
+export const arbitraryAgentSections = (): fc.Arbitrary<AgentSections> =>
   fc.record({
-    addUnknown: fc.option(fc.boolean()),
-    onlyActive: fc.option(fc.boolean()),
+    main: fc.option(fc.array(arbitrarySectionOption())),
+    fallback: fc.option(fc.array(arbitrarySectionOption())),
   });
 
+export const arbitraryContactSupportConfig =
+  (): fc.Arbitrary<ContactSupportConfig> =>
+    fc.record({
+      supportUrl: fc.webUrl(),
+    });
+
 export const arbitraryTransactionOptions =
   (): fc.Arbitrary<TransactionOptions> =>
     fc.record({
+      agentSections: fc.option(arbitraryAgentSections()),
       proofs: fc.option(
         fc.record({
           microTransfer: fc.option(
@@ -228,6 +294,7 @@ export const arbitraryTransactionOptions =
       hide: fc.option(
         fc.array(fc.constantFrom(...Object.values(ValidationSections))),
       ),
+      contactSupport: fc.option(arbitraryContactSupportConfig()),
     });
 
 export const arbitraryDepositRequestOptions =
@@ -249,7 +316,7 @@ export const arbitraryDeposit = (): fc.Arbitrary<Deposit> =>
     agent: arbitraryAgent(),
     counterparty: arbitraryCounterparty(),
     asset: arbitraryTransactionAsset(),
-    amountDecimal: fc.float({ min: 0, max: 1e6 }),
+    amountDecimal: arbitraryAmountDecimal(),
     origin: fc.oneof(arbitraryBlockchainAddress(), arbitraryCAIP10()),
     source: fc.oneof(arbitraryBlockchainAddress(), arbitraryCAIP10()),
   });