@smartico/public-api 0.0.401 → 0.0.403

package/dist/ActivityLog/ActivityLogEntry.d.ts

@@ -1,6 +1,7 @@
 import { PointChangeSourceType } from './PointChangeSourceType';
 import { UserBalanceType } from './UserBalanceType';
 export interface PointsLog {
+    /** Epoch timestamp in SECONDS (not ms — unlike most SDK timestamps). */
     create_date: number;
     user_ext_id: string;
     crm_brand_id: number;
@@ -10,6 +11,7 @@ export interface PointsLog {
     source_type_id: PointChangeSourceType;
 }
 export interface GemsDiamondsLog {
+    /** Epoch timestamp in SECONDS (not ms — unlike most SDK timestamps). */
     create_date: number;
     user_ext_id: string;
     crm_brand_id: number;

package/dist/Avatars/AvatarCustomized.d.ts

@@ -3,6 +3,6 @@ export interface AvatarCustomized {
     avatar_real_id: number;
     /** CDN URL of the AI-customized avatar image */
     url: string;
-    /** ISO date string when the customization was created */
-    dt_created: string;
+    /** Unix-ms timestamp when the customization was created. */
+    dt_created: number;
 }

package/dist/GamePick/GamePickTypes.d.ts

@@ -201,10 +201,10 @@ export interface GamePickEventMeta extends QuizEventMeta {
 export interface GamePickEvent {
     /** Unique identifier of the event */
     gp_event_id: number;
-    /** Timestamp (ms) when the event was resolved, null if not yet resolved */
-    event_resolution_date: number;
-    /** Timestamp (ms) of the match/event start time */
-    match_date: number;
+    /** ISO 8601 date-time string when the event was resolved; null until resolved. */
+    event_resolution_date: string;
+    /** ISO 8601 date-time string of the match/event start time. */
+    match_date: string;
     /** Market type defining the prediction format (e.g. two-team score, quiz question, custom) */
     market_type_id: SAWGPMarketType;
     /** Event metadata containing team names, images, sport type, and question details */
@@ -406,8 +406,8 @@ export interface GamePickUserInfo {
     part_wins_count?: number;
     /** User's total score */
     resolution_score?: number;
-    /** Last time the user's balance was synced from the Smartico platform */
-    last_wallet_sync_time?: Date;
+    /** ISO 8601 date-time string of the last time the user's balance was synced from the Smartico platform. */
+    last_wallet_sync_time?: string;
     /** User's current points balance */
     ach_points_balance?: number;
     /** User's current gems balance */

package/dist/NodeCache.d.ts

@@ -5,6 +5,7 @@ declare class NodeCache {
     get(key: string): any;
     set(key: string, value: any, ttlSeconds?: number): void;
     remove(key: string): void;
+    removeByPrefix(prefix: string): void;
     flushAll(): void;
 }
 export { NodeCache };

package/dist/OCache.d.ts

@@ -10,6 +10,13 @@ export declare class OCache {
     static set(oKey: any, o: any, cacheContext: ECacheContext, ttlSeconds?: number): void;
     static use<T>(oKey: any, cacheContext: ECacheContext, f: () => Promise<T>, ttlSeconds?: number): Promise<T>;
     static clear(cacheContext: ECacheContext, oKey: any): Promise<void>;
+    /**
+     * Remove every entry whose string key starts with `oKeyBase` — the bare key
+     * AND all per-parameter composite variants (`${oKeyBase}:…` / `${oKeyBase}<id>`).
+     * Use when a cache is keyed per parameter (paginated, per-template, per-window):
+     * an exact-key `clear(oKeyBase)` would miss every variant. `oKeyBase` must be a string.
+     */
+    static clearByPrefix(cacheContext: ECacheContext, oKeyBase: string): Promise<void>;
     static clearContext(cacheContext: ECacheContext): Promise<void>;
     static clearAll(): Promise<void>;
 }

package/dist/WSAPI/WSAPIAvatars.d.ts

@@ -123,7 +123,7 @@ export declare class WSAPIAvatars extends WSAPIMiniGames {
      *
      * // Newest-first within each base.
      * for (const list of byBase.values()) {
-     *     list.sort((a, b) => b.dt_created.localeCompare(a.dt_created));
+     *     list.sort((a, b) => b.dt_created - a.dt_created);
      * }
      *
      * console.log('[smartico] AI variants by base avatar — render as a carousel under each base');

package/dist/WSAPI/WSAPITypes.d.ts

@@ -832,7 +832,9 @@ export interface TMissionOrBadge {
     requires_prize_claim?: boolean;
     /** The date/timestamp indicating when the prize was claimed by the user */
     prize_claimed_date_ts?: number;
-    /** Time in hours that took this player to complete mission */
+    /** Date-time the mission/badge was completed, as a `"dd/MM/yyyy HH:mm:ss"` string
+     * (server local — NOT ISO-8601, so `new Date(complete_date)` will not parse it).
+     * Prefer the epoch-ms `complete_date_ts` for date math. */
     complete_date?: string;
     /** Time of mission/badge being completed, this property shows the epoch time in UTC */
     complete_date_ts?: number;
@@ -974,7 +976,8 @@ export interface TInboxMessage {
     /** Unique identifier of the message. Pass to `getInboxMessageBody`
      * and the mark / favorite / delete mutations. */
     message_guid: string;
-    /** Date when the message was sent (server timestamp). */
+    /** Date-time the message was sent, as a `"dd/MM/yyyy HH:mm:ss"` string
+     * (server local — NOT ISO-8601, so `new Date(sent_date)` will not parse it). */
     sent_date: string;
     /** `true` when the message has been marked read. */
     read: boolean;
@@ -1688,8 +1691,8 @@ export interface TAvatarCustomized {
     avatar_real_id: number;
     /** Absolute CDN URL of the AI-generated image. Can be passed as `avatar_url` to `setAvatar()`. */
     url: string;
-    /** ISO date string of when the variant was generated. */
-    dt_created: string;
+    /** Unix-ms timestamp of when the variant was generated. */
+    dt_created: number;
 }
 /**
  * One AI style prompt for avatar customization. Returned by `getAvatarPrompts()`.

package/dist/WSAPI/WSAPIUser.d.ts

@@ -540,5 +540,8 @@ export declare class WSAPIUser extends WSAPIBase {
         /** Optional push callback; payload is a fixed 10-min / 50-entry refresh on every wallet change (see Subscription model). */
         onUpdate?: (data: TActivityLog[]) => void;
     }): Promise<TActivityLog[]>;
+    /** @hidden Last window passed to `getActivityLog` with an `onUpdate`, so a push
+     * refresh re-fetches the same window and updates its matching composite cache key. */
+    private activityLogOnUpdateParams;
     protected notifyActivityLogUpdate(): Promise<void>;
 }

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './SmarticoAPI';
 export * from './WSAPI/WSAPI';
 export * from './SmarticoGlobal';
 export * from './CookieStore';
+export type { TAchCategory, TActivityLog, TAvatarCustomized, TAvatarDefinition, TAvatarPrompt, TBonus, TBuyStoreItemResult, TClaimBonusResult, TClan, TClanInfo, TClanJoinResult, TClanTournamentPlayers, TClans, TGetTranslations, TInboxMessage, TInboxMessageBody, TLevel, TLevelCurrent, TMiniGamePlayBatchResult, TMiniGamePlayResult, TMiniGamePrize, TMiniGameTemplate, TMissionClaimRewardResult, TMissionOptInResult, TMissionOrBadge, TMissionOrBadgeTask, TRaffle, TRaffleDraw, TRaffleDrawRun, TRaffleOptinResponse, TRafflePrize, TRafflePrizeWinner, TRaffleTicket, TSawHistory, TSegmentCheckResult, TSetAvatarResult, TStoreCategory, TStoreItem, TTournament, TTournamentDetailed, TTournamentRegistrationResult, TUICustomSection, TUserProfile, TransformedRaffleClaimPrizeResponse, InboxMarkMessageAction, LeaderBoardDetailsT, LeaderBoardUserT, LeaderBoardsRewardsT, UserLevelExtraCountersT, } from './WSAPI/WSAPITypes';
 export * from './Analytics';
 export * from './Core';
 export * from './UserProfile';

package/dist/index.js

@@ -706,6 +706,13 @@ var NodeCache = /*#__PURE__*/function () {
       delete this.cache[key];
     }
   };
+  _proto.removeByPrefix = function removeByPrefix(prefix) {
+    for (var key in this.cache) {
+      if (this.cache.hasOwnProperty(key) && key.indexOf(prefix) === 0) {
+        delete this.cache[key];
+      }
+    }
+  };
   _proto.flushAll = function flushAll() {
     this.cache = {};
     if (this.ttlChecker) {
@@ -778,27 +785,49 @@ var OCache = /*#__PURE__*/function () {
     } catch (e) {
       return Promise.reject(e);
     }
-  };
-  OCache.clearContext = function clearContext(cacheContext) {
+  }
+  /**
+   * Remove every entry whose string key starts with `oKeyBase` — the bare key
+   * AND all per-parameter composite variants (`${oKeyBase}:…` / `${oKeyBase}<id>`).
+   * Use when a cache is keyed per parameter (paginated, per-template, per-window):
+   * an exact-key `clear(oKeyBase)` would miss every variant. `oKeyBase` must be a string.
+   */
+  ;
+  OCache.clearByPrefix = function clearByPrefix(cacheContext, oKeyBase) {
     try {
       var _this2 = this;
+      // `set`/`get` build keys as `<context>_<JSON.stringify(oKey)>`; JSON.stringify
+      // wraps a string in quotes, so dropping the trailing quote yields a prefix that
+      // matches both the bare `"base"` key and every `"base…"` composite key.
+      var prefix = cacheContext.toString() + '_' + JSON.stringify(oKeyBase).slice(0, -1);
       if (_this2.cache[cacheContext]) {
-        _this2.cache[cacheContext].flushAll();
+        _this2.cache[cacheContext].removeByPrefix(prefix);
       }
       return Promise.resolve();
     } catch (e) {
       return Promise.reject(e);
     }
   };
-  OCache.clearAll = function clearAll() {
+  OCache.clearContext = function clearContext(cacheContext) {
     try {
       var _this3 = this;
-      for (var cacheContext in _this3.cache) {
-        if (_this3.cache.hasOwnProperty(cacheContext)) {
-          _this3.cache[cacheContext].flushAll();
+      if (_this3.cache[cacheContext]) {
+        _this3.cache[cacheContext].flushAll();
+      }
+      return Promise.resolve();
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  };
+  OCache.clearAll = function clearAll() {
+    try {
+      var _this4 = this;
+      for (var cacheContext in _this4.cache) {
+        if (_this4.cache.hasOwnProperty(cacheContext)) {
+          _this4.cache[cacheContext].flushAll();
         }
       }
-      _this3.cache = {};
+      _this4.cache = {};
       return Promise.resolve();
     } catch (e) {
       return Promise.reject(e);
@@ -1064,7 +1093,7 @@ var StoreItemTransform = function StoreItemTransform(items) {
       id: r.id,
       name: r.itemPublicMeta.name,
       purchase_type: mapPurchaseType$1(r.itemPublicMeta.purchase_type),
-      price: r.itemPublicMeta.price,
+      price: Number(r.itemPublicMeta.price),
       image: r.itemPublicMeta.image_url,
       description: r.itemPublicMeta.description,
       ribbon: r.itemPublicMeta.label_tag === 'custom' ? r.itemPublicMeta.custom_label_tag : r.itemPublicMeta.label_tag,
@@ -2461,7 +2490,15 @@ var raffleClaimPrizeResponseTransform = function raffleClaimPrizeResponseTransfo
 /** @group User */
 var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
   function WSAPIUser() {
-    return _WSAPIBase.apply(this, arguments) || this;
+    var _this;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    _this = _WSAPIBase.call.apply(_WSAPIBase, [this].concat(args)) || this;
+    /** @hidden Last window passed to `getActivityLog` with an `onUpdate`, so a push
+     * refresh re-fetches the same window and updates its matching composite cache key. */
+    _this.activityLogOnUpdateParams = void 0;
+    return _this;
   }
   _inheritsLoose(WSAPIUser, _WSAPIBase);
   var _proto = WSAPIUser.prototype;
@@ -2658,8 +2695,8 @@ var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
    */;
   _proto.checkSegmentMatch = function checkSegmentMatch(segment_id) {
     try {
-      var _this = this;
-      return Promise.resolve(_this.api.coreCheckSegments(_this.userExtId, [segment_id])).then(function (r) {
+      var _this2 = this;
+      return Promise.resolve(_this2.api.coreCheckSegments(_this2.userExtId, [segment_id])).then(function (r) {
         if (r && r.find(function (s) {
           return s.segment_id === segment_id && s.is_matching;
         })) {
@@ -2737,8 +2774,8 @@ var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
   ;
   _proto.checkSegmentListMatch = function checkSegmentListMatch(segment_ids) {
     try {
-      var _this2 = this;
-      return Promise.resolve(_this2.api.coreCheckSegments(_this2.userExtId, Array.isArray(segment_ids) ? segment_ids : [segment_ids]));
+      var _this3 = this;
+      return Promise.resolve(_this3.api.coreCheckSegments(_this3.userExtId, Array.isArray(segment_ids) ? segment_ids : [segment_ids]));
     } catch (e) {
       return Promise.reject(e);
     }
@@ -2815,9 +2852,9 @@ var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
   ;
   _proto.getLevels = function getLevels() {
     try {
-      var _this3 = this;
+      var _this4 = this;
       return Promise.resolve(OCache.use(onUpdateContextKey.Levels, exports.ECacheContext.WSAPI, function () {
-        return _this3.api.levelsGetT(_this3.userExtId);
+        return _this4.api.levelsGetT(_this4.userExtId);
       }, CACHE_DATA_SEC));
     } catch (e) {
       return Promise.reject(e);
@@ -2897,9 +2934,9 @@ var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
   ;
   _proto.getCurrentLevel = function getCurrentLevel() {
     try {
-      var _this4 = this;
+      var _this5 = this;
       return Promise.resolve(OCache.use(onUpdateContextKey.CurrentLevel, exports.ECacheContext.WSAPI, function () {
-        return _this4.api.getLevelCurrent(_this4.userExtId);
+        return _this5.api.getLevelCurrent(_this5.userExtId);
       }, CACHE_DATA_SEC));
     } catch (e) {
       return Promise.reject(e);
@@ -2980,9 +3017,9 @@ var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
   ;
   _proto.getUserLevelExtraCounters = function getUserLevelExtraCounters() {
     try {
-      var _this5 = this;
+      var _this6 = this;
       return Promise.resolve(OCache.use(onUpdateContextKey.LevelExtraCounters, exports.ECacheContext.WSAPI, function () {
-        return _this5.api.getUserGamificationInfoT(_this5.userExtId);
+        return _this6.api.getUserGamificationInfoT(_this6.userExtId);
       }, CACHE_DATA_SEC));
     } catch (e) {
       return Promise.reject(e);
@@ -3060,12 +3097,21 @@ var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
       to = _ref.to,
       onUpdate = _ref.onUpdate;
     try {
-      var _this6 = this;
+      var _this7 = this;
+      var cacheKey = onUpdateContextKey.ActivityLog + ":" + startTimeSeconds + ":" + endTimeSeconds + ":" + from + ":" + to;
       if (typeof onUpdate === 'function') {
-        _this6.onUpdateCallback.set(onUpdateContextKey.ActivityLog, onUpdate);
+        _this7.onUpdateCallback.set(onUpdateContextKey.ActivityLog, onUpdate);
+        // Remember the requested window so a push refresh re-fetches THIS window
+        // and writes the matching composite cache key (see notifyActivityLogUpdate).
+        _this7.activityLogOnUpdateParams = {
+          startTimeSeconds: startTimeSeconds,
+          endTimeSeconds: endTimeSeconds,
+          from: from,
+          to: to
+        };
       }
-      return Promise.resolve(OCache.use(onUpdateContextKey.ActivityLog, exports.ECacheContext.WSAPI, function () {
-        return _this6.api.getActivityLogT(_this6.userExtId, startTimeSeconds, endTimeSeconds, from, to);
+      return Promise.resolve(OCache.use(cacheKey, exports.ECacheContext.WSAPI, function () {
+        return _this7.api.getActivityLogT(_this7.userExtId, startTimeSeconds, endTimeSeconds, from, to);
       }, CACHE_DATA_SEC));
     } catch (e) {
       return Promise.reject(e);
@@ -3073,11 +3119,19 @@ var WSAPIUser = /*#__PURE__*/function (_WSAPIBase) {
   };
   _proto.notifyActivityLogUpdate = function notifyActivityLogUpdate() {
     try {
-      var _this7 = this;
-      var startSeconds = Date.now() / 1000 - 600;
-      var endSeconds = Date.now() / 1000;
-      return Promise.resolve(_this7.api.getActivityLogT(_this7.userExtId, startSeconds, endSeconds, 0, 50)).then(function (payload) {
-        _this7.updateEntity(onUpdateContextKey.ActivityLog, payload);
+      var _this8 = this;
+      var params = _this8.activityLogOnUpdateParams;
+      // No consumer has subscribed to a specific window yet — nothing to refresh.
+      if (!params) {
+        return Promise.resolve();
+      }
+      return Promise.resolve(_this8.api.getActivityLogT(_this8.userExtId, params.startTimeSeconds, params.endTimeSeconds, params.from, params.to)).then(function (payload) {
+        var cacheKey = onUpdateContextKey.ActivityLog + ":" + params.startTimeSeconds + ":" + params.endTimeSeconds + ":" + params.from + ":" + params.to;
+        OCache.set(cacheKey, payload, exports.ECacheContext.WSAPI);
+        var onUpdate = _this8.onUpdateCallback.get(onUpdateContextKey.ActivityLog);
+        if (typeof onUpdate === 'function') {
+          onUpdate(payload);
+        }
       });
     } catch (e) {
       return Promise.reject(e);
@@ -5928,7 +5982,10 @@ var WSAPIJackpots = /*#__PURE__*/function (_WSAPIClans) {
     try {
       OCache.clear(exports.ECacheContext.WSAPI, onUpdateContextKey.Jackpots);
       OCache.clear(exports.ECacheContext.WSAPI, onUpdateContextKey.Pots);
-      OCache.clear(exports.ECacheContext.WSAPI, onUpdateContextKey.JackpotWinners);
+      // Winners + eligible-games are cached per jp_template_id (composite keys),
+      // so a bare clear misses every variant — clear by prefix.
+      OCache.clearByPrefix(exports.ECacheContext.WSAPI, onUpdateContextKey.JackpotWinners);
+      OCache.clearByPrefix(exports.ECacheContext.WSAPI, onUpdateContextKey.JackpotEligibleGames);
       return Promise.resolve();
     } catch (e) {
       return Promise.reject(e);
@@ -7289,7 +7346,7 @@ var WSAPIMiniGames = /*#__PURE__*/function (_WSAPIRaffles) {
       saw_template_id = _ref2.saw_template_id;
     try {
       var _this2 = this;
-      return Promise.resolve(OCache.use(onUpdateContextKey.SAWHistory, exports.ECacheContext.WSAPI, function () {
+      return Promise.resolve(OCache.use(onUpdateContextKey.SAWHistory + ":" + (saw_template_id != null ? saw_template_id : '') + ":" + (limit != null ? limit : '') + ":" + (offset != null ? offset : ''), exports.ECacheContext.WSAPI, function () {
         return _this2.api.getSawWinningHistoryT(_this2.userExtId, limit, offset, saw_template_id);
       }, CACHE_DATA_SEC));
     } catch (e) {
@@ -7915,7 +7972,7 @@ var WSAPIAvatars = /*#__PURE__*/function (_WSAPIMiniGames) {
    *
    * // Newest-first within each base.
    * for (const list of byBase.values()) {
-   *     list.sort((a, b) => b.dt_created.localeCompare(a.dt_created));
+   *     list.sort((a, b) => b.dt_created - a.dt_created);
    * }
    *
    * console.log('[smartico] AI variants by base avatar — render as a carousel under each base');
@@ -9940,11 +9997,11 @@ var WSAPI = /*#__PURE__*/function (_WSAPIInbox) {
       });
       on(exports.ClassId.SAW_AKNOWLEDGE_RESPONSE, function () {
         _this.reloadMiniGameTemplate();
-        OCache.clear(exports.ECacheContext.WSAPI, onUpdateContextKey.SAWHistory);
+        OCache.clearByPrefix(exports.ECacheContext.WSAPI, onUpdateContextKey.SAWHistory);
       });
       on(exports.ClassId.SAW_DO_SPIN_RESPONSE, function () {
         _this.reloadMiniGameTemplate();
-        OCache.clear(exports.ECacheContext.WSAPI, onUpdateContextKey.SAWHistory);
+        OCache.clearByPrefix(exports.ECacheContext.WSAPI, onUpdateContextKey.SAWHistory);
       });
       on(exports.ClassId.MISSION_OPTIN_RESPONSE, function () {
         return _this.updateMissions();
@@ -9985,7 +10042,7 @@ var WSAPI = /*#__PURE__*/function (_WSAPIInbox) {
       });
       on(exports.ClassId.SAW_DO_SPIN_BATCH_RESPONSE, function () {
         _this.reloadMiniGameTemplate();
-        OCache.clear(exports.ECacheContext.WSAPI, onUpdateContextKey.SAWHistory);
+        OCache.clearByPrefix(exports.ECacheContext.WSAPI, onUpdateContextKey.SAWHistory);
       });
       on(exports.ClassId.RAF_CLAIM_PRIZE_RESPONSE, function () {
         return _this.updateRaffles();