@classytic/commerce-sdk 0.1.0

package/dist/chunk-5ZFW3FEI.js

@@ -0,0 +1,183 @@
+import { BaseApi } from './chunk-I5TIKUIQ.js';
+import { createCrudHooks } from './chunk-B6MPVOV7.js';
+import { useQuery } from '@tanstack/react-query';
+
+// src/transaction/types/transaction.ts
+var TransactionFlow = /* @__PURE__ */ ((TransactionFlow2) => {
+  TransactionFlow2["INFLOW"] = "inflow";
+  TransactionFlow2["OUTFLOW"] = "outflow";
+  return TransactionFlow2;
+})(TransactionFlow || {});
+var TransactionStatus = /* @__PURE__ */ ((TransactionStatus2) => {
+  TransactionStatus2["PENDING"] = "pending";
+  TransactionStatus2["PAYMENT_INITIATED"] = "payment_initiated";
+  TransactionStatus2["PROCESSING"] = "processing";
+  TransactionStatus2["REQUIRES_ACTION"] = "requires_action";
+  TransactionStatus2["VERIFIED"] = "verified";
+  TransactionStatus2["COMPLETED"] = "completed";
+  TransactionStatus2["FAILED"] = "failed";
+  TransactionStatus2["CANCELLED"] = "cancelled";
+  TransactionStatus2["EXPIRED"] = "expired";
+  TransactionStatus2["REFUNDED"] = "refunded";
+  TransactionStatus2["PARTIALLY_REFUNDED"] = "partially_refunded";
+  return TransactionStatus2;
+})(TransactionStatus || {});
+var TransactionCategory = /* @__PURE__ */ ((TransactionCategory2) => {
+  TransactionCategory2["ORDER_PURCHASE"] = "order_purchase";
+  TransactionCategory2["ORDER_SUBSCRIPTION"] = "order_subscription";
+  TransactionCategory2["WHOLESALE_SALE"] = "wholesale_sale";
+  TransactionCategory2["PLATFORM_SUBSCRIPTION"] = "platform_subscription";
+  TransactionCategory2["CREATOR_SUBSCRIPTION"] = "creator_subscription";
+  TransactionCategory2["ENROLLMENT_PURCHASE"] = "enrollment_purchase";
+  TransactionCategory2["ENROLLMENT_SUBSCRIPTION"] = "enrollment_subscription";
+  TransactionCategory2["INVENTORY_PURCHASE"] = "inventory_purchase";
+  TransactionCategory2["PURCHASE_RETURN"] = "purchase_return";
+  TransactionCategory2["INVENTORY_LOSS"] = "inventory_loss";
+  TransactionCategory2["INVENTORY_ADJUSTMENT"] = "inventory_adjustment";
+  TransactionCategory2["COGS"] = "cogs";
+  TransactionCategory2["REFUND"] = "refund";
+  TransactionCategory2["SUBSCRIPTION"] = "subscription";
+  TransactionCategory2["PURCHASE"] = "purchase";
+  TransactionCategory2["RENT"] = "rent";
+  TransactionCategory2["UTILITIES"] = "utilities";
+  TransactionCategory2["EQUIPMENT"] = "equipment";
+  TransactionCategory2["SUPPLIES"] = "supplies";
+  TransactionCategory2["MAINTENANCE"] = "maintenance";
+  TransactionCategory2["MARKETING"] = "marketing";
+  TransactionCategory2["OTHER_EXPENSE"] = "other_expense";
+  TransactionCategory2["CAPITAL_INJECTION"] = "capital_injection";
+  TransactionCategory2["RETAINED_EARNINGS"] = "retained_earnings";
+  TransactionCategory2["TIP_INCOME"] = "tip_income";
+  TransactionCategory2["OTHER_INCOME"] = "other_income";
+  return TransactionCategory2;
+})(TransactionCategory || {});
+var TransactionType = /* @__PURE__ */ ((TransactionType2) => {
+  TransactionType2["INCOME"] = "income";
+  TransactionType2["EXPENSE"] = "expense";
+  return TransactionType2;
+})(TransactionType || {});
+
+// src/transaction/api/transaction.ts
+var TransactionApi = class extends BaseApi {
+  /**
+   * Get Profit & Loss Report
+   * Returns income (inflow), expenses (outflow), and net profit for a date range
+   */
+  async getProfitLoss(params = {}, options = {}) {
+    return this.request("GET", `${this.baseUrl}/reports/profit-loss`, {
+      params,
+      ...options
+    });
+  }
+  /**
+   * Get Cash Flow Report
+   * Returns monthly inflow, outflow, and net trend
+   */
+  async getCashFlow(params = {}, options = {}) {
+    return this.request("GET", `${this.baseUrl}/reports/cash-flow`, {
+      params,
+      ...options
+    });
+  }
+  /**
+   * Get Category Breakdown
+   * Returns top spending/income categories for a date range
+   * Filter by flow='inflow' for income categories, flow='outflow' for expense categories
+   */
+  async getCategoryReport(params = {}, options = {}) {
+    return this.request("GET", `${this.baseUrl}/reports/categories`, {
+      params,
+      ...options
+    });
+  }
+  /**
+   * Get Statement Export
+   * Accountant-friendly export with branch + VAT invoice references
+   *
+   * @param params.format - 'csv' (default) or 'json'
+   * @returns CSV blob (format=csv) or StatementResponse (format=json)
+   */
+  async getStatement(params = {}, options = {}) {
+    if (params.format === "json") {
+      return this.request("GET", `${this.baseUrl}/statement`, {
+        params,
+        ...options
+      });
+    }
+    return this.request("GET", `${this.baseUrl}/statement`, {
+      params: { ...params, format: "csv" },
+      options: { responseType: "blob", ...options }
+    });
+  }
+};
+var transactionApi = new TransactionApi("transactions");
+var transaction_default = transactionApi;
+var TRANSACTION_KEYS = {
+  all: ["transactions"],
+  lists: () => [...TRANSACTION_KEYS.all, "list"],
+  list: (params) => [...TRANSACTION_KEYS.lists(), params],
+  details: () => [...TRANSACTION_KEYS.all, "detail"],
+  detail: (id) => [...TRANSACTION_KEYS.details(), id],
+  // Report keys
+  reports: () => [...TRANSACTION_KEYS.all, "reports"],
+  profitLoss: (params) => [...TRANSACTION_KEYS.reports(), "profit-loss", params],
+  cashFlow: (params) => [...TRANSACTION_KEYS.reports(), "cash-flow", params],
+  categories: (params) => [...TRANSACTION_KEYS.reports(), "categories", params],
+  statement: (params) => [...TRANSACTION_KEYS.reports(), "statement", params]
+};
+var transactionHooks = createCrudHooks({
+  api: transactionApi,
+  entityKey: "transactions",
+  singular: "Transaction",
+  plural: "Transactions",
+  defaults: {
+    staleTime: 1 * 60 * 1e3
+    // 1 minute (transactions change frequently)
+  }
+});
+var {
+  useList: useTransactions,
+  useDetail: useTransactionDetail,
+  useActions: useTransactionActions,
+  useNavigation: useTransactionNavigation
+} = transactionHooks;
+function useProfitLoss(params, options = {}) {
+  return useQuery({
+    queryKey: TRANSACTION_KEYS.profitLoss(params),
+    queryFn: () => transactionApi.getProfitLoss(params),
+    enabled: options.enabled !== false,
+    staleTime: options.staleTime ?? 5 * 60 * 1e3
+    // 5 minutes
+  });
+}
+function useCashFlow(params = {}, options = {}) {
+  return useQuery({
+    queryKey: TRANSACTION_KEYS.cashFlow(params),
+    queryFn: () => transactionApi.getCashFlow(params),
+    enabled: options.enabled !== false,
+    staleTime: options.staleTime ?? 5 * 60 * 1e3
+    // 5 minutes
+  });
+}
+function useCategoryReport(params = {}, options = {}) {
+  return useQuery({
+    queryKey: TRANSACTION_KEYS.categories(params),
+    queryFn: () => transactionApi.getCategoryReport(params),
+    enabled: options.enabled !== false,
+    staleTime: options.staleTime ?? 5 * 60 * 1e3
+    // 5 minutes
+  });
+}
+function useStatement(params, options = {}) {
+  return useQuery({
+    queryKey: TRANSACTION_KEYS.statement(params),
+    queryFn: () => transactionApi.getStatement({ ...params, format: "json" }),
+    enabled: !!params.startDate && !!params.endDate && options.enabled !== false,
+    staleTime: options.staleTime ?? 5 * 60 * 1e3
+    // 5 minutes
+  });
+}
+
+export { TRANSACTION_KEYS, TransactionApi, TransactionCategory, TransactionFlow, TransactionStatus, TransactionType, transactionApi, transactionHooks, transaction_default, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions };
+//# sourceMappingURL=chunk-5ZFW3FEI.js.map
+//# sourceMappingURL=chunk-5ZFW3FEI.js.map

