@wix/himalaya-cli 0.1634.0 → 0.1635.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/dev-server/src/app-config.d.ts

@@ -84,6 +84,7 @@ export interface NavigationConfig {
     /** Signed release allowlist for contained browser Tier-5 `_stream` requests. */
     streamPolicy?: StreamPolicy;
     topBarLogo?: import("@wix/himalaya/core").TopBarLogo;
+    presentationQueue?: boolean;
     splash?: SplashConfig;
     locale?: LocaleConfig;
     backAffordance?: BackAffordanceConfig;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/dev-server/src/app-module.d.ts

@@ -237,6 +237,8 @@ export interface DerivedAppMeta {
     /** Forwarded from AppConfig.navigation.topBarLogo — the app-wide logo for tab-stack roots
      *  (RFC 0066 amendment "top-bar gap items"). */
     topBarLogo?: import("@wix/himalaya/core").TopBarLogo;
+    /** Forwarded from AppConfig.navigation.presentationQueue — the opt-in host alert queue (#4662). */
+    presentationQueue?: boolean;
     /** Forwarded from AppConfig.`splash` — the in-app splash surface. NOTE the
      *  asymmetry with the fields above: this reads the TOP-LEVEL `config.splash`, not
      *  `config.navigation.splash`, because the same block also drives the build-time

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/iap/src/wix-payments-contract.d.ts

@@ -121,11 +121,12 @@ export interface WixIapPayment {
     canceledDate?: string;
     refundedDate?: string;
 }
-export type WixIapOperation = "startPayment" | "startItemPayment" | "completePayment" | "getPayment";
+export type WixIapOperation = "startPayment" | "startItemPayment" | "completePayment" | "cancelPayment" | "getPayment";
 export type StartPaymentErrorCode = "NOT_PENDING" | "WRONG_PAYMENT_METHOD" | "NOT_ORDER_BUYER" | "UNSUPPORTED_ORDER" | "PRODUCT_NOT_AVAILABLE" | "ALREADY_OWNED" | "APP_NOT_CONFIGURED" | "SUBSCRIPTION_NOT_IN_APP" | "ALREADY_SUBSCRIBED";
-export type StartItemPaymentErrorCode = "PRODUCT_NOT_AVAILABLE" | "ALREADY_OWNED" | "ITEM_NOT_AVAILABLE" | "SITE_NOT_ACCEPTING_PAYMENTS" | "UNSUPPORTED_ORDER";
+export type StartItemPaymentErrorCode = "PRODUCT_NOT_AVAILABLE" | "ALREADY_OWNED" | "ITEM_NOT_AVAILABLE" | "SITE_NOT_ACCEPTING_PAYMENTS" | "UNSUPPORTED_ORDER" | "CATALOG_NOT_SUPPORTED" | "VERTICAL_ACCESS_DENIED" | "EVENT_CHECKOUT_NOT_ECOM" | "ALREADY_SUBSCRIBED" | "SUBSCRIPTION_NOT_IN_APP" | "BILLING_COUNTRY_REQUIRED" | "APP_NOT_CONFIGURED" | "NOT_BOOKING_OWNER" | "BOOKING_PAYMENT_PENDING";
 export type CompletePaymentErrorCode = "INVALID_PURCHASE" | "OWNED_BY_ANOTHER_CUSTOMER" | "PURCHASE_REVOKED" | "NOT_PURCHASED" | "ZERO_PRICE" | "NO_MATCHING_PAYMENT" | "PAYMENT_NOT_PENDING" | "APP_NOT_CONFIGURED";
 export type GetPaymentErrorCode = "NOT_FOUND";
+export type CancelPaymentErrorCode = "NOT_PENDING" | "APP_NOT_CONFIGURED" | "NOT_FOUND";
 /** Why a call gave no usable answer, other than a named application error.
  *  `unavailable` and `sessionChanged` say nothing about whether the request took effect.
  *  `unrecognized` is an HTTP refusal this client cannot name: never treat it as terminal.
@@ -155,12 +156,15 @@ export type StartPaymentResult = {
     storeProductId: string;
     appAccountToken: string;
 } | WixIapFailure<StartPaymentErrorCode>;
-/** One item a Wix catalog sells through eCom, as eCom's `catalogReference` names it: for Wix Stores,
- *  the product id and the Stores app id. The purchases catalog sells it under `catalogItemId` as its
- *  `appProductId`. Variants and options are not supported, and the quantity is always 1. */
+/** One item a Wix catalog sells, as eCom's `catalogReference` names it: the item id and its catalog
+ *  app. The purchases catalog sells it under `catalogItemId` as its `appProductId`. `options` go to
+ *  eCom unchanged and are each vertical's own: a plan's `{type: "PLAN", planOptions: {pricingVariantId}}`,
+ *  a booking's `{bookingId}`, a ticket's `{eventId}`, a Stores variant's `{variantId}`. Plain JSON only.
+ *  The quantity is always 1. */
 export interface EcomCatalogReference {
     catalogItemId: string;
     catalogAppId: string;
+    options?: Record<string, unknown>;
 }
 /** StartItemPayment was handed to the transport and gave no answer this client can act on: an
  *  outage, a lost or late answer, or a 2xx it could not decode. The service may have placed an
@@ -172,16 +176,18 @@ export interface StartItemPaymentOutcomeUnknown {
     kind: WixIapFailureKind;
     httpStatus?: number;
 }
-/** StartItemPayment places the member's eCom order for one catalog item, charges it with
- *  `appleIAP` and starts its Payment, all server-side. Four different ids come back: the eCom
- *  order (`ecomOrderId`), the Wix Payments charge (`payment.wixTransactionId`), the wix-iap
- *  Payment (`payment.paymentId`) and the StoreKit `appAccountToken`. Keep them out of screen state. */
+/** StartItemPayment places the member's order for one catalog item, charges it with `appleIAP` and
+ *  starts its Payment, all server-side. Four different ids come back: the vertical's record (the eCom
+ *  order, `ecomOrderId`; for Online Programs the join application, `joinApplicationId`, and no eCom
+ *  order), the Wix Payments charge (`payment.wixTransactionId`), the wix-iap Payment
+ *  (`payment.paymentId`) and the StoreKit `appAccountToken`. Keep them out of screen state. */
 export type StartItemPaymentResult = {
     status: "started";
     payment: WixIapPayment;
     storeProductId: string;
     appAccountToken: string;
-    ecomOrderId: string;
+    ecomOrderId?: string;
+    joinApplicationId?: string;
 } | WixIapFailure<StartItemPaymentErrorCode> | StartItemPaymentOutcomeUnknown;
 /** `matched`: the server verified the proof and paid the payment whose token the Apple transaction
  *  carries. Its status may still be `approving`. */
@@ -193,3 +199,9 @@ export type GetPaymentResult = {
     status: "found";
     payment: WixIapPayment;
 } | WixIapFailure<GetPaymentErrorCode>;
+/** `answered`: the Payment as CancelPayment left it, `canceling`, `canceled`, or `approved` when a
+ *  purchase the store already reported paid it instead. Only `canceled` means nothing was paid. */
+export type CancelPaymentResult = {
+    status: "answered";
+    payment: WixIapPayment;
+} | WixIapFailure<CancelPaymentErrorCode>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/iap/src/wix-payments-wire.d.ts

@@ -10,13 +10,19 @@ export interface CallScope {
     prefix: string;
 }
 export declare function startPaymentCall(scope: CallScope, wixTransactionId: string): WixIapCall;
-/** The app by its bundle, like every device call (catalyst-server #24546), and only the two ids
- *  StartItemPaymentRequest.item has: no quantity, options or member. */
-export declare function startItemPaymentCall(scope: CallScope, item: EcomCatalogReference): WixIapCall;
-/** CatalogReference's limits: `catalog_item_id` 1–36 characters, `catalog_app_id` a GUID. */
+/** The app by its bundle, like every device call (catalyst-server #24546), and only what
+ *  StartItemPaymentRequest has: the item's ids and options, and StoreKit's storefront country, which
+ *  a Pricing Plans order bills in (#24878). Never a quantity or the member. */
+export declare function startItemPaymentCall(scope: CallScope, item: EcomCatalogReference, storeCountryCode?: string): WixIapCall;
+/** CatalogReference's limits: `catalog_item_id` 1–36 characters, `catalog_app_id` a GUID, `options` a
+ *  protobuf Struct, so plain JSON. Empty options are dropped; any other shape refuses the item. */
 export declare function catalogItemOf(raw: unknown): EcomCatalogReference | null;
+/** StoreKit's `Storefront.countryCode`: ISO 3166-1 alpha-3, uppercase. */
+export declare function isStoreCountryCode(value: unknown): value is string;
 /** The JWS goes byte-for-byte: the server derives the member, and the proof names the product. */
 export declare function completePaymentCall(scope: CallScope, signedTransaction: string): WixIapCall;
+/** The member's own Payment, by id; the bundle names the app as on every device call (#24894). */
+export declare function cancelPaymentCall(scope: CallScope, paymentId: string): WixIapCall;
 export declare function paymentCall(scope: CallScope, paymentId: string): WixIapCall;
 /** A gateway path such as `/_api/<service>/v1`: absolute, no trailing slash, query or scheme. */
 export declare function isRoutePrefix(prefix: string): boolean;
@@ -34,10 +40,14 @@ export interface StartedPayment {
 }
 /** D61: the token is this payment's purchase intent; no other field may stand in for it. */
 export declare function decodeStarted(raw: unknown, expected: PaymentExpectation): StartedPayment | null;
+/** An eCom order for every catalog but Online Programs, which answers its join application instead
+ *  (#24880). */
 export interface StartedItemPayment extends StartedPayment {
-    ecomOrderId: string;
+    ecomOrderId?: string;
+    joinApplicationId?: string;
 }
-/** As StartPayment's answer, plus the member's eCom order. The Payment must name the requested
+/** As StartPayment's answer, plus the member's eCom order or, for Online Programs, join application.
+ *  The Payment must name the requested
  *  item: StartItemPayment builds it from the catalog entry it looked up, whose `appProductId` is
  *  the catalog item id, so a Payment that names none is not known to be this item's. */
 export declare function decodeStartedItem(raw: unknown, expected: PaymentExpectation & {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/iap/src/wix-payments.d.ts

@@ -1,6 +1,6 @@
 import type { AppleTransaction } from "./index.js";
 import type { SessionProvider } from "./delivery-contract.js";
-import type { AppBindingSource, EcomCatalogReference, StartItemPaymentResult, CompletePaymentResult, GetPaymentResult, IapAppHost, MemberIdentitySource, StartPaymentResult, WixIapRoute, WixTransport } from "./wix-payments-contract.js";
+import type { AppBindingSource, CancelPaymentResult, EcomCatalogReference, StartItemPaymentResult, CompletePaymentResult, GetPaymentResult, IapAppHost, MemberIdentitySource, StartPaymentResult, WixIapRoute, WixTransport } from "./wix-payments-contract.js";
 export interface WixIapClientDependencies {
     /** The trusted host session; each call is bound to the generation current when it starts. */
     session: SessionProvider;
@@ -18,11 +18,13 @@ export interface WixIapClient {
     startPayment(input: {
         wixTransactionId: string;
     }): Promise<StartPaymentResult>;
-    /** StartItemPayment for one catalog item: the service places the member's eCom order, charges it
-     *  and starts its Payment. Every call places a new order, so `outcomeUnknown` must never be
-     *  resent as if nothing happened. Returns the store product, the token and the eCom order. */
+    /** StartItemPayment for one catalog item: the service places the member's order, charges it and
+     *  starts its Payment. Every call places a new order, so `outcomeUnknown` must never be resent as
+     *  if nothing happened. `storeCountryCode` is StoreKit's storefront country (alpha-3), sent when
+     *  known. Returns the store product, the token and the eCom order or join application. */
     startItemPayment(input: {
         item: EcomCatalogReference;
+        storeCountryCode?: string;
     }): Promise<StartItemPaymentResult>;
     /** CompletePayment with held Apple proof, sent unchanged: the service pays the payment whose
      *  token the transaction carries. Success can still be `approving`. */
@@ -31,6 +33,11 @@ export interface WixIapClient {
     getPayment(input: {
         paymentId: string;
     }): Promise<GetPaymentResult>;
+    /** CancelPayment: the member dismissed the store sheet. The service cancels the pending Payment and
+     *  releases what its vertical held, unless a purchase the store already reported paid it. */
+    cancelPayment(input: {
+        paymentId: string;
+    }): Promise<CancelPaymentResult>;
 }
 /**
  * Creates a client for Wix's in-app-purchase payments service (`mobile-apps-wix-iap`), which pays

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/schema.d.ts

@@ -3005,6 +3005,12 @@ export interface NavigationConfig {
     site?: SiteNavConfig;
     /** RFC 0066 amendment "top-bar gap items" — app-wide logo for tab-stack roots. */
     topBarLogo?: TopBarLogo;
+    /** Opt-in alert queue. `true` ⇒ every presented alert (worker `ui.alert`, the descriptor nav
+     *  `alert` verb, app services) shows one at a time in FIFO order per shell, instead of replacing
+     *  each other or rejecting `ui_busy`. At most 5 wait (a 6th worker call rejects `ui_queue_full`);
+     *  identical consecutive alerts show once. An inline `AlertDialog` component never enters the
+     *  queue. Absent ⇒ today's behaviour. */
+    presentationQueue?: boolean;
     scheme: string;
     deepLinkPatterns: DeepLinkPattern[];
     linkableScreens: LinkableScreen[];

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/flows/iap-checkout/src/apple-iap-contract.d.ts

@@ -107,12 +107,18 @@ export interface OpeningGuard {
  *  `held`: still unknown, and it blocks this sale. `unrelated`: still unknown, but it targets other
  *  inventory than this sale's. */
 export type OpeningResolution = "released" | "held" | "unrelated" | "unavailable" | "sessionChanged";
-/** An item wix-iap orders itself (StartItemPayment): the item as eCom's catalog reference, and how
- *  the adapter finds the eCom order that call placed. */
+/** What StartItemPayment placed: an eCom order, or for Online Programs a join application. */
+export interface PlacedItem {
+    ecomOrderId?: string;
+    joinApplicationId?: string;
+}
+/** An item wix-iap orders itself (StartItemPayment): the item as its catalog reference, and how the
+ *  adapter finds what that call placed. */
 export interface ItemPayment {
     catalogItem: EcomCatalogReference;
-    /** The reference `readAccess` reads for the eCom order StartItemPayment placed. */
-    verticalRefOf(ecomOrderId: string): VerticalRef;
+    /** The reference `readAccess` reads for what StartItemPayment placed; null when the answer names
+     *  nothing this adapter reads. */
+    verticalRefOf(placed: PlacedItem): VerticalRef | null;
 }
 /** What every vertical answers. Every call goes through the session-bound bridge it is given. */
 export interface IapAdapterBase {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/iap-checkout.mjs

@@ -1066,18 +1066,45 @@ function wixApiGlobal() {
 function startPaymentCall(scope, wixTransactionId) {
   return post(scope, "/payments/start", { appleBundleId: scope.binding.bundleId, wixTransactionId });
 }
-function startItemPaymentCall(scope, item) {
-  return post(scope, "/payments/start-item", { appleBundleId: scope.binding.bundleId, item: { catalogItemId: item.catalogItemId, catalogAppId: item.catalogAppId } });
+function startItemPaymentCall(scope, item, storeCountryCode) {
+  const { catalogItemId, catalogAppId, options } = item;
+  return post(scope, "/payments/start-item", {
+    appleBundleId: scope.binding.bundleId,
+    item: { catalogItemId, catalogAppId, ...options ? { options } : {} },
+    ...storeCountryCode ? { storeCountryCode } : {}
+  });
 }
 function catalogItemOf(raw) {
   const item = isObject3(raw) ? raw : {};
-  const { catalogItemId, catalogAppId } = item;
+  const { catalogItemId, catalogAppId, options } = item;
   const valid = typeof catalogItemId === "string" && catalogItemId.length > 0 && catalogItemId.length <= 36 && isUUID(catalogAppId);
-  return valid ? { catalogItemId, catalogAppId } : null;
+  if (!valid || options !== void 0 && !isJsonObject(options)) return null;
+  return options && Object.keys(options).length > 0 ? { catalogItemId, catalogAppId, options } : { catalogItemId, catalogAppId };
+}
+function isStoreCountryCode(value) {
+  return typeof value === "string" && /^[A-Z]{3}$/.test(value);
+}
+var MAX_JSON_DEPTH = 32;
+function isJsonObject(value, depth = 0) {
+  return depth < MAX_JSON_DEPTH && isPlainObject(value) && Object.values(value).every((v) => isJsonValue(v, depth + 1));
+}
+function isJsonValue(value, depth) {
+  if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+  if (typeof value === "number") return Number.isFinite(value);
+  if (Array.isArray(value)) return depth < MAX_JSON_DEPTH && value.every((v) => isJsonValue(v, depth + 1));
+  return isJsonObject(value, depth);
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
 }
 function completePaymentCall(scope, signedTransaction) {
   return post(scope, "/payments/complete", { appleBundleId: scope.binding.bundleId, apple: { signedTransaction } });
 }
+function cancelPaymentCall(scope, paymentId) {
+  return post(scope, `/payments/${encodeURIComponent(paymentId)}/cancel`, { appleBundleId: scope.binding.bundleId });
+}
 function paymentCall(scope, paymentId) {
   return get2(scope, `/payments/${encodeURIComponent(paymentId)}`);
 }
@@ -1090,10 +1117,17 @@ function decodeStarted(raw, expected) {
   return payment && { payment, storeProductId: raw.storeProductId, appAccountToken: raw.appAccountToken };
 }
 function decodeStartedItem(raw, expected) {
-  if (!isObject3(raw) || !isUUID(raw.ecomOrderId)) return null;
+  if (!isObject3(raw)) return null;
+  const ecomOrderId = optionalId(raw.ecomOrderId);
+  const joinApplicationId = optionalId(raw.joinApplicationId);
+  if (ecomOrderId === null || joinApplicationId === null || !ecomOrderId && !joinApplicationId) return null;
   const started = decodeStarted(raw, expected);
   if (!started || started.payment.appProductId !== expected.catalogItemId) return null;
-  return { ...started, ecomOrderId: raw.ecomOrderId };
+  return { ...started, ...ecomOrderId ? { ecomOrderId } : {}, ...joinApplicationId ? { joinApplicationId } : {} };
+}
+function optionalId(value) {
+  if (value === void 0 || value === "") return void 0;
+  return isUUID(value) ? value : null;
 }
 function decodePaymentAnswer(raw, expected) {
   return isObject3(raw) ? decodePayment(raw.payment, expected) : null;
@@ -1219,11 +1253,12 @@ function createWixIapClient(deps) {
   }
   function startItemPayment(input) {
     const item = catalogItemOf(input.item);
-    if (!item) return Promise.resolve(failure("startItemPayment", "invalidArgument"));
+    const country = input.storeCountryCode;
+    if (!item || country !== void 0 && !isStoreCountryCode(country)) return Promise.resolve(failure("startItemPayment", "invalidArgument"));
     return runUnrepeatable({
       operation: "startItemPayment",
       codes: START_ITEM_PAYMENT_CODES,
-      request: (scope) => startItemPaymentCall(scope, item),
+      request: (scope) => startItemPaymentCall(scope, item, country),
       decode: (raw, scope) => {
         const started = decodeStartedItem(raw, { ...expectationOf2(scope), catalogItemId: item.catalogItemId });
         return started && { status: "started", ...started };
@@ -1255,6 +1290,18 @@ function createWixIapClient(deps) {
       }
     });
   }
+  function cancelPayment(input) {
+    if (!isUUID(input.paymentId)) return Promise.resolve(failure("cancelPayment", "invalidArgument"));
+    return run({
+      operation: "cancelPayment",
+      codes: CANCEL_PAYMENT_CODES,
+      request: (scope) => cancelPaymentCall(scope, input.paymentId),
+      decode: (raw, scope) => {
+        const payment = decodePaymentAnswer(raw, { ...expectationOf2(scope), paymentId: input.paymentId });
+        return payment && { status: "answered", payment };
+      }
+    });
+  }
   async function run(spec) {
     return (await execute(spec)).result;
   }
@@ -1304,7 +1351,7 @@ function createWixIapClient(deps) {
   function isCurrent(session) {
     return deps.session.current().generation === session.generation;
   }
-  return { startPayment, startItemPayment, completePayment, getPayment };
+  return { startPayment, startItemPayment, completePayment, getPayment, cancelPayment };
 }
 async function attempt(transport, call, spec, expectation) {
   try {
@@ -1368,8 +1415,18 @@ var START_ITEM_PAYMENT_CODES = [
   "ALREADY_OWNED",
   "ITEM_NOT_AVAILABLE",
   "SITE_NOT_ACCEPTING_PAYMENTS",
-  "UNSUPPORTED_ORDER"
+  "UNSUPPORTED_ORDER",
+  "CATALOG_NOT_SUPPORTED",
+  "VERTICAL_ACCESS_DENIED",
+  "EVENT_CHECKOUT_NOT_ECOM",
+  "ALREADY_SUBSCRIBED",
+  "SUBSCRIPTION_NOT_IN_APP",
+  "BILLING_COUNTRY_REQUIRED",
+  "APP_NOT_CONFIGURED",
+  "NOT_BOOKING_OWNER",
+  "BOOKING_PAYMENT_PENDING"
 ];
+var CANCEL_PAYMENT_CODES = ["NOT_PENDING", "APP_NOT_CONFIGURED", "NOT_FOUND"];
 var UNDECIDED = /* @__PURE__ */ new Set(["unavailable", "sessionChanged", "invalidResponse"]);
 var COMPLETE_PAYMENT_CODES = [
   "INVALID_PURCHASE",
@@ -2065,7 +2122,7 @@ function createWixOrderBackend(deps) {
     const attempt3 = existing?.cashierOrderId && existing.verticalRef ? await reopenOrOpen(sale, { cashierOrderId: existing.cashierOrderId, verticalRef: existing.verticalRef }) : await sale.adapter.openOrder(sale.item, sale.bridge, beforeCreate, afterCreate);
     if (prevented) return prevented;
     if (guarded !== void 0 && attempt3.status === "open" && !stillGuarded(sale, guarded)) return retry("unavailable");
-    const ref = recordOrder(sale, existing, attempt3);
+    const ref = recordOrder(sale, existing, attempt3, guarded);
     return isStop(ref) ? ref : { ref, placed: isPlaced(attempt3) };
   }
   function stillGuarded(sale, guarded) {
@@ -2077,8 +2134,8 @@ function createWixOrderBackend(deps) {
     const closed = reopened.status === "refused" && reopened.reason === "orderClosed";
     return closed && !sale.adapter.repeatable ? sale.adapter.openOrder(sale.item, sale.bridge) : reopened;
   }
-  function recordOrder(sale, existing, attempt3) {
-    if (attempt3.noOrderCreated && refAt(sale.partition, sale.catalogRef)?.stage === "openingOrder" && !sale.partition.remove(sale.catalogRef)) {
+  function recordOrder(sale, existing, attempt3, guarded) {
+    if (attempt3.noOrderCreated && guarded !== void 0 && stillGuarded(sale, guarded) && !sale.partition.remove(sale.catalogRef)) {
       return stopWith("rejected", "storageUnavailable");
     }
     if (attempt3.status === "granted") return alreadyOwned(sale);
@@ -2159,12 +2216,14 @@ function createWixOrderBackend(deps) {
   }
   function startedItem(sale, itemPayment2, started) {
     if (started.storeProductId !== sale.appleProduct.productId) return contextResult(sale.catalogRef, stopWith("rejected", "productChanged"));
+    const verticalRef = itemPayment2.verticalRefOf(started);
+    if (!verticalRef) return contextResult(sale.catalogRef, OUTCOME_UNKNOWN);
     const { payment, storeProductId, appAccountToken } = started;
     const recorded = persist(sale, {
       key: sale.catalogRef,
       stage: "started",
       kind: sale.adapter.kind,
-      verticalRef: itemPayment2.verticalRefOf(started.ecomOrderId),
+      verticalRef,
       wixTransactionId: payment.wixTransactionId,
       paymentId: payment.paymentId,
       storeProductId,
@@ -2329,7 +2388,16 @@ var ITEM_REFUSALS = {
   ALREADY_OWNED: "paymentRefused",
   ITEM_NOT_AVAILABLE: "orderRefused",
   SITE_NOT_ACCEPTING_PAYMENTS: "sitePaymentUnavailable",
-  UNSUPPORTED_ORDER: "orderRefused"
+  UNSUPPORTED_ORDER: "orderRefused",
+  CATALOG_NOT_SUPPORTED: "unsupportedItem",
+  EVENT_CHECKOUT_NOT_ECOM: "unsupportedItem",
+  VERTICAL_ACCESS_DENIED: "notConfigured",
+  APP_NOT_CONFIGURED: "notConfigured",
+  ALREADY_SUBSCRIBED: "paymentRefused",
+  SUBSCRIPTION_NOT_IN_APP: "paymentRefused",
+  BILLING_COUNTRY_REQUIRED: "orderRefused",
+  NOT_BOOKING_OWNER: "orderRefused",
+  BOOKING_PAYMENT_PENDING: "paymentInProgress"
 };
 var KIND_STOPS = {
   authRequired: SIGN_IN,
@@ -3360,7 +3428,7 @@ function eligibility(item) {
   return catalog && !variant && isNonEmpty3(catalog.appId) && catalog.appId.toLowerCase() === WIX_STORES_APP && catalog.catalogItemId === item.reference.id ? single : UNSUPPORTED;
 }
 function itemPayment(item) {
-  return { catalogItem: { catalogItemId: item.reference.id, catalogAppId: WIX_STORES_APP }, verticalRefOf: (orderId) => ({ orderId }) };
+  return { catalogItem: { catalogItemId: item.reference.id, catalogAppId: WIX_STORES_APP }, verticalRefOf: ({ ecomOrderId }) => ecomOrderId ? { orderId: ecomOrderId } : null };
 }
 function classifyCart(lines) {
   if (lines.length === 0 || lines.some((line) => line.route === "resolving" || line.route === "unavailable")) return "blocked";

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/iap.mjs

@@ -1070,18 +1070,45 @@ function wixApiGlobal() {
 function startPaymentCall(scope, wixTransactionId) {
   return post(scope, "/payments/start", { appleBundleId: scope.binding.bundleId, wixTransactionId });
 }
-function startItemPaymentCall(scope, item) {
-  return post(scope, "/payments/start-item", { appleBundleId: scope.binding.bundleId, item: { catalogItemId: item.catalogItemId, catalogAppId: item.catalogAppId } });
+function startItemPaymentCall(scope, item, storeCountryCode) {
+  const { catalogItemId, catalogAppId, options } = item;
+  return post(scope, "/payments/start-item", {
+    appleBundleId: scope.binding.bundleId,
+    item: { catalogItemId, catalogAppId, ...options ? { options } : {} },
+    ...storeCountryCode ? { storeCountryCode } : {}
+  });
 }
 function catalogItemOf(raw) {
   const item = isObject3(raw) ? raw : {};
-  const { catalogItemId, catalogAppId } = item;
+  const { catalogItemId, catalogAppId, options } = item;
   const valid = typeof catalogItemId === "string" && catalogItemId.length > 0 && catalogItemId.length <= 36 && isUUID(catalogAppId);
-  return valid ? { catalogItemId, catalogAppId } : null;
+  if (!valid || options !== void 0 && !isJsonObject(options)) return null;
+  return options && Object.keys(options).length > 0 ? { catalogItemId, catalogAppId, options } : { catalogItemId, catalogAppId };
+}
+function isStoreCountryCode(value) {
+  return typeof value === "string" && /^[A-Z]{3}$/.test(value);
+}
+var MAX_JSON_DEPTH = 32;
+function isJsonObject(value, depth = 0) {
+  return depth < MAX_JSON_DEPTH && isPlainObject(value) && Object.values(value).every((v) => isJsonValue(v, depth + 1));
+}
+function isJsonValue(value, depth) {
+  if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+  if (typeof value === "number") return Number.isFinite(value);
+  if (Array.isArray(value)) return depth < MAX_JSON_DEPTH && value.every((v) => isJsonValue(v, depth + 1));
+  return isJsonObject(value, depth);
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
 }
 function completePaymentCall(scope, signedTransaction) {
   return post(scope, "/payments/complete", { appleBundleId: scope.binding.bundleId, apple: { signedTransaction } });
 }
+function cancelPaymentCall(scope, paymentId) {
+  return post(scope, `/payments/${encodeURIComponent(paymentId)}/cancel`, { appleBundleId: scope.binding.bundleId });
+}
 function paymentCall(scope, paymentId) {
   return get(scope, `/payments/${encodeURIComponent(paymentId)}`);
 }
@@ -1094,10 +1121,17 @@ function decodeStarted(raw, expected) {
   return payment && { payment, storeProductId: raw.storeProductId, appAccountToken: raw.appAccountToken };
 }
 function decodeStartedItem(raw, expected) {
-  if (!isObject3(raw) || !isUUID(raw.ecomOrderId)) return null;
+  if (!isObject3(raw)) return null;
+  const ecomOrderId = optionalId(raw.ecomOrderId);
+  const joinApplicationId = optionalId(raw.joinApplicationId);
+  if (ecomOrderId === null || joinApplicationId === null || !ecomOrderId && !joinApplicationId) return null;
   const started = decodeStarted(raw, expected);
   if (!started || started.payment.appProductId !== expected.catalogItemId) return null;
-  return { ...started, ecomOrderId: raw.ecomOrderId };
+  return { ...started, ...ecomOrderId ? { ecomOrderId } : {}, ...joinApplicationId ? { joinApplicationId } : {} };
+}
+function optionalId(value) {
+  if (value === void 0 || value === "") return void 0;
+  return isUUID(value) ? value : null;
 }
 function decodePaymentAnswer(raw, expected) {
   return isObject3(raw) ? decodePayment(raw.payment, expected) : null;
@@ -1223,11 +1257,12 @@ function createWixIapClient(deps) {
   }
   function startItemPayment(input) {
     const item = catalogItemOf(input.item);
-    if (!item) return Promise.resolve(failure("startItemPayment", "invalidArgument"));
+    const country = input.storeCountryCode;
+    if (!item || country !== void 0 && !isStoreCountryCode(country)) return Promise.resolve(failure("startItemPayment", "invalidArgument"));
     return runUnrepeatable({
       operation: "startItemPayment",
       codes: START_ITEM_PAYMENT_CODES,
-      request: (scope) => startItemPaymentCall(scope, item),
+      request: (scope) => startItemPaymentCall(scope, item, country),
       decode: (raw, scope) => {
         const started = decodeStartedItem(raw, { ...expectationOf2(scope), catalogItemId: item.catalogItemId });
         return started && { status: "started", ...started };
@@ -1259,6 +1294,18 @@ function createWixIapClient(deps) {
       }
     });
   }
+  function cancelPayment(input) {
+    if (!isUUID(input.paymentId)) return Promise.resolve(failure("cancelPayment", "invalidArgument"));
+    return run({
+      operation: "cancelPayment",
+      codes: CANCEL_PAYMENT_CODES,
+      request: (scope) => cancelPaymentCall(scope, input.paymentId),
+      decode: (raw, scope) => {
+        const payment = decodePaymentAnswer(raw, { ...expectationOf2(scope), paymentId: input.paymentId });
+        return payment && { status: "answered", payment };
+      }
+    });
+  }
   async function run(spec) {
     return (await execute(spec)).result;
   }
@@ -1308,7 +1355,7 @@ function createWixIapClient(deps) {
   function isCurrent(session) {
     return deps.session.current().generation === session.generation;
   }
-  return { startPayment, startItemPayment, completePayment, getPayment };
+  return { startPayment, startItemPayment, completePayment, getPayment, cancelPayment };
 }
 async function attempt(transport, call, spec, expectation) {
   try {
@@ -1372,8 +1419,18 @@ var START_ITEM_PAYMENT_CODES = [
   "ALREADY_OWNED",
   "ITEM_NOT_AVAILABLE",
   "SITE_NOT_ACCEPTING_PAYMENTS",
-  "UNSUPPORTED_ORDER"
+  "UNSUPPORTED_ORDER",
+  "CATALOG_NOT_SUPPORTED",
+  "VERTICAL_ACCESS_DENIED",
+  "EVENT_CHECKOUT_NOT_ECOM",
+  "ALREADY_SUBSCRIBED",
+  "SUBSCRIPTION_NOT_IN_APP",
+  "BILLING_COUNTRY_REQUIRED",
+  "APP_NOT_CONFIGURED",
+  "NOT_BOOKING_OWNER",
+  "BOOKING_PAYMENT_PENDING"
 ];
+var CANCEL_PAYMENT_CODES = ["NOT_PENDING", "APP_NOT_CONFIGURED", "NOT_FOUND"];
 var UNDECIDED = /* @__PURE__ */ new Set(["unavailable", "sessionChanged", "invalidResponse"]);
 var COMPLETE_PAYMENT_CODES = [
   "INVALID_PURCHASE",