@temboplus/afloat 0.1.77-beta.9 → 0.1.79

package/dist/modules/wallet/statement-entry.model.d.ts

@@ -1,299 +0,0 @@
-import { Amount } from "@temboplus/frontend-core";
-import { Narration } from "./narration.model.js";
-import z from "zod";
-/**
- * Zod schema for WalletStatementEntry JSON serialization
- */
-export declare const WalletStatementEntryJSONSchema: z.ZodObject<{
-    accountNo: z.ZodOptional<z.ZodString>;
-    debitOrCredit: z.ZodString;
-    tranRefNo: z.ZodString;
-    narration: z.ZodObject<{
-        text: z.ZodString;
-        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        version: string;
-        text: string;
-    }, {
-        text: string;
-        version?: string | undefined;
-    }>;
-    txnDate: z.ZodString;
-    valueDate: z.ZodString;
-    amountCredited: z.ZodObject<{
-        value: z.ZodNumber;
-        text: z.ZodString;
-        currencyCode: z.ZodString;
-        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        version: string;
-        value: number;
-        text: string;
-        currencyCode: string;
-    }, {
-        value: number;
-        text: string;
-        currencyCode: string;
-        version?: string | undefined;
-    }>;
-    amountDebited: z.ZodObject<{
-        value: z.ZodNumber;
-        text: z.ZodString;
-        currencyCode: z.ZodString;
-        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        version: string;
-        value: number;
-        text: string;
-        currencyCode: string;
-    }, {
-        value: number;
-        text: string;
-        currencyCode: string;
-        version?: string | undefined;
-    }>;
-    balance: z.ZodObject<{
-        value: z.ZodNumber;
-        text: z.ZodString;
-        currencyCode: z.ZodString;
-        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        version: string;
-        value: number;
-        text: string;
-        currencyCode: string;
-    }, {
-        value: number;
-        text: string;
-        currencyCode: string;
-        version?: string | undefined;
-    }>;
-    currencyCode: z.ZodString;
-    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    version: string;
-    currencyCode: string;
-    debitOrCredit: string;
-    tranRefNo: string;
-    narration: {
-        version: string;
-        text: string;
-    };
-    txnDate: string;
-    valueDate: string;
-    amountCredited: {
-        version: string;
-        value: number;
-        text: string;
-        currencyCode: string;
-    };
-    amountDebited: {
-        version: string;
-        value: number;
-        text: string;
-        currencyCode: string;
-    };
-    balance: {
-        version: string;
-        value: number;
-        text: string;
-        currencyCode: string;
-    };
-    accountNo?: string | undefined;
-}, {
-    currencyCode: string;
-    debitOrCredit: string;
-    tranRefNo: string;
-    narration: {
-        text: string;
-        version?: string | undefined;
-    };
-    txnDate: string;
-    valueDate: string;
-    amountCredited: {
-        value: number;
-        text: string;
-        currencyCode: string;
-        version?: string | undefined;
-    };
-    amountDebited: {
-        value: number;
-        text: string;
-        currencyCode: string;
-        version?: string | undefined;
-    };
-    balance: {
-        value: number;
-        text: string;
-        currencyCode: string;
-        version?: string | undefined;
-    };
-    accountNo?: string | undefined;
-    version?: string | undefined;
-}>;
-export type WalletStatementEntryJSON = z.infer<typeof WalletStatementEntryJSONSchema>;
-/**
- * Represents a single entry in a Wallet's statement history.
- *
- * This class provides methods for creating, validating, and accessing statement entry data.
- * It integrates with the Zod schema validation for data integrity and includes narration parsing capabilities.
- * The narration field now uses the Narration class for enhanced functionality.
- */
-export declare class WalletStatementEntry {
-    private _accountNo?;
-    private _debitOrCredit;
-    private _tranRefNo;
-    private _narration;
-    private _txnDate;
-    private _valueDate;
-    private _amountCredited;
-    private _amountDebited;
-    private _balance;
-    private _currencyCode;
-    /**
-     * Gets the statement entry schema used for validation.
-     */
-    static get schema(): z.ZodObject<{
-        accountNo: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-        debitOrCredit: z.ZodString;
-        tranRefNo: z.ZodString;
-        narration: z.ZodString;
-        txnDate: z.ZodDate;
-        valueDate: z.ZodDate;
-        amountCredited: z.ZodNumber;
-        amountDebited: z.ZodNumber;
-        balance: z.ZodNumber;
-        currencyCode: z.ZodDefault<z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>>;
-    }, "strip", z.ZodTypeAny, {
-        currencyCode: string;
-        debitOrCredit: string;
-        tranRefNo: string;
-        narration: string;
-        txnDate: Date;
-        valueDate: Date;
-        amountCredited: number;
-        amountDebited: number;
-        balance: number;
-        accountNo?: string | undefined;
-    }, {
-        debitOrCredit: string;
-        tranRefNo: string;
-        narration: string;
-        txnDate: Date;
-        valueDate: Date;
-        amountCredited: number;
-        amountDebited: number;
-        balance: number;
-        accountNo?: string | undefined;
-        currencyCode?: string | undefined;
-    }>;
-    /**
-     * Private constructor to enforce use of static factory methods.
-     * Assumes data is already validated and dates are Date objects.
-     * @param data - Object containing statement entry information conforming to WalletStatementEntryDTO.
-     * @param narration - Narration instance for the transaction
-     */
-    private constructor();
-    /**
-     * Creates a new WalletStatementEntry instance after validating the input data.
-     * Handles date coercion via the schema and uses currencyCode from the data.
-     *
-     * @param data - Object containing statement entry information. Dates can be strings or Date objects.
-     * @returns A new WalletStatementEntry instance, or undefined if validation fails.
-     */
-    static create(data: {
-        accountNo?: string | null;
-        debitOrCredit: string;
-        tranRefNo: string;
-        narration: string | Narration;
-        txnDate: string | Date;
-        valueDate: string | Date;
-        amountCredited: number;
-        amountDebited: number;
-        balance: number;
-        currencyCode?: string;
-    }): WalletStatementEntry | undefined;
-    get accountNo(): string | undefined;
-    get debitOrCredit(): string;
-    get tranRefNo(): string;
-    get narration(): Narration;
-    get txnDate(): Date;
-    get valueDate(): Date;
-    get amountCredited(): Amount;
-    get amountDebited(): Amount;
-    get balance(): Amount;
-    get currencyCode(): string;
-    /**
-     * Validates the current statement entry instance data against the schema.
-     * @returns True if the statement entry instance data is valid, false otherwise.
-     */
-    validate(): boolean;
-    /**
-     * Type guard to check if an unknown object is a valid WalletStatementEntry instance.
-     * Performs structural checks (duck typing).
-     * @param obj - The object to check.
-     * @returns Type predicate indicating if the object is a WalletStatementEntry instance.
-     */
-    static is(obj: unknown): obj is WalletStatementEntry;
-    /**
-     * Checks if two WalletStatementEntry instances are equal based on their transaction reference numbers.
-     * @param other - Another WalletStatementEntry to compare with.
-     * @returns True if both entries have the same transaction reference number.
-     */
-    equals(other: WalletStatementEntry): boolean;
-    /**
-     * Creates a copy of this WalletStatementEntry with the same data.
-     * @returns A new WalletStatementEntry instance with identical data.
-     */
-    clone(): WalletStatementEntry | undefined;
-    /**
-     * Returns a string representation of the statement entry for debugging.
-     * @returns A formatted string with key transaction details.
-     */
-    toString(): string;
-    /**
-     * Legacy method for backwards compatibility - creates from plain object
-     * @deprecated Use fromJson() for serialized data or create() for raw data
-     */
-    static from(data: any): WalletStatementEntry | undefined;
-    /**
-   * Serializes the WalletStatementEntry instance to a JSON-compatible object
-   */
-    toJSON(): WalletStatementEntryJSON;
-    /**
-     * Serializes the WalletStatementEntry instance to a JSON string
-     */
-    toJSONString(): string;
-    /**
-     * Creates a WalletStatementEntry instance from a JSON-compatible object or string
-     */
-    static fromJSON(json: WalletStatementEntryJSON | string): WalletStatementEntry | undefined;
-    /**
-     * Type guard using Zod schema validation
-     */
-    static isWalletStatementEntryJSON(obj: unknown): obj is WalletStatementEntryJSON;
-    /**
-     * Creates WalletStatementEntry instances from a JSON array
-     */
-    static fromJSONArray(jsonArray: WalletStatementEntryJSON[] | string): WalletStatementEntry[];
-    /**
-     * Serializes an array of WalletStatementEntry instances to JSON
-     */
-    static toJSONArray(entries: WalletStatementEntry[]): WalletStatementEntryJSON[];
-    /**
-     * @deprecated Use toJSON() instead
-     */
-    toJson(): WalletStatementEntryJSON;
-    /**
-     * @deprecated Use fromJSON() instead
-     */
-    static fromJson(json: WalletStatementEntryJSON | string): WalletStatementEntry | undefined;
-    /**
-     * @deprecated Use fromJSONArray() instead
-     */
-    static fromJsonArray(jsonArray: WalletStatementEntryJSON[] | string): WalletStatementEntry[];
-    /**
-     * @deprecated Use toJSONArray() instead
-     */
-    static toJsonArray(entries: WalletStatementEntry[]): WalletStatementEntryJSON[];
-}

