@temboplus/afloat 0.1.77-beta.9 → 0.1.77

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

@@ -27,7 +27,11 @@ export declare class QueryBuilder {
     whereLessThan(field: string, value: any): this;
     whereLessThanOrEqual(field: string, value: any): this;
     whereBetween(field: string, min: any, max: any): this;
-    whereDateBetween(startDate?: string | null, endDate?: string | null): this;
+    /**
+     * Filter by date range with support for Date objects, strings, and null
+     * Internally converts to createdAt:gte and createdAt:lte filters
+     */
+    whereDateBetween(startDate?: string | Date | null, endDate?: string | Date | null): this;
     addSort(criteria: SortCriteria): this;
     orderBy(field: string, direction?: SortDirection): this;
     orderByAsc(field: string): this;

package/dist/modules/contact/contact-info.model.d.ts

@@ -208,6 +208,9 @@ declare abstract class BaseContactInfo {
      * Converts the ContactInfo instance to a JSON string.
     */
     toJSONString(): string;
+    get isMobile(): boolean;
+    get isBank(): boolean;
+    get displayName(): string;
 }
 /**
  * Implementation of BaseContactInfo for mobile phone contacts.

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

@@ -27,7 +27,9 @@ export declare enum PayoutStatus {
     /** Payout has been rejected */
     REJECTED = "REJECTED",
     /** Payout has been reversed */
-    REVERSED = "REVERSED"
+    REVERSED = "REVERSED",
+    /** Payout has been queued for processing */
+    QUEUED = "QUEUED"
 }
 /**
  * Represents the approval status for payouts that require authorization.
@@ -228,14 +230,14 @@ declare const PayoutFiltersSchema: z.ZodObject<{
     id?: string | null | undefined;
     profileId?: string | null | undefined;
     search?: string | null | undefined;
-    startDate?: string | null | undefined;
-    endDate?: string | null | undefined;
     channel?: string | null | undefined;
     currencyCode?: 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;
 }, {
@@ -243,8 +245,6 @@ declare const PayoutFiltersSchema: z.ZodObject<{
     id?: string | null | undefined;
     profileId?: string | null | undefined;
     search?: string | null | undefined;
-    startDate?: string | null | undefined;
-    endDate?: string | null | undefined;
     page?: number | undefined;
     limit?: number | undefined;
     channel?: string | null | undefined;
@@ -255,6 +255,8 @@ declare const PayoutFiltersSchema: z.ZodObject<{
     approvalStatus?: PayoutApprovalStatus | null | undefined;
     sortBy?: string | undefined;
     sortOrder?: "asc" | "desc" | undefined;
+    startDate?: string | null | undefined;
+    endDate?: string | null | undefined;
     minAmount?: number | null | undefined;
     maxAmount?: number | null | undefined;
 }>;
@@ -286,8 +288,6 @@ declare const PayoutURLQueryParamsSchema: z.ZodObject<{
     id?: string | undefined;
     profileId?: string | undefined;
     search?: string | undefined;
-    startDate?: string | undefined;
-    endDate?: string | undefined;
     page?: number | undefined;
     limit?: number | undefined;
     channel?: string | undefined;
@@ -295,6 +295,8 @@ declare const PayoutURLQueryParamsSchema: z.ZodObject<{
     payeeName?: string | undefined;
     partnerReference?: string | undefined;
     approvalStatus?: PayoutApprovalStatus | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
     minAmount?: number | undefined;
     maxAmount?: number | undefined;
 }, {
@@ -302,8 +304,6 @@ declare const PayoutURLQueryParamsSchema: z.ZodObject<{
     id?: string | undefined;
     profileId?: string | undefined;
     search?: string | undefined;
-    startDate?: string | undefined;
-    endDate?: string | undefined;
     page?: string | undefined;
     limit?: string | undefined;
     channel?: string | undefined;
@@ -313,6 +313,8 @@ declare const PayoutURLQueryParamsSchema: z.ZodObject<{
     approvalStatus?: string | undefined;
     sortBy?: string | undefined;
     sortOrder?: "asc" | "desc" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
     minAmount?: string | undefined;
     maxAmount?: string | undefined;
 }>;
@@ -512,14 +514,14 @@ export declare const PayoutDTOSchemas: {
         id?: string | null | undefined;
         profileId?: string | null | undefined;
         search?: string | null | undefined;
-        startDate?: string | null | undefined;
-        endDate?: string | null | undefined;
         channel?: string | null | undefined;
         currencyCode?: 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;
     }, {
@@ -527,8 +529,6 @@ export declare const PayoutDTOSchemas: {
         id?: string | null | undefined;
         profileId?: string | null | undefined;
         search?: string | null | undefined;
-        startDate?: string | null | undefined;
-        endDate?: string | null | undefined;
         page?: number | undefined;
         limit?: number | undefined;
         channel?: string | null | undefined;
@@ -539,6 +539,8 @@ export declare const PayoutDTOSchemas: {
         approvalStatus?: PayoutApprovalStatus | null | undefined;
         sortBy?: string | undefined;
         sortOrder?: "asc" | "desc" | undefined;
+        startDate?: string | null | undefined;
+        endDate?: string | null | undefined;
         minAmount?: number | null | undefined;
         maxAmount?: number | null | undefined;
     }>;
@@ -567,8 +569,6 @@ export declare const PayoutDTOSchemas: {
         id?: string | undefined;
         profileId?: string | undefined;
         search?: string | undefined;
-        startDate?: string | undefined;
-        endDate?: string | undefined;
         page?: number | undefined;
         limit?: number | undefined;
         channel?: string | undefined;
@@ -576,6 +576,8 @@ export declare const PayoutDTOSchemas: {
         payeeName?: string | undefined;
         partnerReference?: string | undefined;
         approvalStatus?: PayoutApprovalStatus | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
         minAmount?: number | undefined;
         maxAmount?: number | undefined;
     }, {
@@ -583,8 +585,6 @@ export declare const PayoutDTOSchemas: {
         id?: string | undefined;
         profileId?: string | undefined;
         search?: string | undefined;
-        startDate?: string | undefined;
-        endDate?: string | undefined;
         page?: string | undefined;
         limit?: string | undefined;
         channel?: string | undefined;
@@ -594,6 +594,8 @@ export declare const PayoutDTOSchemas: {
         approvalStatus?: string | undefined;
         sortBy?: string | undefined;
         sortOrder?: "asc" | "desc" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
         minAmount?: string | undefined;
         maxAmount?: string | undefined;
     }>;

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

@@ -1,5 +1,6 @@
 import { QueryBuilder } from "@/lib/query/index.js";
 import { PayoutStatus, PayoutApprovalStatus, PayoutFilters } from "./payout.dtos.js";
+import { Amount } from "@temboplus/frontend-core";
 /**
  * Payout-specific query builder that extends the base QueryBuilder
  * and handles all possible input conversions (DTOs, URL params, etc.)
@@ -41,7 +42,7 @@ export declare class PayoutQuery extends QueryBuilder {
     whereRejected(): this;
     wherePaid(): this;
     whereFailed(): this;
-    whereAmountBetween(min: number, max: number): this;
+    whereAmountBetween(min: Amount, max: Amount): this;
     wherePayee(payeeName: string): this;
     whereMsisdn(msisdn: string): this;
     whereProfileId(profileId: string): this;
@@ -57,7 +58,7 @@ export declare class PayoutQuery extends QueryBuilder {
      */
     toFilters(): PayoutFilters;
     /**
-     * Convert to URL-safe string parameters
+     * Convert to user-friendly URL parameters (for browser URLs)
      */
     toUrlParams(): Record<string, string>;
     /**
@@ -79,7 +80,7 @@ export declare class PayoutQuery extends QueryBuilder {
     /**
      * Create new instance with date range
      */
