@diffenderfer-games/hub 2.0.0-next.0 → 2.0.0-next.2

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# @diffenderfer-games/hub
+
+## 2.0.0-next.2
+
+### Minor Changes
+
+- 3944819: `game.labels`: say what kind of game yours is, from a fixed vocabulary (`GAME_LABELS`, with display names in `GAME_LABEL_TITLES`, grouped in `GAME_LABEL_GROUPS`): genre (`cards`, `board`, `puzzle`, `arcade`, `platformer`, `real-time-strategy`, `physics`, `typing`, `word`, `sports`, `racing`), look (`2d`, `3d`), where it plays (`phone`, `controller`, `desktop`) and players (`multiplayer`, `single-player`). The home page filters by them. An unknown label is a `hub-doctor` warning, not an error.
+  
+  New endpoints: `GET /catalog/players` (how many accounts and guests have each game open right now: counts only) and `GET /games/:slug/me/activity` (the signed-in player's plays and minutes in a game). The `lobbyOpen` notification preference now means "tell me when people want to play": an open public lobby or race, or a tournament opening.
+- 937d61e: Explicit offline replay. Writes made offline now go into a typed operation outbox in `localStorage`: each op has a kind whose handler performs it (several dependent calls can be one op), ops replay in order with backoff when the hub is back and after a reload, one tab replays at a time, and the outbox is capped. Saves, stats, scores, the profile, daily completions, inventory grants and house exchanges, and starring a game all queue offline. Games add their own kinds with `hub.offline.define(kind, handler)`, queue them with `hub.offline.enqueue(kind, payload)`, list them with `hub.offline.pending()`, and hear `queued`, `replayed` and `failed` through `hub.offline.on(...)` (and `hub:offline-*` window events). An offline `hub.daily.complete()` resolves `null`, fires `hub:daily-queued`, and replays later. The contract marks the endpoints that may be replayed (`OFFLINE_REPLAY_ENDPOINTS`); each replayed call carries an operation key (`x-hub-op`) and the hub runs it once per key. `SyncConflict.op` is now the dropped outbox op.
+- ed68402: Invite links and resilient online games (batch 2026-10, R13 and R14).
+  
+  - **Invite links:** `hub.mp.inviteLink()` makes (or reuses) a shareable link to the room the player is in; `hub.mp.revokeInviteLink(token)` revokes it. Opening `/<slug>/<lobby>?hub_link=<token>` arrives as an ordinary `join` or `watch` launch with `via: 'link'`. Contract: `POST /mp/links`, `GET /mp/links`, `DELETE /mp/links/:token`, `POST /mp/links/:token/open`, the `InviteLink` shape and the `link_invalid`, `link_room_gone` and `too_many_links` error codes.
+  - **Resilient rooms:** the new `room.seat` event (`room.on('seat', …)`: `away` with `graceEndsAt`, `back`, `gone` with `reason`), `room.seats()`, `hub.rooms.reclaim()` (socket op `room.reclaim`), seats' `graceEndsAt`, and `Launch.via` (`'link' | 'rejoin'`). The host role now passes on instead of the room closing with `host_left`: once the host's seat is freed by default, or as soon as the host drops with `hub.rooms.create({ hostMigration: 'drop' })`.
+  - The realtime feature version is 3; on an older runtime the new methods reject with `OfflineError` asking for a reload.
+- 5b68831: Tournaments (docs/multiplayer.md §15). `game.multiplayer.tournaments: true` says a game plays 1v1 tournament matches and reports their winner; race games need nothing. A ready match reaches the game as an ordinary `host`/`guest` launch with the new `launch.tournament` (`{ id, title, match, opponent }`); a hub-room game ends it with `room.end({ winnerId })`, an own-server game posts results with `tournament: { id, match }`.
+  
+  New endpoints: `GET /play-online` (lobbies waiting for a player, invites, my tournaments, open ones coming up), `GET|POST /tournaments`, `GET|DELETE /tournaments/:id`, `POST /tournaments/:id/join|leave|start|invites`, `PUT|DELETE /tournaments/:id/follow` and `POST /tournaments/:id/matches/:match/launch`; the `tournament` socket event; the `tournament` notice kind; `GameInfo.tournaments`; `TOURNAMENT_LIMITS`. `hub.social.openPlayOnline()` opens the hub's Play online window (realtime feature version 4).
+
+### Patch Changes
+
+- `hub.input.axis(name)` reads a vertical-only axis (`axes: { paddle: { y: ['up', 'down'] } }`); it used to read 0.
+- A save, profile or score meta with an optional field set to `undefined` is stored and sent as the JSON it stands for (the field left out); with the new outbox it was refused as "Malformed offline operation payload" and never reached the hub.
+- Updated dependencies [3944819]
+- Updated dependencies [937d61e]
+- Updated dependencies [ed68402]
+- Updated dependencies [5b68831]
+  - @diffenderfer-games/hub-contract@2.0.0-next.2
+
+## 2.0.0-next.1
+
+### Patch Changes
+
+- Follow-ups from the Bubble Pop pilot. `hub-doctor` gives up after `--timeout` ms (default 10 s) and fails with `hub unreachable at <url>` instead of hanging. A v1 vendored singleton adopted on the page is now recorded in `window.__DG__` as `{ version: 'v1' }`. The README covers exact pins for prereleases, sharing the page with the host's `/_hub/hub.js`, and testing against the hub.
+- Updated dependencies
+  - @diffenderfer-games/hub-contract@2.0.0-next.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Philip Diffenderfer
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Philip Diffenderfer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,139 +1,206 @@
-# @diffenderfer-games/hub
-
-The client library for games on [diffenderfer.games](https://diffenderfer.games):
-accounts, saves, stats, leaderboards, inventory and trades, daily challenges,
-the input system (keyboard, touch and gamepad), and the social, multiplayer,
-rooms and race namespaces. It is typed from the hub's wire contract
-(`@diffenderfer-games/hub-contract`), ships ES modules with `.d.ts` files, and
-carries no zod at runtime.
-
-## Install
-
-```sh
-npm install @diffenderfer-games/hub
-```
-
-ESM only, for browsers (ES2020: Safari 14+, current Chrome, Edge and Firefox).
-Node 20+ for the `hub-doctor` command.
-
-## Use
-
-```ts
-import { hub } from '@diffenderfer-games/hub';
-
-const { user } = await hub.me();
-await hub.ensureGuest(); // a guest account, so progress saves without a sign-in
-await hub.putSave('auto', { level: 7, gold: 120 });
-await hub.submitScore('highscore', 9001, { title: 'High Score' });
-hub.recordPlay();
-
-hub.input.define({ groups: { play: { inputs: { jump: { keys: [' '], gamepad: { button: 0 } } } } } });
-hub.input.enable('play');
-hub.daily.define({ play: (challenge) => startLevel(challenge.seed) });
-hub.overlay.autoPause({ pause, resume });
-```
-
-In a game the host serves, the slug and the API base are read from the page.
-For anything else, create a client yourself:
-
-```ts
-import { createHub } from '@diffenderfer-games/hub';
-
-const demo = createHub({ slug: 'my-game', apiBase: '/_api', offline: 'auto' });
-```
-
-A game's own JSON is typed by the game: `hub.getSave<MySave>('auto')`,
-`hub.putSave<MySave>('auto', save)`, `hub.getProfile<MyProfile>()`.
-
-## Entry points
-
-| Import | What it has |
-|---|---|
-| `@diffenderfer-games/hub` | `hub`, `createHub`, `Hub`, the errors, every client type, and the input and daily exports |
-| `@diffenderfer-games/hub/input` | `getInput`, `InputSystem`, the on-screen control layout, `getUiStack` |
-| `@diffenderfer-games/hub/daily` | `getDaily`, `DailySystem` |
-| `@diffenderfer-games/hub/race`, `/social`, `/mp`, `/rooms` | one namespace each (`race`, `social` with `presence` and `notify`, `mp`, `rooms`) |
-| `@diffenderfer-games/hub/types` | type-only: every contract type (requests, replies, entities, error codes, socket ops and events, the `game.*` manifest) |
-| `@diffenderfer-games/hub/auto` | everything above, and it sets `window.HubSDK` (what `/_hub/hub.js` is built from) |
-
-The namespaces also hang off `hub` (`hub.input`, `hub.daily`, `hub.race`,
-`hub.social`, `hub.presence`, `hub.notify`, `hub.mp`, `hub.rooms`,
-`hub.overlay`, `hub.menu`), created on first use.
-
-## Errors
-
-Every call rejects with a `HubError` when it fails. `status` is the HTTP
-status, or `undefined` when the hub could not be reached (`isOffline`).
-`code`, `reason`, `hint` and `retryAfterMs` come from the hub's error body.
-
-- `ContentRejectedError`: the safety filter refused some text (HTTP 422).
-  Keep the player's draft and show `hint`.
-- `OfflineError`: an action that needs the hub was tried offline.
-- `code: 'unsupported_by_hub'`: the hub does not have this call yet (the game
-  uses a newer client than the deployed hub). Deploy the hub first.
-
-The analytics calls (`recordPlay`, `heartbeat`, `event`) never throw.
-
-## Offline
-
-With `offline: 'auto'` (the default), reads fall back to a cache in
-`localStorage` when the hub can't be reached, and writes (saves, stats,
-scores, profile) apply to the cache at once and are queued. The queue replays
-in order when the connection returns; `hub.sync()` replays it on demand,
-`hub.pending()` counts what waits, and `hub.onStatus(listener)` reports
-changes. `hub.prefetchAll()` warms the cache for every game in one request.
-`offline: 'always'` never touches the network (develop without a hub);
-`offline: 'never'` always throws instead.
-
-The cache and queue use the same `localStorage` keys as the old vendored
-client, so a game that switches to this package keeps its players' queued
-progress.
-
-## Games without a build step
-
-Keep `import('/_hub/hub.js')` or `window.HubSDK.hub`: the host serves a
-bundle of this package's `./auto` entry, at the version the host was built
-with. Install the package as a dev dependency only if you want editor types:
-
-```js
-/** @type {import('@diffenderfer-games/hub').Hub} */
-const hub = window.HubSDK.hub;
-```
-
-## Versions
-
-The client sends its version as `x-hub-client`. `hub.hubVersion()` reads the
-hub's `GET /_api/version` (`{ server, contract, supported, deprecated }`) once
-per page, and `hub.clientSupport()` says whether this client is `supported`,
-`deprecated` or `unsupported` (`unknown` on a hub from before versioning).
-
-The hub supports the current major and the previous one. Update with
-`npm update @diffenderfer-games/hub`.
-
-## hub-doctor
-
-Run it in a game's folder, in CI and before pushing:
-
-```sh
-npx hub-doctor            # checks against https://diffenderfer.games
-npx hub-doctor --offline  # skip the version check
-npx hub-doctor --hub http://localhost:8080 --dir ../my-game --json
-```
-
-It fails when the installed client is outside the hub's `supported` range or
-the `package.json` `game.*` block does not match the manifest schema, and it
-warns when the client is deprecated or a vendored `src/hub/` copy (or
-`scripts/sync-hub.mjs`) is still around.
-
-## Moving from the vendored copy
-
-1. `npm install @diffenderfer-games/hub`.
-2. Change `from './hub/hub'` (or `'./hub'`) to `from '@diffenderfer-games/hub'`.
-3. Delete `src/hub/` and `scripts/sync-hub.mjs`.
-4. Add `npx hub-doctor` to the game's CI.
-
-Every method name is unchanged.
-
-## License
-
-MIT
+# @diffenderfer-games/hub
+
+The client library for games on [diffenderfer.games](https://diffenderfer.games):
+accounts, saves, stats, leaderboards, inventory and trades, daily challenges,
+the input system (keyboard, touch and gamepad), and the social, multiplayer,
+rooms and race namespaces. It is typed from the hub's wire contract
+(`@diffenderfer-games/hub-contract`), ships ES modules with `.d.ts` files, and
+carries no zod at runtime.
+
+## Install
+
+```sh
+npm install @diffenderfer-games/hub
+```
+
+**Prereleases: pin the exact version.** While the package is on `2.0.0-next.N`,
+a caret range does not move between prereleases the way you might expect, so
+install with `--save-exact` and bump on purpose:
+
+```sh
+npm install --save-exact @diffenderfer-games/hub@2.0.0-next.1
+```
+
+The `next` dist-tag always names the newest prerelease. `latest` points at the
+same prerelease for now. It moves to `2.0.0` with the first stable release,
+after which ordinary `^2.0.0` ranges are fine.
+
+ESM only, for browsers (ES2020: Safari 14+, current Chrome, Edge and Firefox).
+Node 20+ for the `hub-doctor` command.
+
+## Use
+
+```ts
+import { hub } from '@diffenderfer-games/hub';
+
+const { user } = await hub.me();
+await hub.ensureGuest(); // a guest account, so progress saves without a sign-in
+await hub.putSave('auto', { level: 7, gold: 120 });
+await hub.submitScore('highscore', 9001, { title: 'High Score' });
+hub.recordPlay();
+
+hub.input.define({ groups: { play: { inputs: { jump: { keys: [' '], gamepad: { button: 0 } } } } } });
+hub.input.enable('play');
+hub.daily.define({ play: (challenge) => startLevel(challenge.seed) });
+hub.overlay.autoPause({ pause, resume });
+```
+
+In a game the host serves, the slug and the API base are read from the page.
+For anything else, create a client yourself:
+
+```ts
+import { createHub } from '@diffenderfer-games/hub';
+
+const demo = createHub({ slug: 'my-game', apiBase: '/_api', offline: 'auto' });
+```
+
+A game's own JSON is typed by the game: `hub.getSave<MySave>('auto')`,
+`hub.putSave<MySave>('auto', save)`, `hub.getProfile<MyProfile>()`.
+
+## Entry points
+
+| Import | What it has |
+|---|---|
+| `@diffenderfer-games/hub` | `hub`, `createHub`, `Hub`, the errors, every client type, and the input and daily exports |
+| `@diffenderfer-games/hub/input` | `getInput`, `InputSystem`, the on-screen control layout, `getUiStack` |
+| `@diffenderfer-games/hub/daily` | `getDaily`, `DailySystem` |
+| `@diffenderfer-games/hub/race`, `/social`, `/mp`, `/rooms` | one namespace each (`race`, `social` with `presence` and `notify`, `mp`, `rooms`) |
+| `@diffenderfer-games/hub/types` | type-only: every contract type (requests, replies, entities, error codes, socket ops and events, the `game.*` manifest) |
+| `@diffenderfer-games/hub/auto` | everything above, and it sets `window.HubSDK` (what `/_hub/hub.js` is built from) |
+
+The namespaces also hang off `hub` (`hub.input`, `hub.daily`, `hub.race`,
+`hub.social`, `hub.presence`, `hub.notify`, `hub.mp`, `hub.rooms`,
+`hub.overlay`, `hub.menu`), created on first use.
+
+## Errors
+
+Every call rejects with a `HubError` when it fails. `status` is the HTTP
+status, or `undefined` when the hub could not be reached (`isOffline`).
+`code`, `reason`, `hint` and `retryAfterMs` come from the hub's error body.
+
+- `ContentRejectedError`: the safety filter refused some text (HTTP 422).
+  Keep the player's draft and show `hint`.
+- `OfflineError`: an action that needs the hub was tried offline.
+- `code: 'unsupported_by_hub'`: the hub does not have this call yet (the game
+  uses a newer client than the deployed hub). Deploy the hub first.
+
+The analytics calls (`recordPlay`, `heartbeat`, `event`) never throw.
+
+## Offline
+
+With `offline: 'auto'` (the default), reads fall back to a cache in
+`localStorage` when the hub can't be reached, and writes (saves, stats,
+scores, profile, daily completions, inventory grants and exchanges, stars)
+apply to the cache at once and are queued in an outbox. The outbox replays
+in order when the connection returns (and after a reload), one tab at a
+time, and the hub applies each replayed call once. `hub.sync()` replays it
+on demand, `hub.pending()` counts what waits, and `hub.onStatus(listener)`
+reports changes. `hub.prefetchAll()` warms the cache for every game in one
+request. `offline: 'always'` never touches the network (develop without a
+hub); `offline: 'never'` always throws instead.
+
+Queue your own operations, with a handler that may make several dependent
+calls:
+
+```ts
+hub.offline.define<{ score: number }>('my-game.finish', async (run, context) => {
+  const { rank } = await context.call('submitScore', { slug: 'my-game', key: 'runs', score: run.score });
+  await context.call('updateGameStat', { slug: 'my-game', key: 'best-rank', value: rank ?? 0, mode: 'max' });
+});
+hub.offline.enqueue('my-game.finish', { score: 4200 });
+hub.offline.on('failed', ({ op, error }) => console.warn(op.kind, error));
+```
+
+The full rules (what replays, ordering, retries, the size cap) are in the
+hub docs' "Offline and replay" section. The cache keeps the old vendored
+client's `localStorage` keys, and its queue moves into the outbox, so a game
+that switches to this package keeps its players' queued progress.
+
+## Games without a build step
+
+Keep `import('/_hub/hub.js')` or `window.HubSDK.hub`: the host serves a
+bundle of this package's `./auto` entry, at the version the host was built
+with. Install the package as a dev dependency only if you want editor types:
+
+```js
+/** @type {import('@diffenderfer-games/hub').Hub} */
+const hub = window.HubSDK.hub;
+```
+
+## Sharing the page with the host's `/_hub/hub.js`
+
+Every game page also gets the host's menu and social runtime, which use the
+host's own copy of this client (`/_hub/hub.js`, built from the version the host
+was deployed with). Your bundled copy and the host's cooperate. The page-wide
+pieces (the input system, daily challenges, the realtime API) are registered
+once on `window.__DG__`, each with the version that created it:
+
+- **Same shape** (the usual case): the first one wins and both copies share
+  it, so an older patch version on either side is harmless.
+- **A different shape** (a major change): your game's copy owns input and
+  daily; the host's runtime owns realtime. The mismatch is logged once in the
+  console with the fix: `npm update @diffenderfer-games/hub`.
+- **A v1 vendored copy** already on the page is shared too, and recorded as
+  `{ version: 'v1' }`.
+
+The v1 globals (`window.__HUB_INPUT__`, `__HUB_DAILY__`, `__HUB_RT__`) stay as
+aliases. Don't create your own singletons; `hub.input`, `hub.daily` and the
+forwarders always return the shared ones.
+
+## Versions
+
+The client sends its version as `x-hub-client`. `hub.hubVersion()` reads the
+hub's `GET /_api/version` (`{ server, contract, supported, deprecated }`) once
+per page, and `hub.clientSupport()` says whether this client is `supported`,
+`deprecated` or `unsupported` (`unknown` on a hub from before versioning).
+
+The hub supports the current major and the previous one. Update with
+`npm update @diffenderfer-games/hub`.
+
+## hub-doctor
+
+Run it in a game's folder, in CI and before pushing:
+
+```sh
+npx hub-doctor                 # checks against https://diffenderfer.games
+npx hub-doctor --offline       # skip the version check
+npx hub-doctor --timeout 5000  # wait at most 5 s for the hub (default 10 s)
+npx hub-doctor --hub http://localhost:8080 --dir ../my-game --json
+```
+
+An unreachable or slow hub is an error (`hub unreachable at <url> (...)`) and
+exits non-zero, so CI notices. Use `--offline` where CI has no network.
+
+It fails when the installed client is outside the hub's `supported` range or
+the `package.json` `game.*` block does not match the manifest schema, and it
+warns when the client is deprecated or a vendored `src/hub/` copy (or
+`scripts/sync-hub.mjs`) is still around.
+
+## Testing your game against the hub
+
+The hub's test kit lives in the host repo (`test/helpers/`). Point your
+game's tests at a checkout of it with `DG_HOST`; the default is
+`../diffenderfer-games`. It boots a real hub on a free port for each test
+file:
+
+```sh
+DG_HOST=../diffenderfer-games HUB_IMPL=next npm run test:hub
+```
+
+`HUB_IMPL=next` runs the TypeScript hub and host that production runs. Without
+it, the kit boots the old hub (`src/index.js`), which is kept only as a
+rollback path until it is deleted; test against `next`. The checkout needs
+`npm ci` at its root and in `next/`.
+
+## Moving from the vendored copy
+
+1. `npm install @diffenderfer-games/hub`.
+2. Change `from './hub/hub'` (or `'./hub'`) to `from '@diffenderfer-games/hub'`.
+3. Delete `src/hub/` and `scripts/sync-hub.mjs`.
+4. Add `npx hub-doctor` to the game's CI.
+
+Every method name is unchanged.
+
+## License
+
+MIT

