@notabene/javascript-sdk 2.17.0 → 2.18.0

package/package.json

@@ -10,7 +10,7 @@
   "author": "Notabene <developers@notabene.id>",
   "license": "MIT",
   "packageManager": "yarn@4.5.1",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",
@@ -107,4 +107,4 @@
       "@commitlint/config-conventional"
     ]
   }
-}
+}

package/src/notabene.ts

@@ -14,6 +14,7 @@ import type {
   ComponentResponse,
   ConnectionOptions,
   ConnectionRequest,
+  ContactSupportConfig,
   CosmosMetadata,
   Counterparty,
   CounterpartyAssistConfig,
@@ -74,6 +75,7 @@ import {
   ErrorIdentifierCode,
   HMType,
   IdentityVerificationMethod,
+  InfoIdentifierCode,
   PersonType,
   ProofStatus,
   ProofTypes,
@@ -117,6 +119,7 @@ export {
   ErrorIdentifierCode,
   HMType,
   IdentityVerificationMethod,
+  InfoIdentifierCode,
   PersonType,
   ProofStatus,
   ProofTypes,
@@ -140,6 +143,7 @@ export type {
   ComponentResponse,
   ConnectionOptions,
   ConnectionRequest,
+  ContactSupportConfig,
   CosmosMetadata,
   Counterparty,
   CounterpartyAssistConfig,

package/src/types.ts

@@ -922,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.
@@ -934,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.
@@ -983,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
 }
 /**
@@ -1111,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,6 +21,7 @@ import type {
   ISOCurrency,
   ISODate,
   NaturalPerson,
+  SectionOption,
   ThresholdOptions,
   TransactionAsset,
   TransactionOptions,
@@ -236,9 +239,35 @@ export const arbitraryVASPOptions = (): fc.Arbitrary<VASPOptions> =>
     }),
   );
 
+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({
+    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(
@@ -265,6 +294,7 @@ export const arbitraryTransactionOptions =
       hide: fc.option(
         fc.array(fc.constantFrom(...Object.values(ValidationSections))),
       ),
+      contactSupport: fc.option(arbitraryContactSupportConfig()),
     });
 
 export const arbitraryDepositRequestOptions =