@looplay/sdk 0.7.0 → 0.8.2

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

@@ -1,5 +1,5 @@
 import { type HttpClientOptions } from './http';
-import type { AuthResultDto, CompleteGameplayAttemptRequest, CompleteGameplayMatchRequest, EmitGameEventResponse, GameAssetDto, GameOwnedAssetDto, GameplayAttemptSessionDto, GameStoreDto, GameStoreOfferPurchaseResultDto, GameTrackingSessionDto, PagingResponse, RecordGameplayActionRequest, StartGameplayAttemptRequest, TaskListQuery } from './LooplaySDK.types';
+import type { AuthResultDto, CompleteGameplayAttemptRequest, CompleteGameplayMatchRequest, EmitGameEventResponse, GameAssetDto, GameOwnedAssetDto, GameplayAttemptSessionDto, GameStoreCheckoutIntentDto, GameStoreDto, GameStoreOfferPurchaseResultDto, GameTrackingSessionDto, PagingResponse, RecordGameplayActionRequest, SdkCreateGameStoreCheckoutIntentRequest, SdkPurchaseGameStoreOfferRuntimeRequest, StartGameplayAttemptRequest, TaskListQuery } from './LooplaySDK.types';
 export interface ServiceClientOptions extends HttpClientOptions {
 }
 /**
@@ -17,6 +17,19 @@ export interface TrackingAuth {
     trackingSessionId?: string;
     anonTrackingToken?: string;
 }
+/**
+ * Auth for the creator-secret tier (`createGameStoreCheckoutIntent`/
+ * `purchaseGameStoreOffer`) — moves real coin balance. `creatorKey`/
+ * `gameSecret` identify your integration (never embed these in
+ * client/browser code); `bearerToken` identifies the player you're
+ * purchasing on behalf of, same as any other authenticated call.
+ */
+export interface SdkKeyPairAuth {
+    creatorKey: string;
+    gameSecret: string;
+    bearerToken: string;
+    trackingSessionId?: string;
+}
 /**
  * Low-level HTTP client that maps 1:1 to backend routes.
  * Methods requiring user auth accept `bearerToken` explicitly.
@@ -48,6 +61,12 @@ export declare class ServiceClient {
     listMyGameAssets(bearerToken: string, gameKey: string): Promise<GameOwnedAssetDto[]>;
     /** The authenticated player's past store purchases for this game. */
     listMyStorePurchases(bearerToken: string, gameKey: string): Promise<GameStoreOfferPurchaseResultDto[]>;
+    /** Signs a `checkoutToken` for one purchase — required by `purchaseMyStoreOffer`. */
+    createMyStoreCheckoutIntent(gameKey: string, bearerToken: string, body: SdkCreateGameStoreCheckoutIntentRequest, trackingSessionId?: string): Promise<GameStoreCheckoutIntentDto>;
+    purchaseMyStoreOffer(gameKey: string, bearerToken: string, body: SdkPurchaseGameStoreOfferRuntimeRequest, trackingSessionId?: string): Promise<GameStoreOfferPurchaseResultDto>;
+    /** Signs a `checkoutToken` for one purchase — required by `purchaseGameStoreOffer`. */
+    createGameStoreCheckoutIntent(auth: SdkKeyPairAuth, body: SdkCreateGameStoreCheckoutIntentRequest): Promise<GameStoreCheckoutIntentDto>;
+    purchaseGameStoreOffer(auth: SdkKeyPairAuth, body: SdkPurchaseGameStoreOfferRuntimeRequest): 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/apps/ws-client.d.ts

@@ -0,0 +1,35 @@
+import type { BalanceChangeEvent, StorePurchaseCompletedEvent } from './LooplaySDK.types';
+export interface WsClientOptions {
+    baseUrl: string;
+    /** Resolves the current player's access token — re-checked on every (re)connect. */
+    getAccessToken: () => Promise<string | undefined>;
+}
+type Listener<T> = (payload: T) => void;
+/**
+ * Lazy-connecting Socket.IO client mirroring gbs-service's AppGateway.
+ * Both events it exposes (`balance_change`, `store_purchase_completed`) are
+ * pushed only to the authenticated player's own room — there is nothing to
+ * receive without an access token, so `subscribe*` is a no-op until one is
+ * available.
+ *
+ * The connection is opened on the first subscription and closed once the
+ * last listener unsubscribes — a game that never calls `onBalanceChange`/
+ * `onStorePurchase` never opens a socket at all.
+ */
+export declare class WsClient {
+    private readonly options;
+    private socket?;
+    private connectPromise?;
+    private readonly balanceListeners;
+    private readonly purchaseListeners;
+    constructor(options: WsClientOptions);
+    /** Fires on every balance change — purchases, quest rewards, referral payouts, etc. */
+    onBalanceChange(listener: Listener<BalanceChangeEvent>): () => void;
+    /** Fires once a store purchase finishes — see `StorePurchaseCompletedEvent`. */
+    onStorePurchase(listener: Listener<StorePurchaseCompletedEvent>): () => void;
+    /** Closes the socket immediately, regardless of active listeners. */
+    disconnect(): void;
+    private ensureConnected;
+    private disconnectIfIdle;
+}
+export {};

package/dist/types/realtime.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Optional real-time subpath — `import { WsClient } from '@looplay/sdk/realtime'`.
+ * Kept out of the main `@looplay/sdk` entry point (and its browser IIFE
+ * bundle) because it pulls in `socket.io-client`, which most integrations
+ * — tracking-only or store-browsing-only — don't need.
+ */
+export { WsClient } from './apps/ws-client';
+export type { WsClientOptions } from './apps/ws-client';
+export type { BalanceChangeEvent, StorePurchaseCompletedEvent } from './apps/LooplaySDK.types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@looplay/sdk",
-  "version": "0.7.0",
+  "version": "0.8.2",
   "description": "LooplaySDK (auth + points) for game integrations",
   "license": "UNLICENSED",
   "type": "module",
@@ -17,6 +17,14 @@
     },
     "./browser": {
       "default": "./dist/looplay-sdk.min.js"
+    },
+    "./realtime": {
+      "types": "./dist/types/realtime.d.ts",
+      "import": "./dist/looplay-sdk-realtime.esm.js",
+      "require": "./dist/looplay-sdk-realtime.cjs.js"
+    },
+    "./realtime/browser": {
+      "default": "./dist/looplay-sdk-realtime.min.js"
     }
   },
   "files": [
@@ -30,6 +38,14 @@
   "dependencies": {
     "@looplay/types": "^0.1.0"
   },
+  "peerDependencies": {
+    "socket.io-client": "^4.8.3"
+  },
+  "peerDependenciesMeta": {
+    "socket.io-client": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "npm run build:js && npm run build:types",
     "build:js": "tsup",