@bash-app/bash-common 30.176.0 → 30.178.0

package/dist/index.d.ts

@@ -34,6 +34,7 @@ export * from "./utils/entityUtils.js";
 export * from "./utils/generalDateTimeUtils.js";
 export * from "./utils/luxonUtils.js";
 export * from "./utils/mathUtils.js";
+export * from "./utils/birthdayExperienceQuality.js";
 export * from "./utils/service/apiServiceBookingApiUtils.js";
 export * from "./utils/service/frontendServiceBookingUtils.js";
 export * from "./utils/service/serviceBookingStatusUtils.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAG3C,YAAY,EACV,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAEhD,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACR,WAAW,EAAE,YAAY,EACzB,YAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAE,cAAc,EACjE,MAAM,sBAAsB,CAAC;AAG9B,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAG3C,YAAY,EACV,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAEhD,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACR,WAAW,EAAE,YAAY,EACzB,YAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAE,cAAc,EACjE,MAAM,sBAAsB,CAAC;AAG9B,cAAc,+BAA+B,CAAC"}

package/dist/index.js

@@ -34,6 +34,7 @@ export * from "./utils/entityUtils.js";
 export * from "./utils/generalDateTimeUtils.js";
 export * from "./utils/luxonUtils.js";
 export * from "./utils/mathUtils.js";
+export * from "./utils/birthdayExperienceQuality.js";
 export * from "./utils/service/apiServiceBookingApiUtils.js";
 export * from "./utils/service/frontendServiceBookingUtils.js";
 export * from "./utils/service/serviceBookingStatusUtils.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAa3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,+DAA+D;AAC/D,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAE9C,iFAAiF;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM3D,kBAAkB;AAClB,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAa3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,+DAA+D;AAC/D,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAE9C,iFAAiF;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM3D,kBAAkB;AAClB,cAAc,+BAA+B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,22 @@
+import { averageExperienceStars, EXPERIENCE_STAR_BANDS, } from "../birthdayExperienceQuality.js";
+describe("averageExperienceStars", () => {
+    it("returns null when there are no votes", () => {
+        expect(averageExperienceStars({ Awesome: 0, Okay: 0, Lame: 0 })).toBeNull();
+        expect(averageExperienceStars(undefined)).toBeNull();
+    });
+    it("returns midpoint when all votes are one tier", () => {
+        const awesomeMid = (EXPERIENCE_STAR_BANDS.Awesome.min +
+            EXPERIENCE_STAR_BANDS.Awesome.max) /
+            2;
+        expect(averageExperienceStars({ Awesome: 2, Okay: 0, Lame: 0 })).toBeCloseTo(awesomeMid);
+    });
+    it("blends mixed votes", () => {
+        const awesomeMid = (EXPERIENCE_STAR_BANDS.Awesome.min +
+            EXPERIENCE_STAR_BANDS.Awesome.max) /
+            2;
+        const lameMid = (EXPERIENCE_STAR_BANDS.Lame.min + EXPERIENCE_STAR_BANDS.Lame.max) / 2;
+        const a = averageExperienceStars({ Awesome: 1, Okay: 0, Lame: 1 });
+        expect(a).toBeCloseTo((awesomeMid + lameMid) / 2);
+    });
+});
+//# sourceMappingURL=birthdayExperienceQuality.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"birthdayExperienceQuality.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/birthdayExperienceQuality.test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAEzC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CACJ,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CACzD,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,UAAU,GACd,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG;YAChC,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC;YACpC,CAAC,CAAC;QACJ,MAAM,CACJ,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CACzD,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,UAAU,GACd,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG;YAChC,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC;YACpC,CAAC,CAAC;QACJ,MAAM,OAAO,GACX,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxE,MAAM,CAAC,GAAG,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/birthdayExperienceQuality.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared Quality of Experience math for birthday freebie catalog offers.
+ * Vote tiers map to star bands; the displayed score is a weighted average of band midpoints (0–5).
+ */
+export type BirthdayExperienceVoteTier = "Awesome" | "Okay" | "Lame";
+export interface BirthdayExperienceVoteCounts {
+    Awesome: number;
+    Okay: number;
+    Lame: number;
+}
+export declare const EXPERIENCE_STAR_BANDS: Record<BirthdayExperienceVoteTier, {
+    min: number;
+    max: number;
+    label: string;
+}>;
+/**
+ * Weighted average of midpoint stars for each vote tier. Null when there are no votes.
+ */
+export declare function averageExperienceStars(votes: BirthdayExperienceVoteCounts | null | undefined): number | null;
+export declare function formatExperienceStars(value: number): string;
+//# sourceMappingURL=birthdayExperienceQuality.d.ts.map

