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

package/dist/shared/race.js

@@ -0,0 +1,53 @@
+import { t as pageBridge, u as hubLink } from "./bridge.js";
+import { t as createRuntimeOpener } from "./runtime-opener.js";
+//#region src/realtime/race-forwarder.ts
+/**
+* `hub.race`: races, forwarded to the social runtime. An old cached runtime
+* (feature version 1) has no races, which reads as "not available" rather
+* than a crash.
+*/
+const openWithRuntime = createRuntimeOpener(pageBridge);
+let raceDefinition = null;
+pageBridge.onReady((realtime) => {
+	if (raceDefinition !== null) realtime.race?.define(raceDefinition);
+});
+/** The runtime's race section, or an `OfflineError` for a runtime too old to race. */
+function requireRaces(realtime) {
+	if (realtime.race === void 0) throw hubLink().createOfflineError("Races need the latest hub — reload the page.");
+	return realtime.race;
+}
+/** `hub.race`: races. */
+const raceForwarder = {
+	define(definition) {
+		raceDefinition = definition;
+		pageBridge.current()?.race?.define(definition);
+	},
+	create: (options) => pageBridge.call((realtime) => requireRaces(realtime).create(options)),
+	join: (code, options) => pageBridge.call((realtime) => requireRaces(realtime).join(code, options)),
+	list: () => pageBridge.call((realtime) => requireRaces(realtime).list()),
+	browse: () => {
+		openWithRuntime((realtime) => {
+			realtime.race?.browse();
+		});
+	},
+	openHistory: (options) => {
+		openWithRuntime((realtime) => {
+			realtime.race?.openHistory(options);
+		});
+	},
+	history: (query) => pageBridge.call((realtime) => requireRaces(realtime).history(query)),
+	status: (stats, progress) => {
+		pageBridge.current()?.race?.status(stats, progress);
+	},
+	finish: (stats) => pageBridge.call((realtime) => requireRaces(realtime).finish(stats)),
+	lose: (stats) => pageBridge.call((realtime) => requireRaces(realtime).lose(stats)),
+	forfeit: () => pageBridge.call((realtime) => requireRaces(realtime).forfeit()),
+	leave: () => pageBridge.call((realtime) => requireRaces(realtime).leave()),
+	rematch: (params) => pageBridge.call((realtime) => requireRaces(realtime).rematch(params)),
+	current: () => pageBridge.current()?.race?.current() ?? null,
+	on: (event, listener) => pageBridge.subscribe((realtime) => realtime.race?.on(event, listener) ?? (() => void 0))
+};
+//#endregion
+export { raceForwarder as t };
+
+//# sourceMappingURL=race.js.map

package/dist/shared/race.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.js","names":[],"sources":["../../src/realtime/race-forwarder.ts"],"mappings":";;;;;;;;AAWA,MAAM,kBAAkB,oBAAoB,UAAU;AAEtD,IAAI,iBAAwC;AAC5C,WAAW,SAAS,aAAa;CAC/B,IAAI,mBAAmB,MACrB,SAAS,MAAM,OAAO,cAAc;AAExC,CAAC;;AAGD,SAAS,aAAa,UAAmC;CACvD,IAAI,SAAS,SAAS,KAAA,GACpB,MAAM,QAAQ,CAAC,CAAC,mBAAmB,8CAA8C;CAEnF,OAAO,SAAS;AAClB;;AAGA,MAAa,gBAA4B;CACvC,OAAO,YAAY;EACjB,iBAAiB;EACjB,WAAW,QAAQ,CAAC,EAAE,MAAM,OAAO,UAAU;CAC/C;CACA,SAAS,YAAY,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,OAAO,OAAO,CAAC;CACzF,OAAO,MAAM,YAAY,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,KAAK,MAAM,OAAO,CAAC;CACjG,YAAY,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,KAAK,CAAC;CACvE,cAAc;EACZ,iBAAiB,aAAa;GAC5B,SAAS,MAAM,OAAO;EACxB,CAAC;CACH;CACA,cAAc,YAAY;EACxB,iBAAiB,aAAa;GAC5B,SAAS,MAAM,YAAY,OAAO;EACpC,CAAC;CACH;CACA,UAAU,UAAU,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,QAAQ,KAAK,CAAC;CACvF,SAAS,OAAO,aAAa;EAC3B,WAAW,QAAQ,CAAC,EAAE,MAAM,OAAO,OAAO,QAAQ;CACpD;CACA,SAAS,UAAU,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC;CACrF,OAAO,UAAU,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC;CACjF,eAAe,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,QAAQ,CAAC;CAC7E,aAAa,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,MAAM,CAAC;CACzE,UAAU,WAAW,WAAW,MAAM,aAAa,aAAa,QAAQ,CAAC,CAAC,QAAQ,MAAM,CAAC;CACzF,eAAe,WAAW,QAAQ,CAAC,EAAE,MAAM,QAAQ,KAAK;CACxD,KAAK,OAAO,aAAa,WAAW,WAAW,aAAa,SAAS,MAAM,GAAG,OAAO,QAAQ,YAAY,KAAA,EAAU;AACrH"}

package/dist/shared/room-types.d.ts

