@temboplus/afloat 0.2.0-beta.9 → 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 { 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, MobileMoneyProviderId } from "@temboplus/frontend-core";
+import type { BankSwiftCode, ISO2CountryCode, MobileMoneyProvider, MobileMoneyProviderId } from "@temboplus/frontend-core";
 import { z } from "zod";
 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,7 +21,7 @@ export declare const MobileBeneficiaryJSONSchema: z.ZodObject<{
     name: string;
     phoneNumber: string;
     mnoId: string;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>;
 export declare const BankBeneficiaryJSONSchema: z.ZodObject<{
     type: z.ZodLiteral<"Bank">;
@@ -28,10 +29,10 @@ export declare const BankBeneficiaryJSONSchema: z.ZodObject<{
     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 BankBeneficiaryJSONSchema: z.ZodObject<{
     accName: string;
     swiftCode: string;
     accNo: string;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>;
 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 BeneficiaryJSONSchema: z.ZodDiscriminatedUnion<"type", [z.Z
     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,7 +83,7 @@ export declare const BeneficiaryJSONSchema: z.ZodDiscriminatedUnion<"type", [z.Z
     accName: string;
     swiftCode: string;
     accNo: string;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>]>;
 export type MobileBeneficiaryJSON = z.infer<typeof MobileBeneficiaryJSONSchema>;
 export type BankBeneficiaryJSON = z.infer<typeof BankBeneficiaryJSONSchema>;
@@ -148,6 +149,7 @@ export declare class MobileBeneficiaryInfo extends BaseBeneficiary {
         phoneNumber: PhoneNumber;
         mnoId?: MobileMoneyProviderId;
     }): MobileBeneficiaryInfo | undefined;
+    static fromInputDTO(info: BeneficiaryInputDTO): MobileBeneficiaryInfo | undefined;
     static fromBeneficiaryDTO(info: BeneficiaryDTO): MobileBeneficiaryInfo | undefined;
     static fromPayoutDTO(info: PayoutDTO): MobileBeneficiaryInfo | undefined;
     /**
@@ -164,6 +166,7 @@ export declare class MobileBeneficiaryInfo extends BaseBeneficiary {
     get channelLabel(): string;
     get channelId(): MobileMoneyProviderId;
     get channelName(): string;
+    get mobileMoneyProvider(): MobileMoneyProvider | undefined;
     toJSON(): MobileBeneficiaryJSON;
     static fromJSON(json: MobileBeneficiaryJSON | string): MobileBeneficiaryInfo | undefined;
     static fromJSONString(s: string): MobileBeneficiaryInfo | undefined;
@@ -184,6 +187,7 @@ export declare class BankBeneficiaryInfo extends BaseBeneficiary {
         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;
@@ -203,10 +207,24 @@ export declare class BankBeneficiaryInfo extends BaseBeneficiary {
 }
 export type BeneficiaryInfo = MobileBeneficiaryInfo | BankBeneficiaryInfo;
 /**
- * Top-level entry point for building / recognizing a beneficiary without
+ * Factory for building / recognizing a beneficiary without
  * caring about the variant. Each method dispatches on the discriminator.
  */
+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;

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.
@@ -342,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));
@@ -378,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
@@ -400,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
      *
@@ -412,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);
      * ```
      */
@@ -448,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.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, {}, {}>;
         };

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

@@ -1,6 +1,6 @@
 import { PayoutDTO, PayoutStatus, PayoutApprovalStatus, PayoutAuthorizer } from "@/modules/payout/payout.dtos.js";
 import { Amount } from "@temboplus/frontend-core";
-import { BeneficiaryInfo } from "../beneficiary/beneficiary-info.model.js";
+import { type BeneficiaryInfo } from "../beneficiary/beneficiary-info.model.js";
 import z from "zod";
 /**
  * Zod schema for Payout JSON serialization
@@ -50,12 +50,12 @@ export declare const PayoutJSONSchema: z.ZodObject<{
         id: string;
         identity: string;
     }>>>;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     status: PayoutStatus;
     createdAt: string;
     id: string;
-    version: string;
+    _version: string;
     profileId: string;
     updatedAt: string;
     description: string;
@@ -94,7 +94,7 @@ export declare const PayoutJSONSchema: z.ZodObject<{
     countryCode: string;
     currencyCode: string;
     statusMessage: string;
-    version?: string | undefined;
+    _version?: string | undefined;
     notes?: string | null | undefined;
     partnerReference?: string | null | undefined;
     actionedAt?: string | null | undefined;

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

@@ -11,12 +11,12 @@ export declare const ProfileJSONSchema: z.ZodObject<{
     accountNo: z.ZodString;
     email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     autoApprove: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     displayName: string;
     accountNo: string;
-    version: string;
+    _version: string;
     firstName?: string | null | undefined;
     lastName?: string | null | undefined;
     phone?: string | null | undefined;
@@ -31,7 +31,7 @@ export declare const ProfileJSONSchema: z.ZodObject<{
     phone?: string | null | undefined;
     email?: string | null | undefined;
     autoApprove?: boolean | null | undefined;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>;
 /**
  * Infer the ProfileJSON type from the schema

package/dist/modules/team-member/role.model.d.ts

@@ -10,12 +10,12 @@ export declare const RoleJSONSchema: z.ZodObject<{
     access: z.ZodArray<z.ZodString, "many">;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     createdAt: string;
     id: string;
-    version: string;
+    _version: string;
     updatedAt: string;
     access: string[];
     description?: string | undefined;
@@ -25,7 +25,7 @@ export declare const RoleJSONSchema: z.ZodObject<{
     id: string;
     updatedAt: string;
     access: string[];
-    version?: string | undefined;
+    _version?: string | undefined;
     description?: string | undefined;
 }>;
 /**

package/dist/modules/team-member/team-member.model.d.ts

@@ -35,12 +35,12 @@ export declare const TeamMemberJSONSchema: z.ZodObject<{
         access: z.ZodArray<z.ZodString, "many">;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
-        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         createdAt: string;
         id: string;
-        version: string;
+        _version: string;
         updatedAt: string;
         access: string[];
         description?: string | undefined;
@@ -50,18 +50,18 @@ export declare const TeamMemberJSONSchema: z.ZodObject<{
         id: string;
         updatedAt: string;
         access: string[];
-        version?: string | undefined;
+        _version?: string | undefined;
         description?: string | undefined;
     }>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    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;
@@ -73,7 +73,7 @@ export declare const TeamMemberJSONSchema: z.ZodObject<{
         name: string;
         createdAt: string;
         id: string;
-        version: string;
+        _version: string;
         updatedAt: string;
         access: string[];
         description?: string | undefined;
@@ -90,14 +90,14 @@ export declare const TeamMemberJSONSchema: z.ZodObject<{
     isArchived: boolean;
     resetPassword: boolean;
     updatedAt: string;
-    version?: string | undefined;
+    _version?: string | undefined;
     role?: {
         name: string;
         createdAt: string;
         id: string;
         updatedAt: string;
         access: string[];
-        version?: string | undefined;
+        _version?: string | undefined;
         description?: string | undefined;
     } | undefined;
 }>;

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

@@ -17,13 +17,13 @@ export declare const LEGACY_MOBILE_NARR_PREFIX: string;
  */
 export declare const NarrationJSONSchema: z.ZodObject<{
     text: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    _version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    version: string;
+    _version: string;
     text: string;
 }, {
     text: string;
-    version?: string | undefined;
+    _version?: string | undefined;
 }>;
 export type NarrationJSON = z.infer<typeof NarrationJSONSchema>;
 /**