@bash-app/bash-common 30.186.0 → 30.196.0

package/src/utils/service/cancellationPolicyRefundResolver.ts

@@ -0,0 +1,112 @@
+import { ServiceCancellationPolicy } from "@prisma/client";
+import {
+  SERVICE_CANCELLATION_POLICY_DATA,
+  type ServiceCancellationRefundPolicy,
+} from "./serviceUtils.js";
+
+/**
+ * Converts a tier threshold from SERVICE_CANCELLATION_POLICY_DATA to hours so
+ * rules that mix `days` and `hours` are compared on one timeline.
+ */
+export function cancellationRuleThresholdHours(
+  rule: ServiceCancellationRefundPolicy
+): number {
+  if (rule.days !== undefined) {
+    return rule.days * 24;
+  }
+  if (rule.hours !== undefined) {
+    return rule.hours;
+  }
+  return 0;
+}
+
+export type ResolveCancellationRefundOptions = {
+  /** Event start time (UTC or local — caller must be consistent). */
+  eventStart: Date;
+  /** Defaults to `new Date()`. */
+  now?: Date;
+};
+
+/**
+ * Hours from `now` until `eventStart` (non-negative). Returns 0 if the event
+ * has started or `eventStart` is invalid.
+ */
+export function hoursUntilEventStart(
+  eventStart: Date,
+  now: Date = new Date()
+): number {
+  const ms = eventStart.getTime() - now.getTime();
+  if (ms <= 0 || Number.isNaN(ms)) {
+    return 0;
+  }
+  return ms / (1000 * 60 * 60);
+}
+
+/**
+ * Resolves refund as a fraction in [0, 1] from {@link SERVICE_CANCELLATION_POLICY_DATA}.
+ * For each rule, if time until start is at least that rule's threshold, the rule
+ * applies; when multiple apply, the highest `refundPercentage` wins (matches
+ * tiered "full → partial → none" semantics).
+ */
+export function resolveCancellationRefundFraction(
+  policy: ServiceCancellationPolicy | null | undefined,
+  options: ResolveCancellationRefundOptions
+): number {
+  if (policy == null || policy === ServiceCancellationPolicy.None) {
+    return 0;
+  }
+  const data = SERVICE_CANCELLATION_POLICY_DATA[policy];
+  if (!data?.refundPolicy?.length) {
+    return 0;
+  }
+
+  const now = options.now ?? new Date();
+  const hoursUntil = hoursUntilEventStart(options.eventStart, now);
+  if (hoursUntil <= 0) {
+    return 0;
+  }
+
+  let bestPercent = 0;
+  for (const rule of data.refundPolicy) {
+    const thresholdHours = cancellationRuleThresholdHours(rule);
+    if (hoursUntil >= thresholdHours && rule.refundPercentage > bestPercent) {
+      bestPercent = rule.refundPercentage;
+    }
+  }
+
+  return bestPercent / 100;
+}
+
+/**
+ * The winning tier rule for display (e.g. service booking UI), or null if none.
+ */
+export function getMatchingCancellationRefundRule(
+  policy: ServiceCancellationPolicy | null | undefined,
+  options: ResolveCancellationRefundOptions
+): ServiceCancellationRefundPolicy | null {
+  if (policy == null || policy === ServiceCancellationPolicy.None) {
+    return null;
+  }
+  const data = SERVICE_CANCELLATION_POLICY_DATA[policy];
+  if (!data?.refundPolicy?.length) {
+    return null;
+  }
+
+  const now = options.now ?? new Date();
+  const hoursUntil = hoursUntilEventStart(options.eventStart, now);
+  if (hoursUntil <= 0) {
+    return null;
+  }
+
+  let bestRule: ServiceCancellationRefundPolicy | null = null;
+  let bestPercent = 0;
+  for (const rule of data.refundPolicy) {
+    const thresholdHours = cancellationRuleThresholdHours(rule);
+    if (hoursUntil >= thresholdHours && rule.refundPercentage > bestPercent) {
+      bestPercent = rule.refundPercentage;
+      bestRule = rule;
+    }
+  }
+
+  return bestRule;
+}

package/src/utils/service/serviceUtils.ts

