@notabene/javascript-sdk 2.14.2-next.5 → 2.15.0-next.1

package/dist/cjs/notabene.d.ts

@@ -73,6 +73,26 @@ export declare interface Agent {
     verified?: boolean;
 }
 
+/**
+ * Explicit layout configuration for the agent selection step.
+ *
+ * @remarks
+ * Controls which options appear in the main selection area vs. behind the
+ * "Can't find what you're looking for?" fallback toggle.
+ *
+ * When the main section has no options (empty or all filtered out), fallback options
+ * are promoted and shown inline. When the main section has only one option, a dedicated
+ * single-option layout is used.
+ *
+ * @public
+ */
+export declare interface AgentSections {
+    /** Options shown in the main selection area (always visible) */
+    main?: SectionOption[];
+    /** Options shown behind the "Can't find what you're looking for?" fallback toggle */
+    fallback?: SectionOption[];
+}
+
 /**
  * The type of Agent. Either a wallet or a VASP
  * @public
@@ -1694,6 +1714,25 @@ export declare interface ScreenshotProof extends OwnershipProof {
     url: string;
 }
 
+/**
+ * Options that can be placed in either the main or fallback sections of the agent selection step.
+ *
+ * @remarks
+ * Combines proof types from {@link ProofTypes} with additional UI-specific options:
+ * - `ProofTypes.SelfDeclaration` — ownership proof via self-declaration
+ * - `ProofTypes.Screenshot` — ownership proof via screenshot upload
+ * - `ProofTypes.MicroTransfer` — ownership proof via micro-transfer
+ * - `'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)
+ *
+ * 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 = ProofTypes.SelfDeclaration | ProofTypes.Screenshot | ProofTypes.MicroTransfer | 'signature' | 'manual-signing' | 'add-vasp';
+
 /**
  * Interface for signature-based ownership proofs that use cryptographic message signing
  *
@@ -1914,6 +1953,11 @@ export declare interface TransactionIVMS101Request {
  * @public
  */
 export declare interface TransactionOptions {
+    /**
+     * Explicit layout configuration for the agent selection step.
+     * When provided, takes precedence over legacy fields (`proofs.fallbacks`, `vasps.addUnknown`).
+     */
+    agentSections?: AgentSections;
     proofs?: {
         reuseProof?: boolean;
         microTransfer?: {
@@ -1931,7 +1975,6 @@ export declare interface TransactionOptions {
     hide?: ValidationSections[];
     counterpartyAssist?: CounterpartyAssistConfig;
     autoSubmit?: boolean;
-    supportUrl?: string;
 }
 
 /**

package/dist/cjs/package.json

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

package/dist/esm/notabene.d.ts

@@ -73,6 +73,26 @@ export declare interface Agent {
     verified?: boolean;
 }
 
+/**
+ * Explicit layout configuration for the agent selection step.
+ *
+ * @remarks
+ * Controls which options appear in the main selection area vs. behind the
+ * "Can't find what you're looking for?" fallback toggle.
+ *
+ * When the main section has no options (empty or all filtered out), fallback options
+ * are promoted and shown inline. When the main section has only one option, a dedicated
+ * single-option layout is used.
+ *
+ * @public
+ */
+export declare interface AgentSections {
+    /** Options shown in the main selection area (always visible) */
+    main?: SectionOption[];
+    /** Options shown behind the "Can't find what you're looking for?" fallback toggle */
+    fallback?: SectionOption[];
+}
+
 /**
  * The type of Agent. Either a wallet or a VASP
  * @public
@@ -1694,6 +1714,25 @@ export declare interface ScreenshotProof extends OwnershipProof {
     url: string;
 }
 
+/**
+ * Options that can be placed in either the main or fallback sections of the agent selection step.
+ *
+ * @remarks
+ * Combines proof types from {@link ProofTypes} with additional UI-specific options:
+ * - `ProofTypes.SelfDeclaration` — ownership proof via self-declaration
+ * - `ProofTypes.Screenshot` — ownership proof via screenshot upload
+ * - `ProofTypes.MicroTransfer` — ownership proof via micro-transfer
+ * - `'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)
+ *
+ * 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 = ProofTypes.SelfDeclaration | ProofTypes.Screenshot | ProofTypes.MicroTransfer | 'signature' | 'manual-signing' | 'add-vasp';
+
 /**
  * Interface for signature-based ownership proofs that use cryptographic message signing
  *
@@ -1914,6 +1953,11 @@ export declare interface TransactionIVMS101Request {
  * @public
  */
 export declare interface TransactionOptions {
+    /**
+     * Explicit layout configuration for the agent selection step.
+     * When provided, takes precedence over legacy fields (`proofs.fallbacks`, `vasps.addUnknown`).
+     */
+    agentSections?: AgentSections;
     proofs?: {
         reuseProof?: boolean;
         microTransfer?: {
@@ -1931,7 +1975,6 @@ export declare interface TransactionOptions {
     hide?: ValidationSections[];
     counterpartyAssist?: CounterpartyAssistConfig;
     autoSubmit?: boolean;
-    supportUrl?: string;
 }
 
 /**

package/dist/esm/package.json

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

package/dist/notabene.d.ts

@@ -73,6 +73,26 @@ export declare interface Agent {
     verified?: boolean;
 }
 
+/**
+ * Explicit layout configuration for the agent selection step.
+ *
+ * @remarks
+ * Controls which options appear in the main selection area vs. behind the
+ * "Can't find what you're looking for?" fallback toggle.
+ *
+ * When the main section has no options (empty or all filtered out), fallback options
+ * are promoted and shown inline. When the main section has only one option, a dedicated
+ * single-option layout is used.
+ *
+ * @public
+ */
+export declare interface AgentSections {
+    /** Options shown in the main selection area (always visible) */
+    main?: SectionOption[];
+    /** Options shown behind the "Can't find what you're looking for?" fallback toggle */
+    fallback?: SectionOption[];
+}
+
 /**
  * The type of Agent. Either a wallet or a VASP
  * @public
@@ -1694,6 +1714,25 @@ export declare interface ScreenshotProof extends OwnershipProof {
     url: string;
 }
 
+/**
+ * Options that can be placed in either the main or fallback sections of the agent selection step.
+ *
+ * @remarks
+ * Combines proof types from {@link ProofTypes} with additional UI-specific options:
+ * - `ProofTypes.SelfDeclaration` — ownership proof via self-declaration
+ * - `ProofTypes.Screenshot` — ownership proof via screenshot upload
+ * - `ProofTypes.MicroTransfer` — ownership proof via micro-transfer
+ * - `'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)
+ *
+ * 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 = ProofTypes.SelfDeclaration | ProofTypes.Screenshot | ProofTypes.MicroTransfer | 'signature' | 'manual-signing' | 'add-vasp';
+
 /**
  * Interface for signature-based ownership proofs that use cryptographic message signing
  *
@@ -1914,6 +1953,11 @@ export declare interface TransactionIVMS101Request {
  * @public
  */
 export declare interface TransactionOptions {
+    /**
+     * Explicit layout configuration for the agent selection step.
+     * When provided, takes precedence over legacy fields (`proofs.fallbacks`, `vasps.addUnknown`).
+     */
+    agentSections?: AgentSections;
     proofs?: {
         reuseProof?: boolean;
         microTransfer?: {
@@ -1931,7 +1975,6 @@ export declare interface TransactionOptions {
     hide?: ValidationSections[];
     counterpartyAssist?: CounterpartyAssistConfig;
     autoSubmit?: boolean;
-    supportUrl?: string;
 }
 
 /**

package/package.json

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

package/src/notabene.ts

@@ -2,6 +2,7 @@ import EmbeddedComponent from './components/EmbeddedComponent';
 import type {
   Account,
   Agent,
+  AgentSections,
   BlockchainAddress,
   CAIP10,
   CAIP19,
@@ -45,6 +46,7 @@ import type {
   RefreshSource,
   ResizeRequest,
   ScreenshotProof,
+  SectionOption,
   SignatureProof,
   SIWXInput,
   SolanaMetadata,
@@ -123,6 +125,7 @@ export {
 export type {
   Account,
   Agent,
+  AgentSections,
   BlockchainAddress,
   CAIP10,
   CAIP19,
@@ -167,6 +170,7 @@ export type {
   RefreshSource,
   ResizeRequest,
   ScreenshotProof,
+  SectionOption,
   SignatureProof,
   SIWXInput,
   SolanaMetadata,

package/src/types.ts

@@ -860,18 +860,68 @@ export interface ThresholdOptions {
   currency: ISOCurrency; // Currency of threshold
   proofTypes?: ProofTypes[]; // If left empty no proof will be required under threshold
 }
+/**
+ * Options that can be placed in either the main or fallback sections of the agent selection step.
+ *
+ * @remarks
+ * Combines proof types from {@link ProofTypes} with additional UI-specific options:
+ * - `ProofTypes.SelfDeclaration` — ownership proof via self-declaration
+ * - `ProofTypes.Screenshot` — ownership proof via screenshot upload
+ * - `ProofTypes.MicroTransfer` — ownership proof via micro-transfer
+ * - `'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)
+ *
+ * Options are automatically filtered by flow (e.g. `add-vasp` is ignored in self-hosted).
+ * Including an option implicitly enables that capability.
+ *
+ * @public
+ */
+export type SectionOption =
+  | ProofTypes.SelfDeclaration
+  | ProofTypes.Screenshot
+  | ProofTypes.MicroTransfer
+  | 'signature'
+  | 'manual-signing'
+  | 'add-vasp';
+
+/**
+ * Explicit layout configuration for the agent selection step.
+ *
+ * @remarks
+ * Controls which options appear in the main selection area vs. behind the
+ * "Can't find what you're looking for?" fallback toggle.
+ *
+ * When the main section has no options (empty or all filtered out), fallback options
+ * are promoted and shown inline. When the main section has only one option, a dedicated
+ * single-option layout is used.
+ *
+ * @public
+ */
+export interface AgentSections {
+  /** Options shown in the main selection area (always visible) */
+  main?: SectionOption[];
+  /** Options shown behind the "Can't find what you're looking for?" fallback toggle */
+  fallback?: SectionOption[];
+}
+
 /**
  * Configuration options for Transaction components
  * @public
  */
 export interface TransactionOptions {
+  /**
+   * Explicit layout configuration for the agent selection step.
+   * When provided, takes precedence over legacy fields (`proofs.fallbacks`, `vasps.addUnknown`).
+   */
+  agentSections?: AgentSections;
   proofs?: {
     reuseProof?: boolean; // Defaults true
     microTransfer?: {
       destination: BlockchainAddress;
       amountSubunits: string;
     };
-    fallbacks?: ProofTypes[];
+    fallbacks?: ProofTypes[]; // Legacy — replaced by agentSections.fallback
     deminimis?: ThresholdOptions;
   };
   jurisdiction?: string;
@@ -882,7 +932,6 @@ export interface TransactionOptions {
   hide?: ValidationSections[]; // You can hide a specific section of the component by listing it here
   counterpartyAssist?: CounterpartyAssistConfig;
   autoSubmit?: boolean; // Defaults to false
-  supportUrl?: string;
 }
 /**
  * Component Message Type enum representing different message types that can be sent