package/dist/auto.d.ts

@@ -1,14 +1,14 @@
-import { a as RaceResultPlayer, c as RoomChatLine, d as RoomStateChange, f as SchemaOutput, i as RaceRecordPlayer, l as RoomMessage, m as Snapshot, n as Notice, o as RaceStatusEvent, p as ServerEvents, r as RaceHistory, s as RealtimeErrorShape, t as InviteCreated, u as RoomSeat } from "./shared/wire-types.js";
+import { a as RaceRecordPlayer, c as RealtimeErrorShape, d as RoomSeat, f as RoomSeatChange, g as Snapshot, h as ServerEvents, i as RaceHistory, l as RoomChatLine, m as SchemaOutput, n as InviteLink, o as RaceResultPlayer, p as RoomStateChange, r as Notice, s as RaceStatusEvent, t as InviteCreated, u as RoomMessage } from "./shared/wire-types.js";
 import { _ as DailyStatus, a as isDailySystem, c as DailyAll, d as DailyCompletionMeta, f as DailyDefinition, g as DailyStartResponse, h as DailyHost, i as getDaily, l as DailyChallenge, m as DailyGameStatus, n as DailyCompletions, o as DAILY_START_EVENT, p as DailyEventDetail, r as DAILY_SINGLETON_API, s as DailySystem, t as DailyCompletion, u as DailyCompleteResponse } from "./shared/daily.js";
 import { $ as VirtualControlType, A as AxisSide, B as InputReading, C as parseInputOverrides, D as isPageInputControl, E as PageInputControl, F as InputConfig, G as NavElement, H as MenuBridge, I as InputDef, J as NavTarget, K as NavElementKind, L as InputEvents, M as EdgeOffsets, N as GamepadMapping, O as Anchor, P as GroupDef, Q as Vector, R as InputHost, S as isInputSystem, T as InputSystemOptions, U as MouseMapping, V as InputSource, W as NavBlurEvent, X as Rect, Y as NavigableDef, Z as TouchMapping, _ as boxesTouch, a as OverlayEdge, b as InputOptions, c as OverlayReason, d as LayoutOptions, et as VirtualDef, f as layoutControls, g as LayoutItem, h as LayoutBox, i as AutoPauseOptions, j as DraggedSpot, k as AxisDef, l as UiStack, m as Insets, n as getUiStack, nt as VirtualOverride, o as OverlayEvent, p as Overlay, q as NavFocusEvent, r as isUiStack, s as OverlayListener, t as UI_STACK_VERSION, tt as VirtualInputs, u as UiStackHandoff, v as controlSize, w as InputSystem, x as getInput, y as INPUT_SINGLETON_API, z as InputOverrides } from "./shared/input.js";
