@wix/himalaya-cli 0.1387.0 → 0.1389.0

package/guides/sdk-reference.json

@@ -2398,7 +2398,7 @@
         "name": "\"./commerce-contract.js\"",
         "kind": "reexport",
         "jsdoc": "",
-        "decl": "export type {\n  AppleIapCheckoutRoutes, IapCommerce, IapCommerceOptions, IapPurchaseCopy, IapPurchaseFields, IapPurchaseGap, IapPurchaseReadiness,\n} from \"./commerce-contract.js\";"
+        "decl": "export type {\n  AppleIapCheckoutRoutes, IapCommerce, IapCommerceOptions, IapPurchaseCopy, IapPurchaseFields, IapPurchaseGap, IapPurchaseReadiness,\n  IapRestoreResult,\n} from \"./commerce-contract.js\";"
       },
       {
         "name": "createIapCommerce",
@@ -2602,7 +2602,13 @@
         "name": "IapCommerce",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface IapCommerce {\n  /** Routes, display prices, regular-checkout guards and the visible-refresh poll. */\n  readonly pricing: IapCatalogPricing;\n  /** Prices the items the screen shows, scoped to this app by the host. `scopeComplete` is false\n   *  when the host's own identity could not be read, so the screen offers Retry itself. */\n  loadPrices(items: IapCatalogItem[]): Promise<{ scopeComplete: boolean }>;\n  readiness(): IapPurchaseReadiness;\n  /** Whether the latest price load (the screen's or the poll's) had the host's own identity; when\n   *  false the screen offers Retry itself. */\n  scopeComplete(): boolean;\n  state(): AppleIapCheckoutState;\n  /** The item's App Store action, from its price route (the settled one while a refresh resolves),\n   *  purchase readiness and the checkout state. */\n  purchaseFields(reference: CatalogReference, copy: IapPurchaseCopy): IapPurchaseFields;\n  /** Checks readiness, then recovers held purchases and resumes payments already handed over. */\n  start(): Promise<AppleIapCheckoutState>;\n  buy(item: IapOrderItem): Promise<AppleIapCheckoutState>;\n  /** On resume: re-reads Apple's unfinished queue and the payments being tracked. */\n  reconcile(): Promise<AppleIapCheckoutState>;\n  tick(): Promise<AppleIapCheckoutState>;\n  /** The screen's one `_poll` for prices and purchase, or undefined when the cadence it already\n   *  armed still holds (or there is nothing to poll). Emit it from every publish. */\n  pollDirective(action: string): IapPollDirective | undefined;\n  /** The polled action's body: due purchase work — a full reconcile w\n/* … */"
+        "decl": "export interface IapCommerce {\n  /** Routes, display prices, regular-checkout guards and the visible-refresh poll. */\n  readonly pricing: IapCatalogPricing;\n  /** Prices the items the screen shows, scoped to this app by the host. `scopeComplete` is false\n   *  when the host's own identity could not be read, so the screen offers Retry itself. */\n  loadPrices(items: IapCatalogItem[]): Promise<{ scopeComplete: boolean }>;\n  readiness(): IapPurchaseReadiness;\n  /** Whether the latest price load (the screen's or the poll's) had the host's own identity; when\n   *  false the screen offers Retry itself. */\n  scopeComplete(): boolean;\n  state(): AppleIapCheckoutState;\n  /** The item's App Store action, from its price route (the settled one while a refresh resolves),\n   *  purchase readiness and the checkout state. */\n  purchaseFields(reference: CatalogReference, copy: IapPurchaseCopy): IapPurchaseFields;\n  /** Checks readiness, then recovers held purchases and resumes payments already handed over. */\n  start(): Promise<AppleIapCheckoutState>;\n  buy(item: IapOrderItem): Promise<AppleIapCheckoutState>;\n  /** On resume: re-reads Apple's unfinished queue and the payments being tracked. */\n  reconcile(): Promise<AppleIapCheckoutState>;\n  /** Restore purchases (App Review 3.1.1): syncs Apple's purchase history to the device, then makes a\n   *  new attempt at every unfinished purchase (a scheduled retry is not waited out) and re-reads the\n   *  member's access. Needs a signed-in member; taps while one runs share it. */\n  restore(): Promise<IapRestoreResult>;\n  tick(): Promise<AppleIapCheck\n/* … */"
+      },
+      {
+        "name": "IapRestoreResult",
+        "kind": "type",
+        "jsdoc": "/** What a restore found. Counts only: never a product, transaction or member id.\n *  - `needsSignIn`: no member is signed in; Apple was not asked.\n *  - `restored`: `recovered` purchases were taken by Wix during this restore; `refused` stay held,\n *    unfinished, because Wix refused them (another member's purchase, say), plus any Wix refused for good\n *    during this restore (finished; the member needs support); `pending` are charged but\n *    not yet taken (Wix could not be reached, or asked to retry), and stay held for the next attempt.\n *  - `failed`: `storeUnavailable` when the App Store sync or Apple's queue could not be read,\n *    `unavailable` when this host does not sell through the App Store, `sessionChanged` when the\n *    member changed. */",
+        "decl": "export type IapRestoreResult =\n  | { status: \"needsSignIn\" }\n  | { status: \"restored\"; recovered: number; refused: number; pending: number }\n  | { status: \"failed\"; code: \"storeUnavailable\" | \"unavailable\" | \"sessionChanged\" };"
       },
       {
         "name": "IapPurchaseCopy",
@@ -24613,6 +24619,259 @@
       }
     ]
   },
