@querykitjs/class-validator 1.0.0 → 2.0.1

package/README.en.md

@@ -27,6 +27,17 @@ import "reflect-metadata";
 
 Without it, class-transformer's `@Type()` throws `Reflect.getMetadata is not a function`.
 
+### Requirements
+
+|                                    | Version             | Tested (`bun run test:matrix`) |
+| ---------------------------------- | ------------------- | ------------------------------ |
+| Node.js                            | `>=22.12`           | 24                             |
+| `class-validator` (peer)           | `>=0.14 <0.16`      | 0.14.4, 0.15.1                 |
+| `class-transformer` (peer)         | `^0.5`              | 0.5.1                          |
+| `reflect-metadata` (optional peer) | `^0.1.13 \|\| ^0.2` | 0.1.14, 0.2.2                  |
+
+Node 20 is no longer supported (`engines`: `>=22.12`). Peer ranges cover the last two majors; both ends are tested.
+
 ## Usage (NestJS)
 
 `main.ts`:
@@ -79,17 +90,18 @@ Both flags are **required**, otherwise the guarantees are only half in place:
 
 - **Filter** — a flat array (`{key, operation, value}[]`) or a nested `and`/`or`/`not` tree.
 - **Operators** — the full core set: `= != > >= < <=`, `like/ilike/notLike`, `contains/startsWith/endsWith` (+ tokens `%_%`/`%_`/`_%`), `in/notIn`, `between/notBetween`, `isNull/isNotNull`.