-import { a as JoinInfoEvent, i as InviteResult, n as HubMpApi, r as InviteOptions, t as BusyOptions } from "./shared/multiplayer-types.js";
+import { a as InviteResult, i as InviteOptions, n as HubMpApi, o as JoinInfoEvent, r as InviteLinkMethods, t as BusyOptions } from "./shared/multiplayer-types.js";
 import { o as multiplayerForwarder } from "./shared/mp.js";
-import { a as RoomEvents, c as RoomSendOptions, i as RoomCreateOptions, l as RoomState, n as HubRoomsApi, o as RoomListOptions, r as JoinOptions, s as RoomSelf, t as HubRoom, u as RoomStateOptions } from "./shared/room-types.js";
+import { a as RoomEvents, c as RoomSelf, d as RoomStateOptions, i as RoomCreateOptions, l as RoomSendOptions, n as HubRoomsApi, o as RoomListOptions, r as JoinOptions, s as RoomReclaimMethods, t as HubRoom, u as RoomState } from "./shared/room-types.js";
 import { a as RaceHistoryQuery, c as RaceRuntimeApi, i as RaceEvents, l as RaceStart, n as RaceCreateOptions, o as RaceHistoryViewOptions, r as RaceDefinition, s as RaceHudPlace, t as HubRaceApi } from "./shared/race-types.js";
 import { f as raceForwarder } from "./shared/race.js";
 import { n as roomsForwarder } from "./shared/rooms.js";
