@indiegems/gem-web-sdk 15.3.3 → 16.0.0

package/docs/api/reference.json

@@ -2,7 +2,7 @@
   "schema_version": 2,
   "source": {
     "repo": "IndieGems/gem-web-sdk",
-    "version": "15.3.3"
+    "version": "16.0.0"
   },
   "entries": [
     {
@@ -69,6 +69,14 @@
           "key": "share",
           "title": "Sharing a link to your game"
         },
+        {
+          "key": "arcade",
+          "title": "Arcade features: app links, other games"
+        },
+        {
+          "key": "store",
+          "title": "The Arcade Store, for real money"
+        },
         {
           "key": "vibration",
           "title": "Vibrating the device"
@@ -4167,7 +4175,1004 @@
           "group": "analytics",
           "signature": "readonly rejected: readonly AnalyticsRejection[]",
           "documented": true,
-          "summary": "Every event the platform refused, by index into the batch that was sent.\n\n⚠️ REJECTIONS ARRIVE INSIDE A 200, never as a thrown error, and the\naccepted events in the same batch were still written. An empty array is\nthe ordinary case.",
+          "summary": "Every event the platform refused, by index into the batch that was sent.\n\n⚠️ REJECTIONS ARRIVE INSIDE A 200, never as a thrown error, and the\naccepted events in the same batch were still written. An empty array is\nthe ordinary case.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsFlushResult.dropped",
+          "name": "dropped",
+          "anchor": "analyticsflushresult-dropped",
+          "group": "analytics",
+          "signature": "readonly dropped: number",
+          "documented": true,
+          "summary": "How many events the local queue threw away since the last successful\nflush, because it was full. The oldest go first.\n\nA number worth alarming on: it is nonzero only when the game is producing\nevents faster than the platform accepts them.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsFlushResult.duplicate",
+          "name": "duplicate",
+          "anchor": "analyticsflushresult-duplicate",
+          "group": "analytics",
+          "signature": "readonly duplicate: boolean",
+          "documented": true,
+          "summary": "True when the platform had already seen this batch and wrote nothing.\n\nA retry that the first attempt had in fact delivered. Not an error — it is\nwhat stops a flush racing a `pagehide` from being counted twice — and\n`accepted` is 0 on one.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsFlushOptions",
+          "name": "AnalyticsFlushOptions",
+          "anchor": "analyticsflushoptions",
+          "group": "analytics",
+          "signature": "interface AnalyticsFlushOptions",
+          "documented": true,
+          "summary": "What [AnalyticsApi.flush](api-reference-game.md#analyticsapi-flush) takes.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsFlushOptions.keepalive",
+          "name": "keepalive",
+          "anchor": "analyticsflushoptions-keepalive",
+          "group": "analytics",
+          "signature": "readonly keepalive?: boolean",
+          "documented": true,
+          "summary": "Let the request outlive a page that is going away.\n\nFor the last flush before the player leaves. The browser caps how much can\nbe in flight this way and shares that cap with everything else the SDK\nsends on the way out, so a keepalive flush sends a SMALLER batch and\nleaves the rest queued — which on a closing page means leaving it behind.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsFlushOptions.signal",
+          "name": "signal",
+          "anchor": "analyticsflushoptions-signal",
+          "group": "analytics",
+          "signature": "readonly signal?: AbortSignal",
+          "documented": true,
+          "summary": "Cancel the flush.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsOptions",
+          "name": "AnalyticsOptions",
+          "anchor": "analyticsoptions",
+          "group": "analytics",
+          "signature": "interface AnalyticsOptions",
+          "documented": true,
+          "summary": "What `GemOptions.analytics` takes. Every field has a working default.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsOptions.enabled",
+          "name": "enabled",
+          "anchor": "analyticsoptions-enabled",
+          "group": "analytics",
+          "signature": "readonly enabled?: boolean",
+          "documented": true,
+          "summary": "Turn tracking off without removing your `track` calls, which become\nno-ops. The namespace is still there and the platform's own `gem_*`\nevents still go out. Defaults to on.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsOptions.flushIntervalMs",
+          "name": "flushIntervalMs",
+          "anchor": "analyticsoptions-flushintervalms",
+          "group": "analytics",
+          "signature": "readonly flushIntervalMs?: number",
+          "documented": true,
+          "summary": "How often the queue is flushed, in milliseconds. Defaults to 10 000, and\nis FLOORED at 10 000 — the platform rate-limits this route at 12 requests per\nminute per player, and a shorter interval spends that budget for nothing.\n\nA full queue does not wait for this: 50 events flush at once.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsOptions.maxQueue",
+          "name": "maxQueue",
+          "anchor": "analyticsoptions-maxqueue",
+          "group": "analytics",
+          "signature": "readonly maxQueue?: number",
+          "documented": true,
+          "summary": "How many events may wait in memory. Defaults to 500. Past it the OLDEST\nare discarded and counted in [AnalyticsFlushResult.dropped](api-reference-game.md#analyticsflushresult-dropped) — the\nnewest events are the ones a developer is looking at.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsApi",
+          "name": "AnalyticsApi",
+          "anchor": "analyticsapi",
+          "group": "analytics",
+          "signature": "class AnalyticsApi",
+          "documented": true,
+          "summary": "Your game's own analytics — the events you declared in your game config,\nplus the `gem_*` session and match events the SDK emits for you.\n\nReached as `gem.analytics`. [AnalyticsApi.track](api-reference-game.md#analyticsapi-track) is synchronous, never\nthrows and never rejects: it puts an event on an in-memory queue, and the\nSDK posts that queue on its own timer, when it reaches 50 events, and on the\nway out of the page.\n\n```js\ngem.analytics.setContext({ build: 'v1.4.2' });\n\ngem.analytics.track('level_completed', {\n  outcome: 'win',        // a dimension — a declared, closed set\n  difficulty: 'normal',  // a dimension\n  duration_ms: 48_120,   // a measure — summed, averaged, min and max\n  score: 3_100,          // a measure\n});\n```\n\n⚠️ **Every key has to be declared.** `analytics_events` in your game config\nis what says which events exist, which dimensions each has and which values\neach dimension may take. An undeclared name or key is not stored — it comes\nback as a rejection, which the SDK prints to the console during development.\n\n⚠️ **Detail older than 60 days is gone.** Raw events live 60 days; the daily\ncounters live 400. Anything you want to be able to ask about a year from now\nhas to be a declared dimension today.\n\n⚠️ **These are your numbers, not the platform's.** Client events are\ngame-asserted browser facts. They feed your analytics and nothing the\nplatform treats as authoritative — not rewards, not dailies, not store\nranking.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "analytics",
+              "anchor": null
+            }
+          ]
+        },
+        {
+          "id": "AnalyticsApi.track",
+          "name": "track",
+          "anchor": "analyticsapi-track",
+          "group": "analytics",
+          "signature": "track(name: string, props?: Readonly<Record<string, AnalyticsValue>>): void",
+          "documented": true,
+          "summary": "Record an event. Synchronous, and it never throws.\n\nString values become dimensions and numbers become measures, matched\nagainst your `analytics_events` declaration server-side. Nothing is sent\nyet: the event joins a queue that goes out on a timer, at 50 events, and\non the way out of the page.\n\n⚠️ `gem_` IS RESERVED. The SDK emits the platform's own events itself, so\na name starting `gem_` is refused here rather than sent and rejected\nthere.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "name",
+              "type": "string",
+              "optional": false,
+              "summary": "A declared event id — the `id` of an entry in your config's\n  `analytics_events`."
+            },
+            {
+              "name": "props",
+              "type": "Readonly<Record<string, AnalyticsValue>>",
+              "optional": false,
+              "summary": "Dimensions (strings) and measures (numbers), merged over\n  whatever [AnalyticsApi.setContext](api-reference-game.md#analyticsapi-setcontext) holds."
+            }
+          ],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsApi.setContext",
+          "name": "setContext",
+          "anchor": "analyticsapi-setcontext",
+          "group": "analytics",
+          "signature": "setContext(props: Readonly<Record<string, AnalyticsValue>>): void",
+          "documented": true,
+          "summary": "Merge values into every event **you** record after this call.\n\nWhat keeps a build marker or a difficulty setting off every call site. An\nevent's own `props` win over context for the same key.\n\n⚠️ Context keys are declared like any other: a key here that your\n`analytics_events` entry does not carry is rejected on every event it\nreaches, not just the one you were thinking of.\n\n⚠️ **CONTEXT IS NOT GLOBAL — it reaches your `track` calls and never the\nplatform's own `gem_*` events.** Their dimensions are fixed by the platform\nand no config can widen them, so a context key on one would refuse the\nwhole event rather than annotate it. Session, pause, boot, match and\nauth-lost events therefore carry exactly what the platform declares for\nthem, whatever you set here.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "props",
+              "type": "Readonly<Record<string, AnalyticsValue>>",
+              "optional": false,
+              "summary": null
+            }
+          ],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsApi.experiment",
+          "name": "experiment",
+          "anchor": "analyticsapi-experiment",
+          "group": "analytics",
+          "signature": "experiment(key: string, count: number): Promise<number>",
+          "documented": true,
+          "summary": "Which arm of one of your experiments this player gets — the same answer on\nevery call, every refresh and every device. Use it wherever you would have\npicked an arm with `Math.random()`, which deals a player a new arm on each\nvisit and makes the test unreadable.\n\nPass a COUNT and get an index, `0` to `count - 1`; pass a LIST of strings\nand get one of them. A string listed twice is twice as likely.\n\n```js\nconst tutorial = await gem.analytics.experiment('tutorial_length', ['short', 'long']);\nconst layout = await gem.analytics.experiment('shop_layout', 3); // 0, 1 or 2\n```\n\nThe selection is a hash of the key and the signed-in player's id — FNV-1a\n32-bit over `\"<key>:<playerId>\"`, then MurmurHash3's 32-bit finalizer, mod\nthe arm count; see\n[experimentSelection](api-reference-game.md#experimentselection), which computes the same answer for an id you\nhold. Hashing the key in is what keeps your experiments independent: the\nplayers in one experiment's first arm are not the same players in every\nother experiment's first arm.\n\n⚠️ **Keep the key and the arms fixed for the life of the experiment.** A new\ncount or list re-deals every player. To start over on purpose, use a new\nkey.\n\n⚠️ **NOTHING IS RECORDED FOR YOU.** The selection is not sent anywhere, and\nthe SDK does not add it to your events. To analyse an experiment, declare a\ndimension for it on the events you want to break down, with the arms as its\nvalues, named after the experiment, and pass the selection there yourself:\n`gem.analytics.track('tutorial_finished', { tutorial_length: tutorial })`.\nNever the platform's `variant` field, which belongs to store-page\nexperiments.\n\nWAITS FOR THE PLAYER. The id arrives with the first play token, so a call\nduring boot waits for it, and rejects as [Gem.awaitIdentity](api-reference-game.md#gem-awaitidentity) does\nwhen none arrives — outside the Arcade, the Gem Editor or the dev host.\nThere is no random fallback: catch the rejection and play your control arm.\nA guest is selected by their guest id, which is stable for as long as their\nguest account lasts; once they sign in to an account they are that\naccount's player, and its selection applies.\n\nIn a serverless function it selects for the player who invoked it, with\nno wait, and rejects when a game server invoked it.\n\nWorks with analytics turned off: it reads no setting and sends nothing.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "key",
+              "type": "string",
+              "optional": false,
+              "summary": "Names the experiment — any non-empty string."
+            },
+            {
+              "name": "count",
+              "type": "number",
+              "optional": false,
+              "summary": "How many arms, an integer from 1 to 2048 — or, in the list\n  form, `options`: the arms themselves, 1 to 2048 strings."
+            }
+          ],
+          "returns": "The arm's index, or the chosen string.",
+          "throws": "TypeError for an empty key or a list holding something other than\n  strings; RangeError for a count or list size outside 1 to 2048. Both\n  reject before waiting for the player.",
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsApi.environment",
+          "name": "environment",
+          "anchor": "analyticsapi-environment",
+          "group": "analytics",
+          "signature": "get environment(): Readonly<Record<string, string>>",
+          "documented": true,
+          "summary": "What the SDK knows about the build this session is running — `sdk_version`,\nand `game_version` when you passed `clientVersion` to `createGem`.\n\n⚠️ **THE SDK DOES NOT STAMP THESE ONTO YOUR EVENTS, and the reason is not\ntimidity.** The platform validates every property of every event against your\n`analytics_events` declaration and refuses the WHOLE EVENT over a key it\ndoes not carry — so an SDK that merged `sdk_version` into context would get\nevery event of every game that had not declared that dimension rejected\n`unknown_dimension`, including the platform's own `gem_*` events, whose\ndimensions are fixed. Only your config can declare a dimension, so only you\ncan turn these on:\n\n```js\n// with sdk_version and game_version declared on the events that want them\ngem.analytics.setContext(gem.analytics.environment);\n```\n\nEvery dimension costs cardinality — the product of an event's dimension\nsizes is capped — so declare them on the handful of events where knowing\nwhich build produced a number is worth it, rather than on all of them.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AnalyticsApi.flush",
+          "name": "flush",
+          "anchor": "analyticsapi-flush",
+          "group": "analytics",
+          "signature": "flush(options?: AnalyticsFlushOptions): Promise<AnalyticsFlushResult>",
+          "documented": true,
+          "summary": "Send what is queued now, and find out what happened to it.\n\nResolves with the platform's own answer, INCLUDING per-event rejections, which\narrive inside a 200 — see [AnalyticsFlushResult.rejected](api-reference-game.md#analyticsflushresult-rejected). You do\nnot have to call this: the SDK flushes on its own, and on the way out of\nthe page.\n\nA refusal that could clear on its own — a 429 from the rate limiter, a 503\nwhile the platform's idempotency store is unreachable — KEEPS the queue\nand rejects, so the next flush sends the same events rather than losing\nthem. The SDK's own flushes then hold off for the longer of the server's\n`Retry-After` and a cooldown that doubles from 10 seconds, up to five\nminutes. A refusal that cannot clear discards the batch it was sent for,\nbecause resending it can only fail identically.\n\nOne flush at a time: called while another is still on the wire, this\nresolves at once with nothing sent, and what is queued goes out after it.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "options",
+              "type": "AnalyticsFlushOptions",
+              "optional": false,
+              "summary": null
+            }
+          ],
+          "returns": null,
+          "throws": "[GemApiError](api-reference-game.md#gemapierror) on a refusal.",
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "SessionEndReason",
+          "name": "SessionEndReason",
+          "anchor": "sessionendreason",
+          "group": "analytics",
+          "signature": "type SessionEndReason = \"grant_expiring\" | \"session_ended\" | \"navigating\" | \"kill_switch\" | \"pagehide\"",
+          "documented": true,
+          "summary": "Why a play session ended.\n\nThe closed set `gem_session_end` is broken down by. A value outside it is\nrejected as `dimension_value_not_declared`.\n\n⚠️ `pagehide` is the BEST-EFFORT one. The keepalive flush that carries it is\na browser budget, not a guarantee, so `duration_ms` on a `pagehide` end is\nthe reading a funnel should treat as approximate.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTransport",
+          "name": "MatchTransport",
+          "anchor": "matchtransport",
+          "group": "analytics",
+          "signature": "type MatchTransport = \"dedicated\" | \"p2p\"",
+          "documented": true,
+          "summary": "How a match was hosted — the closed set `gem_match_started` and\n`gem_match_ended` are broken down by.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "PlatformEventName",
+          "name": "PlatformEventName",
+          "anchor": "platformeventname",
+          "group": "analytics",
+          "signature": "type PlatformEventName = \"gem_session_start\" | \"gem_session_end\" | \"gem_pause\" | \"gem_resume\" | \"gem_boot_ready\" | \"gem_match_started\" | \"gem_match_ended\" | \"gem_auth_lost\"",
+          "documented": true,
+          "summary": "Every event the SDK emits by itself.\n\nA game never sends these — `gem.analytics.track` refuses the whole\n`gem_` namespace — but the names are published because a game reading its\nown funnel needs the vocabulary, and because a funnel declared in the game\nconfig names them as steps.\n\n| Event | Dimensions | Measures |\n|---|---|---|\n| `gem_session_start` | — | — |\n| `gem_session_end` | `reason` ([SessionEndReason](api-reference-game.md#sessionendreason)) | `duration_ms` |\n| `gem_pause` / `gem_resume` | — | — |\n| `gem_boot_ready` | — | `boot_ms` |\n| `gem_match_started` / `gem_match_ended` | `transport` ([MatchTransport](api-reference-game.md#matchtransport)) | — |\n| `gem_auth_lost` | — | — |",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "PLATFORM_EVENTS",
+          "name": "PLATFORM_EVENTS",
+          "anchor": "platform_events",
+          "group": "analytics",
+          "signature": "PLATFORM_EVENTS: readonly PlatformEventName[]",
+          "documented": true,
+          "summary": "The platform event names, as a list.\n\nThe runtime companion to [PlatformEventName](api-reference-game.md#platformeventname), for a game that wants to\nshow what it gets for free, or to check a funnel step it authored against\nwhat the platform actually emits.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "experimentSelection",
+          "name": "experimentSelection",
+          "anchor": "experimentselection",
+          "group": "analytics",
+          "signature": "function experimentSelection(key: string, playerId: string, count: number): number",
+          "documented": true,
+          "summary": "Which arm of an experiment a player gets — the same answer for the same key\nand player, every time, anywhere.\n\nIn a game, call [AnalyticsApi.experiment](api-reference-game.md#analyticsapi-experiment) instead: it is this, with\nthe signed-in player's id filled in. This form takes the id, for code that\nhas one in hand — a dedicated server reproducing what a member's client\npicked, or a test.\n\nPass a COUNT and get an index, `0` to `count - 1`; pass a LIST of strings\nand get one of them. A string listed twice is twice as likely, which is how\nto weight an arm.\n\nThe answer is `fmix32(fnv1a32(\"<key>:<playerId>\")) % count`: FNV-1a 32-bit\nover the UTF-8 bytes of the key, a colon and the player id, then\nMurmurHash3's 32-bit finalizer, as an unsigned integer — with a list, the\nindex into it. The hash is fixed, so any other language can reproduce a\nselection; docs/analytics.md has it written out.\n\n⚠️ **Keep the key and the arms fixed for the life of the experiment.** A new\ncount or list re-deals every player. To start over on purpose, use a new\nkey.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "key",
+              "type": "string",
+              "optional": false,
+              "summary": "Names the experiment — any non-empty string, and the only thing\n  that makes one experiment's split independent of another's."
+            },
+            {
+              "name": "playerId",
+              "type": "string",
+              "optional": false,
+              "summary": "The player to select for — [GemIdentity.playerId](api-reference-game.md#gemidentity-playerid)."
+            },
+            {
+              "name": "count",
+              "type": "number",
+              "optional": false,
+              "summary": "How many arms, an integer from 1 to 2048 — or, in the list\n  form, `options`: the arms themselves, 1 to 2048 strings."
+            }
+          ],
+          "returns": null,
+          "throws": "TypeError for an empty key or player id, or a list holding something\n  other than strings; RangeError for a count or list size outside 1 to 2048.",
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppStore",
+          "name": "AppStore",
+          "anchor": "appstore",
+          "group": "arcade",
+          "signature": "type AppStore = \"app_store\" | \"google_play\"",
+          "documented": true,
+          "summary": "Which app store a listing is in, so a game can draw the matching badge.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppListing",
+          "name": "AppListing",
+          "anchor": "applisting",
+          "group": "arcade",
+          "signature": "interface AppListing",
+          "documented": true,
+          "summary": "A store listing the arcade can open from here.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppListing.store",
+          "name": "store",
+          "anchor": "applisting-store",
+          "group": "arcade",
+          "signature": "readonly store: AppStore",
+          "documented": true,
+          "summary": "Which store it is in. Never a URL: the arcade builds the link.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppLinksOutcome",
+          "name": "AppLinksOutcome",
+          "anchor": "applinksoutcome",
+          "group": "arcade",
+          "signature": "interface AppLinksOutcome",
+          "documented": true,
+          "summary": "What [ArcadeApi.appLinks](api-reference-game.md#arcadeapi-applinks) resolves with. `arcade` and `game` are each\npresent only when [ArcadeApi.openApp](api-reference-game.md#arcadeapi-openapp) with that target would open a\nlisting here; show the matching button only then.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppLinksOutcome.arcade",
+          "name": "arcade",
+          "anchor": "applinksoutcome-arcade",
+          "group": "arcade",
+          "signature": "readonly arcade?: AppListing",
+          "documented": true,
+          "summary": "The Gem Arcade app's listing. Absent inside the Gem Arcade app itself.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppLinksOutcome.game",
+          "name": "game",
+          "anchor": "applinksoutcome-game",
+          "group": "arcade",
+          "signature": "readonly game?: AppListing",
+          "documented": true,
+          "summary": "This game's own app's listing, when it has one for this platform.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppLinksOutcome.outcome",
+          "name": "outcome",
+          "anchor": "applinksoutcome-outcome",
+          "group": "arcade",
+          "signature": "readonly outcome: ArcadeOutcomeKind",
+          "documented": true,
+          "summary": "What happened: `ok`, `declined` or `unavailable`. Branch on this.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AppLinksOutcome.reason",
+          "name": "reason",
+          "anchor": "applinksoutcome-reason",
+          "group": "arcade",
+          "signature": "readonly reason?: string",
+          "documented": true,
+          "summary": "Why, as a machine code — `busy`, `cancelled`, `not_found`, `pending`,\n`store_off`, `sign_in_required` and more. OPEN-ENDED: the arcade may send a\ncode this SDK has never heard of, so keep a `default` arm and never show a\ncode to a player. Absent when there is nothing to add.\n\nThree are the SDK's own, answered without asking the arcade:\n`unsupported` (the arcade here does not offer this), `invalid_argument`\n(the SDK refused what you passed) and `busy` (another ask of the same kind\nis still open). `error` means no reliable answer arrived — the ask never\nleft, the wait ran out, the bridge closed or the arcade had none. For\n`gem.store.purchase` that makes the outcome UNKNOWN, not a refusal: the\nplayer may have paid.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard",
+          "name": "GameCard",
+          "anchor": "gamecard",
+          "group": "arcade",
+          "signature": "interface GameCard",
+          "documented": true,
+          "summary": "One game, as an Arcade home tile shows it.\n\n⚠️ `name`, `tagline`, `shortDescription` and `tags` are **another\ndeveloper's text**, so they arrive as [PlayerText](api-reference-game.md#playertext): convert with\n`text.toPlain()` and render them as text, never as markup. The media URLs are\nthe platform's; your page's CSP must allow its media host for `img-src` and\n`media-src` (see `docs/arcade-and-store.md`).",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.gameId",
+          "name": "gameId",
+          "anchor": "gamecard-gameid",
+          "group": "arcade",
+          "signature": "readonly gameId: string",
+          "documented": true,
+          "summary": "The game's id: what [ArcadeApi.openGame](api-reference-game.md#arcadeapi-opengame) takes.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.slug",
+          "name": "slug",
+          "anchor": "gamecard-slug",
+          "group": "arcade",
+          "signature": "readonly slug?: string",
+          "documented": true,
+          "summary": "The game's web address, when it has one.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.name",
+          "name": "name",
+          "anchor": "gamecard-name",
+          "group": "arcade",
+          "signature": "readonly name: PlayerText",
+          "documented": true,
+          "summary": "The game's public name. Another developer's text.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.tagline",
+          "name": "tagline",
+          "anchor": "gamecard-tagline",
+          "group": "arcade",
+          "signature": "readonly tagline: PlayerText",
+          "documented": true,
+          "summary": "One line under the name. Another developer's text; may be empty.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.shortDescription",
+          "name": "shortDescription",
+          "anchor": "gamecard-shortdescription",
+          "group": "arcade",
+          "signature": "readonly shortDescription: PlayerText",
+          "documented": true,
+          "summary": "A sentence or two. Another developer's text; may be empty.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.tags",
+          "name": "tags",
+          "anchor": "gamecard-tags",
+          "group": "arcade",
+          "signature": "readonly tags: readonly PlayerText[]",
+          "documented": true,
+          "summary": "The game's store tags. Another developer's text.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.iconUrl",
+          "name": "iconUrl",
+          "anchor": "gamecard-iconurl",
+          "group": "arcade",
+          "signature": "readonly iconUrl: string",
+          "documented": true,
+          "summary": "The game's icon.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.capsuleLandscapeUrl",
+          "name": "capsuleLandscapeUrl",
+          "anchor": "gamecard-capsulelandscapeurl",
+          "group": "arcade",
+          "signature": "readonly capsuleLandscapeUrl: string",
+          "documented": true,
+          "summary": "The landscape tile art.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.capsulePortraitUrl",
+          "name": "capsulePortraitUrl",
+          "anchor": "gamecard-capsuleportraiturl",
+          "group": "arcade",
+          "signature": "readonly capsulePortraitUrl: string",
+          "documented": true,
+          "summary": "The portrait tile art.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.previewVideoUrl",
+          "name": "previewVideoUrl",
+          "anchor": "gamecard-previewvideourl",
+          "group": "arcade",
+          "signature": "readonly previewVideoUrl?: string",
+          "documented": true,
+          "summary": "The tile's hover clip. Absent when the game has none, and whenever the\narcade judges a clip unwelcome: reduced motion, data saver, a phone.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "GameCard.previewPosterUrl",
+          "name": "previewPosterUrl",
+          "anchor": "gamecard-previewposterurl",
+          "group": "arcade",
+          "signature": "readonly previewPosterUrl?: string",
+          "documented": true,
+          "summary": "The still shown before, and instead of, the clip.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "SimilarGamesOutcome",
+          "name": "SimilarGamesOutcome",
+          "anchor": "similargamesoutcome",
+          "group": "arcade",
+          "signature": "interface SimilarGamesOutcome",
+          "documented": true,
+          "summary": "What [ArcadeApi.similarGames](api-reference-game.md#arcadeapi-similargames) resolves with.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "SimilarGamesOutcome.games",
+          "name": "games",
+          "anchor": "similargamesoutcome-games",
+          "group": "arcade",
+          "signature": "readonly games: readonly GameCard[]",
+          "documented": true,
+          "summary": "Up to `limit` games, best first. Empty unless `ok` — and an `ok` may be empty too.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "SimilarGamesOutcome.outcome",
+          "name": "outcome",
+          "anchor": "similargamesoutcome-outcome",
+          "group": "arcade",
+          "signature": "readonly outcome: ArcadeOutcomeKind",
+          "documented": true,
+          "summary": "What happened: `ok`, `declined` or `unavailable`. Branch on this.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "SimilarGamesOutcome.reason",
+          "name": "reason",
+          "anchor": "similargamesoutcome-reason",
+          "group": "arcade",
+          "signature": "readonly reason?: string",
+          "documented": true,
+          "summary": "Why, as a machine code — `busy`, `cancelled`, `not_found`, `pending`,\n`store_off`, `sign_in_required` and more. OPEN-ENDED: the arcade may send a\ncode this SDK has never heard of, so keep a `default` arm and never show a\ncode to a player. Absent when there is nothing to add.\n\nThree are the SDK's own, answered without asking the arcade:\n`unsupported` (the arcade here does not offer this), `invalid_argument`\n(the SDK refused what you passed) and `busy` (another ask of the same kind\nis still open). `error` means no reliable answer arrived — the ask never\nleft, the wait ran out, the bridge closed or the arcade had none. For\n`gem.store.purchase` that makes the outcome UNKNOWN, not a refusal: the\nplayer may have paid.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeAvailability",
+          "name": "ArcadeAvailability",
+          "anchor": "arcadeavailability",
+          "group": "arcade",
+          "signature": "interface ArcadeAvailability",
+          "documented": true,
+          "summary": "Which arcade features answer here, read synchronously. Decide from these\nwhether to draw a \"Get the app\" button or a \"More games\" section at all.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeAvailability.appLinks",
+          "name": "appLinks",
+          "anchor": "arcadeavailability-applinks",
+          "group": "arcade",
+          "signature": "readonly appLinks: boolean",
+          "documented": true,
+          "summary": "[ArcadeApi.appLinks](api-reference-game.md#arcadeapi-applinks) and [ArcadeApi.openApp](api-reference-game.md#arcadeapi-openapp) reach the arcade.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeAvailability.openGame",
+          "name": "openGame",
+          "anchor": "arcadeavailability-opengame",
+          "group": "arcade",
+          "signature": "readonly openGame: boolean",
+          "documented": true,
+          "summary": "[ArcadeApi.openGame](api-reference-game.md#arcadeapi-opengame) and [ArcadeApi.similarGames](api-reference-game.md#arcadeapi-similargames) reach the arcade.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeApi",
+          "name": "ArcadeApi",
+          "anchor": "arcadeapi",
+          "group": "arcade",
+          "signature": "interface ArcadeApi",
+          "documented": true,
+          "summary": "The arcade-features surface. `gem.arcade` is one of these.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeApi.available",
+          "name": "available",
+          "anchor": "arcadeapi-available",
+          "group": "arcade",
+          "signature": "readonly available: ArcadeAvailability",
+          "documented": true,
+          "summary": "Which of these features the arcade answers here, synchronously. False\nbefore the bridge is up and wherever the arcade does not offer one — the\nsingle-game app, for instance, opens no other game.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeApi.appLinks",
+          "name": "appLinks",
+          "anchor": "arcadeapi-applinks",
+          "group": "arcade",
+          "signature": "appLinks(): Promise<AppLinksOutcome>",
+          "documented": true,
+          "summary": "Which app-store listings the arcade can open from here: the Gem Arcade\napp's and this game's own. A read: call it whenever, and show a button\nfor each listing present.",
+          "deprecated": null,
+          "params": [],
+          "returns": "Always resolves; never rejects.",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeApi.openApp",
+          "name": "openApp",
+          "anchor": "arcadeapi-openapp",
+          "group": "arcade",
+          "signature": "openApp(target: \"arcade\" | \"game\"): Promise<ArcadeOutcome>",
+          "documented": true,
+          "summary": "Open a store listing: the Gem Arcade app's (`'arcade'`) or this game's own\n(`'game'`). **Call it from the player's press handler** — the arcade\nrefuses an ask no person pressed for, `declined` / `busy`.\n\n`ok` means it opened, in a new tab or the store app, or (`reason:\n'handed_off'`) the arcade put up its own QR sheet. The answer comes at\nthat moment, not when the player closes the sheet, so carry on either\nway; while the sheet is up, another acting call is `declined` / `busy`.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "target",
+              "type": "\"arcade\" | \"game\"",
+              "optional": false,
+              "summary": null
+            }
+          ],
+          "returns": "Always resolves; never rejects.",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeApi.openGame",
+          "name": "openGame",
+          "anchor": "arcadeapi-opengame",
+          "group": "arcade",
+          "signature": "openGame(ref: string): Promise<ArcadeOutcome>",
+          "documented": true,
+          "summary": "Open another game in place of this one, by id or web address. **Call it\nfrom the player's press handler.**\n\n⚠️ On `ok` your game is about to be closed: `onWillTerminate` follows with\nthe ordinary save grace (250 ms). Save before you call this, not after.\n`declined` / `same_game` names this game; `unavailable` / `not_found` is a\ngame the player cannot open here.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "ref",
+              "type": "string",
+              "optional": false,
+              "summary": null
+            }
+          ],
+          "returns": "Always resolves; never rejects.",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeApi.similarGames",
+          "name": "similarGames",
+          "anchor": "arcadeapi-similargames",
+          "group": "arcade",
+          "signature": "similarGames(options?: { limit?: number }): Promise<SimilarGamesOutcome>",
+          "documented": true,
+          "summary": "Games like this one, as Arcade home tiles: up to `limit` (1 to 24, default\n12), best first. Hide the section when `games` is empty.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "options",
+              "type": "{ limit?: number }",
+              "optional": true,
+              "summary": null
+            }
+          ],
+          "returns": "Always resolves; never rejects.",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeOutcomeKind",
+          "name": "ArcadeOutcomeKind",
+          "anchor": "arcadeoutcomekind",
+          "group": "arcade",
+          "signature": "type ArcadeOutcomeKind = \"ok\" | \"declined\" | \"unavailable\"",
+          "documented": true,
+          "summary": "What the arcade did with an ask, the complete vocabulary: `ok`, `declined`\nor `unavailable`. Why is in `reason`, which is open-ended.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeOutcome",
+          "name": "ArcadeOutcome",
+          "anchor": "arcadeoutcome",
+          "group": "arcade",
+          "signature": "interface ArcadeOutcome",
+          "documented": true,
+          "summary": "The answer every `gem.arcade` and `gem.store` call resolves with, before\nanything specific to the call.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeOutcome.outcome",
+          "name": "outcome",
+          "anchor": "arcadeoutcome-outcome",
+          "group": "arcade",
+          "signature": "readonly outcome: ArcadeOutcomeKind",
+          "documented": true,
+          "summary": "What happened: `ok`, `declined` or `unavailable`. Branch on this.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "ArcadeOutcome.reason",
+          "name": "reason",
+          "anchor": "arcadeoutcome-reason",
+          "group": "arcade",
+          "signature": "readonly reason?: string",
+          "documented": true,
+          "summary": "Why, as a machine code — `busy`, `cancelled`, `not_found`, `pending`,\n`store_off`, `sign_in_required` and more. OPEN-ENDED: the arcade may send a\ncode this SDK has never heard of, so keep a `default` arm and never show a\ncode to a player. Absent when there is nothing to add.\n\nThree are the SDK's own, answered without asking the arcade:\n`unsupported` (the arcade here does not offer this), `invalid_argument`\n(the SDK refused what you passed) and `busy` (another ask of the same kind\nis still open). `error` means no reliable answer arrived — the ask never\nleft, the wait ran out, the bridge closed or the arcade had none. For\n`gem.store.purchase` that makes the outcome UNKNOWN, not a refusal: the\nplayer may have paid.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4177,13 +5182,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsFlushResult.dropped",
-          "name": "dropped",
-          "anchor": "analyticsflushresult-dropped",
-          "group": "analytics",
-          "signature": "readonly dropped: number",
+          "id": "ArcadeOffer",
+          "name": "ArcadeOffer",
+          "anchor": "arcadeoffer",
+          "group": "store",
+          "signature": "interface ArcadeOffer",
           "documented": true,
