@lenne.tech/nest-server 11.10.5 → 11.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/nest-server",
-  "version": "11.10.5",
+  "version": "11.11.0",
   "description": "Modern, fast, powerful Node.js web framework in TypeScript based on Nest with a GraphQL API and a connection to MongoDB (or other databases).",
   "keywords": [
     "node",
@@ -78,27 +78,27 @@
     "node": ">= 20"
   },
   "dependencies": {
-    "@apollo/server": "5.2.0",
+    "@apollo/server": "5.3.0",
     "@as-integrations/express5": "1.1.2",
-    "@better-auth/passkey": "1.4.16",
+    "@better-auth/passkey": "1.4.17",
     "@getbrevo/brevo": "3.0.1",
     "@nestjs/apollo": "13.2.3",
-    "@nestjs/common": "11.1.9",
-    "@nestjs/core": "11.1.9",
+    "@nestjs/common": "11.1.12",
+    "@nestjs/core": "11.1.12",
     "@nestjs/graphql": "13.2.3",
     "@nestjs/jwt": "11.0.2",
     "@nestjs/mongoose": "11.0.4",
     "@nestjs/passport": "11.0.5",
-    "@nestjs/platform-express": "11.1.9",
+    "@nestjs/platform-express": "11.1.12",
     "@nestjs/schedule": "6.1.0",
-    "@nestjs/swagger": "11.2.3",
+    "@nestjs/swagger": "11.2.5",
     "@nestjs/terminus": "11.0.0",
-    "@nestjs/websockets": "11.1.9",
+    "@nestjs/websockets": "11.1.12",
     "@tus/file-store": "2.0.0",
     "@tus/server": "2.3.0",
     "apollo-server-core": "3.13.0",
     "bcrypt": "6.0.0",
-    "better-auth": "1.4.16",
+    "better-auth": "1.4.17",
     "class-transformer": "0.5.1",
     "class-validator": "0.14.3",
     "compression": "1.8.1",
@@ -112,12 +112,12 @@
     "graphql-upload": "15.0.2",
     "js-sha256": "0.11.1",
     "json-to-graphql-query": "2.3.0",
-    "lodash": "4.17.21",
+    "lodash": "4.17.23",
     "mongodb": "7.0.0",
-    "mongoose": "9.0.2",
+    "mongoose": "9.1.5",
     "multer": "2.0.2",
     "node-mailjet": "6.0.11",
-    "nodemailer": "7.0.11",
+    "nodemailer": "7.0.12",
     "passport": "0.7.0",
     "passport-jwt": "4.0.1",
     "reflect-metadata": "0.2.2",
@@ -126,28 +126,27 @@
     "yuml-diagram": "1.2.0"
   },
   "devDependencies": {
-    "@compodoc/compodoc": "1.1.32",
+    "@compodoc/compodoc": "1.2.1",
     "@lenne.tech/eslint-config-ts": "2.1.4",
-    "@nestjs/cli": "11.0.14",
+    "@nestjs/cli": "11.0.16",
     "@nestjs/schematics": "11.0.9",
-    "@nestjs/testing": "11.1.9",
+    "@nestjs/testing": "11.1.12",
     "@swc/cli": "0.7.9",
-    "@swc/core": "1.15.7",
+    "@swc/core": "1.15.10",
     "@types/compression": "1.8.1",
     "@types/cookie-parser": "1.4.10",
     "@types/ejs": "3.1.5",
     "@types/express": "4.17.21",
-    "@types/lodash": "4.17.21",
+    "@types/lodash": "4.17.23",
     "@types/multer": "2.0.0",
-    "@types/node": "25.0.3",
-    "@types/nodemailer": "7.0.4",
+    "@types/node": "25.0.10",
+    "@types/nodemailer": "7.0.5",
     "@types/passport": "1.0.17",
     "@types/supertest": "6.0.3",
-    "@typescript-eslint/eslint-plugin": "8.50.0",
-    "@typescript-eslint/parser": "8.50.0",
-    "@vitest/coverage-v8": "4.0.16",
-    "@vitest/ui": "4.0.16",
-    "otpauth": "9.4.1",
+    "@typescript-eslint/eslint-plugin": "8.53.1",
+    "@typescript-eslint/parser": "8.53.1",
+    "@vitest/coverage-v8": "4.0.18",
+    "@vitest/ui": "4.0.18",
     "ansi-colors": "4.1.3",
     "eslint": "9.39.2",
     "eslint-config-prettier": "10.1.8",
@@ -161,11 +160,12 @@
     "husky": "9.1.7",
     "nodemon": "3.1.11",
     "npm-watch": "0.13.0",
+    "otpauth": "9.4.1",
     "pm2": "6.0.14",
     "prettier": "3.7.4",
     "pretty-quick": "4.2.2",
     "rimraf": "6.1.2",
-    "supertest": "7.1.4",
+    "supertest": "7.2.2",
     "ts-jest": "29.4.6",
     "ts-loader": "9.5.4",
     "ts-morph": "27.0.2",
@@ -174,10 +174,10 @@
     "tus-js-client": "4.3.1",
     "typescript": "5.9.3",
     "unplugin-swc": "1.5.9",
-    "vite": "7.3.0",
+    "vite": "7.3.1",
     "vite-plugin-node": "7.0.0",
-    "vite-tsconfig-paths": "6.0.3",
-    "vitest": "4.0.16",
+    "vite-tsconfig-paths": "6.0.5",
+    "vitest": "4.0.18",
     "yalc": "1.0.0-pre.53"
   },
   "jest": {
@@ -208,5 +208,8 @@
   ],
   "watch": {
     "build:dev": "src"
+  },
+  "overrides": {
+    "lodash": "4.17.23"
   }
 }

