@qrwise/pos-calculations 0.0.18 → 0.0.19

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  buildTransactionProjection: () => buildTransactionProjection,
   calculateTotals: () => calculateTotals,
   clamp: () => clamp,
   format2: () => format2,
@@ -117,8 +118,8 @@ function calculateSplitTotals(input) {
   const serviceCharge = input.serviceChargeRate > 0 ? format2(serviceChargeBase / vatDivisor * scRate) : 0;
   const togoCharge = input.togoableTotalAmount > 0 ? input.togoCharge : 0;
   const totalAmount = format2(Math.max(0, vatNet + vat + serviceCharge + togoCharge));
-  const voucherVatNet = format2(totalOrderAmount / vatDivisor);
-  const voucherVat = format2(voucherVatNet * vatRate);
+  const voucherVatNet2 = format2(totalOrderAmount / vatDivisor);
+  const voucherVat = format2(voucherVatNet2 * vatRate);
   return {
     quantity: input.quantity,
     subtotal,
@@ -137,9 +138,9 @@ function calculateSplitTotals(input) {
       voucher: {
         discount: voucherDiscounted,
         net: subtotal,
-        vatNet: voucherVatNet,
+        vatNet: voucherVatNet2,
         vat: voucherVat,
-        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet - Number(voucherRate.toFixed(2)) : voucherVatNet * Number(voucherRate.toFixed(2)))
+        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet2 - Number(voucherRate.toFixed(2)) : voucherVatNet2 * Number(voucherRate.toFixed(2)))
       },
       hasDiscount: totalDiscount > 0,
       discount: {
@@ -183,8 +184,8 @@ function calculateTotals(input) {
     }
   }
   const subtotal = totalOrderAmount + voucherDiscounted;
-  const voucherVatNet = format2(totalOrderAmount / vatRate);
-  const voucherVat = format2(voucherVatNet * 0.12);
+  const voucherVatNet2 = format2(totalOrderAmount / vatRate);
+  const voucherVat = format2(voucherVatNet2 * 0.12);
   let vatNet = format2(subtotal / vatRate);
   let vat = format2(vatNet * 0.12);
   const isSpecial = discountRate > 0;
@@ -228,9 +229,9 @@ function calculateTotals(input) {
       voucher: {
         discount: voucherDiscounted,
         net: subtotal,
-        vatNet: voucherVatNet,
+        vatNet: voucherVatNet2,
         vat: voucherVat,
-        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet - Number(voucherRate.toFixed(2)) : voucherVatNet * Number(voucherRate.toFixed(2)))
+        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet2 - Number(voucherRate.toFixed(2)) : voucherVatNet2 * Number(voucherRate.toFixed(2)))
       },
       hasDiscount: discountRate > 0,
       discount: {
@@ -257,8 +258,272 @@ function calculateTotals(input) {
     }
   };
 }
