@diffenderfer-games/hub 0.0.0-stage → 2.0.0-next.0

package/LICENSE

@@ -0,0 +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.

package/README.md

@@ -1,3 +1,139 @@
-# Temporary Holding Version
+# @diffenderfer-games/hub
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+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

package/dist/auto.d.ts

@@ -0,0 +1,36 @@
+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 { _ 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 { 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 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";
+//#region src/auto.d.ts
+/** What `window.HubSDK` holds. */
+export interface HubSdkGlobal {
+  /** The page's client. */
+  readonly hub: Hub;
+  /** Create another client. */
+  readonly createHub: typeof createHub;
+  /** The client class. */
+  readonly Hub: typeof Hub;
+  /** The base error class. */
+  readonly HubError: typeof HubError;
+  /** The offline error class. */
+  readonly OfflineError: typeof OfflineError;
+  /** The content-rejected error class. */
+  readonly ContentRejectedError: typeof ContentRejectedError;
+}
+declare global {
+  interface Window {
+    /** The hub client for games without a build step (installed by `@diffenderfer-games/hub/auto`). */
+    HubSDK?: HubSdkGlobal;
+  }
+}
+//#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 };
+//# sourceMappingURL=auto.d.ts.map

package/dist/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","names":[],"sources":["../src/auto.ts"],"mappings":";;;;;;;;;;;;;iBAciB;;WAEN,KAAK;;WAEL,kBAAkB;;WAElB,YAAY;;WAEZ,iBAAiB;;WAEjB,qBAAqB;;WAErB,6BAA6B;;QAGhC;YACI;;IAER,SAAS"}

package/dist/auto.js

@@ -0,0 +1,27 @@
+import { a as DailySystem, i as DAILY_START_EVENT, n as getDaily, r as isDailySystem, t as DAILY_SINGLETON_API } from "./shared/daily.js";
+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";
+//#region src/auto.ts
+/**
+* `@diffenderfer-games/hub/auto`: everything the main entry exports, plus a
+* side effect: it installs `window.HubSDK` (`{ hub, createHub, Hub, HubError,
+* OfflineError, ContentRejectedError }`), exactly as the v1 `/_hub/hub.js`
+* did. The host builds `/_hub/hub.js` from this entry, for games without a
+* build step (`import('/_hub/hub.js')` or `window.HubSDK.hub`).
+*
+* @packageDocumentation
+*/
+if (typeof window !== "undefined") window.HubSDK = {
+	hub,
+	createHub,
+	Hub,
+	HubError,
+	OfflineError,
+	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 };
+
+//# sourceMappingURL=auto.js.map

package/dist/auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.js","names":[],"sources":["../src/auto.ts"],"mappings":";;;;;;;;;;;;;;;AAoCA,IAAI,OAAO,WAAW,aACpB,OAAO,SAAS;CAAE;CAAK;CAAW;CAAK;CAAU;CAAc;AAAqB"}

package/dist/daily.d.ts

@@ -0,0 +1,2 @@
+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";
+export { 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, getDaily, isDailySystem };

package/dist/daily.js

@@ -0,0 +1 @@
+export { t as DAILY_SINGLETON_API, i as DAILY_START_EVENT, a as DailySystem, n as getDaily, r as isDailySystem } from "./shared/daily.js";

package/dist/doctor/cli.mjs

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { GamePackageJson, HubVersion } from "@diffenderfer-games/hub-contract";
+//#region src/core/version/client-version.gen.ts
+/** This client's package version, sent as `x-hub-client` on REST calls and `client` in `hello`. */
+const HUB_CLIENT_VERSION = "2.0.0-next.0";
+//#endregion
+//#region src/core/version/semver.ts
+const VERSION_PATTERN = /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+/** Parse a version (`2`, `2.1`, `2.1.0`, `2.1.0-next.3`); `undefined` when it is not one. */
+function parseVersion(text) {
+	const match = VERSION_PATTERN.exec(text.trim());
+	if (match === null) return;
+	const [, major = "0", minor = "0", patch = "0", prerelease] = match;
+	return {
+		release: [
+			Number(major),
+			Number(minor),
+			Number(patch)
+		],
+		prerelease: prerelease === void 0 ? [] : prerelease.split(".")
+	};
+}
+/** Compare two prerelease identifiers: numbers by value and before words, words as text. */
+function compareIdentifiers(first, second) {
+	const isFirstNumeric = /^\d+$/.test(first);
+	const isSecondNumeric = /^\d+$/.test(second);
+	if (isFirstNumeric && isSecondNumeric) return Number(first) - Number(second);
+	if (isFirstNumeric !== isSecondNumeric) return isFirstNumeric ? -1 : 1;
+	return first < second ? -1 : first > second ? 1 : 0;
+}
+/** Negative when `first` is older, positive when newer, 0 when equal. */
+function compareVersions(first, second) {
+	for (let i = 0; i < 3; i += 1) {
+		const difference = (first.release[i] ?? 0) - (second.release[i] ?? 0);
+		if (difference !== 0) return difference;
+	}
+	if (first.prerelease.length === 0 || second.prerelease.length === 0) return second.prerelease.length - first.prerelease.length;
+	const length = Math.max(first.prerelease.length, second.prerelease.length);
+	for (let i = 0; i < length; i += 1) {
+		const firstIdentifier = first.prerelease[i];
+		const secondIdentifier = second.prerelease[i];
+		if (firstIdentifier === void 0 || secondIdentifier === void 0) return firstIdentifier === void 0 ? -1 : 1;
+		const difference = compareIdentifiers(firstIdentifier, secondIdentifier);
+		if (difference !== 0) return difference;
+	}
+	return 0;
+}
+const COMPARATOR_PATTERN = /^(>=|<=|>|<|=)?\s*(.+)$/;
+/** Whether `version` meets one comparator (`>=2.0.0`); a malformed comparator never holds. */
+function meetsComparator(version, comparator) {
+	const match = COMPARATOR_PATTERN.exec(comparator);
+	const bound = match?.[2] === void 0 ? void 0 : parseVersion(match[2]);
+	if (match === null || bound === void 0) return false;
+	const order = compareVersions(version, bound);
+	switch (match[1]) {
+		case ">=": return order >= 0;
+		case "<=": return order <= 0;
+		case ">": return order > 0;
+		case "<": return order < 0;
+		default: return order === 0;
+	}
+}
+/** Whether `versionText` is in `range`; a malformed version or empty range never is. */
+function satisfiesRange(versionText, range) {
+	const version = parseVersion(versionText);
+	if (version === void 0) return false;
+	return range.split("||").some((alternative) => {
+		const comparators = alternative.trim().split(/\s+/).filter((comparator) => comparator !== "");
+		return comparators.length > 0 && comparators.every((comparator) => meetsComparator(version, comparator));
+	});
+}
+//#endregion
+//#region src/core/version/hub-version.ts
+/** How `version` fares against a hub's answer (`null`: a hub from before versioning). */
+function clientSupport(hubVersion, version = HUB_CLIENT_VERSION) {
+	if (hubVersion === null) return "unknown";
+	if (!satisfiesRange(version, hubVersion.supported)) return "unsupported";
+	return satisfiesRange(version, hubVersion.deprecated) ? "deprecated" : "supported";
+}
+//#endregion
+//#region src/doctor/checks.ts
+/**
+* The checks `hub-doctor` runs on a game (plan §4.3.7). Each returns
+* findings; an `error` finding fails the run (and the game's CI).
+*/
+/** The fix for an old or unsupported client. */
+const UPDATE_FIX = "run `npm update @diffenderfer-games/hub`";
+/**
+* The installed client against the hub's `/_api/version`: outside
+* `supported` is an error, `deprecated` a warning. `null` (a hub from before
+* versioning) and an unreachable hub are only reported.
+*/
+function checkClientVersion(installedVersion, hubVersion) {
+	if (hubVersion instanceof Error) return [{
+		level: "warning",
+		check: "version",
+		message: `could not read the hub's version (${hubVersion.message}); the client version was not checked`
+	}];
+	switch (clientSupport(hubVersion, installedVersion)) {
+		case "unsupported": return [{
+			level: "error",
+			check: "version",
+			message: `@diffenderfer-games/hub ${installedVersion} is not supported by the hub (supported: ${hubVersion?.supported ?? "?"}): ${UPDATE_FIX}`
+		}];
+		case "deprecated": return [{
+			level: "warning",
+			check: "version",
+			message: `@diffenderfer-games/hub ${installedVersion} is deprecated (deprecated: ${hubVersion?.deprecated ?? "?"}): ${UPDATE_FIX}`
+		}];
+		case "unknown": return [{
+			level: "info",
+			check: "version",
+			message: "the hub predates versioning (no /_api/version); the client version was not checked"
+		}];
+		case "supported": return [{
+			level: "info",
+			check: "version",
+			message: `@diffenderfer-games/hub ${installedVersion} is supported (hub ${hubVersion?.server ?? "?"})`
+		}];
+	}
+}
+/** Leftovers of the v1 vendored client, relative to the game's folder. */
+const VENDORED_LEFTOVERS = [
+	"src/hub/hub.ts",
+	"src/hub/input.ts",
+	"client/src/hub/hub.ts",
+	"scripts/sync-hub.mjs"
+];
+/** A stale vendored `src/hub/` copy or its sync script (the package replaces both). */
+function checkVendoredCopies(gameDir) {
+	return VENDORED_LEFTOVERS.filter((leftover) => existsSync(join(gameDir, leftover))).map((leftover) => ({
+		level: "warning",
+		check: "vendored",
+		message: `${leftover} is a vendored copy of the v1 client: import from '@diffenderfer-games/hub' instead and delete it`
+	}));
+}
+/** The `package.json` `game.*` block against the contract's manifest schema. */
+function checkManifest(packageJson) {
+	const parsed = GamePackageJson.safeParse(packageJson);
+	if (parsed.success) return [{
+		level: "info",
+		check: "manifest",
+		message: `the game.* block is valid (${parsed.data.game.type})`
+	}];
+	return parsed.error.issues.map((issue) => ({
+		level: "error",
+		check: "manifest",
+		message: `${issue.path.length === 0 ? "(package.json)" : issue.path.join(".")}: ${issue.message}`
+	}));
+}
+//#endregion
+//#region src/doctor/cli.ts
+/**
+* `hub-doctor`: checks a game against the hub (plan §4.3.7). Run it in a
+* game's folder, in CI and before pushing:
+*
+* ```sh
+* npx hub-doctor [--dir <game folder>] [--hub <url>] [--offline] [--json]
+* ```
+*
+* - the installed `@diffenderfer-games/hub` against the hub's
+*   `/_api/version` (`--hub`, default `https://diffenderfer.games`): outside
+*   `supported` fails, `deprecated` warns (`--offline` skips this check);
+* - a stale vendored `src/hub/` copy or `scripts/sync-hub.mjs` warns;
+* - the `package.json` `game.*` block must match the contract's schema.
+*
+* Exits 1 when any check fails.
+*/
+const DEFAULT_HUB_URL = "https://diffenderfer.games";
+function readOptions() {
+	const { values } = parseArgs({ options: {
+		dir: { type: "string" },
+		hub: { type: "string" },
+		offline: {
+			type: "boolean",
+			default: false
+		},
+		json: {
+			type: "boolean",
+			default: false
+		}
+	} });
+	return {
+		gameDir: resolve(values.dir ?? "."),
+		hubUrl: values.hub ?? DEFAULT_HUB_URL,
+		isOffline: values.offline,
+		isJson: values.json
+	};
+}
+function readJsonFile(path) {
+	return JSON.parse(readFileSync(path, "utf8"));
+}
+/** The client version the game has installed (its `node_modules` copy), else this doctor's own. */
+function installedClientVersion(gameDir) {
+	try {
+		const installed = readJsonFile(join(gameDir, "node_modules", "@diffenderfer-games", "hub", "package.json"));
+		if (typeof installed === "object" && installed !== null && "version" in installed && typeof installed.version === "string") return installed.version;
+	} catch {}
+	return HUB_CLIENT_VERSION;
+}
+/** The hub's `/_api/version`: `null` for a hub without it, an `Error` when unreachable. */
+async function fetchHubVersion(hubUrl) {
+	try {
+		const response = await fetch(new URL("/_api/version", hubUrl));
+		if (response.status === 404) return null;
+		if (!response.ok) return /* @__PURE__ */ new Error(`HTTP ${String(response.status)}`);
+		return HubVersion.parse(await response.json());
+	} catch (failure) {
+		return failure instanceof Error ? failure : new Error(String(failure));
+	}
+}
+async function runDoctor(options) {
+	const findings = [];
+	if (!options.isOffline) findings.push(...checkClientVersion(installedClientVersion(options.gameDir), await fetchHubVersion(options.hubUrl)));
+	findings.push(...checkVendoredCopies(options.gameDir));
+	try {
+		findings.push(...checkManifest(readJsonFile(join(options.gameDir, "package.json"))));
+	} catch (failure) {
+		findings.push({
+			level: "error",
+			check: "manifest",
+			message: `could not read package.json: ${failure instanceof Error ? failure.message : String(failure)}`
+		});
+	}
+	return findings;
+}
+const options = readOptions();
+const findings = await runDoctor(options);
+if (options.isJson) process.stdout.write(`${JSON.stringify({ findings }, null, 2)}\n`);
+else for (const finding of findings) process.stdout.write(`${finding.level.padEnd(7)} ${finding.check}: ${finding.message}\n`);
+process.exitCode = findings.some((finding) => finding.level === "error") ? 1 : 0;
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/doctor/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../../src/core/version/client-version.gen.ts","../../src/core/version/semver.ts","../../src/core/version/hub-version.ts","../../src/doctor/checks.ts","../../src/doctor/cli.ts"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+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 { _ 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 { 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 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";
+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 };

package/dist/index.js

@@ -0,0 +1,6 @@
+import { a as DailySystem, i as DAILY_START_EVENT, n as getDaily, r as isDailySystem, t as DAILY_SINGLETON_API } from "./shared/daily.js";
+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";
+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 };

