@wix/himalaya-cli 0.1492.0 → 0.1494.0

package/templates/podcast-creator/tier5-src/himi-branded-lite-place-summary/index.ts

@@ -0,0 +1,208 @@
+// Tier-5 bundle: himi-branded-lite-place-summary — the member's place at a glance.
+//
+// A compact screen a host embeds at a tile height (a Home tile, a collapsed bar above a chat):
+// the member's next booking, their active plan and ONE primary action. Stable host entry point
+// `himi_place_summary` (README → Embedded in a host app). It reuses the reads My bookings
+// (`_shared/member-bookings.ts`) and the plan entitlement (`listMyPlanOrders`) already make, and
+// adds none of its own.
+//
+// `load` is both the onAppear action and what an embed controller's `refresh()` runs (arg-less:
+// the stashed appear params keep the verticals and the copy pack), so a host that hears
+// `booking.created` / `booking.cancelled` re-reads the summary without a remount.
+import { defineService } from "@himalaya/state";
+import { listMyPlanOrders, type WixPlanOrder } from "@himalaya/wix-pricing-plans";
+import { fetchMemberBookings, type MemberBookingRow } from "../_shared/member-bookings.js";
+import { memberAccess, assertMemberAccess, memberAccessDenied, type MemberAccess } from "../_shared/member-access.js";
+import { hostSiteFromInput } from "../_shared/branded-lite-hosted.js";
+import { formatDateMedium } from "../_shared/engine-intl.js";
+import { copyParam, copyTemplate, stashCopy } from "../_shared/himi-copy.js";
+
+export interface PlaceSummaryState {
+  status: "loading" | "ready" | "error";
+  isLoading: boolean;
+  notLoading: boolean;
+  hasBooking: boolean;
+  noBooking: boolean;
+  bookingId: string;
+  bookingDay: string;
+  bookingTitle: string;
+  bookingWhen: string;
+  /** The booking row's whole spoken label: the row's label replaces its children. */
+  bookingA11y: string;
+  hasPlan: boolean;
+  noPlan: boolean;
+  planName: string;
+  planDetail: string;
+  /** The one-line state shown instead of a booking and a plan: empty, guest or load failure. */
+  hasMessage: boolean;
+  noMessage: boolean;
+  messageTitle: string;
+  messageBody: string;
+  errored: boolean;
+  notErrored: boolean;
+  ctaLabel: string;
+  ctaScreenId: string;
+  /** `himi_sign_in`'s mode for a guest's Sign in; "" for every other action. */
+  ctaMode: string;
+  hideCta: boolean;
+}
+
+const BOOKINGS_SCREEN = "himi_services";
+const PLANS_SCREEN = "himi_plans";
+const SIGN_IN_SCREEN = "himi_sign_in";
+
+let stashedVerticals: string[] | null = null;
+let generation = 0;
+
+function appearVerticals(arg: unknown): string[] {
+  const raw = arg && typeof arg === "object" ? (arg as Record<string, unknown>).verticals : undefined;
+  if (typeof raw === "string") {
+    try {
+      const parsed = JSON.parse(raw) as unknown;
+      if (Array.isArray(parsed)) stashedVerticals = parsed.filter((v): v is string => typeof v === "string");
+    } catch { /* keep the last good list */ }
+  }
+  return stashedVerticals ?? ["bookings", "plans"];
+}
+
+/** The verticals this summary reads: the build's, narrowed to the host's site when a host
+ *  opened a hosted build for one. Native core always writes `__himiHostSite` — `""` when not
+ *  hosted — so absent or `""` is a deep entry (the build's verticals); anything else is a host's
+ *  site, and one that does not parse installs nothing (fail closed, `readHostedSite`). */
+export function summaryVerticals(buildVerticals: string[], input: unknown): { bookings: boolean; plans: boolean } {
+  const build = new Set(buildVerticals);
+  const raw = input && typeof input === "object" ? (input as Record<string, unknown>).__himiHostSite : undefined;
+  const hosted = raw !== undefined && raw !== null && raw !== "";
+  const installed = hosted ? new Set(hostSiteFromInput(input)?.installedVerticals ?? []) : build;
+  return { bookings: build.has("bookings") && installed.has("bookings"), plans: build.has("plans") && installed.has("plans") };
+}
+
+/** The member's next upcoming booking, earliest first, or null. */
+export function nextBooking(rows: MemberBookingRow[], now: number): MemberBookingRow | null {
+  return rows
+    .filter((row) => Date.parse(row.start) > now && !["CANCELED", "CANCELLED", "DECLINED"].includes(row.status))
+    .sort((a, b) => Date.parse(a.start) - Date.parse(b.start))[0] ?? null;
+}
+
+/** The plan line: the active plan's name and when its current term ends. A member cannot read
+ *  their remaining sessions or credits (Benefit Programs balances are APP-identity only), so the
+ *  line names the plan and its term rather than inventing a count. */
+export function planLine(orders: WixPlanOrder[]): { name: string; detail: string } | null {
+  const active = orders.filter((o) => (o.status ?? "").toUpperCase() === "ACTIVE" && o.planName);
+  const first = active[0];
+  if (!first) return null;
+  // An order that will end (a fixed term, a cancel at period end, the last cycle) is valid
+  // until its end; only an open-ended recurring order renews at its cycle's end.
+  const ends = [first.earliestEndDate, first.endDate].filter((d): d is string => !!d && Number.isFinite(Date.parse(d)));
+  const end = ends.sort((a, b) => Date.parse(a) - Date.parse(b))[0] ?? "";
+  const recurring = !end && !!first.currentCycle?.endedDate;
+  const until = end || first.currentCycle?.endedDate || "";
+  const when = until && Number.isFinite(Date.parse(until)) ? formatDateMedium(new Date(until)) : "";
+  let detail = when
+    ? recurring
+      ? copyTemplate("placeSummary.planRenews", "Renews {date}", { date: when })
+      : copyTemplate("placeSummary.planUntil", "Valid until {date}", { date: when })
+    : copyParam("placeSummary.planActive", "Active");
+  if (active.length > 1) detail = `${detail} · ${copyTemplate("placeSummary.planMore", "+{count} more", { count: active.length - 1 })}`;
+  return { name: first.planName ?? "", detail };
+}
+
+function derive(s: PlaceSummaryState): PlaceSummaryState {
+  return {
+    ...s,
+    isLoading: s.status === "loading",
+    notLoading: s.status !== "loading",
+    noBooking: !s.hasBooking,
+    noPlan: !s.hasPlan,
+    noMessage: !s.hasMessage,
+    notErrored: !s.errored,
+    hideCta: s.status === "loading" || s.errored || !s.ctaScreenId,
+  };
+}
+
+const BLANK: PlaceSummaryState = derive({
+  status: "loading", isLoading: true, notLoading: false,
+  hasBooking: false, noBooking: true, bookingId: "", bookingDay: "", bookingTitle: "", bookingWhen: "", bookingA11y: "",
+  hasPlan: false, noPlan: true, planName: "", planDetail: "",
+  hasMessage: false, noMessage: true, messageTitle: "", messageBody: "",
+  errored: false, notErrored: true, ctaLabel: "", ctaScreenId: "", ctaMode: "", hideCta: true,
+});
+
+function message(title: string, body: string): Partial<PlaceSummaryState> {
+  return { hasMessage: true, messageTitle: title, messageBody: body };
+}
+
+async function read(arg: unknown, again = true): Promise<PlaceSummaryState> {
+  const input = (globalThis as { himalaya?: { input?: unknown } }).himalaya?.input;
+  const verticals = summaryVerticals(appearVerticals(arg), input);
+  const browse = verticals.bookings
+    ? { ctaLabel: copyParam("placeSummary.browseCta", "Browse classes"), ctaScreenId: BOOKINGS_SCREEN }
+    : verticals.plans
+      ? { ctaLabel: copyParam("placeSummary.plansCta", "See plans"), ctaScreenId: PLANS_SCREEN }
+      : { ctaLabel: "", ctaScreenId: "" };
+  const member: MemberAccess = await memberAccess();
+  if (!member.email) {
+    return derive({ ...BLANK, status: "ready",
+      ...message(copyParam("placeSummary.guestTitle", "Sign in to see your bookings"),
+        copyParam("placeSummary.guestBody", "Your next class and plan show up here.")),
+      ctaLabel: copyParam("placeSummary.signInCta", "Sign in"), ctaScreenId: SIGN_IN_SCREEN, ctaMode: "signin" });
+  }
+  const now = Date.now();
+  const [bookings, plans] = await Promise.allSettled([
+    verticals.bookings
+      ? fetchMemberBookings({ query: "", filter: "value:Upcoming", sort: "default", savedIds: [] }, "", new Date(now).toISOString(), member)
+      : Promise.resolve({ items: [] as MemberBookingRow[] }),
+    verticals.plans ? listMyPlanOrders({ statuses: ["ACTIVE"], limit: 50 }) : Promise.resolve({ orders: [] as WixPlanOrder[] }),
+  ]);
+  // The member changed mid-read (signed out, another account): nothing of the old one shows;
+  // read once more for whoever is signed in now.
+  try { await assertMemberAccess(member); } catch { return again ? read(arg, false) : derive({ ...BLANK, status: "ready" }); }
+  const booking = bookings.status === "fulfilled" ? nextBooking(bookings.value.items, now) : null;
+  // A 401/403 on the plan read is a member with no plan access, not a failure to show.
+  const plan = plans.status === "fulfilled" ? planLine(plans.value.orders ?? []) : null;
+  const bookingFailed = bookings.status === "rejected";
+  const planFailed = plans.status === "rejected" && !memberAccessDenied(plans.reason);
+  const base: PlaceSummaryState = { ...BLANK, status: "ready",
+    hasBooking: !!booking, bookingId: booking?.id ?? "", bookingDay: booking?.day ?? "",
+    bookingTitle: booking?.title ?? "", bookingWhen: booking?.subtitle ?? "",
+    bookingA11y: booking ? [copyParam("placeSummary.nextBooking", "Next booking"), booking.title, booking.subtitle].filter(Boolean).join(", ") : "",
+    hasPlan: !!plan, planName: plan?.name ?? "", planDetail: plan?.detail ?? "" };
+  if (!booking && !plan && (bookingFailed || planFailed)) {
+    return derive({ ...base, status: "error", errored: true,
+      ...message(copyParam("placeSummary.errorTitle", "Couldn't load your summary"),
+        copyParam("placeSummary.errorBody", "We couldn't reach the site. Try again in a moment.")) });
+  }
+  if (!booking && !plan) {
+    return derive({ ...base, ...browse,
+      ...message(copyParam("placeSummary.emptyTitle", "Nothing booked yet"),
+        verticals.bookings
+          ? copyParam("placeSummary.emptyBody", "Find a class that fits your week.")
+          : copyParam("placeSummary.emptyPlansBody", "Pick a plan to get started.")) });
+  }
+  return derive({ ...base,
+    ...(verticals.bookings
+      ? { ctaLabel: copyParam("placeSummary.bookCta", "Book"), ctaScreenId: BOOKINGS_SCREEN }
+      : browse) });
+}
+
+/** One read at a time wins: a refresh that lands while an older load is still out replaces it,
+ *  and the older one's answer is dropped — `undefined`, not its starting state, which would
+ *  write back over the newer result. */
+async function load(_s: PlaceSummaryState, arg?: unknown): Promise<PlaceSummaryState | undefined> {
+  stashCopy(arg);
+  const mine = ++generation;
+  const next = await read(arg);
+  return mine === generation ? next : undefined;
+}
+
+const svc = defineService<PlaceSummaryState, {
+  load: (s: PlaceSummaryState, arg?: unknown) => Promise<PlaceSummaryState | undefined>;
+  retry: (s: PlaceSummaryState) => Promise<PlaceSummaryState | undefined>;
+}>("himiPlaceSummary", {
+  state: BLANK,
+  actions: {
+    load,
+    retry: (s) => load(s),
+  },
+});
+export { svc };

