nicot 1.1.10 → 1.1.12

package/README.md

@@ -203,15 +203,17 @@ NICOT 提供了一套查询装饰器，用于在 Entity 字段上声明支持的
 
 ### ✅ 内建查询装饰器
 
-| 装饰器名                     | 查询效果                                       |
-|-----------------------------|------------------------------------------------|
-| `@QueryEqual()`              | 精确匹配：`WHERE field = :value`              |
-| `@QueryLike()`               | 前缀模糊匹配：`WHERE field LIKE :value%`      |
-| `@QuerySearch()`             | 宽泛模糊搜索：`WHERE field LIKE %:value%`     |
-| `@QueryMatchBoolean()`       | `true/false/1/0` 转换为布尔类型查询            |
-| `@QueryEqualZeroNullable()`  | `0 → IS NULL`，否则 `= :value`（适合 nullable）|
-| `@QueryGreater()`            | 大于查询：`WHERE field > :value`              |
-| `@QueryOrderBy()`            | 排序字段控制：`ORDER BY field ASC|DESC`      |
+| 装饰器名                          | 查询效果                                     |
+|-------------------------------|------------------------------------------|
+| `@QueryEqual()`               | 精确匹配：`WHERE field = :value`              |
+| `@QueryLike()`                | 前缀模糊匹配：`WHERE field LIKE :value%`        |
+| `@QuerySearch()`              | 宽泛模糊搜索：`WHERE field LIKE %:value%`       |
+| `@QueryMatchBoolean()`        | `true/false/1/0` 转换为布尔类型查询               |
+| `@QueryEqualZeroNullable()`   | `0 → IS NULL`，否则 `= :value`（适合 nullable） |
+| `@QueryGreater(field)`        | 大于查询：`WHERE field > :value`              |
+| `@QueryLess(field)`           | 小于查询：`WHERE field < :value`              |
+| `@QueryGreaterOrEqual(field)` | 大于等于查询：`WHERE field >= :value`           |
+| `@QueryLessOrEqual(field)`      | 小于等于查询：`WHERE field <= :value`           |
 
 ---
 
@@ -665,6 +667,139 @@ GET /user?name=Tom&pageCount=2&recordsPerPage=10
 
 ---
 
