@reforgium/statum 3.1.1 → 3.1.3

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [3.1.3]: 2026-04-06
+
+### Fix:
+- `PagedQueryStore`: all public state getters (`filters`, `query`, `page`, `pageSize`, `totalElements`, `sort`) and direct `#routeParams` reads now wrap the underlying signal in `untracked()`; previously calling `fetch()`, `refetchWith()`, `updatePage()`, `setRouteParams()`, etc. from inside an Angular `effect()` or `computed()` would inadvertently subscribe the reactive context to internal state signals, causing cascading re-runs; reactive subscriptions remain available exclusively through the `*State` readonly signals (`filtersState`, `sortState`, `pageState`, …)
+
+---
+
+## [3.1.2]: 2026-04-06
+
+### Fix:
+- `DictStore`: `presetFilters` were passed to the internal `PagedQueryStore` as its initial filter state, which was immediately overwritten on the first `fetch()` call; `presetFilters` are now stored directly on `DictStore` and explicitly merged into every `fetch` call as `{ name, ...presetFilters, ...runtimeFilters }`, so direction/status constraints are always included regardless of runtime filter state
+
+---
+
 ## [3.1.1]: 2026-04-04
 
 ### Refactor:

package/fesm2022/reforgium-statum.mjs

@@ -1,7 +1,7 @@
 import { Serializer, fillUrlWithParams, mergeQueryParams, LruCache, deepEqual, isNullable, normalizeSortInput, sortInputToTokens, debounceSignal, storageStrategy } from '@reforgium/internal';
 export { LocalStorage, LruCache, MemoryStorage, Serializer, SerializerFieldError, SessionStorage, storageStrategy } from '@reforgium/internal';
 import { HttpClient, HttpParams } from '@angular/common/http';
-import { InjectionToken, makeEnvironmentProviders, inject, signal, computed, EnvironmentInjector, DestroyRef, runInInjectionContext, effect, untracked } from '@angular/core';
+import { InjectionToken, makeEnvironmentProviders, inject, signal, computed, EnvironmentInjector, DestroyRef, untracked, runInInjectionContext, effect } from '@angular/core';
 import { Subject, filter, timer, merge, map } from 'rxjs';
 import { debounce, tap, throttle, finalize } from 'rxjs/operators';
 