package/dist/chunk-5ZFW3FEI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transaction/types/transaction.ts","../src/transaction/api/transaction.ts","../src/transaction/hooks/transaction.ts"],"names":["TransactionFlow","TransactionStatus","TransactionCategory","TransactionType"],"mappings":"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","file":"chunk-5ZFW3FEI.js","sourcesContent":["/**\n * Transaction Types\n *\n * Transactions track cashflow events across the system.\n * Used by: Orders, POS, Inventory, CRM, HRM, and manual entries.\n *\n * Sources:\n * - modules/transaction/transaction.model.js\n * - common/revenue/enums.js\n * - @classytic/revenue library\n *\n * Key concepts:\n * - `flow`: Direction of money ('inflow' = income, 'outflow' = expense)\n * - `type`: Category of transaction (order_purchase, refund, rent, etc.)\n * - Amounts in smallest unit (paisa for BDT)\n */\n\n// ============================================\n// PAYMENT ENUMS\n// ============================================\n\n/**\n * Payment methods supported by the system\n */\nexport type PaymentMethod =\n  | 'cash'\n  | 'bkash'\n  | 'nagad'\n  | 'rocket'\n  | 'upay'\n  | 'bank_transfer'\n  | 'card'\n  | 'online'\n  | 'manual'\n  | 'split'\n  | 'cod';\n\nexport type PaymentGatewayType =\n  | 'manual'\n  | 'stripe'\n  | 'sslcommerz'\n  | 'bkash'\n  | 'nagad';\n\n// ============================================\n// TRANSACTION FLOW (Money Direction)\n// ============================================\n\n/**\n * Transaction Flow - Direction of money movement\n * - inflow: Money coming in (sales, income, capital injection)\n * - outflow: Money going out (expenses, refunds, purchases)\n */\nexport enum TransactionFlow {\n  INFLOW = 'inflow',\n  OUTFLOW = 'outflow',\n}\n\nexport type TransactionFlowType = 'inflow' | 'outflow';\n\n// ============================================\n// TRANSACTION STATUS\n// ============================================\n\n/**\n * Transaction Status - Payment lifecycle states\n */\nexport enum TransactionStatus {\n  PENDING = 'pending',\n  PAYMENT_INITIATED = 'payment_initiated',\n  PROCESSING = 'processing',\n  REQUIRES_ACTION = 'requires_action',\n  VERIFIED = 'verified',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  CANCELLED = 'cancelled',\n  EXPIRED = 'expired',\n  REFUNDED = 'refunded',\n  PARTIALLY_REFUNDED = 'partially_refunded',\n}\n\nexport type TransactionStatusType =\n  | 'pending'\n  | 'payment_initiated'\n  | 'processing'\n  | 'requires_action'\n  | 'verified'\n  | 'completed'\n  | 'failed'\n  | 'cancelled'\n  | 'expired'\n  | 'refunded'\n  | 'partially_refunded';\n\n// ============================================\n// TRANSACTION CATEGORIES (type field values)\n// ============================================\n\n/**\n * Transaction Categories\n *\n * The `type` field stores the category for reporting/grouping.\n * Flow is determined by `flow` field, not by category.\n *\n * ┌─────────────────────────────────────────────────────────────────┐\n * │ INFLOW (Income)                 │ OUTFLOW (Expense)             │\n * ├─────────────────────────────────┼───────────────────────────────┤\n * │ order_purchase (POS/Web sales)  │ inventory_purchase (stock)    │\n * │ wholesale_sale (B2B sales)      │ purchase_return (refund recv) │\n * │ capital_injection               │ cogs (cost of goods sold)     │\n * │ retained_earnings               │ rent, utilities, equipment... │\n * │ other_income                    │ inventory_loss                │\n * │ tip_income (optional)           │ marketing, maintenance...     │\n * │                                 │ refund (customer refunds)     │\n * └─────────────────────────────────┴───────────────────────────────┘\n */\nexport enum TransactionCategory {\n  // ============ REVENUE CATEGORIES (INFLOW) ============\n  ORDER_PURCHASE = 'order_purchase',\n  ORDER_SUBSCRIPTION = 'order_subscription',\n  WHOLESALE_SALE = 'wholesale_sale',\n  PLATFORM_SUBSCRIPTION = 'platform_subscription',\n  CREATOR_SUBSCRIPTION = 'creator_subscription',\n  ENROLLMENT_PURCHASE = 'enrollment_purchase',\n  ENROLLMENT_SUBSCRIPTION = 'enrollment_subscription',\n\n  // ============ INVENTORY CATEGORIES ============\n  INVENTORY_PURCHASE = 'inventory_purchase',\n  PURCHASE_RETURN = 'purchase_return',\n  INVENTORY_LOSS = 'inventory_loss',\n  INVENTORY_ADJUSTMENT = 'inventory_adjustment',\n  COGS = 'cogs',\n\n  // ============ REFUNDS (OUTFLOW) ============\n  REFUND = 'refund',\n  SUBSCRIPTION = 'subscription',\n  PURCHASE = 'purchase',\n\n  // ============ OPERATIONAL EXPENSES (OUTFLOW) ============\n  RENT = 'rent',\n  UTILITIES = 'utilities',\n  EQUIPMENT = 'equipment',\n  SUPPLIES = 'supplies',\n  MAINTENANCE = 'maintenance',\n  MARKETING = 'marketing',\n  OTHER_EXPENSE = 'other_expense',\n\n  // ============ OPERATIONAL INCOME (INFLOW) ============\n  CAPITAL_INJECTION = 'capital_injection',\n  RETAINED_EARNINGS = 'retained_earnings',\n  TIP_INCOME = 'tip_income',\n  OTHER_INCOME = 'other_income',\n}\n\nexport type TransactionCategoryType =\n  | 'order_purchase'\n  | 'order_subscription'\n  | 'wholesale_sale'\n  | 'platform_subscription'\n  | 'creator_subscription'\n  | 'enrollment_purchase'\n  | 'enrollment_subscription'\n  | 'refund'\n  | 'subscription'\n  | 'purchase'\n  | 'inventory_purchase'\n  | 'purchase_return'\n  | 'inventory_loss'\n  | 'inventory_adjustment'\n  | 'cogs'\n  | 'rent'\n  | 'utilities'\n  | 'equipment'\n  | 'supplies'\n  | 'maintenance'\n  | 'marketing'\n  | 'other_expense'\n  | 'capital_injection'\n  | 'retained_earnings'\n  | 'tip_income'\n  | 'other_income';\n\n// ============================================\n// NESTED TYPES\n// ============================================\n\n/**\n * Transaction Split Payment - Individual payment in a split transaction\n * Different from POS SplitPaymentEntry which has additional UI state fields\n */\nexport interface TransactionSplitPayment {\n  method: PaymentMethod;\n  amount: number;\n  reference?: string;\n  details?: Record<string, unknown>;\n}\n\n/**\n * Payment Details - For manual/split payments\n */\nexport interface TransactionPaymentDetails {\n  walletNumber?: string;\n  walletType?: 'personal' | 'merchant';\n  trxId?: string;\n  bankName?: string;\n  accountNumber?: string;\n  accountName?: string;\n  proofUrl?: string;\n  /** Split payment entries (when method is 'split') */\n  payments?: TransactionSplitPayment[];\n}\n\n/**\n * Tax type for transactions\n */\nexport type TaxType = 'vat' | 'gst' | 'sales_tax' | 'income_tax' | 'withholding_tax' | 'none';\n\n/**\n * Tax Details for VAT/GST/Sales Tax tracking\n */\nexport interface TransactionTaxDetails {\n  /** Tax type: vat, gst, sales_tax, etc. */\n  type?: TaxType;\n  /** Tax rate as decimal (0.15 = 15%) */\n  rate?: number;\n  /** Whether prices include tax (BD default: true) */\n  isInclusive?: boolean;\n  /** Tax jurisdiction code (e.g., 'BD' for Bangladesh) */\n  jurisdiction?: string;\n}\n\n/**\n * Gateway Details - Payment provider info\n */\nexport interface TransactionGateway {\n  type: PaymentGatewayType | string;\n  provider?: string;\n  paymentUrl?: string;\n  transactionId?: string;\n  sessionId?: string;\n  paymentIntentId?: string;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Commission tracking for gateway/marketplace payments\n */\nexport interface TransactionCommission {\n  /** Commission rate as decimal */\n  rate?: number;\n  /** Gross commission amount */\n  grossAmount?: number;\n  /** Gateway fee rate as decimal */\n  gatewayFeeRate?: number;\n  /** Gateway fee amount */\n  gatewayFeeAmount?: number;\n  /** Net commission amount (grossAmount - gatewayFeeAmount) */\n  netAmount?: number;\n  /** Commission status */\n  status?: 'pending' | 'due' | 'paid' | 'waived' | 'reversed';\n  /** Commission due date (ISO 8601) */\n  dueDate?: string;\n}\n\n/**\n * Webhook tracking\n */\nexport interface TransactionWebhook {\n  eventId?: string;\n  eventType?: string;\n  receivedAt?: string;\n  processedAt?: string;\n  payload?: Record<string, unknown>;\n}\n\n/**\n * Reconciliation tracking\n */\nexport interface TransactionReconciliation {\n  isReconciled?: boolean;\n  reconciledAt?: string;\n  reconciledBy?: string;\n  bankStatementRef?: string;\n}\n\n// ============================================\n// TRANSACTION DOCUMENT\n// ============================================\n\n/**\n * Transaction Document\n *\n * Key fields:\n * - flow: Direction of money (inflow/outflow)\n * - type: Category of transaction (order_purchase, refund, etc.)\n * - amount: Gross amount in smallest unit (paisa)\n * - fee: Platform/gateway fees deducted\n * - tax: VAT/tax portion (informational)\n * - net: amount - fee - tax (derived)\n */\nexport interface Transaction {\n  _id: string;\n  organizationId?: string;\n\n  // ===== CLASSIFICATION =====\n  /**\n   * Flow direction: 'inflow' (money in) or 'outflow' (money out)\n   * Use this for Income/Expense classification in UI\n   */\n  flow: TransactionFlowType;\n\n  /**\n   * Transaction category (e.g. 'order_purchase', 'refund', 'rent', 'cogs')\n   * Note: Backend stores category in the 'type' field\n   */\n  type: TransactionCategoryType | string;\n\n  /** Transaction status */\n  status: TransactionStatusType | string;\n\n  // ===== AMOUNTS (in smallest currency unit - paisa for BDT) =====\n  /** Gross money that moved (in smallest unit, e.g. paisa) */\n  amount: number;\n\n  /** Currency code (default: 'BDT') */\n  currency?: string;\n\n  /** Platform/gateway fees deducted */\n  fee?: number;\n\n  /** VAT/tax portion (informational, for VAT reporting) */\n  tax?: number;\n\n  /** Net amount: amount - fee - tax */\n  net?: number;\n\n  /** Tax details for VAT/GST reporting */\n  taxDetails?: TransactionTaxDetails;\n\n  // ===== PARTIES =====\n  customerId?: string | null;\n  handledBy?: string | null;\n\n  // ===== PAYMENT =====\n  method: PaymentMethod | string;\n  gateway?: TransactionGateway;\n  paymentDetails?: TransactionPaymentDetails;\n\n  // ===== REFERENCES =====\n  /** Source model type (Order, Purchase, Manual) - polymorphic reference */\n  sourceModel?: 'Order' | 'Purchase' | 'Manual' | string;\n  /** Source document ID */\n  sourceId?: string;\n  /** Related transaction (for refunds linking to original) */\n  relatedTransactionId?: string;\n\n  // ===== SOURCE & BRANCH =====\n  /** Source channel: where the transaction originated */\n  source: 'web' | 'pos' | 'api';\n  /** Branch reference ID */\n  branch?: string;\n  /** Branch code for display */\n  branchCode?: string;\n\n  // ===== COMMISSION & SPLITS =====\n  /** Commission tracking for gateway payments */\n  commission?: TransactionCommission;\n  /** Revenue splits (for marketplace use) */\n  splits?: Array<{\n    recipientId?: string;\n    recipientType?: string;\n    type?: string;\n    amount?: number;\n    status?: string;\n    paidAt?: string;\n  }>;\n\n  // ===== METADATA =====\n  metadata?: Record<string, unknown>;\n  description?: string;\n  notes?: string;\n  idempotencyKey?: string;\n  webhook?: TransactionWebhook;\n\n  // ===== TIMESTAMPS =====\n  /** Actual transaction date (when it occurred) */\n  date?: string;\n\n  // Verification\n  verifiedBy?: string;\n  verifiedAt?: string;\n\n  // Status timestamps\n  initiatedAt?: string;\n  completedAt?: string;\n  paidAt?: string;\n  failedAt?: string;\n  failureReason?: string;\n\n  // Refund tracking\n  refundedAt?: string;\n  refundedAmount?: number;\n  refundReason?: string;\n\n  // Reconciliation\n  reconciliation?: TransactionReconciliation;\n\n  // Standard timestamps\n  createdAt: string;\n  updatedAt: string;\n\n  // ===== VIRTUALS =====\n  isPaid?: boolean;\n  amountInUnits?: number;\n}\n\n// ============================================\n// PAYLOADS\n// ============================================\n\n/**\n * Payload to create a Manual Transaction (OpEx, CapEx, etc.)\n * Most transactions are system-managed via order/POS flows.\n */\nexport interface CreateTransactionPayload {\n  flow: TransactionFlowType;\n  type: TransactionCategoryType | string;\n  amount: number;\n  method?: PaymentMethod | string;\n  source?: 'web' | 'pos' | 'api';\n  branch?: string;\n  branchCode?: string;\n  date?: string;\n  notes?: string;\n  description?: string;\n  paymentDetails?: TransactionPaymentDetails;\n  taxDetails?: TransactionTaxDetails;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Payload to update a Transaction (limited fields)\n * Editable correction fields (permissioned)\n */\nexport interface UpdateTransactionPayload {\n  flow?: TransactionFlowType;\n  type?: TransactionCategoryType | string;\n  amount?: number;\n  fee?: number;\n  tax?: number;\n  net?: number;\n  method?: PaymentMethod | string;\n  paymentDetails?: TransactionPaymentDetails;\n  taxDetails?: TransactionTaxDetails;\n  branch?: string;\n  branchCode?: string;\n  source?: 'web' | 'pos' | 'api';\n  notes?: string;\n  description?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================\n// PAYMENT INTENT (returned with monetization-managed transactions)\n// ============================================\n\n/**\n * Payment Intent - Returned with order/POS transactions\n */\nexport interface PaymentIntent {\n  id: string;\n  provider: PaymentGatewayType | string;\n  status: 'pending' | 'processing' | 'succeeded' | 'failed' | 'cancelled';\n  /** Manual payment instructions */\n  instructions?: {\n    bkash?: string;\n    nagad?: string;\n    bank?: string;\n    reference?: string;\n    note?: string;\n  };\n  /** Stripe SDK client secret */\n  clientSecret?: string | null;\n  /** Redirect URL for hosted payment pages */\n  paymentUrl?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================\n// REPORT TYPES\n// ============================================\n\n/**\n * Financial Report Response (Profit & Loss)\n * Uses flow-based totals: inflow (income) vs outflow (expense)\n */\nexport interface FinancialReport {\n  /** Total inflow (income) */\n  income: number;\n  /** Total outflow (expense) */\n  expense: number;\n  /** Net profit (income - expense) */\n  net: number;\n  /** Breakdown by category (type field) */\n  breakdown: Record<string, number>;\n}\n\n/**\n * Cash Flow Report Response\n * Monthly trend of inflow vs outflow\n */\nexport interface CashFlowReport {\n  months: Array<{\n    month: string;\n    /** Total inflow (income) for the month */\n    inflow: number;\n    /** Total outflow (expense) for the month */\n    outflow: number;\n    /** Net cash flow (inflow - outflow) */\n    net: number;\n  }>;\n}\n\n/**\n * Category Report Response\n */\nexport interface CategoryReport {\n  categories: Array<{\n    category: string;\n    total: number;\n    count: number;\n  }>;\n}\n\n/**\n * Statement Row (for CSV/JSON export)\n */\nexport interface StatementRow {\n  transactionId: string;\n  transactionDate: string | null;\n  createdAt: string | null;\n  status: string;\n  /** Flow direction: inflow/outflow */\n  flow: string;\n  /** Transaction category (type field) */\n  type: string;\n  source: string;\n  branchCode: string | null;\n  branchId: string | null;\n  method: string;\n  /** Gross amount in BDT (converted from paisa) */\n  amountBdt: number;\n  /** Fee amount in BDT */\n  feeBdt?: number;\n  /** Tax amount in BDT */\n  taxBdt?: number;\n  /** Net amount in BDT (amount - fee - tax) */\n  netBdt?: number;\n  currency: string;\n  /** Source model (Order, Purchase, Manual) */\n  sourceModel?: string;\n  /** Source document ID */\n  sourceId?: string | null;\n  orderId: string | null;\n  orderCustomerName: string | null;\n  vatInvoiceNumber: string | null;\n  vatSellerBin: string | null;\n  paymentReference: string | null;\n  narration: string | null;\n}\n\n/**\n * Statement Export Response (JSON format)\n */\nexport interface StatementResponse {\n  success: boolean;\n  count: number;\n  data: StatementRow[];\n}\n\n// ============================================\n// DEPRECATED TYPES (for backwards compatibility)\n// ============================================\n\n/**\n * @deprecated Use TransactionFlow instead. Backend uses flow (inflow/outflow).\n */\nexport enum TransactionType {\n  INCOME = 'income',\n  EXPENSE = 'expense',\n}\n","/**\n * Transaction API Client\n *\n * Transactions track cashflow events (money in/out) across the system.\n * Used by: Orders, POS, Inventory, CRM, HRM, and manual entries.\n *\n * CRUD (via BaseApi):\n * - getAll(params) - List transactions\n * - getById(id) - Get transaction\n * - create(payload) - Create manual transaction (staff only)\n * - update(id, payload) - Update transaction (limited fields)\n * - delete(id) - Delete transaction (admin/superadmin only)\n *\n * Reports:\n * - getProfitLoss(params) - P&L statement\n * - getCashFlow(params) - Monthly trend\n * - getCategoryReport(params) - Category breakdown\n *\n * Export:\n * - getStatement(params) - CSV/JSON export for accountants\n */\n\nimport { BaseApi } from '../../core/api-factory';\nimport type {\n  Transaction,\n  CreateTransactionPayload,\n  UpdateTransactionPayload,\n  FinancialReport,\n  CashFlowReport,\n  CategoryReport,\n  StatementResponse,\n} from '../types/transaction';\n\n/**\n * Statement Query Params\n */\nexport interface StatementParams {\n  startDate?: string;\n  endDate?: string;\n  branchId?: string;\n  source?: 'web' | 'pos' | 'api';\n  status?: string;\n  format?: 'csv' | 'json';\n  [key: string]: unknown;\n}\n\n/**\n * Report Query Params\n */\nexport interface ReportParams {\n  startDate?: string;\n  endDate?: string;\n  branchId?: string;\n  [key: string]: unknown;\n}\n\nexport interface CashFlowParams {\n  months?: number; // 1-12, default: 6\n  branchId?: string;\n  [key: string]: unknown;\n}\n\nexport interface CategoryParams extends ReportParams {\n  flow?: 'inflow' | 'outflow';\n  limit?: number; // default: 10\n}\n\nclass TransactionApi extends BaseApi<Transaction, CreateTransactionPayload, UpdateTransactionPayload> {\n\n  /**\n   * Get Profit & Loss Report\n   * Returns income (inflow), expenses (outflow), and net profit for a date range\n   */\n  async getProfitLoss(params: ReportParams = {}, options = {}) {\n    return this.request<FinancialReport>('GET', `${this.baseUrl}/reports/profit-loss`, {\n      params,\n      ...options,\n    });\n  }\n\n  /**\n   * Get Cash Flow Report\n   * Returns monthly inflow, outflow, and net trend\n   */\n  async getCashFlow(params: CashFlowParams = {}, options = {}) {\n    return this.request<CashFlowReport>('GET', `${this.baseUrl}/reports/cash-flow`, {\n      params,\n      ...options,\n    });\n  }\n\n  /**\n   * Get Category Breakdown\n   * Returns top spending/income categories for a date range\n   * Filter by flow='inflow' for income categories, flow='outflow' for expense categories\n   */\n  async getCategoryReport(params: CategoryParams = {}, options = {}) {\n    return this.request<CategoryReport>('GET', `${this.baseUrl}/reports/categories`, {\n      params,\n      ...options,\n    });\n  }\n\n  /**\n   * Get Statement Export\n   * Accountant-friendly export with branch + VAT invoice references\n   *\n   * @param params.format - 'csv' (default) or 'json'\n   * @returns CSV blob (format=csv) or StatementResponse (format=json)\n   */\n  async getStatement(params: StatementParams = {}, options = {}) {\n    if (params.format === 'json') {\n      return this.request<StatementResponse>('GET', `${this.baseUrl}/statement`, {\n        params,\n        ...options,\n      });\n    }\n    // For CSV, caller should handle blob response\n    return this.request<Blob>('GET', `${this.baseUrl}/statement`, {\n      params: { ...params, format: 'csv' },\n      options: { responseType: 'blob', ...options },\n    });\n  }\n}\n\nexport const transactionApi = new TransactionApi('transactions');\nexport { TransactionApi };\nexport default transactionApi;\n","\"use client\";\n\n/**\n * Transaction Hooks\n *\n * React hooks for transaction CRUD operations and reports.\n * Transactions are used across the system for cashflow tracking.\n */\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { createCrudHooks, type CrudApi } from \"../../core/react\";\nimport { transactionApi } from \"../api/transaction\";\nimport type { Transaction, CreateTransactionPayload, UpdateTransactionPayload } from \"../types/transaction\";\nimport type {\n  FinancialReport,\n  CashFlowReport,\n  CategoryReport,\n  StatementResponse,\n} from \"../types/transaction\";\nimport type {\n  ReportParams,\n  CashFlowParams,\n  CategoryParams,\n  StatementParams,\n} from \"../api/transaction\";\n\n// Type helper for API compatibility\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyApi = CrudApi<any, any, any>;\n\n// ============================================\n// Query Keys\n// ============================================\n\nexport const TRANSACTION_KEYS = {\n  all: [\"transactions\"] as const,\n  lists: () => [...TRANSACTION_KEYS.all, \"list\"] as const,\n  list: (params: Record<string, unknown>) => [...TRANSACTION_KEYS.lists(), params] as const,\n  details: () => [...TRANSACTION_KEYS.all, \"detail\"] as const,\n  detail: (id: string) => [...TRANSACTION_KEYS.details(), id] as const,\n  // Report keys\n  reports: () => [...TRANSACTION_KEYS.all, \"reports\"] as const,\n  profitLoss: (params: ReportParams) => [...TRANSACTION_KEYS.reports(), \"profit-loss\", params] as const,\n  cashFlow: (params: CashFlowParams) => [...TRANSACTION_KEYS.reports(), \"cash-flow\", params] as const,\n  categories: (params: CategoryParams) => [...TRANSACTION_KEYS.reports(), \"categories\", params] as const,\n  statement: (params: StatementParams) => [...TRANSACTION_KEYS.reports(), \"statement\", params] as const,\n};\n\n// ============================================\n// CRUD Hooks (via factory)\n// ============================================\n\n/**\n * Transaction CRUD hooks using createCrudHooks factory\n *\n * Provides:\n * - useTransactions: List transactions with filtering/pagination\n * - useTransactionDetail: Get single transaction\n * - useTransactionActions: Create, update, delete mutations\n * - useTransactionNavigation: Navigation between transactions\n */\nexport const transactionHooks = createCrudHooks<Transaction, CreateTransactionPayload, UpdateTransactionPayload>({\n  api: transactionApi as AnyApi,\n  entityKey: \"transactions\",\n  singular: \"Transaction\",\n  plural: \"Transactions\",\n  defaults: {\n    staleTime: 1 * 60 * 1000, // 1 minute (transactions change frequently)\n  },\n});\n\nexport const {\n  useList: useTransactions,\n  useDetail: useTransactionDetail,\n  useActions: useTransactionActions,\n  useNavigation: useTransactionNavigation,\n} = transactionHooks;\n\n// ============================================\n// Report Hooks\n// ============================================\n\ninterface QueryOptions {\n  enabled?: boolean;\n  staleTime?: number;\n}\n\n/**\n * Fetch Profit & Loss report\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useProfitLoss({\n *   startDate: '2024-01-01',\n *   endDate: '2024-12-31',\n * });\n *\n * return (\n *   <div>\n *     <p>Income: {data?.income}</p>\n *     <p>Expense: {data?.expense}</p>\n *     <p>Net: {data?.net}</p>\n *   </div>\n * );\n * ```\n */\nexport function useProfitLoss(params: ReportParams, options: QueryOptions = {}) {\n  return useQuery<FinancialReport>({\n    queryKey: TRANSACTION_KEYS.profitLoss(params),\n    queryFn: () => transactionApi.getProfitLoss(params),\n    enabled: options.enabled !== false,\n    staleTime: options.staleTime ?? 5 * 60 * 1000, // 5 minutes\n  });\n}\n\n/**\n * Fetch Cash Flow report (monthly trend)\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useCashFlow({ months: 6 });\n *\n * return (\n *   <BarChart data={data?.months} />\n * );\n * ```\n */\nexport function useCashFlow(params: CashFlowParams = {}, options: QueryOptions = {}) {\n  return useQuery<CashFlowReport>({\n    queryKey: TRANSACTION_KEYS.cashFlow(params),\n    queryFn: () => transactionApi.getCashFlow(params),\n    enabled: options.enabled !== false,\n    staleTime: options.staleTime ?? 5 * 60 * 1000, // 5 minutes\n  });\n}\n\n/**\n * Fetch Category breakdown report\n *\n * @example\n * ```tsx\n * // Get expense categories\n * const { data } = useCategoryReport({ flow: 'outflow', limit: 10 });\n *\n * return (\n *   <PieChart data={data?.categories} />\n * );\n * ```\n */\nexport function useCategoryReport(params: CategoryParams = {}, options: QueryOptions = {}) {\n  return useQuery<CategoryReport>({\n    queryKey: TRANSACTION_KEYS.categories(params),\n    queryFn: () => transactionApi.getCategoryReport(params),\n    enabled: options.enabled !== false,\n    staleTime: options.staleTime ?? 5 * 60 * 1000, // 5 minutes\n  });\n}\n\n/**\n * Fetch Statement export (JSON format)\n *\n * @example\n * ```tsx\n * const { data } = useStatement({\n *   startDate: '2024-01-01',\n *   endDate: '2024-12-31',\n *   format: 'json',\n * });\n *\n * return (\n *   <DataTable data={data?.data} />\n * );\n * ```\n */\nexport function useStatement(params: StatementParams, options: QueryOptions = {}) {\n  return useQuery<StatementResponse>({\n    queryKey: TRANSACTION_KEYS.statement(params),\n    queryFn: () => transactionApi.getStatement({ ...params, format: 'json' }) as Promise<StatementResponse>,\n    enabled: !!params.startDate && !!params.endDate && options.enabled !== false,\n    staleTime: options.staleTime ?? 5 * 60 * 1000, // 5 minutes\n  });\n}\n"]}

