@ryuzaki13/react-foundation-api 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"odata.d.ts","sourceRoot":"","sources":["../../src/persisted/odata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACtI,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;GAEG;AACH,KAAK,oBAAoB,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,KAAK,CAAC;AACjF,KAAK,qBAAqB,CACzB,OAAO,SAAS,oBAAoB,EACpC,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,IACtC,OAAO,SAAS,OAAO,GACxB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GACvD,OAAO,SAAS,QAAQ,GACvB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,GAC1D,OAAO,SAAS,QAAQ,GACvB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,GAC1D,OAAO,SAAS,QAAQ,GACvB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,GAC5D,OAAO,SAAS,MAAM,GACrB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,GAC1D,OAAO,SAAS,IAAI,GACnB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,GACxD,KAAK,CAAC;AAEd;;GAEG;AACH,UAAU,6BAA6B;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,KAAK,sBAAsB,CAAC,OAAO,SAAS,oBAAoB,EAAE,KAAK,EAAE,SAAS,IAAI,CACrF,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC,EAC1F,OAAO,EAAE,6BAA6B,KAClC,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvD;;GAEG;AACH,UAAU,kCAAkC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO;IAC7E,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,sBAAsB,CAAC;IACrE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,iBAAiB,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;IAC9G,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IAC5F,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC;IAClF,QAAQ,CAAC,EAAE,sBAAsB,CAAC,OAAO,GAAG,MAAM,EAAE,oBAAoB,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC;CACvE;AAED;;GAEG;AACH,UAAU,yCAAyC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO;IACrF,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;IAChH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IAC9F,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IACpF,aAAa,CAAC,EAAE,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC;CACrF;AAED,KAAK,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,IAAI,yCAAyC,CAC/H,MAAM,EACN,MAAM,EACN,SAAS,EACT,OAAO,CACP,GAAG;IACH,MAAM,EAAE,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;IACpD,QAAQ,CAAC,EAAE,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;CAC9D,CAAC;AAEF,KAAK,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,IAAI,yCAAyC,CAC/H,MAAM,EACN,MAAM,EACN,SAAS,EACT,OAAO,CACP,GAAG;IACH,MAAM,EAAE,QAAQ,CAAC;IACjB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,sBAAsB,CAAC;IACtE,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;IACpD,QAAQ,CAAC,EAAE,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;CAC9D,CAAC;AAEF,KAAK,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,IAAI,yCAAyC,CACxH,MAAM,EACN,MAAM,EACN,SAAS,EACT,OAAO,CACP,GAAG;IACH,MAAM,EAAE,QAAQ,CAAC;IACjB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,sBAAsB,CAAC;IACtE,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,EAAE,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;CAC9D,CAAC;AAEF,KAAK,mCAAmC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,IAC/E,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,GAC/E,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,GAC/E,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAsG5E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,EAC/F,OAAO,EAAE,kCAAkC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,GAC5E,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CA6BjD;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9F,OAAO,EAAE,kCAAkC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,GAC5E,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CA6BjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,GAAG,OAAO,EACpH,OAAO,EAAE,mCAAmC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,GACrF,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CA0DrD"}

package/dist/persisted/payload.d.ts

@@ -0,0 +1,29 @@
+import type { PersistedPayloadCodec } from "./types";
+/**
+ * Безопасно разбирает JSON payload сохранённой записи.
+ *
+ * Функция намеренно принимает только строку или `null/undefined`, чтобы нельзя
+ * было случайно передать в parser весь record вместо поля `payload`.
+ *
+ * @example
+ * ```ts
+ * const payload = parsePersistedJson<{ columns: string[] }>('{"columns":["A","B"]}');
+ * // => { columns: ["A", "B"] }
+ * ```
+ */
+export declare function parsePersistedJson<T>(payload: string | null | undefined): T | null;
+/**
+ * Сериализует доменную полезную нагрузку в JSON-строку.
+ *
+ * @example
+ * ```ts
+ * const raw = stringifyPersistedJson({ title: "Demo" });
+ * // => '{"title":"Demo"}'
+ * ```
+ */
+export declare function stringifyPersistedJson<T>(value: T): string;
+/**
+ * Возвращает готовый codec для хранения payload в виде строки JSON.
+ */
+export declare function createPersistedJsonCodec<T>(): PersistedPayloadCodec<T>;
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/persisted/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,GAAG,IAAI,CAQlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,KAAK,qBAAqB,CAAC,CAAC,CAAC,CAKtE"}

