feeef 0.10.0 → 0.11.1

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

@@ -0,0 +1,63 @@
+/**
+ * Shared types for AIP-style batch operations (`:batchDelete`, `:batchUpdate`, …).
+ *
+ * Repositories override {@link ModelRepository.deleteMany} / `updateMany` / `createMany`
+ * when the API supports them. HTTP 200 does not mean all items succeeded — always
+ * inspect `summary` and `failedRequests`.
+ */
+export interface BatchRpcStatus {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export interface BatchSummary {
+    total: number;
+    succeeded: number;
+    failed: number;
+}
+export declare function batchSummaryHasFailures(summary: BatchSummary): boolean;
+export declare function batchSummaryAllFailed(summary: BatchSummary): boolean;
+export interface BatchResult<T = void> {
+    resources?: T[];
+    failedRequests: Record<string, BatchRpcStatus>;
+    summary: BatchSummary;
+    code?: string;
+    message?: string;
+}
+export interface BatchDeleteRequest {
+    projectId: string;
+    names: string[];
+    returnPartialSuccess?: boolean;
+    requestId?: string;
+}
+export interface BatchUpdateManyRequest {
+    projectId: string;
+    names: string[];
+    updateMask: string[];
+    returnPartialSuccess?: boolean;
+    requestId?: string;
+    /** Hoisted patch fields (storageClass, warehouseId, …). */
+    fields?: Record<string, unknown>;
+}
+export interface BatchCreateManyRequest {
+    projectId: string;
+    items: Record<string, unknown>[];
+    returnPartialSuccess?: boolean;
+    requestId?: string;
+}
+export interface BatchReleaseRequest {
+    projectId: string;
+    names: string[];
+    returnPartialSuccess?: boolean;
+    requestId?: string;
+    toJson?(): Record<string, unknown>;
+}
+export declare function parseBatchRpcStatus(json: Record<string, unknown>): BatchRpcStatus;
+export declare function parseBatchSummary(json: Record<string, unknown>): BatchSummary;
+/**
+ * Parses batch API response from success or 400 ABORTED body.
+ */
+export declare function parseBatchResult<T = void>(data: unknown, resourceFromJson?: (json: Record<string, unknown>) => T): BatchResult<T>;
+export declare function batchDeleteBody(request: BatchDeleteRequest): Record<string, unknown>;
+export declare function batchUpdateManyBody(request: BatchUpdateManyRequest): Record<string, unknown>;
+export declare function batchReleaseBody(request: BatchReleaseRequest): Record<string, unknown>;

package/build/src/core/entities/finance.d.ts

@@ -0,0 +1,355 @@
+/**
+ * Finance module entities (Phase 1: procurement). Project-scoped, mirroring the
+ * backend Lucid models. Money values are returned as numbers (decimal(14,2)).
+ */
+export type PurchaseOrderStatus = 'draft' | 'sent' | 'partial' | 'received' | 'cancelled';
+export type PurchaseReceiptStatus = 'draft' | 'posted' | 'voided';
+export interface Supplier {
+    id: string;
+    projectId: string;
+    name: string;
+    code?: string | null;
+    phone?: string | null;
+    email?: string | null;
+    taxId?: string | null;
+    address?: Record<string, any> | null;
+    paymentTerms?: string | null;
+    metadata?: Record<string, any>;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
+export interface CreateSupplierInput {
+    projectId: string;
+    name: string;
+    code?: string;
+    phone?: string;
+    email?: string;
+    taxId?: string;
+    address?: Record<string, any>;
+    paymentTerms?: string;
+    metadata?: Record<string, any>;
+}
+export interface UpdateSupplierInput {
+    name?: string;
+    code?: string | null;
+    phone?: string | null;
+    email?: string | null;
+    taxId?: string | null;
+    address?: Record<string, any> | null;
+    paymentTerms?: string | null;
+    metadata?: Record<string, any>;
+}
+export interface PurchaseOrderItem {
+    sku: string;
+    productId?: string | null;
+    variantPath?: string;
+    qtyOrdered: number;
+    qtyReceived?: number;
+    unitCost: number;
+    warehouseId?: string | null;
+    batch?: string | null;
+}
+export interface PurchaseOrder {
+    id: string;
+    projectId: string;
+    supplierId: string;
+    status: PurchaseOrderStatus;
+    reference?: string | null;
+    expectedAt?: string | null;
+    notes?: string | null;
+    items: PurchaseOrderItem[];
+    currency?: string | null;
+    subtotal: number;
+    createdByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatePurchaseOrderInput {
+    projectId: string;
+    supplierId: string;
+    reference?: string;
+    expectedAt?: string;
+    notes?: string;
+    items?: PurchaseOrderItem[];
+    currency?: string;
+}
+export interface UpdatePurchaseOrderInput {
+    reference?: string | null;
+    expectedAt?: string | null;
+    notes?: string | null;
+    items?: PurchaseOrderItem[];
+    currency?: string | null;
+}
+export interface PurchaseReceiptLine {
+    id: string;
+    purchaseReceiptId: string;
+    lineNo: number;
+    sku: string;
+    productId?: string | null;
+    variantPath: string;
+    batch: string;
+    inventoryObjectId?: string | null;
+    qtyReceived: number;
+    unitCost: number;
+    lineTotal: number;
+    poLineIndex?: number | null;
+    createdAt: string;
+}
+export interface PurchaseReceipt {
+    id: string;
+    projectId: string;
+    supplierId: string;
+    purchaseOrderId?: string | null;
+    warehouseId?: string | null;
+    status: PurchaseReceiptStatus;
+    reference?: string | null;
+    receivedAt: string;
+    postedAt?: string | null;
+    voidedAt?: string | null;
+    notes?: string | null;
+    totalCost: number;
+    isPosted?: boolean;
+    createdByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lines?: PurchaseReceiptLine[];
+}
+export interface PurchaseReceiptLineInput {
+    sku: string;
+    productId?: string | null;
+    variantPath?: string;
+    batch?: string | null;
+    qtyReceived: number;
+    unitCost: number;
+    poLineIndex?: number | null;
+}
+export interface CreatePurchaseReceiptInput {
+    projectId: string;
+    supplierId: string;
+    purchaseOrderId?: string | null;
+    warehouseId?: string | null;
+    reference?: string;
+    receivedAt?: string;
+    notes?: string;
+    lines: PurchaseReceiptLineInput[];
+}
+export type FinancialAccountType = 'cash' | 'bank' | 'ewallet';
+export type SupplierBillStatus = 'draft' | 'open' | 'partial' | 'paid' | 'void';
+export type ExpenseStatus = 'draft' | 'recorded' | 'voided';
+export interface FinancialAccount {
+    id: string;
+    projectId: string;
+    name: string;
+    type: FinancialAccountType;
+    currency?: string | null;
+    openingBalance: number;
+    isDefault: boolean;
+    metadata?: Record<string, any>;
+    /** Present on `show` (derived). */
+    balance?: number;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
+export interface CreateFinancialAccountInput {
+    projectId: string;
+    name: string;
+    type?: FinancialAccountType;
+    currency?: string;
+    openingBalance?: number;
+    isDefault?: boolean;
+    metadata?: Record<string, any>;
+}
+export interface UpdateFinancialAccountInput {
+    name?: string;
+    type?: FinancialAccountType;
+    currency?: string | null;
+    openingBalance?: number;
+    isDefault?: boolean;
+    metadata?: Record<string, any>;
+}
+export interface SupplierBill {
+    id: string;
+    projectId: string;
+    supplierId: string;
+    purchaseReceiptId?: string | null;
+    reference?: string | null;
+    billDate: string;
+    dueDate?: string | null;
+    currency?: string | null;
+    totalAmount: number;
+    paidAmount: number;
+    balanceDue?: number;
+    status: SupplierBillStatus;
+    notes?: string | null;
+    createdByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    payments?: SupplierPayment[];
+}
+export interface CreateSupplierBillInput {
+    projectId: string;
+    supplierId: string;
+    purchaseReceiptId?: string | null;
+    reference?: string;
+    billDate: string;
+    dueDate?: string | null;
+    currency?: string;
+    totalAmount: number;
+    notes?: string;
+}
+export interface SupplierPayment {
+    id: string;
+    projectId: string;
+    supplierBillId: string;
+    financialAccountId: string;
+    amount: number;
+    paidAt: string;
+    method?: string | null;
+    reference?: string | null;
+    createdByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PaySupplierBillInput {
+    projectId: string;
+    financialAccountId: string;
+    amount: number;
+    paidAt?: string | null;
+    method?: string | null;
+    reference?: string | null;
+    allowOverpay?: boolean;
+}
+export interface CustomerPayment {
+    id: string;
+    projectId: string;
+    orderId: string;
+    financialAccountId: string;
+    amount: number;
+    receivedAt: string;
+    method?: string | null;
+    reference?: string | null;
+    createdByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CollectCustomerPaymentInput {
+    projectId: string;
+    financialAccountId: string;
+    amount: number;
+    receivedAt?: string | null;
+    method?: string | null;
+    reference?: string | null;
+    allowOverpay?: boolean;
+}
+export interface Receivable {
+    orderId: string;
+    storeId: string;
+    total: number;
+    paid: number;
+    balanceDue: number;
+    status: string;
+    deliveryStatus: string;
+    codInTransit: boolean;
+}
+export interface ExpenseCategory {
+    id: string;
+    projectId: string;
+    name: string;
+    parentId?: string | null;
+    metadata?: Record<string, any>;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
+export interface CreateExpenseCategoryInput {
+    projectId: string;
+    name: string;
+    parentId?: string | null;
+    metadata?: Record<string, any>;
+}
+export interface UpdateExpenseCategoryInput {
+    name?: string;
+    parentId?: string | null;
+    metadata?: Record<string, any>;
+}
+export interface Expense {
+    id: string;
+    projectId: string;
+    categoryId?: string | null;
+    supplierId?: string | null;
+    financialAccountId?: string | null;
+    amount: number;
+    currency?: string | null;
+    spentAt: string;
+    paymentMethod?: string | null;
+    status: ExpenseStatus;
+    reference?: string | null;
+    note?: string | null;
+    attachments: any[];
+    createdByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
+export interface CreateExpenseInput {
+    projectId: string;
+    categoryId?: string | null;
+    supplierId?: string | null;
+    financialAccountId?: string | null;
+    amount: number;
+    currency?: string;
+    spentAt: string;
+    paymentMethod?: string | null;
+    status?: ExpenseStatus;
+    reference?: string | null;
+    note?: string | null;
+    attachments?: any[];
+}
+export interface UpdateExpenseInput {
+    categoryId?: string | null;
+    supplierId?: string | null;
+    financialAccountId?: string | null;
+    amount?: number;
+    currency?: string | null;
+    spentAt?: string;
+    paymentMethod?: string | null;
+    status?: ExpenseStatus;
+    reference?: string | null;
+    note?: string | null;
+    attachments?: any[];
+}
+export interface FinanceOverview {
+    cash: number;
+    inventoryValuation: number;
+    accountsReceivable: number;
+    accountsPayable: number;
+    netPosition: number;
+}
+export interface AgingResult {
+    buckets: {
+        label: string;
+        amount: number;
+    }[];
+    total: number;
+}
+export interface CashPosition {
+    accounts: {
+        id: string;
+        name: string;
+        type: FinancialAccountType;
+        currency?: string | null;
+        balance: number;
+    }[];
+    total: number;
+}
+export interface PnlReport {
+    from: string | null;
+    to: string | null;
+    revenue: number;
+    cogs: number;
+    grossProfit: number;
+    expenses: number;
+    netProfit: number;
+}

package/build/src/core/entities/inventory.d.ts

@@ -0,0 +1,80 @@
+export interface Project {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface InventoryWarehouse {
+    id: string;
+    projectId: string;
+    name: string;
+    code: string;
+    metadata?: Record<string, any>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface InventoryObject {
+    id: string;
+    projectId: string;
+    namespace: string;
+    sku: string;
+    batch: string;
+    warehouseId?: string;
+    storageClass: string;
+    key: string;
+    quantityOnHand: number;
+    quantityReserved: number;
+    quantityAvailable: number;
+    receivedAt: string;
+    metadata?: Record<string, any>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface InventoryMovement {
+    id: string;
+    projectId: string;
+    objectId: string;
+    type: 'in' | 'out' | 'adjust' | 'reserve' | 'release' | 'consume';
+    quantityDelta: number;
+    balanceAfter: number;
+    reason?: string;
+    correlationRef?: string;
+    metadata?: Record<string, any>;
+    createdAt: string;
+}
+export interface InventoryReservation {
+    id: string;
+    projectId: string;
+    holderRef: string;
+    metadata?: Record<string, any>;
+    createdAt: string;
+    expiresAt?: string;
+}
+export interface InventoryAlias {
+    id: string;
+    projectId: string;
+    namespace: string;
+    sku: string;
+    alias: string;
+    createdAt: string;
+}
+export interface InventoryReceiveInput {
+    projectId: string;
+    namespace: string;
+    sku: string;
+    batch?: string;
+    quantity: number;
+    warehouseId?: string;
+    storageClass?: string;
+    metadata?: Record<string, any>;
+}
+export interface InventoryDeltaInput {
+    objectId: string;
+    quantityDelta: number;
+}
+export interface InventoryApplyDeltasInput {
+    projectId: string;
+    deltas: InventoryDeltaInput[];
+    reason: string;
+    correlationRef?: string;
+}

package/build/src/core/entities/store.d.ts

@@ -45,6 +45,8 @@ export interface StoreEntity {
     members?: Record<string, StoreMember>;
     /** Active full-site template (`store_templates.id`) when set. */
     templateId?: string | null;
+    /** Linked inventory project ID for stock management. */
+    projectId?: string | null;
 }
 export declare const generatePublicStoreIntegrations: (integrations: StoreIntegrations | null | undefined) => PublicStoreIntegrations | null;
 export declare const generatePublicStoreIntegrationCustomFields: (customFields: any | null | undefined) => PublicCustomFieldsIntegration | null | undefined;
@@ -247,6 +249,51 @@ export interface CreateStoreInviteInput {
     expiresAt?: string;
     metadata?: Record<string, any>;
 }
+/** How order sync handles line items with no inventory bucket for their SKU. */
+export type MissingInventoryBucketPolicy = 'ignore' | 'reject';
+/** When an order field equals `equals`, apply the parent lifecycle list (reserve / release / consume). */
+export interface InventoryLifecycleRule {
+    id: string;
+    dimension: PixelStatusDimension;
+    equals: string;
+}
+export interface InventoryIntegration {
+    reserve_on: OrderStatus[];
+    unreserve_on: OrderStatus[];
+    consume_on: OrderStatus[];
+    reserve_rules?: InventoryLifecycleRule[];
+    unreserve_rules?: InventoryLifecycleRule[];
+    consume_rules?: InventoryLifecycleRule[];
+    /**
+     * `ignore` — skip untracked SKUs and continue the order save.
+     * `reject` — block the order with a stock validation error.
+     * @default ignore
+     */
+    missing_bucket_policy?: MissingInventoryBucketPolicy;
+}
+export type FinancePdfPaperSize = 'a4' | 'letter' | 'a5' | 'legal';
+/** Layout and content options for finance PDF documents. */
+export interface FinancePdfSettings {
+    paperSize: FinancePdfPaperSize;
+    showQrCode: boolean;
+    showLogo: boolean;
+    showStoreContact: boolean;
+    showSupplierDetails: boolean;
+    showDocumentId: boolean;
+    showFooter: boolean;
+    showStatusBadge: boolean;
+    showSignatureLines: boolean;
+    showPaymentHistory: boolean;
+    footerNote: string;
+}
+/** Order → finance behavior: when revenue/COGS are recognized for an order. */
+export interface FinanceIntegration {
+    /** Order statuses at which revenue + COGS are recognized (receivable opens). */
+    recognize_on: OrderStatus[];
+    /** Cash-basis metrics cutoff — payments/expenses before this are ignored. */
+    activated_at?: string | null;
+    pdf?: FinancePdfSettings;
+}
 export interface StoreConfigs {
     currencies: StoreCurrencyConfig[];
     selectedCurrency: string;
@@ -257,6 +304,8 @@ export interface StoreConfigs {
     customStatusMappings?: CustomStatusMapping[];
     /** Feature flag to enable custom statuses across the app */
     customStatusEnabled?: boolean;
+    inventory_integration?: InventoryIntegration;
+    finance_integration?: FinanceIntegration;
 }
 export interface CustomStatusMapping {
     /** The custom status name (e.g., "not_respond", "phone_closed_1") */
@@ -734,6 +783,18 @@ export interface StoreIntegrations {
     mdmExpress?: MdmExpressIntegration;
     security?: SecurityIntegration;
     dispatcher?: DispatcherIntegration;
+    inventory?: StoreInventoryIntegration;
+    finance?: StoreFinanceIntegration;
+}
+/** Marketplace inventory module (billing + active toggle). */
+export interface StoreInventoryIntegration {
+    active: boolean;
+    metadata?: Record<string, any>;
+}
+/** Finance module (procurement + accounting) billing + active toggle. */
+export interface StoreFinanceIntegration {
+    active: boolean;
+    metadata?: Record<string, any>;
 }
 export declare enum StoreSubscriptionStatus {
     active = "active",
@@ -743,8 +804,26 @@ export declare enum StoreSubscriptionType {
     free = "free",
     premium = "premium",
     vip = "vip",
+    ultra = "ultra",
     custom = "custom"
 }
+/** Per-integration billing lifecycle (stored on store.subscription.integrations). */
+export declare enum IntegrationBillingStatus {
+    active = "active",
+    grace = "grace",
+    past_due = "past_due",
+    canceled = "canceled"
+}
+export interface StoreIntegrationSubscription {
+    startAt: DateTime;
+    expiresAt: DateTime | null;
+    status: IntegrationBillingStatus;
+    /** Price snapshot from last successful charge (DZD). */
+    price: number;
+    autoRenew: boolean;
+    failedAttempts: number;
+    nextRetryAt: DateTime | null;
+}
 export interface StoreSubscription {
     type: StoreSubscriptionType;
     name: string;
@@ -755,6 +834,8 @@ export interface StoreSubscription {
     consumed: number;
     remaining: number;
     metadata: Record<string, any>;
+    /** Per-integration paid subscriptions (billing only; credentials stay in store.integrations). */
+    integrations?: Record<string, StoreIntegrationSubscription>;
 }
 /**
  * Input data for creating a new store
@@ -782,6 +863,7 @@ export interface StoreCreateInput {
     tiktokPixelIds?: string[];
     googleAnalyticsId?: string;
     googleTagsId?: string;
+    projectId?: string;
 }
 /**
  * Input data for updating an existing store
@@ -810,6 +892,7 @@ export interface StoreUpdateInput {
     googleAnalyticsId?: string;
     googleTagsId?: string;
     integrations?: StoreIntegrations;
+    projectId?: string;
 }
 /**
  * Store summary data

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.
      */