package/dist/modules/wallet/wallet-manager.session.d.ts

@@ -1,143 +0,0 @@
-import { Country, type CountryCode } from "@temboplus/frontend-core";
-import { Wallet } from "./wallet.model.js";
-import { User } from "../auth/user.model.js";
-/**
- * Defines the shape of the persisted wallet session state.
- * IMPORTANT: Properties like selectedWalletId/selectedCountryCode are guaranteed
- * non-nullable and valid ONLY when isInitialized is true.
- */
-interface WalletSession {
-    userId: string;
-    wallets: Wallet[];
-    selectedWalletId: string;
-    selectedCountryCode: CountryCode;
-    lastSynced: Date | string;
-    isInitialized: boolean;
-}
-/**
- * Defines the complete state shape including actions and internal getters.
- */
-interface WalletState extends WalletSession {
-    setWallets: (wallets: Wallet[]) => void;
-    setSelectedWallet: (wallet: Wallet) => void;
-    setSelectedCountry: (countryCode: CountryCode) => void;
-    reset: () => void;
-    _getWalletsByCountry: (countryCode: CountryCode) => Wallet[];
-    _getSelectedWallet: () => Wallet;
-}
-export declare const walletsStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<WalletState>, "persist"> & {
-    persist: {
-        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<WalletState, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: WalletState) => void) => () => void;
-        onFinishHydration: (fn: (state: WalletState) => void) => () => void;
-        getOptions: () => Partial<import("zustand/middleware").PersistOptions<WalletState, unknown>>;
-    };
-}>;
-/**
- * WalletSessionManager handles wallet-related operations and state management coordination.
- * It uses a Zustand store (`useWalletStore`) for state and interacts with WalletRepo.
- *
- * IMPORTANT: This manager enforces the invariant that an initialized user session
- * always has at least one wallet and a valid selection. Methods that return selected
- * data (`getSelectedWallet`, `getSelectedCountry`, etc.) will THROW AN ERROR if called
- * before the session is initialized via the `initialize()` method.
- */
-export declare class WalletSessionManager {
-    private repo;
-    private static _instance;
-    /**
-     * @private
-     */
-    private constructor();
-    /**
-     * Gets the singleton instance of WalletSessionManager.
-     * @returns {WalletSessionManager} The singleton instance.
-     */
-    static get instance(): WalletSessionManager;
-    /**
-     * Checks if the wallet session is initialized.
-     * @returns {boolean} True if initialized, false otherwise.
-     */
-    isInitialized(): boolean;
-    /**
-     * Initializes the wallet manager for the current user.
-     * Fetches wallets if the store isn't already initialized.
-     * Throws an error if the user is not authenticated or if the user is found to have no wallets.
-     * @async
-     * @returns {Promise<void>} Resolves when initialization is complete.
-     * @throws {Error} If user not authenticated or user has no wallets.
-     */
-    initialize(user: User): Promise<void>;
-    /**
-     * Fetches the latest wallet data from the server and updates the store.
-     * Throws an error if the user has no wallets or if the fetch fails.
-     * Ensures the store is updated and marked as initialized.
-     * @async
-     * @returns {Promise<void>} Resolves when refresh is complete.
-     * @throws {Error} If fetch fails or user has no wallets.
-     */
-    refreshWallets(): Promise<void>;
-    /**
-     * Gets all available wallets. Guaranteed non-empty after successful initialization.
-     * @returns {Wallet[]} Non-empty array of Wallet instances.
-     * @throws {Error} If called before initialization is complete.
-     */
-    getWallets(): Wallet[];
-    /**
-     * Gets unique available country codes based on current wallets.
-     * @returns {CountryCode[]} Array of CountryCodes. Guaranteed non-empty after initialization.
-     * @throws {Error} If called before initialization is complete.
-     */
-    getCountries(): CountryCode[];
-    /**
-     * Gets wallets for a specific country.
-     * @param {CountryCode} countryCode The country code to filter by.
-     * @returns {Wallet[]} Array of Wallet instances for the country. May be empty if no wallets match the code, but the overall list isn't empty.
-     * @throws {Error} If called before initialization is complete.
-     */
-    getWalletsByCountry(countryCode: CountryCode): Wallet[];
-    /**
-     * Gets the currently selected wallet instance.
-     * @returns {Wallet} The selected Wallet instance (guaranteed non-nullable).
-     * @throws {Error} If called before initialization is complete or if state is inconsistent.
-     */
-    getSelectedWallet(): Wallet;
-    /**
-     * Gets the currently selected country code.
-     * @returns {CountryCode} The selected CountryCode (guaranteed non-nullable).
-     * @throws {Error} If called before initialization is complete.
-     */
-    getSelectedCountryCode(): CountryCode;
-    /**
-     * Gets the currently selected Country object.
-     * @returns {Country} The selected Country object (guaranteed non-nullable).
-     * @throws {Error} If called before initialization or if Country.fromCode fails for the selected code.
-     */
-    getSelectedCountry(): Country;
-    /**
-     * Changes the selected wallet in the store.
-     * Throws error if the provided walletId is not found in the current list.
-     * @param {string} walletId - The ID of the wallet to select.
-     * @returns {void}
-     * @throws {Error} If wallet with given ID is not found or if called before initialization.
-     */
-    changeWallet(walletId: string): void;
-    /**
-     * Changes the selected country in the store.
-     * Automatically selects the first available wallet for that country.
-     * Throws error if no wallets exist for the given countryCode or if called before initialization.
-     * @param {CountryCode} countryCode - The country code to select.
-     * @returns {void}
-     * @throws {Error} If no wallets found for the country code or if called before initialization.
-     */
-    changeCountry(countryCode: CountryCode): void;
-    /**
-     * Resets the wallet store to  initial (uninitialized) state.
-     * Typically used during user logout.
-     */
-    reset(): void;
-}
-export {};

