@looplay/sdk 0.8.9 → 0.8.11

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

@@ -1,6 +1,14 @@
-import type { EmitGameEventResponse, GameAssetDto, GameEventKey, GameOwnedAssetDto, GameStoreDto, GameStoreOfferPurchaseResultDto, PagingResponse } from './LooplaySDK.types';
+import type { EmitGameEventResponse, GameAssetDto, GameEventKey, GameOwnedAssetDto, GameStoreDto, GameStoreOfferPurchaseResultDto, PagingResponse, PlaySessionDto, StartPlaySessionRequest } from './LooplaySDK.types';
 import { ServiceClient } from './service-client';
 import type { ServiceClientOptions } from './service-client';
+/** Signed `playSessionToken` for the current play session — required on every play/match/action call. */
+export interface CachedPlaySession {
+    cacheKey: string;
+    gameKey: string;
+    playSessionId: string;
+    playSessionToken: string;
+    expiresAtMs: number;
+}
 export interface ApiClientOptions extends Omit<ServiceClientOptions, 'baseUrl'> {
     baseUrl?: string;
     getAccessToken?: () => Promise<string | undefined>;
@@ -21,11 +29,11 @@ export declare class ApiClient {
     private trackingSession?;
     private trackingSessionPromiseKey?;
     private trackingSessionPromise?;
-    private currentPlaySessionId?;
-    private playSession?;
+    currentPlaySessionId?: string;
+    playSession?: CachedPlaySession;
     private playSessionPromiseKey?;
     private playSessionPromise?;
-    constructor(options: ApiClientOptions);
+    constructor(options?: ApiClientOptions);
     /** Expose the underlying route-level client (requires manual bearerToken/gameKey passing). */
     unsafeRaw(): ServiceClient;
     detectIntegration(gameKey: string): Promise<boolean>;
@@ -65,6 +73,21 @@ export declare class ApiClient {
      * `startPlaySession()`, auto-starting one on first use if none was started.
      */
     startPlaySession(): string;
+    /**
+     * Starts a new play session on the server and caches the signed  immediately.
+     */
+    startPlaySessionAsync(gameKey: string, body?: StartPlaySessionRequest): Promise<PlaySessionDto>;
+    /**
+     * Explicitly sets or updates the active play session token cache.
+     */
+    setPlaySession(playSession: {
+        gameKey: string;
+        playSessionId: string;
+        playSessionToken: string;
+        expiresAtMs?: number;
+    }): void;
+    /** Returns the active cached play session, or undefined if none has been issued yet. */
+    getCurrentPlaySession(): CachedPlaySession | undefined;
     trackPlay(gameKey: string, playTimeSeconds?: number): Promise<boolean>;
     trackMatch(gameKey: string, body: {
         matchId: string;

package/dist/types/apps/http.d.ts

@@ -1,6 +1,6 @@
 export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 export interface HttpClientOptions {
-    baseUrl: string;
+    baseUrl?: string;
     fetch?: FetchLike;
     defaultHeaders?: Record<string, string>;
 }
@@ -13,7 +13,7 @@ export declare class HttpClient {
     private readonly baseUrl;
     private readonly fetchFn;
     private readonly defaultHeaders;
-    constructor(options: HttpClientOptions);
+    constructor(options?: HttpClientOptions);
     request<T>(method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE', path: string, options?: {
         query?: Record<string, string | number | boolean | undefined>;
         headers?: Record<string, string | undefined>;

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

@@ -34,9 +34,17 @@ export interface SdkKeyPairAuth {
  * Low-level HTTP client that maps 1:1 to backend routes.
  * Methods requiring user auth accept `bearerToken` explicitly.
  */
+export type PlaySessionIssuedListener = (dto: PlaySessionDto, gameKey: string, auth: TrackingAuth) => void;
 export declare class ServiceClient {
     private readonly http;
+    private readonly playSessionTokens;
+    private onPlaySessionIssuedListener?;
     constructor(options: ServiceClientOptions);
+    /**
+     * Internal hook for ApiClient to subscribe to issued/renewed play sessions.
+     * @internal
+     */
+    _setOnPlaySessionIssued(listener?: PlaySessionIssuedListener): void;
     telegramLogin(telegramInitData: string): Promise<AuthResultDto>;
     refresh(refreshToken: string): Promise<AuthResultDto>;
     logout(refreshToken: string): Promise<boolean>;

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

@@ -1,5 +1,6 @@
-import { ApiClient } from "../apps/api-client";
-import type { EmitGameEventResponse, GameEventKey } from "../apps/LooplaySDK.types";
+import { ApiClient, type CachedPlaySession } from "../apps/api-client";
+import type { EmitGameEventResponse, GameEventKey, PlaySessionDto, StartPlaySessionRequest } from "../apps/LooplaySDK.types";
+import type { ServiceClient } from "../apps/service-client";
 import type { EmitGameEventOptions, LooplayIframeAuthListener, LooplayIframeAuthOptions, LooplayIframeAuthState, RequestAdsOptions, TrackMatchOptions } from "./types";
 /**
  * Handles auth for games that may run in two contexts:
@@ -37,7 +38,7 @@ export declare class LooplayIframeAuth {
     constructor(options?: LooplayIframeAuthOptions);
     getState(): LooplayIframeAuthState;
     getJwt(): string | null;
-    getApiUrl(): string | null;
+    getApiUrl(): string;
     /** Resolves to the configured `appId`, falling back to whatever the parent pushed as `gameId`. */
     getGameId(): string | null;
     getAnonymousId(): string | null;
@@ -58,10 +59,18 @@ export declare class LooplayIframeAuth {
     dispose(): void;
     /** Lazily builds (and rebuilds on auth change) the `ApiClient` bound to the current auth mode. */
     getClient(): ApiClient;
+    get currentPlaySessionId(): string | undefined;
+    get playSession(): CachedPlaySession | undefined;
+    unsafeRaw(): ServiceClient;
     /** Call once when the game view opens, before any play/match tracking. */
     trackView(): Promise<boolean>;
     /** Starts a new play session; call when the user presses Play. Returns the play session id. */
     startPlaySession(): string;
+    /**
+     * 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.
+     */
+    startPlaySessionAsync(body?: StartPlaySessionRequest): Promise<PlaySessionDto | null>;
     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

@@ -1,7 +1,8 @@
 import type { LooplayInitParams, LooplaySDKCreateOptions } from './types';
 import { LooplayAuth } from './auth/looplay-auth';
-import { ApiClient } from './apps/api-client';
-import type { EmitGameEventResponse, GameEventKey } from './apps/LooplaySDK.types';
+import { ApiClient, type CachedPlaySession } from './apps/api-client';
+import type { EmitGameEventResponse, GameEventKey, PlaySessionDto, StartPlaySessionRequest } from './apps/LooplaySDK.types';
+import type { ServiceClient } from './apps/service-client';
 export declare class LooplaySDK {
     readonly auth?: LooplayAuth;
     readonly api?: ApiClient;
@@ -11,11 +12,19 @@ export declare class LooplaySDK {
     init(params: LooplayInitParams): Promise<void>;
     getAccessToken(): Promise<string | undefined>;
     getGameId(): string | undefined;
+    get currentPlaySessionId(): string | undefined;
+    get playSession(): CachedPlaySession | undefined;
+    unsafeRaw(): ServiceClient | undefined;
     getMyProfile(): Promise<any>;
     /** Call once when the game view opens, before any play/match tracking. */
     trackView(): Promise<boolean>;
     /** Starts a new play session; call when the user presses Play. Returns the play session id. */
     startPlaySession(): string;
+    /**
+     * Starts a new play session asynchronously on the backend; returns the issued PlaySessionDto
+     * (containing playSessionId and playSessionToken).
+     */
+    startPlaySessionAsync(body?: StartPlaySessionRequest): Promise<PlaySessionDto>;
     trackPlay(playTimeSeconds?: number): Promise<boolean>;
     /**
      * Report that a match/round ended.

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const LOOPLAY_SDK_VERSION = "0.8.5";
+export declare const LOOPLAY_SDK_VERSION = "0.8.11";

package/package.json

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