-          "summary": "How many events the local queue threw away since the last successful\nflush, because it was full. The oldest go first.\n\nA number worth alarming on: it is nonzero only when the game is producing\nevents faster than the platform accepts them.",
+          "summary": "One SKU the Arcade Store sells to this player, here, right now.\n\nShow `priceDisplay` **exactly as given**: it is the payment rail's own\nformatted price in the player's currency. Never parse it, compare it or\ncompute a discount from it. There is no numeric price, no balance and no\navailability flag — the arcade's sheet explains anything that stops a\npurchase.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4193,13 +5198,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsFlushResult.duplicate",
-          "name": "duplicate",
-          "anchor": "analyticsflushresult-duplicate",
-          "group": "analytics",
-          "signature": "readonly duplicate: boolean",
+          "id": "ArcadeOffer.skuId",
+          "name": "skuId",
+          "anchor": "arcadeoffer-skuid",
+          "group": "store",
+          "signature": "readonly skuId: string",
           "documented": true,
-          "summary": "True when the platform had already seen this batch and wrote nothing.\n\nA retry that the first attempt had in fact delivered. Not an error — it is\nwhat stops a flush racing a `pagehide` from being counted twice — and\n`accepted` is 0 on one.",
+          "summary": "The SKU's id: what [StoreApi.purchase](api-reference-game.md#storeapi-purchase) takes.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4209,13 +5214,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsFlushOptions",
-          "name": "AnalyticsFlushOptions",
-          "anchor": "analyticsflushoptions",
-          "group": "analytics",
-          "signature": "interface AnalyticsFlushOptions",
+          "id": "ArcadeOffer.kind",
+          "name": "kind",
+          "anchor": "arcadeoffer-kind",
+          "group": "store",
+          "signature": "readonly kind: \"gem_pack\" | \"boost\" | \"pass\" | \"bundle\"",
           "documented": true,
