@notabene/javascript-sdk 2.15.0-next.2 → 2.15.0-next.3

package/dist/cjs/notabene.d.ts

@@ -1,6 +1,3 @@
-import type { Agent as Agent_2 } from '@taprsvp/types';
-import type { DID as DID_2 } from '@taprsvp/types';
-
 /**
  * A blockchain account
  * @public
@@ -53,6 +50,59 @@ declare type Address = {
     country: ISOCountryCode;
 };
 
+/**
+ * Represents an address
+ *
+ * Per IVMS101 spec section 5.2.6.1, an address contains location information
+ * that can be expressed either as:
+ * - Structured fields (streetName, buildingNumber, etc.)
+ * - Unstructured addressLine array (free-form text)
+ *
+ * Constraint C8 requires at least one of:
+ * - addressLine OR
+ * - (streetName AND (buildingName OR buildingNumber))
+ */
+declare interface Address_2 {
+    /** Identifies the nature of the address */
+    addressType: AddressTypeCode_2;
+    /** Identification of a division of a large organisation or building */
+    department?: string;
+    /** Identification of a sub-division of a large organisation or building */
+    subDepartment?: string;
+    /** Name of a street or thoroughfare */
+    streetName?: string;
+    /** Number that identifies the position of a building on a street */
+    buildingNumber?: string;
+    /** Name of the building or house */
+    buildingName?: string;
+    /** Floor or storey within a building */
+    floor?: string;
+    /** Numbered box in a post office, assigned to a person or organisation, where letters are kept until called for */
+    postBox?: string;
+    /** Building room number */
+    room?: string;
+    /** Identifier consisting of a group of letters and/or numbers */
+    postcode?: string;
+    /** Name of a built-up area, with defined boundaries, and a local government */
+    townName: string;
+    /** Specific location name within the town */
+    townLocationName?: string;
+    /** Identifies a subdivision within a country subdivision */
+    districtName?: string;
+    /** Identifies a subdivision of a country */
+    countrySubDivision?: string;
+    /** Nation with its own government */
+    country: CountryCode;
+    /**
+     * Information that locates and identifies a specific address, as defined by postal services,
+     * presented in free format text.
+     *
+     * Array of 0 to 7 lines, each max 70 characters (Max70Text)
+     * @maxItems 7
+     */
+    addressLine?: string[];
+}
+
 /**
  * Address Type Code
  * Specifies the type of address
@@ -60,6 +110,9 @@ declare type Address = {
  */
 declare type AddressTypeCode = 'HOME' | 'BIZZ' | 'GEOG';
 
