@kollors/deep-json-server 1.0.0-alpha.5 → 1.0.0-alpha.7

package/dist/src/core/lifecycle/mutation.js

@@ -0,0 +1,170 @@
+import { randomUUID } from 'node:crypto';
+import { domainError } from '../errors.js';
+import { isEqual, isObject } from '../utils.js';
+import { DELETION_META } from './options.js';
+const keyOf = (entity, record) => JSON.stringify([entity.collection, String(record[entity.primary])]);
+/** Проверяет владельцев и заполняет поля дат и авторов внутри транзакции. */
+export class RecordMutation {
+    data;
+    model;
+    actor;
+    before;
+    now = new Date().toISOString();
+    originals = new Map();
+    touched = new Set();
+    enabled;
+    constructor(data, model, actor) {
+        this.data = data;
+        this.model = model;
+        this.actor = actor;
+        if (model.options.auth && !actor)
+            throw domainError('UNAUTHENTICATED', 'Authentication required');
+        this.enabled = model.options.auth || model.entities.some((entity) => entity.timestamps || entity.softDelete);
+        this.before = this.enabled ? structuredClone(data) : data;
+        if (!this.enabled)
+            return;
+        for (const entity of model.entities)
+            for (const record of this.before[entity.collection] ?? [])
+                this.originals.set(keyOf(entity, record), record);
+    }
+    /** Проверяет владельца исходной записи или права администратора; данные не меняет.
+     * @example Совпадающие createdById и actor.id → undefined; чужая запись без прав администратора → FORBIDDEN.
+     */
+    check(entity, record) {
+        const original = this.originals.get(keyOf(entity, record));
+        if (this.model.options.auth && original && !this.actor?.isAdmin && (original.createdById == null || original.createdById !== this.actor?.id))
+            throw domainError('FORBIDDEN', 'Only the owner or an administrator can change this record');
+    }
+    /** Отмечает запись изменённой и при необходимости восстанавливает её каскад в черновике.
+     * @example Удалённая запись после успешного вызова → deletedAt: null; конфликт восстановления → ошибка.
+     */
+    write(entity, record) {
+        if (!this.enabled)
+            return;
+        this.check(entity, record);
+        this.touched.add(keyOf(entity, record));
+        if (!entity.softDelete || record.deletedAt == null)
+            return;
+        const deletion = this.deletion(record);
+        if (deletion?.root) {
+            for (const owner of this.model.entities)
+                for (const row of this.data[owner.collection] ?? []) {
+                    if (!owner.softDelete || row.deletedAt == null || this.deletion(row)?.id !== deletion.id)
+                        continue;
+                    this.check(owner, row);
+                    this.clear(owner, row);
+                }
+            for (const patch of deletion.patches ?? []) {
+                const owner = this.model.byCollection.get(patch.collection);
+                const row = owner && (this.data[owner.collection] ?? []).find((value) => String(value[owner.primary]) === String(patch.key));
+                if (!owner || !row || row.deletedAt != null || !isEqual(row[patch.field], patch.after))
+                    throw domainError('CONFLICT', 'A cascaded object changed after deletion');
+                this.check(owner, row);
+                row[patch.field] = structuredClone(patch.before);
+                this.touched.add(keyOf(owner, row));
+            }
+        }
+        this.clear(entity, record);
+    }
+    /** Очищает признаки удаления и служебные сведения восстановления, отмечая запись изменённой.
+     * @example Запись с deletedAt и сведениями каскада → deletedAt: null без служебных сведений; результат undefined.
+     */
+    clear(entity, record) {
+        record.deletedAt = null;
+        if (this.model.options.auth)
+            record.deletedById = null;
+        delete record[DELETION_META];
+        this.touched.add(keyOf(entity, record));
+    }
+    /** Помечает выбранные записи временем удаления и общим случайным идентификатором операции.
+     * @example Две записи с включённым мягким удалением → одинаковые дата и идентификатор каскада.
+     */
+    deleteGroup(initial, deleted) {
+        const id = randomUUID();
+        for (const entity of this.model.entities)
+            for (const record of this.data[entity.collection] ?? []) {
+                if (!deleted.has(record) || !entity.softDelete)
+                    continue;
+                this.check(entity, record);
+                record.deletedAt = this.now;
+                if (this.model.options.auth)
+                    record.deletedById = this.actor?.id ?? null;
+                record[DELETION_META] = JSON.stringify({ id, root: record === initial.value });
+            }
+    }
+    /** Сохраняет изменения вложенных объектов для последующего восстановления каскада.
+     * @example Поле actors изменилось с [a, b] на [b] → в сведениях удаления сохранены оба состояния.
+     */
+    capturePruned(initial) {
+        if (!initial.entity.softDelete)
+            return;
+        const patches = [];
+        for (const entity of this.model.entities)
+            for (const row of this.data[entity.collection] ?? []) {
+                const old = this.originals.get(keyOf(entity, row));
+                if (!old || row.deletedAt != null)
+                    continue;
+                for (const [field, node] of Object.entries(entity.root.children)) {
+                    if (node.relation || node.base !== 'object' || !Object.hasOwn(old, field) || isEqual(old[field], row[field]))
+                        continue;
+                    patches.push({ collection: entity.collection, key: row[entity.primary], field, before: old[field], ...(row[field] !== undefined ? { after: structuredClone(row[field]) } : {}) });
+                }
+            }
+        const deletion = this.deletion(initial.value);
+        initial.value[DELETION_META] = JSON.stringify({ ...deletion, patches });
+    }
+    /** Проверяет права на все изменения и проставляет даты и авторов в черновике.
+     * @example Новая запись при включённых флагах → createdAt = updatedAt и createdById = updatedById.
+     */
+    finish() {
+        if (!this.enabled)
+            return;
+        for (const entity of this.model.entities) {
+            const present = new Set();
+            for (const record of this.data[entity.collection] ?? []) {
+                const key = keyOf(entity, record);
+                present.add(key);
+                const original = this.originals.get(key);
+                if (original && !this.touched.has(key) && isEqual(original, record))
+                    continue;
+                this.check(entity, record);
+                for (const [name, field] of Object.entries(entity.root.children))
+                    if (field.system && !field.internal && !Object.hasOwn(record, name))
+                        record[name] = null;
+                if (entity.timestamps) {
+                    record.createdAt = original?.createdAt ?? (original ? null : this.now);
+                    record.updatedAt = this.now;
+                }
+                if (this.model.options.auth) {
+                    record.createdById = original?.createdById ?? (original ? null : (this.actor?.id ?? null));
+                    record.updatedById = this.actor?.id ?? null;
+                }
+            }
+            for (const old of this.before[entity.collection] ?? [])
+                if (!present.has(keyOf(entity, old)))
+                    this.check(entity, old);
+        }
+    }
+    /** Разбирает и проверяет внутреннюю JSON-строку сведений об удалении.
+     * @example Отсутствующие сведения → undefined; корректная строка → объект; повреждённая строка → ошибка.
+     */
+    deletion(record) {
+        const raw = record[DELETION_META];
+        if (raw == null)
+            return undefined;
+        try {
+            const value = JSON.parse(raw);
+            if (!isObject(value) ||
+                typeof value.id !== 'string' ||
+                typeof value.root !== 'boolean' ||
+                (value.patches !== undefined &&
+                    (!Array.isArray(value.patches) || value.patches.some((p) => !isObject(p) || typeof p.collection !== 'string' || typeof p.field !== 'string' || !Object.hasOwn(p, 'before')))))
+                throw new Error();
+            return value;
+        }
+        catch {
+            throw domainError('INVALID_INPUT', 'Invalid deletion metadata');
+        }
+    }
+}
+//# sourceMappingURL=mutation.js.map

