@querykitjs/core 1.2.0 → 2.0.0

package/dist/raw-Bx8c-TrC.d.cts

@@ -0,0 +1,290 @@
+/**
+ * Filter operatorlari — yagona runtime manba. `FilterOperator` tipi (`types.ts`)
+ * shundan chiqadi; `@querykitjs/zod` shu massivdan zod enum quradi.
+ */
+declare const FILTER_OPERATORS: readonly ["=", "!=", ">", ">=", "<", "<=", "eq", "ne", "gt", "gte", "lt", "lte", "like", "ilike", "notLike", "contains", "startsWith", "endsWith", "%_%", "%_", "_%", "in", "notIn", "between", "notBetween", "isNull", "isNotNull"];
+/**
+ * Qiymati **text pattern** bo'lgan operatorlar. Backend adapterlari wire qiymatni
+ * ustun/path tipiga cast qilishda shularni chetlab o'tadi — aks holda
+ * `ilike(dateColumn, "%2026%")` ISO string o'rniga `String(Date)` olardi
+ * (`"Mon Jul 28 2026 …"`). Ro'yxat ikki adapterda divergent bo'lmasligi uchun
+ * shu yerda — yagona manba.
+ */
+declare const TEXT_FILTER_OPERATORS: readonly ["like", "ilike", "notLike", "contains", "startsWith", "endsWith", "%_%", "%_", "_%"];
+
+/**
+ * `@querykitjs/core` — ORM-agnostik query DSL tiplari. Backend adapterlar
+ * (`@querykitjs/drizzle-pg`) va frontend (`@querykitjs/web`) shu bir xil kontraktga
+ * tayanadi. Tiplar ustun-kaliti (`TKey`) bo'yicha generic; adapterlar uni o'z
+ * kalit tipiga (Drizzle jadval ustuni yoki entity maydoni) ixtisoslashtiradi.
+ */
+
+/** Qo'llab-quvvatlanadigan filter operatorlari (token va nom aliaslari). */
+type FilterOperator = (typeof FILTER_OPERATORS)[number];
+/**
+ * Tiplangan kalit, lekin har qanday `string` ham qabul qilinadi. Wire (JSON) har
+ * doim string-keyed keladi va adapterlar noma'lum kalitni baribir skip qiladi —
+ * tip shunchaki haqiqatni aytsin, route'da `as` cast kerak bo'lmasin.
+ *
+ * `(string & {})` — autocomplete'ni saqlaydigan TS trick'i: IDE `TKey`
+ * variantlarini taklif qiladi, boshqa string esa xato bermaydi.
+ */
+type LooseKey<TKey extends string> = TKey | (string & {});
+/**
+ * A filter scalar. `Date` is accepted **in-memory** (adapters cast it for local
+ * queries); over the JSON wire it serializes to an ISO string, so
+ * `@querykitjs/zod` validates scalars **without** `Date` (string/number/boolean/null).
+ */
+type FilterScalar = string | number | boolean | Date | null;
+type FilterValue = FilterScalar | FilterScalar[];
+/** Bitta maydon sharti (`operation` default `"="`). */
+interface FieldCondition<TKey extends string = string> {
+    key: TKey;
+    operation?: FilterOperator;
+    value?: FilterValue;
+}
+interface AndGroup<TKey extends string = string, TRaw = never> {
+    and: FilterNode<TKey, TRaw>[];
+}
+interface OrGroup<TKey extends string = string, TRaw = never> {
+    or: FilterNode<TKey, TRaw>[];
+}
+interface NotGroup<TKey extends string = string, TRaw = never> {
+    not: FilterNode<TKey, TRaw>;
+}
+/**
+ * Filter daraxti tuguni: maydon sharti, mantiqiy guruh, yoki adapter qo'shadigan
+ * raw escape-hatch (`TRaw`, masalan Drizzle `SQL`; default `never`).
+ */
+type FilterNode<TKey extends string = string, TRaw = never> = FieldCondition<TKey> | AndGroup<TKey, TRaw> | OrGroup<TKey, TRaw> | NotGroup<TKey, TRaw> | TRaw;
+/** Public filter: daraxt/tugun yoki flat massiv (implicit AND). */
+type Filter<TKey extends string = string, TRaw = never> = FilterNode<TKey, TRaw> | FieldCondition<TKey>[];
+type SortDirection = "asc" | "desc";
+/** One sort field — `{ key, direction }`. */
+interface SortItem<TKey extends string = string> {
+    key: TKey;
+    direction?: SortDirection;
+}
+/** Sort is **always an array** of {@link SortItem} (multi-field capable). */
+type Sort<TKey extends string = string> = SortItem<TKey>[];
+/** Scope qiymati ro'yxat bo'yicha (task 014): `{ in: [...] }`; bo'sh ro'yxat — hech qanday qator. */
+interface ScopeIn {
+    in: readonly FilterScalar[];
+}
+/**
+ * Scoped repository'ning har amaliga qo'llanadigan scope: maydon → tenglik qiymati yoki `{ in: [...] }`.
+ * `create` default'lari faqat tenglik scope'laridan olinadi.
+ */
+type Scope<TKey extends string = string> = Partial<Record<TKey, FilterScalar | ScopeIn>>;
+/** Options for upsert / upsertMany — conflict target(s) + optional update set. */
+interface UpsertOptions<TKey extends string = string, TInsert = Record<string, unknown>> {
+    /** Unique/conflict key(s) whose match triggers an update instead of an insert. */
+    target: TKey | TKey[];
+    /** Columns/fields to update on conflict. Defaults to the inserted values minus `target`. */
+    set?: Partial<TInsert>;
+}
+/** Aggregate query spec — group + count/sum/avg/min/max, each keyed by field. */
+interface AggregateSpec<TKey extends string = string, TFilter = unknown> {
+    filter?: TFilter;
+    /** Group rows by these field(s); each appears in the output rows. */
+    groupBy?: TKey | TKey[];
+    count?: boolean;
+    sum?: TKey | TKey[];
+    avg?: TKey | TKey[];
+    min?: TKey | TKey[];
+    max?: TKey | TKey[];
+    withDeleted?: boolean;
+}
+/** Paginatsiyasiz umumiy wire params. */
+interface WireBaseParams {
+    filter?: Filter;
+    sort?: Sort;
+    columns?: Record<string, boolean>;
+    with?: Record<string, unknown>;
+    withDeleted?: boolean;
+}
+/** Offset (sahifali) wire params. */
+interface WireOffsetParams extends WireBaseParams {
+    page?: number;
+    perPage?: number;
+    /**
+     * `false` — umumiy son so'ralmaydi (count yo'q): `perPage + 1` qator o'qiladi,
+     * `has_next` shundan, `total_items` / `total_pages` = `null`. Default `true`.
+     */
+    withTotal?: boolean;
+}
+/** Infinite-scroll wire params. */
+interface WireInfiniteParams extends WireBaseParams {
+    limit?: number;
+    offset?: number;
+}
+/** Cursor (keyset) wire params — `sort` yo'q, tartib `order` + `direction` bilan. */
+interface WireCursorParams extends Omit<WireBaseParams, "sort"> {
+    limit?: number;
+    cursor?: string | null;
+    cursorKey?: string;
+    order?: SortDirection;
+    direction?: "forward" | "backward";
+}
+/**
+ * Shart nima uchun tashlab yuborilgani yoki rad etilgani. `forbidden-key`,
+ * `forbidden-operator` va `limit-exceeded` — server siyosati (`filterable` /
+ * `sortable` / `limits`): ular **hech qachon jim tashlanmaydi**, `strict`dan qat'i nazar
+ * `QueryKitError` bo'ladi.
+ */
+type SkipReason = "unknown-key" | "invalid-value" | "forbidden-key" | "forbidden-operator" | "limit-exceeded" | "empty-filter";
+/**
+ * Shart qayerda tashlab yuborilgani (`page` — offset chuqurligi, `mutation` — `updateWhere` / `deleteWhere` filtri,
+ * `with` — `relations` ro'yxatida yo'q relation, ustun yoki filtr).
+ */
+type SkipSite = "filter" | "sort" | "cursorKey" | "aggregate" | "page" | "mutation" | "with";
+/**
+ * Server siyosati: maydon → ruxsat etilgan operatorlar, yoki `"*"` (hammasi — faqat aniq
+ * yozilganda). Ro'yxatda yo'q maydon yoki operator `QueryKitError` beradi.
+ */
+type Filterable<TKey extends string = string> = Partial<Record<TKey, readonly FilterOperator[] | "*">>;
+/** Tashlab yuborilgan bitta shart haqida ma'lumot. */
+interface SkippedCondition {
+    /** Jadval (drizzle) yoki model (mongoose) nomi. */
+    source: string;
+    site: SkipSite;
+    key: string;
+    operation?: FilterOperator;
+    reason: SkipReason;
+}
+/** Offset (sahifali) paginatsiya meta'si. */
+interface OffsetMeta {
+    /** `withTotal: false` bilan `null` (count so'ralmagan). */
+    total_items: number | null;
+    /** `withTotal: false` bilan `null`. */
+    total_pages: number | null;
+    current_page: number;
+    per_page: number;
+    has_next: boolean;
+    has_prev: boolean;
+}
+/** Infinite-scroll paginatsiya meta'si. */
+interface InfiniteMeta {
+    limit: number;
+    offset: number;
+    count: number;
+    has_more: boolean;
+    next_offset: number | null;
+}
+/** Cursor (keyset) paginatsiya meta'si. */
+interface CursorMeta {
+    limit: number;
+    has_next: boolean;
+    has_prev: boolean;
+    next_cursor: string | null;
+    prev_cursor: string | null;
+}
+/**
+ * `updateWhere` / `deleteWhere` uchun "hamma qatorlar" — faqat shu aniq ko'rsatilsa filtrsiz
+ * mutatsiya bajariladi (scope baribir qo'llanadi). Bo'sh filtr — `QueryKitError` `empty-filter`.
+ */
+interface AllRows {
+    all: true;
+}
+/** `updateWhere` / `deleteWhere` opsiyalari: `returning: { limit }` — ta'sirlangan qatorlardan ko'pi bilan `limit` tasi. */
+interface MutationOptions {
+    returning?: false | {
+        limit: number;
+    };
+}
+/** Ta'sirlangan qatorlar soni. */
+interface MutationCount {
+    count: number;
+}
+/** `returning: { limit }` bilan: soni va ko'pi bilan `limit` ta qator. */
+interface MutationRows<TRow> extends MutationCount {
+    rows: TRow[];
+}
+/**
+ * Bitta relation uchun mijoz `with` ruxsati (task 014, R21): `columns` majburiy — ro'yxat yoki aniq `"*"`;
+ * `filterable` — relation filtrida (prisma `where`, mongoose `match`) ruxsat etilgan maydonlar;
+ * `nested` — shu relation ichidagi `with` uchun xuddi shu shakl (yo'q ⇒ ichki `with` — `forbidden-key`).
+ */
+interface RelationRule {
+    columns: readonly string[] | "*";
+    filterable?: Filterable;
+    nested?: Relations;
+}
+/** Repository `relations`: relation → {@link RelationRule}. Ro'yxatda yo'q relation — `forbidden-key`, `site: "with"`. */
+type Relations = Record<string, RelationRule>;
+
+/**
+ * Umumiy pagination default'lari — yagona manba. Backend adapter (`createRegistry`
+ * options) va frontend (`createQuery` config) shu qiymatlarni fallback sifatida
+ * ishlatadi, shuning uchun ular hech qachon bir-biridan farq qilmaydi.
+ */
+/** Offset (list) sahifa o'lchami default'i. */
+declare const DEFAULT_PER_PAGE = 20;
+/** Infinite/cursor `limit` default'i. */
+declare const DEFAULT_LIMIT = 20;
+/**
+ * `perPage` uchun yuqori chegara — cap'siz paginatsiya DoS yuzasi. Validatsiya
+ * (`@querykitjs/zod` factory'lari), backend repositorylari va frontend `createQuery`
+ * shu bitta qiymatga tayanadi, shuning uchun ular hech qachon farq qilmaydi.
+ */
+declare const DEFAULT_MAX_PER_PAGE = 200;
+/** Infinite/cursor `limit` uchun yuqori chegara. Qarang: {@link DEFAULT_MAX_PER_PAGE}. */
+declare const DEFAULT_MAX_LIMIT = 200;
+/** Longest root-to-leaf path of a filter tree, in nodes: the root is level 1, every `and`/`or`/`not` and the condition itself add one. */
+declare const DEFAULT_MAX_FILTER_DEPTH = 5;
+/** Field conditions (leaves) in one filter, across all groups. */
+declare const DEFAULT_MAX_CONDITIONS = 30;
+/** Items in one array filter value (`in`, `notIn`, …). */
+declare const DEFAULT_MAX_IN_ITEMS = 200;
+/** Characters in one string filter value, also inside an array value. */
+declare const DEFAULT_MAX_STRING_LENGTH = 256;
+/** Rows skipped before a page: `(page - 1) × perPage` for offset pagination, `offset` for infinite. Deeper pages need a cursor. */
+declare const DEFAULT_MAX_OFFSET = 10000;
+/** Fields in one `sort` array. */
+declare const DEFAULT_MAX_SORT_FIELDS = 3;
+/**
+ * Wildcards (`%`, `_`) in one `like` / `ilike` / `notLike` pattern, after a run
+ * of `%` counts as one. Each extra wildcard multiplies the matcher's backtracking
+ * (`%a%a%a…%b`), on MongoDB's regex engine and on Postgres alike.
+ */
+declare const DEFAULT_MAX_LIKE_WILDCARDS = 2;
+/** The six request limits, by the option name every package uses. */
+interface QueryLimits {
+    maxDepth: number;
+    maxConditions: number;
+    maxInItems: number;
+    maxStringLength: number;
+    maxOffset: number;
+    maxSortFields: number;
+    maxLikeWildcards: number;
+}
+/** The core defaults as one object. */
+declare const DEFAULT_QUERY_LIMITS: Readonly<QueryLimits>;
+/**
+ * The defaults with the given limits on top; an `undefined` entry keeps the
+ * default. `Infinity` turns a limit off (⚠️ a DoS surface).
+ *
+ * @example
+ * ```ts
+ * resolveLimits({ maxInItems: 50 }); // { maxDepth: 5, …, maxInItems: 50, … }
+ * ```
+ */
+declare function resolveLimits(limits?: Partial<QueryLimits>): QueryLimits;
+
+/**
+ * Brand a driver-native filter object so an adapter accepts it as a filter node.
+ * The object itself is returned (non-enumerable brand), so the driver receives
+ * exactly what you wrote.
+ *
+ * @example
+ * ```ts
+ * import { raw } from "@querykitjs/core";
+ * repo.findAll({ filter: { and: [{ key: "status", value: "active" }, raw({ posts: { some: { published: true } } })] } });
+ * ```
+ */
+declare function raw<T extends object>(value: T): T;
+/** Whether a filter node was branded with {@link raw}. */
+declare const isRaw: (node: unknown) => boolean;
+
+export { DEFAULT_LIMIT as D, TEXT_FILTER_OPERATORS as T, raw as X, resolveLimits as Y, isRaw as Z, DEFAULT_MAX_CONDITIONS as f, DEFAULT_MAX_FILTER_DEPTH as g, DEFAULT_MAX_IN_ITEMS as h, DEFAULT_MAX_LIKE_WILDCARDS as i, DEFAULT_MAX_LIMIT as j, DEFAULT_MAX_OFFSET as k, DEFAULT_MAX_PER_PAGE as l, DEFAULT_MAX_SORT_FIELDS as m, DEFAULT_MAX_STRING_LENGTH as n, DEFAULT_PER_PAGE as o, DEFAULT_QUERY_LIMITS as p, FILTER_OPERATORS as q };
+export type { AndGroup as A, SkipReason as B, CursorMeta as C, SkipSite as E, FilterValue as F, Sort as G, SortDirection as H, InfiniteMeta as I, SortItem as J, WireCursorParams as K, LooseKey as L, MutationCount as M, NotGroup as N, OrGroup as O, WireInfiniteParams as P, QueryLimits as Q, RelationRule as R, SkippedCondition as S, UpsertOptions as U, WireOffsetParams as V, WireBaseParams as W, FieldCondition as a, FilterScalar as b, FilterNode as c, AggregateSpec as d, AllRows as e, Filter as r, FilterOperator as s, Filterable as t, MutationOptions as u, MutationRows as v, OffsetMeta as w, Relations as x, Scope as y, ScopeIn as z };