+  {
+    "name": "@himalaya/wix-video",
+    "source": "stdlib/wix-sdk/video/src/index.ts",
+    "description": "Wix Video — channels, videos, covers, durations, playback (native apps; the web bridges refuse its gateway)",
+    "api": [
+      {
+        "name": "isHostedVideo",
+        "kind": "function",
+        "jsdoc": "/** True for a video whose file Wix hosts (it plays through `getVideoStreamUrl`). */",
+        "decl": "export function isHostedVideo(video: WixVideo): boolean;"
+      },
+      {
+        "name": "isVideoReady",
+        "kind": "function",
+        "jsdoc": "/** True when the video is published AND its media is ready to play. */",
+        "decl": "export function isVideoReady(video: WixVideo): boolean;"
+      },
+      {
+        "name": "isVideoProcessing",
+        "kind": "function",
+        "jsdoc": "/** True while an upload is still being processed (try again later). */",
+        "decl": "export function isVideoProcessing(video: WixVideo): boolean;"
+      },
+      {
+        "name": "youtubeVideoId",
+        "kind": "function",
+        "jsdoc": "/** The 11-character YouTube id of a linked YouTube video, or \"\". The embed URL is\n *  treated as data: only the id is taken, never the URL itself. */",
+        "decl": "export function youtubeVideoId(video: WixVideo): string;"
+      },
+      {
+        "name": "videoCoverUrl",
+        "kind": "function",
+        "jsdoc": "/**\n * The video's card image, sized for display: the owner's cover, then the poster, then\n * the media thumbnail, then (for a YouTube video) YouTube's own thumbnail. \"\" when there\n * is none, so a card can show its placeholder.\n *\n * Wix media goes through `wixMediaUrl`: a stored cover is the untouched upload.\n */",
+        "decl": "export function videoCoverUrl(video: WixVideo, size: WixImageSize | null = WIX_LIST_IMAGE): string;"
+      },
+      {
+        "name": "channelCoverUrl",
+        "kind": "function",
+        "jsdoc": "/** The channel's cover image, sized for display, or \"\". */",
+        "decl": "export function channelCoverUrl(channel: WixVideoChannel, size: WixImageSize | null = WIX_LIST_IMAGE): string;"
+      },
+      {
+        "name": "videoDurationSec",
+        "kind": "function",
+        "jsdoc": "/** The video's length in whole seconds, or undefined when the gateway gives none. */",
+        "decl": "export function videoDurationSec(video: WixVideo): number | undefined;"
+      },
+      {
+        "name": "formatVideoDuration",
+        "kind": "function",
+        "jsdoc": "/** \"0:23\", \"4:05\", \"1:02:03\". \"\" for an unknown length. */",
+        "decl": "export function formatVideoDuration(seconds: number | undefined): string;"
+      },
+      {
+        "name": "isPaidVideo",
+        "kind": "function",
+        "jsdoc": "/** True when the video has an enabled SALE or RENT price. */",
+        "decl": "export function isPaidVideo(video: WixVideo): boolean;"
+      },
+      {
+        "name": "canWatchVideo",
+        "kind": "function",
+        "jsdoc": "/**\n * May the current viewer watch this video? FAILS CLOSED: missing pricing on the channel\n * or the video, or an entitlement that cannot be established, is \"no\".\n *\n * A channel with a required subscription or a pricing plan needs an active (or a\n * cancelled but unexpired) subscription. A paid video needs that subscription or its\n * own active sale or rent purchase. Query the channel with `CHANNEL_ACCESS_FIELDS` and\n * the video with `VIDEO_FIELDS`.\n */",
+        "decl": "export function canWatchVideo(channel: WixVideoChannel, video: WixVideo, now = Date.now()): boolean;"
+      },
+      {
+        "name": "latestVideos",
+        "kind": "function",
+        "jsdoc": "/**\n * Up to `limit` ready videos from the channels' preview pages (`listChannels` with\n * `videosPerChannel`, or `listLatestVideos`). Channels take turns — the first video of\n * each channel, then the second of each, … — so one large channel cannot fill the\n * whole rail. Duplicates (one video in two channels) appear once.\n */",
+        "decl": "export function latestVideos(channels: WixVideoChannel[], limit = 8): WixVideoInChannel[];"
+      },
+      {
+        "name": "WixVideoCard",
+        "kind": "interface",
+        "jsdoc": "/** The fields a video card binds to (`$item.*`). Shared by every carousel layout so the\n *  caption placement is a layout choice, never a data change. */",
+        "decl": "export interface WixVideoCard {\n  id: string;\n  channelId: string;\n  title: string;\n  /** \"4:05 · Channel\" — the parts that are known, joined. */\n  meta: string;\n  /** \"4:05\", or \"\". */\n  duration: string;\n  channelTitle: string;\n  coverUrl: string;\n  hasCover: boolean;\n  noCover: boolean;\n  /** True for a paid video (it may ask the viewer to buy or subscribe). */\n  isPaid: boolean;\n  notPaid: boolean;\n  /** One spoken label: title, length and channel. */\n  accessibilityLabel: string;\n}"
+      },
+      {
+        "name": "videoCard",
+        "kind": "function",
+        "jsdoc": "/** Shape one video for a card. `untitled` replaces an empty title. */",
+        "decl": "export function videoCard(entry: WixVideoInChannel, untitled = \"Video\", size: WixImageSize | null = WIX_LIST_IMAGE): WixVideoCard;"
+      },
+      {
+        "name": "WIX_VIDEO_GRAPHQL_URL",
+        "kind": "const",
+        "jsdoc": "/** The Wix Video GraphQL gateway (visitor and member reads). */",
+        "decl": "export const WIX_VIDEO_GRAPHQL_URL = \"https://manage.wix.com/_api/vod/public/graphql\";"
+      },
+      {
+        "name": "WixCallOptions",
+        "kind": "interface",
+        "jsdoc": "/** Per-call options. `site` reads a business other than the app's active one. */",
+        "decl": "export interface WixCallOptions {\n  site?: string;\n}"
+      },
+      {
+        "name": "WixVideoPricing",
+        "kind": "interface",
+        "jsdoc": "/** One price option of a channel (`SUBSCRIPTION` | `PRICING_PLAN`) or a video (`SALE` | `RENT`). */",
+        "decl": "export interface WixVideoPricing {\n  type?: string;\n  enabled?: boolean;\n  /** Channel only: true when every video needs the subscription or plan. */\n  required?: boolean;\n  price?: number;\n  currency?: string;\n  /** Rent period in hours (video) or subscription period (channel). */\n  period?: number;\n}"
+      },
+      {
+        "name": "WixVideoPurchase",
+        "kind": "interface",
+        "jsdoc": "/** The viewer's purchase of a channel subscription or of one video. */",
+        "decl": "export interface WixVideoPurchase {\n  /** `ACTIVE` | `PENDING` | `CANCELED` | `EXPIRED` | … */\n  status?: string;\n  expiresAt?: string;\n}"
+      },
+      {
+        "name": "WixVideoMedia",
+        "kind": "interface",
+        "jsdoc": "/** The uploaded or linked media of a video. */",
+        "decl": "export interface WixVideoMedia {\n  /** `READY` once the file can play; `IN_QUEUE` / `IN_PROGRESS` / … while it processes. */\n  status?: string;\n  /** Length in milliseconds. */\n  duration?: number;\n  thumbnailUrl?: string;\n  /** The embed URL of a linked (YouTube, Vimeo, …) video. */\n  externalUrl?: string;\n  externalId?: string;\n}"
+      },
+      {
+        "name": "WixVideoImage",
+        "kind": "interface",
+        "jsdoc": "/** A selectable image (cover or poster). `selected` is the image URL. */",
+        "decl": "export interface WixVideoImage {\n  selected?: string | null;\n}"
+      },
+      {
+        "name": "WixVideoPage",
+        "kind": "interface",
+        "jsdoc": "/** A page of a paginated list. */",
+        "decl": "export interface WixVideoPage<T> {\n  total?: number;\n  cursor?: string | null;\n  entities?: T[];\n}"
+      },
+      {
+        "name": "WixVideo",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixVideo {\n  id: string;\n  title?: string;\n  description?: string;\n  publisher?: string;\n  /** `COMPUTER` | `GOOGLE_DRIVE` | `DROPBOX` (hosted) | `YOUTUBE` | `VIMEO` | `FACEBOOK` | `LIVE`. */\n  source?: string;\n  /** `VISIBLE` for a published video. */\n  status?: string;\n  cover?: WixVideoImage | null;\n  poster?: WixVideoImage | null;\n  content?: WixVideoMedia | null;\n  pricing?: WixVideoPricing[];\n  /** The viewer's SALE purchase, when the query asks for it. */\n  purchase?: WixVideoPurchase | null;\n  /** The viewer's RENT purchase, when the query asks for it (GraphQL alias). */\n  rent_purchase?: WixVideoPurchase | null;\n}"
+      },
+      {
+        "name": "WixVideoChannel",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WixVideoChannel {\n  id: string;\n  title?: string;\n  description?: string;\n  /** `INTERNAL` | `YOUTUBE`. */\n  source?: string;\n  featuredVideoId?: string | null;\n  hasPaidVideos?: boolean;\n  cover?: WixVideoImage | null;\n  pricing?: WixVideoPricing[];\n  /** The viewer's SUBSCRIPTION purchase, when the query asks for it. */\n  purchase?: WixVideoPurchase | null;\n  /** The channel's videos: only `total` in a list, a page when the query asks for one. */\n  videos?: WixVideoPage<WixVideo>;\n}"
+      },
+      {
+        "name": "WixVideoInChannel",
+        "kind": "interface",
+        "jsdoc": "/** A video together with the channel it belongs to. */",
+        "decl": "export interface WixVideoInChannel {\n  channel: WixVideoChannel;\n  video: WixVideo;\n}"
+      },
+      {
+        "name": "WixVideoErrorFlags",
+        "kind": "interface",
+        "jsdoc": "/** Flags every error this client throws carries, so a caller can branch without\n *  matching message text. */",
+        "decl": "export interface WixVideoErrorFlags {\n  /** The gateway refused the viewer (membership, purchase or permission). */\n  denied: boolean;\n  /** The gateway needs a signed-in member. */\n  signInRequired: boolean;\n  /** The requested channel does not exist or is not visible. */\n  notFound: boolean;\n}"
+      },
+      {
+        "name": "WixVideoError",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type WixVideoError = Error & WixVideoErrorFlags;"
+      },
+      {
+        "name": "wixVideoError",
+        "kind": "function",
+        "jsdoc": "/** Build an error carrying the `WixVideoErrorFlags` (each defaults to false). */",
+        "decl": "export function wixVideoError(message: string, flags: Partial<WixVideoErrorFlags> = {}): WixVideoError;"
+      },
+      {
+        "name": "isWixVideoWebRefusal",
+        "kind": "function",
+        "jsdoc": "/** True when a web bridge refused the gateway URL. Wix Video is then out of reach on\n *  this surface: the same read works in the native apps. */",
+        "decl": "export function isWixVideoWebRefusal(error: unknown): boolean;"
+      },
+      {
+        "name": "wixVideoQuery",
+        "kind": "function",
+        "jsdoc": "/**\n * Run one GraphQL read against the Wix Video gateway and return its `data`.\n *\n * The gateway answers HTTP 200 with an `errors` array for a refused or failed query.\n * That is thrown, never returned as empty data: a failed query must not look like a\n * site with no videos.\n *\n * @scope visitor\n */",
+        "decl": "export async function wixVideoQuery<T>(query: string, variables: Record<string, unknown> = {}, opts?: WixCallOptions): Promise<T>;",
+        "scope": "visitor"
+      },
+      {
+        "name": "wixVideoPages",
+        "kind": "function",
+        "jsdoc": "/** Read every page of a cursor-paginated list. Rows are de-duplicated by id. A\n *  repeated or malformed cursor throws instead of looping or returning a partial list. */",
+        "decl": "export async function wixVideoPages<T extends { id: string }>(\n  fetchPage: (cursor: string | null) => Promise<WixVideoPage<T> | null | undefined>,\n): Promise<T[]>;"
+      },
+      {
+        "name": "CHANNEL_FIELDS",
+        "kind": "const",
+        "jsdoc": "/** The channel fields a list or card needs. */",
+        "decl": "export const CHANNEL_FIELDS = \"id title description source featuredVideoId hasPaidVideos cover { selected } videos { total }\";"
+      },
+      {
+        "name": "CHANNEL_ACCESS_FIELDS",
+        "kind": "const",
+        "jsdoc": "/** The channel fields an access decision needs (`canWatchVideo`). */",
+        "decl": "export const CHANNEL_ACCESS_FIELDS = \"id title pricing { type enabled required } purchase(filter: {type: SUBSCRIPTION}) { status expiresAt }\";"
+      },
+      {
+        "name": "VIDEO_CARD_FIELDS",
+        "kind": "const",
+        "jsdoc": "/** The video fields a card needs: title, images, length and processing state. */",
+        "decl": "export const VIDEO_CARD_FIELDS = \"id title source status cover { selected } poster { selected } content { status duration thumbnailUrl externalUrl externalId } pricing { type enabled }\";"
+      },
+      {
+        "name": "VIDEO_FIELDS",
+        "kind": "const",
+        "jsdoc": "/** The video fields playback and an access decision need. */",
+        "decl": "export const VIDEO_FIELDS = \"id title description source status cover { selected } poster { selected } content { status duration thumbnailUrl externalUrl externalId } pricing { type enabled } purchase(filter: {type: SALE}) { status } rent_purchase: purchase(filter: {type: RENT}) { status }\";"
+      },
+      {
+        "name": "ListChannelsOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface ListChannelsOptions extends WixCallOptions {\n  /** Also read the first N videos of each channel (owner's order). 0 (default) reads none. */\n  videosPerChannel?: number;\n}"
+      },
+      {
+        "name": "listChannels",
+        "kind": "function",
+        "jsdoc": "/**\n * Every channel of the site, in the owner's order (all pages).\n *\n * @scope visitor\n */",
+        "decl": "export async function listChannels(opts: ListChannelsOptions = {}): Promise<WixVideoChannel[]>;",
+        "scope": "visitor"
+      },
+      {
+        "name": "listChannelVideos",
+        "kind": "function",
+        "jsdoc": "/**\n * One channel and all its videos, in the owner's order. Throws a `notFound` error when\n * the channel does not exist.\n *\n * @scope visitor\n */",
+        "decl": "export async function listChannelVideos(channelId: string, opts?: WixCallOptions): Promise<{ channel: WixVideoChannel; videos: WixVideo[] }>;",
+        "scope": "visitor"
+      },
+      {
+        "name": "getVideo",
+        "kind": "function",
+        "jsdoc": "/**\n * One video with its channel's access fields. `null` when the channel does not exist;\n * `video: null` when the channel has no such video.\n *\n * @scope visitor\n */",
+        "decl": "export async function getVideo(channelId: string, videoId: string, opts?: WixCallOptions): Promise<{ channel: WixVideoChannel; video: WixVideo | null } | null>;",
+        "scope": "visitor"
+      },
+      {
+        "name": "getVideoStreamUrl",
+        "kind": "function",
+        "jsdoc": "/**\n * An authorized HLS stream URL for a hosted video (source `COMPUTER`, `GOOGLE_DRIVE`\n * or `DROPBOX`), or \"\" when the gateway gives none. Check `canWatchVideo` first: the\n * gateway authorizes the stream per viewer. A linked (YouTube, …) video has no stream\n * here; use `youtubeVideoId`.\n *\n * @scope visitor\n */",
+        "decl": "export async function getVideoStreamUrl(channelId: string, videoId: string, opts?: WixCallOptions): Promise<string>;",
+        "scope": "visitor"
+      },
+      {
+        "name": "ListLatestVideosOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface ListLatestVideosOptions extends WixCallOptions {\n  /** Most videos to return (default 8). */\n  limit?: number;\n  /** Channels to read (first page, default 10). */\n  channels?: number;\n  /** Videos to read from each channel (default 4). */\n  perChannel?: number;\n}"
+      },
+      {
+        "name": "listLatestVideos",
+        "kind": "function",
+        "jsdoc": "/**\n * The newest ready videos across the site's channels, for a rail or carousel: ONE\n * request that reads the first videos of the first channels. Channel order and each\n * channel's own video order are kept, and the channels take turns, so one large\n * channel cannot fill the whole rail.\n *\n * @scope visitor\n */",
+        "decl": "export async function listLatestVideos(opts: ListLatestVideosOptions = {}): Promise<WixVideoInChannel[]>;",
+        "scope": "visitor"
+      }
+    ]
+  },
   {
     "name": "@himalaya/wix-workflows",
     "source": "stdlib/wix-sdk/workflows-v1/src/index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1387.0",
+  "version": "0.1389.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": "3775f6901bf78a5a41956aac4c29f84e7abbb7149aa95c4bf7552269"
+  "falconPackageHash": "7819e77c37b272b77ba95abb8564fbd979ea16abda28b831b8ce4bc5"
 }

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