package/dist/src/core/lifecycle/mutation.js.map

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

package/dist/src/core/lifecycle/options.d.ts

@@ -0,0 +1,20 @@
+export interface RecordOptions {
+    timestamps?: boolean;
+    softDelete?: boolean;
+    auth?: boolean;
+}
+export interface Actor {
+    id: string;
+    isAdmin?: boolean;
+}
+export type Authenticate = (authorization: unknown) => Actor;
+export declare const DELETION_META = "djsDeletion";
+export declare const AUDIT_FIELDS: readonly ['createdAt', 'updatedAt', 'deletedAt', 'createdById', 'updatedById', 'deletedById'];
+/** Проверяет логические флаги и заменяет отсутствующие значения на false.
+ * @example recordOptions({ softDelete: true }) → { timestamps: false, softDelete: true, auth: false }.
+ */
+export declare function recordOptions(options?: RecordOptions): Required<RecordOptions>;
+/** Ищет условие deletedAt на текущем уровне и в логических ветках, не заходя в поля связанных объектов.
+ * @example mentionsDeletedAt({ or: [{ deletedAt: { ne: null } }] }) → true; { user: { deletedAt: {} } } → false.
+ */
+export declare function mentionsDeletedAt(where: unknown): boolean;

package/dist/src/core/lifecycle/options.js

