@itd-api/cache 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1,15 +1,85 @@
-import { BuiltInOperationId, ClientPlugin, ItdRealtime, OperationId, OperationRequestOptions, RealtimeContext, Unsubscribe } from "itd-api";
+import { ClientPlugin, NotificationEventContext, NotificationEvents, OperationId, OperationRequestOptions, Unsubscribe } from "itd-api";
+//#region src/plugin.d.ts
+/** Режимы кэширования отдельного запроса. */
+declare const CacheModes: Readonly<{
+  /** Отдать свежий кэш, иначе выполнить запрос и сохранить ответ. */
+  readonly Default: "default";
+  /** Пропустить сохранённое значение, выполнить запрос и перезаписать кэш. */
+  readonly Reload: "reload";
+  /** Не читать и не писать кэш для этого запроса. */
+  readonly NoStore: "no-store";
+}>;
+/** Поведение кэша для отдельного запроса. */
+type CacheMode = (typeof CacheModes)[keyof typeof CacheModes];
+/** Настройки плагина. */
+interface CacheOptions {
+  /** Сколько миллисекунд хранить успешный ответ. */
+  ttl: number;
+  /** Какие операции itd-api кэшировать. */
+  operations: readonly OperationId[];
+  /** Максимальное количество ответов. По умолчанию 500. */
+  maxEntries?: number | undefined;
+  /** Объединять ли одновременные одинаковые запросы. По умолчанию `true`. */
+  deduplicate?: boolean | undefined;
+}
+/** Плагин и управление созданным им хранилищем. */
+interface CachePlugin extends ClientPlugin {
+  /** Количество готовых ответов во всех разделах кэша. */
+  readonly size: number;
+  /** Удаляет все ответы и не даёт выполняющимся запросам вернуть устаревший результат. */
+  clear(): void;
+  /** Удаляет все варианты названных операций во всех подключённых клиентах. */
+  invalidate(...operations: OperationId[]): void;
+  /**
+   * Подключает инвалидацию к нормализованным событиям уведомлений.
+   *
+   * Удаляет сохранённые список и счётчик, затем отслеживает обновления через промежуточный
+   * обработчик. Подключайте его до обработчиков, способных остановить цепочку.
+   */
+  attachNotificationEvents<C extends NotificationEventContext>(stream: NotificationEvents<C>): Unsubscribe;
+}
+/** Создаёт TTL/LRU-кэш нормализованных результатов itd-api. */
+declare function cache(options: CacheOptions): CachePlugin;
+//#endregion
+//#region src/policy.d.ts
+/** Виды политики кэша, объявляемой в метаданных операции. */
+declare const CachePolicyKind: Readonly<{
+  readonly Query: "query";
+  readonly Mutation: "mutation";
+}>;
+type CachePolicyKind = (typeof CachePolicyKind)[keyof typeof CachePolicyKind];
+/** Области изоляции данных кэша. */
+declare const CachePolicyScope: Readonly<{
+  readonly Account: "account";
+  readonly Session: "session";
+}>;
+type CachePolicyScope = (typeof CachePolicyScope)[keyof typeof CachePolicyScope];
+/** Способы инвалидации кэша после мутации. */
+declare const CacheInvalidation: Readonly<{
+  readonly All: "all";
+}>;
+type CacheInvalidation = (typeof CacheInvalidation)[keyof typeof CacheInvalidation];
+//#endregion
 //#region src/errors.d.ts
 /** Ошибка настройки или использования плагина кэша. */
 declare class CacheError extends Error {
   readonly name = "CacheError";
 }
 //#endregion
