@stackedapp/utils 2.74.1 → 2.75.0

package/dist/currency.d.ts

@@ -19,12 +19,17 @@ declare const currency: {
     roundDecimalPlaces(val: number, decimalPlaces: number): number;
     roundDownDecimalPlaces(val: number, decimalPlaces: number): number;
     /**
-     * Round a reward amount based on reward kind.
-     * - loyalty_currency: round down to min using the currency's decimal places
-     * - coins: round down to min at 1 decimal place
-     * - all others: round down to min at 0 decimal places (integer)
-     *
-     * "Round down to min" means floor, but if the result would be 0, return the smallest unit instead.
+     * Floor `val` to `decimalPlaces`. The scaled value is first snapped to 15
+     * significant digits so binary float noise cannot push a value that is exact in
+     * decimal below the floor boundary (Math.floor(4.35 * 100) is 434, not 435).
+     */
+    floorToDecimalPlaces(val: number, decimalPlaces: number): number;
+    /**
+     * Floor a reward amount based on reward kind.
+     * - loyalty_currency: floor to `roundDecimalPlaces` (the platform Currency's setting, default 0)
+     * - coins: floor to `roundDecimalPlaces` (the org asset library currency's `decimalPlaces`, default 1)
+     * - discount: returned unchanged (the amount is a fraction)
+     * - all others: floor to a whole number
      */
     roundRewardAmount(amount: number, rewardKind: string, roundDecimalPlaces?: number): number;
 };

package/dist/currency.js

@@ -51,18 +51,30 @@ const currency = {
         return Math.floor(val * factor) / factor;
     },
     /**
-     * Round a reward amount based on reward kind.
-     * - loyalty_currency: round down to min using the currency's decimal places
-     * - coins: round down to min at 1 decimal place
-     * - all others: round down to min at 0 decimal places (integer)
-     *
-     * "Round down to min" means floor, but if the result would be 0, return the smallest unit instead.
+     * Floor `val` to `decimalPlaces`. The scaled value is first snapped to 15
+     * significant digits so binary float noise cannot push a value that is exact in
+     * decimal below the floor boundary (Math.floor(4.35 * 100) is 434, not 435).
+     */
+    floorToDecimalPlaces(val, decimalPlaces) {
+        const factor = 10 ** Math.max(0, Math.trunc(decimalPlaces));
+        return Math.floor(Number((val * factor).toPrecision(15))) / factor;
+    },
+    /**
+     * Floor a reward amount based on reward kind.
+     * - loyalty_currency: floor to `roundDecimalPlaces` (the platform Currency's setting, default 0)
+     * - coins: floor to `roundDecimalPlaces` (the org asset library currency's `decimalPlaces`, default 1)
+     * - discount: returned unchanged (the amount is a fraction)
+     * - all others: floor to a whole number
      */
     roundRewardAmount(amount, rewardKind, roundDecimalPlaces) {
-        if (rewardKind === 'loyalty_currency') {
-            return currency.roundDownDecimalPlaces(amount, roundDecimalPlaces ?? 0);
-        }
-        return currency.roundDownDecimalPlaces(amount, rewardKind === 'coins' ? 1 : 0);
+        if (rewardKind === 'discount')
+            return amount;
+        const decimalPlaces = rewardKind === 'loyalty_currency'
+            ? (roundDecimalPlaces ?? 0)
+            : rewardKind === 'coins'
+                ? (roundDecimalPlaces ?? 1)
+                : 0;
+        return currency.floorToDecimalPlaces(amount, decimalPlaces);
     },
 };
 exports.default = currency;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackedapp/utils",
-  "version": "2.74.1",
+  "version": "2.75.0",
   "description": "Public utilities for Stacked platform SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",