@@ -0,0 +1,125 @@
+import { c as RoomChatLine, l as RoomMessage } from "./wire-types.js";
+import { Json, RoomInfo } from "@diffenderfer-games/hub-contract";
+//#region src/realtime/room-types.d.ts
+/** The shared room state (a JSON object, at most 32 KB). */
+type RoomState = Record<string, Json>;
+/** Options for `hub.rooms.create`. `game` defaults to the current slug. */
+interface RoomCreateOptions {
+  /** The game slug (default: this page's game). */
+  game?: string;
+  /** The game mode. */
+  mode?: string;
+  /** Listed in `hub.rooms.list` (default false). */
+  public?: boolean;
+  /** Seats. */
+  maxPlayers?: number;
+  /** `host` (default): guests' unaddressed sends reach the host only. `relay`: everyone hears every send. */
+  model?: 'host' | 'relay';
+  /** Seat this party in the room. */
+  partyId?: string;
+}
+/** Options for joining a room or race. */
+interface JoinOptions {
+  /** Watch instead of taking a seat (if the game allows spectators). */
+  spectate?: boolean;
+}
+/** Events a {@link HubRoom} emits, name → payload. */
+interface RoomEvents {
+  /** The room changed: roster, ready flags, phase, host. */
+  room: RoomInfo;
+  /** A relayed game message. */
+  msg: RoomMessage;
+  /** The shared state after a change. */
+  state: RoomState;
+  /** A moderated chat line. */
+  chat: RoomChatLine;
+  /** The host removed me. */
+  kicked: {
+    roomId: string;
+  };
+  /**
+   * The room is gone for this tab. `reason`: empty, ended, host_left,
+   * other_tab, moved, removed, or `gone` (client-side: the seat couldn't be
+   * reclaimed after a reconnect, e.g. the host restarted).
+   */
+  closed: {
+    reason: string;
+  };
+  /** The host ended the match (phase → `ended`); `results` is what it passed to `end()`. Fires once. */
+  ended: {
+    room: RoomInfo;
+    results?: Json;
+  };
+  /** A player left mid-game (or their reconnect grace ran out). */
+  abandoned: {
+    userId: number;
+    reason?: string;
+  };
+}
+/** Who I am in a room. */
+interface RoomSelf {
+  /** My user id. */
+  userId: number;
+  /** I host the room. */
+  host: boolean;
+  /** I'm watching, not seated. */
+  spectator: boolean;
+}
+/** Options for {@link HubRoom.send}. */
+interface RoomSendOptions {
+  /** Send to this seat only. */
+  to?: number;
+}
+/** Options for {@link HubRoom.setState}. */
+interface RoomStateOptions {
+  /** Replace the whole state instead of shallow-merging the patch. */
+  replace?: boolean;
+}
+/** A live hub relay room, as games see it. */
+interface HubRoom {
+  /** The room as last reported. */
+  readonly info: RoomInfo;
+  /** The shared room state (at most 32 KB). */
+  readonly state: RoomState;
+  /** Who I am in this room. */
+  readonly me: RoomSelf;
+  /** Subscribe to a room event. Returns the unsubscribe function. */
+  on<Name extends keyof RoomEvents>(event: Name, listener: (payload: RoomEvents[Name]) => void): () => void;
+  /** Mark my seat ready (or not). */
+  ready(isReady: boolean): Promise<void>;
+  /** Set my seat's small game data (team, colour…), at most 2 KB. */
+  seat(seatData: Json): Promise<void>;
+  /** Host: start the match. */
+  start(): Promise<void>;
+  /** Relay a game message. */
+  send(message: Json, options?: RoomSendOptions): Promise<void>;
+  /** Change the shared state. */
+  setState(patch: RoomState, options?: RoomStateOptions): Promise<void>;
+  /** Free-text chat; resolves with the delivered (maybe softened) text, rejects with a content rejection. */
+  chat(text: string): Promise<string>;
+  /** Send a quick-chat phrase. */
+  quick(phraseId: string): Promise<void>;
+  /** Host: remove a player. */
+  kick(userId: number): Promise<void>;
+  /** Leave the room. */
+  leave(): Promise<void>;
+  /** Host: end the match, with optional results for everyone. */
+  end(results?: Json): Promise<void>;
+}
+/** Options for `hub.rooms.list`. */
+interface RoomListOptions {
+  /** Only rooms in this mode. */
+  mode?: string;
+}
+/** `hub.rooms`: hub relay rooms (static games, no server). */
+interface HubRoomsApi {
+  /** Create a room and take its first seat. */
+  create(options?: RoomCreateOptions): Promise<HubRoom>;
+  /** Join a room by its 5-character code or its id. */
+  join(codeOrId: string, options?: JoinOptions): Promise<HubRoom>;
+  /** Public rooms in the lobby phase for this game. */
+  list(options?: RoomListOptions): Promise<RoomInfo[]>;
+}
+//#endregion
+export { RoomEvents as a, RoomSendOptions as c, RoomCreateOptions as i, RoomState as l, HubRoomsApi as n, RoomListOptions as o, JoinOptions as r, RoomSelf as s, HubRoom as t, RoomStateOptions as u };
+//# sourceMappingURL=room-types.d.ts.map

