@temboplus/afloat 0.1.77-beta.18 → 0.1.77-beta.20

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

@@ -15,23 +15,23 @@ declare const walletSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    createdAt: string;
     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;
+    accountName: string;
 }, {
+    createdAt: string;
     id: string;
     accountNo: string;
     profileId: string;
-    createdAt: string;
     updatedAt: string;
-    accountName: string;
     channel: string;
+    accountName: string;
     countryCode?: string | undefined;
     currencyCode?: string | undefined;
 }>;
@@ -52,18 +52,18 @@ declare const walletQuerySchema: z.ZodObject<{
     id?: string | undefined;
     accountNo?: string | undefined;
     profileId?: string | undefined;
-    accountName?: string | undefined;
     channel?: string | undefined;
     countryCode?: string | undefined;
     currencyCode?: string | undefined;
+    accountName?: string | undefined;
 }, {
     id?: string | undefined;
     accountNo?: string | undefined;
     profileId?: string | undefined;
-    accountName?: string | undefined;
     channel?: string | undefined;
     countryCode?: string | undefined;
     currencyCode?: string | undefined;
+    accountName?: string | undefined;
 }>;
 /**
  * Schema definition for a statement entry.
@@ -118,23 +118,23 @@ export declare const WalletDTOSchemas: {
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        createdAt: string;
         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;
+        accountName: string;
     }, {
+        createdAt: string;
         id: string;
         accountNo: string;
         profileId: string;
-        createdAt: string;
         updatedAt: string;
-        accountName: string;
         channel: string;
+        accountName: string;
         countryCode?: string | undefined;
         currencyCode?: string | undefined;
     }>;
@@ -150,18 +150,18 @@ export declare const WalletDTOSchemas: {
         id?: string | undefined;
         accountNo?: string | undefined;
         profileId?: string | undefined;
-        accountName?: string | undefined;
         channel?: string | undefined;
         countryCode?: string | undefined;
         currencyCode?: string | undefined;
+        accountName?: string | undefined;
     }, {
         id?: string | undefined;
         accountNo?: string | undefined;
         profileId?: string | undefined;
-        accountName?: string | undefined;
         channel?: string | undefined;
         countryCode?: string | undefined;
         currencyCode?: string | undefined;
+        accountName?: string | undefined;
     }>;
     statementEntry: z.ZodObject<{
         accountNo: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;

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

@@ -16,26 +16,26 @@ export declare const WalletJSONSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
+    createdAt: string;
     id: string;
     accountNo: string;
     version: string;
     profileId: string;
-    createdAt: string;
     updatedAt: string;
-    accountName: string;
     channel: string;
     countryCode: string;
     currencyCode: string;
+    accountName: string;
 }, {
+    createdAt: string;
     id: string;
     accountNo: string;
     profileId: string;
-    createdAt: string;
     updatedAt: string;
-    accountName: string;
     channel: string;
     countryCode: string;
     currencyCode: string;
+    accountName: string;
     version?: string | undefined;
 }>;
 export type WalletJSON = z.infer<typeof WalletJSONSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/afloat",
-  "version": "0.1.77-beta.18",
+  "version": "0.1.77-beta.20",
   "description": "A foundational library for Temboplus-Afloat projects.",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",

package/dist/modules/auth/auth.manager.d.ts

@@ -1,249 +0,0 @@
-import { Permission } from "@/modules/login/permission.type.js";
-import { User } from "@/modules/auth/user.model.js";
-/**
- * Clean authentication manager for client-side usage only.
- *
- * This class provides a centralized way to manage user authentication state,
- * including login, logout, and permission checking. It uses a singleton pattern
- * for client-side usage and directly interfaces with the unified auth store.
- *
- * **Architecture:**
- * - **Client-side**: Use the singleton instance via `AfloatAuth.instance`
- * - **Server-side**: Pass tokens directly to repositories (no auth manager needed)
- *
- * **Features:**
- * - Direct integration with unified auth store
- * - React hooks for reactive UI updates
- * - Permission checking utilities
- * - Automatic wallet session management
- *
- * @example
- * ```typescript
- * // Client-side usage
- * const auth = AfloatAuth.instance;
- * const user = await auth.logIn(email, password);
- *
- * // Server-side usage (no auth manager needed)
- * const walletRepo = new WalletRepository({ token: extractedToken });
- * const balance = await walletRepo.getBalance({ wallet });
- * ```
- */
-export declare class AfloatAuth {
-    /** Client-side singleton instance */
-    private static _instance;
-    /**
-     * Private constructor to control instantiation.
-     * Use the static instance getter instead.
-     *
-     * @private
-     */
-    private constructor();
-    /**
-     * Gets or creates the client-side singleton instance.
-     *
-     * @returns The client-side singleton instance
-     *
-     * @example
-     * ```typescript
-     * const auth = AfloatAuth.instance;
-     * if (auth.currentUser) {
-     *   console.log("User is logged in");
-     * }
-     * ```
-     */
-    static get instance(): AfloatAuth;
-    /**
-     * Gets the authentication repository for API operations.
-     *
-     * @private
-     * @returns The auth repository instance with current token
-     */
-    private get repo();
-    /**
-     * Gets the current authentication token.
-     *
-     * @returns The current authentication token, or undefined if not authenticated
-     *
-     * @example
-     * ```typescript
-     * const token = auth.getUserToken();
-     * if (token) {
-     *   const apiClient = new SomeRepository({ token });
-     * }
-     * ```
-     */
-    getUserToken(): string | undefined;
-    /**
-     * Gets the currently authenticated user.
-     *
-     * @returns The current user instance, or undefined if not authenticated
-     *
-     * @example
-     * ```typescript
-     * const user = auth.currentUser;
-     * if (user) {
-     *   console.log(`Welcome, ${user.name}!`);
-     * }
-     * ```
-     */
-    get currentUser(): User | undefined;
-    /**
-     * Checks if a user is currently authenticated.
-     *
-     * @returns True if user is authenticated, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (auth.isAuthenticated) {
-     *   // User is logged in
-     *   showDashboard();
-     * } else {
-     *   // User needs to log in
-     *   showLoginForm();
-     * }
-     * ```
-     */
-    get isAuthenticated(): boolean;
-    /**
-     * React hook for accessing the current user in client-side components.
-     *
-     * This hook provides reactive updates when the user state changes,
-     * making it perfect for React components that need to respond to
-     * authentication state changes.
-     *
-     * @returns The current user with reactive updates, or undefined if not authenticated
-     * @throws {Error} If called in a server environment
-     *
-     * @example
-     * ```typescript
-     * function UserProfile() {
-     *   const user = AfloatAuth.instance.useCurrentUser();
-     *
-     *   if (!user) {
-     *     return <LoginForm />;
-     *   }
-     *
-     *   return <div>Hello, {user.name}!</div>;
-     * }
-     * ```
-     */
-    useCurrentUser(): User | undefined;
-    /**
-     * Checks if the current user has a specific permission.
-     *
-     * @param perm - The permission to check
-     * @returns True if the user has the permission, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (auth.checkPermission(Permission.ViewBalance)) {
-     *   // User can view wallet balance
-     *   const walletRepo = new WalletRepository({ token: auth.getUserToken() });
-     *   const balance = await walletRepo.getBalance(wallet);
-     * } else {
-     *   console.log("User doesn't have permission to view balance");
-     * }
-     * ```
-     */
-    checkPermission(perm: Permission): boolean;
-    /**
-     * Authenticates a user with email and password.
-     *
-     * On successful authentication:
-     * - Clears any existing auth data
-     * - Stores the new user and token atomically
-     * - Initializes related services (wallet manager)
-     *
-     * @param email - The user's email address
-     * @param password - The user's password
-     * @returns Promise resolving to the authenticated user
-     * @throws {Error} If authentication fails
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   const user = await auth.logIn("user@example.com", "password123");
-     *   console.log("Login successful!");
-     *   router.push("/dashboard");
-     * } catch (error) {
-     *   console.error("Login failed:", error.message);
-     *   setError("Invalid credentials");
-     * }
-     * ```
-     */
-    logIn(email: string, password: string): Promise<User>;
-    /**
-     * Updates the current user's password.
-     *
-     * @param currentPassword - The user's current password
-     * @param newPassword - The new password to set
-     * @returns Promise resolving to true if successful
-     * @throws {Error} If the password update fails or user is not authenticated
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   await auth.resetPassword("oldPassword", "newPassword123");
-     *   console.log("Password updated successfully");
-     *   showSuccessMessage("Password updated!");
-     * } catch (error) {
-     *   console.error("Password update failed:", error.message);
-     *   showErrorMessage("Failed to update password");
-     * }
-     * ```
-     */
-    resetPassword(currentPassword: string, newPassword: string): Promise<boolean>;
-    /**
-     * Logs out the current user and clears all authentication data.
-     *
-     * This method:
-     * - Clears user state from memory and storage
-     * - Removes authentication tokens
-     * - Resets related services
-     *
-     * @example
-     * ```typescript
-     * auth.logOut();
-     * router.push("/login");
-     * console.log("User logged out successfully");
-     * ```
-     */
-    logOut(): void;
-    /**
-     * Refreshes the current authentication state.
-     * Useful for clearing potentially stale data.
-     *
-     * @example
-     * ```typescript
-     * // Clear current state and force fresh authentication
-     * auth.refresh();
-     * ```
-     */
-    refresh(): void;
-    /**
-     * Gets debug information about the current authentication state.
-     * Useful for troubleshooting authentication issues.
-     *
-     * @returns Object containing authentication state information
-     *
-     * @example
-     * ```typescript
-     * const debugInfo = auth.getDebugInfo();
-     * console.log("Auth Debug Info:", debugInfo);
-     * ```
-     */
-    getDebugInfo(): {
-        hasUser: boolean;
-        hasToken: boolean;
-        isAuthenticated: boolean;
-        userName: string;
-        tokenLength: number;
-        managerInstance: string;
-    };
-    /**
-     * Clears all stored authentication data from the unified store.
-     *
-     * @private
-     */
-    private clearSavedData;
-}

