@looplay/sdk 0.8.10 → 0.8.11

package/dist/looplay-sdk.cjs.js

@@ -178,7 +178,7 @@ function resolveEnvApiUrl() {
 }
 
 // src/version.ts
-var LOOPLAY_SDK_VERSION = "0.8.10";
+var LOOPLAY_SDK_VERSION = "0.8.11";
 
 // src/apps/http.ts
 function getFetchFn(fetchOverride) {
@@ -272,9 +272,18 @@ var HttpClient = class {
 // src/apps/service-client.ts
 var ServiceClient = class {
   http;
+  playSessionTokens = /* @__PURE__ */ new Map();
+  onPlaySessionIssuedListener;
   constructor(options) {
     this.http = new HttpClient(options);
   }
+  /**
+   * Internal hook for ApiClient to subscribe to issued/renewed play sessions.
+   * @internal
+   */
+  _setOnPlaySessionIssued(listener) {
+    this.onPlaySessionIssuedListener = listener;
+  }
   // ─────────────────────────────────────────────────────────────────────────────
   // Auth
   // ─────────────────────────────────────────────────────────────────────────────
@@ -308,11 +317,16 @@ var ServiceClient = class {
   }
   /** Signs a fresh `playSessionToken` — required by `completePlaySession`/`completeGameplayMatch`/`recordGameplayAction`. */
   async startPlaySession(gameKey, auth = {}, body = {}) {
-    return this.http.request("POST", "/sdk/games/play-sessions/start", {
+    const dto = await this.http.request("POST", "/sdk/games/play-sessions/start", {
       ...auth,
       headers: { "x-game-key": gameKey, ...this.trackingHeaders(auth) },
       body
     });
+    if (dto?.playSessionId && dto?.playSessionToken) {
+      this.playSessionTokens.set(dto.playSessionId, dto.playSessionToken);
+    }
+    this.onPlaySessionIssuedListener?.(dto, gameKey, auth);
+    return dto;
   }
   /**
    * Re-issues a fresh `playSessionToken` for the SAME `playSessionId` — call
@@ -321,33 +335,44 @@ var ServiceClient = class {
    * long-running sessions keep a single `playSessionId` throughout.
    */
   async renewPlaySession(gameKey, auth = {}, body) {
-    return this.http.request("POST", "/sdk/games/play-sessions/renew", {
+    const dto = await this.http.request("POST", "/sdk/games/play-sessions/renew", {
       ...auth,
       headers: { "x-game-key": gameKey, ...this.trackingHeaders(auth) },
       body
     });
+    if (dto?.playSessionId && dto?.playSessionToken) {
+      this.playSessionTokens.set(dto.playSessionId, dto.playSessionToken);
+    }
+    this.onPlaySessionIssuedListener?.(dto, gameKey, auth);
+    return dto;
   }
   async completePlaySession(gameKey, auth, body) {
+    const playSessionToken = body.playSessionToken || (body.playSessionId ? this.playSessionTokens.get(body.playSessionId) : void 0);
+    const resolvedBody = playSessionToken ? { ...body, playSessionToken } : body;
     await this.http.request("POST", "/sdk/games/play-sessions/complete", {
       ...auth,
       headers: { "x-game-key": gameKey, ...this.trackingHeaders(auth) },
-      body
+      body: resolvedBody
     });
     return true;
   }
   async completeGameplayMatch(gameKey, auth, body) {
+    const playSessionToken = body.playSessionToken || (body.playSessionId ? this.playSessionTokens.get(body.playSessionId) : void 0);
+    const resolvedBody = playSessionToken ? { ...body, playSessionToken } : body;
     await this.http.request("POST", "/sdk/games/matches/complete", {
       ...auth,
       headers: { "x-game-key": gameKey, ...this.trackingHeaders(auth) },
-      body
+      body: resolvedBody
     });
     return true;
   }
   async recordGameplayAction(gameKey, auth, body) {
+    const playSessionToken = body.playSessionToken || (body.playSessionId ? this.playSessionTokens.get(body.playSessionId) : void 0);
+    const resolvedBody = playSessionToken ? { ...body, playSessionToken } : body;
     return this.http.request("POST", "/sdk/games/actions/record", {
       ...auth,
       headers: { "x-game-key": gameKey, ...this.trackingHeaders(auth) },
-      body
+      body: resolvedBody
     });
   }
   /**
@@ -510,6 +535,18 @@ var ApiClient = class {
       fetch: options.fetch,
       defaultHeaders: options.defaultHeaders
     });
+    this.raw._setOnPlaySessionIssued((dto, gameKey, auth) => {
+      if (dto?.playSessionId && dto?.playSessionToken) {
+        this.currentPlaySessionId = dto.playSessionId;
+        this.playSession = {
+          cacheKey: [gameKey, dto.playSessionId, this.getTrackingAuthKey(auth)].join(":"),
+          gameKey,
+          playSessionId: dto.playSessionId,
+          playSessionToken: dto.playSessionToken,
+          expiresAtMs: dto.expiresAt ? new Date(dto.expiresAt).getTime() : Date.now() + 2 * 3600 * 1e3
+        };
+      }
+    });
     this.getAccessToken = options.getAccessToken;
     this.getAnonymousId = options.getAnonymousId;
   }
@@ -641,6 +678,31 @@ var ApiClient = class {
     this.playSession = void 0;
     return this.currentPlaySessionId;
   }
+  /**
+   * Starts a new play session on the server and caches the signed  immediately.
+   */
+  async startPlaySessionAsync(gameKey, body = {}) {
+    const auth = await this.resolveTrackingAuth();
+    const playSessionId = body.playSessionId ?? this.currentPlaySessionId ?? this.startPlaySession();
+    return this.raw.startPlaySession(gameKey, auth, { ...body, playSessionId });
+  }
+  /**
+   * Explicitly sets or updates the active play session token cache.
+   */
+  setPlaySession(playSession) {
+    this.currentPlaySessionId = playSession.playSessionId;
+    this.playSession = {
+      cacheKey: [playSession.gameKey, playSession.playSessionId].join(":"),
+      gameKey: playSession.gameKey,
+      playSessionId: playSession.playSessionId,
+      playSessionToken: playSession.playSessionToken,
+      expiresAtMs: playSession.expiresAtMs ?? Date.now() + 2 * 3600 * 1e3
+    };
+  }
+  /** Returns the active cached play session, or undefined if none has been issued yet. */
+  getCurrentPlaySession() {
+    return this.playSession;
+  }
   async trackPlay(gameKey, playTimeSeconds) {
     const auth = await this.resolveTrackingAuth();
     const playSessionId = this.currentPlaySessionId ?? this.startPlaySession();
@@ -760,6 +822,15 @@ var LooplaySDK = class {
   getGameId() {
     return this.gameId;
   }
+  get currentPlaySessionId() {
+    return this.api?.currentPlaySessionId;
+  }
+  get playSession() {
+    return this.api?.playSession;
+  }
+  unsafeRaw() {
+    return this.api?.unsafeRaw();
+  }
   async getMyProfile() {
     this.assertInitialized();
     if (!this.api) throw new MissingBaseUrlError();
@@ -778,6 +849,16 @@ var LooplaySDK = class {
     if (!this.api) throw new MissingBaseUrlError();
     return this.api.startPlaySession();
   }
+  /**
+   * Starts a new play session asynchronously on the backend; returns the issued PlaySessionDto
+   * (containing playSessionId and playSessionToken).
+   */
+  async startPlaySessionAsync(body) {
+    this.assertInitialized();
+    if (!this.api) throw new MissingBaseUrlError();
+    if (!this.gameId) throw new NotInitializedError();
+    return this.api.startPlaySessionAsync(this.gameId, body);
+  }
   async trackPlay(playTimeSeconds) {
     this.assertInitialized();
     if (!this.api) throw new MissingBaseUrlError();
@@ -1154,6 +1235,15 @@ var LooplayIframeAuth = class {
     });
     return this.client;
   }
+  get currentPlaySessionId() {
+    return this.getClient().currentPlaySessionId;
+  }
+  get playSession() {
+    return this.getClient().playSession;
+  }
+  unsafeRaw() {
+    return this.getClient().unsafeRaw();
+  }
   /** Call once when the game view opens, before any play/match tracking. */
   trackView() {
     const gameId = this.getGameId();
@@ -1170,6 +1260,20 @@ var LooplayIframeAuth = class {
   startPlaySession() {
     return this.getClient().startPlaySession();
   }
+  /**
+   * Starts a new play session asynchronously on the backend; returns the issued PlaySessionDto
+   * (containing playSessionId and playSessionToken) or null if auth/tracking is not ready.
+   */
+  async startPlaySessionAsync(body) {
+    const gameId = this.getGameId();
+    if (!this.canTrack() || !gameId) {
+      this.debug("startPlaySessionAsync skipped; auth is not ready", {
+        hasGameId: Boolean(gameId)
+      });
+      return null;
+    }
+    return this.getClient().startPlaySessionAsync(gameId, body);
+  }
   trackPlay(playTimeSeconds) {
     const gameId = this.getGameId();
     if (!this.canTrack() || !gameId) {