@@ -123,6 +123,91 @@ export const SERVICE_CANCELLATION_POLICY_DATA: ServiceCancellationPolicyMap = {
     ],
     description: "Strict policy for vendor bookings with longer notice periods",
   },
+  // Exhibitor / Sponsor: same tier math as vendor; separate enum + copy for role clarity
+  [ServiceCancellationPolicyOption.ExhibitorFlexible]: {
+    name: "Exhibitor Flexible",
+    refundPolicy: [
+      {
+        days: 7,
+        refundPercentage: 100,
+      },
+      {
+        hours: 24,
+        refundPercentage: 50,
+      },
+    ],
+    description: "Flexible policy for exhibitor bookings",
+  },
+  [ServiceCancellationPolicyOption.ExhibitorStandard]: {
+    name: "Exhibitor Standard",
+    refundPolicy: [
+      {
+        days: 14,
+        refundPercentage: 100,
+      },
+      {
+        days: 3,
+        refundPercentage: 50,
+      },
+    ],
+    description: "Standard policy for exhibitor bookings",
+  },
+  [ServiceCancellationPolicyOption.ExhibitorStrict]: {
+    name: "Exhibitor Strict",
+    refundPolicy: [
+      {
+        days: 30,
+        refundPercentage: 100,
+      },
+      {
+        days: 7,
+        refundPercentage: 25,
+      },
+    ],
+    description: "Strict policy for exhibitor bookings",
+  },
+  [ServiceCancellationPolicyOption.SponsorFlexible]: {
+    name: "Sponsor Flexible",
+    refundPolicy: [
+      {
+        days: 7,
+        refundPercentage: 100,
+      },
+      {
+        hours: 24,
+        refundPercentage: 50,
+      },
+    ],
+    description: "Flexible policy for sponsorship bookings",
+  },
+  [ServiceCancellationPolicyOption.SponsorStandard]: {
+    name: "Sponsor Standard",
+    refundPolicy: [
+      {
+        days: 14,
+        refundPercentage: 100,
+      },
+      {
+        days: 3,
+        refundPercentage: 50,
+      },
+    ],
+    description: "Standard policy for sponsorship bookings",
+  },
+  [ServiceCancellationPolicyOption.SponsorStrict]: {
+    name: "Sponsor Strict",
+    refundPolicy: [
+      {
+        days: 30,
+        refundPercentage: 100,
+      },
+      {
+        days: 7,
+        refundPercentage: 25,
+      },
+    ],
+    description: "Strict policy for sponsorship bookings",
+  },
 } as const;
 
 function generateDescription(
@@ -140,9 +225,10 @@ function generateDescription(
     if (index === 0) {
       return `Guests may cancel their Booking until ${timeValue} ${unit} before the event start time and will receive ${refundText} of their Booking Price.`;
     } else {
-      const previousTime =
-        refundPolicy[index - 1].days ?? refundPolicy[index - 1].hours;
-      return `Guests may cancel their Booking between ${timeValue} ${unit} and ${previousTime} ${unit} before the event start time and receive ${refundText} of their Booking Price.`;
+      const prevPolicy = refundPolicy[index - 1];
+      const prevUnit = prevPolicy.days ? "days" : "hours";
+      const prevTime = prevPolicy.days ?? prevPolicy.hours;
+      return `Guests may cancel their Booking between ${prevTime} ${prevUnit} and ${timeValue} ${unit} before the event start time and receive ${refundText} of their Booking Price.`;
     }
   });
 
@@ -158,6 +244,12 @@ function generateDescription(
   return descriptions.join(" ");
 }
 