@@ -0,0 +1,21 @@
+import { isObject } from '../utils.js';
+export const DELETION_META = 'djsDeletion';
+export const AUDIT_FIELDS = ['createdAt', 'updatedAt', 'deletedAt', 'createdById', 'updatedById', 'deletedById'];
+/** Проверяет логические флаги и заменяет отсутствующие значения на false.
+ * @example recordOptions({ softDelete: true }) → { timestamps: false, softDelete: true, auth: false }.
+ */
+export function recordOptions(options = {}) {
+    for (const key of ['timestamps', 'softDelete', 'auth'])
+        if (options[key] !== undefined && typeof options[key] !== 'boolean')
+            throw new Error(`${key} must be boolean`);
+    return { timestamps: options.timestamps ?? false, softDelete: options.softDelete ?? false, auth: options.auth ?? false };
+}
+/** Ищет условие deletedAt на текущем уровне и в логических ветках, не заходя в поля связанных объектов.
+ * @example mentionsDeletedAt({ or: [{ deletedAt: { ne: null } }] }) → true; { user: { deletedAt: {} } } → false.
+ */
+export function mentionsDeletedAt(where) {
+    if (!isObject(where))
+        return false;
+    return Object.hasOwn(where, 'deletedAt') || ['and', 'or'].some((key) => Array.isArray(where[key]) && where[key].some(mentionsDeletedAt)) || mentionsDeletedAt(where.not);
+}
+//# sourceMappingURL=options.js.map

package/dist/src/core/lifecycle/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/core/lifecycle/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYvC,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,CAAU,CAAC;AAC1H;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAAkB,EAAE;IACvD,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,CAAU;QAAE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,kBAAkB,CAAC,CAAC;IAChL,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;AAC3H,CAAC;AACD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC3K,CAAC"}

package/dist/src/core/model.d.ts