-- **Sort** — `{ key, direction }[]` (multi-field).
-- **Pagination** — offset (`page`/`perPage`), infinite (`limit`/`offset`), cursor (`limit`/`cursor`/`cursorKey`/`order`/`direction`).
+- **Sort** — `{ key, direction }[]` (multi-field, at most 3).
+- **Request limits** — filter size, sort fields, offset depth ([Limits](#limits)).
+- **Pagination** — offset (`page`/`perPage`/`withTotal` — `false` ⇒ no count, totals `null`), infinite (`limit`/`offset`), cursor (`limit`/`cursor`/`cursorKey`/`order`/`direction`).
 - **Values** — a scalar or an array of scalars. Because the wire is JSON, a `Date` object, `NaN` and `Infinity` are **rejected** (dates arrive as ISO strings).
-- **A field allowlist** (`allowedKeys`) and a **depth cap** (`maxDepth`) — neither exists in zod, see below.
+- **A field allowlist** (`allowedKeys`) — zod has none, see below.
 - The legacy `type` field is **ignored** (not rejected) — easy migration.
 
 ## Safe by default
 
 | Layer                              | Default behaviour                                                                                                                                                                                                          |
 | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `perPage` / `limit`                | Capped at core's `DEFAULT_MAX_PER_PAGE` / `DEFAULT_MAX_LIMIT` (200). `page` is uncapped — the DoS surface is page **size**, not page number.                                                                               |
+| `perPage` / `limit`                | Capped at core's `DEFAULT_MAX_PER_PAGE` / `DEFAULT_MAX_LIMIT` (200). `page` itself is uncapped, but `(page - 1) × perPage` ≤ `maxOffset` (10 000).                                                                         |
 | `columns` / `with` / `withDeleted` | Declared on no DTO, so `whitelist: true` strips them. Only `allow` opens them.                                                                                                                                             |
 | `allowedKeys`                      | Omitted (`undefined`), any key passes — the allowlist is **opt-in** (zod parity). Provided, an unknown key is **rejected**; `[]` allows nothing, so an allowlist computed from an empty set fails closed rather than open. |
 | `maxDepth`                         | `5`. An unbounded recursive tree is a DoS surface.                                                                                                                                                                         |
@@ -98,16 +110,19 @@ If you do open a field with `allow`, add the **second layer at the repository**:
 
 ## Options
 
+> ⚠️ The constant DTOs (`BaseParamsDto`, `OffsetParamsDto`, `InfiniteParamsDto`, `CursorParamsDto`) are `@deprecated` (task 014) and go away in the next major. Use `make*ParamsDto` in new code.
+
 `makeOffsetParamsDto` / `makeInfiniteParamsDto` / `makeCursorParamsDto`:
 
-| Option        | Default                           | Meaning                                                     |
-| ------------- | --------------------------------- | ----------------------------------------------------------- |
-| `allowedKeys` | —                                 | Shared allowlist shorthand for `filter` and `sort`          |
-| `filter`      | —                                 | Full options for `filter` (below) — wins over the shorthand |
-| `sort`        | —                                 | `allowedKeys` / `messageStyle` for `sort`                   |
-| `maxPerPage`  | core `DEFAULT_MAX_PER_PAGE` (200) | `perPage` ceiling. `Infinity` disables the cap (⚠️ DoS)     |
-| `maxLimit`    | core `DEFAULT_MAX_LIMIT` (200)    | `limit` ceiling                                             |
-| `allow`       | `[]`                              | Deliberately open `"columns"` / `"with"` / `"withDeleted"`  |
+| Option        | Default                           | Meaning                                                                           |
+| ------------- | --------------------------------- | --------------------------------------------------------------------------------- |
+| `allowedKeys` | —                                 | Shared allowlist shorthand for `filter` and `sort`                                |
+| `filter`      | —                                 | Full options for `filter` (below) — wins over the shorthand                       |
+| `sort`        | —                                 | `allowedKeys` / `messageStyle` for `sort`                                         |
+| `maxPerPage`  | core `DEFAULT_MAX_PER_PAGE` (200) | `perPage` ceiling. `Infinity` disables the cap (⚠️ DoS)                           |
+| `maxLimit`    | core `DEFAULT_MAX_LIMIT` (200)    | `limit` ceiling                                                                   |
+| `allow`       | `[]`                              | Deliberately open `"columns"` / `"with"` / `"withDeleted"`                        |
+| `limits`      | core `DEFAULT_QUERY_LIMITS`       | request limits ([Limits](#limits)); a dedicated `filter.*` / `sort.*` option wins |
 
 `@IsQueryFilter(options)` (and `options.filter`):
 
@@ -115,12 +130,50 @@ If you do open a field with `allow`, add the **second layer at the repository**:
 | ------------------ | ------------------------ | ------------------------------------------------------------------------------------------ |
 | `allowedKeys`      | —                        | When set, an unknown filter key is rejected                                                |
 | `allowedOperators` | every `FILTER_OPERATORS` | Narrow the accepted operator set                                                           |
-| `maxDepth`         | `5`                      | `and`/`or`/`not` depth cap                                                                 |
+| `maxDepth`         | `5`                      | root-to-leaf node count                                                                    |
+| `maxConditions`    | `30`                     | condition count                                                                            |
+| `maxInItems`       | `200`                    | items in an array value                                                                    |
+| `maxStringLength`  | `256`                    | length of a string value                                                                   |
 | `strictValue`      | `false`                  | `in`/`notIn` → array, `between`/`notBetween` → two values, `isNull`/`isNotNull` → no value |
 | `messageStyle`     | `"text"`                 | `"key"` returns the i18n key instead of a sentence                                         |
 | `rootPath`         | the property name        | Root of the reported path (`filter[0].operation`)                                          |
 
-`@IsQuerySort(options)` — `allowedKeys`, `messageStyle`, `rootPath`.
+`@IsQuerySort(options)` — `allowedKeys`, `maxSortFields` (`3`), `messageStyle`, `rootPath`.
+
+`@IsWithinMaxOffset({ mode, maxOffset? })` — `mode: "page"` (`(page - 1) × perPage`) or `"offset"`; `maxOffset` defaults to `10 000`.
+
+## Limits
+
+Every DTO and `validateFilter` / `validateSort` apply the core request limits — the same values as `@querykitjs/zod` (`DEFAULT_QUERY_LIMITS`).
+
+| Limit             | Default  | What counts                                                                       | Where                                                |
+| ----------------- | -------- | --------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| `maxDepth`        | `5`      | root-to-leaf nodes: the root is 1, every `and`/`or`/`not` and the condition add 1 | `@IsQueryFilter` / `validateFilter`                  |
+| `maxConditions`   | `30`     | conditions (leaves) across all groups                                             | `@IsQueryFilter` / `validateFilter`                  |
+| `maxInItems`      | `200`    | items in one array value                                                          | `@IsQueryFilter` / `validateFilter`                  |
+| `maxStringLength` | `256`    | characters in one string value, also inside an array                              | `@IsQueryFilter` / `validateFilter`                  |
+| `maxSortFields`   | `3`      | fields in the `sort` array                                                        | `@IsQuerySort` / `validateSort`                      |
+| `maxOffset`       | `10 000` | `(page - 1) × perPage` (20 without `perPage`); infinite `offset`                  | `@IsWithinMaxOffset` (`page` / `offset` in the DTOs) |
+
+```ts
+// raise a limit for one endpoint — the others keep their defaults
+const ImportDto = makeOffsetParamsDto({ limits: { maxInItems: 500 } });
+
+// a dedicated option wins over `limits`
+const DeepDto = makeOffsetParamsDto({ limits: { maxDepth: 6 }, filter: { maxDepth: 8 } }); // 8
+```
+
+- Filter size is checked iteratively, **before** the shape check: a 10 000-level `not` chain does not fill the stack.
+- The error text names the limit and its value (`filter[0].value exceeds maxInItems (200)`). Keys: `querykit.filter.max_depth` for depth, `querykit.limit.exceeded` for the other five (args `limit`, `max`) — in the en/uz/ru catalogs.
+- Pages deeper than `maxOffset` use cursor pagination (`makeCursorParamsDto`).
+- `Infinity` turns a limit off — ⚠️ a DoS surface.
+
+## Migrating (DTO limits)
+
+- A payload past a limit is now rejected — by the static DTOs and by the factories: an `in` with 201 items, a 257-char string, 31 conditions, 4 sort fields, `page=502, perPage=20` or `offset=10001` now return 400. Raise a limit with `limits` where you need it.
+- `page` now carries `@IsWithinMaxOffset({ mode: "page" })`; if your DTO redeclares `page`, add that decorator too.
+- The `querykit.filter.max_depth` text changed (it now says `maxDepth (5)`); rely on the key, not the text.
+- `DEFAULT_MAX_FILTER_DEPTH` is now re-exported from `@querykitjs/core` (same value, 5).
 
 ## i18n (more than one language)
 
@@ -181,7 +234,7 @@ if (issues.length > 0) {
 | Contract, operators      | from core         | **the same**                              |
 | Stripping unknown fields | automatic         | via `ValidationPipe({ whitelist: true })` |
 | Field allowlist          | none              | `allowedKeys`                             |
-| Depth cap                | none              | `maxDepth` (default 5)                    |
+| Request limits           | the same (core)   | the same (core) — `limits`                |
 | `NaN` / `Infinity`       | `Infinity` passes | both rejected (neither exists in JSON)    |
 | i18n                     | —                 | `querykit.*` keys + en/uz/ru catalogs     |
 

package/README.md

@@ -27,6 +27,17 @@ import "reflect-metadata";
 
 Usiz class-transformer'ning `@Type()` dekoratori `Reflect.getMetadata is not a function` xatosini beradi.
 
+### Talablar
+
+|                                     | Versiya             | Tekshiriladi (`bun run test:matrix`) |
+| ----------------------------------- | ------------------- | ------------------------------------ |
+| Node.js                             | `>=22.12`           | 24                                   |
+| `class-validator` (peer)            | `>=0.14 <0.16`      | 0.14.4, 0.15.1                       |
+| `class-transformer` (peer)          | `^0.5`              | 0.5.1                                |
+| `reflect-metadata` (ixtiyoriy peer) | `^0.1.13 \|\| ^0.2` | 0.1.14, 0.2.2                        |
+
+Node 20 endi qo'llab-quvvatlanmaydi (`engines`: `>=22.12`). Peer diapazoni — oxirgi ikki major; ikkala cheti testda.
+
 ## Foydalanish (NestJS)
 
 `main.ts`:
@@ -79,17 +90,18 @@ Ikkala flag ham **zarur**, aks holda kafolatlar yarim ishlaydi:
 
 - **Filter** — flat massiv (`{key, operation, value}[]`) yoki nested `and`/`or`/`not` daraxt.
 - **Operatorlar** — core'ning to'liq to'plami: `= != > >= < <=`, `like/ilike/notLike`, `contains/startsWith/endsWith` (+ token `%_%`/`%_`/`_%`), `in/notIn`, `between/notBetween`, `isNull/isNotNull`.
-- **Sort** — `{ key, direction }[]` (ko'p-maydon).
-- **Paginatsiya** — offset (`page`/`perPage`), infinite (`limit`/`offset`), cursor (`limit`/`cursor`/`cursorKey`/`order`/`direction`).
+- **Sort** — `{ key, direction }[]` (ko'p-maydon, ko'pi bilan 3).
+- **So'rov limitlari** — filtr hajmi, sort soni, offset chuqurligi ([Limits](#limits)).
+- **Paginatsiya** — offset (`page`/`perPage`/`withTotal` — `false` ⇒ count yo'q, totals `null`), infinite (`limit`/`offset`), cursor (`limit`/`cursor`/`cursorKey`/`order`/`direction`).
 - **Qiymat** — skalyar yoki skalyar massiv. Wire JSON bo'lgani uchun `Date` obyekti, `NaN` va `Infinity` **rad etiladi** (sana ISO string sifatida keladi).
-- **Field allowlist** (`allowedKeys`) va **chuqurlik limiti** (`maxDepth`) — zod'da yo'q, quyiga qarang.
+- **Field allowlist** (`allowedKeys`) — zod'da yo'q, quyiga qarang.
 - Eski `type` maydoni **e'tiborsiz** qoldiriladi (rad etilmaydi) — migratsiya oson.
 
 ## Xavfsiz default
 
 | Qatlam                             | Default xulq                                                                                                                                                                                                                           |
 | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `perPage` / `limit`                | core `DEFAULT_MAX_PER_PAGE` / `DEFAULT_MAX_LIMIT` (200) bilan cheklangan. `page` cheklanmagan — DoS yuzasi sahifa **o'lchami**, raqami emas.                                                                                           |
+| `perPage` / `limit`                | core `DEFAULT_MAX_PER_PAGE` / `DEFAULT_MAX_LIMIT` (200) bilan cheklangan. `page` o'zi cheklanmagan, lekin `(page - 1) × perPage` ≤ `maxOffset` (10 000).                                                                               |
 | `columns` / `with` / `withDeleted` | Hech qaysi DTO'da e'lon qilinmagan → `whitelist: true` ularni o'chiradi. Ochish faqat `allow` bilan.                                                                                                                                   |
 | `allowedKeys`                      | Berilmasa (`undefined`) istalgan kalit o'tadi — allowlist **opt-in** (zod bilan parity). Berilsa, noma'lum kalit **rad etiladi**; `[]` esa hech biriga ruxsat bermaydi (hisoblab chiqarilgan bo'sh ro'yxat fail-open bo'lib qolmasin). |
 | `maxDepth`                         | `5`. Cheklovsiz rekursiv daraxt DoS yuzasi.                                                                                                                                                                                            |
@@ -98,16 +110,19 @@ Ikkala flag ham **zarur**, aks holda kafolatlar yarim ishlaydi:
 
 ## Opsiyalar
 
+> ⚠️ Konstanta DTO'lar (`BaseParamsDto`, `OffsetParamsDto`, `InfiniteParamsDto`, `CursorParamsDto`) `@deprecated` (task 014): keyingi major'da olib tashlanadi. Yangi kod uchun `make*ParamsDto`.
+
 `makeOffsetParamsDto` / `makeInfiniteParamsDto` / `makeCursorParamsDto`:
 
-| Opsiya        | Default                           | Ma'nosi                                                                             |
-| ------------- | --------------------------------- | ----------------------------------------------------------------------------------- |
-| `allowedKeys` | —                                 | `filter` va `sort` uchun umumiy allowlist qisqartmasi                               |
-| `filter`      | —                                 | `filter` uchun to'liq opsiyalar (quyiga qarang) — `allowedKeys` shorthand'dan ustun |
-| `sort`        | —                                 | `sort` uchun `allowedKeys` / `messageStyle`                                         |
-| `maxPerPage`  | core `DEFAULT_MAX_PER_PAGE` (200) | `perPage` yuqori chegarasi. `Infinity` — cap yo'q (⚠️ DoS)                          |
-| `maxLimit`    | core `DEFAULT_MAX_LIMIT` (200)    | `limit` yuqori chegarasi                                                            |
-| `allow`       | `[]`                              | `"columns"` / `"with"` / `"withDeleted"`ni ataylab ochish                           |
+| Opsiya        | Default                           | Ma'nosi                                                                               |
+| ------------- | --------------------------------- | ------------------------------------------------------------------------------------- |
+| `allowedKeys` | —                                 | `filter` va `sort` uchun umumiy allowlist qisqartmasi                                 |
+| `filter`      | —                                 | `filter` uchun to'liq opsiyalar (quyiga qarang) — `allowedKeys` shorthand'dan ustun   |
+| `sort`        | —                                 | `sort` uchun `allowedKeys` / `messageStyle`                                           |
+| `maxPerPage`  | core `DEFAULT_MAX_PER_PAGE` (200) | `perPage` yuqori chegarasi. `Infinity` — cap yo'q (⚠️ DoS)                            |
+| `maxLimit`    | core `DEFAULT_MAX_LIMIT` (200)    | `limit` yuqori chegarasi                                                              |
+| `allow`       | `[]`                              | `"columns"` / `"with"` / `"withDeleted"`ni ataylab ochish                             |
+| `limits`      | core `DEFAULT_QUERY_LIMITS`       | so'rov limitlari ([Limits](#limits)); `filter.*` / `sort.*` dagi alohida opsiya ustun |
 
 `@IsQueryFilter(options)` (va `options.filter`):
 
@@ -115,12 +130,50 @@ Ikkala flag ham **zarur**, aks holda kafolatlar yarim ishlaydi:
 | ------------------ | ------------------------- | ------------------------------------------------------------------------------------------ |
 | `allowedKeys`      | —                         | Berilsa, noma'lum filter kaliti rad etiladi                                                |
 | `allowedOperators` | barcha `FILTER_OPERATORS` | Ruxsat etilgan operatorlar to'plamini toraytirish                                          |
-| `maxDepth`         | `5`                       | `and`/`or`/`not` chuqurlik limiti                                                          |
+| `maxDepth`         | `5`                       | ildizdan bargacha tugunlar soni                                                            |
+| `maxConditions`    | `30`                      | shartlar soni                                                                              |
+| `maxInItems`       | `200`                     | massiv qiymat elementlari                                                                  |
+| `maxStringLength`  | `256`                     | satr qiymat uzunligi                                                                       |
 | `strictValue`      | `false`                   | `in`/`notIn` → massiv, `between`/`notBetween` → 2 qiymat, `isNull`/`isNotNull` → qiymatsiz |
 | `messageStyle`     | `"text"`                  | `"key"` — xato o'rniga i18n kaliti qaytariladi                                             |
 | `rootPath`         | property nomi             | Xato yo'lining ildizi (`filter[0].operation`)                                              |
 
-`@IsQuerySort(options)` — `allowedKeys`, `messageStyle`, `rootPath`.
+`@IsQuerySort(options)` — `allowedKeys`, `maxSortFields` (`3`), `messageStyle`, `rootPath`.
+
+`@IsWithinMaxOffset({ mode, maxOffset? })` — `mode: "page"` (`(page - 1) × perPage`) yoki `"offset"`; `maxOffset` default `10 000`.
+
+## Limits
+
+Har DTO va `validateFilter` / `validateSort` core so'rov limitlarini qo'llaydi — `@querykitjs/zod` bilan bir xil qiymatlar (`DEFAULT_QUERY_LIMITS`).
+
+| Limit             | Default  | Nima sanaladi                                                         | Qayerda                                            |
+| ----------------- | -------- | --------------------------------------------------------------------- | -------------------------------------------------- |
+| `maxDepth`        | `5`      | ildizdan bargacha tugunlar: ildiz 1, har `and`/`or`/`not` va shart +1 | `@IsQueryFilter` / `validateFilter`                |
+| `maxConditions`   | `30`     | barcha guruhlardagi shartlar (barglar)                                | `@IsQueryFilter` / `validateFilter`                |
+| `maxInItems`      | `200`    | bitta massiv qiymatdagi elementlar                                    | `@IsQueryFilter` / `validateFilter`                |
+| `maxStringLength` | `256`    | bitta satr qiymatdagi belgilar (massiv ichida ham)                    | `@IsQueryFilter` / `validateFilter`                |
+| `maxSortFields`   | `3`      | `sort` massividagi maydonlar                                          | `@IsQuerySort` / `validateSort`                    |
+| `maxOffset`       | `10 000` | `(page - 1) × perPage` (`perPage` yo'q bo'lsa 20); infinite `offset`  | `@IsWithinMaxOffset` (DTO'larda `page` / `offset`) |
+
+```ts
+// bitta endpoint uchun limitni oshirish — qolganlari default
+const ImportDto = makeOffsetParamsDto({ limits: { maxInItems: 500 } });
+
+// alohida opsiya `limits`dan ustun
+const DeepDto = makeOffsetParamsDto({ limits: { maxDepth: 6 }, filter: { maxDepth: 8 } }); // 8
+```
+
+- Filtr hajmi iterativ, shakl tekshiruvidan **oldin** tekshiriladi: 10 000 darajali `not` zanjiri stekni to'ldirmaydi.
+- Xato matni limit nomi va qiymatini aytadi (`filter[0].value exceeds maxInItems (200)`). Kalitlar: chuqurlik uchun `querykit.filter.max_depth`, qolgan beshtasi uchun `querykit.limit.exceeded` (args `limit`, `max`) — en/uz/ru kataloglarda.
+- `maxOffset`dan chuqur sahifalar — cursor paginatsiya (`makeCursorParamsDto`).
+- `Infinity` limitni o'chiradi — ⚠️ DoS yuzasi.
+
+## Migrating (DTO limitlari)
+
+- Limitdan oshgan payload endi rad etiladi — static DTO'larda ham, factory'larda ham: `in` 201 element, 257 belgili satr, 31 shart, 4 sort maydoni, `page=502, perPage=20` yoki `offset=10001` endi 400 beradi. Kerak bo'lsa `limits` bilan oshiring.
+- `page` endi `@IsWithinMaxOffset({ mode: "page" })` bilan; o'z DTO'ngizda `page`ni qayta e'lon qilsangiz, shu dekoratorni ham qo'ying.
+- `querykit.filter.max_depth` matni o'zgardi (endi `maxDepth (5)` deydi); matnga emas, kalitga tayaning.
+- `DEFAULT_MAX_FILTER_DEPTH` endi `@querykitjs/core`dan qayta eksport (qiymat o'sha — 5).
 
 ## i18n (bir nechta til)
 
@@ -181,7 +234,7 @@ if (issues.length > 0) {
 | Kontrakt, operatorlar          | core'dan          | **aynan o'sha**                                |
 | Noma'lum maydonni strip qilish | avtomatik         | `ValidationPipe({ whitelist: true })` orqali   |
 | Field allowlist                | yo'q              | `allowedKeys`                                  |
-| Chuqurlik limiti               | yo'q              | `maxDepth` (default 5)                         |
+| So'rov limitlari               | bir xil (core)    | bir xil (core) — `limits`                      |
 | `NaN` / `Infinity`             | `Infinity` o'tadi | ikkalasi ham rad etiladi (JSON'da mavjud emas) |
 | i18n                           | —                 | `querykit.*` kalitlari + en/uz/ru kataloglar   |
 

package/dist/chunk-AX53IY63.cjs

@@ -0,0 +1,89 @@
+'use strict';
+
+var chunkHKLXL3NW_cjs = require('./chunk-HKLXL3NW.cjs');
+var classValidator = require('class-validator');
+var core = require('@querykitjs/core');
+var internal = require('@querykitjs/core/internal');
+
+var optionsOf = (args, fallbackPath) => {
+  let given = args?.constraints?.[0] ?? {};
+  return { rootPath: args?.property ?? fallbackPath, ...given };
+}, firstMessage = (issues, options, args, fallback) => {
+  let first = issues[0];
+  return first ? options.messageStyle === "key" ? first.key : first.message : `${args?.property ?? "value"} ${fallback}`;
+}; exports.IsQueryFilterConstraint = class IsQueryFilterConstraint {
+  validate(value, args) {
+    return chunkHKLXL3NW_cjs.validateFilter(value, optionsOf(args, "filter")).length === 0;
+  }
+  defaultMessage(args) {
+    let options = optionsOf(args, "filter");
+    return firstMessage(chunkHKLXL3NW_cjs.validateFilter(args?.value, options), options, args, "is not a valid querykit filter");
+  }
+};
+exports.IsQueryFilterConstraint = chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.ValidatorConstraint({ name: "isQueryFilter", async: false })
+], exports.IsQueryFilterConstraint);
+exports.IsQuerySortConstraint = class IsQuerySortConstraint {
+  validate(value, args) {
+    return chunkHKLXL3NW_cjs.validateSort(value, optionsOf(args, "sort")).length === 0;
+  }
+  defaultMessage(args) {
+    let options = optionsOf(args, "sort");
+    return firstMessage(chunkHKLXL3NW_cjs.validateSort(args?.value, options), options, args, "is not a valid querykit sort");
+  }
+};
+exports.IsQuerySortConstraint = chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.ValidatorConstraint({ name: "isQuerySort", async: false })
+], exports.IsQuerySortConstraint);
+var maxOffsetOf = (args) => args?.constraints?.[0]?.maxOffset ?? core.DEFAULT_MAX_OFFSET; exports.IsWithinMaxOffsetConstraint = class IsWithinMaxOffsetConstraint {
+  validate(value, args) {
+    if (typeof value != "number") return true;
+    let perPage = args?.object?.perPage;
+    return (args?.constraints?.[0]?.mode === "page" ? internal.offsetOf(value, typeof perPage == "number" ? perPage : void 0) : value) <= maxOffsetOf(args);
+  }
+  defaultMessage(args) {
+    return chunkHKLXL3NW_cjs.formatMessage("querykit.limit.exceeded", { path: args?.property ?? "offset", limit: "maxOffset", max: maxOffsetOf(args) });
+  }
+};
+exports.IsWithinMaxOffsetConstraint = chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.ValidatorConstraint({ name: "isWithinMaxOffset", async: false })
+], exports.IsWithinMaxOffsetConstraint);
+function IsWithinMaxOffset(options, validationOptions) {
+  return (target, propertyName) => {
+    classValidator.registerDecorator({
+      target: target.constructor,
+      propertyName,
+      options: validationOptions,
+      constraints: [options],
+      validator: exports.IsWithinMaxOffsetConstraint
+    });
+  };
+}
+function IsQueryFilter(options, validationOptions) {
+  return (target, propertyName) => {
+    classValidator.registerDecorator({
+      target: target.constructor,
+      propertyName,
+      options: validationOptions,
+      constraints: [options],
+      validator: exports.IsQueryFilterConstraint
+    });
+  };
+}
+function IsQuerySort(options, validationOptions) {
+  return (target, propertyName) => {
+    classValidator.registerDecorator({
+      target: target.constructor,
+      propertyName,
+      options: validationOptions,
+      constraints: [options],
+      validator: exports.IsQuerySortConstraint
+    });
+  };
+}
+
+exports.IsQueryFilter = IsQueryFilter;
+exports.IsQuerySort = IsQuerySort;
+exports.IsWithinMaxOffset = IsWithinMaxOffset;
+//# sourceMappingURL=chunk-AX53IY63.cjs.map
+//# sourceMappingURL=chunk-AX53IY63.cjs.map

package/dist/chunk-AX53IY63.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/decorators.ts"],"names":["IsQueryFilterConstraint","validateFilter","__decorateClass","ValidatorConstraint","IsQuerySortConstraint","validateSort","DEFAULT_MAX_OFFSET","IsWithinMaxOffsetConstraint","offsetOf","formatMessage","registerDecorator"],"mappings":"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","file":"chunk-AX53IY63.cjs","sourcesContent":["/**\n * `class-validator` o'rovi. Butun mantiq `validate.ts`da — bu yerda faqat\n * konstraint klasslari va ularni property'ga bog'laydigan dekorator factory'lari.\n *\n * Rekursiya `validateFilter` ichida bo'lgani uchun nested DTO klassi ham,\n * `@ValidateNested` ham kerak emas: butun `and`/`or`/`not` daraxti bitta\n * dekorator bilan tekshiriladi.\n */\nimport { registerDecorator, ValidatorConstraint } from \"class-validator\";\nimport type { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from \"class-validator\";\nimport { DEFAULT_MAX_OFFSET } from \"@querykitjs/core\";\nimport { offsetOf } from \"@querykitjs/core/internal\";\nimport { formatMessage } from \"./messages\";\nimport { validateFilter, validateSort, type QueryFilterOptions, type QuerySortOptions, type ValidationIssue } from \"./validate\";\n\n/** Dekorator darajasidagi qo'shimcha — yadro buni o'qimaydi. */\nexport interface MessageStyleOptions {\n  /**\n   * Xato matni qanday shaklda qaytsin:\n   * - `\"text\"` (default) — tayyor inglizcha jumla, i18n'siz app ham o'qiydi;\n   * - `\"key\"` — `querykit.filter.*` kaliti, `nestjs-i18n`ning `I18nValidationPipe`i\n   *   uni so'rovning tiliga tarjima qiladi.\n   */\n  messageStyle?: \"text\" | \"key\";\n}\n\nexport type IsQueryFilterOptions = QueryFilterOptions & MessageStyleOptions;\nexport type IsQuerySortOptions = QuerySortOptions & MessageStyleOptions;\n\n/* -------------------------------- helpers --------------------------------- */\n\nconst optionsOf = <TOptions extends MessageStyleOptions>(args: ValidationArguments | undefined, fallbackPath: string): TOptions => {\n  const given = (args?.constraints?.[0] ?? {}) as TOptions;\n  /* Xato yo'li DTO property nomidan boshlansin: `where` deb nomlangan maydon\n   * `filter.operation` emas, `where.operation` deb chiqadi. */\n  return { rootPath: args?.property ?? fallbackPath, ...given };\n};\n\nconst firstMessage = (issues: ValidationIssue[], options: MessageStyleOptions, args: ValidationArguments | undefined, fallback: string): string => {\n  const first = issues[0];\n  if (!first) return `${args?.property ?? \"value\"} ${fallback}`;\n  return options.messageStyle === \"key\" ? first.key : first.message;\n};\n\n/* ------------------------------- constraints ------------------------------ */\n/* DIQQAT: class-validator konstraint instansiyasini bir marta yaratib, barcha\n * so'rovlar uchun qayta ishlatadi. Shu sababli issue'lar `this`da HECH QACHON\n * keshlanmaydi — parallel so'rovlarda xabarlar aralashib ketardi. `defaultMessage`\n * `validateFilter`ni qayta chaqiradi: u sof, holatsiz va arzon. */\n\n/** `@IsQueryFilter()` ortidagi konstraint — test va qayta ishlatish uchun ochiq. */\n@ValidatorConstraint({ name: \"isQueryFilter\", async: false })\nexport class IsQueryFilterConstraint implements ValidatorConstraintInterface {\n  validate(value: unknown, args?: ValidationArguments): boolean {\n    return validateFilter(value, optionsOf<IsQueryFilterOptions>(args, \"filter\")).length === 0;\n  }\n\n  defaultMessage(args?: ValidationArguments): string {\n    const options = optionsOf<IsQueryFilterOptions>(args, \"filter\");\n    return firstMessage(validateFilter(args?.value, options), options, args, \"is not a valid querykit filter\");\n  }\n}\n\n/** `@IsQuerySort()` ortidagi konstraint. */\n@ValidatorConstraint({ name: \"isQuerySort\", async: false })\nexport class IsQuerySortConstraint implements ValidatorConstraintInterface {\n  validate(value: unknown, args?: ValidationArguments): boolean {\n    return validateSort(value, optionsOf<IsQuerySortOptions>(args, \"sort\")).length === 0;\n  }\n\n  defaultMessage(args?: ValidationArguments): string {\n    const options = optionsOf<IsQuerySortOptions>(args, \"sort\");\n    return firstMessage(validateSort(args?.value, options), options, args, \"is not a valid querykit sort\");\n  }\n}\n\n/** `@IsWithinMaxOffset()` opsiyalari. */\nexport interface IsWithinMaxOffsetOptions {\n  /**\n   * `\"page\"` — property `page`, offset `(page - 1) × perPage` (o'sha obyektning `perPage`i,\n   * yo'q bo'lsa core `DEFAULT_PER_PAGE`); `\"offset\"` — property qiymatining o'zi (infinite).\n   */\n  mode: \"page\" | \"offset\";\n  /** Default — core `DEFAULT_MAX_OFFSET` (10 000). `Infinity` tekshiruvni o'chiradi. */\n  maxOffset?: number;\n}\n\nconst maxOffsetOf = (args: ValidationArguments | undefined): number =>\n  (args?.constraints?.[0] as IsWithinMaxOffsetOptions | undefined)?.maxOffset ?? DEFAULT_MAX_OFFSET;\n\n/** `@IsWithinMaxOffset()` ortidagi konstraint. Raqam bo'lmagan qiymatni `@IsInt()` rad etadi, bu yerda o'tadi. */\n@ValidatorConstraint({ name: \"isWithinMaxOffset\", async: false })\nexport class IsWithinMaxOffsetConstraint implements ValidatorConstraintInterface {\n  validate(value: unknown, args?: ValidationArguments): boolean {\n    if (typeof value !== \"number\") return true;\n    const perPage = (args?.object as { perPage?: unknown } | undefined)?.perPage;\n    const isPage = (args?.constraints?.[0] as IsWithinMaxOffsetOptions | undefined)?.mode === \"page\";\n    return (isPage ? offsetOf(value, typeof perPage === \"number\" ? perPage : undefined) : value) <= maxOffsetOf(args);\n  }\n\n  defaultMessage(args?: ValidationArguments): string {\n    return formatMessage(\"querykit.limit.exceeded\", { path: args?.property ?? \"offset\", limit: \"maxOffset\", max: maxOffsetOf(args) });\n  }\n}\n\n/* ------------------------------- decorators ------------------------------- */\n\n/**\n * Sahifa chuqurligini cheklaydi: `page` uchun `(page - 1) × perPage`, infinite `offset` uchun\n * qiymatning o'zi `maxOffset`dan oshmasin. Chuqurroq sahifalar — cursor paginatsiya.\n *\n * @example\n * ```ts\n * class ListDto {\n *   @IsOptional() @Type(() => Number) @IsInt() @IsPositive() @IsWithinMaxOffset({ mode: \"page\" })\n *   page?: number;\n * }\n * ```\n */\nexport function IsWithinMaxOffset(options: IsWithinMaxOffsetOptions, validationOptions?: ValidationOptions): PropertyDecorator {\n  return (target, propertyName) => {\n    registerDecorator({\n      target: target.constructor,\n      propertyName: propertyName as string,\n      options: validationOptions,\n      constraints: [options],\n      validator: IsWithinMaxOffsetConstraint,\n    });\n  };\n}\n\n/**\n * Property'ni querykit `Filter` kontraktiga tekshiradi: flat massiv (implicit AND),\n * nested `and`/`or`/`not` daraxti va core `FILTER_OPERATORS`ning to'liq to'plami.\n *\n * `undefined` qiymatni **rad etmaydi** — maydonni ixtiyoriy qilish uchun\n * `@IsOptional()` bilan birga ishlating (DTO'lardagi kabi).\n *\n * @example\n * ```ts\n * class ListUsersDto extends OffsetParamsDto {\n *   @IsOptional()\n *   @IsQueryFilter({ allowedKeys: [\"id\", \"name\", \"createdAt\"] })\n *   declare filter?: Filter;\n * }\n * ```\n */\nexport function IsQueryFilter(options?: IsQueryFilterOptions, validationOptions?: ValidationOptions): PropertyDecorator {\n  return (target, propertyName) => {\n    registerDecorator({\n      target: target.constructor,\n      propertyName: propertyName as string,\n      options: validationOptions,\n      constraints: [options],\n      validator: IsQueryFilterConstraint,\n    });\n  };\n}\n\n/**\n * Property'ni querykit `Sort` kontraktiga tekshiradi — `{ key, direction }[]`.\n * Qarang: {@link IsQueryFilter}.\n */\nexport function IsQuerySort(options?: IsQuerySortOptions, validationOptions?: ValidationOptions): PropertyDecorator {\n  return (target, propertyName) => {\n    registerDecorator({\n      target: target.constructor,\n      propertyName: propertyName as string,\n      options: validationOptions,\n      constraints: [options],\n      validator: IsQuerySortConstraint,\n    });\n  };\n}\n"]}

package/dist/chunk-HKLXL3NW.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+var core = require('@querykitjs/core');
+var internal = require('@querykitjs/core/internal');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  for (var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target, i = decorators.length - 1, decorator; i >= 0; i--)
+    (decorator = decorators[i]) && (result = (kind ? decorator(target, key, result) : decorator(result)) || result);
+  return kind && result && __defProp(target, key, result), result;
+};
+function localizeIssue(issue, catalog) {
+  return internal.formatMessage(issue.key, issue.args, catalog);
+}
+
+// src/validate.ts
+var joinPath = (root, path) => path.reduce((joined, part) => typeof part == "number" ? `${joined}[${part}]` : `${joined}.${part}`, root), toValidationIssue = (root) => (found) => {
+  let path = joinPath(root, found.path), args = { path, ...found.args };
+  return { path, key: found.key, message: internal.formatMessage(found.key, args), args };
+};
+function validateFilter(value, options = {}) {
+  return internal.checkFilter(value, options).map(toValidationIssue(options.rootPath ?? "filter"));
+}
+function validateSort(value, options = {}) {
+  return internal.checkSort(value, options).map(toValidationIssue(options.rootPath ?? "sort"));
+}
+
+Object.defineProperty(exports, "DEFAULT_MAX_FILTER_DEPTH", {
+  enumerable: true,
+  get: function () { return core.DEFAULT_MAX_FILTER_DEPTH; }
+});
+Object.defineProperty(exports, "formatMessage", {
+  enumerable: true,
+  get: function () { return internal.formatMessage; }
+});
+exports.__decorateClass = __decorateClass;
+exports.localizeIssue = localizeIssue;
+exports.validateFilter = validateFilter;
+exports.validateSort = validateSort;
+//# sourceMappingURL=chunk-HKLXL3NW.cjs.map
+//# sourceMappingURL=chunk-HKLXL3NW.cjs.map

package/dist/chunk-HKLXL3NW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts","../src/validate.ts"],"names":["formatMessage","checkFilter","checkSort"],"mappings":";;;;;;;;;;;;AAuBO,SAAS,aAAA,CAAc,OAAuD,OAAA,EAAyC;AAC5H,EAAA,OAAOA,sBAAA,CAAc,KAAA,CAAM,GAAA,EAAK,KAAA,CAAM,MAAM,OAAO,CAAA;AACrD;;;AC+CA,IAAM,QAAA,GAAW,CAAC,IAAA,EAAc,IAAA,KAC9B,IAAA,CAAK,MAAA,CAAe,CAAC,MAAA,EAAQ,IAAA,KAAU,OAAO,IAAA,IAAS,QAAA,GAAW,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,CAAA,GAAM,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAK,IAAI,CAAA,EAG/G,iBAAA,GACJ,CAAC,IAAA,KACD,CAAC,KAAA,KAA6E;AAC5E,EAAA,IAAM,IAAA,GAAO,QAAA,CAAS,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA,EAChC,IAAA,GAAoB,EAAE,IAAA,EAAM,GAAG,KAAA,CAAM,IAAA,EAAK;AAChD,EAAA,OAAO,EAAE,IAAA,EAAM,GAAA,EAAK,KAAA,CAAM,GAAA,EAAK,OAAA,EAASA,sBAAA,CAAc,KAAA,CAAM,GAAA,EAAK,IAAI,CAAA,EAAG,IAAA,EAAK;AAC/E,CAAA;AAaK,SAAS,cAAA,CAAe,KAAA,EAAgB,OAAA,GAA8B,EAAC,EAAsB;AAClG,EAAA,OAAOC,oBAAA,CAAY,OAAO,OAAO,CAAA,CAAE,IAAI,iBAAA,CAAkB,OAAA,CAAQ,QAAA,IAAY,QAAQ,CAAC,CAAA;AACxF;AAKO,SAAS,YAAA,CAAa,KAAA,EAAgB,OAAA,GAA4B,EAAC,EAAsB;AAC9F,EAAA,OAAOC,kBAAA,CAAU,OAAO,OAAO,CAAA,CAAE,IAAI,iBAAA,CAAkB,OAAA,CAAQ,QAAA,IAAY,MAAM,CAAC,CAAA;AACpF","file":"chunk-HKLXL3NW.cjs","sourcesContent":["/**\n * Xabar formatlash. Kataloglar `locales.ts`da; `formatMessage` core'da\n * (boshqa validatorlar bilan bitta), bu yerda faqat `localizeIssue`.\n *\n * Har bir {@link ValidationIssue} uchta narsani olib yuradi: `key` (tarjima\n * kaliti), `message` (tayyor matn) va `args` (interpolatsiya qiymatlari). Shu\n * sababli paket i18n'ga **majburlamaydi**, lekin unga to'liq mos.\n */\nimport { formatMessage, type MessageArgs, type QueryKitMessageCatalog, type QueryKitMessageKey } from \"@querykitjs/core/internal\";\n\n/** Kalitni matnga aylantirish va argument tipi — core'dan (`formatMessage(key, args, catalog)`, default inglizcha). */\nexport { formatMessage };\nexport type { MessageArgs };\n\n/**\n * Issue'ni tanlangan tilda qayta formatlaydi — `message` inglizcha yozilgan\n * bo'lsa ham, javobni boshqa tilda berish uchun.\n *\n * @example\n * ```ts\n * issues.map(issue => localizeIssue(issue, QUERYKIT_MESSAGES_RU));\n * ```\n */\nexport function localizeIssue(issue: { key: QueryKitMessageKey; args: MessageArgs }, catalog: QueryKitMessageCatalog): string {\n  return formatMessage(issue.key, issue.args, catalog);\n}\n","/**\n * Sof TS validatsiya yadrosi — **framework-agnostik**. Tekshiruv mantiqi core\n * `checkFilter`/`checkSort` da (`@querykitjs/core/internal`) — boshqa validatorlar\n * bilan bitta; bu yerda faqat yo'l satri va xabar matni quriladi.\n * `class-validator` dekoratorlari (`decorators.ts`) faqat yupqa o'rov, shuning\n * uchun yadroni Nest'siz ham (Express, Hono, oddiy funksiya) ishlatish mumkin.\n */\nimport { DEFAULT_MAX_FILTER_DEPTH } from \"@querykitjs/core\";\nimport type { FilterOperator } from \"@querykitjs/core\";\nimport { checkFilter, checkSort, type LimitPath, type WireFilterIssueKey, type WireIssue, type WireSortIssueKey } from \"@querykitjs/core/internal\";\nimport { formatMessage, type MessageArgs } from \"./messages\";\nimport type { QueryKitMessageKey } from \"./locales\";\n\n/** Filter daraxti chuqurligi default limiti — core'dan (yagona manba, R7). */\nexport { DEFAULT_MAX_FILTER_DEPTH };\n\nexport interface QueryFilterOptions {\n  /**\n   * Berilsa — faqat shu kalitlarga ruxsat; noma'lum kalit **rad etiladi**.\n   * Backend adapterlari noma'lum kalitni jimgina tashlaydi, bu qatlam esa\n   * qat'iyroq: mijoz mavjud bo'lmagan maydon bo'yicha filtr yubora olmaydi.\n   * Berilmasa — istalgan string kalit o'tadi (`@querykitjs/zod` bilan parity).\n   */\n  allowedKeys?: readonly string[];\n  /** Ruxsat etilgan operatorlar. Default — core `FILTER_OPERATORS`ning hammasi. */\n  allowedOperators?: readonly FilterOperator[];\n  /** Ildizdan bargacha tugunlar soni (ildiz 1, har `and`/`or`/`not` va shart +1). Default — core `DEFAULT_MAX_FILTER_DEPTH` (5). */\n  maxDepth?: number;\n  /** Barcha guruhlardagi shartlar (barglar) soni. Default — core `DEFAULT_MAX_CONDITIONS` (30). */\n  maxConditions?: number;\n  /** Bitta massiv qiymatdagi elementlar (`in`, `notIn`, …). Default — core `DEFAULT_MAX_IN_ITEMS` (200). */\n  maxInItems?: number;\n  /** Bitta satr qiymatdagi belgilar (massiv ichida ham). Default — core `DEFAULT_MAX_STRING_LENGTH` (256). */\n  maxStringLength?: number;\n  /**\n   * Operator↔qiymat shakli tekshiruvi (opt-in): `in`/`notIn` massiv talab qiladi,\n   * `between`/`notBetween` — aynan ikki element, `isNull`/`isNotNull` — qiymatsiz.\n   * Default `false`, ya'ni `@querykitjs/zod` bilan bir xil qat'iylik.\n   */\n  strictValue?: boolean;\n  /**\n   * `path`ning ildizi. Default `\"filter\"`. Dekorator buni DTO property nomiga\n   * qo'yadi, ya'ni `where` deb nomlangan maydon xatosi `filter.operation` emas,\n   * `where.operation` deb chiqadi.\n   */\n  rootPath?: string;\n}\n\nexport interface QuerySortOptions {\n  /** Berilsa — faqat shu kalitlar bo'yicha saralashga ruxsat. */\n  allowedKeys?: readonly string[];\n  /** `sort` massividagi maydonlar soni. Default — core `DEFAULT_MAX_SORT_FIELDS` (3). */\n  maxSortFields?: number;\n  /** `path`ning ildizi. Default `\"sort\"`. Qarang: {@link QueryFilterOptions.rootPath}. */\n  rootPath?: string;\n}\n\n/** Bitta validatsiya xatosi. */\nexport interface ValidationIssue {\n  /** Xato joyi, masalan `filter.and[1].or[0].value`. */\n  path: string;\n  /** i18n kaliti — iste'molchi tarjima faylida shu kalit qidiriladi. */\n  key: QueryKitMessageKey;\n  /** Tayyor inglizcha matn — tarjimasiz ham o'qiladi. */\n  message: string;\n  /** Interpolatsiya argumentlari (`path` har doim bor) — `I18nValidationPipe` uchun. */\n  args: MessageArgs;\n}\n\n/* ------------------------------- internals -------------------------------- */\n\n/** Core path → `filter.and[1].or[0].value`. */\nconst joinPath = (root: string, path: LimitPath): string =>\n  path.reduce<string>((joined, part) => (typeof part === \"number\" ? `${joined}[${part}]` : `${joined}.${part}`), root);\n\n/** A core issue as this package reports it: a string path under `root`, an English message, `path` first in the args. */\nconst toValidationIssue =\n  (root: string) =>\n  (found: WireIssue<WireFilterIssueKey | WireSortIssueKey>): ValidationIssue => {\n    const path = joinPath(root, found.path);\n    const args: MessageArgs = { path, ...found.args };\n    return { path, key: found.key, message: formatMessage(found.key, args), args };\n  };\n\n/* -------------------------------- public ---------------------------------- */\n\n/**\n * Filter daraxtini core kontraktiga tekshiradi. Bo'sh massiv = valid.\n *\n * @example\n * ```ts\n * const issues = validateFilter(body.filter, { allowedKeys: [\"id\", \"name\"] });\n * if (issues.length) throw new BadRequestException(issues);\n * ```\n */\nexport function validateFilter(value: unknown, options: QueryFilterOptions = {}): ValidationIssue[] {\n  return checkFilter(value, options).map(toValidationIssue(options.rootPath ?? \"filter\"));\n}\n\n/**\n * Sort massivini core kontraktiga tekshiradi (`{ key, direction }[]`). Bo'sh massiv = valid.\n */\nexport function validateSort(value: unknown, options: QuerySortOptions = {}): ValidationIssue[] {\n  return checkSort(value, options).map(toValidationIssue(options.rootPath ?? \"sort\"));\n}\n"]}

