@kollors/deep-json-server 1.0.0-alpha.1 → 1.0.0-alpha.11

package/dist/src/files/routes.d.ts

@@ -1,5 +1,8 @@
 import type { FastifyInstance } from 'fastify';
 import { type FileStore } from './contract.js';
+/** Регистрирует обработчики загрузки, чтения, перемещения и удаления файлов.
+ * @example После регистрации GET по существующему пути → поток файла; функция возвращает undefined.
+ */
 export declare const registerFileRoutes: (fastify: FastifyInstance, { getStore, maxFileSize }: {
     getStore: () => Promise<FileStore>;
     maxFileSize: number;

package/dist/src/files/routes.js

@@ -1,5 +1,9 @@
-import { createHttpError } from '../utils.js';
-import { createFileMetadata, FILE_HEADERS, FILE_ROUTES, FILE_UPDATE_SCHEMA, getDownloadName, getFileKey, getPathLocation, normalizeMimeType, PATCH_BODY_LIMIT, validateDirectory, validateName, } from './contract.js';
+import { createHttpError } from '../core/http-errors.js';
+import { getFileKey, getPathLocation, normalizeMimeType, validateDirectory, validateName } from './contract.js';
+import { createFileMetadata, FILE_HEADERS, FILE_ROUTES, FILE_UPDATE_SCHEMA, getDownloadName, PATCH_BODY_LIMIT } from './http.js';
+/** Декодирует строку из URL-кодировки; отсутствие или повреждённая кодировка дают ошибку 400.
+ * @example decodeHeader('a%20b', 'Name') → 'a b'; decodeHeader('%', 'Name') → ошибка.
+ */
 const decodeHeader = (value, name) => {
     if (typeof value !== 'string') {
         throw createHttpError(400, `Заголовок ${name} обязателен`);
@@ -11,8 +15,17 @@ const decodeHeader = (value, name) => {
         throw createHttpError(400, `Заголовок ${name} содержит некорректное значение`);
     }
 };
+/** Декодирует и проверяет имя файла из заголовка.
+ * @example getContentName('a%20b.txt') → 'a b.txt'.
+ */
 const getContentName = (value) => validateName(decodeHeader(value, FILE_HEADERS.name.name), `Заголовок ${FILE_HEADERS.name.name}`);
+/** Декодирует относительный каталог; отсутствующее значение заменяет пустой строкой.
+ * @example getContentDirectory(undefined) → ''; getContentDirectory('my%20photos') → 'my photos'.
+ */
 const getContentDirectory = (value) => (value == null ? '' : validateDirectory(decodeHeader(value, FILE_HEADERS.directory.name), `Заголовок ${FILE_HEADERS.directory.name}`));
+/** Читает строковый логический флаг перезаписи; отсутствие означает false.
+ * @example getContentOverride('true') → true; getContentOverride(undefined) → false; 'yes' → ошибка.
+ */
 const getContentOverride = (value) => {
     if (value == null || value === 'false') {
         return false;
@@ -22,17 +35,29 @@ const getContentOverride = (value) => {
     }
     throw createHttpError(400, `Заголовок ${FILE_HEADERS.override.name} должен содержать true или false`);
 };
+/** Извлекает и проверяет путь из параметра маршрута.
+ * @example При request.params = { '*': 'photos/a.jpg' } → 'photos/a.jpg'.
+ */
 const getRequestPath = (request) => getFileKey(getPathLocation(request.params['*']));
+/** Проверяет переданные имя и каталог и возвращает только заданные значения.
+ * @example normalizeUpdate({ name: 'a.txt' }) → { name: 'a.txt' }.
+ */
 const normalizeUpdate = (body) => ({
     ...(body.directory != null && { directory: validateDirectory(body.directory, 'Ключ body.directory') }),
     ...(body.name != null && { name: validateName(body.name, 'Ключ body.name') }),
 });
+/** Читает поток из хранилища и отправляет его с MIME-типом и заголовком скачивания или просмотра.
+ * @example При disposition = 'inline' ответ содержит Content-Disposition: inline и байты файла.
+ */
 const sendFile = async (store, path, reply, disposition) => {
     const { file, stream } = await store.get(path);
     reply.header('Content-Disposition', `${disposition}; filename*=UTF-8''${getDownloadName(file.name)}`);
     reply.type(file.mimeType);
     return reply.send(stream);
 };
+/** Регистрирует обработчики загрузки, чтения, перемещения и удаления файлов.
+ * @example После регистрации GET по существующему пути → поток файла; функция возвращает undefined.
+ */
 export const registerFileRoutes = (fastify, { getStore, maxFileSize }) => {
     fastify.register(async (fileServer) => {
         const store = await getStore();

package/dist/src/files/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/files/routes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAGlB,eAAe,EACf,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC;AAMvB,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,IAAY,EAAU,EAAE;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,eAAe,CAAC,GAAG,EAAE,aAAa,IAAI,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,eAAe,CAAC,GAAG,EAAE,aAAa,IAAI,iCAAiC,CAAC,CAAC;IACjF,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,aAAa,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACpJ,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,aAAa,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAE/L,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAW,EAAE;IACrD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,eAAe,CAAC,GAAG,EAAE,aAAa,YAAY,CAAC,QAAQ,CAAC,IAAI,kCAAkC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,OAAuB,EAAU,EAAE,CAAC,UAAU,CAAC,eAAe,CAAE,OAAO,CAAC,MAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEjI,MAAM,eAAe,GAAG,CAAC,IAAgB,EAAc,EAAE,CAAC,CAAC;IACzD,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,CAAC;IACtG,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAgB,EAAE,IAAY,EAAE,KAAmB,EAAE,WAAoC,EAAE,EAAE;IACnH,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE/C,KAAK,CAAC,MAAM,CAAC,qBAAqB,EAAE,GAAG,WAAW,sBAAsB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAwB,EAAE,EAAE,QAAQ,EAAE,WAAW,EAA+D,EAAQ,EAAE;IAC3J,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;QACpC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAE/B,UAAU,CAAC,QAAQ,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YACnD,YAAY,CAAC,2BAA2B,EAAE,CAAC;YAC3C,YAAY,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YAErG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;gBAC9D,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBAEhE,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,WAAW,EAAE,CAAC;oBAClE,MAAM,eAAe,CAAC,GAAG,EAAE,oCAAoC,WAAW,OAAO,CAAC,CAAC;gBACrF,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;oBAChC,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBAC3E,WAAW;oBACX,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;oBAC5D,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC5D,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACxE,MAAM,EAAE,OAAO,CAAC,IAAgB;iBACjC,CAAC,CAAC;gBAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACtF,CAAC,CAAC,CAAC;YAEH,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChI,UAAU,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,QAAQ,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QAErI,UAAU,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,QAAQ,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAElI,UAAU,CAAC,KAAK,CACd,GAAG,WAAW,CAAC,OAAO,IAAI,EAC1B;YACE,SAAS,EAAE,gBAAgB;YAC3B,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC/B,IAAI,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,KAAK,kBAAkB,EAAE,CAAC;oBAC9E,MAAM,eAAe,CAAC,GAAG,EAAE,gEAAgE,CAAC,CAAC;gBAC/F,CAAC;YACH,CAAC;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE;SACrC,EACD,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,IAAkB,CAAC,CAAC,CAAC,CAChI,CAAC;QAEF,UAAU,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YACrE,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;YAE5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/files/routes.ts"],"names":[],"mappings":"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"}

package/dist/src/files/streams.d.ts

@@ -0,0 +1,5 @@
+import { Transform } from 'node:stream';
+/** Создаёт преобразующий поток, который считает байты и отклоняет превышение лимита.
+ * @example Лимит 3 и поток 'abcd' → ошибка; поток 'abc' проходит без изменения.
+ */
+export declare const createSizeLimiter: (maxFileSize: number, onSize: (size: number) => void) => Transform;

package/dist/src/files/streams.js

@@ -0,0 +1,20 @@
+import { Transform } from 'node:stream';
+import { domainError } from '../core/errors.js';
+/** Создаёт преобразующий поток, который считает байты и отклоняет превышение лимита.
+ * @example Лимит 3 и поток 'abcd' → ошибка; поток 'abc' проходит без изменения.
+ */
+export const createSizeLimiter = (maxFileSize, onSize) => {
+    let size = 0;
+    return new Transform({
+        transform(chunk, _encoding, callback) {
+            size += chunk.length;
+            if (size > maxFileSize) {
+                callback(domainError('PAYLOAD_TOO_LARGE', `Размер файла не должен превышать ${maxFileSize} байт`));
+                return;
+            }
+            onSize(size);
+            callback(null, chunk);
+        },
+    });
+};
+//# sourceMappingURL=streams.js.map

package/dist/src/files/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../../../src/files/streams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAmB,EAAE,MAA8B,EAAa,EAAE;IAClG,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO,IAAI,SAAS,CAAC;QACnB,SAAS,CAAC,KAAa,EAAE,SAAyB,EAAE,QAA2B;YAC7E,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;YAErB,IAAI,IAAI,GAAG,WAAW,EAAE,CAAC;gBACvB,QAAQ,CAAC,WAAW,CAAC,mBAAmB,EAAE,oCAAoC,WAAW,OAAO,CAAC,CAAC,CAAC;gBACnG,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,CAAC;YACb,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/src/graphql/entry.d.ts

@@ -0,0 +1,12 @@
+export type { EntityDefinition, Field, ModelSchema } from '../core/model.js';
+import type { ModelSchema } from '../core/model.js';
+import type { GraphqlOptions } from './generate.js';
+/** Загружает генератор при первом обращении и передаёт ему описание и параметры.
+ * @example Описание и параметры → Promise со схемой; при импорте этой обёртки генератор ещё не загружается.
+ */
+export declare function generateGraphql(schema: ModelSchema | string, options?: GraphqlOptions): Promise<string>;
+/** Загружает модуль записи по требованию и сохраняет схему в указанный файл.
+ * @example Схема и путь → Promise<void>; файл появляется после успешного завершения.
+ */
+export declare function writeGraphql(sdl: string, path: string): Promise<void>;
+export type { GraphqlOptions } from './generate.js';

package/dist/src/graphql/entry.js

@@ -0,0 +1,13 @@
+/** Загружает генератор при первом обращении и передаёт ему описание и параметры.
+ * @example Описание и параметры → Promise со схемой; при импорте этой обёртки генератор ещё не загружается.
+ */
+export async function generateGraphql(schema, options) {
+    return (await import('./generate.js')).generateGraphql(schema, options);
+}
+/** Загружает модуль записи по требованию и сохраняет схему в указанный файл.
+ * @example Схема и путь → Promise<void>; файл появляется после успешного завершения.
+ */
+export async function writeGraphql(sdl, path) {
+    return (await import('./write.js')).writeGraphql(sdl, path);
+}
+//# sourceMappingURL=entry.js.map

package/dist/src/graphql/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/graphql/entry.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAA4B,EAAE,OAAwB;IAC1F,OAAO,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AACD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,IAAY;IAC1D,OAAO,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/dist/src/graphql/generate.d.ts

@@ -0,0 +1,12 @@
+export interface GraphqlOptions {
+    auth?: boolean;
+}
+import { type Model, type ModelSchema } from '../core/model.js';
+/** Проверяет доступность формата и возвращает текст схемы из подготовленной модели.
+ * @example Подготовленная модель с сущностью Note → SDL с типом Note и операциями note, noteList.
+ */
+export declare function graphqlFromModel(model: Model | undefined): string;
+/** Загружает описание из объекта или файла и возвращает текст схемы.
+ * @example Корректное описание сущностей → Promise<string> с SDL; некорректное → ошибка.
+ */
+export declare function generateGraphql(schema: ModelSchema | string, options?: GraphqlOptions): Promise<string>;

package/dist/src/graphql/generate.js

@@ -0,0 +1,19 @@
+import { assertKnownKeys } from '../core/utils.js';
+import { printSchema } from 'graphql';
+import { assertApi, loadModel } from '../core/model.js';
+import { buildGraphql } from './schema.js';
+/** Проверяет доступность формата и возвращает текст схемы из подготовленной модели.
+ * @example Подготовленная модель с сущностью Note → SDL с типом Note и операциями note, noteList.
+ */
+export function graphqlFromModel(model) {
+    assertApi(model, 'graphql');
+    return printSchema(buildGraphql(model));
+}
+/** Загружает описание из объекта или файла и возвращает текст схемы.
+ * @example Корректное описание сущностей → Promise<string> с SDL; некорректное → ошибка.
+ */
+export async function generateGraphql(schema, options = {}) {
+    assertKnownKeys(options, new Set(['auth']), 'options');
+    return graphqlFromModel(await loadModel(schema, { auth: options.auth, api: ['graphql'] }));
+}
+//# sourceMappingURL=generate.js.map

package/dist/src/graphql/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/graphql/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKnD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAgC,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC5B,OAAO,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AACD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAA4B,EAAE,OAAO,GAAmB,EAAE;IAC9F,eAAe,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACvD,OAAO,gBAAgB,CAAC,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7F,CAAC"}

package/dist/src/graphql/preflight.d.ts

@@ -0,0 +1,6 @@
+import { type FieldNode, type GraphQLResolveInfo } from 'graphql';
+import type { Engine, PreparedList } from '../core/engine.js';
+/** Обходит выбранные поля, фрагменты и директивы и подготавливает аргументы списков до изменения данных.
+ * @example Запрос без списков → пустая Map; выбранный список с pageSize: 0 → ошибка.
+ */
+export declare function preflight(info: GraphQLResolveInfo, engine: Engine): Map<FieldNode, PreparedList>;

package/dist/src/graphql/preflight.js

@@ -0,0 +1,44 @@
+import { GraphQLIncludeDirective, GraphQLSkipDirective, getArgumentValues, getDirectiveValues, getNamedType, isObjectType, } from 'graphql';
+/** Обходит выбранные поля, фрагменты и директивы и подготавливает аргументы списков до изменения данных.
+ * @example Запрос без списков → пустая Map; выбранный список с pageSize: 0 → ошибка.
+ */
+export function preflight(info, engine) {
+    const prepared = new Map();
+    const root = info.operation.operation === 'mutation' ? info.schema.getMutationType() : info.schema.getQueryType();
+    if (!root)
+        throw new Error('GraphQL operation root is unavailable');
+    const visited = new Map();
+    const walk = (selectionSet, parent) => {
+        let parents = visited.get(selectionSet);
+        if (!parents) {
+            parents = new Set();
+            visited.set(selectionSet, parents);
+        }
+        if (parents.has(parent))
+            return;
+        parents.add(parent);
+        for (const selection of selectionSet.selections) {
+            if (getDirectiveValues(GraphQLSkipDirective, selection, info.variableValues)?.if === true || getDirectiveValues(GraphQLIncludeDirective, selection, info.variableValues)?.if === false)
+                continue;
+            if (selection.kind === 'FragmentSpread') {
+                walk(info.fragments[selection.name.value].selectionSet, parent);
+                continue;
+            }
+            if (selection.kind === 'InlineFragment') {
+                walk(selection.selectionSet, parent);
+                continue;
+            }
+            const field = parent.getFields()[selection.name.value];
+            if (!field)
+                continue;
+            if (field.extensions.listNode && !prepared.has(selection))
+                prepared.set(selection, engine.prepareOptions(field.extensions.listNode, getArgumentValues(field, selection, info.variableValues)));
+            const type = getNamedType(field.type);
+            if (selection.selectionSet && isObjectType(type))
+                walk(selection.selectionSet, type);
+        }
+    };
+    walk(info.operation.selectionSet, root);
+    return prepared;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/src/graphql/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../src/graphql/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,EAGvB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,YAAY,GAEb,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAwB,EAAE,MAAc;IAChE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IAClH,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4C,CAAC;IACpE,MAAM,IAAI,GAAG,CAAC,YAA8B,EAAE,MAAyB,EAAQ,EAAE;QAC/E,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO;QAChC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,KAAK,MAAM,SAAS,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;YAChD,IAAI,kBAAkB,CAAC,oBAAoB,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,IAAI,IAAI,kBAAkB,CAAC,uBAAuB,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,KAAK;gBAAE,SAAS;YACjM,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACxC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;gBACrC,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBACvD,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAC9I,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,SAAS,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACvF,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/graphql/resolvers.d.ts

@@ -0,0 +1,17 @@
+import { type FieldNode, type GraphQLResolveInfo, type GraphQLSchema } from 'graphql';
+import type { Engine, PreparedList } from '../core/engine.js';
+import type { Actor } from '../core/lifecycle/options.js';
+import { type Context } from '../core/records.js';
+export interface GraphqlContext {
+    actor?: () => Actor;
+    snapshot(): Promise<Context>;
+    prepare(info: GraphQLResolveInfo): Promise<Map<FieldNode, PreparedList>>;
+}
+/** Создаёт кеш снимка данных и проверки аргументов на время одного запроса.
+ * @example Повторные вызовы context.snapshot() возвращают тот же Promise<Context>.
+ */
+export declare function createGraphqlContext(engine: Engine): GraphqlContext;
+/** Назначает полям схемы обработчики чтения и изменения записей; изменяет переданную схему.
+ * @example После вызова поле запроса имеет resolve; возвращаемое значение → undefined.
+ */
+export declare function attachResolvers(schema: GraphQLSchema, engine: Engine): void;

package/dist/src/graphql/resolvers.js

@@ -0,0 +1,44 @@
+import { isObjectType } from 'graphql';
+import { resolveField } from '../core/records.js';
+import { preflight } from './preflight.js';
+/** Создаёт кеш снимка данных и проверки аргументов на время одного запроса.
+ * @example Повторные вызовы context.snapshot() возвращают тот же Promise<Context>.
+ */
+export function createGraphqlContext(engine) {
+    let snapshot;
+    let prepared;
+    return {
+        snapshot: () => (snapshot ??= engine.context()),
+        prepare: (info) => (prepared ??= Promise.resolve().then(() => preflight(info, engine))),
+    };
+}
+/** Назначает полям схемы обработчики чтения и изменения записей; изменяет переданную схему.
+ * @example После вызова поле запроса имеет resolve; возвращаемое значение → undefined.
+ */
+export function attachResolvers(schema, engine) {
+    for (const type of Object.values(schema.getTypeMap())) {
+        if (!isObjectType(type))
+            continue;
+        for (const field of Object.values(type.getFields())) {
+            const { entity, operation, node, listNode } = field.extensions;
+            if (entity && operation)
+                field.resolve = async (_root, args, context, info) => {
+                    const plans = await context.prepare(info);
+                    if (operation === 'find')
+                        return engine.find(await context.snapshot(), entity, args[entity.primary]) ?? null;
+                    if (operation === 'list')
+                        return engine.list(engine.records(await context.snapshot(), entity), entity.root, args, plans.get(info.fieldNodes[0]));
+                    return engine.mutate(entity, operation, args[entity.primary], args.data ?? {}, undefined, context.actor);
+                };
+            else if (node)
+                field.resolve = async (ref, args, context, info) => {
+                    const value = resolveField(ref, node);
+                    if (!listNode || value == null)
+                        return value;
+                    const plans = await context.prepare(info);
+                    return engine.list(value, listNode, args, plans.get(info.fieldNodes[0]));
+                };
+        }
+    }
+}
+//# sourceMappingURL=resolvers.js.map

package/dist/src/graphql/resolvers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.js","sourceRoot":"","sources":["../../../src/graphql/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+D,YAAY,EAAE,MAAM,SAAS,CAAC;AAMpG,OAAO,EAA0B,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAO3C;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,QAAsC,CAAC;IAC3C,IAAI,QAA2D,CAAC;IAChE,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;KACxF,CAAC;AACJ,CAAC;AACD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB,EAAE,MAAc;IACnE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;YACpD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,UAA2G,CAAC;YAChK,IAAI,MAAM,IAAI,SAAS;gBACrB,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAuB,EAAE,IAAI,EAAE,EAAE;oBACnE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC1C,IAAI,SAAS,KAAK,MAAM;wBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC;oBAC7G,IAAI,SAAS,KAAK,MAAM;wBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACjJ,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC3G,CAAC,CAAC;iBACC,IAAI,IAAI;gBACX,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,GAAQ,EAAE,IAAiB,EAAE,OAAuB,EAAE,IAAI,EAAE,EAAE;oBACnF,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBACtC,IAAI,CAAC,QAAQ,IAAI,KAAK,IAAI,IAAI;wBAAE,OAAO,KAAK,CAAC;oBAC7C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpF,CAAC,CAAC;QACN,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/graphql/routes.d.ts

@@ -0,0 +1,8 @@
+import type { FastifyInstance } from 'fastify';
+import type { GraphQLSchema } from 'graphql';
+import type { Engine } from '../core/engine.js';
+import type { Authenticate } from '../core/lifecycle/options.js';
+/** Регистрирует обработчик GraphQL, контекст запроса и преобразование ошибок.
+ * @example После регистрации POST на заданный path выполняет запрос; прикладная ошибка попадает в errors[].extensions.code.
+ */
+export declare function registerGraphqlRoutes(server: FastifyInstance, schema: GraphQLSchema, engine: Engine, path: string, authenticate?: Authenticate): void;

package/dist/src/graphql/routes.js

@@ -0,0 +1,30 @@
+import mercurius from 'mercurius';
+import { DomainError } from '../core/errors.js';
+import { attachResolvers, createGraphqlContext } from './resolvers.js';
+/** Регистрирует обработчик GraphQL, контекст запроса и преобразование ошибок.
+ * @example После регистрации POST на заданный path выполняет запрос; прикладная ошибка попадает в errors[].extensions.code.
+ */
+export function registerGraphqlRoutes(server, schema, engine, path, authenticate) {
+    attachResolvers(schema, engine);
+    server.register(mercurius, {
+        schema,
+        path,
+        queryDepth: 32,
+        context: (request) => ({ ...createGraphqlContext(engine), ...(authenticate ? { actor: () => authenticate(request.headers.authorization) } : {}) }),
+        errorFormatter: (execution, context) => {
+            const formatted = mercurius.defaultErrorFormatter(execution, context);
+            formatted.response.errors = execution.errors.map((error) => {
+                const original = error.originalError;
+                if (original instanceof DomainError)
+                    return { ...error.toJSON(), extensions: { ...error.extensions, code: original.code } };
+                if (original && !('errors' in original) && !(original instanceof Error && original.name === 'GraphQLError')) {
+                    context.reply?.request.log.error(original);
+                    return { message: 'Internal server error', locations: error.locations, path: error.path, extensions: { code: 'INTERNAL_ERROR' } };
+                }
+                return error.toJSON();
+            });
+            return formatted;
+        },
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/src/graphql/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/graphql/routes.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvE;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB,EAAE,MAAqB,EAAE,MAAc,EAAE,IAAY,EAAE,YAA2B;IAC7I,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE;QACzB,MAAM;QACN,IAAI;QACJ,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAClJ,cAAc,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;YACrC,MAAM,SAAS,GAAG,SAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtE,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACzD,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC;gBACrC,IAAI,QAAQ,YAAY,WAAW;oBAAE,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC5H,IAAI,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,YAAY,KAAK,IAAI,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,CAAC;oBAC5G,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBAC3C,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,CAAC;gBACpI,CAAC;gBACD,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/src/graphql/schema.d.ts

@@ -0,0 +1,6 @@
+import { GraphQLSchema } from 'graphql';
+import { type Model } from '../core/model.js';
+/** Строит типы, фильтры, аргументы и операции по модели, проверяя конфликты имён.
+ * @example Модель с сущностью Note → GraphQLSchema с типом Note; повторяющееся имя типа → ошибка.
+ */
+export declare function buildGraphql(model: Model): GraphQLSchema;

package/dist/src/{graphql.js → graphql/schema.js}

@@ -1,8 +1,13 @@
 import { assertValidSchema, GraphQLBoolean, GraphQLEnumType, GraphQLFloat, GraphQLID, GraphQLInputObjectType, GraphQLInt, GraphQLList, GraphQLNonNull, GraphQLObjectType, GraphQLSchema, GraphQLString, } from 'graphql';
-import { resolveField } from './engine.js';
-import { assertApi, nodeName, operationName } from './model.js';
-import { sortableFields } from './query/options.js';
-export function buildGraphql(model, engine) {
+import { assertApi, canonicalNode, nodeName, operationName, writable } from '../core/model.js';
+import { MUTATIONS } from '../core/operations.js';
+import { operatorsFor } from '../core/query/contract.js';
+import { sortableFields } from '../core/query/options.js';
+import { capitalize } from '../core/utils.js';
+/** Строит типы, фильтры, аргументы и операции по модели, проверяя конфликты имён.
+ * @example Модель с сущностью Note → GraphQLSchema с типом Note; повторяющееся имя типа → ошибка.
+ */
+export function buildGraphql(model) {
     assertApi(model, 'graphql');
     const names = new Set(['String', 'Float', 'Int', 'Boolean', 'ID', 'Query', 'Mutation', 'Pager', 'OrderDirection']);
     const reserve = (name) => {
@@ -20,7 +25,6 @@ export function buildGraphql(model, engine) {
     const enums = new Map();
     const pager = new GraphQLInputObjectType({ name: 'Pager', fields: { page: { type: GraphQLInt }, pageSize: { type: GraphQLInt } } });
     const direction = new GraphQLEnumType({ name: 'OrderDirection', values: { ASC: { value: 'ASC' }, DESC: { value: 'DESC' } } });
-    const canonical = (entity, node) => (node.relation ? [node.relation, node.relation.root] : [entity, node]);
     function scalar(entity, node, constrained = true) {
         if (constrained && node.enum) {
             let type = enums.get(node);
@@ -36,10 +40,12 @@ export function buildGraphql(model, engine) {
         return node.base === 'number' ? GraphQLFloat : node.base === 'boolean' ? GraphQLBoolean : node.primary ? GraphQLID : GraphQLString;
     }
     function output(entity, node) {
-        [entity, node] = canonical(entity, node);
+        [entity, node] = canonicalNode(entity, node);
         let type = objects.get(node);
         if (type)
             return type;
+        if (!Object.values(node.children).some((child) => !child.writeOnly))
+            throw new Error(`GraphQL object ${nodeName(entity, node)} must contain at least one visible field`);
         type = new GraphQLObjectType({
             name: reserve(nodeName(entity, node)),
             fields: () => Object.fromEntries(Object.entries(node.children)
@@ -56,11 +62,8 @@ export function buildGraphql(model, engine) {
                     {
                         type: childType,
                         description: child.description,
+                        extensions: { node: child, ...(object && child.many ? { listNode: child } : {}) },
                         args: object && child.many ? listArgs(entity, child) : undefined,
-                        resolve: (ref, args) => {
-                            const value = resolveField(ref, child);
-                            return object && child.many && value != null ? engine.list(value, child, args) : value;
-                        },
                     },
                 ];
             })),
@@ -69,7 +72,7 @@ export function buildGraphql(model, engine) {
         return type;
     }
     function page(entity, node) {
-        [entity, node] = canonical(entity, node);
+        [entity, node] = canonicalNode(entity, node);
         let type = pages.get(node);
         if (type)
             return type;
@@ -80,9 +83,15 @@ export function buildGraphql(model, engine) {
         pages.set(node, type);
         return type;
     }
-    function input(entity, node, mode, root = false) {
-        const name = `${nodeName(entity, node)}${mode[0].toUpperCase() + mode.slice(1)}`;
-        let type = inputs.get(name);
+    function input(entity, node, mode, root = false, nested = false) {
+        const name = `${nodeName(entity, node)}${nested ? 'Nested' : ''}${capitalize(mode)}`;
+        const variant = `${mode}:${root}:${nested}`;
+        let variants = inputs.get(node);
+        if (!variants) {
+            variants = new Map();
+            inputs.set(node, variants);
+        }
+        let type = variants.get(variant);
         if (type)
             return type;
         type = new GraphQLInputObjectType({
@@ -90,23 +99,28 @@ export function buildGraphql(model, engine) {
             fields: () => {
                 const fields = {};
                 for (const [key, child] of Object.entries(node.children)) {
-                    if (child.relation || child.generated || child.readOnly || (child.primary && mode !== 'create'))
+                    const lookup = nested && child.primary;
+                    if (!lookup && !writable(child, mode, true))
                         continue;
-                    let childType = child.base === 'object' ? input(entity, child, mode) : scalar(entity, child);
+                    let childType = child.relation
+                        ? input(child.relation, child.relation.root, mode, true, true)
+                        : child.base === 'object'
+                            ? input(entity, child, mode)
+                            : scalar(entity, child);
                     if (child.many)
                         childType = new GraphQLList(new GraphQLNonNull(childType));
-                    if (child.required && !child.nullable && !(root && mode === 'update') && child.default === undefined)
+                    if (!lookup && !child.relation && !child.relationKey && child.required && !child.nullable && !(root && (mode === 'update' || (nested && mode === 'create'))) && child.default === undefined)
                         childType = new GraphQLNonNull(childType);
                     fields[key] = { type: childType, description: child.description };
                 }
                 return fields;
             },
         });
-        inputs.set(name, type);
+        variants.set(variant, type);
         return type;
     }
     function where(entity, node) {
-        [entity, node] = canonical(entity, node);
+        [entity, node] = canonicalNode(entity, node);
         let type = wheres.get(node);
         if (type)
             return type;
@@ -138,29 +152,19 @@ export function buildGraphql(model, engine) {
         type = new GraphQLInputObjectType({
             name: reserve(`${nodeName(entity, node)}Filter`),
             fields: () => {
-                const fields = { not: { type: type } };
-                const object = node.relation || node.base === 'object';
-                if (node.many) {
-                    const element = object ? where(entity, node) : filter(entity, { ...node, many: false, path: `${node.path}_element` });
-                    for (const key of ['some', 'every', 'none'])
+                const fields = {};
+                const element = node.many ? (node.relation || node.base === 'object' ? where(entity, node) : filter(entity, { ...node, many: false, path: `${node.path}_element` })) : undefined;
+                for (const [key, operand] of Object.entries(operatorsFor(node))) {
+                    const value = scalar(entity, node);
+                    if (operand === 'condition')
+                        fields[key] = { type: type };
+                    else if (operand === 'element') {
+                        if (!element)
+                            throw new Error(`Missing element filter for ${node.path}`);
                         fields[key] = { type: element };
-                    if (!object) {
-                        const value = scalar(entity, node);
-                        fields.contains = { type: value };
-                        fields.in = { type: new GraphQLList(value) };
                     }
-                }
-                else {
-                    const value = scalar(entity, node);
-                    for (const key of ['eq', 'ne'])
-                        fields[key] = { type: value };
-                    fields.in = { type: new GraphQLList(value) };
-                    if (node.base !== 'boolean')
-                        for (const key of ['gt', 'gte', 'lt', 'lte'])
-                            fields[key] = { type: scalar(entity, node, false) };
-                    if (node.base === 'string')
-                        for (const key of ['contains', 'startsWith', 'endsWith'])
-                            fields[key] = { type: GraphQLString };
+                    else
+                        fields[key] = { type: operand === 'values' ? new GraphQLList(value) : operand === 'comparison' ? scalar(entity, node, false) : operand === 'text' ? GraphQLString : value };
                 }
                 return fields;
             },
@@ -169,7 +173,7 @@ export function buildGraphql(model, engine) {
         return type;
     }
     function order(entity, node) {
-        [entity, node] = canonical(entity, node);
+        [entity, node] = canonicalNode(entity, node);
         let type = orders.get(node);
         if (type)
             return type;
@@ -196,21 +200,27 @@ export function buildGraphql(model, engine) {
             if (queries[operation])
                 throw new Error(`GraphQL operation collision: ${operation}`);
         const keyArg = { [entity.primary]: { type: new GraphQLNonNull(scalar(entity, entity.fields[entity.primary], false)) } };
-        queries[name] = { type: output(entity, entity.root), args: keyArg, resolve: (_root, args, ctx) => engine.find(ctx.snapshot, entity, args[entity.primary]) ?? null };
+        queries[name] = {
+            type: output(entity, entity.root),
+            args: keyArg,
+            extensions: { entity, operation: 'find' },
+        };
         queries[`${name}List`] = {
             type: new GraphQLNonNull(page(entity, entity.root)),
             args: listArgs(entity, entity.root),
-            resolve: (_root, args, ctx) => engine.list(engine.records(ctx.snapshot, entity), entity.root, args),
+            extensions: { listNode: entity.root, entity, operation: 'list' },
         };
-        for (const mode of ['create', 'replace', 'update', 'delete']) {
-            const operation = `${name}${mode[0].toUpperCase() + mode.slice(1)}`;
+        for (const { mode, hasKey, hasBody } of MUTATIONS) {
+            const operation = `${name}${capitalize(mode)}`;
             if (mutations[operation])
                 throw new Error(`GraphQL operation collision: ${operation}`);
-            const fields = Object.values(entity.root.children).filter((child) => !child.relation && !child.generated && !child.readOnly && (!child.primary || mode === 'create'));
+            const args = { ...(hasKey ? keyArg : {}) };
+            if (hasBody && Object.values(entity.root.children).some((child) => writable(child, mode, true)))
+                args.data = { type: new GraphQLNonNull(input(entity, entity.root, mode, true)) };
             mutations[operation] = {
                 type: output(entity, entity.root),
-                args: { ...(mode !== 'create' ? keyArg : {}), ...(mode !== 'delete' && fields.length ? { data: { type: new GraphQLNonNull(input(entity, entity.root, mode, true)) } } : {}) },
-                resolve: (_root, args) => engine.mutate(entity, mode, args[entity.primary], args.data ?? {}),
+                args,
+                extensions: { entity, operation: mode },
             };
         }
     }
@@ -220,4 +230,4 @@ export function buildGraphql(model, engine) {
     assertValidSchema(schema);
     return schema;
 }
-//# sourceMappingURL=graphql.js.map
+//# sourceMappingURL=schema.js.map