@cuboapp/api-backend 3.0.15 → 4.0.0

package/dist/constants/index.d.ts

@@ -0,0 +1,35 @@
+import { CuboEntityField } from '@cuboapp/types';
+export declare const CUBO_CRUD_QUERY_KEY_REGEX: RegExp;
+export declare const CUBO_CRUD_QUERY_SYMBOL_NOT = "not";
+/**
+ * Separates the field names in an ANY-OF query key: `?a|b=<value>` means "`a` matches OR `b` matches".
+ *
+ * Every other condition in a query is AND-ed, which is right for filtering — each parameter narrows
+ * the result. But some questions are genuinely about a row's relationship to a value regardless of
+ * WHICH column records it: a document involving an organization has it as either the sender or the
+ * receiver, and asking for both as separate parameters would return the documents where it is both.
+ *
+ * One condition, several columns — not a general boolean expression language. That keeps the query
+ * string readable and keeps the SQL to a single parenthesised OR, so it still AND-s with everything
+ * else exactly as a plain key does.
+ */
+export declare const CUBO_CRUD_QUERY_SYMBOL_OR = "|";
+export declare const CUBO_CRUD_DEFAULT_PAGE_LIMIT = 25;
+export declare const CUBO_CRUD_MAX_PAGE_LIMIT = 500;
+export declare const CUBO_CRUD_ACTION: readonly ["create", "read", "update", "delete"];
+export declare const CUBO_CRUD_QUERY_CONDITION: {
+    EQ: string;
+    EX: string;
+    LIKE: string;
+    ILIKE: string;
+    IN: string;
+    NIN: string;
+    GT: string;
+    LT: string;
+    GTE: string;
+    LTE: string;
+    BTW: string;
+};
+export declare const CUBO_CRUD_DEFAULT_FIELDS: Pick<CuboEntityField, 'type' | 'alias' | 'extra'>[];
+export declare const CUBO_CRUD_DEFAULT_FIELDS_ALIASES: string[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAIhD,eAAO,MAAM,yBAAyB,QAAqB,CAAA;AAE3D,eAAO,MAAM,0BAA0B,QAAQ,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAC9C,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C,eAAO,MAAM,gBAAgB,iDAAkD,CAAA;AAE/E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;CAYrC,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,EAyCvF,CAAA;AAED,eAAO,MAAM,gCAAgC,UAA+C,CAAA"}

package/dist/core/index.d.ts

@@ -0,0 +1,77 @@
+import { CuboApiEntitiesMap } from '@cuboapp/types';
+import { CuboCrdtAdapter } from '../crdt';
+import { ApiHelpers } from '../helpers';
+import { CuboQuery } from '../query';
+import { CuboBackendApiAuth, CuboBackendApiOptions, CuboCrudGetManyResponse, CuboCrudMethodOptions, CuboCrudRequest } from '../types';
+/**
+ * CUBO Backend API — метаданные-ориентированный CRUD-движок.
+ *
+ * Перерисованная архитектура:
+ *  - типизированный query-DSL (../query) поверх «строкового» движка;
+ *  - ИММУТАБЕЛЬНЫЕ query-опции: на каждый вызов строится новый объект, хуки
+ *    `before*` возвращают патч, который мёржится в новый объект — состояние
+ *    больше не «протекает» между вложенными вызовами;
+ *  - пакетные операции createMany/updateMany/deleteMany одним запросом + транзакция;
+ *  - корректные read-back'и внутри транзакции (write-соединение, тот же tx);
+ *  - встроенная поддержка cubo-crdt (../crdt) для сущностей с entity.crdt;
+ *  - диалекты Postgres/MySQL (../dialects); s3-хелперы удалены.
+ */
+export declare class CuboBackendApi<T extends CuboApiEntitiesMap<T>, A extends unknown = unknown> {
+    options: CuboBackendApiOptions<T, A>;
+    constructor(options: CuboBackendApiOptions<T, A>);
+    auth: CuboBackendApiAuth;
+    helpers: ApiHelpers<T, A>;
+    crdt?: CuboCrdtAdapter<T, A>;
+    private debounces;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    /** Back-compat: вернуть «голую» транзакцию write-соединения. */
+    transaction(): Promise<import("sequelize").Transaction>;
+    /**
+     * Выполнить fn в транзакции с авто-commit/rollback. Внутри fn все CRUD-вызовы
+     * должны получать opts.transaction (и тогда read-back'и пойдут в write-соединение).
+     */
+    withTransaction<R>(fn: (tx: any) => Promise<R>): Promise<R>;
+    find<K extends Extract<keyof T, string>>(alias: K, query?: CuboQuery<T[K]>, opts?: CuboCrudMethodOptions): Promise<CuboCrudGetManyResponse<T[K]>>;
+    findOne<K extends Extract<keyof T, string>>(alias: K, query?: CuboQuery<T[K]>, opts?: CuboCrudMethodOptions): Promise<T[K]>;
+    create<K extends Extract<keyof T, string>>(alias: K, body: Partial<T[K]>, opts?: CuboCrudMethodOptions): Promise<T[K]>;
+    update<K extends Extract<keyof T, string>>(alias: K, id: number, body: Partial<T[K]>, opts?: CuboCrudMethodOptions): Promise<T[K]>;
+    remove<K extends Extract<keyof T, string>>(alias: K, id: number, opts?: CuboCrudMethodOptions): Promise<boolean>;
+    getMany<K extends Extract<keyof T, string> = Extract<keyof T, string>>(entityAlias: K, req?: CuboCrudRequest, opts?: CuboCrudMethodOptions): Promise<CuboCrudGetManyResponse<T[K]>>;
+    getOne<K extends Extract<keyof T, string> = Extract<keyof T, string>>(entityAlias: K, req: CuboCrudRequest, opts?: CuboCrudMethodOptions): Promise<T[K] | undefined>;
+    createOne<K extends Extract<keyof T, string> = Extract<keyof T, string>>(entityAlias: K, req: CuboCrudRequest, opts?: CuboCrudMethodOptions): Promise<T[K]>;
+    updateOne<K extends Extract<keyof T, string> = Extract<keyof T, string>>(entityAlias: K, req: CuboCrudRequest, opts?: CuboCrudMethodOptions): Promise<T[K] | undefined>;
+    deleteOne<K extends Extract<keyof T, string>>(entityAlias: K, req: CuboCrudRequest, opts?: CuboCrudMethodOptions): Promise<boolean>;
+    /** Пакетное создание одним INSERT (+ транзакция). Возвращает созданные строки. */
+    createMany<K extends Extract<keyof T, string>>(entityAlias: K, rows: Partial<T[K]>[], opts?: CuboCrudMethodOptions): Promise<T[K][]>;
+    /** Пакетное обновление: один UPDATE по id IN (...). Возвращает обновлённые строки. */
+    updateMany<K extends Extract<keyof T, string>>(entityAlias: K, req: CuboCrudRequest, opts?: CuboCrudMethodOptions): Promise<T[K][]>;
+    /** Пакетное (мягкое) удаление: один UPDATE по id IN (...). Возвращает кол-во. */
+    deleteMany<K extends Extract<keyof T, string>>(entityAlias: K, req: CuboCrudRequest, opts?: CuboCrudMethodOptions): Promise<number>;
+    request<R>(url: string, opts?: RequestInit & {
+        debug?: boolean;
+        withAuth?: boolean;
+        withoutContentType?: boolean;
+    }): Promise<R>;
+    private getEntity;
+    private get pkKey();
+    private get pkType();
+    private excluded;
+    /** read-back внутри write-транзакции должен идти в write-соединение и тем же tx. */
+    private connForRead;
+    /** Опции для внутренних read-back'ов: без наследования queryOptions и без хуков чтения. */
+    private readBackOpts;
+    /**
+     * Контекст хука. `queryOptions` передаётся ССЫЛКОЙ на per-call рабочую копию
+     * (свежий cloneDeep на каждый вызов), поэтому хук может либо мутировать её,
+     * либо вернуть свой объект — а накопления/протечки между вызовами нет.
+     */
+    private ctx;
+    /** Вливает raw-условия из query-опций в find-query. */
+    private applyRawQueryOptions;
+    private crdtPush;
+    /** Многострочный INSERT. Postgres -> RETURNING; MySQL -> последовательные autoincrement id. */
+    private insertMany;
+    private updateWhereIds;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/crdt/index.d.ts

@@ -0,0 +1,45 @@
+import type { CuboCrdtServer, CuboCrdtServerDocumentOrigin } from '@cuboapp/crdt';
+import { CuboApiEntitiesMap, CuboEntity } from '@cuboapp/types';
+import type { WsServer, WsServerSocket } from '@cuboapp/ws';
+import type { CuboBackendApi } from '../core';
+/** Тип фабрики, импортируемый только как тип (рантайм-зависимость опциональна). */
+type CreateCrdtServer = typeof import('@cuboapp/crdt')['createCrdtServer'];
+/**
+ * Встроенный адаптер cubo-crdt. Инкапсулирует всю обвязку, которую раньше
+ * приходилось писать в каждом приложении руками (old.ts):
+ *  - fetchRows: подписка тянет строки через api.getMany
+ *  - storeRow: дебаунс-сохранение состояния дока обратно в БД через api.updateOne
+ *  - checkRowIsSutable: фильтрация строк под подписку (augmentation.filterRowForCrdtEvent)
+ *  - push create/update/delete: автоматически из CRUD-методов ядра
+ *
+ * Включается одной опцией `crdt: { ws }` у CuboBackendApi и работает для всех
+ * сущностей с флагом `entity.crdt === true`.
+ */
+export declare class CuboCrdtAdapter<T extends CuboApiEntitiesMap<T>, A> {
+    private api;
+    private ws;
+    private debug;
+    readonly server: CuboCrdtServer<T, A>;
+    constructor(api: CuboBackendApi<T, A>, ws: WsServer, createCrdtServer: CreateCrdtServer, debug?: boolean);
+    /**
+     * Авторизация клиента, владеющего подпиской.
+     *
+     * `checkRowIsSutable` получает только подписку (в ней есть client_id), а права живут на сокете —
+     * поэтому ищем сокет в реестре ws. Нужно для аугментаций, которые прячут строки по правам: гидрация
+     * подписки идёт через getMany с auth и такие строки не отдаст, а живой пуш без этого отдал бы.
+     */
+    private authOf;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    addClient(client: WsServerSocket<{
+        auth?: A;
+    }>): void;
+    removeClient(client: WsServerSocket): void;
+    /** Поддерживается ли CRDT для сущности. */
+    isSupported(entity: CuboEntity): boolean;
+    pushCreate(entity: CuboEntity, row: any): void;
+    pushUpdate(entity: CuboEntity, row: any): void;
+    pushDelete(entity: CuboEntity, row: any, origin?: CuboCrdtServerDocumentOrigin): void;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crdt/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,4BAA4B,EAG7B,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAG3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,mFAAmF;AACnF,KAAK,gBAAgB,GAAG,cAAc,eAAe,CAAC,CAAC,kBAAkB,CAAC,CAAA;AAc1E;;;;;;;;;;GAUG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAI3D,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,EAAE;IAEV,OAAO,CAAC,KAAK;IANf,SAAgB,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBAGlC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EACzB,EAAE,EAAE,QAAQ,EACpB,gBAAgB,EAAE,gBAAgB,EAC1B,KAAK,UAAQ;IAoDvB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAOD,IAAI;IAIJ,OAAO;IAKb,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;QAAE,IAAI,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;IAI9C,YAAY,CAAC,MAAM,EAAE,cAAc;IAI1C,2CAA2C;IACpC,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAKxC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG;IAKvC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG;IAevC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,4BAA4B;CAItF"}

package/dist/dialects/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Слой диалектов БД. Раньше SQL-генерация была заточена под Postgres
+ * (`ilike`, `returning`). Теперь различия спрятаны за интерфейсом CuboDialect,
+ * и движок одинаково работает с Postgres и MySQL.
+ *
+ * Сам @cuboapp/database уже умеет insert/update/delete под оба диалекта;
+ * здесь покрываются различия SELECT-билдера (в первую очередь ILIKE и
+ * пакетные insert/update).
+ */
+export type CuboDialectName = 'postgres' | 'mysql';
+export interface CuboDialect {
+    name: CuboDialectName;
+    /** Регистронезависимый LIKE. Postgres — нативный ILIKE; MySQL — LOWER() LIKE LOWER(). */
+    ilike(field: string, param: string, isNot: boolean): string;
+    /** Поддерживает ли RETURNING (Postgres). У MySQL — insertId / lastval. */
+    supportsReturning: boolean;
+}
+export declare const postgresDialect: CuboDialect;
+export declare const mysqlDialect: CuboDialect;
+export declare function getDialect(name?: string | null): CuboDialect;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dialects/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,CAAA;AAElD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAA;IAErB,yFAAyF;IACzF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IAE3D,0EAA0E;IAC1E,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,eAAe,EAAE,WAI7B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,WAI1B,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAE5D"}

package/dist/helpers/convert.d.ts

@@ -0,0 +1,11 @@
+import { CuboApiEntitiesMap, CuboEntity } from '@cuboapp/types';
+import { CuboCrudFindQuery, CuboCrudRequest } from '../types';
+import { ApiHelpers } from '.';
+export declare class ApiHelpersConvert<T extends CuboApiEntitiesMap<T>> {
+    helpers: ApiHelpers<T>;
+    constructor(helpers: ApiHelpers<T>);
+    prepareAll(req: CuboCrudRequest, entity: CuboEntity, rows: any[], query?: Partial<CuboCrudFindQuery>): Promise<any[]>;
+    prepareOne(req: CuboCrudRequest, entity: CuboEntity, row: any, query?: Partial<CuboCrudFindQuery>): Promise<any>;
+    private prepareFieldValue;
+}
+//# sourceMappingURL=convert.d.ts.map

package/dist/helpers/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/helpers/convert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAmB,MAAM,gBAAgB,CAAA;AAIhF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAA;AAE9B,qBAAa,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;gBAAtB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAE5B,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAQrH,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAsE9G,OAAO,CAAC,iBAAiB;CAsB1B"}

package/dist/helpers/data.d.ts

@@ -0,0 +1,5 @@
+import { CuboApiEntitiesMap, CuboEntityField } from '@cuboapp/types';
+export declare class ApiHelpersData<T extends CuboApiEntitiesMap<T>> {
+    prepare(type: 'create' | 'update' | 'delete', fields: CuboEntityField[], dto?: any, performer_id?: string): any;
+}
+//# sourceMappingURL=data.d.ts.map

package/dist/helpers/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/helpers/data.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAKpE,qBAAa,cAAc,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM;CAkJjH"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,42 @@
+import { Database } from '@cuboapp/database';
+import { CuboApiEntitiesMap, CuboEntity, CuboEntityField, CuboEntityFieldExtra, CuboEntityFieldType } from '@cuboapp/types';
+import type { CuboBackendApi } from '../core';
+import { CuboDialect } from '../dialects';
+import { CuboBackendApiDbConnectionType, CuboCrudFindQuery, CuboCrudRequest } from '../types';
+import { ApiHelpersConvert } from './convert';
+import { ApiHelpersData } from './data';
+import { ApiHelpersWithes } from './withes';
+export declare class ApiHelpers<T extends CuboApiEntitiesMap<T>, A = unknown> {
+    api: CuboBackendApi<T, A>;
+    constructor(api: CuboBackendApi<T, A>);
+    withes: ApiHelpersWithes<T>;
+    convert: ApiHelpersConvert<T>;
+    data: ApiHelpersData<T>;
+    /** Текущий диалект БД (postgres по умолчанию). */
+    get dialect(): CuboDialect;
+    private cache;
+    private fetching;
+    private connections;
+    private connecting;
+    getCached(alias: string, cb: (force: boolean) => Promise<any>, force?: boolean): any;
+    clearFieldConditionValue(field: CuboEntityField | {
+        type: CuboEntityFieldType;
+        alias: string;
+        extra?: CuboEntityFieldExtra;
+    }, value: any): {
+        value: any;
+        is_not: boolean;
+        condition: string;
+    };
+    prepareConditionSql(field: string, replacement: string, value: any, condition: string, is_not: boolean): {
+        conditions: string[];
+        replacements: Record<string, any>;
+    };
+    dropConnection(type: CuboBackendApiDbConnectionType): Promise<void>;
+    getConnection(type: CuboBackendApiDbConnectionType, create?: boolean): Promise<Database>;
+    transaction(type: CuboBackendApiDbConnectionType): Promise<import("sequelize").Transaction>;
+    getEntityByAlias(alias: keyof T): Promise<CuboEntity | undefined>;
+    getEntityById(id: string): Promise<CuboEntity | undefined>;
+    createFindQuery(req: CuboCrudRequest, entity: CuboEntity, queryDto?: Partial<CuboCrudFindQuery>, isCount?: boolean): Promise<Partial<CuboCrudFindQuery>>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAkB,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAG3H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAU7C,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE3C,qBAAa,UAAU,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO;IAC/C,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;gBAAzB,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAErC,MAAM,sBAAgC;IACtC,OAAO,uBAAiC;IACxC,IAAI,oBAA0B;IAErC,kDAAkD;IAClD,IAAW,OAAO,IAAI,WAAW,CAEhC;IAED,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,WAAW,CAAgE;IACnF,OAAO,CAAC,UAAU,CAAwC;IAEnD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,UAAQ;IAsB5E,wBAAwB,CAC7B,KAAK,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,oBAAoB,CAAA;KAAE,EACnG,KAAK,EAAE,GAAG;;;;;IAmML,mBAAmB,CACxB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE;IAkFjD,cAAc,CAAC,IAAI,EAAE,8BAA8B;IAOnD,aAAa,CAAC,IAAI,EAAE,8BAA8B,EAAE,MAAM,UAAO;IA+BjE,WAAW,CAAC,IAAI,EAAE,8BAA8B;IAMhD,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIjE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAI1D,eAAe,CAC1B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACrC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAiKvC"}

package/dist/helpers/withes.d.ts

@@ -0,0 +1,10 @@
+import { CuboApiEntitiesMap, CuboEntity } from '@cuboapp/types';
+import { CuboCrudFindQuery, CuboCrudMethodOptions, CuboCrudRequest } from '../types';
+import { ApiHelpers } from '.';
+export declare class ApiHelpersWithes<T extends CuboApiEntitiesMap<T>> {
+    private helpers;
+    constructor(helpers: ApiHelpers<T>);
+    private getKeyWithes;
+    prepare(req: CuboCrudRequest, entity: CuboEntity, opts?: CuboCrudMethodOptions): Promise<Partial<CuboCrudFindQuery>>;
+}
+//# sourceMappingURL=withes.d.ts.map

package/dist/helpers/withes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withes.d.ts","sourceRoot":"","sources":["../../src/helpers/withes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiC,UAAU,EAAmB,MAAM,gBAAgB,CAAA;AAI/G,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAA+C,MAAM,UAAU,CAAA;AAEjI,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAA;AAE9B,qBAAa,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAE5B,YAAY;IAsNb,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;CA4ElI"}

package/dist/hooks/constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Единый источник правды по именам хуков. Раньше список ключей `excludeHooks`
+ * дублировался руками в типе CuboCrudMethodOptions и легко рассинхронизировался.
+ */
+export declare const CUBO_HOOKS: readonly ["beforeGetMany", "afterGetMany", "beforeGetOne", "afterGetOne", "beforeCreate", "afterCreate", "beforeUpdate", "afterUpdate", "beforeDelete", "afterDelete", "afterCrdtCreate", "afterCrdtUpdate", "baseHooks"];
+export type CuboHookName = (typeof CUBO_HOOKS)[number];
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/hooks/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU,2NAcb,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/hooks/define.d.ts

@@ -0,0 +1,63 @@
+import { CuboApiEntitiesMap } from '@cuboapp/types';
+import { CuboAugmentation, CuboAugmentationsStore } from './types';
+/**
+ * Identity-хелпер: фиксирует тип строки сущности (и auth) ОДИН раз, после чего
+ * в каждом хуке `ctx` выводится контекстно — аннотировать `CuboHookCtx<...>`
+ * больше не нужно.
+ *
+ * @example
+ * export const taskAugmentation = defineAugmentation<Task, Auth>({
+ *   async beforeGetMany({ req, queryOptions }) {   // ← всё типизировано без аннотаций
+ *     // ctx.queryOptions уже нормализован: массивы/объекты гарантированно есть,
+ *     // можно сразу мутировать без `|| []` / `|| {}`
+ *     if (req.query?.company_id) queryOptions.replacements.company_id = Number(req.query.company_id)
+ *     return queryOptions
+ *   }
+ * })
+ */
+export declare function defineAugmentation<R, A = unknown>(augmentation: CuboAugmentation<R, A>): CuboAugmentation<R, A>;
+/** Тип функции-хука аугментации по ключу `K` (без `undefined`). */
+export type CuboAugmentationHook<R, A, K extends keyof CuboAugmentation<R, A>> = NonNullable<CuboAugmentation<R, A>[K]>;
+/**
+ * Identity-хелпер для ОДНОГО хука: фиксирует тип строки (R) и auth (A), а тип
+ * `callback` выводится из переданного `key` — например, для `'beforeGetMany'`
+ * это будет ровно сигнатура `beforeGetMany`. Возвращает типизированную функцию
+ * хука: её можно положить в нужный ключ аугментации или переиспользовать.
+ *
+ * Реализовано перегрузками (overloads): один вызов, R/A задаются явно, нужная
+ * сигнатура выбирается по строковому литералу `key`.
+ *
+ * @example
+ * const beforeGetMany = defineAugmentationHook<Task, Auth>('beforeGetMany', ({ req, queryOptions }) => {
+ *   if (req.query?.company_id) queryOptions.conditions.push('t1.company_id = :company_id')
+ *   return queryOptions
+ * })
+ *
+ * export const taskAugmentation: CuboAugmentation<Task, Auth> = { beforeGetMany }
+ */
+export declare function defineAugmentationHook<R, A = unknown>(key: 'beforeGetMany', callback: CuboAugmentationHook<R, A, 'beforeGetMany'>): CuboAugmentationHook<R, A, 'beforeGetMany'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'beforeGetOne', callback: CuboAugmentationHook<R, A, 'beforeGetOne'>): CuboAugmentationHook<R, A, 'beforeGetOne'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'beforeCreate', callback: CuboAugmentationHook<R, A, 'beforeCreate'>): CuboAugmentationHook<R, A, 'beforeCreate'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'beforeUpdate', callback: CuboAugmentationHook<R, A, 'beforeUpdate'>): CuboAugmentationHook<R, A, 'beforeUpdate'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'beforeDelete', callback: CuboAugmentationHook<R, A, 'beforeDelete'>): CuboAugmentationHook<R, A, 'beforeDelete'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'afterGetMany', callback: CuboAugmentationHook<R, A, 'afterGetMany'>): CuboAugmentationHook<R, A, 'afterGetMany'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'afterGetOne', callback: CuboAugmentationHook<R, A, 'afterGetOne'>): CuboAugmentationHook<R, A, 'afterGetOne'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'afterCreate', callback: CuboAugmentationHook<R, A, 'afterCreate'>): CuboAugmentationHook<R, A, 'afterCreate'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'afterUpdate', callback: CuboAugmentationHook<R, A, 'afterUpdate'>): CuboAugmentationHook<R, A, 'afterUpdate'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'afterDelete', callback: CuboAugmentationHook<R, A, 'afterDelete'>): CuboAugmentationHook<R, A, 'afterDelete'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'afterCrdtCreate', callback: CuboAugmentationHook<R, A, 'afterCrdtCreate'>): CuboAugmentationHook<R, A, 'afterCrdtCreate'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'afterCrdtUpdate', callback: CuboAugmentationHook<R, A, 'afterCrdtUpdate'>): CuboAugmentationHook<R, A, 'afterCrdtUpdate'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'can', callback: CuboAugmentationHook<R, A, 'can'>): CuboAugmentationHook<R, A, 'can'>;
+export declare function defineAugmentationHook<R, A = unknown>(key: 'filterRowForCrdtEvent', callback: CuboAugmentationHook<R, A, 'filterRowForCrdtEvent'>): CuboAugmentationHook<R, A, 'filterRowForCrdtEvent'>;
+/**
+ * То же, но сразу для всей карты аугментаций. Внутри каждой сущности `ctx`
+ * хуков типизируется по её строке автоматически.
+ *
+ * @example
+ * export const augmentations = defineAugmentations<Entities, Auth>({
+ *   task: { async beforeGetMany({ req, queryOptions }) { ... } },
+ *   user: { async afterGetOne({ row }) { ... } }
+ * })
+ */
+export declare function defineAugmentations<T extends CuboApiEntitiesMap<T>, A = unknown>(store: Partial<CuboAugmentationsStore<T, A>>): Partial<CuboAugmentationsStore<T, A>>;
+//# sourceMappingURL=define.d.ts.map

