@konplit-services/common 1.0.362 → 1.0.364

package/build/events/Settlements-events/interfaces/index.d.ts

@@ -11,3 +11,4 @@ export * from "./settlement-transfer-verify-nibss.interface";
 export * from "./settlement-pay-merchant-nibss-created.interface";
 export * from "./settlement-transfer-reserved-nibss.interface";
 export * from "./settlement-manual-trigger.interface";
+export * from "./settlement-transaction-id-updated.interface";

package/build/events/Settlements-events/interfaces/index.js

@@ -27,3 +27,4 @@ __exportStar(require("./settlement-transfer-verify-nibss.interface"), exports);
 __exportStar(require("./settlement-pay-merchant-nibss-created.interface"), exports);
 __exportStar(require("./settlement-transfer-reserved-nibss.interface"), exports);
 __exportStar(require("./settlement-manual-trigger.interface"), exports);
+__exportStar(require("./settlement-transaction-id-updated.interface"), exports);

package/build/events/Settlements-events/interfaces/settlement-transaction-id-updated.interface.d.ts

@@ -0,0 +1,11 @@
+import { StreamEvent, StreamName, Subjects } from "../../subjects";
+export interface SettlementTransactionIdEvent {
+    subject: Subjects.SettlementTransactionIdUpdated;
+    streamName: StreamName.name;
+    streamEvents: StreamEvent.Event;
+    data: {
+        merchantId: string;
+        transactionId: string;
+        settlementId: string;
+    };
+}

package/build/events/Settlements-events/interfaces/settlement-transaction-id-updated.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/subjects.d.ts

