@classytic/commerce-sdk 0.1.2 → 0.2.1

package/dist/sales/types/pos.d.ts

@@ -0,0 +1,227 @@
+import { BasePaymentMethod } from "../../core/types/shared.js";
+import { Product, ProductImage, ProductVariant } from "../../catalog/types/product.js";
+//#region src/sales/types/pos.d.ts
+interface VariantStock {
+  sku: string;
+  attributes: Record<string, string>;
+  quantity: number;
+  priceModifier?: number;
+  costPrice?: number;
+  barcode?: string;
+}
+interface BranchStock {
+  quantity: number;
+  inStock: boolean;
+  lowStock: boolean;
+  variants?: VariantStock[];
+}
+type PosProduct = Omit<Product, 'costPrice'> & {
+  costPrice?: number;
+  branchStock?: BranchStock;
+};
+interface PosProductsSummary {
+  totalItems: number;
+  totalQuantity: number;
+  lowStockCount: number;
+  outOfStockCount: number;
+}
+interface PosProductsBranch {
+  _id: string;
+  code: string;
+  name: string;
+}
+interface PosProductsResponse {
+  success: boolean;
+  branch: PosProductsBranch;
+  summary: PosProductsSummary;
+  docs: PosProduct[];
+  hasMore: boolean;
+  next: string | null;
+  method?: string;
+  limit?: number;
+}
+interface PosProductsParams {
+  branchId?: string;
+  /** Filter by category slug (matches both parent and child categories) */
+  category?: string;
+  search?: string;
+  inStockOnly?: boolean;
+  lowStockOnly?: boolean;
+  sort?: string;
+  after?: string;
+  limit?: number;
+}
+interface PosLookupProduct {
+  _id: string;
+  name: string;
+  basePrice: number;
+  productType: string;
+  slug?: string;
+  sku?: string;
+  barcode?: string;
+  category?: string;
+  costPrice?: number;
+  images?: ProductImage[];
+  variants?: Array<{
+    sku: string;
+    attributes: Record<string, string>;
+    priceModifier?: number;
+  }>;
+}
+interface PosLookupData {
+  product: PosLookupProduct;
+  variantSku?: string;
+  matchedVariant?: {
+    sku: string;
+    attributes: Record<string, string>;
+    priceModifier: number;
+  };
+  quantity: number;
+  branchId: string;
+}
+interface PosLookupResponse {
+  success: boolean;
+  data: PosLookupData;
+  message?: string;
+}
+interface PosOrderItem {
+  productId: string;
+  variantSku?: string;
+  quantity: number;
+  price?: number;
+}
+interface PosPayment {
+  method: PosPaymentMethod;
+  amount?: number;
+  reference?: string;
+}
+interface PosCustomer {
+  name?: string;
+  phone?: string;
+  id?: string;
+}
+interface PosOrderPayload {
+  items: PosOrderItem[];
+  branchId?: string;
+  branchSlug?: string;
+  customer?: PosCustomer;
+  membershipCardId?: string;
+  pointsToRedeem?: number;
+  payment?: PosPayment;
+  payments?: PosPayment[];
+  discount?: number;
+  deliveryMethod?: 'pickup' | 'delivery';
+  deliveryAddress?: {
+    recipientName: string;
+    recipientPhone: string;
+    addressLine1?: string;
+    city?: string;
+    [key: string]: unknown;
+  };
+  deliveryPrice?: number;
+  deliveryAreaId?: number;
+  terminalId?: string;
+  idempotencyKey?: string;
+  notes?: string;
+}
+type PosPaymentMethod = BasePaymentMethod | 'upay';
+interface PosReceiptItem {
+  name: string;
+  variant?: string;
+  quantity: number;
+  unitPrice: number;
+  total: number;
+  vatRate?: number;
+  vatAmount?: number;
+}
+interface PosReceiptVat {
+  applicable: boolean;
+  rate: number;
+  amount: number;
+  taxableAmount: number;
+  sellerBin?: string;
+  pricesIncludeVat?: boolean;
+}
+interface PosReceiptData {
+  orderId: string;
+  orderNumber: string;
+  invoiceNumber?: string;
+  date: string;
+  branch: {
+    name: string;
+    phone?: string;
+  };
+  cashier?: string;
+  customer?: {
+    name?: string;
+    phone?: string | null;
+  };
+  membership?: {
+    cardId?: string;
+    tier?: string;
+    pointsEarned?: number;
+    tierDiscount?: number;
+  };
+  items: PosReceiptItem[];
+  subtotal: number;
+  discount: number;
+  deliveryCharge: number;
+  vat?: PosReceiptVat;
+  total: number;
+  payment: {
+    method: string;
+    amount: number;
+    reference?: string;
+  };
+}
+interface PosReceiptResponse {
+  success: boolean;
+  data: PosReceiptData;
+}
+interface PosReceipt extends PosReceiptData {}
+interface PosLookupResult {
+  product: PosProduct;
+  variant?: ProductVariant;
+  scannedCode: string;
+}
+interface PosCartItem {
+  productId: string;
+  productName: string;
+  variantSku?: string;
+  variantLabel?: string;
+  quantity: number;
+  unitPrice: number;
+  lineTotal: number;
+  image?: string;
+}
+interface SplitPaymentEntry {
+  id: string;
+  paymentKey: string;
+  posMethod: PosPaymentMethod;
+  amount: string;
+  reference: string;
+  error?: string;
+}
+interface PaymentOption {
+  key: string;
+  posMethod: PosPaymentMethod;
+  label: string;
+  needsReference: boolean;
+  note?: string;
+  walletNumber?: string;
+}
+interface PaymentState {
+  mode: 'single' | 'split';
+  selectedKey: string | null;
+  selectedMethod: PosPaymentMethod;
+  reference: string;
+  cashReceived: string;
+  changeAmount: number;
+  amountDue: number;
+  splitEntries: SplitPaymentEntry[];
+  splitTotal: number;
+  splitRemaining: number;
+  splitIsBalanced: boolean;
+}
+//#endregion
+export { BranchStock, PaymentOption, PaymentState, PosCartItem, PosCustomer, PosLookupData, PosLookupProduct, PosLookupResponse, PosLookupResult, PosOrderItem, PosOrderPayload, PosPayment, PosPaymentMethod, PosProduct, PosProductsBranch, PosProductsParams, PosProductsResponse, PosProductsSummary, PosReceipt, PosReceiptData, PosReceiptItem, PosReceiptResponse, PosReceiptVat, SplitPaymentEntry, VariantStock };