package/dist/chunk-PKGWV2JC.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var chunkAX53IY63_cjs = require('./chunk-AX53IY63.cjs');
+var chunkHKLXL3NW_cjs = require('./chunk-HKLXL3NW.cjs');
+var classTransformer = require('class-transformer');
+var classValidator = require('class-validator');
+var core = require('@querykitjs/core');
+
+var BaseParamsDto = class {
+};
+chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  chunkAX53IY63_cjs.IsQueryFilter()
+], BaseParamsDto.prototype, "filter", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  chunkAX53IY63_cjs.IsQuerySort()
+], BaseParamsDto.prototype, "sort", 2);
+var OffsetParamsDto = class extends BaseParamsDto {
+};
+chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classTransformer.Type(() => Number),
+  classValidator.IsInt(),
+  classValidator.IsPositive(),
+  chunkAX53IY63_cjs.IsWithinMaxOffset({ mode: "page" })
+], OffsetParamsDto.prototype, "page", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classTransformer.Type(() => Number),
+  classValidator.IsInt(),
+  classValidator.IsPositive(),
+  classValidator.Max(core.DEFAULT_MAX_PER_PAGE)
+], OffsetParamsDto.prototype, "perPage", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classValidator.IsBoolean()
+], OffsetParamsDto.prototype, "withTotal", 2);
+var InfiniteParamsDto = class extends BaseParamsDto {
+};
+chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classTransformer.Type(() => Number),
+  classValidator.IsInt(),
+  classValidator.IsPositive(),
+  classValidator.Max(core.DEFAULT_MAX_LIMIT)
+], InfiniteParamsDto.prototype, "limit", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classTransformer.Type(() => Number),
+  classValidator.IsInt(),
+  classValidator.Min(0),
+  chunkAX53IY63_cjs.IsWithinMaxOffset({ mode: "offset" })
+], InfiniteParamsDto.prototype, "offset", 2);
+var CursorParamsDto = class {
+};
+chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  chunkAX53IY63_cjs.IsQueryFilter()
+], CursorParamsDto.prototype, "filter", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classTransformer.Type(() => Number),
+  classValidator.IsInt(),
+  classValidator.IsPositive(),
+  classValidator.Max(core.DEFAULT_MAX_LIMIT)
+], CursorParamsDto.prototype, "limit", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classValidator.IsString()
+], CursorParamsDto.prototype, "cursor", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classValidator.IsString()
+], CursorParamsDto.prototype, "cursorKey", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classValidator.IsIn(["asc", "desc"])
+], CursorParamsDto.prototype, "order", 2), chunkHKLXL3NW_cjs.__decorateClass([
+  classValidator.IsOptional(),
+  classValidator.IsIn(["forward", "backward"])
+], CursorParamsDto.prototype, "direction", 2);
+
+exports.BaseParamsDto = BaseParamsDto;
+exports.CursorParamsDto = CursorParamsDto;
+exports.InfiniteParamsDto = InfiniteParamsDto;
+exports.OffsetParamsDto = OffsetParamsDto;
+//# sourceMappingURL=chunk-PKGWV2JC.cjs.map
+//# sourceMappingURL=chunk-PKGWV2JC.cjs.map