package/dist/persisted/resource.d.ts

@@ -0,0 +1,87 @@
+import { type QueryClient } from "@tanstack/react-query";
+import type { CreatePersistedResourceDescriptorOptions, PersistedCacheStrategy, PersistedMutationOperation, PersistedQueryOperation, PersistedReadOperationName, PersistedResourceDescriptor, PersistedTransportAdapter, PersistedWriteOperationName } from "./types";
+/**
+ * Внутренний тип descriptor-а, гарантированно содержащего нужную read-capability.
+ */
+type ReadDescriptor<TScope, TArgs, TResult, TOperation extends PersistedReadOperationName> = PersistedResourceDescriptor<TScope, PersistedTransportAdapter<TScope> & {
+    [K in TOperation]-?: PersistedQueryOperation<TScope, TArgs, TResult>;
+}>;
+/**
+ * Внутренний тип descriptor-а, гарантированно содержащего нужную write-capability.
+ */
+type WriteDescriptor<TScope, TInput, TResult, TOperation extends PersistedWriteOperationName> = PersistedResourceDescriptor<TScope, PersistedTransportAdapter<TScope> & {
+    [K in TOperation]-?: PersistedMutationOperation<TScope, TInput, TResult>;
+}>;
+/**
+ * Дополнительные настройки доменного mutation-хука.
+ */
+interface UsePersistedMutationOptions<TScope, TInput, TResult> {
+    /**
+     * Позволяет переопределить стандартную cache policy descriptor-а.
+     *
+     * Если передать `null`, базовая strategy ресурса будет отключена.
+     */
+    cacheStrategy?: PersistedCacheStrategy<TScope, TInput, TResult> | null;
+    /**
+     * Доменный post-success callback, который запускается после cache strategy.
+     */
+    onSuccess?: (result: TResult, input: TInput) => void | Promise<void>;
+}
+/**
+ * Создаёт descriptor persisted-record ресурса.
+ *
+ * @example
+ * ```ts
+ * const resource = createPersistedResourceDescriptor({
+ *   namespace: "viewConfig",
+ *   resource: "view",
+ *   normalizeScope: (scope) => ({
+ *     appId: scope?.appId?.trim() ?? "",
+ *     viewId: scope?.viewId?.trim() ?? ""
+ *   }),
+ *   isEnabled: (scope) => Boolean(scope?.appId && scope?.viewId),
+ *   transport: {
+ *     latest: createPersistedODataQueryOperation({ ... })
+ *   }
+ * });
+ * ```
+ */
+export declare function createPersistedResourceDescriptor<TScope, TTransport extends PersistedTransportAdapter<TScope> = PersistedTransportAdapter<TScope>>(options: CreatePersistedResourceDescriptorOptions<TScope, TTransport>): PersistedResourceDescriptor<TScope, TTransport>;
+/**
+ * Подключает capability `list` к `useQuery`.
+ */
+export declare function usePersistedListQuery<TScope, TResult>(descriptor: ReadDescriptor<TScope, void, TResult, "list">, scope: TScope | null | undefined): import("@tanstack/react-query").UseQueryResult<NoInfer<TResult>, Error>;
+/**
+ * Подключает capability `latest` к `useQuery`.
+ */
+export declare function usePersistedLatestQuery<TScope, TResult>(descriptor: ReadDescriptor<TScope, void, TResult, "latest">, scope: TScope | null | undefined): import("@tanstack/react-query").UseQueryResult<NoInfer<TResult>, Error>;
+/**
+ * Подключает capability `history` к `useQuery`.
+ */
+export declare function usePersistedHistoryQuery<TScope, TArgs, TResult>(descriptor: ReadDescriptor<TScope, TArgs, TResult, "history">, scope: TScope | null | undefined, args: TArgs): import("@tanstack/react-query").UseQueryResult<NoInfer<TResult>, Error>;
+/**
+ * Императивно загружает capability `list` через `QueryClient`.
+ */
+export declare function getPersistedListData<TScope, TResult>(descriptor: ReadDescriptor<TScope, void, TResult, "list">, scope: TScope | null | undefined, queryClient: QueryClient): Promise<TResult>;
+/**
+ * Императивно загружает capability `latest` через `QueryClient`.
+ */
+export declare function getPersistedLatestData<TScope, TResult>(descriptor: ReadDescriptor<TScope, void, TResult, "latest">, scope: TScope | null | undefined, queryClient: QueryClient): Promise<TResult>;
+/**
+ * Императивно загружает capability `history` через `QueryClient`.
+ */
+export declare function getPersistedHistoryData<TScope, TArgs, TResult>(descriptor: ReadDescriptor<TScope, TArgs, TResult, "history">, scope: TScope | null | undefined, args: TArgs, queryClient: QueryClient): Promise<TResult>;
+/**
+ * Подключает capability `save` к `useMutation`.
+ */
+export declare function usePersistedSaveMutation<TScope, TInput, TResult>(descriptor: WriteDescriptor<TScope, TInput, TResult, "save">, scope: TScope | null | undefined, options?: UsePersistedMutationOptions<TScope, TInput, TResult>): import("@tanstack/react-query").UseMutationResult<TResult, Error, TInput, unknown>;
+/**
+ * Подключает capability `create` к `useMutation`.
+ */
+export declare function usePersistedCreateMutation<TScope, TInput, TResult>(descriptor: WriteDescriptor<TScope, TInput, TResult, "create">, scope: TScope | null | undefined, options?: UsePersistedMutationOptions<TScope, TInput, TResult>): import("@tanstack/react-query").UseMutationResult<TResult, Error, TInput, unknown>;
+/**
+ * Подключает capability `delete` к `useMutation`.
+ */
+export declare function usePersistedDeleteMutation<TScope, TInput, TResult>(descriptor: WriteDescriptor<TScope, TInput, TResult, "delete">, scope: TScope | null | undefined, options?: UsePersistedMutationOptions<TScope, TInput, TResult>): import("@tanstack/react-query").UseMutationResult<TResult, Error, TInput, unknown>;
+export {};
+//# sourceMappingURL=resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/persisted/resource.ts"],"names":[],"mappings":"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"}