+/** Codes identifying the nature of an address */
+declare type AddressTypeCode_2 = "HOME" | "BIZZ" | "GEOG";
+
 /**
  * Who is the agent acting on behalf of the counterparty
  * @public
@@ -73,6 +126,76 @@ export declare interface Agent {
     verified?: boolean;
 }
 
+/**
+ * Agent Interface
+ * Represents software acting on behalf of participants in TAP transactions.
+ * Agents handle communication, compliance, and transaction processing.
+ *
+ * @example
+ * ```typescript
+ * const originatorAgent: Agent = {
+ *   "@id": "did:web:vasp.example.com",
+ *   role: "SourceAddress",
+ *   for: "did:example:customer123",
+ *   name: "Example VASP Agent",
+ *   leiCode: "969500KN90DZLPGW6898",
+ *   url: "https://vasp.example.com",
+ *   email: "compliance@vasp.example.com",
+ *   geographicAddress: [{
+ *     addressType: "HOME",
+ *     streetName: "123 Main St",
+ *     buildingNumber: "123",
+ *     postCode: "12345",
+ *     townName: "Example City",
+ *     country: "US"
+ *   }],
+ *   policies: [{
+ *     "@type": "RequireAuthorization",
+ *     purpose: "AML compliance verification"
+ *   }],
+ *   serviceUrl: "https://vasp.example.com/didcomm"
+ * };
+ * ```
+ */
+declare interface Agent_2 extends Partial<Organization> {
+    /**
+     * Unique identifier for the participant
+     * Can be either a DID or an IRI
+     */
+    "@id": DID_2 | IRI;
+    /**
+     * Role of the participant in the transaction
+     * Standard values for Agents are: "SettlementAddress", "SourceAddress", "CustodialService"
+     * All role values MUST use PascalCase
+     * Optional for all participant types
+     */
+    role?: AgentRoles;
+    /**
+     * DID of the party this participant acts for
+     * Used when participant is an agent acting on behalf of another party
+     * Required for type "Agent", optional for other types
+     * Can be a single DID or an array of DIDs representing multiple parties
+     */
+    for: DID_2 | DID_2[];
+    /**
+     * List of policies that apply to this participant
+     * Defines requirements and constraints on the participant's actions
+     */
+    policies?: Policies[];
+    /**
+     * Optional DIDComm service endpoint URL
+     * This field SHOULD only be used as a fallback when no DIDComm service endpoint
+     * is resolvable from the agent's DID document. Particularly useful for self-hosted
+     * and decentralized agents. For security purposes, this field SHOULD be ignored
+     * if a valid DIDComm service endpoint is already listed in the DID document.
+     *
+     * @example "https://agent.example.com/didcomm"
+     */
+    serviceUrl?: IRI;
+}
+
+declare type AgentRoles = "SettlementAddress" | "SourceAddress" | "CustodialService" | "EscrowAgent" | string;
+
 /**
  * Explicit layout configuration for the agent selection step.
  *
@@ -677,6 +800,8 @@ export declare type CounterpartyAssistConfig = boolean | {
     identityVerification?: IdentityVerificationConfig;
 };
 
+declare type CountryCode = "AF" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BQ" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "CV" | "KH" | "CM" | "CA" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CD" | "CG" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "MP" | "NO" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "PR" | "QA" | "RO" | "RU" | "RW" | "RE" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "VC" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "SS" | "ES" | "LK" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "UM" | "US" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "AX" | "XX";
+
 /**
  * A crypto credential
  * @public
@@ -759,6 +884,18 @@ export declare type Destination = BlockchainAddress | CAIP10 | CryptoCredential
  */
 export declare type DID = `did:${string}:${string}`;
 
+/**
+ * Decentralized Identifier (DID)
+ * A globally unique persistent identifier that doesn't require a centralized registration authority.
+ *
+ * Format: `did:method:method-specific-id`
+ *
+ * @example "did:web:example.com"
+ * @example "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"
+ * @see {@link https://www.w3.org/TR/did-core/ | DID Core Specification}
+ */
+declare type DID_2 = `did:${string}:${string}`;
+
 /**
  * Digital Token Identifier (DTI) following ISO 24165 standard
  *
@@ -1006,6 +1143,15 @@ export declare type InvalidValue<T> = {
     errors: ValidationError[];
 };
 
+/**
+ * Internationalized Resource Identifier (IRI)
+ * A unique identifier that may contain international characters.
+ * Used for identifying resources, particularly in JSON-LD contexts.
+ *
+ * @see {@link https://www.w3.org/TR/json-ld11/#iris | JSON-LD 1.1 IRIs}
+ */
+declare type IRI = `${string}:${string}`;
+
 /**
  * ISO-3166 Alpha-2 country code
  * @example "US" for United States, "GB" for United Kingdom
@@ -1041,6 +1187,19 @@ export declare type IVMS101 = {
     payloadMetadata?: PayloadMetadata;
 };
 
+/**
+ * Base interface for JSON-LD objects
+ * Provides the core structure for JSON-LD compatible objects with type information.
+ *
+ * @template T - The type string that identifies the object type
+ */
+declare interface JsonLdObject<T extends string> {
+    "@context"?: IRI | Record<string, string>;
+    "@type": T;
+}
+
+declare type LegalEntityNationalIdentifierTypeCode = Omit<NationalIdentifierTypeCode_2, "ARNU" | "CCPT" | "DRLC" | "SOCS" | "IDCD">;
+
 /**
  * Interface representing a legal entity (organization/company) involved in a transaction
  *
@@ -1132,6 +1291,14 @@ declare type LegalPersonNameID = {
     legalPersonNameIdentifierType: LegalPersonNameTypeCode;
 };
 
+/** Represents a legal person's name identifier */
+declare interface LegalPersonNameId {
+    /** Name by which the legal person is known */
+    legalPersonName: string;
+    /** The nature of the name specified */
+    legalPersonNameIdentifierType: LegalPersonNameTypeCode_2;
+}
+
 /**
  * Legal Person Name Type Code
  * Specifies the type of name for a legal person
@@ -1139,12 +1306,24 @@ declare type LegalPersonNameID = {
  */
 declare type LegalPersonNameTypeCode = 'LEGL' | 'SHRT' | 'TRAD';
 