-    withDateRange(startDate?: string, endDate?: string): PayoutQuery;
+    withDateRange(startDate?: string | Date, endDate?: string | Date): PayoutQuery;
     /**
      * Create new instance with status filter
      */

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

@@ -7,6 +7,29 @@ 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";
+/**
+ * Input type for payout creation mutation
+ */
+export interface CreatePayoutInput {
+    channel: PayoutChannel;
+    receiver: ContactInfo;
+    amount: Amount;
+    notes?: string;
+}
+/**
+ * Input type for payout approval mutation
+ */
+export interface ApprovePayoutInput {
+    id: string;
+    notes?: string;
+}
+/**
+ * Input type for payout rejection mutation
+ */
+export interface RejectPayoutInput {
+    id: string;
+    notes?: string;
+}
 /**
  * Flexible query input type - supports the class, filters interface, URL params, etc.
  */
@@ -93,11 +116,11 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
     /**
      * Creates a new payout with the provided input data.
      *
-     * @param args - The payout creation data
-     * @param args.channel - The payout channel to use
-     * @param args.receiver - Contact information for the payout receiver
-     * @param args.amount - The amount to pay out
-     * @param args.notes - Optional notes for the payout
+     * @param input - The payout creation data
+     * @param input.channel - The payout channel to use
+     * @param input.receiver - Contact information for the payout receiver
+     * @param input.amount - The amount to pay out
+     * @param input.notes - Optional notes for the payout
      * @returns Promise that resolves to the created payout
      * @throws {APIError} If the input is invalid or if the creation operation fails
      *
@@ -111,18 +134,12 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
      * });
      * ```
      */
-    pay(args: {
-        channel: PayoutChannel;
-        receiver: ContactInfo;
-        amount: Amount;
-        notes?: string;
-    }): Promise<Payout>;
+    pay(input: CreatePayoutInput): Promise<Payout>;
     /**
      * Approves a payout with optional notes.
      *
-     * @param id - The ID of the payout to approve
-     * @param args - Optional arguments
-     * @param args.notes - Optional notes for the approval
+     * @param input.id - The ID of the payout to approve
+     * @param input.notes - Optional notes for the approval
      * @returns Promise that resolves to the approved payout
      * @throws {APIError} If payout is not found, already approved, or if the operation fails
      *
@@ -133,15 +150,12 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
      * });
      * ```
      */
-    approve(id: string, args?: {
-        notes?: string;
-    }): Promise<Payout>;
+    approve(input: ApprovePayoutInput): Promise<Payout>;
     /**
      * Rejects a payout with optional notes.
      *
-     * @param id - The ID of the payout to reject
-     * @param args - Optional arguments
-     * @param args.notes - Optional notes for the rejection
+     * @param input.id - The ID of the payout to reject
+     * @param input.notes - Optional notes for the rejection
      * @returns Promise that resolves to the rejected payout
      * @throws {APIError} If payout is not found, already rejected, or if the operation fails
      *
@@ -152,9 +166,7 @@ export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
      * });
      * ```
      */
-    reject(id: string, args?: {
-        notes?: string;
-    }): Promise<Payout>;
+    reject(input: RejectPayoutInput): Promise<Payout>;
     /**
      * Retrieves a payout by its ID.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/afloat",
-  "version": "0.1.77-beta.9",
+  "version": "0.1.77",
   "description": "A foundational library for Temboplus-Afloat projects.",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",
@@ -58,6 +58,6 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@temboplus/frontend-core": "^0.2.20-beta.2"
+    "@temboplus/frontend-core": "^0.2.20-beta.3"
   }
 }