package/dist/input.d.ts

@@ -0,0 +1,2 @@
+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";
+export { type Anchor, type AutoPauseOptions, type AxisDef, type AxisSide, type DraggedSpot, type EdgeOffsets, type GamepadMapping, type GroupDef, 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 LayoutBox, type LayoutItem, type LayoutOptions, type MenuBridge, type MouseMapping, type NavBlurEvent, type NavElement, type NavElementKind, type NavFocusEvent, type NavTarget, type NavigableDef, Overlay, type OverlayEdge, type OverlayEvent, type OverlayListener, type OverlayReason, type PageInputControl, type Rect, type TouchMapping, UI_STACK_VERSION, type UiStack, type UiStackHandoff, type Vector, type VirtualControlType, type VirtualDef, type VirtualInputs, type VirtualOverride, boxesTouch, controlSize, getInput, getUiStack, isInputSystem, isPageInputControl, isUiStack, layoutControls, parseInputOverrides };

package/dist/input.js

@@ -0,0 +1,3 @@
+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";
+export { INPUT_SINGLETON_API, InputSystem, Overlay, UI_STACK_VERSION, boxesTouch, controlSize, getInput, getUiStack, isInputSystem, isPageInputControl, isUiStack, layoutControls, parseInputOverrides };

package/dist/mp.d.ts

