@looplay/sdk 0.8.3 → 0.8.4

package/dist/types/apps/api-client.d.ts

@@ -1,4 +1,4 @@
-import type { EmitGameEventResponse, GameAssetDto, GameEventKey, GameOwnedAssetDto, GameStoreDto, GameStoreOfferPurchaseResultDto, PagingResponse, TaskListQuery } from './LooplaySDK.types';
+import type { EmitGameEventResponse, GameAssetDto, GameEventKey, GameOwnedAssetDto, GameStoreDto, GameStoreOfferPurchaseResultDto, PagingResponse } from './LooplaySDK.types';
 import { ServiceClient } from './service-client';
 import type { ServiceClientOptions } from './service-client';
 export interface ApiClientOptions extends Omit<ServiceClientOptions, 'baseUrl'> {
@@ -20,12 +20,13 @@ export declare class ApiClient {
     private readonly getAnonymousId?;
     private trackingSession?;
     private trackingSessionPromise?;
-    private currentAttemptId?;
-    private gameplayAttempt?;
-    private gameplayAttemptPromise?;
+    private currentPlaySessionId?;
+    private playSession?;
+    private playSessionPromise?;
     constructor(options: ApiClientOptions);
     /** Expose the underlying route-level client (requires manual bearerToken/gameKey passing). */
     unsafeRaw(): ServiceClient;
+    detectIntegration(gameKey: string): Promise<boolean>;
     private requireToken;
     /**
      * Resolves auth for the tracking endpoints: a real bearer token if logged
@@ -43,24 +44,24 @@ export declare class ApiClient {
      */
     private ensureTrackingSession;
     /**
-     * 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.
      */
-    private ensureGameplayAttempt;
+    private ensurePlaySession;
     /**
      * Call once when the game view opens, before any play/match tracking.
      * `gameKey` is the game's public `appId`.
      */
     trackView(gameKey: string): Promise<boolean>;
     /**
-     * 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(): string;
+    startPlaySession(): string;
     trackPlay(gameKey: string, playTimeSeconds?: number): Promise<boolean>;
     trackMatch(gameKey: string, body: {
         matchId: string;
@@ -83,7 +84,7 @@ export declare class ApiClient {
     listMyStorePurchases(gameKey: string): Promise<GameStoreOfferPurchaseResultDto[]>;
     /**
      * 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.
@@ -96,10 +97,4 @@ export declare class ApiClient {
     getMyBalance(): Promise<any>;
     getBalances(query?: Record<string, any>): Promise<any>;
     getBalanceHistory(query?: Record<string, any>): Promise<PagingResponse<any>>;
-    listReferrals(query?: Record<string, any>): Promise<PagingResponse<any>>;
-    setReferral(body: Record<string, any>): Promise<boolean>;
-    listTasks(query?: TaskListQuery): Promise<any[]>;
-    listFinishedTasks(query?: TaskListQuery): Promise<any[]>;
-    startTask(body: Record<string, any>): Promise<any>;
-    claimTask(body: Record<string, any>): Promise<any>;
 }

package/dist/types/apps/service-client.d.ts

@@ -1,9 +1,9 @@
 import { type HttpClientOptions } from './http';
-import type { AuthResultDto, CompleteGameplayAttemptRequest, CompleteGameplayMatchRequest, EmitGameEventResponse, GameAssetDto, GameOwnedAssetDto, GameplayAttemptSessionDto, GameStoreCheckoutIntentDto, GameStoreDto, GameStoreOfferPurchaseResultDto, GameTrackingSessionDto, PagingResponse, RecordGameplayActionRequest, SdkCreateGameStoreCheckoutIntentRequest, SdkPurchaseGameStoreOfferRuntimeRequest, StartGameplayAttemptRequest, TaskListQuery } from './LooplaySDK.types';
+import type { AuthResultDto, CompletePlaySessionRequest, CompleteGameplayMatchRequest, EmitGameEventResponse, GameAssetDto, GameOwnedAssetDto, PlaySessionDto, GameStoreCheckoutIntentDto, GameStoreDto, GameStoreOfferPurchaseResultDto, GameTrackingSessionDto, PagingResponse, RecordGameplayActionRequest, SdkCreateGameStoreCheckoutIntentRequest, SdkPurchaseGameStoreOfferRuntimeRequest, StartPlaySessionRequest } from './LooplaySDK.types';
 export interface ServiceClientOptions extends HttpClientOptions {
 }
 /**
- * Auth for the tracking endpoints (view/attempt/match/action), which accept
+ * Auth for the tracking endpoints (view/play-session/match/action), which accept
  * either a real user's `bearerToken` (full tracking, eligible for
  * quest/reward) or an `anonId` for an unauthenticated device
  * (analytics-only — the backend never awards quest/reward progress to an
@@ -41,9 +41,9 @@ export declare class ServiceClient {
     refresh(refreshToken: string): Promise<AuthResultDto>;
     logout(refreshToken: string): Promise<boolean>;
     recordGameView(gameKey: string, auth?: TrackingAuth): Promise<boolean>;
-    /** Signs a fresh `attemptToken` — required by `completeGameplayAttempt`/`completeGameplayMatch`/`recordGameplayAction`. */
-    startGameplayAttempt(gameKey: string, auth?: TrackingAuth, body?: StartGameplayAttemptRequest): Promise<GameplayAttemptSessionDto>;
-    completeGameplayAttempt(gameKey: string, auth: TrackingAuth, body: CompleteGameplayAttemptRequest): Promise<boolean>;
+    /** Signs a fresh `playSessionToken` — required by `completePlaySession`/`completeGameplayMatch`/`recordGameplayAction`. */
+    startPlaySession(gameKey: string, auth?: TrackingAuth, body?: StartPlaySessionRequest): Promise<PlaySessionDto>;
+    completePlaySession(gameKey: string, auth: TrackingAuth, body: CompletePlaySessionRequest): Promise<boolean>;
     completeGameplayMatch(gameKey: string, auth: TrackingAuth, body: CompleteGameplayMatchRequest): Promise<boolean>;
     recordGameplayAction(gameKey: string, auth: TrackingAuth, body: RecordGameplayActionRequest): Promise<EmitGameEventResponse>;
     /**
@@ -52,6 +52,11 @@ export declare class ServiceClient {
      * tracing — see `GameTrackingSessionDto`.
      */
     bootstrapTrackingSession(anonId?: string): Promise<GameTrackingSessionDto>;
+    /**
+     * Lightweight integration heartbeat for review/liveops. This intentionally
+     * does not record a view/play metric.
+     */
+    detectGameIntegration(gameKey: string): Promise<boolean>;
     private trackingHeaders;
     /** Public storefront (sections + offers) for the integration's game. Read-only. */
     getStore(gameKey: string): Promise<GameStoreDto>;
@@ -71,10 +76,4 @@ export declare class ServiceClient {
     getBalanceHistory(bearerToken: string, query?: Record<string, any>): Promise<PagingResponse<any>>;
     getMyProfile(bearerToken: string): Promise<any>;
     getMyBalance(bearerToken: string): Promise<any>;
-    listReferrals(bearerToken: string, query?: Record<string, any>): Promise<PagingResponse<any>>;
-    setReferral(bearerToken: string, body: Record<string, any>): Promise<boolean>;
-    listTasks(bearerToken: string, query?: TaskListQuery): Promise<any[]>;
-    listFinishedTasks(bearerToken: string, query?: TaskListQuery): Promise<any[]>;
-    startTask(bearerToken: string, body: Record<string, any>): Promise<any>;
-    claimTask(bearerToken: string, body: Record<string, any>): Promise<any>;
 }

package/dist/types/iframe/iframe-auth.d.ts

@@ -59,8 +59,8 @@ export declare class LooplayIframeAuth {
     getClient(): ApiClient;
     /** Call once when the game view opens, before any play/match tracking. */
     trackView(): Promise<boolean>;
-    /** Starts a new play attempt; call when the user presses Play. Returns the attempt id. */
-    startAttempt(): string;
+    /** Starts a new play session; call when the user presses Play. Returns the play session id. */
+    startPlaySession(): string;
     trackPlay(playTimeSeconds?: number): Promise<boolean>;
     trackMatch(matchId: string, opts: TrackMatchOptions): Promise<boolean>;
     emitGameEvent(actionCode: GameEventKey | string, opts?: EmitGameEventOptions): Promise<EmitGameEventResponse | null>;

package/dist/types/looplay-sdk.d.ts

@@ -14,8 +14,8 @@ export declare class LooplaySDK {
     getMyProfile(): Promise<any>;
     /** Call once when the game view opens, before any play/match tracking. */
     trackView(): Promise<boolean>;
-    /** Starts a new play attempt; call when the user presses Play. Returns the attempt id. */
-    startAttempt(): string;
+    /** Starts a new play session; call when the user presses Play. Returns the play session id. */
+    startPlaySession(): string;
     trackPlay(playTimeSeconds?: number): Promise<boolean>;
     /**
      * Report that a match/round ended.
@@ -39,4 +39,5 @@ export declare class LooplaySDK {
     }): Promise<EmitGameEventResponse>;
     private assertInitialized;
     private verifyGameId;
+    private detectIntegration;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@looplay/sdk",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "LooplaySDK (auth + points) for game integrations",
   "license": "UNLICENSED",
   "type": "module",