+//#region src/key.d.ts
+/**
+ * Собирает ключ из значений, влияющих на адрес, тело или разобранный ответ.
+ *
+ * Заголовки и транспортные опции намеренно не входят. Если тело либо опция другого
+ * плагина не сериализуются как JSON, запрос выполняется без кэша.
+ */
+declare function buildCacheKey(operation: OperationId, request: OperationRequestOptions): string | undefined;
+//#endregion
 //#region src/operations.d.ts
 /** Описание читающей операции itd-api. */
 interface CacheOperation {
   /** Стабильный ID операции и публичное имя для настройки плагина. */
-  id: BuiltInOperationId;
+  id: OperationId;
   /** Раздел клиента. */
   category: string;
 }
@@ -117,7 +187,7 @@ declare const CACHE_OPERATIONS: readonly [Readonly<{
   readonly id: "platform.portal";
   readonly category: "platform";
 }>, Readonly<{
-  readonly id: "platform.status";
+  readonly id: "status.get";
   readonly category: "platform";
 }>];
 /** Имя операции, доступное в `cache({ operations: … })`. */
@@ -129,63 +199,24 @@ declare function isCacheOperationId(value: string): value is CacheOperationId;
 /** Находит читающую операцию по стабильному семантическому ID. */
 declare function cacheOperation(operationId: OperationId): (typeof CACHE_OPERATIONS)[number] | undefined;
 //#endregion
-//#region src/key.d.ts
-/**
- * Собирает ключ из значений, влияющих на адрес, тело или разобранный ответ.
- *
- * Заголовки и транспортные опции намеренно не входят. Если тело либо опция другого
- * плагина не сериализуются как JSON, запрос выполняется без кэша.
- */
-declare function buildCacheKey(operation: CacheOperationId, request: OperationRequestOptions): string | undefined;
-//#endregion
-//#region src/plugin.d.ts
-/** Режимы кэширования отдельного запроса. */
-declare const CacheModes: Readonly<{
-  /** Отдать свежий кэш, иначе выполнить запрос и сохранить ответ. */
-  readonly Default: "default";
-  /** Пропустить сохранённое значение, выполнить запрос и перезаписать кэш. */
-  readonly Reload: "reload";
-  /** Не читать и не писать кэш для этого запроса. */
-  readonly NoStore: "no-store";
-}>;
-/** Поведение кэша для отдельного запроса. */
-type CacheMode = (typeof CacheModes)[keyof typeof CacheModes];
-/** Настройки плагина. */
-interface CacheOptions {
-  /** Сколько миллисекунд хранить успешный ответ. */
-  ttl: number;
-  /** Какие операции itd-api кэшировать. */
-  operations: readonly CacheOperationId[];
-  /** Максимальное количество ответов. По умолчанию 500. */
-  maxEntries?: number | undefined;
-  /** Объединять ли одновременные одинаковые запросы. По умолчанию `true`. */
-  deduplicate?: boolean | undefined;
-}
-/** Плагин и управление созданным им хранилищем. */
-interface CachePlugin extends ClientPlugin {
-  /** Количество готовых ответов во всех разделах кэша. */
-  readonly size: number;
-  /** Удаляет все ответы и не даёт выполняющимся запросам вернуть устаревший результат. */
-  clear(): void;
-  /** Удаляет все варианты названных операций во всех подключённых клиентах. */
-  invalidate(...operations: CacheOperationId[]): void;
-  /**
-   * Очищает список и счётчик уведомлений по событиям realtime.
-   *
-   * Сразу удаляет прежние значения и возвращает функцию отписки.
-   */
-  attachRealtime<C extends RealtimeContext>(stream: ItdRealtime<C>): Unsubscribe;
-}
-/** Создаёт TTL/LRU-кэш разобранных ответов itd-api. */
-declare function cache(options: CacheOptions): CachePlugin;
-//#endregion
 //#region src/index.d.ts
 declare module 'itd-api' {
+  interface OperationAnnotations {
+    /** Правило кэширования операции подключаемого модуля. */
+    readonly cache?: {
+      readonly kind: typeof CachePolicyKind.Query;
+      readonly scope?: CachePolicyScope | undefined;
+    } | {
+      readonly kind: typeof CachePolicyKind.Mutation;
+      readonly invalidates: readonly OperationId[] | CacheInvalidation;
+      readonly scope?: typeof CachePolicyScope.Account | undefined;
+    } | undefined;
+  }
   interface RequestExtensions {
     /** Управление кэшем подключённого `@itd-api/cache`. */
     cache?: CacheMode | undefined;
   }
 }
 //#endregion
