@wix/himalaya-cli 0.1499.0 → 0.1501.0

package/dist/cli.mjs

@@ -2576,10 +2576,11 @@ __export(splash_exports, {
 import { existsSync as existsSync3, readFileSync as readFileSync4, readdirSync as readdirSync3 } from "node:fs";
 import { dirname as dirname4, join as join5 } from "node:path";
 function parseSplashConfig(configTs) {
-  const block = /splash\s*[:=]\s*\{([^}]*)\}/.exec(configTs);
+  const block = /["']?splash["']?\s*[:=]\s*\{([^}]*)\}/.exec(configTs);
   if (!block) return {};
-  const backgroundColor = /backgroundColor\s*:\s*["']([^"']+)["']/.exec(block[1])?.[1];
-  return backgroundColor ? { backgroundColor } : {};
+  const backgroundColor = /["']?backgroundColor["']?\s*:\s*["']([^"']+)["']/.exec(block[1])?.[1];
+  const logoAsset = /["']?logoAsset["']?\s*:\s*["']([^"']*)["']/.exec(block[1])?.[1];
+  return { ...backgroundColor ? { backgroundColor } : {}, ...logoAsset !== void 0 ? { logoAsset } : {} };
 }
 function nativeConfigInputTokens(configTs) {
   const declared = configTs ? parseSplashConfig(configTs).backgroundColor : void 0;
@@ -22149,6 +22150,7 @@ function resolveIdiom(tokens2, ctx = {}) {
 var IDIOM_CONTEXTS, UNSAFE_KEYS;
 var init_idiom = __esm({
   "../../core/ts/src/idiom.ts"() {
+    "use strict";
     IDIOM_CONTEXTS = {
       ios: { native: ["ios"] },
       android: { native: ["material"] },
@@ -147009,7 +147011,7 @@ var init_template_trim = __esm({
       return Array.isArray(items) ? items : void 0;
     };
     NAV_SCREEN_KEYS = /* @__PURE__ */ new Set(["screenId", "parentScreenId", "contentScreenId", "badgeScreenId"]);
-    WORKER_SCREEN_PARAMS = /* @__PURE__ */ new Set(["signInScreen"]);
+    WORKER_SCREEN_PARAMS = /* @__PURE__ */ new Set(["signInScreen", "productScreen", "serviceScreen"]);
     sorted = (xs2) => [...new Set(xs2)].sort();
     refuse3 = (e2) => ({ code: 2, result: { ok: false, error: e2.message, ...e2.detail } });
     plural = (n2, word) => `${n2} ${word}${n2 === 1 ? "" : "s"}`;

package/guides/sdk-reference.json

@@ -1987,7 +1987,7 @@
         "name": "IAP_CATALOG_KINDS",
         "kind": "const",
         "jsdoc": "/** The Wix entity types `himi store iap` writes into its Wix→Apple mapping, so a mapping\n *  backend can serve that export without translating kinds. */",
-        "decl": "export const IAP_CATALOG_KINDS = [\"onlineProgram\", \"storesProduct\", \"pricingPlan\", \"bookingsService\", \"eventsTicket\"] as const;"
+        "decl": "export const IAP_CATALOG_KINDS = [\"onlineProgram\", \"storesProduct\", \"pricingPlan\"] as const;"
       },
       {
         "name": "IapCatalogKind",
@@ -2119,19 +2119,7 @@
         "name": "AppleSaleRule",
         "kind": "interface",
         "jsdoc": "/** How the App Store sells one vertical's Wix item: the purchases catalog's `appProductId` for it, and\n *  the only product type the purchase flow sells it as. */",
-        "decl": "export interface AppleSaleRule {\n  appProductId(entityId: string): string;\n  productType: \"NON_CONSUMABLE\" | \"CONSUMABLE\";\n}"
-      },
-      {
-        "name": "BOOKINGS_APPLE_SALES_ENABLED",
-        "kind": "const",
-        "jsdoc": "",
-        "decl": "export const BOOKINGS_APPLE_SALES_ENABLED = false;"
-      },
-      {
-        "name": "EVENTS_APPLE_SALES_ENABLED",
-        "kind": "const",
-        "jsdoc": "",
-        "decl": "export const EVENTS_APPLE_SALES_ENABLED = false;"
+        "decl": "export interface AppleSaleRule {\n  appProductId(entityId: string): string;\n  productType: \"NON_CONSUMABLE\";\n}"
       },
       {
         "name": "STORES_ITEM_PAYMENT_ENABLED",
@@ -2157,17 +2145,11 @@
         "jsdoc": "/** One-time unlimited plans sell through the App Store. Proven live in Sandbox on 2026-10-19: a member's\n *  online plan order is charged with one cashier item whose id is the plan id, so StartPayment maps it to the\n *  plan's Apple product, and the order reads ACTIVE and PAID. Recurring and time-limited plans stay outside\n *  this rule; their Billing lifecycle is unfinished. */",
         "decl": "export const PRICING_PLAN_APPLE_SALES_ENABLED = true;"
       },
-      {
-        "name": "AppleSaleOptions",
-        "kind": "interface",
-        "jsdoc": "/**\n * The one definition `himi store iap connect` writes mappings by and the mapping source reads them by,\n * keyed by catalog kind. wix-iap StartPayment maps the cashier order's single item id, and Online\n * Programs builds that order with the program id as the item id; programs are one-time unlocks.\n * Wix Stores and one-time unlimited Pricing Plans join only with their independent switches.\n */",
-        "decl": "export interface AppleSaleOptions {\n  storesAppleSalesEnabled?: boolean;\n  storesItemPaymentEnabled?: boolean;\n  pricingPlanAppleSalesEnabled?: boolean;\n  bookingsAppleSalesEnabled?: boolean;\n  eventsAppleSalesEnabled?: boolean;\n}"
-      },
       {
         "name": "appleSaleRules",
         "kind": "function",
-        "jsdoc": "/** Resolves runtime sale eligibility independently from the catalog's provisioning support. */",
-        "decl": "export function appleSaleRules(options: AppleSaleOptions = {}): Readonly<Record<string, AppleSaleRule>>;"
+        "jsdoc": "/**\n * The one definition `himi store iap connect` writes mappings by and the mapping source reads them by,\n * keyed by catalog kind. wix-iap StartPayment maps the cashier order's single item id, and Online\n * Programs builds that order with the program id as the item id; programs are one-time unlocks.\n * Wix Stores and one-time unlimited Pricing Plans join only with their independent switches.\n */",
+        "decl": "export function appleSaleRules(options: { storesAppleSalesEnabled?: boolean; storesItemPaymentEnabled?: boolean; pricingPlanAppleSalesEnabled?: boolean } = {}): Readonly<Record<string, AppleSaleRule>>;"
       },
       {
         "name": "APPLE_SALE_RULES",
@@ -2175,12 +2157,6 @@
         "jsdoc": "",
         "decl": "export const APPLE_SALE_RULES = appleSaleRules();"
       },
-      {
-        "name": "APPLE_PROVISIONING_RULES",
-        "kind": "const",
-        "jsdoc": "/** Catalog setup may precede activation; purchases still require the independent sales switches. */",
-        "decl": "export const APPLE_PROVISIONING_RULES: Readonly<Record<string, AppleSaleRule>> = {\n  ...APPLE_SALE_RULES, bookingsService: ATTENDANCE_SALE_RULE, eventsTicket: ATTENDANCE_SALE_RULE,\n};"
-      },
       {
         "name": "HostCallExpectation",
         "kind": "interface",
@@ -2221,7 +2197,7 @@
         "name": "StartPaymentErrorCode",
         "kind": "type",
         "jsdoc": "",
-        "decl": "export type StartPaymentErrorCode = \"NOT_PENDING\" | \"WRONG_PAYMENT_METHOD\" | \"NOT_ORDER_BUYER\" | \"UNSUPPORTED_ORDER\"\n  | \"PRODUCT_NOT_AVAILABLE\" | \"ALREADY_OWNED\" | \"APP_NOT_CONFIGURED\" | \"SUBSCRIPTION_NOT_IN_APP\" | \"ALREADY_SUBSCRIBED\";"
+        "decl": "export type StartPaymentErrorCode = \"NOT_PENDING\" | \"WRONG_PAYMENT_METHOD\" | \"NOT_ORDER_BUYER\" | \"UNSUPPORTED_ORDER\"\n  | \"PRODUCT_NOT_AVAILABLE\" | \"ALREADY_OWNED\";"
       },
       {
         "name": "StartItemPaymentErrorCode",
@@ -2352,54 +2328,6 @@
         "jsdoc": "/** Whether the host fences protected calls to the captured member (`identityBound`). Web does not. */",
         "decl": "export function readIdentityBound(): boolean;"
       },
-      {
-        "name": "AppleAttendanceRoute",
-        "kind": "type",
-        "jsdoc": "",
-        "decl": "export type AppleAttendanceRoute = \"appleIap\" | \"wixPayments\" | \"decide\";"
-      },
-      {
-        "name": "BookingAttendance",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface BookingAttendance extends AttendancePrice {\n  kind: \"bookingsService\";\n  type?: string;\n  capacity?: number;\n  maxParticipantsPerBooking?: number;\n  conferencing?: boolean;\n  locations?: readonly string[];\n  onlineBooking?: boolean;\n  onlinePayment?: boolean;\n  deposit?: boolean;\n}"
-      },
-      {
-        "name": "TicketAttendance",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface TicketAttendance extends AttendancePrice {\n  kind: \"eventsTicket\";\n  location?: string;\n  registration?: string;\n  eventStatus?: string;\n  saleStatus?: string;\n}"
-      },
-      {
-        "name": "classifyForApple",
-        "kind": "function",
-        "jsdoc": "/** Delivery metadata decides the route; online booking and online payment alone never do. */",
-        "decl": "export function classifyForApple(item: BookingAttendance | TicketAttendance, currency: string): AppleAttendanceRoute;"
-      },
-      {
-        "name": "attendanceCheckoutRoute",
-        "kind": "function",
-        "jsdoc": "/** Applies platform support and activation switches without sending uncertain iOS offers to web checkout. */",
-        "decl": "export function attendanceCheckoutRoute(item: BookingAttendance | TicketAttendance, currency: string, platform: string): \"regular\" | \"appleIap\" | \"blocked\";"
-      },
-      {
-        "name": "bookingAttendanceOf",
-        "kind": "function",
-        "jsdoc": "/** Preserves missing Wix service fields as unknown so absent metadata cannot authorize a payment route. */",
-        "decl": "export function bookingAttendanceOf(raw: unknown): BookingAttendance;"
-      },
-      {
-        "name": "ticketAttendanceOf",
-        "kind": "function",
-        "jsdoc": "/** Combines event delivery and ticket-definition pricing metadata for conservative route classification. */",
-        "decl": "export function ticketAttendanceOf(event: unknown, definition: unknown): TicketAttendance;"
-      },
-      {
-        "name": "availableTicketAttendanceOf",
-        "kind": "function",
-        "jsdoc": "/** Reads the buyer-visible checkout projection; hidden/off-sale inclusions and unknown pricing stay unresolved. */",
-        "decl": "export function availableTicketAttendanceOf(event: unknown, ticket: unknown): TicketAttendance;"
-      },
       {
         "name": "ProductType",
         "kind": "type",
@@ -2517,7 +2445,7 @@
       {
         "name": "purchaseForVerification",
         "kind": "function",
-        "jsdoc": "/** Apple consumables and non-consumables. The token comes from authenticated backend context.\n * Leaves the transaction unfinished. Never falls back to legacy purchase on old binaries. */",
+        "jsdoc": "/** Apple non-consumables only. The token comes from authenticated backend context.\n * Leaves the transaction unfinished. Never falls back to legacy purchase on old binaries. */",
         "decl": "export async function purchaseForVerification(input: { productId: string; appAccountToken: string }): Promise<VerificationPurchaseResult>;"
       },
       {
@@ -2579,7 +2507,7 @@
         "name": "\"./iap-verticals/index.js\"",
         "kind": "reexport",
         "jsdoc": "",
-        "decl": "export { onlineProgramOrders, pricingPlanOrders, storesProductOrders, bookingOrders, eventTicketOrders, classifyCart } from \"./iap-verticals/index.js\";"
+        "decl": "export { onlineProgramOrders, pricingPlanOrders, storesProductOrders, classifyCart } from \"./iap-verticals/index.js\";"
       },
       {
         "name": "\"./order-refs.js\"",
@@ -2675,7 +2603,7 @@
         "name": "IapOrderItem",
         "kind": "interface",
         "jsdoc": "/** One item a screen sells. `reference` is the same catalog reference its price came from. */",
-        "decl": "export interface IapOrderItem {\n  reference: CatalogReference;\n  /** One intentional purchase; reuse on retries, replace only for an explicit new purchase. */\n  attemptId?: string;\n  /** Ephemeral selection and form answers; never written to order references or screen state. */\n  attendance?: {\n    amount: string;\n    currency: string;\n    booking?: { slot: Record<string, unknown>; contactDetails: Record<string, unknown>; formInfo?: Record<string, unknown> };\n    ticket?: { eventId: string; buyer: Record<string, unknown>; guests?: Record<string, unknown>[]; buyerSubmission?: Record<string, unknown>; guestSubmissions?: Record<string, unknown>[] };\n  };\n  /** eCom catalog reference, required for a Wix Stores item. */\n  catalogReference?: { appId: string; catalogItemId: string; options?: Record<string, unknown> };\n  /** Only 1 is supported. */\n  quantity?: number;\n}"
+        "decl": "export interface IapOrderItem {\n  reference: CatalogReference;\n  /** eCom catalog reference, required for a Wix Stores item. */\n  catalogReference?: { appId: string; catalogItemId: string; options?: Record<string, unknown> };\n  /** Only 1 is supported. */\n  quantity?: number;\n}"
       },
       {
         "name": "VerticalRef",
@@ -2693,7 +2621,7 @@
         "name": "OrderAttempt",
         "kind": "type",
         "jsdoc": "/** `open`: a pending order the cashier can charge. `granted`: the vertical already gives the\n *  member access, so nothing is sold. */",
-        "decl": "export type OrderAttempt = (\n  | { status: \"open\"; cashierOrderId: string; verticalRef: VerticalRef }\n  | { status: \"granted\" }\n  | { status: \"refused\"; reason: OrderFailureCode }\n  | { status: \"unavailable\" }\n  | { status: \"sessionChanged\" }) & { noOrderCreated?: true };"
+        "decl": "export type OrderAttempt =\n  | { status: \"open\"; cashierOrderId: string; verticalRef: VerticalRef }\n  | { status: \"granted\" }\n  | { status: \"refused\"; reason: OrderFailureCode }\n  | { status: \"unavailable\" }\n  | { status: \"sessionChanged\" };"
       },
       {
         "name": "AccessRead",
@@ -2705,7 +2633,7 @@
         "name": "IapOrderAdapter",
         "kind": "interface",
         "jsdoc": "/** The only per-vertical code. Every call goes through the session-bound bridge it is given. */",
-        "decl": "export interface IapOrderAdapter {\n  /** The catalog kind it sells (`onlineProgram`, `pricingPlan`, `storesProduct`, or a custom one). */\n  readonly kind: string;\n  readonly repeatable?: boolean;\n  /** Structural check before any call: one item, quantity 1, a supported shape. */\n  eligibility(item: IapOrderItem): IapEligibility;\n  /** Opens, or reuses the vertical's own open, order for the signed-in member. */\n  /** Repeatable adapters call beforeCreate immediately before their first inventory write,\n   *  after read-only checks, and abort without writing if it returns false. */\n  openOrder(item: IapOrderItem, bridge: SessionBoundBridge, beforeCreate?: () => boolean): Promise<OrderAttempt>;\n  /** Re-reads an order opened earlier; `open` only while it can still be paid. */\n  reopenOrder(order: { cashierOrderId: string; verticalRef: VerticalRef }, bridge: SessionBoundBridge): Promise<OrderAttempt>;\n  /** The vertical's authoritative answer for the order's item and the signed-in member. */\n  readAccess(verticalRef: VerticalRef, bridge: SessionBoundBridge): Promise<AccessRead>;\n  /** The member's access to an item before any order exists (bought through Wix, say). Read-only:\n   *  never opens or prepares an order. An adapter without it shows Get access until a sale says otherwise. */\n  currentAccess?(item: IapOrderItem, bridge: SessionBoundBridge): Promise<AccessRead>;\n  /** When the platform enables StartItemPayment, an eligible item whose order wix-iap places itself\n   *  instead of `openOrder`. Null for an item outside that shape, which keeps `openOrder`. */\n  itemPayment?(i\n/* … */"
+        "decl": "export interface IapOrderAdapter {\n  /** The catalog kind it sells (`onlineProgram`, `pricingPlan`, `storesProduct`, or a custom one). */\n  readonly kind: string;\n  /** Structural check before any call: one item, quantity 1, a supported shape. */\n  eligibility(item: IapOrderItem): IapEligibility;\n  /** Opens, or reuses the vertical's own open, order for the signed-in member. */\n  openOrder(item: IapOrderItem, bridge: SessionBoundBridge): Promise<OrderAttempt>;\n  /** Re-reads an order opened earlier; `open` only while it can still be paid. */\n  reopenOrder(order: { cashierOrderId: string; verticalRef: VerticalRef }, bridge: SessionBoundBridge): Promise<OrderAttempt>;\n  /** The vertical's authoritative answer for the order's item and the signed-in member. */\n  readAccess(verticalRef: VerticalRef, bridge: SessionBoundBridge): Promise<AccessRead>;\n  /** The member's access to an item before any order exists (bought through Wix, say). Read-only:\n   *  never opens or prepares an order. An adapter without it shows Get access until a sale says otherwise. */\n  currentAccess?(item: IapOrderItem, bridge: SessionBoundBridge): Promise<AccessRead>;\n  /** When the platform enables StartItemPayment, an eligible item whose order wix-iap places itself\n   *  instead of `openOrder`. Null for an item outside that shape, which keeps `openOrder`. */\n  itemPayment?(item: IapOrderItem): ItemPayment | null;\n}"
       },
       {
         "name": "OrderPartitionKey",
@@ -2717,7 +2645,7 @@
         "name": "OrderRefStage",
         "kind": "type",
         "jsdoc": "/** `startingItem`: a StartItemPayment was or is about to be sent and its answer is not stored, so\n *  the service may have placed an order this device knows nothing of; nothing else is sold for the\n *  item until it expires. `held`: Apple charged, and CompletePayment refused the proof without\n *  recording it, so the transaction stays unfinished and is retried. `needsSupport`: recorded and\n *  refused for good. */",
-        "decl": "export type OrderRefStage = \"startingItem\" | \"openingOrder\" | \"ordered\" | \"charged\" | \"started\" | \"submitted\" | \"fulfilled\" | \"held\" | \"needsSupport\";"
+        "decl": "export type OrderRefStage = \"startingItem\" | \"ordered\" | \"charged\" | \"started\" | \"submitted\" | \"held\" | \"needsSupport\";"
       },
       {
         "name": "OrderRef",
@@ -2819,7 +2747,7 @@
         "name": "IapPurchaseCopy",
         "kind": "interface",
         "jsdoc": "/** Labels from the screen's copy pack; the shared layer only chooses between them. */",
-        "decl": "export interface IapPurchaseCopy {\n  buy: string;\n  buyAnother?: string;\n  processing: string;\n  awaitingApproval: string;\n  unavailable: string;\n  signInRequired: string;\n  retry: string;\n  priceChanged: string;\n  support: string;\n}"
+        "decl": "export interface IapPurchaseCopy {\n  buy: string;\n  processing: string;\n  awaitingApproval: string;\n  unavailable: string;\n  signInRequired: string;\n  retry: string;\n  priceChanged: string;\n  support: string;\n}"
       },
       {
         "name": "IapPurchaseFields",
@@ -2906,7 +2834,7 @@
         "name": "StartOptions",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface StartOptions {\n  /** Groups related activities (e.g. \"order\", \"timer\", \"ride\"). Maps to the iOS\n   *  ActivityKit attributes type / the Android notification channel + tag. */\n  activityType: string;\n  /** The widget-safe SDUI tree rendered on the lock screen + Dynamic Island /\n   *  Live Update notification. */\n  content: LiveActivityComponent;\n  /** Optional one-line title (Android Live Update headline / accessibility). */\n  title?: string;\n  /** Mark the activity stale after this many ms (iOS staleDate). 0 ⇒ no hint. */\n  staleAfterMs?: number;\n  /** Optional per-Dynamic-Island-slot subtrees; omitted slots fall back to title/glyph. */\n  regions?: LiveActivityRegions;\n  /** Exact record route in the host app. Older binaries may open the app root. */\n  deepLink?: string;\n  /** Request an ActivityKit push token; the host must register it with its authenticated runtime. */\n  pushUpdates?: boolean;\n  /**\n   * #2050 — the record this activity tracks. Present ⇒ the runtime records a scoped\n   * mapping and the host registers an authenticated subscription, so the serve plane\n   * can push ordered background frames. Absent ⇒ foreground-only, unchanged.\n   *\n   * On iOS pair it with `pushUpdates: true`: without the ActivityKit push token there\n   * is nothing for the host to register, so the mapping would be recorded and never\n   * addressed.\n   */\n  session?: LiveSessionRef;\n  /** Android promotion is opt-in for a user-followed, bounded, time-sensitive\n   * activity. The system may still keep it as an ordinary notification. */\n  promoted?: boolean;\n  /** In an app\n/* … */"
+        "decl": "export interface StartOptions {\n  /** Groups related activities (e.g. \"order\", \"timer\", \"ride\"). Maps to the iOS\n   *  ActivityKit attributes type / the Android notification channel + tag. */\n  activityType: string;\n  /** The widget-safe SDUI tree rendered on the lock screen + Dynamic Island /\n   *  Live Update notification. */\n  content: LiveActivityComponent;\n  /** Optional one-line title (Android Live Update headline / accessibility). */\n  title?: string;\n  /** Mark the activity stale after this many ms (iOS staleDate). 0 ⇒ no hint. */\n  staleAfterMs?: number;\n  /** Optional per-Dynamic-Island-slot subtrees; omitted slots fall back to title/glyph. */\n  regions?: LiveActivityRegions;\n  /** Exact record route in the host app. Older binaries may open the app root. */\n  deepLink?: string;\n  /** Request an ActivityKit push token; the host must register it with its authenticated runtime. */\n  pushUpdates?: boolean;\n  /**\n   * #2050 — the record this activity tracks. Present ⇒ the runtime records a scoped\n   * mapping and the host registers an authenticated subscription, so the serve plane\n   * can push ordered background frames. Absent ⇒ foreground-only, unchanged.\n   *\n   * On iOS pair it with `pushUpdates: true`: without the ActivityKit push token there\n   * is nothing for the host to register, so the mapping would be recorded and never\n   * addressed.\n   */\n  session?: LiveSessionRef;\n  /** Android promotion is opt-in for a user-followed, bounded, time-sensitive\n   * activity. The system may still keep it as an ordinary notification. */\n  promoted?: boolean;\n}"
       },
       {
         "name": "UpdateOptions",
@@ -9035,25 +8963,7 @@
         "name": "WixServiceFixedPayment",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServiceFixedPayment {\n  price?: WixServiceMoney;\n  deposit?: WixServiceMoney;\n  fullUpfrontPaymentAllowed?: boolean;\n}"
-      },
-      {
-        "name": "WixServiceVariedPayment",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceVariedPayment {\n  defaultPrice?: WixServiceMoney;\n  deposit?: WixServiceMoney;\n  minPrice?: WixServiceMoney;\n  maxPrice?: WixServiceMoney;\n}"
-      },
-      {
-        "name": "WixServiceCustomPayment",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCustomPayment {\n  description?: string;\n}"
-      },
-      {
-        "name": "WixServicePaymentOptions",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServicePaymentOptions {\n  online?: boolean;\n  inPerson?: boolean;\n  deposit?: boolean;\n  pricingPlan?: boolean;\n}"
+        "decl": "export interface WixServiceFixedPayment {\n  price?: WixServiceMoney;\n}"
       },
       {
         "name": "WixServiceRateLabel",
@@ -9065,199 +8975,25 @@
         "name": "WixServicePayment",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServicePayment {\n  rateType?: string;\n  fixed?: WixServiceFixedPayment;\n  varied?: WixServiceVariedPayment;\n  custom?: WixServiceCustomPayment;\n  options?: WixServicePaymentOptions;\n  rateLabel?: WixServiceRateLabel;\n  price?: number;\n  currency?: string;\n}"
-      },
-      {
-        "name": "WixServiceDuration",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceDuration {\n  minutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceHourlyConfig",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceHourlyConfig {\n  minDurationInMinutes?: number;\n  maxDurationInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceDailyConfig",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceDailyConfig {\n  minDurationInDays?: number;\n  maxDurationInDays?: number;\n}"
-      },
-      {
-        "name": "WixServiceDurationRange",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceDurationRange {\n  hourOptions?: WixServiceHourlyConfig;\n  dayOptions?: WixServiceDailyConfig;\n  unitType?: string;\n}"
+        "decl": "export interface WixServicePayment {\n  fixed?: WixServiceFixedPayment;\n  rateLabel?: WixServiceRateLabel;\n  price?: number;\n  currency?: string;\n}"
       },
       {
         "name": "WixServiceAvailabilityConstraints",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServiceAvailabilityConstraints {\n  durations?: WixServiceDuration[];\n  sessionDurations?: number[];\n  durationRange?: WixServiceDurationRange;\n}"
+        "decl": "export interface WixServiceAvailabilityConstraints {\n  sessionDurations?: number[];\n}"
       },
       {
         "name": "WixServiceSchedule",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServiceSchedule {\n  id?: string;\n  firstSessionStart?: string;\n  lastSessionEnd?: string;\n  availabilityConstraints?: WixServiceAvailabilityConstraints;\n}"
-      },
-      {
-        "name": "WixServiceImage",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceImage {\n  id?: string;\n  url?: string;\n  height?: number;\n  width?: number;\n  altText?: string;\n}"
-      },
-      {
-        "name": "WixServiceMediaItem",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceMediaItem {\n  image?: WixServiceImage;\n}"
-      },
-      {
-        "name": "WixServiceMedia",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceMedia {\n  items?: WixServiceMediaItem[];\n  mainMedia?: WixServiceMediaItem;\n  coverMedia?: WixServiceMediaItem;\n}"
-      },
-      {
-        "name": "WixServiceStreetAddress",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceStreetAddress {\n  number?: string;\n  name?: string;\n  apt?: string;\n}"
-      },
-      {
-        "name": "WixServiceAddress",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceAddress {\n  streetAddress?: WixServiceStreetAddress;\n  addressLine?: string;\n  country?: string;\n  subdivision?: string;\n  city?: string;\n  postalCode?: string;\n  formattedAddress?: string;\n}"
-      },
-      {
-        "name": "WixServiceBusinessLocation",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceBusinessLocation {\n  id?: string;\n  name?: string;\n  default?: boolean;\n  address?: WixServiceAddress;\n}"
-      },
-      {
-        "name": "WixServiceCustomLocation",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCustomLocation {\n  id?: string;\n  address?: WixServiceAddress;\n}"
-      },
-      {
-        "name": "WixServiceLocation",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceLocation {\n  id?: string;\n  type?: string;\n  business?: WixServiceBusinessLocation;\n  custom?: WixServiceCustomLocation;\n  calculatedAddress?: WixServiceAddress;\n}"
-      },
-      {
-        "name": "WixServiceOnlineBooking",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceOnlineBooking {\n  enabled?: boolean;\n  requireManualApproval?: boolean;\n  allowMultipleRequests?: boolean;\n}"
-      },
-      {
-        "name": "WixServiceConferencing",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceConferencing {\n  enabled?: boolean;\n}"
-      },
-      {
-        "name": "WixServicePolicyDescription",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServicePolicyDescription {\n  enabled?: boolean;\n  description?: string;\n}"
-      },
-      {
-        "name": "WixServiceLimitEarlyBookingPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceLimitEarlyBookingPolicy {\n  enabled?: boolean;\n  earliestBookingInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceLimitLateBookingPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceLimitLateBookingPolicy {\n  enabled?: boolean;\n  latestBookingInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceBookAfterStartPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceBookAfterStartPolicy {\n  enabled?: boolean;\n}"
-      },
-      {
-        "name": "WixServiceCancellationPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCancellationPolicy {\n  enabled?: boolean;\n  limitLatestCancellation?: boolean;\n  latestCancellationInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceReschedulePolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceReschedulePolicy {\n  enabled?: boolean;\n  limitLatestReschedule?: boolean;\n  latestRescheduleInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceWaitlistPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceWaitlistPolicy {\n  enabled?: boolean;\n  capacity?: number;\n  reservationTimeInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceParticipantsPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceParticipantsPolicy {\n  maxParticipantsPerBooking?: number;\n}"
-      },
-      {
-        "name": "WixServiceCancellationWindow",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCancellationWindow {\n  amount?: WixServiceMoney;\n  percentage?: string;\n  startInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceCancellationFeePolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCancellationFeePolicy {\n  enabled?: boolean;\n  cancellationWindows?: WixServiceCancellationWindow[];\n}"
-      },
-      {
-        "name": "WixServiceBookingPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceBookingPolicy {\n  id?: string;\n  name?: string;\n  customPolicyDescription?: WixServicePolicyDescription;\n  limitEarlyBookingPolicy?: WixServiceLimitEarlyBookingPolicy;\n  limitLateBookingPolicy?: WixServiceLimitLateBookingPolicy;\n  bookAfterStartPolicy?: WixServiceBookAfterStartPolicy;\n  cancellationPolicy?: WixServiceCancellationPolicy;\n  reschedulePolicy?: WixServiceReschedulePolicy;\n  waitlistPolicy?: WixServiceWaitlistPolicy;\n  participantsPolicy?: WixServiceParticipantsPolicy;\n  cancellationFeePolicy?: WixServiceCancellationFeePolicy;\n}"
-      },
-      {
-        "name": "WixServiceStaffMember",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceStaffMember {\n  staffMemberId?: string;\n  name?: string;\n  mainMedia?: WixServiceMediaItem;\n}"
-      },
-      {
-        "name": "WixServiceStaffMemberDetails",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceStaffMemberDetails {\n  staffMembers?: WixServiceStaffMember[];\n}"
-      },
-      {
-        "name": "WixServicePageUrl",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServicePageUrl {\n  relativePath?: string;\n  url?: string;\n}"
-      },
-      {
-        "name": "WixServiceUrls",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceUrls {\n  servicePage?: WixServicePageUrl;\n  bookingPage?: WixServicePageUrl;\n}"
+        "decl": "export interface WixServiceSchedule {\n  availabilityConstraints?: WixServiceAvailabilityConstraints;\n}"
       },
       {
         "name": "WixService",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixService {\n  id: string;\n  name?: string;\n  description?: string;\n  type?: string;\n  tagLine?: string;\n  defaultCapacity?: number;\n  media?: WixServiceMedia;\n  duration?: number;\n  payment?: WixServicePayment;\n  onlineBooking?: WixServiceOnlineBooking;\n  conferencing?: WixServiceConferencing;\n  locations?: WixServiceLocation[];\n  bookingPolicy?: WixServiceBookingPolicy;\n  schedule?: WixServiceSchedule;\n  staffMemberDetails?: WixServiceStaffMemberDetails;\n  urls?: WixServiceUrls;\n  price?: number;\n  category?: string;\n}"
+        "decl": "export interface WixService {\n  id: string;\n  name?: string;\n  description?: string;\n  duration?: number;\n  payment?: WixServicePayment;\n  schedule?: WixServiceSchedule;\n  price?: number;\n  category?: string;\n}"
       },
       {
         "name": "WixServicesSearchPaging",
@@ -9289,12 +9025,6 @@
         "jsdoc": "",
         "decl": "export interface WixGetServiceResponse {\n  service: WixService;\n}"
       },
-      {
-        "name": "WixGetServiceOptions",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixGetServiceOptions {\n  conditionalFields?: string[];\n}"
-      },
       {
         "name": "WixServiceWrite",
         "kind": "interface",
@@ -9433,13 +9163,13 @@
         "name": "WixServicePayment",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServicePayment {\n  /** \"FIXED\" | \"CUSTOM\" | \"VARIED\" | \"NO_FEE\". */\n  rateType?: string;\n  fixed?: { price?: WixServiceMoney; deposit?: WixServiceMoney; fullUpfrontPaymentAllowed?: boolean };\n  varied?: { defaultPrice?: WixServiceMoney; deposit?: WixServiceMoney; minPrice?: WixServiceMoney; maxPrice?: WixServiceMoney };\n  custom?: { description?: string };\n  /** How the customer may pay. A service offers at least one of these. */\n  options?: { online?: boolean; inPerson?: boolean; deposit?: boolean; pricingPlan?: boolean };\n  rateLabel?: { amount?: string; currency?: string };\n  /** @deprecated Legacy flat payment shape. */\n  price?: number;\n  /** @deprecated Legacy flat payment shape. */\n  currency?: string;\n}"
+        "decl": "export interface WixServicePayment {\n  fixed?: { price?: WixServiceMoney };\n  rateLabel?: { amount?: string; currency?: string };\n  /** @deprecated Legacy flat payment shape. */\n  price?: number;\n  /** @deprecated Legacy flat payment shape. */\n  currency?: string;\n}"
       },
       {
         "name": "WixService",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixService {\n  id: string;\n  /** Optimistic-concurrency token — required by every v2 write (updateService reads it if omitted). */\n  revision?: string;\n  name?: string;\n  description?: string;\n  /** \"APPOINTMENT\" | \"CLASS\" | \"COURSE\". */\n  type?: string;\n  tagLine?: string;\n  defaultCapacity?: number;\n  media?: WixServiceMedia;\n  /** Session length in minutes. */\n  duration?: number;\n  /** Raw Bookings v2 response shape. */\n  payment?: WixServicePayment;\n  onlineBooking?: { enabled?: boolean; requireManualApproval?: boolean; allowMultipleRequests?: boolean };\n  conferencing?: { enabled?: boolean };\n  locations?: WixServiceLocation[];\n  bookingPolicy?: WixServiceBookingPolicy;\n  schedule?: {\n    id?: string;\n    firstSessionStart?: string;\n    lastSessionEnd?: string;\n    availabilityConstraints?: { durations?: Array<{ minutes?: number }>; sessionDurations?: number[]; durationRange?: WixServiceDurationRange };\n  };\n  /** Returned only when the request asks for `STAFF_MEMBER_DETAILS` (see `getService`). */\n  staffMemberDetails?: WixServiceStaffMemberDetails;\n  urls?: WixServiceUrls;\n  /** @deprecated Compatibility projection populated by `decodeService`. */\n  price?: number;\n  /** @deprecated Legacy v1 compatibility field. */\n  category?: string;\n}"
+        "decl": "export interface WixService {\n  id: string;\n  /** Optimistic-concurrency token — required by every v2 write (updateService reads it if omitted). */\n  revision?: string;\n  name?: string;\n  description?: string;\n  /** Session length in minutes. */\n  duration?: number;\n  /** Raw Bookings v2 response shape. */\n  payment?: WixServicePayment;\n  schedule?: { availabilityConstraints?: { sessionDurations?: number[] } };\n  /** @deprecated Compatibility projection populated by `decodeService`. */\n  price?: number;\n  /** @deprecated Legacy v1 compatibility field. */\n  category?: string;\n}"
       },
       {
         "name": "decodeService",
@@ -9518,8 +9248,9 @@
       {
         "name": "getService",
         "kind": "function",
-        "jsdoc": "/** Fetch a single service by id — GET /bookings/v2/services/{id}. Visitor-readable\n *  (public GA route, not the owner `_api/` gateway). The detail/edit-prefill source.\n *  `options.conditionalFields` asks for fields Wix returns only on request\n *  (\"STAFF_MEMBER_DETAILS\", \"DISCOUNT_INFO_DETAILS\"), each sent as a repeated\n *  `conditionalFields` query parameter. Without `options` the request is the one this\n *  function always sent. */",
-        "decl": "export async function getService(serviceId: string, options?: WixGetServiceOptions): Promise<WixGetServiceResponse>;"
+        "jsdoc": "/** Fetch a single service by id — GET /bookings/v2/services/{id}. Visitor-readable\n *  (public GA route, not the owner `_api/` gateway). The detail/edit-prefill source. */",
+        "decl": "export async function getService(serviceId: string): Promise<WixGetServiceResponse>;",
+        "http": "GET /bookings/v2/services/{…}"
       },
       {
         "name": "WixServiceWrite",
@@ -9635,54 +9366,6 @@
         "decl": "export function cancelBookingAsMember(bookingId: string, revision: string, notify = true): Promise<WixUpdateBookingResponse>;",
         "http": "POST /bookings/v2/bookings/{…}/cancel"
       },
-      {
-        "name": "WixWaitlistContact",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixWaitlistContact {\n  email: string;\n  firstName?: string;\n  lastName?: string;\n}"
-      },
-      {
-        "name": "WixWaitlistRegistration",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixWaitlistRegistration {\n  id?: string;\n  bookingId?: string;\n  waitingResource?: string;\n  status?: string;\n  availableActions?: { leave?: boolean; enroll?: boolean };\n}"
-      },
-      {
-        "name": "WixWaitlistEntry",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixWaitlistEntry {\n  /** The waitlisted session id. */\n  waitingResource?: string;\n  registrations?: WixWaitlistRegistration[];\n}"
-      },
-      {
-        "name": "WixRegisterToWaitlistResponse",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixRegisterToWaitlistResponse {\n  registrationId?: string;\n  booking?: { id?: string; status?: string };\n}"
-      },
-      {
-        "name": "registerToWaitlist",
-        "kind": "function",
-        "jsdoc": "/** Register the signed-in member to a full session's waitlist —\n *  POST /bookings/v1/waitlist/register. `sessionId` is the availability slot's\n *  `sessionId`. Wix answers with an error when the session has no waitlist or it is\n *  full, so offer this only while the entry reports `waitingList.openSpots > 0`.\n *  @scope member — requires a signed-in site member; `contact.email` is theirs. Only name and\n *  email are sent, so a booking form with other required fields can refuse it. */",
-        "decl": "export function registerToWaitlist(sessionId: string, contact: WixWaitlistContact): Promise<WixRegisterToWaitlistResponse>;",
-        "http": "POST /bookings/v1/waitlist/register",
-        "scope": "member"
-      },
-      {
-        "name": "listWaitlists",
-        "kind": "function",
-        "jsdoc": "/** The waitlists of the given sessions — GET /bookings/v1/waitlist/list (public data).\n *  Each registration carries its `bookingId`, which is how a member's own place is found.\n *  @scope visitor — an anonymous visitor session is enough. */",
-        "decl": "export function listWaitlists(sessionIds: string[]): Promise<{ list?: WixWaitlistEntry[] }>;",
-        "http": "GET /bookings/v1/waitlist/list",
-        "scope": "visitor"
-      },
-      {
-        "name": "leaveWaitlist",
-        "kind": "function",
-        "jsdoc": "/** Leave a waitlist — POST /bookings/v1/waitlist/leave. Wix also cancels the pending\n *  booking the registration created, and offers the place to the next registrant.\n *  @scope member — requires the signed-in member who registered; `registrationId` comes from\n *  `listWaitlists`. */",
-        "decl": "export function leaveWaitlist(registrationId: string, sessionId: string): Promise<{ registrationId?: string; waitingResource?: string }>;",
-        "http": "POST /bookings/v1/waitlist/leave",
-        "scope": "member"
-      },
       {
         "name": "isBookingPolicyViolation",
         "kind": "function",
@@ -16158,30 +15841,6 @@
         "decl": "export async function getCurrentCart(): Promise<WixCartDetail>;",
         "http": "GET /ecom/v1/carts/current"
       },
-      {
-        "name": "addCouponToCurrentCart",
-        "kind": "function",
-        "jsdoc": "/** Add a coupon to the visitor/member's current cart — POST\n *  /ecom/v2/carts/current/add-coupon. Wix validates it against the current cart.\n *  @scope visitor — uses the active shopper's cart; Wix rejects an invalid coupon. */",
-        "decl": "export function addCouponToCurrentCart(code: string): Promise<{ cart?: WixCartDetail }>;",
-        "http": "POST /ecom/v2/carts/current/add-coupon",
-        "scope": "visitor"
-      },
-      {
-        "name": "removeCouponFromCurrentCart",
-        "kind": "function",
-        "jsdoc": "/** Remove a coupon from the current cart — POST /ecom/v2/carts/current/remove-coupon.\n *  @scope visitor — uses the active shopper's cart; a missing coupon ID is rejected. */",
-        "decl": "export function removeCouponFromCurrentCart(couponId: string): Promise<{ cart?: WixCartDetail }>;",
-        "http": "POST /ecom/v2/carts/current/remove-coupon",
-        "scope": "visitor"
-      },
-      {
-        "name": "calculateCurrentCart",
-        "kind": "function",
-        "jsdoc": "/** Recalculate the current cart after a coupon change.\n *  @scope visitor — uses the active shopper's cart and returns its updated totals. */",
-        "decl": "export function calculateCurrentCart(): Promise<{ cart?: WixCartDetail }>;",
-        "http": "POST /ecom/v2/carts/current/calculate",
-        "scope": "visitor"
-      },
       {
         "name": "WixRemoveLineItemsResponse",
         "kind": "interface",
@@ -17886,8 +17545,8 @@
       {
         "name": "WixEventFieldset",
         "kind": "type",
-        "jsdoc": "/** Events v3 response fieldsets (`RequestedFields`). A bare read returns the base fieldset;\n *  each value adds fields: `DETAILS` → `shortDescription`, `mainImage`, `calendarUrls`;\n *  `TEXTS` → the Ricos `description`; `REGISTRATION` → `registration`; `URLS` → `eventPageUrl`;\n *  `FORM` → `form`, the published registration controls and inputs. */",
-        "decl": "export type WixEventFieldset = \"DETAILS\" | \"TEXTS\" | \"REGISTRATION\" | \"URLS\" | \"FORM\";"
+        "jsdoc": "/** Events v3 response fieldsets (`RequestedFields`). A bare read returns the base fieldset;\n *  each value adds fields: `DETAILS` → `shortDescription`, `mainImage`, `calendarUrls`;\n *  `TEXTS` → the Ricos `description`; `REGISTRATION` → `registration`; `URLS` → `eventPageUrl`. */",
+        "decl": "export type WixEventFieldset = \"DETAILS\" | \"TEXTS\" | \"REGISTRATION\" | \"URLS\";"
       },
       {
         "name": "WixEventRichContent",
@@ -17994,7 +17653,7 @@
         "name": "WixAvailableTicket",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixAvailableTicket {\n  id?: string;\n  eventId?: string;\n  name?: string;\n  description?: string;\n  price?: WixTicketPrice;\n  free?: boolean;\n  limitPerCheckout?: number;\n  orderIndex?: number;\n  saleStatus?: string;\n  state?: string[];\n  pricing?: { pricingType?: string; fixedPrice?: WixTicketPrice };\n  dashboard?: { hidden?: boolean };\n}"
+        "decl": "export interface WixAvailableTicket {\n  id?: string;\n  name?: string;\n  description?: string;\n  price?: WixTicketPrice;\n  free?: boolean;\n  limitPerCheckout?: number;\n  orderIndex?: number;\n  saleStatus?: string;\n}"
       },
       {
         "name": "WixQueryAvailableTicketsResponse",
@@ -18002,14 +17661,6 @@
         "jsdoc": "",
         "decl": "export interface WixQueryAvailableTicketsResponse {\n  definitions?: WixAvailableTicket[];\n}"
       },
-      {
-        "name": "getTicketDefinition",
-        "kind": "function",
-        "jsdoc": "/** Read management pricing/visibility for a required ticket-definition ID; absence is not a free offer.\n *  Authorization errors propagate and must block checkout.\n *  @scope owner — Wix documents app/user identity with Manage Ticket Definitions permission.\n *  Member checkout uses queryAvailableTickets; LiftGear member reads returned 403 here.\n *  @see https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/ticket-definitions-v3/get-ticket-definition\n */",
-        "decl": "export function getTicketDefinition(id: string): Promise<{ ticketDefinition?: { id?: string; eventId?: string; hidden?: boolean; saleStatus?: string; pricingMethod?: { pricingType?: string; fixedPrice?: { value?: string; currency?: string } } } }>;",
-        "http": "GET /events/v3/ticket-definitions/{…}",
-        "scope": "owner"
-      },
       {
         "name": "WixTicketQuantity",
         "kind": "interface",
@@ -25049,7 +24700,7 @@
         "name": "StoreProduct",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface StoreProduct {\n  id?: string;\n  productType?: string;\n  name?: string;\n  slug?: string;\n  description?: string;\n  plainDescription?: string;\n  /** Both gallery layouts: V1 `mainMedia`/`items`, V3 `main`/`itemsInfo.items`. */\n  media?: {\n    mainMedia?: WixMediaSlot;\n    main?: WixMediaSlot;\n    items?: WixMediaSlot[];\n    itemsInfo?: { items?: WixMediaSlot[] };\n  };\n  price?: { formatted?: { price?: string }; price?: number; currency?: string };\n  priceData?: { formatted?: { price?: string }; price?: number; currency?: string };\n  currency?: string;\n  actualPriceRange?: {\n    minValue?: { amount?: string; formattedAmount?: string; currency?: string };\n    maxValue?: { amount?: string; formattedAmount?: string; currency?: string };\n  };\n  /** Catalog V3 original price, when the actual price is discounted. */\n  compareAtPriceRange?: {\n    minValue?: { amount?: string; formattedAmount?: string; currency?: string };\n    maxValue?: { amount?: string; formattedAmount?: string; currency?: string };\n  };\n  /** Option groups, both spellings: V1 `productOptions`, V3 `options`. Declared\n   *  because the wire carries them on BOTH catalogs and this type denying them is\n   *  what let every template product screen drop the colour/size picker. Shapes\n   *  differ per catalog, so read them with `productOptions()` from ./options. */\n  productOptions?: unknown[];\n  options?: unknown[];\n  /** V3 purchasable variants. The cart addresses a V3 option choice by `variantId`,\n   *  which `cartOptionsPayload()` resolves out of this. */\n  variantsInfo?: { variants?: unknown[] };\n  /\n/* … */"
+        "decl": "export interface StoreProduct {\n  id?: string;\n  productType?: string;\n  name?: string;\n  slug?: string;\n  description?: string;\n  plainDescription?: string;\n  /** Both gallery layouts: V1 `mainMedia`/`items`, V3 `main`/`itemsInfo.items`. */\n  media?: {\n    mainMedia?: WixMediaSlot;\n    main?: WixMediaSlot;\n    items?: WixMediaSlot[];\n    itemsInfo?: { items?: WixMediaSlot[] };\n  };\n  price?: { formatted?: { price?: string }; price?: number; currency?: string };\n  priceData?: { formatted?: { price?: string }; price?: number; currency?: string };\n  currency?: string;\n  actualPriceRange?: {\n    minValue?: { amount?: string; formattedAmount?: string; currency?: string };\n    maxValue?: { amount?: string; formattedAmount?: string; currency?: string };\n  };\n  /** Option groups, both spellings: V1 `productOptions`, V3 `options`. Declared\n   *  because the wire carries them on BOTH catalogs and this type denying them is\n   *  what let every template product screen drop the colour/size picker. Shapes\n   *  differ per catalog, so read them with `productOptions()` from ./options. */\n  productOptions?: unknown[];\n  options?: unknown[];\n  /** V3 purchasable variants. The cart addresses a V3 option choice by `variantId`,\n   *  which `cartOptionsPayload()` resolves out of this. */\n  variantsInfo?: { variants?: unknown[] };\n}"
       },
       {
         "name": "StoreProductsResponse",
@@ -25088,12 +24739,6 @@
         "jsdoc": "/**\n * EVERY image on the product, sized, in wire order — the gallery a detail screen\n * pages through, not just the one tile `productImage` returns.\n *\n * It reads both catalog layouts (V1 `media.items`, V3 `media.itemsInfo.items`) and\n * falls back to the primary image when the product carries no gallery, so a caller\n * always gets a non-empty list for a product that has any image at all. Empty slots\n * and duplicates are dropped.\n *\n * Exported because the gallery union was being re-derived by hand in ~10 template\n * workers, each free to miss a layout — which is exactly how a V3 store silently\n * lost its thumbnails. Defaults to the LIST budget like `productImage`; pass\n * `WIX_DETAIL_IMAGE` for a full-bleed pager, or `null` for the stored originals.\n */",
         "decl": "export function productGallery(p: StoreProduct, size: WixImageSize | null = WIX_LIST_IMAGE): string[];"
       },
-      {
-        "name": "normalizeFormattedPrice",
-        "kind": "function",
-        "jsdoc": "/** Formats Wix-provided price text consistently for display. A recognized symbol after an\n *  English-style number moves before the amount; locale-specific decimal and grouping formats\n *  remain unchanged. */",
-        "decl": "export function normalizeFormattedPrice(formatted: string): string;"
-      },
       {
         "name": "plainText",
         "kind": "function",
@@ -25219,7 +24864,7 @@
         "name": "WixCollectionsMetadata",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixCollectionsMetadata {\n  items?: number;\n  count?: number;\n  offset?: number;\n  total?: number;\n}"
+        "decl": "export interface WixCollectionsMetadata {\n  items?: number;\n  offset?: number;\n}"
       },
       {
         "name": "WixQueryCollectionsRequest",
@@ -25338,7 +24983,7 @@
         "name": "queryStoreCategories",
         "kind": "function",
         "jsdoc": "/** V3 visitor read: list store categories (the V3 replacement for `queryCollections`).\n *  POST /categories/v1/categories/query — `treeReference.appNamespace` is REQUIRED. */",
-        "decl": "export function queryStoreCategories(limit = 50, cursor?: string): Promise<StoreCategoriesResponse>;",
+        "decl": "export function queryStoreCategories(limit = 50): Promise<StoreCategoriesResponse>;",
         "http": "POST /categories/v1/categories/query"
       },
       {

package/guides/splash-screens.md

@@ -199,8 +199,8 @@ holding the readiness wait there would defeat the point of making this layer OTA
 Two seams, and only one of them needs work:
 
 - **OS splash → in-app surface.** The background is **already continuous** — both layers
-  resolve the same colour token — so there is nothing to cross-fade there. What would
-  otherwise pop is the *content*, so `HimalayaSplashView` / `HimalayaSplash` ease the
+  resolve the same colour token — Android fades a declared gradient over this opaque base in 400 ms.
+  The *content* also eases in, so `HimalayaSplashView` / `HimalayaSplash` ease the
   logo and caption in over `contentFadeInMs`.
 - **In-app surface → real content.** Fades out over a fixed `exitFadeMs` (350 ms), via
   `.splashExitAnimation(ready:)` on iOS and `HimalayaSplashHost` on Android.
@@ -340,3 +340,57 @@ Note that the `splash` accessibility id / `testTag` on some apps today belongs t
 - [designing-himi-screens.md](designing-himi-screens.md) — composing the launch moment as design.
 - [RFC 0012](../core/schema/RFC/0012-screen-rollout-and-authoring.md) — the binary/OTA seam.
 - [RFC 0021](../core/schema/RFC/0021-design-kits.md) — why the background is a token.
+
+### Branded-lite logo and handoff
+
+Use the baked branded-lite app icon as the in-app logo:
+
+```ts
+splash: { enabled: true, logoAsset: "branded_lite_app_icon", logoWidth: 160 }
+```
+
+Hide the logo on both Android splash layers with an **explicit empty string**:
+
+```ts
+splash: { enabled: true, logoAsset: "" }
+```
+
+`logoWidth` is the square in-app logo size in logical points/dp (default 96 for absent or non-positive values). It does not resize Android's OS-controlled icon slot.
+Omitting `logoAsset` retains existing behavior: no in-app logo; the OS uses the
+launcher icon. An empty value also produces no in-app logo on iOS, macOS and web.
+Android 12+ always reserves an icon slot: the build emits a transparent splash
+icon when hidden, while preserving the actual launcher icon. This native change
+requires a new binary; changing the served block alone only changes the in-app layer.
+
+A declared `splash.backgroundColor` now overrides branded-lite's provisioning
+primary color for the native launch background, in both light and dark appearance.
+Without it the provisioning color remains the default. For a gradient, set this
+token to its first/top color. Android and iOS/macOS paint that solid color first and fade the
+gradient over it in 400 ms (immediate with reduce motion or Determinism).
+The Android branded-lite shell mounts its first screen beneath the splash after
+seeding and dismisses after that screen draws a descriptor (including a worker's
+initial loading state) or an error. Explicit `readySignal: "first_content"`
+retains the WebView page-loaded signal. `maxHoldMs` remains the hard deadline;
+auth gates also count as first content. The iOS branded-lite shell likewise mounts its
+content beneath the overlay and waits for loaded content or an error to appear,
+within the same deadline. Once dismissed, the iOS splash stays dismissed even if
+OTA timing settings change. Branded-lite Android image splashes use translucent dark system-bar
+scrims with light icons for legibility; color and gradient splashes remain full-bleed.
+Web retains its current transitions and readiness.
+The standalone branded-lite macOS shell currently does not mount a boot splash
+overlay; `splash.enabled` does not enable one there. The shared SwiftUI background
+renderer is available on macOS, but this host handoff integration covers Android
+and iOS. macOS shell integration requires a separate change.
+
+Branded-lite builds expose the launcher artwork as the regular iOS image asset
+`branded_lite_app_icon`, so the same logo configuration works on Android and iOS.
+
+Native iOS hosts that use `HimalayaScreenHost` can opt into
+`.onHimalayaScreenContent { ... }` to observe the appearance of loaded content or
+an error. The callback ignores the host loader and does not replace a WebView's
+page-loaded readiness signal. Existing hosts behave as before unless they opt in.
+
+If cached splash configuration references missing or invalid colors after a binary
+update, native splash stops fall back to the flat background, then `accentPrimary`,
+then opaque white. Branded-lite also shows a shell loader if `maxHoldMs` expires
+before seed prefill completes; the deadline remains unchanged.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1499.0",
+  "version": "0.1501.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "90b31197c53ba0762e3e70c6edd253abe08c7c85927888d92fc84c9b"
+  "falconPackageHash": "b4581cb1b19e25892ccdd324431e2a5db2facd8ae8c8759bcc8c69cc"
 }

package/templates/branded-lite/dev/index.ts

@@ -89216,24 +89216,65 @@ const SCREENS = runtimeSetting({
                                                           "itemsPath": "$item.articleActions",
                                                           "items": [
                                                             {
-                                                              "id": "himi_business_chat.article_action_$item.id",
+                                                              "id": "himi_business_chat.article_action.slot.$item.id",
                                                               "body": {
                                                                 "package": "himalaya",
-                                                                "type": "Button",
+                                                                "type": "VStack",
                                                                 "props": {
-                                                                  "title": "$item.label",
-                                                                  "style": "secondary",
-                                                                  "size": "sm",
-                                                                  "fullWidth": false,
-                                                                  "action": {
-                                                                    "actionId": "capability.open_url.open",
-                                                                    "params": {
-                                                                      "url": "$item.url"
+                                                                  "children": [
+                                                                    {
+                                                                      "id": "himi_business_chat.article_action.web.$item.id",
+                                                                      "body": {
+                                                                        "package": "himalaya",
+                                                                        "type": "Button",
+                                                                        "props": {
+                                                                          "title": "$item.label",
+                                                                          "style": "secondary",
+                                                                          "size": "sm",
+                                                                          "fullWidth": false,
+                                                                          "action": {
+                                                                            "actionId": "capability.open_url.open",
+                                                                            "params": {
+                                                                              "url": "$item.url"
+                                                                            }
+                                                                          }
+                                                                        }
+                                                                      },
+                                                                      "modifiers": {
+                                                                        "hiddenPath": "$item.inApp"
+                                                                      }
+                                                                    },
+                                                                    {
+                                                                      "id": "himi_business_chat.article_action.app.$item.id",
+                                                                      "body": {
+                                                                        "package": "himalaya",
+                                                                        "type": "Button",
+                                                                        "props": {
+                                                                          "title": "$item.label",
+                                                                          "style": "secondary",
+                                                                          "size": "sm",
+                                                                          "fullWidth": false,
+                                                                          "action": {
+                                                                            "actionId": "himi.open",
+                                                                            "params": {
+                                                                              "screenId": "$item.screenId",
+                                                                              "id": "$item.targetId"
+                                                                            }
+                                                                          }
+                                                                        }
+                                                                      },
+                                                                      "modifiers": {
+                                                                        "hiddenPath": "$item.web"
+                                                                      }
                                                                     }
-                                                                  }
+                                                                  ],
+                                                                  "spacing": 0,
+                                                                  "alignment": "leading"
                                                                 }
                                                               },
-                                                              "modifiers": {}
+                                                              "modifiers": {
+                                                                "fillMaxWidth": true
+                                                              }
                                                             }
                                                           ],
                                                           "spacing": 6
@@ -89607,24 +89648,65 @@ const SCREENS = runtimeSetting({
                                                                   "itemsPath": "$item.articleActions",
                                                                   "items": [
                                                                     {
-                                                                      "id": "himi_business_chat.card_action_$item.id",
+                                                                      "id": "himi_business_chat.card_action.slot.$item.id",
                                                                       "body": {
                                                                         "package": "himalaya",
-                                                                        "type": "Button",
+                                                                        "type": "VStack",
                                                                         "props": {
-                                                                          "title": "$item.label",
-                                                                          "style": "secondary",
-                                                                          "size": "md",
-                                                                          "fullWidth": true,
-                                                                          "action": {
-                                                                            "actionId": "capability.open_url.open",
-                                                                            "params": {
-                                                                              "url": "$item.url"
+                                                                          "children": [
+                                                                            {
+                                                                              "id": "himi_business_chat.card_action.web.$item.id",
+                                                                              "body": {
+                                                                                "package": "himalaya",
+                                                                                "type": "Button",
+                                                                                "props": {
+                                                                                  "title": "$item.label",
+                                                                                  "style": "secondary",
+                                                                                  "size": "md",
+                                                                                  "fullWidth": true,
+                                                                                  "action": {
+                                                                                    "actionId": "capability.open_url.open",
+                                                                                    "params": {
+                                                                                      "url": "$item.url"
+                                                                                    }
+                                                                                  }
+                                                                                }
+                                                                              },
+                                                                              "modifiers": {
+                                                                                "hiddenPath": "$item.inApp"
+                                                                              }
+                                                                            },
+                                                                            {
+                                                                              "id": "himi_business_chat.card_action.app.$item.id",
+                                                                              "body": {
+                                                                                "package": "himalaya",
+                                                                                "type": "Button",
+                                                                                "props": {
+                                                                                  "title": "$item.label",
+                                                                                  "style": "secondary",
+                                                                                  "size": "md",
+                                                                                  "fullWidth": true,
+                                                                                  "action": {
+                                                                                    "actionId": "himi.open",
+                                                                                    "params": {
+                                                                                      "screenId": "$item.screenId",
+                                                                                      "id": "$item.targetId"
+                                                                                    }
+                                                                                  }
+                                                                                }
+                                                                              },
+                                                                              "modifiers": {
+                                                                                "hiddenPath": "$item.web"
+                                                                              }
                                                                             }
-                                                                          }
+                                                                          ],
+                                                                          "spacing": 0,
+                                                                          "alignment": "leading"
                                                                         }
                                                                       },
-                                                                      "modifiers": {}
+                                                                      "modifiers": {
+                                                                        "fillMaxWidth": true
+                                                                      }
                                                                     }
                                                                   ],
                                                                   "spacing": 6
@@ -89990,7 +90072,12 @@ const SCREENS = runtimeSetting({
           "token": "surfaceSecondary"
         },
         "onAppear": {
-          "actionId": "tier5.businessChat.init"
+          "actionId": "tier5.businessChat.init",
+          "params": {
+            "siteUrl": "__HIMI_MEMBER_SITE_URL__",
+            "productScreen": "himi_product",
+            "serviceScreen": "himi_service"
+          }
         }
       }
     },

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

@@ -14,7 +14,26 @@ export type BusinessMessagePart = {
 
 export type BusinessTextRun = { text: string; marks?: string[] };
 export type BusinessSuggestion = { id: string; messageId: string; label: string; kind: "postback" | "visitor_option"; appId?: string; interactionId?: string; enabled: boolean; disabled: boolean };
-export type BusinessArticleAction = { id: string; label: string; url: string; style: "primary" | "secondary" };
+/** `inApp` buttons open `screenId` with `targetId` inside the app; the rest open `url` in the browser. Only a
+ *  `routable` one (a link in the text or a template button, never a file) may be opened in the app. */
+export type BusinessArticleAction = { id: string; label: string; url: string; style: "primary" | "secondary"; screenId: string; targetId: string; inApp: boolean; web: boolean; routable: boolean };
+/** The app's own screen for a site link, named by the slug in the link's path. */
+export type BusinessInAppRoute = { kind: "product" | "service"; slug: string };
+
+/** A store product page or a bookings service (its page or its booking calendar) on this app's own site has a screen
+ *  in the app; another site's page (even one on the same host, as Wix sites share one), a pay link or a file has
+ *  none, and with no site configured nothing is routed. The slug only names the item: the worker still has to find it. */
+export function businessInAppRoute(url: string, siteUrl: string): BusinessInAppRoute | undefined {
+  const site = /^https:\/\/[^/?#\s]+(?:\/[^?#\s]*)?/i.exec(siteUrl.trim())?.[0].replace(/\/+$/, "") ?? "";
+  if (!site || !url.toLowerCase().startsWith(`${site.toLowerCase()}/`)) return undefined;
+  const match = /^\/(product-page|service-page|booking-calendar)\/([^/?#]+)\/?(?:[?#].*)?$/i.exec(url.slice(site.length));
+  if (!match) return undefined;
+  let slug: string;
+  // A malformed escape ("50%-off") names nothing the app can look up: the link stays a web link.
+  try { slug = decodeURIComponent(match[2]!); } catch { return undefined; }
+  return slug ? { kind: match[1]!.toLowerCase() === "product-page" ? "product" : "service", slug } : undefined;
+}
+const webAction = { screenId: "", targetId: "", inApp: false, web: true, routable: true };
 export type BusinessVisitorOptions = { answerTo: string; labels: string[] };
 
 export type BusinessMessage = {
@@ -274,7 +293,7 @@ function articleActions(message: RecordValue, messageId: string): BusinessArticl
     if (!label || !rawUrl || button.payload != null) return [];
     // No `URL` global in a worker: accept only a plain https URL whose authority carries no credentials.
     if (!isSafeLink(rawUrl)) return [];
-    return [{ id: `${messageId}:article-${index}`, label, url: rawUrl, style: "secondary" as const }];
+    return [{ id: `${messageId}:article-${index}`, label, url: rawUrl, style: "secondary" as const, ...webAction }];
   });
 }
 
@@ -471,7 +490,8 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
     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 }));
+      // A file, recording or video always opens as itself in the browser, wherever its URL lives.
+      .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, ...webAction, routable: false }));
     // 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.
@@ -481,7 +501,7 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
     // 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 }))]
+    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, ...webAction }))]
       .filter((action, at, all) => all.findIndex((other) => other.url === action.url) === at);
 
     return {

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

@@ -4,16 +4,17 @@ import type { ChatIdentity } from '../_shared/business-chat-transport.js';
 import { type MessageRow } from '../_shared/business-chat-message-model.js';
 import { businessChatSendRejected, messageTimeLabel, sendAnchor, pendingIntentWasObserved, chronologicalMessages, newBusinessChatIntent, type BusinessChatIntent } from '../_shared/business-chat-model.js';
 import { subscribeRealtime, unsubscribeRealtime, getRealtimeStatus, type RealtimeStatus, type RealtimeEventEnvelope } from '@himalaya/wix-chat';
-import { dispatchBusinessSuggestion, businessRealtimeStatusLabel, businessVisitorOptionSuggestions, presentBusinessMessages, selectExistingBusinessRoom, shouldRefreshBusinessHistory, type BusinessSuggestion, type BusinessVisitorOptions, businessVisitorOptionRequest, businessVisitorOptionsFromAiMessages, newBusinessSelectionId} from '../_shared/business-chat-presenter.js';
+import { businessInAppRoute, type BusinessArticleAction, dispatchBusinessSuggestion, businessRealtimeStatusLabel, businessVisitorOptionSuggestions, presentBusinessMessages, selectExistingBusinessRoom, shouldRefreshBusinessHistory, type BusinessSuggestion, type BusinessVisitorOptions, businessVisitorOptionRequest, businessVisitorOptionsFromAiMessages, newBusinessSelectionId} from '../_shared/business-chat-presenter.js';
 import { listMessages, streamMessages } from '@himalaya/wix-ai-site-chat';
 import { hostSiteFromInput } from '../_shared/branded-lite-hosted.js';
 import { productImage, searchStoreProducts } from '../_shared/himi-store.js';
+import { queryServices } from '@himalaya/wix-bookings';
 
 type PendingIntent = BusinessChatIntent;
 // Only what the screen reads. This state crosses into the worker on every keystroke, so a row carries no raw
 // 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;
+ senderAvatar:string; senderName:string; senderInitials:string; senderBadge:string; imageUrl:string; imageDescription:string; noImage:boolean; bodyText:string; bodyMarkdown:string; suggestions:BusinessSuggestion[]; articleActions:BusinessArticleAction[]; 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. */
@@ -82,6 +83,7 @@ function safeLoadFailure(error:unknown):string{
  return `${loadStage}:${/^(TypeError|SyntaxError|ProtocolError|Unsupported|Error)$/.test(name)?name:'OtherError'}${safeCode}`;
 }
 function value(arg:unknown):string{if(typeof arg==='string')return arg;const a=arg as Record<string,unknown>|null;return typeof a?.value==='string'?a.value:'';}
+function hasParam(arg:unknown,key:string):boolean{const a=arg as Record<string,unknown>|null;const p=a?.params as Record<string,unknown>|undefined;return typeof a?.[key]==='string'||typeof p?.[key]==='string';}
 function param(arg:unknown,key:string):string{const a=arg as Record<string,unknown>|null;const p=a?.params as Record<string,unknown>|undefined;return typeof a?.[key]==='string'?a[key] as string:typeof p?.[key]==='string'?p[key] as string:'';}
 // A private attachment's download URL costs a round trip and stays valid for minutes, so a refresh reuses it.
 const attachmentUrls=new Map<string,{url:string;at:number}>();
@@ -94,21 +96,26 @@ async function privateAttachmentUrl(part:{mediaId?:string;mediaProvider?:string;
  if(url)attachmentUrls.set(key,{url,at:Date.now()});
  return url;
 }
-// A product card's picture comes from the store: the message carries only the product page link. A found picture is
-// reused for ten minutes and a miss for two, so a refresh never repeats the lookup.
-const productImages=new Map<string,{url:string;at:number}>();
-const productImageLookups=new Map<string,Promise<string>>();
+// A product card's picture comes from the store: the message carries only the product page link. A found product is
+// reused for ten minutes and a miss for two, so a refresh never repeats the lookup. Its id opens it in the app.
+/** `id` is the product the link names (same slug) and opens it in the app; the picture may also come from a product of
+ *  the same name, which never stands in for the link's own product. */
+type FoundProduct={url:string;id:string};
+const productImages=new Map<string,FoundProduct&{at:number}>();
+const productImageLookups=new Map<string,Promise<FoundProduct>>();
 const PRODUCT_IMAGE_TTL_MS=10*60*1000;
 const PRODUCT_IMAGE_MISS_TTL_MS=2*60*1000;
-function productImageFor(slug:string,name:string):Promise<string>{
+function productImageFor(slug:string,name:string):Promise<FoundProduct>{
  // Keyed by both: the search runs on the name, so a miss for one name must not hide a hit for another.
  const key=JSON.stringify([slug,name]);
  const hit=productImages.get(key);
- if(hit&&Date.now()-hit.at<(hit.url?PRODUCT_IMAGE_TTL_MS:PRODUCT_IMAGE_MISS_TTL_MS))return Promise.resolve(hit.url);
+ if(hit&&Date.now()-hit.at<(hit.id?PRODUCT_IMAGE_TTL_MS:PRODUCT_IMAGE_MISS_TTL_MS))return Promise.resolve({url:hit.url,id:hit.id});
  const running=productImageLookups.get(key);
  if(running)return running;
- const lookup=(async()=>{
-  let url='';
+ // A reset (sign-out, another member or business) bumps `epoch`: a lookup it overtook must not fill the new cache.
+ const startEpoch=epoch;
+ const lookup:Promise<FoundProduct>=(async()=>{
+  let url='';let id='';
   try{
    // The name first; then the link's own words, for a product renamed since the message was written. The slug is the
    // identity, so a same-named product with another slug is used only if neither search finds the slug.
@@ -123,13 +130,48 @@ function productImageFor(slug:string,name:string):Promise<string>{
    }
    const match=bySlug??sameName;
    if(match)url=productImage(match);
-  }catch{url='';}
-  productImages.set(key,{url,at:Date.now()});
-  return url;
- })().finally(()=>{productImageLookups.delete(key);});
+   if(bySlug)id=typeof bySlug.id==='string'?bySlug.id:'';
+  }catch{url='';id='';}
+  if(startEpoch===epoch)productImages.set(key,{url,id,at:Date.now()});
+  return {url,id};
+ })().finally(()=>{if(productImageLookups.get(key)===lookup)productImageLookups.delete(key);});
  productImageLookups.set(key,lookup);
  return lookup;
 }
+// A bookings service named by a link's slug, cached like a product (a miss for less time). The first history load
+// routes every row at once, so links to the same service share one lookup while it is running.
+const serviceIds=new Map<string,{id:string;at:number}>();
+const serviceIdLookups=new Map<string,Promise<string>>();
+function serviceIdFor(slug:string):Promise<string>{
+ const hit=serviceIds.get(slug);
+ if(hit&&Date.now()-hit.at<(hit.id?PRODUCT_IMAGE_TTL_MS:PRODUCT_IMAGE_MISS_TTL_MS))return Promise.resolve(hit.id);
+ const running=serviceIdLookups.get(slug);
+ if(running)return running;
+ const startEpoch=epoch;
+ const lookup:Promise<string>=(async()=>{
+  let id='';
+  try{
+   const found=(await queryServices({query:{filter:{'mainSlug.name':{$eq:slug}},paging:{limit:1}}})).services??[];
+   id=typeof found[0]?.id==='string'?found[0].id:'';
+  }catch{id='';}
+  if(startEpoch===epoch)serviceIds.set(slug,{id,at:Date.now()});
+  return id;
+ })().finally(()=>{if(serviceIdLookups.get(slug)===lookup)serviceIdLookups.delete(slug);});
+ serviceIdLookups.set(slug,lookup);
+ return lookup;
+}
+/** A button whose link the app has a screen for opens that screen; a link it cannot place stays a web link. */
+// This app's own site and the screens it has for products and services, as the screen passes them to `init`: only
+// its own site's pages, and only to a screen the app registers, are opened in the app.
+let ownSiteUrl='';
+const ownScreens={product:'',service:''};
+async function routeAction(action:BusinessArticleAction,productName:string):Promise<BusinessArticleAction>{
+ const route=action.routable?businessInAppRoute(action.url,ownSiteUrl):undefined;
+ const screenId=route?ownScreens[route.kind]:'';
+ if(!route||!screenId)return action;
+ const id=route.kind==='product'?(await productImageFor(route.slug,productName)).id:await serviceIdFor(route.slug);
+ return id?{...action,screenId,targetId:id,inApp:true,web:false}:action;
+}
 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','isCard','notCard','noSuggestions','noActions','cardTitle','cardDetail','noCardText','dayLabel','dayHidden','startsDay','scrollAnchor') as unknown as BusinessMessageRow;
@@ -149,9 +191,12 @@ async function presentMessages(existing:MessageRow[],raw:unknown[],memberId?:str
  const presented=presentBusinessMessages(prepared as unknown as Parameters<typeof presentBusinessMessages>[0],raw,businessParticipantId) as unknown as Record<string,unknown>[];
  await Promise.all(presented.map(async row=>{
   const slug=typeof row.productSlug==='string'?row.productSlug:'';
-  if(!slug||row.imageUrl)return;
-  const url=await productImageFor(slug,String(row.productName||''));
-  if(url)Object.assign(row,{imageUrl:url,noImage:false,imageDescription:String(row.productName||'Product image')});
+  const name=String(row.productName||'');
+  if(slug&&!row.imageUrl){
+   const {url}=await productImageFor(slug,name);
+   if(url)Object.assign(row,{imageUrl:url,noImage:false,imageDescription:name||'Product image'});
+  }
+  row.articleActions=await Promise.all((row.articleActions as BusinessArticleAction[]).map(action=>routeAction(action,name)));
  }));
  return presented.map(slimRow);
 }
@@ -178,7 +223,7 @@ function safeError(error:unknown,operation:'load'|'send'|'init'):string{
 }
 async function endSubscription():Promise<void>{const id=subscriptionId;subscriptionId='';if(id)try{await unsubscribeRealtime({subscriptionId:id});}catch{}}
 function clearPrivate(s:State,phase:'guest'|'error'='guest'):State{
- attachmentUrls.clear();productImages.clear();currentIdentity=null;businessParticipantId='';epoch++;void endSubscription();
+ attachmentUrls.clear();productImages.clear();productImageLookups.clear();serviceIds.clear();serviceIdLookups.clear();currentIdentity=null;businessParticipantId='';epoch++;void endSubscription();
  return shape({...initial,phase,error:phase==='guest'?'Sign in to send a message.':s.error});
 }
 let refreshTail:Promise<unknown>=Promise.resolve();
@@ -259,8 +304,11 @@ async function deliver(pending:BusinessChatIntent,draft:string):Promise<void>{
 const svc=defineService<State,Record<string,(s:State,a?:unknown)=>State|undefined|Promise<State|undefined>>>('businessChat',{
  state:shape(initial),notHydrated:Object.keys(initial) as (keyof State)[],
  actions:{
-  init:async s=>{
+  init:async(s,a)=>{
    if(initFlight)return s;initFlight=true;eventDuringInit=false;statusDuringInit=null;
+   // A retry passes no site: the one the screen gave first stays. A site the screen passes, even an empty one (a
+   // business with no site), replaces it, so an earlier business's links are not routed to this one's screens.
+   if(hasParam(a,'siteUrl')){ownSiteUrl=param(a,'siteUrl');ownScreens.product=param(a,'productScreen');ownScreens.service=param(a,'serviceScreen');}
    const oldPrincipal=s.principal;
    const initRevision=draftRevision;
    // Text typed at any point of the load, subscribe step included, outlives the snapshot this started from. So does the
@@ -418,7 +466,7 @@ const svc=defineService<State,Record<string,(s:State,a?:unknown)=>State|undefine
    }
    catch(error){if(startEpoch!==epoch)return undefined;const lost=/member_sign_in_required|MemberAccessChanged|\b401\b|\b403\b/i.test(String(error));return lost?clearPrivate(next,'guest'):shape({...withLiveDraft(next),error:safeError(error,'load'),loadFailure:typeof (error as {businessLoadFailure?:unknown})?.businessLoadFailure==='string'?(error as {businessLoadFailure:string}).businessLoadFailure:safeLoadFailure(error)});}
   },
-  dispose:async s=>{epoch++;attachmentUrls.clear();productImages.clear();currentIdentity=null;businessParticipantId='';await endSubscription();return shape({...initial,phase:'guest'});},
+  dispose:async s=>{epoch++;attachmentUrls.clear();productImages.clear();productImageLookups.clear();serviceIds.clear();serviceIdLookups.clear();currentIdentity=null;businessParticipantId='';await endSubscription();return shape({...initial,phase:'guest'});},
  }
 });
 readServiceState=()=>svc.getState();