package/dist/chunk-PKGWV2JC.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/legacy-dto.ts"],"names":["__decorateClass","IsOptional","IsQueryFilter","IsQuerySort","Type","IsInt","IsPositive","IsWithinMaxOffset","Max","DEFAULT_MAX_PER_PAGE","IsBoolean","DEFAULT_MAX_LIMIT","Min","IsString","IsIn"],"mappings":"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","file":"chunk-PKGWV2JC.cjs","sourcesContent":["/**\n * Static param DTOs (deprecated) — `class ListUsersDto extends OffsetParamsDto`.\n * Kept in their own module: their decorators register class-validator metadata\n * when the module loads, so a bundle that does not import them drops the whole module.\n * New code uses the `make*ParamsDto` factories (`./dto`).\n */\nimport { Type } from \"class-transformer\";\nimport { IsIn, IsInt, IsOptional, IsPositive, IsString, Max, Min, IsBoolean } from \"class-validator\";\nimport { DEFAULT_MAX_LIMIT, DEFAULT_MAX_PER_PAGE } from \"@querykitjs/core\";\nimport type { Filter, Sort, SortDirection } from \"@querykitjs/core\";\nimport { IsQueryFilter, IsQuerySort, IsWithinMaxOffset } from \"./decorators\";\n\n/**\n * Paginatsiyasiz umumiy params — `filter` + `sort`.\n *\n * @deprecated Use `makeOffsetParamsDto` / `makeInfiniteParamsDto` / `makeCursorParamsDto` (safe defaults). Removed in the next major.\n */\nexport class BaseParamsDto {\n  @IsOptional()\n  @IsQueryFilter()\n  filter?: Filter;\n\n  @IsOptional()\n  @IsQuerySort()\n  sort?: Sort;\n}\n\n/**\n * Offset (sahifali) params — `page` + `perPage` (`perPage` ≤ core cap).\n *\n * @deprecated Use `makeOffsetParamsDto` (safe defaults). Removed in the next major.\n */\nexport class OffsetParamsDto extends BaseParamsDto {\n  /* `page`ning o'zida cap yo'q — chegara `(page - 1) × perPage` ≤ `DEFAULT_MAX_OFFSET`\n   * (`@querykitjs/zod` factory'lari ham aynan shunday). */\n  @IsOptional()\n  @Type(() => Number)\n  @IsInt()\n  @IsPositive()\n  @IsWithinMaxOffset({ mode: \"page\" })\n  page?: number;\n\n  @IsOptional()\n  @Type(() => Number)\n  @IsInt()\n  @IsPositive()\n  @Max(DEFAULT_MAX_PER_PAGE)\n  perPage?: number;\n\n  /** `false` — no count; the meta totals are `null`. */\n  @IsOptional()\n  @IsBoolean()\n  withTotal?: boolean;\n}\n\n/**\n * Infinite-scroll params — `limit` + `offset`.\n *\n * @deprecated Use `makeInfiniteParamsDto` (safe defaults). Removed in the next major.\n */\nexport class InfiniteParamsDto extends BaseParamsDto {\n  @IsOptional()\n  @Type(() => Number)\n  @IsInt()\n  @IsPositive()\n  @Max(DEFAULT_MAX_LIMIT)\n  limit?: number;\n\n  @IsOptional()\n  @Type(() => Number)\n  @IsInt()\n  @Min(0)\n  @IsWithinMaxOffset({ mode: \"offset\" })\n  offset?: number;\n}\n\n/**\n * Cursor (keyset) params. `sort` **yo'q**: tartib `order` + `direction` bilan\n * boshqariladi. Shu sababli `BaseParamsDto`dan meros olinmaydi — aks holda\n * `sort` kontraktga qarshi ravishda meros bo'lib qolardi.\n *\n * @deprecated Use `makeCursorParamsDto` (safe defaults). Removed in the next major.\n */\nexport class CursorParamsDto {\n  @IsOptional()\n  @IsQueryFilter()\n  filter?: Filter;\n\n  @IsOptional()\n  @Type(() => Number)\n  @IsInt()\n  @IsPositive()\n  @Max(DEFAULT_MAX_LIMIT)\n  limit?: number;\n\n  @IsOptional()\n  @IsString()\n  cursor?: string | null;\n\n  @IsOptional()\n  @IsString()\n  cursorKey?: string;\n\n  @IsOptional()\n  @IsIn([\"asc\", \"desc\"])\n  order?: SortDirection;\n\n  @IsOptional()\n  @IsIn([\"forward\", \"backward\"])\n  direction?: \"forward\" | \"backward\";\n}\n"]}

