@wix/himalaya-cli 0.1537.0 → 0.1538.0

package/dist/cli.mjs

@@ -23049,6 +23049,7 @@ function resolveIdiom(tokens2, ctx = {}) {
 var IDIOM_CONTEXTS, UNSAFE_KEYS;
 var init_idiom = __esm({
   "../../core/ts/src/idiom.ts"() {
+    "use strict";
     IDIOM_CONTEXTS = {
       ios: { native: ["ios"] },
       android: { native: ["material"] },
@@ -173316,6 +173317,12 @@ function credentialsPlan(deps) {
   };
 }
 async function connectProvider(provider, appId2, apply) {
+  if (provider && !apply) {
+    return {
+      state: "unverified",
+      detail: "whether the appleIAP payment provider is connected cannot be read (wix-iap has no read-only provider-readiness method), so applying sends ConnectProviderAccount again"
+    };
+  }
   if (!provider || !apply) return providerPlan(provider);
   try {
     const { connected } = await provider.connect(appId2);
@@ -173377,7 +173384,16 @@ function mappingTarget(item, plans, rules = APPLE_PROVISIONING_RULES) {
     return skip(entity, `the App Store purchase flow sells ${item.wix.entityType} items only as ${rule.productType}, not ${PRODUCT_TYPE[item.type]}`);
   }
   if (item.wix.entityType === "pricingPlan") {
-    if (!plans.ok) return skip(entity, `only one-time unlimited plans sell through the App Store, and ${plans.why}, so this plan was not mapped`);
+    if (!plans.ok) {
+      return { skip: {
+        entity,
+        appProductId: rule.appProductId(item.wix.entityId),
+        storeProductId: item.productId,
+        state: "failed",
+        code: "request_failed",
+        detail: `only one-time unlimited plans sell through the App Store, and ${plans.why}, so this plan was not mapped`
+      } };
+    }
     if (!plans.ids.has(item.wix.entityId)) {
       return skip(entity, "only one-time unlimited plans (one payment, valid until cancelled) sell through the App Store; this plan is recurring, time-limited, archived or not on the site");
     }
@@ -173404,6 +173420,17 @@ function decide(catalog4, target) {
   }
   return void 0;
 }
+function connectDiff(report3) {
+  const diff = { inPlace: [], toCreate: [], conflicts: [], unverified: [], blocked: [], skipped: [] };
+  const steps = [
+    ["app", report3.app],
+    ["key", report3.credentials],
+    ["provider", report3.provider],
+    ...report3.mappings.map((m2) => [`mapping ${m2.appProductId ?? m2.entity}`, m2])
+  ];
+  for (const [label3, step] of steps) diff[DIFF_BUCKET[step.state]].push(label3);
+  return diff;
+}
 function mappingWithoutApp(item, planning, plans, rules = APPLE_PROVISIONING_RULES) {
   const target = mappingTarget(item, plans, rules);
   if ("skip" in target) return target.skip;
@@ -173418,12 +173445,22 @@ function noApp(why) {
 function failed(what, error) {
   return { state: "failed", code: "request_failed", detail: `could not ${what}: ${error instanceof Error ? error.message : String(error)}` };
 }
-var PRODUCT_TYPE;
+var PRODUCT_TYPE, DIFF_BUCKET;
 var init_store_iap_connect = __esm({
   "src/store-iap-connect.ts"() {
     init_wix_payments_contract();
     init_store_iap_purchases();
     PRODUCT_TYPE = { nonConsumable: "NON_CONSUMABLE", consumable: "CONSUMABLE" };
+    DIFF_BUCKET = {
+      reused: "inPlace",
+      done: "inPlace",
+      planned: "toCreate",
+      conflict: "conflicts",
+      unverified: "unverified",
+      failed: "unverified",
+      blocked: "blocked",
+      skipped: "skipped"
+    };
   }
 });
 
@@ -174128,13 +174165,17 @@ function firstProblem(report3) {
 function printConnect(out2, report3, heading) {
   out2.line(`himi store iap connect \u2014 ${heading}`);
   out2.line(`  ${pad("site")}${report3.site} \xB7 bundle ${report3.bundleId}`);
-  const row2 = (label3, step) => out2.line(`  ${pad(label3)}${step.state.padEnd(9)}${step.detail}`);
+  const row2 = (label3, step) => out2.line(`  ${pad(label3)}${step.state.padEnd(11)}${step.detail}`);
   row2("app", report3.app);
   row2("key", report3.credentials);
   row2("provider", report3.provider);
   for (const mapping of report3.mappings) row2("mapping", mapping);
   if (report3.purchasesAppId) out2.line(`  ${pad("binding")}wixIap: { purchasesAppId: "${report3.purchasesAppId}" }`);
 }
+function printDiff(out2, diff) {
+  const parts = [["in place", diff.inPlace], ["to create", diff.toCreate], ["conflicts", diff.conflicts], ["unverified", diff.unverified], ["blocked", diff.blocked], ["skipped", diff.skipped]].filter(([, labels]) => labels.length).map(([name, labels]) => `${name}: ${labels.join(", ")}`);
+  out2.line(`  ${pad("diff")}${parts.join(" \xB7 ") || "nothing to change"}`);
+}
 function printConfig(out2, config, note) {
   if (note) out2.line(`  ${pad("config")}${note}`);
   if (!config) return;
@@ -174241,10 +174282,12 @@ async function connectWith(flags, deps, out2) {
   if (outPath) writeJson(deps, out2, outPath, { report: report3, config });
   const configProblem = config?.conflicts.length ? "config_conflict" : unapplied ? "config_not_applied" : void 0;
   const code = firstProblem(report3) ?? configProblem;
-  if (out2.json) out2.print({ ok: !code, ...code ? { code } : {}, dryRun, report: report3, config, ...note ? { note } : {} });
+  const diff = dryRun ? connectDiff(report3) : void 0;
+  if (out2.json) out2.print({ ok: !code, ...code ? { code } : {}, dryRun, report: report3, ...diff ? { diff } : {}, config, ...note ? { note } : {} });
   else {
     printConnect(out2, report3, dryRun ? "dry run (nothing was written)" : "result");
     printConfig(out2, config, note);
+    if (diff) printDiff(out2, diff);
   }
   return code ? 1 : 0;
 }
@@ -174558,7 +174601,7 @@ var init_store_iap = __esm({
     };
     CredentialsError = class extends Error {
     };
-    writesPlanned = (report3) => [report3.app, report3.credentials, report3.provider, ...report3.mappings].some((step) => step.state === "planned");
+    writesPlanned = (report3) => [report3.app, report3.credentials, report3.provider, ...report3.mappings].some((step) => step.state === "planned" || step.state === "unverified");
     COMMANDS2 = {
       draft: draftCommand,
       plan: planCommand,

package/guides/himi-json-output.md

@@ -125,7 +125,9 @@ An invalid manifest fails with `manifest_invalid`, like the other `store iap` co
 ## `himi store iap connect` codes
 
 `connect` prints one envelope with the whole report. When the setup is not complete it is
-`ok: false` with the first step's code; each step also carries its own `code`.
+`ok: false` with the first step's code; each step also carries its own `code`. A dry run adds
+`diff: { inPlace, toCreate, conflicts, unverified, blocked, skipped }` (every step in exactly one list), and reports a step whose state cannot be read
+without writing (the appleIAP provider, once the app is registered) as `state: "unverified"`.
 
 | Code | Meaning |
 |---|---|
@@ -145,7 +147,7 @@ An invalid manifest fails with `manifest_invalid`, like the other `store iap` co
 | `mapping_unsupported` | The purchase flow cannot map this item yet (a vertical other than Online Programs, Wix Stores or one-time Pricing Plans, a price tier, or an item declared as a consumable). |
 | `no_purchases_app` | A step did not run because the site has no purchases app for the bundle. |
 | `request_failed` | A Purchases or Catalog call failed for another reason; the original message is preserved. |
-| `setup_incomplete` | Steps are only planned (a dry run) or otherwise not yet in place. |
+| `setup_incomplete` | Steps are only planned or unverified (a dry run) or otherwise not yet in place. |
 | `confirmation_required` | Writes were planned, but there was no terminal to ask and no `--yes`. Nothing was written. |
 | `config_conflict` | The backend setup is complete, but the app's config names a different purchases app, site or bundle. |
 | `config_not_applied` | `--content` was given, but the binding is not in its `config.ts` (no config file, a dynamic or symlinked config, an edit `himi validate` rolled back, or no validator); the `config` report or `note` says what to add by hand. |

package/guides/iap-products.md

@@ -109,8 +109,8 @@ managed submission. Other per-item failures include `catalog_screenshot_upload_f
 
 `check` combines the registration, stored purchase key, Catalog mappings, Apple product and
 screenshot readiness, vertical sales rules, app visibility, and source/build binding in one
-read-only report. Unlike `connect --dry-run`, it never reports the payment provider as planned
-and counts that as readiness. Every finding carries `state: "ok" | "missing" | "blocked"`, a
+read-only report. Like `connect --dry-run`, which reports the payment provider `unverified`, it
+never counts the unread provider as ready. Every finding carries `state: "ok" | "missing" | "blocked"`, a
 stable `code`, and a `fix`; overall `code` is `ok` or `setup_incomplete` (exit 0 or 1).
 
 ```sh
@@ -490,12 +490,14 @@ In order:
 3. **The appleIAP payment provider** on the site, through Serve's IAP route to wix-iap
    (`ConnectProviderAccount`). Reported as `provider_route_unavailable` only when the Serve target
    has no IAP routes; a refusal from the service behind it is `request_failed`. There is no read
-   of the provider's state, so a rerun connects it again (the call is safe to repeat).
+   of the provider's state, so a rerun connects it again (the call is safe to repeat), and a dry
+   run for an app that is already registered reports this step `unverified` instead of planned.
 4. **One mapping per Wix item → Apple product, through Catalog `listProducts` / `createProduct`.** Online Programs map by program id, Wix Stores
    digital products by product id, and one-time unlimited Pricing Plans by plan id (the ids the
    purchase flow looks up), all only as non-consumables. A plan is mapped only when the site reads it
    as one-time unlimited (one payment, valid until cancelled); a recurring, time-limited or archived
-   plan, or one connect cannot read, is skipped. Other verticals, price tiers and consumable items
+   plan is skipped. When the site's plans cannot be read, each plan is `failed` (`request_failed`,
+   `unverified` in the dry-run diff) and not mapped. Other verticals, price tiers and consumable items
    are skipped with `mapping_unsupported`. An item already mapped to another
    product (`mapping_conflict`), a mapping of another product type (`mapping_type_mismatch`), an
    inactive mapping (`mapping_inactive`), or an Apple product mapped to another item
@@ -509,7 +511,13 @@ In order:
    otherwise `bundleId` itself or, for a dev bundle, the same without `.dev`. Whenever `--content` was given and the binding
    did not land, the run is `ok: false` (`config_not_applied`) with what to add by hand.
 
-**Review first.** `--dry-run` reads everything and writes nothing. Without `--dry-run` it prints
+**Review first.** `--dry-run` reads everything it can and writes nothing: the site's purchases
+apps and the app's Catalog mappings (plus the site's plans when the manifest maps plans), never
+the provider connection, the key write or a mapping write. It ends with a `diff` (in JSON,
+`diff: { inPlace, toCreate, conflicts, unverified, blocked, skipped }`, each a list of `app`,
+`key`, `provider` or `mapping <id>`, every step in exactly one): what is already in place, what
+applying would create, what it would leave as a conflict, what could not be read (including a
+read that failed), what is blocked, and what connect does not handle. Without `--dry-run` it prints
 the plan and asks; a shell with no terminal (or `--json`) needs `--yes`. A rerun reuses every
 record and writes nothing new. Adding products later means adding them to the manifest and
 rerunning: only their mappings are added, and the purchases-app id (the one thing a build bakes)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1537.0",
+  "version": "0.1538.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": "d6ee8032d51eaeb8dc274ee3f30d37f7461aff9849c18acd863e9fd6"
+  "falconPackageHash": "a1a15dbe939dfa2c63ef1cc4b38f88d026f5eda14efaf885d5c9aa84"
 }