-export { CACHE_OPERATIONS, CacheError, type CacheMode, CacheModes, type CacheOperation, type CacheOperationCategory, type CacheOperationId, type CacheOptions, type CachePlugin, buildCacheKey, cache, cacheOperation, isCacheOperationId };
+export { CACHE_OPERATIONS, CacheError, CacheInvalidation, type CacheMode, CacheModes, type CacheOperation, type CacheOperationCategory, type CacheOperationId, type CacheOptions, type CachePlugin, CachePolicyKind, CachePolicyScope, buildCacheKey, cache, cacheOperation, isCacheOperationId };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,15 +1,85 @@
-import { BuiltInOperationId, ClientPlugin, ItdRealtime, OperationId, OperationRequestOptions, RealtimeContext, Unsubscribe } from "itd-api";
+import { ClientPlugin, NotificationEventContext, NotificationEvents, OperationId, OperationRequestOptions, Unsubscribe } from "itd-api";
+//#region src/plugin.d.ts
+/** Режимы кэширования отдельного запроса. */
+declare const CacheModes: Readonly<{
+  /** Отдать свежий кэш, иначе выполнить запрос и сохранить ответ. */
+  readonly Default: "default";
+  /** Пропустить сохранённое значение, выполнить запрос и перезаписать кэш. */
+  readonly Reload: "reload";
+  /** Не читать и не писать кэш для этого запроса. */
+  readonly NoStore: "no-store";
+}>;
+/** Поведение кэша для отдельного запроса. */
+type CacheMode = (typeof CacheModes)[keyof typeof CacheModes];
+/** Настройки плагина. */
+interface CacheOptions {
+  /** Сколько миллисекунд хранить успешный ответ. */
+  ttl: number;
+  /** Какие операции itd-api кэшировать. */
+  operations: readonly OperationId[];
+  /** Максимальное количество ответов. По умолчанию 500. */
+  maxEntries?: number | undefined;
+  /** Объединять ли одновременные одинаковые запросы. По умолчанию `true`. */
+  deduplicate?: boolean | undefined;
+}
+/** Плагин и управление созданным им хранилищем. */
+interface CachePlugin extends ClientPlugin {
+  /** Количество готовых ответов во всех разделах кэша. */
+  readonly size: number;
+  /** Удаляет все ответы и не даёт выполняющимся запросам вернуть устаревший результат. */
+  clear(): void;
+  /** Удаляет все варианты названных операций во всех подключённых клиентах. */
+  invalidate(...operations: OperationId[]): void;
+  /**
+   * Подключает инвалидацию к нормализованным событиям уведомлений.
+   *
+   * Удаляет сохранённые список и счётчик, затем отслеживает обновления через промежуточный
+   * обработчик. Подключайте его до обработчиков, способных остановить цепочку.
+   */
+  attachNotificationEvents<C extends NotificationEventContext>(stream: NotificationEvents<C>): Unsubscribe;
+}
+/** Создаёт TTL/LRU-кэш нормализованных результатов itd-api. */
+declare function cache(options: CacheOptions): CachePlugin;
+//#endregion
+//#region src/policy.d.ts
+/** Виды политики кэша, объявляемой в метаданных операции. */
+declare const CachePolicyKind: Readonly<{
+  readonly Query: "query";
+  readonly Mutation: "mutation";
+}>;
+type CachePolicyKind = (typeof CachePolicyKind)[keyof typeof CachePolicyKind];
+/** Области изоляции данных кэша. */
+declare const CachePolicyScope: Readonly<{
+  readonly Account: "account";
+  readonly Session: "session";
+}>;
+type CachePolicyScope = (typeof CachePolicyScope)[keyof typeof CachePolicyScope];
+/** Способы инвалидации кэша после мутации. */
+declare const CacheInvalidation: Readonly<{
+  readonly All: "all";
+}>;
+type CacheInvalidation = (typeof CacheInvalidation)[keyof typeof CacheInvalidation];
+//#endregion
 //#region src/errors.d.ts
 /** Ошибка настройки или использования плагина кэша. */
 declare class CacheError extends Error {
   readonly name = "CacheError";
 }
 //#endregion
