@temboplus/afloat 0.1.77-beta.22 → 0.1.77-beta.25

package/dist/modules/wallet/narration.model.d.ts

@@ -1,5 +1,5 @@
-import { ContactInfo, MobileContactInfo, BankContactInfo } from "../contact/contact-info.model.js";
 import z from "zod";
+import { BankBeneficiaryInfo, BeneficiaryInfo, MobileBeneficiaryInfo } from "../beneficiary/beneficiary-info.model.js";
 /** Prefix for Ecobank mobile transfer narrations */
 export declare const ECOBANK_PREFIX = "MOBILE TRANSFER ";
 /** V2 format prefix for payout narrations using contact details */
@@ -49,7 +49,7 @@ export type NarrationJSON = z.infer<typeof NarrationJSONSchema>;
  *
  * // Extract contact details from narration
  * const existingNarration = new Narration("PAYOUT +255123456789 JOHN DOE");
- * const contactInfo = existingNarration.getContactDetails();
+ * const contactInfo = existingNarration.getBeneficiaryDetails();
  * // Returns: MobileContactInfo instance
  * ```
  */
@@ -80,21 +80,21 @@ export declare class Narration {
      * Generates the default payout narration based on contact information using the V2 format.
      * Automatically determines whether to generate mobile or bank narration based on contact type.
      *
-     * @param data - Contact information (either MobileContactInfo or BankContactInfo)
+     * @param data - Contact information (either MobileBeneficiaryInfo or BankBeneficiaryInfo)
      * @returns Formatted default narration string in uppercase using V2 format, or empty string if contact type is unrecognized
      *
      * @example
      * ```typescript
-     * const mobileContact = new MobileContactInfo("John Doe", phoneNumber);
+     * const mobileContact = new MobileBeneficiaryInfo("John Doe", phoneNumber);
      * const narration = Narration.generateDefaultPayoutNarration(mobileContact);
      * // Returns: "PAYOUT +255123456789 JOHN DOE"
      *
-     * const bankContact = new BankContactInfo("Jane Smith", bank, "1234567890");
+     * const bankContact = new BankBeneficiaryInfo("Jane Smith", bank, "1234567890");
      * const narration = Narration.generateDefaultPayoutNarration(bankContact);
      * // Returns: "PAYOUT CORUTZTZ 1234567890 JANE SMITH"
      * ```
      */
-    static generateDefaultPayoutNarration(data: ContactInfo): string;
+    static generateDefaultPayoutNarration(data: BeneficiaryInfo): string;
     /**
      * Generates a V2 standardized mobile money payout narration with contact details.
      * Format: "PAY {phone_number} {name}"
@@ -104,12 +104,12 @@ export declare class Narration {
      *
      * @example
      * ```typescript
-     * const contact = new MobileContactInfo("John Doe", phoneNumber);
+     * const contact = new MobileBeneficiaryInfo("John Doe", phoneNumber);
      * const narration = Narration.generateMobilePayoutNarrationV2(contact);
      * // Returns: "PAYOUT +255123456789 JOHN DOE"
      * ```
      */
-    static generateMobilePayoutNarrationV2(data: MobileContactInfo): string;
+    static generateMobilePayoutNarrationV2(data: MobileBeneficiaryInfo): string;
     /**
      * Generates a V2 standardized bank payout narration with contact details.
      * Format: "PAY {swift_code} {account_number} {account_name}"
@@ -119,32 +119,32 @@ export declare class Narration {
      *
      * @example
      * ```typescript
