nicot 1.1.9 → 1.1.11

package/README.md

@@ -13,8 +13,10 @@
 
 ## 📦 安装
 
+在你的 Nest.js 项目中：
+
 ```bash
-npm install nicot typeorm @nestjs/typeorm class-validator class-transformer reflect-metadata @nestjs/swagger
+npm install nicot @nestjs/config typeorm @nestjs/typeorm class-validator class-transformer reflect-metadata @nestjs/swagger
 ```
 
 ---
@@ -478,8 +480,133 @@ export class UserController {
 - 所有的接口都是返回状态码 200。
 - OpenAPI 文档会自动生成，包含所有 DTO 类型与查询参数。
 - Service 需要使用 `CrudService(Entity, options)` 进行标准化实现。
-- `RestfulFactory` 的选项 `options` 支持传入 `relations`，形式和 `CrudService` 一致，用于自动裁剪结果 DTO 字段。
-  - 如果本内容的 `CrudService` 不查询任何关系字段，那么请设置 `{ relations: [] }` 以裁剪所有关系字段。
+
+---
+
+### 导出 DTO 类
+
+`RestfulFactory` 会自动生成以下 DTO 类：供你导出并在其他的 OpenAPI 装饰器中使用。
+
+```ts
+const factory = new RestfulFactory(User, {
+  relations: ['articles'],
+});
+
+class CreateUserDto extends factory.createDto {} // 创建用 DTO，在 POST /user 中使用
+class UpdateUserDto extends factory.updateDto {} // 更新用 DTO，在 PATCH /user/:id 中使用
+class FindAllUserDto extends factory.findAllDto {} // 查询用 DTO，在 GET /user 中使用
+class UserResultDto extends factory.entityResultDto {} // 查询结果 DTO，在 GET /user/:id 和 GET /user 中返回
+class UserCreateResultDto extends factory.entityCreateResultDto {} // 创建结果 DTO，在 POST /user 中返回。相比 entityResultDto 省略了间接字段和关系字段
+class UserReturnMessageDto extends factory.entityReturnMessageDto {} // 相当于 ReturnMessageDto(UserResultDto)，在 GET /user 中返回
+class UserCreateReturnMessageDto extends factory.entityCreateReturnMessageDto {} // 相当于 ReturnMessageDto(UserCreateResultDto)，在 POST /user 中返回
+class UserArrayResultDto extends factory.entityArrayResultDto {} // 相当于 PaginatedReturnMessageDto(UserResultDto)，在 GET /user 中返回
+```
+
+---
+
+### 关系定义
+
+类似于 `CrudService`，`RestfulFactory` 也需要在配置中定义关系字段。语法和 `CrudService` 的 `relations` 参数完全一致。
+
+```ts
+class User extends IdBase() {
+  @OneToMany(() => Article, article => article.user)
+  articles: Article[];
+
+  @OneToMany(() => Comment, comment => comment.user)
+  comments: Comment[];
+
+  @OneToMany(() => Like, like => like.users)
+  likes: Like[];
+}
+
+class Article extends IdBase() {
+  @ManyToOne(() => User, user => user.articles)
+  user: User;
+
+  @OneToMany(() => Comment, comment => comment.article)
+  comments: Comment[];
+
+  @OneToMany(() => Like, like => like.article)
+  likes: Like[];
+}
+
+class Like extends IdBase() {
+  @ManyToOne(() => User, user => user.likes)
+  user: User;
+
+  @ManyToOne(() => Article, article => article.likes)
+  article: Article;
+}
+
+class Comment extends IdBase() {
+  @ManyToOne(() => Article, article => article.comments)
+  article: Article;
+
+  @ManyToOne(() => User, user => user.articles)
+  user: User;
+}
+
+const factory = new RestfulFactory(User, {
+  relations: ['comments', 'articles', 'articles.comments'], // 生成的 DTO 类中，只含有标明的关系字段，而 articles.user 不会被包含
+});
+
+class UserResultDto extends factory.entityResultDto {
+  // 生成的 DTO 类中包含 comments, articles, articles.comments 字段
+  // 但是不包含 likes, articles.user, articles.likes 等未声明关系字段
+}
+```
+
+如果你的配套 `CrudService` 不准备加载任何关系，那么可以传入空数组：
+
+```ts
+const factory = new RestfulFactory(User, {
+  relations: [], // DTO 不包含任何关系字段
+});
+```
+
+如果不写 `relations`，则默认会尽可能加载所有非 `@NotInResult()` 的关系字段。但现在推荐显式声明需要加载的关系，以避免不必要的 OpenAPI 文档杂乱。
+
+> 这是曾经版本的 nicot (<1.1.9) 的做法。
+
+---
+
+### 依赖关系的间接字段
+
+如果你有实体类，某一间接字段（`@NotColumn()`），依赖某个关系字段，那么需要显示声明这个字段。
+
+```ts
+export class Participant extends IdBase() {
+  @OneToMany(() => Match, match => match.player1)
+  matches1: Match[];
+
+  @OneToMany(() => Match, match => match.player2)
+  matches2: Match[];
+}
+
+export class Match extends IdBase() {
+  @ManyToOne(() => Participant, participant => participant.matches1)
+  player1: Participant;
+  @ManyToOne(() => Participant, participant => participant.matches2)
+  player2: Participant;
+
+  @NotColumn()
+  @RelationComputed(() => Participant) // 声明这个字段依赖于 player1 和 player2 生成，当作关系参与裁剪，避免被拖入 Participant 属性黑洞
+  players: Participant[];
+
+  async afterGet() {
+    this.players = [this.player1, this.player2].filter(s => s);
+  }
+}
+
+const factory = new RestfulFactory(Match, {
+  relations: ['player1', 'player2', 'players'],
+});
+
+class MatchResultDto extends factory.entityResultDto {
+  // 包含 player1, player2, players 字段，但是不包含 player1.matches1, player1.matches2 等间接关系字段
+}
+```
 
 ---
 
@@ -538,6 +665,98 @@ 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()`，请不要再使用游标分页版本
+
+---
+
 ## 📦 统一返回结构与接口注解
 
 NICOT 默认提供统一的接口返回格式与 Swagger 自动注解能力，便于前后端标准化对接。
@@ -546,10 +765,9 @@ NICOT 默认提供统一的接口返回格式与 Swagger 自动注解能力，
 
 ### ✅ 返回结构 DTO 类型（用于 Swagger 类型标注）
 
-#### `ReturnMessageDto(EntityClass)`  
-用于生成带数据的标准返回结构类型（**不是直接返回值**，用于 `@nestjs/swagger`）。
+#### `ReturnMessageDto(EntityClass)`
 
-返回结构样式：
+用于生成带数据的标准返回结构类型（**不是直接返回值**，用于 `@nestjs/swagger`）。
 
 ```json
 {
@@ -557,13 +775,42 @@ NICOT 默认提供统一的接口返回格式与 Swagger 自动注解能力，
   "success": true,
   "message": "success",
   "timestamp": "2025-04-25T12:00:00.000Z",
-  "data": { ... }
+  "data": {}
 }
 ```
 
-#### `BlankReturnMessageDto`  
+#### `BlankReturnMessageDto`
+
 无数据返回结构的类型（用于 DELETE、UPDATE 等空响应）。
 
+```json
+{
+  "statusCode": 200,
+  "success": true,
+  "message": "success"
+}
+```
+
+#### `PaginatedReturnMessageDto(EntityClass)`
+
+带有分页信息的返回结构类型。
+
+> EntityClass 会自动变成数组类型。
+
+```json
+{
+  "statusCode": 200,
+  "success": true,
+  "message": "success",
+  "timestamp": "2025-04-25T12:00:00.000Z",
+  "data": [{}],
+  "total": 100,
+  "totalPages": 4,
+  "pageCount": 1,
+  "recordsPerPage": 25
+}
+```
+
 ---
 
 ### 📊 实际返回结构
@@ -815,3 +1062,7 @@ NICOT 作为一个 “Entity 驱动” 的框架，在开发体验、安全性
 - 内建返回结构、Swagger 注解、守卫装饰器等功能
 
 是构建 NestJS 标准化、低重复、文档完善的后端服务的理想选择。
+
+## LICENSE
+
+MIT

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<{