@wix/himalaya-cli 0.1133.0 → 0.1134.0

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

@@ -90,5 +90,45 @@ export declare function entitlements(): Promise<Entitlement[]>;
  * No-op for subscriptions / non-consumables. Resolves true on success.
  */
 export declare function consume(transactionId: string): Promise<boolean>;
-/** Capability version, for bundles that gate on min binary version. */
-export declare const version = 1;
+/** SDK contract version; not native support detection. Set the bundle min_binary_version at rollout. */
+export declare const version = 2;
+/** StoreKit-verified convenience fields; the server must independently verify the JWS. */
+export interface AppleTransaction {
+    store: "apple";
+    signedTransaction: string;
+    transactionId: string;
+    originalTransactionId: string;
+    productId: string;
+    appAccountToken: string | null;
+    environment: "production" | "sandbox" | "xcode" | "unknown";
+}
+export type TransactionErrorCode = "unsupported" | "unavailable" | "invalidArgument" | "invalidResponse" | "notEnabled" | "unsupportedProductType" | "unknownProduct" | "verificationFailed" | "persistenceFailed" | "ownershipConflict" | "storeError" | "busy";
+export type TransactionFailure = {
+    status: "failed";
+    code: TransactionErrorCode;
+};
+export type VerificationPurchaseResult = {
+    status: "purchased";
+    transaction: AppleTransaction;
+} | {
+    status: "pending" | "cancelled";
+} | TransactionFailure;
+export type UnfinishedTransactionsResult = {
+    status: "ok";
+    transactions: AppleTransaction[];
+} | TransactionFailure;
+export type FinishTransactionResult = {
+    status: "finished" | "notFound";
+} | TransactionFailure;
+/** Apple non-consumables only. The token comes from authenticated backend context.
+ * Leaves the transaction unfinished. Never falls back to legacy purchase on old binaries. */
+export declare function purchaseForVerification(input: {
+    productId: string;
+    appAccountToken: string;
+}): Promise<VerificationPurchaseResult>;
+/** Same-install recovery; does not restore finished purchases or override ownership. */
+export declare function getUnfinishedTransactions(): Promise<UnfinishedTransactionsResult>;
+/** Trusted callers must first obtain durable backend processing acknowledgement. */
+export declare function finishTransaction(input: {
+    transactionId: string;
+}): Promise<FinishTransactionResult>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/sdk-types/src/capabilities.generated.d.ts

