@ryuzaki13/react-foundation-api 1.0.0

package/dist/persisted/cache.d.ts

@@ -0,0 +1,29 @@
+import type { PersistedCacheStrategy, PersistedCacheStrategyContext, PersistedSetQueryDataStrategyOptions } from "./types";
+/**
+ * Безопасно применяет cache strategy, если она была передана.
+ */
+export declare function applyPersistedCacheStrategy<TScope, TInput, TResult>(strategy: PersistedCacheStrategy<TScope, TInput, TResult> | null | undefined, context: PersistedCacheStrategyContext<TScope, TInput, TResult>): Promise<void>;
+/**
+ * Создаёт стратегию, инвалидирующую все query внутри одного scope.
+ *
+ * Это рекомендуемый default для ресурсов, где мутация может затронуть сразу
+ * несколько представлений данных: `list`, `latest`, `history`.
+ */
+export declare function createInvalidatePersistedScopeCacheStrategy<TScope, TInput, TResult>(): PersistedCacheStrategy<TScope, TInput, TResult>;
+/**
+ * Создаёт стратегию точечного обновления одного query через `setQueryData`.
+ *
+ * @example
+ * ```ts
+ * const strategy = createSetPersistedQueryDataCacheStrategy({
+ *   getQueryKey: ({ descriptor, scope }) => descriptor.keys.latest(scope),
+ *   update: (_, { result }) => result
+ * });
+ * ```
+ */
+export declare function createSetPersistedQueryDataCacheStrategy<TScope, TInput, TResult, TData>(options: PersistedSetQueryDataStrategyOptions<TScope, TInput, TResult, TData>): PersistedCacheStrategy<TScope, TInput, TResult>;
+/**
+ * Комбинирует несколько cache strategy в одну последовательную стратегию.
+ */
+export declare function composePersistedCacheStrategies<TScope, TInput, TResult>(...strategies: Array<PersistedCacheStrategy<TScope, TInput, TResult> | null | undefined>): PersistedCacheStrategy<TScope, TInput, TResult>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/persisted/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/persisted/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,oCAAoC,EAAE,MAAM,SAAS,CAAC;AAE3H;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EACxE,QAAQ,EAAE,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAC5E,OAAO,EAAE,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,iBAG/D;AAED;;;;;GAKG;AACH,wBAAgB,2CAA2C,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAMtI;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wCAAwC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EACtF,OAAO,EAAE,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,GAC3E,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAQjD;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EACtE,GAAG,UAAU,EAAE,KAAK,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GACtF,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAQjD"}

package/dist/persisted/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Внутренний infrastructural-модуль для persisted ресурсов.
+ *
+ * Этот слой собирает повторяющуюся механику вокруг API сохранённых записей:
+ * - JSON payload codec;
+ * - фабрики query key;
+ * - capability-based descriptor ресурса;
+ * - адаптеры под OData и REST;
+ * - общие query/mutation-хуки;
+ * - стратегии синхронизации react-query кэша.
+ *
+ * Модуль не содержит доменной бизнес-логики и не знает ничего про конкретные
+ * сущности вроде variant, view-config или preset.
+ */
+export * from "./cache";
+export * from "./keys";
+export * from "./odata";
+export * from "./payload";
+export * from "./resource";
+export * from "./rest";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/persisted/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persisted/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/persisted/index.js

@@ -0,0 +1,339 @@
+import { httpFetchPayload as e } from "../http/index.js";
+import { r as t } from "../chunks/odataFetchFn-BXVJxOou.js";
+import { createResourceKeys as n } from "../resource/index.js";
+import { queryOptions as r, useMutation as i, useQuery as a, useQueryClient as o } from "@tanstack/react-query";
+//#region src/persisted/cache.ts
+async function s(e, t) {
+	await e?.onSuccess?.(t);
+}
+function c() {
+	return { onSuccess: async ({ client: e, descriptor: t, scope: n }) => {
+		await e.invalidateQueries({ queryKey: t.keys.scope(n) });
+	} };
+}
+function l(e) {
+	return { onSuccess: ({ client: t, ...n }) => {
+		t.setQueryData(e.getQueryKey({
+			client: t,
+			...n
+		}), (r) => e.update(r, {
+			client: t,
+			...n
+		}));
+	} };
+}
+function u(...e) {
+	return { onSuccess: async (t) => {
+		for (let n of e) await n?.onSuccess?.(t);
+	} };
+}
+//#endregion
+//#region src/persisted/keys.ts
+function d(e) {
+	let t = n(e);
+	return {
+		...t,
+		list: (e) => t.operation("list", e),
+		latest: (e) => t.operation("latest", e),
+		history: (e, n) => t.operation("history", e, n),
+		save: (e) => t.operation("save", e),
+		create: (e) => t.operation("create", e),
+		delete: (e) => t.operation("delete", e)
+	};
+}
+//#endregion
+//#region src/persisted/odata.ts
+async function f(e, n, r, i) {
+	if (i) return await i(e, n, r);
+	switch (e) {
+		case "query": return await t("query", n)(r);
+		case "create": return await t("create", n)(r);
+		case "update": return await t("update", n)(r);
+		case "delete": return await t("delete", n)(r);
+		case "read": return await t("read", n)(r);
+		case "fi": return await t("fi", n)(r);
+	}
+}
+function p(e) {
+	return {
+		isEnabled: e.isEnabled,
+		staleTime: e.staleTime,
+		gcTime: e.gcTime,
+		meta: e.meta,
+		execute: async ({ scope: t, args: n, client: r, signal: i }) => {
+			let a = await f("query", {
+				odata: e.odata,
+				params: e.buildParams?.(t, n),
+				options: {
+					baseUrl: e.baseUrl,
+					...e.buildOptions?.(t, n)
+				},
+				init: e.buildInit?.(t, n)
+			}, {
+				client: r,
+				signal: i
+			}, e.executor);
+			return e.transform ? e.transform(a.data, {
+				scope: t,
+				args: n
+			}) : a.data;
+		}
+	};
+}
+function m(e) {
+	return {
+		isEnabled: e.isEnabled,
+		staleTime: e.staleTime,
+		gcTime: e.gcTime,
+		meta: e.meta,
+		execute: async ({ scope: t, args: n, client: r, signal: i }) => {
+			let a = await f("read", {
+				odata: e.odata,
+				params: e.buildParams?.(t, n),
+				options: {
+					baseUrl: e.baseUrl,
+					...e.buildOptions?.(t, n)
+				},
+				init: e.buildInit?.(t, n)
+			}, {
+				client: r,
+				signal: i
+			}, e.executor);
+			return e.transform ? e.transform(a.data, {
+				scope: t,
+				args: n
+			}) : a.data;
+		}
+	};
+}
+function h(e) {
+	return {
+		cacheStrategy: e.cacheStrategy,
+		execute: async ({ scope: t, input: n, client: r }) => {
+			let i = e.method === "delete" ? await f(e.method, {
+				odata: e.odata,
+				params: e.buildParams(t, n),
+				options: {
+					baseUrl: e.baseUrl,
+					...e.buildOptions?.(t, n)
+				},
+				init: e.buildInit?.(t, n)
+			}, { client: r }, e.executor) : e.method === "update" ? await f(e.method, {
+				odata: e.odata,
+				params: e.buildParams(t, n),
+				body: e.bodyMapper(t, n),
+				options: {
+					baseUrl: e.baseUrl,
+					...e.buildOptions?.(t, n)
+				},
+				init: e.buildInit?.(t, n)
+			}, { client: r }, e.executor) : await f(e.method, {
+				odata: e.odata,
+				body: e.bodyMapper(t, n),
+				options: {
+					baseUrl: e.baseUrl,
+					...e.buildOptions?.(t, n)
+				},
+				init: e.buildInit?.(t, n)
+			}, { client: r }, e.executor);
+			return e.transform ? e.transform(i.data, {
+				scope: t,
+				input: n
+			}) : i.data;
+		}
+	};
+}
+//#endregion
+//#region src/persisted/payload.ts
+function g(e) {
+	if (!e) return null;
+	try {
+		return JSON.parse(e);
+	} catch {
+		return null;
+	}
+}
+function _(e) {
+	return JSON.stringify(e);
+}
+function v() {
+	return {
+		parse: g,
+		stringify: _
+	};
+}
+//#endregion
+//#region src/persisted/resource.ts
+function y(e, t) {
+	if (t != null && (e.isEnabled?.(t) ?? !0)) return t;
+	throw Error(e.getScopeError?.(t) ?? "Недостаточно данных scope для persisted-record ресурса.");
+}
+function b(e, t) {
+	let n = e.transport[t];
+	if (!n) throw Error(`Persisted-record ресурс '${e.resource}' не поддерживает операцию '${t}'.`);
+	return n;
+}
+function x(e, t) {
+	let n = e.transport[t];
+	if (!n) throw Error(`Persisted-record ресурс '${e.resource}' не поддерживает операцию '${t}'.`);
+	return n;
+}
+function S(e, t, n, r) {
+	return e.keys.operation(t, n, r);
+}
+function C(e, t, n, r) {
+	return e.isEnabled?.(n) ?? !0 ? t.isEnabled?.(n, r) ?? !0 : !1;
+}
+function w(e, t, n, i) {
+	let a = b(e, t), o = C(e, a, n, i);
+	return r({
+		queryKey: S(e, t, n, i),
+		queryFn: ({ client: t, signal: r }) => {
+			let o = y(e, n);
+			return a.execute({
+				scope: o,
+				args: i,
+				client: t,
+				signal: r
+			});
+		},
+		enabled: o,
+		staleTime: a.staleTime,
+		gcTime: a.gcTime,
+		meta: a.meta
+	});
+}
+function T(e, t, n, r) {
+	return a(w(e, t, n, r));
+}
+async function E(e, t, n, r, i) {
+	return await i.fetchQuery(w(e, t, n, r));
+}
+function D(e, t, n, r) {
+	let a = o(), c = x(e, t);
+	return i({
+		mutationKey: S(e, t, n),
+		mutationFn: async (t) => {
+			let r = y(e, n);
+			return await c.execute({
+				scope: r,
+				input: t,
+				client: a
+			});
+		},
+		onSuccess: async (t, i) => {
+			let o = y(e, n);
+			await s(r?.cacheStrategy === void 0 ? c.cacheStrategy : r.cacheStrategy, {
+				client: a,
+				descriptor: e,
+				scope: o,
+				input: i,
+				result: t
+			}), await r?.onSuccess?.(t, i);
+		}
+	});
+}
+function O(e) {
+	return {
+		namespace: e.namespace,
+		resource: e.resource,
+		keys: d({
+			namespace: e.namespace,
+			resource: e.resource,
+			normalizeScope: e.normalizeScope
+		}),
+		transport: e.transport,
+		isEnabled: e.isEnabled,
+		getScopeError: e.getScopeError
+	};
+}
+function k(e, t) {
+	return T(e, "list", t, void 0);
+}
+function A(e, t) {
+	return T(e, "latest", t, void 0);
+}
+function j(e, t, n) {
+	return T(e, "history", t, n);
+}
+async function M(e, t, n) {
+	return await E(e, "list", t, void 0, n);
+}
+async function N(e, t, n) {
+	return await E(e, "latest", t, void 0, n);
+}
+async function P(e, t, n, r) {
+	return await E(e, "history", t, n, r);
+}
+function F(e, t, n) {
+	return D(e, "save", t, n);
+}
+function I(e, t, n) {
+	return D(e, "create", t, n);
+}
+function L(e, t, n) {
+	return D(e, "delete", t, n);
+}
+//#endregion
+//#region src/persisted/rest.ts
+async function R(t, n) {
+	if (n.executor) return await n.executor(t);
+	if (!n.parseResponse) throw Error("REST persisted operation requires executor or parseResponse.");
+	let r = await e(t.url, {
+		baseUrl: t.baseUrl,
+		init: t.init
+	});
+	return n.parseResponse(r);
+}
+function z(e) {
+	return {
+		isEnabled: e.isEnabled,
+		staleTime: e.staleTime,
+		gcTime: e.gcTime,
+		execute: async ({ scope: t, args: n, signal: r }) => {
+			let i = await R({
+				url: e.buildUrl(t, n),
+				baseUrl: e.baseUrl,
+				init: {
+					...e.buildInit?.(t, n),
+					signal: r
+				}
+			}, {
+				executor: e.executor,
+				parseResponse: e.parseResponse
+			});
+			return "transform" in e ? e.transform(i, {
+				scope: t,
+				args: n
+			}) : i;
+		}
+	};
+}
+function B(e) {
+	return {
+		cacheStrategy: e.cacheStrategy,
+		execute: async ({ scope: t, input: n }) => {
+			let r = e.bodyMapper?.(t, n), i = await R({
+				url: e.buildUrl(t, n),
+				baseUrl: e.baseUrl,
+				init: {
+					method: e.method,
+					headers: r === void 0 ? void 0 : { "Content-Type": "application/json" },
+					...e.buildInit?.(t, n),
+					body: r === void 0 ? void 0 : JSON.stringify(r)
+				}
+			}, {
+				executor: e.executor,
+				parseResponse: e.parseResponse
+			});
+			return "transform" in e ? e.transform(i, {
+				scope: t,
+				input: n
+			}) : i;
+		}
+	};
+}
+//#endregion
+export { s as applyPersistedCacheStrategy, u as composePersistedCacheStrategies, c as createInvalidatePersistedScopeCacheStrategy, v as createPersistedJsonCodec, h as createPersistedODataMutationOperation, p as createPersistedODataQueryOperation, m as createPersistedODataReadOperation, d as createPersistedRecordKeys, O as createPersistedResourceDescriptor, B as createPersistedRestMutationOperation, z as createPersistedRestQueryOperation, l as createSetPersistedQueryDataCacheStrategy, P as getPersistedHistoryData, N as getPersistedLatestData, M as getPersistedListData, g as parsePersistedJson, _ as stringifyPersistedJson, I as usePersistedCreateMutation, L as usePersistedDeleteMutation, j as usePersistedHistoryQuery, A as usePersistedLatestQuery, k as usePersistedListQuery, F as usePersistedSaveMutation };
+
+//# sourceMappingURL=index.js.map

