@temboplus/afloat 0.1.77-beta.2 → 0.1.77-beta.21

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 {};