+/** Codes representing the nature of a legal person's name */
+declare type LegalPersonNameTypeCode_2 = "LEGL" | "SHRT" | "TRAD";
+
 /**
  * A LEI Legal Entity Identifier
  * @public
  */
 export declare type LEI = string;
 
+/**
+ * Legal Entity Identifier (LEI)
+ * A 20-character alphanumeric code that uniquely identifies legal entities globally.
+ *
+ * @example "969500KN90DZLPGW6898"
+ * @see {@link https://www.iso.org/standard/59771.html | ISO 17442}
+ */
+declare type LEICode = string;
+
 /**
  * Local Legal Person Name ID
  * Represents a local name identifier for a legal person
@@ -1209,6 +1388,18 @@ export declare type NationalIdentification = {
     registrationAuthority?: string;
 };
 
+/** Represents a national identification */
+declare interface NationalIdentification_2<C> {
+    /** An identifier issued by an appropriate issuing authority */
+    nationalIdentifier: string;
+    /** Specifies the type of identifier */
+    nationalIdentifierType: C;
+    /** Country of the issuing authority */
+    countryOfIssue?: CountryCode;
+    /** A code specifying the registration authority */
+    registrationAuthority?: string;
+}
+
 /**
  * National Identifier Type Code
  * Specifies the type of national identifier
@@ -1216,6 +1407,22 @@ export declare type NationalIdentification = {
  */
 declare type NationalIdentifierTypeCode = 'ARNU' | 'CCPT' | 'RAID' | 'DRLC' | 'FIIN' | 'TXID' | 'SOCS' | 'IDCD' | 'LEIX' | 'MISC';
 
