@looplay/sdk 0.6.0 → 0.7.0

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

@@ -1,4 +1,4 @@
-import type { EmitGameEventResponse, GameEventKey, GameStoreDto, GameStoreOfferPurchaseResultDto, PagingResponse, TaskListQuery } from './LooplaySDK.types';
+import type { EmitGameEventResponse, GameAssetDto, GameEventKey, GameOwnedAssetDto, GameStoreDto, GameStoreOfferPurchaseResultDto, PagingResponse, TaskListQuery } from './LooplaySDK.types';
 import { ServiceClient } from './service-client';
 import type { ServiceClientOptions } from './service-client';
 export interface ApiClientOptions extends Omit<ServiceClientOptions, 'baseUrl'> {
@@ -24,9 +24,8 @@ export declare class ApiClient {
     private gameplayAttempt?;
     private gameplayAttemptPromise?;
     constructor(options: ApiClientOptions);
-    /** Expose the underlying route-level client (requires manual bearerToken passing). */
+    /** Expose the underlying route-level client (requires manual bearerToken/gameKey passing). */
     unsafeRaw(): ServiceClient;
-    listGames(query?: Record<string, any>): Promise<PagingResponse<any>>;
     private requireToken;
     /**
      * Resolves auth for the tracking endpoints: a real bearer token if logged
@@ -50,11 +49,11 @@ export declare class ApiClient {
      * are rejected outright without a valid token.
      */
     private ensureGameplayAttempt;
-    getGameDetail(gameId: string): Promise<any>;
-    private resolveStoreId;
-    listRecentPlayed(query?: Record<string, any>): Promise<PagingResponse<any>>;
-    /** Call once when the game view opens, before any play/match tracking. */
-    trackView(gameId: string): Promise<boolean>;
+    /**
+     * 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
      * presses Play; `trackPlay`/`trackMatch`/`emit` reuse this id (and the
@@ -62,30 +61,26 @@ export declare class ApiClient {
      * `startAttempt()`, auto-starting one on first use if none was started.
      */
     startAttempt(): string;
-    trackPlay(gameId: string, playTimeSeconds?: number): Promise<boolean>;
-    trackMatch(gameId: string, body: {
+    trackPlay(gameKey: string, playTimeSeconds?: number): Promise<boolean>;
+    trackMatch(gameKey: string, body: {
         matchId: string;
         matchDurationSeconds: number;
         isCompleted?: boolean;
         isWin?: boolean;
     }): Promise<boolean>;
-    emit(gameId: string, actionCode: GameEventKey | string, opts?: {
+    emit(gameKey: string, actionCode: GameEventKey | string, opts?: {
         value?: number;
         refId?: string;
         payload?: Record<string, unknown>;
     }): Promise<EmitGameEventResponse>;
-    /** Fetches the storefront (sections + offers) for `gameId`, defined by that game's creator. */
-    getStore(gameId: string): Promise<GameStoreDto>;
-    /** Purchase history for the authenticated player in `gameId`'s store. */
-    listMyStorePurchases(gameId: 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.
-     */
-    purchaseStoreOffer(gameId: string, offerCode: string, opts?: {
-        requestId?: string;
-        quantity?: number;
-    }): Promise<GameStoreOfferPurchaseResultDto>;
+    /** Fetches the storefront (sections + offers) for the integration's game. Read-only, no auth required. */
+    getStore(gameKey: string): Promise<GameStoreDto>;
+    /** Public catalog of purchasable/ownable assets for the game. Read-only, no auth required. */
+    listGameAssets(gameKey: string): Promise<GameAssetDto[]>;
+    /** Assets the authenticated player already owns for this game. */
+    listMyGameAssets(gameKey: string): Promise<GameOwnedAssetDto[]>;
+    /** Purchase history for the authenticated player in the game's store. */
+    listMyStorePurchases(gameKey: string): Promise<GameStoreOfferPurchaseResultDto[]>;
     getMyProfile(): Promise<any>;
     getMyBalance(): Promise<any>;
     getBalances(query?: Record<string, any>): Promise<any>;

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

@@ -1,5 +1,5 @@
 import { type HttpClientOptions } from './http';
-import type { AuthResultDto, CompleteGameplayAttemptRequest, CompleteGameplayMatchRequest, CreateGameStoreCheckoutIntentRequest, EmitGameEventResponse, GameAssetDto, GameOwnedAssetDto, GameplayAttemptSessionDto, GameStoreCheckoutIntentDto, GameStoreDto, GameStoreOfferPurchaseResultDto, GameTrackingSessionDto, PagingResponse, PurchaseGameStoreOfferRuntimeRequest, RecordGameplayActionRequest, StartGameplayAttemptRequest, TaskListQuery } from './LooplaySDK.types';
+import type { AuthResultDto, CompleteGameplayAttemptRequest, CompleteGameplayMatchRequest, EmitGameEventResponse, GameAssetDto, GameOwnedAssetDto, GameplayAttemptSessionDto, GameStoreDto, GameStoreOfferPurchaseResultDto, GameTrackingSessionDto, PagingResponse, RecordGameplayActionRequest, StartGameplayAttemptRequest, TaskListQuery } from './LooplaySDK.types';
 export interface ServiceClientOptions extends HttpClientOptions {
 }
 /**
@@ -27,15 +27,12 @@ export declare class ServiceClient {
     telegramLogin(telegramInitData: string): Promise<AuthResultDto>;
     refresh(refreshToken: string): Promise<AuthResultDto>;
     logout(refreshToken: string): Promise<boolean>;
-    listGames(query?: Record<string, any>): Promise<PagingResponse<any>>;
-    getGameDetail(gameId: string, bearerToken?: string): Promise<any>;
-    listRecentPlayed(bearerToken: string, query?: Record<string, any>): Promise<PagingResponse<any>>;
-    recordGameView(auth: TrackingAuth, gameId: string): Promise<boolean>;
+    recordGameView(gameKey: string, auth?: TrackingAuth): Promise<boolean>;
     /** Signs a fresh `attemptToken` — required by `completeGameplayAttempt`/`completeGameplayMatch`/`recordGameplayAction`. */
-    startGameplayAttempt(auth: TrackingAuth, gameId: string, body?: StartGameplayAttemptRequest): Promise<GameplayAttemptSessionDto>;
-    completeGameplayAttempt(auth: TrackingAuth, gameId: string, body: CompleteGameplayAttemptRequest): Promise<boolean>;
-    completeGameplayMatch(auth: TrackingAuth, gameId: string, body: CompleteGameplayMatchRequest): Promise<boolean>;
-    recordGameplayAction(auth: TrackingAuth, gameId: string, body: RecordGameplayActionRequest): Promise<EmitGameEventResponse>;
+    startGameplayAttempt(gameKey: string, auth?: TrackingAuth, body?: StartGameplayAttemptRequest): Promise<GameplayAttemptSessionDto>;
+    completeGameplayAttempt(gameKey: string, auth: TrackingAuth, body: CompleteGameplayAttemptRequest): Promise<boolean>;
+    completeGameplayMatch(gameKey: string, auth: TrackingAuth, body: CompleteGameplayMatchRequest): Promise<boolean>;
+    recordGameplayAction(gameKey: string, auth: TrackingAuth, body: RecordGameplayActionRequest): Promise<EmitGameEventResponse>;
     /**
      * Anonymous runtimes must call this before any tracking call; logged-in
      * runtimes should still call it to get a `trackingSessionId` for unified
@@ -43,19 +40,14 @@ export declare class ServiceClient {
      */
     bootstrapTrackingSession(anonId?: string): Promise<GameTrackingSessionDto>;
     private trackingHeaders;
-    getStoreByStoreId(storeId: string): Promise<GameStoreDto>;
-    listMyStorePurchasesByStoreId(bearerToken: string, storeId: string): Promise<GameStoreOfferPurchaseResultDto[]>;
-    createStoreCheckoutIntent(bearerToken: string, body: CreateGameStoreCheckoutIntentRequest, trackingSessionId?: string): Promise<GameStoreCheckoutIntentDto>;
-    purchaseStoreOffer(bearerToken: string, body: PurchaseGameStoreOfferRuntimeRequest, trackingSessionId?: string): Promise<GameStoreOfferPurchaseResultDto>;
-    recordGameViewForGameKey(gameKey: string, auth?: TrackingAuth): Promise<boolean>;
-    startGameplayAttemptForGameKey(gameKey: string, auth?: TrackingAuth, body?: StartGameplayAttemptRequest): Promise<GameplayAttemptSessionDto>;
-    completeGameplayAttemptForGameKey(gameKey: string, auth: TrackingAuth | undefined, body: CompleteGameplayAttemptRequest): Promise<boolean>;
-    completeGameplayMatchForGameKey(gameKey: string, auth: TrackingAuth | undefined, body: CompleteGameplayMatchRequest): Promise<boolean>;
-    recordGameplayActionForGameKey(gameKey: string, auth: TrackingAuth | undefined, body: RecordGameplayActionRequest): Promise<EmitGameEventResponse>;
-    getStoreForGameKey(gameKey: string): Promise<GameStoreDto>;
-    listGameAssetsForGameKey(gameKey: string): Promise<GameAssetDto[]>;
-    listMyOwnedAssetsForGameKey(bearerToken: string, gameKey: string): Promise<GameOwnedAssetDto[]>;
-    listMyStorePurchasesForGameKey(bearerToken: string, gameKey: string): Promise<GameStoreOfferPurchaseResultDto[]>;
+    /** Public storefront (sections + offers) for the integration's game. Read-only. */
+    getStore(gameKey: string): Promise<GameStoreDto>;
+    /** Public catalog of purchasable/ownable assets for the game. Read-only. */
+    listGameAssets(gameKey: string): Promise<GameAssetDto[]>;
+    /** Assets the authenticated player already owns for this game. */
+    listMyGameAssets(bearerToken: string, gameKey: string): Promise<GameOwnedAssetDto[]>;
+    /** The authenticated player's past store purchases for this game. */
+    listMyStorePurchases(bearerToken: string, gameKey: string): Promise<GameStoreOfferPurchaseResultDto[]>;
     getBalances(bearerToken: string, query?: Record<string, any>): Promise<any>;
     getBalanceHistory(bearerToken: string, query?: Record<string, any>): Promise<PagingResponse<any>>;
     getMyProfile(bearerToken: string): Promise<any>;

package/dist/types/errors.d.ts

@@ -13,6 +13,3 @@ export declare class MissingAuthError extends LooplaySDKError {
 export declare class NotAuthenticatedError extends LooplaySDKError {
     constructor();
 }
-export declare class MissingStoreError extends LooplaySDKError {
-    constructor(gameId: string);
-}

package/dist/types/types.d.ts

@@ -7,7 +7,8 @@ export interface LooplaySDKCreateOptions {
     defaultHeaders?: Record<string, string>;
 }
 export interface LooplayInitParams {
+    /** The game's public `appId` — same value as `x-game-key`, from your creator dashboard. */
     gameId: string;
-    /** 'none': skip verification | 'strict': verify via /games/:id (requires auth) */
+    /** 'none': skip verification | 'strict': resolve gameId via a read-only, unauthenticated call */
     verifyMode?: 'none' | 'strict';
 }

package/package.json

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