sahab-utils 1.7.1 → 1.7.2

package/dist/constants/types.d.ts

@@ -817,6 +817,8 @@ export type GiftConfig = {
      * Bounded on read: a 0 would expire every gift the moment it was sold.
      */
     giftExpiryMonths?: number;
+    /** Charged when the giver adds a personal message to the SMS. Defaults to `GIFT_MESSAGE_SURCHARGE_DEFAULT` when unset. */
+    giftMessageSurcharge?: number;
 };
 export type OrderReview = {
     ratingId: string;

package/dist/ts/gifts.d.ts

@@ -17,6 +17,17 @@ export declare const MIN_GIFT_EXPIRY_MONTHS = 1;
 export declare const MAX_GIFT_EXPIRY_MONTHS = 36;
 /** What the giver pays: every line in the basket. */
 export declare function giftTotal(items?: GiftItem[]): number;
+/** A message longer than this spans more than one Arabic (UCS-2) SMS segment on its own. */
+export declare const GIFT_MESSAGE_MAX_CHARS = 70;
+/** Used when the back office has not set `GiftConfig.giftMessageSurcharge`. */
+export declare const GIFT_MESSAGE_SURCHARGE_DEFAULT = 3;
+/**
+ * What a personal message, if any, adds to the gift's price.
+ *
+ * Zero for a blank or whitespace-only message — writing nothing costs nothing. Otherwise the
+ * back-office amount if one is configured, else the default, same shape as `giftExpiryMonths`.
+ */
+export declare function giftMessageSurcharge(message?: string, config?: GiftConfig): number;
 /** The gifted service ids. */
 export declare function giftServiceIds(gift?: Pick<Gift, 'items'>): string[];
 /** The gifted addon ids. */

package/dist/ts/gifts.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_GIFT_EXPIRY_MONTHS = exports.MIN_GIFT_EXPIRY_MONTHS = exports.DEFAULT_GIFT_EXPIRY_MONTHS = void 0;
+exports.GIFT_MESSAGE_SURCHARGE_DEFAULT = exports.GIFT_MESSAGE_MAX_CHARS = exports.MAX_GIFT_EXPIRY_MONTHS = exports.MIN_GIFT_EXPIRY_MONTHS = exports.DEFAULT_GIFT_EXPIRY_MONTHS = void 0;
 exports.giftTotal = giftTotal;
+exports.giftMessageSurcharge = giftMessageSurcharge;
 exports.giftServiceIds = giftServiceIds;
 exports.giftAddonIds = giftAddonIds;
 exports.giftExpiryMonths = giftExpiryMonths;
@@ -36,6 +37,22 @@ exports.MAX_GIFT_EXPIRY_MONTHS = 36;
 function giftTotal(items) {
     return (items !== null && items !== void 0 ? items : []).reduce((sum, item) => sum + (0, utils_1.preventNaN)(item === null || item === void 0 ? void 0 : item.price), 0);
 }
+/** A message longer than this spans more than one Arabic (UCS-2) SMS segment on its own. */
+exports.GIFT_MESSAGE_MAX_CHARS = 70;
+/** Used when the back office has not set `GiftConfig.giftMessageSurcharge`. */
+exports.GIFT_MESSAGE_SURCHARGE_DEFAULT = 3;
+/**
+ * What a personal message, if any, adds to the gift's price.
+ *
+ * Zero for a blank or whitespace-only message — writing nothing costs nothing. Otherwise the
+ * back-office amount if one is configured, else the default, same shape as `giftExpiryMonths`.
+ */
+function giftMessageSurcharge(message, config) {
+    if (!(message !== null && message !== void 0 ? message : '').trim().length)
+        return 0;
+    const raw = config === null || config === void 0 ? void 0 : config.giftMessageSurcharge;
+    return raw === undefined || raw === null || !isFinite(raw) || raw < 0 ? exports.GIFT_MESSAGE_SURCHARGE_DEFAULT : raw;
+}
 /** The gifted service ids. */
 function giftServiceIds(gift) {
     var _a;
@@ -105,8 +122,10 @@ function giftDiscount(gift, dates) {
     return {
         isPercentage: true,
         amount: 100,
-        // Bounds the discount to the money actually collected, whatever the recipient orders.
-        maxAmount: (0, utils_1.preventNaN)(gift.amount) || giftTotal(gift.items),
+        // Bounds the discount to what the basket is actually worth, whatever the recipient
+        // orders — never to `gift.amount`, which can include a message surcharge that bought
+        // no redeemable service and must not inflate how much the voucher can discount.
+        maxAmount: giftTotal(gift.items),
         clientIds: gift.recipientUid ? [gift.recipientUid] : [],
         providerUids: gift.providerUid ? [gift.providerUid] : [],
         servicesIds: giftServiceIds(gift),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sahab-utils",
-	"version": "1.7.1",
+	"version": "1.7.2",
 	"description": "This package contains types and utils functions",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",