@@ -3300,6 +3300,93 @@ const SCREENS = runtimeSetting({
                         "accessibilityLabel": "My subscriptions"
                       }
                     },
+                    {
+                      "id": "himi_account.restore",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "HStack",
+                        "props": {
+                          "spacing": 12,
+                          "children": [
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Icon",
+                                "props": {
+                                  "name": "refresh",
+                                  "size": 18,
+                                  "tint": "accentPrimary"
+                                }
+                              },
+                              "modifiers": {
+                                "accessibilityRole": "decorative"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$service:himiStoreAccount.restoreLabel",
+                                  "style": "bodyEmphasis"
+                                }
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Spacer",
+                                "props": {}
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      "modifiers": {
+                        "background": {
+                          "token": "surfaceElevated"
+                        },
+                        "border": {
+                          "width": 1,
+                          "color": {
+                            "token": "border"
+                          }
+                        },
+                        "cornerRadius": 8,
+                        "padding": {
+                          "leading": 14,
+                          "trailing": 14,
+                          "top": 13,
+                          "bottom": 13
+                        },
+                        "onTap": {
+                          "actionId": "tier5.himiStoreAccount.iapRestore"
+                        },
+                        "pressFeedback": "scale",
+                        "haptic": "light",
+                        "accessibilityLabel": "$service:himiStoreAccount.restoreLabel",
+                        "hiddenPath": "$service:himiStoreAccount.restoreHidden"
+                      }
+                    },
+                    {
+                      "id": "himi_account.restore_message",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "$service:himiStoreAccount.restoreMessage",
+                          "style": "footnote",
+                          "color": "textSecondary",
+                          "collapseWhenEmpty": true
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiStoreAccount.restoreHidden"
+                      }
+                    },
                     {
                       "id": "himi_account.addresses",
                       "body": {
@@ -3729,6 +3816,109 @@ const SCREENS = runtimeSetting({
                 "hiddenPath": "$service:himiStoreAccount.isMember"
               }
             },
+            {
+              "id": "",
+              "body": {
+                "package": "himalaya",
+                "type": "VStack",
+                "props": {
+                  "spacing": 8,
+                  "alignment": "leading",
+                  "children": [
+                    {
+                      "id": "himi_account.restore_guest",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "HStack",
+                        "props": {
+                          "spacing": 12,
+                          "children": [
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Icon",
+                                "props": {
+                                  "name": "refresh",
+                                  "size": 18,
+                                  "tint": "accentPrimary"
+                                }
+                              },
+                              "modifiers": {
+                                "accessibilityRole": "decorative"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$service:himiStoreAccount.restoreLabel",
+                                  "style": "bodyEmphasis"
+                                }
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Spacer",
+                                "props": {}
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      "modifiers": {
+                        "background": {
+                          "token": "surfaceElevated"
+                        },
+                        "border": {
+                          "width": 1,
+                          "color": {
+                            "token": "border"
+                          }
+                        },
+                        "cornerRadius": 8,
+                        "padding": {
+                          "leading": 14,
+                          "trailing": 14,
+                          "top": 13,
+                          "bottom": 13
+                        },
+                        "onTap": {
+                          "actionId": "tier5.himiStoreAccount.iapRestore"
+                        },
+                        "pressFeedback": "scale",
+                        "haptic": "light",
+                        "accessibilityLabel": "$service:himiStoreAccount.restoreLabel",
+                        "hiddenPath": "$service:himiStoreAccount.restoreHidden"
+                      }
+                    },
+                    {
+                      "id": "himi_account.restore_guest_message",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "$service:himiStoreAccount.restoreMessage",
+                          "style": "footnote",
+                          "color": "textSecondary",
+                          "collapseWhenEmpty": true
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiStoreAccount.restoreHidden"
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiStoreAccount.isMember"
+              }
+            },
             {
               "id": "himi_account.language",
               "body": {
@@ -4098,6 +4288,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiStoreAccount.refresh",
           "params": {
             "memberAccountLinks": "1",
+            "restorePurchases": "1",
             "copy": "{\"account.subtitle\":\"Orders, bookings, memberships and saved content in one place.\",\"storeAccount.authBody\":\"Sign in to continue — cart, bookings and memberships stay with you.\",\"storeAccount.authBodyRegister\":\"Create a member account to continue — cart, bookings and memberships stay with you.\"}"
           }
         }
@@ -4109,7 +4300,8 @@ const SCREENS = runtimeSetting({
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
         "wix_api",
-        "app_info"
+        "app_info",
+        "iap"
       ],
       "minBinaryVersion": "0.2.0",
       "bundleVersion": "0.0.1"

package/templates/beauty-salon/tier5-src/_shared/collection-contract.ts

@@ -98,7 +98,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedBadges: { rows: 'badges', title: 'name', subtitle: 'description', view: 'grid' },
   himiBrandedDonations: { rows: 'campaigns', title: 'name', subtitle: 'description', view: 'grid', primaryVerb: { label: 'Donate' } },
   himiBrandedGiftCards: { rows: 'cards', title: 'name', subtitle: 'description', view: 'grid' },
-  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'description', view: 'grid' },
+  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'subtitle', image: 'coverUrl', view: 'grid', searchPlaceholder: 'Search channels', countNoun: ['channel', 'channels'] },
   himiBrandedPodcasts: { rows: 'episodes', title: 'title', subtitle: 'subtitle', image: 'image', metadata: ['progressLabel'], view: 'list' },
   himiBrandedForms: { rows: 'forms', title: 'name', subtitle: 'description', view: 'list' },
   himiBrandedGalleries: { rows: 'galleries', title: 'name', subtitle: 'description', image: 'image', view: 'grid' },

package/templates/beauty-salon/tier5-src/_shared/iap-worker.ts

@@ -2,9 +2,9 @@
 // `@himalaya/iap-checkout` → createIapCommerce), shared by every screen that shows or sells an
 // IAP-backed item. Mapping, Apple prices, payment guards, the host scope and the sale live in the
 // SDK; this only supplies the copy and the hydration reset.
-import type { IapPriceCopy } from "@himalaya/iap";
-import type { IapPurchaseCopy } from "@himalaya/iap-checkout";
-import { copyParam } from "./himi-copy.js";
+import { hostSessionFromGlobal, type IapPriceCopy } from "@himalaya/iap";
+import type { IapCommerce, IapPurchaseCopy, IapRestoreResult } from "@himalaya/iap-checkout";
+import { copyParam, copyTemplate } from "./himi-copy.js";
 
 /** Price labels from the screen's copy pack (`<prefix>.priceLoadingText`, …). */
 export function iapPriceCopy(prefix: string): IapPriceCopy {
@@ -31,6 +31,87 @@ export function iapPurchaseCopy(prefix: string): IapPurchaseCopy {
   };
 }
 
+/** The Restore purchases control (App Review 3.1.1) a screen binds. */
+export interface IapRestoreFields {
+  restoreHidden: boolean;
+  restoreLabel: string;
+  restoreDisabled: boolean;
+  restoreMessage: string;
+}
+
+/** Keep these out of hydration: a restore's answer belongs to the run that got it. */
+export const IAP_RESTORE_KEYS = ["restoreHidden", "restoreLabel", "restoreDisabled", "restoreMessage"] as const;
+
+/** The control before the screen knows it sells through Apple. */
+export const NO_IAP_RESTORE: IapRestoreFields = { restoreHidden: true, restoreLabel: "", restoreDisabled: false, restoreMessage: "" };
+
+export interface IapRestoreControl {
+  /** `sellsThroughApple` is the screen's own signal: its item's App Store route, or Account's
+   *  purchase readiness. */
+  fields(sellsThroughApple: boolean): IapRestoreFields;
+  /** Runs the shared `commerce.restore()`, repainting as it starts and when it answers. A tap while
+   *  one runs is ignored. */
+  run(): Promise<void>;
+}
+
+/** Copy from the screen's pack (`<prefix>.restorePurchasesCta`, …). The restore itself, and the access
+ *  re-read after it, are the shared commerce's. */
+export function createIapRestore(
+  commerce: Pick<IapCommerce, "restore">,
+  options: { prefix: string; repaint(): void; /** The session generation; defaults to the host's. */ generation?: () => number },
+): IapRestoreControl {
+  const generation = options.generation ?? (() => hostSessionFromGlobal().current().generation);
+  let running = false;
+  let message = "";
+  let messageGeneration = -1;
+
+  function say(text: string, forGeneration: number): void {
+    message = text;
+    messageGeneration = forGeneration;
+  }
+
+  async function run(): Promise<void> {
+    if (running) return;
+    running = true;
+    const startedFor = generation();
+    say(copyParam(`${options.prefix}.restoringText`, "Restoring…"), startedFor);
+    options.repaint();
+    // Stamped with the session the tap was for: an answer landing after a sign-out is never shown.
+    say(restoreMessage(await restored(commerce), options.prefix), startedFor);
+    running = false;
+    options.repaint();
+  }
+
+  return {
+    fields: (sellsThroughApple) => ({
+      restoreHidden: !sellsThroughApple,
+      restoreLabel: copyParam(`${options.prefix}.restorePurchasesCta`, "Restore purchases"),
+      restoreDisabled: running,
+      // The answer was for the person signed in when it ran; another session never inherits it.
+      restoreMessage: sellsThroughApple && messageGeneration === generation() ? message : "",
+    }),
+    run,
+  };
+}
+
+function restored(commerce: Pick<IapCommerce, "restore">): Promise<IapRestoreResult> {
+  return commerce.restore().catch(() => ({ status: "failed", code: "storeUnavailable" }) as const);
+}
+
+function restoreMessage(result: IapRestoreResult, prefix: string): string {
+  if (result.status === "needsSignIn") return copyParam(`${prefix}.restoreSignInText`, "Sign in to restore your purchases.");
+  if (result.status === "failed") return result.code === "sessionChanged" ? "" : copyParam(`${prefix}.restoreFailedText`, "Couldn't reach the App Store. Try again.");
+  // Every part that happened is said: a recovery never hides a refusal or a purchase still pending.
+  const parts = [
+    result.recovered === 1 ? copyParam(`${prefix}.restoredOneText`, "Restored 1 purchase.") : "",
+    result.recovered > 1 ? copyTemplate(`${prefix}.restoredManyText`, "Restored {count} purchases.", { count: result.recovered }) : "",
+    // Held unfinished because Wix refused it (another member's purchase, say).
+    result.refused > 0 ? copyParam(`${prefix}.restoreRefusedText`, "A purchase on this Apple ID couldn't be added to this account. Contact support.") : "",
+    result.pending > 0 ? copyParam(`${prefix}.restorePendingText`, "A purchase is still being confirmed. Try again in a moment.") : "",
+  ].filter(Boolean);
+  return parts.length ? parts.join(" ") : copyParam(`${prefix}.restoreUpToDateText`, "Your purchases are up to date.");
+}
+
 /** What `notHydrated` does, for a runtime that ignores the option (a binary older than it, still
  *  served new bundles): put the listed keys back to their declared values before any action runs,
  *  so a persisted price or an enabled purchase action never paints as this run's. */