@classytic/commerce-sdk 0.1.0

package/dist/stock-DEApGC-w.d.ts

@@ -0,0 +1,632 @@
+import { P as PaginatedResponse, A as ApiResponse, B as BaseApi, R as RequestOptions } from './api-factory-B_h4RKBm.js';
+import { af as AdjustStockResult, ac as CreateAdjustmentPayload, ae as AdjustStockPayload, w as StockMovement, ai as MovementQueryParams, ag as LowStockItem, a8 as StockRequest, a9 as CreateStockRequestPayload, _ as Transfer, $ as CreateTransferPayload, a1 as UpdateTransferPayload, ah as TransferStats, a2 as DispatchTransferPayload, a3 as ReceiveTransferPayload, H as Purchase, I as CreatePurchasePayload, U as UpdatePurchasePayload, C as PurchaseActionType, v as StockEntry } from './inventory-DCiIZh8P.js';
+
+/**
+ * Supplier (Vendor) Types
+ *
+ * Types for supplier management in the inventory module.
+ */
+
+type SupplierType = "local" | "import" | "manufacturer" | "wholesaler";
+type SupplierPaymentTerms = "cash" | "credit";
+interface Supplier {
+    _id: string;
+    /** Supplier name (unique for active suppliers) */
+    name: string;
+    /** Auto-generated code (e.g., SUP-0001) */
+    code?: string;
+    /** Supplier type */
+    type?: SupplierType;
+    /** Primary contact person */
+    contactPerson?: string;
+    /** Phone number */
+    phone?: string;
+    /** Email address */
+    email?: string;
+    /** Address */
+    address?: string;
+    /** Tax ID or BIN */
+    taxId?: string;
+    /** Payment terms */
+    paymentTerms?: SupplierPaymentTerms;
+    /** Credit days (0 for cash) */
+    creditDays?: number;
+    /** Credit limit in BDT */
+    creditLimit?: number;
+    /** Opening payable balance */
+    openingBalance?: number;
+    /** Internal notes */
+    notes?: string;
+    /** Free-form tags */
+    tags?: string[];
+    /** Active/inactive status */
+    isActive?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface SupplierCreatePayload {
+    name: string;
+    code?: string;
+    type?: SupplierType;
+    contactPerson?: string;
+    phone?: string;
+    email?: string;
+    address?: string;
+    taxId?: string;
+    paymentTerms?: SupplierPaymentTerms;
+    creditDays?: number;
+    creditLimit?: number;
+    openingBalance?: number;
+    notes?: string;
+    tags?: string[];
+    isActive?: boolean;
+}
+interface SupplierUpdatePayload {
+    name?: string;
+    code?: string;
+    type?: SupplierType;
+    contactPerson?: string;
+    phone?: string;
+    email?: string;
+    address?: string;
+    taxId?: string;
+    paymentTerms?: SupplierPaymentTerms;
+    creditDays?: number;
+    creditLimit?: number;
+    openingBalance?: number;
+    notes?: string;
+    tags?: string[];
+    isActive?: boolean;
+}
+interface SupplierQueryParams {
+    page?: number;
+    limit?: number;
+    after?: string;
+    sort?: string | Record<string, 1 | -1 | "asc" | "desc">;
+    search?: string;
+    name?: string;
+    type?: SupplierType;
+    paymentTerms?: SupplierPaymentTerms;
+    isActive?: boolean;
+    [key: string]: unknown;
+}
+type SupplierListResponse = PaginatedResponse<Supplier>;
+type SupplierResponse = ApiResponse<Supplier>;
+
+/**
+ * Supplier (Vendor) API
+ *
+ * Base path: /api/v1/inventory/suppliers
+ *
+ * Standard CRUD (inherited from BaseApi):
+ * - getAll({ token, params }) - list with filtering/search/pagination
+ * - getById({ token, id }) - get by ID
+ * - create({ token, data }) - create supplier
+ * - update({ token, id, data }) - update supplier
+ * - delete({ token, id }) - deactivate supplier (soft delete)
+ */
+
+declare class SupplierApi extends BaseApi<Supplier, SupplierCreatePayload, SupplierUpdatePayload> {
+    constructor(config?: {});
+}
+declare const supplierApi: SupplierApi;
+
+/**
+ * Adjustment API - Manual Stock Corrections
+ *
+ * Handles manual stock adjustments (add, remove, set).
+ * Creates adjustment movements and optionally expense transactions.
+ */
+
+type FetchOptions$5 = Omit<RequestOptions, "token" | "organizationId">;
+declare class AdjustmentApi extends BaseApi<AdjustStockResult, CreateAdjustmentPayload> {
+    constructor(config?: {});
+    /**
+     * Create a manual stock adjustment
+     * POST /inventory/adjustments
+     *
+     * @example Single item adjustment
+     * adjustmentApi.create({
+     *   token,
+     *   data: {
+     *     productId: '...',
+     *     variantSku: 'SKU-RED-M',
+     *     quantity: 5,
+     *     mode: 'remove',
+     *     reason: 'damaged',
+     *     lostAmount: 2500 // Creates expense transaction (opt-in)
+     *   }
+     * })
+     *
+     * @example Bulk adjustment
+     * adjustmentApi.create({
+     *   token,
+     *   data: {
+     *     adjustments: [
+     *       { productId: '...', quantity: 5, mode: 'add' },
+     *       { productId: '...', quantity: 3, mode: 'remove' }
+     *     ],
+     *     reason: 'inventory recount'
+     *   }
+     * })
+     */
+    create({ token, data, options, }: {
+        token: string;
+        data: CreateAdjustmentPayload;
+        options?: FetchOptions$5;
+    }): Promise<ApiResponse<AdjustStockResult>>;
+    /**
+     * Adjust stock (single item, POS format)
+     * POST /inventory/adjustments
+     */
+    adjustStock({ token, data, options, }: {
+        token: string;
+        data: AdjustStockPayload;
+        options?: FetchOptions$5;
+    }): Promise<ApiResponse<AdjustStockResult>>;
+    /**
+     * Add stock to a product
+     */
+    addStock({ token, productId, variantSku, quantity, branchId, reason, options, }: {
+        token: string;
+        productId: string;
+        variantSku?: string;
+        quantity: number;
+        branchId?: string;
+        reason?: string;
+        options?: FetchOptions$5;
+    }): Promise<ApiResponse<AdjustStockResult>>;
+    /**
+     * Remove stock from a product
+     */
+    removeStock({ token, productId, variantSku, quantity, branchId, reason, lostAmount, options, }: {
+        token: string;
+        productId: string;
+        variantSku?: string;
+        quantity: number;
+        branchId?: string;
+        reason?: string;
+        lostAmount?: number;
+        options?: FetchOptions$5;
+    }): Promise<ApiResponse<AdjustStockResult>>;
+    /**
+     * Set stock to a specific quantity
+     */
+    setStock({ token, productId, variantSku, quantity, branchId, reason, options, }: {
+        token: string;
+        productId: string;
+        variantSku?: string;
+        quantity: number;
+        branchId?: string;
+        reason?: string;
+        options?: FetchOptions$5;
+    }): Promise<ApiResponse<AdjustStockResult>>;
+}
+declare const adjustmentApi: AdjustmentApi;
+
+/**
+ * Movement API - Stock Audit Trail
+ *
+ * Every stock change creates an immutable StockMovement record.
+ * Types: purchase, sale, return, adjustment, transfer_in, transfer_out, initial, recount
+ */
+
+type FetchOptions$4 = Omit<RequestOptions, "token" | "organizationId">;
+declare class MovementApi extends BaseApi<StockMovement> {
+    constructor(config?: {});
+    /**
+     * Get stock movements (audit trail)
+     * GET /inventory/movements
+     *
+     * @param params - Filters (productId, branchId, type, startDate, endDate, page, limit, sort, after/cursor)
+     */
+    list({ token, params, options, }: {
+        token: string;
+        params?: MovementQueryParams;
+        options?: FetchOptions$4;
+    }): Promise<PaginatedResponse<StockMovement>>;
+    /**
+     * Get movements by type
+     * GET /inventory/movements?type=<type>
+     */
+    listByType({ token, type, params, options, }: {
+        token: string;
+        type: StockMovement["type"];
+        params?: Omit<MovementQueryParams, "type">;
+        options?: FetchOptions$4;
+    }): Promise<PaginatedResponse<StockMovement>>;
+    /**
+     * Get movements for a specific product
+     * GET /inventory/movements?productId=<id>
+     */
+    listByProduct({ token, productId, params, options, }: {
+        token: string;
+        productId: string;
+        params?: Omit<MovementQueryParams, "productId">;
+        options?: FetchOptions$4;
+    }): Promise<PaginatedResponse<StockMovement>>;
+    /**
+     * Get low stock items
+     * GET /inventory/low-stock
+     */
+    lowStock({ token, params, options, }: {
+        token: string;
+        params?: {
+            branchId?: string;
+            threshold?: number;
+        };
+        options?: FetchOptions$4;
+    }): Promise<ApiResponse<LowStockItem[]>>;
+}
+declare const movementApi: MovementApi;
+
+/**
+ * Stock Request API - Sub-branch -> Head Office requests
+ *
+ * Handles stock requests from sub-branches following the Stripe action-based pattern.
+ * Status flow: pending -> approved -> fulfilled (or rejected/cancelled)
+ */
+
+type FetchOptions$3 = Omit<RequestOptions, "token" | "organizationId">;
+declare class RequestApi extends BaseApi<StockRequest, CreateStockRequestPayload> {
+    constructor(config?: {});
+    /**
+     * List stock requests
+     * GET /inventory/requests
+     */
+    list({ token, params, options, }: {
+        token: string;
+        params?: Record<string, unknown>;
+        options?: FetchOptions$3;
+    }): Promise<PaginatedResponse<StockRequest>>;
+    /**
+     * List pending stock requests
+     * GET /inventory/requests?status=pending
+     */
+    listPending({ token, options, }: {
+        token: string;
+        options?: FetchOptions$3;
+    }): Promise<PaginatedResponse<StockRequest>>;
+    /**
+     * Get stock request by ID
+     * GET /inventory/requests/:id
+     */
+    getById({ token, id, options, }: {
+        token: string;
+        id: string;
+        options?: FetchOptions$3;
+    }): Promise<ApiResponse<StockRequest>>;
+    /**
+     * Create a stock request
+     * POST /inventory/requests
+     */
+    create({ token, data, options, }: {
+        token: string;
+        data: CreateStockRequestPayload;
+        options?: FetchOptions$3;
+    }): Promise<ApiResponse<StockRequest>>;
+    /**
+     * Generic action endpoint
+     * POST /inventory/requests/:id/action
+     */
+    action({ token, id, action, data, options, }: {
+        token: string;
+        id: string;
+        action: "approve" | "reject" | "fulfill" | "cancel";
+        data?: Record<string, unknown>;
+        options?: FetchOptions$3;
+    }): Promise<ApiResponse<StockRequest>>;
+    /**
+     * Approve a stock request
+     */
+    approve({ token, id, items, reviewNotes, notes, options, }: {
+        token: string;
+        id: string;
+        items?: {
+            productId: string;
+            variantSku?: string;
+            quantityApproved: number;
+        }[];
+        reviewNotes?: string;
+        notes?: string;
+        options?: FetchOptions$3;
+    }): Promise<ApiResponse<StockRequest>>;
+    /**
+     * Reject a stock request
+     */
+    reject({ token, id, reason, options, }: {
+        token: string;
+        id: string;
+        reason: string;
+        options?: FetchOptions$3;
+    }): Promise<ApiResponse<StockRequest>>;
+    /**
+     * Fulfill a stock request (creates a transfer)
+     * Head office assigns carton numbers here for label printing
+     */
+    fulfill({ token, id, remarks, documentType, items, transport, options, }: {
+        token: string;
+        id: string;
+        remarks?: string;
+        documentType?: string;
+        items?: {
+            productId: string;
+            variantSku?: string;
+            quantity: number;
+            cartonNumber?: string;
+        }[];
+        transport?: {
+            vehicleNumber?: string;
+            driverName?: string;
+            driverPhone?: string;
+        };
+        options?: FetchOptions$3;
+    }): Promise<ApiResponse<StockRequest>>;
+    /**
+     * Cancel a stock request
+     */
+    cancel({ token, id, reason, options, }: {
+        token: string;
+        id: string;
+        reason?: string;
+        options?: FetchOptions$3;
+    }): Promise<ApiResponse<StockRequest>>;
+}
+declare const requestApi: RequestApi;
+
+/**
+ * Transfer API - Inter-branch Stock Movement
+ *
+ * Handles challan/transfer documents following the Stripe action-based pattern.
+ * Status flow: draft -> approved -> dispatched -> in_transit -> received
+ */
+
+type FetchOptions$2 = Omit<RequestOptions, "token" | "organizationId">;
+declare class TransferApi extends BaseApi<Transfer, CreateTransferPayload, UpdateTransferPayload> {
+    constructor(config?: {});
+    /**
+     * List transfers with filtering
+     * GET /inventory/transfers
+     */
+    list({ token, params, options, }: {
+        token: string;
+        params?: Record<string, unknown>;
+        options?: FetchOptions$2;
+    }): Promise<PaginatedResponse<Transfer>>;
+    /**
+     * Get transfer by ID or challan number
+     * GET /inventory/transfers/:id
+     */
+    getById({ token, id, options, }: {
+        token: string;
+        id: string;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Create a new transfer (draft)
+     * POST /inventory/transfers
+     */
+    create({ token, data, options, }: {
+        token: string;
+        data: CreateTransferPayload;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Update a draft transfer
+     * PATCH /inventory/transfers/:id
+     */
+    update({ token, id, data, options, }: {
+        token: string;
+        id: string;
+        data: UpdateTransferPayload;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Get transfer statistics
+     * GET /inventory/transfers/stats
+     */
+    stats({ token, params, options, }: {
+        token: string;
+        params?: {
+            branchId?: string;
+        };
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<TransferStats>>;
+    /**
+     * Generic action endpoint
+     * POST /inventory/transfers/:id/action
+     */
+    action({ token, id, action, data, options, }: {
+        token: string;
+        id: string;
+        action: "approve" | "dispatch" | "in-transit" | "receive" | "cancel";
+        data?: Record<string, unknown>;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Approve a transfer (validates stock availability)
+     */
+    approve({ token, id, options, }: {
+        token: string;
+        id: string;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Dispatch a transfer (decrements sender stock)
+     */
+    dispatch({ token, id, data, options, }: {
+        token: string;
+        id: string;
+        data?: DispatchTransferPayload;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Mark transfer as in-transit
+     */
+    markInTransit({ token, id, options, }: {
+        token: string;
+        id: string;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Receive a transfer (increments receiver stock)
+     */
+    receive({ token, id, data, options, }: {
+        token: string;
+        id: string;
+        data?: ReceiveTransferPayload;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+    /**
+     * Cancel a transfer
+     */
+    cancel({ token, id, reason, options, }: {
+        token: string;
+        id: string;
+        reason?: string;
+        options?: FetchOptions$2;
+    }): Promise<ApiResponse<Transfer>>;
+}
+declare const transferApi: TransferApi;
+
+/**
+ * Purchase API - Supplier Invoices & Stock Entry
+ *
+ * Base path: /api/v1/inventory/purchases
+ *
+ * Purchases are the only official way to bring new inventory into the system.
+ * They are Head Office only and drive COGS (weighted average cost).
+ *
+ * Standard CRUD:
+ * - create({ token, data }) - Create purchase invoice (draft)
+ * - getAll({ token, params }) - List purchases with filtering
+ * - getById({ token, id }) - Get purchase by ID
+ * - update({ token, id, data }) - Update draft purchase
+ *
+ * Actions (Stripe pattern):
+ * - receive({ token, id }) - Receive purchase (creates stock movements)
+ * - pay({ token, id, amount, method, reference }) - Record payment
+ * - cancel({ token, id, reason }) - Cancel draft/approved purchase
+ */
+
+type FetchOptions$1 = Omit<RequestOptions, "token" | "organizationId">;
+declare class PurchaseApi extends BaseApi<Purchase, CreatePurchasePayload, UpdatePurchasePayload> {
+    constructor(config?: {});
+    /**
+     * Perform a purchase action (receive/pay/cancel)
+     * POST /inventory/purchases/:id/action
+     */
+    action({ token, id, action, data, options, }: {
+        token: string;
+        id: string;
+        action: PurchaseActionType;
+        data?: Record<string, unknown>;
+        options?: FetchOptions$1;
+    }): Promise<ApiResponse<Purchase>>;
+    /**
+     * Receive a purchase (auto-approves draft and creates stock movements)
+     * POST /inventory/purchases/:id/action { action: 'receive' }
+     */
+    receive({ token, id, options, }: {
+        token: string;
+        id: string;
+        options?: FetchOptions$1;
+    }): Promise<ApiResponse<Purchase>>;
+    /**
+     * Record payment for a purchase
+     * POST /inventory/purchases/:id/action { action: 'pay', amount, method, reference }
+     */
+    pay({ token, id, amount, method, reference, accountNumber, walletNumber, bankName, accountName, proofUrl, transactionDate, notes, options, }: {
+        token: string;
+        id: string;
+        amount: number;
+        method: string;
+        reference?: string;
+        accountNumber?: string;
+        walletNumber?: string;
+        bankName?: string;
+        accountName?: string;
+        proofUrl?: string;
+        transactionDate?: string;
+        notes?: string;
+        options?: FetchOptions$1;
+    }): Promise<ApiResponse<Purchase>>;
+    /**
+     * Cancel a purchase (draft or approved only)
+     * POST /inventory/purchases/:id/action { action: 'cancel', reason }
+     */
+    cancel({ token, id, reason, options, }: {
+        token: string;
+        id: string;
+        reason?: string;
+        options?: FetchOptions$1;
+    }): Promise<ApiResponse<Purchase>>;
+    /**
+     * Record a stock purchase (legacy method)
+     * Creates and optionally auto-receives a purchase
+     *
+     * @deprecated Use create() with autoReceive: true instead
+     */
+    recordPurchase({ token, data, options, }: {
+        token: string;
+        data: CreatePurchasePayload;
+        options?: FetchOptions$1;
+    }): Promise<ApiResponse<{
+        stockEntries: StockEntry[];
+        movements: StockMovement[];
+    }>>;
+}
+declare const purchaseApi: PurchaseApi;
+
+/**
+ * Stock API - Stock Entry Management
+ *
+ * Provides access to stock entry records.
+ * Stock entries track quantity per product/variant/branch combination.
+ */
+
+type FetchOptions = Omit<RequestOptions, "token" | "organizationId">;
+declare class StockApi extends BaseApi<StockEntry> {
+    constructor(config?: {});
+    /**
+     * List stock entries
+     * GET /inventory
+     */
+    list({ token, params, options, }: {
+        token: string;
+        params?: Record<string, unknown>;
+        options?: FetchOptions;
+    }): Promise<PaginatedResponse<StockEntry>>;
+    /**
+     * Get stock entry by ID
+     * GET /inventory/:id
+     */
+    getById({ token, id, options, }: {
+        token: string;
+        id: string;
+        options?: FetchOptions;
+    }): Promise<ApiResponse<StockEntry>>;
+    /**
+     * Get stock for a specific product
+     * GET /inventory?productId=<id>
+     */
+    getByProduct({ token, productId, branchId, options, }: {
+        token: string;
+        productId: string;
+        branchId?: string;
+        options?: FetchOptions;
+    }): Promise<PaginatedResponse<StockEntry>>;
+    /**
+     * Get stock for a specific branch
+     * GET /inventory?branchId=<id>
+     */
+    getByBranch({ token, branchId, params, options, }: {
+        token: string;
+        branchId: string;
+        params?: Record<string, unknown>;
+        options?: FetchOptions;
+    }): Promise<PaginatedResponse<StockEntry>>;
+}
+declare const stockApi: StockApi;
+
+export { AdjustmentApi as A, MovementApi as M, PurchaseApi as P, RequestApi as R, StockApi as S, TransferApi as T, adjustmentApi as a, supplierApi as b, SupplierApi as c, type SupplierQueryParams as d, type SupplierType as e, type SupplierPaymentTerms as f, type Supplier as g, type SupplierCreatePayload as h, type SupplierUpdatePayload as i, type SupplierListResponse as j, type SupplierResponse as k, movementApi as m, purchaseApi as p, requestApi as r, stockApi as s, transferApi as t };

package/dist/stock-OOUW57VQ.js

@@ -0,0 +1,5 @@
+export { StockApi, stockApi } from './chunk-KZIGRIQG.js';
+import './chunk-I5TIKUIQ.js';
+import './chunk-VR36QVX2.js';
+//# sourceMappingURL=stock-OOUW57VQ.js.map
+//# sourceMappingURL=stock-OOUW57VQ.js.map

package/dist/stock-OOUW57VQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"stock-OOUW57VQ.js"}

package/dist/supplier-OC6JAWV6.js

@@ -0,0 +1,5 @@
+export { SupplierApi, supplierApi } from './chunk-WUOQK7BO.js';
+import './chunk-I5TIKUIQ.js';
+import './chunk-VR36QVX2.js';
+//# sourceMappingURL=supplier-OC6JAWV6.js.map
+//# sourceMappingURL=supplier-OC6JAWV6.js.map

package/dist/supplier-OC6JAWV6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"supplier-OC6JAWV6.js"}