+
+// src/transaction-projection.ts
+var emptyWeights = () => ({ sc: 0, pwd: 0, naac: 0, solo: 0, mov: 0 });
+function categoryFor(value) {
+  const normalized = value.toLowerCase();
+  if (normalized.includes("senior")) return "sc";
+  if (normalized.includes("pwd") || normalized.includes("disability")) return "pwd";
+  if (normalized.includes("naac") || normalized.includes("athlete")) return "naac";
+  if (normalized.includes("solo")) return "solo";
+  if (normalized.includes("mov") || normalized.includes("valor") || normalized.includes("uniformed")) return "mov";
+  return null;
+}
+function allocate(amount, weights) {
+  const allocations = emptyWeights();
+  const categories = Object.keys(weights).filter((category) => weights[category] > 0);
+  if (categories.length === 1) {
+    allocations[categories[0]] = format2(amount);
+    return allocations;
+  }
+  const totalWeight = categories.reduce((total, category) => total + weights[category], 0);
+  let allocated = 0;
+  categories.forEach((category, index) => {
+    const share = index === categories.length - 1 ? format2(amount - allocated) : format2(amount * weights[category] / totalWeight);
+    allocations[category] = share;
+    allocated += share;
+  });
+  return allocations;
+}
+function itemizedWeights(transaction, options) {
+  const splits = transaction.metadata?.split_discounts;
+  if (!Array.isArray(splits)) return null;
+  const discountWeights = emptyWeights();
+  const vatExemptWeights = emptyWeights();
+  for (const rawSplit of splits) {
+    if (!rawSplit || typeof rawSplit !== "object") continue;
+    const discounts = rawSplit.discounts;
+    if (!Array.isArray(discounts)) continue;
+    for (const rawDiscount of discounts) {
+      if (!rawDiscount || typeof rawDiscount !== "object") continue;
+      const discount = rawDiscount;
+      const category = categoryFor(typeof discount.discount_name === "string" ? discount.discount_name : "");
+      if (!category) continue;
+      discountWeights[category] += Math.abs(toMoneyNumber(discount.discount_amount));
+      vatExemptWeights[category] += Math.abs(toMoneyNumber(discount.vat_exempt_sales));
+    }
+  }
+  if (Object.values(discountWeights).some((weight) => weight > 0)) {
+    return {
+      discountWeights,
+      vatExemptWeights: Object.values(vatExemptWeights).some((weight) => weight > 0) ? vatExemptWeights : { ...emptyWeights(), sc: discountWeights.sc, pwd: discountWeights.pwd }
+    };
+  }
+  const items = (transaction.transaction_items ?? []).filter((item) => item.item_status !== "cancelled");
+  const itemsById = new Map(items.filter((item) => item.id).map((item) => [item.id, item]));
+  splits.forEach((rawSplit, splitIndex) => {
+    if (!rawSplit || typeof rawSplit !== "object") return;
+    const split = rawSplit;
+    if (!Array.isArray(split.discounts)) return;
+    const itemIds = [split.transaction_item_ids, split.item_ids].find(Array.isArray)?.filter((itemId) => typeof itemId === "string");
+    const assignedItems = itemIds?.length ? itemIds.flatMap((itemId) => {
+      const item = itemsById.get(itemId);
+      return item ? [item] : [];
+    }) : splits.length === items.length ? [items[splitIndex]] : [];
+    if (!assignedItems.length) return;
+    const discounts = split.discounts.flatMap((rawDiscount) => {
+      if (!rawDiscount || typeof rawDiscount !== "object") return [];
+      const discount = rawDiscount;
+      const id = typeof discount.discount_id === "string" ? discount.discount_id : "";
+      const name = typeof discount.discount_name === "string" ? discount.discount_name : "";
+      const category = categoryFor(name);
+      if (!category) return [];
+      const customer = transaction.discount_customers?.find(
+        (entry) => id && entry.discount_id === id || !id && entry.discount_name === name
+      );
+      if (!customer) return [];
+      const rate = toMoneyNumber(discount.discount_rate) || toMoneyNumber(customer.discount_rate) || (id ? options.discountRatesById?.[id] : 0) || toMoneyNumber(transaction.discount_rate);
+      return rate > 0 ? [{ category, rate }] : [];
+    });
+    if (!discounts.length) return;
+    const discountableAmount = assignedItems.reduce((total, item) => {
+      const addOns = item.transaction_item_add_ons ?? [];
+      const addOnAmount = addOns.reduce((sum, addOn) => sum + toMoneyNumber(addOn.total_amount), 0);
+      const itemAmount = Math.max(0, toMoneyNumber(item.total_amount) - addOnAmount);
+      return total + (item.is_discountable === false ? 0 : itemAmount) + addOns.reduce(
+        (sum, addOn) => sum + (addOn.is_discountable === false ? 0 : toMoneyNumber(addOn.total_amount)),
+        0
+      );
+    }, 0);
+    const netShare = discountableAmount / discounts.length / 1.12;
+    for (const entry of discounts) {
+      discountWeights[entry.category] += netShare * (entry.rate / 100);
+      if (entry.category === "sc" || entry.category === "pwd") vatExemptWeights[entry.category] += netShare;
+    }
+  });
+  return Object.values(discountWeights).some((weight) => weight > 0) ? { discountWeights, vatExemptWeights } : null;
+}
+function discountAllocation(transaction, options) {
+  const counts = emptyWeights();
+  const rateWeights = emptyWeights();
+  for (const customer of transaction.discount_customers ?? []) {
+    const category = categoryFor(customer.discount_name ?? "");
+    if (!category) continue;
+    counts[category] += 1;
+    rateWeights[category] += toMoneyNumber(customer.discount_rate) || (customer.discount_id ? options.discountRatesById?.[customer.discount_id] : 0) || toMoneyNumber(transaction.discount_rate) || 1;
+  }
+  if (Object.values(counts).every((count) => count === 0)) {
+    const category = categoryFor(`${transaction.discount_name ?? ""} ${transaction.discount_code ?? ""}`);
+    if (category) {
+      counts[category] = 1;
+      rateWeights[category] = toMoneyNumber(transaction.discount_rate) || 1;
+    }
+  }
+  const itemized = itemizedWeights(transaction, options);
+  return {
+    counts,
+    discountWeights: itemized?.discountWeights ?? rateWeights,
+    vatExemptWeights: itemized?.vatExemptWeights
+  };
+}
+function voucherVatNet(transaction, voucher, discount) {
+  const gross = toMoneyNumber(transaction.gross_amount);
+  if (voucher <= 0 || discount <= 0) return format2(gross / 1.12);
+  const itemsById = new Map(
+    (transaction.transaction_items ?? []).filter((item) => item.id && item.item_status !== "cancelled").map((item) => [item.id, toMoneyNumber(item.total_amount)])
+  );
+  let itemizedGross = 0;
+  for (const rawSplit of Array.isArray(transaction.metadata?.split_discounts) ? transaction.metadata.split_discounts : []) {
+    if (!rawSplit || typeof rawSplit !== "object") continue;
+    const split = rawSplit;
+    if (!split.voucher) continue;
+    const shares = Array.isArray(split.item_shares) ? split.item_shares : [];
+    if (shares.length) {
+      for (const rawShare of shares) {
+        if (!rawShare || typeof rawShare !== "object") continue;
+        const share = rawShare;
+        if (typeof share.item_id !== "string") continue;
+        itemizedGross += (itemsById.get(share.item_id) ?? 0) * Math.max(0, Math.min(1, toMoneyNumber(share.share)));
+      }
+    } else {
+      const itemIds = [split.transaction_item_ids, split.item_ids].find(Array.isArray)?.filter((itemId) => typeof itemId === "string");
+      for (const itemId of itemIds ?? []) itemizedGross += itemsById.get(itemId) ?? 0;
+    }
+  }
+  const rate = toMoneyNumber(transaction.voucher_rate);
+  const percentageGross = transaction.voucher_type?.toLowerCase() === "percentage" && rate > 0 ? voucher / (rate / 100) : 0;
+  const eligibleGross = itemizedGross > 0 ? itemizedGross : percentageGross > 0 ? percentageGross : gross;
+  return format2(Math.min(gross, eligibleGross) / 1.12);
+}
+function buildTransactionProjection(transaction, options = {}) {
+  const status = `${transaction.status} ${transaction.payment_status}`.toLowerCase();
+  const state = status.includes("refund") || status.includes("return") ? "RETURNED" : status.includes("cancel") || status.includes("void") ? "CANCELLED" : "SUCCESS";
+  const isSuccessful = state === "SUCCESS";
+  const gross = toMoneyNumber(transaction.gross_amount);
+  const discount = Math.abs(toMoneyNumber(transaction.discount_amount));
+  const voucher = Math.abs(toMoneyNumber(transaction.voucher_discount_amount));
+  const voucherRate = toMoneyNumber(transaction.voucher_rate);
+  const hasVoucher = voucherRate > 0;
+  const hasVoucherAndDiscount = isSuccessful && voucher > 0 && discount > 0;
+  const scopedVoucherVatNet = voucherVatNet(transaction, voucher, discount);
+  const voucherForBirDiscount = -format2(
+    transaction.voucher_type?.toLowerCase() === "fixed" ? scopedVoucherVatNet - format2(voucherRate) : scopedVoucherVatNet * format2(voucherRate / 100)
+  );
+  const otherDiscount = isSuccessful && hasVoucher ? format2(voucherForBirDiscount) : 0;
+  const otherDiscountAdjustment = -format2(Math.abs(otherDiscount * 0.12));
+  const storedVat = Math.abs(toMoneyNumber(transaction.vat_amount));
+  const storedVatSales = toMoneyNumber(transaction.vat_sales);
+  const storedVatExemptSales = toMoneyNumber(transaction.vat_exempt_sales);
+  const storedZeroRatedSales = toMoneyNumber(transaction.zero_rated_sales);
+  const storedNonTaxableSales = toMoneyNumber(transaction.non_taxable_sales);
+  const netOfVat = storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales || Math.max(0, toMoneyNumber(transaction.amount_payable) - storedVat);
+  const returned = state === "RETURNED" ? -format2(netOfVat) : 0;
+  const cancelled = state === "CANCELLED" ? -format2(netOfVat) : 0;
+  const { counts, discountWeights, vatExemptWeights } = discountAllocation(transaction, options);
+  const allocatedDiscount = allocate(discount, discountWeights);
+  const deductions = {
+    scDiscount: isSuccessful ? -allocatedDiscount.sc : 0,
+    pwdDiscount: isSuccessful ? -allocatedDiscount.pwd : 0,
+    naacDiscount: isSuccessful ? -allocatedDiscount.naac : 0,
+    soloDiscount: isSuccessful ? -allocatedDiscount.solo : 0,
+    movDiscount: isSuccessful ? -allocatedDiscount.mov : 0,
+    otherDiscount,
+    returnAmount: returned,
+    voidAmount: cancelled,
+    totalDeductions: 0
+  };
+  deductions.totalDeductions = Object.values(deductions).reduce((total, amount) => total + amount, 0);
+  const vatExemptSales = isSuccessful ? storedVatExemptSales : 0;
+  const allocatedVatAdjustment = allocate(vatExemptSales * 0.12, {
+    ...vatExemptWeights ?? counts,
+    naac: 0,
+    solo: 0,
+    mov: 0
+  });
+  const adjustments = {
+    scDiscountAdjustment: isSuccessful ? -allocatedVatAdjustment.sc : 0,
+    pwdDiscountAdjustment: isSuccessful ? -allocatedVatAdjustment.pwd : 0,
+    naacDiscountAdjustment: 0,
+    soloDiscountAdjustment: 0,
+    movDiscountAdjustment: 0,
+    otherDiscountAdjustment,
+    vatOnReturns: 0,
+    vatOnCancelled: 0,
+    others: 0,
+    totalAdjustments: 0
+  };
+  const regularVat = storedVat || format2(Math.abs(storedVatExemptSales * 0.12));
+  let vatAmount = format2(
+    isSuccessful ? voucher > 0 ? Math.abs(scopedVoucherVatNet * 0.12) : regularVat : netOfVat * 0.12
+  );
+  if (hasVoucherAndDiscount) {
+    vatAmount = format2(
+      storedVat + Math.abs(adjustments.scDiscountAdjustment) + Math.abs(adjustments.pwdDiscountAdjustment) + Math.abs(adjustments.otherDiscountAdjustment)
+    );
+  }
+  adjustments.vatOnReturns = returned ? -vatAmount : 0;
+  adjustments.vatOnCancelled = cancelled ? -vatAmount : 0;
+  adjustments.totalAdjustments = Object.values(adjustments).reduce((total, amount) => total + amount, 0);
+  const vatableSales = isSuccessful ? hasVoucherAndDiscount ? format2(storedVatSales + Math.abs(otherDiscount)) : voucher > 0 ? scopedVoucherVatNet : storedVatSales : netOfVat;
+  const zeroRatedSales = isSuccessful ? storedZeroRatedSales : 0;
+  const netSales = isSuccessful ? format2(
+    vatableSales + vatExemptSales + zeroRatedSales + storedNonTaxableSales + deductions.scDiscount + deductions.pwdDiscount + deductions.naacDiscount + deductions.soloDiscount + deductions.movDiscount + deductions.otherDiscount
+  ) : 0;
+  const serviceCharge = toMoneyNumber(transaction.service_charge_amount);
+  const takeoutCharge = toMoneyNumber(transaction.takeout_charge_amount);
+  return {
+    state,
+    receipt: {
+      grossSales: gross,
+      promoDiscount: voucher,
+      netOfPromo: format2(gross - voucher),
+      netOfVat: format2(storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales),
+      statutoryDiscount: discount,
+      netSales: format2(netOfVat - discount),
+      vatSales: storedVatSales,
+      vatExemptSales: storedVatExemptSales,
+      zeroRatedSales: storedZeroRatedSales,
+      nonTaxableSales: storedNonTaxableSales,
+      vatAmount: storedVat,
+      totalSales: format2(
+        storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales + storedVat
+      ),
+      serviceCharge,
+      takeoutCharge,
+      amountPayable: toMoneyNumber(transaction.amount_payable)
+    },
+    report: {
+      grossSales: gross,
+      vatableSales,
+      voucherDiscount: voucher,
+      vatAmount,
+      vatExemptSales,
+      zeroRatedSales,
+      deductions,
+      serviceCharge,
+      takeoutCharge,
+      adjustments,
+      vatPayable: isSuccessful ? Math.max(0, format2(vatAmount - Math.abs(adjustments.totalAdjustments))) : 0,
+      netSales,
+      totalIncome: netSales
+    },
+    discountCounts: counts
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  buildTransactionProjection,
   calculateTotals,
   clamp,
   format2,

package/dist/index.d.cts

@@ -97,4 +97,104 @@ declare function getDiscountBreakdown(discountType: string | null | undefined, d
 };
 declare function calculateTotals(input: CalculateTotalsInput): CalculateTotalsResult;
 
-export { type CalculateTotalsInput, type CalculateTotalsResult, type DiscountBreakdown, type DiscountRates, type DiscountType, type PaxDiscountCounts, type VoucherType, calculateTotals, clamp, format2, getDiscountBreakdown, isAddVatAfterDiscount, isVatExemptDiscount, toMoneyNumber };
+type ReportDiscountCategory = "sc" | "pwd" | "naac" | "solo" | "mov";
+type DiscountWeights = Record<ReportDiscountCategory, number>;
+interface FinancialTransactionInput {
+    status: string;
+    payment_status: string;
+    gross_amount: number | string;
+    amount_payable: number | string;
+    discount_amount?: number | string | null;
+    discount_code?: string | null;
+    discount_name?: string | null;
+    discount_rate?: number | string | null;
+    voucher_discount_amount?: number | string | null;
+    voucher_rate?: number | string | null;
+    voucher_type?: string | null;
+    vat_sales?: number | string | null;
+    vat_amount?: number | string | null;
+    vat_exempt_sales?: number | string | null;
+    zero_rated_sales?: number | string | null;
+    non_taxable_sales?: number | string | null;
+    service_charge_amount?: number | string | null;
+    takeout_charge_amount?: number | string | null;
+    discount_customers?: Array<{
+        discount_id?: string | null;
+        discount_name?: string | null;
+        discount_rate?: number | string | null;
+    }> | null;
+    transaction_items?: Array<{
+        id?: string;
+        total_amount?: number | string | null;
+        is_discountable?: boolean | null;
+        item_status?: string | null;
+        transaction_item_add_ons?: Array<{
+            add_on_name?: string | null;
+            total_amount?: number | string | null;
+            is_discountable?: boolean | null;
+        }> | null;
+    }> | null;
+    metadata?: Record<string, unknown> | null;
+}
+interface TransactionProjectionOptions {
+    discountRatesById?: Record<string, number>;
+}
+declare function buildTransactionProjection(transaction: FinancialTransactionInput, options?: TransactionProjectionOptions): {
+    state: string;
+    receipt: {
+        grossSales: number;
+        promoDiscount: number;
+        netOfPromo: number;
+        netOfVat: number;
+        statutoryDiscount: number;
+        netSales: number;
+        vatSales: number;
+        vatExemptSales: number;
+        zeroRatedSales: number;
+        nonTaxableSales: number;
+        vatAmount: number;
+        totalSales: number;
+        serviceCharge: number;
+        takeoutCharge: number;
+        amountPayable: number;
+    };
+    report: {
+        grossSales: number;
+        vatableSales: number;
+        voucherDiscount: number;
+        vatAmount: number;
+        vatExemptSales: number;
+        zeroRatedSales: number;
+        deductions: {
+            scDiscount: number;
+            pwdDiscount: number;
+            naacDiscount: number;
+            soloDiscount: number;
+            movDiscount: number;
+            otherDiscount: number;
+            returnAmount: number;
+            voidAmount: number;
+            totalDeductions: number;
+        };
+        serviceCharge: number;
+        takeoutCharge: number;
+        adjustments: {
+            scDiscountAdjustment: number;
+            pwdDiscountAdjustment: number;
+            naacDiscountAdjustment: number;
+            soloDiscountAdjustment: number;
+            movDiscountAdjustment: number;
+            otherDiscountAdjustment: number;
+            vatOnReturns: number;
+            vatOnCancelled: number;
+            others: number;
+            totalAdjustments: number;
+        };
+        vatPayable: number;
+        netSales: number;
+        totalIncome: number;
+    };
+    discountCounts: DiscountWeights;
+};
+
+export { type CalculateTotalsInput, type CalculateTotalsResult, type DiscountBreakdown, type DiscountRates, type DiscountType, type FinancialTransactionInput, type PaxDiscountCounts, type ReportDiscountCategory, type TransactionProjectionOptions, type VoucherType, buildTransactionProjection, calculateTotals, clamp, format2, getDiscountBreakdown, isAddVatAfterDiscount, isVatExemptDiscount, toMoneyNumber };

package/dist/index.d.ts

@@ -97,4 +97,104 @@ declare function getDiscountBreakdown(discountType: string | null | undefined, d
 };
 declare function calculateTotals(input: CalculateTotalsInput): CalculateTotalsResult;
 
-export { type CalculateTotalsInput, type CalculateTotalsResult, type DiscountBreakdown, type DiscountRates, type DiscountType, type PaxDiscountCounts, type VoucherType, calculateTotals, clamp, format2, getDiscountBreakdown, isAddVatAfterDiscount, isVatExemptDiscount, toMoneyNumber };
+type ReportDiscountCategory = "sc" | "pwd" | "naac" | "solo" | "mov";
+type DiscountWeights = Record<ReportDiscountCategory, number>;
+interface FinancialTransactionInput {
+    status: string;
+    payment_status: string;
+    gross_amount: number | string;
+    amount_payable: number | string;
+    discount_amount?: number | string | null;
+    discount_code?: string | null;
+    discount_name?: string | null;
+    discount_rate?: number | string | null;
+    voucher_discount_amount?: number | string | null;
+    voucher_rate?: number | string | null;
+    voucher_type?: string | null;
+    vat_sales?: number | string | null;
+    vat_amount?: number | string | null;
+    vat_exempt_sales?: number | string | null;
+    zero_rated_sales?: number | string | null;
+    non_taxable_sales?: number | string | null;
+    service_charge_amount?: number | string | null;
+    takeout_charge_amount?: number | string | null;
+    discount_customers?: Array<{
+        discount_id?: string | null;
+        discount_name?: string | null;
+        discount_rate?: number | string | null;
+    }> | null;
+    transaction_items?: Array<{
+        id?: string;
+        total_amount?: number | string | null;
+        is_discountable?: boolean | null;
+        item_status?: string | null;
+        transaction_item_add_ons?: Array<{
+            add_on_name?: string | null;
+            total_amount?: number | string | null;
+            is_discountable?: boolean | null;
+        }> | null;
+    }> | null;
+    metadata?: Record<string, unknown> | null;
+}
+interface TransactionProjectionOptions {
+    discountRatesById?: Record<string, number>;
+}
+declare function buildTransactionProjection(transaction: FinancialTransactionInput, options?: TransactionProjectionOptions): {
+    state: string;
+    receipt: {
+        grossSales: number;
+        promoDiscount: number;
+        netOfPromo: number;
+        netOfVat: number;
+        statutoryDiscount: number;
+        netSales: number;
+        vatSales: number;
+        vatExemptSales: number;
+        zeroRatedSales: number;
+        nonTaxableSales: number;
+        vatAmount: number;
+        totalSales: number;
+        serviceCharge: number;
+        takeoutCharge: number;
+        amountPayable: number;
+    };
+    report: {
+        grossSales: number;
+        vatableSales: number;
+        voucherDiscount: number;
+        vatAmount: number;
+        vatExemptSales: number;
+        zeroRatedSales: number;
+        deductions: {
+            scDiscount: number;
+            pwdDiscount: number;
+            naacDiscount: number;
+            soloDiscount: number;
+            movDiscount: number;
+            otherDiscount: number;
+            returnAmount: number;
+            voidAmount: number;
+            totalDeductions: number;
+        };
+        serviceCharge: number;
+        takeoutCharge: number;
+        adjustments: {
+            scDiscountAdjustment: number;
+            pwdDiscountAdjustment: number;
+            naacDiscountAdjustment: number;
+            soloDiscountAdjustment: number;
+            movDiscountAdjustment: number;
+            otherDiscountAdjustment: number;
+            vatOnReturns: number;
+            vatOnCancelled: number;
+            others: number;
+            totalAdjustments: number;
+        };
+        vatPayable: number;
+        netSales: number;
+        totalIncome: number;
+    };
+    discountCounts: DiscountWeights;
+};
+
+export { type CalculateTotalsInput, type CalculateTotalsResult, type DiscountBreakdown, type DiscountRates, type DiscountType, type FinancialTransactionInput, type PaxDiscountCounts, type ReportDiscountCategory, type TransactionProjectionOptions, type VoucherType, buildTransactionProjection, calculateTotals, clamp, format2, getDiscountBreakdown, isAddVatAfterDiscount, isVatExemptDiscount, toMoneyNumber };

package/dist/index.js

@@ -85,8 +85,8 @@ function calculateSplitTotals(input) {
   const serviceCharge = input.serviceChargeRate > 0 ? format2(serviceChargeBase / vatDivisor * scRate) : 0;
   const togoCharge = input.togoableTotalAmount > 0 ? input.togoCharge : 0;
   const totalAmount = format2(Math.max(0, vatNet + vat + serviceCharge + togoCharge));
-  const voucherVatNet = format2(totalOrderAmount / vatDivisor);
-  const voucherVat = format2(voucherVatNet * vatRate);
+  const voucherVatNet2 = format2(totalOrderAmount / vatDivisor);
+  const voucherVat = format2(voucherVatNet2 * vatRate);
   return {
     quantity: input.quantity,
     subtotal,
@@ -105,9 +105,9 @@ function calculateSplitTotals(input) {
       voucher: {
         discount: voucherDiscounted,
         net: subtotal,
-        vatNet: voucherVatNet,
+        vatNet: voucherVatNet2,
         vat: voucherVat,
-        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet - Number(voucherRate.toFixed(2)) : voucherVatNet * Number(voucherRate.toFixed(2)))
+        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet2 - Number(voucherRate.toFixed(2)) : voucherVatNet2 * Number(voucherRate.toFixed(2)))
       },
       hasDiscount: totalDiscount > 0,
       discount: {
@@ -151,8 +151,8 @@ function calculateTotals(input) {
     }
   }
   const subtotal = totalOrderAmount + voucherDiscounted;
-  const voucherVatNet = format2(totalOrderAmount / vatRate);
-  const voucherVat = format2(voucherVatNet * 0.12);
+  const voucherVatNet2 = format2(totalOrderAmount / vatRate);
+  const voucherVat = format2(voucherVatNet2 * 0.12);
   let vatNet = format2(subtotal / vatRate);
   let vat = format2(vatNet * 0.12);
   const isSpecial = discountRate > 0;
@@ -196,9 +196,9 @@ function calculateTotals(input) {
       voucher: {
         discount: voucherDiscounted,
         net: subtotal,
-        vatNet: voucherVatNet,
+        vatNet: voucherVatNet2,
         vat: voucherVat,
-        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet - Number(voucherRate.toFixed(2)) : voucherVatNet * Number(voucherRate.toFixed(2)))
+        forBirDiscount: -(input.voucherType === "FIXED" ? voucherVatNet2 - Number(voucherRate.toFixed(2)) : voucherVatNet2 * Number(voucherRate.toFixed(2)))
       },
       hasDiscount: discountRate > 0,
       discount: {
@@ -225,7 +225,271 @@ function calculateTotals(input) {
     }
   };
 }
+
+// src/transaction-projection.ts
+var emptyWeights = () => ({ sc: 0, pwd: 0, naac: 0, solo: 0, mov: 0 });
+function categoryFor(value) {
+  const normalized = value.toLowerCase();
+  if (normalized.includes("senior")) return "sc";
+  if (normalized.includes("pwd") || normalized.includes("disability")) return "pwd";
+  if (normalized.includes("naac") || normalized.includes("athlete")) return "naac";
+  if (normalized.includes("solo")) return "solo";
+  if (normalized.includes("mov") || normalized.includes("valor") || normalized.includes("uniformed")) return "mov";
+  return null;
+}
+function allocate(amount, weights) {
+  const allocations = emptyWeights();
+  const categories = Object.keys(weights).filter((category) => weights[category] > 0);
+  if (categories.length === 1) {
+    allocations[categories[0]] = format2(amount);
+    return allocations;
+  }
+  const totalWeight = categories.reduce((total, category) => total + weights[category], 0);
+  let allocated = 0;
+  categories.forEach((category, index) => {
+    const share = index === categories.length - 1 ? format2(amount - allocated) : format2(amount * weights[category] / totalWeight);
+    allocations[category] = share;
+    allocated += share;
+  });
+  return allocations;
+}
+function itemizedWeights(transaction, options) {
+  const splits = transaction.metadata?.split_discounts;
+  if (!Array.isArray(splits)) return null;
+  const discountWeights = emptyWeights();
+  const vatExemptWeights = emptyWeights();
+  for (const rawSplit of splits) {
+    if (!rawSplit || typeof rawSplit !== "object") continue;
+    const discounts = rawSplit.discounts;
+    if (!Array.isArray(discounts)) continue;
+    for (const rawDiscount of discounts) {
+      if (!rawDiscount || typeof rawDiscount !== "object") continue;
+      const discount = rawDiscount;
+      const category = categoryFor(typeof discount.discount_name === "string" ? discount.discount_name : "");
+      if (!category) continue;
+      discountWeights[category] += Math.abs(toMoneyNumber(discount.discount_amount));
+      vatExemptWeights[category] += Math.abs(toMoneyNumber(discount.vat_exempt_sales));
+    }
+  }
+  if (Object.values(discountWeights).some((weight) => weight > 0)) {
+    return {
+      discountWeights,
+      vatExemptWeights: Object.values(vatExemptWeights).some((weight) => weight > 0) ? vatExemptWeights : { ...emptyWeights(), sc: discountWeights.sc, pwd: discountWeights.pwd }
+    };
+  }
+  const items = (transaction.transaction_items ?? []).filter((item) => item.item_status !== "cancelled");
+  const itemsById = new Map(items.filter((item) => item.id).map((item) => [item.id, item]));
+  splits.forEach((rawSplit, splitIndex) => {
+    if (!rawSplit || typeof rawSplit !== "object") return;
+    const split = rawSplit;
+    if (!Array.isArray(split.discounts)) return;
+    const itemIds = [split.transaction_item_ids, split.item_ids].find(Array.isArray)?.filter((itemId) => typeof itemId === "string");
+    const assignedItems = itemIds?.length ? itemIds.flatMap((itemId) => {
+      const item = itemsById.get(itemId);
+      return item ? [item] : [];
+    }) : splits.length === items.length ? [items[splitIndex]] : [];
+    if (!assignedItems.length) return;
+    const discounts = split.discounts.flatMap((rawDiscount) => {
+      if (!rawDiscount || typeof rawDiscount !== "object") return [];
+      const discount = rawDiscount;
+      const id = typeof discount.discount_id === "string" ? discount.discount_id : "";
+      const name = typeof discount.discount_name === "string" ? discount.discount_name : "";
+      const category = categoryFor(name);
+      if (!category) return [];
+      const customer = transaction.discount_customers?.find(
+        (entry) => id && entry.discount_id === id || !id && entry.discount_name === name
+      );
+      if (!customer) return [];
+      const rate = toMoneyNumber(discount.discount_rate) || toMoneyNumber(customer.discount_rate) || (id ? options.discountRatesById?.[id] : 0) || toMoneyNumber(transaction.discount_rate);
+      return rate > 0 ? [{ category, rate }] : [];
+    });
+    if (!discounts.length) return;
+    const discountableAmount = assignedItems.reduce((total, item) => {
+      const addOns = item.transaction_item_add_ons ?? [];
+      const addOnAmount = addOns.reduce((sum, addOn) => sum + toMoneyNumber(addOn.total_amount), 0);
+      const itemAmount = Math.max(0, toMoneyNumber(item.total_amount) - addOnAmount);
+      return total + (item.is_discountable === false ? 0 : itemAmount) + addOns.reduce(
+        (sum, addOn) => sum + (addOn.is_discountable === false ? 0 : toMoneyNumber(addOn.total_amount)),
+        0
+      );
+    }, 0);
+    const netShare = discountableAmount / discounts.length / 1.12;
+    for (const entry of discounts) {
+      discountWeights[entry.category] += netShare * (entry.rate / 100);
+      if (entry.category === "sc" || entry.category === "pwd") vatExemptWeights[entry.category] += netShare;
+    }
+  });
+  return Object.values(discountWeights).some((weight) => weight > 0) ? { discountWeights, vatExemptWeights } : null;
+}
+function discountAllocation(transaction, options) {
+  const counts = emptyWeights();
+  const rateWeights = emptyWeights();
+  for (const customer of transaction.discount_customers ?? []) {
+    const category = categoryFor(customer.discount_name ?? "");
+    if (!category) continue;
+    counts[category] += 1;
+    rateWeights[category] += toMoneyNumber(customer.discount_rate) || (customer.discount_id ? options.discountRatesById?.[customer.discount_id] : 0) || toMoneyNumber(transaction.discount_rate) || 1;
+  }
+  if (Object.values(counts).every((count) => count === 0)) {
+    const category = categoryFor(`${transaction.discount_name ?? ""} ${transaction.discount_code ?? ""}`);
+    if (category) {
+      counts[category] = 1;
+      rateWeights[category] = toMoneyNumber(transaction.discount_rate) || 1;
+    }
+  }
+  const itemized = itemizedWeights(transaction, options);
+  return {
+    counts,
+    discountWeights: itemized?.discountWeights ?? rateWeights,
+    vatExemptWeights: itemized?.vatExemptWeights
+  };
+}
+function voucherVatNet(transaction, voucher, discount) {
+  const gross = toMoneyNumber(transaction.gross_amount);
+  if (voucher <= 0 || discount <= 0) return format2(gross / 1.12);
+  const itemsById = new Map(
+    (transaction.transaction_items ?? []).filter((item) => item.id && item.item_status !== "cancelled").map((item) => [item.id, toMoneyNumber(item.total_amount)])
+  );
+  let itemizedGross = 0;
+  for (const rawSplit of Array.isArray(transaction.metadata?.split_discounts) ? transaction.metadata.split_discounts : []) {
+    if (!rawSplit || typeof rawSplit !== "object") continue;
+    const split = rawSplit;
+    if (!split.voucher) continue;
+    const shares = Array.isArray(split.item_shares) ? split.item_shares : [];
+    if (shares.length) {
+      for (const rawShare of shares) {
+        if (!rawShare || typeof rawShare !== "object") continue;
+        const share = rawShare;
+        if (typeof share.item_id !== "string") continue;
+        itemizedGross += (itemsById.get(share.item_id) ?? 0) * Math.max(0, Math.min(1, toMoneyNumber(share.share)));
+      }
+    } else {
+      const itemIds = [split.transaction_item_ids, split.item_ids].find(Array.isArray)?.filter((itemId) => typeof itemId === "string");
+      for (const itemId of itemIds ?? []) itemizedGross += itemsById.get(itemId) ?? 0;
+    }
+  }
+  const rate = toMoneyNumber(transaction.voucher_rate);
+  const percentageGross = transaction.voucher_type?.toLowerCase() === "percentage" && rate > 0 ? voucher / (rate / 100) : 0;
+  const eligibleGross = itemizedGross > 0 ? itemizedGross : percentageGross > 0 ? percentageGross : gross;
+  return format2(Math.min(gross, eligibleGross) / 1.12);
+}
+function buildTransactionProjection(transaction, options = {}) {
+  const status = `${transaction.status} ${transaction.payment_status}`.toLowerCase();
+  const state = status.includes("refund") || status.includes("return") ? "RETURNED" : status.includes("cancel") || status.includes("void") ? "CANCELLED" : "SUCCESS";
+  const isSuccessful = state === "SUCCESS";
+  const gross = toMoneyNumber(transaction.gross_amount);
+  const discount = Math.abs(toMoneyNumber(transaction.discount_amount));
+  const voucher = Math.abs(toMoneyNumber(transaction.voucher_discount_amount));
+  const voucherRate = toMoneyNumber(transaction.voucher_rate);
+  const hasVoucher = voucherRate > 0;
+  const hasVoucherAndDiscount = isSuccessful && voucher > 0 && discount > 0;
+  const scopedVoucherVatNet = voucherVatNet(transaction, voucher, discount);
+  const voucherForBirDiscount = -format2(
+    transaction.voucher_type?.toLowerCase() === "fixed" ? scopedVoucherVatNet - format2(voucherRate) : scopedVoucherVatNet * format2(voucherRate / 100)
+  );
+  const otherDiscount = isSuccessful && hasVoucher ? format2(voucherForBirDiscount) : 0;
+  const otherDiscountAdjustment = -format2(Math.abs(otherDiscount * 0.12));
+  const storedVat = Math.abs(toMoneyNumber(transaction.vat_amount));
+  const storedVatSales = toMoneyNumber(transaction.vat_sales);
+  const storedVatExemptSales = toMoneyNumber(transaction.vat_exempt_sales);
+  const storedZeroRatedSales = toMoneyNumber(transaction.zero_rated_sales);
+  const storedNonTaxableSales = toMoneyNumber(transaction.non_taxable_sales);
+  const netOfVat = storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales || Math.max(0, toMoneyNumber(transaction.amount_payable) - storedVat);
+  const returned = state === "RETURNED" ? -format2(netOfVat) : 0;
+  const cancelled = state === "CANCELLED" ? -format2(netOfVat) : 0;
+  const { counts, discountWeights, vatExemptWeights } = discountAllocation(transaction, options);
+  const allocatedDiscount = allocate(discount, discountWeights);
+  const deductions = {
+    scDiscount: isSuccessful ? -allocatedDiscount.sc : 0,
+    pwdDiscount: isSuccessful ? -allocatedDiscount.pwd : 0,
+    naacDiscount: isSuccessful ? -allocatedDiscount.naac : 0,
+    soloDiscount: isSuccessful ? -allocatedDiscount.solo : 0,
+    movDiscount: isSuccessful ? -allocatedDiscount.mov : 0,
+    otherDiscount,
+    returnAmount: returned,
+    voidAmount: cancelled,
+    totalDeductions: 0
+  };
+  deductions.totalDeductions = Object.values(deductions).reduce((total, amount) => total + amount, 0);
+  const vatExemptSales = isSuccessful ? storedVatExemptSales : 0;
+  const allocatedVatAdjustment = allocate(vatExemptSales * 0.12, {
+    ...vatExemptWeights ?? counts,
+    naac: 0,
+    solo: 0,
+    mov: 0
+  });
+  const adjustments = {
+    scDiscountAdjustment: isSuccessful ? -allocatedVatAdjustment.sc : 0,
+    pwdDiscountAdjustment: isSuccessful ? -allocatedVatAdjustment.pwd : 0,
+    naacDiscountAdjustment: 0,
+    soloDiscountAdjustment: 0,
+    movDiscountAdjustment: 0,
+    otherDiscountAdjustment,
+    vatOnReturns: 0,
+    vatOnCancelled: 0,
+    others: 0,
+    totalAdjustments: 0
+  };
+  const regularVat = storedVat || format2(Math.abs(storedVatExemptSales * 0.12));
+  let vatAmount = format2(
+    isSuccessful ? voucher > 0 ? Math.abs(scopedVoucherVatNet * 0.12) : regularVat : netOfVat * 0.12
+  );
+  if (hasVoucherAndDiscount) {
+    vatAmount = format2(
+      storedVat + Math.abs(adjustments.scDiscountAdjustment) + Math.abs(adjustments.pwdDiscountAdjustment) + Math.abs(adjustments.otherDiscountAdjustment)
+    );
+  }
+  adjustments.vatOnReturns = returned ? -vatAmount : 0;
+  adjustments.vatOnCancelled = cancelled ? -vatAmount : 0;
+  adjustments.totalAdjustments = Object.values(adjustments).reduce((total, amount) => total + amount, 0);
+  const vatableSales = isSuccessful ? hasVoucherAndDiscount ? format2(storedVatSales + Math.abs(otherDiscount)) : voucher > 0 ? scopedVoucherVatNet : storedVatSales : netOfVat;
+  const zeroRatedSales = isSuccessful ? storedZeroRatedSales : 0;
+  const netSales = isSuccessful ? format2(
+    vatableSales + vatExemptSales + zeroRatedSales + storedNonTaxableSales + deductions.scDiscount + deductions.pwdDiscount + deductions.naacDiscount + deductions.soloDiscount + deductions.movDiscount + deductions.otherDiscount
+  ) : 0;
+  const serviceCharge = toMoneyNumber(transaction.service_charge_amount);
+  const takeoutCharge = toMoneyNumber(transaction.takeout_charge_amount);
+  return {
+    state,
+    receipt: {
+      grossSales: gross,
+      promoDiscount: voucher,
+      netOfPromo: format2(gross - voucher),
+      netOfVat: format2(storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales),
+      statutoryDiscount: discount,
+      netSales: format2(netOfVat - discount),
+      vatSales: storedVatSales,
+      vatExemptSales: storedVatExemptSales,
+      zeroRatedSales: storedZeroRatedSales,
+      nonTaxableSales: storedNonTaxableSales,
+      vatAmount: storedVat,
+      totalSales: format2(
+        storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales + storedVat
+      ),
+      serviceCharge,
+      takeoutCharge,
+      amountPayable: toMoneyNumber(transaction.amount_payable)
+    },
+    report: {
+      grossSales: gross,
+      vatableSales,
+      voucherDiscount: voucher,
+      vatAmount,
+      vatExemptSales,
+      zeroRatedSales,
+      deductions,
+      serviceCharge,
+      takeoutCharge,
+      adjustments,
+      vatPayable: isSuccessful ? Math.max(0, format2(vatAmount - Math.abs(adjustments.totalAdjustments))) : 0,
+      netSales,
+      totalIncome: netSales
+    },
+    discountCounts: counts
+  };
+}
 export {
+  buildTransactionProjection,
   calculateTotals,
   clamp,
   format2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qrwise/pos-calculations",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "description": "Shared POS calculations for QR Wise POS",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -19,6 +19,7 @@
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean --tsconfig tsconfig.json",
+    "prepare": "npm run build",
     "test": "npm run build && node --test test/*.test.mjs",
     "prepublishOnly": "npm run build",
     "release:patch": "npm version patch && npm publish",