package/dist/chunk-QMFPUYJO.js

@@ -0,0 +1,30 @@
+export { DEFAULT_MAX_FILTER_DEPTH } from '@querykitjs/core';
+import { formatMessage, checkFilter, checkSort } from '@querykitjs/core/internal';
+export { formatMessage } from '@querykitjs/core/internal';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  for (var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target, i = decorators.length - 1, decorator; i >= 0; i--)
+    (decorator = decorators[i]) && (result = (kind ? decorator(target, key, result) : decorator(result)) || result);
+  return kind && result && __defProp(target, key, result), result;
+};
+function localizeIssue(issue, catalog) {
+  return formatMessage(issue.key, issue.args, catalog);
+}
+
+// src/validate.ts
+var joinPath = (root, path) => path.reduce((joined, part) => typeof part == "number" ? `${joined}[${part}]` : `${joined}.${part}`, root), toValidationIssue = (root) => (found) => {
+  let path = joinPath(root, found.path), args = { path, ...found.args };
+  return { path, key: found.key, message: formatMessage(found.key, args), args };
+};
+function validateFilter(value, options = {}) {
+  return checkFilter(value, options).map(toValidationIssue(options.rootPath ?? "filter"));
+}
+function validateSort(value, options = {}) {
+  return checkSort(value, options).map(toValidationIssue(options.rootPath ?? "sort"));
+}
+
+export { __decorateClass, localizeIssue, validateFilter, validateSort };
+//# sourceMappingURL=chunk-QMFPUYJO.js.map
+//# sourceMappingURL=chunk-QMFPUYJO.js.map