package/dist/shared/room-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-types.d.ts","names":[],"sources":["../../src/realtime/room-types.ts"],"mappings":";;;;KAQY,YAAY,eAAe;;UAGtB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf;;;UAIe;;EAEf,MAAM;;EAEN,KAAK;;EAEL,OAAO;;EAEP,MAAM;;EAEN;IAAU;;;;;;;EAMV;IAAU;;;EAEV;IAAS,MAAM;IAAU,UAAU;;;EAEnC;IAAa;IAAgB;;;;UAId;;EAEf;;EAEA;;EAEA;;;UAIe;;EAEf;;;UAIe;;EAEf;;;UAIe;;WAEN,MAAM;;WAEN,OAAO;;WAEP,IAAI;;EAEb,GAAG,mBAAmB,YAAY,OAAO,MAAM,WAAW,SAAS,WAAW;;EAE9E,MAAM,mBAAmB;;EAEzB,KAAK,UAAU,OAAO;;EAEtB,SAAS;;EAET,KAAK,SAAS,MAAM,UAAU,kBAAkB;;EAEhD,SAAS,OAAO,WAAW,UAAU,mBAAmB;;EAExD,KAAK,eAAe;;EAEpB,MAAM,mBAAmB;;EAEzB,KAAK,iBAAiB;;EAEtB,SAAS;;EAET,IAAI,UAAU,OAAO;;;UAIN;;EAEf;;;UAIe;;EAEf,OAAO,UAAU,oBAAoB,QAAQ;;EAE7C,KAAK,kBAAkB,UAAU,cAAc,QAAQ;;EAEvD,KAAK,UAAU,kBAAkB,QAAQ"}

package/dist/shared/rooms.d.ts

@@ -0,0 +1,9 @@
+import "./wire-types.js";
+import { n as HubRoomsApi } from "./room-types.js";
+import { RoomInfo as RoomInfo$1 } from "@diffenderfer-games/hub-contract";
+//#region src/realtime/rooms-forwarder.d.ts
+/** `hub.rooms`: hub relay rooms. */
+declare const roomsForwarder: HubRoomsApi;
+//#endregion
+export { roomsForwarder as n, RoomInfo$1 as t };
+//# sourceMappingURL=rooms.d.ts.map

package/dist/shared/rooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.d.ts","names":[],"sources":["../../src/realtime/rooms-forwarder.ts"],"mappings":";;;;;cA0Ea,gBAAgB"}

package/dist/shared/rooms.js

@@ -0,0 +1,62 @@
+import { r as _defineProperty } from "./globals.js";
+import { n as rethrowAsHubError, t as pageBridge } from "./bridge.js";
+//#region src/realtime/rooms-forwarder.ts
+/** A runtime room whose rejections are re-created as the core client's errors. */
+var ForwardedRoom = class {
+	constructor(room) {
+		_defineProperty(this, "room", void 0);
+		this.room = room;
+	}
+	get info() {
+		return this.room.info;
+	}
+	get state() {
+		return this.room.state;
+	}
+	get me() {
+		return this.room.me;
+	}
+	on(event, listener) {
+		return this.room.on(event, listener);
+	}
+	ready(isReady) {
+		return rethrowAsHubError(this.room.ready(isReady));
+	}
+	seat(seatData) {
+		return rethrowAsHubError(this.room.seat(seatData));
+	}
+	start() {
+		return rethrowAsHubError(this.room.start());
+	}
+	send(message, options) {
+		return rethrowAsHubError(this.room.send(message, options));
+	}
+	setState(patch, options) {
+		return rethrowAsHubError(this.room.setState(patch, options));
+	}
+	chat(text) {
+		return rethrowAsHubError(this.room.chat(text));
+	}
+	quick(phraseId) {
+		return rethrowAsHubError(this.room.quick(phraseId));
+	}
+	kick(userId) {
+		return rethrowAsHubError(this.room.kick(userId));
+	}
+	leave() {
+		return rethrowAsHubError(this.room.leave());
+	}
+	end(results) {
+		return rethrowAsHubError(this.room.end(results));
+	}
+};
+/** `hub.rooms`: hub relay rooms. */
+const roomsForwarder = {
+	create: (options) => pageBridge.call(async (realtime) => new ForwardedRoom(await realtime.rooms.create(options))),
+	join: (codeOrId, options) => pageBridge.call(async (realtime) => new ForwardedRoom(await realtime.rooms.join(codeOrId, options))),
+	list: (options) => pageBridge.call((realtime) => realtime.rooms.list(options))
+};
+//#endregion
+export { roomsForwarder as t };
+
+//# sourceMappingURL=rooms.js.map