+//#region src/key.d.ts
+/**
+ * Собирает ключ из значений, влияющих на адрес, тело или разобранный ответ.
+ *
+ * Заголовки и транспортные опции намеренно не входят. Если тело либо опция другого
+ * плагина не сериализуются как JSON, запрос выполняется без кэша.
+ */
+declare function buildCacheKey(operation: OperationId, request: OperationRequestOptions): string | undefined;
+//#endregion
 //#region src/operations.d.ts
 /** Описание читающей операции itd-api. */
 interface CacheOperation {
   /** Стабильный ID операции и публичное имя для настройки плагина. */
-  id: BuiltInOperationId;
+  id: OperationId;
   /** Раздел клиента. */
   category: string;
 }
@@ -117,7 +187,7 @@ declare const CACHE_OPERATIONS: readonly [Readonly<{
   readonly id: "platform.portal";
   readonly category: "platform";
 }>, Readonly<{
-  readonly id: "platform.status";
+  readonly id: "status.get";
   readonly category: "platform";
 }>];
 /** Имя операции, доступное в `cache({ operations: … })`. */
@@ -129,63 +199,24 @@ declare function isCacheOperationId(value: string): value is CacheOperationId;
 /** Находит читающую операцию по стабильному семантическому ID. */
 declare function cacheOperation(operationId: OperationId): (typeof CACHE_OPERATIONS)[number] | undefined;
 //#endregion
-//#region src/key.d.ts
-/**
- * Собирает ключ из значений, влияющих на адрес, тело или разобранный ответ.
- *
- * Заголовки и транспортные опции намеренно не входят. Если тело либо опция другого
- * плагина не сериализуются как JSON, запрос выполняется без кэша.
- */
-declare function buildCacheKey(operation: CacheOperationId, request: OperationRequestOptions): string | undefined;
-//#endregion
-//#region src/plugin.d.ts
-/** Режимы кэширования отдельного запроса. */
-declare const CacheModes: Readonly<{
-  /** Отдать свежий кэш, иначе выполнить запрос и сохранить ответ. */
-  readonly Default: "default";
-  /** Пропустить сохранённое значение, выполнить запрос и перезаписать кэш. */
-  readonly Reload: "reload";
-  /** Не читать и не писать кэш для этого запроса. */
-  readonly NoStore: "no-store";
-}>;
-/** Поведение кэша для отдельного запроса. */
-type CacheMode = (typeof CacheModes)[keyof typeof CacheModes];
-/** Настройки плагина. */
-interface CacheOptions {
-  /** Сколько миллисекунд хранить успешный ответ. */
-  ttl: number;
-  /** Какие операции itd-api кэшировать. */
-  operations: readonly CacheOperationId[];
-  /** Максимальное количество ответов. По умолчанию 500. */
-  maxEntries?: number | undefined;
-  /** Объединять ли одновременные одинаковые запросы. По умолчанию `true`. */
-  deduplicate?: boolean | undefined;
-}
-/** Плагин и управление созданным им хранилищем. */
-interface CachePlugin extends ClientPlugin {
-  /** Количество готовых ответов во всех разделах кэша. */
-  readonly size: number;
-  /** Удаляет все ответы и не даёт выполняющимся запросам вернуть устаревший результат. */
-  clear(): void;
-  /** Удаляет все варианты названных операций во всех подключённых клиентах. */
-  invalidate(...operations: CacheOperationId[]): void;
-  /**
-   * Очищает список и счётчик уведомлений по событиям realtime.
-   *
-   * Сразу удаляет прежние значения и возвращает функцию отписки.
-   */
-  attachRealtime<C extends RealtimeContext>(stream: ItdRealtime<C>): Unsubscribe;
-}
-/** Создаёт TTL/LRU-кэш разобранных ответов itd-api. */
-declare function cache(options: CacheOptions): CachePlugin;
-//#endregion
 //#region src/index.d.ts
 declare module 'itd-api' {
+  interface OperationAnnotations {
+    /** Правило кэширования операции подключаемого модуля. */
+    readonly cache?: {
+      readonly kind: typeof CachePolicyKind.Query;
+      readonly scope?: CachePolicyScope | undefined;
+    } | {
+      readonly kind: typeof CachePolicyKind.Mutation;
+      readonly invalidates: readonly OperationId[] | CacheInvalidation;
+      readonly scope?: typeof CachePolicyScope.Account | undefined;
+    } | undefined;
+  }
   interface RequestExtensions {
     /** Управление кэшем подключённого `@itd-api/cache`. */
     cache?: CacheMode | undefined;
   }
 }
 //#endregion