+/**
+ * Codes identifying the type of national identification
+ *
+ * - **ARNU**: Alien registration number - Number assigned by a government agency to identify foreign nationals
+ * - **CCPT**: Passport number - Number assigned by a passport authority
+ * - **RAID**: Registration authority identifier - Identifier of a legal entity as maintained by a registration authority
+ * - **DRLC**: Driver license number - Number assigned to a driver's license
+ * - **FIIN**: Foreign investment identity number - Number assigned to a foreign investor (other than the alien number)
+ * - **TXID**: Tax identification number - Number assigned by a tax authority to an entity
+ * - **SOCS**: Social security number - Number assigned by a social security agency
+ * - **IDCD**: Identity card number - Number assigned by a national authority to an identity card
+ * - **LEIX**: Legal Entity Identifier - Legal Entity Identifier (LEI) assigned in accordance with ISO 17442
+ * - **MISC**: Miscellaneous - Other types of national identification not covered by the above codes
+ */
+declare type NationalIdentifierTypeCode_2 = "ARNU" | "CCPT" | "RAID" | "DRLC" | "FIIN" | "TXID" | "SOCS" | "IDCD" | "LEIX" | "MISC";
+
 /**
  * Field properties for national identifier type selection
  * @public
@@ -1345,6 +1552,15 @@ declare type NaturalPersonV2 = Omit<NaturalPerson_2, 'name'> & {
     name: NaturalPersonNameV2;
 };
 
+/**
+ * Primary constructor for Notabene UX elements
+ *
+ * This class provides methods to create and manage various Notabene components
+ * such as withdrawal assist, deposit assist, connect, and deposit request.
+ * It also handles URL generation and fragment decoding for these components.
+ *
+ * @public
+ */
 declare class Notabene {
     private nodeUrl?;
     private authToken?;
@@ -1469,6 +1685,155 @@ export declare interface NotabeneConfig {
     locale?: string;
 }
 
+/**
+ * Organization Interface
+ * Represents a legal entity (company, institution, merchant) in TAP transactions.
+ * Supports both schema.org/Organization properties and IVMS101 identity data for compliance.
+ *
+ * Organizations typically have less privacy concerns than natural persons, making direct
+ * inclusion of IVMS101 data more common for transparency and compliance purposes.
+ *
+ * @example
+ * ```typescript
+ * // Basic organization with schema.org properties
+ * const basicOrg: Organization = {
+ *   "@id": "did:web:example.com",
+ *   "@type": "https://schema.org/Organization",
+ *   name: "Example Corp",
+ *   url: "https://example.com",
+ *   email: "contact@example.com"
+ * };
+ *
+ * // VASP with full compliance data
+ * const vasp: Organization = {
+ *   "@id": "did:web:vasp.example.com",
+ *   "@type": "https://schema.org/Organization",
+ *   name: "Example Virtual Asset Service Provider",
+ *   leiCode: "969500KN90DZLPGW6898",
+ *   url: "https://vasp.example.com",
+ *   logo: "https://vasp.example.com/logo.png",
+ *   description: "Licensed Virtual Asset Service Provider",
+ *   email: "compliance@vasp.example.com",
+ *   telephone: "+1-555-123-4567",
+ *   geographicAddress: [{
+ *     addressType: "BIZZ",
+ *     streetName: "456 Financial District",
+ *     buildingNumber: "456",
+ *     postCode: "10005",
+ *     townName: "New York",
+ *     country: "US"
+ *   }],
+ *   nationalIdentifier: {
+ *     nationalIdentifier: "12-3456789",
+ *     nationalIdentifierType: "TXID", // Tax ID
+ *     countryOfIssue: "US"
+ *   },
+ *   countryOfRegistration: "US"
+ * };
+ *
+ * // Merchant with MCC
+ * const merchant: Organization = {
+ *   "@id": "did:web:coffee.example.com",
+ *   "@type": "https://schema.org/Organization",
+ *   name: "Downtown Coffee Shop",
+ *   mcc: "5812", // Restaurant
+ *   url: "https://coffee.example.com",
+ *   geographicAddress: [{
+ *     addressType: "BIZZ",
+ *     streetName: "123 Main Street",
+ *     buildingNumber: "123",
+ *     postCode: "12345",
+ *     townName: "Anytown",
+ *     country: "US"
+ *   }]
+ * };
+ * ```
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-6.md | TAIP-6: Party Identification}
+ * @see {@link https://schema.org/Organization | schema.org/Organization}
+ */
+declare interface Organization extends Participant {
+    "@type": "https://schema.org/Organization";
+    /**
+     * Legal Entity Identifier (LEI) code
+     * 20-character alphanumeric code that uniquely identifies legal entities globally
+     * Used to uniquely identify legal entities involved in financial transactions
+     * @example "969500KN90DZLPGW6898"
+     * @see {@link https://www.iso.org/standard/59771.html | ISO 17442}
+     */
+    leiCode?: LEICode;
+    /**
+     * Legal name of the organization
+     * Can be a simple string or structured IVMS101 name identifiers
+     * For regulated entities, IVMS101 format may be required for compliance
+     * @example "Example Corporation Inc." // Simple string
+     * @example [{ legalPersonName: "Example Corp", legalPersonNameIdentifierType: "LEGL" }] // IVMS101
+     */
+    name?: string | LegalPersonNameId[];
+    /**
+     * Customer identification string
+     * Internal identifier used by the institution for this organization
+     * @example "CORP-789012"
+     */
+    customerIdentification?: string;
+    /**
+     * National identification documents
+     * Government-issued identifiers like tax ID, business registration number
+     * @example { nationalIdentifier: "12-3456789", nationalIdentifierType: "TXID", countryOfIssue: "US" }
+     */
+    nationalIdentifier?: NationalIdentification_2<LegalEntityNationalIdentifierTypeCode>;
+    /**
+     * Merchant Category Code (ISO 18245)
+     * Standard classification code for merchant types in payment transactions
+     * Used primarily for merchants in payment requests
+     *
+     * @example "5411" // Grocery stores and supermarkets
+     * @example "5812" // Restaurants
+     * @example "5734" // Computer software stores
+     * @example "6012" // Financial institutions
+     * @see {@link https://www.iso.org/standard/33365.html | ISO 18245}
+     */
+    mcc?: string;
+    /**
+     * URL pointing to the organization's website
+     * Based on schema.org/Organization
+     * @example "https://example.vasp.com"
+     * @example "https://merchant.example.com"
+     */
+    url?: string;
+    /**
+     * URL pointing to the organization's logo image
+     * Based on schema.org/Organization
+     * @example "https://example.vasp.com/logo.png"
+     * @example "https://cdn.example.com/assets/logo.svg"
+     */
+    logo?: string;
+    /**
+     * Description of the organization
+     * Based on schema.org/Organization
+     * @example "Licensed Virtual Asset Service Provider"
+     * @example "Online marketplace for digital assets and collectibles"
+     * @example "Full-service financial institution"
+     */
+    description?: string;
+    /**
+     * Physical addresses of the organization
+     * IVMS101 format addresses for regulatory compliance
+     * Supports multiple address types (BIZZ for business, etc.)
+     * @example [{ addressType: "BIZZ", streetName: "456 Business Ave", townName: "Finance City", country: "US" }]
+     */
+    geographicAddress?: Address_2[];
+    /**
+     * Country of registration/incorporation
+     * ISO 3166-1 alpha-2 country code where the organization is legally registered
+     * @example "US" // United States
+     * @example "GB" // United Kingdom
+     * @example "SG" // Singapore
+     * @example "CH" // Switzerland
+     */
+    countryOfRegistration?: CountryCode;
+}
+
 /**
  * Originating VASP
  * Represents the VASP which initiates the VA transfer
@@ -1532,6 +1897,38 @@ export declare interface OwnershipProof {
     address: CAIP10;
 }
 
+/**
+ * Participant in a TAP transaction
+ * Represents either a party (originator/beneficiary) or an agent in the transaction.
+ * Can include verification methods and policies.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-5.md | TAIP-5: Agents}
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-6.md | TAIP-6: Party Identification}
+ */
+declare interface Participant {
+    /**
+     * Unique identifier for the participant
+     * Can be either a DID or an IRI
+     */
+    "@id": DID_2 | IRI;
+    "@context"?: string | string[];
+    "@type"?: string | string[];
+    /**
+     * Contact email address
+     * Based on schema.org/Organization and schema.org/Person
+     * @example "compliance@example.vasp.com"
+     */
+    email?: string;
+    /**
+     * Contact telephone number
+     * Based on schema.org/Organization and schema.org/Person
+     * @example "+1-555-123-4567"
+     */
+    telephone?: string;
+}
+
+declare type PartyType = "originator" | "beneficiary" | "customer" | "merchant" | "principal";
+
 /**
  * 6.7
  * Data describing the contents of the payload.
@@ -1597,6 +1994,46 @@ declare type PersonV2 = Omit<Person, 'naturalPerson'> & {
     accountNumber?: string[];
 };
 
+/**
+ * Policy type definition
+ * Union type of all possible policy types in TAP.
+ */
+declare type Policies = RequireAuthorization | RequirePresentation | RequireRelationshipConfirmation | RequirePurpose;
+
+/**
+ * Base interface for all TAP policy types.
+ * Policies define requirements and constraints that must be satisfied during a transaction.
+ * Each specific policy type extends this base interface with its own requirements.
+ *
+ * @template T - The specific policy type identifier (e.g. "RequireAuthorization", "RequirePresentation")
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ */
+declare interface Policy<T extends string> extends JsonLdObject<T> {
+    /** The type identifier for this policy */
+    "@type": T;
+    /**
+     * Optional DID of the party or agent required to fulfill this policy
+     * Can be a single DID or an array of DIDs
+     */
+    from?: DID_2 | IRI;
+    /**
+     * Optional role of the party required to fulfill this policy
+     * E.g. 'SettlementAddress', 'SourceAddress', or 'CustodialService'
+     */
+    fromRole?: AgentRoles;
+    /**
+     * Optional agent representing a party required to fulfill this policy
+     * E.g. 'originator' or 'beneficiary' in TAIP-3
+     */
+    fromAgent?: PartyType;
+    /**
+     * Optional human-readable description of the policy's purpose
+     * Used to explain why this requirement exists
+     */
+    purpose?: string;
+}
+
 /**
  * Status of the ownership proof verification process
  *
@@ -1684,6 +2121,74 @@ export declare interface RefreshSource {
 
 declare type RequestID = UUID;
 
+/**
+ * Policy requiring authorization before proceeding
+ * Used to ensure specific agents authorize a transaction.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ */
+declare interface RequireAuthorization extends Policy<"RequireAuthorization"> {
+}
+
+/**
+ * Policy requiring presentation of verifiable credentials
+ * Used to request specific verifiable credentials from participants.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-8.md | TAIP-8: Verifiable Credentials}
+ */
+declare interface RequirePresentation extends Policy<"RequirePresentation"> {
+    /**
+     * Optional DID of the party the presentation is about
+     * Used when requesting credentials about a specific party
+     */
+    aboutParty?: DID_2 | IRI;
+    /**
+     * Optional DID of the agent the presentation is about
+     * Used when requesting credentials about a specific agent
+     */
+    aboutAgent?: DID_2 | IRI;
+    /**
+     * Presentation Exchange definition
+     * Specifies the required credentials and constraints
+     */
+    presentationDefinition: string;
+    /**
+     * Optional credential type shorthand
+     * Simplified way to request a specific credential type
+     */
+    credentialType?: string;
+}
+
+/**
+ * Policy requiring purpose codes for transactions
+ * Used to enforce the inclusion of ISO 20022 purpose codes.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-13.md | TAIP-13: Purpose Codes}
+ */
+declare interface RequirePurpose extends Policy<"RequirePurpose"> {
+    /**
+     * Required purpose code fields
+     * Specifies which purpose code types must be included
+     */
+    required: Array<"purpose" | "categoryPurpose">;
+}
+
+/**
+ * Policy requiring relationship confirmation
+ * Used to verify control of addresses and relationships between parties.
+ *
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-7.md | TAIP-7: Policies}
+ * @see {@link https://github.com/TransactionAuthorizationProtocol/TAIPs/blob/main/TAIPs/taip-9.md | TAIP-9: Proof of Relationship}
+ */
+declare interface RequireRelationshipConfirmation extends Policy<"RequireRelationshipConfirmation"> {
+    /**
+     * Required nonce for signature
+     * Prevents replay attacks
+     */
+    nonce: string;
+}
+
 /**
  * Represents a resize request component message. This is handled by the library.
  * @internal

package/dist/cjs/package.json

@@ -10,7 +10,7 @@
   "author": "Notabene <developers@notabene.id>",
   "license": "MIT",
   "packageManager": "yarn@4.5.1",
-  "version": "2.15.0-next.2",
+  "version": "2.15.0-next.3",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",
@@ -72,6 +72,7 @@
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/gitlab": "^13.2.1",
     "@semantic-release/npm": "^12.0.1",
+    "@taprsvp/types": "^1.14.0",
     "@vitest/coverage-v8": "^2.1.8",
     "eslint": "^9.14.0",
     "eslint-config-prettier": "^9.1.0",
@@ -79,6 +80,7 @@
     "fast-check": "^3.23.1",
     "globals": "^15.11.0",
     "husky": "^9.1.6",
+    "jose": "^6.1.0",
     "jsdom": "^25.0.1",
     "lint-staged": "^15.2.10",
     "prettier": "^3.3.3",
@@ -104,9 +106,5 @@
     "extends": [
       "@commitlint/config-conventional"
     ]
-  },
-  "dependencies": {
-    "@taprsvp/types": "^1.13.0",
-    "jose": "^6.1.0"
   }
 }