@looplay/sdk 0.2.1 → 0.5.0

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

@@ -1,6 +1,6 @@
-import { ApiClient } from '../apps/api-client';
-import type { EmitGameEventResponse, GameEventKey } from '../apps/LooplaySDK.types';
-import type { EmitGameEventOptions, LooplayIframeAuthListener, LooplayIframeAuthOptions, LooplayIframeAuthState, TrackMatchOptions } from './types';
+import { ApiClient } from "../apps/api-client";
+import type { EmitGameEventResponse, GameEventKey } from "../apps/LooplaySDK.types";
+import type { EmitGameEventOptions, LooplayIframeAuthListener, LooplayIframeAuthOptions, LooplayIframeAuthState, RequestAdsOptions, TrackMatchOptions } from "./types";
 /**
  * Handles auth for games that may run in two contexts:
  *
@@ -27,6 +27,12 @@ export declare class LooplayIframeAuth {
     private readonly options;
     private messageListener;
     private anonymousFallbackTimer;
+    private pendingAdsRequests;
+    private requestAdsSequence;
+    private adsRequestInFlight;
+    private adsRequestsSent;
+    private lastAdsRequestAt;
+    private autoAdsActionCount;
     constructor(options?: LooplayIframeAuthOptions);
     getState(): LooplayIframeAuthState;
     getJwt(): string | null;
@@ -38,12 +44,23 @@ export declare class LooplayIframeAuth {
     canTrack(): boolean;
     subscribe(listener: LooplayIframeAuthListener): () => void;
     requestAuth(): void;
+    /**
+     * Requests the parent host to show a rewarded ad.
+     * In a Telegram Mini App setup, the game sends this request from the iframe
+     * and the parent page (the Mini App shell) bridges it to Adsgram, then
+     * responds with `LOOPLAY_ADS_WATCHED` after the ad finishes.
+     */
+    requestAds(options?: RequestAdsOptions): Promise<boolean>;
     /** Idempotent; attaches the postMessage listener (if embedded) and arms the anonymous fallback. */
     init(): void;
     /** Removes the postMessage listener, cancels timers, and clears subscribers; safe to call multiple times. */
     dispose(): void;
     /** Lazily builds (and rebuilds on auth change) the `ApiClient` bound to the current auth mode. */
     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;
     trackPlay(playTimeSeconds?: number): Promise<boolean>;
     trackMatch(matchId: string, opts: TrackMatchOptions): Promise<boolean>;
     emitGameEvent(actionCode: GameEventKey | string, opts?: EmitGameEventOptions): Promise<EmitGameEventResponse | null>;
@@ -53,7 +70,11 @@ export declare class LooplayIframeAuth {
     /** Generates (or restores) a persisted anonymous device id and activates anonymous tracking. */
     private activateAnonymousMode;
     private handleAuthMessage;
+    private handleRequestAdsResult;
+    private handleRequestAdsUnavailable;
+    private handleIncomingMessage;
     private setState;
     private resolveParentOrigin;
     private debug;
+    private recordAutoRequestAdsActivity;
 }

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

@@ -35,6 +35,18 @@ export interface LooplayIframeAuthOptions {
     anonymousFallbackTimeoutMs?: number;
     /** localStorage key for the persisted anonymous device id. Default `'looplay:anon-id'`. */
     anonymousIdStorageKey?: string;
+    /**
+     * Optional auto-trigger for rewarded ads after play/match activity.
+     * When enabled, the SDK may call `requestAds()` after the configured
+     * total play/match threshold is reached and the random chance passes.
+     */
+    autoRequestAds?: {
+        enabled?: boolean;
+        afterActionCount?: number;
+        chance?: number;
+        cooldownMs?: number;
+        maxRequestsPerSession?: number;
+    };
 }
 export interface TrackMatchOptions {
     durationSeconds: number;
@@ -46,3 +58,11 @@ export interface EmitGameEventOptions {
     refId?: string;
     payload?: Record<string, unknown>;
 }
+export interface RequestAdsOptions {
+    /** How long to wait for the parent to answer before resolving `false`. Default 5s. */
+    timeoutMs?: number;
+}
+export interface RequestAdsResult {
+    /** `true` when the parent handled the request and the ad flow completed successfully. */
+    success: boolean;
+}

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

@@ -12,6 +12,10 @@ export declare class LooplaySDK {
     getAccessToken(): Promise<string | undefined>;
     getGameId(): string | undefined;
     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;
     trackPlay(playTimeSeconds?: number): Promise<boolean>;
     /**
      * Report that a match/round ended.

package/package.json

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