@looplay/sdk 0.8.3 → 0.8.5

package/dist/looplay-sdk.esm.js

@@ -259,16 +259,16 @@ var ServiceClient = class {
     });
     return true;
   }
-  /** Signs a fresh `attemptToken` — required by `completeGameplayAttempt`/`completeGameplayMatch`/`recordGameplayAction`. */
-  async startGameplayAttempt(gameKey, auth = {}, body = {}) {
-    return this.http.request("POST", "/sdk/games/attempts/start", {
+  /** Signs a fresh `playSessionToken` — required by `completePlaySession`/`completeGameplayMatch`/`recordGameplayAction`. */
+  async startPlaySession(gameKey, auth = {}, body = {}) {
+    return this.http.request("POST", "/sdk/games/play-sessions/start", {
       ...auth,
       headers: { "x-game-key": gameKey, ...this.trackingHeaders(auth) },
       body
     });
   }
-  async completeGameplayAttempt(gameKey, auth, body) {
-    await this.http.request("POST", "/sdk/games/attempts/complete", {
+  async completePlaySession(gameKey, auth, body) {
+    await this.http.request("POST", "/sdk/games/play-sessions/complete", {
       ...auth,
       headers: { "x-game-key": gameKey, ...this.trackingHeaders(auth) },
       body
@@ -300,6 +300,16 @@ var ServiceClient = class {
       headers: { "x-looplay-anon-id": anonId }
     });
   }
+  /**
+   * Lightweight integration heartbeat for review/liveops. This intentionally
+   * does not record a view/play metric.
+   */
+  async detectGameIntegration(gameKey) {
+    await this.http.request("POST", "/sdk/games/integration/detect", {
+      headers: { "x-game-key": gameKey }
+    });
+    return true;
+  }
   trackingHeaders(auth) {
     return {
       "x-game-tracking-session-id": auth.trackingSessionId,
@@ -337,7 +347,7 @@ var ServiceClient = class {
   // `x-game-key` + the purchasing player's own bearer token, no backend or
   // secret pair required. Safe to call directly from client/browser code —
   // `checkoutToken` (short-lived, server-signed) plays the same role as
-  // `attemptToken` on the tracking routes. `ApiClient.purchaseStoreOffer`
+  // `playSessionToken` on the tracking routes. `ApiClient.purchaseStoreOffer`
   // wraps this pair for you.
   // ─────────────────────────────────────────────────────────────────────────────
   /** Signs a `checkoutToken` for one purchase — required by `purchaseMyStoreOffer`. */
@@ -408,30 +418,6 @@ var ServiceClient = class {
   async getMyBalance(bearerToken) {
     return this.http.request("GET", "/sdk/user/balance", { bearerToken });
   }
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Referrals
-  // ─────────────────────────────────────────────────────────────────────────────
-  async listReferrals(bearerToken, query) {
-    return this.http.request("GET", "/sdk/referrals", { bearerToken, query });
-  }
-  async setReferral(bearerToken, body) {
-    return this.http.request("POST", "/sdk/referrals/set", { bearerToken, body });
-  }
-  // ─────────────────────────────────────────────────────────────────────────────
-  // Tasks
-  // ─────────────────────────────────────────────────────────────────────────────
-  async listTasks(bearerToken, query) {
-    return this.http.request("GET", "/sdk/task", { bearerToken, query: { ...query } });
-  }
-  async listFinishedTasks(bearerToken, query) {
-    return this.http.request("GET", "/sdk/task/finished", { bearerToken, query: { ...query } });
-  }
-  async startTask(bearerToken, body) {
-    return this.http.request("POST", "/sdk/task/start", { bearerToken, body });
-  }
-  async claimTask(bearerToken, body) {
-    return this.http.request("POST", "/sdk/task/claim", { bearerToken, body });
-  }
 };
 
 // src/apps/api-client.ts
@@ -451,9 +437,9 @@ var ApiClient = class {
   getAnonymousId;
   trackingSession;
   trackingSessionPromise;
-  currentAttemptId;
-  gameplayAttempt;
-  gameplayAttemptPromise;
+  currentPlaySessionId;
+  playSession;
+  playSessionPromise;
   constructor(options) {
     if (!options.baseUrl) throw new MissingBaseUrlError();
     this.raw = new ServiceClient({
@@ -468,6 +454,9 @@ var ApiClient = class {
   unsafeRaw() {
     return this.raw;
   }
+  async detectIntegration(gameKey) {
+    return this.raw.detectGameIntegration(gameKey);
+  }
   // Real-time (balance_change / store_purchase_completed WebSocket events)
   // deliberately lives outside this class — import `WsClient` from
   // '@looplay/sdk/realtime' and construct it with the same `getAccessToken`
@@ -523,30 +512,30 @@ var ApiClient = class {
     return this.trackingSessionPromise;
   }
   /**
-   * Signs (and caches until near expiry) the `attemptToken` required by
-   * `trackPlay`/`trackMatch`/`emit` for the current attempt — does not
+   * Signs (and caches until near expiry) the `playSessionToken` required by
+   * `trackPlay`/`trackMatch`/`emit` for the current play session — does not
    * swallow failures, unlike `ensureTrackingSession`, since these calls
    * are rejected outright without a valid token.
    */
-  async ensureGameplayAttempt(gameKey, auth, attemptId) {
+  async ensurePlaySession(gameKey, auth, playSessionId) {
     const now = Date.now();
-    if (this.gameplayAttempt && this.gameplayAttempt.gameKey === gameKey && this.gameplayAttempt.attemptId === attemptId && this.gameplayAttempt.expiresAtMs > now + 1e4) {
-      return this.gameplayAttempt;
+    if (this.playSession && this.playSession.gameKey === gameKey && this.playSession.playSessionId === playSessionId && this.playSession.expiresAtMs > now + 1e4) {
+      return this.playSession;
     }
-    if (!this.gameplayAttemptPromise) {
-      this.gameplayAttemptPromise = this.raw.startGameplayAttempt(gameKey, auth, { attemptId }).then((dto) => {
-        this.gameplayAttempt = {
+    if (!this.playSessionPromise) {
+      this.playSessionPromise = this.raw.startPlaySession(gameKey, auth, { playSessionId }).then((dto) => {
+        this.playSession = {
           gameKey,
-          attemptId: dto.attemptId,
-          attemptToken: dto.attemptToken,
+          playSessionId: dto.playSessionId,
+          playSessionToken: dto.playSessionToken,
           expiresAtMs: new Date(dto.expiresAt).getTime()
         };
-        return this.gameplayAttempt;
+        return this.playSession;
       }).finally(() => {
-        this.gameplayAttemptPromise = void 0;
+        this.playSessionPromise = void 0;
       });
     }
-    return this.gameplayAttemptPromise;
+    return this.playSessionPromise;
   }
   /**
    * Call once when the game view opens, before any play/match tracking.
@@ -557,35 +546,35 @@ var ApiClient = class {
     return this.raw.recordGameView(gameKey, auth);
   }
   /**
-   * Starts a new play attempt and returns its id. Call when the user
+   * Starts a new play session and returns its id. Call when the user
    * presses Play; `trackPlay`/`trackMatch`/`emit` reuse this id (and the
-   * signed `attemptToken` backing it) across calls until the next
-   * `startAttempt()`, auto-starting one on first use if none was started.
+   * signed `playSessionToken` backing it) across calls until the next
+   * `startPlaySession()`, auto-starting one on first use if none was started.
    */
-  startAttempt() {
-    this.currentAttemptId = generateId();
-    this.gameplayAttempt = void 0;
-    return this.currentAttemptId;
+  startPlaySession() {
+    this.currentPlaySessionId = generateId();
+    this.playSession = void 0;
+    return this.currentPlaySessionId;
   }
   async trackPlay(gameKey, playTimeSeconds) {
     const auth = await this.resolveTrackingAuth();
-    const attemptId = this.currentAttemptId ?? this.startAttempt();
-    const { attemptToken } = await this.ensureGameplayAttempt(gameKey, auth, attemptId);
-    return this.raw.completeGameplayAttempt(gameKey, auth, { playTimeSeconds, attemptId, attemptToken });
+    const playSessionId = this.currentPlaySessionId ?? this.startPlaySession();
+    const { playSessionToken } = await this.ensurePlaySession(gameKey, auth, playSessionId);
+    return this.raw.completePlaySession(gameKey, auth, { playTimeSeconds, playSessionId, playSessionToken });
   }
   async trackMatch(gameKey, body) {
     const auth = await this.resolveTrackingAuth();
-    const attemptId = this.currentAttemptId ?? this.startAttempt();
-    const { attemptToken } = await this.ensureGameplayAttempt(gameKey, auth, attemptId);
-    return this.raw.completeGameplayMatch(gameKey, auth, { ...body, attemptId, attemptToken });
+    const playSessionId = this.currentPlaySessionId ?? this.startPlaySession();
+    const { playSessionToken } = await this.ensurePlaySession(gameKey, auth, playSessionId);
+    return this.raw.completeGameplayMatch(gameKey, auth, { ...body, playSessionId, playSessionToken });
   }
   async emit(gameKey, actionCode, opts) {
     const auth = await this.resolveTrackingAuth();
-    const attemptId = this.currentAttemptId ?? this.startAttempt();
-    const { attemptToken } = await this.ensureGameplayAttempt(gameKey, auth, attemptId);
+    const playSessionId = this.currentPlaySessionId ?? this.startPlaySession();
+    const { playSessionToken } = await this.ensurePlaySession(gameKey, auth, playSessionId);
     const body = {
-      attemptId,
-      attemptToken,
+      playSessionId,
+      playSessionToken,
       actionCode,
       value: opts?.value,
       refId: opts?.refId,
@@ -613,7 +602,7 @@ var ApiClient = class {
   }
   /**
    * Spends coin balance to purchase a store offer — signs a checkout intent
-   * first, then redeems it, mirroring the gameplay attempt flow above.
+   * first, then redeems it, mirroring the play session flow above.
    * Self-serve: only the player's own access token is used, no secret pair
    * required, safe to call directly from the game client. Also see
    * `onStorePurchase` to react to the result in real time from any tab.
@@ -648,30 +637,6 @@ var ApiClient = class {
     const token = await this.requireToken();
     return this.raw.getBalanceHistory(token, query);
   }
-  async listReferrals(query) {
-    const token = await this.requireToken();
-    return this.raw.listReferrals(token, query);
-  }
-  async setReferral(body) {
-    const token = await this.requireToken();
-    return this.raw.setReferral(token, body);
-  }
-  async listTasks(query) {
-    const token = await this.requireToken();
-    return this.raw.listTasks(token, query);
-  }
-  async listFinishedTasks(query) {
-    const token = await this.requireToken();
-    return this.raw.listFinishedTasks(token, query);
-  }
-  async startTask(body) {
-    const token = await this.requireToken();
-    return this.raw.startTask(token, body);
-  }
-  async claimTask(body) {
-    const token = await this.requireToken();
-    return this.raw.claimTask(token, body);
-  }
 };
 
 // src/looplay-sdk.ts
@@ -697,6 +662,7 @@ var LooplaySDK = class {
   async init(params) {
     this.gameId = params.gameId;
     await this.auth?.init();
+    await this.detectIntegration(params);
     await this.verifyGameId(params);
     this.initialized = true;
   }
@@ -718,11 +684,11 @@ var LooplaySDK = class {
     if (!this.gameId) throw new NotInitializedError();
     return this.api.trackView(this.gameId);
   }
-  /** Starts a new play attempt; call when the user presses Play. Returns the attempt id. */
-  startAttempt() {
+  /** Starts a new play session; call when the user presses Play. Returns the play session id. */
+  startPlaySession() {
     this.assertInitialized();
     if (!this.api) throw new MissingBaseUrlError();
-    return this.api.startAttempt();
+    return this.api.startPlaySession();
   }
   async trackPlay(playTimeSeconds) {
     this.assertInitialized();
@@ -765,6 +731,10 @@ var LooplaySDK = class {
     if (!this.api) throw new MissingBaseUrlError();
     await this.api.listGameAssets(params.gameId);
   }
+  async detectIntegration(params) {
+    if (!this.api) return;
+    await this.api.detectIntegration(params.gameId);
+  }
 };
 
 // src/auth/jwt.ts
@@ -934,11 +904,11 @@ var LooplayIframeAuth = class {
     return this.state.jwt;
   }
   getApiUrl() {
-    return this.options.apiUrl ?? this.state.apiUrl;
+    return this.state.apiUrl ?? this.options.apiUrl ?? null;
   }
   /** Resolves to the configured `appId`, falling back to whatever the parent pushed as `gameId`. */
   getGameId() {
-    return this.options.appId ?? this.state.gameId;
+    return this.state.gameId ?? this.options.appId ?? null;
   }
   getAnonymousId() {
     return this.state.anonymousId;
@@ -1090,9 +1060,9 @@ var LooplayIframeAuth = class {
     this.debug("trackView dispatched", { gameId });
     return this.getClient().trackView(gameId);
   }
-  /** Starts a new play attempt; call when the user presses Play. Returns the attempt id. */
-  startAttempt() {
-    return this.getClient().startAttempt();
+  /** Starts a new play session; call when the user presses Play. Returns the play session id. */
+  startPlaySession() {
+    return this.getClient().startPlaySession();
   }
   trackPlay(playTimeSeconds) {
     const gameId = this.getGameId();