package/dist/persisted/rest.d.ts

@@ -0,0 +1,87 @@
+import type { PersistedMutationOperation, PersistedQueryOperation } from "./types";
+/**
+ * Нормализованная форма REST-запроса, передаваемая executor-у.
+ */
+interface PersistedRestRequest {
+    url: string;
+    init?: RequestInit;
+    baseUrl?: string;
+}
+/**
+ * Низкоуровневый REST executor.
+ *
+ * Executor можно подменить в тестах и спец-сценариях. Если executor не задан,
+ * адаптер использует чистый HTTP transport и требует явный parser ответа.
+ */
+type PersistedRestExecutor<TResponse> = (request: PersistedRestRequest) => Promise<TResponse>;
+/**
+ * Parser внешнего HTTP payload. REST-слой не приводит `unknown` к доменному типу
+ * самостоятельно, чтобы не маскировать контракт endpoint-а.
+ */
+type PersistedRestResponseParser<TResponse> = (payload: unknown) => TResponse;
+/**
+ * Базовые опции для создания REST read-операции.
+ */
+interface PersistedRestReadOperationBaseOptions<TScope, TArgs, TResponse> {
+    baseUrl?: string;
+    buildUrl: (scope: TScope, args: TArgs) => string;
+    buildInit?: (scope: TScope, args: TArgs) => RequestInit;
+    parseResponse?: PersistedRestResponseParser<TResponse>;
+    executor?: PersistedRestExecutor<TResponse>;
+    staleTime?: number;
+    gcTime?: number;
+    isEnabled?: (scope: TScope | null | undefined, args: TArgs) => boolean;
+}
+type PersistedRestReadOperationOptions<TScope, TArgs, TResponse> = PersistedRestReadOperationBaseOptions<TScope, TArgs, TResponse>;
+type PersistedRestMappedReadOperationOptions<TScope, TArgs, TResponse, TResult> = PersistedRestReadOperationBaseOptions<TScope, TArgs, TResponse> & {
+    transform: (data: TResponse, context: {
+        scope: TScope;
+        args: TArgs;
+    }) => TResult;
+};
+/**
+ * Базовые опции для создания REST write-операции.
+ */
+interface PersistedRestWriteOperationBaseOptions<TScope, TInput, TResponse> {
+    baseUrl?: string;
+    buildUrl: (scope: TScope, input: TInput) => string;
+    method: "POST" | "PUT" | "DELETE";
+    buildInit?: (scope: TScope, input: TInput) => Omit<RequestInit, "method" | "body">;
+    bodyMapper?: (scope: TScope, input: TInput) => unknown;
+    parseResponse?: PersistedRestResponseParser<TResponse>;
+    executor?: PersistedRestExecutor<TResponse>;
+}
+type PersistedRestWriteOperationOptions<TScope, TInput, TResponse> = PersistedRestWriteOperationBaseOptions<TScope, TInput, TResponse> & {
+    cacheStrategy?: PersistedMutationOperation<TScope, TInput, TResponse>["cacheStrategy"];
+};
+type PersistedRestMappedWriteOperationOptions<TScope, TInput, TResponse, TResult> = PersistedRestWriteOperationBaseOptions<TScope, TInput, TResponse> & {
+    transform: (data: TResponse, context: {
+        scope: TScope;
+        input: TInput;
+    }) => TResult;
+    cacheStrategy?: PersistedMutationOperation<TScope, TInput, TResult>["cacheStrategy"];
+};
+/**
+ * Создаёт read-операцию поверх обычного REST endpoint.
+ */
+export declare function createPersistedRestQueryOperation<TScope, TArgs, TResponse>(options: PersistedRestReadOperationOptions<TScope, TArgs, TResponse>): PersistedQueryOperation<TScope, TArgs, TResponse>;
+export declare function createPersistedRestQueryOperation<TScope, TArgs, TResponse, TResult>(options: PersistedRestMappedReadOperationOptions<TScope, TArgs, TResponse, TResult>): PersistedQueryOperation<TScope, TArgs, TResult>;
+/**
+ * Создаёт write-операцию поверх обычного REST endpoint.
+ *
+ * @example
+ * ```ts
+ * const savePreset = createPersistedRestMutationOperation({
+ *   buildUrl: () => "/api/config-presets",
+ *   method: "PUT",
+ *   bodyMapper: (scope, input) => ({
+ *     userId: scope.userId,
+ *     payload: input.payload
+ *   })
+ * });
+ * ```
+ */
+export declare function createPersistedRestMutationOperation<TScope, TInput, TResponse>(options: PersistedRestWriteOperationOptions<TScope, TInput, TResponse>): PersistedMutationOperation<TScope, TInput, TResponse>;
+export declare function createPersistedRestMutationOperation<TScope, TInput, TResponse, TResult>(options: PersistedRestMappedWriteOperationOptions<TScope, TInput, TResponse, TResult>): PersistedMutationOperation<TScope, TInput, TResult>;
+export {};
+//# sourceMappingURL=rest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../src/persisted/rest.ts"],"names":[],"mappings":"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"}

