@temboplus/afloat 0.1.74-0 → 0.1.74

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

@@ -29,6 +29,7 @@ export declare const contract: {
         }>;
         path: "/";
         responses: {
+            [x: number]: import("@ts-rest/core").AppRouteResponse;
             201: z.ZodObject<{
                 id: z.ZodString;
                 profileId: z.ZodString;
@@ -80,6 +81,7 @@ export declare const contract: {
         }>;
         path: "/:id";
         responses: {
+            [x: number]: import("@ts-rest/core").AppRouteResponse;
             200: z.ZodObject<{
                 id: z.ZodString;
                 profileId: z.ZodString;
@@ -122,6 +124,7 @@ 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;
@@ -157,6 +160,7 @@ 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;
@@ -193,6 +197,7 @@ 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,7 +14,28 @@ export declare const DEFAULT_ORDER_BY_DESC = "createdAt";
  */
 export declare const contract: {
     getPayouts: {
-        query: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        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;
+        }>;
         method: "GET";
         path: "";
         responses: {
@@ -123,7 +144,6 @@ export declare const contract: {
                 }>, "many">;
                 total: z.ZodNumber;
             }, "strip", z.ZodTypeAny, {
-                total: number;
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -153,8 +173,8 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
-            }, {
                 total: number;
+            }, {
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -184,6 +204,7 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
+                total: number;
             }>;
         };
     };
@@ -315,7 +336,6 @@ export declare const contract: {
                 }>, "many">;
                 total: z.ZodNumber;
             }, "strip", z.ZodTypeAny, {
-                total: number;
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -345,8 +365,8 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
-            }, {
                 total: number;
+            }, {
                 results: {
                     status: import("./payout.dtos.js").PayoutStatus;
                     id: string;
@@ -376,6 +396,7 @@ export declare const contract: {
                         identity: string;
                     } | null | undefined;
                 }[];
+                total: number;
             }>;
         };
     };

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

@@ -197,122 +197,6 @@ 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
@@ -328,14 +212,6 @@ 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
@@ -481,119 +357,9 @@ 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, PayoutFilters, PayoutURLQueryParams, };
+export type { PayoutAuthorizerDTO as PayoutAuthorizer, PayoutDTO, PayoutInputDTO };

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

@@ -1,15 +1,39 @@
-import { BaseRepository, PaginationDTO } from "@/lib/api/index.js";
+import { BaseRepository } from "@/lib/api/base-repository.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";
 /**
- * Flexible query input type - supports the class, filters interface, URL params, etc.
+ * 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
+ * };
+ * ```
  */
-export type PayoutQueryInput = PayoutQuery | PayoutFilters | Record<string, string> | URLSearchParams | null | undefined;
+export interface GetPayoutsAPIArgs {
+    rangeStart?: number;
+    rangeEnd?: number;
+    pending?: boolean;
+    msisdn?: string;
+}
 /**
  * Repository class for managing payout operations including creation, approval,
  * rejection, and retrieval of payouts.
@@ -22,7 +46,7 @@ export type PayoutQueryInput = PayoutQuery | PayoutFilters | Record<string, stri
  * @example
  * ```typescript
  * const repo = new PayoutRepository({ token: userToken });
- * const payouts = await repo.getPayouts();
+ * const payouts = await repo.getAll();
  * ```
  */
 export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
@@ -45,38 +69,31 @@ 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.
+     * Retrieves a paginated list of payouts with optional filtering for pending status.
      *
-     * @param query - Query parameters in any supported format
-     * @returns Promise resolving to payouts and pagination info
+     * @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
      *
      * @example
      * ```typescript
-     * // From API route with URL search params
-     * const { searchParams } = new URL(req.url);
-     * const result = await repo.getPayouts(searchParams);
-     *
-     * // From client with typed params
-     * const filters: PayoutFilters = { page: 1, limit: 20, approvalStatus: 'Pending' };
-     * const result2 = await repo.getPayouts(filters);
+     * // Get first 20 payouts
+     * const result = await repo.getAll({
+     *   rangeStart: 0,
+     *   rangeEnd: 20
+     * });
      *
-     * // With PayoutQuery instance
-     * const query = PayoutQuery.create().wherePending().withPagination(1, 50);
-     * const result3 = await repo.getPayouts(query);
+     * // Get only pending payouts
+     * const pendingResult = await repo.getAll({ pending: true });
      * ```
      */
-    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;
+    getAll(args?: GetPayoutsAPIArgs): Promise<{
+        results: Payout[];
+        total: number;
     }>;
     /**
      * Creates a new payout with the provided input data.
@@ -92,7 +109,7 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
      * @example
      * ```typescript
      * const payout = await repo.pay({
-     *   channel: PayoutChannel.MOBILE,
+     *   channel: PayoutChannel.MOBILE_MONEY,
      *   receiver: { name: "John Doe", phone: "+255123456789" },
      *   amount: Amount.from(10000, "TZS"),
      *   notes: "Payment for services"
@@ -157,13 +174,4 @@ 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, {
-            startDate: Date;
             endDate: Date;
+            startDate: Date;
             accountNo?: string | undefined;
         }, {
-            startDate: Date;
             endDate: Date;
+            startDate: Date;
             accountNo?: string | undefined;
         }>;
         path: "/statement";