@indiegems/gem-web-sdk 9.1.4 → 10.0.0

package/docs/api/reference.json

@@ -2,7 +2,7 @@
   "schema_version": 2,
   "source": {
     "repo": "IndieGems/gem-web-sdk",
-    "version": "9.1.4"
+    "version": "10.0.0"
   },
   "entries": [
     {
@@ -16350,6 +16350,29 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "RoomManager.queueForMatch",
+          "name": "queueForMatch",
+          "anchor": "roommanager-queueformatch",
+          "group": "rooms",
+          "signature": "queueForMatch(options: QueueForMatchOptions): Promise<MatchTicket>",
+          "documented": true,
+          "summary": "Queue for a match with other players, and get a ticket to wait on.\n\nFOR A MODE THAT NEEDS A FULL LOBBY BEFORE IT STARTS. The platform holds the\nplayer in a queue until it has enough players for one of the templates you\nnamed, then makes the room, seats everyone and starts the match — nobody\nhosts and nobody presses start. For a drop-in mode, where a player should\nbe in a room at once and others join around them, use\n[RoomManager.quickJoin](api-reference-game.md#roommanager-quickjoin) instead.\n\nThis call answers as soon as the player is queued. What happens next is on\nthe ticket: await [MatchTicket.outcome](api-reference-game.md#matchticket-outcome), and when it says `matched`\nthis manager is already in the room — `joined` has fired and the match\nevents follow as for any other room.\n\nA PLAYER MAY QUEUE FROM INSIDE A ROOM — a hub, or a social lobby they wait\nin. When the ticket is matched the manager moves to the match's room:\n`currentRoom` becomes it and `joined` fires. The seat in the room they\nqueued from is kept on the platform, not given up, so when the match is\nover `join()` with that room's id puts them back in it. If the tab closes\nbefore they go back, the SDK leaves both rooms.\n\nWhat it does refuse is a second thing in flight: while a ticket waits,\n`create`, `join`, `joinByCode`, `quickJoin` and another `queueForMatch`\nrefuse until it ends or is cancelled.\n\nCLOSING THE TAB CANCELS THE TICKET. The SDK sends the cancel as the page\ngoes away, so a player who left is not matched into a lobby they will\nnever arrive in.",
+          "deprecated": null,
+          "params": [
+            {
+              "name": "options",
+              "type": "QueueForMatchOptions",
+              "optional": false,
+              "summary": "The templates the player accepts."
+            }
+          ],
+          "returns": "The ticket, still `queued` unless a lobby was waiting for exactly\nthis player.",
+          "throws": "`GemApiError` when the platform refuses the ticket. Two refusals\nare worth their own branch, by [GemApiError.code](api-reference-game.md#gemapierror-code):\n`already_queued` — this player, or someone in their party, is already\non a ticket, possibly in another tab or another game — and\n`matchmaking_unavailable`, which means matchmaking is turned off or not\nanswering. Tell the player; do not loop on it, and do not quietly\nsubstitute `quickJoin`, which puts them in a different kind of room.",
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "RoomManager.list",
           "name": "list",
@@ -16790,6 +16813,22 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "RoomManager.currentTicket",
+          "name": "currentTicket",
+          "anchor": "roommanager-currentticket",
+          "group": "rooms",
+          "signature": "readonly currentTicket: MatchTicket | null",
+          "documented": true,
+          "summary": "The matchmaking ticket this player is waiting on, or `null`.\n\nSet from the moment [RoomManager.queueForMatch](api-reference-game.md#roommanager-queueformatch) answers until the\nticket ends — so it is `null` again by the time a matched ticket's room is\n[RoomManager.currentRoom](api-reference-game.md#roommanager-currentroom).",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "RoomManager.currentMatch",
           "name": "currentMatch",
@@ -17083,6 +17122,240 @@
           "defaultValue": null,
           "guides": []
         },
+        {
+          "id": "QueueForMatchOptions",
+          "name": "QueueForMatchOptions",
+          "anchor": "queueformatchoptions",
+          "group": "rooms",
+          "signature": "interface QueueForMatchOptions",
+          "documented": true,
+          "summary": "What you pass to `gem.rooms.queueForMatch(...)`.\n\nNAME EVERY MODE THE PLAYER WILL ACCEPT. The ticket waits for all of them at\nonce and is matched under whichever fills first, so \"any mode\" is one ticket\nnaming several templates rather than several tickets — a player can only be\non one.\n\n```js\nconst ticket = await gem.rooms.queueForMatch({ templateSlugs: ['duel', 'brawl'] });\n```",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "rooms-and-matches",
+              "anchor": null
+            }
+          ]
+        },
+        {
+          "id": "QueueForMatchOptions.templateSlugs",
+          "name": "templateSlugs",
+          "anchor": "queueformatchoptions-templateslugs",
+          "group": "rooms",
+          "signature": "readonly templateSlugs: readonly string[]",
+          "documented": true,
+          "summary": "The room templates this player accepts, by slug — one to eight of them.\n\nEVERY ONE MUST HAVE MATCHMAKING TURNED ON in your game config. A template\nwithout it refuses the whole ticket rather than being skipped, so a typo\nis an error you see and not a mode nobody is ever matched into.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "QueueForMatchOptions.partyId",
+          "name": "partyId",
+          "anchor": "queueformatchoptions-partyid",
+          "group": "rooms",
+          "signature": "readonly partyId?: string",
+          "documented": true,
+          "summary": "A party to queue as one unit. Normally omit it — the SDK brings the\nplayer's party along when they lead one, exactly as a room call does.\n\nA party is seated together or not at all. If it gains or loses a member\nwhile it waits, the ticket ends `cancelled` with reason `party_changed`.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "QueueForMatchOptions.signal",
+          "name": "signal",
+          "anchor": "queueformatchoptions-signal",
+          "group": "rooms",
+          "signature": "readonly signal?: AbortSignal",
+          "documented": true,
+          "summary": "Cancel the request that creates the ticket.\n\nOnly that request. Once you hold a ticket, [MatchTicket.cancel](api-reference-game.md#matchticket-cancel) is\nwhat takes the player out of the queue.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicketStatus",
+          "name": "MatchTicketStatus",
+          "anchor": "matchticketstatus",
+          "group": "rooms",
+          "signature": "type MatchTicketStatus = \"queued\" | \"matched\" | \"expired\" | \"cancelled\" | \"failed\" | \"lost\" | \"unavailable\"",
+          "documented": true,
+          "summary": "Where a ticket is: `queued` while it waits, and anything else for good.\n\n- `matched` — the player is seated and the match is starting.\n- `expired` — it waited too long, or stopped being kept alive.\n- `cancelled` — the player backed out, or their party changed.\n- `failed` — the platform formed a match and could not start it, repeatedly.\n- `lost` — the platform no longer has the ticket. Queue again.\n- `unavailable` — matchmaking is turned off or not answering.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicketOutcome",
+          "name": "MatchTicketOutcome",
+          "anchor": "matchticketoutcome",
+          "group": "rooms",
+          "signature": "type MatchTicketOutcome = { status: \"matched\"; room: Room } | { status: \"expired\"; reason: string } | { status: \"cancelled\"; reason: string } | { status: \"failed\"; reason: string } | { status: \"lost\" } | { status: \"unavailable\" }",
+          "documented": true,
+          "summary": "How a ticket ended. Branch on `status`.\n\nONLY `matched` CARRIES A ROOM, and by the time you see it the SDK is already\nin that room: `gem.rooms.currentRoom` is it, `joined` has fired, and the\nmatch events follow as they do for any other room.\n\nEvery other ending leaves the player in no room and on no ticket, free to\nqueue again. None of them is retried for you, and nothing falls back to\n`quickJoin` — a game that wants either does it on purpose.\n\n`reason` says why, where the platform gave one: `timed_out` or\n`heartbeat_lapsed` for `expired`, `requested` or `party_changed` for\n`cancelled`, `handoff_failed` for `failed`. Treat a value you do not\nrecognise as the status alone.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicket",
+          "name": "MatchTicket",
+          "anchor": "matchticket",
+          "group": "rooms",
+          "signature": "interface MatchTicket",
+          "documented": true,
+          "summary": "A place in the matchmaking queue — what `gem.rooms.queueForMatch(...)`\nanswers with.\n\nYou do not keep it alive; the SDK does, for as long as it waits. What you do\nwith it is wait for [MatchTicket.outcome](api-reference-game.md#matchticket-outcome), and offer the player a\nbutton that calls [MatchTicket.cancel](api-reference-game.md#matchticket-cancel).\n\n```js\nconst ticket = await gem.rooms.queueForMatch({ templateSlugs: ['duel'] });\nshowSearching({ onCancel: () => ticket.cancel() });\n\nconst outcome = await ticket.outcome;\nif (outcome.status === 'matched') enterMatch(outcome.room);\nelse backToMenu(outcome.status);\n```",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": [
+            {
+              "slug": "rooms-and-matches",
+              "anchor": null
+            }
+          ]
+        },
+        {
+          "id": "MatchTicket.id",
+          "name": "id",
+          "anchor": "matchticket-id",
+          "group": "rooms",
+          "signature": "readonly id: string",
+          "documented": true,
+          "summary": "The ticket's id. For logs and bug reports; nothing you call takes it.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicket.status",
+          "name": "status",
+          "anchor": "matchticket-status",
+          "group": "rooms",
+          "signature": "readonly status: MatchTicketStatus",
+          "documented": true,
+          "summary": "Where the ticket is right now. Changes once, from `queued` to how it ended.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicket.partySize",
+          "name": "partySize",
+          "anchor": "matchticket-partysize",
+          "group": "rooms",
+          "signature": "readonly partySize: number",
+          "documented": true,
+          "summary": "How many players the ticket seats: 1, or the size of the party.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicket.queuedAt",
+          "name": "queuedAt",
+          "anchor": "matchticket-queuedat",
+          "group": "rooms",
+          "signature": "readonly queuedAt: number",
+          "documented": true,
+          "summary": "When the ticket joined the queue, in Unix seconds.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicket.expiresAt",
+          "name": "expiresAt",
+          "anchor": "matchticket-expiresat",
+          "group": "rooms",
+          "signature": "readonly expiresAt: number",
+          "documented": true,
+          "summary": "When the ticket gives up if it is still waiting, in Unix seconds. Good for\na countdown; the platform decides the length, per template.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicket.outcome",
+          "name": "outcome",
+          "anchor": "matchticket-outcome",
+          "group": "rooms",
+          "signature": "readonly outcome: Promise<MatchTicketOutcome>",
+          "documented": true,
+          "summary": "How the ticket ends. Settles exactly once, and RESOLVES for every ending\nthe platform reports — matched, expired, cancelled and the rest are\noutcomes to branch on, not errors to catch.\n\nIt rejects in one case only: the ticket was matched and the SDK could not\nread the room it was seated in. The player holds a seat then, so\n`gem.rooms.myRooms()` shows the room and `gem.rooms.join(id)` enters it.",
+          "deprecated": null,
+          "params": [],
+          "returns": null,
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
+        {
+          "id": "MatchTicket.cancel",
+          "name": "cancel",
+          "anchor": "matchticket-cancel",
+          "group": "rooms",
+          "signature": "cancel(): Promise<MatchTicketOutcome>",
+          "documented": true,
+          "summary": "Take the player — and their party — out of the queue.\n\nA CANCEL CAN LOSE THE RACE, and then the answer is `matched`. A ticket the\nplatform has already seated is never undone, so read the outcome this\nreturns rather than assuming: when it says `matched` the player is in a\nroom, and backing out is `gem.rooms.leave()`.\n\nSafe to call more than once, and after the ticket has ended.",
+          "deprecated": null,
+          "params": [],
+          "returns": "The same promise as [MatchTicket.outcome](api-reference-game.md#matchticket-outcome).",
+          "throws": null,
+          "example": null,
+          "defaultValue": null,
+          "guides": []
+        },
         {
           "id": "RoomStatus",
           "name": "RoomStatus",

package/docs/changelog.md

@@ -16,6 +16,19 @@ Its entries are grouped under up to five headings:
 - **Rebuild**: a type changed. Recompile against the new version; code that compiles today keeps compiling unless the entry says otherwise.
 - **New capability**: something a game can now do. Nothing changes unless you use it.
 
+## 10.0.0
+
+Upgrading from 9.1.4. Impact: required.
+
+### Rebuild
+
+- The OrderSource type now accepts two more values, test_account_provision and developer_grant. Recompile your game. If your code handles order sources in an exhaustive switch or a lookup table typed by OrderSource, add handling for both new values, or the build may fail to compile.
+
+### New capability
+
+- A game can now put a player in a matchmaking queue for a mode that needs a formed lobby. Call RoomManager.queueForMatch with the template slugs you want. It returns a MatchTicket whose outcome settles once and whose cancel method leaves the queue. When the platform finds a match it creates the room, seats everyone and starts the match, and you follow it with the same code you use for any joined room. Options are described by QueueForMatchOptions. Ticket endings are described by MatchTicketOutcome, and the waiting state by MatchTicketStatus. RoomManager.currentTicket exposes the ticket the player is waiting on. The SDK keeps the ticket alive by itself, cancels it when the tab closes, and lets a player queue from inside a room. After a match the player leaves the room they queued from when the tab closes.
+- The lower-level rooms API now has createTicket, heartbeatTicket and cancelTicket calls for working with matchmaking tickets directly. Most games should use RoomManager.queueForMatch, which sends the heartbeats and cancellation for you.
+
 ## 9.1.4
 
 Upgrading from 9.1.3. Impact: none.

package/docs/daily-challenges.md

@@ -78,9 +78,118 @@ Changing only these two is not a change of schedule, so the upload does not refu
 `completion_threshold` is the target. `client_writable` decides who may report it, and
 [section 4](#4-who-may-report-it) is where that choice actually matters.
 
+`display_name` and `description` are what a player reads. To translate them, or to have the
+platform write the target into them, see
+[section 2a](#2a-translate-the-copy-and-write-the-target-into-it).
+
 **Upload the config the way you upload any other.** A challenge is not promoted differently and
 does not need a new build to reach players.
 
+## 2a. Translate the copy, and write the target into it
+
+Both of these are optional, and a config that uses neither keeps working as it is. A progression
+may carry your own translations of its name and description, and a displayed challenge may have the
+platform write its target into the text:
+
+```yaml
+progressions:
+  - id: 9b1d6e40-52c7-4f0a-8e3d-1a7c4b9f2d65
+    slug: clear-lines
+    display_name: 'Clear {target, plural, one {# line} other {# lines}}'
+    description: 'Clear lines in a single run.'
+    localized:
+      de:
+        display_name: 'Räume {target, plural, one {# Reihe} other {# Reihen}} ab'
+        description: 'Räume Reihen in einem Durchgang ab.'
+      pl:
+        description: 'Usuń linie w jednej rozgrywce.'
+    config:
+      completion_threshold: 150
+      reset_schedule: { type: daily }
+      platform_display: challenge
+```
+
+Quote the text. YAML reads an unquoted value that starts with `{` as a mapping, so
+`display_name: {target} points` is not a string.
+
+### Translations
+
+Any progression may carry `localized`, whether or not it is a displayed challenge.
+
+- **The keys are the eleven locales:** `de`, `es`, `fr`, `it`, `ja`, `ko`, `pl`, `pt-BR`, `ru`,
+  `tr`, `zh-Hans`. `en` is refused as a key, and so is any other key.
+- **Each entry has two optional fields**, `display_name` and `description`. You may translate one
+  and not the other.
+- **The `display_name` and `description` you write outside `localized` are the default text**, and
+  the platform treats them as English. A missing locale, or a missing field in a locale, falls back
+  to the default text, one field at a time. In the example, a Polish reader gets the default name
+  and the Polish description, and a French reader gets the default text for both.
+- **An empty translation is refused.** To show the default text, remove the key.
+- **Translations are optional**, and promoting a config does not depend on them.
+
+### Write the target with {target}
+
+On a displayed challenge (`platform_display: challenge`), `{target}` in `display_name` or
+`description` is replaced by the challenge's `completion_threshold`. It works in the default text
+and in every translation. Copy that already contains the literal text `{target}` is now shown with
+the number in its place.
+
+| You write                                              | Target | A player reads        |
+| ------------------------------------------------------ | ------ | --------------------- |
+| `Score {target} points`                                | 12000  | Score 12,000 points   |
+| `Erziele {target} Punkte`, under `de`                  | 12000  | Erziele 12.000 Punkte |
+| `Clear {target, plural, one {# line} other {# lines}}` | 1      | Clear 1 line          |
+| the same                                               | 150    | Clear 150 lines       |
+
+- **`target` is the only name.** Any other `{name}` is refused, and so is `{target}` on a
+  progression with no `completion_threshold`.
+- **The number is grouped the way the reader's language groups it:** `12,000` in English, `12.000`
+  in German. Each text uses one language for its words, its plural rule and its number.
+- **A plural needs an `other` branch.** `Clear {target, plural, one {# line} other {# lines}}` is
+  "Clear 1 line" at 1 and "Clear 150 lines" at 150.
+- **Write category branches (`one`, `few`, `many`, `other`), not `=N`.** An exact branch is
+  accepted only when `N` equals the current threshold, so if you later change the threshold, copy
+  that used `=N` can fail its next upload. Each text uses the categories its own language has: a
+  category that no number takes in that language (`few` in English) is refused, and so is a branch
+  written twice.
+- **Each player reads the target they are working toward.** A player who started a period before
+  you changed the threshold keeps reading their own number, in the copy and on the meter alike.
+  Section 8 has what a change of threshold does to a period in progress.
+
+### The rules for a displayed challenge's copy
+
+- **On a displayed challenge the name and description are templates, and `{` and `}` are syntax.**
+  On any other progression they are plain text, and braces mean nothing.
+- **The name is at most 64 characters and the description at most 280, counted
+  on the line a player is shown**, in every language, never on the template. Nothing is truncated;
+  text that renders too long is refused. A long plural is therefore fine when each line it renders
+  is short. The text as written may be up to 256 characters for a name and 4096 for a description.
+- **A displayed challenge's name and description are each one line.**
+- **The copy is screened at upload, in every language.** It is refused for words that claim to
+  speak for the platform or name a platform role, for the name of a platform currency, for reward
+  or credential words, and for links.
+- **Some problems are refused today, and some only draw a warning.** A problem in a `localized`
+  entry, or in text that uses `{target}`, is refused. A problem in a displayed challenge's default
+  text that does not use `{target}` (a stray brace, a line break, a screened word) draws the
+  warning `progressions_copy_refusal_pending` with the same message, and the upload succeeds. That
+  warning will become a refusal, so fix the text when you see it. It follows the text, not its age:
+  default text without `{target}` on a challenge you add today draws the same warning.
+- **A translation on a progression that is not a displayed challenge is plain text**, held to 64 /
+  280 characters as written. It is still refused for a link or for words that claim to speak for
+  the platform, and its description may have line breaks.
+
+### What a player reads, and what your game reads
+
+- **Where the platform shows a progression's name and description, a reader gets your translation
+  when there is one for their language, and the default text otherwise.**
+- **Your game's own reads do not return this text.** `gem.challenges.list()` and the progression
+  read (`currentValue`, `isCompleted`) carry no name and no description.
+- **`gem.gameConfig.load()` returns the config as you wrote it:** `display_name` and `description`
+  with `{target}` still in them, not replaced, and not chosen for the player's language. It also
+  returns your `localized` entries as written.
+- **A game that shows its own challenge UI keeps rendering its own strings**, in
+  `gem.prefs.locale`.
+
 ## 3. Report progress from your game
 
 The write is the ordinary progression write. Your game already knows how to make it:
@@ -506,7 +615,9 @@ shows, just quietly meaningless.
 
 - **A new challenge gets a new id.** Always.
 - **To rename what the player sees, change `display_name`.** That is free and is not part of the
-  challenge's identity.
+  challenge's identity. Update that name's translations in `localized` too
+  ([section 2a](#2a-translate-the-copy-and-write-the-target-into-it)): a translation you leave
+  behind keeps showing the old name to readers of that language.
 - **Changing a progression's `reset_schedule` is refused at upload**, for the same reason: a daily
   that becomes a weekly would carry its old id into a history that then describes two different
   things. A different period means a new progression. (Rewriting `0 0 * * *` as `daily` is not a
@@ -590,6 +701,17 @@ own streak on your store page. Your game does not have to render any of it.
 | `cron expression never fires`                      | an expression naming a date that does not exist (`0 0 30 2 *`)  | fix the expression                                                   |
 | `reset_schedule changed from … to …`               | you changed a live progression's period                         | use a NEW progression; `display_name` is what renames one            |
 | warning `platform_grant_max_per_window_ignored` (or `platform_grant_cap_uses_retired_max_per_entity`) | a mapping declares `max_per_window` (or `max_per_entity`) | nothing is refused and the upload succeeds; remove the key, because the platform sets the caps |
+| a refusal at `localized.<key>`                     | the key is not one of the eleven locales, or it is `en`         | use a listed locale; the text outside `localized` is the English    |
+| a refusal at a `localized.<locale>` field that is empty | an empty translation                                       | remove the key to show the default text                             |
+| a refusal naming a `{name}` other than `target`    | a displayed challenge's copy referred to something else         | `target` is the only name; remove the braces from the copy          |
+| a refusal for `{target}` with no threshold         | the progression has no `completion_threshold`                   | set one, or remove `{target}`                                       |
+| a refusal on a plural branch                       | no `other` branch, an `=N` that is not the threshold, or a category the language does not have | write the category branches that language has, and always `other` |
+| a refusal for text that is too long                | the line a player is shown passes 64 (name) or 280 (description) | shorten the text; nothing is truncated for you                     |
+| warning `progressions_copy_refusal_pending`        | default text without `{target}` on a displayed challenge breaks a copy rule | the upload succeeds; fix the text now, because this will become a refusal |
+
+A refusal about a progression's copy reads `progressions[<i>] (<slug>): <path>: <reason>`, where
+`<path>` is `display_name`, `description`, `localized.<locale>.display_name`,
+`localized.<locale>.description`, or `localized.<key>` for a refused key.
 
 Every refusal names the field and the reason. **Read the error rather than a list written down
 here** — the platform is what decides these, and this table is only as current as the day it was

package/docs/getting-started.md

@@ -50,7 +50,7 @@ either way.
 ```jsonc
 // package.json
 "dependencies": {
-  "@indiegems/gem-web-sdk": "9.1.4"
+  "@indiegems/gem-web-sdk": "10.0.0"
 }
 ```
 

package/docs/manifest.json

@@ -33,8 +33,8 @@
     },
     {
       "file": "changelog.md",
-      "sha256": "6333e652b2c3ffade4ced6759436b8ab3dcb95b25a43c1bd82fe9a6f23fd8a7d",
-      "updated": "2026-10-10T01:45:03Z"
+      "sha256": "cdaa2661a18afd096def083e5a44b2e125275d2aaa210b5d1e496631bf18f457",
+      "updated": "2026-10-10T18:47:07Z"
     },
     {
       "file": "cross-promotion.md",
@@ -43,8 +43,8 @@
     },
     {
       "file": "daily-challenges.md",
-      "sha256": "c198868e2cb1f1b5d9164bb5b1d23bf3f502987e45e10163c8b048a8eba24667",
-      "updated": "2026-10-02T23:01:00Z"
+      "sha256": "f4842b2fe01c8780020326f4722ab69dc01c1f40e1e6455cf2fb27752094383d",
+      "updated": "2026-10-10T14:37:50Z"
     },
     {
       "file": "dedicated-server-flow.md",
@@ -68,8 +68,8 @@
     },
     {
       "file": "getting-started.md",
-      "sha256": "22fab7f0fd67966239c38541a8620ac7fe614f100b96df3e94570b573d4a9f61",
-      "updated": "2026-10-10T01:45:03Z"
+      "sha256": "39812f4b84097fd29f4038324a9070eeddf526ca294f7cb5b7b3913335ac34bf",
+      "updated": "2026-10-10T18:47:07Z"
     },
     {
       "file": "inventory-and-catalogs.md",
@@ -113,8 +113,8 @@
     },
     {
       "file": "rooms-and-matches.md",
-      "sha256": "0abf3717a42c94ec832dfa1310c2d93a9f58236fd75b0aacaab301976bffe286",
-      "updated": "2026-10-07T19:27:16Z"
+      "sha256": "23540a20bdd8c8d058eb06d8ef11085ffd8eaaeeaadc93a807608b7c279e240c",
+      "updated": "2026-10-10T18:05:31Z"
     },
     {
       "file": "saving-player-progress.md",
@@ -123,8 +123,8 @@
     },
     {
       "file": "server-bundles.md",
-      "sha256": "bc59062fefb7c17986671e2a8b6b86b714d1c7e9774956a3df98adcef38a7fd2",
-      "updated": "2026-10-10T01:45:03Z"
+      "sha256": "43a7674a6da40e2091538d6a24664a66c4cf607cc16b6027f2ddf6fd7421861c",
+      "updated": "2026-10-10T18:47:07Z"
     },
     {
       "file": "serverless-functions-js.md",