npm - @indiegems/gem-web-sdk - Versions diffs - 9.1.3 → 9.1.4 - Mend

@indiegems/gem-web-sdk 9.1.3 → 9.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/CHANGELOG.md +6 -0
package/README.md +1 -2
package/dist/gem-web-sdk.esm.js +1 -1
package/dist/gem-web-sdk.function.js +1 -1
package/dist/gem-web-sdk.game.js +1 -1
package/dist/gem-web-sdk.min.js +1 -1
package/dist/gem-web-sdk.sdk.js +1 -1
package/dist/gem-web-sdk.server.js +1 -1
package/docs/api/api-reference-game.md +2564 -2564
package/docs/api/api-reference-server.md +706 -706
package/docs/api/reference.json +518 -1927
package/docs/changelog.md +6 -0
package/docs/getting-started.md +5 -5
package/docs/manifest.json +10 -10
package/docs/platform-rules.md +2 -2
package/docs/server-bundles.md +4 -4
package/docs/serverless-functions-js.md +3 -1
package/package.json +1 -1

package/docs/api/api-reference-server.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # The server surface — API reference
-Generated from `@indiegems/gem-web-sdk/sdk` v9.1.3. Every symbol below links to its page on the Gem Arcade developer site.
+Generated from `@indiegems/gem-web-sdk/sdk` v9.1.4, the version of the package this file ships in. Every symbol below carries an explicit anchor, its `anchor` in `reference.json` beside this file.
 `@indiegems/gem-web-sdk/sdk` is the one import a game writes, wherever its code runs. `@indiegems/gem-web-sdk/server` exports exactly the symbols on this page and nothing else, for a build that wants only this half.
@@ -8,11 +8,11 @@ Generated from `@indiegems/gem-web-sdk/sdk` v9.1.3. Every symbol below links to
 import { defineServer } from '@indiegems/gem-web-sdk/sdk';
 ```
-One dependency covers both halves of a game, and it is written out in [getting-started](https://gemarcade.com/developer/docs/getting-started#3-add-the-sdk) — the only place it is written out, so there is one copy to keep current. It is a public download needing no account and no credential, it goes in `dependencies`, and nothing is built on install. If you followed that page, the server entry is already installed.
+One dependency covers both halves of a game, and it is written out in [getting-started](../getting-started.md#3-add-the-sdk) — the only place it is written out, so there is one copy to keep current. It is a public download needing no account and no credential, it goes in `dependencies`, and nothing is built on install. If you followed that page, the server entry is already installed.
-## AnalyticsValue
+<a id="analyticsvalue"></a>
-[AnalyticsValue](https://gemarcade.com/developer/api/server#analyticsvalue)
+## AnalyticsValue
 ```ts
 type AnalyticsValue = string | number
@@ -26,9 +26,9 @@ declared ahead of time — that is the whole reason there is no free-text
 property — and measures are the numbers the platform sums, averages and
 takes the min and max of.