+## 🔁 游标分页（Cursor Pagination）
+
+NICOT 支持游标式分页查询（Cursor-based Pagination），相比传统的页码分页，在数据量大、频繁变更或无限滚动的场景中更加稳定可靠。
+
+---
+
+### ✅ 使用方式
+
+定义查询 DTO 时继承工厂生成的游标分页基类：
+
+```ts
+class FindAllUserCursorDto extends factory.findAllCursorPaginatedDto {}
+```
+
+在 Controller 中，使用以下工厂方法：
+
+```ts
+@factory.findAllCursorPaginated()
+async findAll(@factory.findAllParam() dto: FindAllUserCursorDto) {
+return this.service.findAllCursorPaginated(dto);
+}
+```
+
+> ⚠️ 注意：`findAll()` 与 `findAllCursorPaginated()` **不能同时使用**，因为它们会绑定到同一个 GET `/` 路由。请选择其中一种分页模式。
+
+---
+
+### 📥 请求字段说明
+
+| 字段名             | 类型    | 描述                                           |
+|--------------------|---------|------------------------------------------------|
+| `recordsPerPage`   | number  | 每页数据数量，默认 25                          |
+| `paginationCursor` | string  | 上一次请求返回的游标（`nextCursor` 或 `previousCursor`）|
+
+- 首次请求无需传 `paginationCursor`
+- 后续请求使用返回的游标即可获取上一页或下一页数据
+
+---
+
+### 📤 返回结构说明
+
+返回值格式与传统分页一致，但字段不同：
+
+```json
+{
+    "statusCode": 200,
+    "success": true,
+    "message": "success",
+    "timestamp": "2025-04-25T12:00:00.000Z",
+    "data": [{}],
+    "nextCursor": "eyJpZCI6MTAwfQ",
+    "previousCursor": "eyJpZCI6NDB9"
+}
+```
+
+- 游标格式为 Base64URL 编码（安全可用于 URL 参数）
+- `nextCursor` / `previousCursor` 是可选字段，仅在有下一页或上一页时返回
+
+---
+
+### 🔐 兼容性说明
+
+- 所有字段控制装饰器（如 `@NotInResult()`, `@QueryEqual()`, `@NotQueryable()` 等）在游标分页中同样生效
+- 查询参数仍来自实体声明，Swagger 自动生成文档
+- 无需变更现有实体结构，只需更换 `findAllDto` 和分页调用方法
+
+---
+
+### ✅ 适用场景
+
+- 无限滚动分页加载（如微博、时间线）
+- 数据频繁变动（传统分页页数易错）
+- 前后端希望避免“总页数”等全表统计带来的性能消耗
+
+---
+
+### 🧪 示例请求
+
+```http
+GET /user?recordsPerPage=20&paginationCursor=eyJpZCI6MTAwfQ
+```
+
+---
+
+### 🛑 注意事项
+
+- 不支持跳页（如 pageCount = 5 这种跳转）
+- 不再返回 `pageCount`、`totalPages` 等字段
+- 若你的 Controller 中已有 `@factory.findAll()`，请不要再使用游标分页版本
+
+---
+
+## 一键生成 Controller
+
+在一般情况下，可以使用 `factory.restfulController()` 生成 RESTful 控制器，自动处理所有 CRUD 接口。
+
+```ts
+const factory = new RestfulFactory(User, {
+  relations: ['articles'],
+});
+
+@Controller('user')
+class UserController extends factory.restfulController() {
+  constructor(userService: UserService) {
+    super(userService)
+  }
+}
+```
+
+这样就可以自动生成所有 CRUD 接口，无需手动编写。
+
+### 选项
+
+```ts
+class UserController extends factory.restfulController({
+  pagination: 'offset' // findAll 的分页模式。可以是 'offset', 'cursor', 'none'。默认为 'offset'
+  globalMethodDecorators: [ApiError(404, 'Error')] // 每个方法都添加的装饰器
+  routes: {
+    findOne: {
+      methodDecorators: [] // 本方法的装饰器
+    },
+    import: {
+      enabled: false // 禁用该路由
+    },
+    // ...
+  }
+}) {}
+```
+
+> 如果需要覆盖某个方法的实现，请在 `routes` 中设置 `enabled: false`，然后手动实现该方法。
+
+---
+
 ## 📦 统一返回结构与接口注解
 
 NICOT 默认提供统一的接口返回格式与 Swagger 自动注解能力，便于前后端标准化对接。

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import 'reflect-metadata';
 export * from 'nesties';
 export * from './src/crud-base';
+export * from './src/restful';
 export * from './src/bases';
 export * from './src/decorators';
 export * from './src/dto';

package/dist/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 require("reflect-metadata");
 __exportStar(require("nesties"), exports);
 __exportStar(require("./src/crud-base"), exports);
