@wix/himalaya-cli 0.1577.0 → 0.1579.0

package/guides/one-app-section-mappings.md

@@ -51,6 +51,32 @@ The **Himalaya implementation** cell is blank for every unassigned row. Notes on
 | `achievements_carousel_section` | `wix-one-app-achievements.MemberChallengesCarousel` | [Programs data/detail](https://github.com/wix-private/himalaya/blob/97f1542f2f7d6e8cb7a902b912c87dcaa37e5a67/core/dev-server/tier5-bundles-src/himi-branded-lite-programs/index.ts "audience-lint-ok: optional pinned upstream evidence, not a local authoring dependency") + [Core Carousel](https://github.com/wix-private/himalaya/blob/97f1542f2f7d6e8cb7a902b912c87dcaa37e5a67/core/dev-server/src/builder.ts "audience-lint-ok: optional pinned upstream evidence, not a local authoring dependency") | Existing base; adaptation needed | Partial | Reuse the Programs feature and compose a carousel; preserve source extraProps.limit=5 and selected programs. No ready-made legacy Challenges carousel adapter is claimed. |
 | `achievements_participant_carousel_section` | `wix-one-app-achievements.ParticipantChallengesCarousel` |  |  | Empty | The public Programs catalog is not a member-participating-programs carousel. No verified consumer participant/progress list implementation was found. |
 
+For authored Programs sections, pass the source settings as a JSON string in the
+`programsSection` parameter to `tier5.himiBrandedPrograms.load`:
+
+```js
+const programsSection = JSON.stringify({ settings: {
+  sortingSettings: { ordering: "MANUAL", challengesOrder: ["program-id-b", "program-id-a"] },
+} });
+// Source IDs come from the collected section, never customer-specific constants in a template.
+const onAppear = { actionId: "tier5.himiBrandedPrograms.load", params: { programsSection } };
+```
+
+The worker also reads the same string from navigation input at boot. Preserve it
+in the authored section's onAppear params when forwarding the copy pack. A
+copy-only load or Retry retains the last settings. Sending an explicit empty
+settings object, `DEFAULT`, or an empty manual order restores the complete
+newest-first catalog. Manual ordering puts known configured IDs first, then all
+remaining Programs in catalog order; it is not an inclusion list. Stale and
+repeated IDs add no cards. Each worker instance retains its own source settings.
+The collection's member-selected A–Z/Z–A sort still overrides its default order;
+pass `collectionSort: "default"` when opening a source section that must start in
+source order. The member list (`himi_member_programs`) does not read
+`programsSection` and has no manual order yet. This is an authoring recipe, not an
+automatic section importer.
+Category selection, participant status/counts, display flags, limits, See All and
+carousel placement remain separate gaps; the mappings above stay Partial.
+
 ### 3. bookings-section-definitions.json
 
 [Server definitions](https://github.com/wix-private/catalyst-server/blob/617c06d43d2a5608b6876d724553269b1e5346f0/one-app-sections/one-app-sections-definitions/src/main/resources/sections/bookings-section-definitions.json) · 4 definition(s).

package/guides/qa-builds.md

@@ -1210,12 +1210,20 @@ himi dist --app <app> --platform android --aab --wait --target bo
   a bundle id saved in between is refused and stays changeable). The owner must already have the app
   in App Store Connect under that bundle id. The files
   and the key are never stored: the pool and the upload each fetch them again, the job keeps only
-  their hashes. The upload runs on the first status read after the pool validated the IPA; any read
-  the caller may make of the app moves it on, since the owner was proven when the build started (the
-  Containers server's reads carry a project token, not the owner's Wix login). So a caller keeps
-  reading the job until `customerAppStore.status` is `UPLOADED` or `FAILED`, not only until the job
-  is `SUCCESS`: a read that stops early, or gives up mid-upload, leaves the IPA waiting (a claimed
-  upload is retried by a read 15 minutes later).
+  their hashes. The upload starts on its own once the pool reports the validated IPA: the pool's
+  callback starts it in the background, and so does every list read of the app's builds (the owner
+  card's poll) while it can be claimed, which also picks up one a stopped serve pod left. A status
+  read still uploads too; any read the caller may make of the app moves it on, since the owner was
+  proven when the build started (the Containers server's reads carry a project token, not the
+  owner's Wix login). A caller reads the job until `customerAppStore.status` is `UPLOADED` or
+  `FAILED` to learn how it ended; it no longer has to read for the upload to happen. An attempt that
+  fails on a passing error (a 429 or 5xx from mobile-apps-containers-builder or Apple, a timeout, a
+  download that broke off) goes back to `READY_FOR_UPLOAD` with `failedAttempts`, `retryAt` and
+  `lastError`, and is tried again 1, 5 and 15 minutes later. The 4th failed attempt (an attempt
+  whose 15-minute lease ran out counts as one) and any error the owner must fix (no app in App Store
+  Connect, a refused key, a closed version) end `FAILED`, with `error`. When the IPA's 7-day link is
+  within an hour of lapsing, the upload signs a fresh one from the stored bucket and key (the plane's
+  `DIST_ARTIFACT_AWS_*` key pair; without it, the recorded link).
   Refusals, each with `code` equal to `error`: `store_build_ios_only`, `store_build_version_invalid`
   and `store_build_shell_unsupported` 400, `store_build_site_forbidden` 403, `store_id_missing`,
   `store_app_site_taken`, `release_predates_store_builds`, `apple_credentials_missing`,

package/guides/sdk-reference.json

@@ -681,7 +681,7 @@
       {
         "name": "createEvent",
         "kind": "function",
-        "jsdoc": "",
+        "jsdoc": "/** Create an event directly. Needs calendar access — to let the user add an event with\n *  NO permission prompt, use {@link presentEditor} (the system editor) instead. */",
         "decl": "export async function createEvent(event: NewCalendarEvent): Promise<{ id: string | null }>;"
       },
       {
@@ -696,6 +696,48 @@
         "jsdoc": "",
         "decl": "export async function deleteEvent(id: string): Promise<{ deleted: boolean }>;"
       },
+      {
+        "name": "CalendarInfo",
+        "kind": "interface",
+        "jsdoc": "/** A calendar the user has, from {@link listCalendars}. `color` is `#RRGGBB` (\"\" if unknown). */",
+        "decl": "export interface CalendarInfo {\n  id: string;\n  title: string;\n  color: string;\n  allowsModifications: boolean;\n  isPrimary: boolean;\n}"
+      },
+      {
+        "name": "CalendarEditorResult",
+        "kind": "interface",
+        "jsdoc": "/** What {@link presentEditor} resolved with. `saved` is false on cancel. `id` is the new\n *  event's id when the platform can report it — always `null` on Android (ACTION_INSERT\n *  returns no id) and on web, and `null` on iOS without full access. On web, `downloaded`\n *  is true when an .ics file was handed to the browser (the user imports it themselves,\n *  so `saved` stays false). */",
+        "decl": "export interface CalendarEditorResult {\n  saved: boolean;\n  id: string | null;\n  downloaded?: boolean;\n}"
+      },
+      {
+        "name": "CalendarViewerAction",
+        "kind": "type",
+        "jsdoc": "/** How the system viewer was closed. Android reports `done` always (ACTION_VIEW has no result). */",
+        "decl": "export type CalendarViewerAction = \"done\" | \"responded\" | \"deleted\";"
+      },
+      {
+        "name": "presentEditor",
+        "kind": "function",
+        "jsdoc": "/**\n * Open the system event editor prefilled with `event`; the user saves or cancels. Needs\n * NO calendar permission (the OS editor writes the event, not the app). Resolves\n * `{ saved: false, id: null }` on cancel. Web downloads an .ics instead; macOS rejects\n * `unavailable` (no system editor there).\n */",
+        "decl": "export async function presentEditor(event: Partial<NewCalendarEvent> = {}): Promise<CalendarEditorResult>;"
+      },
+      {
+        "name": "presentViewer",
+        "kind": "function",
+        "jsdoc": "/**\n * Show an existing event in the system viewer (iOS EKEventViewController, Android\n * ACTION_VIEW). Needs full calendar access — rejects `permission_denied` without it, and\n * `not_found` when the id does not resolve. Web and macOS reject `unavailable`.\n */",
+        "decl": "export async function presentViewer(id: string): Promise<{ action: CalendarViewerAction }>;"
+      },
+      {
+        "name": "listCalendars",
+        "kind": "function",
+        "jsdoc": "/** The user's calendars. Needs full access — rejects `permission_denied` without it. */",
+        "decl": "export async function listCalendars(): Promise<CalendarInfo[]>;"
+      },
+      {
+        "name": "getEvent",
+        "kind": "function",
+        "jsdoc": "/** One event by id, or `null` when it does not resolve. Needs full access — rejects\n *  `permission_denied` without it. */",
+        "decl": "export async function getEvent(id: string): Promise<CalendarEvent | null>;"
+      },
       {
         "name": "version",
         "kind": "const",
@@ -1017,6 +1059,12 @@
     "source": "core/sdk/clipboard/src/index.ts",
     "description": "Tier-5 typed binding for the system clipboard.",
     "api": [
+      {
+        "name": "\"@himalaya/sdk-types\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export type { FileHandle } from \"@himalaya/sdk-types\";"
+      },
       {
         "name": "writeText",
         "kind": "function",
@@ -1035,11 +1083,59 @@
         "jsdoc": "/** Whether the clipboard holds text — no content access, no iOS paste banner. On\n *  web this can't be known without reading, so it returns true pessimistically;\n *  treat it as a hint, not a guarantee. */",
         "decl": "export async function hasText(): Promise<boolean>;"
       },
+      {
+        "name": "MAX_IMAGE_BYTES",
+        "kind": "const",
+        "jsdoc": "/** Largest image writeImage accepts (20 MB). Hosts enforce it too. */",
+        "decl": "export const MAX_IMAGE_BYTES = 20 * 1024 * 1024;"
+      },
+      {
+        "name": "IMAGE_MIME_TYPES",
+        "kind": "const",
+        "jsdoc": "/** Image MIME types writeImage copies. HEIC is iOS/macOS only (Android and web\n *  reject it `unsupported_type`); web accepts PNG only. The host sniffs the file's\n *  bytes, so a handle is judged by its content, not its `mimeType` — the binding only\n *  refuses up front a handle whose type is plainly not an image (e.g. application/pdf). */",
+        "decl": "export const IMAGE_MIME_TYPES: readonly string[] = [\"image/png\", \"image/jpeg\", \"image/webp\", \"image/heic\"];"
+      },
+      {
+        "name": "ClipboardImageErrorCode",
+        "kind": "type",
+        "jsdoc": "/** Why writeImage rejected. */",
+        "decl": "export type ClipboardImageErrorCode = \"unsupported_type\" | \"too_large\" | \"not_allowed\" | \"not_found\" | \"unavailable\";"
+      },
+      {
+        "name": "ClipboardImageError",
+        "kind": "interface",
+        "jsdoc": "/** A writeImage rejection: an `Error` named \"ClipboardImageError\" carrying a stable\n *  `code`. (A plain Error, not a subclass — Tier-5 bundles target an engine without\n *  class syntax.) Branch on `isClipboardImageError(e) && e.code === \"too_large\"`. */",
+        "decl": "export interface ClipboardImageError extends Error {\n  name: \"ClipboardImageError\";\n  code: ClipboardImageErrorCode;\n}"
+      },
+      {
+        "name": "clipboardImageError",
+        "kind": "function",
+        "jsdoc": "/** Build a coded writeImage rejection. */",
+        "decl": "export function clipboardImageError(code: ClipboardImageErrorCode, message?: string): ClipboardImageError;"
+      },
+      {
+        "name": "isClipboardImageError",
+        "kind": "function",
+        "jsdoc": "/** Whether `e` is a coded writeImage rejection. */",
+        "decl": "export function isClipboardImageError(e: unknown): e is ClipboardImageError;"
+      },
+      {
+        "name": "writeImage",
+        "kind": "function",
+        "jsdoc": "/** Copy an image file the worker already holds to the clipboard. Accepts a\n *  `FileHandle` (from files / camera / photos) or its substrate `uri`. Rejects with a\n *  `ClipboardImageError` (see `isClipboardImageError`) whose `code` is `unsupported_type` (not PNG/JPEG/WebP/HEIC, or\n *  not supported on this host), `too_large` (over 20 MB), `not_allowed` (outside the\n *  app's files substrate), `not_found`, or `unavailable` (no image clipboard here). */",
+        "decl": "export async function writeImage(file: FileHandle | string): Promise<void>;"
+      },
+      {
+        "name": "hasImage",
+        "kind": "function",
+        "jsdoc": "/** Whether the clipboard currently holds an image — without reading it (no iOS paste\n *  banner). Web cannot know without a permission-gated read, so it answers false. */",
+        "decl": "export async function hasImage(): Promise<boolean>;"
+      },
       {
         "name": "version",
         "kind": "const",
         "jsdoc": "/** Capability version, for bundles that gate on min binary version. */",
-        "decl": "export const version = 1;"
+        "decl": "export const version = 2;"
       }
     ]
   },
@@ -1550,20 +1646,68 @@
       {
         "name": "HapticPattern",
         "kind": "type",
-        "jsdoc": "/** Maps to a native impact/notification/selection generator. */",
-        "decl": "export type HapticPattern =\n  | \"selection\"\n  | \"light\"\n  | \"medium\"\n  | \"heavy\"\n  | \"success\"\n  | \"warning\"\n  | \"error\";"
+        "jsdoc": "/**\n * Maps to a native impact/notification/selection generator.\n *\n * - `rigid` / `soft` — iOS `UIImpactFeedbackGenerator.FeedbackStyle.rigid` / `.soft`.\n *   Android: `rigid` is a short full-amplitude click (`VibrationEffect.EFFECT_CLICK`-like),\n *   `soft` a longer low-amplitude tick (`PRIMITIVE_LOW_TICK`-like); on a device without\n *   amplitude control both are plain one-shots of different length.\n */",
+        "decl": "export type HapticPattern =\n  | \"selection\"\n  | \"light\"\n  | \"medium\"\n  | \"heavy\"\n  | \"rigid\"\n  | \"soft\"\n  | \"success\"\n  | \"warning\"\n  | \"error\";"
+      },
+      {
+        "name": "PlayOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface PlayOptions {\n  /**\n   * 0..1, clamped. Scales the strength of an IMPACT style (`light`, `medium`, `heavy`,\n   * `rigid`, `soft`): iOS `impactOccurred(intensity:)`, Android amplitude where the\n   * vibrator has amplitude control. Ignored for `selection` and the notification styles\n   * (`success`, `warning`, `error`) — those have a fixed system strength — and on web.\n   */\n  intensity?: number;\n}"
+      },
+      {
+        "name": "HapticStep",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface HapticStep {\n  pattern: HapticPattern;\n  /** Milliseconds to wait BEFORE this step plays (≥ 0). */\n  delayMs: number;\n  /** Same meaning as {@link PlayOptions.intensity}. */\n  intensity?: number;\n}"
+      },
+      {
+        "name": "HapticResult",
+        "kind": "type",
+        "jsdoc": "/**\n * What a verb reports. `ok: false` is honest: `unavailable` (this surface has no haptic\n * hardware/API — web without `navigator.vibrate`, macOS) or `unsupported_binary` (the\n * native app predates the verb; nothing played, nothing broke).\n */",
+        "decl": "export type HapticResult = { ok: true } | { ok: false; reason: \"unavailable\" | \"unsupported_binary\" };"
+      },
+      {
+        "name": "MAX_SEQUENCE_STEPS",
+        "kind": "const",
+        "jsdoc": "/** Most steps one {@link sequence} may carry. */",
+        "decl": "export const MAX_SEQUENCE_STEPS = 32;"
+      },
+      {
+        "name": "MAX_DURATION_MS",
+        "kind": "const",
+        "jsdoc": "/** Longest a {@link sequence} or {@link vibrate} pattern may run, in milliseconds. */",
+        "decl": "export const MAX_DURATION_MS = 10_000;"
+      },
+      {
+        "name": "clampIntensity",
+        "kind": "function",
+        "jsdoc": "/** Clamp an intensity into 0..1; `undefined` / non-finite → `undefined` (system default). */",
+        "decl": "export function clampIntensity(intensity: number | undefined): number | undefined;"
       },
       {
         "name": "play",
         "kind": "function",
-        "jsdoc": "/**\n * Play a haptic feedback pattern. Fire-and-forget; resolves once handed to the\n * platform. A no-op on web and for unknown patterns.\n */",
-        "decl": "export async function play(pattern: HapticPattern = \"light\"): Promise<void>;"
+        "jsdoc": "/**\n * Play a haptic feedback pattern. Fire-and-forget; resolves once handed to the\n * platform. Unknown pattern names keep their historical behaviour (the platform's\n * default tap). `intensity` applies to impact styles only — see {@link PlayOptions}.\n */",
+        "decl": "export async function play(pattern: HapticPattern = \"light\", options: PlayOptions = {}): Promise<HapticResult>;"
+      },
+      {
+        "name": "sequence",
+        "kind": "function",
+        "jsdoc": "/**\n * Play `steps` in order, waiting each step's `delayMs` before it plays. Runs natively\n * as ONE bridge call (the timing does not depend on the worker), so a drum roll or a\n * countdown keeps its rhythm. A new `sequence` cancels one still running. Resolves once\n * the sequence has been scheduled.\n *\n * Rejects (`RangeError`) with more than {@link MAX_SEQUENCE_STEPS} steps, a negative or\n * non-finite delay, or delays totalling over {@link MAX_DURATION_MS}. An empty list just\n * cancels a running sequence.\n */",
+        "decl": "export async function sequence(steps: HapticStep[]): Promise<HapticResult>;"
+      },
+      {
+        "name": "vibrate",
+        "kind": "function",
+        "jsdoc": "/**\n * Raw vibration: `patternMs` alternates OFF / ON durations in milliseconds, starting\n * with an off gap (`[0, 200, 100, 400]` = buzz 200, pause 100, buzz 400).\n *\n * Android plays it as `VibrationEffect.createWaveform`. iOS approximates: with Core\n * Haptics each ON span is a continuous event (a transient one under 30 ms); without it,\n * each ON span becomes one `heavy` impact at its start. Web uses `navigator.vibrate`.\n *\n * Rejects (`RangeError`) on an empty list, a negative or non-finite duration, or a\n * pattern totalling over {@link MAX_DURATION_MS}.\n */",
+        "decl": "export async function vibrate(patternMs: number[]): Promise<HapticResult>;"
       },
       {
         "name": "version",
         "kind": "const",
         "jsdoc": "/** Capability version, for bundles that gate on a min binary version. */",
-        "decl": "export const version = 1;"
+        "decl": "export const version = 2;"
       }
     ]
   },
