@temboplus/afloat 0.2.0-beta.8 → 0.2.0

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

@@ -1,18 +1,19 @@
-import { BeneficiaryType, BeneficiaryDTO } from "@/modules/beneficiary/beneficiary.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 { BeneficiaryType } from "@/modules/beneficiary/beneficiary.dtos.js";
+import type { BeneficiaryDTO, BeneficiaryInputDTO } from "@/modules/beneficiary/beneficiary.dtos.js";
+import type { PayoutDTO } from "@/modules/payout/payout.dtos.js";
+import { Bank, PhoneNumber } from "@temboplus/frontend-core";
+import type { BankSwiftCode, ISO2CountryCode, MobileMoneyProvider, MobileMoneyProviderId } from "@temboplus/frontend-core";
 import { z } from "zod";
-export declare const MobileBeneficiaryInfoJSONSchema: z.ZodObject<{
+export declare const MobileBeneficiaryJSONSchema: z.ZodObject<{
     type: z.ZodLiteral<"Mobile">;
     name: z.ZodString;
     phoneNumber: z.ZodString;
     mnoId: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     type: "Mobile";
     name: string;
-    version: string;
+    _version: string;
     phoneNumber: string;
     mnoId: string;
 }, {
@@ -20,18 +21,18 @@ export declare const MobileBeneficiaryInfoJSONSchema: z.ZodObject<{
     name: string;
     phoneNumber: string;
     mnoId: string;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>;
-export declare const BankBeneficiaryInfoJSONSchema: z.ZodObject<{
+export declare const BankBeneficiaryJSONSchema: 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>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     type: "Bank";
-    version: string;
+    _version: string;
     countryCode: string;
     accName: string;
     swiftCode: string;
@@ -42,18 +43,18 @@ export declare const BankBeneficiaryInfoJSONSchema: z.ZodObject<{
     accName: string;
     swiftCode: string;
     accNo: string;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>;
-export declare const BeneficiaryInfoJSONSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+export declare const BeneficiaryJSONSchema: 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>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     type: "Mobile";
     name: string;
-    version: string;
+    _version: string;
     phoneNumber: string;
     mnoId: string;
 }, {
@@ -61,17 +62,17 @@ export declare const BeneficiaryInfoJSONSchema: z.ZodDiscriminatedUnion<"type",
     name: string;
     phoneNumber: string;
     mnoId: string;
-    version?: string | undefined;
+    _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>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     type: "Bank";
-    version: string;
+    _version: string;
     countryCode: string;
     accName: string;
     swiftCode: string;
@@ -82,19 +83,35 @@ export declare const BeneficiaryInfoJSONSchema: z.ZodDiscriminatedUnion<"type",
     accName: string;
     swiftCode: string;
     accNo: string;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>]>;
-export type MobileBeneficiaryInfoJSON = z.infer<typeof MobileBeneficiaryInfoJSONSchema>;
-export type BankBeneficiaryInfoJSON = z.infer<typeof BankBeneficiaryInfoJSONSchema>;
-export type BeneficiaryInfoJSON = z.infer<typeof BeneficiaryInfoJSONSchema>;
-/**
- * Abstract base class for beneficiary information.
- */
-declare abstract class BaseBeneficiaryInfo {
+export type MobileBeneficiaryJSON = z.infer<typeof MobileBeneficiaryJSONSchema>;
+export type BankBeneficiaryJSON = z.infer<typeof BankBeneficiaryJSONSchema>;
+export type BeneficiaryJSON = z.infer<typeof BeneficiaryJSONSchema>;
+export declare class BeneficiaryError extends Error {
+    readonly context: {
+        phoneNumber?: string;
+        countryCode?: ISO2CountryCode;
+        mnoId?: string;
+        operation?: string;
+    };
+    constructor(message: string, context?: {
+        phoneNumber?: string;
+        countryCode?: ISO2CountryCode;
+        mnoId?: string;
+        operation?: string;
+    });
+}
+interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+declare abstract class BaseBeneficiary {
     readonly type: BeneficiaryType;
     readonly countryCode: ISO2CountryCode;
-    constructor(type: BeneficiaryType, countryCode: ISO2CountryCode);
-    abstract get channelId(): MNOId | BankSwiftCode;
+    protected constructor(type: BeneficiaryType, countryCode: ISO2CountryCode);
+    abstract get channelId(): MobileMoneyProviderId | BankSwiftCode;
     abstract get channelName(): string;
     abstract get accountName(): string;
     abstract get accountNumber(): string;
@@ -102,63 +119,80 @@ declare abstract class BaseBeneficiaryInfo {
     abstract get accountNumberLabel(): string;
     abstract get channelLabel(): string;
     abstract validate(): boolean;
-    abstract toJSON(): BeneficiaryInfoJSON;
+    abstract getValidationDetails(): ValidationResult;
+    abstract toJSON(): BeneficiaryJSON;
     toJSONString(): string;
     get isMobile(): boolean;
     get isBank(): boolean;
     get displayName(): string;
 }
-/**
- * Mobile beneficiary information implementation.
- */
-export declare class MobileBeneficiaryInfo extends BaseBeneficiaryInfo {
+export declare class MobileBeneficiaryInfo extends BaseBeneficiary {
     readonly name: string;
     readonly phoneNumber: PhoneNumber;
-    readonly mnoId: MNOId;
-    constructor(name: string, phoneNumber: PhoneNumber, mnoId?: MNOId);
+    readonly mnoId: MobileMoneyProviderId;
+    constructor(name: string, phoneNumber: PhoneNumber, mnoId?: MobileMoneyProviderId);
+    /**
+     * For prefix-detectable countries the MNO is always derived from the phone,
+     * so any caller-supplied id is intentionally ignored. For explicit-only
+     * countries, the supplied id is used as-is (validation happens later).
+     */
+    private static resolveMnoId;
+    /**
+     * Single source of truth for input validity. Used by the constructor,
+     * validate(), and getValidationDetails().
+     */
+    private static checkInputs;
+    /** Picks an MNO from a DTO `channel` field, or auto-detects when supported. */
+    private static pickMnoIdFromDTO;
     static from(data: {
         name: string;
         phoneNumber: PhoneNumber;
-        mnoId?: MNOId;
+        mnoId?: MobileMoneyProviderId;
     }): MobileBeneficiaryInfo | undefined;
+    static fromInputDTO(info: BeneficiaryInputDTO): MobileBeneficiaryInfo | undefined;
     static fromBeneficiaryDTO(info: BeneficiaryDTO): MobileBeneficiaryInfo | undefined;
     static fromPayoutDTO(info: PayoutDTO): MobileBeneficiaryInfo | undefined;
+    /**
+     * Pure runtime brand check — no rebuilding, no coercion. Use `fromJSON` to
+     * upgrade raw JSON shape into an instance.
+     */
     static is(obj: unknown): obj is MobileBeneficiaryInfo;
     validate(): boolean;
-    getValidationDetails(): {
-        isValid: boolean;
-        errors: string[];
-        warnings: string[];
-    };
+    getValidationDetails(): ValidationResult;
     get accountName(): string;
     get accountNumber(): string;
     get accountNameLabel(): string;
     get accountNumberLabel(): string;
     get channelLabel(): string;
-    get channelId(): MNOId;
+    get channelId(): MobileMoneyProviderId;
     get channelName(): string;
-    toJSON(): MobileBeneficiaryInfoJSON;
-    static fromJSON(json: MobileBeneficiaryInfoJSON | string): MobileBeneficiaryInfo | undefined;
-    static fromJSONString(jsonString: string): MobileBeneficiaryInfo | undefined;
-    static isMobileBeneficiaryInfoJSON(obj: unknown): obj is MobileBeneficiaryInfoJSON;
+    get mobileMoneyProvider(): MobileMoneyProvider | undefined;
+    toJSON(): MobileBeneficiaryJSON;
+    static fromJSON(json: MobileBeneficiaryJSON | string): MobileBeneficiaryInfo | undefined;
+    static fromJSONString(s: string): MobileBeneficiaryInfo | undefined;
+    static isJSON(obj: unknown): obj is MobileBeneficiaryJSON;
 }
-/**
- * Bank beneficiary information implementation.
- */
-export declare class BankBeneficiaryInfo extends BaseBeneficiaryInfo {
+export declare class BankBeneficiaryInfo extends BaseBeneficiary {
     readonly accName: string;
     readonly bank: Bank;
     readonly accNo: string;
     constructor(accName: string, bank: Bank, accNo: string);
+    /**
+     * Single source of truth for input validity. Used by the constructor,
+     * validate(), and getValidationDetails().
+     */
+    private static checkInputs;
     static from(data: {
         accName: string;
         bank: Bank;
         accNo: string;
     }): BankBeneficiaryInfo | undefined;
+    static fromInputDTO(info: BeneficiaryInputDTO): BankBeneficiaryInfo | undefined;
     static fromBeneficiaryDTO(info: BeneficiaryDTO): BankBeneficiaryInfo | undefined;
     static fromPayoutDTO(info: PayoutDTO): BankBeneficiaryInfo | undefined;
     static is(obj: unknown): obj is BankBeneficiaryInfo;
     validate(): boolean;
+    getValidationDetails(): ValidationResult;
     get accountName(): string;
     get accountNumber(): string;
     get accountNameLabel(): string;
@@ -166,13 +200,36 @@ export declare class BankBeneficiaryInfo extends BaseBeneficiaryInfo {
     get channelLabel(): string;
     get channelId(): BankSwiftCode;
     get channelName(): string;
-    toJSON(): BankBeneficiaryInfoJSON;
-    static fromJSON(json: BankBeneficiaryInfoJSON | string): BankBeneficiaryInfo | undefined;
-    static fromJSONString(jsonString: string): BankBeneficiaryInfo | undefined;
-    static isBankBeneficiaryInfoJSON(obj: unknown): obj is BankBeneficiaryInfoJSON;
+    toJSON(): BankBeneficiaryJSON;
+    static fromJSON(json: BankBeneficiaryJSON | string): BankBeneficiaryInfo | undefined;
+    static fromJSONString(s: string): BankBeneficiaryInfo | undefined;
+    static isJSON(obj: unknown): obj is BankBeneficiaryJSON;
 }
+export type BeneficiaryInfo = MobileBeneficiaryInfo | BankBeneficiaryInfo;
 /**
- * Union type representing either a mobile or bank beneficiary.
+ * Factory for building / recognizing a beneficiary without
+ * caring about the variant. Each method dispatches on the discriminator.
  */
-export type BeneficiaryInfo = MobileBeneficiaryInfo | BankBeneficiaryInfo;
+export declare class BeneficiaryInfoFactory {
+    static fromInputDTO(info: BeneficiaryInputDTO): BeneficiaryInfo | undefined;
+    static fromBeneficiaryDTO(info: BeneficiaryDTO): BeneficiaryInfo | undefined;
+    static fromPayoutDTO(info: PayoutDTO): BeneficiaryInfo | undefined;
+    static fromJSON(json: BeneficiaryJSON | string): BeneficiaryInfo | undefined;
+    static fromJSONString(s: string): BeneficiaryInfo | undefined;
+    static is(obj: unknown): obj is BeneficiaryInfo;
+    static isJSON(obj: unknown): obj is BeneficiaryJSON;
+    private static fromDTO;
+}
+/**
+ * @deprecated Use BeneficiaryInfoFactory instead.
+ */
+export declare const BeneficiaryInfo: {
+    fromInputDTO(info: BeneficiaryInputDTO): BeneficiaryInfo | undefined;
+    fromBeneficiaryDTO(info: BeneficiaryDTO): BeneficiaryInfo | undefined;
+    fromPayoutDTO(info: PayoutDTO): BeneficiaryInfo | undefined;
+    fromJSON(json: BeneficiaryJSON | string): BeneficiaryInfo | undefined;
+    fromJSONString(s: string): BeneficiaryInfo | undefined;
+    is(obj: unknown): obj is BeneficiaryInfo;
+    isJSON(obj: unknown): obj is BeneficiaryJSON;
+};
 export {};

package/dist/modules/beneficiary/beneficiary.model.d.ts

@@ -1,75 +1,54 @@
 import { BeneficiaryDTO, BeneficiaryType } from "@/modules/beneficiary/beneficiary.dtos.js";
-import { BeneficiaryInfo } from "./beneficiary-info.model.js";
+import { type BeneficiaryInfo } from "./beneficiary-info.model.js";
 import { z } from "zod";
 /**
  * Zod schema for Beneficiary JSON serialization
  * This schema validates the JSON representation of a Beneficiary instance
  *
- * The Beneficiary JSON format wraps the BeneficiaryDTO structure for consistency
- * and future extensibility (e.g., adding metadata, version info)
+ * The Beneficiary JSON format is a flat BeneficiaryDTO structure with metadata
+ * under underscored keys.
  */
 export declare const BeneficiaryJSONSchema: z.ZodObject<{
-    /** The complete beneficiary data transfer object */
-    data: z.ZodObject<{
-        id: z.ZodString;
-        profileId: z.ZodString;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-    } & {
-        displayName: z.ZodString;
-        accountNo: z.ZodString;
-        channel: z.ZodString;
-        type: z.ZodNativeEnum<typeof BeneficiaryType>;
-    }, "strip", z.ZodTypeAny, {
-        type: BeneficiaryType;
-        createdAt: string;
-        id: string;
-        displayName: string;
-        accountNo: string;
-        profileId: string;
-        updatedAt: string;
-        channel: string;
-    }, {
-        type: BeneficiaryType;
-        createdAt: string;
-        id: string;
-        displayName: string;
-        accountNo: string;
-        profileId: string;
-        updatedAt: string;
-        channel: string;
-    }>;
-    /** Version for future compatibility */
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    id: z.ZodString;
+    profileId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+} & {
+    displayName: z.ZodString;
+    accountNo: z.ZodString;
+    channel: z.ZodString;
+    type: z.ZodNativeEnum<typeof BeneficiaryType>;
+} & {
+    /** Serialization version for future compatibility */
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    version: string;
-    data: {
-        type: BeneficiaryType;
-        createdAt: string;
-        id: string;
-        displayName: string;
-        accountNo: string;
-        profileId: string;
-        updatedAt: string;
-        channel: string;
-    };
+    type: BeneficiaryType;
+    createdAt: string;
+    id: string;
+    displayName: string;
+    accountNo: string;
+    _version: string;
+    profileId: string;
+    updatedAt: string;
+    channel: string;
 }, {
-    data: {
-        type: BeneficiaryType;
-        createdAt: string;
-        id: string;
-        displayName: string;
-        accountNo: string;
-        profileId: string;
-        updatedAt: string;
-        channel: string;
-    };
-    version?: string | undefined;
+    type: BeneficiaryType;
+    createdAt: string;
+    id: string;
+    displayName: string;
+    accountNo: string;
+    profileId: string;
+    updatedAt: string;
+    channel: string;
+    _version?: string | undefined;
 }>;
 /**
  * Infer the BeneficiaryJSON type from the schema
  */
 export type BeneficiaryJSON = z.infer<typeof BeneficiaryJSONSchema>;
+type LegacyBeneficiaryJSON = {
+    data: BeneficiaryDTO;
+} & Record<string, unknown>;
 /**
  * Beneficiary class that wraps the Zod schema and provides additional functionality.
  * Represents a beneficiary entity with validation and type-safe access to beneficiary information.
@@ -93,6 +72,8 @@ export type BeneficiaryJSON = z.infer<typeof BeneficiaryJSONSchema>;
  */
 export declare class Beneficiary {
     private readonly data;
+    private _info;
+    private _infoComputed;
     /**
      * Private constructor - use static factory methods to create instances.
      *
@@ -148,6 +129,9 @@ export declare class Beneficiary {
      * @remarks
      * For mobile beneficiaries, constructs from phone number.
      * For bank beneficiaries, constructs from SWIFT code and account number.
+     *
+     * Result is memoised — repeated accesses don't re-parse the phone number or
+     * re-resolve the bank.
      */
     get info(): BeneficiaryInfo | undefined;
     /**
@@ -275,7 +259,7 @@ export declare class Beneficiary {
      *
      * @static
      * @param {unknown} obj - The value containing potential beneficiary data
-     * @returns {obj is Beneficiary} Type predicate indicating if a Beneficiary can be constructed
+     * @returns {obj is BeneficiaryDTO} Type predicate indicating the value is a valid BeneficiaryDTO
      *
      * @example
      * ```typescript
@@ -288,8 +272,12 @@ export declare class Beneficiary {
      *
      * @remarks
      * This method performs strict validation against the {@link BeneficiaryDTO} schema.
+     *
+     * The predicate narrows to {@link BeneficiaryDTO} (not `Beneficiary`) — what
+     * `obj` actually is on success — so callers don't accidentally try to use
+     * instance methods like `toJSON()` on a raw DTO.
      */
-    static canConstruct(obj: unknown): obj is Beneficiary;
+    static canConstruct(obj: unknown): obj is BeneficiaryDTO;
     /**
      * Validates if an unknown value is a Beneficiary instance.
      * This is a runtime type guard that ensures proper object structure and data validity.
@@ -333,7 +321,7 @@ export declare class Beneficiary {
      * ```typescript
      * const beneficiary = Beneficiary.from(beneficiaryData);
      * const json = beneficiary.toJSON();
-     * // { data: { id: "123", displayName: "John", ... }, version: "1.0" }
+     * // { id: "123", displayName: "John", ..., _version: "1.0" }
      *
      * // Store in localStorage
      * localStorage.setItem('beneficiary', JSON.stringify(json));
@@ -369,13 +357,13 @@ export declare class Beneficiary {
      * 4. Constructs Beneficiary instance with validated data
      *
      * @static
-     * @param {BeneficiaryJSON | string} json - JSON object or string containing beneficiary data
+     * @param {BeneficiaryJSON | LegacyBeneficiaryJSON | string} json - JSON object or string containing beneficiary data
      * @returns {Beneficiary | undefined} New Beneficiary instance if successful, undefined if parsing/validation fails
      *
      * @example
      * ```typescript
      * // From JSON object
-     * const json = { data: { id: "123", displayName: "John", ... }, version: "1.0" };
+     * const json = { id: "123", displayName: "John", ..., _version: "1.0" };
      * const beneficiary = Beneficiary.fromJSON(json);
      *
      * // From JSON string
@@ -391,7 +379,7 @@ export declare class Beneficiary {
      * }
      * ```
      */
-    static fromJSON(json: BeneficiaryJSON | string): Beneficiary | undefined;
+    static fromJSON(json: BeneficiaryJSON | LegacyBeneficiaryJSON | string): Beneficiary | undefined;
     /**
      * Creates a Beneficiary instance from a JSON string
      *
@@ -403,7 +391,7 @@ export declare class Beneficiary {
      *
      * @example
      * ```typescript
-     * const jsonString = '{"data":{"id":"123","displayName":"John",...},"version":"1.0"}';
+     * const jsonString = '{"id":"123","displayName":"John",...,"_version":"1.0"}';
      * const beneficiary = Beneficiary.fromJSONString(jsonString);
      * ```
      */
@@ -439,3 +427,4 @@ export declare class Beneficiary {
      */
     static isBeneficiaryJSON(obj: unknown): obj is BeneficiaryJSON;
 }
+export {};

package/dist/modules/beneficiary/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./beneficiary.repository.js";
 export * from "./beneficiary.dtos.js";
-export * from "./beneficiary-info.model.js";
-export * from "./beneficiary.model.js";
+export { BankBeneficiaryInfo, BankBeneficiaryJSONSchema, BeneficiaryError, BeneficiaryInfo, BeneficiaryInfoFactory, BeneficiaryJSONSchema as BeneficiaryInfoJSONSchema, MobileBeneficiaryInfo, MobileBeneficiaryJSONSchema, type BankBeneficiaryJSON, type BeneficiaryJSON as BeneficiaryInfoJSON, type MobileBeneficiaryJSON, } from "./beneficiary-info.model.js";
+export { Beneficiary, BeneficiaryJSONSchema, type BeneficiaryJSON, } from "./beneficiary.model.js";
 export * from "./beneficiary-input-handler.js";
 export * from "./beneficiary.api-contract.js";

package/dist/modules/login/login.model.d.ts

@@ -1,4 +1,5 @@
 import { LogInDTO } from "./login.dtos.js";
+import { Permission } from "./permission.type.js";
 import { z } from "zod";
 /**
  * Zod schema for LogIn JSON serialization
@@ -17,13 +18,13 @@ export declare const LogInJSONSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     access: z.ZodArray<z.ZodString, "many">;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     type: string;
     name: string;
     createdAt: string;
     id: string;
-    version: string;
+    _version: string;
     profileId: string;
     identity: string;
     roleId: string;
@@ -45,7 +46,7 @@ export declare const LogInJSONSchema: z.ZodObject<{
     resetPassword: boolean;
     updatedAt: string;
     access: string[];
-    version?: string | undefined;
+    _version?: string | undefined;
 }>;
 /**
  * Infer the LogInJSON type from the schema
@@ -74,6 +75,7 @@ export declare class LogIn {
     private readonly _createdAt;
     private readonly _updatedAt;
     private readonly _access;
+    private readonly _permissionMap;
     private constructor();
     /**
      * Creates a LogIn instance from a validated DTO.
@@ -149,6 +151,27 @@ export declare class LogIn {
      * Gets the user's permissions/access list.
      */
     get access(): ReadonlyArray<string>;
+    /**
+     * Checks if the login has a specific permission.
+     *
+     * @param permission - The permission to check
+     * @returns true if the login has the permission
+     */
+    can(permission: Permission): boolean;
+    /**
+     * Checks if the login has any of the specified permissions.
+     *
+     * @param permissions - Array of permissions to check
+     * @returns true if the login has at least one permission
+     */
+    canAny(permissions: Permission[]): boolean;
+    /**
+     * Checks if the login has all of the specified permissions.
+     *
+     * @param permissions - Array of permissions to check
+     * @returns true if the login has all permissions
+     */
+    canAll(permissions: Permission[]): boolean;
     /**
     * Serializes the LogIn instance to a JSON-compatible object
     */

package/dist/modules/payout/payout-channel-handler.d.ts

@@ -1,5 +1,6 @@
 import { Wallet } from "@/modules/wallet/wallet.model.js";
-import { Amount, MNOId, PhoneNumber } from "@temboplus/frontend-core";
+import { Amount, PhoneNumber } from "@temboplus/frontend-core";
+import type { ISO2CountryCode, MobileMoneyProviderId } from "@temboplus/frontend-core";
 import { PayoutChannel, PayoutInputDTO } from "./payout.dtos.js";
 import { BankBeneficiaryInfo, BeneficiaryInfo } from "../beneficiary/beneficiary-info.model.js";
 /**
@@ -11,17 +12,17 @@ import { BankBeneficiaryInfo, BeneficiaryInfo } from "../beneficiary/beneficiary
  *
  * @see {@link PayoutChannelCodeFactory} for functions to generate valid codes
  */
-export type PayoutChannelCode = `${string}-BANK-B2C` | `${string}-${string}-B2C`;
+export type PayoutChannelCode = `${ISO2CountryCode}-${string}-B2C`;
 /**
  * Factory for creating standardized payout channel codes
  *
  * @example
  * ```ts
  * // Create bank channel code
- * const bankCode = PayoutChannelCodeFactory.forBank(bankContactInfo); // Returns "TZ-BANK-B2C"
+ * const bankCode = PayoutChannelCodeFactory.forBank(bankContactInfo, wallet); // Returns "TZ-BANK-B2C"
  *
  * // Create mobile channel code
- * const mobileCode = PayoutChannelCodeFactory.forMobile(phoneNumber); // Returns "TZ-VODACOM-B2C" for Vodacom number
+ * const mobileCode = PayoutChannelCodeFactory.forMobile(phoneNumber, mnoId, wallet); // Returns "TZ-VODACOM-B2C" for Vodacom number
  * ```
  */
 declare class PayoutChannelCodeFactory {
@@ -39,7 +40,7 @@ declare class PayoutChannelCodeFactory {
      *
      * @see {@link PhoneNumber} from "@temboplus/frontend-core" for phone number structure
      */
-    static forMobile(phoneNumber: PhoneNumber, mnoId: MNOId, wallet: Wallet): PayoutChannelCode;
+    static forMobile(phoneNumber: PhoneNumber, mnoId: MobileMoneyProviderId, wallet: Wallet): PayoutChannelCode;
 }
 /**
  * Factory class for creating payout input DTOs based on channel and contact information
@@ -52,7 +53,7 @@ declare class PayoutChannelCodeFactory {
  *   receiver: mobileContactInfo,
  *   amount: new Amount(1000),
  *   notes: "Payment for services"
- * });
+ * }, wallet);
  * ```
  */
 export declare class PayoutInputFactory {

package/dist/modules/payout/payout.api-contract.d.ts

@@ -646,6 +646,46 @@ export declare const contract: {
                     identity: string;
                 } | null | undefined;
             }>;
+            400: z.ZodObject<{
+                message: z.ZodString;
+                statusCode: z.ZodNumber;
+                error: z.ZodOptional<z.ZodString>;
+                details: z.ZodOptional<z.AnyZodObject>;
+            }, z.UnknownKeysParam, z.ZodTypeAny, {
+                message: string;
+                statusCode: number;
+                error?: string | undefined;
+                details?: {
+                    [x: string]: any;
+                } | undefined;
+            }, {
+                message: string;
+                statusCode: number;
+                error?: string | undefined;
+                details?: {
+                    [x: string]: any;
+                } | undefined;
+            }>;
+            401: z.ZodObject<{
+                message: z.ZodString;
+                statusCode: z.ZodNumber;
+                error: z.ZodOptional<z.ZodString>;
+                details: z.ZodOptional<z.AnyZodObject>;
+            }, z.UnknownKeysParam, z.ZodTypeAny, {
+                message: string;
+                statusCode: number;
+                error?: string | undefined;
+                details?: {
+                    [x: string]: any;
+                } | undefined;
+            }, {
+                message: string;
+                statusCode: number;
+                error?: string | undefined;
+                details?: {
+                    [x: string]: any;
+                } | undefined;
+            }>;
             404: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
             409: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         };