@temboplus/afloat 0.1.73 → 0.1.75-0

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

@@ -11,16 +11,16 @@ export declare const contract: {
             currencyCode: z.ZodOptional<z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>>;
         }, "strip", z.ZodTypeAny, {
             id?: string | undefined;
-            profileId?: string | undefined;
             accountNo?: string | undefined;
+            profileId?: string | undefined;
             channel?: string | undefined;
             countryCode?: string | undefined;
             currencyCode?: string | undefined;
             accountName?: string | undefined;
         }, {
             id?: string | undefined;
-            profileId?: string | undefined;
             accountNo?: string | undefined;
+            profileId?: string | undefined;
             channel?: string | undefined;
             countryCode?: string | undefined;
             currencyCode?: string | undefined;
@@ -41,20 +41,20 @@ export declare const contract: {
                 updatedAt: z.ZodString;
             }, "strip", z.ZodTypeAny, {
                 id: string;
-                profileId: string;
+                accountNo: string;
                 createdAt: string;
+                profileId: string;
                 updatedAt: string;
-                accountNo: string;
                 channel: string;
                 countryCode: import("@temboplus/frontend-core").ISO2CountryCode;
                 currencyCode: import("@temboplus/frontend-core").CurrencyCode;
                 accountName: string;
             }, {
                 id: string;
-                profileId: string;
+                accountNo: string;
                 createdAt: string;
+                profileId: string;
                 updatedAt: string;
-                accountNo: string;
                 channel: string;
                 accountName: string;
                 countryCode?: string | undefined;
@@ -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";

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

@@ -16,20 +16,20 @@ declare const walletSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    profileId: string;
+    accountNo: string;
     createdAt: string;
+    profileId: string;
     updatedAt: string;
-    accountNo: string;
     channel: string;
     countryCode: import("@temboplus/frontend-core").ISO2CountryCode;
     currencyCode: import("@temboplus/frontend-core").CurrencyCode;
     accountName: string;
 }, {
     id: string;
-    profileId: string;
+    accountNo: string;
     createdAt: string;
+    profileId: string;
     updatedAt: string;
-    accountNo: string;
     channel: string;
     accountName: string;
     countryCode?: string | undefined;
@@ -50,16 +50,16 @@ declare const walletQuerySchema: z.ZodObject<{
     currencyCode: z.ZodOptional<z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>>;
 }, "strip", z.ZodTypeAny, {
     id?: string | undefined;
-    profileId?: string | undefined;
     accountNo?: string | undefined;
+    profileId?: string | undefined;
     channel?: string | undefined;
     countryCode?: string | undefined;
     currencyCode?: string | undefined;
     accountName?: string | undefined;
 }, {
     id?: string | undefined;
-    profileId?: string | undefined;
     accountNo?: string | undefined;
+    profileId?: string | undefined;
     channel?: string | undefined;
     countryCode?: string | undefined;
     currencyCode?: string | undefined;
@@ -119,20 +119,20 @@ export declare const WalletDTOSchemas: {
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        profileId: string;
+        accountNo: string;
         createdAt: string;
+        profileId: string;
         updatedAt: string;
-        accountNo: string;
         channel: string;
         countryCode: import("@temboplus/frontend-core").ISO2CountryCode;
         currencyCode: import("@temboplus/frontend-core").CurrencyCode;
         accountName: string;
     }, {
         id: string;
-        profileId: string;
+        accountNo: string;
         createdAt: string;
+        profileId: string;
         updatedAt: string;
-        accountNo: string;
         channel: string;
         accountName: string;
         countryCode?: string | undefined;
@@ -148,16 +148,16 @@ export declare const WalletDTOSchemas: {
         currencyCode: z.ZodOptional<z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>>;
     }, "strip", z.ZodTypeAny, {
         id?: string | undefined;
-        profileId?: string | undefined;
         accountNo?: string | undefined;
+        profileId?: string | undefined;
         channel?: string | undefined;
         countryCode?: string | undefined;
         currencyCode?: string | undefined;
         accountName?: string | undefined;
     }, {
         id?: string | undefined;
-        profileId?: string | undefined;
         accountNo?: string | undefined;
+        profileId?: string | undefined;
         channel?: string | undefined;
         countryCode?: string | undefined;
         currencyCode?: string | undefined;