@indiegems/gem-web-sdk 24.0.1 → 24.1.0

package/docs/inventory-and-catalogs.md

@@ -1208,23 +1208,36 @@ now without the bonus. `declined` or `unavailable` means run it as it is — and
 `error` may still mean the player paid, so read `gem.me.passes` again rather than telling them
 they did not.
 
-`upsells` is empty for a minor, a store that is off, a pass the player declined twice today or
-already holds, and anywhere the store sells no pass: draw nothing then. A guest **does** get
+`upsells` is empty for a minor, a store that is off, a pass the player already holds, and anywhere
+the store sells no pass: draw nothing then. Declining a pass's sheet does not empty it: there is no
+limit on how often a game offers a pass. A guest **does** get
 upsells, and buying takes them through sign-up first.
 
-**The rules, every one a must:**
-
-- **Upsell only before granting**, and at most once per reward moment. Never after.
-- **Give Get VIP and Continue equal weight.** Neither is the default, the larger or the brighter.
-- **Never show the outcome of a locked roll.** Show "+1 roll", never what it would land on.
-- **Disclose the odds** for a bonus roll, as for any roll ([§12](#12-loot-tables-and-odds)).
-- **No countdowns, no "expires" pressure, and no price** in your game. The Arcade's sheet shows the
-  price.
-- **Show a lock as an icon plus text**, never colour alone.
-- **Return focus to the button** that opened the sheet when it closes.
-- **Announce an applied bonus in a polite live region** (`aria-live="polite"`).
-- **Use the preview's numbers and `upsell.name`**, never your own copy of them, and never a
-  literal `'vip'`: pass `upsell.pass` straight to `showPass`.
+**How it works:**
+
+- **The offer comes before the grant.** That is the point of the upsell: a bonus applies only if the
+  player holds VIP when the claim runs, and the platform holds nothing back, so a pass bought after
+  the grant cannot reach a reward already given.
+- **The numbers and the name come from the preview.** Show the preview's numbers and `upsell.name`
+  rather than your own copy of them, and pass `upsell.pass` straight to `showPass` rather than a
+  literal `'vip'`: what is on sale, and what it adds, can change without a release of your game.
+- **The price comes from the Arcade's sheet.** It varies by player and by sale, so your game does not
+  hard-code one; the sheet shows it.
+- **A locked roll shows as "+1 roll", not what it would land on.** The roll has not happened: it
+  happens when the recipe runs.
+
+**The one rule: disclose the odds** for a bonus roll, as for any roll
+([§12](#12-loot-tables-and-odds)). Store rules require it for a paid random item (Apple's App Store
+Review Guideline 3.1.1 among them).
+
+**Recommended, for accessibility:**
+
+- Show a lock as an icon plus text, not colour alone.
+- Return focus to the button that opened the sheet when it closes.
+- Announce an applied bonus in a polite live region (`aria-live="polite"`).
+
+The card itself is your game's design: how it looks, which button leads and when it appears. The
+platform sets no rule on them.
 
 ### Reading the player's balance
 

package/docs/manifest.json

@@ -18,8 +18,8 @@
     },
     {
       "file": "arcade-and-store.md",
-      "sha256": "73e77f3bd0124f69d53b42714fb24c7d128dd1be97e203fc3a353a8eb4e3c05a",
-      "updated": "2026-11-11T01:56:34Z"
+      "sha256": "d5b3d7753bf00b87d39f16741e743605214059d4b4a499a69b3a5e7350ec288f",
+      "updated": "2026-11-13T00:22:09Z"
     },
     {
       "file": "arcade-avatars.md",
@@ -48,8 +48,8 @@
     },
     {
       "file": "changelog.md",
-      "sha256": "1df1bb9edeb1db3a6e69f2625b091e3a06b6e3ca7accb7e6c22a392dbf95ba3c",
-      "updated": "2026-11-11T13:36:03Z"
+      "sha256": "8339a777114f7d8ad7acfcc61d47af25b3e027dc3bdc42c092e9064bd578f78e",
+      "updated": "2026-11-13T03:35:34Z"
     },
     {
       "file": "daily-challenges.md",
@@ -78,8 +78,8 @@
     },
     {
       "file": "getting-started.md",
-      "sha256": "d740cfa7dd54f089399b3a83f29442f12337afa88309c997d598f583f5c9f113",
-      "updated": "2026-11-11T13:36:03Z"
+      "sha256": "35401b63060f02364bad539eef2718c5907e8e418b0456582759b65e2313bbe2",
+      "updated": "2026-11-13T03:35:34Z"
     },
     {
       "file": "graphics-route.md",
@@ -88,8 +88,8 @@
     },
     {
       "file": "inventory-and-catalogs.md",
-      "sha256": "22998fb3ff26d4f9f29d2a73ce6db0ccf42ca2b635f171023a2e2214bbea4b1a",
-      "updated": "2026-11-11T01:56:34Z"
+      "sha256": "f32ea4291e47763e7ec664f1c1fee71e0cd1b443f4c617194ab3d27f556aec79",
+      "updated": "2026-11-13T00:16:49Z"
     },
     {
       "file": "leaderboards.md",
@@ -113,8 +113,8 @@
     },
     {
       "file": "platform-rules.md",
-      "sha256": "e9cb3cf1945002d182d917b0f3f7cfdf26f41de9ec9cd34a47c487cb4c615152",
-      "updated": "2026-11-11T01:56:34Z"
+      "sha256": "ba07fc48837dce46500478ae958e03394e7af9650f8314a1868d30e4c3b70354",
+      "updated": "2026-11-12T20:29:05Z"
     },
     {
       "file": "player-sign-in.md",
@@ -143,8 +143,8 @@
     },
     {
       "file": "server-bundles.md",
-      "sha256": "8e18e0c918476d0bd4ca83a56fa8274dccb9c4f344c6eba566e3067104dc912d",
-      "updated": "2026-11-11T13:36:03Z"
+      "sha256": "4eca8bb4a1b9018257bb9411ecaf3e65cdef472d8b0cc5653b49ab991680eb6c",
+      "updated": "2026-11-13T03:35:34Z"
     },
     {
       "file": "serverless-functions-js.md",

package/docs/platform-rules.md

@@ -357,8 +357,9 @@ A game **must not gate** anything on the multiplier:
 `requires: [{ kind: 'holds_pass', pass: 'vip' }]` on the item, recipe, bonus or track, which the
 platform checks when it runs; or a decision your function or server makes from its pass read
 (`gem.me.passes` in a function, `gem.match.playerPasses` on a server). The browser's
-`gem.me.passes` draws the door; it never opens it. Offer VIP only before a reward, by the rules in
-[inventory-and-catalogs.md](inventory-and-catalogs.md#offering-vip-before-a-reward-the-upsell).
+`gem.me.passes` draws the door; it never opens it. To offer VIP at a reward, offer it before the
+grant, as [inventory-and-catalogs.md](inventory-and-catalogs.md#offering-vip-before-a-reward-the-upsell)
+describes.
 
 Three reasons not to gate on the multiplier, any one of which would be enough. It is **advisory**:
 the browser value is pushed on connect and on change, so it can lag, and the platform's own figure

package/docs/server-bundles.md

@@ -80,8 +80,8 @@ To check the download yourself: the package npm serves is, byte for byte, the fi
 also publishes on its download host, with the hash beside it:
 
 ```bash
-curl -fsSL -O https://downloads.gemarcade.com/sdk/v24.0.1/gem-web-sdk.tgz
-curl -fsSL https://downloads.gemarcade.com/sdk/v24.0.1/gem-web-sdk.tgz.sri
+curl -fsSL -O https://downloads.gemarcade.com/sdk/v24.1.0/gem-web-sdk.tgz
+curl -fsSL https://downloads.gemarcade.com/sdk/v24.1.0/gem-web-sdk.tgz.sri
 openssl dgst -sha384 -binary gem-web-sdk.tgz | openssl base64 -A
 ```
 

package/package.json

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

package/schema/bridge.v1.json

@@ -6099,11 +6099,15 @@
         "multipliers it carries in `earnMultipliers`, so a game can find VIP by",
         "slug and preview what it would add without naming a SKU or a number.",
         "A parent lists a pass only where it would open that pass's sheet: an",
-        "offering with `visible_to_games`, to a player who has not declined",
-        "its sheet twice today. For a KNOWN MINOR it leaves the pass out",
+        "offering with `visible_to_games`. A player declining its sheet never",
+        "takes it out of the listing. For a KNOWN MINOR it leaves the pass out",
         "exactly as if it were not on sale - the same `ok`, the same other",
         "offers, no reason - so a game can never tell a minor from a pass that",
-        "is not sold here. A holder still sees it: the sheet adds time.",
+        "is not sold here. A HOLDER may be listed the pass or not, as the",
+        "parent's store decides, and a frame must not assume either. The rule",
+        "is only that the sheet follows the listing: a listed pass opens its",
+        "sheet, and gem.requestStoreOfferSheet for a pass that is not listed is",
+        "answered `unavailable` with nothing shown.",
         "",
         "COIN PACKS ARE `gem_pack`. The kind enum is closed (a fifth value",
         "would be refused whole by an N-1 frame), so a pack of any platform",