-          "summary": "What [AnalyticsApi.flush](api-reference-game.md#analyticsapi-flush) takes.",
+          "summary": "What sort of thing it is.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4225,13 +5230,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsFlushOptions.keepalive",
-          "name": "keepalive",
-          "anchor": "analyticsflushoptions-keepalive",
-          "group": "analytics",
-          "signature": "readonly keepalive?: boolean",
+          "id": "ArcadeOffer.name",
+          "name": "name",
+          "anchor": "arcadeoffer-name",
+          "group": "store",
+          "signature": "readonly name: string",
           "documented": true,
-          "summary": "Let the request outlive a page that is going away.\n\nFor the last flush before the player leaves. The browser caps how much can\nbe in flight this way and shares that cap with everything else the SDK\nsends on the way out, so a keepalive flush sends a SMALLER batch and\nleaves the rest queued — which on a closing page means leaving it behind.",
+          "summary": "The store's own name for it, localized as the store shows it.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4241,13 +5246,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsFlushOptions.signal",
-          "name": "signal",
-          "anchor": "analyticsflushoptions-signal",
-          "group": "analytics",
-          "signature": "readonly signal?: AbortSignal",
+          "id": "ArcadeOffer.description",
+          "name": "description",
+          "anchor": "arcadeoffer-description",
+          "group": "store",
+          "signature": "readonly description: string",
           "documented": true,