-## AnalyticsRejection
+<a id="analyticsrejection"></a>
-[AnalyticsRejection](https://gemarcade.com/developer/api/server#analyticsrejection)
+## AnalyticsRejection
 ```ts
 interface AnalyticsRejection
@@ -36,9 +36,9 @@ interface AnalyticsRejection
 One event the platform refused, inside an otherwise fine batch.
-## AnalyticsRejection.index
+<a id="analyticsrejection-index"></a>
-[AnalyticsRejection.index](https://gemarcade.com/developer/api/server#analyticsrejection-index)
+## AnalyticsRejection.index
 ```ts
 readonly index: number
@@ -50,9 +50,9 @@ Which event was refused, as an index into the batch that was sent.
 schedule, so this is only meaningful beside the code — which is the part
 worth acting on.
-## AnalyticsRejection.code
+<a id="analyticsrejection-code"></a>
-[AnalyticsRejection.code](https://gemarcade.com/developer/api/server#analyticsrejection-code)
+## AnalyticsRejection.code
 ```ts
 readonly code: string
@@ -66,9 +66,9 @@ channel declares a set and this name is not in it), `unknown_dimension`,
 `missing_dimension`, `dimension_value_not_declared`, `unknown_measure`,
 `measure_wrong_type`, `source_not_permitted`.
-## AnalyticsFlushResult
+<a id="analyticsflushresult"></a>
-[AnalyticsFlushResult](https://gemarcade.com/developer/api/server#analyticsflushresult)
+## AnalyticsFlushResult
 ```ts
 interface AnalyticsFlushResult
@@ -76,9 +76,9 @@ interface AnalyticsFlushResult
 What `AnalyticsApi.flush` resolves with.
-## AnalyticsFlushResult.accepted
+<a id="analyticsflushresult-accepted"></a>
-[AnalyticsFlushResult.accepted](https://gemarcade.com/developer/api/server#analyticsflushresult-accepted)
+## AnalyticsFlushResult.accepted
 ```ts
 readonly accepted: number
@@ -86,9 +86,9 @@ readonly accepted: number
 How many events the platform accepted and wrote.
-## AnalyticsFlushResult.rejected
+<a id="analyticsflushresult-rejected"></a>
-[AnalyticsFlushResult.rejected](https://gemarcade.com/developer/api/server#analyticsflushresult-rejected)
+## AnalyticsFlushResult.rejected
 ```ts
 readonly rejected: readonly AnalyticsRejection[]
@@ -100,9 +100,9 @@ Every event the platform refused, by index into the batch that was sent.
 accepted events in the same batch were still written. An empty array is
 the ordinary case.
-## AnalyticsFlushResult.dropped
+<a id="analyticsflushresult-dropped"></a>
-[AnalyticsFlushResult.dropped](https://gemarcade.com/developer/api/server#analyticsflushresult-dropped)
+## AnalyticsFlushResult.dropped
 ```ts
 readonly dropped: number
@@ -114,9 +114,9 @@ flush, because it was full. The oldest go first.
 A number worth alarming on: it is nonzero only when the game is producing
 events faster than the platform accepts them.
-## AnalyticsFlushResult.duplicate
+<a id="analyticsflushresult-duplicate"></a>
-[AnalyticsFlushResult.duplicate](https://gemarcade.com/developer/api/server#analyticsflushresult-duplicate)
+## AnalyticsFlushResult.duplicate
 ```ts
 readonly duplicate: boolean
@@ -128,9 +128,9 @@ A retry that the first attempt had in fact delivered. Not an error — it is
 what stops a flush racing a `pagehide` from being counted twice — and
 `accepted` is 0 on one.
-## Base64String
+<a id="base64string"></a>
-[Base64String](https://gemarcade.com/developer/api/server#base64string)
+## Base64String
 ```ts
 type Base64String = string & { __contentEncoding: "base64" }
@@ -148,12 +148,12 @@ This type moves that failure to your build. `{ value: JSON.stringify(state) }`
 type-checks perfectly against `string` and is exactly the mistake being
 stopped.
-MAKE ONE WITH [toBase64](https://gemarcade.com/developer/api/server#tobase64). Writing `as Base64String` instead silences the
+MAKE ONE WITH [toBase64](#tobase64). Writing `as Base64String` instead silences the
 error and puts the trap back.
-## toBase64
+<a id="tobase64"></a>
-[toBase64](https://gemarcade.com/developer/api/server#tobase64)
+## toBase64
 ```ts
 function toBase64(value: string | Uint8Array<ArrayBufferLike>): Base64String
@@ -161,7 +161,7 @@ function toBase64(value: string | Uint8Array<ArrayBufferLike>): Base64String
 Encode text or bytes for a field that wants base64.
-The only way to produce a [Base64String](https://gemarcade.com/developer/api/server#base64string), and the reason not to reach
+The only way to produce a [Base64String](#base64string), and the reason not to reach
 for `btoa` yourself: `btoa` takes a *binary* string and throws on any
 character above U+00FF, so `btoa(name)` works all through your testing and
 then fails on the first player whose display name is not Latin-1. This
@@ -179,9 +179,9 @@ await gem.api.putEntityGameSetting('loadout', {
 });
 ```
-## GemErrorReason
+<a id="gemerrorreason"></a>
-[GemErrorReason](https://gemarcade.com/developer/api/server#gemerrorreason)
+## GemErrorReason
 ```ts
 type GemErrorReason = "invalid" | "forbidden" | "not_found" | "conflict" | "precondition_failed" | "not_modified" | "insufficient_funds" | "too_large" | "rate_limited" | "unavailable"
@@ -191,11 +191,11 @@ What went wrong, in terms you can act on.
 BRANCH ON THIS, not on the HTTP status — one status covers several distinct
 refusals, and the reason is what tells them apart. It is carried by
-[GemApiError.reason](https://gemarcade.com/developer/api/server#gemapierror-reason).
+[GemApiError.reason](#gemapierror-reason).
-## GemApiError
+<a id="gemapierror"></a>
-[GemApiError](https://gemarcade.com/developer/api/server#gemapierror)
+## GemApiError
 ```ts
 class GemApiError
@@ -204,9 +204,9 @@ class GemApiError
 A refusal from the Gem Arcade backend. Any call that reaches the platform can
 throw one.
-You catch this; you never construct it. Branch on [GemApiError.reason](https://gemarcade.com/developer/api/server#gemapierror-reason)
-for what went wrong and [GemApiError.retryable](https://gemarcade.com/developer/api/server#gemapierror-retryable) for whether another
-attempt could help — not on [GemApiError.status](https://gemarcade.com/developer/api/server#gemapierror-status), because one status
+You catch this; you never construct it. Branch on [GemApiError.reason](#gemapierror-reason)
+for what went wrong and [GemApiError.retryable](#gemapierror-retryable) for whether another
+attempt could help — not on [GemApiError.status](#gemapierror-status), because one status
 covers several distinct refusals.
 ```js
@@ -222,9 +222,9 @@ try {
 }
 ```
-## GemApiError.reason
+<a id="gemapierror-reason"></a>
-[GemApiError.reason](https://gemarcade.com/developer/api/server#gemapierror-reason)
+## GemApiError.reason
 ```ts
 readonly reason: GemErrorReason
@@ -237,9 +237,9 @@ What went wrong, in terms you can act on — `invalid`, `forbidden`,
 This is the field to branch on. Two refusals can share a status and mean
 different things; they do not share a reason.
-## GemApiError.status
+<a id="gemapierror-status"></a>
-[GemApiError.status](https://gemarcade.com/developer/api/server#gemapierror-status)
+## GemApiError.status
 ```ts
 readonly status: number
@@ -247,13 +247,13 @@ readonly status: number
 The HTTP status the server answered with.
-Carried for logs and bug reports. Prefer [GemApiError.reason](https://gemarcade.com/developer/api/server#gemapierror-reason) for
+Carried for logs and bug reports. Prefer [GemApiError.reason](#gemapierror-reason) for
 decisions: several distinct refusals map onto one status, so branching
 here treats different problems as the same one.
-## GemApiError.detail
+<a id="gemapierror-detail"></a>
-[GemApiError.detail](https://gemarcade.com/developer/api/server#gemapierror-detail)
+## GemApiError.detail
 ```ts
 readonly detail: string
@@ -265,9 +265,9 @@ The server's own sentence, without the `reason (status):` prefix that
 Use this when you want to quote the platform — in a log line, or a bug
 report. It is not written for players, so do not put it on screen.
-## GemApiError.retryAfterSeconds
+<a id="gemapierror-retryafterseconds"></a>
-[GemApiError.retryAfterSeconds](https://gemarcade.com/developer/api/server#gemapierror-retryafterseconds)
+## GemApiError.retryAfterSeconds
 ```ts
 readonly retryAfterSeconds?: number
@@ -276,15 +276,15 @@ readonly retryAfterSeconds?: number
 How long the server asked you to wait, in whole seconds.
 ABSENT MEANS "NO ESTIMATE GIVEN", NEVER "DO NOT RETRY" —
-[GemApiError.retryable](https://gemarcade.com/developer/api/server#gemapierror-retryable) is what answers that. A refusal can be
+[GemApiError.retryable](#gemapierror-retryable) is what answers that. A refusal can be
 worth repeating and still name no wait, so treat absence as "pick your
 own backoff" rather than as a stop signal. The platform estimates a wait
 for capacity and for rate limits, and sends none for the refusals it
 cannot put a number on.
-## GemApiError.code
+<a id="gemapierror-code"></a>
-[GemApiError.code](https://gemarcade.com/developer/api/server#gemapierror-code)
+## GemApiError.code
 ```ts
 readonly code?: string
@@ -294,7 +294,7 @@ The platform's own error code, when it sent one —
 `too_many_concurrent_matches`, `cluster_target_required`,
 `no_compatible_server`.
-Finer-grained than [GemApiError.reason](https://gemarcade.com/developer/api/server#gemapierror-reason), and the only way to tell
+Finer-grained than [GemApiError.reason](#gemapierror-reason), and the only way to tell
 apart two refusals that share both a reason and a status. Absent on most
 refusals, so treat it as extra information rather than something to
 depend on.
@@ -305,9 +305,9 @@ refusals carry the platform's purchase codes — `insufficient_funds`,
 strings `gem.purchases.request` answers as its `reason`, so one `switch`
 on `err.code` covers both purchase paths.
-## GemApiError.retryable
+<a id="gemapierror-retryable"></a>
-[GemApiError.retryable](https://gemarcade.com/developer/api/server#gemapierror-retryable)
+## GemApiError.retryable
 ```ts
 get retryable(): boolean
@@ -318,45 +318,45 @@ Whether another attempt could plausibly succeed.
 True for `unavailable` and `rate_limited` and false for everything else —
 a `forbidden` or `not_found` will refuse identically however many times you
 send it. Check this before retrying, and wait
-[GemApiError.retryAfterSeconds](https://gemarcade.com/developer/api/server#gemapierror-retryafterseconds) if the server named one.
+[GemApiError.retryAfterSeconds](#gemapierror-retryafterseconds) if the server named one.
-## ClientOptions
+<a id="clientoptions"></a>
-[ClientOptions](https://gemarcade.com/developer/api/server#clientoptions)
+## ClientOptions
 ```ts
 interface ClientOptions
 ```
-How a [GemClient](https://gemarcade.com/developer/api/server#gemclient) is built.
+How a [GemClient](#gemclient) is built.
-You rarely construct one yourself — [createGemServer](https://gemarcade.com/developer/api/server#creategemserver) does it — but the
+You rarely construct one yourself — [createGemServer](#creategemserver) does it — but the
 type has to be nameable to write a helper that takes one.
-## ClientOptions.transport
+<a id="clientoptions-transport"></a>
-[ClientOptions.transport](https://gemarcade.com/developer/api/server#clientoptions-transport)
+## ClientOptions.transport
 ```ts
 readonly transport: Transport
 ```
 How requests actually leave. Substitute one to test without a network — see
-[Transport](https://gemarcade.com/developer/api/server#transport).
+[Transport](#transport).
-## ClientOptions.clock
+<a id="clientoptions-clock"></a>
-[ClientOptions.clock](https://gemarcade.com/developer/api/server#clientoptions-clock)
+## ClientOptions.clock
 ```ts
 readonly clock: Clock
 ```
-Where time comes from, for retry backoff. See [Clock](https://gemarcade.com/developer/api/server#clock).
+Where time comes from, for retry backoff. See [Clock](#clock).
-## ClientOptions.maxRetries
+<a id="clientoptions-maxretries"></a>
-[ClientOptions.maxRetries](https://gemarcade.com/developer/api/server#clientoptions-maxretries)
+## ClientOptions.maxRetries
 ```ts
 readonly maxRetries?: number
@@ -366,15 +366,15 @@ How many times to retry a read that failed. Defaults to 2 — three attempts
 in all.
 READS SPEND THIS BUDGET, and so does a write the caller has declared
-replayable with [RequestOptions.replaySafe](https://gemarcade.com/developer/api/server#requestoptions-replaysafe). Every other write gets
+replayable with [RequestOptions.replaySafe](#requestoptions-replaysafe). Every other write gets
 one attempt whatever you set here: a write that timed out may already have
 been applied, and repeating it is how a client charges someone twice.
 Whether a given write is safe to repeat is something only its caller knows,
 so the SDK does not guess.
-## RequestOptions
+<a id="requestoptions"></a>
-[RequestOptions](https://gemarcade.com/developer/api/server#requestoptions)
+## RequestOptions
 ```ts
 interface RequestOptions
@@ -382,9 +382,9 @@ interface RequestOptions
 Per-call options, for the occasional call that needs one.
-## RequestOptions.keepalive
+<a id="requestoptions-keepalive"></a>
-[RequestOptions.keepalive](https://gemarcade.com/developer/api/server#requestoptions-keepalive)
+## RequestOptions.keepalive
 ```ts
 readonly keepalive?: boolean
@@ -396,9 +396,9 @@ For the last write before a player closes the tab. Browsers cap how much
 can be in flight this way, so use it for the write that matters, not for
 every write.
-## RequestOptions.ifMatch
+<a id="requestoptions-ifmatch"></a>
-[RequestOptions.ifMatch](https://gemarcade.com/developer/api/server#requestoptions-ifmatch)
+## RequestOptions.ifMatch
 ```ts
 readonly ifMatch?: string
@@ -411,9 +411,9 @@ someone else wrote in between, the call fails with `precondition_failed`
 instead of overwriting them — re-read, decide again against the new state,
 and write again.
-## RequestOptions.replaySafe
+<a id="requestoptions-replaysafe"></a>
-[RequestOptions.replaySafe](https://gemarcade.com/developer/api/server#requestoptions-replaysafe)
+## RequestOptions.replaySafe
 ```ts
 readonly replaySafe?: boolean
@@ -435,14 +435,14 @@ opposite: a retry the caller cannot see is how one purchase becomes two.
 If you are unsure, leave it alone and decide for yourself whether to
 repeat the call.
-It buys the same budget a read gets — see [ClientOptions.maxRetries](https://gemarcade.com/developer/api/server#clientoptions-maxretries)
+It buys the same budget a read gets — see [ClientOptions.maxRetries](#clientoptions-maxretries)
 — and nothing else. A refusal the server made deliberately is still
-final: only the failures [GemApiError.retryable](https://gemarcade.com/developer/api/server#gemapierror-retryable) describes, and a
+final: only the failures [GemApiError.retryable](#gemapierror-retryable) describes, and a
 connection that died with no answer, are attempted again.
-## VersionedGetOptions
+<a id="versionedgetoptions"></a>
-[VersionedGetOptions](https://gemarcade.com/developer/api/server#versionedgetoptions)
+## VersionedGetOptions
 ```ts
 interface VersionedGetOptions
@@ -450,9 +450,9 @@ interface VersionedGetOptions
 Options for a read that also wants the value's version back.
-## VersionedGetOptions.signal
+<a id="versionedgetoptions-signal"></a>
-[VersionedGetOptions.signal](https://gemarcade.com/developer/api/server#versionedgetoptions-signal)
+## VersionedGetOptions.signal
 ```ts
 readonly signal?: AbortSignal
@@ -460,9 +460,9 @@ readonly signal?: AbortSignal
 Cancel the read. An aborted call rejects rather than resolving.
-## VersionedGetOptions.ifNoneMatch
+<a id="versionedgetoptions-ifnonematch"></a>
-[VersionedGetOptions.ifNoneMatch](https://gemarcade.com/developer/api/server#versionedgetoptions-ifnonematch)
+## VersionedGetOptions.ifNoneMatch
 ```ts
 readonly ifNoneMatch?: string
@@ -473,9 +473,9 @@ Ask "has this changed?" instead of "give me this".
 Pass the version from your last read. If nothing has changed you get back
 `{ modified: false }` and no body — cheaper for you and for the platform.
-## VersionedResponse
+<a id="versionedresponse"></a>
-[VersionedResponse](https://gemarcade.com/developer/api/server#versionedresponse)
+## VersionedResponse
 ```ts
 type VersionedResponse<T> = { modified: true; body: T; etag?: string } | { modified: false; etag?: string }
@@ -497,20 +497,20 @@ if (result.modified) {
 }
 ```
-## BytesResponse
+<a id="bytesresponse"></a>
-[BytesResponse](https://gemarcade.com/developer/api/server#bytesresponse)
+## BytesResponse
 ```ts
 interface BytesResponse
 ```
-What [GemClient.postBytes](https://gemarcade.com/developer/api/server#gemclient-postbytes) resolves: the answer's raw bytes, and the id
+What [GemClient.postBytes](#gemclient-postbytes) resolves: the answer's raw bytes, and the id
 the platform gave the invocation when there was one.
-## BytesResponse.bytes
+<a id="bytesresponse-bytes"></a>
-[BytesResponse.bytes](https://gemarcade.com/developer/api/server#bytesresponse-bytes)
+## BytesResponse.bytes
 ```ts
 readonly bytes: Uint8Array
@@ -518,20 +518,20 @@ readonly bytes: Uint8Array
 Exactly the bytes that arrived — empty when the answer had no body.
-## BytesResponse.invocationId
+<a id="bytesresponse-invocationid"></a>
-[BytesResponse.invocationId](https://gemarcade.com/developer/api/server#bytesresponse-invocationid)
+## BytesResponse.invocationId
 ```ts
 readonly invocationId?: string
 ```
 The platform's id for this invocation, when the answer named one and the
-runtime could read it. See [TransportResponse.invocationId](https://gemarcade.com/developer/api/server#transportresponse-invocationid).
+runtime could read it. See [TransportResponse.invocationId](#transportresponse-invocationid).
-## GemClient
+<a id="gemclient"></a>
-[GemClient](https://gemarcade.com/developer/api/server#gemclient)
+## GemClient
 ```ts
 class GemClient
@@ -540,25 +540,25 @@ class GemClient
 The HTTP client underneath the generated operations — for calls those do not
 cover.
-PREFER [ServerApi](https://gemarcade.com/developer/api/server#serverapi). Its methods are typed against the platform's own
+PREFER [ServerApi](#serverapi). Its methods are typed against the platform's own
 description, so a shape that changes becomes a build error in your bundle.
 This one takes a path and checks nothing you give it.
 What it does give you is everything around the call: the credential, retries
 on the requests that are safe to retry, and failures already classified into
-[GemApiError](https://gemarcade.com/developer/api/server#gemapierror) so you can branch on a reason instead of a status.
+[GemApiError](#gemapierror) so you can branch on a reason instead of a status.
 READS ARE RETRIED; A WRITE IS NOT, unless its caller declares it replayable
-with [RequestOptions.replaySafe](https://gemarcade.com/developer/api/server#requestoptions-replaysafe). A write that timed out may well have
+with [RequestOptions.replaySafe](#requestoptions-replaysafe). A write that timed out may well have
 been applied, and retrying it silently is how a client duplicates a purchase
 it cannot see — so the default is one attempt, and widening it is a decision
 made one call at a time by whoever knows what the call does.
 You reach one as `gem.client`; there is normally no reason to construct it.
-## GemClient.constructor
+<a id="gemclient-constructor"></a>
-[GemClient.constructor](https://gemarcade.com/developer/api/server#gemclient-constructor)
+## GemClient.constructor
 ```ts
 constructor(options: ClientOptions): GemClient
@@ -569,11 +569,11 @@ it to you as `gem.client`.
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `options` | `ClientOptions` | See [ClientOptions](https://gemarcade.com/developer/api/server#clientoptions). |
+| `options` | `ClientOptions` | See [ClientOptions](#clientoptions). |
-## GemClient.get
+<a id="gemclient-get"></a>
-[GemClient.get](https://gemarcade.com/developer/api/server#gemclient-get)
+## GemClient.get
 ```ts
 get<T>(path: string, signal?: AbortSignal): Promise<T>
@@ -586,11 +586,11 @@ Read something.
 | `path` | `string` | From the API root, e.g. `/v1/players/me/settings`. |
 | `signal` | `AbortSignal` | Cancels the read. |
-**Throws.** [GemApiError](https://gemarcade.com/developer/api/server#gemapierror) on a refusal — branch on `reason`.
+**Throws.** [GemApiError](#gemapierror) on a refusal — branch on `reason`.
-## GemClient.getWithEtag
+<a id="gemclient-getwithetag"></a>
-[GemClient.getWithEtag](https://gemarcade.com/developer/api/server#gemclient-getwithetag)
+## GemClient.getWithEtag
 ```ts
 getWithEtag<T>(path: string, options?: VersionedGetOptions): Promise<VersionedResponse<T>>
@@ -603,21 +603,21 @@ it as `ifMatch` on your write, and the write is refused rather than
 overwriting somebody. Pass it as `ifNoneMatch` here and an unchanged
 resource comes back with no body at all.
-SEPARATE FROM [GemClient.get](https://gemarcade.com/developer/api/server#gemclient-get) on purpose — `get` answers with the value
+SEPARATE FROM [GemClient.get](#gemclient-get) on purpose — `get` answers with the value
 and nothing else, which is what most calls want.
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `path` | `string` | From the API root. |
-| `options` | `VersionedGetOptions` | See [VersionedGetOptions](https://gemarcade.com/developer/api/server#versionedgetoptions). |
+| `options` | `VersionedGetOptions` | See [VersionedGetOptions](#versionedgetoptions). |
-**Returns.** See [VersionedResponse](https://gemarcade.com/developer/api/server#versionedresponse) — check `modified` before reading a body.
+**Returns.** See [VersionedResponse](#versionedresponse) — check `modified` before reading a body.
-**Throws.** [GemApiError](https://gemarcade.com/developer/api/server#gemapierror) on a refusal.
+**Throws.** [GemApiError](#gemapierror) on a refusal.
-## GemClient.put
+<a id="gemclient-put"></a>
-[GemClient.put](https://gemarcade.com/developer/api/server#gemclient-put)
+## GemClient.put
 ```ts
 put<T>(path: string, body: unknown, signal?: AbortSignal, options?: RequestOptions): Promise<T>
@@ -626,7 +626,7 @@ put<T>(path: string, body: unknown, signal?: AbortSignal, options?: RequestOptio
 Replace something.
 NOT RETRIED. A write that timed out may already have been applied — set
-[RequestOptions.replaySafe](https://gemarcade.com/developer/api/server#requestoptions-replaysafe) if repeating this one cannot change the
+[RequestOptions.replaySafe](#requestoptions-replaysafe) if repeating this one cannot change the
 outcome.
 | Parameter | Type | Description |
@@ -634,14 +634,14 @@ outcome.
 | `path` | `string` | From the API root. |
 | `body` | `unknown` | What to send. Encoded as JSON. |
 | `signal` | `AbortSignal` |  |
-| `options` | `RequestOptions` | See [RequestOptions](https://gemarcade.com/developer/api/server#requestoptions) — `ifMatch` is how you avoid
+| `options` | `RequestOptions` | See [RequestOptions](#requestoptions) — `ifMatch` is how you avoid
   overwriting someone else's write. |
-**Throws.** [GemApiError](https://gemarcade.com/developer/api/server#gemapierror) on a refusal.
+**Throws.** [GemApiError](#gemapierror) on a refusal.
-## GemClient.post
+<a id="gemclient-post"></a>
-[GemClient.post](https://gemarcade.com/developer/api/server#gemclient-post)
+## GemClient.post
 ```ts
 post<T>(path: string, body: unknown, signal?: AbortSignal, options?: RequestOptions): Promise<T>
@@ -649,7 +649,7 @@ post<T>(path: string, body: unknown, signal?: AbortSignal, options?: RequestOpti
 Create something, or perform an action.
-NOT RETRIED, for the same reason as [GemClient.put](https://gemarcade.com/developer/api/server#gemclient-put), and widened the
+NOT RETRIED, for the same reason as [GemClient.put](#gemclient-put), and widened the
 same way.
 | Parameter | Type | Description |
@@ -657,13 +657,13 @@ same way.
 | `path` | `string` | From the API root. |
 | `body` | `unknown` | What to send. Encoded as JSON. |
 | `signal` | `AbortSignal` |  |
-| `options` | `RequestOptions` | See [RequestOptions](https://gemarcade.com/developer/api/server#requestoptions). |
+| `options` | `RequestOptions` | See [RequestOptions](#requestoptions). |
-**Throws.** [GemApiError](https://gemarcade.com/developer/api/server#gemapierror) on a refusal.
+**Throws.** [GemApiError](#gemapierror) on a refusal.
-## GemClient.postBytes
+<a id="gemclient-postbytes"></a>
-[GemClient.postBytes](https://gemarcade.com/developer/api/server#gemclient-postbytes)
+## GemClient.postBytes
 ```ts
 postBytes(path: string, bytes: Uint8Array, signal?: AbortSignal, options?: RequestOptions): Promise<BytesResponse>
@@ -673,9 +673,9 @@ Send raw bytes and get raw bytes back.
 For a route whose input and output are your own bytes rather than JSON.
 The body goes out as it is, labelled `application/octet-stream`, and a
-success comes back undecoded. A refusal is still a [GemApiError](https://gemarcade.com/developer/api/server#gemapierror).
+success comes back undecoded. A refusal is still a [GemApiError](#gemapierror).
-NOT RETRIED, for the same reason as [GemClient.put](https://gemarcade.com/developer/api/server#gemclient-put), and widened the
+NOT RETRIED, for the same reason as [GemClient.put](#gemclient-put), and widened the
 same way.
 | Parameter | Type | Description |
@@ -683,13 +683,13 @@ same way.
 | `path` | `string` | From the API root. |
 | `bytes` | `Uint8Array` | What to send, byte for byte. |
 | `signal` | `AbortSignal` |  |
-| `options` | `RequestOptions` | See [RequestOptions](https://gemarcade.com/developer/api/server#requestoptions). |
+| `options` | `RequestOptions` | See [RequestOptions](#requestoptions). |
-**Throws.** [GemApiError](https://gemarcade.com/developer/api/server#gemapierror) on a refusal.
+**Throws.** [GemApiError](#gemapierror) on a refusal.
-## GemClient.patch
+<a id="gemclient-patch"></a>
-[GemClient.patch](https://gemarcade.com/developer/api/server#gemclient-patch)
+## GemClient.patch
 ```ts
 patch<T>(path: string, body: unknown, signal?: AbortSignal, options?: RequestOptions): Promise<T>
@@ -697,7 +697,7 @@ patch<T>(path: string, body: unknown, signal?: AbortSignal, options?: RequestOpt
 Change part of something.
-NOT RETRIED, for the same reason as [GemClient.put](https://gemarcade.com/developer/api/server#gemclient-put), and widened the
+NOT RETRIED, for the same reason as [GemClient.put](#gemclient-put), and widened the
 same way.
 | Parameter | Type | Description |
@@ -705,13 +705,13 @@ same way.
 | `path` | `string` | From the API root. |
 | `body` | `unknown` | The change. Encoded as JSON. |
 | `signal` | `AbortSignal` |  |
-| `options` | `RequestOptions` | See [RequestOptions](https://gemarcade.com/developer/api/server#requestoptions). |
+| `options` | `RequestOptions` | See [RequestOptions](#requestoptions). |
-**Throws.** [GemApiError](https://gemarcade.com/developer/api/server#gemapierror) on a refusal.
+**Throws.** [GemApiError](#gemapierror) on a refusal.
-## GemClient.delete
+<a id="gemclient-delete"></a>
-[GemClient.delete](https://gemarcade.com/developer/api/server#gemclient-delete)
+## GemClient.delete
 ```ts
 delete<T>(path: string, signal?: AbortSignal, options?: RequestOptions): Promise<T>
@@ -719,20 +719,20 @@ delete<T>(path: string, signal?: AbortSignal, options?: RequestOptions): Promise
 Remove something.
-NOT RETRIED, for the same reason as [GemClient.put](https://gemarcade.com/developer/api/server#gemclient-put), and widened the
+NOT RETRIED, for the same reason as [GemClient.put](#gemclient-put), and widened the
 same way.
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `path` | `string` | From the API root. |
 | `signal` | `AbortSignal` | Cancels the call. |
-| `options` | `RequestOptions` | See [RequestOptions](https://gemarcade.com/developer/api/server#requestoptions). |
+| `options` | `RequestOptions` | See [RequestOptions](#requestoptions). |
-**Throws.** [GemApiError](https://gemarcade.com/developer/api/server#gemapierror) on a refusal.
+**Throws.** [GemApiError](#gemapierror) on a refusal.
-## AuthFailure
+<a id="authfailure"></a>
-[AuthFailure](https://gemarcade.com/developer/api/server#authfailure)
+## AuthFailure
 ```ts
 type AuthFailure = "chain_exhausted" | "unavailable" | "timeout" | "internal"
@@ -742,7 +742,7 @@ Why the session could not produce a usable token.
 THIS IS THE CAUSE, NOT A VERDICT. It deliberately never distinguishes a
 sign-out from a ban from a revocation, and it does not tell you whether to
-try again — [AuthState](https://gemarcade.com/developer/api/server#authstate) does that. A game that branches on the reason
+try again — [AuthState](#authstate) does that. A game that branches on the reason
 is guessing.
 - `chain_exhausted` — the token chain cannot be renewed any further.
@@ -750,9 +750,9 @@ is guessing.
 - `timeout` — the arcade did not answer in time.
 - `internal` — something went wrong on this side.
-## AuthState
+<a id="authstate"></a>
-[AuthState](https://gemarcade.com/developer/api/server#authstate)
+## AuthState
 ```ts
 type AuthState = "ready" | "pending" | "degraded" | "lost"
@@ -771,9 +771,9 @@ the callback instead.
 - `lost` — terminal for this session. Signing back in is the only way
   forward, and retrying will not produce one.
-## TokenGrant
+<a id="tokengrant"></a>
-[TokenGrant](https://gemarcade.com/developer/api/server#tokengrant)
+## TokenGrant
 ```ts
 interface TokenGrant
@@ -791,9 +791,9 @@ credential stops working and a fresh one is fetched — routine, invisible.
 `chainEndsAt` is when fetching a fresh one stops being possible at all: past
 it the session is over and only signing in again helps.
-## TokenGrant.token
+<a id="tokengrant-token"></a>
-[TokenGrant.token](https://gemarcade.com/developer/api/server#tokengrant-token)
+## TokenGrant.token
 ```ts
 readonly token: string
@@ -804,9 +804,9 @@ The credential itself.
 NEVER LOG IT AND NEVER FORWARD IT. Anything holding it can act as this
 session until it expires.
-## TokenGrant.expiresAt
+<a id="tokengrant-expiresat"></a>
-[TokenGrant.expiresAt](https://gemarcade.com/developer/api/server#tokengrant-expiresat)
+## TokenGrant.expiresAt
 ```ts
 readonly expiresAt: number
@@ -816,9 +816,9 @@ When this credential stops working, in seconds since the Unix epoch.
 Routine — the SDK renews before this, and you do not see it happen.
-## TokenGrant.chainEndsAt
+<a id="tokengrant-chainendsat"></a>
-[TokenGrant.chainEndsAt](https://gemarcade.com/developer/api/server#tokengrant-chainendsat)
+## TokenGrant.chainEndsAt
 ```ts
 readonly chainEndsAt: number
@@ -827,11 +827,11 @@ readonly chainEndsAt: number
 When renewal stops being possible, in seconds since the Unix epoch.
 Past this the session cannot be extended by anything. Watch
-[AuthState](https://gemarcade.com/developer/api/server#authstate) rather than this number.
+[AuthState](#authstate) rather than this number.
-## AuthError
+<a id="autherror"></a>
-[AuthError](https://gemarcade.com/developer/api/server#autherror)
+## AuthError
 ```ts
 class AuthError
@@ -843,25 +843,25 @@ Thrown by any call that needs the player's session. You catch this; you never
 construct it.
 IT CARRIES NO `retryable` FIELD, and that is deliberate rather than an
-oversight — [AuthError.reason](https://gemarcade.com/developer/api/server#autherror-reason) is the cause, and the retry verdict
+oversight — [AuthError.reason](#autherror-reason) is the cause, and the retry verdict
 lives on the session's state. Watch `GemOptions.onAuthStateChange` and treat
-[AuthState](https://gemarcade.com/developer/api/server#authstate) `degraded` as worth retrying and `lost` as terminal. A game
+[AuthState](#authstate) `degraded` as worth retrying and `lost` as terminal. A game
 that decides from the reason will retry a session that can never come back.
-## AuthError.reason
+<a id="autherror-reason"></a>
-[AuthError.reason](https://gemarcade.com/developer/api/server#autherror-reason)
+## AuthError.reason
 ```ts
 readonly reason: AuthFailure
 ```
-Why the token could not be produced. See [AuthFailure](https://gemarcade.com/developer/api/server#authfailure) — it is the
+Why the token could not be produced. See [AuthFailure](#authfailure) — it is the
 cause, and not a signal about whether to try again.
-## AuthError.isAuthError
+<a id="autherror-isautherror"></a>
-[AuthError.isAuthError](https://gemarcade.com/developer/api/server#autherror-isautherror)
+## AuthError.isAuthError
 ```ts
 isAuthError(error: unknown): error is AuthError
@@ -891,9 +891,9 @@ bundle alike, and the two have no call in common.
 | --- | --- |
 | `error` | `unknown` |
-## TransportRefusal
+<a id="transportrefusal"></a>
-[TransportRefusal](https://gemarcade.com/developer/api/server#transportrefusal)
+## TransportRefusal
 ```ts
 class TransportRefusal
@@ -912,9 +912,9 @@ conditional-header value the wire cannot carry, and a retry count outside
 Nothing reached the platform, so there is no status and no response to read.
 Fix the call.
-## TransportRefusal.retryable
+<a id="transportrefusal-retryable"></a>
-[TransportRefusal.retryable](https://gemarcade.com/developer/api/server#transportrefusal-retryable)
+## TransportRefusal.retryable
 ```ts
 readonly retryable: false
@@ -926,9 +926,9 @@ Present so that code branching on `retryable` across the errors this SDK
 throws reads a real `false` here rather than `undefined`. A refusal is
 deterministic; retrying cannot change it.
-## TransportRefusal.isRefusal
+<a id="transportrefusal-isrefusal"></a>
-[TransportRefusal.isRefusal](https://gemarcade.com/developer/api/server#transportrefusal-isrefusal)
+## TransportRefusal.isRefusal
 ```ts
 isRefusal(error: unknown): error is TransportRefusal
@@ -944,9 +944,9 @@ one copy fails `instanceof` in the other.
 | --- | --- |
 | `error` | `unknown` |
-## CONDITIONAL_HEADERS
+<a id="conditional_headers"></a>
-[CONDITIONAL_HEADERS](https://gemarcade.com/developer/api/server#conditional_headers)
+## CONDITIONAL_HEADERS
 ```ts
 CONDITIONAL_HEADERS: readonly ["if-match", "if-none-match"]
@@ -958,33 +958,33 @@ A CLOSED SET, ON PURPOSE. Everything else — the credential, the content type,
 the client's identity — is the SDK's to send, and a call that could add its
 own headers could send headers the platform trusts.
-## ConditionalRequestHeaders
+<a id="conditionalrequestheaders"></a>
-[ConditionalRequestHeaders](https://gemarcade.com/developer/api/server#conditionalrequestheaders)
+## ConditionalRequestHeaders
 ```ts
 type ConditionalRequestHeaders = Partial<Record<unknown[number], string>>
 ```
-The type of [TransportRequest.headers](https://gemarcade.com/developer/api/server#transportrequest-headers) — derived from
-[CONDITIONAL_HEADERS](https://gemarcade.com/developer/api/server#conditional_headers), so the two cannot disagree.
+The type of [TransportRequest.headers](#transportrequest-headers) — derived from
+[CONDITIONAL_HEADERS](#conditional_headers), so the two cannot disagree.
-## TransportRequest
+<a id="transportrequest"></a>
-[TransportRequest](https://gemarcade.com/developer/api/server#transportrequest)
+## TransportRequest
 ```ts
 interface TransportRequest
 ```
-One outgoing call, as a [Transport](https://gemarcade.com/developer/api/server#transport) receives it.
+One outgoing call, as a [Transport](#transport) receives it.
 You meet this when you write a transport — usually in a test, to assert what
 your code sends without a network.
-## TransportRequest.method
+<a id="transportrequest-method"></a>
-[TransportRequest.method](https://gemarcade.com/developer/api/server#transportrequest-method)
+## TransportRequest.method
 ```ts
 readonly method: "GET" | "PUT" | "POST" | "PATCH" | "DELETE"
@@ -992,9 +992,9 @@ readonly method: "GET" | "PUT" | "POST" | "PATCH" | "DELETE"
 The HTTP method.
-## TransportRequest.path
+<a id="transportrequest-path"></a>
-[TransportRequest.path](https://gemarcade.com/developer/api/server#transportrequest-path)
+## TransportRequest.path
 ```ts
 readonly path: string
@@ -1003,9 +1003,9 @@ readonly path: string
 The path, from the API root — `/v1/players/me/settings`. Never a full URL:
 where it is sent is not a call's decision.
-## TransportRequest.body
+<a id="transportrequest-body"></a>
-[TransportRequest.body](https://gemarcade.com/developer/api/server#transportrequest-body)
+## TransportRequest.body
 ```ts
 readonly body?: unknown
@@ -1013,9 +1013,9 @@ readonly body?: unknown
 The request body, if there is one. Encoded as JSON.
-## TransportRequest.bytes
+<a id="transportrequest-bytes"></a>
-[TransportRequest.bytes](https://gemarcade.com/developer/api/server#transportrequest-bytes)
+## TransportRequest.bytes
 ```ts
 readonly bytes?: Uint8Array<ArrayBufferLike>
@@ -1024,12 +1024,12 @@ readonly bytes?: Uint8Array<ArrayBufferLike>
 A raw request body, sent as it is and labelled `application/octet-stream`.
 For a route whose input is your own bytes rather than JSON. Set this or
-[TransportRequest.body](https://gemarcade.com/developer/api/server#transportrequest-body), never both: a request carrying both is
+[TransportRequest.body](#transportrequest-body), never both: a request carrying both is
 refused rather than sent with one of them dropped.
-## TransportRequest.responseType
+<a id="transportrequest-responsetype"></a>
-[TransportRequest.responseType](https://gemarcade.com/developer/api/server#transportrequest-responsetype)
+## TransportRequest.responseType
 ```ts
 readonly responseType?: "json" | "bytes"
@@ -1042,19 +1042,19 @@ Only a success is read as bytes. A refusal is the platform's own JSON
 envelope whichever you ask for, so its code and message still reach the
 error you catch.
-## TransportRequest.headers
+<a id="transportrequest-headers"></a>
-[TransportRequest.headers](https://gemarcade.com/developer/api/server#transportrequest-headers)
+## TransportRequest.headers
 ```ts
 readonly headers?: Partial<Record<"if-match" | "if-none-match", string>>
 ```
-See [ConditionalRequestHeaders](https://gemarcade.com/developer/api/server#conditionalrequestheaders) — nothing else may be set.
+See [ConditionalRequestHeaders](#conditionalrequestheaders) — nothing else may be set.
-## TransportRequest.signal
+<a id="transportrequest-signal"></a>
-[TransportRequest.signal](https://gemarcade.com/developer/api/server#transportrequest-signal)
+## TransportRequest.signal
 ```ts
 readonly signal?: AbortSignal
@@ -1062,9 +1062,9 @@ readonly signal?: AbortSignal
 Cancels the request. Timeouts are the caller's policy, not the SDK's.
-## TransportRequest.keepalive
+<a id="transportrequest-keepalive"></a>
-[TransportRequest.keepalive](https://gemarcade.com/developer/api/server#transportrequest-keepalive)
+## TransportRequest.keepalive
 ```ts
 readonly keepalive?: boolean
@@ -1079,23 +1079,23 @@ and nothing arrives.
 NOT ON EVERYTHING, because browsers cap how much can be in flight this way
 (64 KB across all such requests). Use it for the write that matters.
-## TransportResponse
+<a id="transportresponse"></a>
-[TransportResponse](https://gemarcade.com/developer/api/server#transportresponse)
+## TransportResponse
 ```ts
 interface TransportResponse
 ```
-What a [Transport](https://gemarcade.com/developer/api/server#transport) answers with.
+What a [Transport](#transport) answers with.
 THREE HEADERS ARE PARSED OUT and there is no header bag, because these are the
 only three anything above this point reads — which also keeps a stub in a test
 to a few fields.
-## TransportResponse.status
+<a id="transportresponse-status"></a>
-[TransportResponse.status](https://gemarcade.com/developer/api/server#transportresponse-status)
+## TransportResponse.status
 ```ts
 readonly status: number
@@ -1103,9 +1103,9 @@ readonly status: number
 The HTTP status.
-## TransportResponse.body
+<a id="transportresponse-body"></a>
-[TransportResponse.body](https://gemarcade.com/developer/api/server#transportresponse-body)
+## TransportResponse.body
 ```ts
 readonly body: unknown
@@ -1114,9 +1114,9 @@ readonly body: unknown
 The decoded response body — or, for a success when the request asked for
 `responseType: 'bytes'`, a `Uint8Array` of exactly what arrived.
-## TransportResponse.etag
+<a id="transportresponse-etag"></a>
-[TransportResponse.etag](https://gemarcade.com/developer/api/server#transportresponse-etag)
+## TransportResponse.etag
 ```ts
 readonly etag?: string
@@ -1128,9 +1128,9 @@ Absent when the server sent none — not every resource is versioned. If you
 are writing a transport for a test, set it: leaving it out makes every
 conditional read look unversioned.
-## TransportResponse.retryAfterSeconds
+<a id="transportresponse-retryafterseconds"></a>
-[TransportResponse.retryAfterSeconds](https://gemarcade.com/developer/api/server#transportresponse-retryafterseconds)
+## TransportResponse.retryAfterSeconds
 ```ts
 readonly retryAfterSeconds?: number
@@ -1141,11 +1141,11 @@ How long the server asked you to wait, in WHOLE SECONDS.
 Seconds, not milliseconds — do not divide it by anything.
 ABSENT MEANS "NO ESTIMATE", NEVER "DO NOT RETRY". Whether a refusal is
-worth repeating is [GemApiError.retryable](https://gemarcade.com/developer/api/server#gemapierror-retryable)'s answer, not this field's.
+worth repeating is [GemApiError.retryable](#gemapierror-retryable)'s answer, not this field's.
-## TransportResponse.invocationId
+<a id="transportresponse-invocationid"></a>
-[TransportResponse.invocationId](https://gemarcade.com/developer/api/server#transportresponse-invocationid)
+## TransportResponse.invocationId
 ```ts
 readonly invocationId?: string
@@ -1158,9 +1158,9 @@ Absent when the answer named none, and also when the runtime could not read
 the header: a browser only reads the response headers the platform exposes
 to it.
-## Transport
+<a id="transport"></a>
-[Transport](https://gemarcade.com/developer/api/server#transport)
+## Transport
 ```ts
 interface Transport
@@ -1181,9 +1181,9 @@ const transport = {
 };
 ```
-## Transport.request
+<a id="transport-request"></a>
-[Transport.request](https://gemarcade.com/developer/api/server#transport-request)
+## Transport.request
 ```ts
 request(request: TransportRequest): Promise<TransportResponse>
@@ -1195,9 +1195,9 @@ Send one request and resolve with what came back.
 | --- | --- |
 | `request` | `TransportRequest` |
-## ChallengeWindow
+<a id="challengewindow"></a>
-[ChallengeWindow](https://gemarcade.com/developer/api/server#challengewindow)
+## ChallengeWindow
 ```ts
 type ChallengeWindow = "daily" | "weekly" | "monthly" | "cron" | string & object
@@ -1209,9 +1209,9 @@ Open on purpose: the platform may add a window, and a game that pattern-
 matches on the three it knows should fall through rather than fail to
 compile against a newer SDK.
-## Challenge
+<a id="challenge"></a>
-[Challenge](https://gemarcade.com/developer/api/server#challenge)
+## Challenge
 ```ts
 interface Challenge
@@ -1222,14 +1222,14 @@ One challenge, in one period.
 Everything here is a function of your game config, the calendar and the
 player's time zone. It says nothing about the player's progress or streak.
-⚠️ **Key a period on [Challenge.periodLocalDate](https://gemarcade.com/developer/api/server#challenge-periodlocaldate), or on
-[Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed) for a `cron` challenge — never on
-[Challenge.periodStartAt](https://gemarcade.com/developer/api/server#challenge-periodstartat).** Two players on the same date, and on the
+⚠️ **Key a period on [Challenge.periodLocalDate](#challenge-periodlocaldate), or on
+[Challenge.seed](#challenge-seed) for a `cron` challenge — never on
+[Challenge.periodStartAt](#challenge-periodstartat).** Two players on the same date, and on the
 same board, see different start instants when their time zones differ.
-## Challenge.id
+<a id="challenge-id"></a>
-[Challenge.id](https://gemarcade.com/developer/api/server#challenge-id)
+## Challenge.id
 ```ts
 readonly id: string
@@ -1242,9 +1242,9 @@ A challenge's id means one thing forever — reusing it for a different
 challenge merges two histories into one; the daily-challenges guide, §7,
 is the page.
-## Challenge.slug
+<a id="challenge-slug"></a>
-[Challenge.slug](https://gemarcade.com/developer/api/server#challenge-slug)
+## Challenge.slug
 ```ts
 readonly slug?: string
@@ -1254,9 +1254,9 @@ The slug from your game config, when you declared one.
 Absent means absent — the field is omitted, never `null` or `''`.
-## Challenge.window
+<a id="challenge-window"></a>
-[Challenge.window](https://gemarcade.com/developer/api/server#challenge-window)
+## Challenge.window
 ```ts
 readonly window: ChallengeWindow
@@ -1264,9 +1264,9 @@ readonly window: ChallengeWindow
 How often this challenge resets.
-## Challenge.periodStartAt
+<a id="challenge-periodstartat"></a>
-[Challenge.periodStartAt](https://gemarcade.com/developer/api/server#challenge-periodstartat)
+## Challenge.periodStartAt
 ```ts
 readonly periodStartAt: number
@@ -1278,12 +1278,12 @@ When this period began for this player, in Unix seconds.
 not a result you send your server. A `local` period begins at the player's
 own reset time, so the same date starts at a different instant in each
 time zone, and an earlier period (`periodsBack`) is computed in the zone
-the player has now. Key on [Challenge.periodLocalDate](https://gemarcade.com/developer/api/server#challenge-periodlocaldate), or on
-[Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed) for a `cron` challenge.
+the player has now. Key on [Challenge.periodLocalDate](#challenge-periodlocaldate), or on
+[Challenge.seed](#challenge-seed) for a `cron` challenge.
-## Challenge.periodEndsAt
+<a id="challenge-periodendsat"></a>
-[Challenge.periodEndsAt](https://gemarcade.com/developer/api/server#challenge-periodendsat)
+## Challenge.periodEndsAt
 ```ts
 readonly periodEndsAt: number
@@ -1292,7 +1292,7 @@ readonly periodEndsAt: number
 When this period stops accepting progress, in Unix seconds.
 **This is the seed's expiry.** After this instant the challenge is in a new
-period with a different [Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed); read `gem.challenges.list`
+period with a different [Challenge.seed](#challenge-seed); read `gem.challenges.list`
 again rather than computing the next boundary.
 ⚠️ **Comparing it against the device clock is the one place that clock
@@ -1307,9 +1307,9 @@ sent something this SDK could not read (see below), and
 fires immediately, every time — a tight poll with no backoff. A
 `Math.max(60_000, ...)` floor turns that into a slow retry.
-## Challenge.periodLocalDate
+<a id="challenge-periodlocaldate"></a>
-[Challenge.periodLocalDate](https://gemarcade.com/developer/api/server#challenge-periodlocaldate)
+## Challenge.periodLocalDate
 ```ts
 readonly periodLocalDate?: string
@@ -1319,17 +1319,17 @@ The period's calendar date, `YYYY-MM-DD`: the day for a daily, the Monday
 for a weekly, the 1st for a monthly, in the calendar the challenge runs on.
 **This is the period's identity, and what to key on** — together with
-[Challenge.id](https://gemarcade.com/developer/api/server#challenge-id), for content, a cache, or a result your server checks.
-Every player on the same date shares the same [Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed) and
+[Challenge.id](#challenge-id), for content, a cache, or a result your server checks.
+Every player on the same date shares the same [Challenge.seed](#challenge-seed) and
 the same stored content, whatever their time zone.
 Absent — never `''` or `null` — for a `cron` challenge, which has no
 calendar date, and when the platform sent no date this SDK would pass on;
-key on [Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed) then: `c.periodLocalDate ?? c.seed`.
+key on [Challenge.seed](#challenge-seed) then: `c.periodLocalDate ?? c.seed`.
-## Challenge.boundary
+<a id="challenge-boundary"></a>
-[Challenge.boundary](https://gemarcade.com/developer/api/server#challenge-boundary)
+## Challenge.boundary
 ```ts
 readonly boundary: string
@@ -1344,24 +1344,24 @@ challenge is on UTC for them.
 `''` when the platform sent something this SDK would not pass on.
-## Challenge.resetTime
+<a id="challenge-resettime"></a>
-[Challenge.resetTime](https://gemarcade.com/developer/api/server#challenge-resettime)
+## Challenge.resetTime
 ```ts
 readonly resetTime: string
 ```
-The clock time, `HH:MM` in [Challenge.boundary](https://gemarcade.com/developer/api/server#challenge-boundary)'s zone, at which a
+The clock time, `HH:MM` in [Challenge.boundary](#challenge-boundary)'s zone, at which a
 new period begins. `'00:00'` unless your game config set one, and always
 `'00:00'` for a `cron` challenge, whose periods begin when its expression
 fires.
 `''` when the platform sent something this SDK would not pass on.
-## Challenge.seed
+<a id="challenge-seed"></a>
-[Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed)
+## Challenge.seed
 ```ts
 readonly seed: string
@@ -1372,7 +1372,7 @@ The subject selector for this challenge in this period.
 Identical for every player in this game and period — **in every channel**,
 because the channel is not part of what the platform derives it from — and
 different in the next period. For a daily, weekly or monthly challenge the
-period is the [Challenge.periodLocalDate](https://gemarcade.com/developer/api/server#challenge-periodlocaldate), so players in different
+period is the [Challenge.periodLocalDate](#challenge-periodlocaldate), so players in different
 time zones share each board, each reaching it when their own period begins.
 Lowercase hex, and **a string on purpose**: JavaScript numbers are doubles,
@@ -1393,9 +1393,9 @@ agreement, not secrecy.
 a value outside the lowercase-hex contract above. It is falsy, so
 `if (today.seed)` is the guard; do not start a seeded board without one.
-## Challenge.data
+<a id="challenge-data"></a>
-[Challenge.data](https://gemarcade.com/developer/api/server#challenge-data)
+## Challenge.data
 ```ts
 readonly data?: string
@@ -1406,7 +1406,7 @@ usually JSON describing today's board — when it stored some.
 ⚠️ **It may be absent, and your game must keep working when it is.** The
 field is omitted — never `''` — when nothing is stored for this period, and
-then you fall back to [Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed) or a pool bundled with your
+then you fall back to [Challenge.seed](#challenge-seed) or a pool bundled with your
 game. Content is written ahead of time by your studio's producer (a CI job,
 a cron job, an agent, or a developer with `gemctl challenges data push`),
 and a producer's runway can run out.
@@ -1418,7 +1418,7 @@ treat a value you cannot parse the way you treat an absent one.
 period and served on every channel whose config displays that challenge —
 the same bytes on `dev` as on `release`. Content pushed to try out on `dev`
 reaches `release` players as soon as the `release` config displays the same
-challenge [Challenge.id](https://gemarcade.com/developer/api/server#challenge-id); to trial different content, give the trial
+challenge [Challenge.id](#challenge-id); to trial different content, give the trial
 challenge a different id. The player's progress on it stays per channel.
 ⚠️ **It is not authority.** Every player in the period receives the same
@@ -1428,38 +1428,38 @@ data.
 A period's content becomes readable only once that period has begun.
-## Challenge.dataHash
+<a id="challenge-datahash"></a>
-[Challenge.dataHash](https://gemarcade.com/developer/api/server#challenge-datahash)
+## Challenge.dataHash
 ```ts
 readonly dataHash?: string
 ```
-16 lowercase hex identifying [Challenge.data](https://gemarcade.com/developer/api/server#challenge-data) — present exactly when
+16 lowercase hex identifying [Challenge.data](#challenge-data) — present exactly when
 `data` is.
-**Send it with a result, together with [Challenge.periodLocalDate](https://gemarcade.com/developer/api/server#challenge-periodlocaldate)**
-— or [Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed) for a `cron` challenge, which has no date.
+**Send it with a result, together with [Challenge.periodLocalDate](#challenge-periodlocaldate)**
+— or [Challenge.seed](#challenge-seed) for a `cron` challenge, which has no date.
 A verifier reads the same period and compares hashes, which is how it
 proves the player played the content it is checking against. It changes
 only when your studio corrects a running period; clients may hold the old
 content for up to an hour afterwards, and the hash is how a verifier tells
 them apart.
-## FunctionInvokeOptions
+<a id="functioninvokeoptions"></a>
-[FunctionInvokeOptions](https://gemarcade.com/developer/api/server#functioninvokeoptions)
+## FunctionInvokeOptions
 ```ts
 interface FunctionInvokeOptions
 ```
-What [FunctionsApi.invoke](https://gemarcade.com/developer/api/server#functionsapi-invoke) takes besides the input.
+What [FunctionsApi.invoke](#functionsapi-invoke) takes besides the input.
-## FunctionInvokeOptions.signal
+<a id="functioninvokeoptions-signal"></a>
-[FunctionInvokeOptions.signal](https://gemarcade.com/developer/api/server#functioninvokeoptions-signal)
+## FunctionInvokeOptions.signal
 ```ts
 readonly signal?: AbortSignal
@@ -1467,9 +1467,9 @@ readonly signal?: AbortSignal
 Cancel the call. A call already cancelled sends nothing.
-## FunctionResult
+<a id="functionresult"></a>
-[FunctionResult](https://gemarcade.com/developer/api/server#functionresult)
+## FunctionResult
 ```ts
 interface FunctionResult
@@ -1482,9 +1482,9 @@ const result = await gem.functions.invoke({ v: 2, runId, finishMs });
 const verdict = result.json();
 ```
-## FunctionResult.bytes
+<a id="functionresult-bytes"></a>
-[FunctionResult.bytes](https://gemarcade.com/developer/api/server#functionresult-bytes)
+## FunctionResult.bytes
 ```ts
 readonly bytes: Uint8Array
@@ -1492,9 +1492,9 @@ readonly bytes: Uint8Array
 Exactly the bytes your function returned in `Ok`. Empty when it returned none.
-## FunctionResult.invocationId
+<a id="functionresult-invocationid"></a>
-[FunctionResult.invocationId](https://gemarcade.com/developer/api/server#functionresult-invocationid)
+## FunctionResult.invocationId
 ```ts
 readonly invocationId?: string
@@ -1505,9 +1505,9 @@ The platform's id for this call — what to quote when you ask about one call.
 Absent when your code cannot read it: a server bundle can, and a game page
 can only once the platform lets a page read that response header.
-## FunctionResult.text
+<a id="functionresult-text"></a>
-[FunctionResult.text](https://gemarcade.com/developer/api/server#functionresult-text)
+## FunctionResult.text
 ```ts
 text(): string
@@ -1518,9 +1518,9 @@ The answer as UTF-8 text.
 **Throws.** `TypeError` when the bytes are not valid UTF-8, rather than
   replacing what it cannot decode.
-## FunctionResult.json
+<a id="functionresult-json"></a>
-[FunctionResult.json](https://gemarcade.com/developer/api/server#functionresult-json)
+## FunctionResult.json
 ```ts
 json<T>(): T
@@ -1530,16 +1530,16 @@ The answer parsed as JSON.
 **Throws.** `SyntaxError` when the answer is not JSON — including an empty one.
-## FunctionFailure
+<a id="functionfailure"></a>
-[FunctionFailure](https://gemarcade.com/developer/api/server#functionfailure)
+## FunctionFailure
 ```ts
 type FunctionFailure = "trap" | "memory_exceeded" | "cpu_budget_exceeded" | "host_call_limit" | "output_too_large" | "argument_too_large"
 ```
 Why a call that reached your function did not finish — carried on
-[GemFunctionError.failure](https://gemarcade.com/developer/api/server#gemfunctionerror-failure).
+[GemFunctionError.failure](#gemfunctionerror-failure).
 - `trap` — a panic, an `unreachable`, an out-of-bounds access or a stack
   overflow. No stack trace comes back.
@@ -1551,9 +1551,9 @@ Why a call that reached your function did not finish — carried on
   (`log`, `call-api`, `download-link` or `upload-link`) was over the 16 MiB
   per-call limit.
-## GemFunctionError
+<a id="gemfunctionerror"></a>
-[GemFunctionError](https://gemarcade.com/developer/api/server#gemfunctionerror)
+## GemFunctionError
 ```ts
 class GemFunctionError
@@ -1562,8 +1562,8 @@ class GemFunctionError
 A call to your serverless function was refused, or your function did not
 answer.
-Thrown by [FunctionsApi.invoke](https://gemarcade.com/developer/api/server#functionsapi-invoke) for every refusal the platform sends.
-It IS a [GemApiError](https://gemarcade.com/developer/api/server#gemapierror), so `reason`, `status`, `code`, `detail` and
+Thrown by [FunctionsApi.invoke](#functionsapi-invoke) for every refusal the platform sends.
+It IS a [GemApiError](#gemapierror), so `reason`, `status`, `code`, `detail` and
 `retryAfterSeconds` mean what they mean there. Branch on `code` for what
 happened; `retryable` is decided by the code. You catch this; you never
 construct it.
@@ -1579,9 +1579,9 @@ try {
 }
 ```
-## GemFunctionError.reason
+<a id="gemfunctionerror-reason"></a>
-[GemFunctionError.reason](https://gemarcade.com/developer/api/server#gemfunctionerror-reason)
+## GemFunctionError.reason
 ```ts
 readonly reason: GemErrorReason
@@ -1594,9 +1594,9 @@ What went wrong, in terms you can act on — `invalid`, `forbidden`,
 This is the field to branch on. Two refusals can share a status and mean
 different things; they do not share a reason.
-## GemFunctionError.status
+<a id="gemfunctionerror-status"></a>
-[GemFunctionError.status](https://gemarcade.com/developer/api/server#gemfunctionerror-status)
+## GemFunctionError.status
 ```ts
 readonly status: number
@@ -1604,13 +1604,13 @@ readonly status: number
 The HTTP status the server answered with.
-Carried for logs and bug reports. Prefer [GemApiError.reason](https://gemarcade.com/developer/api/server#gemapierror-reason) for
+Carried for logs and bug reports. Prefer [GemApiError.reason](#gemapierror-reason) for
 decisions: several distinct refusals map onto one status, so branching
 here treats different problems as the same one.
-## GemFunctionError.detail
+<a id="gemfunctionerror-detail"></a>
-[GemFunctionError.detail](https://gemarcade.com/developer/api/server#gemfunctionerror-detail)
+## GemFunctionError.detail
 ```ts
 readonly detail: string
@@ -1622,9 +1622,9 @@ The server's own sentence, without the `reason (status):` prefix that
 Use this when you want to quote the platform — in a log line, or a bug
 report. It is not written for players, so do not put it on screen.
-## GemFunctionError.retryAfterSeconds
+<a id="gemfunctionerror-retryafterseconds"></a>
-[GemFunctionError.retryAfterSeconds](https://gemarcade.com/developer/api/server#gemfunctionerror-retryafterseconds)
+## GemFunctionError.retryAfterSeconds
 ```ts
 readonly retryAfterSeconds?: number
@@ -1633,15 +1633,15 @@ readonly retryAfterSeconds?: number
 How long the server asked you to wait, in whole seconds.
 ABSENT MEANS "NO ESTIMATE GIVEN", NEVER "DO NOT RETRY" —
-[GemApiError.retryable](https://gemarcade.com/developer/api/server#gemapierror-retryable) is what answers that. A refusal can be
+[GemApiError.retryable](#gemapierror-retryable) is what answers that. A refusal can be
 worth repeating and still name no wait, so treat absence as "pick your
 own backoff" rather than as a stop signal. The platform estimates a wait
 for capacity and for rate limits, and sends none for the refusals it
 cannot put a number on.
-## GemFunctionError.code
+<a id="gemfunctionerror-code"></a>
-[GemFunctionError.code](https://gemarcade.com/developer/api/server#gemfunctionerror-code)
+## GemFunctionError.code
 ```ts
 readonly code?: string
@@ -1651,7 +1651,7 @@ The platform's own error code, when it sent one —
 `too_many_concurrent_matches`, `cluster_target_required`,
 `no_compatible_server`.
-Finer-grained than [GemApiError.reason](https://gemarcade.com/developer/api/server#gemapierror-reason), and the only way to tell
+Finer-grained than [GemApiError.reason](#gemapierror-reason), and the only way to tell
 apart two refusals that share both a reason and a status. Absent on most
 refusals, so treat it as extra information rather than something to
 depend on.
@@ -1662,20 +1662,20 @@ refusals carry the platform's purchase codes — `insufficient_funds`,
 strings `gem.purchases.request` answers as its `reason`, so one `switch`
 on `err.code` covers both purchase paths.
-## GemFunctionError.invocationId
+<a id="gemfunctionerror-invocationid"></a>
-[GemFunctionError.invocationId](https://gemarcade.com/developer/api/server#gemfunctionerror-invocationid)
+## GemFunctionError.invocationId
 ```ts
 readonly invocationId?: string
 ```
 The platform's id for the invocation, when the call became one and your
-code can read the id. See [FunctionResult.invocationId](https://gemarcade.com/developer/api/server#functionresult-invocationid).
+code can read the id. See [FunctionResult.invocationId](#functionresult-invocationid).
-## GemFunctionError.functionMessage
+<a id="gemfunctionerror-functionmessage"></a>
-[GemFunctionError.functionMessage](https://gemarcade.com/developer/api/server#gemfunctionerror-functionmessage)
+## GemFunctionError.functionMessage
 ```ts
 readonly functionMessage?: string
@@ -1686,21 +1686,21 @@ The text your function returned in `Err`, on `code` `function_error`.
 Written by your function, which may have repeated what the caller sent, so
 treat it as untrusted: log it, never render it as markup.
-## GemFunctionError.failure
+<a id="gemfunctionerror-failure"></a>
-[GemFunctionError.failure](https://gemarcade.com/developer/api/server#gemfunctionerror-failure)
+## GemFunctionError.failure
 ```ts
 readonly failure?: string & object | FunctionFailure
 ```
 On `code` `function_failed`, which limit or fault ended the call. See
-[FunctionFailure](https://gemarcade.com/developer/api/server#functionfailure). A value this SDK does not know yet arrives as the
+[FunctionFailure](#functionfailure). A value this SDK does not know yet arrives as the
 platform sent it.
-## GemFunctionError.retryable
+<a id="gemfunctionerror-retryable"></a>
-[GemFunctionError.retryable](https://gemarcade.com/developer/api/server#gemfunctionerror-retryable)
+## GemFunctionError.retryable
 ```ts
 get retryable(): boolean
@@ -1715,9 +1715,9 @@ when the function ran — `function_error`, `function_failed`,
 nothing published, input too large, functions switched off. A lost
 connection is `retryable` too, but your function may have run.
-## FunctionsApi
+<a id="functionsapi"></a>
-[FunctionsApi](https://gemarcade.com/developer/api/server#functionsapi)
+## FunctionsApi
 ```ts
 class FunctionsApi
@@ -1726,9 +1726,9 @@ class FunctionsApi
 Your game's serverless function. Reached as `gem.functions`, in the browser
 and in a server bundle.
-## FunctionsApi.invoke
+<a id="functionsapi-invoke"></a>
-[FunctionsApi.invoke](https://gemarcade.com/developer/api/server#functionsapi-invoke)
+## FunctionsApi.invoke
 ```ts
 invoke(input: unknown, options?: FunctionInvokeOptions): Promise<FunctionResult>
@@ -1742,7 +1742,7 @@ are. Pass anything else and it is sent as its JSON text — a string too, so
 `'ping'` arrives as `"ping"` with its quotes.
 The call is made once. It is never repeated for you, because your function
-may have granted or written something: see [GemFunctionError.retryable](https://gemarcade.com/developer/api/server#gemfunctionerror-retryable)
+may have granted or written something: see [GemFunctionError.retryable](#gemfunctionerror-retryable)
 for whether repeating it could help.
 ```js
@@ -1755,13 +1755,13 @@ const { accepted, why } = result.json();
 | `input` | `unknown` | Bytes, or a value to send as JSON. |
 | `options` | `FunctionInvokeOptions` |  |
-**Throws.** [GemFunctionError](https://gemarcade.com/developer/api/server#gemfunctionerror) for a refusal, including your function's
+**Throws.** [GemFunctionError](#gemfunctionerror) for a refusal, including your function's
   own `Err`. `TransportRefusal` for an input that is neither bytes nor
   JSON, before anything is sent. `AuthError` if the token cannot be renewed.
-## Clock
+<a id="clock"></a>
-[Clock](https://gemarcade.com/developer/api/server#clock)
+## Clock
 ```ts
 interface Clock
@@ -1773,7 +1773,7 @@ Credential refresh, retry backoff and timeouts are all wall-clock behaviour.
 A test that has to wait ten real seconds to prove a timeout fires is a test
 nobody runs, so every SDK option that involves time takes one of these.
-Pass [systemClock](https://gemarcade.com/developer/api/server#systemclock) — or nothing, which means the same — to use real
+Pass [systemClock](#systemclock) — or nothing, which means the same — to use real
 time. Pass your own to control it.
 ```js
@@ -1787,9 +1787,9 @@ const clock = {
 // advance time yourself, and run whatever is due
 ```
-## Clock.now
+<a id="clock-now"></a>
-[Clock.now](https://gemarcade.com/developer/api/server#clock-now)
+## Clock.now
 ```ts
 now(): number
@@ -1797,52 +1797,52 @@ now(): number
 The current time, in milliseconds — the same scale as `Date.now()`.
-## Clock.setTimeout
+<a id="clock-settimeout"></a>
-[Clock.setTimeout](https://gemarcade.com/developer/api/server#clock-settimeout)
+## Clock.setTimeout
 ```ts
 setTimeout(fn: () => void, ms: number): unknown
 ```
 Run `fn` after `ms` milliseconds. Return whatever identifies it; the SDK
-only ever hands that value back to [Clock.clearTimeout](https://gemarcade.com/developer/api/server#clock-cleartimeout).
+only ever hands that value back to [Clock.clearTimeout](#clock-cleartimeout).
 | Parameter | Type |
 | --- | --- |
 | `fn` | `() => void` |
 | `ms` | `number` |
-## Clock.clearTimeout
+<a id="clock-cleartimeout"></a>
-[Clock.clearTimeout](https://gemarcade.com/developer/api/server#clock-cleartimeout)
+## Clock.clearTimeout
 ```ts
 clearTimeout(handle: unknown): void
 ```
-Cancel a timer created by [Clock.setTimeout](https://gemarcade.com/developer/api/server#clock-settimeout).
+Cancel a timer created by [Clock.setTimeout](#clock-settimeout).
 | Parameter | Type |
 | --- | --- |
 | `handle` | `unknown` |
-## systemClock
+<a id="systemclock"></a>
-[systemClock](https://gemarcade.com/developer/api/server#systemclock)
+## systemClock
 ```ts
 systemClock: Clock
 ```
-Real time — the [Clock](https://gemarcade.com/developer/api/server#clock) every SDK option defaults to.
+Real time — the [Clock](#clock) every SDK option defaults to.
 Name it when you want to be explicit, or wrap it when you want to watch what
 the SDK schedules without replacing the clock entirely.
-## defineServer
+<a id="defineserver"></a>
-[defineServer](https://gemarcade.com/developer/api/server#defineserver)
+## defineServer
 ```ts
 function defineServer(setup: (gem: GemMatchServer) => GemServerBundle, options?: GemServerOptions): GemServerFactory
@@ -1850,7 +1850,7 @@ function defineServer(setup: (gem: GemMatchServer) => GemServerBundle, options?:
 Declare your dedicated server. Default-export the result.
-You pass a setup function; it receives a [GemMatchServer](https://gemarcade.com/developer/api/server#gemmatchserver) — the platform
+You pass a setup function; it receives a [GemMatchServer](#gemmatchserver) — the platform
 operations, your room, your players — and returns the handlers you want. The
 credential and its refresh are handled for you, and the SDK is disposed when
 the match ends.
@@ -1866,8 +1866,8 @@ a broken handler quietly serving nobody is worse than one that stops.
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `setup` | `(gem: GemMatchServer) => GemServerBundle` | Called once. Return the handlers you want from
-  [GemServerBundle](https://gemarcade.com/developer/api/server#gemserverbundle); omit the rest. |
-| `options` | `GemServerOptions` | Passed through to [createGemServer](https://gemarcade.com/developer/api/server#creategemserver). Normally omit it. |
+  [GemServerBundle](#gemserverbundle); omit the rest. |
+| `options` | `GemServerOptions` | Passed through to [createGemServer](#creategemserver). Normally omit it. |
 **Returns.** The value to default-export from your bundle's entry file.
@@ -1891,11 +1891,11 @@ export default defineServer((gem) => {
 });
 ```
-**Guides.** [server-bundles](https://gemarcade.com/developer/docs/server-bundles)
+**Guides.** [server-bundles](../server-bundles.md)
-## createMatchServer
+<a id="creatematchserver"></a>
-[createMatchServer](https://gemarcade.com/developer/api/server#creatematchserver)
+## createMatchServer
 ```ts
 function createMatchServer(host: GemServerHost, options?: GemServerOptions): GemMatchServer
@@ -1903,7 +1903,7 @@ function createMatchServer(host: GemServerHost, options?: GemServerOptions): Gem
 Build the `gem` object yourself, when you are driving the lifecycle by hand.
-MOST BUNDLES WANT [defineServer](https://gemarcade.com/developer/api/server#defineserver), which calls this for you and wires up
+MOST BUNDLES WANT [defineServer](#defineserver), which calls this for you and wires up
 your handlers. Use this one if you are writing the lifecycle object directly.
 CALL IT FROM `init`, not at module scope — it needs the host, and it builds
@@ -1914,7 +1914,7 @@ is too old" into a startup failure rather than a surprise mid-match. Call
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `host` | `GemServerHost` | The object the runtime passed to `init`. |
-| `options` | `GemServerOptions` | Passed through to [createGemServer](https://gemarcade.com/developer/api/server#creategemserver). Normally omit it. |
+| `options` | `GemServerOptions` | Passed through to [createGemServer](#creategemserver). Normally omit it. |
 **Throws.** When the runtime named no API host, so no call could succeed.
@@ -1931,9 +1931,9 @@ export default () => {
 };
 ```
-## createGemServer
+<a id="creategemserver"></a>
-[createGemServer](https://gemarcade.com/developer/api/server#creategemserver)
+## createGemServer
 ```ts
 function createGemServer(host: ServerBundleHost, options?: GemServerOptions): GemServer
@@ -1942,11 +1942,11 @@ function createGemServer(host: ServerBundleHost, options?: GemServerOptions): Ge
 Build your server's connection to the platform. Call it once, in `init(host)`.
 Pass the `host` object the runtime handed you and you get back a
-[GemServer](https://gemarcade.com/developer/api/server#gemserver): the platform operations, the room reads for your own room,
+[GemServer](#gemserver): the platform operations, the room reads for your own room,
 and a way to end the match. The credential is taken from the host and kept
 fresh for you.
-MOST BUNDLES DO NOT CALL THIS. [defineServer](https://gemarcade.com/developer/api/server#defineserver) does it for you and hands
+MOST BUNDLES DO NOT CALL THIS. [defineServer](#defineserver) does it for you and hands
 you the result. Reach for it directly when you are managing the lifecycle
 yourself.
@@ -1957,7 +1957,7 @@ platform is worse than one that refuses to start.
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `host` | `ServerBundleHost` | The object the runtime passes to `init`. |
-| `options` | `GemServerOptions` | See [GemServerOptions](https://gemarcade.com/developer/api/server#gemserveroptions) — normally omit it. |
+| `options` | `GemServerOptions` | See [GemServerOptions](#gemserveroptions) — normally omit it. |
 **Throws.** When the runtime named no API host, so no call could succeed.
@@ -1971,11 +1971,11 @@ export async function init(host) {
 }
 ```
-**Guides.** [server-bundles](https://gemarcade.com/developer/docs/server-bundles)
+**Guides.** [server-bundles](../server-bundles.md)
-## createHostTokenSource
+<a id="createhosttokensource"></a>
-[createHostTokenSource](https://gemarcade.com/developer/api/server#createhosttokensource)
+## createHostTokenSource
 ```ts
 function createHostTokenSource(host: ServerBundleHost, options: HostTokenSourceOptions): HostTokenSource
@@ -1983,7 +1983,7 @@ function createHostTokenSource(host: ServerBundleHost, options: HostTokenSourceO
 Keep the platform credential fresh, without building the rest of the SDK.
-MOST BUNDLES NEVER CALL THIS. [createGemServer](https://gemarcade.com/developer/api/server#creategemserver) does it, and hands you a
+MOST BUNDLES NEVER CALL THIS. [createGemServer](#creategemserver) does it, and hands you a
 client that is already authenticated. Reach for it when you are assembling
 the pieces yourself.
@@ -1994,13 +1994,13 @@ after the match is over.
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `host` | `ServerBundleHost` | The object the runtime passed to `init`. |
-| `options` | `HostTokenSourceOptions` | See [HostTokenSourceOptions](https://gemarcade.com/developer/api/server#hosttokensourceoptions) — `clock` is required. |
+| `options` | `HostTokenSourceOptions` | See [HostTokenSourceOptions](#hosttokensourceoptions) — `clock` is required. |
-**Returns.** Something you can stop. See [HostTokenSource](https://gemarcade.com/developer/api/server#hosttokensource).
+**Returns.** Something you can stop. See [HostTokenSource](#hosttokensource).
-## achievementReceipts
+<a id="achievementreceipts"></a>
-[achievementReceipts](https://gemarcade.com/developer/api/server#achievementreceipts)
+## achievementReceipts
 ```ts
 function achievementReceipts(order: unknown): AchievementReceipt[]
@@ -2035,11 +2035,11 @@ for (const r of achievementReceipts(order)) {
 }
 ```
-**Guides.** [achievements](https://gemarcade.com/developer/docs/achievements)
+**Guides.** [achievements](../achievements.md)
-## AchievementReceipt
+<a id="achievementreceipt"></a>
-[AchievementReceipt](https://gemarcade.com/developer/api/server#achievementreceipt)
+## AchievementReceipt
 ```ts
 interface AchievementReceipt
@@ -2047,11 +2047,11 @@ interface AchievementReceipt
 What became of one achievement an order reached.
-**Guides.** [achievements](https://gemarcade.com/developer/docs/achievements)
+**Guides.** [achievements](../achievements.md)
-## GemMatchServer
+<a id="gemmatchserver"></a>
-[GemMatchServer](https://gemarcade.com/developer/api/server#gemmatchserver)
+## GemMatchServer
 ```ts
 interface GemMatchServer
@@ -2060,8 +2060,8 @@ interface GemMatchServer
 The `gem` your bundle holds — everything a dedicated server can do, on one
 object.
-This is what [defineServer](https://gemarcade.com/developer/api/server#defineserver) hands your setup function. It is a
-[GemServer](https://gemarcade.com/developer/api/server#gemserver) — the platform operations, your room, ending the match —
+This is what [defineServer](#defineserver) hands your setup function. It is a
+[GemServer](#gemserver) — the platform operations, your room, ending the match —
 with the match surface added: the players connected right now, and how to talk
 to them.
@@ -2078,9 +2078,9 @@ export default defineServer((gem) => ({
 }));
 ```
-## GemServerBundle
+<a id="gemserverbundle"></a>
-[GemServerBundle](https://gemarcade.com/developer/api/server#gemserverbundle)
+## GemServerBundle
 ```ts
 interface GemServerBundle
@@ -2089,7 +2089,7 @@ interface GemServerBundle
 The five things that can happen to your server. Define the ones you care
 about; each may be `async` and is awaited before the next event arrives.
-This is what your setup function returns — see [defineServer](https://gemarcade.com/developer/api/server#defineserver). Events
+This is what your setup function returns — see [defineServer](#defineserver). Events
 are delivered one at a time, in order, so you never handle two at once and do
 not need locking around your own state.
@@ -2107,30 +2107,30 @@ export default defineServer((gem) => {
 });
 ```
-## GemServerFactory
+<a id="gemserverfactory"></a>
-[GemServerFactory](https://gemarcade.com/developer/api/server#gemserverfactory)
+## GemServerFactory
 ```ts
 type GemServerFactory = () => GemServerLifecycle
 ```
-The type of your bundle's default export — what [defineServer](https://gemarcade.com/developer/api/server#defineserver) returns.
+The type of your bundle's default export — what [defineServer](#defineserver) returns.
 The platform calls it once, at the start of a match.
-## GemServerLifecycle
+<a id="gemserverlifecycle"></a>
-[GemServerLifecycle](https://gemarcade.com/developer/api/server#gemserverlifecycle)
+## GemServerLifecycle
 ```ts
 interface GemServerLifecycle
 ```
-What the platform actually calls — a [GemServerBundle](https://gemarcade.com/developer/api/server#gemserverbundle) after the SDK has
+What the platform actually calls — a [GemServerBundle](#gemserverbundle) after the SDK has
 wrapped it.
-YOU DO NOT WRITE ONE. [defineServer](https://gemarcade.com/developer/api/server#defineserver) produces it from your bundle. It is
+YOU DO NOT WRITE ONE. [defineServer](#defineserver) produces it from your bundle. It is
 named here so you can type a variable holding the result, and so the shape the
 platform drives is written down somewhere a reader can find it.
@@ -2138,9 +2138,9 @@ platform drives is written down somewhere a reader can find it.
 bundle: the SDK always defines them, to receive the host and to release the
 credential subscription when the match is over.
-## RuntimeShutdownPayload
+<a id="runtimeshutdownpayload"></a>
-[RuntimeShutdownPayload](https://gemarcade.com/developer/api/server#runtimeshutdownpayload)
+## RuntimeShutdownPayload
 ```ts
 interface RuntimeShutdownPayload
@@ -2151,9 +2151,9 @@ What the platform runtime hands `shutdown`, on images that say why.
 Either spelling of the platform reason is accepted: the runtime's wire
 name (`platform_reason`) and the SDK's (`endedReason`).
-## ServerShutdownInfo
+<a id="servershutdowninfo"></a>
-[ServerShutdownInfo](https://gemarcade.com/developer/api/server#servershutdowninfo)
+## ServerShutdownInfo
 ```ts
 interface ServerShutdownInfo
@@ -2181,9 +2181,9 @@ nothing).
 OPEN: a later runtime may add a value. Treat one you do not recognise as
 "the match is over", which is the safe reading.
-## GemServerProfile
+<a id="gemserverprofile"></a>
-[GemServerProfile](https://gemarcade.com/developer/api/server#gemserverprofile)
+## GemServerProfile
 ```ts
 interface GemServerProfile
@@ -2191,22 +2191,22 @@ interface GemServerProfile
 Who a player is, for display. Safe to hold; think before you relay it.
-Returned by [GemMatchServer.profile](https://gemarcade.com/developer/api/server#gemmatchserver-profile).
+Returned by [GemMatchServer.profile](#gemmatchserver-profile).
 RELAY THE ID, NOT THE NAME. Sending player ids to your clients and letting
 each one render the name it already has is better than broadcasting names
 through your server: it is less to send, and it keeps one player's text from
 reaching every other player's screen through you.
-## GemServer
+<a id="gemserver"></a>
-[GemServer](https://gemarcade.com/developer/api/server#gemserver)
+## GemServer
 ```ts
 interface GemServer
 ```
-Your server's connection to the platform — what [createGemServer](https://gemarcade.com/developer/api/server#creategemserver)
+Your server's connection to the platform — what [createGemServer](#creategemserver)
 returns.
 Build one in `init(host)`, keep it, and call through it for the life of the
@@ -2227,9 +2227,9 @@ export default defineServer((gem) => ({
 }));
 ```
-## GemServerIdentity
+<a id="gemserveridentity"></a>
-[GemServerIdentity](https://gemarcade.com/developer/api/server#gemserveridentity)
+## GemServerIdentity
 ```ts
 interface GemServerIdentity
@@ -2238,29 +2238,29 @@ interface GemServerIdentity
 Which game, channel and match this server was started for.
 You never construct one. The platform decides all of it when it allocates the
-server, and [GemServer.identity](https://gemarcade.com/developer/api/server#gemserver-identity) is it restated in one place so you do
+server, and [GemServer.identity](#gemserver-identity) is it restated in one place so you do
 not have to keep reaching back to the host object.
 These are also the ids bound into every call `api` makes, which is why a
 bundle never types a game id and cannot name another game's.
-## GemServerOptions
+<a id="gemserveroptions"></a>
-[GemServerOptions](https://gemarcade.com/developer/api/server#gemserveroptions)
+## GemServerOptions
 ```ts
 interface GemServerOptions
 ```
-Options for [createGemServer](https://gemarcade.com/developer/api/server#creategemserver). Every one is optional, and a bundle
+Options for [createGemServer](#creategemserver). Every one is optional, and a bundle
 running on the platform normally passes none.
 They exist for the two cases the platform does not cover: pointing a bundle at
 something other than the API the platform named, and running it in a test.
-## ServerApi
+<a id="serverapi"></a>
-[ServerApi](https://gemarcade.com/developer/api/server#serverapi)
+## ServerApi
 ```ts
 type ServerApi = unknown
@@ -2281,11 +2281,11 @@ The operation list moves with the platform. An operation added to your game's
 API appears here without this package changing, and one that is withdrawn
 stops type-checking rather than failing at runtime.
-**Guides.** [server-bundles](https://gemarcade.com/developer/docs/server-bundles)
+**Guides.** [server-bundles](../server-bundles.md)
-## ServerBundleHost
+<a id="serverbundlehost"></a>
-[ServerBundleHost](https://gemarcade.com/developer/api/server#serverbundlehost)
+## ServerBundleHost
 ```ts
 interface ServerBundleHost
@@ -2294,13 +2294,13 @@ interface ServerBundleHost
 The part of the host object that identifies the match and carries the
 credential.
-This is what [createGemServer](https://gemarcade.com/developer/api/server#creategemserver) needs, and nothing more — which is also
+This is what [createGemServer](#creategemserver) needs, and nothing more — which is also
 what makes it easy to stand up in a test: four members instead of the whole
-host. [GemServerHost](https://gemarcade.com/developer/api/server#gemserverhost) is the same object at full width.
+host. [GemServerHost](#gemserverhost) is the same object at full width.
-## ServerTokenGrant
+<a id="servertokengrant"></a>
-[ServerTokenGrant](https://gemarcade.com/developer/api/server#servertokengrant)
+## ServerTokenGrant
 ```ts
 interface ServerTokenGrant
@@ -2308,26 +2308,26 @@ interface ServerTokenGrant
 A credential the platform handed your server, and when it stops working.
-You do not normally touch one. [createGemServer](https://gemarcade.com/developer/api/server#creategemserver) takes the credential
+You do not normally touch one. [createGemServer](#creategemserver) takes the credential
 from the host and refreshes it for you; this type is here for a bundle wiring
 the pieces up itself.
-## HostTokenSource
+<a id="hosttokensource"></a>
-[HostTokenSource](https://gemarcade.com/developer/api/server#hosttokensource)
+## HostTokenSource
 ```ts
 interface HostTokenSource
 ```
-A credential subscription — what [createHostTokenSource](https://gemarcade.com/developer/api/server#createhosttokensource) gives back.
+A credential subscription — what [createHostTokenSource](#createhosttokensource) gives back.
 Deliberately narrow: the only thing you can do with it is stop it. The
 credential itself is not reachable, because nothing you can call takes one.
-## GemServerHost
+<a id="gemserverhost"></a>
-[GemServerHost](https://gemarcade.com/developer/api/server#gemserverhost)
+## GemServerHost
 ```ts
 interface GemServerHost
@@ -2335,7 +2335,7 @@ interface GemServerHost
 The whole `host` object, as the runtime passes it to your bundle.
-[ServerBundleHost](https://gemarcade.com/developer/api/server#serverbundlehost) is its credential half; everything added here is the
+[ServerBundleHost](#serverbundlehost) is its credential half; everything added here is the
 match — who is connected, what they sent, and how to answer.
 SEVERAL MEMBERS ARE OPTIONAL BECAUSE THE PLATFORM IMAGE MAY BE OLDER than the
@@ -2343,12 +2343,12 @@ member. There is no version to ask for; presence is the signal. Check before
 calling, and your bundle keeps running on every image rather than only the
 newest.
-A bundle written with [defineServer](https://gemarcade.com/developer/api/server#defineserver) usually reads [GemMatchServer](https://gemarcade.com/developer/api/server#gemmatchserver)
+A bundle written with [defineServer](#defineserver) usually reads [GemMatchServer](#gemmatchserver)
 instead, which wraps this.
-## GemServerHostProfile
+<a id="gemserverhostprofile"></a>
-[GemServerHostProfile](https://gemarcade.com/developer/api/server#gemserverhostprofile)
+## GemServerHostProfile
 ```ts
 interface GemServerHostProfile
@@ -2359,12 +2359,12 @@ A player's display identity, as the platform resolved it for your server.
 EVERY FIELD IS OPTIONAL. The platform may not have all of them for a given
 player, and that is not an error — fall back to something of your own.
-[GemMatchServer.profile](https://gemarcade.com/developer/api/server#gemmatchserver-profile) is the version you usually want: same
-information, with the name typed as [PlayerText](https://gemarcade.com/developer/api/server#playertext).
+[GemMatchServer.profile](#gemmatchserver-profile) is the version you usually want: same
+information, with the name typed as [PlayerText](#playertext).
-## SendOptions
+<a id="sendoptions"></a>
-[SendOptions](https://gemarcade.com/developer/api/server#sendoptions)
+## SendOptions
 ```ts
 interface SendOptions
@@ -2377,32 +2377,32 @@ unreliable message reliably anyway, and it never does the reverse. What you
 asked for is carried to the receiver either way, so they can tell the
 difference.
-## BroadcastOptions
+<a id="broadcastoptions"></a>
-[BroadcastOptions](https://gemarcade.com/developer/api/server#broadcastoptions)
+## BroadcastOptions
 ```ts
 interface BroadcastOptions
 ```
-The same delivery choices as [SendOptions](https://gemarcade.com/developer/api/server#sendoptions), plus who to skip.
+The same delivery choices as [SendOptions](#sendoptions), plus who to skip.
-## HostTokenSourceOptions
+<a id="hosttokensourceoptions"></a>
-[HostTokenSourceOptions](https://gemarcade.com/developer/api/server#hosttokensourceoptions)
+## HostTokenSourceOptions
 ```ts
 interface HostTokenSourceOptions
 ```
-Options for [createHostTokenSource](https://gemarcade.com/developer/api/server#createhosttokensource).
+Options for [createHostTokenSource](#createhosttokensource).
 You need these only if you are wiring the credential up yourself.
-[createGemServer](https://gemarcade.com/developer/api/server#creategemserver) does it for you.
+[createGemServer](#creategemserver) does it for you.
-## RoomArgValue
+<a id="roomargvalue"></a>
-[RoomArgValue](https://gemarcade.com/developer/api/server#roomargvalue)
+## RoomArgValue
 ```ts
 type RoomArgValue = string | number | boolean | readonly string[] | readonly number[] | readonly boolean[]
@@ -2417,11 +2417,11 @@ room may be created with, already type-checked by the platform before the
 match was allocated — so a bundle reading settings does not need to validate
 them again.
-**Guides.** [rooms-and-matches](https://gemarcade.com/developer/docs/rooms-and-matches)
+**Guides.** [rooms-and-matches](../rooms-and-matches.md)
-## ServerAnalytics
+<a id="serveranalytics"></a>
-[ServerAnalytics](https://gemarcade.com/developer/api/server#serveranalytics)
+## ServerAnalytics
 ```ts
 interface ServerAnalytics
@@ -2430,9 +2430,9 @@ interface ServerAnalytics
 Your server's analytics — the events you declared in your game config,
 attributed to the player they are about.
-Reached as `gem.analytics`. [ServerAnalytics.track](https://gemarcade.com/developer/api/server#serveranalytics-track) is synchronous and
+Reached as `gem.analytics`. [ServerAnalytics.track](#serveranalytics-track) is synchronous and
 never throws: it queues, and the queue goes out on a timer, at fifty events,
-and whenever you call [ServerAnalytics.flush](https://gemarcade.com/developer/api/server#serveranalytics-flush).
+and whenever you call [ServerAnalytics.flush](#serveranalytics-flush).
 ⚠️ **Flush before your match ends.** A dedicated server is torn down when the
 match is over and nothing gets a last word in for it — there is no `pagehide`
@@ -2447,11 +2447,11 @@ export default defineServer((gem) => ({
 }));
 ```
-**Guides.** [analytics](https://gemarcade.com/developer/docs/analytics)
+**Guides.** [analytics](../analytics.md)
-## ServerAnalytics.track
+<a id="serveranalytics-track"></a>
-[ServerAnalytics.track](https://gemarcade.com/developer/api/server#serveranalytics-track)
+## ServerAnalytics.track
 ```ts
 track(playerId: string, name: string, props?: Readonly<Record<string, AnalyticsValue>>): void
@@ -2477,9 +2477,9 @@ events are client-sourced, so one emitted here would be refused
 | `name` | `string` | A declared event id — an `id` from your `analytics_events`. |
 | `props` | `Readonly<Record<string, AnalyticsValue>>` | Dimensions (strings) and measures (numbers). |
-## ServerAnalytics.flush
+<a id="serveranalytics-flush"></a>
-[ServerAnalytics.flush](https://gemarcade.com/developer/api/server#serveranalytics-flush)
+## ServerAnalytics.flush
 ```ts
 flush(signal?: AbortSignal): Promise<AnalyticsFlushResult>
@@ -2496,9 +2496,9 @@ discards the batch, because resending it can only fail the same way.
 | --- | --- | --- |
 | `signal` | `AbortSignal` | Cancels the call — not the queue. |
-## ServerAnalytics.pending
+<a id="serveranalytics-pending"></a>
-[ServerAnalytics.pending](https://gemarcade.com/developer/api/server#serveranalytics-pending)
+## ServerAnalytics.pending
 ```ts
 readonly pending: number
@@ -2506,19 +2506,19 @@ readonly pending: number
 How many events are waiting to go out.
-## ServerListChallengesOptions
+<a id="serverlistchallengesoptions"></a>
-[ServerListChallengesOptions](https://gemarcade.com/developer/api/server#serverlistchallengesoptions)
+## ServerListChallengesOptions
 ```ts
 interface ServerListChallengesOptions
 ```
-Options for [ServerChallenges.list](https://gemarcade.com/developer/api/server#serverchallenges-list).
+Options for [ServerChallenges.list](#serverchallenges-list).
-## ServerListChallengesOptions.playerId
+<a id="serverlistchallengesoptions-playerid"></a>
-[ServerListChallengesOptions.playerId](https://gemarcade.com/developer/api/server#serverlistchallengesoptions-playerid)
+## ServerListChallengesOptions.playerId
 ```ts
 readonly playerId: string
@@ -2530,9 +2530,9 @@ Take it from `join()` or `gem.players()`, never from something a client
 sent you. The platform answers only for a player who plays your game or is
 in it now, and refuses anyone else with `not_found`.
-## ServerListChallengesOptions.periodsBack
+<a id="serverlistchallengesoptions-periodsback"></a>
-[ServerListChallengesOptions.periodsBack](https://gemarcade.com/developer/api/server#serverlistchallengesoptions-periodsback)
+## ServerListChallengesOptions.periodsBack
 ```ts
 readonly periodsBack?: number
@@ -2548,9 +2548,9 @@ player finished just before their day rolled over.
 An integer from 0 to 400. Anything else is a `TypeError` before the
 request is made.
-## ServerListChallengesOptions.signal
+<a id="serverlistchallengesoptions-signal"></a>
-[ServerListChallengesOptions.signal](https://gemarcade.com/developer/api/server#serverlistchallengesoptions-signal)
+## ServerListChallengesOptions.signal
 ```ts
 readonly signal?: AbortSignal
@@ -2558,9 +2558,9 @@ readonly signal?: AbortSignal
 Abort the request.
-## ServerChallenges
+<a id="serverchallenges"></a>
-[ServerChallenges](https://gemarcade.com/developer/api/server#serverchallenges)
+## ServerChallenges
 ```ts
 interface ServerChallenges
@@ -2573,7 +2573,7 @@ result against.
 Reached as `gem.challenges`. The browser's `gem.challenges.list()` answers
 for the player holding the token; a server holds no player, so this one
 takes the player's id. Everything else is the same read, and each entry is
-the same [Challenge](https://gemarcade.com/developer/api/server#challenge).
+the same [Challenge](#challenge).
 ```js
 export default defineServer((gem) => ({
@@ -2596,9 +2596,9 @@ export default defineServer((gem) => ({
 }));
 ```
-## ServerChallenges.list
+<a id="serverchallenges-list"></a>
-[ServerChallenges.list](https://gemarcade.com/developer/api/server#serverchallenges-list)
+## ServerChallenges.list
 ```ts
 list(options: ServerListChallengesOptions): Promise<Challenge[]>
@@ -2610,8 +2610,8 @@ Every challenge your config declares, for one player, for one period.
 player's day ends at their own midnight, so the date and the seed you hold
 for one player are not another player's, and "today" on the machine this
 runs on is neither. Ask per player, and match on
-[Challenge.periodLocalDate](https://gemarcade.com/developer/api/server#challenge-periodlocaldate) — or [Challenge.seed](https://gemarcade.com/developer/api/server#challenge-seed) for a
-`cron` challenge — never on [Challenge.periodStartAt](https://gemarcade.com/developer/api/server#challenge-periodstartat).
+[Challenge.periodLocalDate](#challenge-periodlocaldate) — or [Challenge.seed](#challenge-seed) for a
+`cron` challenge — never on [Challenge.periodStartAt](#challenge-periodstartat).
 | Parameter | Type |
 | --- | --- |
@@ -2623,9 +2623,9 @@ runs on is neither. Ask per player, and match on
 `GemApiError` with `reason: 'not_found'` for a player who neither
   plays your game nor is in it now, and for a channel with no config.
-## GameApi
+<a id="gameapi"></a>
-[GameApi](https://gemarcade.com/developer/api/server#gameapi)
+## GameApi
 ```ts
 interface GameApi
@@ -2644,9 +2644,9 @@ the platform has issued a credential, which happens after the client exists.
 It is never something a caller passes: a bundle cannot address another
 game's data because it never types a game id, in a path or in a query.
-## GameApi.client
+<a id="gameapi-client"></a>
-[GameApi.client](https://gemarcade.com/developer/api/server#gameapi-client)
+## GameApi.client
 ```ts
 readonly client: GemClient
@@ -2654,9 +2654,9 @@ readonly client: GemClient
 The client every operation sends through.
-## GameApi.gameId
+<a id="gameapi-gameid"></a>
-[GameApi.gameId](https://gemarcade.com/developer/api/server#gameapi-gameid)
+## GameApi.gameId
 ```ts
 gameId(): string
@@ -2664,9 +2664,9 @@ gameId(): string
 The game this server is running — taken from its credential.
-## PlayerText
+<a id="playertext"></a>
-[PlayerText](https://gemarcade.com/developer/api/server#playertext)
+## PlayerText
 ```ts
 class PlayerText
@@ -2689,12 +2689,12 @@ const name = text.toPlain(profile.displayName);
 label.textContent = name;
 ```
-To sort names, use [text.compare](https://gemarcade.com/developer/api/server#text-compare) rather than converting first — it is
+To sort names, use [text.compare](#text-compare) rather than converting first — it is
 locale-aware, which a plain `<` comparison is not.
-## PlayerText.toString
+<a id="playertext-tostring"></a>
-[PlayerText.toString](https://gemarcade.com/developer/api/server#playertext-tostring)
+## PlayerText.toString
 ```ts
 toString(): string
@@ -2710,9 +2710,9 @@ alternative was shipping an unescaped player name.
 from the package — `import { text } from '@indiegems/gem-web-sdk/sdk';` —
 not reached from your `gem` instance. Follow that rather than the message.
-## PlayerText.toJSON
+<a id="playertext-tojson"></a>
-[PlayerText.toJSON](https://gemarcade.com/developer/api/server#playertext-tojson)
+## PlayerText.toJSON
 ```ts
 toJSON(): string
@@ -2721,18 +2721,18 @@ toJSON(): string
 The same sentinel, so putting a player name into a save blob or a telemetry
 payload cannot silently store unescaped text.
-Convert with [text.toPlain](https://gemarcade.com/developer/api/server#text-toplain) before serialising anything you intend to
+Convert with [text.toPlain](#text-toplain) before serialising anything you intend to
 keep.
-## text
+<a id="text"></a>
-[text](https://gemarcade.com/developer/api/server#text)
+## text
 ```ts
 text: { toPlain: null; compare: null; equals: null }
 ```
-The only ways out of [PlayerText](https://gemarcade.com/developer/api/server#playertext).
+The only ways out of [PlayerText](#playertext).
 Imported from the package rather than reached from `gem`:
 `import { text } from '@indiegems/gem-web-sdk/sdk';`
@@ -2761,9 +2761,9 @@ lands — safe in element text and quoted attributes, unsafe in URL, style and
 script contexts — and your framework already escapes. One unambiguous
 function beats two where one carries a caveat.
-## text.toPlain
+<a id="text-toplain"></a>
-[text.toPlain](https://gemarcade.com/developer/api/server#text-toplain)
+## text.toPlain
 ```ts
 toPlain(t: PlayerText): string
@@ -2787,9 +2787,9 @@ your framework escape, which is what it already does.
 | --- | --- |
 | `t` | `PlayerText` |
-## text.compare
+<a id="text-compare"></a>
-[text.compare](https://gemarcade.com/developer/api/server#text-compare)
+## text.compare
 ```ts
 compare(a: string | PlayerText, b: string | PlayerText, locale?: string): number
@@ -2816,9 +2816,9 @@ throw here would take the whole sort down with it.
 | `b` | `string \| PlayerText` |
 | `locale` | `string` |
-## text.equals
+<a id="text-equals"></a>
-[text.equals](https://gemarcade.com/developer/api/server#text-equals)
+## text.equals
 ```ts
 equals(a: string | PlayerText, b: string | PlayerText): boolean
@@ -2839,9 +2839,9 @@ theirs. Use this for display-level comparisons, not for identity.
 | `a` | `string \| PlayerText` |
 | `b` | `string \| PlayerText` |
-## AchievementReceipt.achievementId
+<a id="achievementreceipt-achievementid"></a>
-[AchievementReceipt.achievementId](https://gemarcade.com/developer/api/server#achievementreceipt-achievementid)
+## AchievementReceipt.achievementId
 ```ts
 readonly achievementId: string
@@ -2849,9 +2849,9 @@ readonly achievementId: string
 The achievement's id, as your game config declares it.
-## AchievementReceipt.progressionDefinitionId
+<a id="achievementreceipt-progressiondefinitionid"></a>
-[AchievementReceipt.progressionDefinitionId](https://gemarcade.com/developer/api/server#achievementreceipt-progressiondefinitionid)
+## AchievementReceipt.progressionDefinitionId
 ```ts
 readonly progressionDefinitionId: string
@@ -2859,9 +2859,9 @@ readonly progressionDefinitionId: string
 The progression the achievement sits on.
-## AchievementReceipt.points
+<a id="achievementreceipt-points"></a>
-[AchievementReceipt.points](https://gemarcade.com/developer/api/server#achievementreceipt-points)
+## AchievementReceipt.points
 ```ts
 readonly points: number
@@ -2871,9 +2871,9 @@ Achievement points the unlock credited. Zero unless `outcome` is
 `unlocked`, so summing it over receipts counts only what this order
 credited.
-## AchievementReceipt.outcome
+<a id="achievementreceipt-outcome"></a>
-[AchievementReceipt.outcome](https://gemarcade.com/developer/api/server#achievementreceipt-outcome)
+## AchievementReceipt.outcome
 ```ts
 readonly outcome: "unlocked" | "already_unlocked" | "suppressed"
@@ -2887,9 +2887,9 @@ The set may grow. A receipt with an outcome this SDK does not know is
 left out rather than reported as one of these, so a `switch` over these
 three needs no default for correctness — but write one anyway.
-## AchievementReceipt.reason
+<a id="achievementreceipt-reason"></a>
-[AchievementReceipt.reason](https://gemarcade.com/developer/api/server#achievementreceipt-reason)
+## AchievementReceipt.reason
 ```ts
 readonly reason?: string
@@ -2904,9 +2904,9 @@ achievement on it never unlocks), or `achievements_unavailable`
 (transient; the next eligible write tries again). For your logs and your
 developer tools; not text to show a player.
-## GemServerOptions.baseUrl
+<a id="gemserveroptions-baseurl"></a>
-[GemServerOptions.baseUrl](https://gemarcade.com/developer/api/server#gemserveroptions-baseurl)
+## GemServerOptions.baseUrl
 ```ts
 readonly baseUrl?: string
@@ -2920,9 +2920,9 @@ machine — not for choosing which environment you are in. Setting it in a
 shipped bundle means your server talks to somewhere the platform did not
 send it.
-## GemServerOptions.clock
+<a id="gemserveroptions-clock"></a>
-[GemServerOptions.clock](https://gemarcade.com/developer/api/server#gemserveroptions-clock)
+## GemServerOptions.clock
 ```ts
 readonly clock?: Clock
@@ -2930,12 +2930,12 @@ readonly clock?: Clock
 Where time comes from. Defaults to the real clock.
-Pass a [Clock](https://gemarcade.com/developer/api/server#clock) in a test so token refresh and retry backoff happen when
+Pass a [Clock](#clock) in a test so token refresh and retry backoff happen when
 you say rather than when a real second passes.
-## GemServerOptions.fetch
+<a id="gemserveroptions-fetch"></a>
-[GemServerOptions.fetch](https://gemarcade.com/developer/api/server#gemserveroptions-fetch)
+## GemServerOptions.fetch
 ```ts
 readonly fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>
@@ -2946,9 +2946,9 @@ The `fetch` used for every call. Defaults to the runtime's own.
 For tests: a stub here is how you assert what your bundle sends without a
 network.
-## GemServerOptions.onAuthStateChange
+<a id="gemserveroptions-onauthstatechange"></a>
-[GemServerOptions.onAuthStateChange](https://gemarcade.com/developer/api/server#gemserveroptions-onauthstatechange)
+## GemServerOptions.onAuthStateChange
 ```ts
 readonly onAuthStateChange?: (state: AuthState, reason?: AuthFailure) => void
@@ -2958,12 +2958,12 @@ Called whenever the server's ability to make authenticated calls changes.
 The same signal the browser half delivers to a game, for the same reason:
 the token is refreshed for you, and this is how you find out when that stops
-working. See [AuthState](https://gemarcade.com/developer/api/server#authstate) for what to branch on and [AuthFailure](https://gemarcade.com/developer/api/server#authfailure)
+working. See [AuthState](#authstate) for what to branch on and [AuthFailure](#authfailure)
 for the cause.
-## GemServerIdentity.gameId
+<a id="gemserveridentity-gameid"></a>
-[GemServerIdentity.gameId](https://gemarcade.com/developer/api/server#gemserveridentity-gameid)
+## GemServerIdentity.gameId
 ```ts
 readonly gameId: string
@@ -2971,9 +2971,9 @@ readonly gameId: string
 The game this server belongs to.
-## GemServerIdentity.channel
+<a id="gemserveridentity-channel"></a>
-[GemServerIdentity.channel](https://gemarcade.com/developer/api/server#gemserveridentity-channel)
+## GemServerIdentity.channel
 ```ts
 readonly channel: string
@@ -2981,9 +2981,9 @@ readonly channel: string
 The channel it was allocated on — `dev`, `test` or `release`.
-## GemServerIdentity.matchId
+<a id="gemserveridentity-matchid"></a>
-[GemServerIdentity.matchId](https://gemarcade.com/developer/api/server#gemserveridentity-matchid)
+## GemServerIdentity.matchId
 ```ts
 readonly matchId: string
@@ -2991,9 +2991,9 @@ readonly matchId: string
 The match it is running.
-## GemServerIdentity.gameRoomId
+<a id="gemserveridentity-gameroomid"></a>
-[GemServerIdentity.gameRoomId](https://gemarcade.com/developer/api/server#gemserveridentity-gameroomid)
+## GemServerIdentity.gameRoomId
 ```ts
 readonly gameRoomId?: string
@@ -3002,11 +3002,11 @@ readonly gameRoomId?: string
 The room this match came from, when there is one.
 CHECK IT BEFORE USING IT. It is absent on older platform images, which is
-also why [GemServer.room](https://gemarcade.com/developer/api/server#gemserver-room) can be absent — the two go together.
+also why [GemServer.room](#gemserver-room) can be absent — the two go together.
-## GemServer.identity
+<a id="gemserver-identity"></a>
-[GemServer.identity](https://gemarcade.com/developer/api/server#gemserver-identity)
+## GemServer.identity
 ```ts
 readonly identity: GemServerIdentity
@@ -3014,15 +3014,15 @@ readonly identity: GemServerIdentity
 Which game, channel and match this server is running.
-## GemServer.client
+<a id="gemserver-client"></a>
-[GemServer.client](https://gemarcade.com/developer/api/server#gemserver-client)
+## GemServer.client
 ```ts
 readonly client: GemClient
 ```
-The HTTP client underneath [GemServer.api](https://gemarcade.com/developer/api/server#gemserver-api), for calls the generated
+The HTTP client underneath [GemServer.api](#gemserver-api), for calls the generated
 surface does not cover.
 PREFER `api`. It is typed against the platform's description, so a shape
@@ -3030,9 +3030,9 @@ that changes becomes a build error in your bundle. This one takes a path and
 checks nothing — reach for it when you genuinely need something `api` has
 no method for, and treat that as worth telling us about.
-## GemServer.api
+<a id="gemserver-api"></a>
-[GemServer.api](https://gemarcade.com/developer/api/server#gemserver-api)
+## GemServer.api
 ```ts
 readonly api: ServerApi
@@ -3040,11 +3040,11 @@ readonly api: ServerApi
 Every platform operation your server can call. This is the one you want.
-See [ServerApi](https://gemarcade.com/developer/api/server#serverapi).
+See [ServerApi](#serverapi).
-## GemServer.match
+<a id="gemserver-match"></a>
-[GemServer.match](https://gemarcade.com/developer/api/server#gemserver-match)
+## GemServer.match
 ```ts
 readonly match: { end: null }
@@ -3065,9 +3065,9 @@ that this server is the one allocated to the match, which the platform
 requires. On a platform image too old to offer that, `end()` throws rather
 than sending a request without the proof.
-## GemServer.match.end
+<a id="gemserver-match-end"></a>
-[GemServer.match.end](https://gemarcade.com/developer/api/server#gemserver-match-end)
+## GemServer.match.end
 ```ts
 end(signal?: AbortSignal): Promise<void>
@@ -3082,9 +3082,9 @@ Tell the platform this match is finished.
 **Throws.** When the platform image running this server predates
   `host.endMatch`, so the match cannot be ended from here.
-## GemServer.analytics
+<a id="gemserver-analytics"></a>
-[GemServer.analytics](https://gemarcade.com/developer/api/server#gemserver-analytics)
+## GemServer.analytics
 ```ts
 readonly analytics: ServerAnalytics
@@ -3101,12 +3101,12 @@ game may declare an event `sources: [server]` and shut the client out of it
 entirely.
 ⚠️ **Every event names its player, and `gem_*` is unavailable here** — see
-[ServerAnalytics.track](https://gemarcade.com/developer/api/server#serveranalytics-track). And flush before the match ends: there is no
+[ServerAnalytics.track](#serveranalytics-track). And flush before the match ends: there is no
 page unload to get the tail out on.
-## GemServer.functions
+<a id="gemserver-functions"></a>
-[GemServer.functions](https://gemarcade.com/developer/api/server#gemserver-functions)
+## GemServer.functions
 ```ts
 readonly functions: FunctionsApi
@@ -3119,9 +3119,9 @@ The call arrives as this server, not as a player: your function's
 `get-context` says so, and a server's per-minute budget is its own. It runs
 the function promoted on the channel this match runs on.
-## GemServer.challenges
+<a id="gemserver-challenges"></a>
-[GemServer.challenges](https://gemarcade.com/developer/api/server#gemserver-challenges)
+## GemServer.challenges
 ```ts
 readonly challenges: ServerChallenges
@@ -3133,11 +3133,11 @@ board that player was actually given.
 A period is the PLAYER's, not the calendar's: it ends at their own
 midnight. That is why this takes a player id where the browser's
-`gem.challenges` takes none. See [ServerChallenges.list](https://gemarcade.com/developer/api/server#serverchallenges-list).
+`gem.challenges` takes none. See [ServerChallenges.list](#serverchallenges-list).
-## GemServer.room
+<a id="gemserver-room"></a>
-[GemServer.room](https://gemarcade.com/developer/api/server#gemserver-room)
+## GemServer.room
 ```ts
 readonly room?: { get: (options?: { ifNoneMatch?: string; signal?: AbortSignal }) => Promise<VersionedResponse<GameRoomResponseV2>>; args: (options?: { signal?: AbortSignal }) => Promise<RoomArgsResponse> }
@@ -3151,9 +3151,9 @@ the type says it might be. `gem.room?.get()` is the shape to write. When it
 is absent the same reads are still available through `api` if you know the
 room id from somewhere else.
-## GemServer.room.get
+<a id="gemserver-room-get"></a>
-[GemServer.room.get](https://gemarcade.com/developer/api/server#gemserver-room-get)
+## GemServer.room.get
 ```ts
 get: (options?: { ifNoneMatch?: string; signal?: AbortSignal }) => Promise<VersionedResponse<GameRoomResponseV2>>
@@ -3166,9 +3166,9 @@ avatar.
 This is what you want at `start()`, and it is a superset of what the older
 roster push carried.
-## GemServer.room.args
+<a id="gemserver-room-args"></a>
-[GemServer.room.args](https://gemarcade.com/developer/api/server#gemserver-room-args)
+## GemServer.room.args
 ```ts
 args: (options?: { signal?: AbortSignal }) => Promise<RoomArgsResponse>
@@ -3181,9 +3181,9 @@ A room whose template declares no settings answers 404
 settings" and "this room's settings are empty" are different answers and
 the API keeps them apart.
-## GemServer.dispose
+<a id="gemserver-dispose"></a>
-[GemServer.dispose](https://gemarcade.com/developer/api/server#gemserver-dispose)
+## GemServer.dispose
 ```ts
 dispose(): void
@@ -3191,13 +3191,13 @@ dispose(): void
 Stop listening for credential updates.
-You rarely need it: a bundle built with [defineServer](https://gemarcade.com/developer/api/server#defineserver) is disposed for
+You rarely need it: a bundle built with [defineServer](#defineserver) is disposed for
 you when the match ends. Call it in a test, or if you built the server
 yourself and are tearing it down.
-## ServerTokenGrant.token
+<a id="servertokengrant-token"></a>
-[ServerTokenGrant.token](https://gemarcade.com/developer/api/server#servertokengrant-token)
+## ServerTokenGrant.token
 ```ts
 readonly token: string
@@ -3205,9 +3205,9 @@ readonly token: string
 The credential to present. Never log it and never send it on.
-## ServerTokenGrant.expiresAt
+<a id="servertokengrant-expiresat"></a>
-[ServerTokenGrant.expiresAt](https://gemarcade.com/developer/api/server#servertokengrant-expiresat)
+## ServerTokenGrant.expiresAt
 ```ts
 readonly expiresAt: number
@@ -3215,9 +3215,9 @@ readonly expiresAt: number
 When it expires, in seconds since the Unix epoch.
-## ServerBundleHost.matchId
+<a id="serverbundlehost-matchid"></a>
-[ServerBundleHost.matchId](https://gemarcade.com/developer/api/server#serverbundlehost-matchid)
+## ServerBundleHost.matchId
 ```ts
 readonly matchId: string
@@ -3225,9 +3225,9 @@ readonly matchId: string
 The match this server was allocated for.
-## ServerBundleHost.gameId
+<a id="serverbundlehost-gameid"></a>
-[ServerBundleHost.gameId](https://gemarcade.com/developer/api/server#serverbundlehost-gameid)
+## ServerBundleHost.gameId
 ```ts
 readonly gameId: string
@@ -3235,9 +3235,9 @@ readonly gameId: string
 The game it belongs to.
-## ServerBundleHost.channel
+<a id="serverbundlehost-channel"></a>
-[ServerBundleHost.channel](https://gemarcade.com/developer/api/server#serverbundlehost-channel)
+## ServerBundleHost.channel
 ```ts
 readonly channel: string
@@ -3245,32 +3245,32 @@ readonly channel: string
 The channel it was allocated on — `dev`, `test` or `release`.
-## ServerBundleHost.gameRoomId
+<a id="serverbundlehost-gameroomid"></a>
-[ServerBundleHost.gameRoomId](https://gemarcade.com/developer/api/server#serverbundlehost-gameroomid)
+## ServerBundleHost.gameRoomId
 ```ts
 readonly gameRoomId?: string
 ```
 The room this match came from. MAY BE ABSENT on older platform images, so
-check before using it — that absence is also why [GemServer.room](https://gemarcade.com/developer/api/server#gemserver-room) can
+check before using it — that absence is also why [GemServer.room](#gemserver-room) can
 be missing.
-## ServerBundleHost.apiBaseUrl
+<a id="serverbundlehost-apibaseurl"></a>
-[ServerBundleHost.apiBaseUrl](https://gemarcade.com/developer/api/server#serverbundlehost-apibaseurl)
+## ServerBundleHost.apiBaseUrl
 ```ts
 readonly apiBaseUrl?: string
 ```
 Where to send API calls. Absent on older platform images, which is the case
-[createGemServer](https://gemarcade.com/developer/api/server#creategemserver) refuses at startup.
+[createGemServer](#creategemserver) refuses at startup.
-## ServerBundleHost.serverToken
+<a id="serverbundlehost-servertoken"></a>
-[ServerBundleHost.serverToken](https://gemarcade.com/developer/api/server#serverbundlehost-servertoken)
+## ServerBundleHost.serverToken
 ```ts
 serverToken(): ServerTokenGrant | undefined
@@ -3278,9 +3278,9 @@ serverToken(): ServerTokenGrant | undefined
 The credential held right now, if the platform delivered one.
-## ServerBundleHost.onServerToken
+<a id="serverbundlehost-onservertoken"></a>
-[ServerBundleHost.onServerToken](https://gemarcade.com/developer/api/server#serverbundlehost-onservertoken)
+## ServerBundleHost.onServerToken
 ```ts
 onServerToken(listener: (grant: ServerTokenGrant) => void): () => void
@@ -3291,15 +3291,15 @@ Be told when the credential is replaced.
 Called straight away if one is already held, and again on every refresh.
 Returns a function that stops the notifications.
-You rarely call this. [createGemServer](https://gemarcade.com/developer/api/server#creategemserver) subscribes for you.
+You rarely call this. [createGemServer](#creategemserver) subscribes for you.
 | Parameter | Type |
 | --- | --- |
 | `listener` | `(grant: ServerTokenGrant) => void` |
-## SendOptions.reliable
+<a id="sendoptions-reliable"></a>
-[SendOptions.reliable](https://gemarcade.com/developer/api/server#sendoptions-reliable)
+## SendOptions.reliable
 ```ts
 readonly reliable?: boolean
@@ -3311,9 +3311,9 @@ Ask for the message to arrive. Defaults to true.
 that a later one supersedes. A transport is free to deliver it reliably
 anyway; the receiver is still told what you asked for.
-## SendOptions.ordered
+<a id="sendoptions-ordered"></a>
-[SendOptions.ordered](https://gemarcade.com/developer/api/server#sendoptions-ordered)
+## SendOptions.ordered
 ```ts
 readonly ordered?: boolean
@@ -3321,9 +3321,9 @@ readonly ordered?: boolean
 Ask for messages to arrive in the order you sent them. Defaults to true.
-## BroadcastOptions.reliable
+<a id="broadcastoptions-reliable"></a>
-[BroadcastOptions.reliable](https://gemarcade.com/developer/api/server#broadcastoptions-reliable)
+## BroadcastOptions.reliable
 ```ts
 readonly reliable?: boolean
@@ -3335,9 +3335,9 @@ Ask for the message to arrive. Defaults to true.
 that a later one supersedes. A transport is free to deliver it reliably
 anyway; the receiver is still told what you asked for.
-## BroadcastOptions.ordered
+<a id="broadcastoptions-ordered"></a>
-[BroadcastOptions.ordered](https://gemarcade.com/developer/api/server#broadcastoptions-ordered)
+## BroadcastOptions.ordered
 ```ts
 readonly ordered?: boolean
@@ -3345,9 +3345,9 @@ readonly ordered?: boolean
 Ask for messages to arrive in the order you sent them. Defaults to true.
-## BroadcastOptions.except
+<a id="broadcastoptions-except"></a>
-[BroadcastOptions.except](https://gemarcade.com/developer/api/server#broadcastoptions-except)
+## BroadcastOptions.except
 ```ts
 readonly except?: string
@@ -3355,9 +3355,9 @@ readonly except?: string
 A player to leave out — usually the one whose action caused the broadcast.
-## GemServerHostProfile.displayName
+<a id="gemserverhostprofile-displayname"></a>
-[GemServerHostProfile.displayName](https://gemarcade.com/developer/api/server#gemserverhostprofile-displayname)
+## GemServerHostProfile.displayName
 ```ts
 readonly displayName?: string
@@ -3365,23 +3365,23 @@ readonly displayName?: string
 The player's chosen name, as a plain string.
-PREFER [GemMatchServer.profile](https://gemarcade.com/developer/api/server#gemmatchserver-profile), which gives you the same name as
-[PlayerText](https://gemarcade.com/developer/api/server#playertext) — a type that reminds you a stranger wrote it.
+PREFER [GemMatchServer.profile](#gemmatchserver-profile), which gives you the same name as
+[PlayerText](#playertext) — a type that reminds you a stranger wrote it.
-## GemServerHostProfile.displayTag
+<a id="gemserverhostprofile-displaytag"></a>
-[GemServerHostProfile.displayTag](https://gemarcade.com/developer/api/server#gemserverhostprofile-displaytag)
+## GemServerHostProfile.displayTag
 ```ts
 readonly displayTag?: string
 ```
 The precomposed `Name#0001`, as a plain string. It contains the name, so
-PREFER [GemMatchServer.profile](https://gemarcade.com/developer/api/server#gemmatchserver-profile), which gives it as [PlayerText](https://gemarcade.com/developer/api/server#playertext).
+PREFER [GemMatchServer.profile](#gemmatchserver-profile), which gives it as [PlayerText](#playertext).
-## GemServerHostProfile.discriminator
+<a id="gemserverhostprofile-discriminator"></a>
-[GemServerHostProfile.discriminator](https://gemarcade.com/developer/api/server#gemserverhostprofile-discriminator)
+## GemServerHostProfile.discriminator
 ```ts
 readonly discriminator?: string
@@ -3389,9 +3389,9 @@ readonly discriminator?: string
 The disambiguating suffix, when the player has one.
-## GemServerHost.matchId
+<a id="gemserverhost-matchid"></a>
-[GemServerHost.matchId](https://gemarcade.com/developer/api/server#gemserverhost-matchid)
+## GemServerHost.matchId
 ```ts
 readonly matchId: string
@@ -3399,9 +3399,9 @@ readonly matchId: string
 The match this server was allocated for.
-## GemServerHost.gameId
+<a id="gemserverhost-gameid"></a>
-[GemServerHost.gameId](https://gemarcade.com/developer/api/server#gemserverhost-gameid)
+## GemServerHost.gameId
 ```ts
 readonly gameId: string
@@ -3409,9 +3409,9 @@ readonly gameId: string
 The game it belongs to.
-## GemServerHost.channel
+<a id="gemserverhost-channel"></a>
-[GemServerHost.channel](https://gemarcade.com/developer/api/server#gemserverhost-channel)
+## GemServerHost.channel
 ```ts
 readonly channel: string
@@ -3419,32 +3419,32 @@ readonly channel: string
 The channel it was allocated on — `dev`, `test` or `release`.
-## GemServerHost.gameRoomId
+<a id="gemserverhost-gameroomid"></a>
-[GemServerHost.gameRoomId](https://gemarcade.com/developer/api/server#gemserverhost-gameroomid)
+## GemServerHost.gameRoomId
 ```ts
 readonly gameRoomId?: string
 ```
 The room this match came from. MAY BE ABSENT on older platform images, so
-check before using it — that absence is also why [GemServer.room](https://gemarcade.com/developer/api/server#gemserver-room) can
+check before using it — that absence is also why [GemServer.room](#gemserver-room) can
 be missing.
-## GemServerHost.apiBaseUrl
+<a id="gemserverhost-apibaseurl"></a>
-[GemServerHost.apiBaseUrl](https://gemarcade.com/developer/api/server#gemserverhost-apibaseurl)
+## GemServerHost.apiBaseUrl
 ```ts
 readonly apiBaseUrl?: string
 ```
 Where to send API calls. Absent on older platform images, which is the case
-[createGemServer](https://gemarcade.com/developer/api/server#creategemserver) refuses at startup.
+[createGemServer](#creategemserver) refuses at startup.
-## GemServerHost.serverToken
+<a id="gemserverhost-servertoken"></a>
-[GemServerHost.serverToken](https://gemarcade.com/developer/api/server#gemserverhost-servertoken)
+## GemServerHost.serverToken
 ```ts
 serverToken(): ServerTokenGrant | undefined
@@ -3452,9 +3452,9 @@ serverToken(): ServerTokenGrant | undefined
 The credential held right now, if the platform delivered one.
-## GemServerHost.onServerToken
+<a id="gemserverhost-onservertoken"></a>
-[GemServerHost.onServerToken](https://gemarcade.com/developer/api/server#gemserverhost-onservertoken)
+## GemServerHost.onServerToken
 ```ts
 onServerToken(listener: (grant: ServerTokenGrant) => void): () => void
@@ -3465,15 +3465,15 @@ Be told when the credential is replaced.
 Called straight away if one is already held, and again on every refresh.
 Returns a function that stops the notifications.
-You rarely call this. [createGemServer](https://gemarcade.com/developer/api/server#creategemserver) subscribes for you.
+You rarely call this. [createGemServer](#creategemserver) subscribes for you.
 | Parameter | Type |
 | --- | --- |
 | `listener` | `(grant: ServerTokenGrant) => void` |
-## GemServerHost.sizeClass
+<a id="gemserverhost-sizeclass"></a>
-[GemServerHost.sizeClass](https://gemarcade.com/developer/api/server#gemserverhost-sizeclass)
+## GemServerHost.sizeClass
 ```ts
 readonly sizeClass: string
@@ -3481,9 +3481,9 @@ readonly sizeClass: string
 Which size of machine this server was allocated on.
-## GemServerHost.roomArgs
+<a id="gemserverhost-roomargs"></a>
-[GemServerHost.roomArgs](https://gemarcade.com/developer/api/server#gemserverhost-roomargs)
+## GemServerHost.roomArgs
 ```ts
 readonly roomArgs?: Readonly<Record<string, RoomArgValue>>
@@ -3498,7 +3498,7 @@ and `4.0.0` is the earliest release that may take it off the type. Whether
 a server keeps sending a value is a separate question, decided where the
 dedicated-server image is built rather than by a package release — so check
 for the room read and keep this as the fallback. Both halves are in
-[the deprecation policy](https://gemarcade.com/developer/docs/deprecation-policy).
+[the deprecation policy](../deprecation-policy.md).
 The room's settings as they were at match start.
@@ -3506,9 +3506,9 @@ The room's settings as they were at match start.
 room type declares no settings, or the platform image is older than this
 member.
-## GemServerHost.roster
+<a id="gemserverhost-roster"></a>
-[GemServerHost.roster](https://gemarcade.com/developer/api/server#gemserverhost-roster)
+## GemServerHost.roster
 ```ts
 readonly roster: readonly string[]
@@ -3522,7 +3522,7 @@ and `4.0.0` is the earliest release that may take it off the type. Whether
 a server keeps sending a value is a separate question, decided where the
 dedicated-server image is built rather than by a package release — so check
 for the room read and keep this as the fallback. Both halves are in
-[the deprecation policy](https://gemarcade.com/developer/docs/deprecation-policy).
+[the deprecation policy](../deprecation-policy.md).
 Who was in the room when this server was allocated.
@@ -3530,9 +3530,9 @@ A SIZING HINT, NOT A GUEST LIST. It is never revised, and it does not decide
 who may connect — the platform admits players by credential. A player who
 joined after allocation holds a valid one and is not in here.
-## GemServerHost.players
+<a id="gemserverhost-players"></a>
-[GemServerHost.players](https://gemarcade.com/developer/api/server#gemserverhost-players)
+## GemServerHost.players
 ```ts
 players(): string[]
@@ -3540,9 +3540,9 @@ players(): string[]
 The player ids connected right now, as a fresh array each call.
-## GemServerHost.profile
+<a id="gemserverhost-profile"></a>
-[GemServerHost.profile](https://gemarcade.com/developer/api/server#gemserverhost-profile)
+## GemServerHost.profile
 ```ts
 profile(playerId: string): GemServerHostProfile | undefined
@@ -3552,15 +3552,15 @@ A player's display identity, if the platform resolved one.
 OPTIONAL TWICE OVER: the method itself may be absent on an older platform
 image, and it may answer `undefined` for a player it has nothing for.
-[GemMatchServer.profile](https://gemarcade.com/developer/api/server#gemmatchserver-profile) collapses both into one `null`.
+[GemMatchServer.profile](#gemmatchserver-profile) collapses both into one `null`.
 | Parameter | Type |
 | --- | --- |
 | `playerId` | `string` |
-## GemServerHost.playerNumber
+<a id="gemserverhost-playernumber"></a>
-[GemServerHost.playerNumber](https://gemarcade.com/developer/api/server#gemserverhost-playernumber)
+## GemServerHost.playerNumber
 ```ts
 playerNumber(playerId: string): number | undefined
@@ -3575,9 +3575,9 @@ May be absent as a method on an older platform image, and answers
 | --- | --- |
 | `playerId` | `string` |
-## GemServerHost.send
+<a id="gemserverhost-send"></a>
-[GemServerHost.send](https://gemarcade.com/developer/api/server#gemserverhost-send)
+## GemServerHost.send
 ```ts
 send(playerId: string, data: string | Uint8Array<ArrayBufferLike>, options?: SendOptions): void
@@ -3590,18 +3590,18 @@ receiver is told which.
 | --- | --- | --- |
 | `playerId` | `string` |  |
 | `data` | `string \| Uint8Array<ArrayBufferLike>` |  |
-| `options` | `SendOptions` | What delivery you are asking for — see [SendOptions](https://gemarcade.com/developer/api/server#sendoptions).
+| `options` | `SendOptions` | What delivery you are asking for — see [SendOptions](#sendoptions).
   Pass them freely: an older platform image ignores them harmlessly. |
-## GemServerHost.broadcast
+<a id="gemserverhost-broadcast"></a>
-[GemServerHost.broadcast](https://gemarcade.com/developer/api/server#gemserverhost-broadcast)
+## GemServerHost.broadcast
 ```ts
 broadcast(data: string | Uint8Array<ArrayBufferLike>, options?: BroadcastOptions): void
 ```
-Send to every connected player. See [BroadcastOptions](https://gemarcade.com/developer/api/server#broadcastoptions) for how, and
+Send to every connected player. See [BroadcastOptions](#broadcastoptions) for how, and
 for leaving one out.
 | Parameter | Type |
@@ -3609,9 +3609,9 @@ for leaving one out.
 | `data` | `string \| Uint8Array<ArrayBufferLike>` |
 | `options` | `BroadcastOptions` |
-## GemServerHost.kick
+<a id="gemserverhost-kick"></a>
-[GemServerHost.kick](https://gemarcade.com/developer/api/server#gemserverhost-kick)
+## GemServerHost.kick
 ```ts
 kick(playerId: string, reason?: string): void
@@ -3624,9 +3624,9 @@ Disconnect a player. `reason` is shown to them and recorded in the logs.
 | `playerId` | `string` |
 | `reason` | `string` |
-## GemServerHost.endMatch
+<a id="gemserverhost-endmatch"></a>
-[GemServerHost.endMatch](https://gemarcade.com/developer/api/server#gemserverhost-endmatch)
+## GemServerHost.endMatch
 ```ts
 endMatch(): Promise<"ok" | "already_ended" | "refused" | "failed" | string & object>
@@ -3643,9 +3643,9 @@ Resolves with what the platform half did: `ok`, `already_ended` (this
 match was already over, or you asked twice), `refused` (the allocation was
 not ready yet) or `failed` (the platform could not be reached).
-## GemServerHost.log
+<a id="gemserverhost-log"></a>
-[GemServerHost.log](https://gemarcade.com/developer/api/server#gemserverhost-log)
+## GemServerHost.log
 ```ts
 log(message: string): void
@@ -3661,34 +3661,34 @@ about your bundle rather than as a log.
 | --- | --- |
 | `message` | `string` |
-## GemServerHost.warn
+<a id="gemserverhost-warn"></a>
-[GemServerHost.warn](https://gemarcade.com/developer/api/server#gemserverhost-warn)
+## GemServerHost.warn
 ```ts
 warn(message: string): void
 ```
-Like [GemServerHost.log](https://gemarcade.com/developer/api/server#gemserverhost-log), marked as a warning.
+Like [GemServerHost.log](#gemserverhost-log), marked as a warning.
 | Parameter | Type |
 | --- | --- |
 | `message` | `string` |
-## HostTokenSourceOptions.clock
+<a id="hosttokensourceoptions-clock"></a>
-[HostTokenSourceOptions.clock](https://gemarcade.com/developer/api/server#hosttokensourceoptions-clock)
+## HostTokenSourceOptions.clock
 ```ts
 readonly clock: Clock
 ```
 Where time comes from — used for expiry and for the wait below. Pass a
-[Clock](https://gemarcade.com/developer/api/server#clock) in a test.
+[Clock](#clock) in a test.
-## HostTokenSourceOptions.timeoutMs
+<a id="hosttokensourceoptions-timeoutms"></a>
-[HostTokenSourceOptions.timeoutMs](https://gemarcade.com/developer/api/server#hosttokensourceoptions-timeoutms)
+## HostTokenSourceOptions.timeoutMs
 ```ts
 readonly timeoutMs?: number
@@ -3697,20 +3697,20 @@ readonly timeoutMs?: number
 How long to wait for the platform to deliver a credential before giving up
 on a call. Defaults to 10 seconds.
-## HostTokenSourceOptions.onStateChange
+<a id="hosttokensourceoptions-onstatechange"></a>
-[HostTokenSourceOptions.onStateChange](https://gemarcade.com/developer/api/server#hosttokensourceoptions-onstatechange)
+## HostTokenSourceOptions.onStateChange
 ```ts
 readonly onStateChange?: (state: AuthState, reason?: AuthFailure) => void
 ```
 Called when the ability to make authenticated calls changes. See
-[AuthState](https://gemarcade.com/developer/api/server#authstate) for what to branch on.
+[AuthState](#authstate) for what to branch on.
-## HostTokenSource.dispose
+<a id="hosttokensource-dispose"></a>
-[HostTokenSource.dispose](https://gemarcade.com/developer/api/server#hosttokensource-dispose)
+## HostTokenSource.dispose
 ```ts
 dispose(): void
@@ -3721,9 +3721,9 @@ Stop refreshing the credential.
 CALL IT AT SHUTDOWN. A pending refresh timer keeps the process alive, so a
 bundle that skips this looks like it has hung rather than exited.
-## GemServerBundle.init
+<a id="gemserverbundle-init"></a>
-[GemServerBundle.init](https://gemarcade.com/developer/api/server#gemserverbundle-init)
+## GemServerBundle.init
 ```ts
 init(): void | Promise<void>
@@ -3734,9 +3734,9 @@ Once, before any player arrives. Set your world up here.
 YOU HAVE 60 SECONDS. Throwing fails the match, so do not start anything here
 you are not prepared to have fail loudly.
-## GemServerBundle.join
+<a id="gemserverbundle-join"></a>
-[GemServerBundle.join](https://gemarcade.com/developer/api/server#gemserverbundle-join)
+## GemServerBundle.join
 ```ts
 join(playerId: string, meta?: { playerNumber?: number; transport?: string; rejoin?: boolean; superseded?: boolean }): void | Promise<void>
@@ -3778,9 +3778,9 @@ nothing was superseded, and on platform images that predate it.
   back, and whether they replaced a connection that was still up. MAY BE
   ABSENT on older platform images, so default before use. |
-## GemServerBundle.leave
+<a id="gemserverbundle-leave"></a>
-[GemServerBundle.leave](https://gemarcade.com/developer/api/server#gemserverbundle-leave)
+## GemServerBundle.leave
 ```ts
 leave(playerId: string, meta?: { cause?: string }): void | Promise<void>
@@ -3806,9 +3806,9 @@ on the strength of the cause alone.
 | `playerId` | `string` | Who left. |
 | `meta` | `{ cause?: string }` | Why, when the platform knows. May be absent. |
-## GemServerBundle.message
+<a id="gemserverbundle-message"></a>
-[GemServerBundle.message](https://gemarcade.com/developer/api/server#gemserverbundle-message)
+## GemServerBundle.message
 ```ts
 message(playerId: string, data: string | Uint8Array<ArrayBufferLike>, isText: boolean, meta?: { reliable?: boolean; ordered?: boolean; sessionId?: number; playerNumber?: number }): void | Promise<void>
@@ -3825,9 +3825,9 @@ A player sent you something.
 | `meta` | `{ reliable?: boolean; ordered?: boolean; sessionId?: number; playerNumber?: number }` | What the sender ASKED FOR — `reliable` and `ordered` — carried
   across whatever the transport actually did. May be absent. |
-## GemServerBundle.shutdown
+<a id="gemserverbundle-shutdown"></a>
-[GemServerBundle.shutdown](https://gemarcade.com/developer/api/server#gemserverbundle-shutdown)
+## GemServerBundle.shutdown
 ```ts
 shutdown(info?: ServerShutdownInfo): void | Promise<void>
@@ -3843,7 +3843,7 @@ is reclaiming the machine: up to 2 hours, so a match with players still in it
 plays out rather than dying mid-game.
 `info.reason` says which, on platform images that report it — see
-[ServerShutdownInfo](https://gemarcade.com/developer/api/server#servershutdowninfo). On a reclaim (`signal`) do NOT end the match:
+[ServerShutdownInfo](#servershutdowninfo). On a reclaim (`signal`) do NOT end the match:
 the players are still in it, and ending it here drops every one of them.
 ```js
@@ -3858,11 +3858,11 @@ async shutdown(info) {
 | `info` | `ServerShutdownInfo` | Why, when the platform says. ABSENT on older platform images,
   so default before use. |
-**Guides.** [server-bundles](https://gemarcade.com/developer/docs/server-bundles#how-long-your-server-lives)
+**Guides.** [server-bundles](../server-bundles.md#how-long-your-server-lives)
-## ServerShutdownInfo.reason
+<a id="servershutdowninfo-reason"></a>
-[ServerShutdownInfo.reason](https://gemarcade.com/developer/api/server#servershutdowninfo-reason)
+## ServerShutdownInfo.reason
 ```ts
 readonly reason: string & object | "match_ended" | "idle_timeout" | "signal"
@@ -3870,9 +3870,9 @@ readonly reason: string & object | "match_ended" | "idle_timeout" | "signal"
 Which of the above.
-## ServerShutdownInfo.endedReason
+<a id="servershutdowninfo-endedreason"></a>
-[ServerShutdownInfo.endedReason](https://gemarcade.com/developer/api/server#servershutdowninfo-endedreason)
+## ServerShutdownInfo.endedReason
 ```ts
 readonly endedReason?: string
@@ -3882,9 +3882,9 @@ On `match_ended`: why, in the client's `matchEnded` vocabulary (`explicit`,
 `expired`, `all_left`, …), or `unknown` when the runtime passed a word this
 SDK does not know. Absent when the runtime passed nothing.
-## GemServerLifecycle.init
+<a id="gemserverlifecycle-init"></a>
-[GemServerLifecycle.init](https://gemarcade.com/developer/api/server#gemserverlifecycle-init)
+## GemServerLifecycle.init
 ```ts
 init(host: GemServerHost): Promise<void>
@@ -3897,9 +3897,9 @@ and where your own `init` runs.
 | --- | --- |
 | `host` | `GemServerHost` |
-## GemServerLifecycle.join
+<a id="gemserverlifecycle-join"></a>
-[GemServerLifecycle.join](https://gemarcade.com/developer/api/server#gemserverlifecycle-join)
+## GemServerLifecycle.join
 ```ts
 join(playerId: string, meta?: { playerNumber?: number; transport?: string; rejoin?: boolean; superseded?: boolean }): void | Promise<void>
@@ -3912,9 +3912,9 @@ Forwarded from your bundle, when you defined a `join`.
 | `playerId` | `string` |
 | `meta` | `{ playerNumber?: number; transport?: string; rejoin?: boolean; superseded?: boolean }` |
-## GemServerLifecycle.leave
+<a id="gemserverlifecycle-leave"></a>
-[GemServerLifecycle.leave](https://gemarcade.com/developer/api/server#gemserverlifecycle-leave)
+## GemServerLifecycle.leave
 ```ts
 leave(playerId: string, meta?: { cause?: string }): void | Promise<void>
@@ -3927,9 +3927,9 @@ Forwarded from your bundle, when you defined a `leave`.
 | `playerId` | `string` |
 | `meta` | `{ cause?: string }` |
-## GemServerLifecycle.message
+<a id="gemserverlifecycle-message"></a>
-[GemServerLifecycle.message](https://gemarcade.com/developer/api/server#gemserverlifecycle-message)
+## GemServerLifecycle.message
 ```ts
 message(playerId: string, data: string | Uint8Array<ArrayBufferLike>, isText: boolean, meta?: { reliable?: boolean; ordered?: boolean; sessionId?: number; playerNumber?: number }): void | Promise<void>
@@ -3944,9 +3944,9 @@ Forwarded from your bundle, when you defined a `message`.
 | `isText` | `boolean` |
 | `meta` | `{ reliable?: boolean; ordered?: boolean; sessionId?: number; playerNumber?: number }` |
-## GemServerLifecycle.shutdown
+<a id="gemserverlifecycle-shutdown"></a>
-[GemServerLifecycle.shutdown](https://gemarcade.com/developer/api/server#gemserverlifecycle-shutdown)
+## GemServerLifecycle.shutdown
 ```ts
 shutdown(info?: RuntimeShutdownPayload): Promise<void>
@@ -3959,11 +3959,11 @@ of its own to do, and it runs whether or not yours threw.
 | --- | --- | --- |
 | `info` | `RuntimeShutdownPayload` | What the runtime passed, when it passed anything: the raw
   `{ reason, platform_reason }` of its shutdown frame, which the SDK
-  narrows into [ServerShutdownInfo](https://gemarcade.com/developer/api/server#servershutdowninfo) for your bundle. |
+  narrows into [ServerShutdownInfo](#servershutdowninfo) for your bundle. |
-## RuntimeShutdownPayload.reason
+<a id="runtimeshutdownpayload-reason"></a>
-[RuntimeShutdownPayload.reason](https://gemarcade.com/developer/api/server#runtimeshutdownpayload-reason)
+## RuntimeShutdownPayload.reason
 ```ts
 readonly reason?: string
@@ -3971,9 +3971,9 @@ readonly reason?: string
 The runtime's cause: `match_ended`, `idle_timeout`, `signal`.
-## RuntimeShutdownPayload.platform_reason
+<a id="runtimeshutdownpayload-platform_reason"></a>
-[RuntimeShutdownPayload.platform_reason](https://gemarcade.com/developer/api/server#runtimeshutdownpayload-platform_reason)
+## RuntimeShutdownPayload.platform_reason
 ```ts
 readonly platform_reason?: string
@@ -3981,9 +3981,9 @@ readonly platform_reason?: string
 On `match_ended`, the platform's reason as the runtime's frame spells it.
-## RuntimeShutdownPayload.endedReason
+<a id="runtimeshutdownpayload-endedreason"></a>
-[RuntimeShutdownPayload.endedReason](https://gemarcade.com/developer/api/server#runtimeshutdownpayload-endedreason)
+## RuntimeShutdownPayload.endedReason
 ```ts
 readonly endedReason?: string
@@ -3991,35 +3991,35 @@ readonly endedReason?: string
 The same, as the SDK spells it — for a lifecycle driven by hand.
-## GemServerProfile.displayName
+<a id="gemserverprofile-displayname"></a>
-[GemServerProfile.displayName](https://gemarcade.com/developer/api/server#gemserverprofile-displayname)
+## GemServerProfile.displayName
 ```ts
 readonly displayName: PlayerText
 ```
-The name the player chose — so it is [PlayerText](https://gemarcade.com/developer/api/server#playertext), not a plain string.
+The name the player chose — so it is [PlayerText](#playertext), not a plain string.
 The type is the reminder: this is text a stranger wrote. `text.toPlain` is
 the one way to turn it into a string, and on a server the honest answer is
 usually that you never need to.
-## GemServerProfile.displayTag
+<a id="gemserverprofile-displaytag"></a>
-[GemServerProfile.displayTag](https://gemarcade.com/developer/api/server#gemserverprofile-displaytag)
+## GemServerProfile.displayTag
 ```ts
 readonly displayTag?: PlayerText
 ```
 The precomposed `Name#0001`, when the platform has one. It contains the
-name, so it is [PlayerText](https://gemarcade.com/developer/api/server#playertext) too — the same type every other surface
+name, so it is [PlayerText](#playertext) too — the same type every other surface
 that shows a player gives it.
-## GemServerProfile.discriminator
+<a id="gemserverprofile-discriminator"></a>
-[GemServerProfile.discriminator](https://gemarcade.com/developer/api/server#gemserverprofile-discriminator)
+## GemServerProfile.discriminator
 ```ts
 readonly discriminator?: string
@@ -4027,9 +4027,9 @@ readonly discriminator?: string
 The disambiguating suffix, when the player has one.
-## GemMatchServer.identity
+<a id="gemmatchserver-identity"></a>
-[GemMatchServer.identity](https://gemarcade.com/developer/api/server#gemmatchserver-identity)
+## GemMatchServer.identity
 ```ts
 readonly identity: GemServerIdentity
@@ -4037,15 +4037,15 @@ readonly identity: GemServerIdentity
 Which game, channel and match this server is running.
-## GemMatchServer.client
+<a id="gemmatchserver-client"></a>
-[GemMatchServer.client](https://gemarcade.com/developer/api/server#gemmatchserver-client)
+## GemMatchServer.client
 ```ts
 readonly client: GemClient
 ```
-The HTTP client underneath [GemServer.api](https://gemarcade.com/developer/api/server#gemserver-api), for calls the generated
+The HTTP client underneath [GemServer.api](#gemserver-api), for calls the generated
 surface does not cover.
 PREFER `api`. It is typed against the platform's description, so a shape
@@ -4053,9 +4053,9 @@ that changes becomes a build error in your bundle. This one takes a path and
 checks nothing — reach for it when you genuinely need something `api` has
 no method for, and treat that as worth telling us about.
-## GemMatchServer.api
+<a id="gemmatchserver-api"></a>
-[GemMatchServer.api](https://gemarcade.com/developer/api/server#gemmatchserver-api)
+## GemMatchServer.api
 ```ts
 readonly api: ServerApi
@@ -4063,11 +4063,11 @@ readonly api: ServerApi
 Every platform operation your server can call. This is the one you want.
-See [ServerApi](https://gemarcade.com/developer/api/server#serverapi).
+See [ServerApi](#serverapi).
-## GemMatchServer.match
+<a id="gemmatchserver-match"></a>
-[GemMatchServer.match](https://gemarcade.com/developer/api/server#gemmatchserver-match)
+## GemMatchServer.match
 ```ts
 readonly match: { end: null }
@@ -4088,9 +4088,9 @@ that this server is the one allocated to the match, which the platform
 requires. On a platform image too old to offer that, `end()` throws rather
 than sending a request without the proof.
-## GemMatchServer.match.end
+<a id="gemmatchserver-match-end"></a>
-[GemMatchServer.match.end](https://gemarcade.com/developer/api/server#gemmatchserver-match-end)
+## GemMatchServer.match.end
 ```ts
 end(signal?: AbortSignal): Promise<void>
@@ -4105,9 +4105,9 @@ Tell the platform this match is finished.
 **Throws.** When the platform image running this server predates
   `host.endMatch`, so the match cannot be ended from here.
-## GemMatchServer.analytics
+<a id="gemmatchserver-analytics"></a>
-[GemMatchServer.analytics](https://gemarcade.com/developer/api/server#gemmatchserver-analytics)
+## GemMatchServer.analytics
 ```ts
 readonly analytics: ServerAnalytics
@@ -4124,12 +4124,12 @@ game may declare an event `sources: [server]` and shut the client out of it
 entirely.
 ⚠️ **Every event names its player, and `gem_*` is unavailable here** — see
-[ServerAnalytics.track](https://gemarcade.com/developer/api/server#serveranalytics-track). And flush before the match ends: there is no
+[ServerAnalytics.track](#serveranalytics-track). And flush before the match ends: there is no
 page unload to get the tail out on.
-## GemMatchServer.functions
+<a id="gemmatchserver-functions"></a>
-[GemMatchServer.functions](https://gemarcade.com/developer/api/server#gemmatchserver-functions)
+## GemMatchServer.functions
 ```ts
 readonly functions: FunctionsApi
@@ -4142,9 +4142,9 @@ The call arrives as this server, not as a player: your function's
 `get-context` says so, and a server's per-minute budget is its own. It runs
 the function promoted on the channel this match runs on.
-## GemMatchServer.challenges
+<a id="gemmatchserver-challenges"></a>
-[GemMatchServer.challenges](https://gemarcade.com/developer/api/server#gemmatchserver-challenges)
+## GemMatchServer.challenges
 ```ts
 readonly challenges: ServerChallenges
@@ -4156,11 +4156,11 @@ board that player was actually given.
 A period is the PLAYER's, not the calendar's: it ends at their own
 midnight. That is why this takes a player id where the browser's
-`gem.challenges` takes none. See [ServerChallenges.list](https://gemarcade.com/developer/api/server#serverchallenges-list).
+`gem.challenges` takes none. See [ServerChallenges.list](#serverchallenges-list).
-## GemMatchServer.room
+<a id="gemmatchserver-room"></a>
-[GemMatchServer.room](https://gemarcade.com/developer/api/server#gemmatchserver-room)
+## GemMatchServer.room
 ```ts
 readonly room?: { get: (options?: { ifNoneMatch?: string; signal?: AbortSignal }) => Promise<VersionedResponse<GameRoomResponseV2>>; args: (options?: { signal?: AbortSignal }) => Promise<RoomArgsResponse> }
@@ -4174,9 +4174,9 @@ the type says it might be. `gem.room?.get()` is the shape to write. When it
 is absent the same reads are still available through `api` if you know the
 room id from somewhere else.
-## GemMatchServer.room.get
+<a id="gemmatchserver-room-get"></a>
-[GemMatchServer.room.get](https://gemarcade.com/developer/api/server#gemmatchserver-room-get)
+## GemMatchServer.room.get
 ```ts
 get: (options?: { ifNoneMatch?: string; signal?: AbortSignal }) => Promise<VersionedResponse<GameRoomResponseV2>>
@@ -4189,9 +4189,9 @@ avatar.
 This is what you want at `start()`, and it is a superset of what the older
 roster push carried.
-## GemMatchServer.room.args
+<a id="gemmatchserver-room-args"></a>
-[GemMatchServer.room.args](https://gemarcade.com/developer/api/server#gemmatchserver-room-args)
+## GemMatchServer.room.args
 ```ts
 args: (options?: { signal?: AbortSignal }) => Promise<RoomArgsResponse>
@@ -4204,9 +4204,9 @@ A room whose template declares no settings answers 404
 settings" and "this room's settings are empty" are different answers and
 the API keeps them apart.
-## GemMatchServer.dispose
+<a id="gemmatchserver-dispose"></a>
-[GemMatchServer.dispose](https://gemarcade.com/developer/api/server#gemmatchserver-dispose)
+## GemMatchServer.dispose
 ```ts
 dispose(): void
@@ -4214,13 +4214,13 @@ dispose(): void
 Stop listening for credential updates.
-You rarely need it: a bundle built with [defineServer](https://gemarcade.com/developer/api/server#defineserver) is disposed for
+You rarely need it: a bundle built with [defineServer](#defineserver) is disposed for
 you when the match ends. Call it in a test, or if you built the server
 yourself and are tearing it down.
-## GemMatchServer.sizeClass
+<a id="gemmatchserver-sizeclass"></a>
-[GemMatchServer.sizeClass](https://gemarcade.com/developer/api/server#gemmatchserver-sizeclass)
+## GemMatchServer.sizeClass
 ```ts
 readonly sizeClass: string
@@ -4230,9 +4230,9 @@ Which size of machine this server was allocated on.
 Useful if your game scales what it does to the hardware it got.
-## GemMatchServer.roomArgs
+<a id="gemmatchserver-roomargs"></a>
-[GemMatchServer.roomArgs](https://gemarcade.com/developer/api/server#gemmatchserver-roomargs)
+## GemMatchServer.roomArgs
 ```ts
 readonly roomArgs: Readonly<Record<string, RoomArgValue>> | undefined
@@ -4247,13 +4247,13 @@ and `4.0.0` is the earliest release that may take it off the type. Whether
 a server keeps sending a value is a separate question, decided where the
 dedicated-server image is built rather than by a package release — so check
 for the room read and keep this as the fallback. Both halves are in
-[the deprecation policy](https://gemarcade.com/developer/docs/deprecation-policy).
+[the deprecation policy](../deprecation-policy.md).
 The room's settings as they were at match start.
-## GemMatchServer.roster
+<a id="gemmatchserver-roster"></a>
-[GemMatchServer.roster](https://gemarcade.com/developer/api/server#gemmatchserver-roster)
+## GemMatchServer.roster
 ```ts
 readonly roster: readonly string[]
@@ -4267,7 +4267,7 @@ and `4.0.0` is the earliest release that may take it off the type. Whether
 a server keeps sending a value is a separate question, decided where the
 dedicated-server image is built rather than by a package release — so check
 for the room read and keep this as the fallback. Both halves are in
-[the deprecation policy](https://gemarcade.com/developer/docs/deprecation-policy).
+[the deprecation policy](../deprecation-policy.md).
 Who was in the room when the server was allocated.
@@ -4275,9 +4275,9 @@ A HINT FOR SIZING, NOT A GUEST LIST. It is never revised, and it is not what
 decides who may connect — the platform admits players by credential, not by
 this array.
-## GemMatchServer.players
+<a id="gemmatchserver-players"></a>
-[GemMatchServer.players](https://gemarcade.com/developer/api/server#gemmatchserver-players)
+## GemMatchServer.players
 ```ts
 players(): string[]
@@ -4285,9 +4285,9 @@ players(): string[]
 The players connected right now, as a fresh array each call.
-## GemMatchServer.profile
+<a id="gemmatchserver-profile"></a>
-[GemMatchServer.profile](https://gemarcade.com/developer/api/server#gemmatchserver-profile)
+## GemMatchServer.profile
 ```ts
 profile(playerId: string): GemServerProfile | null
@@ -4301,9 +4301,9 @@ for them.
 | `playerId` | `string` | Take this from `join()` or `players()`, never from something
   a client sent you. |
-## GemMatchServer.playerNumber
+<a id="gemmatchserver-playernumber"></a>
-[GemMatchServer.playerNumber](https://gemarcade.com/developer/api/server#gemmatchserver-playernumber)
+## GemMatchServer.playerNumber
 ```ts
 playerNumber(playerId: string): number | undefined
@@ -4319,9 +4319,9 @@ do not need to — handle the absence.
 | --- | --- |
 | `playerId` | `string` |
-## GemMatchServer.send
+<a id="gemmatchserver-send"></a>
-[GemMatchServer.send](https://gemarcade.com/developer/api/server#gemmatchserver-send)
+## GemMatchServer.send
 ```ts
 send(playerId: string, data: string | Uint8Array<ArrayBufferLike>, options?: SendOptions): void
@@ -4333,13 +4333,13 @@ Send to one player.
 | --- | --- | --- |
 | `playerId` | `string` | Who to send to. |
 | `data` | `string \| Uint8Array<ArrayBufferLike>` | A string or bytes. The receiver is told which. |
-| `options` | `SendOptions` | What delivery you are ASKING FOR — see [SendOptions](https://gemarcade.com/developer/api/server#sendoptions).
+| `options` | `SendOptions` | What delivery you are ASKING FOR — see [SendOptions](#sendoptions).
   Both default to true. Pass them freely: an older platform image ignores
   them harmlessly. |
-## GemMatchServer.broadcast
+<a id="gemmatchserver-broadcast"></a>
-[GemMatchServer.broadcast](https://gemarcade.com/developer/api/server#gemmatchserver-broadcast)
+## GemMatchServer.broadcast
 ```ts
 broadcast(data: string | Uint8Array<ArrayBufferLike>, options?: BroadcastOptions): void
@@ -4350,12 +4350,12 @@ Send to every connected player.
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `data` | `string \| Uint8Array<ArrayBufferLike>` | A string or bytes. |
-| `options` | `BroadcastOptions` | See [BroadcastOptions](https://gemarcade.com/developer/api/server#broadcastoptions) — the same delivery choices as
-  [GemMatchServer.send](https://gemarcade.com/developer/api/server#gemmatchserver-send), plus who to leave out. |
+| `options` | `BroadcastOptions` | See [BroadcastOptions](#broadcastoptions) — the same delivery choices as
+  [GemMatchServer.send](#gemmatchserver-send), plus who to leave out. |
-## GemMatchServer.kick
+<a id="gemmatchserver-kick"></a>
-[GemMatchServer.kick](https://gemarcade.com/developer/api/server#gemmatchserver-kick)
+## GemMatchServer.kick
 ```ts
 kick(playerId: string, reason?: string): void
@@ -4368,9 +4368,9 @@ Disconnect a player.
 | `playerId` | `string` | Who to remove. |
 | `reason` | `string` | Shown to them, and recorded in the match's logs. |
-## GemMatchServer.log
+<a id="gemmatchserver-log"></a>
-[GemMatchServer.log](https://gemarcade.com/developer/api/server#gemmatchserver-log)
+## GemMatchServer.log
 ```ts
 log(message: string): void
@@ -4386,15 +4386,15 @@ corrupts that conversation.
 | --- | --- |
 | `message` | `string` |
-## GemMatchServer.warn
+<a id="gemmatchserver-warn"></a>
-[GemMatchServer.warn](https://gemarcade.com/developer/api/server#gemmatchserver-warn)
+## GemMatchServer.warn
 ```ts
 warn(message: string): void
 ```
-Like [GemMatchServer.log](https://gemarcade.com/developer/api/server#gemmatchserver-log), marked as a warning.
+Like [GemMatchServer.log](#gemmatchserver-log), marked as a warning.
 | Parameter | Type |
 | --- | --- |