-import { $ as HubNotifyApi, A as RacerState, B as SuggestionStatus, C as RaceRecord, D as RaceStats, E as RaceState, F as ReportReason, G as REALTIME_READY_EVENT, H as isRealtimeApi, I as RoomInfo, J as RealtimeHubLink, K as REALTIME_SINGLETON_API, L as SocialConfig, M as Relation, N as ReportInput, O as Racer, P as ReportKind, Q as socialForwarder, R as SocialMe, S as RaceParams, T as RaceStatValue, U as REALTIME_FAILED_EVENT, V as findRealtimeApi, W as REALTIME_FEATURE_VERSION, X as notifyForwarder, Y as linkRealtimeToHub, Z as presenceForwarder, _ as PlayerLite, a as ErrorBody, at as SocialEvents, b as PresenceKind, c as JoinInfo, d as Message, et as HubPresenceApi, f as MessagesPage, g as PlayerCard, h as Party, i as Counts, it as SocialCounts, j as RecentPlayer, k as RacerResult, l as Launch, m as NotifyPrefs, n as ChatMode, nt as OpenInviteOptions, o as FriendEntry, p as NotifyChange, q as RealtimeApi, r as Conversation, rt as PlayerRef, s as Invite, t as Audience, tt as HubSocialApi, u as LaunchTicket, v as Presence, w as RaceResult, x as RaceOutcome, y as PresenceInput, z as Suggestion } from "./shared/social.js";
-import { $ as SubmitScoreResult, A as BoardWithTop, B as Json, C as CLIENT_VERSION_HEADER, D as QueuedScoreOptions, E as QueueOpInput, F as GlobalAnalytics, G as Profile, H as LeaderboardResult, I as HubOptions, J as SaveMeta, K as ProfileSummary, L as HubStatus, M as GameInfo, N as GameLeaderboards, O as BufferedEvent, P as GameRecords, Q as SubmitScoreOptions, R as Inventory, S as SyncResult, T as QueueOp, U as MeResponse, V as LeaderboardEntry, W as Metrics, X as SortDir, Y as SnapshotResponse, Z as Stats, _ as TradeNoteOptions, a as HubErrorDetails, b as StatResult, c as Hub, d as ClientSupport, et as User, f as HubMenuControl, g as TradeListOptions, h as TradeId, i as HubErrorCode, it as GamePayload, j as GameAnalytics, k as Board, l as createHub, m as TradeBundle, n as ContentRejectedError, nt as EndpointName, o as OfflineError, p as GrantBundle, q as Save, r as HubError, rt as EndpointReply, s as UNSUPPORTED_BY_HUB, t as HUB_CLIENT_VERSION, tt as EndpointFields, u as hub, v as AuthResponse, w as ProfilePatch, x as SyncConflict, y as ProfileUpdate, z as InventorySnapshot } from "./shared/index.js";
+import { $ as HubNotifyApi, A as RacerState, B as SuggestionStatus, C as RaceRecord, D as RaceStats, E as RaceState, F as ReportReason, G as REALTIME_READY_EVENT, H as isRealtimeApi, I as RoomInfo, J as RealtimeHubLink, K as REALTIME_SINGLETON_API, L as SocialConfig, M as Relation, N as ReportInput, O as Racer, P as ReportKind, Q as socialForwarder, R as SocialMe, S as RaceParams, T as RaceStatValue, U as REALTIME_FAILED_EVENT, V as findRealtimeApi, W as REALTIME_FEATURE_VERSION, X as notifyForwarder, Y as linkRealtimeToHub, Z as presenceForwarder, _ as PlayerLite, a as ErrorBody, at as SocialCounts, b as PresenceKind, c as JoinInfo, d as Message, et as HubPresenceApi, f as MessagesPage, g as PlayerCard, h as Party, i as Counts, it as PlayerRef, j as RecentPlayer, k as RacerResult, l as Launch, m as NotifyPrefs, n as ChatMode, nt as OpenInviteOptions, o as FriendEntry, ot as SocialEvents, p as NotifyChange, q as RealtimeApi, r as Conversation, rt as PlayOnlineMethods, s as Invite, t as Audience, tt as HubSocialApi, u as LaunchTicket, v as Presence, w as RaceResult, x as RaceOutcome, y as PresenceInput, z as Suggestion } from "./shared/social.js";
+import { $ as LeaderboardResult, A as OUTBOX_MAX_ENTRIES, B as Board, C as OfflineApi, D as OfflineListener, E as OfflineEventName, F as ProfilePatch, G as GameRecords, H as GameAnalytics, I as QueueOp, J as HubStatus, K as GlobalAnalytics, L as QueueOpInput, M as OfflineKindDefinition, N as ReplayContext, O as OfflineOp, P as CLIENT_VERSION_HEADER, Q as LeaderboardEntry, R as QueuedScoreOptions, S as SyncResult, T as OfflineEventDetails, U as GameInfo, V as BoardWithTop, W as GameLeaderboards, X as InventorySnapshot, Y as Inventory, Z as Json, _ as TradeNoteOptions, a as HubErrorDetails, at as SaveMeta, b as StatResult, c as Hub, ct as Stats, d as ClientSupport, dt as User, et as MeResponse, f as HubMenuControl, ft as EndpointFields, g as TradeListOptions, h as TradeId, ht as GamePayload, i as HubErrorCode, it as Save, j as OfflineHandler, k as OUTBOX_MAX_CHARS, l as createHub, lt as SubmitScoreOptions, m as TradeBundle, mt as EndpointReply, n as ContentRejectedError, nt as Profile, o as OfflineError, ot as SnapshotResponse, p as GrantBundle, pt as EndpointName, q as HubOptions, r as HubError, rt as ProfileSummary, s as UNSUPPORTED_BY_HUB, st as SortDir, t as HUB_CLIENT_VERSION, tt as Metrics, u as hub, ut as SubmitScoreResult, v as AuthResponse, w as OUTBOX_FULL_CODE, x as SyncConflict, y as ProfileUpdate, z as BufferedEvent } from "./shared/index.js";
 //#region src/auto.d.ts
 /** What `window.HubSDK` holds. */
 export interface HubSdkGlobal {
@@ -32,5 +32,5 @@ declare global {
   }
 }
 //#endregion
