@smartico/public-api 0.0.412 → 0.0.413

package/docs/api/interfaces/SAWTemplate.md

@@ -210,6 +210,14 @@ Prize Drop only: when true, the pushed prize requires an explicit claim by the u
 
 ***
 
+### requires\_manual\_claim?
+
+> `optional` **requires\_manual\_claim?**: `boolean`
+
+Prize Drop only: when true, the pushed prize requires a manual claim by the user before it is credited. The difference between this and `requires_prize_claim` is that requires_manual_claim gives the user the ability to cancel the claim.
+
+***
+
 ### relative\_period\_timezone?
 
 > `optional` **relative\_period\_timezone?**: `number`

package/docs/ui/jackpots/UIGuide_getJackpotWinners.md

@@ -4,7 +4,7 @@
 - Paginated list of past winners of a specific jackpot template.
 - Powers the "Recent Winners" / "Win History" tab inside the jackpot
   detail modal.
-- 30 s cache per template.
+- 30 s cache per page (template + `limit`/`offset`).
 - Gated by the operator's `expose_winners_over_api` flag — but only on
   the client side. Custom UIs must check this flag before calling.
 
@@ -59,7 +59,8 @@ client-side using the exchange rate available on the platform.
 
 ## Refresh
 
-- 30 s SDK cache per `jp_template_id`.
+- 30 s SDK cache per page — keyed by `jp_template_id` + `limit` +
+  `offset`, so each page is cached independently.
 - Cache clears on jackpot-win push events — when the pot explodes, the
   new winner row appears on the next call.
 - Cache also clears on opt-in / opt-out.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smartico/public-api",
-	"version": "0.0.412",
+	"version": "0.0.413",
 	"description": "Smartico public API",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/src/WSAPI/WSAPIJackpots.ts

@@ -332,7 +332,9 @@ export class WSAPIJackpots extends WSAPIClans {
 	 * user-currency display is needed, the consumer must convert client-side.
 	 *
 	 * **Refresh**
-	 * - The SDK caches per `jp_template_id` for 30 seconds.
+	 * - The SDK caches each page separately (per `jp_template_id` +
+	 *   `limit` + `offset`) for 30 seconds, so paging back and forth is
+	 *   served from cache and each page keeps its own fresh copy.
 	 * - Caches clear on jackpot-win push events and on opt-in / opt-out.
 	 *
 	 * **Error handling**
@@ -375,8 +377,11 @@ export class WSAPIJackpots extends WSAPIClans {
 		/** Jackpot template ID (required). */
 		jp_template_id?: number;
 	}): Promise<JackpotWinnerHistory[]> {
+		// Cache per (jp_template_id, limit, offset) so paging or switching
+		// jackpot within the TTL doesn't return a colliding winners list.
+		const cacheKey = `${onUpdateContextKey.JackpotWinners}${jp_template_id}:${limit}:${offset}`;
 		return OCache.use(
-			onUpdateContextKey.JackpotWinners + jp_template_id,
+			cacheKey,
 			ECacheContext.WSAPI,
 			() => this.api.getJackpotWinnersT(this.userExtId, limit, offset, jp_template_id),
 			JACKPOT_WINNERS_CACHE_SEC,