package/dist/raw-Bx8c-TrC.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Filter operatorlari — yagona runtime manba. `FilterOperator` tipi (`types.ts`)
+ * shundan chiqadi; `@querykitjs/zod` shu massivdan zod enum quradi.
+ */
+declare const FILTER_OPERATORS: readonly ["=", "!=", ">", ">=", "<", "<=", "eq", "ne", "gt", "gte", "lt", "lte", "like", "ilike", "notLike", "contains", "startsWith", "endsWith", "%_%", "%_", "_%", "in", "notIn", "between", "notBetween", "isNull", "isNotNull"];
+/**
+ * Qiymati **text pattern** bo'lgan operatorlar. Backend adapterlari wire qiymatni
+ * ustun/path tipiga cast qilishda shularni chetlab o'tadi — aks holda
+ * `ilike(dateColumn, "%2026%")` ISO string o'rniga `String(Date)` olardi
+ * (`"Mon Jul 28 2026 …"`). Ro'yxat ikki adapterda divergent bo'lmasligi uchun
+ * shu yerda — yagona manba.
+ */
+declare const TEXT_FILTER_OPERATORS: readonly ["like", "ilike", "notLike", "contains", "startsWith", "endsWith", "%_%", "%_", "_%"];
+
+/**
+ * `@querykitjs/core` — ORM-agnostik query DSL tiplari. Backend adapterlar
+ * (`@querykitjs/drizzle-pg`) va frontend (`@querykitjs/web`) shu bir xil kontraktga
+ * tayanadi. Tiplar ustun-kaliti (`TKey`) bo'yicha generic; adapterlar uni o'z
+ * kalit tipiga (Drizzle jadval ustuni yoki entity maydoni) ixtisoslashtiradi.
+ */
+
+/** Qo'llab-quvvatlanadigan filter operatorlari (token va nom aliaslari). */
+type FilterOperator = (typeof FILTER_OPERATORS)[number];
+/**
+ * Tiplangan kalit, lekin har qanday `string` ham qabul qilinadi. Wire (JSON) har
+ * doim string-keyed keladi va adapterlar noma'lum kalitni baribir skip qiladi —
+ * tip shunchaki haqiqatni aytsin, route'da `as` cast kerak bo'lmasin.
+ *
+ * `(string & {})` — autocomplete'ni saqlaydigan TS trick'i: IDE `TKey`
+ * variantlarini taklif qiladi, boshqa string esa xato bermaydi.
+ */
+type LooseKey<TKey extends string> = TKey | (string & {});
+/**
+ * A filter scalar. `Date` is accepted **in-memory** (adapters cast it for local
+ * queries); over the JSON wire it serializes to an ISO string, so
+ * `@querykitjs/zod` validates scalars **without** `Date` (string/number/boolean/null).
+ */
+type FilterScalar = string | number | boolean | Date | null;
+type FilterValue = FilterScalar | FilterScalar[];
+/** Bitta maydon sharti (`operation` default `"="`). */
+interface FieldCondition<TKey extends string = string> {
+    key: TKey;
+    operation?: FilterOperator;
+    value?: FilterValue;
+}
+interface AndGroup<TKey extends string = string, TRaw = never> {
+    and: FilterNode<TKey, TRaw>[];
+}
+interface OrGroup<TKey extends string = string, TRaw = never> {
+    or: FilterNode<TKey, TRaw>[];
+}
+interface NotGroup<TKey extends string = string, TRaw = never> {
+    not: FilterNode<TKey, TRaw>;
+}
+/**
+ * Filter daraxti tuguni: maydon sharti, mantiqiy guruh, yoki adapter qo'shadigan
+ * raw escape-hatch (`TRaw`, masalan Drizzle `SQL`; default `never`).
+ */
+type FilterNode<TKey extends string = string, TRaw = never> = FieldCondition<TKey> | AndGroup<TKey, TRaw> | OrGroup<TKey, TRaw> | NotGroup<TKey, TRaw> | TRaw;
+/** Public filter: daraxt/tugun yoki flat massiv (implicit AND). */
+type Filter<TKey extends string = string, TRaw = never> = FilterNode<TKey, TRaw> | FieldCondition<TKey>[];
+type SortDirection = "asc" | "desc";
+/** One sort field — `{ key, direction }`. */
+interface SortItem<TKey extends string = string> {
+    key: TKey;
+    direction?: SortDirection;
+}
+/** Sort is **always an array** of {@link SortItem} (multi-field capable). */
+type Sort<TKey extends string = string> = SortItem<TKey>[];
+/** Scope qiymati ro'yxat bo'yicha (task 014): `{ in: [...] }`; bo'sh ro'yxat — hech qanday qator. */
+interface ScopeIn {
+    in: readonly FilterScalar[];
+}
+/**
+ * Scoped repository'ning har amaliga qo'llanadigan scope: maydon → tenglik qiymati yoki `{ in: [...] }`.
+ * `create` default'lari faqat tenglik scope'laridan olinadi.
+ */
+type Scope<TKey extends string = string> = Partial<Record<TKey, FilterScalar | ScopeIn>>;
+/** Options for upsert / upsertMany — conflict target(s) + optional update set. */
+interface UpsertOptions<TKey extends string = string, TInsert = Record<string, unknown>> {
+    /** Unique/conflict key(s) whose match triggers an update instead of an insert. */
+    target: TKey | TKey[];
+    /** Columns/fields to update on conflict. Defaults to the inserted values minus `target`. */
+    set?: Partial<TInsert>;
+}
+/** Aggregate query spec — group + count/sum/avg/min/max, each keyed by field. */
+interface AggregateSpec<TKey extends string = string, TFilter = unknown> {
+    filter?: TFilter;
+    /** Group rows by these field(s); each appears in the output rows. */
+    groupBy?: TKey | TKey[];
+    count?: boolean;
+    sum?: TKey | TKey[];
+    avg?: TKey | TKey[];
+    min?: TKey | TKey[];
+    max?: TKey | TKey[];
+    withDeleted?: boolean;
+}
+/** Paginatsiyasiz umumiy wire params. */
+interface WireBaseParams {
+    filter?: Filter;
+    sort?: Sort;
+    columns?: Record<string, boolean>;
+    with?: Record<string, unknown>;
+    withDeleted?: boolean;
+}
+/** Offset (sahifali) wire params. */
+interface WireOffsetParams extends WireBaseParams {
+    page?: number;
+    perPage?: number;
+    /**
+     * `false` — umumiy son so'ralmaydi (count yo'q): `perPage + 1` qator o'qiladi,
+     * `has_next` shundan, `total_items` / `total_pages` = `null`. Default `true`.
+     */
+    withTotal?: boolean;
+}
+/** Infinite-scroll wire params. */
+interface WireInfiniteParams extends WireBaseParams {
+    limit?: number;
+    offset?: number;
+}
+/** Cursor (keyset) wire params — `sort` yo'q, tartib `order` + `direction` bilan. */
+interface WireCursorParams extends Omit<WireBaseParams, "sort"> {
+    limit?: number;
+    cursor?: string | null;
+    cursorKey?: string;
+    order?: SortDirection;
+    direction?: "forward" | "backward";
+}
+/**
+ * Shart nima uchun tashlab yuborilgani yoki rad etilgani. `forbidden-key`,
+ * `forbidden-operator` va `limit-exceeded` — server siyosati (`filterable` /
+ * `sortable` / `limits`): ular **hech qachon jim tashlanmaydi**, `strict`dan qat'i nazar
+ * `QueryKitError` bo'ladi.
+ */
+type SkipReason = "unknown-key" | "invalid-value" | "forbidden-key" | "forbidden-operator" | "limit-exceeded" | "empty-filter";
+/**
+ * Shart qayerda tashlab yuborilgani (`page` — offset chuqurligi, `mutation` — `updateWhere` / `deleteWhere` filtri,
+ * `with` — `relations` ro'yxatida yo'q relation, ustun yoki filtr).
+ */
+type SkipSite = "filter" | "sort" | "cursorKey" | "aggregate" | "page" | "mutation" | "with";
+/**
+ * Server siyosati: maydon → ruxsat etilgan operatorlar, yoki `"*"` (hammasi — faqat aniq
+ * yozilganda). Ro'yxatda yo'q maydon yoki operator `QueryKitError` beradi.
+ */
+type Filterable<TKey extends string = string> = Partial<Record<TKey, readonly FilterOperator[] | "*">>;
+/** Tashlab yuborilgan bitta shart haqida ma'lumot. */
+interface SkippedCondition {
+    /** Jadval (drizzle) yoki model (mongoose) nomi. */
+    source: string;
+    site: SkipSite;
+    key: string;
+    operation?: FilterOperator;
+    reason: SkipReason;
+}
+/** Offset (sahifali) paginatsiya meta'si. */
+interface OffsetMeta {
+    /** `withTotal: false` bilan `null` (count so'ralmagan). */
+    total_items: number | null;
+    /** `withTotal: false` bilan `null`. */
+    total_pages: number | null;
+    current_page: number;
+    per_page: number;
+    has_next: boolean;
+    has_prev: boolean;
+}
+/** Infinite-scroll paginatsiya meta'si. */
+interface InfiniteMeta {
+    limit: number;
+    offset: number;
+    count: number;
+    has_more: boolean;
+    next_offset: number | null;
+}
+/** Cursor (keyset) paginatsiya meta'si. */
+interface CursorMeta {
+    limit: number;
+    has_next: boolean;
+    has_prev: boolean;
+    next_cursor: string | null;
+    prev_cursor: string | null;
+}
+/**
+ * `updateWhere` / `deleteWhere` uchun "hamma qatorlar" — faqat shu aniq ko'rsatilsa filtrsiz
+ * mutatsiya bajariladi (scope baribir qo'llanadi). Bo'sh filtr — `QueryKitError` `empty-filter`.
+ */
+interface AllRows {
+    all: true;
+}
+/** `updateWhere` / `deleteWhere` opsiyalari: `returning: { limit }` — ta'sirlangan qatorlardan ko'pi bilan `limit` tasi. */
+interface MutationOptions {
+    returning?: false | {
+        limit: number;
+    };
+}
+/** Ta'sirlangan qatorlar soni. */
+interface MutationCount {
+    count: number;
+}
+/** `returning: { limit }` bilan: soni va ko'pi bilan `limit` ta qator. */
+interface MutationRows<TRow> extends MutationCount {
+    rows: TRow[];
+}
+/**
+ * Bitta relation uchun mijoz `with` ruxsati (task 014, R21): `columns` majburiy — ro'yxat yoki aniq `"*"`;
+ * `filterable` — relation filtrida (prisma `where`, mongoose `match`) ruxsat etilgan maydonlar;
+ * `nested` — shu relation ichidagi `with` uchun xuddi shu shakl (yo'q ⇒ ichki `with` — `forbidden-key`).
+ */
+interface RelationRule {
+    columns: readonly string[] | "*";
+    filterable?: Filterable;
+    nested?: Relations;
+}
+/** Repository `relations`: relation → {@link RelationRule}. Ro'yxatda yo'q relation — `forbidden-key`, `site: "with"`. */
+type Relations = Record<string, RelationRule>;
+
+/**
+ * Umumiy pagination default'lari — yagona manba. Backend adapter (`createRegistry`
+ * options) va frontend (`createQuery` config) shu qiymatlarni fallback sifatida
+ * ishlatadi, shuning uchun ular hech qachon bir-biridan farq qilmaydi.
+ */
+/** Offset (list) sahifa o'lchami default'i. */
+declare const DEFAULT_PER_PAGE = 20;
+/** Infinite/cursor `limit` default'i. */
+declare const DEFAULT_LIMIT = 20;
+/**
+ * `perPage` uchun yuqori chegara — cap'siz paginatsiya DoS yuzasi. Validatsiya
+ * (`@querykitjs/zod` factory'lari), backend repositorylari va frontend `createQuery`
+ * shu bitta qiymatga tayanadi, shuning uchun ular hech qachon farq qilmaydi.
+ */
+declare const DEFAULT_MAX_PER_PAGE = 200;
+/** Infinite/cursor `limit` uchun yuqori chegara. Qarang: {@link DEFAULT_MAX_PER_PAGE}. */
+declare const DEFAULT_MAX_LIMIT = 200;
+/** Longest root-to-leaf path of a filter tree, in nodes: the root is level 1, every `and`/`or`/`not` and the condition itself add one. */
+declare const DEFAULT_MAX_FILTER_DEPTH = 5;
+/** Field conditions (leaves) in one filter, across all groups. */
+declare const DEFAULT_MAX_CONDITIONS = 30;
+/** Items in one array filter value (`in`, `notIn`, …). */
+declare const DEFAULT_MAX_IN_ITEMS = 200;
+/** Characters in one string filter value, also inside an array value. */
+declare const DEFAULT_MAX_STRING_LENGTH = 256;
+/** Rows skipped before a page: `(page - 1) × perPage` for offset pagination, `offset` for infinite. Deeper pages need a cursor. */
+declare const DEFAULT_MAX_OFFSET = 10000;
+/** Fields in one `sort` array. */
+declare const DEFAULT_MAX_SORT_FIELDS = 3;
+/**
+ * Wildcards (`%`, `_`) in one `like` / `ilike` / `notLike` pattern, after a run
+ * of `%` counts as one. Each extra wildcard multiplies the matcher's backtracking
+ * (`%a%a%a…%b`), on MongoDB's regex engine and on Postgres alike.
+ */
+declare const DEFAULT_MAX_LIKE_WILDCARDS = 2;
+/** The six request limits, by the option name every package uses. */
+interface QueryLimits {
+    maxDepth: number;
+    maxConditions: number;
+    maxInItems: number;
+    maxStringLength: number;
+    maxOffset: number;
+    maxSortFields: number;
+    maxLikeWildcards: number;
+}
+/** The core defaults as one object. */
+declare const DEFAULT_QUERY_LIMITS: Readonly<QueryLimits>;
+/**
+ * The defaults with the given limits on top; an `undefined` entry keeps the
+ * default. `Infinity` turns a limit off (⚠️ a DoS surface).
+ *
+ * @example
+ * ```ts
+ * resolveLimits({ maxInItems: 50 }); // { maxDepth: 5, …, maxInItems: 50, … }
+ * ```
+ */
+declare function resolveLimits(limits?: Partial<QueryLimits>): QueryLimits;
+
+/**
+ * Brand a driver-native filter object so an adapter accepts it as a filter node.
+ * The object itself is returned (non-enumerable brand), so the driver receives
+ * exactly what you wrote.
+ *
+ * @example
+ * ```ts
+ * import { raw } from "@querykitjs/core";
+ * repo.findAll({ filter: { and: [{ key: "status", value: "active" }, raw({ posts: { some: { published: true } } })] } });
+ * ```
+ */
+declare function raw<T extends object>(value: T): T;
+/** Whether a filter node was branded with {@link raw}. */
+declare const isRaw: (node: unknown) => boolean;
+
+export { DEFAULT_LIMIT as D, TEXT_FILTER_OPERATORS as T, raw as X, resolveLimits as Y, isRaw as Z, DEFAULT_MAX_CONDITIONS as f, DEFAULT_MAX_FILTER_DEPTH as g, DEFAULT_MAX_IN_ITEMS as h, DEFAULT_MAX_LIKE_WILDCARDS as i, DEFAULT_MAX_LIMIT as j, DEFAULT_MAX_OFFSET as k, DEFAULT_MAX_PER_PAGE as l, DEFAULT_MAX_SORT_FIELDS as m, DEFAULT_MAX_STRING_LENGTH as n, DEFAULT_PER_PAGE as o, DEFAULT_QUERY_LIMITS as p, FILTER_OPERATORS as q };
+export type { AndGroup as A, SkipReason as B, CursorMeta as C, SkipSite as E, FilterValue as F, Sort as G, SortDirection as H, InfiniteMeta as I, SortItem as J, WireCursorParams as K, LooseKey as L, MutationCount as M, NotGroup as N, OrGroup as O, WireInfiniteParams as P, QueryLimits as Q, RelationRule as R, SkippedCondition as S, UpsertOptions as U, WireOffsetParams as V, WireBaseParams as W, FieldCondition as a, FilterScalar as b, FilterNode as c, AggregateSpec as d, AllRows as e, Filter as r, FilterOperator as s, Filterable as t, MutationOptions as u, MutationRows as v, OffsetMeta as w, Relations as x, Scope as y, ScopeIn as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@querykitjs/core",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "description": "ORM-agnostic query DSL shared by querykit packages — filters, operators & wire types.",
   "type": "module",
   "author": {
@@ -23,26 +23,52 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./internal": {
+      "import": {
+        "types": "./dist/internal.d.ts",
+        "default": "./dist/internal.js"
+      },
+      "require": {
+        "types": "./dist/internal.d.cts",
+        "default": "./dist/internal.cjs"
+      }
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "internal": [
+        "./dist/internal.d.ts"
+      ]
     }
   },
   "files": [
     "dist",
     "README.md",
     "README.en.md",
-    "LICENSE"
+    "LICENSE",
+    "skills"
   ],
   "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22.12"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
-    "test:smoke": "bun run test/smoke.ts"
+    "test:smoke": "bun run test/smoke.ts && bun run test/internal.ts"
   },
   "keywords": [
     "querykit",