-export { CACHE_OPERATIONS, CacheError, type CacheMode, CacheModes, type CacheOperation, type CacheOperationCategory, type CacheOperationId, type CacheOptions, type CachePlugin, buildCacheKey, cache, cacheOperation, isCacheOperationId };
+export { CACHE_OPERATIONS, CacheError, CacheInvalidation, type CacheMode, CacheModes, type CacheOperation, type CacheOperationCategory, type CacheOperationId, type CacheOptions, type CachePlugin, CachePolicyKind, CachePolicyScope, buildCacheKey, cache, cacheOperation, isCacheOperationId };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,3 +1,4 @@
+import { NotificationUpdateType, isBuiltInOperationId } from "itd-api";
 import { LRUCache } from "lru-cache";
 //#region src/errors.ts
 /** Ошибка настройки или использования плагина кэша. */
@@ -209,7 +210,7 @@ const CACHE_OPERATIONS = freezeOperations([
 		category: "platform"
 	},
 	{
-		id: "platform.status",
+		id: "status.get",
 		category: "platform"
 	}
 ]);
@@ -223,6 +224,20 @@ function cacheOperation(operationId) {
 	return OPERATIONS.get(operationId);
 }
 //#endregion
+//#region src/policy.ts
+/** Виды политики кэша, объявляемой в метаданных операции. */
+const CachePolicyKind = Object.freeze({
+	Query: "query",
+	Mutation: "mutation"
+});
+/** Области изоляции данных кэша. */
+const CachePolicyScope = Object.freeze({
+	Account: "account",
+	Session: "session"
+});
+/** Способы инвалидации кэша после мутации. */
+const CacheInvalidation = Object.freeze({ All: "all" });
+//#endregion
 //#region src/mutations.ts
 const POST_CONTENT = [
 	"posts.list",
@@ -336,37 +351,37 @@ const CACHE_MUTATIONS = Object.freeze([
 	},
 	{
 		operationId: "auth.signUp",
-		invalidates: "all"
+		invalidates: CacheInvalidation.All
 	},
 	{
 		operationId: "auth.signIn",
-		invalidates: "all"
+		invalidates: CacheInvalidation.All
 	},
 	{
 		operationId: "auth.verifyOtp",
-		invalidates: "all"
+		invalidates: CacheInvalidation.All
 	},
 	{
 		operationId: "auth.logout",
-		invalidates: "all"
+		invalidates: CacheInvalidation.All
 	},
 	{
 		operationId: "auth.resetPassword",
-		invalidates: "all"
+		invalidates: CacheInvalidation.All
 	},
 	{
 		operationId: "auth.changePassword",
-		invalidates: "all"
+		invalidates: CacheInvalidation.All
 	},
 	{
 		operationId: "auth.revokeSession",
 		invalidates: ["auth.sessions"],
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "auth.revokeOtherSessions",
 		invalidates: ["auth.sessions"],
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "posts.create",
@@ -491,22 +506,22 @@ const CACHE_MUTATIONS = Object.freeze([
 	{
 		operationId: "notifications.markRead",
 		invalidates: NOTIFICATIONS,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "notifications.markReadBatch",
 		invalidates: NOTIFICATIONS,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "notifications.markAllRead",
 		invalidates: NOTIFICATIONS,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "notifications.updateSettings",
 		invalidates: ["notifications.getSettings"],
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "files.upload",
@@ -519,32 +534,32 @@ const CACHE_MUTATIONS = Object.freeze([
 	{
 		operationId: "verification.submit",
 		invalidates: ["verification.status"],
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "subscription.pay",
 		invalidates: SUBSCRIPTION,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "subscription.setAutoRenewal",
 		invalidates: SUBSCRIPTION,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "subscription.bindCard",
 		invalidates: SUBSCRIPTION,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "subscription.setDefaultMethod",
 		invalidates: SUBSCRIPTION,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "subscription.removeMethod",
 		invalidates: SUBSCRIPTION,
-		scope: "account"
+		scope: CachePolicyScope.Account
 	},
 	{
 		operationId: "reports.create",
@@ -590,7 +605,7 @@ function resolveOptions(options) {
 	if (!Array.isArray(options.operations) || options.operations.length === 0) throw new CacheError("cache.operations должен содержать хотя бы одну операцию");
 	const operations = /* @__PURE__ */ new Set();
 	for (const operation of options.operations) {
-		if (typeof operation !== "string" || !isCacheOperationId(operation)) throw new CacheError(`Неизвестная операция кэша: ${JSON.stringify(operation)}`);
+		if (typeof operation !== "string" || isBuiltInOperationId(operation) && !isCacheOperationId(operation)) throw new CacheError(`Неизвестная операция кэша: ${JSON.stringify(operation)}`);
 		operations.add(operation);
 	}
 	const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
@@ -622,7 +637,7 @@ function cacheMode(request) {
 	if (!CACHE_MODES.has(mode)) throw new CacheError(`cache должен быть '${CacheModes.Default}', '${CacheModes.Reload}' или '${CacheModes.NoStore}', получено: ${String(mode)}`);
 	return mode;
 }
-/** Создаёт TTL/LRU-кэш разобранных ответов itd-api. */
+/** Создаёт TTL/LRU-кэш нормализованных результатов itd-api. */
 function cache(options) {
 	const config = resolveOptions(options);
 	const values = new LRUCache({
@@ -648,9 +663,10 @@ function cache(options) {
 		if (operations.length === 0) return;
 		const selected = /* @__PURE__ */ new Set();
 		for (const operation of operations) {
-			if (!isCacheOperationId(operation)) throw new CacheError(`Неизвестная операция кэша: ${JSON.stringify(operation)}`);
-			selected.add(operation);
-			operationGenerations.set(operation, (operationGenerations.get(operation) ?? 0) + 1);
+			if (typeof operation !== "string") throw new CacheError(`Неизвестная операция кэша: ${JSON.stringify(operation)}`);
+			const operationId = operation;
+			selected.add(operationId);
+			operationGenerations.set(operationId, (operationGenerations.get(operationId) ?? 0) + 1);
 		}
 		for (const [key, entry] of values.entries()) if (selected.has(entry.operation)) values.delete(key);
 		for (const [key, entry] of pending) if (selected.has(entry.operation)) pending.delete(key);
@@ -671,11 +687,24 @@ function cache(options) {
 		for (const [key, entry] of pending) if (entry.accountScope === accountScope && selected.has(entry.operation)) pending.delete(key);
 	};
 	const applyMutation = (accountScope, mutation) => {
-		if (mutation.invalidates === "all") clearScope(accountScope);
-		else if (mutation.scope === "account") invalidateScope(accountScope, mutation.invalidates);
+		if (mutation.invalidates === CacheInvalidation.All) clearScope(accountScope);
+		else if (mutation.scope === CachePolicyScope.Account) invalidateScope(accountScope, mutation.invalidates);
 		else invalidate(...mutation.invalidates);
 	};
-	const createTransformer = (installation, baseUrl, getAuthIdentity, getAuthScope) => {
+	const invalidateNotificationStream = (stream, ...operations) => {
+		const identity = stream.getAuthIdentity();
+		const streamBaseUrl = stream.baseUrl;
+		const legacyScope = stream.getAuthScope();
+		const accountScope = identity?.userId ? JSON.stringify([streamBaseUrl, identity.userId]) : legacyScope !== void 0 ? JSON.stringify([streamBaseUrl, legacyScope]) : void 0;
+		if (accountScope === void 0) invalidate(...operations);
+		else invalidateScope(accountScope, operations);
+	};
+	const notificationMiddleware = async (context, next) => {
+		if (context.update.type === NotificationUpdateType.Notification) invalidateNotificationStream(context.stream, "notifications.list", "notifications.count");
+		else if (context.update.type === NotificationUpdateType.UnreadCount) invalidateNotificationStream(context.stream, "notifications.count");
+		await next();
+	};
+	const createTransformer = (installation, baseUrl, getAuthIdentity, getAuthScope, getOperation) => {
 		const fallbackAuthScope = JSON.stringify([baseUrl, `installation:${installation}`]);
 		const resolveIdentity = async () => {
 			const identity = await getAuthIdentity?.();
@@ -690,16 +719,24 @@ function cache(options) {
 			};
 		};
 		return async (request, next) => {
-			const operation = cacheOperation(request.operationId);
+			const policy = getOperation(request.operationId)?.annotations?.cache;
+			const operation = cacheOperation(request.operationId) ?? (policy?.kind === CachePolicyKind.Query ? {
+				id: request.operationId,
+				category: request.operationId.split(".", 1)[0] ?? "feature"
+			} : void 0);
 			const method = request.method.toUpperCase();
-			if (!(operation !== void 0 || method === "GET" || method === "HEAD")) {
-				const mutation = cacheMutation(request.operationId);
+			if (!(policy !== void 0 ? policy.kind === CachePolicyKind.Query : operation !== void 0 || method === "GET" || method === "HEAD")) {
+				const mutation = cacheMutation(request.operationId) ?? (policy?.kind === CachePolicyKind.Mutation ? {
+					operationId: request.operationId,
+					invalidates: policy.invalidates,
+					...policy.scope === void 0 ? {} : { scope: policy.scope }
+				} : void 0);
 				const startedIdentity = mutation ? await resolveIdentity() : void 0;
 				const result = await next(request);
 				if (mutation && startedIdentity) {
 					applyMutation(startedIdentity.accountScope, mutation);
 					const currentIdentity = await resolveIdentity();
-					if (currentIdentity.accountScope !== startedIdentity.accountScope && (mutation.invalidates === "all" || mutation.scope === "account")) applyMutation(currentIdentity.accountScope, mutation);
+					if (currentIdentity.accountScope !== startedIdentity.accountScope && (mutation.invalidates === CacheInvalidation.All || mutation.scope === CachePolicyScope.Account)) applyMutation(currentIdentity.accountScope, mutation);
 				} else clear();
 				return result;
 			}
@@ -709,7 +746,7 @@ function cache(options) {
 			const unscopedKey = buildCacheKey(operation.id, request);
 			if (unscopedKey === void 0) return next(request);
 			const identity = await resolveIdentity();
-			const scope = operation.id === "auth.sessions" ? identity.sessionScope : identity.accountScope;
+			const scope = operation.id === "auth.sessions" || policy?.kind === CachePolicyKind.Query && policy.scope === CachePolicyScope.Session ? identity.sessionScope : identity.accountScope;
 			const key = JSON.stringify([scope, unscopedKey]);
 			if (mode === CacheModes.Reload) {
 				const state = keyStates.get(key) ?? {
@@ -748,7 +785,7 @@ function cache(options) {
 					const result = await next(request);
 					const stored = cloneValue(result);
 					const currentIdentity = await resolveIdentity();
-					const currentScope = operation.id === "auth.sessions" ? currentIdentity.sessionScope : currentIdentity.accountScope;
+					const currentScope = operation.id === "auth.sessions" || policy?.kind === CachePolicyKind.Query && policy.scope === CachePolicyScope.Session ? currentIdentity.sessionScope : currentIdentity.accountScope;
 					if (stored.cacheable && currentScope === scope && generation === startedGeneration && (scopeGenerations.get(identity.accountScope) ?? 0) === startedScopeGeneration && (operationGenerations.get(operation.id) ?? 0) === startedOperationGeneration && (scopeOperationGenerations.get(scopedOperationKey) ?? 0) === startedScopeOperationGeneration && keyState.generation === startedKeyGeneration) values.set(key, {
 						accountScope: identity.accountScope,
 						operation: operation.id,
@@ -785,31 +822,18 @@ function cache(options) {
 		},
 		clear,
 		invalidate,
-		attachRealtime(stream) {
-			if (!stream || typeof stream.on !== "function") throw new CacheError("attachRealtime() принимает поток из itd.realtime()");
-			const invalidateStream = (...operations) => {
-				const identity = typeof stream.getAuthIdentity === "function" ? stream.getAuthIdentity() : void 0;
-				const streamBaseUrl = typeof stream.baseUrl === "string" && stream.baseUrl.length > 0 ? stream.baseUrl : void 0;
-				const legacyScope = typeof stream.getAuthScope === "function" ? stream.getAuthScope() : void 0;
-				const accountScope = identity?.userId && streamBaseUrl ? JSON.stringify([streamBaseUrl, identity.userId]) : legacyScope !== void 0 && streamBaseUrl ? JSON.stringify([streamBaseUrl, legacyScope]) : void 0;
-				if (accountScope === void 0) invalidate(...operations);
-				else invalidateScope(accountScope, operations);
-			};
-			invalidateStream("notifications.list", "notifications.count");
-			const offNotification = stream.on("notification", () => invalidateStream("notifications.list", "notifications.count"));
-			const offUnreadCount = stream.on("unreadCount", () => invalidateStream("notifications.count"));
-			return () => {
-				offNotification();
-				offUnreadCount();
-			};
+		attachNotificationEvents(stream) {
+			if (!stream || typeof stream.use !== "function" || typeof stream.getAuthIdentity !== "function" || typeof stream.getAuthScope !== "function" || typeof stream.baseUrl !== "string") throw new CacheError("attachNotificationEvents() принимает канал itd.notifications.events");
+			invalidateNotificationStream(stream, "notifications.list", "notifications.count");
+			return stream.use(notificationMiddleware);
 		},
 		install({ operations, baseUrl, getAuthIdentity, getAuthScope }) {
 			installationSequence += 1;
-			operations.use(createTransformer(installationSequence, baseUrl, getAuthIdentity, getAuthScope));
+			operations.use(createTransformer(installationSequence, baseUrl, getAuthIdentity, getAuthScope, operations.get));
 		}
 	};
 }
 //#endregion
-export { CACHE_OPERATIONS, CacheError, CacheModes, buildCacheKey, cache, cacheOperation, isCacheOperationId };
+export { CACHE_OPERATIONS, CacheError, CacheInvalidation, CacheModes, CachePolicyKind, CachePolicyScope, buildCacheKey, cache, cacheOperation, isCacheOperationId };
 
 //# sourceMappingURL=index.js.map