package/dist/modules/wallet/wallet.dtos.d.ts

@@ -1,204 +0,0 @@
-import { z } from "zod";
-/**
- * Zod schema definition for validating Wallet data structures.
- * Ensures data integrity for wallet objects, including runtime validation
- * of country codes against the imported ISO2CountryCodesSet.
- */
-declare const walletSchema: z.ZodObject<{
-    id: z.ZodString;
-    profileId: z.ZodString;
-    accountNo: z.ZodString;
-    accountName: z.ZodString;
-    channel: z.ZodString;
-    countryCode: z.ZodEffects<z.ZodDefault<z.ZodString>, import("@temboplus/frontend-core").ISO2CountryCode, string | undefined>;
-    currencyCode: z.ZodEffects<z.ZodDefault<z.ZodString>, import("@temboplus/frontend-core").CurrencyCode, string | undefined>;
-    createdAt: z.ZodString;
-    updatedAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    accountNo: string;
-    profileId: string;
-    createdAt: string;
-    updatedAt: string;
-    accountName: string;
-    channel: string;
-    countryCode: import("@temboplus/frontend-core").ISO2CountryCode;
-    currencyCode: import("@temboplus/frontend-core").CurrencyCode;
-}, {
-    id: string;
-    accountNo: string;
-    profileId: string;
-    createdAt: string;
-    updatedAt: string;
-    accountName: string;
-    channel: string;
-    countryCode?: string | undefined;
-    currencyCode?: string | undefined;
-}>;
-/**
- * Zod schema definition for validating Wallet data structures.
- * Ensures data integrity for wallet objects, including runtime validation
- * of country codes against the imported ISO2CountryCodesSet.
- */
-declare const walletQuerySchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    profileId: z.ZodOptional<z.ZodString>;
-    accountNo: z.ZodOptional<z.ZodString>;
-    accountName: z.ZodOptional<z.ZodString>;
-    channel: z.ZodOptional<z.ZodString>;
-    countryCode: z.ZodOptional<z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>>;
-    currencyCode: z.ZodOptional<z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>>;
-}, "strip", z.ZodTypeAny, {
-    id?: string | undefined;
-    accountNo?: string | undefined;
-    profileId?: string | undefined;
-    accountName?: string | undefined;
-    channel?: string | undefined;
-    countryCode?: string | undefined;
-    currencyCode?: string | undefined;
-}, {
-    id?: string | undefined;
-    accountNo?: string | undefined;
-    profileId?: string | undefined;
-    accountName?: string | undefined;
-    channel?: string | undefined;
-    countryCode?: string | undefined;
-    currencyCode?: string | undefined;
-}>;
-/**
- * Schema definition for a statement entry.
- */
-declare const statementEntrySchema: z.ZodObject<{
-    accountNo: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-    debitOrCredit: z.ZodString;
-    tranRefNo: z.ZodString;
-    narration: z.ZodString;
-    txnDate: z.ZodDate;
-    valueDate: z.ZodDate;
-    amountCredited: z.ZodNumber;
-    amountDebited: z.ZodNumber;
-    balance: z.ZodNumber;
-    currencyCode: z.ZodDefault<z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>>;
-}, "strip", z.ZodTypeAny, {
-    currencyCode: string;
-    debitOrCredit: string;
-    tranRefNo: string;
-    narration: string;
-    txnDate: Date;
-    valueDate: Date;
-    amountCredited: number;
-    amountDebited: number;
-    balance: number;
-    accountNo?: string | undefined;
-}, {
-    debitOrCredit: string;
-    tranRefNo: string;
-    narration: string;
-    txnDate: Date;
-    valueDate: Date;
-    amountCredited: number;
-    amountDebited: number;
-    balance: number;
-    accountNo?: string | undefined;
-    currencyCode?: string | undefined;
-}>;
-/**
- * Collection of wallet-related schemas for export.
- * Provides access to both wallet and statement entry validation schemas.
- */
-export declare const WalletDTOSchemas: {
-    walletDTO: z.ZodObject<{
-        id: z.ZodString;
-        profileId: z.ZodString;
-        accountNo: z.ZodString;
-        accountName: z.ZodString;
-        channel: z.ZodString;
-        countryCode: z.ZodEffects<z.ZodDefault<z.ZodString>, import("@temboplus/frontend-core").ISO2CountryCode, string | undefined>;
-        currencyCode: z.ZodEffects<z.ZodDefault<z.ZodString>, import("@temboplus/frontend-core").CurrencyCode, string | undefined>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        accountNo: string;
-        profileId: string;
-        createdAt: string;
-        updatedAt: string;
-        accountName: string;
-        channel: string;
-        countryCode: import("@temboplus/frontend-core").ISO2CountryCode;
-        currencyCode: import("@temboplus/frontend-core").CurrencyCode;
-    }, {
-        id: string;
-        accountNo: string;
-        profileId: string;
-        createdAt: string;
-        updatedAt: string;
-        accountName: string;
-        channel: string;
-        countryCode?: string | undefined;
-        currencyCode?: string | undefined;
-    }>;
-    walletQuery: z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        profileId: z.ZodOptional<z.ZodString>;
-        accountNo: z.ZodOptional<z.ZodString>;
-        accountName: z.ZodOptional<z.ZodString>;
-        channel: z.ZodOptional<z.ZodString>;
-        countryCode: z.ZodOptional<z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>>;
-        currencyCode: z.ZodOptional<z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>>;
-    }, "strip", z.ZodTypeAny, {
-        id?: string | undefined;
-        accountNo?: string | undefined;
-        profileId?: string | undefined;
-        accountName?: string | undefined;
-        channel?: string | undefined;
-        countryCode?: string | undefined;
-        currencyCode?: string | undefined;
-    }, {
-        id?: string | undefined;
-        accountNo?: string | undefined;
-        profileId?: string | undefined;
-        accountName?: string | undefined;
-        channel?: string | undefined;
-        countryCode?: string | undefined;
-        currencyCode?: string | undefined;
-    }>;
-    statementEntry: z.ZodObject<{
-        accountNo: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-        debitOrCredit: z.ZodString;
-        tranRefNo: z.ZodString;
-        narration: z.ZodString;
-        txnDate: z.ZodDate;
-        valueDate: z.ZodDate;
-        amountCredited: z.ZodNumber;
-        amountDebited: z.ZodNumber;
-        balance: z.ZodNumber;
-        currencyCode: z.ZodDefault<z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>>;
-    }, "strip", z.ZodTypeAny, {
-        currencyCode: string;
-        debitOrCredit: string;
-        tranRefNo: string;
-        narration: string;
-        txnDate: Date;
-        valueDate: Date;
-        amountCredited: number;
-        amountDebited: number;
-        balance: number;
-        accountNo?: string | undefined;
-    }, {
-        debitOrCredit: string;
-        tranRefNo: string;
-        narration: string;
-        txnDate: Date;
-        valueDate: Date;
-        amountCredited: number;
-        amountDebited: number;
-        balance: number;
-        accountNo?: string | undefined;
-        currencyCode?: string | undefined;
-    }>;
-};
-export type WalletDTO = z.infer<typeof walletSchema>;
-export type WalletQueryDTO = z.infer<typeof walletQuerySchema>;
-export type WalletStatementEntryDTO = z.infer<typeof statementEntrySchema>;
-export {};