@usions/sdk 2.17.0 → 2.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usions/sdk",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "description": "Usion Mini App SDK for iframe games and services",
   "type": "module",
   "main": "src/modules/index.js",

package/src/browser.js

@@ -69,7 +69,7 @@ var Usion = (function () {
    * Core Usion object with init, _post, _request
    */
   const core = {
-    version: '2.17.0', // injected from package.json at build
+    version: '2.18.0', // injected from package.json at build
     config: {},
     _initialized: false,
     _initCallback: null,
@@ -263,14 +263,25 @@ var Usion = (function () {
      * to a specific screen — e.g. when the user taps a notification sent via
      * `Usion.notify.send({ path })`, the app reopens and `getLaunchParams().path`
      * returns that same path so the app can route to it.
-     * @returns {{ path: string|null, ref: string|null, roomId: string|null }}
+     *
+     * `mode` is how the app was launched: `'single'` (opened from Explore / the
+     * Game hub, played solo) or `'multiplayer'` (opened from a game invite in a
+     * chat, played with another person). The host declares it authoritatively;
+     * branch on it to skip lobby/matchmaking UI in single-player or wire up
+     * netcode in multiplayer. When the host doesn't declare a mode (legacy hosts
+     * or a standalone URL), it falls back to "a room means multiplayer".
+     * @returns {{ path: string|null, ref: string|null, roomId: string|null, mode: 'single'|'multiplayer' }}
      */
     getLaunchParams: function() {
       var c = this.config || {};
+      var mode = (c.mode === 'single' || c.mode === 'multiplayer')
+        ? c.mode
+        : (c.roomId ? 'multiplayer' : 'single');
       return {
         path: c.launchPath || null,
         ref: c.ref || c.launchRef || null,
         roomId: c.roomId || null,
+        mode: mode,
       };
     },
 
@@ -2507,6 +2518,17 @@ var Usion = (function () {
       } catch (e) { /* non-fatal */ }
     };
 
+    /**
+     * Whether this app was launched in multiplayer mode (opened from a game
+     * invite in a chat) rather than single-player (opened from Explore / the
+     * Game hub). Convenience wrapper over Usion.getLaunchParams().mode — use it
+     * to branch setup, e.g. skip matchmaking and run solo when false.
+     * @returns {boolean}
+     */
+    game.isMultiplayer = function() {
+      return Usion.getLaunchParams().mode === 'multiplayer';
+    };
+
     /**
      * Get connection status
      * @returns {boolean}

package/src/modules/core.js

@@ -260,14 +260,25 @@ export const core = {
    * to a specific screen — e.g. when the user taps a notification sent via
    * `Usion.notify.send({ path })`, the app reopens and `getLaunchParams().path`
    * returns that same path so the app can route to it.
-   * @returns {{ path: string|null, ref: string|null, roomId: string|null }}
+   *
+   * `mode` is how the app was launched: `'single'` (opened from Explore / the
+   * Game hub, played solo) or `'multiplayer'` (opened from a game invite in a
+   * chat, played with another person). The host declares it authoritatively;
+   * branch on it to skip lobby/matchmaking UI in single-player or wire up
+   * netcode in multiplayer. When the host doesn't declare a mode (legacy hosts
+   * or a standalone URL), it falls back to "a room means multiplayer".
+   * @returns {{ path: string|null, ref: string|null, roomId: string|null, mode: 'single'|'multiplayer' }}
    */
   getLaunchParams: function() {
     var c = this.config || {};
+    var mode = (c.mode === 'single' || c.mode === 'multiplayer')
+      ? c.mode
+      : (c.roomId ? 'multiplayer' : 'single');
     return {
       path: c.launchPath || null,
       ref: c.ref || c.launchRef || null,
       roomId: c.roomId || null,
+      mode: mode,
     };
   },
 

package/src/modules/game-methods.js

@@ -567,6 +567,17 @@ export function applyGameMethods(game, Usion) {
     } catch (e) { /* non-fatal */ }
   };
 
+  /**
+   * Whether this app was launched in multiplayer mode (opened from a game
+   * invite in a chat) rather than single-player (opened from Explore / the
+   * Game hub). Convenience wrapper over Usion.getLaunchParams().mode — use it
+   * to branch setup, e.g. skip matchmaking and run solo when false.
+   * @returns {boolean}
+   */
+  game.isMultiplayer = function() {
+    return Usion.getLaunchParams().mode === 'multiplayer';
+  };
+
   /**
    * Get connection status
    * @returns {boolean}

package/types/index.d.ts

@@ -31,6 +31,12 @@ export interface UsionConfig {
   launchPath?: string;
   /** Referral code the app was opened with, if any. */
   ref?: string;
+  /**
+   * How the app was launched: `'single'` (from Explore / the Game hub, solo)
+   * or `'multiplayer'` (from a game invite in a chat). Read via
+   * `Usion.getLaunchParams().mode`. (SDK ≥ 2.18)
+   */
+  mode?: 'single' | 'multiplayer';
 }
 
 // ─── Payment ─────────────────────────────────────────────────────
@@ -256,6 +262,12 @@ export interface GameModule {
   connectDirect(config?: DirectConnectionConfig): Promise<void>;
   disconnect(): void;
   isConnected(): boolean;
+  /**
+   * Whether the app was launched multiplayer (from a chat game invite) vs
+   * single-player (from Explore / the Game hub). Wrapper over
+   * `Usion.getLaunchParams().mode === 'multiplayer'`. (SDK ≥ 2.18)
+   */
+  isMultiplayer(): boolean;
 
   // Room & actions
   //
@@ -774,9 +786,11 @@ export interface UsionSDK {
   /**
    * Launch parameters the host opened this app with. `path` is the deep-link
    * target (e.g. from a tapped `Usion.notify` notification); route to it after
-   * init so the user lands on the right screen.
+   * init so the user lands on the right screen. `mode` is `'single'` (opened
+   * from Explore / the Game hub, solo) or `'multiplayer'` (opened from a game
+   * invite in a chat) — branch game setup on it. (mode: SDK ≥ 2.18)
    */
-  getLaunchParams(): { path: string | null; ref: string | null; roomId: string | null };
+  getLaunchParams(): { path: string | null; ref: string | null; roomId: string | null; mode: 'single' | 'multiplayer' };
 
   // Payments
   requestPayment(amount: number, reason: string, data?: PaymentOptions): Promise<PaymentResponse>;