@notabene/javascript-sdk 2.16.0 → 2.17.0

package/dist/cjs/notabene.d.ts

@@ -272,7 +272,6 @@ declare type BeneficiaryFields = {
 
 declare type BeneficiaryV2 = {
     beneficiaryPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -879,7 +878,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;
 };
@@ -2107,6 +2106,7 @@ declare type NaturalPersonNationalIdentifierTypeCode = Omit<NationalIdentifierTy
 
 declare type NaturalPersonV2 = Omit<NaturalPerson_2, 'name'> & {
     name: NaturalPersonNameV2;
+    customerIdentification?: string;
 };
 
 /**
@@ -2450,7 +2450,6 @@ declare type OriginatorFields = {
 
 declare type OriginatorV2 = {
     originatorPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -3220,7 +3219,7 @@ export declare interface Transaction extends ComponentRequest {
     agent: Agent;
     counterparty: Counterparty;
     asset: TransactionAsset;
-    amountDecimal: number;
+    amountDecimal: string | number;
     proof?: OwnershipProof;
     assetPrice?: {
         price: number;
@@ -3517,13 +3516,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 +3562,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",
   "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;
 };
 
 /**
@@ -879,7 +878,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;
 };
@@ -2107,6 +2106,7 @@ declare type NaturalPersonNationalIdentifierTypeCode = Omit<NationalIdentifierTy
 
 declare type NaturalPersonV2 = Omit<NaturalPerson_2, 'name'> & {
     name: NaturalPersonNameV2;
+    customerIdentification?: string;
 };
 
 /**
@@ -2450,7 +2450,6 @@ declare type OriginatorFields = {
 
 declare type OriginatorV2 = {
     originatorPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -3220,7 +3219,7 @@ export declare interface Transaction extends ComponentRequest {
     agent: Agent;
     counterparty: Counterparty;
     asset: TransactionAsset;
-    amountDecimal: number;
+    amountDecimal: string | number;
     proof?: OwnershipProof;
     assetPrice?: {
         price: number;
@@ -3517,13 +3516,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 +3562,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/esm/notabene.js

@@ -12223,7 +12223,7 @@ function _c(e) {
     account: n == null ? void 0 : n.account,
     proof: m,
     asset: (n == null ? void 0 : n.asset) || (typeof l.transactionAsset == "string" ? l.transactionAsset : (h = l.transactionAsset) == null ? void 0 : h.caip19) || "",
-    amountDecimal: (n == null ? void 0 : n.amountDecimal) || (l.transactionAmount ? parseFloat(l.transactionAmount) : 0),
+    amountDecimal: (n == null ? void 0 : n.amountDecimal) ?? l.transactionAmount ?? 0,
     customer: n == null ? void 0 : n.customer
   };
   return mc(s, l, d);

package/dist/esm/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",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",

package/dist/notabene.d.ts

@@ -272,7 +272,6 @@ declare type BeneficiaryFields = {
 
 declare type BeneficiaryV2 = {
     beneficiaryPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -879,7 +878,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;
 };
@@ -2107,6 +2106,7 @@ declare type NaturalPersonNationalIdentifierTypeCode = Omit<NationalIdentifierTy
 
 declare type NaturalPersonV2 = Omit<NaturalPerson_2, 'name'> & {
     name: NaturalPersonNameV2;
+    customerIdentification?: string;
 };
 
 /**
@@ -2450,7 +2450,6 @@ declare type OriginatorFields = {
 
 declare type OriginatorV2 = {
     originatorPerson: PersonV2[];
-    customerIdentification?: string;
 };
 
 /**
@@ -3220,7 +3219,7 @@ export declare interface Transaction extends ComponentRequest {
     agent: Agent;
     counterparty: Counterparty;
     asset: TransactionAsset;
-    amountDecimal: number;
+    amountDecimal: string | number;
     proof?: OwnershipProof;
     assetPrice?: {
         price: number;
@@ -3517,13 +3516,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 +3562,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/notabene.js

@@ -12223,7 +12223,7 @@ function _c(e) {
     account: n == null ? void 0 : n.account,
     proof: m,
     asset: (n == null ? void 0 : n.asset) || (typeof l.transactionAsset == "string" ? l.transactionAsset : (h = l.transactionAsset) == null ? void 0 : h.caip19) || "",
-    amountDecimal: (n == null ? void 0 : n.amountDecimal) || (l.transactionAmount ? parseFloat(l.transactionAmount) : 0),
+    amountDecimal: (n == null ? void 0 : n.amountDecimal) ?? l.transactionAmount ?? 0,
     customer: n == null ? void 0 : n.customer
   };
   return mc(s, l, d);

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",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",

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

@@ -63,6 +63,7 @@ import type {
   ValidationError,
   VASP,
   VASPOptions,
+  VASPTrustStatus,
   Wallet,
   Withdrawal,
 } from './types';
@@ -189,6 +190,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

package/src/utils/arbitraries.ts

@@ -24,6 +24,7 @@ import type {
   TransactionOptions,
   TravelAddress,
   VASPOptions,
+  VASPTrustStatus,
   Withdrawal,
 } from '../types';
 import {
@@ -31,6 +32,7 @@ import {
   PersonType,
   ProofTypes,
   ValidationSections,
+  VASPSearchControl,
 } from '../types';
 import {
   CAIP10_MATCHER,
@@ -91,6 +93,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 +113,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 +163,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,10 +208,33 @@ export const arbitraryFieldTypes = (): fc.Arbitrary<FieldTypes> =>
   });
 
 export const arbitraryVASPOptions = (): fc.Arbitrary<VASPOptions> =>
-  fc.record({
-    addUnknown: fc.option(fc.boolean()),
-    onlyActive: fc.option(fc.boolean()),
-  });
+  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 },
+      ),
+    }),
+  );
 
 export const arbitraryTransactionOptions =
   (): fc.Arbitrary<TransactionOptions> =>
@@ -249,7 +286,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()),
   });