-          "summary": "Cancel the flush.",
+          "summary": "What the player gets, in the store's words. May be empty.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4257,13 +5262,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsOptions",
-          "name": "AnalyticsOptions",
-          "anchor": "analyticsoptions",
-          "group": "analytics",
-          "signature": "interface AnalyticsOptions",
+          "id": "ArcadeOffer.imageUrl",
+          "name": "imageUrl",
+          "anchor": "arcadeoffer-imageurl",
+          "group": "store",
+          "signature": "readonly imageUrl?: string",
           "documented": true,
-          "summary": "What `GemOptions.analytics` takes. Every field has a working default.",
+          "summary": "The SKU's art, when it has any.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4273,13 +5278,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsOptions.enabled",
-          "name": "enabled",
-          "anchor": "analyticsoptions-enabled",
-          "group": "analytics",
-          "signature": "readonly enabled?: boolean",
+          "id": "ArcadeOffer.priceDisplay",
+          "name": "priceDisplay",
+          "anchor": "arcadeoffer-pricedisplay",
+          "group": "store",
+          "signature": "readonly priceDisplay: string",
           "documented": true,
-          "summary": "Turn tracking off without removing your `track` calls, which become\nno-ops. The namespace is still there and the platform's own `gem_*`\nevents still go out. Defaults to on.",
+          "summary": "The price, formatted by the payment rail. Show it as given.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4289,13 +5294,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsOptions.flushIntervalMs",
-          "name": "flushIntervalMs",
-          "anchor": "analyticsoptions-flushintervalms",
-          "group": "analytics",
-          "signature": "readonly flushIntervalMs?: number",
+          "id": "ArcadeOffer.grant",
+          "name": "grant",
+          "anchor": "arcadeoffer-grant",
+          "group": "store",
+          "signature": "readonly grant?: { currency: string; amount: number }",
           "documented": true,
