@indiegems/gem-web-sdk 16.2.0 → 16.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indiegems/gem-web-sdk",
-  "version": "16.2.0",
+  "version": "16.3.1",
   "description": "postMessage bridge contract between gem-web and browser-playable games",
   "license": "UNLICENSED",
   "type": "module",

package/schema/bridge.v1.json

@@ -3771,8 +3771,8 @@
         "      arcade's store for one of the store's own SKUs -",
         "      gem.requestStorePurchase, gated on `store` -",
         "      but only from the player's press on a button of the game's; that",
-        "      sheet is the Arcade Store's, under its own rules, and nothing opens",
-        "      it by itself on a refusal here.",
+        "      checkout is the Arcade Store's, under its own rules, and nothing",
+        "      opens it by itself on a refusal here.",
         "    - MONEY IS TAKEN ONLY ON THE PAYMENT PROVIDER'S PAGE OR THE OPERATING",
         "      SYSTEM'S PURCHASE SHEET, which a player reaches through the parent's",
         "      own chrome. Nothing a frame sends carries a price or a card field,",
@@ -5342,7 +5342,9 @@
         "rail's own formatted string, and a game shows it exactly as given,",
         "never parsing it or computing a discount from it. No balance. And no",
         "per-offer availability flag: one would reveal a recent purchase through",
-        "its cooldown, so the parent's sheet explains a cooldown instead.",
+        "its cooldown, so the parent explains a cooldown in its own chrome",
+        "instead, and a purchase of that offer is answered `declined` /",
+        "`cancelled`.",
         "",
         "THE NAMES ARE THE PLATFORM'S, not a game developer's: the Arcade",
         "Store's own catalog copy, which is why `name` and `description` sit",
@@ -5438,14 +5440,14 @@
       "direction": "frameToParent",
       "transport": "port",
       "$comment": [
-        "Ask the parent to open the Arcade Store's purchase sheet for ONE SKU it",
+        "Ask the parent to open the Arcade Store's checkout for ONE SKU it",
         "listed in gem.storeOffersResult - real money, not Gems. Gated by the",
         "`store` capability. Answered by `gem.storePurchaseResult`.",
         "",
         "THE GAME ASKS; THE PLATFORM SELLS. Nothing in this message is a price,",
-        "a card field, a URL or a token. The parent renders its own sheet from",
-        "platform records, takes money only on the payment provider's page or",
-        "the operating system's purchase sheet, and tells the game the outcome.",
+        "a card field, a URL or a token. The parent looks the SKU up in its own",
+        "listing, takes money only on the payment provider's page or the",
+        "operating system's purchase sheet, and tells the game the outcome.",
         "",
         "AN ACTING MESSAGE, under every rule gem.requestOpenApp states: a press",
         "the parent can see (a missing `userActivation` API fails closed), one",
@@ -5456,17 +5458,26 @@
         "  would list to this player right now; anything else is `unavailable`",
         "  with nothing shown.",
         "",
-        "  THE STORE'S OWN SHEET. Over the paused game, hidden not dimmed, with",
-        "  the parent's bar saying the Arcade Store is open, game chrome frozen,",
-        "  and focus never landing on a money control. \"Not now\" has the",
-        "  default focus. Buy arms visibly for a moment and then takes a FRESH",
-        "  press; input during arming restarts it.",
+        "  STRAIGHT TO CHECKOUT, with no confirmation of the parent's own first,",
+        "  by owner decision: games are developed in-house and trusted, as for",
+        "  gem.requestOpenGame. The press in the game opens the",
+        "  payment provider's page on the web, or the operating system's",
+        "  purchase sheet in an app, over the paused game: hidden, not dimmed.",
+        "  That checkout is the confirmation - it has its own pay control, and",
+        "  no money moves without the player's press there.",
+        "",
+        "  AN OFFER COOLING DOWN OPENS NOTHING. When the listed SKU cannot be",
+        "  bought again yet, the parent says when, in its own chrome, and",
+        "  answers `declined` / `cancelled` - the answer a closed checkout gets,",
+        "  so the cooldown, which would reveal a recent purchase, never crosses",
+        "  the bridge. It starts no back-off: the player turned nothing down.",
         "",
         "  BACK OFF AFTER A DISMISSAL. `cancelled` is disclosed, so after the",
-        "  player dismisses a sheet a game started, further asks from that game",
+        "  player closes a checkout a game started, further asks from that game",
         "  are `declined` / `busy`, unrendered, for an interval that grows with",
         "  each dismissal (the Arcade: 30 s, 2 min, 10 min, then the rest of the",
-        "  session).",
+        "  session). Only the player closing it starts the back-off: a failed",
+        "  payment, `error` and `ok` / `pending` do not.",
         "",
         "  RESUME, THEN ANSWER. The result is sent after the game has been told",
         "  it is resumed, so the game's own celebration is visible.",
@@ -5508,9 +5519,10 @@
         "                `reason: pending`, the provider has not settled yet (or",
         "                the player left before it did): `gem.storePurchaseSettled`",
         "                follows when it does, and a game re-reads on resume too.",
-        "  declined    - nothing was bought: the player dismissed the sheet",
-        "                (`cancelled`), or no press, another acting message open",
-        "                or a back-off running (`busy`).",
+        "  declined    - nothing was bought: the player closed the checkout,",
+        "                or the offer is cooling down (`cancelled`); or no",
+        "                press, another acting message open or a back-off",
+        "                running (`busy`).",
         "  unavailable - no sale the parent can vouch for. With `store_off`",
         "                (the store withheld), `sign_in_required` (a guest),",
         "                `not_found` (an unknown SKU) or the provider's own",