package/dist/chunk-QMFPUYJO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts","../src/validate.ts"],"names":[],"mappings":";;;;;;;;;;;AAuBO,SAAS,aAAA,CAAc,OAAuD,OAAA,EAAyC;AAC5H,EAAA,OAAO,aAAA,CAAc,KAAA,CAAM,GAAA,EAAK,KAAA,CAAM,MAAM,OAAO,CAAA;AACrD;;;AC+CA,IAAM,QAAA,GAAW,CAAC,IAAA,EAAc,IAAA,KAC9B,IAAA,CAAK,MAAA,CAAe,CAAC,MAAA,EAAQ,IAAA,KAAU,OAAO,IAAA,IAAS,QAAA,GAAW,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,CAAA,GAAM,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAK,IAAI,CAAA,EAG/G,iBAAA,GACJ,CAAC,IAAA,KACD,CAAC,KAAA,KAA6E;AAC5E,EAAA,IAAM,IAAA,GAAO,QAAA,CAAS,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA,EAChC,IAAA,GAAoB,EAAE,IAAA,EAAM,GAAG,KAAA,CAAM,IAAA,EAAK;AAChD,EAAA,OAAO,EAAE,IAAA,EAAM,GAAA,EAAK,KAAA,CAAM,GAAA,EAAK,OAAA,EAAS,aAAA,CAAc,KAAA,CAAM,GAAA,EAAK,IAAI,CAAA,EAAG,IAAA,EAAK;AAC/E,CAAA;AAaK,SAAS,cAAA,CAAe,KAAA,EAAgB,OAAA,GAA8B,EAAC,EAAsB;AAClG,EAAA,OAAO,WAAA,CAAY,OAAO,OAAO,CAAA,CAAE,IAAI,iBAAA,CAAkB,OAAA,CAAQ,QAAA,IAAY,QAAQ,CAAC,CAAA;AACxF;AAKO,SAAS,YAAA,CAAa,KAAA,EAAgB,OAAA,GAA4B,EAAC,EAAsB;AAC9F,EAAA,OAAO,SAAA,CAAU,OAAO,OAAO,CAAA,CAAE,IAAI,iBAAA,CAAkB,OAAA,CAAQ,QAAA,IAAY,MAAM,CAAC,CAAA;AACpF","file":"chunk-QMFPUYJO.js","sourcesContent":["/**\n * Xabar formatlash. Kataloglar `locales.ts`da; `formatMessage` core'da\n * (boshqa validatorlar bilan bitta), bu yerda faqat `localizeIssue`.\n *\n * Har bir {@link ValidationIssue} uchta narsani olib yuradi: `key` (tarjima\n * kaliti), `message` (tayyor matn) va `args` (interpolatsiya qiymatlari). Shu\n * sababli paket i18n'ga **majburlamaydi**, lekin unga to'liq mos.\n */\nimport { formatMessage, type MessageArgs, type QueryKitMessageCatalog, type QueryKitMessageKey } from \"@querykitjs/core/internal\";\n\n/** Kalitni matnga aylantirish va argument tipi — core'dan (`formatMessage(key, args, catalog)`, default inglizcha). */\nexport { formatMessage };\nexport type { MessageArgs };\n\n/**\n * Issue'ni tanlangan tilda qayta formatlaydi — `message` inglizcha yozilgan\n * bo'lsa ham, javobni boshqa tilda berish uchun.\n *\n * @example\n * ```ts\n * issues.map(issue => localizeIssue(issue, QUERYKIT_MESSAGES_RU));\n * ```\n */\nexport function localizeIssue(issue: { key: QueryKitMessageKey; args: MessageArgs }, catalog: QueryKitMessageCatalog): string {\n  return formatMessage(issue.key, issue.args, catalog);\n}\n","/**\n * Sof TS validatsiya yadrosi — **framework-agnostik**. Tekshiruv mantiqi core\n * `checkFilter`/`checkSort` da (`@querykitjs/core/internal`) — boshqa validatorlar\n * bilan bitta; bu yerda faqat yo'l satri va xabar matni quriladi.\n * `class-validator` dekoratorlari (`decorators.ts`) faqat yupqa o'rov, shuning\n * uchun yadroni Nest'siz ham (Express, Hono, oddiy funksiya) ishlatish mumkin.\n */\nimport { DEFAULT_MAX_FILTER_DEPTH } from \"@querykitjs/core\";\nimport type { FilterOperator } from \"@querykitjs/core\";\nimport { checkFilter, checkSort, type LimitPath, type WireFilterIssueKey, type WireIssue, type WireSortIssueKey } from \"@querykitjs/core/internal\";\nimport { formatMessage, type MessageArgs } from \"./messages\";\nimport type { QueryKitMessageKey } from \"./locales\";\n\n/** Filter daraxti chuqurligi default limiti — core'dan (yagona manba, R7). */\nexport { DEFAULT_MAX_FILTER_DEPTH };\n\nexport interface QueryFilterOptions {\n  /**\n   * Berilsa — faqat shu kalitlarga ruxsat; noma'lum kalit **rad etiladi**.\n   * Backend adapterlari noma'lum kalitni jimgina tashlaydi, bu qatlam esa\n   * qat'iyroq: mijoz mavjud bo'lmagan maydon bo'yicha filtr yubora olmaydi.\n   * Berilmasa — istalgan string kalit o'tadi (`@querykitjs/zod` bilan parity).\n   */\n  allowedKeys?: readonly string[];\n  /** Ruxsat etilgan operatorlar. Default — core `FILTER_OPERATORS`ning hammasi. */\n  allowedOperators?: readonly FilterOperator[];\n  /** Ildizdan bargacha tugunlar soni (ildiz 1, har `and`/`or`/`not` va shart +1). Default — core `DEFAULT_MAX_FILTER_DEPTH` (5). */\n  maxDepth?: number;\n  /** Barcha guruhlardagi shartlar (barglar) soni. Default — core `DEFAULT_MAX_CONDITIONS` (30). */\n  maxConditions?: number;\n  /** Bitta massiv qiymatdagi elementlar (`in`, `notIn`, …). Default — core `DEFAULT_MAX_IN_ITEMS` (200). */\n  maxInItems?: number;\n  /** Bitta satr qiymatdagi belgilar (massiv ichida ham). Default — core `DEFAULT_MAX_STRING_LENGTH` (256). */\n  maxStringLength?: number;\n  /**\n   * Operator↔qiymat shakli tekshiruvi (opt-in): `in`/`notIn` massiv talab qiladi,\n   * `between`/`notBetween` — aynan ikki element, `isNull`/`isNotNull` — qiymatsiz.\n   * Default `false`, ya'ni `@querykitjs/zod` bilan bir xil qat'iylik.\n   */\n  strictValue?: boolean;\n  /**\n   * `path`ning ildizi. Default `\"filter\"`. Dekorator buni DTO property nomiga\n   * qo'yadi, ya'ni `where` deb nomlangan maydon xatosi `filter.operation` emas,\n   * `where.operation` deb chiqadi.\n   */\n  rootPath?: string;\n}\n\nexport interface QuerySortOptions {\n  /** Berilsa — faqat shu kalitlar bo'yicha saralashga ruxsat. */\n  allowedKeys?: readonly string[];\n  /** `sort` massividagi maydonlar soni. Default — core `DEFAULT_MAX_SORT_FIELDS` (3). */\n  maxSortFields?: number;\n  /** `path`ning ildizi. Default `\"sort\"`. Qarang: {@link QueryFilterOptions.rootPath}. */\n  rootPath?: string;\n}\n\n/** Bitta validatsiya xatosi. */\nexport interface ValidationIssue {\n  /** Xato joyi, masalan `filter.and[1].or[0].value`. */\n  path: string;\n  /** i18n kaliti — iste'molchi tarjima faylida shu kalit qidiriladi. */\n  key: QueryKitMessageKey;\n  /** Tayyor inglizcha matn — tarjimasiz ham o'qiladi. */\n  message: string;\n  /** Interpolatsiya argumentlari (`path` har doim bor) — `I18nValidationPipe` uchun. */\n  args: MessageArgs;\n}\n\n/* ------------------------------- internals -------------------------------- */\n\n/** Core path → `filter.and[1].or[0].value`. */\nconst joinPath = (root: string, path: LimitPath): string =>\n  path.reduce<string>((joined, part) => (typeof part === \"number\" ? `${joined}[${part}]` : `${joined}.${part}`), root);\n\n/** A core issue as this package reports it: a string path under `root`, an English message, `path` first in the args. */\nconst toValidationIssue =\n  (root: string) =>\n  (found: WireIssue<WireFilterIssueKey | WireSortIssueKey>): ValidationIssue => {\n    const path = joinPath(root, found.path);\n    const args: MessageArgs = { path, ...found.args };\n    return { path, key: found.key, message: formatMessage(found.key, args), args };\n  };\n\n/* -------------------------------- public ---------------------------------- */\n\n/**\n * Filter daraxtini core kontraktiga tekshiradi. Bo'sh massiv = valid.\n *\n * @example\n * ```ts\n * const issues = validateFilter(body.filter, { allowedKeys: [\"id\", \"name\"] });\n * if (issues.length) throw new BadRequestException(issues);\n * ```\n */\nexport function validateFilter(value: unknown, options: QueryFilterOptions = {}): ValidationIssue[] {\n  return checkFilter(value, options).map(toValidationIssue(options.rootPath ?? \"filter\"));\n}\n\n/**\n * Sort massivini core kontraktiga tekshiradi (`{ key, direction }[]`). Bo'sh massiv = valid.\n */\nexport function validateSort(value: unknown, options: QuerySortOptions = {}): ValidationIssue[] {\n  return checkSort(value, options).map(toValidationIssue(options.rootPath ?? \"sort\"));\n}\n"]}