@temboplus/tembo-dashboard 0.0.10 → 0.0.12

package/dist/modules/collection/collection.query.d.ts

@@ -0,0 +1,119 @@
+import { QueryBuilder } from "@/lib/query";
+import { COLLECTION_STATUS, COLLECTION_CHANNEL, CollectionFilters } from "./collection.types";
+/**
+ * Collection-specific query builder that extends the base QueryBuilder
+ * and handles all possible input conversions (DTOs, URL params, etc.)
+ */
+export declare class CollectionQuery extends QueryBuilder {
+    /**
+     * Create empty collection query with defaults
+     */
+    static create(): CollectionQuery;
+    /**
+     * Create from typed DTO/filters object
+     */
+    static fromFilters(filters: CollectionFilters): CollectionQuery;
+    /**
+     * Create from URL search parameters (strings)
+     */
+    static fromUrlParams(params: Record<string, string>): CollectionQuery;
+    /**
+     * Create from URLSearchParams object
+     */
+    static fromSearchParams(searchParams: URLSearchParams): CollectionQuery;
+    /**
+     * Create from Next.js Request object
+     */
+    static fromRequest(request: Request): CollectionQuery;
+    /**
+     * Create from any supported input type
+     */
+    static from(input: QueryBuilder | CollectionFilters | Record<string, string> | URLSearchParams | null | undefined): CollectionQuery;
+    /**
+     * Type guard for string records
+     */
+    private static isStringRecord;
+    whereStatus(status: COLLECTION_STATUS): this;
+    whereChannel(channel: COLLECTION_CHANNEL): this;
+    wherePending(): this;
+    whereSuccessful(): this;
+    whereFailed(): this;
+    whereAmountBetween(min: number, max: number): this;
+    whereSender(msisdn: string): this;
+    whereAccount(accountNo: string): this;
+    whereReference(reference: string): this;
+    wherePartnerReference(partnerReference: string): this;
+    whereSearch(searchTerm: string): this;
+    /**
+     * Apply all filters from CollectionFilters object
+     */
+    private applyFilters;
+    /**
+     * Convert to CollectionFilters DTO
+     */
+    toFilters(): CollectionFilters;
+    /**
+     * 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): CollectionQuery;
+    /**
+     * Create new instance with updated sorting
+     */
+    withSorting(sortBy: string, sortOrder?: "asc" | "desc"): CollectionQuery;
+    /**
+     * Create new instance with date range
+     */
+    withDateRange(startDate?: string, endDate?: string): CollectionQuery;
+    /**
+     * Create new instance with status filter
+     */
+    withStatus(status?: COLLECTION_STATUS): CollectionQuery;
+    /**
+     * Create new instance with channel filter
+     */
+    withChannel(channel?: COLLECTION_CHANNEL): CollectionQuery;
+    /**
+     * Reset to first page
+     */
+    resetPage(): CollectionQuery;
+    /**
+     * 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 channels
+     */
+    private isValidChannel;
+    /**
+     * Type guard for valid statuses
+     */
+    private isValidStatus;
+}

package/dist/modules/collection/collection.repository.d.ts

@@ -1,32 +1,26 @@
-import { BaseRepository, PaginationDTO, WalletSummaryDTO } from "@/lib/api";
+import { BaseRepository, PaginationDTO } from "@/lib/api";
 import { collectionContract } from "./collection.api-contract";
 import { Collection } from "./collection.model";
-import { CollectionQueryBuilder } from "./collection.query-builder";
-import { CollectionQueryParams } from "./collection.query-params.model";
+import { CollectionQuery } from "./collection.query";
+import { CollectionFilters } from "./collection.types";
+import { TransactionSummary, WalletInfo } from "@/lib/models";
 /**
- * Flexible query input type - supports the class, DTO, URL params, etc.
+ * Flexible query input type - supports the class, filters interface, URL params, etc.
  */