package/dist/chunk-66OQAZSL.js

@@ -0,0 +1,94 @@
+import { BaseApi } from './chunk-I5TIKUIQ.js';
+
+// src/sales/api/pos.ts
+var PosApi = class extends BaseApi {
+  /**
+   * Browse products with branch-specific stock
+   * GET /api/v1/pos/products
+   */
+  async getProducts(options) {
+    const { token, ...params } = options;
+    return this.request("GET", `${this.config.basePath}/pos/products`, {
+      params,
+      token
+    });
+  }
+  /**
+   * Fast Lookup by Barcode/SKU
+   * GET /api/v1/pos/lookup
+   */
+  async lookup(options) {
+    const { token, ...params } = options;
+    return this.request("GET", `${this.config.basePath}/pos/lookup`, {
+      params,
+      token
+    });
+  }
+  /**
+   * Create POS Order
+   * POST /api/v1/pos/orders
+   */
+  async createOrder(options) {
+    const { token, data } = options;
+    return this.request("POST", `${this.config.basePath}/pos/orders`, {
+      data,
+      token
+    });
+  }
+  /**
+   * Get Receipt Data
+   * GET /api/v1/pos/orders/:orderId/receipt
+   */
+  async getReceipt(options) {
+    const { token, orderId } = options;
+    return this.request("GET", `${this.config.basePath}/pos/orders/${orderId}/receipt`, {
+      token
+    });
+  }
+  /**
+   * Adjust Stock (Quick Adjustment from POS)
+   * POST /api/v1/pos/stock/adjust
+   */
+  async adjustStock(options) {
+    const { token, data } = options;
+    return this.request("POST", `${this.config.basePath}/pos/stock/adjust`, {
+      data,
+      token
+    });
+  }
+  /**
+   * Set stock level directly (POS adjustment alias)
+   * POST /api/v1/pos/stock/adjust
+   */
+  async setStock(options) {
+    const { token, productId, data } = options;
+    return this.request("POST", `${this.config.basePath}/pos/stock/adjust`, {
+      data: {
+        productId,
+        quantity: data.quantity,
+        variantSku: data.variantSku,
+        branchId: data.branchId,
+        mode: "set",
+        reason: data.reason ?? data.notes
+      },
+      token
+    });
+  }
+  /**
+   * Bulk adjustments (POS adjustment alias)
+   * POST /api/v1/pos/stock/adjust
+   */
+  async bulkAdjust(options) {
+    const { token, data } = options;
+    return this.request("POST", `${this.config.basePath}/pos/stock/adjust`, {
+      data,
+      token
+    });
+  }
+};
+var posApi = new PosApi("pos");
+var pos_default = posApi;
+
+export { posApi, pos_default };
+//# sourceMappingURL=chunk-66OQAZSL.js.map
+//# sourceMappingURL=chunk-66OQAZSL.js.map

