feeef 0.9.7 → 0.11.0

package/build/src/core/models_catalog.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Multi-provider model catalog (options key `models`).
+ * Re-uses OpenRouter **Models API** types (`Model`, `ModelsListResponse`) for parity with
+ * `curl https://openrouter.ai/api/v1/models` and `@openrouter/sdk`.
+ *
+ * @see https://openrouter.ai/docs/guides/overview/models
+ * @see https://openrouter.ai/docs/api-reference/models/get-models
+ */
+export type { DefaultParameters, InputModality, Model, ModelArchitecture, ModelLinks, ModelsListResponse, OutputModality, Parameter, PerRequestLimits, PublicPricing, TopProviderInfo, } from '@openrouter/sdk/models';
+/** Feeef routing — not part of OpenRouter's schema. */
+export type AiProviderKind = 'google' | 'openai' | 'azure' | 'openrouter';
+export interface ProviderRegistryRow {
+    slug: string;
+    kind: AiProviderKind;
+    baseUrl: string;
+    displayName?: string;
+    name?: string;
+}
+/**
+ * Feeef catalog extensions (not from OpenRouter Models API).
+ * Optional `capabilities.image_generation` drives aspect/output tiers and pricing add-ons.
+ */
+export interface ImageGenerationCapabilitiesWire {
+    allowed_aspect_ratios?: string[];
+    output_size_tiers?: string[];
+    input_resolution_tiers?: string[];
+    params?: {
+        background?: string[];
+        quality?: string[];
+        output_format?: string[];
+    };
+    toggles?: {
+        google_search?: boolean;
+        image_search?: boolean;
+    };
+    pricing_addons_dzd?: {
+        transparent_background?: number;
+    };
+}
+export interface FeeefModelCapabilities {
+    image_generation?: ImageGenerationCapabilitiesWire;
+}
+/** `GET /v1/models` row + `provider_slug` for Feeef's registry lookup. */
+export type ModelCatalogRow = import('@openrouter/sdk/models').Model & {
+    provider_slug: string;
+    capabilities?: FeeefModelCapabilities;
+    /** Azure OpenAI deployment name when it differs from catalog `id`. */
+    azure_deployment?: string;
+};
+export interface ModelsCatalogConfig {
+    providers: ProviderRegistryRow[];
+    data: ModelCatalogRow[];
+}

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

@@ -16,6 +16,8 @@ import { CurrencyRepository } from './repositories/currencies.js';
 import { ShippingPriceRepository } from './repositories/shipping_prices.js';
 import { ShippingMethodRepository } from './repositories/shipping_methods.js';
 import { FeedbackRepository } from './repositories/feedbacks.js';
+import { InventoryRepository } from './repositories/inventory.js';
+import { FinanceRepository } from './repositories/finance.js';
 import { ProductLandingPageTemplatesRepository } from './repositories/product_landing_page_templates.js';
 import { ProductLandingPagesRepository } from './repositories/product_landing_pages.js';
 import { ImagePromptTemplatesRepository } from './repositories/image_prompt_templates.js';