-export { type Anchor, type Audience, type AuthResponse, type AutoPauseOptions, type AxisDef, type AxisSide, type Board, type BoardWithTop, type BufferedEvent, type BusyOptions, CLIENT_VERSION_HEADER, type ChatMode, type ClientSupport, ContentRejectedError, type Conversation, type Counts, DAILY_SINGLETON_API, DAILY_START_EVENT, type DailyAll, type DailyChallenge, type DailyCompleteResponse, type DailyCompletion, type DailyCompletionMeta, type DailyCompletions, type DailyDefinition, type DailyEventDetail, type DailyGameStatus, type DailyHost, type DailyStartResponse, type DailyStatus, DailySystem, type DraggedSpot, type EdgeOffsets, type EndpointFields, type EndpointName, type EndpointReply, type ErrorBody, type FriendEntry, type GameAnalytics, type GameInfo, type GameLeaderboards, type GamePayload, type GameRecords, type GamepadMapping, type GlobalAnalytics, type GrantBundle, type GroupDef, HUB_CLIENT_VERSION, Hub, HubError, type HubErrorCode, type HubErrorDetails, type HubMenuControl, type HubMpApi, type HubNotifyApi, type HubOptions, type HubPresenceApi, type HubRaceApi, type HubRoom, type HubRoomsApi, type HubSocialApi, type HubStatus, INPUT_SINGLETON_API, type InputConfig, type InputDef, type InputEvents, type InputHost, type InputOptions, type InputOverrides, type InputReading, type InputSource, InputSystem, type InputSystemOptions, type Insets, type Inventory, type InventorySnapshot, type Invite, type InviteCreated, type InviteOptions, type InviteResult, type JoinInfo, type JoinInfoEvent, type JoinOptions, type Json, type Launch, type LaunchTicket, type LayoutBox, type LayoutItem, type LayoutOptions, type LeaderboardEntry, type LeaderboardResult, type MeResponse, type MenuBridge, type Message, type MessagesPage, type Metrics, type MouseMapping, type NavBlurEvent, type NavElement, type NavElementKind, type NavFocusEvent, type NavTarget, type NavigableDef, type Notice, type NotifyChange, type NotifyPrefs, OfflineError, type OpenInviteOptions, Overlay, type OverlayEdge, type OverlayEvent, type OverlayListener, type OverlayReason, type PageInputControl, type Party, type PlayerCard, type PlayerLite, type PlayerRef, type Presence, type PresenceInput, type PresenceKind, type Profile, type ProfilePatch, type ProfileSummary, type ProfileUpdate, type QueueOp, type QueueOpInput, type QueuedScoreOptions, type REALTIME_FAILED_EVENT, type REALTIME_FEATURE_VERSION, type REALTIME_READY_EVENT, type REALTIME_SINGLETON_API, type RaceCreateOptions, type RaceDefinition, type RaceEvents, type RaceHistory, type RaceHistoryQuery, type RaceHistoryViewOptions, type RaceHudPlace, type RaceOutcome, type RaceParams, type RaceRecord, type RaceRecordPlayer, type RaceResult, type RaceResultPlayer, type RaceRuntimeApi, type RaceStart, type RaceStatValue, type RaceState, type RaceStats, type RaceStatusEvent, type Racer, type RacerResult, type RacerState, type RealtimeApi, type RealtimeErrorShape, type RealtimeHubLink, type RecentPlayer, type Rect, type Relation, type ReportInput, type ReportKind, type ReportReason, type RoomChatLine, type RoomCreateOptions, type RoomEvents, type RoomInfo, type RoomListOptions, type RoomMessage, type RoomSeat, type RoomSelf, type RoomSendOptions, type RoomState, type RoomStateChange, type RoomStateOptions, type Save, type SaveMeta, type SchemaOutput, type ServerEvents, type Snapshot, type SnapshotResponse, type SocialConfig, type SocialCounts, type SocialEvents, type SocialMe, type SortDir, type StatResult, type Stats, type SubmitScoreOptions, type SubmitScoreResult, type Suggestion, type SuggestionStatus, type SyncConflict, type SyncResult, type TouchMapping, type TradeBundle, type TradeId, type TradeListOptions, type TradeNoteOptions, UI_STACK_VERSION, UNSUPPORTED_BY_HUB, type UiStack, type UiStackHandoff, type User, type Vector, type VirtualControlType, type VirtualDef, type VirtualInputs, type VirtualOverride, boxesTouch, controlSize, createHub, type findRealtimeApi, getDaily, getInput, getUiStack, hub, isDailySystem, isInputSystem, isPageInputControl, type isRealtimeApi, isUiStack, layoutControls, type linkRealtimeToHub, type multiplayerForwarder as mp, type notifyForwarder as notify, parseInputOverrides, type presenceForwarder as presence, type raceForwarder as race, type roomsForwarder as rooms, type socialForwarder as social };
+export { type Anchor, type Audience, type AuthResponse, type AutoPauseOptions, type AxisDef, type AxisSide, type Board, type BoardWithTop, type BufferedEvent, type BusyOptions, CLIENT_VERSION_HEADER, type ChatMode, type ClientSupport, ContentRejectedError, type Conversation, type Counts, DAILY_SINGLETON_API, DAILY_START_EVENT, type DailyAll, type DailyChallenge, type DailyCompleteResponse, type DailyCompletion, type DailyCompletionMeta, type DailyCompletions, type DailyDefinition, type DailyEventDetail, type DailyGameStatus, type DailyHost, type DailyStartResponse, type DailyStatus, DailySystem, type DraggedSpot, type EdgeOffsets, type EndpointFields, type EndpointName, type EndpointReply, type ErrorBody, type FriendEntry, type GameAnalytics, type GameInfo, type GameLeaderboards, type GamePayload, type GameRecords, type GamepadMapping, type GlobalAnalytics, type GrantBundle, type GroupDef, HUB_CLIENT_VERSION, Hub, HubError, type HubErrorCode, type HubErrorDetails, type HubMenuControl, type HubMpApi, type HubNotifyApi, type HubOptions, type HubPresenceApi, type HubRaceApi, type HubRoom, type HubRoomsApi, type HubSocialApi, type HubStatus, INPUT_SINGLETON_API, type InputConfig, type InputDef, type InputEvents, type InputHost, type InputOptions, type InputOverrides, type InputReading, type InputSource, InputSystem, type InputSystemOptions, type Insets, type Inventory, type InventorySnapshot, type Invite, type InviteCreated, type InviteLink, type InviteLinkMethods, type InviteOptions, type InviteResult, type JoinInfo, type JoinInfoEvent, type JoinOptions, type Json, type Launch, type LaunchTicket, type LayoutBox, type LayoutItem, type LayoutOptions, type LeaderboardEntry, type LeaderboardResult, type MeResponse, type MenuBridge, type Message, type MessagesPage, type Metrics, type MouseMapping, type NavBlurEvent, type NavElement, type NavElementKind, type NavFocusEvent, type NavTarget, type NavigableDef, type Notice, type NotifyChange, type NotifyPrefs, OUTBOX_FULL_CODE, OUTBOX_MAX_CHARS, OUTBOX_MAX_ENTRIES, OfflineApi, OfflineError, type OfflineEventDetails, type OfflineEventName, type OfflineHandler, type OfflineKindDefinition, type OfflineListener, type OfflineOp, type OpenInviteOptions, Overlay, type OverlayEdge, type OverlayEvent, type OverlayListener, type OverlayReason, type PageInputControl, type Party, type PlayOnlineMethods, type PlayerCard, type PlayerLite, type PlayerRef, type Presence, type PresenceInput, type PresenceKind, type Profile, type ProfilePatch, type ProfileSummary, type ProfileUpdate, type QueueOp, type QueueOpInput, type QueuedScoreOptions, type REALTIME_FAILED_EVENT, type REALTIME_FEATURE_VERSION, type REALTIME_READY_EVENT, type REALTIME_SINGLETON_API, type RaceCreateOptions, type RaceDefinition, type RaceEvents, type RaceHistory, type RaceHistoryQuery, type RaceHistoryViewOptions, type RaceHudPlace, type RaceOutcome, type RaceParams, type RaceRecord, type RaceRecordPlayer, type RaceResult, type RaceResultPlayer, type RaceRuntimeApi, type RaceStart, type RaceStatValue, type RaceState, type RaceStats, type RaceStatusEvent, type Racer, type RacerResult, type RacerState, type RealtimeApi, type RealtimeErrorShape, type RealtimeHubLink, type RecentPlayer, type Rect, type Relation, type ReplayContext, type ReportInput, type ReportKind, type ReportReason, type RoomChatLine, type RoomCreateOptions, type RoomEvents, type RoomInfo, type RoomListOptions, type RoomMessage, type RoomReclaimMethods, type RoomSeat, type RoomSeatChange, type RoomSelf, type RoomSendOptions, type RoomState, type RoomStateChange, type RoomStateOptions, type Save, type SaveMeta, type SchemaOutput, type ServerEvents, type Snapshot, type SnapshotResponse, type SocialConfig, type SocialCounts, type SocialEvents, type SocialMe, type SortDir, type StatResult, type Stats, type SubmitScoreOptions, type SubmitScoreResult, type Suggestion, type SuggestionStatus, type SyncConflict, type SyncResult, type TouchMapping, type TradeBundle, type TradeId, type TradeListOptions, type TradeNoteOptions, UI_STACK_VERSION, UNSUPPORTED_BY_HUB, type UiStack, type UiStackHandoff, type User, type Vector, type VirtualControlType, type VirtualDef, type VirtualInputs, type VirtualOverride, boxesTouch, controlSize, createHub, type findRealtimeApi, getDaily, getInput, getUiStack, hub, isDailySystem, isInputSystem, isPageInputControl, type isRealtimeApi, isUiStack, layoutControls, type linkRealtimeToHub, type multiplayerForwarder as mp, type notifyForwarder as notify, parseInputOverrides, type presenceForwarder as presence, type raceForwarder as race, type roomsForwarder as rooms, type socialForwarder as social };
 //# sourceMappingURL=auto.d.ts.map