@@ -277,10 +277,10 @@ class KeyedScheduler {
 class ResourceStore {
     http = inject(HttpClient);
     serializer;
-    #value = signal(null, ...(ngDevMode ? [{ debugName: "#value" }] : /* istanbul ignore next */ []));
-    #status = signal('idle', ...(ngDevMode ? [{ debugName: "#status" }] : /* istanbul ignore next */ []));
-    #error = signal(null, ...(ngDevMode ? [{ debugName: "#error" }] : /* istanbul ignore next */ []));
-    #activeRequests = signal(0, ...(ngDevMode ? [{ debugName: "#activeRequests" }] : /* istanbul ignore next */ []));
+    #value = signal(null, ...(ngDevMode ? [{ debugName: "#value" }] : []));
+    #status = signal('idle', ...(ngDevMode ? [{ debugName: "#status" }] : []));
+    #error = signal(null, ...(ngDevMode ? [{ debugName: "#error" }] : []));
+    #activeRequests = signal(0, ...(ngDevMode ? [{ debugName: "#activeRequests" }] : []));
     /**
      * Current resource value.
      * Returns `null` if no data yet or the request failed.
@@ -298,7 +298,7 @@ class ResourceStore {
      * Convenience loading flag: `true` when `loading` or `stale`.
      * Useful for spinners and disabling buttons.
      */
-    loading = computed(() => this.#activeRequests() > 0 || this.#status() === 'stale', ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
+    loading = computed(() => this.#activeRequests() > 0 || this.#status() === 'stale', ...(ngDevMode ? [{ debugName: "loading" }] : []));
     routes;
     opts;
     maxEntries;
@@ -819,7 +819,7 @@ const createResourceProfile = (profile, overrides = {}) => ({
  * - reactive signals: `items`, `loading`, `cached`;
  * - methods to control page/size/query;
  * - optional LRU cache by pages;
- * - configurable transport (GET/POST/PATCH/…).
+ * - configurable transport (GET/POST/PATCH/…).
  *
  * Example:
  * ```ts
@@ -839,22 +839,22 @@ class PagedQueryStore {
     #transport;
     #cache;
     /** Current page data (reactive). */
-    items = signal([], ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    items = signal([], ...(ngDevMode ? [{ debugName: "items" }] : []));
     /** Merged cache of pages (flat list) handy for search/export. */
-    cached = signal([], ...(ngDevMode ? [{ debugName: "cached" }] : /* istanbul ignore next */ []));
+    cached = signal([], ...(ngDevMode ? [{ debugName: "cached" }] : []));
     /** Loading flag of the current operation. */
-    loading = signal(false, ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
+    loading = signal(false, ...(ngDevMode ? [{ debugName: "loading" }] : []));
     /** Last request error (if any). */
-    error = signal(null, ...(ngDevMode ? [{ debugName: "error" }] : /* istanbul ignore next */ []));
+    error = signal(null, ...(ngDevMode ? [{ debugName: "error" }] : []));
     /** Increments when the current dataset is reset/replaced. Useful for external consumers with local buffers. */
-    version = signal(0, ...(ngDevMode ? [{ debugName: "version" }] : /* istanbul ignore next */ []));
-    #page = signal(0, ...(ngDevMode ? [{ debugName: "#page" }] : /* istanbul ignore next */ []));
-    #pageSize = signal(20, ...(ngDevMode ? [{ debugName: "#pageSize" }] : /* istanbul ignore next */ []));
-    #totalElements = signal(0, ...(ngDevMode ? [{ debugName: "#totalElements" }] : /* istanbul ignore next */ []));
-    #filters = signal({}, ...(ngDevMode ? [{ debugName: "#filters" }] : /* istanbul ignore next */ []));
-    #query = signal({}, ...(ngDevMode ? [{ debugName: "#query" }] : /* istanbul ignore next */ []));
-    #sort = signal([], ...(ngDevMode ? [{ debugName: "#sort" }] : /* istanbul ignore next */ []));
-    #routeParams = signal({}, ...(ngDevMode ? [{ debugName: "#routeParams" }] : /* istanbul ignore next */ []));
+    version = signal(0, ...(ngDevMode ? [{ debugName: "version" }] : []));
+    #page = signal(0, ...(ngDevMode ? [{ debugName: "#page" }] : []));
+    #pageSize = signal(20, ...(ngDevMode ? [{ debugName: "#pageSize" }] : []));
+    #totalElements = signal(0, ...(ngDevMode ? [{ debugName: "#totalElements" }] : []));
+    #filters = signal({}, ...(ngDevMode ? [{ debugName: "#filters" }] : []));
+    #query = signal({}, ...(ngDevMode ? [{ debugName: "#query" }] : []));
+    #sort = signal([], ...(ngDevMode ? [{ debugName: "#sort" }] : []));
+    #routeParams = signal({}, ...(ngDevMode ? [{ debugName: "#routeParams" }] : []));
     pageState = this.#page.asReadonly();
     pageSizeState = this.#pageSize.asReadonly();
     totalElementsState = this.#totalElements.asReadonly();
@@ -877,27 +877,27 @@ class PagedQueryStore {
     }
     /** Current filters (applied to requests). */
     get filters() {
-        return this.#filters();
+        return untracked(this.#filters);
     }
     /** Additional query params sent to transport requests. */
     get query() {
-        return this.#query();
+        return untracked(this.#query);
     }
     /** Current page index (0-based). */
     get page() {
-        return this.#page();
+        return untracked(this.#page);
     }
     /** Default page size. */
     get pageSize() {
-        return this.#pageSize();
+        return untracked(this.#pageSize);
     }
     /** Total number of elements reported by the server. */
     get totalElements() {
-        return this.#totalElements();
+        return untracked(this.#totalElements);
     }
     /** Current sort rules. */
     get sort() {
-        return this.#sort();
+        return untracked(this.#sort);
     }
     set filters(value) {
         this.#filters.set(value);
@@ -998,7 +998,7 @@ class PagedQueryStore {
      * ```
      */
     setRouteParams = (params = {}, opts = {}) => {
-        const isChanged = !deepEqual(this.#routeParams(), params);
+        const isChanged = !deepEqual(untracked(this.#routeParams), params);
         if (!isChanged) {
             return;
         }
@@ -1046,7 +1046,7 @@ class PagedQueryStore {
             }
         }
     }
-    #fetchItems = async ({ page = this.page, size = this.pageSize, filters = this.filters, query = this.query, routeParams = this.#routeParams(), sort = this.sort, }) => {
+    #fetchItems = async ({ page = this.page, size = this.pageSize, filters = this.filters, query = this.query, routeParams = untracked(this.#routeParams), sort = this.sort, }) => {
         const builtQuery = this.parseQuery({ page, size, filters, query, sort });
         const requestId = ++this.#requestId;
         this.#activeRequests++;
@@ -1285,21 +1285,22 @@ class DictStore {
     metaStorage;
     ttlMs;
     revalidate;
-    cacheUpdatedAt = signal(null, ...(ngDevMode ? [{ debugName: "cacheUpdatedAt" }] : /* istanbul ignore next */ []));
+    cacheUpdatedAt = signal(null, ...(ngDevMode ? [{ debugName: "cacheUpdatedAt" }] : []));
+    presetFilters = {};
     /**
      * Search text.
      * With `fixed: true` filters the local cache; with `fixed: false` triggers server search.
      */
-    searchText = signal('', ...(ngDevMode ? [{ debugName: "searchText" }] : /* istanbul ignore next */ []));
+    searchText = signal('', ...(ngDevMode ? [{ debugName: "searchText" }] : []));
     debouncedSearchText;
     /**
      * Additional filters for server request (or presets).
      */
-    filters = signal({}, ...(ngDevMode ? [{ debugName: "filters" }] : /* istanbul ignore next */ []));
-    cachedItems = signal([], ...(ngDevMode ? [{ debugName: "cachedItems" }] : /* istanbul ignore next */ []));
+    filters = signal({}, ...(ngDevMode ? [{ debugName: "filters" }] : []));
+    cachedItems = signal([], ...(ngDevMode ? [{ debugName: "cachedItems" }] : []));
     /**
      * Current list of dictionary items.
-     * Source — local cache (fixed=true) or data from `PagedQueryStore`.
+     * Source — local cache (fixed=true) or data from `PagedQueryStore`.
      */
     items = computed(() => {
         const cached = this.cachedItems();
@@ -1307,7 +1308,7 @@ class DictStore {
             return this.debouncedSearchText() || !cached.length ? this.#helper.items() : cached;
         }
         return cached.length ? this.filterLocal() : this.#helper.items();
-    }, ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "items" }] : []));
     /**
      * Ready-to-use dropdown options: `{ label, value }`.
      * Respects `maxOptionsSize` for truncating the list.
@@ -1315,9 +1316,9 @@ class DictStore {
     options = computed(() => {
         const options = this.items().map((it) => ({ label: String(it[this.labelKey] ?? ''), value: it[this.valueKey] }));
         return this.maxOptionsSize ? options.slice(0, this.maxOptionsSize) : options;
-    }, ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "options" }] : []));
     _lastPromise = null;
-    _armed = signal(false, ...(ngDevMode ? [{ debugName: "_armed" }] : /* istanbul ignore next */ []));
+    _armed = signal(false, ...(ngDevMode ? [{ debugName: "_armed" }] : []));
     // todo add i18n support
     /**
      * @param apiUrl      dictionary endpoint (e.g., `'/api/dicts/countries'`)
@@ -1329,10 +1330,10 @@ class DictStore {
         this.storageKey = storageKey;
         const searchDebounce = debounceTime ?? 300;
         this.debouncedSearchText = debounceSignal(this.searchText, searchDebounce);
+        this.presetFilters = presetFilters ?? {};
         this.#helper = new PagedQueryStore(this.apiUrl, {
             method: method,
             hasCache: false,
-            presetFilters: { name: '', ...presetFilters },
             parseResponse: parseResponse,
             parseRequest: parseRequest,
             debounceTime: debounceTime,
@@ -1366,12 +1367,14 @@ class DictStore {
             if (!this.fixed) {
                 const query = this.debouncedSearchText().trim();
                 untracked(() => {
-                    this._lastPromise = this.#helper.fetch({ filters: { name: query, ...rest } });
+                    this._lastPromise = this.#helper.fetch({ filters: { name: query, ...this.presetFilters, ...rest } });
                 });
             }
             else if (this.shouldFetchFixedCache()) {
                 untracked(() => {
-                    this._lastPromise = this.#helper.fetch({ filters: { name: '', ...rest } }).then((items) => {
+                    this._lastPromise = this.#helper
+                        .fetch({ filters: { name: '', ...this.presetFilters, ...rest } })
+                        .then((items) => {
                         items?.length && this.mergeIntoCache(items);
                         return items;
                     });
@@ -1392,7 +1395,7 @@ class DictStore {
     }
     /**
      * Set a search query and filters.
-     * With `fixed: false` initiates server search; with `fixed: true` — local filtering.
+     * With `fixed: false` initiates server search; with `fixed: true` — local filtering.
      */
     search = (name = '', filters = {}) => {
         this._armed.set(true);
@@ -1571,8 +1574,8 @@ class DictLocalStore {
      * Represents the full, unfiltered list of dictionary entries.
      * Used as the base data set for search and option generation.
      */
-    items = signal([], ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
-    #draftItems = signal([], ...(ngDevMode ? [{ debugName: "#draftItems" }] : /* istanbul ignore next */ []));
+    items = signal([], ...(ngDevMode ? [{ debugName: "items" }] : []));
+    #draftItems = signal([], ...(ngDevMode ? [{ debugName: "#draftItems" }] : []));
     /**
      * Computed list of options in `{ label, value }` format.
      *
@@ -1587,7 +1590,7 @@ class DictLocalStore {
             value: it[this.valueKey],
         }));
         return this.maxOptionsSize ? options.slice(0, this.maxOptionsSize) : options;
-    }, ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "options" }] : []));
     labelKey;
     valueKey;
     maxOptionsSize;
@@ -1672,14 +1675,14 @@ class DictLocalStore {
 class EntityStore {
     idKey;
     sortIds;
-    byId = signal({}, ...(ngDevMode ? [{ debugName: "byId" }] : /* istanbul ignore next */ []));
-    ids = signal([], ...(ngDevMode ? [{ debugName: "ids" }] : /* istanbul ignore next */ []));
+    byId = signal({}, ...(ngDevMode ? [{ debugName: "byId" }] : []));
+    ids = signal([], ...(ngDevMode ? [{ debugName: "ids" }] : []));
     items = computed(() => {
         const byId = this.byId();
         return this.ids()
             .map((id) => byId[String(id)])
             .filter((item) => item !== undefined);
-    }, ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    }, ...(ngDevMode ? [{ debugName: "items" }] : []));
     constructor(config) {
         this.idKey = config.idKey;
         this.sortIds = config.sortIds;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.1.1",
+  "version": "3.1.3",
   "name": "@reforgium/statum",
   "description": "Signals-first API state and query stores for Angular",
   "author": "rtommievich",

package/types/reforgium-statum.d.ts

@@ -477,7 +477,7 @@ type PagedQueryStoreProviderConfig = {
  * - reactive signals: `items`, `loading`, `cached`;
  * - methods to control page/size/query;
  * - optional LRU cache by pages;
- * - configurable transport (GET/POST/PATCH/…).
+ * - configurable transport (GET/POST/PATCH/…).
  *
  * Example:
  * ```ts
@@ -761,6 +761,7 @@ declare class DictStore<Type extends AnyDict> {
     private readonly ttlMs?;
     private readonly revalidate;
     private readonly cacheUpdatedAt;
+    private readonly presetFilters;
     /**
      * Search text.
      * With `fixed: true` filters the local cache; with `fixed: false` triggers server search.
@@ -774,7 +775,7 @@ declare class DictStore<Type extends AnyDict> {
     private cachedItems;
     /**
      * Current list of dictionary items.
-     * Source — local cache (fixed=true) or data from `PagedQueryStore`.
+     * Source — local cache (fixed=true) or data from `PagedQueryStore`.
      */
     items: Signal<readonly Type[]>;
     /**
@@ -798,7 +799,7 @@ declare class DictStore<Type extends AnyDict> {
     clearCache(): void;
     /**
      * Set a search query and filters.
-     * With `fixed: false` initiates server search; with `fixed: true` — local filtering.
+     * With `fixed: false` initiates server search; with `fixed: true` — local filtering.
      */
     search: (name?: string, filters?: AnyDict) => void;
     /**