sahab-utils 1.7.0 → 1.7.1

package/dist/constants/types.d.ts

@@ -655,6 +655,17 @@ export type Discount = {
     gift?: {
         giftId: string;
     };
+    /**
+     * Which environment this offer belongs to. Absent means prod, matching every offer created
+     * before this field existed — mirrors `Client.isTest`/`Order.isTest`/`Provider.isTest`.
+     *
+     * Only meaningful for an offer that doesn't otherwise resolve to one environment (see
+     * `loyaltyOfferMatchesTestMode` in `ts/loyalty.ts`): a provider-scoped offer's environment is
+     * really the provider's own `isTest`, and a gift voucher's is really the gift's — this field
+     * is what lets a genuinely Sahab-wide, no-single-provider offer (or a promo code with no
+     * gift/provider scope at all) still declare one explicitly.
+     */
+    isTest?: boolean;
 };
 /**
  * "Buy N washes, get one free" configuration, carried on the `Discount` that represents the
@@ -762,6 +773,12 @@ export type Gift = {
     expiresAt?: TimestampType;
     notifiedAt?: TimestampType;
     notifyChannel?: GiftNotifyChannel;
+    /**
+     * Whether the giver was a test client at purchase — mirrors `Client.isTest`. Stamped once at
+     * creation and never recomputed, same reasoning as `expiresAt`: a client's test/prod status
+     * changing later must not retroactively move a gift someone already paid for.
+     */
+    isTest?: boolean;
 };
 /** One line of a gifted basket, priced when the gift was bought. */
 export type GiftItem = {

package/dist/ts/gifts.js

@@ -121,6 +121,7 @@ function giftDiscount(gift, dates) {
         validFrom: dates.validFrom,
         validTo: dates.validTo,
         gift: { giftId: gift.giftId },
+        isTest: gift.isTest,
     };
 }
 /** Every service and addon line on an order, flattened. */

package/dist/ts/loyalty.d.ts

@@ -20,6 +20,19 @@ export declare function isProviderLoyaltyOffer(offer?: Discount): boolean;
 export declare function isSahabLoyaltyOffer(offer?: Discount): boolean;
 /** Whether an offer's provider scope admits a given provider. */
 export declare function loyaltyCoversProvider(offer: Discount | undefined, providerUid?: string): boolean;
+/**
+ * Whether a loyalty offer belongs to the given test/prod environment.
+ *
+ * An offer's environment is decided in priority order:
+ *   1. `offer.isTest`, when the offer declares one explicitly.
+ *   2. `providerIsTest`, for an offer scoped to exactly one provider — resolving that (a
+ *      Firestore read on the provider) is the caller's job, since this stays framework-agnostic.
+ *      Pass it only when `loyaltyProviderScope(offer)` resolves to a single provider.
+ *   3. Prod, otherwise — a genuinely network-wide offer with no explicit flag is exactly the
+ *      shape every offer had before this field existed, so it stays visible to prod and hidden
+ *      from test rather than leaking into both.
+ */
+export declare function loyaltyOfferMatchesTestMode(offer: Discount | undefined, isTest: boolean, providerIsTest?: boolean): boolean;
 /**
  * Whether a finished order earns a stamp.
  *

package/dist/ts/loyalty.js

@@ -4,6 +4,7 @@ exports.loyaltyProviderScope = loyaltyProviderScope;
 exports.isProviderLoyaltyOffer = isProviderLoyaltyOffer;
 exports.isSahabLoyaltyOffer = isSahabLoyaltyOffer;
 exports.loyaltyCoversProvider = loyaltyCoversProvider;
+exports.loyaltyOfferMatchesTestMode = loyaltyOfferMatchesTestMode;
 exports.orderEarnsLoyaltyStamp = orderEarnsLoyaltyStamp;
 exports.giftEarnsLoyaltyStamp = giftEarnsLoyaltyStamp;
 exports.emptyLoyaltyProgress = emptyLoyaltyProgress;
@@ -67,6 +68,25 @@ function loyaltyCoversProvider(offer, providerUid) {
         return true;
     return !!providerUid && scope.includes(providerUid);
 }
+/**
+ * Whether a loyalty offer belongs to the given test/prod environment.
+ *
+ * An offer's environment is decided in priority order:
+ *   1. `offer.isTest`, when the offer declares one explicitly.
+ *   2. `providerIsTest`, for an offer scoped to exactly one provider — resolving that (a
+ *      Firestore read on the provider) is the caller's job, since this stays framework-agnostic.
+ *      Pass it only when `loyaltyProviderScope(offer)` resolves to a single provider.
+ *   3. Prod, otherwise — a genuinely network-wide offer with no explicit flag is exactly the
+ *      shape every offer had before this field existed, so it stays visible to prod and hidden
+ *      from test rather than leaking into both.
+ */
+function loyaltyOfferMatchesTestMode(offer, isTest, providerIsTest) {
+    if (typeof (offer === null || offer === void 0 ? void 0 : offer.isTest) === 'boolean')
+        return offer.isTest === isTest;
+    if (typeof providerIsTest === 'boolean')
+        return providerIsTest === isTest;
+    return !isTest;
+}
 /**
  * Whether a finished order earns a stamp.
  *

package/package.json

@@ -1,37 +1,37 @@
 {
-  "name": "sahab-utils",
-  "version": "1.7.0",
-  "description": "This package contains types and utils functions",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "deploy": "npm run build && npm publish",
-    "test": "npm run build && node tests/loyalty.test.js && node tests/gifts.test.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/SahabApp/sahab-utils.git"
-  },
-  "keywords": [
-    "sahab"
-  ],
-  "author": "Sahab",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/SahabApp/sahab-utils/issues"
-  },
-  "homepage": "https://github.com/SahabApp/sahab-utils#readme",
-  "files": [
-    "dist"
-  ],
-  "devDependencies": {
-    "@types/lodash": "^4.17.24",
-    "typescript": "^6.0.2"
-  },
-  "dependencies": {
-    "firebase": "^10.7.1",
-    "lodash": "^4.17.21"
-  },
-  "packageManager": "yarn@4.9.1+sha512.f95ce356460e05be48d66401c1ae64ef84d163dd689964962c6888a9810865e39097a5e9de748876c2e0bf89b232d583c33982773e9903ae7a76257270986538"
+	"name": "sahab-utils",
+	"version": "1.7.1",
+	"description": "This package contains types and utils functions",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"scripts": {
+		"build": "tsc",
+		"deploy": "npm run build && npm publish",
+		"test": "npm run build && node tests/loyalty.test.js && node tests/gifts.test.js"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/SahabApp/sahab-utils.git"
+	},
+	"keywords": [
+		"sahab"
+	],
+	"author": "Sahab",
+	"license": "ISC",
+	"bugs": {
+		"url": "https://github.com/SahabApp/sahab-utils/issues"
+	},
+	"homepage": "https://github.com/SahabApp/sahab-utils#readme",
+	"files": [
+		"dist"
+	],
+	"devDependencies": {
+		"@types/lodash": "^4.17.24",
+		"typescript": "^6.0.2"
+	},
+	"dependencies": {
+		"firebase": "^10.7.1",
+		"lodash": "^4.17.21"
+	},
+	"packageManager": "yarn@4.9.1+sha512.f95ce356460e05be48d66401c1ae64ef84d163dd689964962c6888a9810865e39097a5e9de748876c2e0bf89b232d583c33982773e9903ae7a76257270986538"
 }