@idosgames/core 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -2714,6 +2714,16 @@ interface SdkEvents {
      * quest UI. Nothing to call to trigger it.
      */
     "quest:systemProgress": QuestProgressUpdate[];
+    /**
+     * New revisions of the state containers the backend changed while handling some other call
+     * (a purchase, a claim, a roll). Rides on that call's response so the client can keep its
+     * locally-applied copy marked fresh instead of re-fetching it. Handled by the SDK itself —
+     * subscribe only if you keep your own cache keyed by these numbers.
+     */
+    "user:stateVersions": {
+        epoch: string | null;
+        versions: Record<string, number>;
+    };
     "timedEvent:activeEventsLoaded": GetActiveEventsResponse;
     "timedEvent:definitionsLoaded": TimedEventDefinitions;
     "timedEvent:userStateLoaded": UserTimedEventStateResponse;
@@ -3215,8 +3225,18 @@ declare class UserService {
     private baseRequest;
     private get configCache();
     private cache?;
-    private get stateCache();
-    private userStateCache?;
+    private get stateStore();
+    private versionStore?;
+    /**
+     * Версии контейнеров, которые бэкенд изменил, обрабатывая ЛЮБОЕ действие (побочный блок
+     * `StateVersions` на ответе покупки, клейма, ролла). Зовётся одним местом — подпиской в
+     * `ClientContext`, чтобы ни один сервис не был обязан помнить про версии в своём коде.
+     *
+     * Номера принимаются только в память: данные в этот момент ещё не применены к кешу, и запись
+     * их в хранилище рядом со старым содержимым сломала бы инвариант «версия есть ⇔ содержимое
+     * есть». На диск они уедут вместе со снимком живого состояния — перед следующим запросом.
+     */
+    noteStateVersions(epoch: string | null, versions: Record<string, number>): void;
     getClientState(): Promise<OperationResult<ClientState>>;
     /**
      * Подготовка версионного хендшейка состояния: достаём сохранённое состояние игрока и
@@ -3277,6 +3297,11 @@ declare class UserService {
      * выборке нет, остаются нетронутыми.
      */
     getUserState(fields?: string[]): Promise<OperationResult<UserStateSlice>>;
+    /**
+     * Сохраняет версии вместе со снимком живого состояния. Зовётся ПОСЛЕ применения ответа —
+     * только там состояние уже содержит всё, о чём заявляют номера.
+     */
+    private flushState;
     getUserInventory(): Promise<OperationResult<UserInventoryState>>;
     getEventTokens(): Promise<OperationResult<UserEventTokensState>>;
     getUsageTime(): Promise<OperationResult<UsageTimeStats>>;

package/dist/index.d.ts

@@ -2714,6 +2714,16 @@ interface SdkEvents {
      * quest UI. Nothing to call to trigger it.
      */
     "quest:systemProgress": QuestProgressUpdate[];
+    /**
+     * New revisions of the state containers the backend changed while handling some other call
+     * (a purchase, a claim, a roll). Rides on that call's response so the client can keep its
+     * locally-applied copy marked fresh instead of re-fetching it. Handled by the SDK itself —
+     * subscribe only if you keep your own cache keyed by these numbers.
+     */
+    "user:stateVersions": {
+        epoch: string | null;
+        versions: Record<string, number>;
+    };
     "timedEvent:activeEventsLoaded": GetActiveEventsResponse;
     "timedEvent:definitionsLoaded": TimedEventDefinitions;
     "timedEvent:userStateLoaded": UserTimedEventStateResponse;
@@ -3215,8 +3225,18 @@ declare class UserService {
     private baseRequest;
     private get configCache();
     private cache?;
-    private get stateCache();
-    private userStateCache?;
+    private get stateStore();
+    private versionStore?;
+    /**
+     * Версии контейнеров, которые бэкенд изменил, обрабатывая ЛЮБОЕ действие (побочный блок
+     * `StateVersions` на ответе покупки, клейма, ролла). Зовётся одним местом — подпиской в
+     * `ClientContext`, чтобы ни один сервис не был обязан помнить про версии в своём коде.
+     *
+     * Номера принимаются только в память: данные в этот момент ещё не применены к кешу, и запись
+     * их в хранилище рядом со старым содержимым сломала бы инвариант «версия есть ⇔ содержимое
+     * есть». На диск они уедут вместе со снимком живого состояния — перед следующим запросом.
+     */
+    noteStateVersions(epoch: string | null, versions: Record<string, number>): void;
     getClientState(): Promise<OperationResult<ClientState>>;
     /**
      * Подготовка версионного хендшейка состояния: достаём сохранённое состояние игрока и
@@ -3277,6 +3297,11 @@ declare class UserService {
      * выборке нет, остаются нетронутыми.
      */
     getUserState(fields?: string[]): Promise<OperationResult<UserStateSlice>>;
+    /**
+     * Сохраняет версии вместе со снимком живого состояния. Зовётся ПОСЛЕ применения ответа —
+     * только там состояние уже содержит всё, о чём заявляют номера.
+     */
+    private flushState;
     getUserInventory(): Promise<OperationResult<UserInventoryState>>;
     getEventTokens(): Promise<OperationResult<UserEventTokensState>>;
     getUsageTime(): Promise<OperationResult<UsageTimeStats>>;