-          "summary": "How often the queue is flushed, in milliseconds. Defaults to 10 000, and\nis FLOORED at 10 000 — the platform rate-limits this route at 12 requests per\nminute per player, and a shorter interval spends that budget for nothing.\n\nA full queue does not wait for this: 50 events flush at once.",
+          "summary": "For a Gem pack: the platform currency and the amount it grants.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4305,13 +5310,13 @@
           "guides": []
         },
         {
-          "id": "AnalyticsOptions.maxQueue",
-          "name": "maxQueue",
-          "anchor": "analyticsoptions-maxqueue",
-          "group": "analytics",
-          "signature": "readonly maxQueue?: number",
+          "id": "ArcadeOffer.grant.currency",
+          "name": "currency",
+          "anchor": "arcadeoffer-grant-currency",
+          "group": "store",
+          "signature": "readonly currency: string",
           "documented": true,
-          "summary": "How many events may wait in memory. Defaults to 500. Past it the OLDEST\nare discarded and counted in [AnalyticsFlushResult.dropped](api-reference-game.md#analyticsflushresult-dropped) — the\nnewest events are the ones a developer is looking at.",
+          "summary": "The platform currency's exact slug, e.g. `GEMS`.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4321,49 +5326,31 @@
           "guides": []
         },
         {
-          "id": "AnalyticsApi",
-          "name": "AnalyticsApi",
-          "anchor": "analyticsapi",
-          "group": "analytics",
-          "signature": "class AnalyticsApi",
+          "id": "ArcadeOffer.grant.amount",
+          "name": "amount",
+          "anchor": "arcadeoffer-grant-amount",
+          "group": "store",
+          "signature": "readonly amount: number",
           "documented": true,
-          "summary": "Your game's own analytics — the events you declared in your game config,\nplus the `gem_*` session and match events the SDK emits for you.\n\nReached as `gem.analytics`. [AnalyticsApi.track](api-reference-game.md#analyticsapi-track) is synchronous, never\nthrows and never rejects: it puts an event on an in-memory queue, and the\nSDK posts that queue on its own timer, when it reaches 50 events, and on the\nway out of the page.\n\n```js\ngem.analytics.setContext({ build: 'v1.4.2' });\n\ngem.analytics.track('level_completed', {\n  outcome: 'win',        // a dimension — a declared, closed set\n  difficulty: 'normal',  // a dimension\n  duration_ms: 48_120,   // a measure — summed, averaged, min and max\n  score: 3_100,          // a measure\n});\n```\n\n⚠️ **Every key has to be declared.** `analytics_events` in your game config\nis what says which events exist, which dimensions each has and which values\neach dimension may take. An undeclared name or key is not stored — it comes\nback as a rejection, which the SDK prints to the console during development.\n\n⚠️ **Detail older than 60 days is gone.** Raw events live 60 days; the daily\ncounters live 400. Anything you want to be able to ask about a year from now\nhas to be a declared dimension today.\n\n⚠️ **These are your numbers, not the platform's.** Client events are\ngame-asserted browser facts. They feed your analytics and nothing the\nplatform treats as authoritative — not rewards, not dailies, not store\nranking.",
+          "summary": "How much of it the pack grants.",
           "deprecated": null,
           "params": [],
           "returns": null,
           "throws": null,
           "example": null,
           "defaultValue": null,
-          "guides": [
-            {
-              "slug": "analytics",
-              "anchor": null
-            }
-          ]
+          "guides": []
         },
         {
-          "id": "AnalyticsApi.track",
-          "name": "track",
-          "anchor": "analyticsapi-track",
-          "group": "analytics",
-          "signature": "track(name: string, props?: Readonly<Record<string, AnalyticsValue>>): void",
+          "id": "StoreOffersOutcome",
+          "name": "StoreOffersOutcome",
+          "anchor": "storeoffersoutcome",
+          "group": "store",
+          "signature": "interface StoreOffersOutcome",
           "documented": true,
-          "summary": "Record an event. Synchronous, and it never throws.\n\nString values become dimensions and numbers become measures, matched\nagainst your `analytics_events` declaration server-side. Nothing is sent\nyet: the event joins a queue that goes out on a timer, at 50 events, and\non the way out of the page.\n\n⚠️ `gem_` IS RESERVED. The SDK emits the platform's own events itself, so\na name starting `gem_` is refused here rather than sent and rejected\nthere.",
+          "summary": "What [StoreApi.offers](api-reference-game.md#storeapi-offers) resolves with.",
           "deprecated": null,
-          "params": [
-            {
-              "name": "name",
-              "type": "string",
-              "optional": false,
-              "summary": "A declared event id — the `id` of an entry in your config's\n  `analytics_events`."
-            },
-            {
-              "name": "props",
-              "type": "Readonly<Record<string, AnalyticsValue>>",
-              "optional": false,
-              "summary": "Dimensions (strings) and measures (numbers), merged over\n  whatever [AnalyticsApi.setContext](api-reference-game.md#analyticsapi-setcontext) holds."
-            }
-          ],
+          "params": [],
           "returns": null,
           "throws": null,
           "example": null,
@@ -4371,22 +5358,15 @@
           "guides": []
         },
         {
-          "id": "AnalyticsApi.setContext",
-          "name": "setContext",
-          "anchor": "analyticsapi-setcontext",
-          "group": "analytics",
-          "signature": "setContext(props: Readonly<Record<string, AnalyticsValue>>): void",
+          "id": "StoreOffersOutcome.outcome",
+          "name": "outcome",
+          "anchor": "storeoffersoutcome-outcome",
+          "group": "store",
+          "signature": "readonly outcome: ArcadeOutcomeKind",
           "documented": true,
-          "summary": "Merge values into every event **you** record after this call.\n\nWhat keeps a build marker or a difficulty setting off every call site. An\nevent's own `props` win over context for the same key.\n\n⚠️ Context keys are declared like any other: a key here that your\n`analytics_events` entry does not carry is rejected on every event it\nreaches, not just the one you were thinking of.\n\n⚠️ **CONTEXT IS NOT GLOBAL — it reaches your `track` calls and never the\nplatform's own `gem_*` events.** Their dimensions are fixed by the platform\nand no config can widen them, so a context key on one would refuse the\nwhole event rather than annotate it. Session, pause, boot, match and\nauth-lost events therefore carry exactly what the platform declares for\nthem, whatever you set here.",
+          "summary": "What happened: `ok`, `declined` or `unavailable`. Branch on this.",
           "deprecated": null,
-          "params": [
-            {
-              "name": "props",
-              "type": "Readonly<Record<string, AnalyticsValue>>",
-              "optional": false,
-              "summary": null
-            }
-          ],
+          "params": [],
           "returns": null,
           "throws": null,
           "example": null,
@@ -4394,42 +5374,29 @@
           "guides": []
         },
         {
-          "id": "AnalyticsApi.experiment",
-          "name": "experiment",
-          "anchor": "analyticsapi-experiment",
-          "group": "analytics",
-          "signature": "experiment(key: string, count: number): Promise<number>",
+          "id": "StoreOffersOutcome.reason",
+          "name": "reason",
+          "anchor": "storeoffersoutcome-reason",
+          "group": "store",
+          "signature": "readonly reason?: string",
           "documented": true,
-          "summary": "Which arm of one of your experiments this player gets — the same answer on\nevery call, every refresh and every device. Use it wherever you would have\npicked an arm with `Math.random()`, which deals a player a new arm on each\nvisit and makes the test unreadable.\n\nPass a COUNT and get an index, `0` to `count - 1`; pass a LIST of strings\nand get one of them. A string listed twice is twice as likely.\n\n```js\nconst tutorial = await gem.analytics.experiment('tutorial_length', ['short', 'long']);\nconst layout = await gem.analytics.experiment('shop_layout', 3); // 0, 1 or 2\n```\n\nThe selection is a hash of the key and the signed-in player's id — FNV-1a\n32-bit over `\"<key>:<playerId>\"`, then MurmurHash3's 32-bit finalizer, mod\nthe arm count; see\n[experimentSelection](api-reference-game.md#experimentselection), which computes the same answer for an id you\nhold. Hashing the key in is what keeps your experiments independent: the\nplayers in one experiment's first arm are not the same players in every\nother experiment's first arm.\n\n⚠️ **Keep the key and the arms fixed for the life of the experiment.** A new\ncount or list re-deals every player. To start over on purpose, use a new\nkey.\n\n⚠️ **NOTHING IS RECORDED FOR YOU.** The selection is not sent anywhere, and\nthe SDK does not add it to your events. To analyse an experiment, declare a\ndimension for it on the events you want to break down, with the arms as its\nvalues, named after the experiment, and pass the selection there yourself:\n`gem.analytics.track('tutorial_finished', { tutorial_length: tutorial })`.\nNever the platform's `variant` field, which belongs to store-page\nexperiments.\n\nWAITS FOR THE PLAYER. The id arrives with the first play token, so a call\nduring boot waits for it, and rejects as [Gem.awaitIdentity](api-reference-game.md#gem-awaitidentity) does\nwhen none arrives — outside the Arcade, the Gem Editor or the dev host.\nThere is no random fallback: catch the rejection and play your control arm.\nA guest is selected by their guest id, which is stable for as long as their\nguest account lasts; once they sign in to an account they are that\naccount's player, and its selection applies.\n\nIn a serverless function it selects for the player who invoked it, with\nno wait, and rejects when a game server invoked it.\n\nWorks with analytics turned off: it reads no setting and sends nothing.",
+          "summary": "Why, as a machine code — `busy`, `cancelled`, `not_found`, `pending`,\n`store_off`, `sign_in_required` and more. OPEN-ENDED: the arcade may send a\ncode this SDK has never heard of, so keep a `default` arm and never show a\ncode to a player. Absent when there is nothing to add.\n\nThree are the SDK's own, answered without asking the arcade:\n`unsupported` (the arcade here does not offer this), `invalid_argument`\n(the SDK refused what you passed) and `busy` (another ask of the same kind\nis still open). `error` means no reliable answer arrived — the ask never\nleft, the wait ran out, the bridge closed or the arcade had none. For\n`gem.store.purchase` that makes the outcome UNKNOWN, not a refusal: the\nplayer may have paid.",
           "deprecated": null,
-          "params": [
-            {
-              "name": "key",
-              "type": "string",
-              "optional": false,
-              "summary": "Names the experiment — any non-empty string."
-            },
-            {
-              "name": "count",
-              "type": "number",
-              "optional": false,
-              "summary": "How many arms, an integer from 1 to 2048 — or, in the list\n  form, `options`: the arms themselves, 1 to 2048 strings."
-            }
-          ],
-          "returns": "The arm's index, or the chosen string.",
-          "throws": "TypeError for an empty key or a list holding something other than\n  strings; RangeError for a count or list size outside 1 to 2048. Both\n  reject before waiting for the player.",
+          "params": [],
+          "returns": null,
+          "throws": null,
           "example": null,
           "defaultValue": null,
           "guides": []
         },
         {
-          "id": "AnalyticsApi.environment",
-          "name": "environment",
-          "anchor": "analyticsapi-environment",
-          "group": "analytics",
-          "signature": "get environment(): Readonly<Record<string, string>>",
+          "id": "StoreOffersOutcome.offers",
+          "name": "offers",
+          "anchor": "storeoffersoutcome-offers",
+          "group": "store",
+          "signature": "readonly offers: readonly ArcadeOffer[]",
           "documented": true,
-          "summary": "What the SDK knows about the build this session is running — `sdk_version`,\nand `game_version` when you passed `clientVersion` to `createGem`.\n\n⚠️ **THE SDK DOES NOT STAMP THESE ONTO YOUR EVENTS, and the reason is not\ntimidity.** The platform validates every property of every event against your\n`analytics_events` declaration and refuses the WHOLE EVENT over a key it\ndoes not carry — so an SDK that merged `sdk_version` into context would get\nevery event of every game that had not declared that dimension rejected\n`unknown_dimension`, including the platform's own `gem_*` events, whose\ndimensions are fixed. Only your config can declare a dimension, so only you\ncan turn these on:\n\n```js\n// with sdk_version and game_version declared on the events that want them\ngem.analytics.setContext(gem.analytics.environment);\n```\n\nEvery dimension costs cardinality — the product of an event's dimension\nsizes is capped — so declare them on the handful of events where knowing\nwhich build produced a number is worth it, rather than on all of them.",
+          "summary": "What the store sells here, in its own order. Empty unless `ok`.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4439,36 +5406,29 @@
           "guides": []
         },
         {
-          "id": "AnalyticsApi.flush",
-          "name": "flush",
-          "anchor": "analyticsapi-flush",
-          "group": "analytics",
-          "signature": "flush(options?: AnalyticsFlushOptions): Promise<AnalyticsFlushResult>",
+          "id": "StoreSettlement",
+          "name": "StoreSettlement",
+          "anchor": "storesettlement",
+          "group": "store",
+          "signature": "interface StoreSettlement",
           "documented": true,
-          "summary": "Send what is queued now, and find out what happened to it.\n\nResolves with the platform's own answer, INCLUDING per-event rejections, which\narrive inside a 200 — see [AnalyticsFlushResult.rejected](api-reference-game.md#analyticsflushresult-rejected). You do\nnot have to call this: the SDK flushes on its own, and on the way out of\nthe page.\n\nA refusal that could clear on its own — a 429 from the rate limiter, a 503\nwhile the platform's idempotency store is unreachable — KEEPS the queue\nand rejects, so the next flush sends the same events rather than losing\nthem. The SDK's own flushes then hold off for the longer of the server's\n`Retry-After` and a cooldown that doubles from 10 seconds, up to five\nminutes. A refusal that cannot clear discards the batch it was sent for,\nbecause resending it can only fail identically.\n\nOne flush at a time: called while another is still on the wire, this\nresolves at once with nothing sent, and what is queued goes out after it.",
+          "summary": "A purchase that answered `ok` / `pending` has settled.",
           "deprecated": null,
-          "params": [
-            {
-              "name": "options",
-              "type": "AnalyticsFlushOptions",
-              "optional": false,
-              "summary": null
-            }
-          ],
+          "params": [],
           "returns": null,
-          "throws": "[GemApiError](api-reference-game.md#gemapierror) on a refusal.",
+          "throws": null,
           "example": null,
           "defaultValue": null,
           "guides": []
         },
         {
-          "id": "SessionEndReason",
-          "name": "SessionEndReason",
-          "anchor": "sessionendreason",
-          "group": "analytics",
-          "signature": "type SessionEndReason = \"grant_expiring\" | \"session_ended\" | \"navigating\" | \"kill_switch\" | \"pagehide\"",
+          "id": "StoreSettlement.skuId",
+          "name": "skuId",
+          "anchor": "storesettlement-skuid",
+          "group": "store",
+          "signature": "readonly skuId: string",
           "documented": true,
-          "summary": "Why a play session ended.\n\nThe closed set `gem_session_end` is broken down by. A value outside it is\nrejected as `dimension_value_not_declared`.\n\n⚠️ `pagehide` is the BEST-EFFORT one. The keepalive flush that carries it is\na browser budget, not a guarantee, so `duration_ms` on a `pagehide` end is\nthe reading a funnel should treat as approximate.",
+          "summary": "The SKU it was for. Re-read balances and inventory through `gem.me`.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4478,13 +5438,13 @@
           "guides": []
         },
         {
-          "id": "MatchTransport",
-          "name": "MatchTransport",
-          "anchor": "matchtransport",
-          "group": "analytics",
-          "signature": "type MatchTransport = \"dedicated\" | \"p2p\"",
+          "id": "StoreApi",
+          "name": "StoreApi",
+          "anchor": "storeapi",
+          "group": "store",
+          "signature": "interface StoreApi",
           "documented": true,
-          "summary": "How a match was hosted — the closed set `gem_match_started` and\n`gem_match_ended` are broken down by.",
+          "summary": "**Real money.** The Arcade Store's own Gem packs, Boosts, passes and bundles,\nbought with the player's money through the arcade's own purchase sheet.\n`gem.store` is one of these. To spend Gems or Coins on your game's own items,\nuse `gem.purchases`.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4494,13 +5454,13 @@
           "guides": []
         },
         {
-          "id": "PlatformEventName",
-          "name": "PlatformEventName",
-          "anchor": "platformeventname",
-          "group": "analytics",
-          "signature": "type PlatformEventName = \"gem_session_start\" | \"gem_session_end\" | \"gem_pause\" | \"gem_resume\" | \"gem_boot_ready\" | \"gem_match_started\" | \"gem_match_ended\" | \"gem_auth_lost\"",
+          "id": "StoreApi.available",
+          "name": "available",
+          "anchor": "storeapi-available",
+          "group": "store",
+          "signature": "readonly available: boolean",
           "documented": true,
-          "summary": "Every event the SDK emits by itself.\n\nA game never sends these — `gem.analytics.track` refuses the whole\n`gem_` namespace — but the names are published because a game reading its\nown funnel needs the vocabulary, and because a funnel declared in the game\nconfig names them as steps.\n\n| Event | Dimensions | Measures |\n|---|---|---|\n| `gem_session_start` | — | — |\n| `gem_session_end` | `reason` ([SessionEndReason](api-reference-game.md#sessionendreason)) | `duration_ms` |\n| `gem_pause` / `gem_resume` | — | — |\n| `gem_boot_ready` | — | `boot_ms` |\n| `gem_match_started` / `gem_match_ended` | `transport` ([MatchTransport](api-reference-game.md#matchtransport)) | — |\n| `gem_auth_lost` | — | — |",
+          "summary": "Whether the Arcade Store answers here, synchronously. Draw your own \"Get\nGems\" button only when it is true.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -4510,52 +5470,63 @@
           "guides": []
         },
         {
-          "id": "PLATFORM_EVENTS",
-          "name": "PLATFORM_EVENTS",
-          "anchor": "platform_events",
-          "group": "analytics",
-          "signature": "PLATFORM_EVENTS: readonly PlatformEventName[]",
+          "id": "StoreApi.offers",
+          "name": "offers",
+          "anchor": "storeapi-offers",
+          "group": "store",
+          "signature": "offers(): Promise<StoreOffersOutcome>",
           "documented": true,
-          "summary": "The platform event names, as a list.\n\nThe runtime companion to [PlatformEventName](api-reference-game.md#platformeventname), for a game that wants to\nshow what it gets for free, or to check a funnel step it authored against\nwhat the platform actually emits.",
+          "summary": "What the store sells this player here: names, art and the rail's own\nprices. `unavailable` / `sign_in_required` for a guest (offer\n`gem.account.requestSignIn`), `unavailable` / `store_off` where the store\nis withheld. Re-read on resume: what is on sale can change.",
           "deprecated": null,
           "params": [],
-          "returns": null,
+          "returns": "Always resolves; never rejects.",
           "throws": null,
           "example": null,
           "defaultValue": null,
           "guides": []
         },
         {
-          "id": "experimentSelection",
-          "name": "experimentSelection",
-          "anchor": "experimentselection",
-          "group": "analytics",
-          "signature": "function experimentSelection(key: string, playerId: string, count: number): number",
+          "id": "StoreApi.purchase",
+          "name": "purchase",
+          "anchor": "storeapi-purchase",
+          "group": "store",
+          "signature": "purchase(skuId: string): Promise<ArcadeOutcome>",
           "documented": true,
-          "summary": "Which arm of an experiment a player gets — the same answer for the same key\nand player, every time, anywhere.\n\nIn a game, call [AnalyticsApi.experiment](api-reference-game.md#analyticsapi-experiment) instead: it is this, with\nthe signed-in player's id filled in. This form takes the id, for code that\nhas one in hand — a dedicated server reproducing what a member's client\npicked, or a test.\n\nPass a COUNT and get an index, `0` to `count - 1`; pass a LIST of strings\nand get one of them. A string listed twice is twice as likely, which is how\nto weight an arm.\n\nThe answer is `fmix32(fnv1a32(\"<key>:<playerId>\")) % count`: FNV-1a 32-bit\nover the UTF-8 bytes of the key, a colon and the player id, then\nMurmurHash3's 32-bit finalizer, as an unsigned integer — with a list, the\nindex into it. The hash is fixed, so any other language can reproduce a\nselection; docs/analytics.md has it written out.\n\n⚠️ **Keep the key and the arms fixed for the life of the experiment.** A new\ncount or list re-deals every player. To start over on purpose, use a new\nkey.",
+          "summary": "Ask the arcade to open its store's purchase sheet for one SKU from\n[StoreApi.offers](api-reference-game.md#storeapi-offers). **Call it from the player's press handler** — the\narcade refuses an ask no person pressed for, `declined` / `busy`.\n\n- `ok` — the player paid. Re-read balances and inventory through `gem.me`;\n  nothing here carries an amount. With `reason: 'pending'`, the provider\n  has not settled yet: [StoreApi.onSettled](api-reference-game.md#storeapi-onsettled) hears when it does.\n- `declined` — nothing was bought: `cancelled` (the player said no) or\n  `busy`. Return to your screen silently, and do not ask again unprompted.\n- `unavailable` with `store_off`, `sign_in_required`, `not_found`,\n  `unsupported`, `invalid_argument` or a payment provider's failure code —\n  nothing was bought.\n- `unavailable` / `error` — **the outcome is unknown, and the player may\n  have paid.** It is what you get when the bridge closes while the sheet\n  is open, or the arcade has no reliable answer. Never tell the player\n  nothing was bought: re-read balances and inventory through `gem.me`,\n  and keep listening with [StoreApi.onSettled](api-reference-game.md#storeapi-onsettled).\n\nNO TIMEOUT: it waits for as long as the arcade is connected, because a\npayment takes as long as it takes.",
           "deprecated": null,
           "params": [
             {
-              "name": "key",
-              "type": "string",
-              "optional": false,
-              "summary": "Names the experiment — any non-empty string, and the only thing\n  that makes one experiment's split independent of another's."
-            },
-            {
-              "name": "playerId",
+              "name": "skuId",
               "type": "string",
               "optional": false,
-              "summary": "The player to select for — [GemIdentity.playerId](api-reference-game.md#gemidentity-playerid)."
-            },
+              "summary": null
+            }
+          ],
+          "returns": "Always resolves; never rejects.",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "StoreApi.onSettled",
+          "name": "onSettled",
+          "anchor": "storeapi-onsettled",
+          "group": "store",
+          "signature": "onSettled(listener: (settlement: StoreSettlement) => void): () => void",
+          "documented": true,
+          "summary": "Hear when a purchase that answered `ok` / `pending` settles, while your\ngame is running. Returns a function that stops listening.",
+          "deprecated": null,
+          "params": [
             {
-              "name": "count",
-              "type": "number",
+              "name": "listener",
+              "type": "(settlement: StoreSettlement) => void",
               "optional": false,
-              "summary": "How many arms, an integer from 1 to 2048 — or, in the list\n  form, `options`: the arms themselves, 1 to 2048 strings."
+              "summary": null
             }
           ],
           "returns": null,
