@wix/himalaya-cli 0.1324.0 → 0.1325.0

package/guides/sdk-reference.json

@@ -2263,6 +2263,259 @@
       }
     ]
   },
+  {
+    "name": "@himalaya/iap-checkout",
+    "source": "stdlib/flows/iap-checkout/src/index.ts",
+    "description": "@wix/himalaya/iap-checkout — the ONE shared flow that sells a digital Wix item through the App Store, for any screen: a vertical order, its `appleIAP` cashier charge, mobile-apps-wix-iap's payment, the managed StoreKit purchase and the vertical's own access read.",
+    "api": [
+      {
+        "name": "\"./commerce.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export { createIapCommerce } from \"./commerce.js\";"
+      },
+      {
+        "name": "\"./purchase-fields.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export { iapPurchaseFields } from \"./purchase-fields.js\";"
+      },
+      {
+        "name": "\"./apple-iap.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export { createAppleIapCheckout } from \"./apple-iap.js\";"
+      },
+      {
+        "name": "\"./iap-verticals/index.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export { onlineProgramOrders, pricingPlanOrders, storesProductOrders, classifyCart } from \"./iap-verticals/index.js\";"
+      },
+      {
+        "name": "\"./order-refs.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export { createWorkerOrderRefStore } from \"./order-refs.js\";"
+      },
+      {
+        "name": "\"./apple-iap-contract.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export type {\n  AccessRead, AppleIapCheckout, AppleIapCheckoutDependencies, AppleIapCheckoutPhase, AppleIapCheckoutState, BridgeOutcome,\n  BridgeRefusal, CashierRoute, IapEligibility, IapOrderAdapter, IapOrderItem, OrderAttempt, OrderFailureCode,\n  OrderPartitionKey, OrderRef, OrderRefPartition, OrderRefStage, OrderRefStore, PaymentAccess, PaymentProgress,\n  SessionBoundBridge, VerticalRef, WixBridge,\n} from \"./apple-iap-contract.js\";"
+      },
+      {
+        "name": "\"./commerce-contract.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export type {\n  AppleIapCheckoutRoutes, IapCommerce, IapCommerceOptions, IapPurchaseCopy, IapPurchaseFields, IapPurchaseGap, IapPurchaseReadiness,\n} from \"./commerce-contract.js\";"
+      },
+      {
+        "name": "createIapCommerce",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates this worker's App Store commerce: catalog pricing for the items the screen shows, and the\n * shared Apple-IAP checkout for the verticals it sells. Create it once at module scope, call\n * `start()` when the screen boots, `reconcile()` when it resumes, and `tick()` from a `_poll` at\n * `state().nextWakeAt`. Bind the action with `iapPurchaseFields`.\n */",
+        "decl": "export function createIapCommerce(options: IapCommerceOptions = {}): IapCommerce;"
+      },
+      {
+        "name": "iapPurchaseFields",
+        "kind": "function",
+        "jsdoc": "/** Projects a shared checkout into customer-facing action fields; a price alone never grants access. */",
+        "decl": "export function iapPurchaseFields(view: IapItemView, state: AppleIapCheckoutState, readiness: IapPurchaseReadiness, copy: IapPurchaseCopy): IapPurchaseFields;"
+      },
+      {
+        "name": "createAppleIapCheckout",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates the shared Apple-IAP checkout for one worker: vertical order → `appleIAP` cashier\n * charge → wix-iap StartPayment → managed StoreKit purchase → CompletePayment → GetPayment →\n * the vertical's own access read. It reuses `createPurchaseCoordinator` for StoreKit, proof\n * delivery and finishing, and opens content only when the vertical confirms access.\n *\n * NOT ENABLED: it answers `notEnabled` and makes no call until the documented dependencies (a\n * wix-iap route, the cashier route, a real mapping source, a trusted binding, the native identity\n * fence and the finish-policy confirmation) are resolved.\n */",
+        "decl": "export function createAppleIapCheckout(deps: AppleIapCheckoutDependencies): AppleIapCheckout;"
+      },
+      {
+        "name": "createWorkerOrderRefStore",
+        "kind": "function",
+        "jsdoc": "/** Persists unfinished orders per app and member, using the host KV unless storage is supplied. */",
+        "decl": "export function createWorkerOrderRefStore(storage?: KeyValueStorage): OrderRefStore;"
+      },
+      {
+        "name": "WixBridge",
+        "kind": "interface",
+        "jsdoc": "/** The host's Wix REST bridge (`himalaya.wixApi`). Resolves a 2xx body; rejects with\n *  `HTTP <status> [<code>]: <message>` otherwise. Credentials are attached natively.\n *  Same positional shape as the runtime's `wixApiCall`: `expectation` is bridge metadata for a\n *  protected call, after `headers`, and never an HTTP header. */",
+        "decl": "export interface WixBridge {\n  call(\n    method: \"GET\" | \"POST\",\n    path: string,\n    body?: unknown,\n    headers?: Record<string, string>,\n    expectation?: HostCallExpectation,\n  ): Promise<unknown>;\n}"
+      },
+      {
+        "name": "BridgeRefusal",
+        "kind": "type",
+        "jsdoc": "/** Why a bridge call gave no body. `sessionChanged`: the captured session is no longer current,\n *  before the send or after the answer; nothing from it may be used or stored. */",
+        "decl": "export type BridgeRefusal =\n  | { status: \"sessionChanged\" }\n  | { status: \"notEnabled\" }\n  | { status: \"unavailable\" }\n  | { status: \"http\"; httpStatus: number; code: string };"
+      },
+      {
+        "name": "BridgeOutcome",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type BridgeOutcome = { status: \"ok\"; body: unknown } | BridgeRefusal;"
+      },
+      {
+        "name": "SessionBoundBridge",
+        "kind": "interface",
+        "jsdoc": "/** A bridge bound to one captured member session: it refuses to send, and drops the answer,\n *  once that session is no longer current. */",
+        "decl": "export interface SessionBoundBridge {\n  call(method: \"GET\" | \"POST\", path: string, body?: unknown): Promise<BridgeOutcome>;\n  isCurrent(): boolean;\n}"
+      },
+      {
+        "name": "CashierRoute",
+        "kind": "interface",
+        "jsdoc": "/** Cashier pay v2 (`wix.payment.api.pay.v2.PaymentService`). The member-accepted gateway path\n *  is unverified, so there is deliberately no default. */",
+        "decl": "export interface CashierRoute {\n  /** The gateway path that maps to `/api/payments/v2`, without a trailing slash. */\n  prefix: string;\n}"
+      },
+      {
+        "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  /** 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",
+        "kind": "type",
+        "jsdoc": "/** Ids an adapter needs to find its order and the member's access again. No member data. */",
+        "decl": "export type VerticalRef = Record<string, string>;"
+      },
+      {
+        "name": "IapEligibility",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type IapEligibility = { eligible: true } | { eligible: false; reason: OrderFailureCode };"
+      },
+      {
+        "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\" };"
+      },
+      {
+        "name": "AccessRead",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type AccessRead = \"granted\" | \"pending\" | \"none\" | \"unavailable\" | \"sessionChanged\";"
+      },
+      {
+        "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  /** 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}"
+      },
+      {
+        "name": "OrderPartitionKey",
+        "kind": "interface",
+        "jsdoc": "/** Durable, member-partitioned purchase references. Ids only: never a proof or a credential, and\n *  the member id is stored only as a one-way hash in the key. */",
+        "decl": "export interface OrderPartitionKey {\n  purchasesAppId: string;\n  siteId: string;\n  /** The signed-in member's Wix id, from the host session (wix-iap records purchases against it). */\n  memberId: string;\n}"
+      },
+      {
+        "name": "OrderRefStage",
+        "kind": "type",
+        "jsdoc": "/** `held`: Apple charged, and CompletePayment refused the proof without recording it, so the\n *  transaction stays unfinished and is retried. `needsSupport`: recorded and refused for good. */",
+        "decl": "export type OrderRefStage = \"ordered\" | \"charged\" | \"started\" | \"submitted\" | \"held\" | \"needsSupport\";"
+      },
+      {
+        "name": "OrderRef",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface OrderRef {\n  /** `<kind>:<id>` of the item, or `payment:<paymentId>` for a payment with no local order. */\n  key: string;\n  stage: OrderRefStage;\n  kind?: string;\n  verticalRef?: VerticalRef;\n  cashierOrderId?: string;\n  wixTransactionId?: string;\n  paymentId?: string;\n  storeProductId?: string;\n  appProductId?: string;\n  appleTransactionId?: string;\n  /** The StoreKit token StartPayment minted for this payment (D61): recovery finds the order by it. */\n  appAccountToken?: string;\n  updatedAt: number;\n}"
+      },
+      {
+        "name": "OrderRefPartition",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface OrderRefPartition {\n  refs(): readonly OrderRef[];\n  /** False when the write could not be verified as durable; the caller must not proceed. */\n  put(ref: OrderRef): boolean;\n  remove(key: string): boolean;\n}"
+      },
+      {
+        "name": "OrderRefStore",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface OrderRefStore {\n  /** Null when this partition cannot be stored durably: no storage bridge, unreadable or\n   *  unknown-version data. Never an empty stand-in. */\n  open(key: OrderPartitionKey): OrderRefPartition | null;\n  /** Whether any member holds references for this app and site; null when unreadable. Lets a\n   *  start-up skip reading the member and tracking when nothing was ever handed over. */\n  hasRefs(app: { purchasesAppId: string; siteId: string }): boolean | null;\n}"
+      },
+      {
+        "name": "OrderFailureCode",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type OrderFailureCode =\n  | \"notEnabled\" | \"notConfigured\" | \"signInRequired\" | \"unsupportedItem\" | \"notAppleRoute\"\n  | \"storageUnavailable\" | \"approvalRequired\" | \"orderClosed\" | \"orderRefused\" | \"chargeFailed\"\n  | \"paymentRefused\" | \"paymentHeld\" | \"alreadyOwned\" | \"paymentInProgress\" | \"productChanged\"\n  | \"invalidAssociation\" | \"needsSupport\" | \"unavailable\" | \"sessionChanged\";"
+      },
+      {
+        "name": "PaymentAccess",
+        "kind": "type",
+        "jsdoc": "/** Progress of a payment this device handed to wix-iap, tracked from its durable reference. */",
+        "decl": "export type PaymentAccess = \"processing\" | \"granted\" | \"accessUnknown\" | \"needsSupport\";"
+      },
+      {
+        "name": "PaymentProgress",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface PaymentProgress {\n  /** `<kind>:<id>` of the item, or `payment` when no local order is known. */\n  item: string;\n  access: PaymentAccess;\n  nextAttemptAt: number | null;\n}"
+      },
+      {
+        "name": "AppleIapCheckoutPhase",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type AppleIapCheckoutPhase =\n  | \"notEnabled\" | \"idle\" | \"preparing\" | \"purchasing\" | \"awaitingApproval\" | \"processing\"\n  | \"accessReady\" | \"cancelled\" | \"signInRequired\" | \"unavailable\" | \"refused\";"
+      },
+      {
+        "name": "AppleIapCheckoutState",
+        "kind": "interface",
+        "jsdoc": "/** Safe to render: no proof, account token, member, order or payment id. */",
+        "decl": "export interface AppleIapCheckoutState {\n  enabled: boolean;\n  phase: AppleIapCheckoutPhase;\n  /** The item the last `buy` was for, as `<kind>:<id>`. */\n  item: string | null;\n  failure: OrderFailureCode | null;\n  purchase: DeliveryState;\n  payments: PaymentProgress[];\n  nextWakeAt: number | null;\n}"
+      },
+      {
+        "name": "AppleIapCheckoutDependencies",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface AppleIapCheckoutDependencies {\n  wixIap: WixIapClient;\n  /** The member signed in for a captured session, from the trusted host (`memberIdentityOf` over the\n   *  host session). It partitions the references and scopes acknowledgements: wix-iap has no\n   *  customer ids any more (D61). */\n  identity: MemberIdentitySource;\n  /** The same trusted binding the wix-iap client uses; it partitions the stored references. */\n  binding: AppBindingSource;\n  /** The same host provider the wix-iap client was given: every step compares generations. */\n  session: SessionProvider;\n  clock: Clock;\n  cashier: CashierRoute;\n  adapters: readonly IapOrderAdapter[];\n  /** The screen's catalog pricing: the route and the App Store product a sale must match. */\n  pricing: Pick<IapCatalogPricing, \"view\" | \"appleProduct\">;\n  store?: TransactionStore;\n  refs?: OrderRefStore;\n  bridge?: WixBridge;\n  jitter?: (baseDelayMs: number) => number;\n  onState?: (state: AppleIapCheckoutState) => void;\n}"
+      },
+      {
+        "name": "AppleIapCheckout",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface AppleIapCheckout {\n  /** Recovers held purchases and resumes tracking payments already handed over. */\n  start(): Promise<AppleIapCheckoutState>;\n  buy(item: IapOrderItem): Promise<AppleIapCheckoutState>;\n  /** Marks the items the signed-in member already has access to, read from each vertical without an order. */\n  checkAccess(items: readonly IapOrderItem[]): Promise<AppleIapCheckoutState>;\n  reconcile(): Promise<AppleIapCheckoutState>;\n  retry(): Promise<AppleIapCheckoutState>;\n  tick(): Promise<AppleIapCheckoutState>;\n  state(): AppleIapCheckoutState;\n  dispose(): void;\n}"
+      },
+      {
+        "name": "AppleIapCheckoutRoutes",
+        "kind": "interface",
+        "jsdoc": "/** Where the checkout reaches Wix: mobile-apps-wix-iap's Payments service and cashier pay v2, both\n *  as gateway paths the member credential is accepted on. Platform configuration, never a screen's. */",
+        "decl": "export interface AppleIapCheckoutRoutes {\n  wixIap: WixIapRoute;\n  cashier: CashierRoute;\n}"
+      },
+      {
+        "name": "IapPurchaseGap",
+        "kind": "type",
+        "jsdoc": "/** A dependency purchasing needs that this app or host does not have yet. Internal diagnostics:\n *  never customer copy.\n *  - `routes`: no member-callable wix-iap or cashier route is configured.\n *  - `mapping`: no Wix→Apple mapping source is connected.\n *  - `binding`: the binary carries no purchases-app binding for this app.\n *  - `nativeIdentity`: the host cannot bind a request to the signed-in member.\n *  - `managedStore`: managed StoreKit is not enabled on this host (or not iOS).\n *  - `storage`: purchase references cannot be stored durably. */",
+        "decl": "export type IapPurchaseGap = \"routes\" | \"mapping\" | \"binding\" | \"nativeIdentity\" | \"managedStore\" | \"storage\";"
+      },
+      {
+        "name": "IapPurchaseReadiness",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type IapPurchaseReadiness =\n  | { status: \"checking\" }\n  | { status: \"ready\" }\n  | { status: \"unavailable\"; gaps: readonly IapPurchaseGap[] };"
+      },
+      {
+        "name": "IapCommerceOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface IapCommerceOptions {\n  /** The verticals this screen sells. A screen that only shows prices passes none. */\n  adapters?: readonly IapOrderAdapter[];\n  /** After any price, readiness or checkout change; a worker republishes its state here. */\n  onChange?(): void;\n}"
+      },
+      {
+        "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/* … */"
+      },
+      {
+        "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  processing: string;\n  awaitingApproval: string;\n  unavailable: string;\n  signInRequired: string;\n  retry: string;\n  priceChanged: string;\n  support: string;\n}"
+      },
+      {
+        "name": "IapPurchaseFields",
+        "kind": "interface",
+        "jsdoc": "/** What a screen binds for an item's App Store purchase action. */",
+        "decl": "export interface IapPurchaseFields {\n  /** The item sells through the App Store: show this action instead of the regular one. */\n  appleRoute: boolean;\n  /** The vertical confirmed the member's access: open the content instead of selling it. */\n  accessReady: boolean;\n  buyLabel: string;\n  buyDisabled: boolean;\n  buyBusy: boolean;\n  buyNote: string;\n}"
+      }
+    ]
+  },
   {
     "name": "@himalaya/keyboard",
     "source": "core/sdk/keyboard/src/index.ts",
@@ -3495,6 +3748,91 @@
       }
     ]
   },
+  {
+    "name": "@himalaya/screens",
+    "source": "stdlib/flows/screens/src/index.ts",
+    "description": "@wix/himalaya/screens — ready-made sign-in and paywall screens.",
+    "api": [
+      {
+        "name": "ScreenEnvelope",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface ScreenEnvelope {\n  screenId: string;\n  renderer: string;\n  title: string;\n  schemaVersion: number;\n  cacheControl: { maxAge: number; staleWhileRevalidate: number };\n  logicBundle?: { url: string; integrity: string; declaredCapabilities: string[] };\n  payload: { id: string; body: unknown };\n}"
+      },
+      {
+        "name": "AuthCopy",
+        "kind": "interface",
+        "jsdoc": "/** Every user-facing string on the auth screen. Override any subset. */",
+        "decl": "export interface AuthCopy {\n  signInTitle?: string;\n  registerTitle?: string;\n  subhead?: string;\n  emailLabel?: string;\n  passwordLabel?: string;\n  signInCta?: string;\n  registerCta?: string;\n  toRegisterCta?: string;\n  toSignInCta?: string;\n  signOutCta?: string;\n  signedInTitle?: string;\n}"
+      },
+      {
+        "name": "AuthScreenOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface AuthScreenOptions {\n  /** Where the built worker bundle is served from. */\n  bundleUrl: string;\n  screenId?: string;\n  /** Service name — must match `createAuthService({ service })`. */\n  service?: string;\n  title?: string;\n  /** Offer \"create an account\" alongside sign-in. Default true. */\n  register?: boolean;\n  copy?: AuthCopy;\n  /** Buttons shown once signed in, as { label, screenId } — e.g. back to the library. */\n  next?: Array<{ label: string; screenId: string }>;\n}"
+      },
+      {
+        "name": "authScreen",
+        "kind": "function",
+        "jsdoc": "/**\n * The sign-in / create-account screen.\n *\n * Static descriptor, worker-driven layout: every conditional binds a negative\n * flag the service emits, so the descriptor never computes anything.\n */",
+        "decl": "export function authScreen(opts: AuthScreenOptions): ScreenEnvelope;"
+      },
+      {
+        "name": "AuthServiceOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface AuthServiceOptions {\n  /** Must match `authScreen({ service })`. */\n  service?: string;\n  register?: boolean;\n  copy?: AuthCopy;\n}"
+      },
+      {
+        "name": "createAuthService",
+        "kind": "function",
+        "jsdoc": "/**\n * The worker behind `authScreen`. An app's whole worker file is:\n *\n *     import { createAuthService } from \"@wix/himalaya/screens\";\n *     const svc = createAuthService();\n *     export default svc; export { svc };\n *\n * The first load is kicked here, at module scope, so the app cannot forget it.\n */",
+        "decl": "export function createAuthService(opts: AuthServiceOptions = {});"
+      },
+      {
+        "name": "PlanRow",
+        "kind": "interface",
+        "jsdoc": "/** One plan, flattened to the scalar fields an SDUI row template can bind.\n *\n *  Flattened on purpose: a row template binds `$item.<field>` and cannot iterate\n *  a nested list, so the perks arrive as three slots plus their `no…` flags\n *  rather than an array. Three is a deliberate cap — it is what a plan card can\n *  show without becoming a wall of text. */",
+        "decl": "export interface PlanRow {\n  id: string;\n  name: string;\n  description: string;\n  priceLine: string;\n  periodLine: string;\n  perk1: string; perk2: string; perk3: string;\n  noPerk1: boolean; noPerk2: boolean; noPerk3: boolean;\n  badge: string;\n  noBadge: boolean;\n  hasBadge: boolean;\n  /** True when this is the plan the signed-in member currently holds. */\n  joined: boolean;\n  notJoined: boolean;\n  /** \"Current plan\" / \"\" — the label a joined row shows instead of a Join button. */\n  joinedLabel: string;\n  /** Per-row CTA, so the template needs no conditional of its own. */\n  cta: string;\n  appleSupported: boolean;\n  joinDisabled: boolean;\n  joinNote: string;\n}"
+      },
+      {
+        "name": "CheckoutCopy",
+        "kind": "interface",
+        "jsdoc": "/** Every user-facing string on the paywall. Override any subset. */",
+        "decl": "export interface CheckoutCopy {\n  headline?: string;\n  subhead?: string;\n  joinCta?: string;\n  joinedLabel?: string;\n  badgeLabel?: string;\n  /** Shown while the catalog is loading. */\n  loadingText?: string;\n  /** Shown when the site has no plans to sell. */\n  emptyText?: string;\n  loadError?: string;\n  signInFirst?: string;\n  joinedNotice?: string;\n  pendingNotice?: string;\n  handoffNotice?: string;\n  cancelledNotice?: string;\n  failedNotice?: string;\n  goneNotice?: string;\n}"
+      },
+      {
+        "name": "CheckoutServiceOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface CheckoutServiceOptions {\n  /** Must match `checkoutScreen({ service })`. */\n  service?: string;\n  copy?: CheckoutCopy;\n  /** Deep link the cashier returns to, e.g. \"myapp://screen/library\". Without it\n   *  the member completes payment and lands nowhere. */\n  returnTo?: string;\n  /** Plan id to mark with the badge (\"Most popular\"). */\n  featuredPlanId?: string;\n  /** Ask whether the member already holds a plan, so rows can say so. Default\n   *  true. Costs one extra call on load; turn it off only for a pure price list. */\n  showJoined?: boolean;\n}"
+      },
+      {
+        "name": "createCheckoutService",
+        "kind": "function",
+        "jsdoc": "/**\n * The worker behind `checkoutScreen`. An app's whole worker file is:\n *\n *     import { createCheckoutService } from \"@wix/himalaya/screens\";\n *     const svc = createCheckoutService({ returnTo: \"myapp://screen/library\" });\n *     export default svc; export { svc };\n */",
+        "decl": "export function createCheckoutService(opts: CheckoutServiceOptions = {});"
+      },
+      {
+        "name": "CheckoutScreenOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface CheckoutScreenOptions {\n  /** Where the built worker bundle is served from. */\n  bundleUrl: string;\n  screenId?: string;\n  /** Service name — must match `createCheckoutService({ service })`. */\n  service?: string;\n  title?: string;\n  copy?: CheckoutCopy;\n  /** Screen the \"Sign in to continue\" button opens. Omit to drop the button —\n   *  but only if the app genuinely has no sign-in, because the notice it pairs\n   *  with is usually \"sign in to join a plan\" and would otherwise dead-end. */\n  signInScreenId?: string;\n}"
+      },
+      {
+        "name": "checkoutScreen",
+        "kind": "function",
+        "jsdoc": "/**\n * The paywall: browse plans, join one.\n *\n * Every conditional binds a NEGATIVE flag the service emits, so the descriptor\n * computes nothing — `hiddenPath` gates HIDING, and it sits on the\n * NODE as a sibling of `body`, never inside it.\n *\n * The row is a template: `$item.<field>` resolves per row against what\n * `createCheckoutService` puts in `rows`. Every binding used here is a field\n * that service emits — the two halves are pinned together by a test, because a\n * binding no service satisfies renders as nothing and the screen still LOOKS\n * structurally right.\n */",
+        "decl": "export function checkoutScreen(opts: CheckoutScreenOptions): ScreenEnvelope;"
+      },
+      {
+        "name": "(reexport)",
+        "kind": "reexport",
+        "jsdoc": "/** Re-exported so a gated screen can ask the entitlement question without also\n *  importing @wix/himalaya/checkout directly. Same fail-closed door. */",
+        "decl": "export { entitlement };"
+      }
+    ]
+  },
   {
     "name": "@himalaya/sdk-types",
     "source": "core/sdk/sdk-types/src/index.ts",
@@ -23289,7 +23627,7 @@
         "name": "StoreProduct",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface StoreProduct {\n  id?: 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}"
+        "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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1324.0",
+  "version": "0.1325.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": "bf9e4b60f45454490675830b87c19b099668fb282ba36c4e4842116d"
+  "falconPackageHash": "59d136e19e06159bf0072aeaadce11576db7a226a5eef4c05f2d9023"
 }

package/templates/beauty-salon/config.ts

@@ -37,7 +37,7 @@ export default defineApp({
     actions: "http://localhost:8190/v1/actions",
     sync: "http://localhost:8190/v1/sync",
   },
-  capabilities: ["live_activity","push","share","secure_storage","open_url","calendar","local_database","wix_api","wix_platform","app_info","release_control","clipboard"],
+  capabilities: ["live_activity","push","share","secure_storage","open_url","calendar","local_database","wix_api","wix_platform","app_info","iap","release_control","clipboard"],
   designTokensPath: "./tokens.json",
   navigation: {
     "navKind": "responsive",

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

@@ -2384,7 +2384,9 @@ const SCREENS = runtimeSetting({
       "integrity": "",
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
-        "wix_api"
+        "wix_api",
+        "iap",
+        "app_info"
       ],
       "minBinaryVersion": "0.2.0",
       "bundleVersion": "0.0.1"
@@ -7875,7 +7877,9 @@ const SCREENS = runtimeSetting({
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
         "wix_api",
-        "local_database"
+        "local_database",
+        "iap",
+        "app_info"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -8343,7 +8347,11 @@ const SCREENS = runtimeSetting({
       "url": "http://localhost:8190/v1/bundles/himi-store-saved",
       "integrity": "",
       "contentType": "application/javascript+ts-bundle",
-      "declaredCapabilities": [],
+      "declaredCapabilities": [
+        "wix_api",
+        "iap",
+        "app_info"
+      ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
     }
@@ -9869,7 +9877,9 @@ const SCREENS = runtimeSetting({
         "wix_cashier",
         "open_url",
         "local_database",
-        "wix_platform"
+        "wix_platform",
+        "iap",
+        "app_info"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -18904,7 +18914,8 @@ const SCREENS = runtimeSetting({
                                                 "package": "himalaya",
                                                 "type": "Button",
                                                 "props": {
-                                                  "title": "Join on website",
+                                                  "title": "$item.joinLabel",
+                                                  "disabledPath": "$item.joinDisabled",
                                                   "style": "primary",
                                                   "fullWidth": true,
                                                   "action": {
@@ -18925,7 +18936,8 @@ const SCREENS = runtimeSetting({
                                                 "package": "himalaya",
                                                 "type": "Button",
                                                 "props": {
-                                                  "title": "Join on website",
+                                                  "title": "$item.joinLabel",
+                                                  "disabledPath": "$item.joinDisabled",
                                                   "style": "secondary",
                                                   "fullWidth": true,
                                                   "action": {
@@ -19106,7 +19118,8 @@ const SCREENS = runtimeSetting({
                                                         "package": "himalaya",
                                                         "type": "Button",
                                                         "props": {
-                                                          "title": "Join on website",
+                                                          "title": "$item.joinLabel",
+                                                          "disabledPath": "$item.joinDisabled",
                                                           "style": "primary",
                                                           "fullWidth": true,
                                                           "action": {
@@ -19127,7 +19140,8 @@ const SCREENS = runtimeSetting({
                                                         "package": "himalaya",
                                                         "type": "Button",
                                                         "props": {
-                                                          "title": "Join on website",
+                                                          "title": "$item.joinLabel",
+                                                          "disabledPath": "$item.joinDisabled",
                                                           "style": "secondary",
                                                           "fullWidth": true,
                                                           "action": {
@@ -19532,7 +19546,8 @@ const SCREENS = runtimeSetting({
                                                 "package": "himalaya",
                                                 "type": "Button",
                                                 "props": {
-                                                  "title": "Join on website",
+                                                  "title": "$item.joinLabel",
+                                                  "disabledPath": "$item.joinDisabled",
                                                   "style": "primary",
                                                   "fullWidth": true,
                                                   "action": {
@@ -19553,7 +19568,8 @@ const SCREENS = runtimeSetting({
                                                 "package": "himalaya",
                                                 "type": "Button",
                                                 "props": {
-                                                  "title": "Join on website",
+                                                  "title": "$item.joinLabel",
+                                                  "disabledPath": "$item.joinDisabled",
                                                   "style": "secondary",
                                                   "fullWidth": true,
                                                   "action": {
@@ -19734,7 +19750,8 @@ const SCREENS = runtimeSetting({
                                                         "package": "himalaya",
                                                         "type": "Button",
                                                         "props": {
-                                                          "title": "Join on website",
+                                                          "title": "$item.joinLabel",
+                                                          "disabledPath": "$item.joinDisabled",
                                                           "style": "primary",
                                                           "fullWidth": true,
                                                           "action": {
@@ -19755,7 +19772,8 @@ const SCREENS = runtimeSetting({
                                                         "package": "himalaya",
                                                         "type": "Button",
                                                         "props": {
-                                                          "title": "Join on website",
+                                                          "title": "$item.joinLabel",
+                                                          "disabledPath": "$item.joinDisabled",
                                                           "style": "secondary",
                                                           "fullWidth": true,
                                                           "action": {
@@ -20333,7 +20351,8 @@ const SCREENS = runtimeSetting({
                                               "package": "himalaya",
                                               "type": "Button",
                                               "props": {
-                                                "title": "Join on website",
+                                                "title": "$item.joinLabel",
+                                                "disabledPath": "$item.joinDisabled",
                                                 "style": "primary",
                                                 "fullWidth": true,
                                                 "action": {
@@ -20354,7 +20373,8 @@ const SCREENS = runtimeSetting({
                                               "package": "himalaya",
                                               "type": "Button",
                                               "props": {
-                                                "title": "Join on website",
+                                                "title": "$item.joinLabel",
+                                                "disabledPath": "$item.joinDisabled",
                                                 "style": "secondary",
                                                 "fullWidth": true,
                                                 "action": {
@@ -20632,7 +20652,9 @@ const SCREENS = runtimeSetting({
         "wix_api",
         "wix_cashier",
         "open_url",
-        "wix_platform"
+        "wix_platform",
+        "iap",
+        "app_info"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -20888,7 +20910,9 @@ const SCREENS = runtimeSetting({
       "integrity": "",
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
-        "wix_api"
+        "wix_api",
+        "iap",
+        "app_info"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -25683,7 +25707,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
       "declaredCapabilities": [
         "wix_api",
         "local_database",
-        "live_activity"
+        "live_activity",
+        "iap",
+        "app_info"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -26565,7 +26591,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
         "wix_api",
         "share",
         "local_database",
-        "open_url"
+        "open_url",
+        "iap",
+        "app_info"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"

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

@@ -87,7 +87,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedOrders: { rows: 'rows', title: 'title', subtitle: 'subtitle', view: 'list', backendQuery: true,
     searchPlaceholder: 'Search by order number', countNoun: ['order', 'orders'], filterValues: ['Not fulfilled', 'Partially fulfilled', 'Fulfilled'],
     sortLabels: { default: 'Newest', az: 'Oldest', za: 'Order # ↓' } },
-  himiBrandedPlans: { rows: 'rows', title: 'name', subtitle: 'description', metadata: ['badge', 'priceLine', 'periodLine', 'trialBadge', 'perk1', 'perk2', 'perk3'], view: 'grid', gridColumns: 1, metaMaxLines: 8, countNoun: ['plan', 'plans'] },
+  himiBrandedPlans: { rows: 'rows', title: 'name', subtitle: 'description', metadata: ['badge', 'priceLine', 'periodLine', 'trialBadge', 'perk1', 'perk2', 'perk3', 'joinNote'], view: 'grid', gridColumns: 1, metaMaxLines: 8, countNoun: ['plan', 'plans'] },
   himiBrandedPrograms: { rows: 'rows', title: 'name', subtitle: 'description', image: 'image', view: 'grid' },
   himiBrandedCoupons: { rows: 'coupons', title: 'name', subtitle: 'subtitle', view: 'list', primaryVerb: { label: 'Get code' } },
   himiBrandedNotifications: { rows: 'items', title: 'name', subtitle: 'subtitle', image: 'photo', metadata: ['unreadDot'], view: 'list' },

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

@@ -323,6 +323,7 @@ export function decorateCollection(name: string, def: { state: State; actions?:
 /** Domain-owned page source with shared query controls. Publishing uses a normal
  * reducer and reads the private controller snapshot, never an SDUI payload. */
 export function defineBackendCollection<S extends object, Row extends object>(name: string, options: {
+  register?: typeof register;
   /** Revalidate already opened pages on navigation return; explicit refresh resets. */
   restorePagesOnLoad?: boolean;
   /** The load action's argument (onAppear params beyond `copy`), before the query runs — for a
@@ -342,7 +343,7 @@ export function defineBackendCollection<S extends object, Row extends object>(na
     controller: controller as unknown as BackendCollection['controller'],
     apply: (state, page) => options.apply(state as S, page as unknown as CollectionQueryState<Row>) as State,
   });
-  const handle = register(name, definition);
+  const handle = (options.register ?? register)(name, definition);
   publish = () => handle.collectionDataChanged();
   return handle;
 }
@@ -350,7 +351,7 @@ export function defineBackendCollection<S extends object, Row extends object>(na
 /** Keep the domain service's existing TypeScript API. Extra collection verbs are
  * dispatched through SDUI and do not widen the native capability surface. */
 export const defineService: typeof register = ((name: string, def: ServiceDefinition<unknown>) =>
-  register(name, decorateCollection(name, def as unknown as { state: State; actions?: Record<string, Reducer> }))) as typeof register;
+  register(name, { ...def, ...decorateCollection(name, def as unknown as { state: State; actions?: Record<string, Reducer> }) } as ServiceDefinition<State>)) as typeof register;
 
 /** Domains can supply their existing saved-items store without putting domain
  * data or mutations in the shared collection layer. */