@notabene/javascript-sdk 2.18.0 → 2.19.0

package/dist/cjs/notabene.d.ts

@@ -753,6 +753,23 @@ export declare type ConnectionResult<T extends ComponentRequest> = {
 
 export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
 
+/**
+ * Configuration for the terms and conditions consent checkbox.
+ *
+ * @remarks
+ * - `undefined` or `true`: show default T&C (current behavior)
+ * - `false`: hide T&C entirely
+ * - `{ label?, description? }`: show with custom text (translations are the customer's responsibility)
+ *
+ * @public
+ */
+export declare type ConsentConfig = boolean | {
+    /** Custom label text. Replaces the default "Accept terms and conditions". */
+    label?: string;
+    /** Custom description text. Replaces the default sharing-info description. */
+    description?: string;
+};
+
 /**
  * Configuration for the contact support action.
  *
@@ -3330,12 +3347,8 @@ 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;
+    consent?: ConsentConfig;
     autoSubmit?: boolean;
 }
 

package/dist/cjs/package.json

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

package/dist/esm/notabene.d.ts

@@ -753,6 +753,23 @@ export declare type ConnectionResult<T extends ComponentRequest> = {
 
 export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
 
+/**
+ * Configuration for the terms and conditions consent checkbox.
+ *
+ * @remarks
+ * - `undefined` or `true`: show default T&C (current behavior)
+ * - `false`: hide T&C entirely
+ * - `{ label?, description? }`: show with custom text (translations are the customer's responsibility)
+ *
+ * @public
+ */
+export declare type ConsentConfig = boolean | {
+    /** Custom label text. Replaces the default "Accept terms and conditions". */
+    label?: string;
+    /** Custom description text. Replaces the default sharing-info description. */
+    description?: string;
+};
+
 /**
  * Configuration for the contact support action.
  *
@@ -3330,12 +3347,8 @@ 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;
+    consent?: ConsentConfig;
     autoSubmit?: boolean;
 }
 

package/dist/esm/package.json

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

package/dist/notabene.d.ts

@@ -753,6 +753,23 @@ export declare type ConnectionResult<T extends ComponentRequest> = {
 
 export declare type ConnectionStatus = 'active' | 'completed' | 'closed';
 
+/**
+ * Configuration for the terms and conditions consent checkbox.
+ *
+ * @remarks
+ * - `undefined` or `true`: show default T&C (current behavior)
+ * - `false`: hide T&C entirely
+ * - `{ label?, description? }`: show with custom text (translations are the customer's responsibility)
+ *
+ * @public
+ */
+export declare type ConsentConfig = boolean | {
+    /** Custom label text. Replaces the default "Accept terms and conditions". */
+    label?: string;
+    /** Custom description text. Replaces the default sharing-info description. */
+    description?: string;
+};
+
 /**
  * Configuration for the contact support action.
  *
@@ -3330,12 +3347,8 @@ 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;
+    consent?: ConsentConfig;
     autoSubmit?: boolean;
 }
 

package/docs/README.md

@@ -73,6 +73,7 @@ This library is the JavaScript SDK for loading the Notabene UX components in the
       - [Full Example](#full-example)
       - [Field reference](#field-reference)
     - [Configure Counterparty Assist](#counterparty-assist-configuration)
+    - [Consent / Terms & Conditions](#consent--terms--conditions)
   - [Locales](#locales)
   - [Theming](#theming)
   - [License](#license)
@@ -767,7 +768,8 @@ const options: TransactionOptions = {
       PersonType.NATURAL, // JS: 'natural'
       PersonType.SELF, // JS: 'self'
     ],
-  }
+  },
+  consent: true, // true (default) | false (hide) | { label?: string, description?: string }
 };
 const withdrawal = notabene.createWithdrawalAssist(tx, options);
 ```
@@ -987,6 +989,37 @@ const options: TransactionOptions = {
 | `lei`                    | --      | ✅    | 🟩      | LEI (Legal Entity Identifier)                 |
 | `countryOfRegistration`  | --      | 🟩    | 🟩      | Country of Registration                       |
 
+### Consent / Terms & Conditions
+
+By default, a consent checkbox is shown when the counterparty agent is a VASP. It asks the user to accept sharing personal information with the receiving/sending exchange. You can configure this behavior using the `consent` option.
+
+- `undefined` or `true`: Show the default consent checkbox (default behavior)
+- `false`: Hide the consent checkbox entirely
+- `{ label?, description? }`: Show the checkbox with custom text
+
+#### Hiding the consent checkbox
+
+```ts
+const options: TransactionOptions = {
+  consent: false,
+};
+```
+
+When hidden, the consent requirement is skipped in validation — the component will complete without requiring the user to check the box.
+
+#### Custom consent text
+
+```ts
+const options: TransactionOptions = {
+  consent: {
+    label: 'I agree to the terms',
+    description: 'By proceeding you agree to share your name and address with the counterparty.',
+  },
+};
+```
+
+Both `label` and `description` are optional — you can override one while keeping the default for the other. Translations are the customer's responsibility when providing custom text.
+
 ## Locales
 
 See [locales](_media/locales.ts) for the list of supported locales.

package/package.json

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

package/src/notabene.ts

@@ -14,6 +14,7 @@ import type {
   ComponentResponse,
   ConnectionOptions,
   ConnectionRequest,
+  ConsentConfig,
   ContactSupportConfig,
   CosmosMetadata,
   Counterparty,
@@ -143,6 +144,7 @@ export type {
   ComponentResponse,
   ConnectionOptions,
   ConnectionRequest,
+  ConsentConfig,
   ContactSupportConfig,
   CosmosMetadata,
   Counterparty,

package/src/types.ts

@@ -978,6 +978,25 @@ export interface AgentSections {
   fallback?: SectionOption[];
 }
 
+/**
+ * Configuration for the terms and conditions consent checkbox.
+ *
+ * @remarks
+ * - `undefined` or `true`: show default T&C (current behavior)
+ * - `false`: hide T&C entirely
+ * - `{ label?, description? }`: show with custom text (translations are the customer's responsibility)
+ *
+ * @public
+ */
+export type ConsentConfig =
+  | boolean
+  | {
+      /** Custom label text. Replaces the default "Accept terms and conditions". */
+      label?: string;
+      /** Custom description text. Replaces the default sharing-info description. */
+      description?: string;
+    };
+
 /**
  * Configuration options for Transaction components
  * @public
@@ -1005,12 +1024,8 @@ 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;
+  contactSupport?: ContactSupportConfig; // Requires 'contact-support' in agentSections
+  consent?: ConsentConfig; // Defaults to true
   autoSubmit?: boolean; // Defaults to false
 }
 /**