package/dist/chunk-66OQAZSL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sales/api/pos.ts"],"names":[],"mappings":";;;AAiBA,IAAM,MAAA,GAAN,cAAqB,OAAA,CAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3B,MAAM,YAAY,OAAA,EAWf;AACD,IAAA,MAAM,EAAE,KAAA,EAAO,GAAG,MAAA,EAAO,GAAI,OAAA;AAC7B,IAAA,OAAO,KAAK,OAAA,CAA6B,KAAA,EAAO,GAAG,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,aAAA,CAAA,EAAiB;AAAA,MACtF,MAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO,OAAA,EAIV;AACD,IAAA,MAAM,EAAE,KAAA,EAAO,GAAG,MAAA,EAAO,GAAI,OAAA;AAC7B,IAAA,OAAO,KAAK,OAAA,CAA2B,KAAA,EAAO,GAAG,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,WAAA,CAAA,EAAe;AAAA,MAClF,MAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,YAAY,OAAA,EAGf;AACD,IAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,OAAA;AACxB,IAAA,OAAO,KAAK,OAAA,CAAQ,MAAA,EAAQ,GAAG,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,WAAA,CAAA,EAAe;AAAA,MAChE,IAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WAAW,OAAA,EAGd;AACD,IAAA,MAAM,EAAE,KAAA,EAAO,OAAA,EAAQ,GAAI,OAAA;AAC3B,IAAA,OAAO,IAAA,CAAK,QAAQ,KAAA,EAAO,CAAA,EAAG,KAAK,MAAA,CAAO,QAAQ,CAAA,YAAA,EAAe,OAAO,CAAA,QAAA,CAAA,EAAY;AAAA,MAClF;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,YAAY,OAAA,EAGf;AACD,IAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,OAAA;AACxB,IAAA,OAAO,KAAK,OAAA,CAAQ,MAAA,EAAQ,GAAG,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,iBAAA,CAAA,EAAqB;AAAA,MACtE,IAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,SAAS,OAAA,EAUZ;AACD,IAAA,MAAM,EAAE,KAAA,EAAO,SAAA,EAAW,IAAA,EAAK,GAAI,OAAA;AACnC,IAAA,OAAO,KAAK,OAAA,CAAQ,MAAA,EAAQ,GAAG,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,iBAAA,CAAA,EAAqB;AAAA,MACtE,IAAA,EAAM;AAAA,QACJ,SAAA;AAAA,QACA,UAAU,IAAA,CAAK,QAAA;AAAA,QACf,YAAY,IAAA,CAAK,UAAA;AAAA,QACjB,UAAU,IAAA,CAAK,QAAA;AAAA,QACf,IAAA,EAAM,KAAA;AAAA,QACN,MAAA,EAAQ,IAAA,CAAK,MAAA,IAAU,IAAA,CAAK;AAAA,OAC9B;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WAAW,OAAA,EAGd;AACD,IAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,OAAA;AACxB,IAAA,OAAO,KAAK,OAAA,CAAQ,MAAA,EAAQ,GAAG,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,iBAAA,CAAA,EAAqB;AAAA,MACtE,IAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAEO,IAAM,MAAA,GAAS,IAAI,MAAA,CAAO,KAAK;AACtC,IAAO,WAAA,GAAQ","file":"chunk-66OQAZSL.js","sourcesContent":["/**\r\n * POS API Client\r\n *\r\n * Follows BaseApi pattern: all methods accept { token, ...params/data }\r\n */\r\n\r\nimport { BaseApi } from '../../core/api-factory';\r\nimport type {\r\n  PosProductsResponse,\r\n  PosLookupResponse,\r\n  PosOrderPayload,\r\n} from '../types/pos';\r\nimport type {\r\n  CreateAdjustmentPayload,\r\n  BulkAdjustmentPayload,\r\n} from '../../inventory/types';\r\n\r\nclass PosApi extends BaseApi {\r\n\r\n  /**\r\n   * Browse products with branch-specific stock\r\n   * GET /api/v1/pos/products\r\n   */\r\n  async getProducts(options: {\r\n    token: string;\r\n    branchId?: string;\r\n    /** Filter by category slug (matches both parent and child categories) */\r\n    category?: string;\r\n    search?: string;\r\n    inStockOnly?: boolean;\r\n    lowStockOnly?: boolean;\r\n    sort?: string;\r\n    after?: string;\r\n    limit?: number;\r\n  }) {\r\n    const { token, ...params } = options;\r\n    return this.request<PosProductsResponse>('GET', `${this.config.basePath}/pos/products`, {\r\n      params,\r\n      token\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Fast Lookup by Barcode/SKU\r\n   * GET /api/v1/pos/lookup\r\n   */\r\n  async lookup(options: {\r\n    token: string;\r\n    code: string;\r\n    branchId?: string;\r\n  }) {\r\n    const { token, ...params } = options;\r\n    return this.request<PosLookupResponse>('GET', `${this.config.basePath}/pos/lookup`, {\r\n      params,\r\n      token\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create POS Order\r\n   * POST /api/v1/pos/orders\r\n   */\r\n  async createOrder(options: {\r\n    token: string;\r\n    data: PosOrderPayload;\r\n  }) {\r\n    const { token, data } = options;\r\n    return this.request('POST', `${this.config.basePath}/pos/orders`, {\r\n      data: data as unknown as Record<string, unknown>,\r\n      token\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Get Receipt Data\r\n   * GET /api/v1/pos/orders/:orderId/receipt\r\n   */\r\n  async getReceipt(options: {\r\n    token: string;\r\n    orderId: string;\r\n  }) {\r\n    const { token, orderId } = options;\r\n    return this.request('GET', `${this.config.basePath}/pos/orders/${orderId}/receipt`, {\r\n      token\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Adjust Stock (Quick Adjustment from POS)\r\n   * POST /api/v1/pos/stock/adjust\r\n   */\r\n  async adjustStock(options: {\r\n    token: string;\r\n    data: CreateAdjustmentPayload;\r\n  }) {\r\n    const { token, data } = options;\r\n    return this.request('POST', `${this.config.basePath}/pos/stock/adjust`, {\r\n      data: data as unknown as Record<string, unknown>,\r\n      token\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Set stock level directly (POS adjustment alias)\r\n   * POST /api/v1/pos/stock/adjust\r\n   */\r\n  async setStock(options: {\r\n    token: string;\r\n    productId: string;\r\n    data: {\r\n      quantity: number;\r\n      branchId?: string;\r\n      variantSku?: string;\r\n      reason?: string;\r\n      notes?: string;\r\n    };\r\n  }) {\r\n    const { token, productId, data } = options;\r\n    return this.request('POST', `${this.config.basePath}/pos/stock/adjust`, {\r\n      data: {\r\n        productId,\r\n        quantity: data.quantity,\r\n        variantSku: data.variantSku,\r\n        branchId: data.branchId,\r\n        mode: 'set',\r\n        reason: data.reason ?? data.notes,\r\n      },\r\n      token,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Bulk adjustments (POS adjustment alias)\r\n   * POST /api/v1/pos/stock/adjust\r\n   */\r\n  async bulkAdjust(options: {\r\n    token: string;\r\n    data: BulkAdjustmentPayload;\r\n  }) {\r\n    const { token, data } = options;\r\n    return this.request('POST', `${this.config.basePath}/pos/stock/adjust`, {\r\n      data: data as unknown as Record<string, unknown>,\r\n      token,\r\n    });\r\n  }\r\n}\r\n\r\nexport const posApi = new PosApi('pos');\r\nexport default posApi;\r\n"]}

package/dist/chunk-6RYGA6MF.js

@@ -0,0 +1,123 @@
+import { BaseApi } from './chunk-I5TIKUIQ.js';
+import { handleApiRequest } from './chunk-VR36QVX2.js';
+
+// src/inventory/api/purchase.ts
+var PurchaseApi = class extends BaseApi {
+  constructor(config = {}) {
+    super("inventory/purchases", config);
+  }
+  // ==================== Actions (Stripe Pattern) ====================
+  /**
+   * Perform a purchase action (receive/pay/cancel)
+   * POST /inventory/purchases/:id/action
+   */
+  async action({
+    token,
+    id,
+    action,
+    data = {},
+    options = {}
+  }) {
+    if (!id) {
+      throw new Error("Purchase ID is required");
+    }
+    return handleApiRequest("POST", `${this.baseUrl}/${id}/action`, {
+      token,
+      body: { action, ...data },
+      cache: this.config.cache,
+      ...options
+    });
+  }
+  /**
+   * Receive a purchase (auto-approves draft and creates stock movements)
+   * POST /inventory/purchases/:id/action { action: 'receive' }
+   */
+  async receive({
+    token,
+    id,
+    options = {}
+  }) {
+    return this.action({ token, id, action: "receive", options });
+  }
+  /**
+   * Record payment for a purchase
+   * POST /inventory/purchases/:id/action { action: 'pay', amount, method, reference }
+   */
+  async pay({
+    token,
+    id,
+    amount,
+    method,
+    reference,
+    accountNumber,
+    walletNumber,
+    bankName,
+    accountName,
+    proofUrl,
+    transactionDate,
+    notes,
+    options = {}
+  }) {
+    return this.action({
+      token,
+      id,
+      action: "pay",
+      data: {
+        amount,
+        method,
+        reference,
+        accountNumber,
+        walletNumber,
+        bankName,
+        accountName,
+        proofUrl,
+        transactionDate,
+        notes
+      },
+      options
+    });
+  }
+  /**
+   * Cancel a purchase (draft or approved only)
+   * POST /inventory/purchases/:id/action { action: 'cancel', reason }
+   */
+  async cancel({
+    token,
+    id,
+    reason,
+    options = {}
+  }) {
+    return this.action({
+      token,
+      id,
+      action: "cancel",
+      data: { reason },
+      options
+    });
+  }
+  // ==================== Legacy Methods (Backward Compatibility) ====================
+  /**
+   * Record a stock purchase (legacy method)
+   * Creates and optionally auto-receives a purchase
+   *
+   * @deprecated Use create() with autoReceive: true instead
+   */
+  async recordPurchase({
+    token,
+    data,
+    options = {}
+  }) {
+    const payload = { ...data, autoReceive: true };
+    return handleApiRequest("POST", this.baseUrl, {
+      token,
+      body: payload,
+      cache: this.config.cache,
+      ...options
+    });
+  }
+};
+var purchaseApi = new PurchaseApi();
+
+export { PurchaseApi, purchaseApi };
+//# sourceMappingURL=chunk-6RYGA6MF.js.map
+//# sourceMappingURL=chunk-6RYGA6MF.js.map

package/dist/chunk-6RYGA6MF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/inventory/api/purchase.ts"],"names":[],"mappings":"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","file":"chunk-6RYGA6MF.js","sourcesContent":["/**\r\n * Purchase API - Supplier Invoices & Stock Entry\r\n *\r\n * Base path: /api/v1/inventory/purchases\r\n *\r\n * Purchases are the only official way to bring new inventory into the system.\r\n * They are Head Office only and drive COGS (weighted average cost).\r\n *\r\n * Standard CRUD:\r\n * - create({ token, data }) - Create purchase invoice (draft)\r\n * - getAll({ token, params }) - List purchases with filtering\r\n * - getById({ token, id }) - Get purchase by ID\r\n * - update({ token, id, data }) - Update draft purchase\r\n *\r\n * Actions (Stripe pattern):\r\n * - receive({ token, id }) - Receive purchase (creates stock movements)\r\n * - pay({ token, id, amount, method, reference }) - Record payment\r\n * - cancel({ token, id, reason }) - Cancel draft/approved purchase\r\n */\r\n\r\nimport { BaseApi, type ApiResponse, type PaginatedResponse, type RequestOptions } from \"../../core/api-factory\";\r\nimport { handleApiRequest } from \"../../core/api-handler\";\r\nimport type {\r\n  Purchase,\r\n  CreatePurchasePayload,\r\n  UpdatePurchasePayload,\r\n  PurchaseActionType,\r\n  StockMovement,\r\n  StockEntry,\r\n} from \"../types\";\r\n\r\ntype FetchOptions = Omit<RequestOptions, \"token\" | \"organizationId\">;\r\n\r\nclass PurchaseApi extends BaseApi<Purchase, CreatePurchasePayload, UpdatePurchasePayload> {\r\n  constructor(config = {}) {\r\n    super(\"inventory/purchases\", config);\r\n  }\r\n\r\n  // ==================== Actions (Stripe Pattern) ====================\r\n\r\n  /**\r\n   * Perform a purchase action (receive/pay/cancel)\r\n   * POST /inventory/purchases/:id/action\r\n   */\r\n  async action({\r\n    token,\r\n    id,\r\n    action,\r\n    data = {},\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    action: PurchaseActionType;\r\n    data?: Record<string, unknown>;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Purchase>> {\r\n    if (!id) {\r\n      throw new Error(\"Purchase ID is required\");\r\n    }\r\n\r\n    return handleApiRequest(\"POST\", `${this.baseUrl}/${id}/action`, {\r\n      token,\r\n      body: { action, ...data },\r\n      cache: this.config.cache,\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Receive a purchase (auto-approves draft and creates stock movements)\r\n   * POST /inventory/purchases/:id/action { action: 'receive' }\r\n   */\r\n  async receive({\r\n    token,\r\n    id,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Purchase>> {\r\n    return this.action({ token, id, action: \"receive\", options });\r\n  }\r\n\r\n  /**\r\n   * Record payment for a purchase\r\n   * POST /inventory/purchases/:id/action { action: 'pay', amount, method, reference }\r\n   */\r\n  async pay({\r\n    token,\r\n    id,\r\n    amount,\r\n    method,\r\n    reference,\r\n    accountNumber,\r\n    walletNumber,\r\n    bankName,\r\n    accountName,\r\n    proofUrl,\r\n    transactionDate,\r\n    notes,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    amount: number;\r\n    method: string;\r\n    reference?: string;\r\n    accountNumber?: string;\r\n    walletNumber?: string;\r\n    bankName?: string;\r\n    accountName?: string;\r\n    proofUrl?: string;\r\n    transactionDate?: string;\r\n    notes?: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Purchase>> {\r\n    return this.action({\r\n      token,\r\n      id,\r\n      action: \"pay\",\r\n      data: {\r\n        amount,\r\n        method,\r\n        reference,\r\n        accountNumber,\r\n        walletNumber,\r\n        bankName,\r\n        accountName,\r\n        proofUrl,\r\n        transactionDate,\r\n        notes,\r\n      },\r\n      options,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Cancel a purchase (draft or approved only)\r\n   * POST /inventory/purchases/:id/action { action: 'cancel', reason }\r\n   */\r\n  async cancel({\r\n    token,\r\n    id,\r\n    reason,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    reason?: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Purchase>> {\r\n    return this.action({\r\n      token,\r\n      id,\r\n      action: \"cancel\",\r\n      data: { reason },\r\n      options,\r\n    });\r\n  }\r\n\r\n  // ==================== Legacy Methods (Backward Compatibility) ====================\r\n\r\n  /**\r\n   * Record a stock purchase (legacy method)\r\n   * Creates and optionally auto-receives a purchase\r\n   *\r\n   * @deprecated Use create() with autoReceive: true instead\r\n   */\r\n  async recordPurchase({\r\n    token,\r\n    data,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    data: CreatePurchasePayload;\r\n    options?: FetchOptions;\r\n  }): Promise<\r\n    ApiResponse<{\r\n      stockEntries: StockEntry[];\r\n      movements: StockMovement[];\r\n    }>\r\n  > {\r\n    // Set autoReceive to maintain backward compatibility\r\n    const payload = { ...data, autoReceive: true };\r\n    return handleApiRequest(\"POST\", this.baseUrl, {\r\n      token,\r\n      body: payload,\r\n      cache: this.config.cache,\r\n      ...options,\r\n    });\r\n  }\r\n}\r\n\r\nexport const purchaseApi = new PurchaseApi();\r\nexport { PurchaseApi };\r\n"]}