package/dist/shared/rooms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.js","names":[],"sources":["../../src/realtime/rooms-forwarder.ts"],"mappings":";;;;AASA,IAAM,gBAAN,MAAuC;CAGrC,YAAY,MAAe;EAFV,gBAAA,MAAA,QAAA,KAAA,CAAA;EAGf,KAAK,OAAO;CACd;CAEA,IAAI,OAAiB;EACnB,OAAO,KAAK,KAAK;CACnB;CAEA,IAAI,QAAmB;EACrB,OAAO,KAAK,KAAK;CACnB;CAEA,IAAI,KAAe;EACjB,OAAO,KAAK,KAAK;CACnB;CAEA,GAAkC,OAAa,UAA2D;EACxG,OAAO,KAAK,KAAK,GAAG,OAAO,QAAQ;CACrC;CAEA,MAAM,SAAiC;EACrC,OAAO,kBAAkB,KAAK,KAAK,MAAM,OAAO,CAAC;CACnD;CAEA,KAAK,UAA+B;EAClC,OAAO,kBAAkB,KAAK,KAAK,KAAK,QAAQ,CAAC;CACnD;CAEA,QAAuB;EACrB,OAAO,kBAAkB,KAAK,KAAK,MAAM,CAAC;CAC5C;CAEA,KAAK,SAAe,SAA0C;EAC5D,OAAO,kBAAkB,KAAK,KAAK,KAAK,SAAS,OAAO,CAAC;CAC3D;CAEA,SAAS,OAAkB,SAA2C;EACpE,OAAO,kBAAkB,KAAK,KAAK,SAAS,OAAO,OAAO,CAAC;CAC7D;CAEA,KAAK,MAA+B;EAClC,OAAO,kBAAkB,KAAK,KAAK,KAAK,IAAI,CAAC;CAC/C;CAEA,MAAM,UAAiC;EACrC,OAAO,kBAAkB,KAAK,KAAK,MAAM,QAAQ,CAAC;CACpD;CAEA,KAAK,QAA+B;EAClC,OAAO,kBAAkB,KAAK,KAAK,KAAK,MAAM,CAAC;CACjD;CAEA,QAAuB;EACrB,OAAO,kBAAkB,KAAK,KAAK,MAAM,CAAC;CAC5C;CAEA,IAAI,SAA+B;EACjC,OAAO,kBAAkB,KAAK,KAAK,IAAI,OAAO,CAAC;CACjD;AACF;;AAGA,MAAa,iBAA8B;CACzC,SAAS,YAAY,WAAW,KAAK,OAAO,aAAa,IAAI,cAAc,MAAM,SAAS,MAAM,OAAO,OAAO,CAAC,CAAC;CAChH,OAAO,UAAU,YAAY,WAAW,KAAK,OAAO,aAAa,IAAI,cAAc,MAAM,SAAS,MAAM,KAAK,UAAU,OAAO,CAAC,CAAC;CAChI,OAAO,YAAY,WAAW,MAAM,aAAa,SAAS,MAAM,KAAK,OAAO,CAAC;AAC/E"}

package/dist/shared/runtime-opener.js

@@ -0,0 +1,84 @@
+import { r as pageBody } from "./dom.js";
+import { a as readRuntimeFailure, o as REALTIME_FAILED_EVENT } from "./bridge.js";
+//#region src/realtime/fallback-notice.ts
+/**
+* A minimal top-centre notice for when the social runtime (which owns the
+* real toasts) isn't available: plain DOM with inline styles in the hub
+* palette, one at a time.
+*/
+const NOTICE_ELEMENT_ID = "hub-fallback-notice";
+const NOTICE_STYLE = "position:fixed;top:12px;left:50%;transform:translateX(-50%);z-index:2147483647;max-width:min(92vw,420px);padding:10px 14px;border-radius:10px;font:13px/1.4 \"Space Mono\",ui-monospace,monospace;background:#11141c;color:#e8e6df;border:1px solid #2a3142;box-shadow:0 8px 24px rgba(0,0,0,.5);pointer-events:none;";
+let hideTimer = null;
+/** Show `text`; it hides itself after `visibleMs` (0 = until replaced or hidden). */
+function showFallbackNotice(text, visibleMs = 0) {
+	if (typeof document === "undefined") return;
+	const body = pageBody();
+	if (body === null) return;
+	let notice = document.getElementById(NOTICE_ELEMENT_ID);
+	if (notice === null) {
+		notice = document.createElement("div");
+		notice.id = NOTICE_ELEMENT_ID;
+		notice.setAttribute("role", "status");
+		notice.style.cssText = NOTICE_STYLE;
+		body.appendChild(notice);
+	}
+	notice.textContent = text;
+	if (hideTimer !== null) clearTimeout(hideTimer);
+	hideTimer = visibleMs > 0 ? setTimeout(hideFallbackNotice, visibleMs) : null;
+}
+/** Remove the notice. */
+function hideFallbackNotice() {
+	if (hideTimer !== null) {
+		clearTimeout(hideTimer);
+		hideTimer = null;
+	}
+	if (typeof document !== "undefined") document.getElementById(NOTICE_ELEMENT_ID)?.remove();
+}
+//#endregion
+//#region src/realtime/runtime-opener.ts
+/** How long before "still loading" shows. */
+const SLOW_NOTICE_MS = 1500;
+/** How long the failure notice stays up. */
+const FAILURE_NOTICE_MS = 8e3;
+/** Tell the player the social runtime failed, with the reason the menu recorded. */
+function showRuntimeFailure() {
+	const reason = readRuntimeFailure();
+	showFallbackNotice(`Friends couldn't load${reason === "" ? "" : ` (${reason})`}. Reload the page to try again.`, FAILURE_NOTICE_MS);
+}
+/** Make an opener: runs a UI call on the runtime once it is up, with the loading and failure notices. */
+function createRuntimeOpener(bridge) {
+	return (openUi) => {
+		const loaded = bridge.current();
+		if (loaded !== null) {
+			openUi(loaded);
+			return;
+		}
+		if (readRuntimeFailure() !== "") {
+			showRuntimeFailure();
+			return;
+		}
+		const slowTimer = setTimeout(() => {
+			showFallbackNotice("Friends are still loading…");
+		}, SLOW_NOTICE_MS);
+		let isSettled = false;
+		const onFailed = () => {
+			if (!isSettled) {
+				isSettled = true;
+				clearTimeout(slowTimer);
+				showRuntimeFailure();
+			}
+		};
+		if (typeof window !== "undefined") window.addEventListener(REALTIME_FAILED_EVENT, onFailed, { once: true });
+		bridge.whenReady().then((realtime) => {
+			if (isSettled) return;
+			isSettled = true;
+			clearTimeout(slowTimer);
+			hideFallbackNotice();
+			openUi(realtime);
+		}, onFailed);
+	};
+}
+//#endregion
+export { createRuntimeOpener as t };
+
+//# sourceMappingURL=runtime-opener.js.map

