@temboplus/tembo-dashboard 0.1.3-beta.4 → 0.2.0

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

@@ -1,5 +1,6 @@
-import { QueryBuilder } from "../../lib/query";
-import { PAYOUT_STATUS, PAYOUT_CHANNEL, PayoutFilters } from "./payout.types";
+import { QueryBuilder } from "../../lib/query/index.js";
+import { PAYOUT_STATUS, PAYOUT_CHANNEL, PayoutFilters } from "./payout.types.js";
+type PayoutUrlParams = Record<string, string | string[]>;
 /**
  * Payout-specific query builder that extends the base QueryBuilder
  * and handles all possible input conversions (DTOs, URL params, etc.)
@@ -14,9 +15,9 @@ export declare class PayoutQuery extends QueryBuilder {
      */
     static fromFilters(filters: PayoutFilters): PayoutQuery;
     /**
-     * Create from URL search parameters (strings)
+     * Create from URL search parameters (strings or string arrays)
      */
-    static fromUrlParams(params: Record<string, string>): PayoutQuery;
+    static fromUrlParams(params: PayoutUrlParams): PayoutQuery;
     /**
      * Create from URLSearchParams object
      */
@@ -28,13 +29,33 @@ export declare class PayoutQuery extends QueryBuilder {
     /**
      * Create from any supported input type
      */
-    static from(input: QueryBuilder | PayoutFilters | Record<string, string> | URLSearchParams | null | undefined): PayoutQuery;
+    static from(input: QueryBuilder | PayoutFilters | PayoutUrlParams | URLSearchParams | null | undefined): PayoutQuery;
     /**
-     * Type guard for string records
+     * Type guard for URL param records (string or string[] values)
      */
-    private static isStringRecord;
+    private static isUrlParamsRecord;
+    /**
+     * Convert URLSearchParams to a record, collecting repeated keys into arrays.
+     */
+    private static searchParamsToRecord;
+    /**
+     * Fold the various URL spellings of multi-value filters into a single
+     * canonical `${field}In` key with an array value. Accepts:
+     *   - `statusIn=a,b,c`
+     *   - `status:in=a,b,c`            (objection-find wire format)
+     *   - `status[]=a&status[]=b`      (HTML-style bracket array)
+     *   - `statusIn[]=a&statusIn[]=b`
+     *   - `status=a&status=b`          (repeated scalar)
+     */
+    private static normalizeUrlParams;
     whereStatus(status: PAYOUT_STATUS): this;
+    whereStatusIn(statuses: PAYOUT_STATUS[]): this;
     whereChannel(channel: PAYOUT_CHANNEL): this;
+    whereChannelIn(channels: PAYOUT_CHANNEL[]): this;
+    whereIdIn(ids: string[]): this;
+    whereRefIn(refs: string[]): this;
+    whereChannelRef(channelRef: string): this;
+    whereChannelRefIn(channelRefs: string[]): this;
     wherePending(): this;
     whereSuccessful(): this;
     whereFailed(): this;
@@ -55,7 +76,8 @@ export declare class PayoutQuery extends QueryBuilder {
      */
     toFilters(): PayoutFilters;
     /**
-     * Convert to URL-safe string parameters
+     * Convert to URL-safe string parameters.
+     * IN-filter arrays are emitted as comma-joined strings under the `${field}In` key.
      */
     toUrlParams(): Record<string, string>;
     /**
@@ -99,9 +121,19 @@ export declare class PayoutQuery extends QueryBuilder {
      */
     getActiveFilters(): string[];
     /**
-     * Extract filter values from QueryBuilder options
+     * Extract filter values from QueryBuilder options. Maps wire-field names
+     * back onto surface-filter names (statusCodeText→status, etc.) for fields
+     * that have a friendly alias on `PayoutFilters`.
      */
     private extractFilterValues;
+    /**
+     * Apply an IN filter, silently no-op when the normalized list is empty.
+     */
+    private whereInValues;
+    /** Narrow an unknown array to a `PAYOUT_STATUS[]` (preserving order). */
+    private getValidStatuses;
+    /** Narrow an unknown array to a `PAYOUT_CHANNEL[]` (preserving order). */
+    private getValidChannels;
     /**
      * Extract primary sort field
      */
@@ -119,3 +151,4 @@ export declare class PayoutQuery extends QueryBuilder {
      */
     private isValidStatus;
 }
+export {};

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

@@ -1,13 +1,13 @@
-import { BaseRepository, PaginationDTO } from "../../lib/api";
-import { payoutContract } from "./payout.api-contract";
-import { Payout } from "./payout.model";
-import { PayoutQuery } from "./payout.query";
-import { PayoutFilters } from "./payout.types";
-import { TransactionSummary } from "../../lib/models";
+import { BaseRepository, PaginationDTO } from "../../lib/api/index.js";
+import { payoutContract } from "./payout.api-contract.js";
+import { Payout } from "./payout.model.js";
+import { PayoutQuery } from "./payout.query.js";
+import { PayoutFilters } from "./payout.types.js";
+import { TransactionSummary } from "../../lib/models/index.js";
 /**
  * Flexible query input type - supports the class, filters interface, URL params, etc.
  */
-export type PayoutQueryInput = PayoutQuery | PayoutFilters | Record<string, string> | URLSearchParams | null | undefined;
+export type PayoutQueryInput = PayoutQuery | PayoutFilters | Record<string, string | string[]> | URLSearchParams | null | undefined;
 /**
  * Repository class for managing payouts through API interactions.
  * Handles payout operations, filtering, and summary data retrieval.

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

@@ -25,6 +25,12 @@ export declare enum BANK_PAYOUT_CHANNEL {
     BANK = "TZ-BANK-B2C"
 }
 export type PAYOUT_CHANNEL = MOBILE_PAYOUT_CHANNEL | BANK_PAYOUT_CHANNEL;
+/**
+ * Accepts a single string, a comma-separated string, or an array of strings,
+ * and normalizes to a deduplicated, trimmed, non-empty `string[]`.
+ */
+declare const toStringArray: (value: unknown) => string[];
+export { toStringArray as payoutToStringArray };
 export declare const PayoutDTOSchemas: {
     payout: z.ZodObject<{
         id: z.ZodString;
@@ -125,9 +131,15 @@ export declare const PayoutDTOSchemas: {
         accountNo: z.ZodOptional<z.ZodString>;
         walletId: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
+        idIn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         ref: z.ZodOptional<z.ZodString>;
+        refIn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        channelRef: z.ZodOptional<z.ZodString>;
+        channelRefIn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         channel: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<typeof MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof BANK_PAYOUT_CHANNEL>]>>;
+        channelIn: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNativeEnum<typeof MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof BANK_PAYOUT_CHANNEL>]>, "many">>;
         status: z.ZodOptional<z.ZodNativeEnum<typeof PAYOUT_STATUS>>;
+        statusIn: z.ZodOptional<z.ZodArray<z.ZodNativeEnum<typeof PAYOUT_STATUS>, "many">>;
         minAmount: z.ZodOptional<z.ZodNumber>;
         maxAmount: z.ZodOptional<z.ZodNumber>;
         search: z.ZodOptional<z.ZodString>;
@@ -145,9 +157,15 @@ export declare const PayoutDTOSchemas: {
         channel?: MOBILE_PAYOUT_CHANNEL | BANK_PAYOUT_CHANNEL | undefined;
         startDate?: string | undefined;
         endDate?: string | undefined;
+        idIn?: string[] | undefined;
+        channelIn?: (MOBILE_PAYOUT_CHANNEL | BANK_PAYOUT_CHANNEL.BANK)[] | undefined;
+        statusIn?: PAYOUT_STATUS[] | undefined;
         minAmount?: number | undefined;
         maxAmount?: number | undefined;
         ref?: string | undefined;
+        refIn?: string[] | undefined;
+        channelRef?: string | undefined;
+        channelRefIn?: string[] | undefined;
     }, {
         status?: PAYOUT_STATUS | undefined;
         page?: number | undefined;
@@ -162,9 +180,15 @@ export declare const PayoutDTOSchemas: {
         sortOrder?: "asc" | "desc" | undefined;
         startDate?: string | undefined;
         endDate?: string | undefined;
+        idIn?: string[] | undefined;
+        channelIn?: (MOBILE_PAYOUT_CHANNEL | BANK_PAYOUT_CHANNEL.BANK)[] | undefined;
+        statusIn?: PAYOUT_STATUS[] | undefined;
         minAmount?: number | undefined;
         maxAmount?: number | undefined;
         ref?: string | undefined;
+        refIn?: string[] | undefined;
+        channelRef?: string | undefined;
+        channelRefIn?: string[] | undefined;
     }>;
     payoutURLQueryParams: z.ZodObject<{
         page: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
@@ -177,9 +201,15 @@ export declare const PayoutDTOSchemas: {
         accountNo: z.ZodOptional<z.ZodString>;
         walletId: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
+        idIn: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
         ref: z.ZodOptional<z.ZodString>;
+        refIn: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        channelRef: z.ZodOptional<z.ZodString>;
+        channelRefIn: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
         channel: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, MOBILE_PAYOUT_CHANNEL | BANK_PAYOUT_CHANNEL, string>>;
+        channelIn: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>, z.ZodArray<z.ZodUnion<[z.ZodNativeEnum<typeof MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof BANK_PAYOUT_CHANNEL>]>, "many">>>;
         status: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, PAYOUT_STATUS, string>>;
+        statusIn: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>, z.ZodArray<z.ZodNativeEnum<typeof PAYOUT_STATUS>, "many">>>;
         minAmount: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
         maxAmount: z.ZodOptional<z.ZodEffects<z.ZodString, number, string>>;
         search: z.ZodOptional<z.ZodString>;
@@ -197,9 +227,15 @@ export declare const PayoutDTOSchemas: {
         channel?: MOBILE_PAYOUT_CHANNEL | BANK_PAYOUT_CHANNEL | undefined;
         startDate?: string | undefined;
         endDate?: string | undefined;
+        idIn?: string[] | undefined;
+        channelIn?: (MOBILE_PAYOUT_CHANNEL | BANK_PAYOUT_CHANNEL.BANK)[] | undefined;
+        statusIn?: PAYOUT_STATUS[] | undefined;
         minAmount?: number | undefined;
         maxAmount?: number | undefined;
         ref?: string | undefined;
+        refIn?: string[] | undefined;
+        channelRef?: string | undefined;
+        channelRefIn?: string[] | undefined;
     }, {
         status?: string | undefined;
         page?: string | undefined;
@@ -214,9 +250,15 @@ export declare const PayoutDTOSchemas: {
         sortOrder?: "asc" | "desc" | undefined;
         startDate?: string | undefined;
         endDate?: string | undefined;
+        idIn?: string | string[] | undefined;
+        channelIn?: string | string[] | undefined;
+        statusIn?: string | string[] | undefined;
         minAmount?: string | undefined;
         maxAmount?: string | undefined;
         ref?: string | undefined;
+        refIn?: string | string[] | undefined;
+        channelRef?: string | undefined;
+        channelRefIn?: string | string[] | undefined;
     }>;
     payoutStatus: z.ZodNativeEnum<typeof PAYOUT_STATUS>;
     payoutChannel: z.ZodUnion<[z.ZodNativeEnum<typeof MOBILE_PAYOUT_CHANNEL>, z.ZodNativeEnum<typeof BANK_PAYOUT_CHANNEL>]>;

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

@@ -1,3 +1,3 @@
-export * from "./transaction.api-contract";
-export * from "./transaction.repository";
-export * from "./transaction.types";
+export * from "./transaction.api-contract.js";
+export * from "./transaction.repository.js";
+export * from "./transaction.types.js";

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

@@ -1,6 +1,6 @@
-import { BaseRepository } from "../../lib/api";
-import { transactionContract } from "./transaction.api-contract";
-import { LocalTransferRequestDTO, LocalTransferResponseDTO } from "./transaction.types";
+import { BaseRepository } from "../../lib/api/index.js";
+import { transactionContract } from "./transaction.api-contract.js";
+import { LocalTransferRequestDTO, LocalTransferResponseDTO } from "./transaction.types.js";
 export declare class TransactionRepository extends BaseRepository<typeof transactionContract> {
     constructor(options?: {
         token?: string;

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

@@ -1,4 +1,4 @@
-export * from "./wallet.api-contract";
-export * from "./wallet.model";
-export * from "./wallet.repository";
-export * from "./wallet.types";
+export * from "./wallet.api-contract.js";
+export * from "./wallet.model.js";
+export * from "./wallet.repository.js";
+export * from "./wallet.types.js";

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

@@ -1,7 +1,7 @@
-import { BaseRepository } from "../../lib/api";
-import { StatementEntry, WalletInfo } from "../../lib/models";
-import { Wallet } from "./wallet.model";
-import { walletContract } from "./wallet.api-contract";
+import { BaseRepository } from "../../lib/api/index.js";
+import { StatementEntry, WalletInfo } from "../../lib/models/index.js";
+import { Wallet } from "./wallet.model.js";
+import { walletContract } from "./wallet.api-contract.js";
 export interface WalletStatementInput {
     accountNo: string;
     startDate: Date | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/tembo-dashboard",
-  "version": "0.1.3-beta.4",
+  "version": "0.2.0",
   "description": "A foundational library for Temboplus-Dashboard projects providing type-safe data layer abstraction with API contracts, domain models, and repositories.",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",
@@ -58,6 +58,6 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@temboplus/frontend-core": "^0.4.0"
+    "@temboplus/frontend-core": "^1.0.2"
   }
 }