@astral/mobx-query 1.17.1 → 1.18.1

package/README.md

@@ -31,6 +31,7 @@
     - [Создание mutations](#создание-и-использование-mutations)
     - [Синхронный вызов mutation](#синхронный-вызов-mutation)
     - [Асинхронный вызов mutation](#асинхронный-вызов-mutation)
+    - [Best practices для MutationSet](#best-practices-для-mutationset)
   - [Кэширование QuerySet и InfiniteQuerySet](#кэширование-queryset-и-infinitequeryset)
     - [FetchPolicy](#fetchpolicy)
     - [Как работает кэш](#как-работает-кэш)
@@ -428,6 +429,36 @@ const editDocMutation = docsFetcher.mutations.editDoc.create();
 await editDocMutation.async({ params: { id: 'docID', name: 'test' } });
 ```
 
+### Best practices для MutationSet
+
+#### `Mutation` должен создаваться в конструкторе класса, а не в getter
+
+**✅ Valid**
+
+```ts
+class DocStore {
+  private readonly creationDocMutation: Mutation<DocsDTO.CreateDocResponse, DocsDTO.CreateDocInput>;
+
+  public constructor(
+    private readonly _docsFetcher: DocsFetcher,
+  ) {
+    this.creationDocMutation = this._docsFetcher.mutations.createDoc.create();
+  }
+}
+```
+
+**❌ Invalid**
+
+```ts
+class DocStore {
+  private get creationDocMutation() {
+    return this._docsFetcher.mutations.createDoc.create();
+  }
+}
+```
+
+Описанный кейс является антипаттерном потому что если на `creationDocMutation` больше не будет подписчиков, то при следующем обращении getter заново создаст `mutation`. Это может привести к нежелательным побочным эффектам.
+
 ## Кэширование QuerySet и InfiniteQuerySet
 
 `QuerySet` и `InfiniteQuerySet` позволяет закэшировать данные, которые были получены ранее.

package/Sets/utils/generateQuerySetKeys/generateQuerySetKeys.js

@@ -1,4 +1,5 @@
 import { isPlainObject } from '@astral/utils';
+import stringify from 'fast-json-stable-stringify';
 /**
  * Создает ключи на основе каждого параметра
  * @param additionalKeys - Создает для каждого параметра отдельный ключ, чтобы по нему можно было инвалидировать query
@@ -10,7 +11,9 @@ export const generateQuerySetKeys = (baseKey, params) => {
     const resultKeys = [];
     params.forEach((param) => {
         if (isPlainObject(param)) {
-            resultKeys.push(...Object.entries(param).map(([key, value]) => [baseKey, key, value]));
+            // Нормализуем объект через стабильную сериализацию для консистентных ключей
+            const normalizedParam = JSON.parse(stringify(param));
+            resultKeys.push(...Object.entries(normalizedParam).map(([key, value]) => [baseKey, key, value]));
         }
         else {
             resultKeys.push(param);

package/node/Sets/utils/generateQuerySetKeys/generateQuerySetKeys.js

@@ -1,7 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateQuerySetKeys = void 0;
 const utils_1 = require("@astral/utils");
+const fast_json_stable_stringify_1 = __importDefault(require("fast-json-stable-stringify"));
 /**
  * Создает ключи на основе каждого параметра
  * @param additionalKeys - Создает для каждого параметра отдельный ключ, чтобы по нему можно было инвалидировать query
@@ -13,7 +17,9 @@ const generateQuerySetKeys = (baseKey, params) => {
     const resultKeys = [];
     params.forEach((param) => {
         if ((0, utils_1.isPlainObject)(param)) {
-            resultKeys.push(...Object.entries(param).map(([key, value]) => [baseKey, key, value]));
+            // Нормализуем объект через стабильную сериализацию для консистентных ключей
+            const normalizedParam = JSON.parse((0, fast_json_stable_stringify_1.default)(param));
+            resultKeys.push(...Object.entries(normalizedParam).map(([key, value]) => [baseKey, key, value]));
         }
         else {
             resultKeys.push(param);

package/package.json

@@ -4,12 +4,13 @@
   "dependencies": {
     "@astral/utils": "^1.6.1",
     "@emotion/hash": "0.9.2",
-    "utility-types": "3.11.0"
+    "utility-types": "3.11.0",
+    "fast-json-stable-stringify": "2.1.0"
   },
   "peerDependencies": {
     "mobx": "^6.0.0"
   },
-  "version": "1.17.1",
+  "version": "1.18.1",
   "author": "Astral.Soft",
   "license": "MIT",
   "repository": {