-          "throws": "TypeError for an empty key or player id, or a list holding something\n  other than strings; RangeError for a count or list size outside 1 to 2048.",
+          "throws": null,
           "example": null,
           "defaultValue": null,
           "guides": []
@@ -11023,7 +11994,7 @@
           "group": "start",
           "signature": "readonly purchases: PurchaseApi",
           "documented": true,
-          "summary": "Buy one of YOUR OWN items or recipes with platform currency, on the\nplayer's behalf.\n\nThis is the platform-owned path: the request crosses the bridge, the parent\nalways renders the platform purchase sheet in trusted chrome, and the\nparent's account session submits the confirmed purchase.\n\nFor a game-owned purchase UI, call `gem.me.mutations.purchase()` with\n`payment: { kind: 'platform_currency', currencySlug: 'GEMS' }`. That direct\nSDK path does not cross the bridge or invoke the platform sheet.\n\nThe catalog is yours to read directly; only the money crosses the bridge.\nBuild your shop from `gameConfig`, then call this when the player taps Buy.\n\nResolves for every outcome — a decline is what a shop does, not an\nexception. On `ok`, re-read inventory rather than assuming what landed.",
+          "summary": "**Gems and Coins, not real money.** Buy one of YOUR OWN items or recipes\nwith platform currency, on the player's behalf. To sell the Arcade Store's\nown Gem packs, Boosts and passes for the player's money, use\n[Gem.store](api-reference-game.md#gem-store).\n\nThis is the platform-owned path: the request crosses the bridge, the parent\nalways renders the platform purchase sheet in trusted chrome, and the\nparent's account session submits the confirmed purchase.\n\nFor a game-owned purchase UI, call `gem.me.mutations.purchase()` with\n`payment: { kind: 'platform_currency', currencySlug: 'GEMS' }`. That direct\nSDK path does not cross the bridge or invoke the platform sheet.\n\nThe catalog is yours to read directly; only the money crosses the bridge.\nBuild your shop from `gameConfig`, then call this when the player taps Buy.\n\nResolves for every outcome — a decline is what a shop does, not an\nexception. On `ok`, re-read inventory rather than assuming what landed.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -11132,6 +12103,48 @@
             }
           ]
         },
