@wix/himalaya-cli 0.1496.0 → 0.1498.0

package/templates/branded-lite/tier5-src/_shared/business-chat-presenter.ts

@@ -160,6 +160,13 @@ function safeAvatar(value: unknown): string {
   return match && !/[@%]/.test(match[1]!) ? value : "";
 }
 
+/** A card's picture, only a plain https URL. Wix sends a 200-point thumbnail; a card shows it about 270 wide on a
+ *  dense screen, so a Wix media URL asks its image service for a larger copy instead of being blown up. */
+function cardImage(value: unknown): string {
+  const url = safeAvatar(value);
+  return /^https:\/\/static\.wixstatic\.com\/media\//i.test(url) ? url.replace(/\/v1\/fit\/w_\d+,h_\d+,/i, "/v1/fit/w_800,h_800,") : url;
+}
+
 function initials(value: string): string {
   const words = value.trim().split(/\s+/).filter(Boolean);
   return words.length > 1 ? `${words[0]![0]}${words[words.length - 1]![0]}`.toUpperCase() : (words[0]?.slice(0, 2) ?? "").toUpperCase();
@@ -316,8 +323,10 @@ const isSafeLink = (url: string): boolean => SAFE_LINK.test(url) && !/[\u0000-\u
 
 /** Owner tools (a product, a coupon, a scheduling link) reach a member as plain text: a title, detail
  *  lines and `Label: https://…` lines. On a phone that is a wall of text with a URL nobody can tap, so a
- *  link line becomes a button and a coupon code its own block. Only plain https links are lifted. */
-export function extractBusinessMessageExtras(markdown: string): { text: string; links: { label: string; url: string }[]; couponCode: string } {
+ *  link line becomes a button and a coupon code its own block. Only plain https links are lifted. A message shown
+ *  without a card (an AI answer) has no coupon block, so `liftCoupon: false` leaves its code in the text. */
+export function extractBusinessMessageExtras(markdown: string, options: { liftCoupon?: boolean } = {}): { text: string; links: { label: string; url: string }[]; couponCode: string } {
+  const liftCoupon = options.liftCoupon ?? true;
   const kept: string[] = [];
   const links: { label: string; url: string }[] = [];
   let couponCode = "";
@@ -343,7 +352,7 @@ export function extractBusinessMessageExtras(markdown: string): { text: string;
       }
     }
     const code = /^(.*?)[,;]?\s*\b[Cc]ode:\s*([A-Z0-9_-]{3,32})$/.exec(trimmed);
-    if (code && !couponCode) {
+    if (code && liftCoupon && !couponCode) {
       couponCode = code[2]!;
       if (code[1]!.trim()) kept.push(code[1]!.trim());
       continue;
@@ -383,6 +392,14 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
   noCoupon: boolean;
   productSlug: string;
   productName: string;
+  isCard: boolean;
+  notCard: boolean;
+  noSuggestions: boolean;
+  noActions: boolean;
+  cardTitle: string;
+  cardDetail: string;
+  /** A card with neither title nor detail (a file, a coupon with no line): its text block is hidden, not an empty gap. */
+  noCardText: boolean;
 })[] {
   const metadata = new Map<string, RecordValue>();
   for (const value of raw) {
@@ -410,14 +427,15 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
       : "";
     if (key) previousDay = key;
 
-    const imageUrl = imagePart?.url || "";
     const template = object(message.templateData);
+    // A product the owner sends from the Inbox carries its picture on the card itself (`templateData.image`).
+    const imageUrl = imagePart?.url || cardImage(template.image);
     const standardEventText = message.messageType === "template/standard-event"
       ? [template.title, ...(Array.isArray(template.lines) ? template.lines : [])]
         .filter((value): value is string => typeof value === "string" && !!value.trim())
         .join("\n")
       : "";
-    const bodyText = imageUrl
+    const bodyText = imagePart?.url
       ? row.parts.filter((part) => part.kind === "text").map((part) => [part.text, ...(part.fields ?? []).map((field) => `${field.name}: ${field.value}`)].filter(Boolean).join("\n")).filter(Boolean).join("\n")
       : standardEventText || row.plainText;
     const senderAvatar = safeAvatar(image.url);
@@ -434,7 +452,8 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
     const bodyRuns = htmlMessageRuns(message) ?? plainTextRuns;
     const bodyMarkdown = markdownFromRuns(bodyRuns);
     const buttons = messageButtons(message, row.id);
-    const extras = mine ? { text: bodyMarkdown, links: [], couponCode: "" } : extractBusinessMessageExtras(bodyMarkdown);
+    // An AI answer is never a card, and only a card shows the coupon block, so its code stays in its text.
+    const extras = mine ? { text: bodyMarkdown, links: [], couponCode: "" } : extractBusinessMessageExtras(bodyMarkdown, { liftCoupon: !isAiGenerated });
     // A card is a title and detail lines: Wix sends events as one, and an owner's product, coupon or scheduling link
     // arrives as plain text of the same shape. Its title leads in bold, and a coupon's title is its code, which
     // the coupon block already shows.
@@ -447,10 +466,21 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
     const titled = cardLike && extras.couponCode && first === extras.couponCode ? lines.slice(1).join("\n")
       : cardLike && lines.length > 1 && !first.startsWith("**") ? `**${first}**\n${lines.slice(1).join("\n")}` : extras.text;
     // A product card links to its store page; the slug lets the worker find the product and show its picture.
-    const productPage = cardLike ? extras.links.map((link) => /^https:\/\/[^/?#]+(?:\/[^/?#]+)*?\/product-page\/([^/?#]+)/i.exec(link.url)?.[1]).find(Boolean) : undefined;
+    // The link is a line of the text or, from the Inbox's product tool, a template button.
+    // Only a card shows the picture, so an AI answer (never a card) does not look one up.
+    const productPage = cardLike && !isAiGenerated ? [...extras.links, ...articleActions(message, row.id)].map((link) => /^https:\/\/[^/?#]+(?:\/[^/?#]+)*?\/product-page\/([^/?#]+)/i.exec(link.url)?.[1]).find(Boolean) : undefined;
     // A file, recording or video has no inline player here: it gets a button that opens it.
     const attachmentLinks = row.parts.filter((part) => (part.kind === "file" || part.kind === "audio" || part.kind === "video") && !!part.url)
       .map((part, at) => ({ id: `${row.id}:attachment-${at}`, label: (part.fileName || part.caption || `Open ${part.kind}`).slice(0, 40), url: part.url as string, style: "secondary" as const }));
+    // The card look (a framed box with a centred title) is for what an owner tool sends: a product, coupon, scheduling
+    // or pay link, an event, or a file. A coupon's title is its code, which the coupon block already shows.
+    // An AI answer is text with link pills, as on the site's Smart Chat, even when it is shaped like a card.
+    const isCard = !mine && !isAiGenerated && (cardLike || !!extras.couponCode || (attachmentLinks.length > 0 && !imageUrl));
+    const cardTitle = cardLike && !(extras.couponCode && first === extras.couponCode) ? first.replace(/^\*\*(.+)\*\*$/, "$1") : "";
+    // A product card shows its name and price, as on the site's Smart Chat; the "4 variants | In stock" summary the
+    // Inbox adds to the text is left out of it.
+    const cardLines = cardTitle ? lines.slice(1) : titled.split("\n");
+    const cardDetail = (productPage ? cardLines.filter((line) => !/^\s*\d+\s+variants?\b|\|\s*(?:in|out of)\s+stock\s*$/i.test(line)) : cardLines).join("\n");
     const articles = [...articleActions(message, row.id), ...attachmentLinks, ...extras.links.map((link, at) => ({ id: `${row.id}:link-${at}`, label: link.label, url: link.url, style: /\b(view|buy|shop|book|pay|order|checkout|reserve|schedule)\b/i.test(link.label) ? "primary" as const : "secondary" as const }))]
       .filter((action, at, all) => all.findIndex((other) => other.url === action.url) === at);
 
@@ -463,7 +493,8 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
       senderInitials: typeof display.initials === "string" && display.initials.trim() ? display.initials.trim() : initials(senderName),
       senderBadge: participantId && !mine ? isAiGenerated ? "AI assistant" : "Staff Response" : "",
       imageUrl,
-      imageDescription: imagePart?.caption || "Image attachment",
+      // A card's own picture is named by the card (a product's name), not as an anonymous attachment.
+      imageDescription: imagePart?.caption || (imageUrl && !imagePart?.url && first ? first.replace(/\*/g, "") : "Image attachment"),
       noImage: !imageUrl,
       bodyText,
       bodyRuns,
@@ -472,6 +503,13 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
       noCoupon: !extras.couponCode,
       productSlug: productPage ?? "",
       productName: productPage ? first : "",
+      isCard,
+      notCard: !isCard,
+      noSuggestions: buttons.length === 0,
+      noActions: articles.length === 0,
+      cardTitle,
+      noCardText: !cardTitle && !cardDetail.trim(),
+      cardDetail,
       isAiGenerated,
       suggestions: buttons,
       articleActions: articles,

package/templates/branded-lite/tier5-src/_shared/iap-attendance-form.ts

@@ -0,0 +1,106 @@
+import { copyParam } from "./himi-copy.js";
+
+export interface AttendanceField {
+  id: string;
+  label: string;
+  kind: string;
+  required: boolean;
+  value: string;
+  selectedIds: string[];
+  options: { id: string; label: string }[];
+  error: string;
+  maxLength?: number;
+  maxSize?: number;
+}
+
+const object = (v: unknown): Record<string, unknown> => v !== null && typeof v === "object" && !Array.isArray(v) ? v as Record<string, unknown> : {};
+const text = (v: unknown): string => typeof v === "string" ? v : "";
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+export function createAttendanceForm(prefix: string) {
+  let fields: AttendanceField[] = [];
+  let supported = false;
+  const label = (name: string) => copyParam(`${prefix}.${name}Label`, name === "firstName" ? "First name" : name === "lastName" ? "Last name" : "Email");
+  const field = (scope: string, name: string, input: Record<string, unknown> = {}): AttendanceField => ({
+    id: `${scope}:${name}`, label: text(input.label) || label(name), required: input.mandatory === true,
+    kind: name === "email" ? "email" : input.type === "NUMBER" ? "number" : input.type === "TEXT_ARRAY" ? "multiple" : Array.isArray(input.options) && input.options.length ? "choice" : "text",
+    value: "", selectedIds: [], error: "",
+    options: Array.isArray(input.options) ? input.options.filter((o): o is string => typeof o === "string").map((o) => ({ id: o, label: o })) : [],
+    ...(typeof input.maxLength === "number" ? { maxLength: input.maxLength } : {}),
+    ...(typeof input.maxSize === "number" ? { maxSize: input.maxSize } : {}),
+  });
+  const contact = (scope: string) => ["firstName", "lastName", "email"].map((name) => field(scope, name, { mandatory: true }));
+
+  function event(raw: unknown): void {
+    fields = contact("buyer");
+    const controls = object(raw).controls;
+    supported = Array.isArray(controls) && controls.length > 0;
+    const names = new Set<string>();
+    for (const control of Array.isArray(controls) ? controls : []) {
+      const c = object(control);
+      if (c.deleted === true) continue;
+      if (!Array.isArray(c.inputs) || !c.inputs.length) { supported = false; continue; }
+      for (const rawInput of c.inputs) {
+        const input = object(rawInput);
+        const name = text(input.name);
+        if (!name || names.has(name) || !["TEXT", "NUMBER", "TEXT_ARRAY"].includes(text(input.type)) || (input.type === "TEXT_ARRAY" && (!Array.isArray(input.options) || !input.options.length))) { supported = false; continue; }
+        names.add(name);
+        fields.push(field("guest", name, { ...input, mandatory: input.mandatory === true || ["firstName", "lastName", "email"].includes(name) }));
+      }
+    }
+    if (!["firstName", "lastName", "email"].every((name) => names.has(name))) supported = false;
+  }
+
+  function booking(service: unknown): void {
+    fields = contact("buyer");
+    const id = text(object(object(service).form).id);
+    // Custom intake schemas need their own reader; never silently omit their required fields.
+    supported = id === "00000000-0000-0000-0000-000000000000";
+  }
+
+  function change(arg: unknown): void {
+    const a = object(arg);
+    const f = fields.find((candidate) => candidate.id === a.id);
+    if (!f) return;
+    if (typeof a.option === "string") {
+      if (f.kind === "multiple") f.selectedIds = f.selectedIds.includes(a.option) ? f.selectedIds.filter((v) => v !== a.option) : [...f.selectedIds, a.option];
+      else f.value = a.option;
+      f.error = "";
+      return;
+    }
+    f.value = text(a.value ?? a.text ?? a.selectedId);
+    f.selectedIds = Array.isArray(a.selectedIds) ? a.selectedIds.filter((v): v is string => typeof v === "string") : [];
+    f.error = "";
+  }
+
+  function valid(f: AttendanceField): boolean {
+    const value = f.value.trim();
+    const values = f.kind === "multiple" ? f.selectedIds : value ? [value] : [];
+    if (!values.length) return !f.required;
+    if (f.options.length && values.some((v) => !f.options.some((o) => o.id === v))) return false;
+    if (f.maxSize !== undefined && values.length > f.maxSize) return false;
+    if (f.maxLength !== undefined && values.some((v) => v.length > f.maxLength!)) return false;
+    return f.kind === "email" ? EMAIL.test(value) : f.kind !== "number" || /^-?\d+(?:\.\d+)?$/.test(value);
+  }
+
+  function validate(): boolean {
+    for (const f of fields) f.error = valid(f) ? "" : copyParam(`${prefix}.formInvalidText`, "Check this field.");
+    return supported && fields.every((f) => !f.error);
+  }
+
+  function buyer(): Record<string, string> {
+    return Object.fromEntries(fields.filter((f) => f.id.startsWith("buyer:")).map((f) => [f.id.slice(6), f.value.trim()]));
+  }
+
+  function ticket(definitionId: string) {
+    const inputValues = fields.filter((f) => f.id.startsWith("guest:") && (f.value.trim() || f.selectedIds.length)).map((f) => ({ inputName: f.id.slice(6), ...(f.kind === "multiple" ? { values: f.selectedIds.slice() } : { value: f.value.trim() }) }));
+    return { buyer: buyer(), guests: [{ ticketDefinitionId: definitionId, form: { inputValues } }] };
+  }
+
+  return {
+    event, booking, change, validate, buyer, ticket,
+    supported: () => supported,
+    rows: () => fields.map((f) => ({ ...f, selectedIds: f.selectedIds.slice(), kind: f.kind === "text" && f.required ? "requiredText" : f.kind })),
+    clear: () => { for (const f of fields) { f.value = ""; f.selectedIds = []; f.error = ""; } },
+  };
+}

package/templates/branded-lite/tier5-src/_shared/iap-attendance-purchase.ts

@@ -0,0 +1,211 @@
+import { attendanceCheckoutRoute, availableTicketAttendanceOf, bookingAttendanceOf, classifyForApple, hostSessionFromGlobal, iapPriceFields, type BookingAttendance, type CatalogReference, type IapPollDirective, type TicketAttendance } from "@himalaya/iap";
+import { bookingOrders, createIapCommerce, eventTicketOrders, type IapOrderItem } from "@himalaya/iap-checkout";
+import { copyParam, copyTemplate } from "./himi-copy.js";
+import { createAttendanceForm, type AttendanceField } from "./iap-attendance-form.js";
+import { attendancePlatform } from "./iap-attendance.js";
+import { iapPriceCopy, iapPurchaseCopy } from "./iap-worker.js";
+
+export interface AttendancePurchaseFields {
+  iapBuyHidden: boolean;
+  iapBuyDisabled: boolean;
+  iapBuyLabel: string;
+  iapBusy: boolean;
+  iapPrice: string;
+  iapNote: string;
+  iapRetryHidden: boolean;
+  iapFormHidden: boolean;
+  iapFormError: string;
+  iapSignInHidden: boolean;
+  iapFields: AttendanceField[];
+  _poll?: IapPollDirective;
+}
+
+export const ATTENDANCE_INITIAL: AttendancePurchaseFields = {
+  iapBuyHidden: true, iapBuyDisabled: true, iapBuyLabel: "", iapBusy: false,
+  iapPrice: "", iapNote: "", iapRetryHidden: true, iapFormHidden: true, iapFormError: "", iapSignInHidden: true, iapFields: [],
+};
+export const ATTENDANCE_NOT_HYDRATED = [...Object.keys(ATTENDANCE_INITIAL), "_poll"] as (keyof AttendancePurchaseFields & string)[];
+
+export function createAttendancePurchase(options: { kind: "bookingsService" | "eventsTicket"; prefix: string; pollAction: string; onChange(): void }) {
+  const { prefix } = options;
+  let form = createAttendanceForm(prefix);
+  const submittedForms = new Map<string, ReturnType<typeof createAttendanceForm>>();
+  const session = hostSessionFromGlobal();
+  const commerce = createIapCommerce({ adapters: [options.kind === "bookingsService" ? bookingOrders : eventTicketOrders], onChange: options.onChange });
+  let generation = session.current().generation;
+  let reference: CatalogReference | undefined;
+  let metadata: BookingAttendance | TicketAttendance | undefined;
+  let platform = "unknown";
+  let started = false;
+  let inFlight = false;
+  let formError = "";
+  let sequence = 0;
+  let formRevision = 0;
+  const attempts = new Map<string, string>();
+  session.subscribe(() => { syncSession(); if (reference) options.onChange(); });
+
+  function syncSession(): void {
+    const next = session.current().generation;
+    if (next === generation) return;
+    generation = next;
+    form.clear();
+    submittedForms.clear();
+    formError = "";
+    attempts.clear();
+  }
+
+  async function refresh(): Promise<void> {
+    const next = await attendancePlatform(publishPlatform);
+    if (next !== "unknown" || platform === "unknown") platform = next;
+    await resume();
+  }
+
+  async function resume(): Promise<void> {
+    if (reference) await commerce.loadPrices([{ reference }]);
+    const first = !started;
+    started = true;
+    await (first ? commerce.start() : commerce.reconcile());
+  }
+
+  function publishPlatform(next: string): void {
+    if (next === "unknown" && platform !== "unknown") return;
+    platform = next;
+    void resume().then(options.onChange, options.onChange);
+  }
+
+  function show(): void {
+    void attendancePlatform(publishPlatform).then(publishPlatform, options.onChange);
+  }
+
+  async function booking(id: string, service: unknown): Promise<void> {
+    syncSession();
+    reference = { kind: options.kind, id };
+    metadata = bookingAttendanceOf(service);
+    selectForm(id, (next) => next.booking(service));
+    formRevision++;
+    formError = "";
+    await show();
+  }
+
+  async function ticket(id: string, event: unknown, available: unknown): Promise<void> {
+    syncSession();
+    reference = id ? { kind: options.kind, id } : undefined;
+    metadata = availableTicketAttendanceOf(event, available);
+    selectForm(id, (next) => next.event((event as { form?: unknown } | undefined)?.form));
+    formRevision++;
+    formError = "";
+    await show();
+  }
+
+  function selectForm(id: string, initialize: (next: ReturnType<typeof createAttendanceForm>) => void): void {
+    const key = `${options.kind}:${id}`;
+    const retained = submittedForms.get(key);
+    form = retained ?? createAttendanceForm(prefix);
+    if (!retained) initialize(form);
+  }
+
+  function fields(selected = true, publishPoll = true): AttendancePurchaseFields {
+    syncSession();
+    if (!reference || !metadata) return ATTENDANCE_INITIAL;
+    const currency = metadata.currency ?? "";
+    const classified = classifyForApple(metadata, currency);
+    const candidate = platform === "ios" && classified === "appleIap";
+    const price = iapPriceFields(commerce.pricing.view(reference), iapPriceCopy(prefix));
+    const copy = { ...iapPurchaseCopy(prefix), buy: copyParam(`${prefix}.appleBuyCta`, options.kind === "bookingsService" ? "Book with Apple" : "Buy ticket with Apple"), buyAnother: copyParam(`${prefix}.buyAnotherCta`, options.kind === "bookingsService" ? "Book again" : "Buy another ticket") };
+    const purchase = commerce.purchaseFields(reference, copy);
+    const apple = candidate || (platform === "ios" && classified !== "wixPayments" && purchase.appleRoute);
+    const enabled = attendanceCheckoutRoute(metadata, currency, platform) === "appleIap";
+    const poll = publishPoll ? commerce.pollDirective(options.pollAction) : undefined;
+    const state = commerce.state();
+    for (const [target, attempt] of attempts) {
+      const key = `${reference.kind}:${reference.id}#${encodeURIComponent(attempt)}`;
+      if ((state.phase === "accessReady" && state.item === key) || state.payments.some((p) => p.item === key && p.access === "granted")) attempts.delete(target);
+    }
+    const formKey = `${reference.kind}:${reference.id}`;
+    if (![...attempts.keys()].some((target) => target.startsWith(`${formKey}:`))) submittedForms.delete(formKey);
+    const own = state.item?.startsWith(`${reference.kind}:${reference.id}#`);
+    const completed = state.phase === "accessReady" && own;
+    const member = session.current().kind === "member";
+    let note = "";
+    if (apple && !enabled) note = copy.unavailable;
+    else if (apple && !member) note = copy.signInRequired;
+    else if (apple && purchase.buyNote) note = purchase.buyNote;
+    else if (apple && !form.supported()) note = copyParam(`${prefix}.formUnavailableText`, "This registration form is not supported yet.");
+    else if (apple && completed) note = copyParam(`${prefix}.purchaseCompleteText`, options.kind === "bookingsService" ? "Your booking is confirmed." : "Your ticket is confirmed.");
+    else if (apple && own && state.phase === "cancelled") note = copyParam(`${prefix}.purchaseCancelledText`, "Purchase cancelled. Your place is not confirmed.");
+    return {
+      iapBuyHidden: !apple, iapBuyDisabled: !enabled || !selected || !member || !form.supported() || purchase.buyDisabled || inFlight,
+      iapBuyLabel: purchase.buyLabel || copy.buy, iapBusy: purchase.buyBusy || inFlight,
+      iapPrice: apple ? price.priceText : "", iapRetryHidden: !apple || (price.hidePriceRetry && commerce.scopeComplete()),
+      iapNote: note,
+      iapFormHidden: !apple || !selected || !form.supported(), iapFormError: formError,
+      iapSignInHidden: !apple || member || options.kind === "bookingsService",
+      iapFields: form.rows().map((f, index, rows) => ({ ...f,
+        id: `${generation}:${formRevision}:${f.id}`, fieldId: f.id,
+        errorHidden: !f.error,
+        options: f.options.map((o) => ({ ...o, fieldId: f.id, displayLabel: (f.kind === "multiple" ? f.selectedIds.includes(o.id) : f.value === o.id) ? `${o.label} ✓` : o.label })),
+        label: f.required ? `${f.label} *` : f.label,
+        inputLabel: copyTemplate(`${prefix}.fieldAccessibilityLabel`, "{section}: {field}", { section: f.id.startsWith("buyer:") ? copyParam(`${prefix}.buyerDetailsLabel`, "Buyer details") : copyParam(`${prefix}.guestDetailsLabel`, "Ticket holder details"), field: f.label }),
+        sectionLabel: index === 0 ? copyParam(`${prefix}.buyerDetailsLabel`, "Buyer details") : f.id.startsWith("guest:") && rows[index - 1].id.startsWith("buyer:") ? copyParam(`${prefix}.guestDetailsLabel`, "Ticket holder details") : "",
+      })), ...(poll ? { _poll: poll } : {}),
+    };
+  }
+
+  async function buy(selection: { key: string; slot?: Record<string, unknown>; eventId?: string }): Promise<void> {
+    syncSession();
+    if (!reference || !metadata || fields(true, false).iapBuyDisabled || inFlight) return;
+    if (options.kind === "eventsTicket" && reference.id !== selection.key) return;
+    if (!form.validate()) { formError = copyParam(`${prefix}.formRequiredText`, "Complete the required details before purchasing."); return; }
+    if (session.current().kind !== "member") { formError = iapPurchaseCopy(prefix).signInRequired; return; }
+    const currentGeneration = generation;
+    const ref = reference;
+    submittedForms.set(`${ref.kind}:${ref.id}`, form);
+    const target = `${ref.kind}:${ref.id}:${selection.key}`;
+    let attemptId = attempts.get(target);
+    const state = commerce.state();
+    const attemptKey = attemptId ? `${ref.kind}:${ref.id}#${encodeURIComponent(attemptId)}` : "";
+    const completed = attemptId && ((state.phase === "accessReady" && state.item === attemptKey) || state.payments.some((p) => p.item === attemptKey && p.access === "granted"));
+    if (!attemptId || completed) { attemptId = `${Date.now().toString(36)}-${++sequence}-${Math.random().toString(36).slice(2)}`; attempts.set(target, attemptId); }
+    const item: IapOrderItem = { reference: ref, attemptId, quantity: 1, attendance: {
+      amount: metadata.amount!, currency: metadata.currency!,
+      ...(options.kind === "bookingsService" ? { booking: { slot: selection.slot ?? {}, contactDetails: form.buyer() } } : { ticket: { eventId: selection.eventId ?? "", ...form.ticket(ref.id) } }),
+    } };
+    inFlight = true;
+    formError = "";
+    options.onChange();
+    try {
+      await commerce.buy(item);
+      const after = commerce.state();
+      if (after.phase === "accessReady" && after.item === `${ref.kind}:${ref.id}#${encodeURIComponent(attemptId)}`) attempts.delete(target);
+    }
+    finally { inFlight = false; syncSession(); if (generation !== currentGeneration) form.clear(); options.onChange(); }
+  }
+
+  function change(arg: unknown): void {
+    syncSession();
+    const state = commerce.state();
+    if (reference) {
+      for (const [target, attempt] of attempts) {
+        const item = `${reference.kind}:${reference.id}#${encodeURIComponent(attempt)}`;
+        const canCorrect = state.phase === "cancelled" || (state.phase === "refused" && (state.failure === "orderRefused" || state.failure === "productChanged"));
+        if (canCorrect && state.item === item) { attempts.delete(target); submittedForms.delete(`${reference.kind}:${reference.id}`); }
+      }
+      const referencePrefix = `${reference.kind}:${reference.id}:`;
+      if (inFlight || [...attempts.keys()].some((target) => target.startsWith(referencePrefix))) {
+        formError = copyParam(`${prefix}.detailsLockedText`, "Finish the current purchase before changing registration details.");
+        return;
+      }
+    }
+    form.change(arg);
+    formError = "";
+  }
+
+  return {
+    booking, ticket, fields, buy,
+    usesRegularPlatform: () => platform === "android" || platform === "web",
+    invalidate: () => { reference = undefined; metadata = undefined; options.onChange(); },
+    change,
+    refresh,
+    poll: async () => { syncSession(); await commerce.poll(); },
+  };
+}

package/templates/branded-lite/tier5-src/_shared/iap-attendance.ts

@@ -0,0 +1,38 @@
+import { get as appInfo } from "@himalaya/app-info";
+import { attendanceCheckoutRoute, bookingAttendanceOf, ticketAttendanceOf } from "@himalaya/iap";
+
+let knownPlatform: string | undefined;
+
+export function attendancePlatform(onResolved?: (platform: string) => void): Promise<string> {
+  if (knownPlatform) return Promise.resolve(knownPlatform);
+  const info = appInfo().then((value) => value.platform, () => "unknown").then((platform) => {
+    if (platform !== "unknown") knownPlatform = platform;
+    return platform;
+  });
+  const host = globalThis as { setTimeout?: (fn: () => void, ms: number) => unknown; clearTimeout?: (timer: unknown) => void };
+  if (!host.setTimeout) {
+    void info.then((platform) => onResolved?.(platform));
+    return Promise.resolve("unknown");
+  }
+  return new Promise((resolve) => {
+    let timedOut = false;
+    const timer = host.setTimeout!(() => { timedOut = true; resolve("unknown"); }, 1500);
+    void info.then((platform) => { host.clearTimeout?.(timer); resolve(platform); if (timedOut) onResolved?.(platform); });
+  });
+}
+
+export async function mayUseRegularBookingCheckout(service: unknown): Promise<boolean> {
+  const metadata = bookingAttendanceOf(service);
+  if (metadata.priceType === "NO_FEE" || isZero(metadata.amount)) return true;
+  return attendanceCheckoutRoute(metadata, metadata.currency ?? "", await attendancePlatform()) === "regular";
+}
+
+export async function mayUseRegularTicketCheckout(event: unknown, ticket: { free?: boolean; price?: { amount?: string; currency?: string }; saleStatus?: string } | undefined): Promise<boolean> {
+  if (ticket?.free === true || isZero(ticket?.price?.amount)) return true;
+  const metadata = ticketAttendanceOf(event, { hidden: false, saleStatus: ticket?.saleStatus });
+  return attendanceCheckoutRoute(metadata, ticket?.price?.currency ?? "", await attendancePlatform()) === "regular";
+}
+
+function isZero(value: unknown): boolean {
+  return typeof value === "string" && /^0+(?:\.0+)?$/.test(value);
+}

package/templates/branded-lite/tier5-src/business-chat/index.ts

@@ -14,6 +14,7 @@ type PendingIntent = BusinessChatIntent;
 // parts, plain text or text runs: they would be re-sent each time for nothing.
 type BusinessMessageRow = Pick<MessageRow,'id'|'sender'|'when'|'createdDate'|'mine'> & {
  senderAvatar:string; senderName:string; senderInitials:string; senderBadge:string; imageUrl:string; imageDescription:string; noImage:boolean; bodyText:string; bodyMarkdown:string; suggestions:BusinessSuggestion[]; articleActions:{id:string;label:string;url:string;style:'primary'|'secondary'}[]; couponCode:string; noCoupon:boolean; notMine:boolean;
+ isCard:boolean; notCard:boolean; noSuggestions:boolean; noActions:boolean; cardTitle:string; cardDetail:string; noCardText:boolean;
  dayLabel:string; dayHidden:boolean; startsDay:boolean; scrollAnchor:string;
  /** Only the member's own row that the server has not returned yet. */
  pending?:boolean;
@@ -67,7 +68,7 @@ function pendingRow(intent:BusinessChatIntent):BusinessMessageRow{
  const when=intent.delivery==='sending'?'Sending…':intent.delivery==='unconfirmed'?'Not confirmed':messageTimeLabel(intent.createdDate);
  return {id:intent.id,sender:'',when,createdDate:intent.createdDate,mine:true,
   senderAvatar:'',senderName:intent.senderName??'',senderInitials:'',senderBadge:'',imageUrl:'',imageDescription:'',noImage:true,bodyText:intent.text,bodyMarkdown:intent.text,
-  suggestions:[],articleActions:[],couponCode:'',noCoupon:true,notMine:false,dayLabel:'',dayHidden:true,startsDay:false,scrollAnchor:`himi_business_chat.message_${intent.id}`,pending:true};
+  suggestions:[],articleActions:[],couponCode:'',noCoupon:true,notMine:false,isCard:false,notCard:true,noSuggestions:true,noActions:true,cardTitle:'',cardDetail:'',noCardText:true,dayLabel:'',dayHidden:true,startsDay:false,scrollAnchor:`himi_business_chat.message_${intent.id}`,pending:true};
 }
 function shape(s:State):State{const used=new Set(s.usedSuggestionIds);const messages=s.messages.map(row=>({...row,suggestions:(row.suggestions||[]).map(button=>used.has(button.id)?{...button,enabled:false,disabled:true}:button)}));const quickReplies=(s.quickReplies||[]).map(button=>used.has(button.id)?{...button,enabled:false,disabled:true}:button);const quickEnabled=quickReplies.some(button=>button.enabled);return {...s,messages,quickReplies,hasQuickReplies:quickEnabled,noQuickReplies:!quickEnabled,scrollAnchor:messages[messages.length-1]?.scrollAnchor||'',liveLabel:liveDescription(s.liveState,s.liveReason),hasActiveRoom:!!s.roomId,noActiveRoom:!s.roomId,hasHostedName:!!s.hostedName,noHostedName:!s.hostedName,isGuest:s.phase==='guest',notGuest:s.phase!=='guest',realtimeDiagnostic:`state=${s.liveState}; reason=${s.liveReason||'none'}; events=${s.realtimeEventCount}; lastType=${/^(message|messagesent)$/i.test(s.lastRealtimeEventType)?s.lastRealtimeEventType:'none'}`,errorText:s.error,loadingHidden:s.phase!=='loading'||!!s.error,noError:!s.error,noNotice:!s.notice,noMessages:!messages.length,hasMessages:!!messages.length,noEmpty:s.phase!=='ready'||!!messages.length,
   notLoading:s.phase!=='loading',sendDisabled:!canSend(s,s.draft),sendEnabled:canSend(s,s.draft),noLive:!s.roomId||s.liveState==='connected'};}
@@ -131,7 +132,7 @@ function productImageFor(slug:string,name:string):Promise<string>{
 }
 function slimRow(row:Record<string,unknown>):BusinessMessageRow{
  const pick=(...keys:string[])=>Object.fromEntries(keys.map(key=>[key,row[key]]));
- return pick('id','sender','when','createdDate','mine','senderAvatar','senderName','senderInitials','senderBadge','imageUrl','imageDescription','noImage','bodyText','bodyMarkdown','suggestions','articleActions','couponCode','noCoupon','notMine','dayLabel','dayHidden','startsDay','scrollAnchor') as unknown as BusinessMessageRow;
+ return pick('id','sender','when','createdDate','mine','senderAvatar','senderName','senderInitials','senderBadge','imageUrl','imageDescription','noImage','bodyText','bodyMarkdown','suggestions','articleActions','couponCode','noCoupon','notMine','isCard','notCard','noSuggestions','noActions','cardTitle','cardDetail','noCardText','dayLabel','dayHidden','startsDay','scrollAnchor') as unknown as BusinessMessageRow;
 }
 async function presentMessages(existing:MessageRow[],raw:unknown[],memberId?:string):Promise<BusinessMessageRow[]>{
  const rows=chronologicalMessages(existing,raw,memberId) as MessageRow[];