From 0edfe87b58f2ce519185c089b07e04e0c4560031 Mon Sep 17 00:00:00 2001
From: Louis Liu <louisliu@Louiss-MacBook-Air-568.local>
Date: Wed, 29 Jul 2026 12:13:34 +0800
Subject: [PATCH] test: add platform fee calculation coverage

---
 src/utils/fee-calculator.utils.ts       | 14 ++++++++++++
 tests/unit/utils/fee-calculator.test.ts | 30 +++++++++++++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 src/utils/fee-calculator.utils.ts
 create mode 100644 tests/unit/utils/fee-calculator.test.ts

diff --git a/src/utils/fee-calculator.utils.ts b/src/utils/fee-calculator.utils.ts
new file mode 100644
index 0000000..0187266
--- /dev/null
+++ b/src/utils/fee-calculator.utils.ts
@@ -0,0 +1,14 @@
+import Decimal from "decimal.js";
+
+const BASIS_POINTS_DIVISOR = new Decimal(10_000);
+const MONEY_DECIMAL_PLACES = 2;
+
+export function calculatePlatformFee(
+  amount: Decimal,
+  feeBps: number,
+): Decimal {
+  return amount
+    .mul(feeBps)
+    .div(BASIS_POINTS_DIVISOR)
+    .toDecimalPlaces(MONEY_DECIMAL_PLACES, Decimal.ROUND_HALF_UP);
+}
diff --git a/tests/unit/utils/fee-calculator.test.ts b/tests/unit/utils/fee-calculator.test.ts
new file mode 100644
index 0000000..aa90a25
--- /dev/null
+++ b/tests/unit/utils/fee-calculator.test.ts
@@ -0,0 +1,30 @@
+import Decimal from "decimal.js";
+
+import { calculatePlatformFee } from "../../../src/utils/fee-calculator.utils";
+
+describe("calculatePlatformFee", () => {
+  it("returns zero for 0 bps", () => {
+    expect(calculatePlatformFee(new Decimal(1000), 0).equals(new Decimal(0))).toBe(true);
+  });
+
+  it("calculates 50 bps as 0.5%", () => {
+    expect(calculatePlatformFee(new Decimal(1000), 50).equals(new Decimal(5))).toBe(true);
+  });
+
+  it("calculates 150 bps as 1.5%", () => {
+    expect(calculatePlatformFee(new Decimal(1000), 150).equals(new Decimal(15))).toBe(true);
+  });
+
+  it("calculates 250 bps as 2.5%", () => {
+    expect(calculatePlatformFee(new Decimal(1000), 250).equals(new Decimal(25))).toBe(true);
+  });
+
+  it("calculates 10000 bps as 100%", () => {
+    expect(calculatePlatformFee(new Decimal(1000), 10_000).equals(new Decimal(1000))).toBe(true);
+  });
+
+  it("rounds half up to currency precision", () => {
+    expect(calculatePlatformFee(new Decimal("10.005"), 10_000).toFixed(2)).toBe("10.01");
+    expect(calculatePlatformFee(new Decimal("10.004"), 10_000).toFixed(2)).toBe("10.00");
+  });
+});