@@ -0,0 +1,4 @@
+import { t as InviteCreated } from "./shared/wire-types.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 Party, i as LaunchTicket, n as JoinInfo, o as multiplayerForwarder, r as Launch, t as Invite } from "./shared/mp.js";
+export { type BusyOptions, type HubMpApi, type Invite, type InviteCreated, type InviteOptions, type InviteResult, type JoinInfo, type JoinInfoEvent, type Launch, type LaunchTicket, type Party, multiplayerForwarder as mp };

package/dist/mp.js

@@ -0,0 +1 @@
+export { t as mp } from "./shared/mp.js";

package/dist/race.d.ts

@@ -0,0 +1,4 @@
+import { a as RaceResultPlayer, i as RaceRecordPlayer, o as RaceStatusEvent, r as RaceHistory } from "./shared/wire-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 { a as RaceStatValue, c as Racer, d as RoomInfo, f as raceForwarder, i as RaceResult, l as RacerResult, n as RaceParams, o as RaceState, r as RaceRecord, s as RaceStats, t as RaceOutcome, u as RacerState } from "./shared/race.js";
+export { type HubRaceApi, 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 RoomInfo, raceForwarder as race };

package/dist/race.js

@@ -0,0 +1 @@
+export { t as race } from "./shared/race.js";

package/dist/rooms.d.ts

@@ -0,0 +1,4 @@
+import { c as RoomChatLine, d as RoomStateChange, l as RoomMessage, u as RoomSeat } from "./shared/wire-types.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 { n as roomsForwarder, t as RoomInfo } from "./shared/rooms.js";
+export { type HubRoom, type HubRoomsApi, type JoinOptions, type RoomChatLine, type RoomCreateOptions, type RoomEvents, type RoomInfo, type RoomListOptions, type RoomMessage, type RoomSeat, type RoomSelf, type RoomSendOptions, type RoomState, type RoomStateChange, type RoomStateOptions, roomsForwarder as rooms };

package/dist/rooms.js

@@ -0,0 +1 @@
+export { t as rooms } from "./shared/rooms.js";