@@ -0,0 +1,130 @@
+import { type RecordOptions } from './lifecycle/options.js';
+import type { DatabaseData, JsonValue } from './types.js';
+export interface Field {
+    type: string;
+    description?: string;
+    example?: JsonValue;
+    required?: boolean;
+    nullable?: boolean;
+    default?: JsonValue;
+    enum?: JsonValue[];
+    primary?: boolean;
+    generated?: 'uuid' | 'increment';
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: 'date' | 'date-time' | 'email' | 'uri' | 'uuid';
+    minimum?: number;
+    maximum?: number;
+    source?: string;
+    target?: string;
+    onDelete?: 'restrict' | 'cascade';
+}
+export interface EntityDefinition {
+    timestamps?: boolean;
+    softDelete?: boolean;
+    collection: string;
+    api?: ('openapi' | 'graphql')[];
+    fields: Record<string, Field>;
+}
+export type ModelSchema = Record<string, EntityDefinition>;
+export interface Node extends Field {
+    system?: boolean;
+    internal?: boolean;
+    softDelete?: boolean;
+    path: string;
+    base: string;
+    many: boolean;
+    children: Record<string, Node>;
+    relation?: Entity;
+    implicit?: boolean;
+    mixed?: boolean;
+    relationKey?: boolean;
+}
+export interface Entity {
+    timestamps: boolean;
+    softDelete: boolean;
+    name: string;
+    collection: string;
+    api: ('openapi' | 'graphql')[];
+    primary: string;
+    fields: Record<string, Node>;
+    root: Node;
+}
+export interface Model {
+    options: Required<RecordOptions>;
+    entities: Entity[];
+    byName: Map<string, Entity>;
+    byCollection: Map<string, Entity>;
+    explicit: boolean;
+}
+export type ValidationSchema = Record<string, unknown>;
+/** Разбивает путь по точкам и проверяет допустимость каждого имени.
+ * @example pathParts('profile.name') → ['profile', 'name']; pathParts('a..b') → ошибка.
+ */
+export declare const pathParts: (path: string) => string[];
+/** Находит самый длинный префикс пути среди ключей объекта, учитывая границы сегментов.
+ * @example bindingFor({ a: {}, 'a.b': {} }, 'a.b.id') → 'a.b'; bindingFor({ a: {} }, 'abc.id') → undefined.
+ */
+export declare function bindingFor(bindings: Record<string, unknown>, path: string): string | undefined;
+/** Проверяет, что все сегменты пути объявлены и доступны для записи, включая родительские объекты.
+ * @example Для поля name без ограничений canWriteKey(entity, 'name') → true; для первичного ключа → false.
+ */
+export declare function canWriteKey(entity: Entity, path: string): boolean;
+/** Распознаёт обратную связь: источник совпадает с первичным ключом, а целевой путь отличается от первичного ключа цели.
+ * @example При source = 'id', target = 'authorId' и первичных ключах id → true.
+ */
+export declare function isReverseRelation(entity: Entity, node: Node): boolean;
+/** Собирает значения по вложенному пути, проходя через массивы; отсутствующие значения и null пропускает.
+ * @example readPath({ rows: [{ id: 1 }, { id: 2 }] }, 'rows.id') → [1, 2].
+ */
+export declare const readPath: (value: unknown, path: string | string[]) => unknown[];
+/** Возвращает последний сегмент пути поля.
+ * @example childName({ path: 'profile.name', … }) → 'name'.
+ */
+export declare const childName: (node: Node) => string;
+/** Для связи возвращает целевую сущность и её корень; обычный узел сохраняет без изменений.
+ * @example canonicalNode(author, { relation: book }) → [book, book.root].
+ * @example canonicalNode(author, author.root) → [author, author.root].
+ */
+export declare const canonicalNode: (entity: Entity, node: Node) => [Entity, Node];
+/** Соединяет имя сущности и путь поля, заменяя точки подчёркиваниями.
+ * @example nodeName({ name: 'User', … }, { path: 'profile.name', … }) → 'User_profile_name'.
+ */
+export declare const nodeName: (entity: Entity, node: Node) => string;
+/** Переводит первую букву имени сущности в нижний регистр.
+ * @example operationName({ name: 'UserProfile', … }) → 'userProfile'.
+ */
+export declare const operationName: (entity: Entity) => string;
+/** Загружает описание из объекта или JSON-файла, проверяет поля и сопоставляет связи.
+ * @example loadModel(undefined) → Promise<undefined>; корректное описание → Promise<Model>.
+ */
+export declare function loadModel(source: unknown, settings?: RecordOptions): Promise<Model | undefined>;
+/** Определяет доступность поля для выбранного режима записи, учитывая защищённые дочерние поля.
+ * @example writable({ readOnly: true, … }, 'update') → false.
+ */
+export declare function writable(node: Node, mode: InputMode, relations?: boolean): boolean;
+/** Проверяет наличие явной модели и доступность выбранного формата для её связей.
+ * @example assertApi(undefined, 'graphql') → ошибка; согласованная модель → undefined.
+ */
+export declare function assertApi(model: Model | undefined, api: 'graphql' | 'openapi'): asserts model is Model;
+/** Строит схему проверки значения с ограничениями, массивом и допустимостью null.
+ * @example Для строкового узла без ограничений valueSchema(node) → { type: 'string' }.
+ */
+export declare function valueSchema(node: Node): ValidationSchema;
+export type InputMode = 'stored' | 'create' | 'replace' | 'update';
+/** Строит схему объекта для выбранного режима; при частичном обновлении корневые поля необязательны.
+ * @example Для пустого узла → { type: 'object', properties: {}, additionalProperties: false }.
+ */
+export declare function objectSchema(node: Node, mode: InputMode, root?: boolean, relationSchema?: (node: Node) => ValidationSchema): ValidationSchema;
+export declare function relationInputSchema(node: Node, object?: ValidationSchema): ValidationSchema;
+/** Проверяет запись по схеме выбранного режима и выбрасывает исключение при несоответствии.
+ * @example Обязательное строковое name: { name: 'Анна' } → undefined; { name: 2 } → ошибка.
+ */
+export declare function validateRecord(entity: Entity, value: unknown, mode: InputMode, relations?: boolean): void;
+/** Выводит поля и связи из значений коллекций, не меняя переданные записи.
+ * @example inferModel({ users: [{ id: '1', name: 'Анна' }] }) → модель со строковыми id и name.
+ */
+export declare function inferModel(database: DatabaseData, settings?: RecordOptions): Model;