+        {
+          "id": "Gem.arcade",
+          "name": "arcade",
+          "anchor": "gem-arcade",
+          "group": "start",
+          "signature": "readonly arcade: ArcadeApi",
+          "documented": true,
+          "summary": "The Gem Arcade's own features, asked for from your game: link out to the\nGem Arcade app or your game's own app, open another game, and list games\nlike yours as home tiles.\n\nThe game asks; the arcade decides. Nothing you send is a URL, and nothing\nrejects: every call resolves `{ outcome, reason, … }`. Check\n[ArcadeApi.available](api-reference-game.md#arcadeapi-available) before drawing a button, and call `openApp`\nand `openGame` from the player's press handler.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "arcade-and-store",
+              "anchor": null
+            }
+          ]
+        },
+        {
+          "id": "Gem.store",
+          "name": "store",
+          "anchor": "gem-store",
+          "group": "start",
+          "signature": "readonly store: StoreApi",
+          "documented": true,
+          "summary": "**Real money.** The Arcade Store's own Gem packs, Boosts, passes and\nbundles, sold for the player's money through the arcade's own purchase\nsheet. To spend Gems or Coins on your game's own items, use\n[Gem.purchases](api-reference-game.md#gem-purchases).\n\nList what the store sells here with `offers()`, show each `priceDisplay`\nexactly as given, and call `purchase(skuId)` from the player's press. After\n`ok`, re-read balances through [Gem.me](api-reference-game.md#gem-me). Nothing rejects.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "arcade-and-store",
+              "anchor": null
+            }
+          ]
+        },
         {
           "id": "Gem.avatarPickerAvailable",
           "name": "avatarPickerAvailable",