@nest-util/nest-crud 0.0.3 → 1.0.0

package/dist/lib/services/nest-crud.service.js

@@ -3,9 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestCrudService = void 0;
 const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
-const nest_audit_1 = require("@nest-util/nest-audit");
+const audit_log_entity_1 = require("../entities/audit-log.entity");
 const filter_helper_1 = require("../helpers/filter.helper");
 const pagination_helper_1 = require("../helpers/pagination.helper");
+const cursor_pagination_helper_1 = require("../helpers/cursor-pagination.helper");
 let NestCrudService = class NestCrudService {
     constructor(options) {
         this.repo = options.repository;
@@ -17,6 +18,12 @@ let NestCrudService = class NestCrudService {
         this.createDtoClass = options.createDtoClass;
         this.updateDtoClass = options.updateDtoClass;
         this.disabledEndpoints = options.disabledEndpoints ?? [];
+        this.cursorStrategy =
+            options.cursorStrategy ?? (0, cursor_pagination_helper_1.detectCursorStrategy)(this.repo);
+        this.hooks = options.hooks ?? {};
+        this.transactionConfig = options.transactionConfig ?? {};
+        this.userOwnershipField = options.userOwnershipField;
+        this.findMineQuery = options.findMineQuery;
     }
     async resolveRelations(payload) {
         if (!this.relations.length)
@@ -39,6 +46,32 @@ let NestCrudService = class NestCrudService {
         }
         return payload;
     }
+    async executeInTransaction(fn, isolationLevel) {
+        const queryRunner = this.repo.manager.connection.createQueryRunner();
+        await queryRunner.startTransaction(isolationLevel);
+        try {
+            const result = await fn();
+            await queryRunner.commitTransaction();
+            return result;
+        }
+        catch (error) {
+            await queryRunner.rollbackTransaction();
+            throw error;
+        }
+        finally {
+            await queryRunner.release();
+        }
+    }
+    async executeHook(hook, context) {
+        if (!hook)
+            return;
+        if (hook.transaction) {
+            await this.executeInTransaction(() => hook.handler(context), this.transactionConfig?.isolationLevel);
+        }
+        else {
+            await hook.handler(context);
+        }
+    }
     async findAll(query) {
         const qb = this.repo.createQueryBuilder('e');
         if (this.include.length > 0) {
@@ -72,7 +105,115 @@ let NestCrudService = class NestCrudService {
             ? { data, meta: { ...paginationMeta, total } }
             : { data };
     }
+    async findMine(userId, query) {
+        if (!this.userOwnershipField && !this.findMineQuery) {
+            throw new common_1.BadRequestException('findMine not configured');
+        }
+        const qb = this.repo.createQueryBuilder('e');
+        if (this.findMineQuery) {
+            this.findMineQuery(qb, userId);
+        }
+        else if (this.userOwnershipField) {
+            qb.where(`e.${String(this.userOwnershipField)} = :userId`, { userId });
+        }
+        if (this.include.length > 0) {
+            this.include.forEach((relation) => {
+                const parts = relation.split('.');
+                if (parts.length === 1) {
+                    qb.leftJoinAndSelect(`e.${parts[0]}`, parts[0]);
+                }
+                else {
+                    const parentAlias = parts.slice(0, -1).join('_');
+                    const field = parts[parts.length - 1];
+                    const alias = parts.join('_');
+                    qb.leftJoinAndSelect(`${parentAlias}.${field}`, alias);
+                }
+            });
+        }
+        (0, filter_helper_1.applyFilters)(qb, query.filter, this.allowedFilters);
+        const paginationMeta = (0, pagination_helper_1.applyPagination)(qb, query);
+        if (query.orderBy) {
+            const orderDirection = query.orderDirection === 'ASC' ? 'ASC' : 'DESC';
+            if (this.allowedSortFields.length === 0 ||
+                this.allowedSortFields.includes(query.orderBy)) {
+                qb.orderBy(`e.${query.orderBy}`, orderDirection);
+            }
+        }
+        const [entities, total] = await qb.getManyAndCount();
+        const data = this.toResponseDto
+            ? this.toResponseDto(entities)
+            : entities;
+        return paginationMeta
+            ? { data, meta: { ...paginationMeta, total } }
+            : { data };
+    }
+    async findAllWithCursor(query) {
+        const limit = query.limit ?? 10;
+        const strategy = this.cursorStrategy;
+        const orderDirection = 'DESC';
+        const qb = this.repo.createQueryBuilder('e');
+        // Join relations
+        if (this.include.length > 0) {
+            this.include.forEach((relation) => {
+                const parts = relation.split('.');
+                if (parts.length === 1) {
+                    qb.leftJoinAndSelect(`e.${parts[0]}`, parts[0]);
+                }
+                else {
+                    const parentAlias = parts.slice(0, -1).join('_');
+                    const field = parts[parts.length - 1];
+                    const alias = parts.join('_');
+                    qb.leftJoinAndSelect(`${parentAlias}.${field}`, alias);
+                }
+            });
+        }
+        // Apply filters
+        (0, filter_helper_1.applyFilters)(qb, query.filter, this.allowedFilters);
+        // Apply cursor filter
+        if (query.cursor) {
+            const decoded = (0, cursor_pagination_helper_1.decodeCursor)(query.cursor, strategy);
+            (0, cursor_pagination_helper_1.applyCursorFilter)(qb, decoded, strategy, orderDirection);
+        }
+        // Default ordering by id
+        qb.orderBy(`e.id`, orderDirection);
+        // Fetch limit + 1 to detect hasMore
+        const take = limit + 1;
+        const entities = await qb.take(take).getMany();
+        const hasMore = entities.length > limit;
+        const data = hasMore ? entities.slice(0, limit) : entities;
+        // Build next cursor from last entity
+        const nextCursor = hasMore ? (0, cursor_pagination_helper_1.buildNextCursor)(data, strategy) : null;
+        // Optionally compute total count
+        let total;
+        if (query.includeTotal) {
+            // Build a clean count query (reuse same filters but no cursor/order/take)
+            const countQb = this.repo.createQueryBuilder('e');
+            if (this.include.length > 0) {
+                this.include.forEach((relation) => {
+                    const parts = relation.split('.');
+                    if (parts.length === 1) {
+                        countQb.leftJoin(`e.${parts[0]}`, parts[0]);
+                    }
+                });
+            }
+            (0, filter_helper_1.applyFilters)(countQb, query.filter, this.allowedFilters);
+            total = await countQb.getCount();
+        }
+        const response = this.toResponseDto
+            ? this.toResponseDto(data)
+            : data;
+        return {
+            data: response,
+            meta: {
+                limit,
+                hasMore,
+                nextCursor,
+                ...(total !== undefined ? { total } : {}),
+            },
+        };
+    }
     async findOne(id) {
+        await this.executeHook(this.hooks.beforeFindOne, { id });
         const entity = await this.repo.findOne({
             where: { id },
             relations: this.include,
@@ -80,16 +221,21 @@ let NestCrudService = class NestCrudService {
         if (!entity) {
             throw new common_1.NotFoundException('Resource not found');
         }
-        return this.toResponseDto
+        const result = this.toResponseDto
             ? this.toResponseDto(entity)
             : entity;
+        await this.executeHook(this.hooks.afterFindOne, { entity, id });
+        return result;
     }
     async create(payload) {
+        await this.executeHook(this.hooks.beforeCreate, { payload });
         const resolved = await this.resolveRelations(payload);
         const entity = await this.repo.save(resolved);
-        return this.toResponseDto
+        const result = this.toResponseDto
             ? this.toResponseDto(entity)
             : entity;
+        await this.executeHook(this.hooks.afterCreate, { entity, payload });
+        return result;
     }
     async update(id, payload) {
         const existing = await this.repo.findOneBy({
@@ -98,22 +244,32 @@ let NestCrudService = class NestCrudService {
         if (!existing) {
             throw new common_1.NotFoundException('Resource not found');
         }
+        await this.executeHook(this.hooks.beforeUpdate, { payload, entity: existing, id });
         const resolved = await this.resolveRelations(payload);
-        await this.repo.update(id, resolved);
-        return this.findOne(id);
+        this.repo.merge(existing, resolved);
+        await this.repo.save(existing);
+        const result = await this.findOne(id);
+        await this.executeHook(this.hooks.afterUpdate, { entity: result, payload, id });
+        return result;
     }
     async remove(id) {
-        const result = await this.repo.delete(id);
-        if (result.affected === 0) {
+        const existing = await this.repo.findOneBy({
+            id,
+        });
+        if (!existing) {
             throw new common_1.NotFoundException('Resource not found');
         }
-        return true;
+        await this.executeHook(this.hooks.beforeRemove, { entity: existing, id });
+        const result = await this.repo.delete(id);
+        const deleted = result.affected !== 0;
+        await this.executeHook(this.hooks.afterRemove, { id, deleted });
+        return deleted;
     }
     async findAuditLogs(query) {
         const page = query.page ?? 1;
         const limit = query.limit ?? 10;
         const qb = this.repo.manager
-            .getRepository(nest_audit_1.AuditLogEntity)
+            .getRepository(audit_log_entity_1.AuditLogEntity)
             .createQueryBuilder('auditLog')
             .where('auditLog.entity = :entity', {
             entity: this.repo.metadata.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nest-util/nest-crud",
-  "version": "0.0.3",
+  "version": "1.0.0",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,17 +18,26 @@
     "!**/*.tsbuildinfo"
   ],
   "dependencies": {
-    "tslib": "^2.3.0"
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@nest-util/nest-auth": "workspace:*"
   },
   "peerDependencies": {
-    "@nest-util/nest-audit": "workspace:*",
+    "@nest-util/nest-auth": "workspace:*",
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/swagger": "^11.2.6",
+    "@nestjs/typeorm": "^11.0.1",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.3",
     "express": "^5.2.1",
-    "typeorm": "^0.3.28",
-    "rxjs": "^7.8.0"
+    "rxjs": "^7.8.0",
+    "typeorm": "^1.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@nest-util/nest-auth": {
+      "optional": true
+    }
   }
 }