@looplay/sdk 0.2.0 → 0.4.0

package/dist/looplay-sdk.cjs.js

@@ -249,107 +249,141 @@ var ServiceClient = class {
   // Games
   // ─────────────────────────────────────────────────────────────────────────────
   async listGames(query) {
-    return this.http.request("GET", "/games", { query });
+    return this.http.request("GET", "/sdk/games", { query });
   }
   async getGameDetail(gameId, bearerToken) {
-    return this.http.request("GET", `/games/${encodeURIComponent(gameId)}`, {
+    return this.http.request("GET", `/sdk/games/${encodeURIComponent(gameId)}`, {
       bearerToken
     });
   }
   async listRecentPlayed(bearerToken, query) {
-    return this.http.request("GET", "/games/recent-play", { bearerToken, query });
+    return this.http.request("GET", "/sdk/games/recent-play", { bearerToken, query });
   }
-  async trackPlay(auth, gameId, playTimeSeconds) {
-    const body = { playTimeSeconds };
-    await this.http.request("POST", `/games/${encodeURIComponent(gameId)}/play`, {
+  async trackView(auth, gameId) {
+    await this.http.request("POST", `/sdk/games/${encodeURIComponent(gameId)}/view`, {
       ...auth,
+      headers: this.trackingHeaders(auth)
+    });
+    return true;
+  }
+  async trackPlay(auth, gameId, attemptId, playTimeSeconds) {
+    const body = { playTimeSeconds, attemptId };
+    await this.http.request("POST", `/sdk/games/${encodeURIComponent(gameId)}/play`, {
+      ...auth,
+      headers: this.trackingHeaders(auth),
       body
     });
     return true;
   }
   async trackMatchEnd(auth, gameId, body) {
-    await this.http.request("POST", `/games/${encodeURIComponent(gameId)}/end`, {
+    await this.http.request("POST", `/sdk/games/${encodeURIComponent(gameId)}/end`, {
       ...auth,
+      headers: this.trackingHeaders(auth),
       body
     });
     return true;
   }
   async emitGameEvent(auth, gameId, body) {
-    return this.http.request("POST", `/games/${encodeURIComponent(gameId)}/emit`, {
+    return this.http.request("POST", `/sdk/games/${encodeURIComponent(gameId)}/emit`, {
       ...auth,
+      headers: this.trackingHeaders(auth),
       body
     });
   }
+  /**
+   * Anonymous runtimes must call this before any tracking call; logged-in
+   * runtimes should still call it to get a `trackingSessionId` for unified
+   * tracing — see `GameTrackingSessionDto`.
+   */
+  async issueTrackingSession(anonId) {
+    return this.http.request("POST", "/sdk/games/tracking/bootstrap", {
+      headers: { "x-looplay-anon-id": anonId }
+    });
+  }
+  trackingHeaders(auth) {
+    return {
+      "x-game-tracking-session-id": auth.trackingSessionId,
+      "x-looplay-anon-token": auth.anonTrackingToken
+    };
+  }
+  // ─────────────────────────────────────────────────────────────────────────────
+  // Game assets — spend coin balance on assets defined by the game's
+  // creator. Coin balance itself comes from getBalances()/getMyBalance().
+  // ─────────────────────────────────────────────────────────────────────────────
+  async listGameAssets(gameId, bearerToken) {
+    return this.http.request("GET", `/sdk/games/${encodeURIComponent(gameId)}/assets`, {
+      bearerToken
+    });
+  }
+  async purchaseGameAsset(bearerToken, gameId, assetCode, body = {}) {
+    return this.http.request(
+      "POST",
+      `/sdk/games/${encodeURIComponent(gameId)}/assets/${encodeURIComponent(assetCode)}/purchase`,
+      { bearerToken, body }
+    );
+  }
   // ─────────────────────────────────────────────────────────────────────────────
   // Balance
   // ─────────────────────────────────────────────────────────────────────────────
   async getBalances(bearerToken, query) {
-    return this.http.request("GET", "/balance", { bearerToken, query });
+    return this.http.request("GET", "/sdk/balance", { bearerToken, query });
   }
   async getBalanceHistory(bearerToken, query) {
-    return this.http.request("GET", "/balance/history", { bearerToken, query });
+    return this.http.request("GET", "/sdk/balance/history", { bearerToken, query });
   }
   // ─────────────────────────────────────────────────────────────────────────────
   // User
   // ─────────────────────────────────────────────────────────────────────────────
   async getMyProfile(bearerToken) {
-    return this.http.request("GET", "/user/profile", { bearerToken });
+    return this.http.request("GET", "/sdk/user/profile", { bearerToken });
   }
   async getMyBalance(bearerToken) {
-    return this.http.request("GET", "/user/balance", { bearerToken });
+    return this.http.request("GET", "/sdk/user/balance", { bearerToken });
   }
   // ─────────────────────────────────────────────────────────────────────────────
   // Referrals
   // ─────────────────────────────────────────────────────────────────────────────
   async listReferrals(bearerToken, query) {
-    return this.http.request("GET", "/referrals", { bearerToken, query });
+    return this.http.request("GET", "/sdk/referrals", { bearerToken, query });
   }
   async setReferral(bearerToken, body) {
-    return this.http.request("POST", "/referrals/set", { bearerToken, body });
+    return this.http.request("POST", "/sdk/referrals/set", { bearerToken, body });
   }
   // ─────────────────────────────────────────────────────────────────────────────
-  // Tasks / Quests
+  // Tasks
   // ─────────────────────────────────────────────────────────────────────────────
   async listTasks(bearerToken) {
-    return this.http.request("GET", "/task", { bearerToken });
+    return this.http.request("GET", "/sdk/task", { bearerToken });
   }
   async listFinishedTasks(bearerToken) {
-    return this.http.request("GET", "/task/finished", { bearerToken });
+    return this.http.request("GET", "/sdk/task/finished", { bearerToken });
   }
   async startTask(bearerToken, body) {
-    return this.http.request("POST", "/task/start", { bearerToken, body });
+    return this.http.request("POST", "/sdk/task/start", { bearerToken, body });
   }
   async claimTask(bearerToken, body) {
-    return this.http.request("POST", "/task/claim", { bearerToken, body });
-  }
-  async getPlatformQuests(bearerToken, query) {
-    return this.http.request("GET", "/quest/platform", { bearerToken, query });
-  }
-  async getCampaignQuests(bearerToken, query) {
-    return this.http.request("GET", "/quest/campaign", { bearerToken, query });
-  }
-  async claimQuest(bearerToken, questProgressId) {
-    return this.http.request("POST", `/quest/${encodeURIComponent(questProgressId)}/claim`, {
-      bearerToken
-    });
-  }
-  async claimMilestone(bearerToken, milestoneId, body) {
-    return this.http.request(
-      "POST",
-      `/quest/milestone/${encodeURIComponent(milestoneId)}/claim`,
-      {
-        bearerToken,
-        body
-      }
-    );
+    return this.http.request("POST", "/sdk/task/claim", { bearerToken, body });
   }
 };
 
 // src/apps/api-client.ts
+function generateId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
 var ApiClient = class {
   raw;
   getAccessToken;
   getAnonymousId;
+  trackingSession;
+  trackingSessionPromise;
+  currentAttemptId;
   constructor(options) {
     if (!options.baseUrl) throw new MissingBaseUrlError();
     this.raw = new ServiceClient({
@@ -377,14 +411,46 @@ var ApiClient = class {
   /**
    * Resolves auth for the tracking endpoints: a real bearer token if logged
    * in, otherwise an anonymous device id. Throws only when neither is
-   * available — anonymous tracking still requires *some* identity.
+   * available — anonymous tracking still requires *some* identity. Also
+   * attaches a `trackingSessionId`/`anonTrackingToken` (bootstrapped and
+   * cached lazily) — the backend's tracking contract expects these even for
+   * logged-in callers, for unified tracing.
    */
   async resolveTrackingAuth() {
     const bearerToken = await this.getAccessToken?.();
-    if (bearerToken) return { bearerToken };
-    const anonId = this.getAnonymousId?.();
-    if (anonId) return { anonId };
-    throw new NotAuthenticatedError();
+    const anonId = bearerToken ? void 0 : this.getAnonymousId?.();
+    if (!bearerToken && !anonId) throw new NotAuthenticatedError();
+    const session = await this.ensureTrackingSession(anonId);
+    return {
+      bearerToken,
+      anonId,
+      trackingSessionId: session?.trackingSessionId,
+      anonTrackingToken: session?.anonTrackingToken
+    };
+  }
+  /**
+   * Bootstraps (and caches until near expiry) the platform tracking
+   * session. Swallows failures — tracking calls still work without it,
+   * just without unified session tracing.
+   */
+  async ensureTrackingSession(anonId) {
+    const now = Date.now();
+    if (this.trackingSession && this.trackingSession.expiresAtMs > now + 3e4) {
+      return this.trackingSession;
+    }
+    if (!this.trackingSessionPromise) {
+      this.trackingSessionPromise = this.raw.issueTrackingSession(anonId).then((dto) => {
+        this.trackingSession = {
+          trackingSessionId: dto.trackingSessionId,
+          anonTrackingToken: dto.trackingToken,
+          expiresAtMs: new Date(dto.expiresAt).getTime()
+        };
+        return this.trackingSession;
+      }).catch(() => void 0).finally(() => {
+        this.trackingSessionPromise = void 0;
+      });
+    }
+    return this.trackingSessionPromise;
   }
   async getGameDetail(gameId) {
     const token = await this.getAccessToken?.();
@@ -394,9 +460,24 @@ var ApiClient = class {
     const token = await this.requireToken();
     return this.raw.listRecentPlayed(token, query);
   }
+  /** Call once when the game view opens, before any play/match tracking. */
+  async trackView(gameId) {
+    const auth = await this.resolveTrackingAuth();
+    return this.raw.trackView(auth, gameId);
+  }
+  /**
+   * Starts a new play attempt and returns its id. Call when the user
+   * presses Play; `trackPlay` reuses this id across calls until the next
+   * `startAttempt()`, auto-starting one on first use if none was started.
+   */
+  startAttempt() {
+    this.currentAttemptId = generateId();
+    return this.currentAttemptId;
+  }
   async trackPlay(gameId, playTimeSeconds) {
     const auth = await this.resolveTrackingAuth();
-    return this.raw.trackPlay(auth, gameId, playTimeSeconds);
+    const attemptId = this.currentAttemptId ?? this.startAttempt();
+    return this.raw.trackPlay(auth, gameId, attemptId, playTimeSeconds);
   }
   async trackMatch(gameId, body) {
     const auth = await this.resolveTrackingAuth();
@@ -412,6 +493,16 @@ var ApiClient = class {
     };
     return this.raw.emitGameEvent(auth, gameId, body);
   }
+  /** Lists assets purchasable in `gameId`, defined by that game's creator. */
+  async listGameAssets(gameId) {
+    const token = await this.getAccessToken?.();
+    return this.raw.listGameAssets(gameId, token);
+  }
+  /** Spends coin balance to purchase an asset — see PurchaseGameAssetRequest for dedupe/quantity. */
+  async purchaseGameAsset(gameId, assetCode, opts) {
+    const token = await this.requireToken();
+    return this.raw.purchaseGameAsset(token, gameId, assetCode, opts);
+  }
   async getMyProfile() {
     const token = await this.requireToken();
     return this.raw.getMyProfile(token);
@@ -452,22 +543,6 @@ var ApiClient = class {
     const token = await this.requireToken();
     return this.raw.claimTask(token, body);
   }
-  async getPlatformQuests(query) {
-    const token = await this.requireToken();
-    return this.raw.getPlatformQuests(token, query);
-  }
-  async getCampaignQuests(query) {
-    const token = await this.requireToken();
-    return this.raw.getCampaignQuests(token, query);
-  }
-  async claimQuest(questProgressId) {
-    const token = await this.requireToken();
-    return this.raw.claimQuest(token, questProgressId);
-  }
-  async claimMilestone(milestoneId, body) {
-    const token = await this.requireToken();
-    return this.raw.claimMilestone(token, milestoneId, body);
-  }
 };
 
 // src/looplay-sdk.ts
@@ -507,6 +582,19 @@ var LooplaySDK = class {
     if (!this.api) throw new MissingBaseUrlError();
     return this.api.getMyProfile();
   }
+  /** Call once when the game view opens, before any play/match tracking. */
+  async trackView() {
+    this.assertInitialized();
+    if (!this.api) throw new MissingBaseUrlError();
+    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() {
+    this.assertInitialized();
+    if (!this.api) throw new MissingBaseUrlError();
+    return this.api.startAttempt();
+  }
   async trackPlay(playTimeSeconds) {
     this.assertInitialized();
     if (!this.api) throw new MissingBaseUrlError();
@@ -802,6 +890,20 @@ var LooplayIframeAuth = class {
     });
     return this.client;
   }
+  /** Call once when the game view opens, before any play/match tracking. */
+  trackView() {
+    const gameId = this.getGameId();
+    if (!this.canTrack() || !gameId) {
+      this.debug("trackView skipped; auth is not ready", { hasGameId: Boolean(gameId) });
+      return Promise.resolve(false);
+    }
+    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();
+  }
   trackPlay(playTimeSeconds) {
     const gameId = this.getGameId();
     if (!this.canTrack() || !gameId) {
@@ -874,10 +976,36 @@ ${identity}`;
     const jwt = toOptionalString(data.jwt);
     const gameId = toOptionalString(data.gameId);
     const apiUrl = toOptionalString(data.apiUrl);
-    if (!jwt || !gameId || !apiUrl) {
+    const resolvedGameId = gameId ?? this.getGameId();
+    const resolvedApiUrl = apiUrl ?? this.getApiUrl();
+    if (!resolvedGameId || !resolvedApiUrl) {
+      this.lastGameStartedKey = null;
+      this.setState({
+        ...this.state,
+        jwt: null,
+        gameId: null,
+        apiUrl: null,
+        origin,
+        receivedAt: Date.now()
+      });
+      this.debug("auth message missing game identity; falling back to anonymous tracking");
+      this.activateAnonymousMode();
+      return;
+    }
+    if (!jwt) {
       this.lastGameStartedKey = null;
-      this.setState({ ...this.state, jwt: null, gameId: null, apiUrl: null, origin, receivedAt: Date.now() });
-      this.debug("auth cleared by parent; falling back to anonymous tracking");
+      this.setState({
+        ...this.state,
+        jwt: null,
+        gameId: resolvedGameId,
+        apiUrl: resolvedApiUrl,
+        origin,
+        receivedAt: Date.now()
+      });
+      this.debug("auth message missing jwt; falling back to anonymous tracking", {
+        gameId: resolvedGameId,
+        apiUrl: resolvedApiUrl
+      });
       this.activateAnonymousMode();
       return;
     }