package/dist/shared/runtime-opener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-opener.js","names":[],"sources":["../../src/realtime/fallback-notice.ts","../../src/realtime/runtime-opener.ts"],"mappings":";;;;;;;;AAOA,MAAM,oBAAoB;AAC1B,MAAM,eAAe;AAIrB,IAAI,YAAkD;;AAGtD,SAAgB,mBAAmB,MAAc,YAAY,GAAS;CACpE,IAAI,OAAO,aAAa,aACtB;CAEF,MAAM,OAAO,SAAS;CACtB,IAAI,SAAS,MACX;CAEF,IAAI,SAAS,SAAS,eAAe,iBAAiB;CACtD,IAAI,WAAW,MAAM;EACnB,SAAS,SAAS,cAAc,KAAK;EACrC,OAAO,KAAK;EACZ,OAAO,aAAa,QAAQ,QAAQ;EACpC,OAAO,MAAM,UAAU;EACvB,KAAK,YAAY,MAAM;CACzB;CACA,OAAO,cAAc;CACrB,IAAI,cAAc,MAChB,aAAa,SAAS;CAExB,YAAY,YAAY,IAAI,WAAW,oBAAoB,SAAS,IAAI;AAC1E;;AAGA,SAAgB,qBAA2B;CACzC,IAAI,cAAc,MAAM;EACtB,aAAa,SAAS;EACtB,YAAY;CACd;CACA,IAAI,OAAO,aAAa,aACtB,SAAS,eAAe,iBAAiB,CAAC,EAAE,OAAO;AAEvD;;;;AClCA,MAAM,iBAAiB;;AAEvB,MAAM,oBAAoB;;AAG1B,SAAS,qBAA2B;CAClC,MAAM,SAAS,mBAAmB;CAClC,mBAAmB,wBAAwB,WAAW,KAAK,KAAK,KAAK,OAAO,GAAG,kCAAkC,iBAAiB;AACpI;;AAGA,SAAgB,oBAAoB,QAA2E;CAC7G,QAAQ,WAAW;EACjB,MAAM,SAAS,OAAO,QAAQ;EAC9B,IAAI,WAAW,MAAM;GACnB,OAAO,MAAM;GACb;EACF;EAEA,IAAI,mBAAmB,MAAM,IAAI;GAC/B,mBAAmB;GACnB;EACF;EACA,MAAM,YAAY,iBAAiB;GACjC,mBAAmB,4BAA4B;EACjD,GAAG,cAAc;EACjB,IAAI,YAAY;EAChB,MAAM,iBAAuB;GAC3B,IAAI,CAAC,WAAW;IACd,YAAY;IACZ,aAAa,SAAS;IACtB,mBAAmB;GACrB;EACF;EACA,IAAI,OAAO,WAAW,aACpB,OAAO,iBAAiB,uBAAuB,UAAU,EAAE,MAAM,KAAK,CAAC;EAEzE,OAAO,UAAU,CAAC,CAAC,MAAM,aAAa;GACpC,IAAI,WACF;GAEF,YAAY;GACZ,aAAa,SAAS;GACtB,mBAAmB;GACnB,OAAO,QAAQ;EACjB,GAAG,QAAQ;CACb;AACF"}

package/dist/shared/social.d.ts