package/dist/modules/auth/auth.store.d.ts

@@ -1,139 +0,0 @@
-import { type StoreApi, type UseBoundStore } from "zustand";
-import { User } from "@/modules/auth/user.model.js";
-/** Type definition for the store's internal state */
-type AuthState = {
-    user: string | undefined;
-    token: string | undefined;
-};
-/** Type definition for the store's actions */
-interface AuthActions {
-    setUser: (user: User) => void;
-    getUser: () => User | undefined;
-    setToken: (token: string) => void;
-    getToken: () => string | undefined;
-    setUserAndToken: (user: User, token: string) => void;
-    clearAuth: () => void;
-}
-/**
- * Unified Zustand store for managing both user and token state with persistence.
- *
- * Features:
- * - Persists both user data and token to sessionStorage
- * - Serializes/deserializes User objects to/from JSON
- * - Provides reactive state updates for React components
- * - Automatically syncs user and token state
- * - Server-side rendering safe
- */
-export declare const authStore: UseBoundStore<StoreApi<AuthState & AuthActions>>;
-/**
- * Gets the current authenticated user from the auth store.
- * This function can be called from anywhere in the application.
- *
- * @returns The current user or undefined if not authenticated
- *
- * @example
- * ```typescript
- * // In BaseRepository or any other file
- * const user = getCurrentUser();
- * if (user) {
- *   console.log(`Current user: ${user.name}`);
- * }
- * ```
- */
-export declare const getCurrentUser: () => User | undefined;
-/**
- * Gets the current authentication token from the auth store.
- * This function can be called from anywhere in the application,
- * including BaseRepository for automatic token injection.
- *
- * @returns The current token or undefined if not authenticated
- *
- * @example
- * ```typescript
- * // In BaseRepository
- * const token = getCurrentToken();
- * if (token) {
- *   // Use token for API calls
- *   return initClient(contract, { baseHeaders: { token } });
- * }
- * ```
- */
-export declare const getCurrentToken: () => string | undefined;
-/**
- * React hook to access the current user with reactive updates.
- *
- * @returns The current user or undefined if not authenticated
- * @throws {Error} If called in a server environment
- *
- * @example
- * ```typescript
- * function UserProfile() {
- *   const user = useCurrentUser();
- *
- *   if (!user) {
- *     return <div>Please log in</div>;
- *   }
- *
- *   return <div>Welcome, {user.name}!</div>;
- * }
- * ```
- */
-export declare const useCurrentUser: () => User | undefined;
-/**
- * React hook to access the current token with reactive updates.
- *
- * @returns The current token or undefined if not authenticated
- * @throws {Error} If called in a server environment
- *
- * @example
- * ```typescript
- * function SomeComponent() {
- *   const token = useCurrentToken();
- *
- *   if (!token) {
- *     return <div>Please log in</div>;
- *   }
- *
- *   // Use token...
- * }
- * ```
- */
-export declare const useCurrentToken: () => string | undefined;
-/**
- * Checks if a user is currently authenticated.
- *
- * @returns True if user is authenticated, false otherwise
- *
- * @example
- * ```typescript
- * if (isAuthenticated()) {
- *   // User is logged in
- *   showDashboard();
- * } else {
- *   // User needs to log in
- *   showLoginForm();
- * }
- * ```
- */
-export declare const isAuthenticated: () => boolean;
-/**
- * Gets debug information about the current authentication state.
- * Useful for troubleshooting authentication issues.
- *
- * @returns Object containing authentication state information
- *
- * @example
- * ```typescript
- * const debugInfo = getAuthDebugInfo();
- * console.log("Auth Debug Info:", debugInfo);
- * ```
- */
-export declare const getAuthDebugInfo: () => {
-    hasUser: boolean;
-    hasToken: boolean;
-    isAuthenticated: boolean;
-    userName: string;
-    tokenLength: number;
-    storeState: string | (AuthState & AuthActions);
-};
-export {};