@@ -4867,7 +5011,13 @@
         "name": "AlertOptions",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface AlertOptions {\n  /** Required — the native presenters drop alerts with an empty title. */\n  title: string;\n  message?: string;\n  /** Confirm button label. Default \"Confirm\". */\n  confirmLabel?: string;\n  /** Cancel button label. OMIT for a single-button alert (no cancel button). */\n  cancelLabel?: string;\n  /** Style the confirm button with the `danger` token. */\n  destructive?: boolean;\n}"
+        "decl": "export interface AlertOptions {\n  /** Required — the native presenters drop alerts with an empty title. */\n  title: string;\n  message?: string;\n  /** Confirm button label. Default \"Confirm\". */\n  confirmLabel?: string;\n  /** Cancel button label. OMIT for a single-button alert (no cancel button). */\n  cancelLabel?: string;\n  /** Style the confirm button with the `danger` token. A destructive confirm is not the\n   *  affirmative button: its `confirm.actionId` still runs, but without gesture credit. */\n  destructive?: boolean;\n  /** The affirmative button's ACTION. Pressing it runs `actionId` as a NEW invocation\n   *  with user-gesture origin (so an app service's `app.<svc>.<action>` may return `_nav` and\n   *  navigate — the \"Ready — View\" alert). `label` replaces `confirmLabel`. The id is checked when\n   *  you set it, against this worker: a `capability.<id>.*` needs `<id>` allowed, an `app.*` from a\n   *  screen worker needs `app_services` and an exported action, a `tier5.*` must be this worker's\n   *  own; anything else rejects (`action_not_allowed`). Cancel and dismissal run nothing. */\n  confirm?: AlertConfirm;\n}"
+      },
+      {
+        "name": "AlertConfirm",
+        "kind": "interface",
+        "jsdoc": "/** The affirmative button of an `alert()`: its label and the action its press runs. */",
+        "decl": "export interface AlertConfirm {\n  label: string;\n  actionId: string;\n  /** Passed to the action (JSON types kept). */\n  args?: Record<string, unknown>;\n}"
       },
       {
         "name": "AlertResult",
@@ -4878,7 +5028,7 @@
       {
         "name": "alert",
         "kind": "function",
-        "jsdoc": "/** Present a modal alert on the current screen. Resolves when the user picks a\n *  button. Rejects with `ui_busy` while another alert() is pending, and with\n *  `no_ui_host` if the app has no presenter attached. */",
+        "jsdoc": "/** Present a modal alert on the current screen. Resolves when the user picks a\n *  button. Rejects with `ui_busy` while another alert() is pending, and with\n *  `no_ui_host` if the app has no presenter attached — or, from an APP SERVICE, when no\n *  shell is in the foreground (re-show it from `onForeground`). An app service's alert shows on\n *  whatever screen is open. */",
         "decl": "export async function alert(options: AlertOptions): Promise<AlertResult>;"
       },
       {

package/guides/web-page-sdk-reference.md

@@ -19,15 +19,15 @@ the SDK sources, so it matches the shipped SDKs.
 - [`base44`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fbase44?format=md) — A Base44 app's backend. 11 methods · Brandy: conditional.
 - [`biometrics`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fbiometrics?format=md) — Biometric authentication capability. 2 methods.
 - [`browser_auth`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fbrowser_auth?format=md) — Native browser SSO. 1 method.
-- [`calendar`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fcalendar?format=md) — Device calendar. 6 methods.
+- [`calendar`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fcalendar?format=md) — Device calendar. 10 methods.
 - [`calls`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fcalls?format=md) — Real-time 1:1 audio calls (Stage 1). 16 methods.
 - [`camera`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fcamera?format=md) — Camera capability. 4 methods · returns FileHandles.
-- [`clipboard`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fclipboard?format=md) — System clipboard. 3 methods.
+- [`clipboard`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fclipboard?format=md) — System clipboard. 5 methods.
 - [`contacts`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fcontacts?format=md) — Device address book. 4 methods.
 - [`file_picker`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Ffile_picker?format=md) — User-mediated document access OUTSIDE the app sandbox. 3 methods · returns FileHandles.
 - [`files`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Ffiles?format=md) — App-scoped document storage. 6 methods · returns FileHandles.
 - [`godot`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fgodot?format=md) — A Godot game surface. 3 methods · not in Brandy.
-- [`haptic`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fhaptic?format=md) — Haptic capability. 1 method.
+- [`haptic`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fhaptic?format=md) — Haptic capability. 3 methods.
 - [`health`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fhealth?format=md) — Platform HEALTH store. 5 methods.
 - [`himi_apps`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fhimi_apps?format=md) — Cross-app open / host queries. 4 methods · not in Brandy.
 - [`iap`](https://apps.wix.com/_api/himi-serve/authoring/resource/web-sdk%2Fiap?format=md) — In-app-purchase capability. 9 methods.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1577.0",
+  "version": "0.1579.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": "9902ef55d169da2c82868b986ceafb0c54b8102e501f513b72e4c8c0"
+  "falconPackageHash": "939c5230409902d493ec5b28c46a83496669032bc8f663eabd42dcf6"
 }

package/templates/beauty-salon/dev/index.ts

@@ -20977,6 +20977,20 @@ const SCREENS = runtimeSetting({
                                                 "hiddenPath": "$item.noTypeTag"
                                               }
                                             },
+                                            {
+                                              "id": "himi_services.row.$item.id/ended",
+                                              "body": {
+                                                "package": "himalaya",
+                                                "type": "Text",
+                                                "props": {
+                                                  "text": "$item.endedText",
+                                                  "style": "caption",
+                                                  "color": "textSecondary",
+                                                  "maxLines": 1,
+                                                  "collapseWhenEmpty": true
+                                                }
+                                              }
+                                            },
                                             {
                                               "id": "",
                                               "body": {

package/templates/beauty-salon/tier5-src/_shared/himi-bookings.ts

@@ -80,6 +80,19 @@ type CoursePolicyShape = {
   };
 };
 
+/** A completed course, independent of whether bookings are currently allowed. Missing,
+ *  invalid or reversed dates are unknown, never evidence that a course has ended. */
+export function courseHasEnded(service: CoursePolicyShape, now: number): boolean {
+  const start = service.schedule?.firstSessionStart ?? "";
+  const end = service.schedule?.lastSessionEnd ?? "";
+  // The schedule has no zone beside these fields. A local wall time must not be interpreted
+  // in the device's zone and presented as a confirmed business end instant.
+  if (!HAS_OFFSET.test(start) || !HAS_OFFSET.test(end)) return false;
+  const first = validDate(start)?.getTime() ?? NaN;
+  const last = validDate(end)?.getTime() ?? NaN;
+  return Number.isFinite(now) && Number.isFinite(first) && Number.isFinite(last) && first <= last && last <= now;
+}
+
 /** Whether the business takes course bookings at `now` (ms): the course has not ended, has not
  *  started (unless the policy lets people join late), and `now` is inside its booking window —
  *  which the early and late limits count from the first session. */
@@ -238,6 +251,14 @@ export function serviceDurationText(service: PricedServiceShape, label: BookingL
 
 function validDate(value: string | undefined): Date | undefined {
   if (!value) return undefined;
+  const parts = /^(\d{4})-(\d{2})-(\d{2})(?:T|$)/i.exec(value);
+  if (!parts) return undefined;
+  const year = Number(parts[1]), month = Number(parts[2]) - 1, day = Number(parts[3]);
+  // Date accepts February 30 by rolling into March. Check the stated calendar day first;
+  // setUTCFullYear also preserves years 0–99, which Date.UTC would reinterpret as 1900–1999.
+  const calendar = new Date(0);
+  calendar.setUTCFullYear(year, month, day);
+  if (calendar.getUTCFullYear() !== year || calendar.getUTCMonth() !== month || calendar.getUTCDate() !== day) return undefined;
   const date = new Date(value);
   return Number.isFinite(date.getTime()) ? date : undefined;
 }

package/templates/beauty-salon/tier5-src/_shared/himi-copy.ts

@@ -21,6 +21,7 @@
 export type CopyPackValue = string | { source: string; translation: string };
 
 let stashedCopy: Record<string, CopyPackValue> = Object.create(null);
+let copyReceived = false;
 
 /** Absorb the `copy` onAppear param (customer strings or stock translation records)
  *  from an action arg. Call first in every action that can receive onAppear
@@ -44,15 +45,19 @@ export function stashCopy(arg: unknown): void {
       }
     }
     stashedCopy = next;
+    copyReceived = true;
   } catch {
     // Malformed pack param — keep the stock copy rather than dying mid-action.
   }
 }
 
-/** The provisioned override for `key`, or `fallback` (the stock copy) when no
- *  pack / no such key reached this worker. */
-export function copyParam(key: string, fallback: string): string {
+/** The provisioned override for `key`, or `fallback` (the stock copy). An optional
+ *  restored label survives only until a current copy pack arrives. */
+export function copyParam(key: string, fallback: string, restoredFallback = fallback): string {
   const value = stashedCopy[key];
+  // A disk-restored row may paint before onAppear supplies its copy pack. Keep its
+  // last label only before a pack arrives; even an empty current pack selects stock copy.
+  if (value === undefined) return copyReceived ? fallback : restoredFallback;
   if (typeof value === "string") return value !== "" ? value : fallback;
   return value?.source === fallback && value.translation !== "" ? value.translation : fallback;
 }

package/templates/beauty-salon/tier5-src/himi-booking-services/index.ts

@@ -10,7 +10,7 @@
 import { defineBackendCollection } from "../_shared/collection-service.js";
 import { COLLECTION_CHROME_MIN_ITEMS } from "../_shared/collection-contract.js";
 import { queryServiceCategories, queryServices, type WixService } from "@himalaya/wix-bookings";
-import { categoryName, courseDatesText, serviceDurationText, servicePriceLine, type BookingLabel } from "../_shared/himi-bookings.js";
+import { categoryName, courseDatesText, courseHasEnded, serviceDurationText, servicePriceLine, type BookingLabel } from "../_shared/himi-bookings.js";
 import { formatServicePrice } from "../_shared/wix-service-price.js";
 import { getAll, upsert, type DbEntity } from "@himalaya/local-db";
 import { initials } from "../_shared/himi-text.js";
@@ -60,6 +60,9 @@ interface Row {
   /** "Class" or "Course"; "" for an appointment. */
   typeTag: string;
   noTypeTag: boolean;
+  endedText: string;
+  /** Retain course dates so a cached catalog can refresh its status after the course ends. */
+  courseSchedule?: { firstSessionStart?: string; lastSessionEnd?: string };
   /** "1 hr · ₪70"; a course: "Nov 3 – Dec 15, 2026 · ₪1,200". "" when the record has neither. */
   meta: string;
   /** Online booking by time is possible: online booking is on and the service is not a course. */
@@ -186,8 +189,8 @@ function typeTagOf(type: unknown): string {
   return "";
 }
 
-function spokenName(row: Pick<Row, "name" | "typeTag" | "tagline" | "meta">): string {
-  return [row.name, row.typeTag, row.tagline, row.meta].filter(Boolean).join(", ");
+function spokenName(row: Pick<Row, "name" | "typeTag" | "tagline" | "meta" | "endedText">): string {
+  return [row.name, row.typeTag, row.endedText, row.tagline, row.meta].filter(Boolean).join(", ");
 }
 
 function bookCtaFor(request: boolean): string {
@@ -212,6 +215,11 @@ function norm(service: WixService): Row {
   ].filter(Boolean);
   const image = imageUrl(service);
   const isCourse = service.type === "COURSE";
+  const courseSchedule = isCourse ? {
+    firstSessionStart: service.schedule?.firstSessionStart,
+    lastSessionEnd: service.schedule?.lastSessionEnd,
+  } : undefined;
+  const endedText = isCourse && courseHasEnded(service, Date.now()) ? copyParam("services.ended", "Ended") : "";
   const price = servicePriceLine(service, listLabel).text;
   const meta = [isCourse ? courseDatesText(service) : serviceDurationText(service, listLabel), price].filter(Boolean).join(" · ");
   const typeTag = typeTagOf(service.type);
@@ -234,18 +242,20 @@ function norm(service: WixService): Row {
     tagline,
     typeTag,
     noTypeTag: !typeTag,
+    endedText,
+    courseSchedule,
     meta,
     canBook,
     noBook: !canBook,
     bookCta: bookCtaFor(request),
     bookA11y: bookLabel(name, request),
-    a11y: spokenName({ name, typeTag, tagline, meta }),
+    a11y: spokenName({ name, typeTag, endedText, tagline, meta }),
   };
 }
 
 /** A row saved by an older worker (offline cache, restored state) has none of the new
  *  fields: it renders with no tagline, meta or tag, and no Book pill until the live read. */
-function withRowDefaults(row: Partial<Row>): Row {
+function withRowDefaults(row: Partial<Row>, shownEnded?: string): Row {
   const name = typeof row.name === "string" && row.name ? row.name : "Service";
   const str = (v: unknown) => (typeof v === "string" ? v : "");
   const image = str(row.image);
@@ -253,6 +263,9 @@ function withRowDefaults(row: Partial<Row>): Row {
   const tagline = str(row.tagline);
   const meta = str(row.meta);
   const canBook = row.canBook === true;
+  const courseSchedule = row.courseSchedule;
+  const endedText = courseSchedule && courseHasEnded({ schedule: courseSchedule }, Date.now())
+    ? copyParam("services.ended", "Ended", shownEnded || str(row.endedText) || "Ended") : "";
   return {
     ...row,
     id: str(row.id),
@@ -268,12 +281,13 @@ function withRowDefaults(row: Partial<Row>): Row {
     tagline,
     typeTag,
     noTypeTag: !typeTag,
+    endedText,
     meta,
     canBook,
     noBook: !canBook,
     bookCta: str(row.bookCta) || bookCtaFor(false),
     bookA11y: str(row.bookA11y) || bookLabel(name),
-    a11y: str(row.a11y) || spokenName({ name, typeTag, tagline, meta }),
+    a11y: spokenName({ name, typeTag, endedText, tagline, meta }),
   };
 }
 
@@ -287,6 +301,9 @@ let categoriesInFlight = false;
 let categoriesFailedAt = 0;
 const CATEGORY_RETRY_MS = 60_000;
 const rowCategories = new Map<string, number>();
+/** A restored Ended label bridges only the first live page after boot, because an app that sends no
+ *  copy pack gives no sign that none is coming: after it, current copy (pack or stock) decides. */
+let restoredEndedBridge = true;
 
 /** Repaint the chips only, on the state already shown. Re-deriving from the query controller
  *  would publish its working state, which a revalidation deliberately holds back (a restored list
@@ -302,7 +319,7 @@ function withChips(s: S): S {
   // rows of the whole list (no category, no query), or the stand-in would be one category.
   const whole = filter === "all" && !(typeof collection?.query === "string" && collection.query.trim());
   // Not while a load is out: the rows on screen may still be a previous search's.
-  if (!siteCategories?.length && rowCategories.size === 0 && whole && s.isLoading !== true) rememberRowCategories((s.results ?? []).map(withRowDefaults));
+  if (!siteCategories?.length && rowCategories.size === 0 && whole && s.isLoading !== true) rememberRowCategories((s.results ?? []).map((row) => withRowDefaults(row)));
   const chips = categoryChips(filter);
   return { ...s, categoryChips: chips, hideCategories: collection?.hideChrome === true || (chips.length < 3 && !filter.startsWith("value:")) };
 }
@@ -345,6 +362,11 @@ function categoryChips(filter: string): CategoryChip[] {
 
 const svc = defineBackendCollection<S, Row>("himiBookingServices", {
   restorePagesOnLoad: true,
+  onLoad() {
+    // Copy is stashed before this hook. Repaint restored labels immediately, even
+    // when the background query holds the old page through a slow or failed read.
+    (svc as unknown as { normalizeRestored?: () => unknown }).normalizeRestored?.();
+  },
   state: { status: "loading", query: "", all: [], results: [], emptyText: "", countLabel: "", errored: false,
     notErrored: true, isLoading: true, notLoading: false, hasResults: false, noEmpty: true,
     categoryChips: [], hideCategories: true, hideRows: false, noMatchText: "", hasQuery: false, noQuery: true, categoriesLabel: "" },
@@ -377,11 +399,10 @@ const svc = defineBackendCollection<S, Row>("himiBookingServices", {
   },
   actions: {
     categoriesLanded: (s) => withChips(s),
-    // A snapshot saved by an older worker comes back without the new row fields; a missing
-    // `noBook` would show Book on a course until the live read. Give restored rows the defaults.
+    // Normalize old snapshots and refresh Ended/copy before revalidation settles.
+    // A missing `noBook` must never show Book on a restored course.
     normalizeRestored: (s) => {
       const rows = Array.isArray(s.results) ? s.results : [];
-      if (rows.every((row) => typeof (row as Partial<Row>).noBook === "boolean")) return s;
       const fixed = rows.map((row) => withRowDefaults(row as Partial<Row>));
       return { ...s, results: fixed, all: fixed };
     },
@@ -389,7 +410,11 @@ const svc = defineBackendCollection<S, Row>("himiBookingServices", {
   apply(s, page) {
     const loading = page.status === "loading";
     const errored = page.status === "error";
-    const rows = page.items.map(withRowDefaults);
+    // A live row is built before a cold boot's copy pack arrives: the first live page keeps the
+    // Ended label the restored row for the same course showed, until a current pack replaces it.
+    const shown = new Map((restoredEndedBridge && Array.isArray(s.results) ? s.results : []).map((row) => [row.id, row.endedText]));
+    const rows = page.items.map((item) => withRowDefaults(item, shown.get(item.id)));
+    if (page.metadata?.fromCache === false && !loading && !errored) restoredEndedBridge = false;
     // The stand-in categories come from the accepted rows of the whole list (a superseded
     // response never reaches apply): a live page replaces them, the device's copy only fills a gap.
     if (!page.criteria.query && page.criteria.filter === "all" && rows.length > 0) {
@@ -427,7 +452,6 @@ const svc = defineBackendCollection<S, Row>("himiBookingServices", {
 // (there is no Refine now): both go back to the business's own view before the first read.
 type Retired = { getState?: () => { collection?: { filter?: unknown; sort?: unknown } };
   collectionFilter?: (arg: unknown) => unknown; collectionSort?: (arg: unknown) => unknown };
-(svc as unknown as { normalizeRestored?: () => unknown }).normalizeRestored?.();
 const retired = svc as unknown as Retired;
 const persisted = retired.getState?.()?.collection;
 if (persisted?.filter === "saved") void retired.collectionFilter?.({ selectedIds: ["all"] });

package/templates/beauty-salon-owner/tier5-src/_shared/himi-copy.ts

@@ -21,6 +21,7 @@
 export type CopyPackValue = string | { source: string; translation: string };
 
 let stashedCopy: Record<string, CopyPackValue> = Object.create(null);
+let copyReceived = false;
 
 /** Absorb the `copy` onAppear param (customer strings or stock translation records)
  *  from an action arg. Call first in every action that can receive onAppear
@@ -44,15 +45,19 @@ export function stashCopy(arg: unknown): void {
       }
     }
     stashedCopy = next;
+    copyReceived = true;
   } catch {
     // Malformed pack param — keep the stock copy rather than dying mid-action.
   }
 }
 
-/** The provisioned override for `key`, or `fallback` (the stock copy) when no
- *  pack / no such key reached this worker. */
-export function copyParam(key: string, fallback: string): string {
+/** The provisioned override for `key`, or `fallback` (the stock copy). An optional
+ *  restored label survives only until a current copy pack arrives. */
+export function copyParam(key: string, fallback: string, restoredFallback = fallback): string {
   const value = stashedCopy[key];
+  // A disk-restored row may paint before onAppear supplies its copy pack. Keep its
+  // last label only before a pack arrives; even an empty current pack selects stock copy.
+  if (value === undefined) return copyReceived ? fallback : restoredFallback;
   if (typeof value === "string") return value !== "" ? value : fallback;
   return value?.source === fallback && value.translation !== "" ? value.translation : fallback;
 }