+/**
+ * Vendor cancellation policy copy shown in the service wizard. Hosts send
+ * **booking requests**; after acceptance and payment, the vendor's obligation
+ * is a **verified booking**. Use "verified booking" for vendor-initiated
+ * cancellation—never "booking request" in this generator.
+ */
 function generateVendorDescription(
   refundPolicy: ServiceCancellationRefundPolicy[]
 ): string {
@@ -171,11 +263,12 @@ function generateVendorDescription(
         : `${policy.refundPercentage}% refund from the Host (excluding Fees)`;
 
     if (index === 0) {
-      return `Vendors may cancel their booking request until ${timeValue} ${unit} before the event start time and will receive ${refundText} of their payment.`;
+      return `If you (the vendor) cancel your verified booking at least ${timeValue} ${unit} before the event start time, you will receive ${refundText} of what you paid the Host.`;
     } else {
-      const previousTime =
-        refundPolicy[index - 1].days ?? refundPolicy[index - 1].hours;
-      return `Vendors may cancel their booking request between ${timeValue} ${unit} and ${previousTime} ${unit} before the event start time and receive ${refundText} of their payment.`;
+      const prevPolicy = refundPolicy[index - 1];
+      const prevUnit = prevPolicy.days ? "days" : "hours";
+      const prevTime = prevPolicy.days ?? prevPolicy.hours;
+      return `If you (the vendor) cancel your verified booking between ${prevTime} ${prevUnit} and ${timeValue} ${unit} before the event start time, you will receive ${refundText} of what you paid the Host.`;
     }
   });
 
