@bash-app/bash-common 30.225.0 → 30.227.0

package/dist/utils/__tests__/promoCodesUtils.test.js

@@ -0,0 +1,183 @@
+/**
+ * promoCodesUtils — locate / aggregate / re-distribute promo codes across a
+ * BashEvent's ticket tiers.
+ *
+ * These three helpers are tiny but they sit on the path between checkout
+ * UI ↔ pricing engine. A bug in `findPromoCodeFromBashEvent` would cause a
+ * promo to silently fail to apply at checkout (lost revenue / angry user).
+ * A bug in `updatePromoCodesOnBashEventTicketTiers` would scramble which
+ * tier a promo code belongs to after edits in the host wizard.
+ */
+import { findPromoCodeFromBashEvent, getPromoCodesFromBashEvent, updatePromoCodesOnBashEventTicketTiers, } from "../promoCodesUtils.js";
+function makePromo(id, ticketTierId, overrides = {}) {
+    return {
+        id,
+        ticketTierId,
+        code: `CODE-${id}`,
+        discountPercent: 10,
+        discountAmount: null,
+        maxRedemptions: null,
+        redemptionCount: 0,
+        expiresAt: null,
+        createdAt: new Date(0),
+        updatedAt: new Date(0),
+        ...overrides,
+    };
+}
+function makeTier(id, promoCodes) {
+    return {
+        id,
+        title: `Tier ${id}`,
+        promoCodes,
+    };
+}
+function makeBashEvent(tiers) {
+    return { ticketTiers: tiers };
+}
+// ============================================================================
+// findPromoCodeFromBashEvent
+// ============================================================================
+describe("findPromoCodeFromBashEvent", () => {
+    it("returns undefined when promoCodeId is undefined (no lookup attempted)", () => {
+        const bash = makeBashEvent([makeTier("t1", [makePromo("p1", "t1")])]);
+        expect(findPromoCodeFromBashEvent(bash, undefined)).toBeUndefined();
+    });
+    it("returns undefined when promoCodeId is the empty string (falsy guard)", () => {
+        const bash = makeBashEvent([makeTier("t1", [makePromo("p1", "t1")])]);
+        expect(findPromoCodeFromBashEvent(bash, "")).toBeUndefined();
+    });
+    it("returns undefined when bashEvent is null", () => {
+        expect(findPromoCodeFromBashEvent(null, "p1")).toBeUndefined();
+    });
+    it("returns undefined when bashEvent is undefined", () => {
+        expect(findPromoCodeFromBashEvent(undefined, "p1")).toBeUndefined();
+    });
+    it("returns undefined when ticketTiers is empty", () => {
+        expect(findPromoCodeFromBashEvent(makeBashEvent([]), "p1")).toBeUndefined();
+    });
+    it("finds a promo on the FIRST tier", () => {
+        const promo = makePromo("p1", "t1");
+        const bash = makeBashEvent([
+            makeTier("t1", [promo]),
+            makeTier("t2", [makePromo("p2", "t2")]),
+        ]);
+        expect(findPromoCodeFromBashEvent(bash, "p1")).toBe(promo);
+    });
+    it("finds a promo on a NON-FIRST tier (iterates across tiers)", () => {
+        const promo = makePromo("p2", "t2");
+        const bash = makeBashEvent([
+            makeTier("t1", [makePromo("p1", "t1")]),
+            makeTier("t2", [promo]),
+        ]);
+        expect(findPromoCodeFromBashEvent(bash, "p2")).toBe(promo);
+    });
+    it("returns the FIRST match if the same id appears on multiple tiers (defensive — shouldn't happen but guard the order)", () => {
+        const dupOnT1 = makePromo("dup", "t1");
+        const dupOnT2 = makePromo("dup", "t2");
+        const bash = makeBashEvent([
+            makeTier("t1", [dupOnT1]),
+            makeTier("t2", [dupOnT2]),
+        ]);
+        expect(findPromoCodeFromBashEvent(bash, "dup")).toBe(dupOnT1);
+    });
+    it("returns undefined when promoCodeId doesn't match any tier's promo", () => {
+        const bash = makeBashEvent([makeTier("t1", [makePromo("p1", "t1")])]);
+        expect(findPromoCodeFromBashEvent(bash, "missing")).toBeUndefined();
+    });
+    it("does not throw when a tier has no promoCodes array (defensive)", () => {
+        const tier = { id: "t1", promoCodes: [] };
+        expect(() => findPromoCodeFromBashEvent(makeBashEvent([tier]), "p1")).not.toThrow();
+    });
+});
+// ============================================================================
+// getPromoCodesFromBashEvent
+// ============================================================================
+describe("getPromoCodesFromBashEvent", () => {
+    it("returns [] when bashEvent is null", () => {
+        expect(getPromoCodesFromBashEvent(null)).toEqual([]);
+    });
+    it("returns [] when bashEvent is undefined", () => {
+        expect(getPromoCodesFromBashEvent(undefined)).toEqual([]);
+    });
+    it("returns [] when there are no ticket tiers", () => {
+        expect(getPromoCodesFromBashEvent(makeBashEvent([]))).toEqual([]);
+    });
+    it("returns [] when no tier has any promo codes", () => {
+        const bash = makeBashEvent([makeTier("t1", []), makeTier("t2", [])]);
+        expect(getPromoCodesFromBashEvent(bash)).toEqual([]);
+    });
+    it("flattens promo codes across multiple tiers in tier order", () => {
+        const p1 = makePromo("p1", "t1");
+        const p2 = makePromo("p2", "t2");
+        const p3 = makePromo("p3", "t2");
+        const bash = makeBashEvent([
+            makeTier("t1", [p1]),
+            makeTier("t2", [p2, p3]),
+        ]);
+        expect(getPromoCodesFromBashEvent(bash)).toEqual([p1, p2, p3]);
+    });
+    it("skips tiers with empty promoCodes (filter step)", () => {
+        const p1 = makePromo("p1", "t1");
+        const bash = makeBashEvent([
+            makeTier("t1", [p1]),
+            makeTier("t2", []),
+            makeTier("t3", [makePromo("p3", "t3")]),
+        ]);
+        const all = getPromoCodesFromBashEvent(bash);
+        expect(all.map((p) => p.id)).toEqual(["p1", "p3"]);
+    });
+});
+// ============================================================================
+// updatePromoCodesOnBashEventTicketTiers
+// ============================================================================
+describe("updatePromoCodesOnBashEventTicketTiers", () => {
+    it("re-buckets promos onto tiers by ticketTierId (mutates in place)", () => {
+        const bash = makeBashEvent([
+            makeTier("t1", []),
+            makeTier("t2", []),
+        ]);
+        const promos = [
+            makePromo("p1", "t1"),
+            makePromo("p2", "t2"),
+            makePromo("p3", "t1"),
+        ];
+        updatePromoCodesOnBashEventTicketTiers(bash, promos);
+        expect(bash.ticketTiers?.[0].promoCodes.map((p) => p.id)).toEqual([
+            "p1",
+            "p3",
+        ]);
+        expect(bash.ticketTiers?.[1].promoCodes.map((p) => p.id)).toEqual(["p2"]);
+    });
+    it("REPLACES existing promo codes on each tier (not appended)", () => {
+        const oldPromo = makePromo("old", "t1");
+        const bash = makeBashEvent([makeTier("t1", [oldPromo])]);
+        updatePromoCodesOnBashEventTicketTiers(bash, [makePromo("new", "t1")]);
+        expect(bash.ticketTiers?.[0].promoCodes.map((p) => p.id)).toEqual([
+            "new",
+        ]);
+    });
+    it("clears tiers that have no matching promos in the new list", () => {
+        const bash = makeBashEvent([
+            makeTier("t1", [makePromo("oldA", "t1")]),
+            makeTier("t2", [makePromo("oldB", "t2")]),
+        ]);
+        updatePromoCodesOnBashEventTicketTiers(bash, [makePromo("newA", "t1")]);
+        expect(bash.ticketTiers?.[0].promoCodes.map((p) => p.id)).toEqual([
+            "newA",
+        ]);
+        expect(bash.ticketTiers?.[1].promoCodes).toEqual([]);
+    });
+    it("ignores promos whose ticketTierId doesn't match any tier on the event (orphans dropped)", () => {
+        const bash = makeBashEvent([makeTier("t1", [])]);
+        updatePromoCodesOnBashEventTicketTiers(bash, [
+            makePromo("p1", "t1"),
+            makePromo("orphan", "tDoesNotExist"),
+        ]);
+        expect(bash.ticketTiers?.[0].promoCodes.map((p) => p.id)).toEqual(["p1"]);
+    });
+    it("is a no-op when ticketTiers is undefined", () => {
+        const bash = { ticketTiers: undefined };
+        expect(() => updatePromoCodesOnBashEventTicketTiers(bash, [makePromo("p1", "t1")])).not.toThrow();
+    });
+});
+//# sourceMappingURL=promoCodesUtils.test.js.map

