minimojs 1.0.0-alpha.36 → 1.0.0-alpha.37

package/dist/minimo-multiplayer.d.ts

@@ -100,6 +100,19 @@ export interface RoomUpdate {
     /** Passes the turn: `"next"`, the next player by seat, or a player's id. */
     turn?: "next" | string;
 }
+/**
+ * The room a player is expected in when the game starts, from
+ * {@link Multiplayer.pendingRoom}.
+ */
+export interface PendingRoom {
+    /** The room's code, such as `KQ7XA`. */
+    code: string;
+    /**
+     * `true` when the player opened the room's link, an invitation; `false`
+     * when they were already in the room on this device, as after a reload.
+     */
+    invited: boolean;
+}
 /** Options for {@link Room.showResults}. */
 export interface RoomResultsOptions {
     /** A title instead of `"Results"`. */
@@ -295,6 +308,16 @@ export declare class Room {
  * await room.end({ [winnerId]: 1 });
  * const choice = await room.showResults(); // "rematch" or "leave"
  * ```
+ *
+ * A game with its own welcome screen asks {@link Multiplayer.pendingRoom}
+ * first, so a player who opened a room's link, or reloaded the page in a
+ * room, goes straight to it instead of to the welcome screen:
+ *
+ * ```js
+ * const pending = await mp.pendingRoom();
+ * if (pending) room = await mp.lobby(); // that room's lobby, or its game in progress
+ * else showWelcome();                   // Play online, then mp.lobby() to create or join
+ * ```
  */
 export declare class Multiplayer {
     /**
@@ -313,6 +336,19 @@ export declare class Multiplayer {
     create(): Promise<Room>;
     /** Joins a room by its code, without the lobby, or returns to one the player is in. */
     join(code: string): Promise<Room>;
+    /**
+     * The room this player is expected in, before any screen is shown: the room
+     * whose link they opened, an invitation, or the room they were in on this
+     * device before the page reloaded. `null` on a normal visit, outside
+     * Minimo Games, and when the game's creator is not on Pro.
+     *
+     * It opens nothing, joins nothing, and can be asked again: the room stays
+     * pending until the player is in it. {@link Multiplayer.lobby} then takes
+     * them straight into it. A room that has closed since, as an old link's,
+     * is still returned, and the lobby then says there is no room with that
+     * code.
+     */
+    pendingRoom(): Promise<PendingRoom | null>;
     /**
      * The player's name on Minimo Games, the one leaderboards show, or `null`
      * before they choose one.

package/dist/minimo-multiplayer.js

@@ -772,6 +772,16 @@ export class Room {
  * await room.end({ [winnerId]: 1 });
  * const choice = await room.showResults(); // "rematch" or "leave"
  * ```
+ *
+ * A game with its own welcome screen asks {@link Multiplayer.pendingRoom}
+ * first, so a player who opened a room's link, or reloaded the page in a
+ * room, goes straight to it instead of to the welcome screen:
+ *
+ * ```js
+ * const pending = await mp.pendingRoom();
+ * if (pending) room = await mp.lobby(); // that room's lobby, or its game in progress
+ * else showWelcome();                   // Play online, then mp.lobby() to create or join
+ * ```
  */
 export class Multiplayer {
     /**
@@ -897,6 +907,29 @@ export class Multiplayer {
         const result = await request("join", { code: String(code).trim().toUpperCase() });
         return this._adopt(result.room);
     }
+    /**
+     * The room this player is expected in, before any screen is shown: the room
+     * whose link they opened, an invitation, or the room they were in on this
+     * device before the page reloaded. `null` on a normal visit, outside
+     * Minimo Games, and when the game's creator is not on Pro.
+     *
+     * It opens nothing, joins nothing, and can be asked again: the room stays
+     * pending until the player is in it. {@link Multiplayer.lobby} then takes
+     * them straight into it. A room that has closed since, as an old link's,
+     * is still returned, and the lobby then says there is no room with that
+     * code.
+     */
+    async pendingRoom() {
+        if (this._room && !this._room.closed)
+            return { code: this._room.code, invited: false };
+        if (!(await connectHost()))
+            return null;
+        const info = await request("hello", {}, HOST_TIMEOUT_MS * 2).catch(() => null);
+        if (!info || !info.available || typeof info.roomCode !== "string")
+            return null;
+        const code = info.roomCode.trim().toUpperCase();
+        return /^[A-Z0-9]{5}$/.test(code) ? { code, invited: Boolean(info.fromLink) } : null;
+    }
     /**
      * The player's name on Minimo Games, the one leaderboards show, or `null`
      * before they choose one.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimojs",
-  "version": "1.0.0-alpha.36",
+  "version": "1.0.0-alpha.37",
   "description": "MinimoJS v1 — ultra-minimal, flat, deterministic 2D web game engine. Image-first sprites with emoji as a zero-asset alternative, rAF loop, TypeScript-first, LLM-friendly.",
   "type": "module",
   "main": "dist/minimo.js",