@qrwise/pos-calculations 0.0.27 → 0.0.29

package/dist/index.cjs

@@ -27,6 +27,8 @@ __export(index_exports, {
   getDiscountBreakdown: () => getDiscountBreakdown,
   isAddVatAfterDiscount: () => isAddVatAfterDiscount,
   isVatExemptDiscount: () => isVatExemptDiscount,
+  subscriptionTaxFromBase: () => subscriptionTaxFromBase,
+  subscriptionTaxFromTotal: () => subscriptionTaxFromTotal,
   toMoneyNumber: () => toMoneyNumber
 });
 module.exports = __toCommonJS(index_exports);
@@ -436,6 +438,7 @@ function buildTransactionProjection(transaction, options = {}) {
   const storedZeroRatedSales = toMoneyNumber(transaction.zero_rated_sales);
   const storedNonTaxableSales = toMoneyNumber(transaction.non_taxable_sales);
   const storedNetOfVat = storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales;
+  const serviceCharge = toMoneyNumber(transaction.service_charge_amount);
   const reconstructsVoidedVoucherSale = !isSuccessful && hasVoucher && gross > 0 && options.isVatRegistered !== void 0;
   const voidedVoucherNet = reconstructsVoidedVoucherSale ? format2(gross / (options.isVatRegistered ? 1.12 : 1)) : 0;
   const netOfVat = voidedVoucherNet || storedNetOfVat || Math.max(0, toMoneyNumber(transaction.amount_payable) - storedVat);
@@ -487,12 +490,25 @@ function buildTransactionProjection(transaction, options = {}) {
   adjustments.vatOnReturns = returned ? -vatAmount : 0;
   adjustments.vatOnCancelled = cancelled ? -vatAmount : 0;
   adjustments.totalAdjustments = Object.values(adjustments).reduce((total, amount) => total + amount, 0);
-  const vatableSales = isSuccessful ? isNonVat ? 0 : hasVoucherAndDiscount ? format2(storedVatSales + Math.abs(otherDiscount)) : voucher > 0 ? scopedVoucherVatNet : storedVatSales : isNonVat ? 0 : netOfVat;
+  let vatableSales = isSuccessful ? isNonVat ? 0 : hasVoucherAndDiscount ? format2(storedVatSales + Math.abs(otherDiscount)) : voucher > 0 ? scopedVoucherVatNet : storedVatSales : isNonVat ? 0 : netOfVat;
+  const projectedGross = format2(vatableSales + vatAmount + vatExemptSales + storedZeroRatedSales);
+  const unclassifiedDiscountGross = format2(gross - projectedGross);
+  const storedComponentPayable = format2(storedNetOfVat + storedVat - discount + serviceCharge);
+  const hasHistoricalUnclassifiedDiscount = isSuccessful && !isNonVat && !hasVoucher && storedNonTaxableSales === 0 && unclassifiedDiscountGross > 0.02 && Math.abs(format2(toMoneyNumber(transaction.amount_payable) - storedComponentPayable)) <= 0.02;
+  if (hasHistoricalUnclassifiedDiscount) {
+    const inferredDiscountNet = format2(unclassifiedDiscountGross / 1.12);
+    const inferredDiscountVat = format2(unclassifiedDiscountGross - inferredDiscountNet);
+    vatableSales = format2(vatableSales + inferredDiscountNet);
+    vatAmount = format2(vatAmount + inferredDiscountVat);
+    deductions.otherDiscount = -inferredDiscountNet;
+    deductions.totalDeductions = format2(deductions.totalDeductions - inferredDiscountNet);
+    adjustments.otherDiscountAdjustment = -inferredDiscountVat;
+    adjustments.totalAdjustments = format2(adjustments.totalAdjustments - inferredDiscountVat);
+  }
   const zeroRatedSales = isSuccessful ? storedZeroRatedSales : 0;
   const netSales = isSuccessful ? format2(
     vatableSales + vatExemptSales + zeroRatedSales + (isNonVat ? 0 : storedNonTaxableSales) + deductions.scDiscount + deductions.pwdDiscount + deductions.naacDiscount + deductions.soloDiscount + deductions.movDiscount + deductions.otherDiscount
   ) : 0;
-  const serviceCharge = toMoneyNumber(transaction.service_charge_amount);
   return {
     state,
     receipt: {
@@ -530,6 +546,41 @@ function buildTransactionProjection(transaction, options = {}) {
     discountCounts: counts
   };
 }
+
+// src/subscription-tax.ts
+function cents(amount) {
+  const value = Number(amount);
+  const result = Math.round(value * 100);
+  if (!Number.isFinite(value) || value < 0 || !Number.isSafeInteger(result) || Math.abs(value * 100 - result) > 1e-4)
+    throw new Error("Invalid subscription amount");
+  return result;
+}
+function subscriptionTaxFromBase(amount) {
+  const base = cents(amount);
+  const vat = Math.round(base * 12 / 100);
+  if (!Number.isSafeInteger(base + vat)) throw new Error("Invalid subscription total");
+  return { base_price: base / 100, vat_amount: vat / 100, amount: (base + vat) / 100 };
+}
+function subscriptionTaxFromTotal(amount) {
+  const total = cents(amount);
+  const { vatNet } = calculateTotals({
+    quantity: 1,
+    discountableTotalAmount: total / 100,
+    nonDiscountableTotalAmount: 0,
+    serviceChargeableTotalAmount: 0,
+    togoableTotalAmount: 0,
+    voucherType: null,
+    voucherRate: 0,
+    discountType: null,
+    discountRate: 0,
+    vatRate: 112,
+    isVatRegistered: true,
+    serviceChargeRate: 0,
+    togoCharge: 0
+  });
+  const base = Math.round(vatNet * 100);
+  return { base_price: base / 100, vat_amount: (total - base) / 100, amount: total / 100 };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   buildTransactionProjection,
@@ -539,5 +590,7 @@ function buildTransactionProjection(transaction, options = {}) {
   getDiscountBreakdown,
   isAddVatAfterDiscount,
   isVatExemptDiscount,
+  subscriptionTaxFromBase,
+  subscriptionTaxFromTotal,
   toMoneyNumber
 });

package/dist/index.d.cts

@@ -197,4 +197,17 @@ declare function buildTransactionProjection(transaction: FinancialTransactionInp
     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 };
+/** Catalog subscription prices exclude 12% VAT. Round VAT once per charge. */
+declare function subscriptionTaxFromBase(amount: number | string): {
+    base_price: number;
+    vat_amount: number;
+    amount: number;
+};
+/** Preserve the actual total on legacy subscriptions and historical payments. */
+declare function subscriptionTaxFromTotal(amount: number | string): {
+    base_price: number;
+    vat_amount: number;
+    amount: number;
+};
+
+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, subscriptionTaxFromBase, subscriptionTaxFromTotal, toMoneyNumber };

package/dist/index.d.ts

@@ -197,4 +197,17 @@ declare function buildTransactionProjection(transaction: FinancialTransactionInp
     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 };
+/** Catalog subscription prices exclude 12% VAT. Round VAT once per charge. */
+declare function subscriptionTaxFromBase(amount: number | string): {
+    base_price: number;
+    vat_amount: number;
+    amount: number;
+};
+/** Preserve the actual total on legacy subscriptions and historical payments. */
+declare function subscriptionTaxFromTotal(amount: number | string): {
+    base_price: number;
+    vat_amount: number;
+    amount: number;
+};
+
+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, subscriptionTaxFromBase, subscriptionTaxFromTotal, toMoneyNumber };

package/dist/index.js

@@ -403,6 +403,7 @@ function buildTransactionProjection(transaction, options = {}) {
   const storedZeroRatedSales = toMoneyNumber(transaction.zero_rated_sales);
   const storedNonTaxableSales = toMoneyNumber(transaction.non_taxable_sales);
   const storedNetOfVat = storedVatSales + storedVatExemptSales + storedZeroRatedSales + storedNonTaxableSales;
+  const serviceCharge = toMoneyNumber(transaction.service_charge_amount);
   const reconstructsVoidedVoucherSale = !isSuccessful && hasVoucher && gross > 0 && options.isVatRegistered !== void 0;
   const voidedVoucherNet = reconstructsVoidedVoucherSale ? format2(gross / (options.isVatRegistered ? 1.12 : 1)) : 0;
   const netOfVat = voidedVoucherNet || storedNetOfVat || Math.max(0, toMoneyNumber(transaction.amount_payable) - storedVat);
@@ -454,12 +455,25 @@ function buildTransactionProjection(transaction, options = {}) {
   adjustments.vatOnReturns = returned ? -vatAmount : 0;
   adjustments.vatOnCancelled = cancelled ? -vatAmount : 0;
   adjustments.totalAdjustments = Object.values(adjustments).reduce((total, amount) => total + amount, 0);
-  const vatableSales = isSuccessful ? isNonVat ? 0 : hasVoucherAndDiscount ? format2(storedVatSales + Math.abs(otherDiscount)) : voucher > 0 ? scopedVoucherVatNet : storedVatSales : isNonVat ? 0 : netOfVat;
+  let vatableSales = isSuccessful ? isNonVat ? 0 : hasVoucherAndDiscount ? format2(storedVatSales + Math.abs(otherDiscount)) : voucher > 0 ? scopedVoucherVatNet : storedVatSales : isNonVat ? 0 : netOfVat;
+  const projectedGross = format2(vatableSales + vatAmount + vatExemptSales + storedZeroRatedSales);
+  const unclassifiedDiscountGross = format2(gross - projectedGross);
+  const storedComponentPayable = format2(storedNetOfVat + storedVat - discount + serviceCharge);
+  const hasHistoricalUnclassifiedDiscount = isSuccessful && !isNonVat && !hasVoucher && storedNonTaxableSales === 0 && unclassifiedDiscountGross > 0.02 && Math.abs(format2(toMoneyNumber(transaction.amount_payable) - storedComponentPayable)) <= 0.02;
+  if (hasHistoricalUnclassifiedDiscount) {
+    const inferredDiscountNet = format2(unclassifiedDiscountGross / 1.12);
+    const inferredDiscountVat = format2(unclassifiedDiscountGross - inferredDiscountNet);
+    vatableSales = format2(vatableSales + inferredDiscountNet);
+    vatAmount = format2(vatAmount + inferredDiscountVat);
+    deductions.otherDiscount = -inferredDiscountNet;
+    deductions.totalDeductions = format2(deductions.totalDeductions - inferredDiscountNet);
+    adjustments.otherDiscountAdjustment = -inferredDiscountVat;
+    adjustments.totalAdjustments = format2(adjustments.totalAdjustments - inferredDiscountVat);
+  }
   const zeroRatedSales = isSuccessful ? storedZeroRatedSales : 0;
   const netSales = isSuccessful ? format2(
     vatableSales + vatExemptSales + zeroRatedSales + (isNonVat ? 0 : storedNonTaxableSales) + deductions.scDiscount + deductions.pwdDiscount + deductions.naacDiscount + deductions.soloDiscount + deductions.movDiscount + deductions.otherDiscount
   ) : 0;
-  const serviceCharge = toMoneyNumber(transaction.service_charge_amount);
   return {
     state,
     receipt: {
@@ -497,6 +511,41 @@ function buildTransactionProjection(transaction, options = {}) {
     discountCounts: counts
   };
 }
+
+// src/subscription-tax.ts
+function cents(amount) {
+  const value = Number(amount);
+  const result = Math.round(value * 100);
+  if (!Number.isFinite(value) || value < 0 || !Number.isSafeInteger(result) || Math.abs(value * 100 - result) > 1e-4)
+    throw new Error("Invalid subscription amount");
+  return result;
+}
+function subscriptionTaxFromBase(amount) {
+  const base = cents(amount);
+  const vat = Math.round(base * 12 / 100);
+  if (!Number.isSafeInteger(base + vat)) throw new Error("Invalid subscription total");
+  return { base_price: base / 100, vat_amount: vat / 100, amount: (base + vat) / 100 };
+}
+function subscriptionTaxFromTotal(amount) {
+  const total = cents(amount);
+  const { vatNet } = calculateTotals({
+    quantity: 1,
+    discountableTotalAmount: total / 100,
+    nonDiscountableTotalAmount: 0,
+    serviceChargeableTotalAmount: 0,
+    togoableTotalAmount: 0,
+    voucherType: null,
+    voucherRate: 0,
+    discountType: null,
+    discountRate: 0,
+    vatRate: 112,
+    isVatRegistered: true,
+    serviceChargeRate: 0,
+    togoCharge: 0
+  });
+  const base = Math.round(vatNet * 100);
+  return { base_price: base / 100, vat_amount: (total - base) / 100, amount: total / 100 };
+}
 export {
   buildTransactionProjection,
   calculateTotals,
@@ -505,5 +554,7 @@ export {
   getDiscountBreakdown,
   isAddVatAfterDiscount,
   isVatExemptDiscount,
+  subscriptionTaxFromBase,
+  subscriptionTaxFromTotal,
   toMoneyNumber
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qrwise/pos-calculations",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "Shared POS calculations for QR Wise POS",
   "type": "module",
   "main": "./dist/index.cjs",