@@ -0,0 +1,148 @@
+import "./wire-types.js";
+import { n as HubMpApi } from "./multiplayer-types.js";
+import { n as HubRoomsApi } from "./room-types.js";
+import { t as HubRaceApi } from "./race-types.js";
+import { Audience, ChatMode, ChatMode as ChatMode$1, Conversation, Counts, ErrorBody, FriendEntry, FriendEntry as FriendEntry$1, Invite, Invite as Invite$1, JoinInfo as JoinInfo$1, Launch as Launch$1, LaunchTicket, Message, MessagesPage, NotifyChange, NotifyPrefs, Party, Party as Party$1, PlayerCard, PlayerLite, Presence, Presence as Presence$1, PresenceInput, PresenceInput as PresenceInput$1, PresenceKind, RaceOutcome, RaceParams as RaceParams$1, RaceRecord, RaceResult as RaceResult$1, RaceStatValue, RaceState, RaceStats as RaceStats$1, Racer, RacerResult, RacerState, RecentPlayer, Relation, ReportInput, ReportKind, ReportReason, RoomInfo as RoomInfo$1, SocialConfig, SocialMe, Suggestion, SuggestionStatus } from "@diffenderfer-games/hub-contract";
+//#region src/realtime/social-types.d.ts
+/** Online counts as a game sees them. */
+interface SocialCounts {
+  /** Everyone online on the site. */
+  online: number;
+  /** Players in the current game (0 on the catalog page). */
+  inGame: number;
+  /** My friends currently online. */
+  friendsOnline: number;
+}
+/** Events `hub.social.on` delivers, name → payload. */
+interface SocialEvents {
+  /** The friends list changed. */
+  friends: FriendEntry[];
+  /** A friend's presence changed (`null` when they went offline). */
+  presence: {
+    userId: number;
+    p: Presence | null;
+  };
+  /** The online counts changed. */
+  counts: SocialCounts;
+  /** An invite arrived. */
+  invite: Invite;
+  /** My party changed (`null` when I left it). */
+  party: Party | null;
+}
+/** Who to open a player card for. */
+type PlayerRef = {
+  userId: number;
+} | {
+  username: string;
+};
+/** Options for the invite picker. */
+interface OpenInviteOptions {
+  /** Preselect this friend. */
+  userId?: number;
+  /** The game mode to invite to. */
+  mode?: string;
+}
+/** `hub.presence`: what you're doing, shown to friends (privacy is automatic). */
+interface HubPresenceApi {
+  /** Report an activity, e.g. `{ kind: 'playing', detail: 'Level 3' }`. Coalesced; safe to call often. */
+  set(presence: PresenceInput): void;
+  /** Back to "in the menu". */
+  clear(): void;
+}
+/** `hub.social`: friends and the hub's social dialogs. */
+interface HubSocialApi {
+  /** Open a player card (add friend, message, invite, block, report). */
+  openPlayer(ref: PlayerRef): void;
+  /** Open the hub menu on the Friends section. */
+  openFriends(): void;
+  /** Open the chat with a friend. */
+  openChat(userId: number): void;
+  /** Open the invite picker (current game by default). */
+  openInvite(options?: OpenInviteOptions): void;
+  /** Open the game-suggestion form and board. */
+  openSuggest(): void;
+  /** Open notification settings, optionally focused on a game's lobby bell. */
+  openNotify(options?: {
+    game?: string;
+  }): void;
+  /** Friends with live presence. Rejects with `OfflineError` without the runtime. */
+  friends(): Promise<FriendEntry[]>;
+  /** Live counts; all zero until the runtime is up. */
+  counts(): SocialCounts;
+  /** The effective chat mode (with these players); `'off'` until the runtime is up. */
+  chatMode(userIds?: number[]): ChatMode;
+  /** Subscribe to social events; works before the runtime loads. Returns the unsubscribe function. */
+  on<Name extends keyof SocialEvents>(event: Name, listener: (payload: SocialEvents[Name]) => void): () => void;
+}
+/** `hub.notify`: toast behaviour during intense play. */
+interface HubNotifyApi {
+  /** Quiet: toasts collapse into the menu badge; invites still show as a small pill. */
+  setQuiet(isQuiet: boolean): void;
+}
+//#endregion
+//#region src/realtime/social-forwarder.d.ts
+/** `hub.presence`: what you're doing, shown to friends. */
+declare const presenceForwarder: HubPresenceApi;
+/** `hub.notify`: toast behaviour. */
+declare const notifyForwarder: HubNotifyApi;
+/** `hub.social`: friends and the hub's social dialogs. */
+declare const socialForwarder: HubSocialApi;
+//#endregion
+//#region src/realtime/hub-link.d.ts
+/** The core client's side of the link. */
+interface RealtimeHubLink {
+  /** Re-create an error from the runtime (another bundle) as this client's `HubError` family. */
+  toHubError(error: unknown): Error;
+  /** This client's `OfflineError` with a message. */
+  createOfflineError(message: string): Error;
+  /** A 60-second identity ticket for this game's own server (`POST /mp/ticket`), straight from the hub. */
+  getGameServerTicket(): Promise<string>;
+}
+/** Called once by the core client so forwarder errors use its classes and tickets use its REST client. */
+declare function linkRealtimeToHub(link: RealtimeHubLink): void;
+//#endregion
+//#region src/realtime/runtime-api.d.ts
+/**
+ * The realtime feature version the runtime reports in {@link RealtimeApi.version}.
+ * 2 added races; a client feature-detects newer additions with it.
+ */
+declare const REALTIME_FEATURE_VERSION = 2;
+/**
+ * The cross-bundle shape number of the `rt` page singleton (plan §4.4). The
+ * runtime registers with it through `claimSingleton`; bump it only when the
+ * shape of {@link RealtimeApi} changes incompatibly.
+ */
+declare const REALTIME_SINGLETON_API = 1;
+/** The window event the runtime fires once it has installed itself. */
+declare const REALTIME_READY_EVENT = "hub:rt-ready";
+/** The window event the menu fires when the runtime failed to load (its reason is on `window.__HUB_RT_ERROR__`). */
+declare const REALTIME_FAILED_EVENT = "hub:rt-failed";
+/**
+ * Installed by the social runtime as the page's `rt` singleton (and the v1
+ * alias `window.__HUB_RT__`).
+ */
+interface RealtimeApi {
+  /** The runtime's feature version (see {@link REALTIME_FEATURE_VERSION}). */
+  readonly version: number;
+  /** Presence reporting. */
+  presence: HubPresenceApi;
+  /** Friends and the social dialogs. */
+  social: HubSocialApi;
+  /** Invites, launches, the leave guard and tickets. */
+  mp: HubMpApi;
+  /** Hub relay rooms. */
+  rooms: HubRoomsApi;
+  /** Toast behaviour. */
+  notify: HubNotifyApi;
+  /** Races (feature version 2 and later). */
+  race?: HubRaceApi;
+}
+//#endregion
+//#region src/realtime/page-runtime.d.ts
+/** Whether `candidate` looks like a {@link RealtimeApi} (any bundle's). */
+declare function isRealtimeApi(candidate: unknown): candidate is RealtimeApi;
+/** The page's realtime API if the runtime has loaded, else `null`. */
+declare function findRealtimeApi(): RealtimeApi | null;
+//#endregion
+export { HubNotifyApi as $, RacerState as A, SuggestionStatus as B, RaceRecord as C, RaceStats$1 as D, RaceState as E, ReportReason as F, REALTIME_READY_EVENT as G, isRealtimeApi as H, RoomInfo$1 as I, RealtimeHubLink as J, REALTIME_SINGLETON_API as K, SocialConfig as L, Relation as M, ReportInput as N, Racer as O, ReportKind as P, socialForwarder as Q, SocialMe as R, RaceParams$1 as S, RaceStatValue as T, REALTIME_FAILED_EVENT as U, findRealtimeApi as V, REALTIME_FEATURE_VERSION as W, notifyForwarder as X, linkRealtimeToHub as Y, presenceForwarder as Z, PlayerLite as _, ErrorBody as a, SocialEvents as at, PresenceKind as b, JoinInfo$1 as c, Message as d, HubPresenceApi as et, MessagesPage as f, PlayerCard as g, Party$1 as h, Counts as i, SocialCounts as it, RecentPlayer as j, RacerResult as k, Launch$1 as l, NotifyPrefs as m, ChatMode$1 as n, OpenInviteOptions as nt, FriendEntry$1 as o, NotifyChange as p, RealtimeApi as q, Conversation as r, PlayerRef as rt, Invite$1 as s, Audience as t, HubSocialApi as tt, LaunchTicket as u, Presence$1 as v, RaceResult$1 as w, RaceOutcome as x, PresenceInput$1 as y, Suggestion as z };
+//# sourceMappingURL=social.d.ts.map