-     * const contact = new BankContactInfo("Jane Smith", bank, "1234567890");
+     * const contact = new BankBeneficiaryInfo("Jane Smith", bank, "1234567890");
      * const narration = Narration.generateBankPayoutNarrationV2(contact);
      * // Returns: "PAYOUT CORUTZTZ 1234567890 JANE SMITH"
      * ```
      */
-    static generateBankPayoutNarrationV2(data: BankContactInfo): string;
+    static generateBankPayoutNarrationV2(data: BankBeneficiaryInfo): string;
     /**
      * Extracts contact information from the narration text.
      * Supports V2 (PAY format), V1, and legacy formats for comprehensive contact detection.
      *
-     * @returns Parsed ContactInfo (BankContactInfo or MobileContactInfo) if successful, undefined otherwise
+     * @returns Parsed BeneficiaryInfo (BankBeneficiaryInfo or MobileBeneficiaryInfo) if successful, undefined otherwise
      *
      * @example
      * ```typescript
      * // V2 format
      * const v2Narration = new Narration("PAYOUT +255123456789 JOHN DOE");
-     * const v2Contact = v2Narration.getContactDetails();
+     * const v2Contact = v2Narration.getBeneficiaryDetails();
      * // Returns: MobileContactInfo instance
      *
      * // V1 format
      * const v1Narration = new Narration("PAYOUT TO BANK CRDB 1234567890 Jane Smith");
-     * const v1Contact = v1Narration.getContactDetails();
+     * const v1Contact = v1Narration.getBeneficiaryDetails();
      * // Returns: BankContactInfo instance
      * ```
      */
-    getContactDetails: () => ContactInfo | undefined;
+    getBeneficiaryDetails: () => BeneficiaryInfo | undefined;
     /**
      * Extracts bank contact information from the narration text.
      * Handles V2 format (PAY with SWIFT code and details), V1 format, and legacy format.
@@ -154,20 +154,20 @@ export declare class Narration {
      * V1 format: "PAYOUT TO BANK {bank_name} {account_number} {account_name}"
      * Legacy format: "TO_BANK => {json_object}"
      *
-     * @returns BankContactInfo if parsing is successful, undefined otherwise
+     * @returns BankBeneficiaryInfo if parsing is successful, undefined otherwise
      *
      * @example
      * ```typescript
      * // V2 format
      * const v2Narration = new Narration("PAYOUT CORUTZTZ 1234567890 JANE SMITH");
-     * const v2Contact = v2Narration.getBankContactDetails();
+     * const v2Contact = v2Narration.getBankBeneficiaryDetails();
      *
      * // V1 format
      * const v1Narration = new Narration("PAYOUT TO BANK CRDB 1234567890 Jane Smith");
-     * const v1Contact = v1Narration.getBankContactDetails();
+     * const v1Contact = v1Narration.getBankBeneficiaryDetails();
      * ```
      */
-    getBankContactDetails: () => BankContactInfo | undefined;
+    getBankBeneficiaryDetails: () => BankBeneficiaryInfo | undefined;
     /**
      * Extracts mobile contact information from the narration text.
      * Handles V2 format (PAY with phone number and name), V1 format, and legacy format.
@@ -177,20 +177,20 @@ export declare class Narration {
      * V1 format: "PAYOUT TO MOBILE {phone_number} {name}"
      * Legacy format: "TO_MOMO => {json_object}"
      *
-     * @returns MobileContactInfo if parsing is successful, undefined otherwise
+     * @returns MobileBeneficiaryInfo if parsing is successful, undefined otherwise
      *
      * @example
      * ```typescript
      * // V2 format
      * const v2Narration = new Narration("PAYOUT +255123456789 JOHN DOE");
-     * const v2Contact = v2Narration.getMobileContactDetails();
+     * const v2Contact = v2Narration.getMobileBeneficiaryDetails();
      *
      * // V1 format
      * const v1Narration = new Narration("PAYOUT TO MOBILE +255123456789 John Doe");