package/dist/utils/__tests__/promoCodesUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promoCodesUtils.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/promoCodesUtils.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/__tests__/qrCodeUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=qrCodeUtils.test.d.ts.map

package/dist/utils/__tests__/qrCodeUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrCodeUtils.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/qrCodeUtils.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/qrCodeUtils.test.js

@@ -0,0 +1,99 @@
+/**
+ * qrCodeUtils — URL builders for the *navigable* `/ticket-details` deep
+ * links that get encoded into ticket QR codes (and createQrCodeImage that
+ * renders them as PNG data URLs).
+ *
+ * The contract these tests pin (consumed by the door-scan flow, ticket
+ * emails, and tier-share QR codes):
+ *
+ *   bashEventPrismaCheckoutQrCodeUrl(eventId, checkoutId)
+ *     → "/ticket-details/{eventId}/{checkoutId}"
+ *
+ *   bashEventQrCodeUrl(eventId)                                     → "/ticket-details/{eventId}"
+ *   bashEventQrCodeUrl(eventId, tierId)                             → "/ticket-details/{eventId}/ticket-tier/{tierId}"
+ *   bashEventQrCodeUrl(eventId, tierId, ticketId)                   → "/ticket-details/{eventId}/ticket/{ticketId}"   (ticketId WINS over tierId)
+ *   bashEventQrCodeUrl(eventId, _, _, slug)                         → "/ticket-details/{eventId}-{slug}"               (slug version of the deep link)
+ *
+ *   createQrCodeImage(data) → Promise<"data:image/png;base64,...">
+ *
+ * Bugs in any of these route door-scanners to the wrong page (= entry chaos).
+ */
+import { bashEventPrismaCheckoutQrCodeUrl, bashEventQrCodeUrl, createQrCodeImage, } from "../qrCodeUtils.js";
+// ============================================================================
+// bashEventPrismaCheckoutQrCodeUrl — checkout-id deep link
+// ============================================================================
+describe("bashEventPrismaCheckoutQrCodeUrl", () => {
+    it("composes /ticket-details/{eventId}/{checkoutId}", () => {
+        expect(bashEventPrismaCheckoutQrCodeUrl("evt_123", "co_456")).toBe("/ticket-details/evt_123/co_456");
+    });
+    it("does NOT throw on null/undefined inputs (downstream link is broken-but-safe)", () => {
+        // The current contract just stringifies via template literal, so we pin
+        // the literal output rather than asserting an exception.
+        expect(bashEventPrismaCheckoutQrCodeUrl(null, null)).toBe("/ticket-details/null/null");
+        expect(bashEventPrismaCheckoutQrCodeUrl(undefined, undefined)).toBe("/ticket-details/undefined/undefined");
+    });
+});
+// ============================================================================
+// bashEventQrCodeUrl — base / tier / ticket / slug variants
+// ============================================================================
+describe("bashEventQrCodeUrl", () => {
+    describe("base url (no tier, no ticket, no slug)", () => {
+        it("returns /ticket-details/{eventId}", () => {
+            expect(bashEventQrCodeUrl("evt_1")).toBe("/ticket-details/evt_1");
+        });
+    });
+    describe("with ticketTierId", () => {
+        it("appends /ticket-tier/{tierId}", () => {
+            expect(bashEventQrCodeUrl("evt_1", "tier_a")).toBe("/ticket-details/evt_1/ticket-tier/tier_a");
+        });
+        it("ignores null ticketId in favor of tier", () => {
+            expect(bashEventQrCodeUrl("evt_1", "tier_a", null)).toBe("/ticket-details/evt_1/ticket-tier/tier_a");
+        });
+    });
+    describe("with ticketId (the door-scan link)", () => {
+        it("appends /ticket/{ticketId}", () => {
+            expect(bashEventQrCodeUrl("evt_1", undefined, "ticket_xyz")).toBe("/ticket-details/evt_1/ticket/ticket_xyz");
+        });
+        it("PREFERS ticketId over ticketTierId when both are provided", () => {
+            // Tickets are more specific than tiers; the deep link must resolve to the
+            // individual ticket (otherwise the door scanner can't validate redemption).
+            expect(bashEventQrCodeUrl("evt_1", "tier_a", "ticket_xyz")).toBe("/ticket-details/evt_1/ticket/ticket_xyz");
+        });
+    });
+    describe("with slug", () => {
+        it("uses the slugged base (`/ticket-details/{eventId}-{slug}`)", () => {
+            expect(bashEventQrCodeUrl("evt_1", undefined, undefined, "summer-rave")).toBe("/ticket-details/evt_1-summer-rave");
+        });
+        it("appends ticketId on the slugged base", () => {
+            expect(bashEventQrCodeUrl("evt_1", undefined, "ticket_xyz", "summer-rave")).toBe("/ticket-details/evt_1-summer-rave/ticket/ticket_xyz");
+        });
+        it("appends ticket-tier on the slugged base when no ticketId", () => {
+            expect(bashEventQrCodeUrl("evt_1", "tier_a", undefined, "summer-rave")).toBe("/ticket-details/evt_1-summer-rave/ticket-tier/tier_a");
+        });
+        it("falls back to non-slug base when slug is null", () => {
+            expect(bashEventQrCodeUrl("evt_1", null, null, null)).toBe("/ticket-details/evt_1");
+        });
+    });
+});
+// ============================================================================
+// createQrCodeImage — PNG data URL
+// ============================================================================
+describe("createQrCodeImage", () => {
+    it("returns a base64-encoded PNG data URL", async () => {
+        const dataUrl = await createQrCodeImage("https://bash.app/ticket-details/evt_1/ticket/abc");
+        expect(dataUrl).toMatch(/^data:image\/png;base64,/);
+        // Sanity: a real QR image will have *meaningful* base64 length, not a few bytes.
+        expect(dataUrl.length).toBeGreaterThan(200);
+    });
+    it("produces a deterministic PNG for the same input (no nonce / timestamp leakage)", async () => {
+        const a = await createQrCodeImage("ticket://abc");
+        const b = await createQrCodeImage("ticket://abc");
+        expect(a).toBe(b);
+    });
+    it("produces DIFFERENT output for different payloads", async () => {
+        const a = await createQrCodeImage("ticket://abc");
+        const b = await createQrCodeImage("ticket://xyz");
+        expect(a).not.toBe(b);
+    });
+});
+//# sourceMappingURL=qrCodeUtils.test.js.map