package/dist/shared/social.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","names":[],"sources":["../../src/realtime/social-types.ts","../../src/realtime/social-forwarder.ts","../../src/realtime/hub-link.ts","../../src/realtime/runtime-api.ts","../../src/realtime/page-runtime.ts"],"mappings":";;;;;;;UAOiB;;EAEf;;EAEA;;EAEA;;;UAIe;;EAEf,SAAS;;EAET;IAAY;IAAgB,GAAG;;;EAE/B,QAAQ;;EAER,QAAQ;;EAER,OAAO;;;KAIG;EAAc;;EAAqB;;;UAG9B;;EAEf;;EAEA;;;UAIe;;EAEf,IAAI,UAAU;;EAEd;;;UAIe;;EAEf,WAAW,KAAK;;EAEhB;;EAEA,SAAS;;EAET,WAAW,UAAU;;EAErB;;EAEA,WAAW;IAAY;;;EAEvB,WAAW,QAAQ;;EAEnB,UAAU;;EAEV,SAAS,qBAAqB;;EAE9B,GAAG,mBAAmB,cAAc,OAAO,MAAM,WAAW,SAAS,aAAa;;;UAInE;;EAEf,SAAS;;;;;cC5DE,mBAAmB;;cAYnB,iBAAiB;;cAQjB,iBAAiB;;;;UCzBb;;EAGf,WAAW,iBAAiB;;EAE5B,mBAAmB,kBAAkB;;EAErC,uBAAuB;;;iBAuCT,kBAAkB,MAAM;;;;;;;cC3C3B;;;;;;cAOA;;cAGA;;cAGA;;;;;UAMI;;WAEN;;EAET,UAAU;;EAEV,QAAQ;;EAER,IAAI;;EAEJ,OAAO;;EAEP,QAAQ;;EAER,OAAO;;;;;iBCnCO,cAAc,qBAAqB,aAAa;;iBAsBhD,mBAAmB"}

package/dist/shared/social.js