package/src/core/common/models/pagination-info.model.ts

@@ -0,0 +1,101 @@
+import { ObjectType } from '@nestjs/graphql';
+
+import { UnifiedField } from '../decorators/unified-field.decorator';
+
+/**
+ * Pagination information for paginated queries
+ *
+ * Provides metadata about the current page, total pages, and navigation flags
+ * to facilitate frontend pagination UI implementation.
+ */
+@ObjectType({ description: 'Pagination information for paginated queries' })
+export class PaginationInfo {
+  /**
+   * Total number of items across all pages
+   */
+  @UnifiedField({
+    description: 'Total number of items across all pages',
+  })
+  totalCount: number;
+
+  /**
+   * Total number of pages
+   */
+  @UnifiedField({
+    description: 'Total number of pages',
+  })
+  pageCount: number;
+
+  /**
+   * Current page number (1-based)
+   */
+  @UnifiedField({
+    description: 'Current page number (1-based)',
+  })
+  currentPage: number;
+
+  /**
+   * Number of items per page
+   */
+  @UnifiedField({
+    description: 'Number of items per page',
+  })
+  perPage: number;
+
+  /**
+   * Indicates if there is a next page
+   */
+  @UnifiedField({
+    description: 'Indicates if there is a next page',
+  })
+  hasNextPage: boolean;
+
+  /**
+   * Indicates if there is a previous page
+   */
+  @UnifiedField({
+    description: 'Indicates if there is a previous page',
+  })
+  hasPreviousPage: boolean;
+
+  /**
+   * Create PaginationInfo from query parameters and total count
+   */
+  static create(options: {
+    limit?: number;
+    offset?: number;
+    skip?: number;
+    take?: number;
+    totalCount: number;
+  }): PaginationInfo {
+    const { totalCount } = options;
+    const skip = options.skip ?? options.offset ?? 0;
+    const perPage = options.take ?? options.limit ?? 0;
+
+    // Handle edge case: no limit specified (return all items as single page)
+    if (perPage === 0) {
+      return {
+        currentPage: totalCount > 0 ? 1 : 0,
+        hasNextPage: false,
+        hasPreviousPage: false,
+        pageCount: totalCount > 0 ? 1 : 0,
+        perPage: 0,
+        totalCount,
+      };
+    }
+
+    const pageCount = Math.ceil(totalCount / perPage);
+    const currentPage = totalCount === 0 ? 0 : Math.floor(skip / perPage) + 1;
+    const hasNextPage = currentPage < pageCount;
+    const hasPreviousPage = currentPage > 1;
+
+    return {
+      currentPage,
+      hasNextPage,
+      hasPreviousPage,
+      pageCount,
+      perPage,
+      totalCount,
+    };
+  }
+}

package/src/core/common/services/crud.service.ts

@@ -15,6 +15,7 @@ import { convertFilterArgsToQuery } from '../helpers/filter.helper';
 import { mergePlain, prepareServiceOptionsForCreate } from '../helpers/input.helper';
 import { ServiceOptions } from '../interfaces/service-options.interface';
 import { CoreModel } from '../models/core-model.model';