package/dist/hooks/define.d.ts.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export * from './constants';
+export * from './types';
+export * from './define';
+export * from './subscribe';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/hooks/subscribe.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Subscribing a module backend to its declared hooks (hooks.md §5).
+ *
+ * A module's hooks are declared on its version, next to the entities they belong to. This is the
+ * other half: the running build telling the core "I am alive, I am this version, and these are the
+ * tuples I actually implement". The core binds the declarations to this process, works out which
+ * accounts that touches — a module backend serves every account it is installed in and deliberately
+ * cannot enumerate them — and compiles the chain.
+ *
+ * What a module backend has to write is one call:
+ *
+ *     const stop = subscribeHooks({
+ *       apiUrl: process.env.CUBO_API_URL!,
+ *       token: process.env.CUBO_TOKEN!,
+ *       version: process.env.CUBO_MODULE_VERSION!,
+ *       baseUrl: 'http://flowers-be:9100',
+ *       implemented: tuplesFrom(READS, ENRICH, AFTER, VIRTUAL_FIELDS)
+ *     })
+ *
+ * and call `stop()` on shutdown. Everything else — the renewal interval, the TTL contract, the boot
+ * diff, the graceful unsubscribe — lives here so no module has to reimplement a protocol.
+ */
+/** How often to renew. The core treats a subscription older than 30s as dead, so this has slack. */
+export declare const SUBSCRIBE_INTERVAL_MS = 10000;
+export interface SubscribeOptions {
+    /** The core API base url, e.g. `http://cubo-api:4000`. */
+    apiUrl: string;
+    /** This service's `cubo-module-service` token — the same one `/auth/me` accepts. */
+    token: string;
+    /** The module VERSION id this build implements. Hooks are a contract with one specific build. */
+    version: string;
+    /**
+     * Where this service can be reached, e.g. `http://flowers-be:9100`.
+     *
+     * Honoured only for the module owner's own account. Everywhere else the core resolves the endpoint
+     * from the deployment record instead — the hook url is where the instance sends a live,
+     * identity-scoped credential, so it must not be settable by whoever holds this token.
+     */
+    baseUrl?: string;
+    /** The tuples this build implements: `entity:method:phase`. See `hookTuples`. */
+    implemented: string[];
+    /** Called with the core's boot diff on every successful subscribe. */
+    onDiff?: (diff: SubscribeDiff) => void;
+    /** Called when a renewal fails. Default logs; the loop keeps trying. */
+    onError?: (error: unknown) => void;
+    fetchImpl?: typeof fetch;
+}
+export interface SubscribeDiff {
+    declared: string[];
+    /** Declared but not implemented by this build. */
+    missing: string[];
+    /** The subset of `missing` the module marked required — every write on those will fail closed. */
+    missing_required: string[];
+    /** Implemented but never declared. Harmless (the core will not call them) but usually an oversight. */
+    undeclared: string[];
+}
+/**
+ * Turn a module's dispatch maps into the tuple list the core diffs against.
+ *
+ * Module backends key their handlers by `entity:method` and split before/after by route, which is the
+ * convention the declaration format was lifted FROM — so the tuples can be derived from the code
+ * rather than maintained beside it. Anything derived cannot drift.
+ */
+export declare function hookTuples(maps: {
+    /** Read rewrites — before-phase on the methods each key names. */
+    before?: Record<string, unknown>;
+    /** Response shaping / write effects — after-phase. */
+    after?: Record<string, unknown>;
+    /** Entities whose write bodies are stripped before the engine sees them: create + update, before. */
+    virtualFields?: string[] | Record<string, unknown>;
+}): string[];
+export interface Subscription {
+    /** Unsubscribe and stop renewing. Safe to call more than once. */
+    stop: () => Promise<void>;
+    /** Force a renewal now — useful in tests, and after a deploy changes what is implemented. */
+    renew: () => Promise<SubscribeDiff | null>;
+}
+/**
+ * Start the subscribe loop. Returns immediately; the first renewal runs in the background so a slow
+ * or unreachable core cannot hold up the service's own boot.
+ */
+export declare function subscribeHooks(options: SubscribeOptions): Subscription;
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/hooks/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../src/hooks/subscribe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,oGAAoG;AACpG,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAA;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IACtC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,kGAAkG;IAClG,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,uGAAuG;IACvG,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnD,GAAG,MAAM,EAAE,CAUX;AAED,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CAC3C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA8DtE"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,60 @@
+import { CuboApiEntitiesMap, CuboEntity } from '@cuboapp/types';
+import { CuboCrudAction, CuboCrudGetManyResponse, CuboCrudRequest } from '../types/basic';
+import { CuboCrudQueryOptions, CuboCrudQueryOptionsInput } from '../types/db';
+export type MaybePromise<X> = X | Promise<X>;
+/**
+ * Контекст хука. `queryOptions` — это per-call РАБОЧАЯ КОПИЯ опций: каждый вызов
+ * получает свой свежий объект, так что состояние НЕ «накапливается» и не
+ * протекает между вызовами (внутренние getOne после create/update чужие опции
+ * не наследуют). Хук может либо мутировать эту копию, либо вернуть свой объект
+ * опций — движок возьмёт возвращённое значение (если оно есть), иначе текущую
+ * (возможно, изменённую) копию.
+ */
+export type CuboHookCtx<R, A = unknown> = {
+    entity: CuboEntity;
+    req: CuboCrudRequest;
+    auth?: A;
+    performer_id?: string;
+    queryOptions: CuboCrudQueryOptions;
+};
+export interface CuboAugmentation<R, A = unknown> {
+    beforeGetMany?(ctx: CuboHookCtx<R, A>): MaybePromise<CuboCrudQueryOptionsInput | void>;
+    beforeGetOne?(ctx: CuboHookCtx<R, A>): MaybePromise<CuboCrudQueryOptionsInput | void>;
+    beforeCreate?(ctx: CuboHookCtx<R, A>): MaybePromise<CuboCrudQueryOptionsInput | void>;
+    beforeUpdate?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+    }): MaybePromise<CuboCrudQueryOptionsInput | void>;
+    beforeDelete?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+    }): MaybePromise<CuboCrudQueryOptionsInput | void>;
+    afterGetMany?(ctx: CuboHookCtx<R, A> & {
+        result: CuboCrudGetManyResponse<R>;
+    }): MaybePromise<CuboCrudGetManyResponse<R>>;
+    afterGetOne?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+    }): MaybePromise<R | undefined>;
+    afterCreate?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+    }): MaybePromise<R>;
+    afterUpdate?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+        prev: R;
+    }): MaybePromise<R>;
+    afterDelete?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+    }): MaybePromise<boolean>;
+    afterCrdtCreate?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+    }): MaybePromise<void>;
+    afterCrdtUpdate?(ctx: CuboHookCtx<R, A> & {
+        row: R;
+    }): MaybePromise<void>;
+    can?(action: CuboCrudAction, ctx: CuboHookCtx<R, A> & {
+        row?: R;
+    }): MaybePromise<boolean>;
+    filterRowForCrdtEvent?(row: R, filters: Record<string, any>, auth?: A): boolean;
+}
+export type CuboAugmentationsStore<T extends CuboApiEntitiesMap<T>, A = unknown> = {
+    [K in Extract<keyof T, string>]?: CuboAugmentation<T[K], A>;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './core';
+export * from './types';
+export * from './helpers';
+export * from './hooks';
+export * from './query';
+export * from './dialects';
+export * from './crdt';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA"}

package/dist/query/compile.d.ts

@@ -0,0 +1,14 @@
+import { CuboCompiledQuery, CuboQuery } from './types';
+/**
+ * Компилирует типизированный CuboQuery<R> в плоский «строковый» запрос движка
+ * (CuboCrudRequest.query). Чистая функция: на каждый вызов создаётся новый
+ * объект — query-опции иммутабельны по построению, ничего не «накапливается».
+ *
+ * Поддержка операторов через flat-DSL:
+ *   eq/ne/gt/gte/lt/lte/in/nin/like/ilike/between/isNull/not.
+ * Диапазон gte+lte на одном поле автоматически сворачивается в between.
+ * Экзотические комбинации (>1 оператора, не сводящиеся к диапазону) —
+ * через escape-hatch `raw` в CuboCrudMethodOptions.queryOptions.
+ */
+export declare function compileQuery<R>(query?: CuboQuery<R>): CuboCompiledQuery;
+//# sourceMappingURL=compile.d.ts.map

package/dist/query/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/query/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAU,SAAS,EAAsB,MAAM,SAAS,CAAA;AAElF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAkCvE"}

package/dist/query/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './compile';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA"}