@@ -0,0 +1,73 @@
+import { t as pageBridge } from "./bridge.js";
+import { t as latestState } from "./latest-state.js";
+import { t as createRuntimeOpener } from "./runtime-opener.js";
+//#region src/realtime/social-forwarder.ts
+/**
+* `hub.presence`, `hub.social` and `hub.notify`: thin forwarders to the
+* social runtime. Presence and quiet mode are "latest state" calls,
+* remembered and replayed when the runtime loads.
+*/
+const openWithRuntime = createRuntimeOpener(pageBridge);
+/** Counts before the runtime is up. */
+const NO_COUNTS = {
+	online: 0,
+	inGame: 0,
+	friendsOnline: 0
+};
+/** `hub.presence`: what you're doing, shown to friends. */
+const presenceForwarder = {
+	set(presence) {
+		latestState.presence = { ...presence };
+		pageBridge.current()?.presence.set(latestState.presence);
+	},
+	clear() {
+		latestState.presence = { kind: "menu" };
+		pageBridge.current()?.presence.clear();
+	}
+};
+/** `hub.notify`: toast behaviour. */
+const notifyForwarder = { setQuiet(isQuiet) {
+	latestState.isQuiet = isQuiet;
+	pageBridge.current()?.notify.setQuiet(isQuiet);
+} };
+/** `hub.social`: friends and the hub's social dialogs. */
+const socialForwarder = {
+	openPlayer: (ref) => {
+		openWithRuntime((realtime) => {
+			realtime.social.openPlayer(ref);
+		});
+	},
+	openFriends: () => {
+		openWithRuntime((realtime) => {
+			realtime.social.openFriends();
+		});
+	},
+	openChat: (userId) => {
+		openWithRuntime((realtime) => {
+			realtime.social.openChat(userId);
+		});
+	},
+	openInvite: (options) => {
+		openWithRuntime((realtime) => {
+			realtime.social.openInvite(options);
+		});
+	},
+	openSuggest: () => {
+		openWithRuntime((realtime) => {
+			realtime.social.openSuggest();
+		});
+	},
+	openNotify: (options) => {
+		openWithRuntime((realtime) => {
+			realtime.social.openNotify(options);
+		});
+	},
+	friends: () => pageBridge.call((realtime) => realtime.social.friends()),
+	counts: () => pageBridge.current()?.social.counts() ?? { ...NO_COUNTS },
+	chatMode: (userIds) => pageBridge.current()?.social.chatMode(userIds) ?? "off",
+	on: (event, listener) => pageBridge.subscribe((realtime) => realtime.social.on(event, listener))
+};
+//#endregion
+export { presenceForwarder as n, socialForwarder as r, notifyForwarder as t };
+
+//# sourceMappingURL=social.js.map

package/dist/shared/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","names":[],"sources":["../../src/realtime/social-forwarder.ts"],"mappings":";;;;;;;;;AAUA,MAAM,kBAAkB,oBAAoB,UAAU;;AAGtD,MAAM,YAA0B;CAAE,QAAQ;CAAG,QAAQ;CAAG,eAAe;AAAE;;AAGzE,MAAa,oBAAoC;CAC/C,IAAI,UAAU;EACZ,YAAY,WAAW,EAAE,GAAG,SAAS;EACrC,WAAW,QAAQ,CAAC,EAAE,SAAS,IAAI,YAAY,QAAQ;CACzD;CACA,QAAQ;EACN,YAAY,WAAW,EAAE,MAAM,OAAO;EACtC,WAAW,QAAQ,CAAC,EAAE,SAAS,MAAM;CACvC;AACF;;AAGA,MAAa,kBAAgC,EAC3C,SAAS,SAAS;CAChB,YAAY,UAAU;CACtB,WAAW,QAAQ,CAAC,EAAE,OAAO,SAAS,OAAO;AAC/C,EACF;;AAGA,MAAa,kBAAgC;CAC3C,aAAa,QAAQ;EACnB,iBAAiB,aAAa;GAC5B,SAAS,OAAO,WAAW,GAAG;EAChC,CAAC;CACH;CACA,mBAAmB;EACjB,iBAAiB,aAAa;GAC5B,SAAS,OAAO,YAAY;EAC9B,CAAC;CACH;CACA,WAAW,WAAW;EACpB,iBAAiB,aAAa;GAC5B,SAAS,OAAO,SAAS,MAAM;EACjC,CAAC;CACH;CACA,aAAa,YAAY;EACvB,iBAAiB,aAAa;GAC5B,SAAS,OAAO,WAAW,OAAO;EACpC,CAAC;CACH;CACA,mBAAmB;EACjB,iBAAiB,aAAa;GAC5B,SAAS,OAAO,YAAY;EAC9B,CAAC;CACH;CACA,aAAa,YAAY;EACvB,iBAAiB,aAAa;GAC5B,SAAS,OAAO,WAAW,OAAO;EACpC,CAAC;CACH;CACA,eAAe,WAAW,MAAM,aAAa,SAAS,OAAO,QAAQ,CAAC;CACtE,cAAc,WAAW,QAAQ,CAAC,EAAE,OAAO,OAAO,KAAK,EAAE,GAAG,UAAU;CACtE,WAAW,YAAY,WAAW,QAAQ,CAAC,EAAE,OAAO,SAAS,OAAO,KAAK;CACzE,KAAK,OAAO,aAAa,WAAW,WAAW,aAAa,SAAS,OAAO,GAAG,OAAO,QAAQ,CAAC;AACjG"}