@@ -63,6 +63,7 @@ export declare enum Subjects {
     SettlementTransferReservedNIBSS = "events.settlement.transfer.reserved.nibss",
     SettlementTransferWallet = "events.settlement.transfer.wallet",
     SettlementTransactionUpdated = "events.settlement.transaction.updated",
+    SettlementTransactionIdUpdated = "events.settlement.transaction.id.updated",
     TransferInitiation = "events.transfer.initiation",
     TransferFundReserved = "events.transfer.reserved",
     TransferFailed = "events.transfer.failed",

package/build/events/subjects.js

@@ -80,6 +80,7 @@ var Subjects;
     Subjects["SettlementTransferReservedNIBSS"] = "events.settlement.transfer.reserved.nibss";
     Subjects["SettlementTransferWallet"] = "events.settlement.transfer.wallet";
     Subjects["SettlementTransactionUpdated"] = "events.settlement.transaction.updated";
+    Subjects["SettlementTransactionIdUpdated"] = "events.settlement.transaction.id.updated";
     //TRANSFERS
     Subjects["TransferInitiation"] = "events.transfer.initiation";
     Subjects["TransferFundReserved"] = "events.transfer.reserved";

package/build/helper/money.d.ts

@@ -6,26 +6,39 @@ export declare const formatMoneyToNumber: (money: ReturnType<typeof dinero>) =>
 export declare const sumMoney: (a: ReturnType<typeof dinero>, b: ReturnType<typeof dinero>) => import("dinero.js").Dinero<number>;
 export declare const subtractMoney: (a: ReturnType<typeof dinero>, b: ReturnType<typeof dinero>) => import("dinero.js").Dinero<number>;
 /**
- * Multiplies a Dinero.js monetary amount by a factor, typically for percentage-based calculations.
- * The scale is dynamically calculated based on the number of decimal places in the factor,
- * plus 2 for the percentage conversion (÷100) and 2 for scaling (*100).
+ * Multiplies a Dinero.js monetary amount by a given factor, typically used for percentage-based calculations.
  *
- * @param a - The Dinero.js object representing the monetary amount (e.g., in kobo for NGN).
- * @param factor - The multiplier, typically a percentage rate (e.g., 1.4 for 1.4%).
- * @returns A new Dinero.js object representing the result of the multiplication.
- * @throws Error if the resulting amount is invalid (e.g., exceeds Number.MAX_SAFE_INTEGER).
+ * This function dynamically calculates the multiplication scale based on the number of decimal places
+ * in the factor to maintain precision, then adjusts for percentage scaling by adding 2 to the scale
+ * (because factor is a percentage, i.e., factor% = factor/100).
+ *
+ * The input amount is expected to be in the smallest currency unit (e.g., kobo for NGN, cents for USD).
+ *
+ * @param a - The Dinero.js monetary amount object, representing money in minor units.
+ * @param factor - The multiplier factor, typically a percentage (e.g., 1.4 means 1.4%).
+ *                 Can be any positive decimal number, including those with many decimal places (e.g., 1.00054).
+ *
+ * @returns A new Dinero.js object representing the result of the multiplication (e.g., the fee or adjusted amount).
+ *
+ * @throws Error if the calculation results in an invalid amount (e.g., exceeding Number.MAX_SAFE_INTEGER).
  *
  * @example
- * // Calculate 1.4% fee on 7100 kobo (71.00 NGN)
+ * // Calculate a 1.4% fee on ₦71.00 (7100 kobo)
  * const amount = dinero({ amount: 7100, currency: NGN });
  * const result = multiplyMoney(amount, 1.4);
- * // Result: { amount: 994, currency: NGN, scale: 2 } (99.4 kobo)
+ * // result.amount = 994 (kobo) which is ₦9.94
  *
  * @example
- * // Calculate 0.05% fee on 10000 kobo (100.00 NGN)
+ * // Calculate a 0.05% fee on ₦100.00 (10000 kobo)
  * const amount = dinero({ amount: 10000, currency: NGN });
  * const result = multiplyMoney(amount, 0.05);
- * // Result: { amount: 50, currency: NGN, scale: 2 } (5 kobo)
+ * // result.amount = 5 (kobo) which is ₦0.05
+ *
+ * @example
+ * // Calculate a 1.00054% fee on ₦2500.00 (250000 kobo)
+ * const amount = dinero({ amount: 250000, currency: NGN });
+ * const result = multiplyMoney(amount, 1.00054);
+ * // result.amount ≈ 2501 (kobo) which is approximately ₦25.01
  */
 export declare const multiplyMoney: (a: ReturnType<typeof dinero>, factor: number) => import("dinero.js").Dinero<number>;
 export declare const divideMoney: (money: ReturnType<typeof dinero>, divisor: number) => import("dinero.js").Dinero<number>;

package/build/helper/money.js

@@ -28,36 +28,54 @@ const subtractMoney = (a, b) => {
 };
 exports.subtractMoney = subtractMoney;
 /**
- * Multiplies a Dinero.js monetary amount by a factor, typically for percentage-based calculations.
- * The scale is dynamically calculated based on the number of decimal places in the factor,
- * plus 2 for the percentage conversion (÷100) and 2 for scaling (*100).
+ * Multiplies a Dinero.js monetary amount by a given factor, typically used for percentage-based calculations.
  *
- * @param a - The Dinero.js object representing the monetary amount (e.g., in kobo for NGN).
- * @param factor - The multiplier, typically a percentage rate (e.g., 1.4 for 1.4%).
- * @returns A new Dinero.js object representing the result of the multiplication.
- * @throws Error if the resulting amount is invalid (e.g., exceeds Number.MAX_SAFE_INTEGER).
+ * This function dynamically calculates the multiplication scale based on the number of decimal places
+ * in the factor to maintain precision, then adjusts for percentage scaling by adding 2 to the scale
+ * (because factor is a percentage, i.e., factor% = factor/100).
+ *
+ * The input amount is expected to be in the smallest currency unit (e.g., kobo for NGN, cents for USD).
+ *
+ * @param a - The Dinero.js monetary amount object, representing money in minor units.
+ * @param factor - The multiplier factor, typically a percentage (e.g., 1.4 means 1.4%).
+ *                 Can be any positive decimal number, including those with many decimal places (e.g., 1.00054).
+ *
+ * @returns A new Dinero.js object representing the result of the multiplication (e.g., the fee or adjusted amount).
+ *
+ * @throws Error if the calculation results in an invalid amount (e.g., exceeding Number.MAX_SAFE_INTEGER).
  *
  * @example
- * // Calculate 1.4% fee on 7100 kobo (71.00 NGN)
+ * // Calculate a 1.4% fee on ₦71.00 (7100 kobo)
  * const amount = dinero({ amount: 7100, currency: NGN });
  * const result = multiplyMoney(amount, 1.4);
- * // Result: { amount: 994, currency: NGN, scale: 2 } (99.4 kobo)
+ * // result.amount = 994 (kobo) which is ₦9.94
  *
  * @example
- * // Calculate 0.05% fee on 10000 kobo (100.00 NGN)
+ * // Calculate a 0.05% fee on ₦100.00 (10000 kobo)
  * const amount = dinero({ amount: 10000, currency: NGN });
  * const result = multiplyMoney(amount, 0.05);
- * // Result: { amount: 50, currency: NGN, scale: 2 } (5 kobo)
+ * // result.amount = 5 (kobo) which is ₦0.05
+ *
+ * @example
+ * // Calculate a 1.00054% fee on ₦2500.00 (250000 kobo)
+ * const amount = dinero({ amount: 250000, currency: NGN });
+ * const result = multiplyMoney(amount, 1.00054);
+ * // result.amount ≈ 2501 (kobo) which is approximately ₦25.01
  */
 const multiplyMoney = (a, factor) => {
     const decimalPlaces = getDecimalPlaces(factor);
-    const scale = decimalPlaces + 2 + 2; // Decimal places + 2 (*100) + 2 (÷100)
-    const multiplierAmount = Math.round(factor * 100); // Ensure integer
-    return (0, dinero_js_1.multiply)(a, { amount: multiplierAmount, scale });
+    const scale = decimalPlaces;
+    const multiplierAmount = Math.round(factor * Math.pow(10, scale));
+    return (0, dinero_js_1.multiply)(a, { amount: multiplierAmount, scale: scale + 2 });
 };
 exports.multiplyMoney = multiplyMoney;
 function getDecimalPlaces(num) {
     const str = num.toString();
+    // Handle exponential notation (e.g., 1e-7)
+    if (str.includes("e-")) {
+        const [, exp] = str.split("e-");
+        return parseInt(exp, 10);
+    }
     const decimalIndex = str.indexOf(".");
     if (decimalIndex === -1)
         return 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konplit-services/common",
-  "version": "1.0.362",
+  "version": "1.0.364",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",