@temboplus/afloat 0.1.74-0 → 0.1.76-beta.0

package/dist/lib/api/index.d.ts

@@ -1,2 +1 @@
-export * from "./common-schemas.js";
 export * from "./base-repository.js";

package/dist/lib/error/error.permission.d.ts

@@ -1,4 +1,4 @@
-import { Permission } from "@/models/permission.js";
+import { Permission } from "@/modules/auth/permission.type.js";
 /**
  * Custom error class representing an error caused by missing required permissions.
  * Extends the built-in {@link Error} class to include the `requiredPermissions` property.

package/dist/lib/query/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./query.builder.js";
 export * from "./query.types.js";
+export * from "./pagination/pagination.schemas.js";
+export * from "./pagination/pagination.js";

package/dist/lib/query/pagination/pagination.d.ts

@@ -0,0 +1,73 @@
+/** Serialized pagination metadata for API responses */
+export type PaginationJson = {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+};
+/**
+ * Represents pagination metadata for paginated API responses.
+ * Provides computed properties for navigation and page calculations.
+ */
+export declare class Pagination {
+    readonly page: number;
+    readonly limit: number;
+    readonly total: number;
+    /**
+     * @param page - Current page number (1-based)
+     * @param limit - Number of items per page
+     * @param total - Total number of items across all pages
+     */
+    constructor(page: number, limit: number, total: number);
+    /** Total number of pages */
+    get totalPages(): number;
+    /** Whether there is a next page available */
+    get hasNext(): boolean;
+    /** Whether there is a previous page available */
+    get hasPrev(): boolean;
+    /** Offset for database queries (0-based) */
+    get offset(): number;
+    /** Whether this is the first page */
+    get isFirstPage(): boolean;
+    /** Whether this is the last page */
+    get isLastPage(): boolean;
+    /**
+     * Creates a Pagination instance for the next page.
+     * @returns New Pagination instance or null if no next page exists
+     */
+    nextPage(): Pagination | null;
+    /**
+     * Creates a Pagination instance for the previous page.
+     * @returns New Pagination instance or null if no previous page exists
+     */
+    prevPage(): Pagination | null;
+    /** Converts to a plain object for JSON serialization */
+    toJSON(): {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+/** Generic paginated response structure */
+export interface Paged<T> {
+    results: T[];
+    pagination: Pagination;
+}
+/** Type for paginated responses after JSON serialization */
+export type PaginatedApiResponse<T> = {
+    results: T[];
+    pagination: PaginationJson;
+};
+/**
+ * Creates a paginated response from query results.
+ */
+export declare function createPaginatedResponse<T>(results: T[], page: number, limit: number, total: number): Paged<T>;
+/**
+ * Creates an empty paginated response.
+ */
+export declare function emptyPaginatedResponse<T>(page?: number, limit?: number): Paged<T>;

package/dist/lib/query/pagination/pagination.schemas.d.ts

@@ -0,0 +1,83 @@
+import { z } from "zod";
+/** Zod schema for validating pagination query parameters */
+export declare const PaginationParamsSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+}, {
+    page?: number | undefined;
+    limit?: number | undefined;
+}>;
+/** Zod schema for validating pagination metadata */
+export declare const PaginationSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    limit: z.ZodNumber;
+    total: z.ZodNumber;
+    totalPages: z.ZodNumber;
+    hasNext: z.ZodBoolean;
+    hasPrev: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}, {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}>;
+/**
+ * Creates a Zod schema for a paginated response with typed results.
+ */
+export declare function createPaginatedResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    results: z.ZodArray<T, "many">;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasNext: z.ZodBoolean;
+        hasPrev: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    }, {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    results: T["_output"][];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}, {
+    results: T["_input"][];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}>;

package/dist/{features → modules}/auth/auth.contract.d.ts