package/dist/persisted/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/persisted/cache.ts","../../src/persisted/keys.ts","../../src/persisted/odata.ts","../../src/persisted/payload.ts","../../src/persisted/resource.ts","../../src/persisted/rest.ts"],"sourcesContent":["import type { PersistedCacheStrategy, PersistedCacheStrategyContext, PersistedSetQueryDataStrategyOptions } from \"./types\";\n\n/**\n * Безопасно применяет cache strategy, если она была передана.\n */\nexport async function applyPersistedCacheStrategy<TScope, TInput, TResult>(\n\tstrategy: PersistedCacheStrategy<TScope, TInput, TResult> | null | undefined,\n\tcontext: PersistedCacheStrategyContext<TScope, TInput, TResult>\n) {\n\tawait strategy?.onSuccess?.(context);\n}\n\n/**\n * Создаёт стратегию, инвалидирующую все query внутри одного scope.\n *\n * Это рекомендуемый default для ресурсов, где мутация может затронуть сразу\n * несколько представлений данных: `list`, `latest`, `history`.\n */\nexport function createInvalidatePersistedScopeCacheStrategy<TScope, TInput, TResult>(): PersistedCacheStrategy<TScope, TInput, TResult> {\n\treturn {\n\t\tonSuccess: async ({ client, descriptor, scope }) => {\n\t\t\tawait client.invalidateQueries({ queryKey: descriptor.keys.scope(scope) });\n\t\t}\n\t};\n}\n\n/**\n * Создаёт стратегию точечного обновления одного query через `setQueryData`.\n *\n * @example\n * ```ts\n * const strategy = createSetPersistedQueryDataCacheStrategy({\n *   getQueryKey: ({ descriptor, scope }) => descriptor.keys.latest(scope),\n *   update: (_, { result }) => result\n * });\n * ```\n */\nexport function createSetPersistedQueryDataCacheStrategy<TScope, TInput, TResult, TData>(\n\toptions: PersistedSetQueryDataStrategyOptions<TScope, TInput, TResult, TData>\n): PersistedCacheStrategy<TScope, TInput, TResult> {\n\treturn {\n\t\tonSuccess: ({ client, ...context }) => {\n\t\t\tclient.setQueryData<TData>(options.getQueryKey({ client, ...context }), (current) =>\n\t\t\t\toptions.update(current, { client, ...context })\n\t\t\t);\n\t\t}\n\t};\n}\n\n/**\n * Комбинирует несколько cache strategy в одну последовательную стратегию.\n */\nexport function composePersistedCacheStrategies<TScope, TInput, TResult>(\n\t...strategies: Array<PersistedCacheStrategy<TScope, TInput, TResult> | null | undefined>\n): PersistedCacheStrategy<TScope, TInput, TResult> {\n\treturn {\n\t\tonSuccess: async (context) => {\n\t\t\tfor (const strategy of strategies) {\n\t\t\t\tawait strategy?.onSuccess?.(context);\n\t\t\t}\n\t\t}\n\t};\n}\n","import { createResourceKeys } from \"../resource\";\n\nimport type { PersistedOperationName, PersistedRecordKeys } from \"./types\";\n\n/**\n * Создаёт фабрики query key для persisted-record ресурса.\n *\n * @example\n * ```ts\n * const keys = createPersistedRecordKeys<{ appId: string; viewId: string }>({\n *   namespace: \"viewConfig\",\n *   resource: \"view\"\n * });\n *\n * keys.latest({ appId: \"APP\", viewId: \"MAIN\" });\n * // => [\"viewConfig\", \"view\", { appId: \"sales\", viewId: \"CumulativeShipment\" }, \"latest\"]\n * ```\n */\nexport function createPersistedRecordKeys<TScope>(options: {\n\tnamespace: string;\n\tresource: string;\n\tnormalizeScope?: (scope: TScope | null | undefined) => unknown;\n}): PersistedRecordKeys<TScope> {\n\tconst keys = createResourceKeys<TScope, PersistedOperationName>(options);\n\n\treturn {\n\t\t...keys,\n\t\tlist: (value) => keys.operation(\"list\", value),\n\t\tlatest: (value) => keys.operation(\"latest\", value),\n\t\thistory: (value, args) => keys.operation(\"history\", value, args),\n\t\tsave: (value) => keys.operation(\"save\", value),\n\t\tcreate: (value) => keys.operation(\"create\", value),\n\t\tdelete: (value) => keys.operation(\"delete\", value)\n\t};\n}\n","import { type ODataFetchFnRequest, type ODataFetchOptions } from \"../odata\";\nimport { odataFetchFn } from \"../odata/odataFetchFn\";\nimport { BaseURLType } from \"../odata/transport\";\n\nimport { PersistedMutationOperation, PersistedQueryOperation } from \"./types\";\n\nimport type { ODataOperationMethod, ODataServiceConfig, WrappedODataParameters } from \"@ryuzaki13/react-foundation-lib/odata-service\";\nimport type { QueryClient, QueryMeta } from \"@tanstack/react-query\";\n\n/**\n * Полная сигнатура конфигурации `odataQueryFn`.\n */\ntype PersistedODataEntity<TData> = TData extends (infer TItem)[] ? TItem : TData;\ntype PersistedODataRequest<\n\tTMethod extends ODataOperationMethod,\n\tTBody = unknown,\n\tTResponse = TBody,\n\tTEntity = PersistedODataEntity<TResponse>\n> = TMethod extends \"query\"\n\t? ODataFetchFnRequest<\"query\", TEntity, TEntity, TEntity>\n\t: TMethod extends \"create\"\n\t\t? ODataFetchFnRequest<\"create\", TResponse, TResponse, TBody>\n\t\t: TMethod extends \"update\"\n\t\t\t? ODataFetchFnRequest<\"update\", TResponse, TResponse, TBody>\n\t\t\t: TMethod extends \"delete\"\n\t\t\t\t? ODataFetchFnRequest<\"delete\", TResponse, TResponse, TEntity>\n\t\t\t\t: TMethod extends \"read\"\n\t\t\t\t\t? ODataFetchFnRequest<\"read\", TResponse, TResponse, TEntity>\n\t\t\t\t\t: TMethod extends \"fi\"\n\t\t\t\t\t\t? ODataFetchFnRequest<\"fi\", TResponse, TResponse, TEntity>\n\t\t\t\t\t\t: never;\n\n/**\n * Контекст низкоуровневого OData executor.\n */\ninterface PersistedODataExecutorContext {\n\tclient: QueryClient;\n\tsignal?: AbortSignal;\n}\n\n/**\n * Низкоуровневая функция выполнения OData-запроса.\n *\n * По умолчанию используется сам `odataQueryFn`, но в тестах или особых\n * сценариях executor можно подменить.\n */\ntype PersistedODataExecutor<TMethod extends ODataOperationMethod, TBody, TResponse> = (\n\tmethod: TMethod,\n\trequest: PersistedODataRequest<TMethod, TBody, TResponse, PersistedODataEntity<TResponse>>,\n\tcontext: PersistedODataExecutorContext\n) => Promise<{ data: TResponse; totalCount?: number }>;\n\n/**\n * Опции для создания OData query-операции.\n */\ninterface PersistedODataReadOperationOptions<TScope, TArgs, TResponse, TResult> {\n\todata: ODataServiceConfig;\n\tbaseUrl?: BaseURLType;\n\tbuildParams?: (scope: TScope, args: TArgs) => WrappedODataParameters;\n\tbuildOptions?: (scope: TScope, args: TArgs) => ODataFetchOptions<PersistedODataEntity<TResponse>> | undefined;\n\tbuildInit?: (scope: TScope, args: TArgs) => Omit<RequestInit, \"signal\" | \"method\" | \"body\">;\n\ttransform?: (data: TResponse, context: { scope: TScope; args: TArgs }) => TResult;\n\texecutor?: PersistedODataExecutor<\"query\" | \"read\", PersistedODataEntity<TResponse>, TResponse>;\n\tstaleTime?: number;\n\tgcTime?: number;\n\tmeta?: QueryMeta;\n\tisEnabled?: (scope: TScope | null | undefined, args: TArgs) => boolean;\n}\n\n/**\n * Опции для создания OData mutation-операции.\n */\ninterface PersistedODataWriteOperationSharedOptions<TScope, TInput, TResponse, TResult> {\n\todata: ODataServiceConfig;\n\tbaseUrl?: BaseURLType;\n\tbuildOptions?: (scope: TScope, input: TInput) => ODataFetchOptions<PersistedODataEntity<TResponse>> | undefined;\n\tbuildInit?: (scope: TScope, input: TInput) => Omit<RequestInit, \"signal\" | \"method\" | \"body\">;\n\ttransform?: (data: TResponse, context: { scope: TScope; input: TInput }) => TResult;\n\tcacheStrategy?: PersistedMutationOperation<TScope, TInput, TResult>[\"cacheStrategy\"];\n}\n\ntype PersistedODataCreateOperationOptions<TScope, TInput, TBody, TResponse, TResult> = PersistedODataWriteOperationSharedOptions<\n\tTScope,\n\tTInput,\n\tTResponse,\n\tTResult\n> & {\n\tmethod: \"create\";\n\tbuildParams?: never;\n\tbodyMapper: (scope: TScope, input: TInput) => TBody;\n\texecutor?: PersistedODataExecutor<\"create\", TBody, TResponse>;\n};\n\ntype PersistedODataUpdateOperationOptions<TScope, TInput, TBody, TResponse, TResult> = PersistedODataWriteOperationSharedOptions<\n\tTScope,\n\tTInput,\n\tTResponse,\n\tTResult\n> & {\n\tmethod: \"update\";\n\tbuildParams: (scope: TScope, input: TInput) => WrappedODataParameters;\n\tbodyMapper: (scope: TScope, input: TInput) => TBody;\n\texecutor?: PersistedODataExecutor<\"update\", TBody, TResponse>;\n};\n\ntype PersistedODataDeleteOperationOptions<TScope, TInput, TResponse, TResult> = PersistedODataWriteOperationSharedOptions<\n\tTScope,\n\tTInput,\n\tTResponse,\n\tTResult\n> & {\n\tmethod: \"delete\";\n\tbuildParams: (scope: TScope, input: TInput) => WrappedODataParameters;\n\tbodyMapper?: never;\n\texecutor?: PersistedODataExecutor<\"delete\", never, TResponse>;\n};\n\ntype PersistedODataWriteOperationOptions<TScope, TInput, TBody, TResponse, TResult> =\n\t| PersistedODataCreateOperationOptions<TScope, TInput, TBody, TResponse, TResult>\n\t| PersistedODataUpdateOperationOptions<TScope, TInput, TBody, TResponse, TResult>\n\t| PersistedODataDeleteOperationOptions<TScope, TInput, TResponse, TResult>;\n\n/**\n * Выполняет OData-запрос через переданный executor или через дефолтный `odataQueryFn`.\n */\nasync function executePersistedOData<TMethod extends ODataOperationMethod, TBody, TResponse>(\n\tmethod: TMethod,\n\trequest: PersistedODataRequest<TMethod, TBody, TResponse, PersistedODataEntity<TResponse>>,\n\tcontext: PersistedODataExecutorContext,\n\texecutor?: PersistedODataExecutor<TMethod, TBody, TResponse>\n) {\n\tif (executor) {\n\t\treturn await executor(method, request, context);\n\t}\n\n\tswitch (method) {\n\t\tcase \"query\": {\n\t\t\tconst response = await odataFetchFn<PersistedODataEntity<TResponse>, PersistedODataEntity<TResponse>>(\n\t\t\t\t\"query\",\n\t\t\t\trequest as ODataFetchFnRequest<\n\t\t\t\t\t\"query\",\n\t\t\t\t\tPersistedODataEntity<TResponse>,\n\t\t\t\t\tPersistedODataEntity<TResponse>,\n\t\t\t\t\tPersistedODataEntity<TResponse>\n\t\t\t\t> & {\n\t\t\t\t\ttransform?: undefined;\n\t\t\t\t}\n\t\t\t)(context);\n\n\t\t\treturn response as unknown as {\n\t\t\t\tdata: TResponse;\n\t\t\t\ttotalCount?: number;\n\t\t\t};\n\t\t}\n\t\tcase \"create\": {\n\t\t\tconst response = await odataFetchFn<TResponse, TBody, \"create\">(\n\t\t\t\t\"create\",\n\t\t\t\trequest as ODataFetchFnRequest<\"create\", TResponse, TResponse, TBody> & {\n\t\t\t\t\ttransform?: undefined;\n\t\t\t\t}\n\t\t\t)(context);\n\n\t\t\treturn response as unknown as {\n\t\t\t\tdata: TResponse;\n\t\t\t\ttotalCount?: number;\n\t\t\t};\n\t\t}\n\t\tcase \"update\": {\n\t\t\tconst response = await odataFetchFn<TResponse, TBody, \"update\">(\n\t\t\t\t\"update\",\n\t\t\t\trequest as ODataFetchFnRequest<\"update\", TResponse, TResponse, TBody> & {\n\t\t\t\t\ttransform?: undefined;\n\t\t\t\t}\n\t\t\t)(context);\n\n\t\t\treturn response as unknown as {\n\t\t\t\tdata: TResponse;\n\t\t\t\ttotalCount?: number;\n\t\t\t};\n\t\t}\n\t\tcase \"delete\": {\n\t\t\tconst response = await odataFetchFn<TResponse, PersistedODataEntity<TResponse>, \"delete\">(\n\t\t\t\t\"delete\",\n\t\t\t\trequest as ODataFetchFnRequest<\"delete\", TResponse, TResponse, PersistedODataEntity<TResponse>> & {\n\t\t\t\t\ttransform?: undefined;\n\t\t\t\t}\n\t\t\t)(context);\n\n\t\t\treturn response as unknown as {\n\t\t\t\tdata: TResponse;\n\t\t\t\ttotalCount?: number;\n\t\t\t};\n\t\t}\n\t\tcase \"read\": {\n\t\t\tconst response = await odataFetchFn<TResponse, PersistedODataEntity<TResponse>, \"read\">(\n\t\t\t\t\"read\",\n\t\t\t\trequest as ODataFetchFnRequest<\"read\", TResponse, TResponse, PersistedODataEntity<TResponse>> & {\n\t\t\t\t\ttransform?: undefined;\n\t\t\t\t}\n\t\t\t)(context);\n\n\t\t\treturn response as unknown as {\n\t\t\t\tdata: TResponse;\n\t\t\t\ttotalCount?: number;\n\t\t\t};\n\t\t}\n\t\tcase \"fi\": {\n\t\t\tconst response = await odataFetchFn<TResponse, PersistedODataEntity<TResponse>, \"fi\">(\n\t\t\t\t\"fi\",\n\t\t\t\trequest as ODataFetchFnRequest<\"fi\", TResponse, TResponse, PersistedODataEntity<TResponse>> & {\n\t\t\t\t\ttransform?: undefined;\n\t\t\t\t}\n\t\t\t)(context);\n\n\t\t\treturn response as unknown as {\n\t\t\t\tdata: TResponse;\n\t\t\t\ttotalCount?: number;\n\t\t\t};\n\t\t}\n\t}\n}\n\n/**\n * Создаёт query-операцию поверх OData transport.\n *\n * @example\n * ```ts\n * const latestOperation = createPersistedODataQueryOperation({\n *   odata: { service: \"TEXT_CONFIG_SRV\", target: \"TEXT_CONFIG_LATEST\" },\n *   buildOptions: (scope) => ({\n *     expression: buildScopeFilters(scope)\n *   }),\n *   transform: (rows) => parsePersistedJson(rows[0]?.payload)\n * });\n * ```\n */\nexport function createPersistedODataQueryOperation<TScope, TArgs, TResponse, TResult = TResponse>(\n\toptions: PersistedODataReadOperationOptions<TScope, TArgs, TResponse, TResult>\n): PersistedQueryOperation<TScope, TArgs, TResult> {\n\treturn {\n\t\tisEnabled: options.isEnabled,\n\t\tstaleTime: options.staleTime,\n\t\tgcTime: options.gcTime,\n\t\tmeta: options.meta,\n\t\texecute: async ({ scope, args, client, signal }) => {\n\t\t\tconst response = await executePersistedOData<\"query\", PersistedODataEntity<TResponse>, TResponse>(\n\t\t\t\t\"query\",\n\t\t\t\t{\n\t\t\t\t\todata: options.odata,\n\t\t\t\t\tparams: options.buildParams?.(scope, args),\n\t\t\t\t\toptions: {\n\t\t\t\t\t\tbaseUrl: options.baseUrl,\n\t\t\t\t\t\t...options.buildOptions?.(scope, args)\n\t\t\t\t\t},\n\t\t\t\t\tinit: options.buildInit?.(scope, args)\n\t\t\t\t} as PersistedODataRequest<\"query\", PersistedODataEntity<TResponse>, TResponse>,\n\t\t\t\t{ client, signal },\n\t\t\t\toptions.executor\n\t\t\t);\n\n\t\t\tif (options.transform) {\n\t\t\t\treturn options.transform(response.data, { scope, args });\n\t\t\t}\n\n\t\t\treturn response.data as unknown as TResult;\n\t\t}\n\t};\n}\n\nexport function createPersistedODataReadOperation<TScope, TArgs, TResponse, TResult = TResponse>(\n\toptions: PersistedODataReadOperationOptions<TScope, TArgs, TResponse, TResult>\n): PersistedQueryOperation<TScope, TArgs, TResult> {\n\treturn {\n\t\tisEnabled: options.isEnabled,\n\t\tstaleTime: options.staleTime,\n\t\tgcTime: options.gcTime,\n\t\tmeta: options.meta,\n\t\texecute: async ({ scope, args, client, signal }) => {\n\t\t\tconst response = await executePersistedOData<\"read\", PersistedODataEntity<TResponse>, TResponse>(\n\t\t\t\t\"read\",\n\t\t\t\t{\n\t\t\t\t\todata: options.odata,\n\t\t\t\t\tparams: options.buildParams?.(scope, args),\n\t\t\t\t\toptions: {\n\t\t\t\t\t\tbaseUrl: options.baseUrl,\n\t\t\t\t\t\t...options.buildOptions?.(scope, args)\n\t\t\t\t\t},\n\t\t\t\t\tinit: options.buildInit?.(scope, args)\n\t\t\t\t} as PersistedODataRequest<\"read\", PersistedODataEntity<TResponse>, TResponse>,\n\t\t\t\t{ client, signal },\n\t\t\t\toptions.executor\n\t\t\t);\n\n\t\t\tif (options.transform) {\n\t\t\t\treturn options.transform(response.data, { scope, args });\n\t\t\t}\n\n\t\t\treturn response.data as unknown as TResult;\n\t\t}\n\t};\n}\n\n/**\n * Создаёт mutation-операцию поверх OData transport.\n *\n * @example\n * ```ts\n * const saveOperation = createPersistedODataMutationOperation({\n *   odata: { service: \"TEXT_CONFIG_SRV\", target: \"TEXT_VARIANT\" },\n *   method: \"PUT\",\n *   buildParams: (_, input) => ({\n *     variantId: { value: input.variantId }\n *   }),\n *   bodyMapper: (_, input) => input\n * });\n * ```\n */\nexport function createPersistedODataMutationOperation<TScope, TInput, TResponse, TResult = TResponse, TBody = unknown>(\n\toptions: PersistedODataWriteOperationOptions<TScope, TInput, TBody, TResponse, TResult>\n): PersistedMutationOperation<TScope, TInput, TResult> {\n\treturn {\n\t\tcacheStrategy: options.cacheStrategy,\n\t\texecute: async ({ scope, input, client }) => {\n\t\t\tconst response =\n\t\t\t\toptions.method === \"delete\"\n\t\t\t\t\t? await executePersistedOData<\"delete\", never, TResponse>(\n\t\t\t\t\t\t\toptions.method,\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\todata: options.odata,\n\t\t\t\t\t\t\t\tparams: options.buildParams(scope, input),\n\t\t\t\t\t\t\t\toptions: {\n\t\t\t\t\t\t\t\t\tbaseUrl: options.baseUrl,\n\t\t\t\t\t\t\t\t\t...options.buildOptions?.(scope, input)\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tinit: options.buildInit?.(scope, input)\n\t\t\t\t\t\t\t} as PersistedODataRequest<\"delete\", never, TResponse, PersistedODataEntity<TResponse>>,\n\t\t\t\t\t\t\t{ client },\n\t\t\t\t\t\t\toptions.executor\n\t\t\t\t\t\t)\n\t\t\t\t\t: options.method === \"update\"\n\t\t\t\t\t\t? await executePersistedOData<\"update\", TBody, TResponse>(\n\t\t\t\t\t\t\t\toptions.method,\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\todata: options.odata,\n\t\t\t\t\t\t\t\t\tparams: options.buildParams(scope, input),\n\t\t\t\t\t\t\t\t\tbody: options.bodyMapper(scope, input),\n\t\t\t\t\t\t\t\t\toptions: {\n\t\t\t\t\t\t\t\t\t\tbaseUrl: options.baseUrl,\n\t\t\t\t\t\t\t\t\t\t...options.buildOptions?.(scope, input)\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tinit: options.buildInit?.(scope, input)\n\t\t\t\t\t\t\t\t} as PersistedODataRequest<\"update\", TBody, TResponse, PersistedODataEntity<TResponse>>,\n\t\t\t\t\t\t\t\t{ client },\n\t\t\t\t\t\t\t\toptions.executor\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: await executePersistedOData<\"create\", TBody, TResponse>(\n\t\t\t\t\t\t\t\toptions.method,\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\todata: options.odata,\n\t\t\t\t\t\t\t\t\tbody: options.bodyMapper(scope, input),\n\t\t\t\t\t\t\t\t\toptions: {\n\t\t\t\t\t\t\t\t\t\tbaseUrl: options.baseUrl,\n\t\t\t\t\t\t\t\t\t\t...options.buildOptions?.(scope, input)\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tinit: options.buildInit?.(scope, input)\n\t\t\t\t\t\t\t\t} as PersistedODataRequest<\"create\", TBody, TResponse, PersistedODataEntity<TResponse>>,\n\t\t\t\t\t\t\t\t{ client },\n\t\t\t\t\t\t\t\toptions.executor\n\t\t\t\t\t\t\t);\n\n\t\t\tif (options.transform) {\n\t\t\t\treturn options.transform(response.data, { scope, input });\n\t\t\t}\n\n\t\t\treturn response.data as unknown as TResult;\n\t\t}\n\t};\n}\n","import type { PersistedPayloadCodec } from \"./types\";\n\n/**\n * Безопасно разбирает JSON payload сохранённой записи.\n *\n * Функция намеренно принимает только строку или `null/undefined`, чтобы нельзя\n * было случайно передать в parser весь record вместо поля `payload`.\n *\n * @example\n * ```ts\n * const payload = parsePersistedJson<{ columns: string[] }>('{\"columns\":[\"A\",\"B\"]}');\n * // => { columns: [\"A\", \"B\"] }\n * ```\n */\nexport function parsePersistedJson<T>(payload: string | null | undefined): T | null {\n\tif (!payload) return null;\n\n\ttry {\n\t\treturn JSON.parse(payload) as T;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Сериализует доменную полезную нагрузку в JSON-строку.\n *\n * @example\n * ```ts\n * const raw = stringifyPersistedJson({ title: \"Demo\" });\n * // => '{\"title\":\"Demo\"}'\n * ```\n */\nexport function stringifyPersistedJson<T>(value: T): string {\n\treturn JSON.stringify(value);\n}\n\n/**\n * Возвращает готовый codec для хранения payload в виде строки JSON.\n */\nexport function createPersistedJsonCodec<T>(): PersistedPayloadCodec<T> {\n\treturn {\n\t\tparse: parsePersistedJson,\n\t\tstringify: stringifyPersistedJson\n\t};\n}\n","import { queryOptions, useMutation, useQuery, useQueryClient, type QueryClient } from \"@tanstack/react-query\";\n\nimport { applyPersistedCacheStrategy } from \"./cache\";\nimport { createPersistedRecordKeys } from \"./keys\";\n\nimport type {\n\tCreatePersistedResourceDescriptorOptions,\n\tPersistedCacheStrategy,\n\tPersistedMutationOperation,\n\tPersistedQueryOperation,\n\tPersistedReadOperationName,\n\tPersistedResourceDescriptor,\n\tPersistedTransportAdapter,\n\tPersistedWriteOperationName\n} from \"./types\";\n\n/**\n * Внутренний тип descriptor-а, гарантированно содержащего нужную read-capability.\n */\ntype ReadDescriptor<TScope, TArgs, TResult, TOperation extends PersistedReadOperationName> = PersistedResourceDescriptor<\n\tTScope,\n\tPersistedTransportAdapter<TScope> & {\n\t\t[K in TOperation]-?: PersistedQueryOperation<TScope, TArgs, TResult>;\n\t}\n>;\n\n/**\n * Внутренний тип descriptor-а, гарантированно содержащего нужную write-capability.\n */\ntype WriteDescriptor<TScope, TInput, TResult, TOperation extends PersistedWriteOperationName> = PersistedResourceDescriptor<\n\tTScope,\n\tPersistedTransportAdapter<TScope> & {\n\t\t[K in TOperation]-?: PersistedMutationOperation<TScope, TInput, TResult>;\n\t}\n>;\n\n/**\n * Дополнительные настройки доменного mutation-хука.\n */\ninterface UsePersistedMutationOptions<TScope, TInput, TResult> {\n\t/**\n\t * Позволяет переопределить стандартную cache policy descriptor-а.\n\t *\n\t * Если передать `null`, базовая strategy ресурса будет отключена.\n\t */\n\tcacheStrategy?: PersistedCacheStrategy<TScope, TInput, TResult> | null;\n\n\t/**\n\t * Доменный post-success callback, который запускается после cache strategy.\n\t */\n\tonSuccess?: (result: TResult, input: TInput) => void | Promise<void>;\n}\n\n/**\n * Проверяет валидность scope и возвращает его в суженном виде.\n */\nfunction assertPersistedScope<TScope, TTransport extends PersistedTransportAdapter<TScope>>(\n\tdescriptor: PersistedResourceDescriptor<TScope, TTransport>,\n\tscope: TScope | null | undefined\n): TScope {\n\tif (scope !== null && scope !== undefined && (descriptor.isEnabled?.(scope) ?? true)) {\n\t\treturn scope;\n\t}\n\n\tthrow new Error(descriptor.getScopeError?.(scope) ?? \"Недостаточно данных scope для persisted-record ресурса.\");\n}\n\n/**\n * Извлекает read-операцию из descriptor-а и даёт раннюю ошибку, если capability\n * не была подключена.\n */\nfunction assertReadOperation<\n\tTScope,\n\tTArgs,\n\tTResult,\n\tTOperation extends PersistedReadOperationName,\n\tTTransport extends PersistedTransportAdapter<TScope>\n>(descriptor: PersistedResourceDescriptor<TScope, TTransport>, operationName: TOperation): PersistedQueryOperation<TScope, TArgs, TResult> {\n\tconst operation = descriptor.transport[operationName];\n\tif (!operation) {\n\t\tthrow new Error(`Persisted-record ресурс '${descriptor.resource}' не поддерживает операцию '${operationName}'.`);\n\t}\n\n\treturn operation as PersistedQueryOperation<TScope, TArgs, TResult>;\n}\n\n/**\n * Извлекает write-операцию из descriptor-а и даёт раннюю ошибку, если capability\n * не была подключена.\n */\nfunction assertWriteOperation<\n\tTScope,\n\tTInput,\n\tTResult,\n\tTOperation extends PersistedWriteOperationName,\n\tTTransport extends PersistedTransportAdapter<TScope>\n>(\n\tdescriptor: PersistedResourceDescriptor<TScope, TTransport>,\n\toperationName: TOperation\n): PersistedMutationOperation<TScope, TInput, TResult> {\n\tconst operation = descriptor.transport[operationName];\n\tif (!operation) {\n\t\tthrow new Error(`Persisted-record ресурс '${descriptor.resource}' не поддерживает операцию '${operationName}'.`);\n\t}\n\n\treturn operation as PersistedMutationOperation<TScope, TInput, TResult>;\n}\n\n/**\n * Строит ключ query/mutation для конкретной операции descriptor-а.\n */\nfunction buildPersistedOperationKey<TScope, TTransport extends PersistedTransportAdapter<TScope>>(\n\tdescriptor: PersistedResourceDescriptor<TScope, TTransport>,\n\toperationName: PersistedReadOperationName | PersistedWriteOperationName,\n\tscope: TScope | null | undefined,\n\targs?: unknown\n) {\n\treturn descriptor.keys.operation(operationName, scope, args);\n}\n\n/**\n * Вычисляет итоговый `enabled` для query.\n *\n * Учитываются:\n * - общая policy descriptor-а;\n * - локальная policy самой операции.\n */\nfunction resolvePersistedQueryEnabled<TScope, TArgs>(\n\tdescriptor: PersistedResourceDescriptor<TScope>,\n\toperation: PersistedQueryOperation<TScope, TArgs, unknown>,\n\tscope: TScope | null | undefined,\n\targs: TArgs\n) {\n\tif (!(descriptor.isEnabled?.(scope) ?? true)) {\n\t\treturn false;\n\t}\n\n\treturn operation.isEnabled?.(scope, args) ?? true;\n}\n\n/**\n * Собирает `queryOptions` для read-операции descriptor-а.\n */\nfunction buildPersistedQueryOptions<TScope, TArgs, TResult, TOperation extends PersistedReadOperationName>(\n\tdescriptor: ReadDescriptor<TScope, TArgs, TResult, TOperation>,\n\toperationName: TOperation,\n\tscope: TScope | null | undefined,\n\targs: TArgs\n) {\n\tconst operation = assertReadOperation(descriptor, operationName) as PersistedQueryOperation<TScope, TArgs, TResult>;\n\tconst enabled = resolvePersistedQueryEnabled(descriptor, operation, scope, args);\n\n\treturn queryOptions({\n\t\tqueryKey: buildPersistedOperationKey(descriptor, operationName, scope, args),\n\t\tqueryFn: ({ client, signal }) => {\n\t\t\tconst resolvedScope = assertPersistedScope(descriptor, scope);\n\t\t\treturn operation.execute({ scope: resolvedScope, args, client, signal });\n\t\t},\n\t\tenabled,\n\t\tstaleTime: operation.staleTime,\n\t\tgcTime: operation.gcTime,\n\t\tmeta: operation.meta\n\t});\n}\n\n/**\n * Общий read-хук для persisted-record операций.\n */\nfunction usePersistedQuery<TScope, TArgs, TResult, TOperation extends PersistedReadOperationName>(\n\tdescriptor: ReadDescriptor<TScope, TArgs, TResult, TOperation>,\n\toperationName: TOperation,\n\tscope: TScope | null | undefined,\n\targs: TArgs\n) {\n\treturn useQuery(buildPersistedQueryOptions(descriptor, operationName, scope, args));\n}\n\n/**\n * Императивный helper для preload/prefetch сценариев через `QueryClient`.\n */\nasync function getPersistedQueryData<TScope, TArgs, TResult, TOperation extends PersistedReadOperationName>(\n\tdescriptor: ReadDescriptor<TScope, TArgs, TResult, TOperation>,\n\toperationName: TOperation,\n\tscope: TScope | null | undefined,\n\targs: TArgs,\n\tqueryClient: QueryClient\n) {\n\treturn await queryClient.fetchQuery(buildPersistedQueryOptions(descriptor, operationName, scope, args));\n}\n\n/**\n * Общий mutation-хук для persisted-record операций.\n *\n * Он выполняет transport-specific мутацию, затем применяет cache strategy и\n * только после этого запускает опциональный доменный `onSuccess`.\n */\nfunction usePersistedMutation<TScope, TInput, TResult, TOperation extends PersistedWriteOperationName>(\n\tdescriptor: WriteDescriptor<TScope, TInput, TResult, TOperation>,\n\toperationName: TOperation,\n\tscope: TScope | null | undefined,\n\toptions?: UsePersistedMutationOptions<TScope, TInput, TResult>\n) {\n\tconst client = useQueryClient();\n\tconst operation = assertWriteOperation(descriptor, operationName) as PersistedMutationOperation<TScope, TInput, TResult>;\n\n\treturn useMutation({\n\t\tmutationKey: buildPersistedOperationKey(descriptor, operationName, scope),\n\t\tmutationFn: async (input: TInput) => {\n\t\t\tconst resolvedScope = assertPersistedScope(descriptor, scope);\n\t\t\treturn await operation.execute({ scope: resolvedScope, input, client });\n\t\t},\n\t\tonSuccess: async (result, input) => {\n\t\t\tconst resolvedScope = assertPersistedScope(descriptor, scope);\n\t\t\tconst cacheStrategy = options?.cacheStrategy === undefined ? operation.cacheStrategy : options.cacheStrategy;\n\n\t\t\tawait applyPersistedCacheStrategy(cacheStrategy, {\n\t\t\t\tclient,\n\t\t\t\tdescriptor,\n\t\t\t\tscope: resolvedScope,\n\t\t\t\tinput,\n\t\t\t\tresult\n\t\t\t});\n\t\t\tawait options?.onSuccess?.(result, input);\n\t\t}\n\t});\n}\n\n/**\n * Создаёт descriptor persisted-record ресурса.\n *\n * @example\n * ```ts\n * const resource = createPersistedResourceDescriptor({\n *   namespace: \"viewConfig\",\n *   resource: \"view\",\n *   normalizeScope: (scope) => ({\n *     appId: scope?.appId?.trim() ?? \"\",\n *     viewId: scope?.viewId?.trim() ?? \"\"\n *   }),\n *   isEnabled: (scope) => Boolean(scope?.appId && scope?.viewId),\n *   transport: {\n *     latest: createPersistedODataQueryOperation({ ... })\n *   }\n * });\n * ```\n */\nexport function createPersistedResourceDescriptor<\n\tTScope,\n\tTTransport extends PersistedTransportAdapter<TScope> = PersistedTransportAdapter<TScope>\n>(options: CreatePersistedResourceDescriptorOptions<TScope, TTransport>): PersistedResourceDescriptor<TScope, TTransport> {\n\treturn {\n\t\tnamespace: options.namespace,\n\t\tresource: options.resource,\n\t\tkeys: createPersistedRecordKeys({\n\t\t\tnamespace: options.namespace,\n\t\t\tresource: options.resource,\n\t\t\tnormalizeScope: options.normalizeScope\n\t\t}),\n\t\ttransport: options.transport,\n\t\tisEnabled: options.isEnabled,\n\t\tgetScopeError: options.getScopeError\n\t};\n}\n\n/**\n * Подключает capability `list` к `useQuery`.\n */\nexport function usePersistedListQuery<TScope, TResult>(\n\tdescriptor: ReadDescriptor<TScope, void, TResult, \"list\">,\n\tscope: TScope | null | undefined\n) {\n\treturn usePersistedQuery(descriptor, \"list\", scope, undefined);\n}\n\n/**\n * Подключает capability `latest` к `useQuery`.\n */\nexport function usePersistedLatestQuery<TScope, TResult>(\n\tdescriptor: ReadDescriptor<TScope, void, TResult, \"latest\">,\n\tscope: TScope | null | undefined\n) {\n\treturn usePersistedQuery(descriptor, \"latest\", scope, undefined);\n}\n\n/**\n * Подключает capability `history` к `useQuery`.\n */\nexport function usePersistedHistoryQuery<TScope, TArgs, TResult>(\n\tdescriptor: ReadDescriptor<TScope, TArgs, TResult, \"history\">,\n\tscope: TScope | null | undefined,\n\targs: TArgs\n) {\n\treturn usePersistedQuery(descriptor, \"history\", scope, args);\n}\n\n/**\n * Императивно загружает capability `list` через `QueryClient`.\n */\nexport async function getPersistedListData<TScope, TResult>(\n\tdescriptor: ReadDescriptor<TScope, void, TResult, \"list\">,\n\tscope: TScope | null | undefined,\n\tqueryClient: QueryClient\n) {\n\treturn await getPersistedQueryData(descriptor, \"list\", scope, undefined, queryClient);\n}\n\n/**\n * Императивно загружает capability `latest` через `QueryClient`.\n */\nexport async function getPersistedLatestData<TScope, TResult>(\n\tdescriptor: ReadDescriptor<TScope, void, TResult, \"latest\">,\n\tscope: TScope | null | undefined,\n\tqueryClient: QueryClient\n) {\n\treturn await getPersistedQueryData(descriptor, \"latest\", scope, undefined, queryClient);\n}\n\n/**\n * Императивно загружает capability `history` через `QueryClient`.\n */\nexport async function getPersistedHistoryData<TScope, TArgs, TResult>(\n\tdescriptor: ReadDescriptor<TScope, TArgs, TResult, \"history\">,\n\tscope: TScope | null | undefined,\n\targs: TArgs,\n\tqueryClient: QueryClient\n) {\n\treturn await getPersistedQueryData(descriptor, \"history\", scope, args, queryClient);\n}\n\n/**\n * Подключает capability `save` к `useMutation`.\n */\nexport function usePersistedSaveMutation<TScope, TInput, TResult>(\n\tdescriptor: WriteDescriptor<TScope, TInput, TResult, \"save\">,\n\tscope: TScope | null | undefined,\n\toptions?: UsePersistedMutationOptions<TScope, TInput, TResult>\n) {\n\treturn usePersistedMutation(descriptor, \"save\", scope, options);\n}\n\n/**\n * Подключает capability `create` к `useMutation`.\n */\nexport function usePersistedCreateMutation<TScope, TInput, TResult>(\n\tdescriptor: WriteDescriptor<TScope, TInput, TResult, \"create\">,\n\tscope: TScope | null | undefined,\n\toptions?: UsePersistedMutationOptions<TScope, TInput, TResult>\n) {\n\treturn usePersistedMutation(descriptor, \"create\", scope, options);\n}\n\n/**\n * Подключает capability `delete` к `useMutation`.\n */\nexport function usePersistedDeleteMutation<TScope, TInput, TResult>(\n\tdescriptor: WriteDescriptor<TScope, TInput, TResult, \"delete\">,\n\tscope: TScope | null | undefined,\n\toptions?: UsePersistedMutationOptions<TScope, TInput, TResult>\n) {\n\treturn usePersistedMutation(descriptor, \"delete\", scope, options);\n}\n","import { httpFetchPayload } from \"../http\";\n\nimport type { PersistedMutationOperation, PersistedQueryOperation } from \"./types\";\n\n/**\n * Нормализованная форма REST-запроса, передаваемая executor-у.\n */\ninterface PersistedRestRequest {\n\turl: string;\n\tinit?: RequestInit;\n\tbaseUrl?: string;\n}\n\n/**\n * Низкоуровневый REST executor.\n *\n * Executor можно подменить в тестах и спец-сценариях. Если executor не задан,\n * адаптер использует чистый HTTP transport и требует явный parser ответа.\n */\ntype PersistedRestExecutor<TResponse> = (request: PersistedRestRequest) => Promise<TResponse>;\n\n/**\n * Parser внешнего HTTP payload. REST-слой не приводит `unknown` к доменному типу\n * самостоятельно, чтобы не маскировать контракт endpoint-а.\n */\ntype PersistedRestResponseParser<TResponse> = (payload: unknown) => TResponse;\n\n/**\n * Базовые опции для создания REST read-операции.\n */\ninterface PersistedRestReadOperationBaseOptions<TScope, TArgs, TResponse> {\n\tbaseUrl?: string;\n\tbuildUrl: (scope: TScope, args: TArgs) => string;\n\tbuildInit?: (scope: TScope, args: TArgs) => RequestInit;\n\tparseResponse?: PersistedRestResponseParser<TResponse>;\n\texecutor?: PersistedRestExecutor<TResponse>;\n\tstaleTime?: number;\n\tgcTime?: number;\n\tisEnabled?: (scope: TScope | null | undefined, args: TArgs) => boolean;\n}\n\ntype PersistedRestReadOperationOptions<TScope, TArgs, TResponse> = PersistedRestReadOperationBaseOptions<TScope, TArgs, TResponse>;\n\ntype PersistedRestMappedReadOperationOptions<TScope, TArgs, TResponse, TResult> = PersistedRestReadOperationBaseOptions<\n\tTScope,\n\tTArgs,\n\tTResponse\n> & {\n\ttransform: (data: TResponse, context: { scope: TScope; args: TArgs }) => TResult;\n};\n\n/**\n * Базовые опции для создания REST write-операции.\n */\ninterface PersistedRestWriteOperationBaseOptions<TScope, TInput, TResponse> {\n\tbaseUrl?: string;\n\tbuildUrl: (scope: TScope, input: TInput) => string;\n\tmethod: \"POST\" | \"PUT\" | \"DELETE\";\n\tbuildInit?: (scope: TScope, input: TInput) => Omit<RequestInit, \"method\" | \"body\">;\n\tbodyMapper?: (scope: TScope, input: TInput) => unknown;\n\tparseResponse?: PersistedRestResponseParser<TResponse>;\n\texecutor?: PersistedRestExecutor<TResponse>;\n}\n\ntype PersistedRestWriteOperationOptions<TScope, TInput, TResponse> = PersistedRestWriteOperationBaseOptions<TScope, TInput, TResponse> & {\n\tcacheStrategy?: PersistedMutationOperation<TScope, TInput, TResponse>[\"cacheStrategy\"];\n};\n\ntype PersistedRestMappedWriteOperationOptions<TScope, TInput, TResponse, TResult> = PersistedRestWriteOperationBaseOptions<\n\tTScope,\n\tTInput,\n\tTResponse\n> & {\n\ttransform: (data: TResponse, context: { scope: TScope; input: TInput }) => TResult;\n\tcacheStrategy?: PersistedMutationOperation<TScope, TInput, TResult>[\"cacheStrategy\"];\n};\n\n/**\n * Выполняет REST-запрос через executor или нейтральный HTTP transport.\n */\nasync function executePersistedRest<TResponse>(\n\trequest: PersistedRestRequest,\n\toptions: {\n\t\texecutor?: PersistedRestExecutor<TResponse>;\n\t\tparseResponse?: PersistedRestResponseParser<TResponse>;\n\t}\n) {\n\tif (options.executor) {\n\t\treturn await options.executor(request);\n\t}\n\n\tif (!options.parseResponse) {\n\t\tthrow new Error(\"REST persisted operation requires executor or parseResponse.\");\n\t}\n\n\tconst payload = await httpFetchPayload(request.url, {\n\t\tbaseUrl: request.baseUrl,\n\t\tinit: request.init\n\t});\n\n\treturn options.parseResponse(payload);\n}\n\n/**\n * Создаёт read-операцию поверх обычного REST endpoint.\n */\nexport function createPersistedRestQueryOperation<TScope, TArgs, TResponse>(\n\toptions: PersistedRestReadOperationOptions<TScope, TArgs, TResponse>\n): PersistedQueryOperation<TScope, TArgs, TResponse>;\n\nexport function createPersistedRestQueryOperation<TScope, TArgs, TResponse, TResult>(\n\toptions: PersistedRestMappedReadOperationOptions<TScope, TArgs, TResponse, TResult>\n): PersistedQueryOperation<TScope, TArgs, TResult>;\n\nexport function createPersistedRestQueryOperation<TScope, TArgs, TResponse, TResult>(\n\toptions:\n\t\t| PersistedRestReadOperationOptions<TScope, TArgs, TResponse>\n\t\t| PersistedRestMappedReadOperationOptions<TScope, TArgs, TResponse, TResult>\n): PersistedQueryOperation<TScope, TArgs, TResponse | TResult> {\n\treturn {\n\t\tisEnabled: options.isEnabled,\n\t\tstaleTime: options.staleTime,\n\t\tgcTime: options.gcTime,\n\t\texecute: async ({ scope, args, signal }) => {\n\t\t\tconst data = await executePersistedRest<TResponse>(\n\t\t\t\t{\n\t\t\t\t\turl: options.buildUrl(scope, args),\n\t\t\t\t\tbaseUrl: options.baseUrl,\n\t\t\t\t\tinit: {\n\t\t\t\t\t\t...options.buildInit?.(scope, args),\n\t\t\t\t\t\tsignal\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\texecutor: options.executor,\n\t\t\t\t\tparseResponse: options.parseResponse\n\t\t\t\t}\n\t\t\t);\n\n\t\t\tif (\"transform\" in options) {\n\t\t\t\treturn options.transform(data, { scope, args });\n\t\t\t}\n\n\t\t\treturn data;\n\t\t}\n\t};\n}\n\n/**\n * Создаёт write-операцию поверх обычного REST endpoint.\n *\n * @example\n * ```ts\n * const savePreset = createPersistedRestMutationOperation({\n *   buildUrl: () => \"/api/config-presets\",\n *   method: \"PUT\",\n *   bodyMapper: (scope, input) => ({\n *     userId: scope.userId,\n *     payload: input.payload\n *   })\n * });\n * ```\n */\nexport function createPersistedRestMutationOperation<TScope, TInput, TResponse>(\n\toptions: PersistedRestWriteOperationOptions<TScope, TInput, TResponse>\n): PersistedMutationOperation<TScope, TInput, TResponse>;\n\nexport function createPersistedRestMutationOperation<TScope, TInput, TResponse, TResult>(\n\toptions: PersistedRestMappedWriteOperationOptions<TScope, TInput, TResponse, TResult>\n): PersistedMutationOperation<TScope, TInput, TResult>;\n\nexport function createPersistedRestMutationOperation<TScope, TInput, TResponse, TResult>(\n\toptions:\n\t\t| PersistedRestWriteOperationOptions<TScope, TInput, TResponse>\n\t\t| PersistedRestMappedWriteOperationOptions<TScope, TInput, TResponse, TResult>\n): PersistedMutationOperation<TScope, TInput, TResponse | TResult> {\n\treturn {\n\t\tcacheStrategy: options.cacheStrategy,\n\t\texecute: async ({ scope, input }) => {\n\t\t\tconst payload = options.bodyMapper?.(scope, input);\n\t\t\tconst data = await executePersistedRest<TResponse>(\n\t\t\t\t{\n\t\t\t\t\turl: options.buildUrl(scope, input),\n\t\t\t\t\tbaseUrl: options.baseUrl,\n\t\t\t\t\tinit: {\n\t\t\t\t\t\tmethod: options.method,\n\t\t\t\t\t\theaders: payload === undefined ? undefined : { \"Content-Type\": \"application/json\" },\n\t\t\t\t\t\t...options.buildInit?.(scope, input),\n\t\t\t\t\t\tbody: payload === undefined ? undefined : JSON.stringify(payload)\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\texecutor: options.executor,\n\t\t\t\t\tparseResponse: options.parseResponse\n\t\t\t\t}\n\t\t\t);\n\n\t\t\tif (\"transform\" in options) {\n\t\t\t\treturn options.transform(data, { scope, input });\n\t\t\t}\n\n\t\t\treturn data;\n\t\t}\n\t};\n}\n"],"mappings":"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"}

