sahab-utils 1.7.4 → 1.7.6

package/dist/ts/wheel.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WHEEL_PRIZE_EXPIRY_DAYS = void 0;
+exports.wheelPrizeExpiryDate = wheelPrizeExpiryDate;
+exports.cycleKeyFor = cycleKeyFor;
+exports.isCampaignLive = isCampaignLive;
+exports.pickWeightedSegment = pickWeightedSegment;
+exports.wheelPrizeDiscount = wheelPrizeDiscount;
+/** Wheel-of-fortune — the shared rules. Pure (no Firestore/clock/ids); the cloud function owns
+ *  reading the campaign, generating the random draw, and writing the spin + prize atomically. */
+/** A prize is redeemable for this long from the moment it's won, independent of the campaign's own
+ *  window — a customer who spins on the campaign's last day still gets a fair chance to use it. */
+exports.WHEEL_PRIZE_EXPIRY_DAYS = 14;
+function wheelPrizeExpiryDate(issuedAt) {
+    const out = new Date(issuedAt.getTime());
+    out.setDate(out.getDate() + exports.WHEEL_PRIZE_EXPIRY_DAYS);
+    return out;
+}
+/** Which cycle `at` falls into for a campaign's cadence — the same key twice within one grant
+ *  period, a different key across it. `'once'` has a single, constant cycle for the campaign's
+ *  whole life; the doc-id built from this is what makes "already spun this cycle" a direct read. */
+function cycleKeyFor(campaign, at) {
+    if (campaign.cadence === 'daily') {
+        return at.toISOString().slice(0, 10);
+    }
+    if (campaign.cadence === 'weekly') {
+        return isoWeekKey(at);
+    }
+    return 'once';
+}
+/** ISO-8601 week key (`YYYY-Www`), Thursday-anchored so the week a year "belongs to" matches the
+ *  ISO standard rather than the calendar year of Jan 1st. */
+function isoWeekKey(at) {
+    const date = new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth(), at.getUTCDate()));
+    const dayNum = date.getUTCDay() || 7;
+    date.setUTCDate(date.getUTCDate() + 4 - dayNum);
+    const yearStart = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
+    const week = Math.ceil(((date.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+    return `${date.getUTCFullYear()}-W${String(week).padStart(2, '0')}`;
+}
+/** Whether a campaign is currently offering spins. `validFrom`/`validTo` are passed pre-converted
+ *  (see this package's `TimestampType` gotcha — converting Firestore timestamps is the caller's job). */
+function isCampaignLive(campaign, at, window) {
+    if (campaign.active === false)
+        return false;
+    if (window.validFrom && at < window.validFrom)
+        return false;
+    if (window.validTo && at > window.validTo)
+        return false;
+    return true;
+}
+/** Weighted random pick, given the caller's own `[0,1)` draw so the choice itself stays pure and
+ *  testable — `Math.random()` is the cloud function's job, never this module's. A segment with
+ *  `weight` ≤ 0 can never be picked. */
+function pickWeightedSegment(segments, randomUnit) {
+    const live = segments.filter((s) => { var _a; return ((_a = s.weight) !== null && _a !== void 0 ? _a : 0) > 0; });
+    if (!live.length)
+        throw new Error('pickWeightedSegment: no segment has a positive weight');
+    const totalWeight = live.reduce((sum, s) => sum + s.weight, 0);
+    const target = Math.max(0, Math.min(randomUnit, 0.9999999999)) * totalWeight;
+    let cumulative = 0;
+    for (const segment of live) {
+        cumulative += segment.weight;
+        if (target < cumulative)
+            return segment;
+    }
+    return live[live.length - 1];
+}
+/** The prize for a winning spin — an ordinary auto-applied `Discount`, mirroring `giftDiscount`.
+ *  Hardcoded shape (not passed in) so no call site can misfund it or leave it typeable-in. */
+function wheelPrizeDiscount(campaign, segment, winnerUid, promoCodeId, dates) {
+    var _a, _b;
+    return {
+        promoCodeId,
+        amount: segment.amount,
+        isPercentage: segment.isPercentage,
+        maxAmount: segment.maxAmount,
+        clientIds: [winnerUid],
+        providerUids: campaign.providerUids,
+        allowedOnce: true,
+        usedBy: [],
+        // Never typed in as a code — the app finds it via `wheel.campaignId`, not a promoCode string.
+        isAutoApplied: true,
+        createdByProvider: false,
+        sahabPercentage: (_a = campaign.sahabPercentage) !== null && _a !== void 0 ? _a : 100,
+        providerPercentage: (_b = campaign.providerPercentage) !== null && _b !== void 0 ? _b : 0,
+        validFrom: dates.validFrom,
+        validTo: dates.validTo,
+        wheel: { campaignId: campaign.campaignId, segmentId: segment.segmentId },
+        isTest: campaign.isTest,
+    };
+}

package/package.json

@@ -1,13 +1,13 @@
 {
 	"name": "sahab-utils",
-	"version": "1.7.4",
+	"version": "1.7.6",
 	"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 && node tests/cashback.test.js && node tests/utils.test.js"
+		"test": "npm run build && node tests/loyalty.test.js && node tests/gifts.test.js && node tests/cashback.test.js && node tests/utils.test.js && node tests/wheel.test.js && node tests/calcs.test.js"
 	},
 	"repository": {
 		"type": "git",