package/dist/utils/__tests__/qrCodeUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrCodeUtils.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/qrCodeUtils.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/__tests__/stripeAccountUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stripeAccountUtils.test.d.ts.map

package/dist/utils/__tests__/stripeAccountUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripeAccountUtils.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/stripeAccountUtils.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/stripeAccountUtils.test.js

@@ -0,0 +1,75 @@
+/**
+ * stripeAccountUtils — the gate that decides whether a host can accept money.
+ *
+ * `stripeAccountFullyLinked` returns `true` ONLY when ALL FOUR of these are true:
+ *   - linkingStatus is non-null
+ *   - hasOutstandingRequirements === false
+ *   - isOnboarded === true
+ *   - paymentsEnabled === true
+ *   - taxMonitoringEnabled === true
+ *
+ * This is the single check used everywhere we decide "can this host get paid?"
+ * Returning `true` when any one is false leads to checkouts that can't actually
+ * disburse money. We pin all 5 axes individually so a future refactor that
+ * accidentally drops one will fail loudly.
+ */
+import { stripeAccountFullyLinked } from "../stripeAccountUtils.js";
+const fullyLinked = {
+    isOnboarded: true,
+    hasOutstandingRequirements: false,
+    paymentsEnabled: true,
+    taxMonitoringEnabled: true,
+};
+describe("stripeAccountFullyLinked", () => {
+    describe("nullish guard", () => {
+        it("returns false for null", () => {
+            expect(stripeAccountFullyLinked(null)).toBe(false);
+        });
+        it("returns false for undefined", () => {
+            expect(stripeAccountFullyLinked(undefined)).toBe(false);
+        });
+    });
+    describe("happy path", () => {
+        it("returns true when ALL four flags are correct", () => {
+            expect(stripeAccountFullyLinked(fullyLinked)).toBe(true);
+        });
+    });
+    describe("each individual gate must be satisfied", () => {
+        it("returns false when isOnboarded is false", () => {
+            expect(stripeAccountFullyLinked({ ...fullyLinked, isOnboarded: false })).toBe(false);
+        });
+        it("returns false when hasOutstandingRequirements is true", () => {
+            expect(stripeAccountFullyLinked({
+                ...fullyLinked,
+                hasOutstandingRequirements: true,
+            })).toBe(false);
+        });
+        it("returns false when paymentsEnabled is false", () => {
+            expect(stripeAccountFullyLinked({ ...fullyLinked, paymentsEnabled: false })).toBe(false);
+        });
+        it("returns false when taxMonitoringEnabled is false", () => {
+            expect(stripeAccountFullyLinked({
+                ...fullyLinked,
+                taxMonitoringEnabled: false,
+            })).toBe(false);
+        });
+    });
+    describe("multi-flag failures (any combination = false)", () => {
+        it("returns false when payments AND tax monitoring are both disabled", () => {
+            expect(stripeAccountFullyLinked({
+                ...fullyLinked,
+                paymentsEnabled: false,
+                taxMonitoringEnabled: false,
+            })).toBe(false);
+        });
+        it("returns false when EVERY flag is in the wrong state", () => {
+            expect(stripeAccountFullyLinked({
+                isOnboarded: false,
+                hasOutstandingRequirements: true,
+                paymentsEnabled: false,
+                taxMonitoringEnabled: false,
+            })).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=stripeAccountUtils.test.js.map

package/dist/utils/__tests__/stripeAccountUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripeAccountUtils.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/stripeAccountUtils.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,MAAM,WAAW,GAAwB;IACvC,WAAW,EAAE,IAAI;IACjB,0BAA0B,EAAE,KAAK;IACjC,eAAe,EAAE,IAAI;IACrB,oBAAoB,EAAE,IAAI;CAC3B,CAAC;AAEF,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;QACtD,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,CACJ,wBAAwB,CAAC,EAAE,GAAG,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CACjE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,CACJ,wBAAwB,CAAC;gBACvB,GAAG,WAAW;gBACd,0BAA0B,EAAE,IAAI;aACjC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CACJ,wBAAwB,CAAC,EAAE,GAAG,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CACrE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CACJ,wBAAwB,CAAC;gBACvB,GAAG,WAAW;gBACd,oBAAoB,EAAE,KAAK;aAC5B,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;QAC7D,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YAC1E,MAAM,CACJ,wBAAwB,CAAC;gBACvB,GAAG,WAAW;gBACd,eAAe,EAAE,KAAK;gBACtB,oBAAoB,EAAE,KAAK;aAC5B,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,CACJ,wBAAwB,CAAC;gBACvB,WAAW,EAAE,KAAK;gBAClB,0BAA0B,EAAE,IAAI;gBAChC,eAAe,EAAE,KAAK;gBACtB,oBAAoB,EAAE,KAAK;aAC5B,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/blog/__tests__/getRelatedBlogPosts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getRelatedBlogPosts.test.d.ts.map

package/dist/utils/blog/__tests__/getRelatedBlogPosts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRelatedBlogPosts.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/blog/__tests__/getRelatedBlogPosts.test.ts"],"names":[],"mappings":""}

package/dist/utils/blog/__tests__/getRelatedBlogPosts.test.js

@@ -0,0 +1,233 @@
+// Tests for getRelatedBlogPosts -- the tag-overlap-first scoring algorithm
+// that powers the "Related reading" rail under every blog detail page. The
+// scoring function is the SEO-critical surface (controls the internal-link
+// graph) so we exercise every branch of the priority sort:
+//   1. tag overlap count (descending)
+//   2. shared category (1/0)
+//   3. recency (most recent first)
+//
+// Plus the edge cases:
+//   - source post does not exist -> []
+//   - source has no tags + no category -> still returns recent published posts
+//   - limit cap
+//   - publishedAt null on a candidate is treated as oldest
+import { BlogStatus } from "@prisma/client";
+import { getRelatedBlogPosts } from "../blogDbUtils.js";
+function makePrismaMock(opts) {
+    const findUnique = jest.fn().mockResolvedValue(opts.source);
+    const findMany = jest.fn().mockResolvedValue(opts.candidates);
+    return {
+        blogPost: { findUnique, findMany },
+        __findUnique: findUnique,
+        __findMany: findMany,
+    };
+}
+function candidate(overrides = {}) {
+    return {
+        id: "c-default",
+        slug: "c-default",
+        title: "Default Candidate",
+        excerpt: "default",
+        coverImage: null,
+        readTime: 5,
+        publishedAt: new Date("2026-01-01T00:00:00Z"),
+        categoryId: null,
+        tags: [],
+        ...overrides,
+    };
+}
+describe("getRelatedBlogPosts", () => {
+    it("returns [] when the source post does not exist", async () => {
+        const prisma = makePrismaMock({ source: null, candidates: [] });
+        const out = await getRelatedBlogPosts(prisma, "missing-id");
+        expect(out).toEqual([]);
+        expect(prisma.__findMany).not.toHaveBeenCalled();
+    });
+    it("ranks candidates by shared tag count (descending)", async () => {
+        const source = {
+            id: "src",
+            categoryId: null,
+            tags: [{ id: "t1" }, { id: "t2" }, { id: "t3" }],
+        };
+        const candidates = [
+            candidate({
+                id: "low",
+                title: "One tag in common",
+                tags: [{ id: "t1" }],
+                publishedAt: new Date("2026-03-01"),
+            }),
+            candidate({
+                id: "high",
+                title: "Three tags in common",
+                tags: [{ id: "t1" }, { id: "t2" }, { id: "t3" }],
+                publishedAt: new Date("2026-01-01"),
+            }),
+            candidate({
+                id: "mid",
+                title: "Two tags in common",
+                tags: [{ id: "t1" }, { id: "t2" }],
+                publishedAt: new Date("2026-02-01"),
+            }),
+        ];
+        const prisma = makePrismaMock({ source, candidates });
+        const out = await getRelatedBlogPosts(prisma, "src", 4);
+        expect(out.map((p) => p.id)).toEqual(["high", "mid", "low"]);
+    });
+    it("uses shared category as the tiebreaker when tag counts tie", async () => {
+        const source = {
+            id: "src",
+            categoryId: "cat-1",
+            tags: [{ id: "t1" }],
+        };
+        const candidates = [
+            candidate({
+                id: "without-category",
+                tags: [{ id: "t1" }],
+                categoryId: "cat-other",
+                publishedAt: new Date("2026-03-01"),
+            }),
+            candidate({
+                id: "with-category",
+                tags: [{ id: "t1" }],
+                categoryId: "cat-1",
+                publishedAt: new Date("2026-01-01"),
+            }),
+        ];
+        const prisma = makePrismaMock({ source, candidates });
+        const out = await getRelatedBlogPosts(prisma, "src", 4);
+        expect(out.map((p) => p.id)).toEqual(["with-category", "without-category"]);
+    });
+    it("falls back to recency when both tag count and category tie", async () => {
+        const source = {
+            id: "src",
+            categoryId: "cat-1",
+            tags: [{ id: "t1" }],
+        };
+        const candidates = [
+            candidate({
+                id: "older",
+                tags: [{ id: "t1" }],
+                categoryId: "cat-1",
+                publishedAt: new Date("2026-01-01"),
+            }),
+            candidate({
+                id: "newer",
+                tags: [{ id: "t1" }],
+                categoryId: "cat-1",
+                publishedAt: new Date("2026-04-01"),
+            }),
+        ];
+        const prisma = makePrismaMock({ source, candidates });
+        const out = await getRelatedBlogPosts(prisma, "src", 4);
+        expect(out.map((p) => p.id)).toEqual(["newer", "older"]);
+    });
+    it("treats null publishedAt as the oldest possible candidate", async () => {
+        const source = {
+            id: "src",
+            categoryId: null,
+            tags: [{ id: "t1" }],
+        };
+        const candidates = [
+            candidate({
+                id: "no-date",
+                tags: [{ id: "t1" }],
+                publishedAt: null,
+            }),
+            candidate({
+                id: "dated",
+                tags: [{ id: "t1" }],
+                publishedAt: new Date("2026-01-01"),
+            }),
+        ];
+        const prisma = makePrismaMock({ source, candidates });
+        const out = await getRelatedBlogPosts(prisma, "src", 4);
+        expect(out.map((p) => p.id)).toEqual(["dated", "no-date"]);
+    });
+    it("respects the limit parameter", async () => {
+        const source = {
+            id: "src",
+            categoryId: null,
+            tags: [{ id: "t1" }],
+        };
+        const candidates = Array.from({ length: 8 }, (_, i) => candidate({
+            id: `c${i}`,
+            title: `Candidate ${i}`,
+            tags: [{ id: "t1" }],
+            publishedAt: new Date(2026, 0, i + 1),
+        }));
+        const prisma = makePrismaMock({ source, candidates });
+        const out = await getRelatedBlogPosts(prisma, "src", 3);
+        expect(out).toHaveLength(3);
+    });
+    it("defaults the limit to 4 when not provided", async () => {
+        const source = {
+            id: "src",
+            categoryId: null,
+            tags: [{ id: "t1" }],
+        };
+        const candidates = Array.from({ length: 10 }, (_, i) => candidate({ id: `c${i}`, tags: [{ id: "t1" }] }));
+        const prisma = makePrismaMock({ source, candidates });
+        const out = await getRelatedBlogPosts(prisma, "src");
+        expect(out).toHaveLength(4);
+    });
+    it("queries by tag-overlap OR shared category, excluding the source", async () => {
+        const source = {
+            id: "src",
+            categoryId: "cat-1",
+            tags: [{ id: "t1" }, { id: "t2" }],
+        };
+        const prisma = makePrismaMock({ source, candidates: [] });
+        await getRelatedBlogPosts(prisma, "src", 5);
+        const where = prisma.__findMany.mock.calls[0][0].where;
+        expect(where.id).toEqual({ not: "src" });
+        expect(where.status).toBe(BlogStatus.Published);
+        expect(where.publishedAt).toEqual({ not: null });
+        expect(where.OR).toEqual([
+            { tags: { some: { id: { in: ["t1", "t2"] } } } },
+            { categoryId: "cat-1" },
+        ]);
+        // candidate pool size is limit * 4 to give the scorer headroom
+        expect(prisma.__findMany.mock.calls[0][0].take).toBe(20);
+    });
+    it("omits the OR clause entirely when source has no tags and no category", async () => {
+        const source = { id: "src", categoryId: null, tags: [] };
+        const prisma = makePrismaMock({ source, candidates: [] });
+        await getRelatedBlogPosts(prisma, "src");
+        const where = prisma.__findMany.mock.calls[0][0].where;
+        expect(where.OR).toBeUndefined();
+    });
+    it("returns the trimmed RelatedBlogPost shape (no internal scoring fields)", async () => {
+        const source = {
+            id: "src",
+            categoryId: null,
+            tags: [{ id: "t1" }],
+        };
+        const candidates = [
+            candidate({
+                id: "c1",
+                slug: "c1-slug",
+                title: "C1",
+                excerpt: "ex",
+                coverImage: "img.png",
+                readTime: 7,
+                publishedAt: new Date("2026-01-01"),
+                tags: [{ id: "t1" }],
+                categoryId: "cat-1",
+            }),
+        ];
+        const prisma = makePrismaMock({ source, candidates });
+        const out = await getRelatedBlogPosts(prisma, "src", 4);
+        expect(out[0]).toEqual({
+            id: "c1",
+            slug: "c1-slug",
+            title: "C1",
+            excerpt: "ex",
+            coverImage: "img.png",
+            readTime: 7,
+            publishedAt: new Date("2026-01-01"),
+        });
+        expect(Object.keys(out[0])).not.toContain("categoryId");
+        expect(Object.keys(out[0])).not.toContain("tags");
+    });
+});
+//# sourceMappingURL=getRelatedBlogPosts.test.js.map