-export type CollectionQueryInput = CollectionQueryParams | Parameters<typeof CollectionQueryParams.from>[0];
+export type CollectionQueryInput = CollectionQuery | CollectionFilters | Record<string, string> | URLSearchParams | null | undefined;
 /**
  * Repository class for managing collections through API interactions.
  * Handles collection operations, filtering, and summary data retrieval.
- * Supports flexible query input types including URL search parameters and typed DTOs.
+ * Simplified to use CollectionQuery as the primary query interface.
  */
 export declare class CollectionRepository extends BaseRepository<typeof collectionContract> {
     constructor(options?: {
         token?: string;
         root?: string;
     });
-    /**
-     * Normalize query input to CollectionQueryParams class instance
-     * @param query - Any supported query input type
-     * @returns CollectionQueryParams instance
-     * @throws Error if validation fails
-     */
-    private normalizeQueryParams;
     /**
      * Get all collections with filtering and pagination.
-     * Supports flexible input types: typed DTO, URL search params, or string records.
+     * Accepts flexible input types and normalizes them to CollectionQuery.
      *
      * @param query - Query parameters in any supported format
      * @returns Promise resolving to collections and pagination info
@@ -35,16 +29,15 @@ export declare class CollectionRepository extends BaseRepository<typeof collecti
      * ```typescript
      * // From API route with URL search params
      * const { searchParams } = new URL(req.url);
-     * const stringParams = Object.fromEntries(searchParams.entries());
-     * const result = await repo.getCollections(stringParams);
+     * const result = await repo.getCollections(searchParams);
      *
      * // From client with typed params
-     * const typedParams: CollectionQueryParamsDTO = { page: 1, limit: 20, status: 'PAYMENT_ACCEPTED' };
-     * const result2 = await repo.getCollections(typedParams);
+     * const filters: CollectionFilters = { page: 1, limit: 20, status: 'PAYMENT_ACCEPTED' };
+     * const result2 = await repo.getCollections(filters);
      *
-     * // With URLSearchParams directly
-     * const urlParams = new URLSearchParams(window.location.search);
-     * const result3 = await repo.getCollections(urlParams);
+     * // With CollectionQuery instance
+     * const query = CollectionQuery.create().whereSuccessful().withPagination(1, 50);
+     * const result3 = await repo.getCollections(query);
      * ```
      */
     getCollections(query?: CollectionQueryInput): Promise<{
@@ -52,42 +45,8 @@ export declare class CollectionRepository extends BaseRepository<typeof collecti
         pagination: PaginationDTO;
     }>;
     /**
-     * Convenience method to get collections from URL search params directly.
-     * Useful in API routes where you have direct access to search params.
-     *
-     * @param searchParams - URLSearchParams from request
-     * @returns Promise resolving to collections and pagination info
-     *
-     * @example
-     * ```typescript
-     * // In API route
-     * export async function GET(req: Request) {
-     *   const { searchParams } = new URL(req.url);
-     *   const repo = new CollectionRepository({ token });
-     *   return repo.getCollectionsFromSearchParams(searchParams);
-     * }
-     * ```
-     */
-    getCollectionsFromSearchParams(searchParams: URLSearchParams): Promise<{
-        collections: Collection[];
-        pagination: PaginationDTO;
-    }>;
-    /**
-     * Convenience method to get collections from Next.js Request object.
-     * Extracts and processes search params automatically.
-     *
-     * @param req - Next.js Request object
-     * @returns Promise resolving to collections and pagination info
-     *
-     * @example
-     * ```typescript
-     * // In API route
-     * export async function GET(req: Request) {
-     *   const repo = new CollectionRepository({ token });
-     *   const result = await repo.getCollectionsFromRequest(req);
-     *   return NextResponse.json(result);
-     * }
-     * ```
+     * Convenience method for Next.js API routes
+     * Extracts search params directly from Request object
      */
     getCollectionsFromRequest(req: Request): Promise<{
         collections: Collection[];
@@ -100,50 +59,9 @@ export declare class CollectionRepository extends BaseRepository<typeof collecti
     /**
      * Get collections summary statistics
      */
-    getSummary(): Promise<{
-        yesterday: number;
-        today: number;
-        thisMonth: number;
-        lastMonth: number;
-    }>;
-    /**
-     * Get account balance and summary information
-     */
-    getBalance(): Promise<WalletSummaryDTO>;
-    /**
-     * Build a query using the fluent query builder interface
-     * Returns a query builder instance for complex filtering scenarios.
-     *
-     * @returns CollectionQueryBuilder instance for method chaining
-     *
-     * @example
-     * ```typescript
-     * const collections = await repo.query()
-     *   .whereSuccessful()
-     *   .whereAmountBetween(100, 1000)
-     *   .whereDateBetween('2024-01-01', '2024-01-31')
-     *   .orderByDesc('amount')
-     *   .paginate(1, 50)
-     *   .execute(repo);
-     * ```
-     */
-    query(): CollectionQueryBuilderWithExecute;
-}
-/**
- * Extended query builder that includes execute method for direct repository integration
- */
-declare class CollectionQueryBuilderWithExecute extends CollectionQueryBuilder {
-    private builder;
-    private repository;
-    constructor(builder: CollectionQueryBuilder, repository: CollectionRepository);
+    getCollectionStats(): Promise<TransactionSummary>;
     /**
-     * Execute the query and return results
-     *
-     * @returns Promise resolving to collections and pagination info
+     * Get wallet information
      */
-    execute(): Promise<{
-        collections: Collection[];
-        pagination: PaginationDTO;
-    }>;
+    getWalletInfo(): Promise<WalletInfo>;
 }
-export {};

package/dist/modules/collection/{collection.dtos.d.ts → collection.types.d.ts}

@@ -81,7 +81,7 @@ export declare const CollectionDTOSchemas: {
         notes?: string | undefined;
         currencyCode?: string | undefined;
     }>;
-    collectionQueryParams: z.ZodObject<{
+    collectionFilters: z.ZodObject<{
         page: z.ZodDefault<z.ZodNumber>;
         limit: z.ZodDefault<z.ZodNumber>;
         sortBy: z.ZodDefault<z.ZodString>;
@@ -185,47 +185,9 @@ export declare const CollectionDTOSchemas: {
         minAmount?: string | undefined;
         maxAmount?: string | undefined;
     }>;
-    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;
-    }>;
     paymentStatus: z.ZodNativeEnum<typeof COLLECTION_STATUS>;
     paymentChannel: z.ZodNativeEnum<typeof COLLECTION_CHANNEL>;
-    walletSummary: z.ZodObject<{
-        balance: z.ZodNumber;
-        availableBalance: z.ZodNumber;
-        accountNumber: z.ZodString;
-        accountName: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        balance: number;
-        availableBalance: number;
-        accountNumber: string;
-        accountName: string;
-    }, {
-        balance: number;
-        availableBalance: number;
-        accountNumber: string;
-        accountName: string;
-    }>;
 };
 export type CollectionDTO = z.infer<typeof CollectionDTOSchemas.collection>;
-export type CollectionQueryParamsDTO = z.infer<typeof CollectionDTOSchemas.collectionQueryParams>;
-export type CollectionURLQueryParamsDTO = z.infer<typeof CollectionDTOSchemas.collectionURLQueryParams>;
+export type CollectionFilters = z.infer<typeof CollectionDTOSchemas.collectionFilters>;
+export type CollectionURLQueryParams = z.infer<typeof CollectionDTOSchemas.collectionURLQueryParams>;

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

@@ -1,7 +1,5 @@
 export * from "./collection.api-contract";
-export * from "./collection.dtos";
-export * from "./collection.model";
-export * from "./collection.query-builder";
 export * from "./collection.repository";
-export * from "./collection.utils";
-export * from "./collection.query-params.model";
+export * from "./collection.model";
+export * from "./collection.types";
+export * from "./collection.query";

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

@@ -1,5 +1,5 @@
 export * from "./payout.api-contract";
-export * from "./payout.dtos";
-export * from "./payout.model";
-export * from "./payout.query-builder";
 export * from "./payout.repository";
+export * from "./payout.types";
+export * from "./payout.model";
+export * from "./payout.query";

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

@@ -2,8 +2,8 @@ import { z } from "zod";
 export declare const payoutContract: {
     getPayouts: {
         query: z.ZodObject<{
-            page: z.ZodDefault<z.ZodNumber>;
-            limit: z.ZodDefault<z.ZodNumber>;
+            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>;
@@ -11,40 +11,40 @@ export declare const payoutContract: {
             msisdn: z.ZodOptional<z.ZodString>;
             id: z.ZodOptional<z.ZodString>;
             ref: z.ZodOptional<z.ZodString>;
-            channel: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<typeof import("./payout.dtos").MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof import("./payout.dtos").BANK_PAYOUT_CHANNEL>]>>;
-            status: z.ZodOptional<z.ZodNativeEnum<typeof import("./payout.dtos").PAYOUT_STATUS>>;
-            minAmount: z.ZodOptional<z.ZodNumber>;
-            maxAmount: z.ZodOptional<z.ZodNumber>;
+            channel: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL, string>>;
+            status: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, import("./payout.types").PAYOUT_STATUS, 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, {
-            page: number;
-            limit: number;
             sortBy: string;
             sortOrder: "asc" | "desc";
-            status?: import("./payout.dtos").PAYOUT_STATUS | undefined;
+            status?: import("./payout.types").PAYOUT_STATUS | undefined;
             startDate?: string | undefined;
             endDate?: string | undefined;
+            page?: number | undefined;
+            limit?: number | undefined;
             search?: string | undefined;
             id?: string | undefined;
             msisdn?: string | undefined;
-            channel?: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL | undefined;
+            channel?: import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL | undefined;
             minAmount?: number | undefined;
             maxAmount?: number | undefined;
             ref?: string | undefined;
         }, {
-            status?: import("./payout.dtos").PAYOUT_STATUS | undefined;
+            status?: string | undefined;
             startDate?: string | undefined;
             endDate?: string | undefined;
-            page?: number | undefined;
-            limit?: number | undefined;
+            page?: string | undefined;
+            limit?: string | undefined;
             search?: string | undefined;
             id?: string | undefined;
             msisdn?: string | undefined;
-            channel?: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL | undefined;
+            channel?: string | undefined;
             sortBy?: string | undefined;
             sortOrder?: "asc" | "desc" | undefined;
-            minAmount?: number | undefined;
-            maxAmount?: number | undefined;
+            minAmount?: string | undefined;
+            maxAmount?: string | undefined;
             ref?: string | undefined;
         }>;
         summary: "List payouts";
@@ -56,10 +56,10 @@ export declare const payoutContract: {
                 results: z.ZodArray<z.ZodObject<{
                     id: z.ZodString;
                     statusCode: z.ZodString;
-                    statusCodeText: z.ZodNativeEnum<typeof import("./payout.dtos").PAYOUT_STATUS>;
+                    statusCodeText: z.ZodNativeEnum<typeof import("./payout.types").PAYOUT_STATUS>;
                     statusDescription: z.ZodString;
                     countryCode: z.ZodString;
-                    serviceCode: z.ZodUnion<[z.ZodNativeEnum<typeof import("./payout.dtos").MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof import("./payout.dtos").BANK_PAYOUT_CHANNEL>]>;
+                    serviceCode: z.ZodUnion<[z.ZodNativeEnum<typeof import("./payout.types").MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof import("./payout.types").BANK_PAYOUT_CHANNEL>]>;
                     amount: z.ZodNumber;
                     serviceFee: z.ZodOptional<z.ZodString>;
                     postedAmount: z.ZodOptional<z.ZodString>;
@@ -92,10 +92,10 @@ export declare const payoutContract: {
                     amount: number;
                     transactionId: string;
                     currencyCode: string;
-                    statusCodeText: import("./payout.dtos").PAYOUT_STATUS;
+                    statusCodeText: import("./payout.types").PAYOUT_STATUS;
                     statusDescription: string;
                     countryCode: string;
-                    serviceCode: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL;
+                    serviceCode: import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL;
                     transactionRef: string;
                     walletId?: string | undefined;
                     serviceFee?: string | undefined;
@@ -121,10 +121,10 @@ export declare const payoutContract: {
                     amount: number;
                     transactionId: string;
                     currencyCode: string;
-                    statusCodeText: import("./payout.dtos").PAYOUT_STATUS;
+                    statusCodeText: import("./payout.types").PAYOUT_STATUS;
                     statusDescription: string;
                     countryCode: string;
-                    serviceCode: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL;
+                    serviceCode: import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL;
                     transactionRef: string;
                     walletId?: string | undefined;
                     serviceFee?: string | undefined;
@@ -154,10 +154,10 @@ export declare const payoutContract: {
                     amount: number;
                     transactionId: string;
                     currencyCode: string;
-                    statusCodeText: import("./payout.dtos").PAYOUT_STATUS;
+                    statusCodeText: import("./payout.types").PAYOUT_STATUS;
                     statusDescription: string;
                     countryCode: string;
-                    serviceCode: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL;
+                    serviceCode: import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL;
                     transactionRef: string;
                     walletId?: string | undefined;
                     serviceFee?: string | undefined;
@@ -186,10 +186,10 @@ export declare const payoutContract: {
                     amount: number;
                     transactionId: string;
                     currencyCode: string;
-                    statusCodeText: import("./payout.dtos").PAYOUT_STATUS;
+                    statusCodeText: import("./payout.types").PAYOUT_STATUS;
                     statusDescription: string;
                     countryCode: string;
-                    serviceCode: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL;
+                    serviceCode: import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL;
                     transactionRef: string;
                     walletId?: string | undefined;
                     serviceFee?: string | undefined;
@@ -239,10 +239,10 @@ export declare const payoutContract: {
             200: z.ZodObject<{
                 id: z.ZodString;
                 statusCode: z.ZodString;
-                statusCodeText: z.ZodNativeEnum<typeof import("./payout.dtos").PAYOUT_STATUS>;
+                statusCodeText: z.ZodNativeEnum<typeof import("./payout.types").PAYOUT_STATUS>;
                 statusDescription: z.ZodString;
                 countryCode: z.ZodString;
-                serviceCode: z.ZodUnion<[z.ZodNativeEnum<typeof import("./payout.dtos").MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof import("./payout.dtos").BANK_PAYOUT_CHANNEL>]>;
+                serviceCode: z.ZodUnion<[z.ZodNativeEnum<typeof import("./payout.types").MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof import("./payout.types").BANK_PAYOUT_CHANNEL>]>;
                 amount: z.ZodNumber;
                 serviceFee: z.ZodOptional<z.ZodString>;
                 postedAmount: z.ZodOptional<z.ZodString>;
@@ -275,10 +275,10 @@ export declare const payoutContract: {
                 amount: number;
                 transactionId: string;
                 currencyCode: string;
-                statusCodeText: import("./payout.dtos").PAYOUT_STATUS;
+                statusCodeText: import("./payout.types").PAYOUT_STATUS;
                 statusDescription: string;
                 countryCode: string;
-                serviceCode: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL;
+                serviceCode: import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL;
                 transactionRef: string;
                 walletId?: string | undefined;
                 serviceFee?: string | undefined;
@@ -304,10 +304,10 @@ export declare const payoutContract: {
                 amount: number;
                 transactionId: string;
                 currencyCode: string;
-                statusCodeText: import("./payout.dtos").PAYOUT_STATUS;
+                statusCodeText: import("./payout.types").PAYOUT_STATUS;
                 statusDescription: string;
                 countryCode: string;
-                serviceCode: import("./payout.dtos").MOBILE_PAYOUT_CHANNEL | import("./payout.dtos").BANK_PAYOUT_CHANNEL;
+                serviceCode: import("./payout.types").MOBILE_PAYOUT_CHANNEL | import("./payout.types").BANK_PAYOUT_CHANNEL;
                 transactionRef: string;
                 walletId?: string | undefined;
                 serviceFee?: string | undefined;
@@ -385,7 +385,7 @@ export declare const payoutContract: {
             }>;
         };
     };
-    getBalance: {
+    getWalletInfo: {
         summary: "Get account balance";
         description: "Retrieve current account balance and status information";
         method: "GET";

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

@@ -1,5 +1,5 @@
 import { Amount, AmountJson, Bank } from "@temboplus/frontend-core";
-import { BANK_PAYOUT_CHANNEL, MOBILE_PAYOUT_CHANNEL, PAYOUT_CHANNEL, PAYOUT_STATUS } from "./payout.dtos";
+import { BANK_PAYOUT_CHANNEL, MOBILE_PAYOUT_CHANNEL, PAYOUT_CHANNEL, PAYOUT_STATUS } from "./payout.types";
 export interface PayoutStatusInfo {
     label: string;
     description: string;

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

@@ -0,0 +1,119 @@
+import { QueryBuilder } from "@/lib/query";
+import { PAYOUT_STATUS, PAYOUT_CHANNEL, PayoutFilters } from "./payout.types";
+/**
+ * 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: PAYOUT_STATUS): this;
+    whereChannel(channel: PAYOUT_CHANNEL): this;
+    wherePending(): this;
+    whereSuccessful(): this;
+    whereFailed(): this;
+    whereAmountBetween(min: number, max: number): this;
+    whereRecipient(msisdn: string): this;
+    whereReference(ref: string): this;
+    whereMobile(): this;
+    whereBank(): 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?: PAYOUT_STATUS): PayoutQuery;
+    /**
+     * Create new instance with channel filter
+     */
+    withChannel(channel?: PAYOUT_CHANNEL): 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 channels
+     */
+    private isValidChannel;
+    /**
+     * Type guard for valid statuses
+     */
+    private isValidStatus;
+}