package/templates/podcast-creator/tokens.json

@@ -109,6 +109,12 @@
     "xl": 24
   },
   "typography": {
+    "pageTitle": {
+      "size": 28,
+      "weight": 400,
+      "line": 1.25,
+      "letterSpacing": 0
+    },
     "title1": {
       "size": 26,
       "weight": 400,

package/templates/portfolio-creative/tier5-src/_shared/branded-lite-hosted.ts

@@ -112,6 +112,7 @@ export const HOSTED_SCREEN_VERTICALS: Readonly<Record<string, readonly BrandedLi
   himi_notifications: ["notifications"],
   himi_orders: ["store"],
   himi_photo_album: ["galleries"],
+  himi_place_summary: ["bookings", "plans"],
   himi_plan: ["plans"],
   himi_plans: ["plans"],
   himi_podcast: ["podcasts"],

package/templates/portfolio-creative/tier5-src/_shared/wix-service-price.ts

@@ -99,6 +99,24 @@ export function serviceIsChargeable(service: unknown): boolean {
   return amount != null && amount > 0;
 }
 
+/**
+ * Format one Bookings v2 Money value (`{ value, currency }`, `value` a decimal string) — a
+ * price, a deposit, a VARIED minimum, a cancellation fee. A whole amount drops its cents
+ * ("₪90", not "₪90.00"), as the service screen shows it. "" when it carries no usable
+ * amount. The currency comes from the Money itself, then from `fallbackCurrency`.
+ */
+export function formatServiceMoney(money: unknown, fallbackCurrency = "USD"): string {
+  const m = (money ?? {}) as { value?: unknown; amount?: unknown; currency?: unknown };
+  const amount = numberOf(m.value ?? m.amount);
+  if (amount == null) return "";
+  const currency = stringOf(m.currency) || fallbackCurrency;
+  try {
+    return formatCurrency(amount, currency, "en", Number.isInteger(amount) ? 0 : undefined);
+  } catch {
+    return `${amount}`;
+  }
+}
+
 /**
  * Format a Wix Bookings service's price for display, e.g. "₪111" / "$20".
  *

package/templates/portfolio-creative/tokens.json

@@ -109,6 +109,12 @@
     "xl": 24
   },
   "typography": {
+    "pageTitle": {
+      "size": 28,
+      "weight": 400,
+      "line": 1.25,
+      "letterSpacing": 0
+    },
     "title1": {
       "size": 30,
       "weight": 400,

package/templates/restaurant/tier5-src/_shared/branded-lite-hosted.ts

@@ -112,6 +112,7 @@ export const HOSTED_SCREEN_VERTICALS: Readonly<Record<string, readonly BrandedLi
   himi_notifications: ["notifications"],
   himi_orders: ["store"],
   himi_photo_album: ["galleries"],
+  himi_place_summary: ["bookings", "plans"],
   himi_plan: ["plans"],
   himi_plans: ["plans"],
   himi_podcast: ["podcasts"],

package/templates/restaurant/tier5-src/_shared/wix-service-price.ts

@@ -99,6 +99,24 @@ export function serviceIsChargeable(service: unknown): boolean {
   return amount != null && amount > 0;
 }
 
+/**
+ * Format one Bookings v2 Money value (`{ value, currency }`, `value` a decimal string) — a
+ * price, a deposit, a VARIED minimum, a cancellation fee. A whole amount drops its cents
+ * ("₪90", not "₪90.00"), as the service screen shows it. "" when it carries no usable
+ * amount. The currency comes from the Money itself, then from `fallbackCurrency`.
+ */
+export function formatServiceMoney(money: unknown, fallbackCurrency = "USD"): string {
+  const m = (money ?? {}) as { value?: unknown; amount?: unknown; currency?: unknown };
+  const amount = numberOf(m.value ?? m.amount);
+  if (amount == null) return "";
+  const currency = stringOf(m.currency) || fallbackCurrency;
+  try {
+    return formatCurrency(amount, currency, "en", Number.isInteger(amount) ? 0 : undefined);
+  } catch {
+    return `${amount}`;
+  }
+}
+
 /**
  * Format a Wix Bookings service's price for display, e.g. "₪111" / "$20".
  *

package/templates/restaurant/tokens.json

@@ -109,6 +109,12 @@
     "xl": 24
   },
   "typography": {
+    "pageTitle": {
+      "size": 28,
+      "weight": 400,
+      "line": 1.25,
+      "letterSpacing": 0
+    },
     "title1": {
       "size": 26,
       "weight": 400,

package/templates/retail-store/tier5-src/_shared/branded-lite-hosted.ts

@@ -112,6 +112,7 @@ export const HOSTED_SCREEN_VERTICALS: Readonly<Record<string, readonly BrandedLi
   himi_notifications: ["notifications"],
   himi_orders: ["store"],
   himi_photo_album: ["galleries"],
+  himi_place_summary: ["bookings", "plans"],
   himi_plan: ["plans"],
   himi_plans: ["plans"],
   himi_podcast: ["podcasts"],

package/templates/retail-store/tier5-src/_shared/wix-service-price.ts

@@ -99,6 +99,24 @@ export function serviceIsChargeable(service: unknown): boolean {
   return amount != null && amount > 0;
 }
 
+/**
+ * Format one Bookings v2 Money value (`{ value, currency }`, `value` a decimal string) — a
+ * price, a deposit, a VARIED minimum, a cancellation fee. A whole amount drops its cents
+ * ("₪90", not "₪90.00"), as the service screen shows it. "" when it carries no usable
+ * amount. The currency comes from the Money itself, then from `fallbackCurrency`.
+ */
+export function formatServiceMoney(money: unknown, fallbackCurrency = "USD"): string {
+  const m = (money ?? {}) as { value?: unknown; amount?: unknown; currency?: unknown };
+  const amount = numberOf(m.value ?? m.amount);
+  if (amount == null) return "";
+  const currency = stringOf(m.currency) || fallbackCurrency;
+  try {
+    return formatCurrency(amount, currency, "en", Number.isInteger(amount) ? 0 : undefined);
+  } catch {
+    return `${amount}`;
+  }
+}
+
 /**
  * Format a Wix Bookings service's price for display, e.g. "₪111" / "$20".
  *

package/templates/retail-store/tokens.json

@@ -109,6 +109,12 @@
     "xl": 24
   },
   "typography": {
+    "pageTitle": {
+      "size": 28,
+      "weight": 400,
+      "line": 1.25,
+      "letterSpacing": 0
+    },
     "title1": {
       "size": 28,
       "weight": 400,