@@ -160,6 +162,14 @@ export declare class FeeeF {
      * The repository for managing feedbacks.
      */
     feedbacks: FeedbackRepository;
+    /**
+     * The repository for managing inventory.
+     */
+    inventory: InventoryRepository;
+    /**
+     * The repository for managing finance (procurement: suppliers, POs, receipts).
+     */
+    finance: FinanceRepository;
     /**
      * The cart service for managing the cart.
      */

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

@@ -0,0 +1,156 @@
+import { AxiosInstance } from 'axios';
+import { type BatchDeleteRequest, type BatchResult } from '../../core/batch.js';
+import { Supplier, CreateSupplierInput, UpdateSupplierInput, PurchaseOrder, CreatePurchaseOrderInput, UpdatePurchaseOrderInput, PurchaseOrderStatus, PurchaseReceipt, CreatePurchaseReceiptInput, FinancialAccount, CreateFinancialAccountInput, UpdateFinancialAccountInput, SupplierBill, CreateSupplierBillInput, PaySupplierBillInput, SupplierPayment, CustomerPayment, CollectCustomerPaymentInput, Receivable, Expense, CreateExpenseInput, UpdateExpenseInput, ExpenseCategory, CreateExpenseCategoryInput, UpdateExpenseCategoryInput, FinanceOverview, AgingResult, CashPosition, PnlReport } from '../../core/entities/finance.js';
+import { ModelRepository, ListResponse } from './repository.js';
+/** Suppliers (`/finance/suppliers`). */
+export declare class SupplierRepository extends ModelRepository<Supplier, CreateSupplierInput, UpdateSupplierInput> {
+    constructor(client: AxiosInstance);
+    deleteMany(request: BatchDeleteRequest): Promise<BatchResult<Supplier>>;
+}
+/** Purchase orders (`/finance/purchase-orders`). */
+export declare class PurchaseOrderRepository extends ModelRepository<PurchaseOrder, CreatePurchaseOrderInput, UpdatePurchaseOrderInput> {
+    constructor(client: AxiosInstance);
+    /** Transition the PO to `sent`. */
+    send(options: {
+        projectId: string;
+        id: string;
+    }): Promise<PurchaseOrder>;
+    /** Transition the PO to `cancelled`. */
+    cancel(options: {
+        projectId: string;
+        id: string;
+    }): Promise<PurchaseOrder>;
+    /** Set an explicit status (state machine enforced server-side). */
+    setStatus(options: {
+        projectId: string;
+        id: string;
+        status: PurchaseOrderStatus;
+    }): Promise<PurchaseOrder>;
+}
+/** Purchase receipts (`/finance/purchase-receipts`). */
+export declare class PurchaseReceiptRepository extends ModelRepository<PurchaseReceipt, CreatePurchaseReceiptInput, never> {
+    constructor(client: AxiosInstance);
+    update(): Promise<PurchaseReceipt>;
+    /** Post the receipt: stock goods into inventory at batch cost (idempotent). */
+    post(options: {
+        projectId: string;
+        id: string;
+    }): Promise<PurchaseReceipt>;
+    /** Void a posted receipt: reverse its stock-in. */
+    void(options: {
+        projectId: string;
+        id: string;
+    }): Promise<PurchaseReceipt>;
+}
+/** Financial accounts — cash / bank / e-wallet (`/finance/financial-accounts`). */
+export declare class FinancialAccountRepository extends ModelRepository<FinancialAccount, CreateFinancialAccountInput, UpdateFinancialAccountInput> {
+    constructor(client: AxiosInstance);
+    deleteMany(request: BatchDeleteRequest): Promise<BatchResult<FinancialAccount>>;
+}
+/** Supplier bills — Accounts Payable (`/finance/supplier-bills`). */
+export declare class SupplierBillRepository extends ModelRepository<SupplierBill, CreateSupplierBillInput, never> {
+    constructor(client: AxiosInstance);
+    update(): Promise<SupplierBill>;
+    /** Record a (partial) payment against a bill. */
+    pay(options: {
+        id: string;
+    } & PaySupplierBillInput): Promise<{
+        bill: SupplierBill;
+        payment: SupplierPayment;
+    }>;
+}
+/** Supplier payments (`/finance/supplier-payments`). */
+export declare class SupplierPaymentRepository extends ModelRepository<SupplierPayment, never, never> {
+    constructor(client: AxiosInstance);
+    /** Void a payment and recompute the parent bill. */
+    void(options: {
+        projectId: string;
+        id: string;
+    }): Promise<SupplierBill>;
+}
+/** Customer payments — Accounts Receivable collection (`/finance/customer-payments`). */
+export declare class CustomerPaymentRepository extends ModelRepository<CustomerPayment, never, never> {
+    constructor(client: AxiosInstance);
+    /** Void a customer payment. */
+    void(options: {
+        projectId: string;
+        id: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+}
+/** Expenses (`/finance/expenses`). */
+export declare class ExpenseRepository extends ModelRepository<Expense, CreateExpenseInput, UpdateExpenseInput> {
+    constructor(client: AxiosInstance);
+    deleteMany(request: BatchDeleteRequest): Promise<BatchResult<Expense>>;
+}
+/** Expense categories (`/finance/expense-categories`). */
+export declare class ExpenseCategoryRepository extends ModelRepository<ExpenseCategory, CreateExpenseCategoryInput, UpdateExpenseCategoryInput> {
+    constructor(client: AxiosInstance);
+}
+/**
+ * Finance API facade. Use sub-repositories for CRUD and document ops; top-level
+ * helpers cover AR collection and reports.
+ */
+export declare class FinanceRepository {
+    readonly suppliers: SupplierRepository;
+    readonly purchaseOrders: PurchaseOrderRepository;
+    readonly purchaseReceipts: PurchaseReceiptRepository;
+    readonly financialAccounts: FinancialAccountRepository;
+    readonly supplierBills: SupplierBillRepository;
+    readonly supplierPayments: SupplierPaymentRepository;
+    readonly customerPayments: CustomerPaymentRepository;
+    readonly expenses: ExpenseRepository;
+    readonly expenseCategories: ExpenseCategoryRepository;
+    readonly client: AxiosInstance;
+    constructor(client: AxiosInstance);
+    listSuppliers(options?: {
+        projectId: string;
+        page?: number;
+        limit?: number;
+        params?: Record<string, unknown>;
+    }): Promise<ListResponse<Supplier>>;
+    /** Open order receivables (derived, read-only). */
+    listReceivables(options: {
+        projectId: string;
+    }): Promise<Receivable[]>;
+    /** Record a customer / COD payment against an order. */
+    collectPayment(options: {
+        orderId: string;
+    } & CollectCustomerPaymentInput): Promise<CustomerPayment>;
+    overview(options: {
+        projectId: string;
+    }): Promise<FinanceOverview>;
+    cashPosition(options: {
+        projectId: string;
+    }): Promise<CashPosition>;
+    apAging(options: {
+        projectId: string;
+    }): Promise<AgingResult>;
+    arAging(options: {
+        projectId: string;
+    }): Promise<AgingResult>;
+    pnl(options: {
+        projectId: string;
+        from?: string;
+        to?: string;
+    }): Promise<PnlReport>;
+    listGlAccounts(options: {
+        projectId: string;
+        type?: string;
+    }): Promise<any>;
+    listJournalEntries(options: {
+        projectId: string;
+        status?: string;
+        from?: string;
+        to?: string;
+    }): Promise<any>;
+    trialBalance(options: {
+        projectId: string;
+        asOf?: string;
+    }): Promise<any>;
+    balanceSheet(options: {
+        projectId: string;
+        asOf?: string;
+    }): Promise<any>;
+}

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

@@ -0,0 +1,159 @@
+import { AxiosInstance } from 'axios';
+import { type BatchDeleteRequest, type BatchReleaseRequest, type BatchResult, type BatchUpdateManyRequest } from '../../core/batch.js';
+import { InventoryObject, Project, InventoryMovement, InventoryAlias, InventoryWarehouse, InventoryReservation, InventoryReceiveInput, InventoryApplyDeltasInput } from '../../core/entities/inventory.js';
+import { ModelRepository, ListResponse } from './repository.js';
+/** Typed batch update for inventory objects (`objects.updateMany`). */
+export declare class InventoryBatchUpdateObjectsRequest implements BatchUpdateManyRequest {
+    projectId: string;
+    names: string[];
+    updateMask: string[];
+    returnPartialSuccess?: boolean;
+    requestId?: string;
+    readonly fields: Record<string, unknown>;
+    constructor(options: {
+        projectId: string;
+        names: string[];
+        updateMask: string[];
+        storageClass?: string;
+        warehouseId?: string;
+        namespace?: string;
+        batch?: string;
+        priority?: number;
+        expiresAt?: string;
+        returnPartialSuccess?: boolean;
+        requestId?: string;
+    });
+}
+/** Inventory stock objects (`/inventory/objects`). */
+export declare class InventoryObjectRepository extends ModelRepository<InventoryObject, InventoryReceiveInput, Record<string, unknown>> {
+    constructor(client: AxiosInstance);
+    find(options: {
+        id: string;
+        params?: Record<string, unknown>;
+    }): Promise<InventoryObject>;
+    list(options?: {
+        page?: number;
+        offset?: number;
+        limit?: number;
+        params?: Record<string, unknown>;
+    }): Promise<ListResponse<InventoryObject>>;
+    create(data: InventoryReceiveInput): Promise<InventoryObject>;
+    update(options: {
+        id: string;
+        data: Record<string, unknown>;
+        params?: Record<string, unknown>;
+    }): Promise<InventoryObject>;
+    delete(options: {
+        id: string;
+        params?: Record<string, unknown>;
+    }): Promise<void>;
+    deleteMany(request: BatchDeleteRequest): Promise<BatchResult<InventoryObject>>;
+    updateMany(request: BatchUpdateManyRequest | InventoryBatchUpdateObjectsRequest): Promise<BatchResult<InventoryObject>>;
+    applyDeltas(data: InventoryApplyDeltasInput): Promise<void>;
+}
+export declare class InventoryWarehouseRepository extends ModelRepository<InventoryWarehouse, {
+    projectId: string;
+    name: string;
+    code: string;
+    namespacePrefix?: string;
+}, Record<string, unknown>> {
+    constructor(client: AxiosInstance);
+    list(options?: {
+        params?: Record<string, unknown>;
+    }): Promise<ListResponse<InventoryWarehouse>>;
+    create(data: {
+        projectId: string;
+        name: string;
+        code: string;
+        namespacePrefix?: string;
+    }): Promise<InventoryWarehouse>;
+    delete(options: {
+        id: string;
+        params?: Record<string, unknown>;
+    }): Promise<void>;
+    deleteMany(request: BatchDeleteRequest): Promise<BatchResult<InventoryWarehouse>>;
+}
+export declare class InventoryAliasRepository extends ModelRepository<InventoryAlias, {
+    projectId: string;
+    alias: string;
+    targetSku: string;
+}, {
+    targetSku: string;
+}> {
+    constructor(client: AxiosInstance);
+    list(options?: {
+        params?: Record<string, unknown>;
+    }): Promise<ListResponse<InventoryAlias>>;
+    create(data: {
+        projectId: string;
+        alias: string;
+        targetSku: string;
+    }): Promise<InventoryAlias>;
+    update(options: {
+        id: string;
+        data: {
+            targetSku: string;
+        };
+        params?: Record<string, unknown>;
+    }): Promise<InventoryAlias>;
+    delete(options: {
+        id: string;
+        params?: Record<string, unknown>;
+    }): Promise<void>;
+    deleteMany(request: BatchDeleteRequest): Promise<BatchResult<InventoryAlias>>;
+}
+export declare class InventoryReservationRepository extends ModelRepository<InventoryReservation, never, never> {
+    constructor(client: AxiosInstance);
+    find(options: {
+        id: string;
+        params?: Record<string, unknown>;
+    }): Promise<InventoryReservation>;
+    list(options?: {
+        params?: Record<string, unknown>;
+    }): Promise<ListResponse<InventoryReservation>>;
+    create(): Promise<InventoryReservation>;
+    update(): Promise<InventoryReservation>;
+    delete(): Promise<void>;
+    release(options: {
+        projectId: string;
+        id: string;
+    }): Promise<void>;
+    releaseMany(request: BatchReleaseRequest): Promise<BatchResult<void>>;
+}
+export declare class InventoryMovementRepository extends ModelRepository<InventoryMovement, never, never> {
+    constructor(client: AxiosInstance);
+    list(options?: {
+        params?: Record<string, unknown>;
+    }): Promise<ListResponse<InventoryMovement>>;
+    create(): Promise<InventoryMovement>;
+    update(): Promise<InventoryMovement>;
+    delete(): Promise<void>;
+}
+/**
+ * Inventory API facade. Use sub-repositories for CRUD and batch ops.
+ */
+export declare class InventoryRepository {
+    readonly objects: InventoryObjectRepository;
+    readonly warehouses: InventoryWarehouseRepository;
+    readonly aliases: InventoryAliasRepository;
+    readonly reservations: InventoryReservationRepository;
+    readonly movements: InventoryMovementRepository;
+    readonly client: AxiosInstance;
+    constructor(client: AxiosInstance);
+    availability(params: {
+        projectId: string;
+        skus: string[];
+    }): Promise<Record<string, number>>;
+    reservationsByHolder(params: {
+        projectId: string;
+        holderRef: string;
+    }): Promise<ListResponse<InventoryReservation>>;
+    listProjects(): Promise<ListResponse<Project>>;
+    createProject(data: {
+        name: string;
+    }): Promise<Project>;
+    publicAvailability(data: {
+        storeId: string;
+        skus: string[];
+    }): Promise<Record<string, number>>;
+}

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

@@ -155,4 +155,20 @@ export declare class OrderRepository extends ModelRepository<OrderEntity, OrderC
     assignMany(data: AssignManyOrdersSchema): Promise<{
         message: string;
     }>;
+    /**
+     * Returns items from an order to inventory.
+     * @param data - The return data including orderId, reason, and deltas.
+     */
+    returnOrder(data: {
+        orderId: string;
+        reason: string;
+        correlationRef?: string;
+        deltas: {
+            objectId: string;
+            quantityDelta: number;
+            storageClass?: string;
+        }[];
+    }): Promise<{
+        message: string;
+    }>;
 }

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

@@ -1,4 +1,5 @@
 import { AxiosInstance } from 'axios';
+import { type BatchCreateManyRequest, type BatchDeleteRequest, type BatchResult, type BatchUpdateManyRequest } from '../../core/batch.js';
 /**
  * Represents a generic model repository.
  * @template T - The type of the model.
@@ -48,6 +49,39 @@ export declare abstract class ModelRepository<T, C, U> {
      * @returns A promise that resolves when the model is deleted.
      */
     delete(options: ModelFindOptions): Promise<void>;
+    /**
+     * Batch delete by resource name/id (`POST /{resource}:batchDelete`).
+     * Override on repositories that support batch delete.
+     */
+    deleteMany(_request: BatchDeleteRequest): Promise<BatchResult<T>>;
+    /**
+     * Batch update with field mask (`POST /{resource}:batchUpdate`).
+     */
+    updateMany(_request: BatchUpdateManyRequest): Promise<BatchResult<T>>;
+    /**
+     * Batch create (`POST /{resource}:batchCreate`).
+     */
+    createMany(_request: BatchCreateManyRequest): Promise<BatchResult<T>>;
+    /**
+     * POST `/{resource}:batchDelete` — used by inventory resource repositories.
+     */
+    protected postBatchDelete(request: BatchDeleteRequest): Promise<BatchResult<T>>;
+    /**
+     * POST `/{resource}:batchUpdate`.
+     */
+    protected postBatchUpdate(request: BatchUpdateManyRequest): Promise<BatchResult<T>>;
+    /**
+     * POST `/{resource}:batchCreate`.
+     */
+    protected postBatchCreate(request: BatchCreateManyRequest): Promise<BatchResult<T>>;
+    /** `POST /{resource}:{action}` for custom batch endpoints (e.g. `:batchRelease`). */
+    protected postBatchAction(action: string, body: Record<string, unknown>): Promise<BatchResult<T>>;
+    /**
+     * Parses batch envelope from 200 or 400 ABORTED responses.
+     *
+     * Use `postBatch<void>(...)` when the API returns no `resources` array.
+     */
+    protected postBatch<R = T>(path: string, body: Record<string, unknown>, resourceFromJson?: (json: Record<string, unknown>) => R): Promise<BatchResult<R>>;
 }
 /**
  * Represents a list response containing an array of data of type T.

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

@@ -3,7 +3,7 @@ import { ModelRepository, ListResponse } from './repository.js';
 /**
  * Transfer type enum
  */
-export type TransferType = 'deposit' | 'subscription' | 'points' | 'store_due' | 'user_transfer' | 'ai_generation' | 'refund' | 'adjustment';
+export type TransferType = 'deposit' | 'subscription' | 'points' | 'store_due' | 'user_transfer' | 'ai_generation' | 'integration_subscription' | 'refund' | 'adjustment';
 /**
  * Represents a transfer entity for double-entry accounting transactions
  */

package/build/src/feeef/services/integrations.d.ts

@@ -74,6 +74,14 @@ export interface EcotrackSyncResult {
     totalFetched?: number;
     totalUpdated?: number;
     totalSkipped?: number;
+    /** COD payout batches processed from Ecotrack cash-in history. */
+    totalCashinTransactions?: number;
+    /** Orders marked payment_status received from cash-in sync. */
+    totalPaymentReceived?: number;
+    /** Customer payments created in Finance from cash-in sync. */
+    totalFinancePaymentsCreated?: number;
+    /** Total amount collected into Finance from cash-in sync. */
+    totalFinanceAmountCollected?: number;
     syncedAt?: string;
     errors?: string[];
 }
@@ -83,6 +91,8 @@ export interface EcotrackSyncResult {
 export interface EcotrackSyncStatus {
     canSync: boolean;
     lastSyncAt?: string;
+    /** Latest Ecotrack cash-in transaction archived-at processed (integration metadata). */
+    lastCashinSyncAt?: string;
     nextSyncAvailableAt?: string;
     minutesUntilNextSync?: number;
 }
@@ -121,6 +131,12 @@ export declare class EcotrackDeliveryIntegrationApi {
         startDate?: Date | string;
         endDate?: Date | string;
     }): Promise<EcotrackSyncResult>;
+    /**
+     * Sync only COD payouts received by the merchant (Ecotrack cash-in history).
+     */
+    triggerCashinSync(options?: {
+        forceAll?: boolean;
+    }): Promise<EcotrackSyncResult>;
 }
 /**
  * Yalidine agent type

package/build/src/index.d.ts

@@ -1,4 +1,5 @@
 export * from './feeef/feeef.js';
+export * from './core/models_catalog.js';
 export * from './delivery/parcel.js';
 export * from './delivery/delivery_carrier_client.js';
 export * from './core/entities/order.js';
@@ -20,6 +21,9 @@ export * from './core/entities/state.js';
 export * from './core/entities/city.js';
 export * from './core/entities/currency.js';
 export * from './core/entities/feedback.js';
+export * from './core/entities/inventory.js';
+export * from './core/entities/finance.js';
+export * from './core/batch.js';
 export * from './feeef/repositories/repository.js';
 export * from './feeef/repositories/apps.js';
 export * from './feeef/repositories/oauth.js';
@@ -43,6 +47,8 @@ export * from './feeef/repositories/countries.js';
 export * from './feeef/repositories/states.js';
 export * from './feeef/repositories/cities.js';
 export * from './feeef/repositories/currencies.js';
+export * from './feeef/repositories/inventory.js';
+export * from './feeef/repositories/finance.js';
 export type { AppEntity, AppCreateInput, AppUpdateInput } from './feeef/repositories/apps.js';
 export type { TransferEntity, TransferCreateInput, TransferUpdateInput, TransferType, TransferListOptions, } from './feeef/repositories/transfers.js';
 export type { DepositEntity, DepositCreateInput, DepositUpdateInput, DepositStatus, DepositListOptions, PayPalOrderResponse, PayPalCaptureResponse, } from './feeef/repositories/deposits.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feeef",
   "description": "feeef sdk for javascript",
-  "version": "0.9.7",
+  "version": "0.11.0",
   "main": "build/index.js",
   "type": "module",
   "files": [
@@ -38,6 +38,7 @@
     "@japa/snapshot": "^2.0.5",
     "@swc/core": "^1.5.3",
     "@types/dlv": "^1.1.4",
+    "@types/luxon": "^3.4.2",
     "@types/node": "^20.12.10",
     "ajv": "^8.13.0",
     "benchmark": "^2.1.4",
@@ -51,11 +52,11 @@
     "release-it": "^17.2.1",
     "ts-node": "^10.9.2",
     "tsup": "^8.0.2",
-    "typescript": "^5.4.5",
-    "@types/luxon": "^3.4.2"
+    "typescript": "^5.4.5"
   },
   "dependencies": {
     "@adonisjs/transmit-client": "^1.0.0",
+    "@openrouter/sdk": "^0.12.26",
     "axios": "^1.6.8",
     "axios-cache-interceptor": "^1.5.1",
     "luxon": "^3.5.0"