+__exportStar(require("./src/restful"), exports);
 __exportStar(require("./src/bases"), exports);
 __exportStar(require("./src/decorators"), exports);
 __exportStar(require("./src/dto"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAA0B;AAE1B,0CAAwB;AACxB,kDAAgC;AAChC,8CAA4B;AAC5B,mDAAiC;AACjC,4CAA0B;AAC1B,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAA0B;AAE1B,0CAAwB;AACxB,kDAAgC;AAChC,gDAA8B;AAC9B,8CAA4B;AAC5B,mDAAiC;AACjC,4CAA0B;AAC1B,gDAA8B"}

package/dist/src/bases/base-restful-controller.d.ts

@@ -0,0 +1,32 @@
+import { CrudBase, RelationDef } from '../crud-base';
+import { Repository } from 'typeorm';
+import { ClassType } from 'nesties';
+export declare const RestfulMethods: readonly ["findOne", "findAll", "create", "update", "delete", "import"];
+export declare type RestfulMethods = typeof RestfulMethods[number];
+export declare type RestfulPaginateType = 'offset' | 'cursor' | 'none';
+export declare class BaseRestfulController<T extends {
+    id: any;
+}> {
+    _options: Partial<{
+        paginateType: RestfulPaginateType;
+        relations: (string | RelationDef)[];
+        entityClass: ClassType<T>;
+    }>;
+    service: CrudBase<T>;
+    constructor(serviceOrRepo: CrudBase<T> | Repository<T>, _options?: Partial<{
+        paginateType: RestfulPaginateType;
+        relations: (string | RelationDef)[];
+        entityClass: ClassType<T>;
+    }>);
+    findOne(id: number): Promise<import("nesties").GenericReturnMessageDto<T>>;
+    findAll(dto: Partial<T>): Promise<import("nesties").GenericPaginatedReturnMessageDto<T>> | Promise<import("../dto").GenericCursorPaginationReturnMessageDto<T>>;
+    create(dto: T): Promise<import("nesties").GenericReturnMessageDto<T>>;
+    update(id: number, dto: Partial<T>): Promise<import("nesties").BlankReturnMessageDto>;
+    delete(id: number): Promise<import("nesties").BlankReturnMessageDto>;
+    import(data: {
+        data: T[];
+    }): Promise<import("nesties").GenericReturnMessageDto<{
+        result: string;
+        entry: T;
+    }[]>>;
+}

package/dist/src/bases/base-restful-controller.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRestfulController = exports.RestfulMethods = void 0;
+const crud_base_1 = require("../crud-base");
+exports.RestfulMethods = [
+    'findOne',
+    'findAll',
+    'create',
+    'update',
+    'delete',
+    'import',
+];
+class BaseRestfulController {
+    constructor(serviceOrRepo, _options = {}) {
+        this._options = _options;
+        if (serviceOrRepo instanceof crud_base_1.CrudBase) {
+            this.service = serviceOrRepo;
+        }
+        else {
+            const crudServiceClass = (0, crud_base_1.CrudService)(this._options.entityClass, {
+                relations: this._options.relations,
+            });
+            this.service = new crudServiceClass(serviceOrRepo);
+        }
+    }
+    findOne(id) {
+        return this.service.findOne(id);
+    }
+    findAll(dto) {
+        if (this._options.paginateType === 'cursor') {
+            return this.service.findAllCursorPaginated(dto);
+        }
+        if (this._options.paginateType === 'offset') {
+            return this.service.findAll(dto);
+        }
+        dto['recordsPerPage'] ??= 99999;
+        return this.service.findAll(dto);
+    }
+    create(dto) {
+        return this.service.create(dto);
+    }
+    update(id, dto) {
+        return this.service.update(id, dto);
+    }
+    delete(id) {
+        return this.service.delete(id);
+    }
+    import(data) {
+        return this.service.importEntities(data.data);
+    }
+}
+exports.BaseRestfulController = BaseRestfulController;
+//# sourceMappingURL=base-restful-controller.js.map

package/dist/src/bases/base-restful-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-restful-controller.js","sourceRoot":"","sources":["../../../src/bases/base-restful-controller.ts"],"names":[],"mappings":";;;AAAA,4CAAkE;AAIrD,QAAA,cAAc,GAAG;IAC5B,SAAS;IACT,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AAMX,MAAa,qBAAqB;IAEhC,YACE,aAA0C,EACnC,WAIF,EAAE;QAJA,aAAQ,GAAR,QAAQ,CAIR;QAEP,IAAI,aAAa,YAAY,oBAAQ,EAAE;YACrC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;SAC9B;aAAM;YACL,MAAM,gBAAgB,GAAG,IAAA,uBAAW,EAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAC9D,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;aACnC,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAAC;SACpD;IACH,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAAC,GAAe;QACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE;YAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;SACjD;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE;YAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;SAClC;QACD,GAAG,CAAC,gBAAgB,CAAC,KAAK,KAAK,CAAC;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,GAAe;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,IAAmB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF;AAlDD,sDAkDC"}

package/dist/src/bases/id-base.d.ts

@@ -22,6 +22,7 @@ export declare function IdBase(idOptions?: IdOptions): {
         getPageCount(): number;
         getRecordsPerPage(): number;
         getStartingFrom(): number;
+        applyPaginationQuery(qb: SelectQueryBuilder<any>): void;
     };
 };
 export interface StringIdOptions extends IdOptions {
@@ -48,5 +49,6 @@ export declare function StringIdBase(idOptions: StringIdOptions): {
         getPageCount(): number;
         getRecordsPerPage(): number;
         getStartingFrom(): number;
+        applyPaginationQuery(qb: SelectQueryBuilder<any>): void;
     };
 };

package/dist/src/bases/page-settings.d.ts

@@ -6,7 +6,7 @@ export interface PageSettingsFactory {
 export interface QueryWise<T> {
     applyQuery(qb: SelectQueryBuilder<T>, entityName: string): void;
 }
-export declare type QueryCond = <T extends PageSettingsDto>(obj: T, qb: SelectQueryBuilder<T>, entityName: string, key: keyof T & string) => any;
+export declare type QueryCond = <T>(obj: T, qb: SelectQueryBuilder<T>, entityName: string, key: keyof T & string) => any;
 export declare class PageSettingsDto implements PageSettingsWise, PageSettingsFactory, QueryWise<PageSettingsDto> {
     pageCount: number;
     recordsPerPage: number;
@@ -14,5 +14,6 @@ export declare class PageSettingsDto implements PageSettingsWise, PageSettingsFa
     getPageCount(): number;
     getRecordsPerPage(): number;
     getStartingFrom(): number;
-    applyQuery(qb: SelectQueryBuilder<PageSettingsDto>, entityName: string): void;
+    applyPaginationQuery(qb: SelectQueryBuilder<any>): void;
+    applyQuery(qb: SelectQueryBuilder<any>, entityName: string): void;
 }

package/dist/src/bases/page-settings.js

@@ -13,7 +13,6 @@ exports.PageSettingsDto = void 0;
 const decorators_1 = require("../decorators");
 const class_validator_1 = require("class-validator");
 const swagger_1 = require("@nestjs/swagger");
-const metadata_1 = require("../utility/metadata");
 class PageSettingsDto {
     getActualPageSettings() {
         return {
@@ -22,24 +21,18 @@ class PageSettingsDto {
         };
     }
     getPageCount() {
-        return this.pageCount || 1;
+        return parseInt(this.pageCount) || 1;
     }
     getRecordsPerPage() {
-        return this.recordsPerPage || 25;
+        return parseInt(this.recordsPerPage) || 25;
     }
     getStartingFrom() {
         return (this.getPageCount() - 1) * this.getRecordsPerPage();
     }
-    applyQuery(qb, entityName) {
-        const queryFields = metadata_1.reflector.getArray('queryConditionFields', this);
-        for (const field of queryFields) {
-            const condition = metadata_1.reflector.get('queryCondition', this, field);
-            if (condition) {
-                condition(this, qb, entityName, field);
-            }
-        }
+    applyPaginationQuery(qb) {
         qb.take(this.getRecordsPerPage()).skip(this.getStartingFrom());
     }
+    applyQuery(qb, entityName) { }
 }
 __decorate([
     (0, decorators_1.NotWritable)(),

package/dist/src/bases/page-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-settings.js","sourceRoot":"","sources":["../../../src/bases/page-settings.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAAyD;AAEzD,qDAAoD;AACpD,6CAA8C;AAC9C,kDAAgD;AAkBhD,MAAa,eAAe;IA2B1B,qBAAqB;QACnB,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE;YAC9B,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE;SACzC,CAAC;IACJ,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,eAAe;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC9D,CAAC;IAED,UAAU,CAAC,EAAuC,EAAE,UAAkB;QACpE,MAAM,WAAW,GAAG,oBAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE;YAC/B,MAAM,SAAS,GAAG,oBAAS,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/D,IAAI,SAAS,EAAE;gBACb,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,KAA8B,CAAC,CAAC;aACjE;SACF;QACD,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AA3CC;IAVC,IAAA,wBAAW,GAAE;IACb,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,gCAAgC;QAC7C,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC;KACX,CAAC;IACD,IAAA,wBAAW,GAAE;;kDACI;AAYlB;IAVC,IAAA,wBAAW,GAAE;IACb,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,mBAAmB;QAChC,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC;KACX,CAAC;IACD,IAAA,wBAAW,GAAE;;uDACS;AAzBzB,0CAwDC"}
+{"version":3,"file":"page-settings.js","sourceRoot":"","sources":["../../../src/bases/page-settings.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAAyD;AAEzD,qDAAoD;AACpD,6CAA8C;AAmB9C,MAAa,eAAe;IA2B1B,qBAAqB;QACnB,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE;YAC9B,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE;SACzC,CAAC;IACJ,CAAC;IAED,YAAY;QACV,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAgB,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,iBAAiB;QACf,OAAO,QAAQ,CAAC,IAAI,CAAC,cAAqB,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,eAAe;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC9D,CAAC;IAED,oBAAoB,CAAC,EAA2B;QAC9C,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,UAAU,CAAC,EAA2B,EAAE,UAAkB,IAAG,CAAC;CAC/D;AAtCC;IAVC,IAAA,wBAAW,GAAE;IACb,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,gCAAgC;QAC7C,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC;KACX,CAAC;IACD,IAAA,wBAAW,GAAE;;kDACI;AAYlB;IAVC,IAAA,wBAAW,GAAE;IACb,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,mBAAmB;QAChC,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC;KACX,CAAC;IACD,IAAA,wBAAW,GAAE;;uDACS;AAzBzB,0CAmDC"}

package/dist/src/crud-base.d.ts

@@ -1,7 +1,8 @@
 import { FindOptionsWhere, Repository, SelectQueryBuilder } from 'typeorm';
-import { DeletionWise, EntityHooks, PageSettingsFactory, QueryWise } from './bases';
+import { EntityHooks, PageSettingsDto, PageSettingsFactory, QueryWise } from './bases';
 import { ConsoleLogger } from '@nestjs/common';
-import { BlankReturnMessageDto, ClassType } from 'nesties';
+import { BlankReturnMessageDto, ClassType, PageSettingsWise } from 'nesties';
+import { CursorPaginationDto } from './dto/cursor-pagination';
 export declare type EntityId<T extends {
     id: any;
 }> = T['id'];
@@ -16,7 +17,7 @@ export declare const Relation: (name: string, options?: Omit<RelationDef, 'name'
 export declare const Inner: (name: string, options?: Omit<RelationDef, 'name'>) => RelationDef;
 export declare type ValidCrudEntity<T> = Record<string, any> & {
     id: any;
-} & Partial<QueryWise<T> & DeletionWise & EntityHooks & PageSettingsFactory>;
+} & Partial<QueryWise<T> & EntityHooks & PageSettingsFactory>;
 export interface CrudOptions<T extends ValidCrudEntity<T>> {
     relations?: (string | RelationDef)[];
     extraGetQuery?: (qb: SelectQueryBuilder<T>) => void;
@@ -41,10 +42,16 @@ export declare class CrudBase<T extends ValidCrudEntity<T>> {
         result: string;
         entry: T;
     }[]>;
-    readonly entityPaginatedReturnMessageDto: new (statusCode: number, message: string, data: T[], total: number, pageSettings: import("nesties").PageSettingsWise) => import("nesties").GenericPaginatedReturnMessageDto<T>;
+    readonly entityPaginatedReturnMessageDto: new (statusCode: number, message: string, data: T[], total: number, pageSettings: PageSettingsWise) => import("nesties").GenericPaginatedReturnMessageDto<T>;
+    readonly entityCursorPaginatedReturnMessageDto: new (statusCode: number, message: string, data: T[], cursorResponse: import("./dto").CursorPaginationResponseWise) => import("./dto").GenericCursorPaginationReturnMessageDto<T>;
     readonly entityRelations: (string | RelationDef)[];
     readonly extraGetQuery: (qb: SelectQueryBuilder<T>) => void;
     readonly log: ConsoleLogger;
+    readonly _typeormRelations: {
+        isArray: boolean;
+        propertyClass: import("nesties").AnyClass;
+        propertyName: string;
+    }[];
     constructor(entityClass: ClassType<T>, repo: Repository<T>, crudOptions: CrudOptions<T>);
     _cleanEntityNotInResultFields(ent: T): T;
     cleanEntityNotInResultFields<E extends T | T[]>(ents: E): E;
@@ -57,11 +64,18 @@ export declare class CrudBase<T extends ValidCrudEntity<T>> {
     }>;
     create(_ent: T, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<import("nesties").GenericReturnMessageDto<T>>;
     get entityAliasName(): string;
-    _applyRelationToQuery(qb: SelectQueryBuilder<T>, relation: RelationDef): void;
-    _applyRelationsToQuery(qb: SelectQueryBuilder<T>): void;
+    _applyQueryRelation(qb: SelectQueryBuilder<T>, relation: RelationDef): void;
+    _applyQueryRelations(qb: SelectQueryBuilder<T>): void;
+    _applyQueryFilters(qb: SelectQueryBuilder<T>, ent: T): void;
     queryBuilder(): SelectQueryBuilder<T>;
     findOne(id: EntityId<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericReturnMessageDto<T>>;
+    _preFindAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<{
+        query: SelectQueryBuilder<T>;
+        newEnt: T;
+        pageSettings: T & PageSettingsDto;
+    }>;
     findAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericPaginatedReturnMessageDto<T>>;
+    findAllCursorPaginated(ent?: Partial<T & Partial<CursorPaginationDto>>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("./dto").GenericCursorPaginationReturnMessageDto<T>>;
     update(id: EntityId<T>, entPart: Partial<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
     delete(id: EntityId<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
     importEntities(_ents: T[], extraChecking?: (ent: T) => string | Promise<string>): Promise<import("nesties").GenericReturnMessageDto<{
@@ -85,10 +99,16 @@ export declare function CrudService<T extends ValidCrudEntity<T>>(entityClass: C
             result: string;
             entry: T;
         }[]>;
-        readonly entityPaginatedReturnMessageDto: new (statusCode: number, message: string, data: T[], total: number, pageSettings: import("nesties").PageSettingsWise) => import("nesties").GenericPaginatedReturnMessageDto<T>;
+        readonly entityPaginatedReturnMessageDto: new (statusCode: number, message: string, data: T[], total: number, pageSettings: PageSettingsWise) => import("nesties").GenericPaginatedReturnMessageDto<T>;
+        readonly entityCursorPaginatedReturnMessageDto: new (statusCode: number, message: string, data: T[], cursorResponse: import("./dto").CursorPaginationResponseWise) => import("./dto").GenericCursorPaginationReturnMessageDto<T>;
         readonly entityRelations: (string | RelationDef)[];
         readonly extraGetQuery: (qb: SelectQueryBuilder<T>) => void;
         readonly log: ConsoleLogger;
+        readonly _typeormRelations: {
+            isArray: boolean;
+            propertyClass: import("nesties").AnyClass;
+            propertyName: string;
+        }[];
         entityClass: ClassType<T>;
         repo: Repository<T>;
         crudOptions: CrudOptions<T>;
@@ -103,11 +123,18 @@ export declare function CrudService<T extends ValidCrudEntity<T>>(entityClass: C
         }>;
         create(_ent: T, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<import("nesties").GenericReturnMessageDto<T>>;
         readonly entityAliasName: string;
-        _applyRelationToQuery(qb: SelectQueryBuilder<T>, relation: RelationDef): void;
-        _applyRelationsToQuery(qb: SelectQueryBuilder<T>): void;
+        _applyQueryRelation(qb: SelectQueryBuilder<T>, relation: RelationDef): void;
+        _applyQueryRelations(qb: SelectQueryBuilder<T>): void;
+        _applyQueryFilters(qb: SelectQueryBuilder<T>, ent: T): void;
         queryBuilder(): SelectQueryBuilder<T>;
         findOne(id: EntityId<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericReturnMessageDto<T>>;
+        _preFindAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<{
+            query: SelectQueryBuilder<T>;
+            newEnt: T;
+            pageSettings: T & PageSettingsDto;
+        }>;
         findAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericPaginatedReturnMessageDto<T>>;
+        findAllCursorPaginated(ent?: Partial<T & Partial<CursorPaginationDto>>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("./dto").GenericCursorPaginationReturnMessageDto<T>>;
         update(id: EntityId<T>, entPart: Partial<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
         delete(id: EntityId<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
         importEntities(_ents: T[], extraChecking?: (ent: T) => string | Promise<string>): Promise<import("nesties").GenericReturnMessageDto<{