package/dist/modules/auth/storage/client-store.d.ts

@@ -1,29 +0,0 @@
-import { type StoreApi, type UseBoundStore } from "zustand";
-import type { AuthStore } from "./types.js";
-import { User } from "@/modules/auth/user.model.js";
-/** Type definition for the store's state */
-type State = {
-    user: string | undefined;
-};
-/** Type definition for the store's actions */
-interface Actions {
-    setUser: (user: User) => void;
-    getUser: () => User | undefined;
-    refresh: () => void;
-}
-/**
- * Creates and exports the Zustand store directly for reactive hooks
- * @internal This should only be used by AfloatAuth
- */
-export declare const clientStore: UseBoundStore<StoreApi<State & Actions>>;
-/**
- * Creates a client-side authentication store using Zustand.
- * @returns {AuthStore} An implementation of AuthStore for client-side use
- */
-export declare const createClientStore: () => AuthStore;
-/**
- * React hook to access the current user with reactive updates.
- * @returns {User | undefined} The current user or undefined if not authenticated
- */
-export declare const useClientUser: () => User | undefined;
-export {};

package/dist/modules/auth/storage/client-token-handler.d.ts

@@ -1,31 +0,0 @@
-import type { TokenHandler } from "./types.js";
-/**
- * Client-side implementation of TokenHandler.
- * Manages tokens using sessionStorage.
- * @implements {TokenHandler}
- */
-export declare class ClientTokenHandler implements TokenHandler {
-    /** Singleton instance */
-    private static _instance;
-    /** Private constructor to enforce singleton pattern */
-    private constructor();
-    /**
-     * Gets the singleton instance of ClientTokenHandler.
-     * @returns {ClientTokenHandler} The singleton instance
-     */
-    static get instance(): ClientTokenHandler;
-    /**
-     * Retrieves the token from sessionStorage.
-     * @returns {string | undefined} The stored token or undefined if not present
-     */
-    getUserToken(): string | undefined;
-    /**
-     * Stores the token in sessionStorage.
-     * @param {string} token - The token to store
-     */
-    setUserToken(token: string): void;
-    /**
-     * Removes the token from sessionStorage.
-     */
-    clearToken(): void;
-}

package/dist/modules/auth/storage/types.d.ts

@@ -1,41 +0,0 @@
-import { User } from "../user.model.js";
-/**
- * Interface defining the contract for auth storage implementations.
- * This allows for different storage strategies in different environments.
- */
-export interface AuthStore {
-    /**
-     * Retrieves the currently authenticated user.
-     * @returns {User | undefined} The current user or undefined if not authenticated
-     */
-    getUser(): User | undefined;
-    /**
-     * Sets the current authenticated user.
-     * @param {User} user - The user to set as currently authenticated
-     */
-    setUser(user: User): void;
-    /**
-     * Clears the current authentication state.
-     */
-    refresh(): void;
-}
-/**
- * Interface defining the contract for token handling implementations.
- * This allows for different token storage strategies in different environments.
- */
-export interface TokenHandler {
-    /**
-     * Retrieves the current authentication token.
-     * @returns {string | undefined} The current token or undefined if not present
-     */
-    getUserToken(): string | undefined;
-    /**
-     * Sets the authentication token.
-     * @param {string} token - The token to store
-     */
-    setUserToken(token: string): void;
-    /**
-     * Clears the stored authentication token.
-     */
-    clearToken(): void;
-}