package/dist/persisted/keys.d.ts

@@ -0,0 +1,21 @@
+import type { PersistedRecordKeys } from "./types";
+/**
+ * Создаёт фабрики query key для persisted-record ресурса.
+ *
+ * @example
+ * ```ts
+ * const keys = createPersistedRecordKeys<{ appId: string; viewId: string }>({
+ *   namespace: "viewConfig",
+ *   resource: "view"
+ * });
+ *
+ * keys.latest({ appId: "APP", viewId: "MAIN" });
+ * // => ["viewConfig", "view", { appId: "sales", viewId: "CumulativeShipment" }, "latest"]
+ * ```
+ */
+export declare function createPersistedRecordKeys<TScope>(options: {
+    namespace: string;
+    resource: string;
+    normalizeScope?: (scope: TScope | null | undefined) => unknown;
+}): PersistedRecordKeys<TScope>;
+//# sourceMappingURL=keys.d.ts.map

package/dist/persisted/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/persisted/keys.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA0B,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,OAAO,CAAC;CAC/D,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAY9B"}

package/dist/persisted/odata.d.ts

@@ -0,0 +1,113 @@
+import { type ODataFetchFnRequest, type ODataFetchOptions } from "../odata";
+import { BaseURLType } from "../odata/transport";
+import { PersistedMutationOperation, PersistedQueryOperation } from "./types";
+import type { ODataOperationMethod, ODataServiceConfig, WrappedODataParameters } from "@ryuzaki13/react-foundation-lib/odata-service";
+import type { QueryClient, QueryMeta } from "@tanstack/react-query";
+/**
+ * Полная сигнатура конфигурации `odataQueryFn`.
+ */
+type PersistedODataEntity<TData> = TData extends (infer TItem)[] ? TItem : TData;
+type PersistedODataRequest<TMethod extends ODataOperationMethod, TBody = unknown, TResponse = TBody, TEntity = PersistedODataEntity<TResponse>> = TMethod extends "query" ? ODataFetchFnRequest<"query", TEntity, TEntity, TEntity> : TMethod extends "create" ? ODataFetchFnRequest<"create", TResponse, TResponse, TBody> : TMethod extends "update" ? ODataFetchFnRequest<"update", TResponse, TResponse, TBody> : TMethod extends "delete" ? ODataFetchFnRequest<"delete", TResponse, TResponse, TEntity> : TMethod extends "read" ? ODataFetchFnRequest<"read", TResponse, TResponse, TEntity> : TMethod extends "fi" ? ODataFetchFnRequest<"fi", TResponse, TResponse, TEntity> : never;
+/**
+ * Контекст низкоуровневого OData executor.
+ */
+interface PersistedODataExecutorContext {
+    client: QueryClient;
+    signal?: AbortSignal;
+}
+/**
+ * Низкоуровневая функция выполнения OData-запроса.
+ *
+ * По умолчанию используется сам `odataQueryFn`, но в тестах или особых
+ * сценариях executor можно подменить.
+ */
+type PersistedODataExecutor<TMethod extends ODataOperationMethod, TBody, TResponse> = (method: TMethod, request: PersistedODataRequest<TMethod, TBody, TResponse, PersistedODataEntity<TResponse>>, context: PersistedODataExecutorContext) => Promise<{
+    data: TResponse;
+    totalCount?: number;
+}>;
+/**
+ * Опции для создания OData query-операции.
+ */
+interface PersistedODataReadOperationOptions<TScope, TArgs, TResponse, TResult> {
+    odata: ODataServiceConfig;
+    baseUrl?: BaseURLType;
+    buildParams?: (scope: TScope, args: TArgs) => WrappedODataParameters;
+    buildOptions?: (scope: TScope, args: TArgs) => ODataFetchOptions<PersistedODataEntity<TResponse>> | undefined;
+    buildInit?: (scope: TScope, args: TArgs) => Omit<RequestInit, "signal" | "method" | "body">;
+    transform?: (data: TResponse, context: {
+        scope: TScope;
+        args: TArgs;
+    }) => TResult;
+    executor?: PersistedODataExecutor<"query" | "read", PersistedODataEntity<TResponse>, TResponse>;
+    staleTime?: number;
+    gcTime?: number;
+    meta?: QueryMeta;
+    isEnabled?: (scope: TScope | null | undefined, args: TArgs) => boolean;
+}
+/**
+ * Опции для создания OData mutation-операции.
+ */
+interface PersistedODataWriteOperationSharedOptions<TScope, TInput, TResponse, TResult> {
+    odata: ODataServiceConfig;
+    baseUrl?: BaseURLType;
+    buildOptions?: (scope: TScope, input: TInput) => ODataFetchOptions<PersistedODataEntity<TResponse>> | undefined;
+    buildInit?: (scope: TScope, input: TInput) => Omit<RequestInit, "signal" | "method" | "body">;
+    transform?: (data: TResponse, context: {
+        scope: TScope;
+        input: TInput;
+    }) => TResult;
+    cacheStrategy?: PersistedMutationOperation<TScope, TInput, TResult>["cacheStrategy"];
+}
+type PersistedODataCreateOperationOptions<TScope, TInput, TBody, TResponse, TResult> = PersistedODataWriteOperationSharedOptions<TScope, TInput, TResponse, TResult> & {
+    method: "create";
+    buildParams?: never;
+    bodyMapper: (scope: TScope, input: TInput) => TBody;
+    executor?: PersistedODataExecutor<"create", TBody, TResponse>;
+};
+type PersistedODataUpdateOperationOptions<TScope, TInput, TBody, TResponse, TResult> = PersistedODataWriteOperationSharedOptions<TScope, TInput, TResponse, TResult> & {
+    method: "update";
+    buildParams: (scope: TScope, input: TInput) => WrappedODataParameters;
+    bodyMapper: (scope: TScope, input: TInput) => TBody;
+    executor?: PersistedODataExecutor<"update", TBody, TResponse>;
+};
+type PersistedODataDeleteOperationOptions<TScope, TInput, TResponse, TResult> = PersistedODataWriteOperationSharedOptions<TScope, TInput, TResponse, TResult> & {
+    method: "delete";
+    buildParams: (scope: TScope, input: TInput) => WrappedODataParameters;
+    bodyMapper?: never;
+    executor?: PersistedODataExecutor<"delete", never, TResponse>;
+};
+type PersistedODataWriteOperationOptions<TScope, TInput, TBody, TResponse, TResult> = PersistedODataCreateOperationOptions<TScope, TInput, TBody, TResponse, TResult> | PersistedODataUpdateOperationOptions<TScope, TInput, TBody, TResponse, TResult> | PersistedODataDeleteOperationOptions<TScope, TInput, TResponse, TResult>;
+/**
+ * Создаёт query-операцию поверх OData transport.
+ *
+ * @example
+ * ```ts
+ * const latestOperation = createPersistedODataQueryOperation({
+ *   odata: { service: "TEXT_CONFIG_SRV", target: "TEXT_CONFIG_LATEST" },
+ *   buildOptions: (scope) => ({
+ *     expression: buildScopeFilters(scope)
+ *   }),
+ *   transform: (rows) => parsePersistedJson(rows[0]?.payload)
+ * });
+ * ```
+ */
+export declare function createPersistedODataQueryOperation<TScope, TArgs, TResponse, TResult = TResponse>(options: PersistedODataReadOperationOptions<TScope, TArgs, TResponse, TResult>): PersistedQueryOperation<TScope, TArgs, TResult>;
+export declare function createPersistedODataReadOperation<TScope, TArgs, TResponse, TResult = TResponse>(options: PersistedODataReadOperationOptions<TScope, TArgs, TResponse, TResult>): PersistedQueryOperation<TScope, TArgs, TResult>;
+/**
+ * Создаёт mutation-операцию поверх OData transport.
+ *
+ * @example
+ * ```ts
+ * const saveOperation = createPersistedODataMutationOperation({
+ *   odata: { service: "TEXT_CONFIG_SRV", target: "TEXT_VARIANT" },
+ *   method: "PUT",
+ *   buildParams: (_, input) => ({
+ *     variantId: { value: input.variantId }
+ *   }),
+ *   bodyMapper: (_, input) => input
+ * });
+ * ```
+ */
+export declare function createPersistedODataMutationOperation<TScope, TInput, TResponse, TResult = TResponse, TBody = unknown>(options: PersistedODataWriteOperationOptions<TScope, TInput, TBody, TResponse, TResult>): PersistedMutationOperation<TScope, TInput, TResult>;
+export {};
+//# sourceMappingURL=odata.d.ts.map