@looplay/sdk 0.8.9 → 0.8.11

package/dist/looplay-sdk.esm.js

@@ -137,8 +137,45 @@ var LooplayAuth = class {
   }
 };
 
+// src/constants.ts
+var DEFAULT_API_URL = "https://miniapp-api.looplay.gg";
+function resolveEnvParentOrigin() {
+  try {
+    if (typeof import.meta !== "undefined" && import.meta.env?.VITE_PARENT_ORIGIN) {
+      const val = import.meta.env.VITE_PARENT_ORIGIN;
+      if (typeof val === "string" && val.trim().length > 0) return val.trim();
+    }
+  } catch {
+  }
+  try {
+    if (typeof process !== "undefined" && process.env?.VITE_PARENT_ORIGIN) {
+      const val = process.env.VITE_PARENT_ORIGIN;
+      if (typeof val === "string" && val.trim().length > 0) return val.trim();
+    }
+  } catch {
+  }
+  return void 0;
+}
+function resolveEnvApiUrl() {
+  try {
+    if (typeof import.meta !== "undefined" && import.meta.env) {
+      const val = import.meta.env.VITE_API_URL ?? import.meta.env.VITE_LOOPLAY_API_URL;
+      if (typeof val === "string" && val.trim().length > 0) return val.trim();
+    }
+  } catch {
+  }
+  try {
+    if (typeof process !== "undefined" && process.env) {
+      const val = process.env.VITE_API_URL ?? process.env.VITE_LOOPLAY_API_URL;
+      if (typeof val === "string" && val.trim().length > 0) return val.trim();
+    }
+  } catch {
+  }
+  return void 0;
+}
+
 // src/version.ts
-var LOOPLAY_SDK_VERSION = "0.8.5";
+var LOOPLAY_SDK_VERSION = "0.8.11";
 
 // src/apps/http.ts
 function getFetchFn(fetchOverride) {
@@ -164,8 +201,9 @@ var HttpClient = class {
   baseUrl;
   fetchFn;
   defaultHeaders;
-  constructor(options) {
-    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+  constructor(options = {}) {
+    const rawBaseUrl = typeof options.baseUrl === "string" && options.baseUrl.trim().length > 0 ? options.baseUrl.trim() : resolveEnvApiUrl() ?? DEFAULT_API_URL;
+    this.baseUrl = rawBaseUrl.replace(/\/$/, "");
     this.fetchFn = getFetchFn(options.fetch);
     this.defaultHeaders = {
       "x-looplay-sdk-version": LOOPLAY_SDK_VERSION,
@@ -231,9 +269,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
   // ─────────────────────────────────────────────────────────────────────────────
@@ -267,11 +314,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
@@ -280,33 +332,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
     });
   }
   /**
@@ -461,13 +524,26 @@ var ApiClient = class {
   playSession;
   playSessionPromiseKey;
   playSessionPromise;
-  constructor(options) {
-    if (!options.baseUrl) throw new MissingBaseUrlError();
+  constructor(options = {}) {
+    const baseUrl = typeof options.baseUrl === "string" && options.baseUrl.trim().length > 0 ? options.baseUrl.trim() : resolveEnvApiUrl() ?? DEFAULT_API_URL;
+    if (!baseUrl) throw new MissingBaseUrlError();
     this.raw = new ServiceClient({
-      baseUrl: options.baseUrl,
+      baseUrl,
       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;
   }
@@ -599,6 +675,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();
@@ -682,43 +783,6 @@ var ApiClient = class {
   }
 };
 
-// src/constants.ts
-var DEFAULT_API_URL = "https://miniapp-api.looplay.gg";
-function resolveEnvParentOrigin() {
-  try {
-    if (typeof import.meta !== "undefined" && import.meta.env?.VITE_PARENT_ORIGIN) {
-      const val = import.meta.env.VITE_PARENT_ORIGIN;
-      if (typeof val === "string" && val.trim().length > 0) return val.trim();
-    }
-  } catch {
-  }
-  try {
-    if (typeof process !== "undefined" && process.env?.VITE_PARENT_ORIGIN) {
-      const val = process.env.VITE_PARENT_ORIGIN;
-      if (typeof val === "string" && val.trim().length > 0) return val.trim();
-    }
-  } catch {
-  }
-  return void 0;
-}
-function resolveEnvApiUrl() {
-  try {
-    if (typeof import.meta !== "undefined" && import.meta.env) {
-      const val = import.meta.env.VITE_API_URL ?? import.meta.env.VITE_LOOPLAY_API_URL;
-      if (typeof val === "string" && val.trim().length > 0) return val.trim();
-    }
-  } catch {
-  }
-  try {
-    if (typeof process !== "undefined" && process.env) {
-      const val = process.env.VITE_API_URL ?? process.env.VITE_LOOPLAY_API_URL;
-      if (typeof val === "string" && val.trim().length > 0) return val.trim();
-    }
-  } catch {
-  }
-  return void 0;
-}
-
 // src/looplay-sdk.ts
 var LooplaySDK = class {
   auth;
@@ -728,21 +792,19 @@ var LooplaySDK = class {
   constructor(options = {}) {
     const {
       auth,
-      baseUrl = resolveEnvApiUrl() ?? DEFAULT_API_URL,
       fetch,
       defaultHeaders
     } = options;
+    const baseUrl = typeof options.baseUrl === "string" && options.baseUrl.trim().length > 0 ? options.baseUrl.trim() : resolveEnvApiUrl() ?? DEFAULT_API_URL;
     if (auth) {
       this.auth = new LooplayAuth(auth);
     }
-    if (baseUrl) {
-      this.api = new ApiClient({
-        baseUrl,
-        fetch,
-        defaultHeaders,
-        getAccessToken: async () => this.auth?.getAccessToken()
-      });
-    }
+    this.api = new ApiClient({
+      baseUrl,
+      fetch,
+      defaultHeaders,
+      getAccessToken: async () => this.auth?.getAccessToken()
+    });
   }
   async init(params) {
     this.gameId = params.gameId;
@@ -757,6 +819,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();
@@ -775,6 +846,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();
@@ -1004,7 +1085,8 @@ var LooplayIframeAuth = class {
     return this.state.jwt;
   }
   getApiUrl() {
-    return this.state.apiUrl ?? this.options.apiUrl ?? resolveEnvApiUrl() ?? DEFAULT_API_URL;
+    const raw = toOptionalString(this.state.apiUrl) ?? toOptionalString(this.options.apiUrl) ?? resolveEnvApiUrl() ?? DEFAULT_API_URL;
+    return raw.trim();
   }
   /** Resolves to the configured `appId`, falling back to whatever the parent pushed as `gameId`. */
   getGameId() {
@@ -1150,6 +1232,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();
@@ -1166,6 +1257,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) {
@@ -1379,7 +1484,10 @@ ${gameId}`;
     }
   }
   resolveParentOrigin() {
-    if (this.options.parentOrigin) return this.options.parentOrigin;
+    if (this.options.parentOrigin) {
+      const opt = toOptionalString(this.options.parentOrigin);
+      if (opt) return opt;
+    }
     const envOrigin = resolveEnvParentOrigin();
     if (envOrigin) return envOrigin;
     if (typeof document === "undefined" || !document.referrer) return null;