@temboplus/afloat 0.1.73 → 0.1.74-0

package/dist/features/contact/contact.api-contract.d.ts

@@ -29,7 +29,6 @@ export declare const contract: {
         }>;
         path: "/";
         responses: {
-            [x: number]: import("@ts-rest/core").AppRouteResponse;
             201: z.ZodObject<{
                 id: z.ZodString;
                 profileId: z.ZodString;
@@ -81,7 +80,6 @@ export declare const contract: {
         }>;
         path: "/:id";
         responses: {
-            [x: number]: import("@ts-rest/core").AppRouteResponse;
             200: z.ZodObject<{
                 id: z.ZodString;
                 profileId: z.ZodString;
@@ -124,7 +122,6 @@ export declare const contract: {
         method: "GET";
         path: "/";
         responses: {
-            [x: number]: import("@ts-rest/core").AppRouteResponse;
             200: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 profileId: z.ZodString;
@@ -160,7 +157,6 @@ export declare const contract: {
         method: "GET";
         path: "/:id";
         responses: {
-            [x: number]: import("@ts-rest/core").AppRouteResponse;
             200: z.ZodObject<{
                 id: z.ZodString;
                 profileId: z.ZodString;
@@ -197,7 +193,6 @@ export declare const contract: {
         body: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         path: "/:id";
         responses: {
-            [x: number]: import("@ts-rest/core").AppRouteResponse;
             200: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         };
     };

package/dist/features/payout/payout.api-contract.d.ts

@@ -14,28 +14,7 @@ export declare const DEFAULT_ORDER_BY_DESC = "createdAt";
  */
 export declare const contract: {
     getPayouts: {
-        query: z.ZodObject<{
-            rangeStart: z.ZodNumber;
-            rangeEnd: z.ZodNumber;
-            eager: z.ZodString;
-            approvalStatus: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof import("./payout.dtos.js").PayoutApprovalStatus>>>;
-            orderByDesc: z.ZodString;
-            msisdn: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            eager: string;
-            orderByDesc: string;
-            rangeStart: number;
-            rangeEnd: number;
-            msisdn?: string | undefined;
-            approvalStatus?: import("./payout.dtos.js").PayoutApprovalStatus | null | undefined;
-        }, {
-            eager: string;
-            orderByDesc: string;
-            rangeStart: number;
-            rangeEnd: number;
-            msisdn?: string | undefined;
-            approvalStatus?: import("./payout.dtos.js").PayoutApprovalStatus | null | undefined;
-        }>;
+        query: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         method: "GET";
         path: "";
         responses: {
@@ -144,6 +123,7 @@ export declare const contract: {
                 }>, "many">;
                 total: z.ZodNumber;
             }, "strip", z.ZodTypeAny, {
+                total: number;
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -173,8 +153,8 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
-                total: number;
             }, {
+                total: number;
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -204,7 +184,6 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
-                total: number;
             }>;
         };
     };
@@ -336,6 +315,7 @@ export declare const contract: {
                 }>, "many">;
                 total: z.ZodNumber;
             }, "strip", z.ZodTypeAny, {
+                total: number;
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -365,8 +345,8 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
-                total: number;
             }, {
+                total: number;
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -396,7 +376,6 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
-                total: number;
             }>;
         };
     };

package/dist/features/payout/payout.dtos.d.ts

@@ -197,6 +197,122 @@ declare const PayoutDTOSchema: z.ZodObject<{
         identity: string;
     } | null | undefined;
 }>;
+/**
+ * Lightweight filters interface for payout queries
+ */
+declare const PayoutFiltersSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    sortBy: z.ZodDefault<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+    startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    endDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    payeeName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    msisdn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    profileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    partnerReference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof PayoutStatus>>>;
+    approvalStatus: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof PayoutApprovalStatus>>>;
+    minAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    maxAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+    sortBy: string;
+    sortOrder: "asc" | "desc";
+    status?: PayoutStatus | null | undefined;
+    id?: string | null | undefined;
+    profileId?: string | null | undefined;
+    channel?: string | null | undefined;
+    msisdn?: string | null | undefined;
+    payeeName?: string | null | undefined;
+    partnerReference?: string | null | undefined;
+    approvalStatus?: PayoutApprovalStatus | null | undefined;
+    startDate?: string | null | undefined;
+    endDate?: string | null | undefined;
+    minAmount?: number | null | undefined;
+    maxAmount?: number | null | undefined;
+    search?: string | null | undefined;
+}, {
+    status?: PayoutStatus | null | undefined;
+    id?: string | null | undefined;
+    profileId?: string | null | undefined;
+    channel?: string | null | undefined;
+    msisdn?: string | null | undefined;
+    payeeName?: string | null | undefined;
+    partnerReference?: string | null | undefined;
+    approvalStatus?: PayoutApprovalStatus | null | undefined;
+    page?: number | undefined;
+    limit?: number | undefined;
+    sortBy?: string | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+    startDate?: string | null | undefined;
+    endDate?: string | null | undefined;
+    minAmount?: number | null | undefined;
+    maxAmount?: number | null | undefined;
+    search?: string | null | undefined;
+}>;
+/**
+ * URL-safe schema for query parameters (all strings)
+ */
+declare const PayoutURLQueryParamsSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+    limit: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+    sortBy: z.ZodDefault<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    payeeName: z.ZodOptional<z.ZodString>;
+    msisdn: z.ZodOptional<z.ZodString>;
+    profileId: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    partnerReference: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, PayoutStatus, string>>;
+    approvalStatus: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, PayoutApprovalStatus, string>>;
+    minAmount: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+    maxAmount: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+    search: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sortBy: string;
+    sortOrder: "asc" | "desc";
+    status?: PayoutStatus | undefined;
+    id?: string | undefined;
+    profileId?: string | undefined;
+    channel?: string | undefined;
+    msisdn?: string | undefined;
+    payeeName?: string | undefined;
+    partnerReference?: string | undefined;
+    approvalStatus?: PayoutApprovalStatus | undefined;
+    page?: number | undefined;
+    limit?: number | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    minAmount?: number | undefined;
+    maxAmount?: number | undefined;
+    search?: string | undefined;
+}, {
+    status?: string | undefined;
+    id?: string | undefined;
+    profileId?: string | undefined;
+    channel?: string | undefined;
+    msisdn?: string | undefined;
+    payeeName?: string | undefined;
+    partnerReference?: string | undefined;
+    approvalStatus?: string | undefined;
+    page?: string | undefined;
+    limit?: string | undefined;
+    sortBy?: string | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    minAmount?: string | undefined;
+    maxAmount?: string | undefined;
+    search?: string | undefined;
+}>;
 /**
  * Type definition inferred from AuthorizerSchema
  * Represents the structure of a user who actions the payout
@@ -212,6 +328,14 @@ type PayoutInputDTO = z.infer<typeof PayoutInputDTOSchema>;
  * Represents the complete payout record structure
  */
 type PayoutDTO = z.infer<typeof PayoutDTOSchema>;
+/**
+ * Type definition for payout filters
+ */
+type PayoutFilters = z.infer<typeof PayoutFiltersSchema>;
+/**
+ * Type definition for URL query parameters
+ */
+type PayoutURLQueryParams = z.infer<typeof PayoutURLQueryParamsSchema>;
 /**
  * Export object containing all payout-related schemas
  * Used for validation and type checking throughout the application
@@ -357,9 +481,119 @@ export declare const PayoutDTOSchemas: {
         id: string;
         identity: string;
     }>;
+    readonly PayoutFilters: z.ZodObject<{
+        page: z.ZodDefault<z.ZodNumber>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        sortBy: z.ZodDefault<z.ZodString>;
+        sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+        startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        endDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payeeName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        msisdn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        profileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        partnerReference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof PayoutStatus>>>;
+        approvalStatus: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof PayoutApprovalStatus>>>;
+        minAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        limit: number;
+        sortBy: string;
+        sortOrder: "asc" | "desc";
+        status?: PayoutStatus | null | undefined;
+        id?: string | null | undefined;
+        profileId?: string | null | undefined;
+        channel?: string | null | undefined;
+        msisdn?: string | null | undefined;
+        payeeName?: string | null | undefined;
+        partnerReference?: string | null | undefined;
+        approvalStatus?: PayoutApprovalStatus | null | undefined;
+        startDate?: string | null | undefined;
+        endDate?: string | null | undefined;
+        minAmount?: number | null | undefined;
+        maxAmount?: number | null | undefined;
+        search?: string | null | undefined;
+    }, {
+        status?: PayoutStatus | null | undefined;
+        id?: string | null | undefined;
+        profileId?: string | null | undefined;
+        channel?: string | null | undefined;
+        msisdn?: string | null | undefined;
+        payeeName?: string | null | undefined;
+        partnerReference?: string | null | undefined;
+        approvalStatus?: PayoutApprovalStatus | null | undefined;
+        page?: number | undefined;
+        limit?: number | undefined;
+        sortBy?: string | undefined;
+        sortOrder?: "asc" | "desc" | undefined;
+        startDate?: string | null | undefined;
+        endDate?: string | null | undefined;
+        minAmount?: number | null | undefined;
+        maxAmount?: number | null | undefined;
+        search?: string | null | undefined;
+    }>;
+    readonly PayoutURLQueryParams: z.ZodObject<{
+        page: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+        limit: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+        sortBy: z.ZodDefault<z.ZodString>;
+        sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        payeeName: z.ZodOptional<z.ZodString>;
+        msisdn: z.ZodOptional<z.ZodString>;
+        profileId: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        partnerReference: z.ZodOptional<z.ZodString>;
+        channel: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, PayoutStatus, string>>;
+        approvalStatus: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, PayoutApprovalStatus, string>>;
+        minAmount: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+        maxAmount: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
+        search: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        sortBy: string;
+        sortOrder: "asc" | "desc";
+        status?: PayoutStatus | undefined;
+        id?: string | undefined;
+        profileId?: string | undefined;
+        channel?: string | undefined;
+        msisdn?: string | undefined;
+        payeeName?: string | undefined;
+        partnerReference?: string | undefined;
+        approvalStatus?: PayoutApprovalStatus | undefined;
+        page?: number | undefined;
+        limit?: number | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        minAmount?: number | undefined;
+        maxAmount?: number | undefined;
+        search?: string | undefined;
+    }, {
+        status?: string | undefined;
+        id?: string | undefined;
+        profileId?: string | undefined;
+        channel?: string | undefined;
+        msisdn?: string | undefined;
+        payeeName?: string | undefined;
+        partnerReference?: string | undefined;
+        approvalStatus?: string | undefined;
+        page?: string | undefined;
+        limit?: string | undefined;
+        sortBy?: string | undefined;
+        sortOrder?: "asc" | "desc" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        minAmount?: string | undefined;
+        maxAmount?: string | undefined;
+        search?: string | undefined;
+    }>;
 };
 /**
  * Export types for use in other parts of the application
  * These types can be used for type checking and documentation
  */
-export type { PayoutAuthorizerDTO as PayoutAuthorizer, PayoutDTO, PayoutInputDTO };
+export type { PayoutAuthorizerDTO as PayoutAuthorizer, PayoutDTO, PayoutInputDTO, PayoutFilters, PayoutURLQueryParams, };

package/dist/features/payout/payout.query.d.ts

@@ -0,0 +1,126 @@
+import { QueryBuilder } from "@/lib/query/index.js";
+import { PayoutStatus, PayoutApprovalStatus, PayoutFilters } from "./payout.dtos.js";
+/**
+ * Payout-specific query builder that extends the base QueryBuilder
+ * and handles all possible input conversions (DTOs, URL params, etc.)
+ */
+export declare class PayoutQuery extends QueryBuilder {
+    /**
+     * Create empty payout query with defaults
+     */
+    static create(): PayoutQuery;
+    /**
+     * Create from typed DTO/filters object
+     */
+    static fromFilters(filters: PayoutFilters): PayoutQuery;
+    /**
+     * Create from URL search parameters (strings)
+     */
+    static fromUrlParams(params: Record<string, string>): PayoutQuery;
+    /**
+     * Create from URLSearchParams object
+     */
+    static fromSearchParams(searchParams: URLSearchParams): PayoutQuery;
+    /**
+     * Create from Next.js Request object
+     */
+    static fromRequest(request: Request): PayoutQuery;
+    /**
+     * Create from any supported input type
+     */
+    static from(input: QueryBuilder | PayoutFilters | Record<string, string> | URLSearchParams | null | undefined): PayoutQuery;
+    /**
+     * Type guard for string records
+     */
+    private static isStringRecord;
+    whereStatus(status: PayoutStatus): this;
+    whereApprovalStatus(approvalStatus: PayoutApprovalStatus): this;
+    whereChannel(channel: string): this;
+    wherePending(): this;
+    whereApproved(): this;
+    whereRejected(): this;
+    wherePaid(): this;
+    whereFailed(): this;
+    whereAmountBetween(min: number, max: number): this;
+    wherePayee(payeeName: string): this;
+    whereMsisdn(msisdn: string): this;
+    whereProfileId(profileId: string): this;
+    wherePartnerReference(partnerReference: string): this;
+    whereSearch(searchTerm: string): this;
+    /**
+     * Apply all filters from PayoutFilters object
+     */
+    private applyFilters;
+    /**
+     * Convert to PayoutFilters DTO
+     */
+    toFilters(): PayoutFilters;
+    /**
+     * Convert to URL-safe string parameters
+     */
+    toUrlParams(): Record<string, string>;
+    /**
+     * Convert to URLSearchParams
+     */
+    toSearchParams(): URLSearchParams;
+    /**
+     * Convert to query string
+     */
+    toQueryString(): string;
+    /**
+     * Create new instance with updated pagination
+     */
+    withPagination(page: number, limit?: number): PayoutQuery;
+    /**
+     * Create new instance with updated sorting
+     */
+    withSorting(sortBy: string, sortOrder?: "asc" | "desc"): PayoutQuery;
+    /**
+     * Create new instance with date range
+     */
+    withDateRange(startDate?: string, endDate?: string): PayoutQuery;
+    /**
+     * Create new instance with status filter
+     */
+    withStatus(status?: PayoutStatus): PayoutQuery;
+    /**
+     * Create new instance with approval status filter
+     */
+    withApprovalStatus(approvalStatus?: PayoutApprovalStatus): PayoutQuery;
+    /**
+     * Create new instance with channel filter
+     */
+    withChannel(channel?: string): PayoutQuery;
+    /**
+     * Reset to first page
+     */
+    resetPage(): PayoutQuery;
+    /**
+     * Check if any filters are applied
+     */
+    hasFilters(): boolean;
+    /**
+     * Get human-readable filter descriptions
+     */
+    getActiveFilters(): string[];
+    /**
+     * Extract filter values from QueryBuilder options
+     */
+    private extractFilterValues;
+    /**
+     * Extract primary sort field
+     */
+    private extractSortField;
+    /**
+     * Extract primary sort order
+     */
+    private extractSortOrder;
+    /**
+     * Type guard for valid statuses
+     */
+    private isValidStatus;
+    /**
+     * Type guard for valid approval statuses
+     */
+    private isValidApprovalStatus;
+}

package/dist/features/payout/payout.repository.d.ts

@@ -1,39 +1,15 @@
-import { BaseRepository } from "@/lib/api/base-repository.js";
+import { BaseRepository, PaginationDTO } from "@/lib/api/index.js";
 import { ContactInfo } from "@/models/contact-info.model.js";
 import { Payout } from "@/models/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";
 /**
- * Arguments for retrieving payouts from the API.
- *
- * @interface GetPayoutsAPIArgs
- *
- * @property {number} [rangeStart] - The starting index for pagination. Defaults to 0.
- * @property {number} [rangeEnd] - The ending index for pagination. Defaults to 10.
- * @property {boolean} [pending] - Filter for pending payouts only. If true, returns only pending payouts.
- * @property {string} [msisdn] - Filter for msisdn. Should be properly formatted. {country_code}{compact_number} for phone numbers and {SWIFT_CODE}:{account_no}
- *
- * @example
- * ```typescript
- * // Get first 10 payouts
- * const args: GetPayoutsAPIArgs = {
- *   rangeStart: 0,
- *   rangeEnd: 10
- * };
- *
- * // Get only pending payouts
- * const pendingArgs: GetPayoutsAPIArgs = {
- *   pending: true
- * };
- * ```
+ * Flexible query input type - supports the class, filters interface, URL params, etc.
  */
-export interface GetPayoutsAPIArgs {
-    rangeStart?: number;
-    rangeEnd?: number;
-    pending?: boolean;
-    msisdn?: string;
-}
+export type PayoutQueryInput = PayoutQuery | PayoutFilters | Record<string, string> | URLSearchParams | null | undefined;
 /**
  * Repository class for managing payout operations including creation, approval,
  * rejection, and retrieval of payouts.
@@ -46,7 +22,7 @@ export interface GetPayoutsAPIArgs {
  * @example
  * ```typescript
  * const repo = new PayoutRepository({ token: userToken });
- * const payouts = await repo.getAll();
+ * const payouts = await repo.getPayouts();
  * ```
  */
 export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
@@ -69,31 +45,38 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
         root?: string;
     });
     /**
-     * Retrieves a paginated list of payouts with optional filtering for pending status.
+     * Get all payouts with filtering and pagination.
+     * Accepts flexible input types and normalizes them to PayoutQuery.
      *
-     * @param args - Optional arguments for filtering and pagination
-     * @param args.rangeStart - Starting index for pagination (default: 0)
-     * @param args.rangeEnd - Ending index for pagination (default: 10)
-     * @param args.pending - Filter for pending payouts only
-     * @param args.msisdn - Filter by MSISDN
-     * @returns Promise that resolves to paginated payout results and total count
-     * @throws {APIError} If range is invalid or if the fetch operation fails
+     * @param query - Query parameters in any supported format
+     * @returns Promise resolving to payouts and pagination info
      *
      * @example
      * ```typescript
-     * // Get first 20 payouts
-     * const result = await repo.getAll({
-     *   rangeStart: 0,
-     *   rangeEnd: 20
-     * });
+     * // From API route with URL search params
+     * const { searchParams } = new URL(req.url);
+     * const result = await repo.getPayouts(searchParams);
      *
-     * // Get only pending payouts
-     * const pendingResult = await repo.getAll({ pending: true });
+     * // From client with typed params
+     * const filters: PayoutFilters = { page: 1, limit: 20, approvalStatus: 'Pending' };
+     * const result2 = await repo.getPayouts(filters);
+     *
+     * // With PayoutQuery instance
+     * const query = PayoutQuery.create().wherePending().withPagination(1, 50);
+     * const result3 = await repo.getPayouts(query);
      * ```
      */
-    getAll(args?: GetPayoutsAPIArgs): Promise<{
-        results: Payout[];
-        total: number;
+    getPayouts(query?: PayoutQueryInput): Promise<{
+        payouts: Payout[];
+        pagination: PaginationDTO;
+    }>;
+    /**
+     * Convenience method for Next.js API routes
+     * Extracts search params directly from Request object
+     */
+    getPayoutsFromRequest(req: Request): Promise<{
+        payouts: Payout[];
+        pagination: PaginationDTO;
     }>;
     /**
      * Creates a new payout with the provided input data.
@@ -109,7 +92,7 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
      * @example
      * ```typescript
      * const payout = await repo.pay({
-     *   channel: PayoutChannel.MOBILE_MONEY,
+     *   channel: PayoutChannel.MOBILE,
      *   receiver: { name: "John Doe", phone: "+255123456789" },
      *   amount: Amount.from(10000, "TZS"),
      *   notes: "Payment for services"
@@ -174,4 +157,13 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
      * ```
      */
     getByID(id: string): Promise<Payout>;
+    /**
+     * Get count of payouts matching a query
+     * Uses the same query syntax as getPayouts but only returns the count
+     */
+    count(query?: PayoutQueryInput): Promise<number>;
+    /**
+     * Check if any payouts exist matching a query
+     */
+    exists(query?: PayoutQueryInput): Promise<boolean>;
 }

package/dist/features/wallet/wallet.contract.d.ts

@@ -90,12 +90,12 @@ export declare const contract: {
             startDate: z.ZodDate;
             accountNo: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            endDate: Date;
             startDate: Date;
+            endDate: Date;
             accountNo?: string | undefined;
         }, {
-            endDate: Date;
             startDate: Date;
+            endDate: Date;
             accountNo?: string | undefined;
         }>;
         path: "/statement";