feeef 0.5.38-dev.4 → 0.6.2

package/build/src/feeef/repositories/deposits.d.ts

@@ -1,5 +1,9 @@
 import { AxiosInstance } from 'axios';
-import { ModelRepository } from './repository.js';
+import { ModelRepository, ListResponse } from './repository.js';
+/**
+ * Deposit status enum
+ */
+export type DepositStatus = 'pending' | 'completed' | 'failed' | 'cancelled';
 /**
  * Represents a deposit entity for wallet transactions
  */
@@ -11,7 +15,7 @@ export interface DepositEntity {
     currency: string;
     paymentMethod?: string | null;
     attachment?: string | null;
-    status: 'pending' | 'completed' | 'failed' | 'cancelled';
+    status: DepositStatus;
     note?: string | null;
     metadata: Record<string, any>;
     history: Array<{
@@ -28,13 +32,45 @@ export interface DepositEntity {
 export interface DepositCreateInput {
     id?: string;
     externalId?: string;
+    userId?: string;
     amount: number;
     currency?: string;
     paymentMethod?: string;
     attachment?: string;
+    status?: DepositStatus;
+    note?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Input data for updating an existing deposit
+ */
+export interface DepositUpdateInput {
+    externalId?: string;
+    amount?: number;
+    currency?: string;
+    paymentMethod?: string;
+    attachment?: string;
+    status?: DepositStatus;
     note?: string;
     metadata?: Record<string, any>;
 }
+/**
+ * Options for listing deposits
+ */
+export interface DepositListOptions {
+    page?: number;
+    offset?: number;
+    limit?: number;
+    userId?: string;
+    status?: DepositStatus | DepositStatus[];
+    paymentMethod?: string;
+    createdAfter?: Date | string;
+    createdBefore?: Date | string;
+    minAmount?: number;
+    maxAmount?: number;
+    q?: string;
+    params?: Record<string, any>;
+}
 /**
  * PayPal order creation response
  */
@@ -61,14 +97,20 @@ export interface PayPalCaptureResponse {
 /**
  * Repository for managing deposit data and PayPal integration
  */
-export declare class DepositRepository extends ModelRepository<DepositEntity, DepositCreateInput, any> {
+export declare class DepositRepository extends ModelRepository<DepositEntity, DepositCreateInput, DepositUpdateInput> {
     /**
      * Constructs a new DepositRepository instance
      * @param client - The AxiosInstance used for making HTTP requests
      */
     constructor(client: AxiosInstance);
     /**
-     * Create a new deposit request
+     * Lists deposits with optional filtering.
+     * @param options - The options for listing deposits.
+     * @returns A Promise that resolves to a list of Deposit entities.
+     */
+    list(options?: DepositListOptions): Promise<ListResponse<DepositEntity>>;
+    /**
+     * Create a new deposit request (for anonymous/guest users)
      * @param data - The deposit data
      * @returns Promise that resolves to the created deposit
      */
@@ -102,4 +144,25 @@ export declare class DepositRepository extends ModelRepository<DepositEntity, De
         amount?: number;
         currency?: string;
     }>;
+    /**
+     * Accept a pending deposit (admin only)
+     * @param depositId - The deposit ID to accept
+     * @param note - Optional note for the status change
+     * @returns Promise that resolves to the updated deposit
+     */
+    accept(depositId: string, note?: string): Promise<DepositEntity>;
+    /**
+     * Reject a pending deposit (admin only)
+     * @param depositId - The deposit ID to reject
+     * @param note - Optional note for the rejection reason
+     * @returns Promise that resolves to the updated deposit
+     */
+    reject(depositId: string, note?: string): Promise<DepositEntity>;
+    /**
+     * Cancel a pending deposit
+     * @param depositId - The deposit ID to cancel
+     * @param note - Optional note for the cancellation reason
+     * @returns Promise that resolves to the updated deposit
+     */
+    cancel(depositId: string, note?: string): Promise<DepositEntity>;
 }

package/build/src/feeef/repositories/feedbacks.d.ts

@@ -0,0 +1,43 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository, ListResponse } from './repository.js';
+import { FeedbackEntity, FeedbackCreateInput, FeedbackUpdateInput, FeedbackListOptions } from '../../core/entities/feedback.js';
+/**
+ * Repository for managing Feedback entities.
+ */
+export declare class FeedbackRepository extends ModelRepository<FeedbackEntity, FeedbackCreateInput, FeedbackUpdateInput> {
+    /**
+     * Constructs a new FeedbackRepository instance.
+     * @param client The AxiosInstance used for making HTTP requests.
+     */
+    constructor(client: AxiosInstance);
+    /**
+     * Lists feedbacks with optional filtering.
+     * @param options - The options for listing feedbacks.
+     * @returns A Promise that resolves to a list of Feedback entities.
+     */
+    list(options?: FeedbackListOptions): Promise<ListResponse<FeedbackEntity>>;
+    /**
+     * Adds a comment to existing feedback.
+     * @param id - The feedback ID.
+     * @param comment - The comment to add.
+     * @returns A Promise that resolves to the updated Feedback entity.
+     */
+    addComment(id: string, comment: string): Promise<FeedbackEntity>;
+    /**
+     * Creates feedback with file attachments.
+     * @param data - The feedback data.
+     * @param files - Optional array of files to attach.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the created Feedback entity.
+     */
+    createWithFiles(data: FeedbackCreateInput, files?: File[], params?: Record<string, any>): Promise<FeedbackEntity>;
+    /**
+     * Updates feedback with additional files.
+     * @param id - The feedback ID.
+     * @param data - The update data.
+     * @param files - Optional array of files to attach.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the updated Feedback entity.
+     */
+    updateWithFiles(id: string, data: FeedbackUpdateInput, files?: File[], params?: Record<string, any>): Promise<FeedbackEntity>;
+}

package/build/src/feeef/repositories/orders.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from 'axios';
-import { ModelRepository } from './repository.js';
-import { OrderEntity, OrderTrackEntity, ShippingType } from '../../core/entities/order.js';
+import { ModelRepository, ListResponse } from './repository.js';
+import { OrderEntity, OrderTrackEntity, OrderStatus, DeliveryStatus, PaymentStatus, ShippingType, OrderCreateInput, OrderUpdateInput, OrderPricing, CalculateOrderPricingOptions } from '../../core/entities/order.js';
 /**
  * Represents the options for tracking an order.
  */
@@ -8,6 +8,9 @@ export interface OrderModelTrackOptions {
     id: string;
     params?: Record<string, any>;
 }
+/**
+ * Schema for sending an order from an anonymous user
+ */
 export interface SendOrderSchema {
     id?: string;
     customerName?: string;
@@ -18,6 +21,7 @@ export interface SendOrderSchema {
     shippingAddress?: string;
     shippingCity?: string;
     shippingState?: string;
+    shippingCountry?: string;
     shippingType: ShippingType;
     shippingMethodId?: string;
     shippingNote?: string;
@@ -26,8 +30,12 @@ export interface SendOrderSchema {
     coupon?: string;
     status: 'pending' | 'draft';
     storeId: string;
+    customFields?: Record<string, any>;
     metadata?: any;
 }
+/**
+ * Schema for guest order items
+ */
 export interface GuestOrderItemSchema {
     productId: string;
     offerCode?: string;
@@ -51,15 +59,57 @@ export interface AssignManyOrdersSchema {
     memberId: string;
     storeId: string;
 }
+/**
+ * Delivery service filter enum
+ */
+export declare enum DeliveryServiceFilter {
+    yalidine = "yalidine",
+    ecotrack = "ecotrack",
+    procolis = "procolis",
+    noest = "noest",
+    zimou = "zimou",
+    maystro = "maystro",
+    ecomanager = "ecomanager"
+}
+/**
+ * Options for listing orders
+ */
+export interface OrderListOptions {
+    page?: number;
+    offset?: number;
+    limit?: number;
+    storeId?: string;
+    status?: OrderStatus | OrderStatus[];
+    deliveryStatus?: DeliveryStatus;
+    paymentStatus?: PaymentStatus;
+    customStatus?: string | string[];
+    source?: string | string[];
+    tags?: string[];
+    createdBefore?: Date | string;
+    createdAfter?: Date | string;
+    q?: string;
+    confirmer?: string;
+    products?: string[];
+    shippingState?: string;
+    shippingCity?: string;
+    deliveryService?: DeliveryServiceFilter;
+    params?: Record<string, any>;
+}
 /**
  * Represents a repository for managing orders.
  */
-export declare class OrderRepository extends ModelRepository<OrderEntity, any, any> {
+export declare class OrderRepository extends ModelRepository<OrderEntity, OrderCreateInput, OrderUpdateInput> {
     /**
      * Constructs a new OrderRepository instance.
      * @param client - The AxiosInstance used for making HTTP requests.
      */
     constructor(client: AxiosInstance);
+    /**
+     * Lists orders with optional filtering.
+     * @param options - The options for listing orders.
+     * @returns A Promise that resolves to a list of Order entities.
+     */
+    list(options?: OrderListOptions): Promise<ListResponse<OrderEntity>>;
     /**
      * Sends an order from an anonymous user.
      * @param data - The data representing the order to be sent.
@@ -67,22 +117,28 @@ export declare class OrderRepository extends ModelRepository<OrderEntity, any, a
      */
     send(data: SendOrderSchema): Promise<OrderEntity>;
     /**
-     * track the order by the order id
-     * it will return the order status and history
-     * @param options - The options for finding the model.
-     * @returns A promise that resolves to the found model.
+     * Tracks the order by the order ID.
+     * Returns the order status and history.
+     * @param options - The options for tracking the order.
+     * @returns A promise that resolves to the order track entity.
      */
     track(options: OrderModelTrackOptions): Promise<OrderTrackEntity>;
     /**
-     * Assigns a single order to a member (as confirmer)
-     * @param data - The data containing orderId, memberId, and storeId
-     * @returns A Promise that resolves to the updated OrderEntity
+     * Calculates order pricing based on items, shipping details, etc.
+     * @param options - The calculation options.
+     * @returns A Promise that resolves to the calculated pricing.
+     */
+    calculate(options: CalculateOrderPricingOptions): Promise<OrderPricing>;
+    /**
+     * Assigns a single order to a member (as confirmer).
+     * @param data - The data containing orderId, memberId, and storeId.
+     * @returns A Promise that resolves to the updated OrderEntity.
      */
     assign(data: AssignOrderSchema): Promise<OrderEntity>;
     /**
-     * Assigns multiple orders to a member (as confirmer)
-     * @param data - The data containing orderIds, memberId, and storeId
-     * @returns A Promise that resolves to a success message
+     * Assigns multiple orders to a member (as confirmer).
+     * @param data - The data containing orderIds, memberId, and storeId.
+     * @returns A Promise that resolves to a success message.
      */
     assignMany(data: AssignManyOrdersSchema): Promise<{
         message: string;

package/build/src/feeef/repositories/products.d.ts

@@ -1,19 +1,57 @@
 import { AxiosInstance } from 'axios';
-import { ModelRepository } from './repository.js';
-import { ProductEntity } from '../../core/entities/product.js';
+import { ModelRepository, ListResponse } from './repository.js';
+import { ProductEntity, ProductCreateInput, ProductUpdateInput, ProductReport, ProductStatus } from '../../core/entities/product.js';
+/**
+ * Options for listing products
+ */
+export interface ProductListOptions {
+    page?: number;
+    offset?: number;
+    limit?: number;
+    storeId?: string;
+    categoryId?: string;
+    status?: ProductStatus | ProductStatus[];
+    q?: string;
+    minPrice?: number;
+    maxPrice?: number;
+    inStock?: boolean;
+    sortBy?: 'price' | 'createdAt' | 'sold' | 'views';
+    sortOrder?: 'asc' | 'desc';
+    params?: Record<string, any>;
+}
 /**
  * Represents a repository for managing products.
  */
-export declare class ProductRepository extends ModelRepository<ProductEntity, any, any> {
+export declare class ProductRepository extends ModelRepository<ProductEntity, ProductCreateInput, ProductUpdateInput> {
     /**
      * Creates a new instance of the ProductRepository class.
      * @param client - The AxiosInstance used for making HTTP requests.
      */
     constructor(client: AxiosInstance);
     /**
-     * Retrieves a random products from the repository.
-     * @param limit - The number of random products to retrieve. Default is 1.
+     * Lists products with optional filtering.
+     * @param options - The options for listing products.
+     * @returns A Promise that resolves to a list of Product entities.
+     */
+    list(options?: ProductListOptions): Promise<ListResponse<ProductEntity>>;
+    /**
+     * Retrieves random products from the repository.
+     * @param limit - The number of random products to retrieve. Default is 12.
      * @returns A promise that resolves to an array of random ProductEntity objects.
      */
     random(limit?: number): Promise<ProductEntity[]>;
+    /**
+     * Gets the sells chart for a product (last 7 days).
+     * @param productId - The product ID.
+     * @param storeId - The store ID.
+     * @returns A Promise that resolves to a map of date to number of sells.
+     */
+    sells(productId: string, storeId: string): Promise<Map<Date, number>>;
+    /**
+     * Gets the analytics/report for a product.
+     * @param productId - The product ID.
+     * @param storeId - The store ID.
+     * @returns A Promise that resolves to the product report.
+     */
+    report(productId: string, storeId: string): Promise<ProductReport>;
 }

package/build/src/feeef/repositories/repository.d.ts

@@ -28,10 +28,14 @@ export declare abstract class ModelRepository<T, C, U> {
     list(options?: ModelListOptions): Promise<ListResponse<T>>;
     /**
      * Creates a new model.
-     * @param options - The options for creating the model.
+     * Supports two call patterns:
+     * 1. `create(data, params?)` - Pass data directly with optional params
+     * 2. `create({ data, params })` - Pass options object
+     * @param dataOrOptions - The data to create or options object containing data and params
+     * @param params - Optional query parameters (only used when data is passed directly)
      * @returns A promise that resolves to the created model.
      */
-    create(options: ModelCreateOptions<C>): Promise<T>;
+    create(dataOrOptions: C | ModelCreateOptions<C>, params?: Record<string, any>): Promise<T>;
     /**
      * Updates an existing model.
      * @param options - The options for updating the model.

package/build/src/feeef/repositories/shipping_methods.d.ts

@@ -0,0 +1,38 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository, ListResponse } from './repository.js';
+import { ShippingMethodEntity, ShippingMethodCreateInput, ShippingMethodUpdateInput, ShippingMethodStatus, ShippingMethodPolicy } from '../../core/entities/shipping_method.js';
+/**
+ * Options for listing shipping methods
+ */
+export interface ShippingMethodListOptions {
+    page?: number;
+    offset?: number;
+    limit?: number;
+    storeId?: string;
+    status?: ShippingMethodStatus | ShippingMethodStatus[];
+    policy?: ShippingMethodPolicy;
+    params?: Record<string, any>;
+}
+/**
+ * Repository for managing ShippingMethod entities.
+ */
+export declare class ShippingMethodRepository extends ModelRepository<ShippingMethodEntity, ShippingMethodCreateInput, ShippingMethodUpdateInput> {
+    /**
+     * Constructs a new ShippingMethodRepository instance.
+     * @param client The AxiosInstance used for making HTTP requests.
+     */
+    constructor(client: AxiosInstance);
+    /**
+     * Lists shipping methods with optional filtering.
+     * @param options - The options for listing shipping methods.
+     * @returns A Promise that resolves to a list of ShippingMethod entities.
+     */
+    list(options?: ShippingMethodListOptions): Promise<ListResponse<ShippingMethodEntity>>;
+    /**
+     * Lists shipping methods for a specific store.
+     * @param storeId - The store ID.
+     * @param options - Optional list options.
+     * @returns A Promise that resolves to a list of ShippingMethod entities.
+     */
+    listByStore(storeId: string, options?: Omit<ShippingMethodListOptions, 'storeId'>): Promise<ListResponse<ShippingMethodEntity>>;
+}

package/build/src/feeef/repositories/shipping_prices.d.ts

@@ -1,26 +1,37 @@
 import { AxiosInstance } from 'axios';
-import { ModelRepository, ModelCreateOptions } from './repository.js';
-import { ShippingPriceEntity } from '../../core/entities/shipping_price.js';
+import { ModelRepository, ListResponse } from './repository.js';
+import { ShippingPriceEntity, ShippingPriceCreateInput, ShippingPriceUpdateInput, ShippingPriceStatus } from '../../core/entities/shipping_price.js';
+/**
+ * Options for listing shipping prices
+ */
+export interface ShippingPriceListOptions {
+    page?: number;
+    offset?: number;
+    limit?: number;
+    storeId?: string;
+    status?: ShippingPriceStatus | ShippingPriceStatus[];
+    params?: Record<string, any>;
+}
 /**
  * Repository for managing ShippingPrice entities.
  *
  * ShippingPrice is the new geo-based shipping system that replaces
  * the legacy array-based ShippingMethod rates.
  */
-export declare class ShippingPriceRepository extends ModelRepository<ShippingPriceEntity, any, any> {
+export declare class ShippingPriceRepository extends ModelRepository<ShippingPriceEntity, ShippingPriceCreateInput, ShippingPriceUpdateInput> {
     /**
      * Constructs a new ShippingPriceRepository instance.
      * @param client The AxiosInstance used for making HTTP requests.
      */
     constructor(client: AxiosInstance);
     /**
-     * Creates a new ShippingPrice entity.
-     * @param options The options for creating the ShippingPrice entity.
-     * @returns A Promise that resolves to the created ShippingPrice entity.
+     * Lists shipping prices with optional filtering.
+     * @param options - The options for listing shipping prices.
+     * @returns A Promise that resolves to a list of ShippingPrice entities.
      */
-    create(options: ModelCreateOptions<any>): Promise<ShippingPriceEntity>;
+    list(options?: ShippingPriceListOptions): Promise<ListResponse<ShippingPriceEntity>>;
     /**
-     * Finds a ShippingPrice by store ID.
+     * Lists shipping prices for a specific store.
      * @param storeId The store ID to search for.
      * @returns A Promise that resolves to the ShippingPrice entities for the store.
      */

package/build/src/feeef/repositories/stores.d.ts

@@ -1,19 +1,102 @@
 import { AxiosInstance } from 'axios';
-import { ModelRepository, ModelCreateOptions } from './repository.js';
-import { StoreEntity } from '../../core/entities/store.js';
+import { ModelRepository, ListResponse } from './repository.js';
+import { StoreEntity, StoreSummary, StoreMember, StoreSubscriptionType, AddStoreMemberInput, UpdateStoreMemberInput, StoreCreateInput, StoreUpdateInput } from '../../core/entities/store.js';
+/**
+ * Options for listing stores
+ */
+export interface StoreListOptions {
+    page?: number;
+    offset?: number;
+    limit?: number;
+    userId?: string;
+    params?: Record<string, any>;
+}
+/**
+ * Options for getting store summary
+ */
+export interface StoreSummaryOptions {
+    id: string;
+    from?: Date | string;
+    to?: Date | string;
+}
+/**
+ * Result from paying store due
+ */
+export interface PayDueResult {
+    success: boolean;
+    paidAmount: number;
+    remainingDue: number;
+    cost: number;
+}
 /**
  * Repository for managing Store entities.
  */
-export declare class StoreRepository extends ModelRepository<StoreEntity, any, any> {
+export declare class StoreRepository extends ModelRepository<StoreEntity, StoreCreateInput, StoreUpdateInput> {
     /**
      * Constructs a new StoreRepository instance.
      * @param client The AxiosInstance used for making HTTP requests.
      */
     constructor(client: AxiosInstance);
     /**
-     * Creates a new Store entity.
-     * @param options The options for creating the Store entity.
-     * @returns A Promise that resolves to the created Store entity.
+     * Lists stores with optional filtering.
+     * @param options - The options for listing stores.
+     * @returns A Promise that resolves to a list of Store entities.
+     */
+    list(options?: StoreListOptions): Promise<ListResponse<StoreEntity>>;
+    /**
+     * Gets the summary for a store.
+     * @param options - The summary options including store ID and date range.
+     * @returns A Promise that resolves to the store summary.
+     */
+    summary(options: StoreSummaryOptions): Promise<StoreSummary>;
+    /**
+     * Gets the orders chart data for a store.
+     * @param id - The store ID.
+     * @returns A Promise that resolves to a map of date to order count.
+     */
+    chart(id: string): Promise<Map<Date, number>>;
+    /**
+     * Adds a member to the store.
+     * @param storeId - The store ID.
+     * @param data - The member data.
+     * @returns A Promise that resolves to the added member.
+     */
+    addMember(storeId: string, data: AddStoreMemberInput): Promise<StoreMember>;
+    /**
+     * Edits a store member.
+     * @param storeId - The store ID.
+     * @param memberId - The member ID.
+     * @param data - The update data.
+     * @returns A Promise that resolves to the updated member.
+     */
+    editMember(storeId: string, memberId: string, data: UpdateStoreMemberInput): Promise<StoreMember>;
+    /**
+     * Removes a member from the store.
+     * @param storeId - The store ID.
+     * @param memberId - The member ID.
+     * @returns A Promise that resolves when the member is removed.
+     */
+    removeMember(storeId: string, memberId: string): Promise<void>;
+    /**
+     * Upgrades or renews a store's subscription plan.
+     * @param id - The store ID.
+     * @param plan - The plan type to upgrade to.
+     * @param months - The number of months (1-12).
+     * @returns A Promise that resolves when the upgrade is complete.
+     */
+    upgrade(id: string, plan: StoreSubscriptionType, months: number): Promise<void>;
+    /**
+     * Purchases additional points for a store's subscription.
+     * @param id - The store ID.
+     * @param points - The number of points to purchase.
+     * @returns A Promise that resolves when the charge is complete.
+     */
+    charge(id: string, points: number): Promise<void>;
+    /**
+     * Pays store due amount.
+     * @param storeId - The store ID.
+     * @param amount - The amount of due to pay (in points).
+     * @returns A Promise that resolves to the payment result.
      */
-    create(options: ModelCreateOptions<any>): Promise<StoreEntity>;
+    payDue(storeId: string, amount: number): Promise<PayDueResult>;
 }

package/build/src/feeef/repositories/transfers.d.ts

@@ -1,5 +1,9 @@
 import { AxiosInstance } from 'axios';
-import { ModelRepository } from './repository.js';
+import { ModelRepository, ListResponse } from './repository.js';
+/**
+ * Transfer type enum
+ */
+export type TransferType = 'deposit' | 'subscription' | 'points' | 'store_due' | 'user_transfer' | 'ai_generation' | 'refund' | 'adjustment';
 /**
  * Represents a transfer entity for double-entry accounting transactions
  */
@@ -8,7 +12,7 @@ export interface TransferEntity {
     debitAccountId: string;
     creditAccountId: string;
     amount: number;
-    type: 'deposit' | 'subscription' | 'points' | 'store_due' | 'user_transfer' | 'ai_generation' | 'refund' | 'adjustment';
+    type: TransferType;
     referenceId?: string | null;
     description?: string | null;
     metadata: Record<string, any>;
@@ -21,18 +25,71 @@ export interface TransferCreateInput {
     debitAccountId: string;
     creditAccountId: string;
     amount: number;
-    type: TransferEntity['type'];
+    type: TransferType;
     referenceId?: string | null;
     description?: string | null;
     metadata?: Record<string, any>;
 }
+/**
+ * Input data for updating an existing transfer
+ * Note: Transfers are typically immutable, but metadata/description may be updatable
+ */
+export interface TransferUpdateInput {
+    description?: string | null;
+    metadata?: Record<string, any>;
+}
+/**
+ * Options for listing transfers
+ */
+export interface TransferListOptions {
+    page?: number;
+    offset?: number;
+    limit?: number;
+    debitAccountId?: string;
+    creditAccountId?: string;
+    accountId?: string;
+    type?: TransferType | TransferType[];
+    referenceId?: string;
+    createdAfter?: Date | string;
+    createdBefore?: Date | string;
+    minAmount?: number;
+    maxAmount?: number;
+    params?: Record<string, any>;
+}
 /**
  * Repository for managing transfer data
  */
-export declare class TransferRepository extends ModelRepository<TransferEntity, TransferCreateInput, any> {
+export declare class TransferRepository extends ModelRepository<TransferEntity, TransferCreateInput, TransferUpdateInput> {
     /**
      * Constructs a new TransferRepository instance
      * @param client - The AxiosInstance used for making HTTP requests
      */
     constructor(client: AxiosInstance);
+    /**
+     * Lists transfers with optional filtering.
+     * @param options - The options for listing transfers.
+     * @returns A Promise that resolves to a list of Transfer entities.
+     */
+    list(options?: TransferListOptions): Promise<ListResponse<TransferEntity>>;
+    /**
+     * Lists transfers for a specific account (either as debit or credit).
+     * @param accountId - The account ID.
+     * @param options - Optional list options.
+     * @returns A Promise that resolves to a list of Transfer entities.
+     */
+    listByAccount(accountId: string, options?: Omit<TransferListOptions, 'accountId'>): Promise<ListResponse<TransferEntity>>;
+    /**
+     * Lists transfers by type.
+     * @param type - The transfer type(s).
+     * @param options - Optional list options.
+     * @returns A Promise that resolves to a list of Transfer entities.
+     */
+    listByType(type: TransferType | TransferType[], options?: Omit<TransferListOptions, 'type'>): Promise<ListResponse<TransferEntity>>;
+    /**
+     * Lists transfers by reference ID.
+     * @param referenceId - The reference ID.
+     * @param options - Optional list options.
+     * @returns A Promise that resolves to a list of Transfer entities.
+     */
+    listByReferenceId(referenceId: string, options?: Omit<TransferListOptions, 'referenceId'>): Promise<ListResponse<TransferEntity>>;
 }