@indiegems/gem-web-sdk 13.0.0 → 13.2.0

package/docs/api/reference.json

@@ -2,7 +2,7 @@
   "schema_version": 2,
   "source": {
     "repo": "IndieGems/gem-web-sdk",
-    "version": "13.0.0"
+    "version": "13.2.0"
   },
   "entries": [
     {
@@ -53,9 +53,13 @@
           "key": "deviceSettings",
           "title": "Settings kept on this device"
         },
+        {
+          "key": "moments",
+          "title": "Platform moments"
+        },
         {
           "key": "ads",
-          "title": "Cross-promotion"
+          "title": "Rewarded ads, and the deprecated interstitial"
         },
         {
           "key": "account",
@@ -382,7 +386,7 @@
           "defaultValue": null,
           "guides": [
             {
-              "slug": "cross-promotion",
+              "slug": "rewarded-ads",
               "anchor": null
             }
           ]
@@ -3767,7 +3771,7 @@
           "group": "ads",
           "signature": "type AdFormat = \"interstitial\" | \"rewarded\"",
           "documented": true,
-          "summary": "Which kind of break this is.\n\n`interstitial` is a panel the player dismisses and nothing follows from.\n\n`rewarded` is a button the player pressed for a reward, such as a revive or\nan extra attempt, that your game config declares for the placement in\n`rewarded_placements`. The press is the player's opt-in, and the arcade\nstarts the ad straight away, so ask from the button's own handler (see\n[AdsApi.requestAd](api-reference-game.md#adsapi-requestad)). It is served where this arcade serves it, and\nanswered `no_ad` where it does not. ⚠️ The outcome grants nothing: the\nplatform grants the reward, against its own record, never your game reading\n`shown`. It arrives on your game's inventory for this player, written by the\nplatform, so re-read `gem.me.inventory` after a `rewarded` ask settles rather\nthan waiting for a signal on this pair; there will not be one.",
+          "summary": "Which kind of break this is.\n\n`interstitial` is a panel the player dismisses and nothing follows from.\n**Deprecated:** signal a platform moment with `gem.moments.signal` instead.\nIt keeps working — the arcade treats it as a platform moment — and `14.0.0`\nis the earliest release that may remove it (`docs/deprecation-policy.md`).\n\n`rewarded` is a button the player pressed for a reward, such as a revive or\nan extra attempt, that your game config declares for the placement in\n`rewarded_placements`. The press is the player's opt-in, and the arcade\nstarts the ad straight away, so ask from the button's own handler (see\n[AdsApi.requestAd](api-reference-game.md#adsapi-requestad)). It is served where this arcade serves it, and\nanswered `no_ad` where it does not. ⚠️ The outcome grants nothing: the\nplatform grants the reward, against its own record, never your game reading\n`shown`. It arrives on your game's inventory for this player, written by the\nplatform, so re-read `gem.me.inventory` after a `rewarded` ask settles rather\nthan waiting for a signal on this pair; there will not be one.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -3884,7 +3888,7 @@
           "group": "ads",
           "signature": "interface AdsApi",
           "documented": true,
-          "summary": "The cross-promotion surface. `gem.ads` is one of these.",
+          "summary": "Rewarded ads, and the deprecated interstitial ask. `gem.ads` is one of these.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -3900,7 +3904,7 @@
           "group": "ads",
           "signature": "requestAd(req: AdRequest): Promise<AdOutcome>",
           "documented": true,
-          "summary": "Ask whether the arcade has anything to show at this break in play.\n\nNOTHING REJECTS, and the answer is usually `no_ad`. Every local refusal —\nan arcade that does not do this at all, a call while another is still in\nflight, a `placement` this module will not send — resolves `no_ad` rather\nthan throwing, so a game needs exactly one branch. Only \"no answer ever\narrived\" resolves `unavailable`.\n\nThe arcade pauses your game while a panel is up and resumes it when this\nsettles, so you do not need to pause anything yourself.\n\n⚠️ `shown` grants nothing. Never hand out a reward, an unlock or a currency\non the strength of it. A `rewarded` placement's reward is granted by the\nplatform into your game's inventory; re-read `gem.me.inventory` once this\nsettles, whatever it settled as.\n\n**A `rewarded` ask must come from the player's press.** The press is the\nplayer's opt-in, and the arcade starts the ad as soon as the ask arrives.\nCall this from your button's `click`, `pointerup`, `touchend` or `keydown`\nhandler, before anything that can outlast the press, such as a slow\n`await` or a timer. **Not from `pointerdown` or `touchstart`:** on a\ntouchscreen they run before the browser counts the tap, so the ask is\nrefused on a phone while the same code works at a desk with a mouse. A\ncontroller press counts when the ask follows it within a second, so ask\nfrom the frame of your input loop that saw the button go down. Where the\nbrowser reports user activation (`navigator.userActivation`), the frame\nholds none, and no controller was used in the last second, this answers\n`no_ad` without asking. It also calls your `onError` handler with\ncode `'internal'` and a message that begins\n`rewarded_requires_user_gesture`, and writes one `[gem]` line a session\nthrough your `log`. Where the browser has no such API, the ask goes ahead.\nAn `interstitial` needs no press.",
+          "summary": "Ask whether the arcade has anything to show at this break in play.\n\n**For a break in play, signal a platform moment with\n`gem.moments.signal` instead: `format: 'interstitial'` is deprecated.** It\nkeeps working until at least `14.0.0`. A `rewarded` ask is unchanged.\n\nNOTHING REJECTS, and the answer is usually `no_ad`. Every local refusal —\nan arcade that does not do this at all, a call while another is still in\nflight, a `placement` this module will not send — resolves `no_ad` rather\nthan throwing, so a game needs exactly one branch. Only \"no answer ever\narrived\" resolves `unavailable`.\n\nThe arcade pauses your game while a panel is up and resumes it when this\nsettles, so you do not need to pause anything yourself.\n\n⚠️ `shown` grants nothing. Never hand out a reward, an unlock or a currency\non the strength of it. A `rewarded` placement's reward is granted by the\nplatform into your game's inventory; re-read `gem.me.inventory` once this\nsettles, whatever it settled as.\n\n**A `rewarded` ask must come from the player's press.** The press is the\nplayer's opt-in, and the arcade starts the ad as soon as the ask arrives.\nCall this from your button's `click`, `pointerup`, `touchend` or `keydown`\nhandler, before anything that can outlast the press, such as a slow\n`await` or a timer. **Not from `pointerdown` or `touchstart`:** on a\ntouchscreen they run before the browser counts the tap, so the ask is\nrefused on a phone while the same code works at a desk with a mouse. A\ncontroller press counts when the ask follows it within a second, so ask\nfrom the frame of your input loop that saw the button go down. Where the\nbrowser reports user activation (`navigator.userActivation`), the frame\nholds none, and no controller was used in the last second, this answers\n`no_ad` without asking. It also calls your `onError` handler with\ncode `'internal'` and a message that begins\n`rewarded_requires_user_gesture`, and writes one `[gem]` line a session\nthrough your `log`. Where the browser has no such API, the ask goes ahead.\nAn `interstitial` needs no press.",
           "deprecated": null,
           "params": [
             {
@@ -3912,7 +3916,7 @@
           ],
           "returns": "The arcade's answer. Always resolves; never rejects.",
           "throws": null,
-          "example": "```ts\nconst { outcome } = await gem.ads.requestAd({\n  placement: 'level-complete',\n  format: 'interstitial',\n});\n// `no_ad` is the ordinary answer. There is nothing to show and nothing\n// to draw; carry straight on to the next level.\nstartNextLevel();\n```\n\n```ts\n// A rewarded ask, from the button's own click: the ask comes first, and\n// the inventory read comes after it.\nwatchAdButton.addEventListener('click', async () => {\n  watchAdButton.disabled = true; // only between the press and the answer\n  await gem.ads.requestAd({ placement: 'dice_rolls', format: 'rewarded' });\n  gem.me.inventory.refresh();\n  try {\n    showDice(await gem.me.inventory.snapshot());\n  } finally {\n    watchAdButton.disabled = false;\n  }\n});\n```",
+          "example": "```ts\n// A rewarded ask, from the button's own click: the ask comes first, and\n// the inventory read comes after it.\nwatchAdButton.addEventListener('click', async () => {\n  watchAdButton.disabled = true; // only between the press and the answer\n  await gem.ads.requestAd({ placement: 'dice_rolls', format: 'rewarded' });\n  gem.me.inventory.refresh();\n  try {\n    showDice(await gem.me.inventory.snapshot());\n  } finally {\n    watchAdButton.disabled = false;\n  }\n});\n```",
           "defaultValue": null,
           "guides": []
         },
@@ -3939,7 +3943,7 @@
           "defaultValue": null,
           "guides": [
             {
-              "slug": "cross-promotion",
+              "slug": "rewarded-ads",
               "anchor": null
             }
           ]
@@ -4319,7 +4323,7 @@
           "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 30 days is gone.** Raw events live 30 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": "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,
@@ -4408,7 +4412,7 @@
           "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. A refusal that cannot clear discards the batch it was sent for,\nbecause resending it can only fail identically.",
+          "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": [
             {
@@ -4797,6 +4801,118 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "AvatarRigNode",
+          "name": "AvatarRigNode",
+          "anchor": "avatarrignode",
+          "group": "avatars3d",
+          "signature": "interface AvatarRigNode",
+          "documented": true,
+          "summary": "One node of a rig family's tree: its exact, case-sensitive name, and the\nname of the node it is a DIRECT child of. `parent` is `null` for the rig's\nroot, which is a root node of the scene.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AvatarRigNode.node",
+          "name": "node",
+          "anchor": "avatarrignode-node",
+          "group": "avatars3d",
+          "signature": "readonly node: string",
+          "documented": true,
+          "summary": "The node's name, exact and case-sensitive.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AvatarRigNode.parent",
+          "name": "parent",
+          "anchor": "avatarrignode-parent",
+          "group": "avatars3d",
+          "signature": "readonly parent: string | null",
+          "documented": true,
+          "summary": "The node it is a direct child of; `null` for the rig's root.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AvatarRigs",
+          "name": "AvatarRigs",
+          "anchor": "avatarrigs",
+          "group": "avatars3d",
+          "signature": "interface AvatarRigs",
+          "documented": true,
+          "summary": "The rig families this SDK knows, by name.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AvatarRigs.small_human",
+          "name": "small_human",
+          "anchor": "avatarrigs-small_human",
+          "group": "avatars3d",
+          "signature": "readonly small_human: readonly AvatarRigNode[]",
+          "documented": true,
+          "summary": "The toy rig: rigid limbs on a body, eight nodes.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AvatarRigs.adult_human",
+          "name": "adult_human",
+          "anchor": "avatarrigs-adult_human",
+          "group": "avatars3d",
+          "signature": "readonly adult_human: readonly AvatarRigNode[]",
+          "documented": true,
+          "summary": "The adult humanoid with fingers: 56 nodes, world-aligned at rest.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "AVATAR_RIGS",
+          "name": "AVATAR_RIGS",
+          "anchor": "avatar_rigs",
+          "group": "avatars3d",
+          "signature": "AVATAR_RIGS: AvatarRigs",
+          "documented": true,
+          "summary": "Every node each rig family requires, with the node it is a direct child of,\nparents before children. Frozen: read it, never change it.\n\nThe platform refuses an upload whose model is missing one of these, has one\nunder another parent, or has one twice (`rig_mismatch`). Extra nodes are\nallowed anywhere. `adult_human` also requires every one of its nodes to be\nworld-aligned at rest; that rule is not in this list, see the guide.\n\n```js\nimport { AVATAR_RIGS } from '@indiegems/gem-web-sdk/sdk';\n\n// Every joint of the worn avatar, by name.\nconst joints = new Map(\n  AVATAR_RIGS.adult_human.map(({ node }) => [node, gltf.scene.getObjectByName(node)]),\n);\n\n// A test that one of your own models is on the rig.\nfor (const { node, parent } of AVATAR_RIGS.adult_human) {\n  const found = gltf.scene.getObjectByName(node);\n  if (!found) throw new Error(`missing ${node}`);\n  if (parent !== null && found.parent?.name !== parent) throw new Error(`${node} is not under ${parent}`);\n}\n```",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "GemApiError",
           "name": "GemApiError",
@@ -6346,7 +6462,7 @@
           "group": "platform",
           "signature": "interface RewardCue",
           "documented": true,
-          "summary": "A platform-currency reward on its way to the arcade — in the Gem Arcade, a\nflight into the Gem button at the top-left of your frame — what\n`gem.cueReward` takes.",
+          "summary": "A platform-currency reward on its way to the arcade — in the Gem Arcade, a\nflight into the Gem button, in whichever corner of your frame it sits — what\n`gem.cueReward` takes.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -6435,6 +6551,22 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "GemCorner",
+          "name": "GemCorner",
+          "anchor": "gemcorner",
+          "group": "frame",
+          "signature": "type GemCorner = \"top-left\" | \"top-right\" | \"bottom-left\" | \"bottom-right\"",
+          "documented": true,
+          "summary": "A corner of your frame, for `gem.setGemCorner`: where you would like the\narcade's Gem button to sit. `'top-left'` is where it sits unless you ask.\nPhysical corners: `'top-left'` is the top-left in every language.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "FrameState",
           "name": "FrameState",
@@ -6769,6 +6901,29 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "GemFrame.setGemCorner",
+          "name": "setGemCorner",
+          "anchor": "gemframe-setgemcorner",
+          "group": "frame",
+          "signature": "setGemCorner(corner: GemCorner): boolean",
+          "documented": true,
+          "summary": "Ask the arcade to put its own control over your game — the Gem button —\nin this corner of your frame: the whole answer each time, the latest one\nwinning.\n\nPrefer `gem.setGemCorner`, which holds the corner across a reconnect.\nThis one sends only while connected, and only to an arcade that can move\nits control.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "corner",
+              "type": "GemCorner",
+              "optional": false,
+              "summary": null
+            }
+          ],
+          "returns": "whether the message left the frame — `false` before the bridge is\n  up, for an arcade that cannot move its control, for a value that is not\n  one of the four corners, and past this frame's own limit.",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "GemFrame.requestShare",
           "name": "requestShare",
@@ -9401,7 +9556,7 @@
           "group": "player",
           "signature": "readonly reserved: readonly GemReservedArea[]",
           "documented": true,
-          "summary": "Rectangles of your frame the arcade's own controls cover — in the Gem\nArcade, its Gem button in the top-left corner, and the frame-rate readout\nbeside it while the player shows it; an embedder that draws wallets over\nyour game adds theirs (see `setWalletVisible`). Keep essential UI and touch\ntargets out of them. Empty when the arcade covers nothing.\n\nA stylesheet reads the per-corner custom properties the SDK stamps from\nthese instead — `--gem-reserved-tl-height` and friends.",
+          "summary": "Rectangles of your frame the arcade's own controls cover — in the Gem\nArcade, its Gem button in whichever corner it sits, and the frame-rate readout\nbeside it while the player shows it; an embedder that draws wallets over\nyour game adds theirs (see `setWalletVisible`). Keep essential UI and touch\ntargets out of them. Empty when the arcade covers nothing.\n\nA stylesheet reads the per-corner custom properties the SDK stamps from\nthese instead — `--gem-reserved-tl-height` and friends.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -9956,6 +10111,27 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "Gem.moments",
+          "name": "moments",
+          "anchor": "gem-moments",
+          "group": "start",
+          "signature": "readonly moments: MomentsApi",
+          "documented": true,
+          "summary": "Platform moments — **every game, at every break.** Signal one from the\nplayer's press that leaves a natural break in play (Next, Retry, Back to\nmenu), and the arcade may show one of its own offers over your paused\ngame. It usually shows nothing.\n\nRequired by the release checklist at every important break, whether or\nnot your game has a shop of its own. Never resolves a reason, never\nrejects, and `shown` grants nothing.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "platform-moments",
+              "anchor": null
+            }
+          ]
+        },
         {
           "id": "Gem.ads",
           "name": "ads",
@@ -9963,7 +10139,7 @@
           "group": "start",
           "signature": "readonly ads: AdsApi",
           "documented": true,
-          "summary": "One full-screen cross-promotion at a natural break in play, rendered by\nthe arcade over your paused game.\n\nAsk at a break the player already expects — a level ending, a round\nfinishing — never mid-input. **The answer is usually no, and that is\nordinary rather than a failure:** carry straight on, and draw no\nplaceholder while you wait.\n\nNothing here rejects. The arcade pauses your game while a panel is up and\nresumes it when the promise settles, so you do not pause anything yourself.\n\n⚠️ `shown` **grants nothing.** It is not a receipt and not an entitlement,\nand a reward must never be handed out on the strength of it.\n\nYou are told no reason for a no, and there is nothing to infer from one\nabout the player. What you can read is your own economy:\n`rewardedStatus(placement)` says whether a rewarded placement could pay\nright now under your own declared caps — never whether an ad will play.",
+          "summary": "Rewarded ads, and the deprecated interstitial ask.\n\n**`format: 'interstitial'` is deprecated: signal a platform moment with\n`gem.moments.signal` instead.** It keeps working until at least `14.0.0`\n(`docs/deprecation-policy.md`); the arcade treats it as a platform moment.\n\nA rewarded ask comes from the player's press on your own button. **The\nanswer is usually no, and that is ordinary rather than a failure:** carry\nstraight on, and draw no placeholder while you wait.\n\nNothing here rejects. The arcade pauses your game while a panel is up and\nresumes it when the promise settles, so you do not pause anything yourself.\n\n⚠️ `shown` **grants nothing.** It is not a receipt and not an entitlement,\nand a reward must never be handed out on the strength of it.\n\nYou are told no reason for a no, and there is nothing to infer from one\nabout the player. What you can read is your own economy:\n`rewardedStatus(placement)` says whether a rewarded placement could pay\nright now under your own declared caps — never whether an ad will play.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -9972,7 +10148,7 @@
           "defaultValue": null,
           "guides": [
             {
-              "slug": "cross-promotion",
+              "slug": "rewarded-ads",
               "anchor": null
             }
           ]
@@ -10412,7 +10588,7 @@
           "group": "start",
           "signature": "cueReward(cue: RewardCue): boolean",
           "documented": true,
-          "summary": "Tell the arcade a platform-currency reward is on its way, so it **shows it\nlanding**: in the Gem Arcade the currency flies from `origin` into the Gem\nbutton at the top-left of your frame, which pops as each mark lands, and\nthe player's total moves once the platform confirms the grant. The Gem\nArcade draws no wallet over your game: the player sees their Gems and\nTickets in the Gem menu. A payout you do not cue still flies, from the\nmiddle of your frame, so cue the ones the player earns on screen.\n\nCall it the moment your game decides to award — when your server has moved\n(or is about to move) the progression mapped onto a platform currency —\nand pass the centre of that currency's icon (or hero) on your screen, so\nthe flight starts from the mark the player is looking at:\n\n```js\nconst { x, y, width, height } = rewardGem.getBoundingClientRect(); // the gem's own box\ngem.cueReward({\n  currencySlug: 'GEMS', // or 'ARCADE_TICKETS', from the ticket\n  expected: 15,\n  origin: { x: x + width / 2, y: y + height / 2 },\n});\n```\n\n**This is the platform-currency animation, and the only one.** The display\nof every platform currency — Gems and Tickets alike — belongs to the\narcade: a game draws no flight or celebration of its own for one and keeps\nno counter of one. **If this returns `false`, do nothing** — there is no\nfallback celebration.\n\n**The arcade never takes your word for the amount.** What lands, and the\nplayer's new total, come from the platform itself; `expected` is drawn as\nprovisional, and a cue the platform never confirms fades on its own — a\ngrant clamped to zero, say, or one the receipt reports `suppressed`. So\nthe cue can only ever make the wallet move for a reward that really\nlanded — which it does on every channel, dev and test included.",
+          "summary": "Tell the arcade a platform-currency reward is on its way, so it **shows it\nlanding**: in the Gem Arcade the currency flies from `origin` into the Gem\nbutton, wherever on your frame it sits, which pops as each mark lands, and\nthe player's total moves once the platform confirms the grant. The Gem\nArcade draws no wallet over your game: the player sees their Gems and\nTickets in the Gem menu. A payout you do not cue still flies, from the\nmiddle of your frame, so cue the ones the player earns on screen.\n\nCall it the moment your game decides to award — when your server has moved\n(or is about to move) the progression mapped onto a platform currency —\nand pass the centre of that currency's icon (or hero) on your screen, so\nthe flight starts from the mark the player is looking at:\n\n```js\nconst { x, y, width, height } = rewardGem.getBoundingClientRect(); // the gem's own box\ngem.cueReward({\n  currencySlug: 'GEMS', // or 'ARCADE_TICKETS', from the ticket\n  expected: 15,\n  origin: { x: x + width / 2, y: y + height / 2 },\n});\n```\n\n**This is the platform-currency animation, and the only one.** The display\nof every platform currency — Gems and Tickets alike — belongs to the\narcade: a game draws no flight or celebration of its own for one and keeps\nno counter of one. **If this returns `false`, do nothing** — there is no\nfallback celebration.\n\n**The arcade never takes your word for the amount.** What lands, and the\nplayer's new total, come from the platform itself; `expected` is drawn as\nprovisional, and a cue the platform never confirms fades on its own — a\ngrant clamped to zero, say, or one the receipt reports `suppressed`. So\nthe cue can only ever make the wallet move for a reward that really\nlanded — which it does on every channel, dev and test included.",
           "deprecated": null,
           "params": [
             {
@@ -10464,7 +10640,7 @@
           "group": "start",
           "signature": "setMenu(menu: GameMenu): boolean",
           "documented": true,
-          "summary": "Put up to four entries of your own in the arcade's menu. The arcade keeps\none menu button over your game: it is how a player leaves, mutes, goes\nfullscreen, reports a problem and changes their Arcade-wide settings.\n\n```js\ngem.setMenu({\n  items: [{ id: 'how-to-play', label: t('How to play'), onSelect: () => help.open() }],\n});\n```\n\n**Your settings are not in it: draw your own settings button, always** —\ntop-right, clear of `gem.viewport.reserved`. The Arcade's menu never opens\nyour settings screen.\n\n**It is screen state, not a toggle.** Each call is the whole answer and\nreplaces the last, so call it again when the entries change — a new\nlanguage, a screen with different options. `gem.setMenu({})` takes\neverything of yours back out. The arcade's own entries are not yours to\nchange, and Return to the Arcade is always among them.\n\n**The arcade pauses your game while its menu is open** (`onPause`), and\nresumes it before a handler of yours runs. A handler opens a screen; it\nshould not assume the game was paused by you.",
+          "summary": "Put up to four entries of your own in the arcade's menu. The arcade keeps\none menu button over your game: it is how a player leaves, mutes, goes\nfullscreen, reports a problem and changes their Arcade-wide settings.\n\n```js\ngem.setMenu({\n  items: [{ id: 'how-to-play', label: t('How to play'), onSelect: () => help.open() }],\n});\n```\n\n**Your settings are not in it: draw your own settings button, always** —\ntop-right, with your Back button just to its left, clear of\n`gem.viewport.reserved`. The Arcade's menu never opens your settings\nscreen.\n\n**It is screen state, not a toggle.** Each call is the whole answer and\nreplaces the last, so call it again when the entries change — a new\nlanguage, a screen with different options. `gem.setMenu({})` takes\neverything of yours back out. The arcade's own entries are not yours to\nchange, and Return to the Arcade is always among them.\n\n**The arcade pauses your game while its menu is open** (`onPause`), and\nresumes it before a handler of yours runs. A handler opens a screen; it\nshould not assume the game was paused by you.",
           "deprecated": null,
           "params": [
             {
@@ -10480,6 +10656,29 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "Gem.setGemCorner",
+          "name": "setGemCorner",
+          "anchor": "gem-setgemcorner",
+          "group": "start",
+          "signature": "setGemCorner(corner: GemCorner): boolean",
+          "documented": true,
+          "summary": "Ask the arcade to put its Gem button — its one control over your game,\ntop-left unless you ask — in another corner of your frame.\n\n```js\n// This game's own HUD needs the top-left, so the Gem goes top-right.\ngem.setGemCorner('top-right');\n```\n\n**Leave it top-left unless your own HUD needs that corner**, and then pick\none corner for the whole game — at most one per orientation. A Gem that\nmoves between screens is a way out the player has to look for. In\nlandscape the bottom corners sit where a player's thumbs hold the sticks.\n\n**Lay out around `gem.viewport.reserved`, never around the corner you\nasked for.** The arcade moves the Gem on its own terms: not while the\nplayer is using it or its menu is open, not more often than every few\nseconds, and never over a corner the player chose for themselves. The\nrectangles say where it actually is, and the `--gem-reserved-*` CSS\nproperties follow them.\n\n**It is screen state, not a toggle.** Each call is the whole answer and\nreplaces the last. A value that is not one of the four corners is ignored,\nwith a warning on the console, and changes nothing.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "corner",
+              "type": "GemCorner",
+              "optional": false,
+              "summary": "`'top-left'`, `'top-right'`, `'bottom-left'` or `'bottom-right'`."
+            }
+          ],
+          "returns": "`true` when the arcade was told now; `false` before the bridge is\n  up (the corner is held and sent when it connects), under an embedder that\n  cannot move its control, and for a value that is not a corner.",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "Gem.exit",
           "name": "exit",
@@ -11364,7 +11563,7 @@
           "name": "protocol",
           "anchor": "matchconnection-protocol",
           "group": "match",
-          "signature": "readonly protocol: \"dedicated\" | \"p2p\" | \"loopback\"",
+          "signature": "readonly protocol: \"p2p\" | \"dedicated\" | \"loopback\"",
           "documented": true,
           "summary": "What is on the other end: `dedicated` (the platform's server), `p2p` (the\nhosting player's browser), or `loopback` (this browser — you are the host,\nand this is the in-process link to your own bundle).",
           "deprecated": null,
@@ -11619,9 +11818,9 @@
           "name": "Avatar3dFamily",
           "anchor": "avatar3dfamily",
           "group": "avatars3d",
-          "signature": "type Avatar3dFamily = \"small_human\" | string & object",
+          "signature": "type Avatar3dFamily = \"small_human\" | \"adult_human\" | string & object",
           "documented": true,
-          "summary": "A rig family — the skeleton contract a 3D avatar is built on, and what a\ngame declares it can animate. `small_human` is the first: a `root` node\nwith a `body` child, which holds `head`, `arm_l`, `arm_r`, `leg_l` and\n`leg_r`, and a `hand_socket` under `arm_r`.\n\nOpen-ended (`| (string & {})`) so a family the platform adds later does not\nbreak a `switch` you compiled against this version: keep a `default` arm and\nskip a family you do not draw.",
+          "summary": "A rig family — the skeleton contract a 3D avatar is built on, and what a\ngame declares it can animate. Two today:\n\n- `small_human`, the toy rig: a `root` node with a `body` child, which holds\n  `head`, `arm_l`, `arm_r`, `leg_l` and `leg_r`, and a `hand_socket` under\n  `arm_r`.\n- `adult_human`, a full humanoid with fingers: 56 nodes from `root` and\n  `hips` down to `toes_r`, every one world-aligned at rest, so one clip plays\n  on every avatar in the family.\n\n`AVATAR_RIGS` (from `@indiegems/gem-web-sdk/sdk`) lists every node of\nboth, with its parent.\n\nOpen-ended (`| (string & {})`) so a family the platform adds later does not\nbreak a `switch` you compiled against this version: keep a `default` arm and\nskip a family you do not draw.",
           "deprecated": null,
           "params": [],
           "returns": null,
@@ -11948,6 +12147,151 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "MomentKind",
+          "name": "MomentKind",
+          "anchor": "momentkind",
+          "group": "moments",
+          "signature": "type MomentKind = \"level_end\" | \"run_end\" | \"match_end\" | \"menu_return\" | \"other_break\"",
+          "documented": true,
+          "summary": "Which kind of break a platform moment is. A closed set — there will not be a\nsixth:\n\n- `level_end` — a level, stage, wave or puzzle finished, won or lost.\n- `run_end` — game over, death, or a run banked, in an endless, arcade or\n  roguelike game.\n- `match_end` — a multiplayer round or match finished and the player is\n  leaving its results.\n- `menu_return` — the player chose to go back to the title, a main menu or\n  level select. A return, never the first arrival.\n- `other_break` — any other natural stop: a story chapter, a between-waves\n  shop.\n\nIt is a label, for the arcade's analytics, the dev host's log and the release\nchecklist. It never changes what the arcade decides for your game.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "platform-moments",
+              "anchor": null
+            }
+          ]
+        },
+        {
+          "id": "MomentSignal",
+          "name": "MomentSignal",
+          "anchor": "momentsignal",
+          "group": "moments",
+          "signature": "interface MomentSignal",
+          "documented": true,
+          "summary": "A platform moment: which kind of break the player is leaving, and optionally\nyour own name for the screen.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MomentSignal.kind",
+          "name": "kind",
+          "anchor": "momentsignal-kind",
+          "group": "moments",
+          "signature": "kind: MomentKind",
+          "documented": true,
+          "summary": "Which kind of break this is. Required.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MomentSignal.placement",
+          "name": "placement",
+          "anchor": "momentsignal-placement",
+          "group": "moments",
+          "signature": "placement?: string",
+          "documented": true,
+          "summary": "Optional: your own name for the screen the player is leaving —\n`world-1-3`, `results`. **1 to 32 characters of `a-z`, `0-9`, `-` and\n`_`.** It appears only in the dev host's log, so a reviewer can map each\nmoment to a screen. It is never sent to the platform, never stored, never\nshown to a player and never sent to an ad network.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MomentResult",
+          "name": "MomentResult",
+          "anchor": "momentresult",
+          "group": "moments",
+          "signature": "interface MomentResult",
+          "documented": true,
+          "summary": "What the arcade answers at a platform moment.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MomentResult.shown",
+          "name": "shown",
+          "anchor": "momentresult-shown",
+          "group": "moments",
+          "signature": "readonly shown: boolean",
+          "documented": true,
+          "summary": "Whether the arcade showed anything of its own at this break. Usually\n`false`. Either way, carry on exactly as you would have. **It grants\nnothing**, and it never says what was shown or why nothing was.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MomentsApi",
+          "name": "MomentsApi",
+          "anchor": "momentsapi",
+          "group": "moments",
+          "signature": "interface MomentsApi",
+          "documented": true,
+          "summary": "Platform moments. `gem.moments` is one of these.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MomentsApi.signal",
+          "name": "signal",
+          "anchor": "momentsapi-signal",
+          "group": "moments",
+          "signature": "signal(moment: MomentSignal): Promise<MomentResult>",
+          "documented": true,
+          "summary": "Signal a platform moment: the player is leaving a natural break in play.\nThe arcade may show one of its own offers over your paused game, and\nusually shows nothing.\n\n**Call it from the player's press that LEAVES the break** — Next, Retry,\nBack to menu — once per break. Start your own transition in parallel, and\nstart play when this settles. **Never** mid-input, during a timed\nsequence, on a timer, on boot or the first arrival at the title, or from a\nplayer-opened pause menu (choosing Quit to menu from it is a\n`menu_return`). No press is required by the SDK; the rule is about when a\nbreak really is one.\n\nNOTHING REJECTS. It resolves `{ shown: false }` without asking for an\narcade that does not do platform moments, a `kind` or `placement` outside\nthe grammar, a call before `gem.frame.ready()`, a call while another is in\nflight, a call within 10 seconds of the last answer, or no answer within\nthree minutes — and each of those, except an arcade that does not do it\n(said once a session), is reported to your `onError` handler with code\n`'internal'` and a message beginning with a stable token:\n`moments_unsupported`, `moments_invalid_argument`, `moments_before_ready`,\n`moments_in_flight`, `moments_called_repeatedly` or `moments_timeout`.\n\nThe arcade pauses and resumes your game through the ordinary\n`gem.pause`, so you do not pause anything yourself.\n\n⚠️ `shown` grants nothing. Never hand out a reward, an unlock or a currency\non it, and never pop your own offer at a break that settled `shown: true`.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "moment",
+              "type": "MomentSignal",
+              "optional": false,
+              "summary": "Which kind of break, and optionally your name for the screen."
+            }
+          ],
+          "returns": "Whether the arcade showed anything. Always resolves; never rejects.",
+          "throws": null,
+          "example": "```ts\n// From the press that LEAVES the break — Next, Retry, Back to menu.\nasync function onNextPressed() {\n  startLevelTransition(); // your fade or loading beat, in parallel\n  await gem.moments.signal({ kind: 'level_end', placement: 'world-1-3' });\n  startNextLevel(); // settled either way; never grant anything on `shown`\n}\n```",
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "platform-moments",
+              "anchor": null
+            }
+          ]
+        },
         {
           "id": "DedicatedServerFailure",
           "name": "DedicatedServerFailure",
@@ -21628,6 +21972,22 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "RequestOptions.retryRateLimited",
+          "name": "retryRateLimited",
+          "anchor": "requestoptions-retryratelimited",
+          "group": "calls",
+          "signature": "readonly retryRateLimited?: boolean",
+          "documented": true,
+          "summary": "Set `false` to make a 429 final for this call instead of waiting out\n`Retry-After` and trying again.\n\nFor a caller that keeps its own queue and its own cooldown, such as a\nbatch sender on a timer: retrying inside the call only spends more of the\nsame limit, and holds the caller's queue while it does. Every other\nfailure is retried exactly as before. Defaults to `true`.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "VersionedGetOptions",
           "name": "VersionedGetOptions",
@@ -23810,7 +24170,7 @@
           "group": "analytics",
           "signature": "flush(signal?: AbortSignal): 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 rather than as an error. A refusal that could clear on\nits own — a 429, a 503 — keeps the queue and rejects; one that cannot\ndiscards the batch, because resending it can only fail the same way.",
+          "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 rather than as an error. A refusal that could clear on\nits own — a 429, a 503 — keeps the queue and rejects, and the SDK's own\nflushes then hold off for the longer of the server's `Retry-After` and a\ncooldown that doubles from 10 seconds, up to five minutes; one that cannot\ndiscards the batch, because resending it can only fail the same way.\n\nOne flush at a time: called while another is on the wire, this waits for\nit and then sends what is left.",
           "deprecated": null,
           "params": [
             {
@@ -26365,7 +26725,7 @@
       "usageRoots": [
         "GemFunction"
       ],
-      "install": "A function imports the same package your game already depends on, written out in [getting-started](../getting-started.md#3-add-the-sdk) — the only place the install is written out. Your function’s build bundles this module, so the version your function runs is the one your `package.json` names: pin the version your game pins. A function published importing the SDK from the engine runs the engine’s built-in copy instead; [serverless-functions-js](../serverless-functions-js.md) says what that means.",
+      "install": "⚠️ **JavaScript functions are disabled for now, due to performance issues.** Uploading a new JavaScript function is refused with `400 js_functions_disabled`: write a new function in Rust, as [serverless-functions](../serverless-functions.md#3-writing-one) shows. A JavaScript function already published keeps running, and this page is what it imports.\n\nA function imports the same package your game already depends on, written out in [getting-started](../getting-started.md#3-add-the-sdk) — the only place the install is written out. Your function’s build bundles this module, so the version your function runs is the one your `package.json` names: pin the version your game pins. A function published importing the SDK from the engine runs the engine’s built-in copy instead; [serverless-functions-js](../serverless-functions-js.md) says what that means.",
       "entrySymbol": "createGem",
       "groups": [
         {
@@ -26685,7 +27045,7 @@
           "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-function.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 30 days is gone.** Raw events live 30 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": "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-function.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,
@@ -26774,7 +27134,7 @@
           "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-function.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. A refusal that cannot clear discards the batch it was sent for,\nbecause resending it can only fail identically.",
+          "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-function.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": [
             {
@@ -27078,6 +27438,22 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "RequestOptions.retryRateLimited",
+          "name": "retryRateLimited",
+          "anchor": "requestoptions-retryratelimited",
+          "group": "calls",
+          "signature": "readonly retryRateLimited?: boolean",
+          "documented": true,
+          "summary": "Set `false` to make a 429 final for this call instead of waiting out\n`Retry-After` and trying again.\n\nFor a caller that keeps its own queue and its own cooldown, such as a\nbatch sender on a timer: retrying inside the call only spends more of the\nsame limit, and holds the caller's queue while it does. Every other\nfailure is retried exactly as before. Defaults to `true`.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "VersionedGetOptions",
           "name": "VersionedGetOptions",
@@ -32069,9 +32445,9 @@
           "name": "Avatar3dFamily",
           "anchor": "avatar3dfamily",
           "group": "identity",
-          "signature": "type Avatar3dFamily = \"small_human\" | string & object",
+          "signature": "type Avatar3dFamily = \"small_human\" | \"adult_human\" | string & object",
           "documented": true,
-          "summary": "A rig family — the skeleton contract a 3D avatar is built on, and what a\ngame declares it can animate. `small_human` is the first: a `root` node\nwith a `body` child, which holds `head`, `arm_l`, `arm_r`, `leg_l` and\n`leg_r`, and a `hand_socket` under `arm_r`.\n\nOpen-ended (`| (string & {})`) so a family the platform adds later does not\nbreak a `switch` you compiled against this version: keep a `default` arm and\nskip a family you do not draw.",
+          "summary": "A rig family — the skeleton contract a 3D avatar is built on, and what a\ngame declares it can animate. Two today:\n\n- `small_human`, the toy rig: a `root` node with a `body` child, which holds\n  `head`, `arm_l`, `arm_r`, `leg_l` and `leg_r`, and a `hand_socket` under\n  `arm_r`.\n- `adult_human`, a full humanoid with fingers: 56 nodes from `root` and\n  `hips` down to `toes_r`, every one world-aligned at rest, so one clip plays\n  on every avatar in the family.\n\n`AVATAR_RIGS` (from `@indiegems/gem-web-sdk/sdk`) lists every node of\nboth, with its parent.\n\nOpen-ended (`| (string & {})`) so a family the platform adds later does not\nbreak a `switch` you compiled against this version: keep a `default` arm and\nskip a family you do not draw.",
           "deprecated": null,
           "params": [],
           "returns": null,