@@ -183,14 +276,97 @@ function generateVendorDescription(
     refundPolicy[refundPolicy.length - 1].days ??
     refundPolicy[refundPolicy.length - 1].hours;
   descriptions.push(
-    `Vendor cancellations submitted less than ${lastTime} ${
+    `If you (the vendor) cancel your verified booking less than ${lastTime} ${
       refundPolicy[refundPolicy.length - 1].days ? "days" : "hours"
-    } before the Event start time are not refundable.`
+    } before the event start time, your payment is not refundable under this policy.`
   );
 
-  // Add host cancellation policy
   descriptions.push(
-    `If the Host cancels the event or vendor booking, the Vendor will receive a full refund regardless of timing, unless the cancellation is due to vendor non-compliance with event requirements.`
+    `If the Host cancels the event or your verified booking, you will generally receive a full refund of what you paid, unless the cancellation was due to your non-compliance with the Host's or event's requirements.`
+  );
+
+  return descriptions.join(" ");
+}
+
+/**
+ * Exhibitor-facing copy: hosts send booking requests; after accept + pay, use
+ * "verified booking" for exhibitor-initiated cancellation (same convention as vendors).
+ */
+function generateExhibitorDescription(
+  refundPolicy: ServiceCancellationRefundPolicy[]
+): string {
+  const descriptions = refundPolicy.map((policy, index) => {
+    const unit = policy.days ? "days" : "hours";
+    const timeValue = policy.days ?? policy.hours;
+
+    const refundText =
+      policy.refundPercentage === 100
+        ? "a full refund from the Host (including all Fees)"
+        : `${policy.refundPercentage}% refund from the Host (excluding Fees)`;
+
+    if (index === 0) {
+      return `If you (the exhibitor) cancel your verified booking at least ${timeValue} ${unit} before the event start time, you will receive ${refundText} of what you paid the Host.`;
+    } else {
+      const prevPolicy = refundPolicy[index - 1];
+      const prevUnit = prevPolicy.days ? "days" : "hours";
+      const prevTime = prevPolicy.days ?? prevPolicy.hours;
+      return `If you (the exhibitor) cancel your verified booking between ${prevTime} ${prevUnit} and ${timeValue} ${unit} before the event start time, you will receive ${refundText} of what you paid the Host.`;
+    }
+  });
+
+  const lastTime =
+    refundPolicy[refundPolicy.length - 1].days ??
+    refundPolicy[refundPolicy.length - 1].hours;
+  descriptions.push(
+    `If you (the exhibitor) cancel your verified booking less than ${lastTime} ${
+      refundPolicy[refundPolicy.length - 1].days ? "days" : "hours"
+    } before the event start time, your payment is not refundable under this policy.`
+  );
+
+  descriptions.push(
+    `If the Host cancels the event or your verified booking, you will generally receive a full refund of what you paid, unless the cancellation was due to your non-compliance with the Host's or event's requirements.`
+  );
+
+  return descriptions.join(" ");
+}
+
+/**
+ * Sponsor-facing copy: same payment-to-host model; use "sponsorship commitment" where
+ * "verified booking" would be awkward for sponsors.
+ */
+function generateSponsorDescription(
+  refundPolicy: ServiceCancellationRefundPolicy[]
+): string {
+  const descriptions = refundPolicy.map((policy, index) => {
+    const unit = policy.days ? "days" : "hours";
+    const timeValue = policy.days ?? policy.hours;
+
+    const refundText =
+      policy.refundPercentage === 100
+        ? "a full refund from the Host (including all Fees)"
+        : `${policy.refundPercentage}% refund from the Host (excluding Fees)`;
+
+    if (index === 0) {
+      return `If you (the sponsor) cancel your verified sponsorship commitment at least ${timeValue} ${unit} before the event start time, you will receive ${refundText} of what you paid the Host.`;
+    } else {
+      const prevPolicy = refundPolicy[index - 1];
+      const prevUnit = prevPolicy.days ? "days" : "hours";
+      const prevTime = prevPolicy.days ?? prevPolicy.hours;
+      return `If you (the sponsor) cancel your verified sponsorship commitment between ${prevTime} ${prevUnit} and ${timeValue} ${unit} before the event start time, you will receive ${refundText} of what you paid the Host.`;
+    }
+  });
+
+  const lastTime =
+    refundPolicy[refundPolicy.length - 1].days ??
+    refundPolicy[refundPolicy.length - 1].hours;
+  descriptions.push(
+    `If you (the sponsor) cancel your verified sponsorship commitment less than ${lastTime} ${
+      refundPolicy[refundPolicy.length - 1].days ? "days" : "hours"
+    } before the event start time, your payment is not refundable under this policy.`
+  );
+
+  descriptions.push(
+    `If the Host cancels the event or your sponsorship, you will generally receive a full refund of what you paid, unless the cancellation was due to your non-compliance with the Host's or event's requirements.`
   );
 
   return descriptions.join(" ");
@@ -207,11 +383,14 @@ Object.keys(SERVICE_CANCELLATION_POLICY_DATA)
       SERVICE_CANCELLATION_POLICY_DATA[
         policyKey as ServiceCancellationPolicyOption
       ];
-    
-    // Use vendor-specific description for vendor policies
-    const isVendorPolicy = (policyKey as string).startsWith('Vendor');
-    if (isVendorPolicy) {
+
+    const keyStr = policyKey as string;
+    if (keyStr.startsWith("Vendor")) {
       policy.description = generateVendorDescription(policy.refundPolicy);
+    } else if (keyStr.startsWith("Exhibitor")) {
+      policy.description = generateExhibitorDescription(policy.refundPolicy);
+    } else if (keyStr.startsWith("Sponsor")) {
+      policy.description = generateSponsorDescription(policy.refundPolicy);
     } else {
       policy.description = generateDescription(policy.refundPolicy);
     }
@@ -277,6 +456,27 @@ export function serviceWizardUrl(
   return `/wz/services/${serviceId}/${serviceType}/${specificId}/${step}/${substep}`;
 }
 
+/**
+ * Vendor, Exhibitor, and Sponsor profile wizards share this layout: major step 6 = "How",
+ * sub-step 3 = "Payment method" (partner profile wizard payment step).
+ */
+export const PARTNER_SERVICE_PROFILE_WIZARD_PAYMENT_METHOD_MAJOR_STEP = 6;
+export const PARTNER_SERVICE_PROFILE_WIZARD_PAYMENT_METHOD_SUB_STEP = 3;
+
+export function partnerServiceProfileWizardPaymentMethodUrl(
+  serviceId: string,
+  serviceType: string,
+  specificId: string
+): string {
+  return serviceWizardUrl(
+    serviceId,
+    serviceType,
+    specificId,
+    PARTNER_SERVICE_PROFILE_WIZARD_PAYMENT_METHOD_MAJOR_STEP,
+    PARTNER_SERVICE_PROFILE_WIZARD_PAYMENT_METHOD_SUB_STEP
+  );
+}
+
 export function serviceCheckoutUrl(
   serviceId: string,
   serviceType: string,
@@ -440,14 +640,14 @@ export const serviceSpecificInfoAI = {
       isArray: false,
     },
     vendorType: {
-      description: `vendorType (set to "products" if selling physical goods, or "services" if providing vendor services like face painting)`,
+      description: `vendorType: use "products" for physical goods (retail food, merchandise, packaged goods) and "services" for experiential booth activities (face painting, henna, etc.). If the prompt is only a well-known business or brand name, infer the correct mode: restaurant chains, bakeries, coffee shops, snack brands → "products"; activity-only brands → "services" when appropriate.`,
       example: `"products"`,
       type: "string",
       isArray: false,
     },
     vendorProductTypes: {
-      description: `vendorProductTypes (array of VendedProductType enum values for PRODUCT vendors: Art, HandcraftedItems, Pottery, Woodwork, LeatherGoods, Textiles, BakedGoods, Beverages, FoodItems, HoneyAndJams, PopcornAndSnacks, SweetTreats, Spices, Sauces, MakeupCosmetics, SkincareProducts, BodyCareProducts, Soaps, Perfumes, HairCareProducts, Clothing, TShirtsAndApparel, Jewelry, Accessories, Hats, Bags, Shoes, HomeDecor, Candles, Plants, Succulents, Furniture, Kitchenware, Books, Crystals, SpiritualItems, HerbalRemedies, VintageAntiques, Collectibles, PhotographyPrints, StickersAndStationery, Prints, Zines, Toys, BabyItems, PetProducts, TechAccessories, Other). Only use for vendors with vendorType="products".`,
-      example: `["Jewelry", "HandcraftedItems"]`,
+      description: `vendorProductTypes (array of VendedProductType enum values for PRODUCT vendors: Art, HandcraftedItems, Pottery, Woodwork, LeatherGoods, Textiles, BakedGoods, Beverages, FoodItems, HoneyAndJams, PopcornAndSnacks, SweetTreats, Spices, Sauces, MakeupCosmetics, SkincareProducts, BodyCareProducts, Soaps, Perfumes, HairCareProducts, Clothing, TShirtsAndApparel, Jewelry, Accessories, Hats, Bags, Shoes, HomeDecor, Candles, Plants, Succulents, Furniture, Kitchenware, Books, Crystals, SpiritualItems, HerbalRemedies, VintageAntiques, Collectibles, PhotographyPrints, StickersAndStationery, Prints, Zines, Toys, BabyItems, PetProducts, TechAccessories, Other). Only use for vendors with vendorType="products". For famous food/dessert brands (e.g. doughnuts, coffee), use FoodItems and/or SweetTreats (both are valid when appropriate).`,
+      example: `["FoodItems", "SweetTreats"]`,
       type: "string",
       isArray: true,
     },
@@ -458,8 +658,8 @@ export const serviceSpecificInfoAI = {
       isArray: true,
     },
     goodsOrServices: {
-      description: `goodsOrServices (array of specific products/services offered - the actual items, not categories)`,
-      example: `["bracelets", "jewelry", "ponchos", "blankets"]`,
+      description: `goodsOrServices (array of specific items offered — e.g. "Donuts", "Coffee", "Glazed doughnuts", not just category names). When the user names a famous brand, infer typical menu or product lines for that brand.`,
+      example: `["Donuts", "Coffee", "Seasonal flavors"]`,
       type: "string",
       isArray: true,
     },

package/src/utils/slugUtils.ts

@@ -1,4 +1,5 @@
 import slugify from 'slugify';
+import { BASH_DETAIL_URL } from '../definitions.js';
 
 export function generateSlug(title: string): string {
   return slugify(title, { 
@@ -31,6 +32,21 @@ export function generateBashDetailUrl(bashEventId: string, slug: string): string
   return `/bash/${bashEventId}-${slug}`;
 }
 
+/**
+ * Public event path for links shared to social / QR (canonical frontend URL).
+ * With a slug: `/bash/{id}-{slug}`; without: `/bash/{id}` (legacy id-only segment).
+ */
+export function getPublicBashDetailPath(
+  bashEventId: string,
+  slug: string | null | undefined
+): string {
+  const s = slug?.trim();
+  if (s) {
+    return generateBashDetailUrl(bashEventId, s);
+  }
+  return `${BASH_DETAIL_URL}/${bashEventId}`;
+}
+
 export function parseBashUrlParams(param: string): { id: string; slug: string | null } | null {
   // Expected format: "id-slug" where id is first part before first dash
   const dashIndex = param.indexOf('-');