@@ -87,13 +87,6 @@ export declare const authContract: {
     access: {
         method: "GET";
         path: "/access";
-        headers: z.ZodObject<{
-            token: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            token: string;
-        }, {
-            token: string;
-        }>;
         responses: {
             200: z.ZodArray<z.ZodString, "many">;
         };
@@ -104,11 +97,11 @@ export declare const authContract: {
             currentPassword: z.ZodString;
             newPassword: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            newPassword: string;
             currentPassword: string;
-        }, {
             newPassword: string;
+        }, {
             currentPassword: string;
+            newPassword: string;
         }>;
         path: "/password";
         responses: {};

package/dist/{features → modules}/auth/auth.manager.d.ts

@@ -1,5 +1,5 @@
-import { Permission } from "@/models/permission.js";
-import { User } from "@/models/user.model.js";
+import { Permission } from "@/modules/auth/permission.type.js";
+import { User } from "@/modules/auth/user.model.js";
 /**
  * Clean authentication manager for client-side usage only.
  *

package/dist/{features → modules}/auth/auth.repository.d.ts

@@ -1,5 +1,5 @@
 import { BaseRepository } from "@/lib/api/base-repository.js";
-import { User } from "@/models/user.model.js";
+import { User } from "@/modules/auth/user.model.js";
 import { authContract } from "./auth.contract.js";
 /**
  * Repository class for handling authentication-related operations.
@@ -63,4 +63,21 @@ export declare class AuthRepository extends BaseRepository<typeof authContract>
      * ```
      */
     updatePassword(currentPassword: string, newPassword: string): Promise<boolean>;
+    /**
+     * Retrieves the current user's access list.
+     *
+     * @returns Promise that resolves to an array of access permissions/roles
+     * @throws {APIError} If the request fails or returns an unexpected status
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const accessList = await repo.getAccessList();
+     *   console.log("User has access to:", accessList);
+     * } catch (error) {
+     *   console.error("Failed to get access list:", error.message);
+     * }
+     * ```
+     */
+    getAccessList(): Promise<string[]>;
 }

package/dist/{features → modules}/auth/auth.store.d.ts

@@ -1,5 +1,5 @@
 import { type StoreApi, type UseBoundStore } from "zustand";
-import { User } from "@/models/user.model.js";
+import { User } from "@/modules/auth/user.model.js";
 /** Type definition for the store's internal state */
 type AuthState = {
     user: string | undefined;

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

@@ -0,0 +1,4 @@
+export * from "./auth.manager.js";
+export * from "./auth.repository.js";
+export * from "./permission.type.js";
+export * from "./user.model.js";

package/dist/{features → modules}/auth/storage/client-store.d.ts

@@ -1,6 +1,6 @@
 import { type StoreApi, type UseBoundStore } from "zustand";
 import type { AuthStore } from "./types.js";
-import { User } from "@/models/user.model.js";
+import { User } from "@/modules/auth/user.model.js";
 /** Type definition for the store's state */
 type State = {
     user: string | undefined;

package/dist/{features → modules}/auth/storage/types.d.ts

@@ -1,4 +1,4 @@
-import type { User } from "@/models/user.model";
+import { User } from "../user.model.js";
 /**
  * Interface defining the contract for auth storage implementations.
  * This allows for different storage strategies in different environments.

package/dist/{models → modules/auth}/user.model.d.ts

@@ -1,4 +1,5 @@
-import { Profile } from "./profile.model.js";
+import { Permission } from "./permission.type.js";
+import { Profile } from "../profile/profile.model.js";
 /**
  * Represents a user in Afloat.
  *
@@ -29,7 +30,7 @@ export declare class User {
     /**
      * A list of granted access keys (permissions).
      */
-    access: string[];
+    access: Permission[];
     /**
      * A map of access keys to boolean values for fast permission checks.
      */
@@ -44,7 +45,7 @@ export declare class User {
      * @param key - The access key to check.
      * @returns `true` if the user has the specified access, otherwise `false`.
      */
-    can(key: string): boolean;
+    can(key: Permission): boolean;
     /**
      * Returns a plain object representation of the user.
      * This can safely be embedded in a JWT payload.

package/dist/{models → modules/contact}/contact-info.model.d.ts

@@ -1,5 +1,5 @@
-import { ContactType, ContactDTO } from "@/features/contact/contact.dtos.js";
-import { PayoutDTO } from "@/features/payout/payout.dtos.js";
+import { ContactType, ContactDTO } from "@/modules/contact/contact.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";
 /**

package/dist/{features → modules}/contact/contact-input-handler.d.ts

@@ -1,4 +1,4 @@
-import { ContactInfo } from "@/models/contact-info.model.js";
+import { ContactInfo } from "@/modules/contact/contact-info.model.js";
 import { ContactInputDTO } from "./contact.dtos.js";
 /**
  * Factory for resolving and validating a raw `ContactInput` into a typed and valid version.

package/dist/{models → modules/contact}/contact.model.d.ts

@@ -1,4 +1,4 @@
-import { ContactDTO, ContactType } from "@/features/contact/contact.dtos.js";
+import { ContactDTO, ContactType } from "@/modules/contact/contact.dtos.js";
 import { ContactInfo } from "./contact-info.model.js";
 /**
  * Contact class that wraps the Zod schema and provides additional functionality

package/dist/{features → modules}/contact/contact.repository.d.ts

@@ -1,6 +1,6 @@
 import { BaseRepository } from "@/lib/api/base-repository.js";
-import { ContactInfo } from "@/models/contact-info.model.js";
-import { Contact } from "@/models/contact.model.js";
+import { ContactInfo } from "@/modules/contact/contact-info.model.js";
+import { Contact } from "@/modules/contact/contact.model.js";
 import { contract } from "./contact.api-contract.js";
 /**
  * Repository class for managing Contact data through API interactions.

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

@@ -0,0 +1,4 @@
+export * from "./contact.repository.js";
+export * from "./contact.dtos.js";
+export * from "./contact-info.model.js";
+export * from "./contact.model.js";

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

@@ -0,0 +1,2 @@
+export * from "./login.model.js";
+export * from "./login.repository.js";

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

@@ -0,0 +1 @@
+export {};

package/dist/{features/auth/identity/identity.repository.d.ts → modules/login/login.repository.d.ts}

@@ -1,4 +1,4 @@
-import { identityContract } from "./identity.api-contract.js";
+import { identityContract } from "./login.api-contract.js";
 import type { ClientInferResponseBody } from "@ts-rest/core";
 import { BaseRepository } from "@/lib/api/base-repository.js";
 type GetUserIdentityResponse = ClientInferResponseBody<typeof identityContract.getUserCredentials>;

package/dist/{features → modules}/payout/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./payout.repository.js";
 export * from "./payout.dtos.js";
 export * from "./payout-channel-handler.js";
+export * from "./payout.model.js";
+export * from "./payout.query.js";

package/dist/{features → modules}/payout/payout-channel-handler.d.ts

@@ -1,5 +1,5 @@
-import { ContactInfo, BankContactInfo } from "@/models/contact-info.model.js";
-import { Wallet } from "@/models/wallet.model.js";
+import { ContactInfo, BankContactInfo } from "@/modules/contact/contact-info.model.js";
+import { Wallet } from "@/modules/wallet/wallet.model.js";
 import { Amount, MNOId, PhoneNumber } from "@temboplus/frontend-core";
 import { PayoutChannel, PayoutInputDTO } from "./payout.dtos.js";
 /**

package/dist/{models → modules/payout}/payout.model.d.ts

@@ -1,6 +1,6 @@
-import { PayoutDTO, PayoutStatus, PayoutApprovalStatus, PayoutAuthorizer } from "@/features/payout/payout.dtos.js";
+import { PayoutDTO, PayoutStatus, PayoutApprovalStatus, PayoutAuthorizer } from "@/modules/payout/payout.dtos.js";
 import { Amount } from "@temboplus/frontend-core";
-import { ContactInfo } from "./contact-info.model.js";
+import { ContactInfo } from "../contact/contact-info.model.js";
 /**
  * Payout class that wraps the Zod schema and provides additional functionality
  */

package/dist/{features → modules}/payout/payout.repository.d.ts

@@ -1,11 +1,12 @@
-import { BaseRepository, PaginationDTO } from "@/lib/api/index.js";
-import { ContactInfo } from "@/models/contact-info.model.js";
-import { Payout } from "@/models/payout.model.js";
+import { BaseRepository } from "@/lib/api/index.js";
+import { ContactInfo } from "@/modules/contact/contact-info.model.js";
+import { Payout } from "@/modules/payout/payout.model.js";
 import { Amount } from "@temboplus/frontend-core";
 import { PayoutAPI } from "./payout.api-contract.js";
 import { PayoutChannel } from "./payout.dtos.js";
 import { PayoutQuery } from "./payout.query.js";
 import { PayoutFilters } from "./payout.dtos.js";
+import { Paged } from "@/lib/query/index.js";
 /**
  * Flexible query input type - supports the class, filters interface, URL params, etc.
  */
@@ -45,11 +46,11 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
         root?: string;
     });
     /**
-     * Get all payouts with filtering and pagination.
-     * Accepts flexible input types and normalizes them to PayoutQuery.
+     * Get paginated payouts with filtering.
+     * Always returns paginated results with metadata.
      *
      * @param query - Query parameters in any supported format
-     * @returns Promise resolving to payouts and pagination info
+     * @returns Promise resolving to paginated payouts
      *
      * @example
      * ```typescript
@@ -66,18 +67,29 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
      * const result3 = await repo.getPayouts(query);
      * ```
      */
-    getPayouts(query?: PayoutQueryInput): Promise<{
-        payouts: Payout[];
-        pagination: PaginationDTO;
-    }>;
+    getPayouts(query?: PayoutQueryInput): Promise<Paged<Payout>>;
     /**
-     * Convenience method for Next.js API routes
-     * Extracts search params directly from Request object
+     * Get all payouts without pagination.
+     * Returns a plain array of all matching results.
+     *
+     * @param query - Query parameters (pagination params will be ignored)
+     * @returns Promise resolving to array of all payouts
+     *
+     * @example
+     * ```typescript
+     * // Get all pending payouts for a dropdown
+     * const allPending = await repo.getAllPayouts({ approvalStatus: 'Pending' });
+     *
+     * // Get all payouts without any filters
+     * const allPayouts = await repo.getAllPayouts();
+     * ```
+     */
+    getAllPayouts(query?: PayoutQueryInput): Promise<Payout[]>;
+    /**
+     * Convenience method for Next.js API routes.
+     * Extracts search params directly from Request object and returns paginated results.
      */
-    getPayoutsFromRequest(req: Request): Promise<{
-        payouts: Payout[];
-        pagination: PaginationDTO;
-    }>;
+    getPayoutsFromRequest(req: Request): Promise<Paged<Payout>>;
     /**
      * Creates a new payout with the provided input data.
      *

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

@@ -0,0 +1,3 @@
+export * from "./profile.dtos.js";
+export * from "./profile.model.js";
+export * from "./profile.repository.js";

package/dist/{models → modules/profile}/profile.model.d.ts

@@ -1,4 +1,4 @@
-import { ProfileDTO } from "@/features/auth/profile/profile.dtos.js";
+import { ProfileDTO } from "./profile.dtos.js";
 /**
  * Represents a user profile in the system.
  *

package/dist/{features/auth → modules}/profile/profile.repository.d.ts

@@ -1,6 +1,6 @@
 import { BaseRepository } from "@/lib/api/base-repository.js";
 import { profileContract } from "./profile.api-contract.js";
-import { Profile } from "@/models/profile.model.js";
+import { Profile } from "./profile.model.js";
 /**
  * Repository class for managing user profile operations.
  * Handles retrieving and updating user profile information from the API.

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

@@ -0,0 +1,4 @@
+export * from "./user.repository.js";
+export * from "./user.dtos.js";
+export * from "./user.model.js";
+export * from "./role.model.js";

package/dist/{models → modules/user}/role.model.d.ts

@@ -1,4 +1,4 @@
-import { RoleDTO } from "@/features/admin/admin.dtos.js";
+import { RoleDTO } from "@/modules/user/user.dtos.js";
 export declare class Role {
     readonly id: string;
     readonly name: string;