package/dist/auto.js

@@ -2,7 +2,7 @@ import { a as DailySystem, i as DAILY_START_EVENT, n as getDaily, r as isDailySy
 import { t as HUB_CLIENT_VERSION } from "./shared/client-version.gen.js";
 import { a as isPageInputControl, c as layoutControls, i as parseInputOverrides, l as boxesTouch, n as getInput, o as InputSystem, r as isInputSystem, s as Overlay, t as INPUT_SINGLETON_API, u as controlSize } from "./shared/input.js";
 import { n as isUiStack, r as UI_STACK_VERSION, t as getUiStack } from "./shared/page-stack.js";
-import { a as ContentRejectedError, c as UNSUPPORTED_BY_HUB, i as CLIENT_VERSION_HEADER, n as createHub, o as HubError, r as hub, s as OfflineError, t as Hub } from "./shared/src.js";
+import { a as OUTBOX_FULL_CODE, c as OfflineApi, d as OfflineError, f as UNSUPPORTED_BY_HUB, i as CLIENT_VERSION_HEADER, l as ContentRejectedError, n as createHub, o as OUTBOX_MAX_CHARS, r as hub, s as OUTBOX_MAX_ENTRIES, t as Hub, u as HubError } from "./shared/src.js";
 //#region src/auto.ts
 /**
 * `@diffenderfer-games/hub/auto`: everything the main entry exports, plus a
@@ -22,6 +22,6 @@ if (typeof window !== "undefined") window.HubSDK = {
 	ContentRejectedError
 };
 //#endregion
-export { CLIENT_VERSION_HEADER, ContentRejectedError, DAILY_SINGLETON_API, DAILY_START_EVENT, DailySystem, HUB_CLIENT_VERSION, Hub, HubError, INPUT_SINGLETON_API, InputSystem, OfflineError, Overlay, UI_STACK_VERSION, UNSUPPORTED_BY_HUB, boxesTouch, controlSize, createHub, getDaily, getInput, getUiStack, hub, isDailySystem, isInputSystem, isPageInputControl, isUiStack, layoutControls, parseInputOverrides };
+export { CLIENT_VERSION_HEADER, ContentRejectedError, DAILY_SINGLETON_API, DAILY_START_EVENT, DailySystem, HUB_CLIENT_VERSION, Hub, HubError, INPUT_SINGLETON_API, InputSystem, OUTBOX_FULL_CODE, OUTBOX_MAX_CHARS, OUTBOX_MAX_ENTRIES, OfflineApi, OfflineError, Overlay, UI_STACK_VERSION, UNSUPPORTED_BY_HUB, boxesTouch, controlSize, createHub, getDaily, getInput, getUiStack, hub, isDailySystem, isInputSystem, isPageInputControl, isUiStack, layoutControls, parseInputOverrides };
 
 //# sourceMappingURL=auto.js.map