package/dist/persisted/types.d.ts

@@ -0,0 +1,172 @@
+import type { QueryClient, QueryKey, QueryMeta } from "@tanstack/react-query";
+/**
+ * Имена read-операций, которые generic-слой умеет подключать к `useQuery`.
+ */
+export type PersistedReadOperationName = "list" | "latest" | "history";
+/**
+ * Имена write-операций, которые generic-слой умеет подключать к `useMutation`.
+ */
+export type PersistedWriteOperationName = "save" | "create" | "delete";
+/**
+ * Полный набор стандартных операций persisted-record ресурса.
+ */
+export type PersistedOperationName = PersistedReadOperationName | PersistedWriteOperationName;
+/**
+ * Контракт кодека полезной нагрузки сохранённой записи.
+ *
+ * Как правило, backend хранит payload строкой JSON, но общий слой не навязывает
+ * конкретный формат. Ресурс сам решает, как именно парсить и сериализовать данные.
+ */
+export interface PersistedPayloadCodec<T> {
+    /**
+     * Разбирает сохранённый payload в доменную структуру.
+     */
+    parse: (payload: string | null | undefined) => T | null;
+    /**
+     * Сериализует доменную структуру в формат, ожидаемый transport/backend слоем.
+     */
+    stringify: (value: T) => string;
+}
+/**
+ * Набор фабрик query key для конкретного persisted-record ресурса.
+ *
+ * Стандартная форма ключа:
+ * `namespace -> resource -> normalizedScope -> operation -> optionalArgs`
+ */
+export interface PersistedRecordKeys<TScope> {
+    all: readonly unknown[];
+    scope: (scope: TScope | null | undefined) => readonly unknown[];
+    operation: (name: PersistedOperationName, scope: TScope | null | undefined, args?: unknown) => readonly unknown[];
+    list: (scope: TScope | null | undefined) => readonly unknown[];
+    latest: (scope: TScope | null | undefined) => readonly unknown[];
+    history: (scope: TScope | null | undefined, args?: unknown) => readonly unknown[];
+    save: (scope: TScope | null | undefined) => readonly unknown[];
+    create: (scope: TScope | null | undefined) => readonly unknown[];
+    delete: (scope: TScope | null | undefined) => readonly unknown[];
+}
+/**
+ * Контекст выполнения read-операции.
+ *
+ * Общий слой гарантирует, что к моменту вызова `execute` scope уже прошёл
+ * базовую проверку descriptor-а.
+ */
+export interface PersistedQueryOperationContext<TScope, TArgs> {
+    scope: TScope;
+    args: TArgs;
+    client: QueryClient;
+    signal?: AbortSignal;
+}
+/**
+ * Контекст выполнения write-операции.
+ */
+export interface PersistedMutationOperationContext<TScope, TInput> {
+    scope: TScope;
+    input: TInput;
+    client: QueryClient;
+}
+/**
+ * Контракт read-операции (`list`, `latest`, `history`).
+ */
+export interface PersistedQueryOperation<TScope, TArgs, TResult> {
+    /**
+     * Выполняет запрос и возвращает уже доменную модель результата.
+     */
+    execute(context: PersistedQueryOperationContext<TScope, TArgs>): Promise<TResult>;
+    /**
+     * Позволяет локально отключить query даже при формально валидном scope.
+     */
+    isEnabled?(scope: TScope | null | undefined, args: TArgs): boolean;
+    /**
+     * Политики react-query для конкретной операции.
+     */
+    staleTime?: number;
+    gcTime?: number;
+    meta?: QueryMeta;
+}
+/**
+ * Контекст, который cache strategy получает после успешной мутации.
+ */
+export interface PersistedCacheStrategyContext<TScope, TInput, TResult, TTransport extends PersistedTransportAdapter<TScope> = PersistedTransportAdapter<TScope>> {
+    client: QueryClient;
+    descriptor: PersistedResourceDescriptor<TScope, TTransport>;
+    scope: TScope;
+    input: TInput;
+    result: TResult;
+}
+/**
+ * Политика обновления react-query кэша после write-операции.
+ */
+export interface PersistedCacheStrategy<TScope, TInput, TResult> {
+    onSuccess?(context: PersistedCacheStrategyContext<TScope, TInput, TResult>): void | Promise<void>;
+}
+/**
+ * Контракт write-операции (`save`, `create`, `delete`).
+ */
+export interface PersistedMutationOperation<TScope, TInput, TResult> {
+    /**
+     * Выполняет мутацию и возвращает доменный результат.
+     */
+    execute(context: PersistedMutationOperationContext<TScope, TInput>): Promise<TResult>;
+    /**
+     * Базовая cache policy ресурса.
+     */
+    cacheStrategy?: PersistedCacheStrategy<TScope, TInput, TResult>;
+}
+/**
+ * Capability model ресурса.
+ *
+ * Ресурс не обязан поддерживать весь CRUD. Он подключает только те операции,
+ * которые реально существуют у backend-а и нужны доменному коду.
+ */
+export interface PersistedOperationCapabilities<TScope> {
+    list?: PersistedQueryOperation<TScope, void, unknown>;
+    latest?: PersistedQueryOperation<TScope, void, unknown>;
+    history?: PersistedQueryOperation<TScope, unknown, unknown>;
+    save?: PersistedMutationOperation<TScope, unknown, unknown>;
+    create?: PersistedMutationOperation<TScope, unknown, unknown>;
+    delete?: PersistedMutationOperation<TScope, unknown, unknown>;
+}
+/**
+ * Транспортный адаптер ресурса.
+ *
+ * Обычно собирается из OData или REST adapter factory.
+ */
+export type PersistedTransportAdapter<TScope> = PersistedOperationCapabilities<TScope>;
+/**
+ * Полное описание persisted-record ресурса.
+ *
+ * Descriptor — центральная точка конфигурации generic-слоя.
+ */
+export interface PersistedResourceDescriptor<TScope, TTransport extends PersistedTransportAdapter<TScope> = PersistedTransportAdapter<TScope>> {
+    namespace: string;
+    resource: string;
+    keys: PersistedRecordKeys<TScope>;
+    transport: TTransport;
+    isEnabled?: (scope: TScope | null | undefined) => boolean;
+    getScopeError?: (scope: TScope | null | undefined) => string | null;
+}
+/**
+ * Параметры создания descriptor-а.
+ */
+export interface CreatePersistedResourceDescriptorOptions<TScope, TTransport extends PersistedTransportAdapter<TScope> = PersistedTransportAdapter<TScope>> {
+    namespace: string;
+    resource: string;
+    transport: TTransport;
+    normalizeScope?: (scope: TScope | null | undefined) => unknown;
+    isEnabled?: (scope: TScope | null | undefined) => boolean;
+    getScopeError?: (scope: TScope | null | undefined) => string | null;
+}
+/**
+ * Настройки стратегии точечного обновления кэша через `setQueryData`.
+ */
+export interface PersistedSetQueryDataStrategyOptions<TScope, TInput, TResult, TData> {
+    /**
+     * Возвращает ключ query, который нужно обновить.
+     */
+    getQueryKey: (context: PersistedCacheStrategyContext<TScope, TInput, TResult>) => QueryKey;
+    /**
+     * Вычисляет новое значение кэша на основе текущего значения и результата мутации.
+     */
+    update: (current: TData | undefined, context: PersistedCacheStrategyContext<TScope, TInput, TResult>) => TData;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persisted/types.ts"],"names":[],"mappings":"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"}

package/dist/resource/cache.d.ts

@@ -0,0 +1,22 @@
+import type { ResourceCacheStrategy, ResourceCacheStrategyContext, ResourceSetQueryDataStrategyOptions } from "./types";
+/**
+ * Безопасно применяет cache strategy, если она была передана.
+ */
+export declare function applyResourceCacheStrategy<TScope, TInput, TResult, TDescriptor>(strategy: ResourceCacheStrategy<TScope, TInput, TResult, TDescriptor> | null | undefined, context: ResourceCacheStrategyContext<TScope, TInput, TResult, TDescriptor>): Promise<void>;
+/**
+ * Создаёт стратегию, инвалидирующую все query внутри одного scope ресурса.
+ */
+export declare function createInvalidateResourceScopeCacheStrategy<TScope, TInput, TResult, TDescriptor extends {
+    readonly keys: {
+        scope: (scope: TScope) => readonly unknown[];
+    };
+}>(): ResourceCacheStrategy<TScope, TInput, TResult, TDescriptor>;
+/**
+ * Создаёт стратегию точечного обновления одного query через `setQueryData`.
+ */
+export declare function createSetResourceQueryDataCacheStrategy<TScope, TInput, TResult, TData, TDescriptor>(options: ResourceSetQueryDataStrategyOptions<TScope, TInput, TResult, TData, TDescriptor>): ResourceCacheStrategy<TScope, TInput, TResult, TDescriptor>;
+/**
+ * Комбинирует несколько cache strategy в одну последовательную стратегию.
+ */
+export declare function composeResourceCacheStrategies<TScope, TInput, TResult, TDescriptor>(...strategies: Array<ResourceCacheStrategy<TScope, TInput, TResult, TDescriptor> | null | undefined>): ResourceCacheStrategy<TScope, TInput, TResult, TDescriptor>;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/resource/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,mCAAmC,EAAE,MAAM,SAAS,CAAC;AAExH;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EACpF,QAAQ,EAAE,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,EACxF,OAAO,EAAE,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,iBAG3E;AAED;;GAEG;AACH,wBAAgB,0CAA0C,CACzD,MAAM,EACN,MAAM,EACN,OAAO,EACP,WAAW,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,OAAO,EAAE,CAAA;KAAE,CAAA;CAAE,KACnF,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAM/D;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAClG,OAAO,EAAE,mCAAmC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,GACvF,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAQ7D;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAClF,GAAG,UAAU,EAAE,KAAK,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAClG,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAQ7D"}

package/dist/resource/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./cache";
+export * from "./keys";
+export * from "./resource";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/resource/index.js

@@ -0,0 +1,147 @@
+import { queryOptions as e, useMutation as t, useQuery as n, useQueryClient as r } from "@tanstack/react-query";
+//#region src/resource/cache.ts
+async function i(e, t) {
+	await e?.onSuccess?.(t);
+}
+function a() {
+	return { onSuccess: async ({ client: e, descriptor: t, scope: n }) => {
+		await e.invalidateQueries({ queryKey: t.keys.scope(n) });
+	} };
+}
+function o(e) {
+	return { onSuccess: ({ client: t, ...n }) => {
+		t.setQueryData(e.getQueryKey({
+			client: t,
+			...n
+		}), (r) => e.update(r, {
+			client: t,
+			...n
+		}));
+	} };
+}
+function s(...e) {
+	return { onSuccess: async (t) => {
+		for (let n of e) await n?.onSuccess?.(t);
+	} };
+}
+//#endregion
+//#region src/resource/keys.ts
+function c(e) {
+	return e == null ? null : typeof e == "string" ? e.trim() : typeof e == "number" || typeof e == "boolean" ? e : Array.isArray(e) ? e.map((e) => c(e)) : typeof e == "object" ? Object.keys(e).sort().reduce((t, n) => (t[n] = c(e[n]), t), {}) : String(e);
+}
+var l = (e) => c(e ?? null);
+function u(e) {
+	let t = [e.namespace, e.resource], n = e.normalizeScope ?? l, r = (e) => [...t, c(n(e))];
+	return {
+		all: t,
+		scope: r,
+		operation: (e, t, n) => n === void 0 ? [...r(t), e] : [
+			...r(t),
+			e,
+			c(n)
+		]
+	};
+}
+//#endregion
+//#region src/resource/resource.ts
+function d(e, t) {
+	if (t != null && (e.isEnabled?.(t) ?? !0)) return t;
+	throw Error(e.getScopeError?.(t) ?? `Недостаточно данных scope для ресурса '${e.resource}'.`);
+}
+function f(e) {
+	return typeof e == "object" && !!e && "execute" in e && typeof e.execute == "function";
+}
+function p(e) {
+	return f(e);
+}
+function m(e) {
+	return f(e);
+}
+function h(e, t) {
+	let n = e.operations.queries[t];
+	if (!p(n)) throw Error(`Ресурс '${e.resource}' не поддерживает read-операцию '${t}'.`);
+	return n;
+}
+function g(e, t) {
+	let n = e.operations.mutations[t];
+	if (!m(n)) throw Error(`Ресурс '${e.resource}' не поддерживает write-операцию '${t}'.`);
+	return n;
+}
+function _(e, t, n, r) {
+	return e.isEnabled?.(n) ?? !0 ? t.isEnabled?.(n, r) ?? !0 : !1;
+}
+function v(e) {
+	return {
+		namespace: e.namespace,
+		resource: e.resource,
+		keys: e.keys ?? u({
+			namespace: e.namespace,
+			resource: e.resource,
+			normalizeScope: e.normalizeScope
+		}),
+		operations: {
+			queries: e.operations.queries ?? {},
+			mutations: e.operations.mutations ?? {}
+		},
+		isEnabled: e.isEnabled,
+		getScopeError: e.getScopeError
+	};
+}
+function y(e) {
+	return e;
+}
+function b(e) {
+	return e;
+}
+function x(t, n, r, i) {
+	let a = h(t, n), o = _(t, a, r, i);
+	return e({
+		queryKey: t.keys.operation(n, r, i),
+		queryFn: ({ client: e, signal: n }) => {
+			let o = d(t, r);
+			return a.execute({
+				scope: o,
+				args: i,
+				client: e,
+				signal: n
+			});
+		},
+		enabled: o,
+		staleTime: a.staleTime,
+		gcTime: a.gcTime
+	});
+}
+function S(e, t, r, i) {
+	return n(x(e, t, r, i));
+}
+async function C(e, t, n, r, i) {
+	return await i.fetchQuery(x(e, t, n, r));
+}
+function w(e, n, a, o) {
+	let s = r(), c = g(e, n);
+	return t({
+		mutationKey: e.keys.operation(n, a),
+		mutationFn: async (t) => {
+			let n = d(e, a);
+			return await c.execute({
+				scope: n,
+				input: t,
+				client: s
+			});
+		},
+		onSuccess: async (t, n) => {
+			let r = d(e, a);
+			await i(o?.cacheStrategy === void 0 ? c.cacheStrategy : o.cacheStrategy, {
+				client: s,
+				descriptor: e,
+				scope: r,
+				input: n,
+				result: t
+			}), await o?.onSuccess?.(t, n);
+		}
+	});
+}
+//#endregion
+export { i as applyResourceCacheStrategy, x as buildResourceQueryOptions, s as composeResourceCacheStrategies, a as createInvalidateResourceScopeCacheStrategy, v as createResourceDescriptor, u as createResourceKeys, b as createResourceMutationOperation, y as createResourceQueryOperation, o as createSetResourceQueryDataCacheStrategy, C as getResourceQueryData, c as normalizeResourceKeyValue, w as useResourceMutation, S as useResourceQuery };
+
+//# sourceMappingURL=index.js.map