package/dist/sales/types/referrals.d.ts

@@ -0,0 +1,51 @@
+import { ApiResponse } from "../../core/api-factory.js";
+
+//#region src/sales/types/referrals.d.ts
+type ReferralStatus = 'pending' | 'approved' | 'rejected' | 'expired';
+interface Referral {
+  _id: string;
+  programId: string;
+  referrerId: string;
+  refereeId: string;
+  referralCode: string;
+  status: ReferralStatus;
+  referrerRewardPoints?: number;
+  refereeRewardPoints?: number;
+  referrerTransactionId?: string;
+  refereeTransactionId?: string;
+  approvedAt?: string;
+  rejectedAt?: string;
+  rejectionReason?: string;
+  expiresAt?: string;
+  metadata?: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+interface RecordReferralPayload {
+  referralCode: string;
+  refereeCustomerId: string;
+}
+interface RejectReferralPayload {
+  reason: string;
+}
+interface SelfReferralPayload {
+  referralCode: string;
+}
+interface ReferralListParams {
+  page?: number;
+  limit?: number;
+}
+type ReferralResponse = ApiResponse<Referral>;
+type ReferralListResponse = ApiResponse<{
+  docs: Referral[];
+  total: number;
+  page: number;
+  pages: number;
+  hasNext: boolean;
+  hasPrev: boolean;
+}>;
+type ReferralLookupResponse = ApiResponse<{
+  referrerMemberId: string;
+}>;
+//#endregion
+export { RecordReferralPayload, Referral, ReferralListParams, ReferralListResponse, ReferralLookupResponse, ReferralResponse, ReferralStatus, RejectReferralPayload, SelfReferralPayload };

package/dist/sales/types/tiers.d.ts

@@ -0,0 +1,56 @@
+import { ApiResponse } from "../../core/api-factory.js";
+
+//#region src/sales/types/tiers.d.ts
+interface TierQualification {
+  minLifetimePoints?: number;
+  minLifetimeSpend?: number;
+  evaluationPeriodDays?: number;
+}
+interface TierBenefits {
+  pointsMultiplier?: number;
+  discountPercent?: number;
+  freeShipping?: boolean;
+  customBenefits?: Record<string, unknown>;
+}
+interface TierDowngrade {
+  enabled: boolean;
+  gracePeriodDays?: number;
+}
+interface TierDefinition {
+  _id: string;
+  programId: string;
+  name: string;
+  rank: number;
+  qualificationCriteria: TierQualification;
+  benefits: TierBenefits;
+  downgrade: TierDowngrade;
+  color?: string;
+  metadata?: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+interface CreateTierPayload {
+  name: string;
+  rank: number;
+  qualificationCriteria: TierQualification;
+  benefits: TierBenefits;
+  downgrade?: TierDowngrade;
+  color?: string;
+}
+interface UpdateTierPayload {
+  name?: string;
+  rank?: number;
+  qualificationCriteria?: TierQualification;
+  benefits?: TierBenefits;
+  downgrade?: TierDowngrade;
+  color?: string;
+}
+type TierResponse = ApiResponse<TierDefinition>;
+type TierListResponse = ApiResponse<TierDefinition[]>;
+type TierEvaluationResponse = ApiResponse<{
+  upgraded: number;
+  downgraded: number;
+  unchanged: number;
+}>;
+//#endregion
+export { CreateTierPayload, TierBenefits, TierDefinition, TierDowngrade, TierEvaluationResponse, TierListResponse, TierQualification, TierResponse, UpdateTierPayload };

package/dist/server.d.ts

@@ -1,23 +1,41 @@
-import { SDKConfig } from './core/index.js';
-export { configureSDK, getBaseUrl, getSDKConfig, handleApiRequest } from './core/index.js';
-export { a as CommerceSDKClient, C as CommerceSDKConfig, c as createCommerceSDK, i as initCommerceSDK } from './client-BPG8fbae.js';
-export { a as authApi, d as createUser, f as forgetPassApi, e as getProfile, g as getUser, c as getUserByPhone, l as loginApi, r as registerApi, b as resetPassApi, t as tokenRefreshApi, u as updateUser, v as verifyManagerAuth } from './user-data-DdLjAGwO.js';
-export { c as categoryApi, p as productApi, s as sizeGuideApi } from './size-guide-DgjzjM5P.js';
-export { p as cartApi, r as customerApi, q as orderApi, t as posApi } from './pos-C-sBzevg.js';
-export { t as transactionApi } from './transaction-Bf6WjYCh.js';
-export { b as branchApi, c as couponApi, p as platformConfigApi, u as userApi } from './coupon-CDzL4bJG.js';
-export { g as getCmsPage, m as mediaApi, u as updateCmsPage } from './media-CNLJK93J.js';
-export { a as adjustmentApi, m as movementApi, p as purchaseApi, r as requestApi, s as stockApi, b as supplierApi, t as transferApi } from './stock-CfrU5_Wr.js';
-export { l as logisticsApi } from './logistics-REVDorcc.js';
-export { f as financeApi } from './finance-BJdfKRw0.js';
-export { p as paymentApi } from './payment-BRboLqvU.js';
-export { a as analyticsApi } from './analytics-DMcD-o8w.js';
-import './api-factory-B_h4RKBm.js';
-import './product-p09zXkXB.js';
-import './order-BfdPxZiA.js';
-import './inventory-B5pssqRx.js';
-import './transaction-dL3WW-er.js';
-
-declare function runWithSDKConfig<T>(config: SDKConfig, fn: () => T): T;
-
-export { runWithSDKConfig };
+import { analyticsApi } from "./analytics/api/analytics.js";
+import { authApi, getProfile, getUser, getUserByPhone, updateUser, verifyManagerAuth } from "./auth/api/user-data.js";
+import { configureSDK, getBaseUrl, getSDKConfig, handleApiRequest } from "./core/api-handler.js";
+import { productApi } from "./catalog/api/product.js";
+import { categoryApi } from "./catalog/api/category.js";
+import { sizeGuideApi } from "./catalog/api/size-guide.js";
+import { cartApi } from "./sales/api/cart.js";
+import { orderApi } from "./sales/api/order.js";
+import { customerApi } from "./sales/api/customer.js";
+import { posApi } from "./sales/api/pos.js";
+import { loyaltyApi } from "./sales/api/loyalty.js";
+import { earningRulesApi } from "./sales/api/earning-rules.js";
+import { tiersApi } from "./sales/api/tiers.js";
+import { referralsApi } from "./sales/api/referrals.js";
+import { availabilityApi } from "./inventory/api/availability.js";
+import { reservationApi } from "./inventory/api/reservation.js";
+import { scanApi } from "./inventory/api/scan.js";
+import { purchaseApi } from "./inventory/api/purchase.js";
+import { transferApi } from "./inventory/api/transfer.js";
+import { requestApi } from "./inventory/api/request.js";
+import { movementApi } from "./inventory/api/movement.js";
+import { adjustmentApi } from "./inventory/api/adjustment.js";
+import { supplierApi } from "./inventory/api/supplier.js";
+import { auditApi, locationApi, nodeApi } from "./inventory/api/warehouse.js";
+import { logisticsApi } from "./logistics/api/logistics.js";
+import { financeApi } from "./finance/api/finance.js";
+import { transactionApi } from "./transaction/api/transaction.js";
+import { cmsApi } from "./content/api/cms.js";
+import { mediaApi } from "./content/api/media.js";
+import { platformConfigApi } from "./platform/api/config.js";
+import { branchApi } from "./platform/api/branch.js";
+import { userApi } from "./platform/api/user.js";
+import { evaluationApi, programApi, voucherApi } from "./platform/api/promo.js";
+import { paymentApi } from "./payments/api/payment.js";
+import { CommerceSDKClient, CommerceSDKConfig, createCommerceSDK, initCommerceSDK } from "./client.js";
+import { runWithSDKConfig } from "./core/server-context.js";
+import { CrudPrefetcher, PrefetchDetailOptions, PrefetchOptions, createCrudPrefetcher, dehydrate } from "./core/prefetch.js";
+import { categoriesPrefetcher, productsPrefetcher } from "./catalog/prefetch.js";
+import { customersPrefetcher, ordersPrefetcher } from "./sales/prefetch.js";
+import { branchesPrefetcher } from "./platform/prefetch.js";
+export { type CommerceSDKClient, type CommerceSDKConfig, type CrudPrefetcher, type PrefetchDetailOptions, type PrefetchOptions, adjustmentApi, analyticsApi, auditApi, authApi, availabilityApi, branchApi, branchesPrefetcher, cartApi, categoriesPrefetcher, categoryApi, cmsApi, configureSDK, createCommerceSDK, createCrudPrefetcher, customerApi, customersPrefetcher, dehydrate, earningRulesApi, evaluationApi, financeApi, getBaseUrl, getProfile, getSDKConfig, getUser, getUserByPhone, handleApiRequest, initCommerceSDK, locationApi, logisticsApi, loyaltyApi, mediaApi, movementApi, nodeApi, orderApi, ordersPrefetcher, paymentApi, platformConfigApi, posApi, productApi, productsPrefetcher, programApi, purchaseApi, referralsApi, requestApi, reservationApi, runWithSDKConfig, scanApi, sizeGuideApi, supplierApi, tiersApi, transactionApi, transferApi, updateUser, userApi, verifyManagerAuth, voucherApi };

package/dist/server.js

@@ -1,37 +1,42 @@
-export { createCommerceSDK, initCommerceSDK } from './chunk-M3B4DFTT.js';
-export { logisticsApi } from './chunk-2YAZ5WG6.js';
-export { financeApi } from './chunk-N43VE355.js';
-export { transactionApi } from './chunk-AQAISI4F.js';
-export { getCmsPage, mediaApi, updateCmsPage } from './chunk-ERQ52WHY.js';
-export { branchApi, couponApi, platformConfigApi, userApi } from './chunk-YYFKLOKO.js';
-export { paymentApi } from './chunk-5E57JODA.js';
-export { analyticsApi } from './chunk-RIKAPJNG.js';
-export { authApi, createUser, forgetPassApi, getProfile, getUser, getUserByPhone, loginApi, registerApi, resetPassApi, tokenRefreshApi, updateUser, verifyManagerAuth } from './chunk-W22WB3WZ.js';
-export { categoryApi, productApi, sizeGuideApi } from './chunk-FOTUJPM4.js';
-import './chunk-PYYLHUV6.js';
-export { cartApi, customerApi, orderApi } from './chunk-4IYW6RF3.js';
-import './chunk-LRV7MWWX.js';
-export { purchaseApi } from './chunk-L4OEI4VZ.js';
-export { transferApi } from './chunk-36NLLAVH.js';
-export { requestApi } from './chunk-2TF7QNYV.js';
-export { movementApi } from './chunk-24FDD6UR.js';
-export { adjustmentApi } from './chunk-3OYSJB3P.js';
-export { supplierApi } from './chunk-7LZCW4VF.js';
-export { stockApi } from './chunk-X2CQFJPR.js';
-export { posApi } from './chunk-CILP56G2.js';
-import './chunk-QCTXAMLA.js';
-import './chunk-B6MPVOV7.js';
-import './chunk-U3XT35GZ.js';
-import { setSDKConfigProvider } from './chunk-IHCBBLLW.js';
-export { configureSDK, getBaseUrl, getSDKConfig, handleApiRequest } from './chunk-IHCBBLLW.js';
-import { AsyncLocalStorage } from 'async_hooks';
+import { configureSDK, getBaseUrl, getSDKConfig, handleApiRequest } from "./core/api-handler.js";
+import authApi, { getProfile, getUser, getUserByPhone, updateUser, verifyManagerAuth } from "./auth/api/user-data.js";
+import { productApi } from "./catalog/api/product.js";
+import { categoryApi } from "./catalog/api/category.js";
+import { sizeGuideApi } from "./catalog/api/size-guide.js";
+import { cartApi } from "./sales/api/cart.js";
+import orderApi from "./sales/api/order.js";
+import { customerApi } from "./sales/api/customer.js";
+import posApi from "./sales/api/pos.js";
+import { loyaltyApi } from "./sales/api/loyalty.js";
+import { earningRulesApi } from "./sales/api/earning-rules.js";
+import { tiersApi } from "./sales/api/tiers.js";
+import { referralsApi } from "./sales/api/referrals.js";
+import transactionApi from "./transaction/api/transaction.js";
+import { platformConfigApi } from "./platform/api/config.js";
+import { branchApi } from "./platform/api/branch.js";
+import { userApi } from "./platform/api/user.js";
+import { evaluationApi, programApi, voucherApi } from "./platform/api/promo.js";
+import { cmsApi } from "./content/api/cms.js";
+import { mediaApi } from "./content/api/media.js";
+import { paymentApi } from "./payments/api/payment.js";
+import { financeApi } from "./finance/api/finance.js";
+import { logisticsApi } from "./logistics/api/logistics.js";
+import { availabilityApi } from "./inventory/api/availability.js";
+import { reservationApi } from "./inventory/api/reservation.js";
+import { scanApi } from "./inventory/api/scan.js";
+import { purchaseApi } from "./inventory/api/purchase.js";
+import { transferApi } from "./inventory/api/transfer.js";
+import { requestApi } from "./inventory/api/request.js";
+import { movementApi } from "./inventory/api/movement.js";
+import { adjustmentApi } from "./inventory/api/adjustment.js";
+import { supplierApi } from "./inventory/api/supplier.js";
+import { auditApi, locationApi, nodeApi } from "./inventory/api/warehouse.js";
+import { createCommerceSDK, initCommerceSDK } from "./client.js";
+import { analyticsApi } from "./analytics/api/analytics.js";
+import { runWithSDKConfig } from "./core/server-context.js";
+import { createCrudPrefetcher, dehydrate } from "./core/prefetch.js";
+import { categoriesPrefetcher, productsPrefetcher } from "./catalog/prefetch.js";
+import { customersPrefetcher, ordersPrefetcher } from "./sales/prefetch.js";
+import { branchesPrefetcher } from "./platform/prefetch.js";
 
-var configStore = new AsyncLocalStorage();
-setSDKConfigProvider(() => configStore.getStore() ?? null);
-function runWithSDKConfig(config, fn) {
-  return configStore.run(config, fn);
-}
-
-export { runWithSDKConfig };
-//# sourceMappingURL=server.js.map
-//# sourceMappingURL=server.js.map
+export { adjustmentApi, analyticsApi, auditApi, authApi, availabilityApi, branchApi, branchesPrefetcher, cartApi, categoriesPrefetcher, categoryApi, cmsApi, configureSDK, createCommerceSDK, createCrudPrefetcher, customerApi, customersPrefetcher, dehydrate, earningRulesApi, evaluationApi, financeApi, getBaseUrl, getProfile, getSDKConfig, getUser, getUserByPhone, handleApiRequest, initCommerceSDK, locationApi, logisticsApi, loyaltyApi, mediaApi, movementApi, nodeApi, orderApi, ordersPrefetcher, paymentApi, platformConfigApi, posApi, productApi, productsPrefetcher, programApi, purchaseApi, referralsApi, requestApi, reservationApi, runWithSDKConfig, scanApi, sizeGuideApi, supplierApi, tiersApi, transactionApi, transferApi, updateUser, userApi, verifyManagerAuth, voucherApi };

package/dist/transaction/api/index.d.ts

@@ -0,0 +1 @@
+import { CashFlowParams, CategoryParams, ReportParams, StatementParams, TransactionApi, transactionApi } from "./transaction.js";

package/dist/transaction/api/transaction.d.ts

@@ -0,0 +1,63 @@
+import { BaseApi } from "../../core/api-factory.js";
+import { CashFlowReport, CategoryReport, CreateTransactionPayload, FinancialReport, StatementResponse, Transaction, UpdateTransactionPayload } from "../types/transaction.js";
+
+//#region src/transaction/api/transaction.d.ts
+/**
+ * Statement Query Params
+ */
+interface StatementParams {
+  startDate?: string;
+  endDate?: string;
+  branchId?: string;
+  source?: 'web' | 'pos' | 'api';
+  status?: string;
+  format?: 'csv' | 'json';
+  [key: string]: unknown;
+}
+/**
+ * Report Query Params
+ */
+interface ReportParams {
+  startDate?: string;
+  endDate?: string;
+  branchId?: string;
+  [key: string]: unknown;
+}
+interface CashFlowParams {
+  months?: number;
+  branchId?: string;
+  [key: string]: unknown;
+}
+interface CategoryParams extends ReportParams {
+  flow?: 'inflow' | 'outflow';
+  limit?: number;
+}
+declare class TransactionApi extends BaseApi<Transaction, CreateTransactionPayload, UpdateTransactionPayload> {
+  /**
+   * Get Profit & Loss Report
+   * Returns income (inflow), expenses (outflow), and net profit for a date range
+   */
+  getProfitLoss(params?: ReportParams, options?: {}): Promise<FinancialReport>;
+  /**
+   * Get Cash Flow Report
+   * Returns monthly inflow, outflow, and net trend
+   */
+  getCashFlow(params?: CashFlowParams, options?: {}): Promise<CashFlowReport>;
+  /**
+   * Get Category Breakdown
+   * Returns top spending/income categories for a date range
+   * Filter by flow='inflow' for income categories, flow='outflow' for expense categories
+   */
+  getCategoryReport(params?: CategoryParams, options?: {}): Promise<CategoryReport>;
+  /**
+   * 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)
+   */
+  getStatement(params?: StatementParams, options?: {}): Promise<StatementResponse | Blob>;
+}
+declare const transactionApi: TransactionApi;
+//#endregion
+export { CashFlowParams, CategoryParams, ReportParams, StatementParams, TransactionApi, transactionApi };

package/dist/transaction/api/transaction.js

@@ -0,0 +1,84 @@
+import { BaseApi } from "../../core/api-factory.js";
+
+//#region src/transaction/api/transaction.ts
+/**
+* Transaction API Client
+*
+* Transactions track cashflow events (money in/out) across the system.
+* Used by: Orders, POS, Inventory, CRM, HRM, and manual entries.
+*
+* CRUD (via BaseApi):
+* - getAll(params) - List transactions
+* - getById(id) - Get transaction
+* - create(payload) - Create manual transaction (staff only)
+* - update(id, payload) - Update transaction (limited fields)
+* - delete(id) - Delete transaction (admin/superadmin only)
+*
+* Reports:
+* - getProfitLoss(params) - P&L statement
+* - getCashFlow(params) - Monthly trend
+* - getCategoryReport(params) - Category breakdown
+*
+* Export:
+* - getStatement(params) - CSV/JSON export for accountants
+*/
+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
+			}
+		});
+	}
+};
+const transactionApi = new TransactionApi("transactions");
+
+//#endregion
+export { TransactionApi, transactionApi as default };

package/dist/transaction/hooks/index.d.ts

@@ -0,0 +1 @@
+import { TRANSACTION_KEYS, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions } from "./transaction.js";