@@ -14,7 +14,7 @@ export declare const CAPABILITY_REGISTRY: {
     readonly godot: readonly ["loadPack", "release", "send"];
     readonly haptic: readonly ["play"];
     readonly himi_apps: readonly ["canOpen", "current", "hostInfo", "open"];
-    readonly iap: readonly ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"];
+    readonly iap: readonly ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"];
     readonly keyboard: readonly ["dismiss"];
     readonly live_activity: readonly ["end", "start", "update"];
     readonly local_database: readonly ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"];

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -58,13 +58,62 @@ async function consume(transactionId) {
 function normalizeStatus(s) {
   return s === "purchased" || s === "pending" || s === "cancelled" || s === "failed" ? s : "failed";
 }
-var version = 1;
+var version = 2;
+async function purchaseForVerification(input) {
+  if (!nonempty(input?.productId) || !isUUID(input?.appAccountToken)) return failure("invalidArgument");
+  const result = await managedDispatch(() => dispatch("capability.iap.purchaseForVerification", input));
+  if (result?.status === "purchased" && isAppleTransaction(result.transaction)) {
+    return { status: "purchased", transaction: decodeTransaction(result.transaction) };
+  }
+  if (result?.status === "pending" || result?.status === "cancelled") return { status: result.status };
+  return decodeFailure(result);
+}
+async function getUnfinishedTransactions() {
+  const result = await managedDispatch(() => dispatch("capability.iap.getUnfinishedTransactions"));
+  if (result?.status === "ok" && Array.isArray(result.transactions) && result.transactions.every(isAppleTransaction)) {
+    return { status: "ok", transactions: result.transactions.map(decodeTransaction) };
+  }
+  return decodeFailure(result);
+}
+async function finishTransaction(input) {
+  if (!nonempty(input?.transactionId)) return failure("invalidArgument");
+  const result = await managedDispatch(() => dispatch("capability.iap.finishTransaction", input));
+  if (result?.status === "finished" || result?.status === "notFound") return { status: result.status };
+  return decodeFailure(result);
+}
+var transactionErrors = /* @__PURE__ */ new Set(["unsupported", "unavailable", "invalidArgument", "invalidResponse", "notEnabled", "unsupportedProductType", "unknownProduct", "verificationFailed", "persistenceFailed", "ownershipConflict", "storeError", "busy"]);
+var failure = (code) => ({ status: "failed", code });
+var nonempty = (value) => typeof value === "string" && value.trim().length > 0;
+var isUUID = (value) => typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value) && value.length === 36;
+var isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+async function managedDispatch(invoke) {
+  try {
+    const value = await invoke();
+    return isObject(value) ? value : null;
+  } catch {
+    return failure("unavailable");
+  }
+}
+function decodeFailure(value) {
+  return value?.status === "failed" && transactionErrors.has(value.code) ? failure(value.code) : failure("invalidResponse");
+}
+function isAppleTransaction(value) {
+  if (!isObject(value)) return false;
+  return value.store === "apple" && typeof value.signedTransaction === "string" && /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/.test(value.signedTransaction) && nonempty(value.transactionId) && nonempty(value.originalTransactionId) && nonempty(value.productId) && (value.appAccountToken === null || isUUID(value.appAccountToken)) && ["production", "sandbox", "xcode", "unknown"].includes(value.environment);
+}
+function decodeTransaction(value) {
+  const { store, signedTransaction, transactionId, originalTransactionId, productId, appAccountToken, environment } = value;
+  return { store, signedTransaction, transactionId, originalTransactionId, productId, appAccountToken, environment };
+}
 export {
   consume,
   entitlements,
+  finishTransaction,
   getPaywallConfig,
   getProducts,
+  getUnfinishedTransactions,
   purchase,
+  purchaseForVerification,
   restore,
   version
 };

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -14,7 +14,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

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

@@ -29,7 +29,7 @@ var CAPABILITY_REGISTRY = {
   "godot": ["loadPack", "release", "send"],
   "haptic": ["play"],
   "himi_apps": ["canOpen", "current", "hostInfo", "open"],
-  "iap": ["consume", "entitlements", "getPaywallConfig", "getProducts", "purchase", "restore"],
+  "iap": ["consume", "entitlements", "finishTransaction", "getPaywallConfig", "getProducts", "getUnfinishedTransactions", "purchase", "purchaseForVerification", "restore"],
   "keyboard": ["dismiss"],
   "live_activity": ["end", "start", "update"],
   "local_database": ["availability", "count", "get", "getAll", "purge", "query", "queueDepth", "queueDrain", "queueEnqueue", "remove", "upsert"],

package/dist/cli.mjs

@@ -6789,7 +6789,6 @@ function resolveTranslation(value, catalog, sourceCatalog) {
 var BINDING_SIGILS, BINDING_SIGIL_RE, TRANSLATION_PREFIX, TRANSLATION_KEY_RE;
 var init_bindings = __esm({
   "../../core/ts/src/bindings.ts"() {
-    "use strict";
     BINDING_SIGILS = ["service", "flag", "item", "t"];
     BINDING_SIGIL_RE = new RegExp(
       `^\\$(?:${BINDING_SIGILS.filter((s) => s !== "t").join("|")})\\b|^\\$t:`
@@ -24749,7 +24748,6 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
-    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -29150,7 +29148,6 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
-    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,
@@ -58109,21 +58106,21 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-nG7b3MPu.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1104209, sha256: "88839c5eb15058f706e50664752a75646d690de5148f8b504eb82c0f87a70a15" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1104217, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1108827, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1597411, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1688335, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1779319, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1870299, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1961171, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2052151, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2160787, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2269871, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2378919, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2486619, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2574727, length: 4947, sha256: "5c0a3e1b1d5bda7b6bc8cc2a025321bf6d0aa74d1f14b073861f188fd7b13a8b" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2579674, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
+      { key: "assets/index-B-1B15q7.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1104811, sha256: "bd81d6b74d2a1b72072c1c20303e225dbc620861e50f66e5b7a90a6d64c66ed2" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1104819, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1109429, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1598013, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1688937, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1779921, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1870901, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1961773, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2052753, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2161389, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2270473, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2379521, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2487221, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2575329, length: 4947, sha256: "e6135ff25467aef302a26590c7f740191c93ee3acc0abcfbd4f218780559ff9f" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2580276, length: 17209, sha256: "dffc9718e2faa63ae2cc919e0a842f585ed565aaaa7c53778e90379442c731b6" }
     ];
   }
 });

package/guides/sdk-reference.json

@@ -1406,8 +1406,62 @@
       {
         "name": "version",
         "kind": "const",
-        "jsdoc": "/** Capability version, for bundles that gate on min binary version. */",
-        "decl": "export const version = 1;"
+        "jsdoc": "/** SDK contract version; not native support detection. Set the bundle min_binary_version at rollout. */",
+        "decl": "export const version = 2;"
+      },
+      {
+        "name": "AppleTransaction",
+        "kind": "interface",
+        "jsdoc": "/** StoreKit-verified convenience fields; the server must independently verify the JWS. */",
+        "decl": "export interface AppleTransaction {\n  store: \"apple\";\n  signedTransaction: string;\n  transactionId: string;\n  originalTransactionId: string;\n  productId: string;\n  appAccountToken: string | null;\n  environment: \"production\" | \"sandbox\" | \"xcode\" | \"unknown\";\n}"
+      },
+      {
+        "name": "TransactionErrorCode",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type TransactionErrorCode = \"unsupported\" | \"unavailable\" | \"invalidArgument\" | \"invalidResponse\"\n  | \"notEnabled\" | \"unsupportedProductType\" | \"unknownProduct\" | \"verificationFailed\"\n  | \"persistenceFailed\" | \"ownershipConflict\" | \"storeError\" | \"busy\";"
+      },
+      {
+        "name": "TransactionFailure",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type TransactionFailure = { status: \"failed\"; code: TransactionErrorCode };"
+      },
+      {
+        "name": "VerificationPurchaseResult",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type VerificationPurchaseResult = { status: \"purchased\"; transaction: AppleTransaction }\n  | { status: \"pending\" | \"cancelled\" } | TransactionFailure;"
+      },
+      {
+        "name": "UnfinishedTransactionsResult",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type UnfinishedTransactionsResult = { status: \"ok\"; transactions: AppleTransaction[] } | TransactionFailure;"
+      },
+      {
+        "name": "FinishTransactionResult",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type FinishTransactionResult = { status: \"finished\" | \"notFound\" } | TransactionFailure;"
+      },
+      {
+        "name": "purchaseForVerification",
+        "kind": "function",
+        "jsdoc": "/** Apple non-consumables only. The token comes from authenticated backend context.\n * Leaves the transaction unfinished. Never falls back to legacy purchase on old binaries. */",
+        "decl": "export async function purchaseForVerification(input: { productId: string; appAccountToken: string }): Promise<VerificationPurchaseResult>;"
+      },
+      {
+        "name": "getUnfinishedTransactions",
+        "kind": "function",
+        "jsdoc": "/** Same-install recovery; does not restore finished purchases or override ownership. */",
+        "decl": "export async function getUnfinishedTransactions(): Promise<UnfinishedTransactionsResult>;"
+      },
+      {
+        "name": "finishTransaction",
+        "kind": "function",
+        "jsdoc": "/** Trusted callers must first obtain durable backend processing acknowledgement. */",
+        "decl": "export async function finishTransaction(input: { transactionId: string }): Promise<FinishTransactionResult>;"
       }
     ]
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1133.0",
+  "version": "0.1134.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": [
@@ -67,5 +67,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "4920f7f92ed5d3cccc334bbc8ff870b7299ebb01377a75b9829788cd"
+  "falconPackageHash": "b114c871da4cb1b2f6f20b7a14c5d491c36f951d089ce10a23f5ca76"
 }