@looplay/sdk 0.8.2 → 0.8.3

package/README.md

@@ -63,24 +63,49 @@ backward compatibility, but you should set one regardless).
 ```ts
 import { LooplayIframeAuth } from '@looplay/sdk';
 
+// 1. Initialize the SDK
 export const looplayAuth = new LooplayIframeAuth({
   appId: 'YOUR_APP_ID', // from your creator dashboard
   apiUrl: 'https://api.looplay.gg', // required for standalone builds; optional inside the iframe
   parentOrigin: import.meta.env.VITE_PARENT_ORIGIN, // restrict the accepted postMessage origin
+  
+  // Optional: Auto-request rewarded ads after match activity
+  autoRequestAds: {
+    enabled: true,
+    afterActionCount: 3, // show ad every 3 actions/matches
+    chance: 0.5, // 50% chance to show ad
+    cooldownMs: 60000, // min 1 minute between requests
+    maxRequestsPerSession: 5,
+  }
 });
 
+// 2. Start listening for auth and lifecycle events
 looplayAuth.init();
 looplayAuth.initLifecycleTracking(); // auto-emits GAME_STARTED once per session
 
-// Anywhere in the game — identical code whether hosted on Looplay or not:
+// 3. Anywhere in the game — identical code whether hosted on Looplay or not:
 looplayAuth.canTrack();
 looplayAuth.subscribe((state) => { /* re-render when auth arrives/clears */ });
+
 await looplayAuth.trackView();
-looplayAuth.startAttempt(); // call once when the user presses Play
+
+// Call once when the user presses Play
+looplayAuth.startAttempt(); 
+
+// Periodically track play time
 await looplayAuth.trackPlay(playTimeSeconds);
+
+// Track when a match/level ends
 await looplayAuth.trackMatch(matchId, { durationSeconds, isWin: true });
+
+// Emit custom actions for quests/analytics
 await looplayAuth.emitGameEvent('CUSTOM_ACTION', { value: 1 });
-await looplayAuth.requestAds();
+
+// Manually request rewarded ads (returns true if watched)
+const adWatched = await looplayAuth.requestAds();
+if (adWatched) {
+  // Give reward to the player
+}
 ```
 
 Every play attempt is backed by a short-lived, server-signed token — the SDK
@@ -238,6 +263,13 @@ request as `false` and continue normally.
 If the parent never answers, `requestAds()` times out after 5 seconds by
 default and resolves `false`.
 
+```ts
+const isWatched = await looplayAuth.requestAds();
+if (isWatched) {
+  // Grant reward to player
+}
+```
+
 ```ts
 window.addEventListener('message', async (event) => {
   const data = event.data;

package/package.json

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