@kollors/deep-json-server 1.0.0-beta.1 → 1.0.0-beta.3

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

@@ -0,0 +1,24 @@
+import { Ajv } from 'ajv';
+import { type InputMode } from './policy.js';
+import type { Entity, Node, ValidationSchema } from './types.js';
+/** Создаёт независимый валидатор JSON Schema с форматами и строгой проверкой без преобразования данных.
+ * @example createValidator().validate({ type: 'number' }, '1') → false.
+ */
+export declare const createValidator: () => Ajv;
+export declare const entityValidators: WeakMap<Entity, Ajv>;
+/** Строит схему проверки значения с ограничениями, массивом и допустимостью null.
+ * @example Для строкового узла без ограничений valueSchema(node) → { type: 'string' }.
+ */
+export declare function valueSchema(node: Node): ValidationSchema;
+/** Строит схему объекта для выбранного режима; при частичном обновлении корневые поля необязательны.
+ * @example Для пустого узла → { type: 'object', properties: {}, additionalProperties: false }.
+ */
+export declare function objectSchema(node: Node, mode: InputMode, root?: boolean, relationSchema?: (node: Node) => ValidationSchema): ValidationSchema;
+/** Описывает ввод связанной записи: первичный ключ или объект, при необходимости — массив таких значений.
+ * @example Связь со строковым ключом → anyOf для строки и объекта; many: true → массив.
+ */
+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;

package/dist/src/core/model/validation.js

@@ -0,0 +1,96 @@
+import { Ajv } from 'ajv';
+import addFormats from 'ajv-formats';
+import { domainError } from '../errors.js';
+import { AUDIT_FIELDS } from '../lifecycle/options.js';
+import { requiredInput, writable } from './policy.js';
+import { fieldAt, requireRelation } from './tree.js';
+/** Создаёт независимый валидатор JSON Schema с форматами и строгой проверкой без преобразования данных.
+ * @example createValidator().validate({ type: 'number' }, '1') → false.
+ */
+export const createValidator = () => {
+    const ajv = new Ajv({ allErrors: true, coerceTypes: false, removeAdditional: false, strict: true, ownProperties: true });
+    addFormats.default(ajv);
+    return ajv;
+};
+export const entityValidators = new WeakMap();
+/** Строит схему проверки значения с ограничениями, массивом и допустимостью 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'])
+        if (node[key] !== undefined)
+            schema[key] = node[key];
+    if (node.many)
+        schema = { type: 'array', items: schema };
+    if (node.nullable)
+        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 = [];
+    for (const [key, child] of Object.entries(node.children)) {
+        if (child.virtual)
+            continue;
+        if (child.relation) {
+            if (mode !== 'stored' && relationSchema)
+                properties[key] = relationSchema(child);
+            continue;
+        }
+        if (mode !== 'stored' && !writable(child, mode, !!relationSchema))
+            continue;
+        properties[key] =
+            child.base === 'object'
+                ? (() => {
+                    let s = objectSchema(child, mode, false, relationSchema);
+                    if (child.many)
+                        s = { type: 'array', items: s };
+                    return child.nullable ? { anyOf: [s, { type: 'null' }] } : s;
+                })()
+                : valueSchema(child);
+        if (requiredInput(child, mode, root, !!relationSchema))
+            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 } : {}) };
+}
+/** Описывает ввод связанной записи: первичный ключ или объект, при необходимости — массив таких значений.
+ * @example Связь со строковым ключом → anyOf для строки и объекта; many: true → массив.
+ */
+export function relationInputSchema(node, object = { type: 'object' }) {
+    const target = requireRelation(node).relation;
+    let schema = { anyOf: [valueSchema(fieldAt(target, target.primary)), object] };
+    if (node.many)
+        schema = { type: 'array', items: schema };
+    else if (node.nullable)
+        schema = { anyOf: [schema, { type: 'null' }] };
+    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);
+    if (!cache) {
+        cache = new Map();
+        validators.set(entity, cache);
+    }
+    const key = `${mode}:${relations}`;
+    let validate = cache.get(key);
+    if (!validate) {
+        validate = ajv.compile(objectSchema(entity.root, mode, true, relations ? (node) => relationInputSchema(node) : undefined));
+        cache.set(key, validate);
+    }
+    if (!validate(value))
+        throw domainError('INVALID_INPUT', `${entity.name}: ${ajv.errorsText(validate.errors)}`);
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/core/model/validation.js.map

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

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

@@ -1,146 +1,6 @@
-import { type RecordOptions } from './lifecycle/options.js';
-import type { WriteMode } from './operations.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 ApiFormat = 'openapi' | 'graphql';
-export interface ModelSchema {
-    models: Record<string, EntityDefinition>;
-    api?: ApiFormat[];
-    timestamps?: boolean;
-    softDelete?: boolean;
-}
-export interface ModelOptions {
-    auth?: boolean;
-    api?: ApiFormat[];
-}
-/** Проверяет список форматов и возвращает его независимую копию.
- * @example apiFormats(['graphql']) → ['graphql']; ['unknown'] → ошибка.
- */
-export declare function apiFormats(value: unknown, fallback: ApiFormat[], label: string): ApiFormat[];
-export interface Node extends Field {
-    system?: boolean;
-    internal?: boolean;
-    virtual?: 'actions';
-    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?: ModelOptions): 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' | WriteMode;
-/** Строит схему объекта для выбранного режима; при частичном обновлении корневые поля необязательны.
- * @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;
+export { inferModel } from './model/infer.js';
+export { apiFormats, loadModel } from './model/load.js';
+export { assertApi, type InputMode, requiredInput, writable } from './model/policy.js';
+export { bindingFor, canonicalNode, canWriteKey, childName, fieldAt, isReverseRelation, nodeName, operationName, pathParts, readPath, requireRelation } from './model/tree.js';
+export * from './model/types.js';
+export { objectSchema, relationInputSchema, validateRecord, valueSchema } from './model/validation.js';