+import { PaginationInfo } from '../models/pagination-info.model';
 import { PlainObject } from '../types/plain-object.type';
 import { ConfigService } from './config.service';
 import { ModuleService } from './module.service';
@@ -218,7 +219,11 @@ export abstract class CrudService<
   async findAndCount(
     filter?: FilterArgs | { filterQuery?: QueryFilter<any>; queryOptions?: QueryOptions; samples?: number },
     serviceOptions?: ServiceOptions,
-  ): Promise<{ items: Model[]; totalCount: number }> {
+  ): Promise<{
+    items: Model[];
+    pagination: PaginationInfo;
+    totalCount: number;
+  }> {
     // If filter is not instance of FilterArgs a simple form with filterQuery and queryOptions is set
     // and should not be processed as FilterArgs
     if (!(filter instanceof FilterArgs) && serviceOptions?.inputType === FilterArgs) {
@@ -284,6 +289,17 @@ export abstract class CrudService<
           (await this.mainDbModel.aggregate(aggregation, collation ? { collation } : {}).exec())[0] || {};
         dbResult.totalCount = dbResult.totalCount?.[0]?.total || 0;
         dbResult.items = dbResult.items?.map((item) => this.mainDbModel.hydrate(item)) || [];
+
+        // Calculate pagination info
+        const queryOptions = filterQuery.queryOptions || {};
+        dbResult.pagination = PaginationInfo.create({
+          limit: queryOptions.limit,
+          offset: queryOptions.offset,
+          skip: queryOptions.skip,
+          take: queryOptions.take,
+          totalCount: dbResult.totalCount,
+        });
+
         return dbResult;
       },
       { input: filter, outputPath: 'items', serviceOptions },
@@ -297,7 +313,7 @@ export abstract class CrudService<
   async findAndCountForce(
     filter?: FilterArgs | { filterQuery?: QueryFilter<any>; queryOptions?: QueryOptions; samples?: number },
     serviceOptions: ServiceOptions = {},
-  ): Promise<{ items: Model[]; totalCount: number }> {
+  ): Promise<{ items: Model[]; pagination: PaginationInfo; totalCount: number; }> {
     serviceOptions.raw = true;
     return this.findAndCount(filter, serviceOptions);
   }
@@ -309,7 +325,7 @@ export abstract class CrudService<
   async findAndCountRaw(
     filter?: FilterArgs | { filterQuery?: QueryFilter<any>; queryOptions?: QueryOptions; samples?: number },
     serviceOptions: ServiceOptions = {},
-  ): Promise<{ items: Model[]; totalCount: number }> {
+  ): Promise<{ items: Model[]; pagination: PaginationInfo; totalCount: number; }> {
     serviceOptions = serviceOptions || {};
     serviceOptions.raw = true;
     return this.findAndCountForce(filter, serviceOptions);

package/src/index.ts

@@ -62,6 +62,7 @@ export * from './core/common/interfaces/service-options.interface';
 export * from './core/common/middlewares/to-lower-case.middleware';
 export * from './core/common/models/core-model.model';
 export * from './core/common/models/core-persistence.model';
+export * from './core/common/models/pagination-info.model';
 export * from './core/common/pipes/check-input.pipe';
 export * from './core/common/pipes/map-and-validate.pipe';
 export * from './core/common/plugins/complexity.plugin';

package/src/server/modules/user/outputs/find-and-count-users-result.output.ts

@@ -3,6 +3,7 @@ import { ObjectType } from '@nestjs/graphql';
 import { Restricted } from '../../../../core/common/decorators/restricted.decorator';
 import { UnifiedField } from '../../../../core/common/decorators/unified-field.decorator';
 import { RoleEnum } from '../../../../core/common/enums/role.enum';
+import { PaginationInfo } from '../../../../core/common/models/pagination-info.model';
 import { User } from '../user.model';
 
 @ObjectType({ description: 'Result of find and count' })
@@ -21,4 +22,11 @@ export class FindAndCountUsersResult {
     isOptional: false,
   })
   totalCount: number;
+
+  @UnifiedField({
+    description: 'Pagination information',
+    isOptional: true,
+    type: () => PaginationInfo,
+  })
+  pagination?: PaginationInfo;
 }