package/dist/src/{model.js → core/model.js}

@@ -2,6 +2,7 @@ import { readFile } from 'node:fs/promises';
 import { Ajv } from 'ajv';
 import addFormats from 'ajv-formats';
 import { domainError } from './errors.js';
+import { AUDIT_FIELDS, DELETION_META, recordOptions } from './lifecycle/options.js';
 import { getRelationMetadata } from './relation-metadata.js';
 import { assertKnownKeys, isObject, isSafeKey, singularize, toPascalCase } from './utils.js';
 const createValidator = () => {
@@ -34,13 +35,18 @@ const FIELD_KEYS = new Set([
     'target',
     'onDelete',
 ]);
+/** Разбивает путь по точкам и проверяет допустимость каждого имени.
+ * @example pathParts('profile.name') → ['profile', 'name']; pathParts('a..b') → ошибка.
+ */
 export const pathParts = (path) => {
     const parts = path.split('.');
     if (parts.some((p) => !NAME.test(p) || !isSafeKey(p)))
         throw domainError('INVALID_INPUT', `Invalid field path: ${path}`);
     return parts;
 };
-/** Finds the nearest physical object containing a relation key. */
+/** Находит самый длинный префикс пути среди ключей объекта, учитывая границы сегментов.
+ * @example bindingFor({ a: {}, 'a.b': {} }, 'a.b.id') → 'a.b'; bindingFor({ a: {} }, 'abc.id') → undefined.
+ */
 export function bindingFor(bindings, path) {
     let nearest;
     for (const prefix of Object.keys(bindings))
@@ -48,6 +54,9 @@ export function bindingFor(bindings, path) {
             nearest = prefix;
     return nearest;
 }
+/** Проверяет, что все сегменты пути объявлены и доступны для записи, включая родительские объекты.
+ * @example Для поля name без ограничений canWriteKey(entity, 'name') → true; для первичного ключа → false.
+ */
 export function canWriteKey(entity, path) {
     const parts = pathParts(path);
     return parts.every((_, index) => {
@@ -55,9 +64,15 @@ export function canWriteKey(entity, path) {
         return field && !field.primary && !field.generated && !field.readOnly;
     });
 }
+/** Распознаёт обратную связь: источник совпадает с первичным ключом, а целевой путь отличается от первичного ключа цели.
+ * @example При source = 'id', target = 'authorId' и первичных ключах id → true.
+ */
 export function isReverseRelation(entity, node) {
     return node.source === entity.primary || (!canWriteKey(entity, node.source) && canWriteKey(node.relation, node.target));
 }
+/** Собирает значения по вложенному пути, проходя через массивы; отсутствующие значения и null пропускает.
+ * @example readPath({ rows: [{ id: 1 }, { id: 2 }] }, 'rows.id') → [1, 2].
+ */
 export const readPath = (value, path) => {
     const parts = typeof path === 'string' ? pathParts(path) : path;
     if (!parts.length)
@@ -66,8 +81,22 @@ export const readPath = (value, path) => {
         return value.flatMap((v) => readPath(v, parts));
     return isObject(value) && Object.hasOwn(value, parts[0]) ? readPath(value[parts[0]], parts.slice(1)) : [];
 };
+/** Возвращает последний сегмент пути поля.
+ * @example childName({ path: 'profile.name', … }) → 'name'.
+ */
 export const childName = (node) => node.path.split('.').at(-1);
+/** Для связи возвращает целевую сущность и её корень; обычный узел сохраняет без изменений.
+ * @example canonicalNode(author, { relation: book }) → [book, book.root].
+ * @example canonicalNode(author, author.root) → [author, author.root].
+ */
+export const canonicalNode = (entity, node) => (node.relation ? [node.relation, node.relation.root] : [entity, node]);
+/** Соединяет имя сущности и путь поля, заменяя точки подчёркиваниями.
+ * @example nodeName({ name: 'User', … }, { path: 'profile.name', … }) → 'User_profile_name'.
+ */
 export const nodeName = (entity, node) => (node.path ? `${entity.name}_${node.path.replaceAll('.', '_')}` : entity.name);
+/** Переводит первую букву имени сущности в нижний регистр.
+ * @example operationName({ name: 'UserProfile', … }) → 'userProfile'.
+ */
 export const operationName = (entity) => entity.name[0].toLowerCase() + entity.name.slice(1);
 const newNode = (path, field) => ({ ...field, path, base: field.type.replace(/\[\]$/, ''), many: field.type.endsWith('[]'), children: Object.create(null) });
 function addField(entity, path, field, implicit = false) {
@@ -91,6 +120,25 @@ function addField(entity, path, field, implicit = false) {
     entity.fields[path] = node;
     return node;
 }
+function systemFields(entity, options) {
+    const names = [
+        ...(entity.timestamps ? ['createdAt', 'updatedAt'] : []),
+        DELETION_META,
+        ...(entity.softDelete ? ['deletedAt'] : []),
+        ...(options.auth ? ['createdById', 'updatedById', ...(entity.softDelete ? ['deletedById'] : [])] : []),
+    ];
+    entity.root.softDelete = entity.softDelete;
+    for (const name of names) {
+        if (entity.fields[name])
+            throw new Error(`Reserved system field ${entity.name}.${name}`);
+        const node = addField(entity, name, { type: 'string', readOnly: true, nullable: true, ...(name.endsWith('At') ? { format: 'date-time' } : {}) });
+        node.system = true;
+        if (name === DELETION_META) {
+            node.internal = true;
+            node.writeOnly = true;
+        }
+    }
+}
 function checkField(path, field) {
     if (!isObject(field))
         throw new Error(`Field ${path} must be an object`);
@@ -139,7 +187,11 @@ function checkField(path, field) {
     if (typeof field.minLength === 'number' && typeof field.maxLength === 'number' && field.minLength > field.maxLength)
         throw new Error(`${path}: minLength exceeds maxLength`);
 }
-export async function loadModel(source) {
+/** Загружает описание из объекта или JSON-файла, проверяет поля и сопоставляет связи.
+ * @example loadModel(undefined) → Promise<undefined>; корректное описание → Promise<Model>.
+ */
+export async function loadModel(source, settings = {}) {
+    const options = recordOptions(settings);
     if (source === undefined)
         return undefined;
     const schema = typeof source === 'string' ? JSON.parse(await readFile(source, 'utf8')) : structuredClone(source);
@@ -148,11 +200,11 @@ export async function loadModel(source) {
         throw new Error('Model schema must be a nonempty object');
     if ('$schema' in schema || '$info' in schema)
         throw new Error('Legacy $schema/$info format is no longer supported');
-    const model = { entities: [], byName: new Map(), byCollection: new Map(), explicit: true };
+    const model = { entities: [], byName: new Map(), byCollection: new Map(), explicit: true, options };
     for (const [name, definition] of Object.entries(schema)) {
         if (!NAME.test(name) || !isSafeKey(name) || PRIMITIVES.has(name) || !isObject(definition))
             throw new Error(`Invalid model ${name}`);
-        assertKnownKeys(definition, new Set(['collection', 'api', 'fields']), name);
+        assertKnownKeys(definition, new Set(['collection', 'api', 'fields', 'timestamps', 'softDelete']), name);
         if (typeof definition.collection !== 'string' || !/^[A-Za-z][A-Za-z0-9_-]*$/.test(definition.collection) || !isSafeKey(definition.collection))
             throw new Error(`Invalid collection for ${name}`);
         if (model.byCollection.has(definition.collection))
@@ -162,7 +214,17 @@ export async function loadModel(source) {
             throw new Error(`Invalid api for ${name}`);
         if (!isObject(definition.fields))
             throw new Error(`${name}.fields must be an object`);
-        const entity = { name, collection: definition.collection, api, primary: '', fields: Object.create(null), root: newNode('', { type: 'object' }) };
+        const flags = recordOptions({ timestamps: definition.timestamps, softDelete: definition.softDelete });
+        const entity = {
+            timestamps: definition.timestamps === undefined ? options.timestamps : flags.timestamps,
+            softDelete: definition.softDelete === undefined ? options.softDelete : flags.softDelete,
+            name,
+            collection: definition.collection,
+            api,
+            primary: '',
+            fields: Object.create(null),
+            root: newNode('', { type: 'object' }),
+        };
         for (const [path, field] of Object.entries(definition.fields).sort(([a], [b]) => a.split('.').length - b.split('.').length)) {
             checkField(path, field);
             addField(entity, path, field);
@@ -175,6 +237,7 @@ export async function loadModel(source) {
         }
         if (!entity.primary)
             throw new Error(`${name}: primary key is required`);
+        systemFields(entity, options);
         entityValidators.set(entity, ajv);
         model.entities.push(entity);
         model.byName.set(name, entity);
@@ -254,6 +317,9 @@ export async function loadModel(source) {
     }
     return model;
 }
+/** Определяет доступность поля для выбранного режима записи, учитывая защищённые дочерние поля.
+ * @example writable({ readOnly: true, … }, 'update') → false.
+ */
 export function writable(node, mode, relations = false) {
     if (node.relation)
         return relations;
@@ -262,6 +328,9 @@ export function writable(node, mode, relations = false) {
     const children = Object.values(node.children);
     return node.base !== 'object' || children.length === 0 || children.some((child) => writable(child, mode, relations));
 }
+/** Проверяет наличие явной модели и доступность выбранного формата для её связей.
+ * @example assertApi(undefined, 'graphql') → ошибка; согласованная модель → undefined.
+ */
 export function assertApi(model, api) {
     if (!model?.explicit)
         throw new Error(`${api} requires an explicit model schema`);
@@ -270,6 +339,9 @@ export function assertApi(model, api) {
             if (node.relation && !node.relation.api.includes(api))
                 throw new Error(`${entity.name}.${node.path}: ${node.relation.name} does not enable ${api}`);
 }
+/** Строит схему проверки значения с ограничениями, массивом и допустимостью null.
+ * @example Для строкового узла без ограничений valueSchema(node) → { type: 'string' }.
+ */
 export function valueSchema(node) {
     let schema = node.base === 'object' ? objectSchema(node, 'stored') : { type: node.base };
     for (const key of ['minLength', 'maxLength', 'pattern', 'format', 'minimum', 'maximum', 'enum'])
@@ -281,6 +353,9 @@ export function valueSchema(node) {
         schema = { anyOf: [schema, { type: 'null' }] };
     return schema;
 }
+/** Строит схему объекта для выбранного режима; при частичном обновлении корневые поля необязательны.
+ * @example Для пустого узла → { type: 'object', properties: {}, additionalProperties: false }.
+ */
 export function objectSchema(node, mode, root = false, relationSchema) {
     const properties = {};
     const required = [];
@@ -304,6 +379,10 @@ export function objectSchema(node, mode, root = false, relationSchema) {
         if (child.required && !(root && mode === 'update') && !(mode !== 'stored' && child.default !== undefined) && !(relationSchema && child.relationKey))
             required.push(key);
     }
+    // Сохраняем ранее записанные даты и авторов при отключении соответствующих флагов.
+    if (root && mode === 'stored')
+        for (const name of AUDIT_FIELDS)
+            properties[name] ??= { type: ['string', 'null'], ...(name.endsWith('At') ? { format: 'date-time' } : {}) };
     return { type: 'object', properties, additionalProperties: false, ...(required.length ? { required } : {}) };
 }
 export function relationInputSchema(node, object = { type: 'object' }) {
@@ -316,6 +395,9 @@ export function relationInputSchema(node, object = { type: 'object' }) {
     return schema;
 }
 const validators = new WeakMap();
+/** Проверяет запись по схеме выбранного режима и выбрасывает исключение при несоответствии.
+ * @example Обязательное строковое name: { name: 'Анна' } → undefined; { name: 2 } → ошибка.
+ */
 export function validateRecord(entity, value, mode, relations = false) {
     const ajv = entityValidators.get(entity);
     let cache = validators.get(entity);
@@ -332,16 +414,30 @@ export function validateRecord(entity, value, mode, relations = false) {
     if (!validate(value))
         throw domainError('INVALID_INPUT', `${entity.name}: ${ajv.errorsText(validate.errors)}`);
 }
-export function inferModel(database) {
+/** Выводит поля и связи из значений коллекций, не меняя переданные записи.
+ * @example inferModel({ users: [{ id: '1', name: 'Анна' }] }) → модель со строковыми id и name.
+ */
+export function inferModel(database, settings = {}) {
+    const options = recordOptions(settings);
     const valueType = (value) => (isObject(value) ? 'object' : ['string', 'number', 'boolean'].includes(typeof value) ? typeof value : 'string');
-    const model = { entities: [], byName: new Map(), byCollection: new Map(), explicit: false };
+    const model = { entities: [], byName: new Map(), byCollection: new Map(), explicit: false, options };
     for (const [collection, records] of Object.entries(database)) {
         const name = toPascalCase(singularize(collection));
-        const entity = { name, collection, api: [], primary: 'id', fields: Object.create(null), root: newNode('', { type: 'object' }) };
+        const entity = {
+            timestamps: options.timestamps,
+            softDelete: options.softDelete,
+            name,
+            collection,
+            api: [],
+            primary: 'id',
+            fields: Object.create(null),
+            root: newNode('', { type: 'object' }),
+        };
+        systemFields(entity, options);
         const observed = new Map();
         const scan = (record, prefix = '') => {
             for (const [key, value] of Object.entries(record)) {
-                if (!NAME.test(key) || !isSafeKey(key))
+                if (!NAME.test(key) || !isSafeKey(key) || (!prefix && entity.fields[key]?.system))
                     continue;
                 const path = prefix + key;
                 const sample = Array.isArray(value) ? value.find((v) => v !== null) : value;
@@ -382,7 +478,7 @@ export function inferModel(database) {
     const resources = Object.keys(database);
     for (const entity of model.entities)
         for (const field of Object.values(entity.fields)) {
-            if (field.mixed)
+            if (field.mixed || field.system)
                 continue;
             const relation = getRelationMetadata(childName(field), resources, entity.collection);
             if (!relation)