package/dist/utils/birthdayExperienceQuality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"birthdayExperienceQuality.d.ts","sourceRoot":"","sources":["../../src/utils/birthdayExperienceQuality.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,0BAA0B,EAC1B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAK5C,CAAC;AAUF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,4BAA4B,GAAG,IAAI,GAAG,SAAS,GACrD,MAAM,GAAG,IAAI,CASf;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/utils/birthdayExperienceQuality.js

@@ -0,0 +1,33 @@
+/**
+ * Shared Quality of Experience math for birthday freebie catalog offers.
+ * Vote tiers map to star bands; the displayed score is a weighted average of band midpoints (0–5).
+ */
+export const EXPERIENCE_STAR_BANDS = {
+    Lame: { min: 0, max: 1.999, label: "0–2.0" },
+    Okay: { min: 2.0, max: 3.499, label: "2.0–3.5" },
+    Awesome: { min: 3.5, max: 5.0, label: "3.5–5.0" },
+};
+const MIDPOINT = {
+    Lame: (EXPERIENCE_STAR_BANDS.Lame.min + EXPERIENCE_STAR_BANDS.Lame.max) / 2,
+    Okay: (EXPERIENCE_STAR_BANDS.Okay.min + EXPERIENCE_STAR_BANDS.Okay.max) / 2,
+    Awesome: (EXPERIENCE_STAR_BANDS.Awesome.min + EXPERIENCE_STAR_BANDS.Awesome.max) /
+        2,
+};
+/**
+ * Weighted average of midpoint stars for each vote tier. Null when there are no votes.
+ */
+export function averageExperienceStars(votes) {
+    if (!votes)
+        return null;
+    const n = votes.Awesome + votes.Okay + votes.Lame;
+    if (n === 0)
+        return null;
+    const sum = votes.Awesome * MIDPOINT.Awesome +
+        votes.Okay * MIDPOINT.Okay +
+        votes.Lame * MIDPOINT.Lame;
+    return sum / n;
+}
+export function formatExperienceStars(value) {
+    return value.toFixed(1);
+}
+//# sourceMappingURL=birthdayExperienceQuality.js.map

package/dist/utils/birthdayExperienceQuality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"birthdayExperienceQuality.js","sourceRoot":"","sources":["../../src/utils/birthdayExperienceQuality.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,CAAC,MAAM,qBAAqB,GAG9B;IACF,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;IAC5C,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;IAChD,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE;CAClD,CAAC;AAEF,MAAM,QAAQ,GAA+C;IAC3D,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3E,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3E,OAAO,EACL,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC;QACvE,CAAC;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAsD;IAEtD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GACP,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO;QAChC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI;QAC1B,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC7B,OAAO,GAAG,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bash-app/bash-common",
-  "version": "30.176.0",
+  "version": "30.178.0",
   "description": "Common data and scripts to use on the frontend and backend",
   "type": "module",
   "main": "dist/index.js",

package/prisma/schema.prisma

@@ -1708,6 +1708,7 @@ model User {
   birthdayRewardFavorites   BirthdayRewardFavorite[]
   birthdayDealSuggestions BirthdayDealSuggestion[]
   rewardReports          RewardReport[]
+  birthdayFreebieVotes   BirthdayFreebieVote[]
   rewardReportsReviewed  RewardReport[]           @relation("RewardReportReviewedBy")
   nationalChainReports   NationalChainReport[]
   nationalChainReportsReviewed NationalChainReport[] @relation("NationalChainReportReviewedBy")
@@ -6056,6 +6057,8 @@ model BirthdayFreebieCatalog {
   partner    BirthdayOfferPartner?   @relation(fields: [partnerId], references: [id], onDelete: SetNull)
   suggestion BirthdayDealSuggestion? @relation(fields: [suggestionId], references: [id], onDelete: SetNull)
   rewardReports RewardReport[]
+  /// User quality votes (Awesome / Okay / Lame); one row per user per catalog entry.
+  votes      BirthdayFreebieVote[]
 
   @@index([stateSlug, citySlug])
   @@index([isActive])
@@ -6063,6 +6066,23 @@ model BirthdayFreebieCatalog {
   @@index([sector])
 }
 
+/// User quality vote on a catalog entry (Awesome / Okay / Lame). Drives aggregate counts and optional qualityTier updates.
+model BirthdayFreebieVote {
+  id        String   @id @default(cuid())
+  catalogId String
+  userId    String
+  tier      BirthdayOfferQualityTier
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  catalog BirthdayFreebieCatalog @relation(fields: [catalogId], references: [id], onDelete: Cascade)
+  user    User                   @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([catalogId, userId])
+  @@index([catalogId])
+  @@index([userId])
+}
+
 // Per-city "free things to do" links (tourism calendar, Eventbrite, Meetup, alt-weekly)
 enum BirthdayCityResourceType {
   TourismCalendar

package/src/index.ts

@@ -46,6 +46,7 @@ export * from "./utils/entityUtils.js";
 export * from "./utils/generalDateTimeUtils.js";
 export * from "./utils/luxonUtils.js";
 export * from "./utils/mathUtils.js";
+export * from "./utils/birthdayExperienceQuality.js";
 export * from "./utils/service/apiServiceBookingApiUtils.js";
 export * from "./utils/service/frontendServiceBookingUtils.js";
 export * from "./utils/service/serviceBookingStatusUtils.js";

package/src/utils/__tests__/birthdayExperienceQuality.test.ts

@@ -0,0 +1,34 @@
+import {
+  averageExperienceStars,
+  EXPERIENCE_STAR_BANDS,
+} from "../birthdayExperienceQuality.js";
+
+describe("averageExperienceStars", () => {
+  it("returns null when there are no votes", () => {
+    expect(
+      averageExperienceStars({ Awesome: 0, Okay: 0, Lame: 0 })
+    ).toBeNull();
+    expect(averageExperienceStars(undefined)).toBeNull();
+  });
+
+  it("returns midpoint when all votes are one tier", () => {
+    const awesomeMid =
+      (EXPERIENCE_STAR_BANDS.Awesome.min +
+        EXPERIENCE_STAR_BANDS.Awesome.max) /
+      2;
+    expect(
+      averageExperienceStars({ Awesome: 2, Okay: 0, Lame: 0 })
+    ).toBeCloseTo(awesomeMid);
+  });
+
+  it("blends mixed votes", () => {
+    const awesomeMid =
+      (EXPERIENCE_STAR_BANDS.Awesome.min +
+        EXPERIENCE_STAR_BANDS.Awesome.max) /
+      2;
+    const lameMid =
+      (EXPERIENCE_STAR_BANDS.Lame.min + EXPERIENCE_STAR_BANDS.Lame.max) / 2;
+    const a = averageExperienceStars({ Awesome: 1, Okay: 0, Lame: 1 });
+    expect(a).toBeCloseTo((awesomeMid + lameMid) / 2);
+  });
+});

package/src/utils/birthdayExperienceQuality.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared Quality of Experience math for birthday freebie catalog offers.
+ * Vote tiers map to star bands; the displayed score is a weighted average of band midpoints (0–5).
+ */
+
+export type BirthdayExperienceVoteTier = "Awesome" | "Okay" | "Lame";
+
+export interface BirthdayExperienceVoteCounts {
+  Awesome: number;
+  Okay: number;
+  Lame: number;
+}
+
+export const EXPERIENCE_STAR_BANDS: Record<
+  BirthdayExperienceVoteTier,
+  { min: number; max: number; label: string }
+> = {
+  Lame: { min: 0, max: 1.999, label: "0–2.0" },
+  Okay: { min: 2.0, max: 3.499, label: "2.0–3.5" },
+  Awesome: { min: 3.5, max: 5.0, label: "3.5–5.0" },
+};
+
+const MIDPOINT: Record<BirthdayExperienceVoteTier, number> = {
+  Lame: (EXPERIENCE_STAR_BANDS.Lame.min + EXPERIENCE_STAR_BANDS.Lame.max) / 2,
+  Okay: (EXPERIENCE_STAR_BANDS.Okay.min + EXPERIENCE_STAR_BANDS.Okay.max) / 2,
+  Awesome:
+    (EXPERIENCE_STAR_BANDS.Awesome.min + EXPERIENCE_STAR_BANDS.Awesome.max) /
+    2,
+};
+
+/**
+ * Weighted average of midpoint stars for each vote tier. Null when there are no votes.
+ */
+export function averageExperienceStars(
+  votes: BirthdayExperienceVoteCounts | null | undefined
+): number | null {
+  if (!votes) return null;
+  const n = votes.Awesome + votes.Okay + votes.Lame;
+  if (n === 0) return null;
+  const sum =
+    votes.Awesome * MIDPOINT.Awesome +
+    votes.Okay * MIDPOINT.Okay +
+    votes.Lame * MIDPOINT.Lame;
+  return sum / n;
+}
+
+export function formatExperienceStars(value: number): string {
+  return value.toFixed(1);
+}