-     * const v1Contact = v1Narration.getMobileContactDetails();
+     * const v1Contact = v1Narration.getMobileBeneficiaryDetails();
      * ```
      */
-    getMobileContactDetails: () => MobileContactInfo | undefined;
+    getMobileBeneficiaryDetails: () => MobileBeneficiaryInfo | undefined;
     /**
      * Type guard to check if an unknown object is a valid Narration instance.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/afloat",
-  "version": "0.1.77-beta.22",
+  "version": "0.1.77-beta.25",
   "description": "A foundational library for Temboplus-Afloat projects.",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",
@@ -40,7 +40,7 @@
     "@ts-rest/core": "^3.52.1",
     "tslib": "^2.8.1",
     "uuid": "^11.1.0",
-    "zod": "^4.1.13",
+    "zod": "^3.24.2",
     "zustand": "^5.0.9"
   },
   "devDependencies": {
@@ -58,6 +58,6 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@temboplus/frontend-core": "^0.2.20-beta.7"
+    "@temboplus/frontend-core": "^0.2.20-beta.8"
   }
 }

package/dist/modules/contact/contact-info.model.d.ts

@@ -1,488 +0,0 @@
-import { ContactType, ContactDTO } from "@/modules/contact/contact.dtos.js";
-import { PayoutDTO } from "@/modules/payout/payout.dtos.js";
-import { Bank, ISO2CountryCode, PhoneNumber } from "@temboplus/frontend-core";
-import type { BankSwiftCode, MNOId } from "@temboplus/frontend-core";
-import { z } from "zod";
-export declare const MobileContactInfoJSONSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Mobile">;
-    name: z.ZodString;
-    phoneNumber: z.ZodString;
-    mnoId: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    type: "Mobile";
-    name: string;
-    version: string;
-    phoneNumber: string;
-    mnoId: string;
-}, {
-    type: "Mobile";
-    name: string;
-    phoneNumber: string;
-    mnoId: string;
-    version?: string | undefined;
-}>;
-export declare const BankContactInfoJSONSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Bank">;
-    accName: z.ZodString;
-    swiftCode: z.ZodString;
-    countryCode: z.ZodString;
-    accNo: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    type: "Bank";
-    version: string;
-    countryCode: string;
-    accName: string;
-    swiftCode: string;
-    accNo: string;
-}, {
-    type: "Bank";
-    countryCode: string;
-    accName: string;
-    swiftCode: string;
-    accNo: string;
-    version?: string | undefined;
-}>;
-export declare const ContactInfoJSONSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-    type: z.ZodLiteral<"Mobile">;
-    name: z.ZodString;
-    phoneNumber: z.ZodString;
-    mnoId: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    type: "Mobile";
-    name: string;
-    version: string;
-    phoneNumber: string;
-    mnoId: string;
-}, {
-    type: "Mobile";
-    name: string;
-    phoneNumber: string;
-    mnoId: string;
-    version?: string | undefined;
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"Bank">;
-    accName: z.ZodString;
-    swiftCode: z.ZodString;
-    countryCode: z.ZodString;
-    accNo: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    type: "Bank";
-    version: string;
-    countryCode: string;
-    accName: string;
-    swiftCode: string;
-    accNo: string;
-}, {
-    type: "Bank";
-    countryCode: string;
-    accName: string;
-    swiftCode: string;
-    accNo: string;
-    version?: string | undefined;
-}>]>;
-export type MobileContactInfoJSON = z.infer<typeof MobileContactInfoJSONSchema>;
-export type BankContactInfoJSON = z.infer<typeof BankContactInfoJSONSchema>;
-export type ContactInfoJSON = z.infer<typeof ContactInfoJSONSchema>;
-/**
- * Abstract base class that provides a common interface for different types of contact information.
- * This class defines the structure and validation requirements for both mobile and bank contacts.
- *
- * Serves as the foundation for type-safe contact handling throughout the application,
- * ensuring consistent behavior between mobile money and bank transfer contacts.
- *
- * **Country Code Handling:**
- * The country code is always derived from the underlying domain objects (PhoneNumber or Bank)
- * rather than being passed as a separate parameter, ensuring consistency and single source of truth.
- *
- * @abstract
- * @class BaseContactInfo
- *
- * @property {ContactType} type - The type of contact (either "Mobile" or "Bank")
- * @property {ISO2CountryCode} countryCode - The ISO2 country code derived from PhoneNumber or Bank
- *
- * @example
- * ```typescript
- * // Cannot instantiate directly - use concrete implementations
- * const mobileContact = MobileContactInfo.from({ name: "John Doe", phoneNumber });
- * const bankContact = BankContactInfo.from({ accName: "Jane Smith", bank, accNo: "123456789" });
- *
- * // Polymorphic usage
- * function processContact(contact: BaseContactInfo) {
- *   console.log(`Processing ${contact.type} contact: ${contact.displayName}`);
- *   console.log(`Channel: ${contact.channelDisplayName}`);
- *   console.log(`Country: ${contact.countryCode}`); // Always available
- * }
- * ```
- */
-declare abstract class BaseContactInfo {
-    readonly type: ContactType;
-    readonly countryCode: ISO2CountryCode;
-    /**
-     * Creates a new instance of BaseContactInfo.
-     * Protected constructor ensures only subclasses can instantiate.
-     *
-     * @protected
-     * @param {ContactType} type - The type of contact to create ("Mobile" or "Bank")
-     * @param {ISO2CountryCode} countryCode - The ISO2 country code derived from domain objects
-     */
-    constructor(type: ContactType, countryCode: ISO2CountryCode);
-    /**
-     * Gets the typed channel identifier for the contact.
-     * Returns MNO ID for mobile contacts, SWIFT code for bank contacts.
-     *
-     * @abstract
-     * @returns {MNOId | BankSwiftCode} The typed channel identifier
-     *
-     * @example
-     * ```typescript
-     * const mobileChannel: MNOId = mobileContact.channelId; // "VODACOM", "SAFARICOM", etc.
-     * const bankChannel: BankSwiftCode = bankContact.channelId; // "CORUTZTZ", "KCBLKENX", etc.
-     * ```
-     */
-    abstract get channelId(): MNOId | BankSwiftCode;
-    /**
-     * Gets the human-readable channel name for display purposes.
-     * Returns mobile money service name for mobile contacts, bank short name for bank contacts.
-     *
-     * @abstract
-     * @returns {string} The display-friendly channel name
-     *
-     * @example
-     * ```typescript
-     * console.log(mobileContact.channelName); // "M-Pesa", "Airtel Money", etc.
-     * console.log(bankContact.channelName); // "CRDB", "KCB", etc.
-     * ```
-     */
-    abstract get channelName(): string;
-    /**
-     * Gets the primary display name for the contact.
-     *
-     * @abstract
-     * @returns {string} The contact's display name (personal name for mobile, account name for bank)
-     */
-    abstract get accountName(): string;
-    /**
-     * Gets the primary account/identification number for the contact.
-     *
-     * @abstract
-     * @returns {string} The contact's number (phone number for mobile, account number for bank)
-     */
-    abstract get accountNumber(): string;
-    /**
-     * Gets the localized label for the display name field.
-     *
-     * @abstract
-     * @returns {string} The appropriate label for the display name based on contact type
-     */
-    abstract get accountNameLabel(): string;
-    /**
-     * Gets the localized label for the account number field.
-     *
-     * @abstract
-     * @returns {string} The appropriate label for the account number based on contact type
-     */
-    abstract get accountNumberLabel(): string;
-    /**
-     * Gets the localized label for the channel field.
-     *
-     * @abstract
-     * @returns {string} The appropriate label for the channel based on contact type
-     */
-    abstract get channelLabel(): string;
-    /**
-     * Validates that all contact information is consistent and correct.
-     *
-     * @abstract
-     * @returns {boolean} True if the contact information is valid
-     */
-    abstract validate(): boolean;
-    /**
-    * Serializes the ContactInfo instance to a JSON-compatible object
-    */
-    abstract toJSON(): ContactInfoJSON;
-    /**
-     * Converts the ContactInfo instance to a JSON string.
-    */
-    toJSONString(): string;
-    get isMobile(): boolean;
-    get isBank(): boolean;
-    get displayName(): string;
-}
-/**
- * Implementation of BaseContactInfo for mobile phone contacts.
- * Handles storage, validation, and display of contact details specific to mobile money services.
- *
- * This class properly delegates MNO-related logic to country-specific implementations,
- * supporting both countries with Mobile Number Portability (MNP) and those without.
- * The country code is always derived from the PhoneNumber object, ensuring consistency.
- *
- * **Key Features:**
- * - Automatic MNO detection for countries without MNP (e.g., Tanzania)
- * - Explicit MNO requirement for countries with MNP (e.g., Kenya)
- * - Country-specific validation through MNOUtils delegation
- * - Comprehensive error handling with structured context
- * - Country code derived from PhoneNumber (single source of truth)
- *
- * **MNP Handling:**
- * - **Tanzania (no MNP)**: MNO is always auto-detected from phone number prefix, ignoring any provided MNO
- * - **Kenya (has MNP)**: MNO must be explicitly provided as numbers can be ported
- *
- * @extends BaseContactInfo
- * @class MobileContactInfo
- *
- * @property {string} name - The contact's personal name
- * @property {PhoneNumber} phoneNumber - The validated phone number object
- * @property {MNOId} mnoId - The mobile network operator identifier (always available after construction)
- *
- * @example
- * ```typescript
- * // Preferred: Use static factory method
- * const tzContact = MobileContactInfo.from({
- *   name: "John Doe",
- *   phoneNumber: tzPhoneNumber
- * });
- * console.log(tzContact?.channelName); // "M-Pesa" (Vodacom's service)
- *
- * // From JSON
- * const jsonContact = MobileContactInfo.fromJSON(jsonString);
- * ```
- */
-export declare class MobileContactInfo extends BaseContactInfo {
-    readonly name: string;
-    readonly phoneNumber: PhoneNumber;
-    readonly mnoId: MNOId;
-    /**
-     * Creates a new mobile contact with comprehensive validation.
-     *
-     * **Validation Process:**
-     * 1. Validates name is non-empty
-     * 2. Validates phone number structure
-     * 3. Extracts country code from PhoneNumber object
-     * 4. Handles MNO validation based on country MNP status
-     *
-     * @deprecated Use {@link MobileContactInfo.from} static factory method instead
-     * @param {string} name - The contact's personal name (required, non-empty)
-     * @param {PhoneNumber} phoneNumber - The validated phone number object (contains country code)
-     * @param {MNOId} [mnoId] - MNO ID. Required for MNP countries (KE), ignored for non-MNP countries (TZ)
-     *
-     * @throws {ContactInfoError} When any validation fails
-     */
-    constructor(name: string, phoneNumber: PhoneNumber, mnoId?: MNOId);
-    /**
-     * Creates a MobileContactInfo instance from data object.
-     * This is the preferred method for creating instances.
-     *
-     * @static
-     * @param {Object} data - The mobile contact data
-     * @param {string} data.name - The contact's personal name
-     * @param {PhoneNumber} data.phoneNumber - The validated phone number object
-     * @param {MNOId} [data.mnoId] - MNO ID (required for MNP countries)
-     *
-     * @returns {MobileContactInfo | undefined} New instance if successful, undefined if validation fails
-     *
-     * @example
-     * ```typescript
-     * const contact = MobileContactInfo.from({
-     *   name: "John Doe",
-     *   phoneNumber: tzPhone,
-     *   mnoId: TZMNOId.VODACOM // Optional for TZ, required for KE
-     * });
-     * ```
-     */
-    static from(data: {
-        name: string;
-        phoneNumber: PhoneNumber;
-        mnoId?: MNOId;
-    }): MobileContactInfo | undefined;
-    /**
-     * Creates a MobileContactInfo instance from a ContactDTO object.
-     * Handles validation and MNO extraction from the DTO's channel field.
-     *
-     * @static
-     * @param {ContactDTO} info - The contact data transfer object
-     * @returns {MobileContactInfo | undefined} New instance if successful, undefined if validation fails
-     *
-     * @example
-     * ```typescript
-     * const contactDTO = {
-     *   type: "Mobile",
-     *   accountNo: "+255712345678",
-     *   displayName: "John Doe",
-     *   channel: "VODACOM"
-     * };
-     *
-     * const contact = MobileContactInfo.fromContactDTO(contactDTO);
-     * ```
-     */
-    static fromContactDTO(info: ContactDTO): MobileContactInfo | undefined;
-    /**
-     * Creates a MobileContactInfo instance from a PayoutDTO object.
-     * Extracts mobile contact information from payout data structure.
-     *
-     * @static
-     * @param {PayoutDTO} info - The payout data transfer object
-     * @returns {MobileContactInfo | undefined} New instance if successful, undefined if parsing fails
-     *
-     * @example
-     * ```typescript
-     * const payoutDTO = {
-     *   msisdn: "+255712345678",
-     *   countryCode: "TZ",
-     *   payeeName: "John Doe",
-     *   channel: "VODACOM"
-     * };
-     *
-     * const contact = MobileContactInfo.fromPayoutDTO(payoutDTO);
-     * ```
-     */
-    static fromPayoutDTO(info: PayoutDTO): MobileContactInfo | undefined;
-    /**
-     * Type guard to validate if an unknown object is a valid MobileContactInfo instance.
-     *
-     * @static
-     * @param {unknown} obj - The object to validate
-     * @returns {obj is MobileContactInfo} Type predicate indicating validity
-     *
-     * @example
-     * ```typescript
-     * if (MobileContactInfo.is(unknownData)) {
-     *   console.log(unknownData.name); // Type-safe access
-     * }
-     * ```
-     */
-    static is(obj: unknown): obj is MobileContactInfo;
-    /**
-     * Validates that all contact information is consistent and correct.
-     *
-     * @returns {boolean} True if all validations pass, false otherwise
-     */
-    validate(): boolean;
-    /**
-     * Provides detailed validation results with specific error and warning information.
-     *
-     * @returns {Object} Detailed validation results
-     */
-    getValidationDetails(): {
-        isValid: boolean;
-        errors: string[];
-        warnings: string[];
-    };
-    get accountName(): string;
-    get accountNumber(): string;
-    get accountNameLabel(): string;
-    get accountNumberLabel(): string;
-    get channelLabel(): string;
-    get channelId(): MNOId;
-    get channelName(): string;
-    toJSON(): MobileContactInfoJSON;
-    static fromJSON(json: MobileContactInfoJSON | string): MobileContactInfo | undefined;
-    static fromJSONString(jsonString: string): MobileContactInfo | undefined;
-    static isMobileContactInfoJSON(obj: unknown): obj is MobileContactInfoJSON;
-}
-/**
- * Implementation of BaseContactInfo for bank account contacts.
- * Handles storage, validation, and display of contact details specific to bank transfers.
- *
- * @extends BaseContactInfo
- * @class BankContactInfo
- *
- * @example
- * ```typescript
- * const bank = Bank.from("CORUTZTZ", "TZ");
- * const contact = BankContactInfo.from({
- *   accName: "John Doe",
- *   bank,
- *   accNo: "0150123456789"
- * });
- * ```
- */
-export declare class BankContactInfo extends BaseContactInfo {
-    readonly accName: string;
-    readonly bank: Bank;
-    readonly accNo: string;
-    /**
-     * Creates a new bank contact with comprehensive validation.
-     *
-     * @deprecated Use {@link BankContactInfo.from} static factory method instead
-     * @param {string} accName - The bank account holder's name
-     * @param {Bank} bank - The bank institution object
-     * @param {string} accNo - The bank account number
-     *
-     * @throws {ContactInfoError} When validation fails
-     */
-    constructor(accName: string, bank: Bank, accNo: string);
-    /**
-     * Creates a BankContactInfo instance from data object.
-     * This is the preferred method for creating instances.
-     *
-     * @static
-     * @param {Object} data - The bank contact data
-     * @param {string} data.accName - The account holder's name
-     * @param {Bank} data.bank - The bank institution object
-     * @param {string} data.accNo - The bank account number
-     *
-     * @returns {BankContactInfo | undefined} New instance if successful, undefined if validation fails
-     *
-     * @example
-     * ```typescript
-     * const bank = Bank.from("CORUTZTZ", "TZ");
-     * const contact = BankContactInfo.from({
-     *   accName: "John Doe",
-     *   bank,
-     *   accNo: "0150123456789"
-     * });
-     * ```
-     */
-    static from(data: {
-        accName: string;
-        bank: Bank;
-        accNo: string;
-    }): BankContactInfo | undefined;
-    /**
-     * Creates a BankContactInfo instance from a ContactDTO object.
-     *
-     * @static
-     * @param {ContactDTO} info - The contact data transfer object
-     * @returns {BankContactInfo | undefined} New instance if successful, undefined if validation fails
-     */
-    static fromContactDTO(info: ContactDTO): BankContactInfo | undefined;
-    /**
-     * Creates a BankContactInfo instance from a PayoutDTO object.
-     *
-     * @static
-     * @param {PayoutDTO} info - The payout data transfer object
-     * @returns {BankContactInfo | undefined} New instance if successful, undefined if parsing fails
-     */
-    static fromPayoutDTO(info: PayoutDTO): BankContactInfo | undefined;
-    /**
-     * Type guard to validate if an unknown object is a valid BankContactInfo instance.
-     *
-     * @static
-     * @param {unknown} obj - The object to validate
-     * @returns {obj is BankContactInfo} Type predicate indicating validity
-     */
-    static is(obj: unknown): obj is BankContactInfo;
-    validate(): boolean;
-    get accountName(): string;
-    get accountNumber(): string;
-    get accountNameLabel(): string;
-    get accountNumberLabel(): string;
-    get channelLabel(): string;
-    get channelId(): BankSwiftCode;
-    get channelName(): string;
-    toJSON(): BankContactInfoJSON;
-    static fromJSON(json: BankContactInfoJSON | string): BankContactInfo | undefined;
-    static fromJSONString(jsonString: string): BankContactInfo | undefined;
-    static isBankContactInfoJSON(obj: unknown): obj is BankContactInfoJSON;
-}
-/**
- * Union type representing either a mobile or bank contact.
- *
- * @typedef {MobileContactInfo | BankContactInfo} ContactInfo
- */
-export type ContactInfo = MobileContactInfo | BankContactInfo;
-export {};

package/dist/modules/contact/contact-input-handler.d.ts

@@ -1,16 +0,0 @@
-import { ContactInfo } from "@/modules/contact/contact-info.model.js";
-import { ContactInputDTO } from "./contact.dtos.js";
-/**
- * Factory for resolving and validating a raw `ContactInput` into a typed and valid version.
- */
-export declare class ValidatedContactInputFactory {
-    private handlers;
-    /**
-     * Resolves a raw contact input into a valid and strongly-typed `ContactInput`.
-     *
-     * @param {ContactInputDTO} data - The unvalidated input object
-     * @returns {ContactInputDTO} - A valid and converted input ready for use
-     * @throws {Error} - If the input cannot be handled by any handler
-     */
-    resolve(data: ContactInfo): ContactInputDTO;
-}