ofpos-shared-core 1.1.0

package/dist/services/purchaseService.d.ts

@@ -0,0 +1,130 @@
+import { PosCore } from '../PosCore';
+import { DbAdapter, QueryOptions } from 'ofcore';
+import { Purchase, PurchaseData } from '../models/Purchase';
+import { PurchaseItem } from '../models/PurchaseItem';
+export interface PurchaseCart {
+    supplierId: string;
+    items: Array<{
+        productId: string;
+        quantity: number;
+        uomId?: string;
+        unitCost: number;
+    }>;
+    paymentMethod: 'cash' | 'card' | 'bank_transfer' | 'tempo';
+    dueDate?: string;
+    paymentData?: any;
+    note?: string;
+}
+export interface PurchaseReceiveItemInput {
+    purchaseOrderItemId?: string;
+    productId?: string;
+    receivedQuantity: number;
+    unitCost?: number;
+    uomId?: string | null;
+    lotNumber?: string | null;
+    serialNumber?: string | null;
+    expiryDate?: string | null;
+    note?: string | null;
+}
+type PurchaseReceiveOptions = ({
+    method: 'cash';
+    data: any;
+} | {
+    method: 'tempo';
+    dueDate: string;
+}) & {
+    receivedItems?: PurchaseReceiveItemInput[];
+};
+/** Service interface for Purchase operations. */
+export interface IPurchaseService {
+    /** Add new Purchase. */
+    addPurchase(data: PurchaseData, tx?: DbAdapter): Promise<Purchase>;
+    /** Update existing Purchase. */
+    updatePurchase(id: string, data: Partial<PurchaseData>): Promise<Purchase>;
+    /** Get all Purchases with complex options. */
+    getPurchases(options?: QueryOptions, tx?: DbAdapter): Promise<Purchase[]>;
+    /** Get Purchase by ID or options. */
+    getPurchase(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<Purchase | null>;
+    /** Delete Purchase (logical). */
+    deletePurchase(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate Purchase by ID. */
+    duplicatePurchase(originalId: string, tx?: DbAdapter): Promise<Purchase>;
+    /** Finalize purchase by ID */
+    finalizePurchase(purchaseId: string, options: {
+        method: 'cash';
+        data: any;
+    } | {
+        method: 'tempo';
+        dueDate: string;
+    }, tx?: DbAdapter): Promise<{
+        purchase: Purchase;
+        queued: boolean;
+    }>;
+    /** Receive purchase from Purchase Order */
+    receivePurchaseFromPO(purchaseOrderId: string, options: PurchaseReceiveOptions): Promise<{
+        purchase: Purchase;
+        queued: boolean;
+    }>;
+    /** Create purchase from cart */
+    createPurchaseFromCart(cart: PurchaseCart): Promise<{
+        purchase: Purchase;
+        items: PurchaseItem[];
+    }>;
+}
+/** Service implementation for Purchase operations. */
+export declare class PurchaseService implements IPurchaseService {
+    private context;
+    private dbAdapter;
+    private syncStore?;
+    private docNumberPolicy;
+    private readonly defaultBaseCurrencyCode;
+    /**
+     * Initialize PurchaseService.
+     * @param context - PosCore context
+     */
+    constructor(context: PosCore);
+    private roundCurrencyAmount;
+    private resolveCurrencySnapshot;
+    private getCostingMethod;
+    private applyCostingPolicy;
+    /** Add new Purchase. */
+    addPurchase(data: PurchaseData, tx?: DbAdapter): Promise<Purchase>;
+    /** Update existing Purchase. */
+    updatePurchase(id: string, data: Partial<PurchaseData>, tx?: DbAdapter): Promise<Purchase>;
+    /** Get all Purchases with complex options. */
+    getPurchases(options?: QueryOptions, tx?: DbAdapter): Promise<Purchase[]>;
+    /** Get Purchase by ID or options. */
+    getPurchase(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<Purchase | null>;
+    /** Delete Purchase (logical). */
+    deletePurchase(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate Purchase by ID. */
+    duplicatePurchase(originalId: string, tx?: DbAdapter): Promise<Purchase>;
+    /** Finalize purchase by ID */
+    finalizePurchase(purchaseId: string, options: {
+        method: 'cash';
+        data: any;
+    } | {
+        method: 'tempo';
+        dueDate: string;
+    }, tx?: DbAdapter): Promise<{
+        purchase: Purchase;
+        queued: boolean;
+    }>;
+    /** Receive purchase from Purchase Order */
+    receivePurchaseFromPO(purchaseOrderId: string, options: PurchaseReceiveOptions, tx?: DbAdapter): Promise<{
+        purchase: Purchase;
+        queued: boolean;
+    }>;
+    /** Create purchase from cart */
+    createPurchaseFromCart(cart: PurchaseCart): Promise<{
+        purchase: Purchase;
+        items: PurchaseItem[];
+    }>;
+}
+export {};

package/dist/services/receivableService.d.ts

@@ -0,0 +1,47 @@
+import { PosCore } from '../PosCore';
+import { DbAdapter, QueryOptions } from 'ofcore';
+import { Receivable, ReceivableData } from '../models/Receivable';
+/** Service interface for Receivable operations. */
+export interface IReceivableService {
+    /** Add new Receivable. */
+    addReceivable(data: ReceivableData, tx?: DbAdapter): Promise<Receivable>;
+    /** Update existing Receivable. */
+    updateReceivable(id: string, data: Partial<ReceivableData>): Promise<Receivable>;
+    /** Get all Receivables with complex options. */
+    getReceivables(options?: QueryOptions, tx?: DbAdapter): Promise<Receivable[]>;
+    /** Get Receivable by ID or options. */
+    getReceivable(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<Receivable | null>;
+    /** Delete Receivable (logical). */
+    deleteReceivable(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate Receivable by ID. */
+    duplicateReceivable(originalId: string, tx?: DbAdapter): Promise<Receivable>;
+}
+/** Service implementation for Receivable operations. */
+export declare class ReceivableService implements IReceivableService {
+    private context;
+    private dbAdapter;
+    private syncStore?;
+    /**
+     * Initialize ReceivableService.
+     * @param context - PosCore context
+     */
+    constructor(context: PosCore);
+    /** Add new Receivable. */
+    addReceivable(data: ReceivableData, tx?: DbAdapter): Promise<Receivable>;
+    /** Update existing Receivable. */
+    updateReceivable(id: string, data: Partial<ReceivableData>, tx?: DbAdapter): Promise<Receivable>;
+    /** Get all Receivables with complex options. */
+    getReceivables(options?: QueryOptions, tx?: DbAdapter): Promise<Receivable[]>;
+    /** Get Receivable by ID or options. */
+    getReceivable(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<Receivable | null>;
+    /** Delete Receivable (logical). */
+    deleteReceivable(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate Receivable by ID. */
+    duplicateReceivable(originalId: string, tx?: DbAdapter): Promise<Receivable>;
+}

package/dist/services/reportScheduleService.d.ts

@@ -0,0 +1,47 @@
+import { PosCore } from '../PosCore';
+import { DbAdapter, QueryOptions } from 'ofcore';
+import { ReportSchedule, ReportScheduleData } from '../models/ReportSchedule';
+/** Service interface for ReportSchedule operations. */
+export interface IReportScheduleService {
+    /** Add new ReportSchedule. */
+    addReportSchedule(data: ReportScheduleData, tx?: DbAdapter): Promise<ReportSchedule>;
+    /** Update existing ReportSchedule. */
+    updateReportSchedule(id: string, data: Partial<ReportScheduleData>): Promise<ReportSchedule>;
+    /** Get all ReportSchedules with complex options. */
+    getReportSchedules(options?: QueryOptions, tx?: DbAdapter): Promise<ReportSchedule[]>;
+    /** Get ReportSchedule by ID or options. */
+    getReportSchedule(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<ReportSchedule | null>;
+    /** Delete ReportSchedule (logical). */
+    deleteReportSchedule(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate ReportSchedule by ID. */
+    duplicateReportSchedule(originalId: string, tx?: DbAdapter): Promise<ReportSchedule>;
+}
+/** Service implementation for ReportSchedule operations. */
+export declare class ReportScheduleService implements IReportScheduleService {
+    private context;
+    private dbAdapter;
+    private syncStore?;
+    /**
+     * Initialize ReportScheduleService.
+     * @param context - PosCore context
+     */
+    constructor(context: PosCore);
+    /** Add new ReportSchedule. */
+    addReportSchedule(data: ReportScheduleData, tx?: DbAdapter): Promise<ReportSchedule>;
+    /** Update existing ReportSchedule. */
+    updateReportSchedule(id: string, data: Partial<ReportScheduleData>, tx?: DbAdapter): Promise<ReportSchedule>;
+    /** Get all ReportSchedules with complex options. */
+    getReportSchedules(options?: QueryOptions, tx?: DbAdapter): Promise<ReportSchedule[]>;
+    /** Get ReportSchedule by ID or options. */
+    getReportSchedule(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<ReportSchedule | null>;
+    /** Delete ReportSchedule (logical). */
+    deleteReportSchedule(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate ReportSchedule by ID. */
+    duplicateReportSchedule(originalId: string, tx?: DbAdapter): Promise<ReportSchedule>;
+}

package/dist/services/reportingService.d.ts

@@ -0,0 +1,251 @@
+import { PosCore } from '../PosCore';
+import { Product } from '../models/Product';
+export interface DailyReport {
+    date: string;
+    totalSalesCash: number;
+    totalReturnsCash: number;
+    totalExpenses: number;
+    netCashMovement: number;
+    startingCash: number;
+    systemEndingCash: number;
+    physicalEndingCash: number;
+    cashDifference: number;
+    shifts: any[];
+}
+export interface DailyReconciliationPack {
+    date: string;
+    salesCashIn: number;
+    salesReturnCashOut: number;
+    purchaseCashOut: number;
+    purchaseReturnCashIn: number;
+    expenseCashOut: number;
+    cashAdjustmentIn: number;
+    cashAdjustmentOut: number;
+    totalCashIn: number;
+    totalCashOut: number;
+    netCashMovement: number;
+    inventoryAdjustmentEntries: number;
+    inventoryAdjustmentInQty: number;
+    inventoryAdjustmentOutQty: number;
+    inventoryAdjustmentNetQty: number;
+}
+export interface BranchPerformancePack {
+    date: string;
+    branchId: string;
+    totalSalesCash: number;
+    totalReturnsCash: number;
+    totalExpenses: number;
+    totalCashIn: number;
+    totalCashOut: number;
+    netCashMovement: number;
+    shiftsClosed: number;
+    totalCashDifferenceAbs: number;
+    stockDiscrepancyItems: number;
+    stockDiscrepancyAbsQty: number;
+    anomalyIndicators: string[];
+}
+export interface DailyExceptionReport {
+    date: string;
+    voidEvents: Array<{
+        transactionId: string;
+        referenceType: string;
+        referenceId: string;
+        amount: number;
+        date: string;
+    }>;
+    refundExceptions: Array<{
+        returnId: string;
+        type: string;
+        refundAmount: number;
+        actualRefund: number;
+        status: string;
+        date: string;
+    }>;
+    stockDiscrepancies: Array<{
+        stockOpnameId: string;
+        productId: string;
+        difference: number;
+        date: string;
+    }>;
+}
+export interface SupplierPayableAging {
+    supplierId: string;
+    openPayableCount: number;
+    totalOutstanding: number;
+    overduePayableCount: number;
+    overdueOutstanding: number;
+    maxDaysPastDue: number;
+    avgDaysPastDue: number;
+}
+export interface CustomerReceivableAging {
+    customerId: string;
+    openReceivableCount: number;
+    totalOutstanding: number;
+    overdueReceivableCount: number;
+    overdueOutstanding: number;
+    maxDaysPastDue: number;
+    escalationLevel: 'none' | 'warning' | 'critical';
+}
+export interface OverduePurchaseOrderAlert {
+    purchaseOrderId: string;
+    supplierId: string;
+    status: string;
+    expectedDeliveryDate: string;
+    daysOverdue: number;
+    total: number;
+}
+export interface SupplierPerformanceBaseline {
+    supplierId: string;
+    rating: number;
+    grade: 'A' | 'B' | 'C' | 'D';
+    openPayableCount: number;
+    overduePayableRatio: number;
+    openPurchaseOrderCount: number;
+    overdueOrderCount: number;
+    overdueOrderRatio: number;
+}
+export interface TopProduct {
+    productId: string;
+    productName: string;
+    quantity: number;
+    totalSales: number;
+}
+/**
+ * Ringkasan data penjualan.
+ * @property totalTransactions - jumlah transaksi.
+ * @property totalRevenue - total pendapatan.
+ */
+export interface SalesAggregate {
+    totalTransactions: number;
+    totalRevenue: number;
+}
+/**
+ * Representasi jumlah transaksi per jam.
+ * @property hour - jam dalam format '00'..'23'.
+ * @property count - jumlah transaksi pada jam tersebut.
+ */
+export interface TransactionsByHour {
+    hour: string;
+    count: number;
+}
+/**
+ * Representasi pendapatan per pelanggan.
+ * @property customerId - ID pelanggan.
+ * @property revenue - total pendapatan dari pelanggan.
+ */
+export interface RevenueByCustomer {
+    customerId: string;
+    revenue: number;
+}
+/**
+ * Antarmuka untuk layanan pelaporan.
+ * Menyediakan metode untuk mendapatkan agregat penjualan, transaksi per jam, dan pendapatan per pelanggan.
+ */
+export interface IReportingService {
+    /**
+     * Dapatkan ringkasan penjualan pada rentang tanggal.
+     * @param startDate - tanggal mulai.
+     * @param endDate - tanggal akhir.
+     * @returns Promise dengan SalesAggregate.
+     */
+    getSalesAggregate(startDate: Date, endDate: Date): Promise<SalesAggregate>;
+    /**
+     * Dapatkan jumlah transaksi per jam pada rentang tanggal.
+     * @param startDate - tanggal mulai.
+     * @param endDate - tanggal akhir.
+     * @returns Promise dengan array TransactionsByHour.
+     */
+    getTransactionsByHour(startDate: Date, endDate: Date): Promise<TransactionsByHour[]>;
+    /**
+     * Dapatkan pendapatan per pelanggan pada rentang tanggal.
+     * @param startDate - tanggal mulai.
+     * @param endDate - tanggal akhir.
+     * @returns Promise dengan array RevenueByCustomer.
+     */
+    getRevenueByCustomer(startDate: Date, endDate: Date): Promise<RevenueByCustomer[]>;
+    getTodaySales(): Promise<{
+        total: number;
+    }>;
+    getSalesThisMonth(): Promise<{
+        total: number;
+    }>;
+    getLowStockProducts(limit?: number, threshold?: number): Promise<Array<{
+        productId: string;
+        stock: number;
+        product: Product;
+    }>>;
+    getActiveShift(): Promise<any>;
+    getTopSellingProducts(limit?: number): Promise<TopProduct[]>;
+    getDailySalesLast7Days(): Promise<{
+        date: string;
+        total: number;
+    }[]>;
+    getDailyReconciliationPack(date: string): Promise<DailyReconciliationPack>;
+    getBranchPerformancePack(date: string): Promise<BranchPerformancePack>;
+    getDailyExceptionReport(date: string): Promise<DailyExceptionReport>;
+    getSupplierPayableAging(asOfDate?: string): Promise<SupplierPayableAging[]>;
+    getCustomerReceivableAging(asOfDate?: string): Promise<CustomerReceivableAging[]>;
+    getOverduePurchaseOrderAlerts(asOfDate?: string): Promise<OverduePurchaseOrderAlert[]>;
+    getSupplierPerformanceBaseline(asOfDate?: string): Promise<SupplierPerformanceBaseline[]>;
+}
+/**
+ * Implementasi layanan pelaporan.
+ * Menyediakan operasi untuk mengambil data pelaporan dari database.
+ */
+export declare class ReportingService implements IReportingService {
+    private context;
+    private validateDateRange;
+    private dbAdapter;
+    /**
+     * Inisialisasi layanan pelaporan.
+     * @param context - instance PosCore yang berisi registry dan SyncStore.
+     */
+    constructor(context: PosCore);
+    /**
+     * Dapatkan ringkasan penjualan pada rentang tanggal.
+     * @param startDate - tanggal mulai.
+     * @param endDate - tanggal akhir.
+     * @returns Promise dengan SalesAggregate berisi jumlah transaksi dan total pendapatan.
+     */
+    getSalesAggregate(startDate: Date, endDate: Date): Promise<SalesAggregate>;
+    /**
+     * Dapatkan jumlah transaksi per jam pada rentang tanggal.
+     * @param startDate - tanggal mulai.
+     * @param endDate - tanggal akhir.
+     * @returns Promise dengan array TransactionsByHour.
+     */
+    getTransactionsByHour(startDate: Date, endDate: Date): Promise<TransactionsByHour[]>;
+    /**
+     * Dapatkan pendapatan per pelanggan pada rentang tanggal.
+     * @param startDate - tanggal mulai.
+     * @param endDate - tanggal akhir.
+     * @returns Promise dengan array RevenueByCustomer.
+     */
+    getRevenueByCustomer(startDate: Date, endDate: Date): Promise<RevenueByCustomer[]>;
+    getTodaySales(): Promise<{
+        total: number;
+    }>;
+    getSalesThisMonth(): Promise<{
+        total: number;
+    }>;
+    getLowStockProducts(limit?: number, threshold?: number): Promise<{
+        productId: string;
+        stock: number;
+        product: Product;
+    }[]>;
+    getActiveShift(): Promise<{} | null>;
+    getTopSellingProducts(limit?: number): Promise<TopProduct[]>;
+    getDailySalesLast7Days(): Promise<{
+        date: string;
+        total: number;
+    }[]>;
+    getDailyReport(date: string): Promise<DailyReport>;
+    getDailyReconciliationPack(date: string): Promise<DailyReconciliationPack>;
+    getBranchPerformancePack(date: string): Promise<BranchPerformancePack>;
+    getDailyExceptionReport(date: string): Promise<DailyExceptionReport>;
+    getSupplierPayableAging(asOfDate?: string): Promise<SupplierPayableAging[]>;
+    getCustomerReceivableAging(asOfDate?: string): Promise<CustomerReceivableAging[]>;
+    getOverduePurchaseOrderAlerts(asOfDate?: string): Promise<OverduePurchaseOrderAlert[]>;
+    getSupplierPerformanceBaseline(asOfDate?: string): Promise<SupplierPerformanceBaseline[]>;
+    private diffInDays;
+}

package/dist/services/returnItemService.d.ts

@@ -0,0 +1,47 @@
+import { PosCore } from '../PosCore';
+import { DbAdapter, QueryOptions } from 'ofcore';
+import { ReturnItem, ReturnItemData } from '../models/ReturnItem';
+/** Service interface for ReturnItem operations. */
+export interface IReturnItemService {
+    /** Add new ReturnItem. */
+    addReturnItem(data: ReturnItemData, tx?: DbAdapter): Promise<ReturnItem>;
+    /** Update existing ReturnItem. */
+    updateReturnItem(id: string, data: Partial<ReturnItemData>): Promise<ReturnItem>;
+    /** Get all ReturnItems with complex options. */
+    getReturnItems(options?: QueryOptions, tx?: DbAdapter): Promise<ReturnItem[]>;
+    /** Get ReturnItem by ID or options. */
+    getReturnItem(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<ReturnItem | null>;
+    /** Delete ReturnItem (logical). */
+    deleteReturnItem(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate ReturnItem by ID. */
+    duplicateReturnItem(originalId: string, tx?: DbAdapter): Promise<ReturnItem>;
+}
+/** Service implementation for ReturnItem operations. */
+export declare class ReturnItemService implements IReturnItemService {
+    private context;
+    private dbAdapter;
+    private syncStore?;
+    /**
+     * Initialize ReturnItemService.
+     * @param context - PosCore context
+     */
+    constructor(context: PosCore);
+    /** Add new ReturnItem. */
+    addReturnItem(data: ReturnItemData, tx?: DbAdapter): Promise<ReturnItem>;
+    /** Update existing ReturnItem. */
+    updateReturnItem(id: string, data: Partial<ReturnItemData>, tx?: DbAdapter): Promise<ReturnItem>;
+    /** Get all ReturnItems with complex options. */
+    getReturnItems(options?: QueryOptions, tx?: DbAdapter): Promise<ReturnItem[]>;
+    /** Get ReturnItem by ID or options. */
+    getReturnItem(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<ReturnItem | null>;
+    /** Delete ReturnItem (logical). */
+    deleteReturnItem(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate ReturnItem by ID. */
+    duplicateReturnItem(originalId: string, tx?: DbAdapter): Promise<ReturnItem>;
+}

package/dist/services/returnService.d.ts

@@ -0,0 +1,123 @@
+import { PosCore } from '../PosCore';
+import { DbAdapter, QueryOptions } from 'ofcore';
+import { Return, ReturnData } from '../models/Return';
+import { ReturnType } from '../models/Return';
+export interface ProcessReturnInput {
+    /** saleId atau purchaseId – salah satu wajib diisi */
+    saleId?: string | null;
+    purchaseId?: string | null;
+    type: ReturnType;
+    reason?: string;
+    /** Daftar barang yang diretur */
+    items: Array<{
+        productId: string;
+        quantity: number;
+        /** Apakah barang dikembalikan ke stok? Default = true */
+        restock?: boolean;
+        /** Alasan kalau tidak restock */
+        restockNote?: string;
+    }>;
+    /** Jumlah yang SEHARUSNYA direfund (100%) */
+    refundAmount: number;
+    /** Jumlah yang BENAR-BENAR diterima (untuk supplier nakal) – default = refundAmount */
+    actualRefund?: number;
+    /** Metode refund yang benar-benar diterima */
+    refundMethod?: 'cash' | 'bank_transfer' | 'voucher' | 'credit_note' | 'deduct_next_purchase' | null;
+    /** Penanda numerik tambahan untuk actualRefund */
+    creditNoteNumber?: string;
+    refundNote?: number;
+    refundReceivedDate?: string;
+    approval?: {
+        approvedBy: string;
+        reason: string;
+        approverRole?: string;
+    };
+}
+/** Service interface for Return operations. */
+export interface IReturnService {
+    /** Add new Return. */
+    addReturn(data: ReturnData, tx?: DbAdapter): Promise<Return>;
+    /** Update existing Return. */
+    updateReturn(id: string, data: Partial<ReturnData>): Promise<Return>;
+    /** Get all Returns with complex options. */
+    getReturns(options?: QueryOptions, tx?: DbAdapter): Promise<Return[]>;
+    /** Get Return by ID or options. */
+    getReturn(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<Return | null>;
+    /** Delete Return (logical). */
+    deleteReturn(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate Return by ID. */
+    duplicateReturn(originalId: string, tx?: DbAdapter): Promise<Return>;
+    /** Finalize purchase by ID */
+    processReturn(input: ProcessReturnInput): Promise<{
+        returnId: string;
+        queued: boolean;
+    }>;
+    cancelReturn(returnId: string, reasonOrOptions?: string | {
+        reason?: string;
+        approval?: {
+            approvedBy: string;
+            reason: string;
+            approverRole?: string;
+        };
+    }): Promise<{
+        returnId: string;
+        queued: boolean;
+    }>;
+    getReturnsByReference(type: 'sale_return' | 'purchase_return', referenceId: string): Promise<Return[]>;
+    getReturnableQuantity(referenceType: 'sale' | 'purchase', referenceId: string, productId: string): Promise<number>;
+}
+/** Service implementation for Return operations. */
+export declare class ReturnService implements IReturnService {
+    private context;
+    private dbAdapter;
+    private syncStore?;
+    /**
+     * Initialize ReturnService.
+     * @param context - PosCore context
+     */
+    constructor(context: PosCore);
+    /** Add new Return. */
+    addReturn(data: ReturnData, tx?: DbAdapter): Promise<Return>;
+    /** Update existing Return. */
+    updateReturn(id: string, data: Partial<ReturnData>, tx?: DbAdapter): Promise<Return>;
+    /** Get all Returns with complex options. */
+    getReturns(options?: QueryOptions, tx?: DbAdapter): Promise<Return[]>;
+    /** Get Return by ID or options. */
+    getReturn(idOrOptions: string | QueryOptions, tx?: DbAdapter): Promise<Return | null>;
+    /** Delete Return (logical). */
+    deleteReturn(id: string, tx?: DbAdapter): Promise<{
+        id: string;
+        queued: boolean;
+    }>;
+    /** Duplicate Return by ID. */
+    duplicateReturn(originalId: string, tx?: DbAdapter): Promise<Return>;
+    private getReferenceItem;
+    private getCurrentRole;
+    private normalizeRoles;
+    private validateApproval;
+    private getFraudGuardPolicy;
+    private shouldTriggerFraudGuardForRefund;
+    private shouldTriggerFraudGuardForCancel;
+    processReturn(input: ProcessReturnInput): Promise<{
+        returnId: string;
+        queued: boolean;
+    }>;
+    cancelReturn(returnId: string, reasonOrOptions?: string | {
+        reason?: string;
+        approval?: {
+            approvedBy: string;
+            reason: string;
+            approverRole?: string;
+        };
+    }): Promise<{
+        returnId: string;
+        queued: boolean;
+    }>;
+    getReturnsByReference(type: ReturnType, referenceId: string): Promise<Return[]>;
+    getReturnableQuantity(referenceType: 'sale' | 'purchase', referenceId: string, productId: string): Promise<number>;
+    private calculateTotalReturnedQty;
+    private getOriginalQuantity;
+}