@nest-util/nest-crud 0.0.3

package/README.md

@@ -0,0 +1,22 @@
+# nest-crud
+
+This library was generated with [Nx](https://nx.dev).
+
+## Installation
+
+To install this library in your project, use the permanent URL from the latest GitHub Release:
+
+```bash
+pnpm add https://github.com/nigussolomon/nest-util/releases/download/latest/nest-util-nest-crud-0.0.1.tgz
+```
+
+> [!TIP]
+> This tarball contains only the compiled code and its specific dependencies, making it as clean as a standard npm package.
+
+## Building
+
+Run `nx build nest-crud` to build the library.
+
+## Running unit tests
+
+Run `nx test nest-crud` to execute the unit tests via [Jest](https://jestjs.io).

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './lib/nest-crud.module';
+export * from './lib/services/nest-crud.service';
+export * from './lib/controllers/nest-crud.controller';
+export * from './lib/dtos/filter.dto';
+export * from './lib/dtos/pagination.dto';
+export * from './lib/decorators/response-message.decorator';
+export * from './lib/interceptors/response.interceptor';
+export * from './lib/interfaces/crud.interface';
+export * from './lib/helpers/exception-filter.helper';
+export { Audit, AuditLogEntity } from '@nest-util/nest-audit';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogEntity = exports.Audit = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/nest-crud.module"), exports);
+tslib_1.__exportStar(require("./lib/services/nest-crud.service"), exports);
+tslib_1.__exportStar(require("./lib/controllers/nest-crud.controller"), exports);
+tslib_1.__exportStar(require("./lib/dtos/filter.dto"), exports);
+tslib_1.__exportStar(require("./lib/dtos/pagination.dto"), exports);
+tslib_1.__exportStar(require("./lib/decorators/response-message.decorator"), exports);
+tslib_1.__exportStar(require("./lib/interceptors/response.interceptor"), exports);
+tslib_1.__exportStar(require("./lib/interfaces/crud.interface"), exports);
+tslib_1.__exportStar(require("./lib/helpers/exception-filter.helper"), exports);
+var nest_audit_1 = require("@nest-util/nest-audit");
+Object.defineProperty(exports, "Audit", { enumerable: true, get: function () { return nest_audit_1.Audit; } });
+Object.defineProperty(exports, "AuditLogEntity", { enumerable: true, get: function () { return nest_audit_1.AuditLogEntity; } });

package/dist/lib/controllers/nest-crud.controller.d.ts

@@ -0,0 +1,25 @@
+import { Type } from '@nestjs/common';
+import { CrudEndpoint, CrudInterface } from '../interfaces/crud.interface';
+import { PaginationDto } from '../dtos/pagination.dto';
+import { FilterDto } from '../dtos/filter.dto';
+import { ListAuditLogsDto } from '@nest-util/nest-audit';
+export declare const AUTH_PERMISSIONS_METADATA_KEY = "auth:permissions";
+export type CrudEndpointPermissions = string | readonly string[];
+export type CrudPermissionsMap = Partial<Record<CrudEndpoint, CrudEndpointPermissions>>;
+export interface CrudControllerFactoryOptions {
+    permissions?: CrudPermissionsMap;
+}
+export interface IBaseController<CD, UD, RD> {
+    service: CrudInterface<CD, UD, RD>;
+    findAll(query: PaginationDto & FilterDto): Promise<{
+        data: RD[];
+        meta?: unknown;
+    } | RD[]>;
+    findOne(id: number): Promise<RD>;
+    create(dto: CD): Promise<RD>;
+    update(id: number, dto: UD): Promise<RD>;
+    remove(id: number): Promise<boolean>;
+    findAuditLogs?(query: ListAuditLogsDto): Promise<unknown>;
+}
+export declare function CreateNestedCrudController<CD, UD, RD>(createDto: Type<CD>, updateDto: Type<UD>, responseDto: Type<RD>, options?: CrudControllerFactoryOptions): Type<IBaseController<CD, UD, RD>>;
+//# sourceMappingURL=nest-crud.controller.d.ts.map

package/dist/lib/controllers/nest-crud.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-crud.controller.d.ts","sourceRoot":"","sources":["../../../src/lib/controllers/nest-crud.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,IAAI,EACL,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAS,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAEhE,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACtC,MAAM,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAC9C,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED,MAAM,WAAW,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;IACzC,OAAO,EAAE,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,CACL,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,OAAO,CAAC;QAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,aAAa,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAyDD,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EACnD,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,EACnB,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,EACnB,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,EACrB,OAAO,CAAC,EAAE,4BAA4B,GACrC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CA2FnC"}

package/dist/lib/controllers/nest-crud.controller.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTH_PERMISSIONS_METADATA_KEY = void 0;
+exports.CreateNestedCrudController = CreateNestedCrudController;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const response_message_decorator_1 = require("../decorators/response-message.decorator");
+const nest_audit_1 = require("@nest-util/nest-audit");
+exports.AUTH_PERMISSIONS_METADATA_KEY = 'auth:permissions';
+const toPermissionList = (permissionValue) => {
+    if (Array.isArray(permissionValue)) {
+        return [
+            ...permissionValue.filter((permission) => Boolean(permission)),
+        ];
+    }
+    return typeof permissionValue === 'string' && permissionValue
+        ? [permissionValue]
+        : [];
+};
+const applyPermissionMetadata = (controllerClass, permissions) => {
+    if (!permissions) {
+        return;
+    }
+    for (const endpoint of Object.keys(permissions)) {
+        const permissionValue = permissions[endpoint];
+        if (!permissionValue) {
+            continue;
+        }
+        const permissionList = toPermissionList(permissionValue);
+        if (permissionList.length === 0) {
+            continue;
+        }
+        const handler = controllerClass.prototype[endpoint];
+        if (typeof handler !== 'function') {
+            continue;
+        }
+        Reflect.defineMetadata(exports.AUTH_PERMISSIONS_METADATA_KEY, permissionList, handler);
+    }
+};
+function CreateNestedCrudController(createDto, updateDto, responseDto, options) {
+    class BaseController {
+        constructor(service) {
+            this.service = service;
+        }
+        ensureEndpointEnabled(endpoint) {
+            if (this.service.disabledEndpoints?.includes(endpoint)) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+        }
+        findAll(query) {
+            this.ensureEndpointEnabled('findAll');
+            return this.service.findAll(query);
+        }
+        create(dto) {
+            this.ensureEndpointEnabled('create');
+            return this.service.create(dto);
+        }
+        update(id, dto) {
+            this.ensureEndpointEnabled('update');
+            return this.service.update(id, dto);
+        }
+        remove(id) {
+            this.ensureEndpointEnabled('remove');
+            return this.service.remove(id);
+        }
+        findAuditLogs(query) {
+            this.ensureEndpointEnabled('findAuditLogs');
+            if (!this.service.findAuditLogs) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+            return this.service.findAuditLogs(query);
+        }
+        findOne(id) {
+            this.ensureEndpointEnabled('findOne');
+            return this.service.findOne(id);
+        }
+    }
+    tslib_1.__decorate([
+        (0, common_1.Get)(),
+        (0, response_message_decorator_1.Message)('fetched'),
+        (0, swagger_1.ApiResponse)({ type: [responseDto] }),
+        (0, swagger_1.ApiQuery)({
+            name: 'filter',
+            required: false,
+            style: 'deepObject',
+            explode: true,
+            type: 'object',
+            description: 'Filters in format filter[field_operator]=value. Operators: eq, ne, cont, notcont, starts, ends, gte, lte, gt, lt, in, nin, isnull. Grouping keys: and, or',
+            example: {
+                name_cont: 'Bob',
+                or: [{ name_eq: 'Bob' }, { name_eq: 'Carol' }],
+            },
+        }),
+        (0, swagger_1.ApiQuery)({ name: 'page', required: false, type: Number }),
+        (0, swagger_1.ApiQuery)({ name: 'limit', required: false, type: Number }),
+        (0, swagger_1.ApiQuery)({ name: 'orderBy', required: false, type: String }),
+        (0, swagger_1.ApiQuery)({
+            name: 'orderDirection',
+            required: false,
+            enum: ['ASC', 'DESC'],
+        }),
+        tslib_1.__param(0, (0, common_1.Query)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "findAll", null);
+    tslib_1.__decorate([
+        (0, common_1.Post)(),
+        (0, response_message_decorator_1.Message)('created'),
+        (0, nest_audit_1.Audit)({ action: 'CREATE' }),
+        (0, swagger_1.ApiBody)({ type: createDto }),
+        (0, swagger_1.ApiResponse)({ type: responseDto }),
+        tslib_1.__param(0, (0, common_1.Body)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "create", null);
+    tslib_1.__decorate([
+        (0, common_1.Patch)(':id'),
+        (0, response_message_decorator_1.Message)('updated'),
+        (0, nest_audit_1.Audit)({ action: 'UPDATE' }),
+        (0, swagger_1.ApiBody)({ type: updateDto }),
+        (0, swagger_1.ApiResponse)({ type: responseDto }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__param(1, (0, common_1.Body)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number, Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "update", null);
+    tslib_1.__decorate([
+        (0, common_1.Delete)(':id'),
+        (0, response_message_decorator_1.Message)('deleted'),
+        (0, nest_audit_1.Audit)({ action: 'DELETE' }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "remove", null);
+    tslib_1.__decorate([
+        (0, common_1.Get)('auditlogs'),
+        (0, response_message_decorator_1.Message)('fetched'),
+        tslib_1.__param(0, (0, common_1.Query)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [nest_audit_1.ListAuditLogsDto]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "findAuditLogs", null);
+    tslib_1.__decorate([
+        (0, common_1.Get)(':id'),
+        (0, response_message_decorator_1.Message)('fetched'),
+        (0, swagger_1.ApiResponse)({ type: responseDto }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "findOne", null);
+    applyPermissionMetadata(BaseController, options?.permissions);
+    return BaseController;
+}

package/dist/lib/decorators/response-message.decorator.d.ts

@@ -0,0 +1,9 @@
+export declare const MESSAGE_KEY = "customMessage";
+export declare const Message: (message: string) => import("@nestjs/common").CustomDecorator<string>;
+export declare const ENTITY_NAME_KEY = "entityName";
+export interface EntityNames {
+    singular: string;
+    plural: string;
+}
+export declare const EntityName: (names: string | EntityNames) => import("@nestjs/common").CustomDecorator<string>;
+//# sourceMappingURL=response-message.decorator.d.ts.map

package/dist/lib/decorators/response-message.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-message.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/response-message.decorator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,kBAAkB,CAAC;AAC3C,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,qDAAsC,CAAC;AAE9E,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,GAAG,WAAW,qDAInD,CAAC"}

package/dist/lib/decorators/response-message.decorator.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityName = exports.ENTITY_NAME_KEY = exports.Message = exports.MESSAGE_KEY = void 0;
+const common_1 = require("@nestjs/common");
+exports.MESSAGE_KEY = 'customMessage';
+const Message = (message) => (0, common_1.SetMetadata)(exports.MESSAGE_KEY, message);
+exports.Message = Message;
+exports.ENTITY_NAME_KEY = 'entityName';
+const EntityName = (names) => (0, common_1.SetMetadata)(exports.ENTITY_NAME_KEY, typeof names === 'string' ? { singular: names, plural: `${names}s` } : names);
+exports.EntityName = EntityName;

package/dist/lib/dtos/filter.dto.d.ts

@@ -0,0 +1,4 @@
+export declare class FilterDto {
+    filter?: Record<string, unknown>;
+}
+//# sourceMappingURL=filter.dto.d.ts.map

package/dist/lib/dtos/filter.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.dto.d.ts","sourceRoot":"","sources":["../../../src/lib/dtos/filter.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,SAAS;IAqBpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

package/dist/lib/dtos/filter.dto.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterDto = void 0;
+const tslib_1 = require("tslib");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+class FilterDto {
+}
+exports.FilterDto = FilterDto;
+tslib_1.__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    (0, class_transformer_1.Transform)(({ value, obj }) => {
+        // 1. If Express already parsed it into an object: { name_cont: 'Alice' }
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            return value;
+        }
+        // 2. Fallback: If for some reason it's still a flat object with string keys
+        // like { "filter[name_cont]": "Alice" }
+        const filters = {};
+        Object.keys(obj).forEach((key) => {
+            const match = key.match(/^filter\[(.*)\]$/);
+            if (match && match[1]) {
+                filters[match[1]] = obj[key];
+            }
+        });
+        return Object.keys(filters).length > 0 ? filters : value;
+    }),
+    tslib_1.__metadata("design:type", Object)
+], FilterDto.prototype, "filter", void 0);

package/dist/lib/dtos/pagination.dto.d.ts

@@ -0,0 +1,7 @@
+export declare class PaginationDto {
+    page?: number;
+    limit?: number;
+    orderBy?: string;
+    orderDirection?: 'ASC' | 'DESC';
+}
+//# sourceMappingURL=pagination.dto.d.ts.map

package/dist/lib/dtos/pagination.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.dto.d.ts","sourceRoot":"","sources":["../../../src/lib/dtos/pagination.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,aAAa;IAUxB,IAAI,CAAC,EAAE,MAAM,CAAK;IAWlB,KAAK,CAAC,EAAE,MAAM,CAAM;IAMpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAQjB,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACjC"}

package/dist/lib/dtos/pagination.dto.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaginationDto = void 0;
+const tslib_1 = require("tslib");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const swagger_1 = require("@nestjs/swagger");
+class PaginationDto {
+    constructor() {
+        this.page = 1;
+        this.limit = 10;
+    }
+}
+exports.PaginationDto = PaginationDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Page number',
+        minimum: 1,
+        default: 1,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    tslib_1.__metadata("design:type", Number)
+], PaginationDto.prototype, "page", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Items per page',
+        minimum: 1,
+        default: 10,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    tslib_1.__metadata("design:type", Number)
+], PaginationDto.prototype, "limit", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Field to order by',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    tslib_1.__metadata("design:type", String)
+], PaginationDto.prototype, "orderBy", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Sort direction',
+        enum: ['ASC', 'DESC'],
+        default: 'DESC',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    tslib_1.__metadata("design:type", String)
+], PaginationDto.prototype, "orderDirection", void 0);

package/dist/lib/helpers/exception-filter.helper.d.ts

@@ -0,0 +1,6 @@
+import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+import { QueryFailedError } from 'typeorm';
+export declare class TypeOrmExceptionFilter implements ExceptionFilter {
+    catch(exception: QueryFailedError, host: ArgumentsHost): void;
+}
+//# sourceMappingURL=exception-filter.helper.d.ts.map

package/dist/lib/helpers/exception-filter.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.helper.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/exception-filter.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,eAAe,EAEhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAU3C,qBACa,sBAAuB,YAAW,eAAe;IAC5D,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;CA8B9D"}

package/dist/lib/helpers/exception-filter.helper.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeOrmExceptionFilter = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("typeorm");
+let TypeOrmExceptionFilter = class TypeOrmExceptionFilter {
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        const driverError = exception.driverError;
+        const isUniqueViolation = driverError.code === '23505' || driverError.errno === 1062;
+        let status = common_1.HttpStatus.INTERNAL_SERVER_ERROR;
+        let message = 'Internal server error';
+        if (isUniqueViolation) {
+            status = common_1.HttpStatus.UNPROCESSABLE_ENTITY;
+            message = 'Duplicate entry: A record with this value already exists.';
+            if (driverError.detail) {
+                message = driverError.detail
+                    .replace('Key ', '')
+                    .replace(/[()]/g, '')
+                    .trim();
+            }
+        }
+        response.status(status).json({
+            status: 'error',
+            message: message,
+            statusCode: status,
+        });
+    }
+};
+exports.TypeOrmExceptionFilter = TypeOrmExceptionFilter;
+exports.TypeOrmExceptionFilter = TypeOrmExceptionFilter = tslib_1.__decorate([
+    (0, common_1.Catch)(typeorm_1.QueryFailedError)
+], TypeOrmExceptionFilter);

package/dist/lib/helpers/filter.helper.d.ts

@@ -0,0 +1,3 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+export declare function applyFilters<Entity extends ObjectLiteral>(qb: SelectQueryBuilder<Entity>, filters: Record<string, unknown> | undefined, allowedFilters: readonly (keyof Entity)[]): void;
+//# sourceMappingURL=filter.helper.d.ts.map

package/dist/lib/helpers/filter.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.helper.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/filter.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAsL5D,wBAAgB,YAAY,CAAC,MAAM,SAAS,aAAa,EACvD,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,cAAc,EAAE,SAAS,CAAC,MAAM,MAAM,CAAC,EAAE,GACxC,IAAI,CAoBN"}

package/dist/lib/helpers/filter.helper.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyFilters = applyFilters;
+const SAFE_FIELD_PATTERN = /^[A-Za-z][A-Za-z0-9_]*$/;
+const toArrayValue = (value) => {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return value
+            .split(',')
+            .map((part) => part.trim())
+            .filter((part) => part.length > 0);
+    }
+    return value === undefined || value === null ? [] : [value];
+};
+const toBooleanValue = (value) => {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return value !== 0;
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (['true', '1', 'yes'].includes(normalized))
+        return true;
+    if (['false', '0', 'no'].includes(normalized))
+        return false;
+    return null;
+};
+const parseFilterKey = (rawKey) => {
+    const separatorIndex = rawKey.lastIndexOf('_');
+    if (separatorIndex <= 0 || separatorIndex === rawKey.length - 1)
+        return null;
+    const field = rawKey.slice(0, separatorIndex);
+    const operator = rawKey.slice(separatorIndex + 1).toLowerCase();
+    return { field, operator };
+};
+const buildCondition = (field, operator, value, paramIndex) => {
+    const paramKey = `filter_${paramIndex.current++}`;
+    switch (operator) {
+        case 'eq':
+            return { sql: `e.${field} = :${paramKey}`, params: { [paramKey]: value } };
+        case 'ne':
+            return { sql: `e.${field} != :${paramKey}`, params: { [paramKey]: value } };
+        case 'cont':
+            return {
+                sql: `e.${field} ILIKE :${paramKey}`,
+                params: { [paramKey]: `%${value}%` },
+            };
+        case 'notcont':
+            return {
+                sql: `e.${field} NOT ILIKE :${paramKey}`,
+                params: { [paramKey]: `%${value}%` },
+            };
+        case 'starts':
+            return {
+                sql: `e.${field} ILIKE :${paramKey}`,
+                params: { [paramKey]: `${value}%` },
+            };
+        case 'ends':
+            return {
+                sql: `e.${field} ILIKE :${paramKey}`,
+                params: { [paramKey]: `%${value}` },
+            };
+        case 'gte':
+            return { sql: `e.${field} >= :${paramKey}`, params: { [paramKey]: value } };
+        case 'lte':
+            return { sql: `e.${field} <= :${paramKey}`, params: { [paramKey]: value } };
+        case 'gt':
+            return { sql: `e.${field} > :${paramKey}`, params: { [paramKey]: value } };
+        case 'lt':
+            return { sql: `e.${field} < :${paramKey}`, params: { [paramKey]: value } };
+        case 'in':
+        case 'nin': {
+            const values = toArrayValue(value);
+            if (values.length === 0)
+                return null;
+            return {
+                sql: operator === 'in'
+                    ? `e.${field} IN (:...${paramKey})`
+                    : `e.${field} NOT IN (:...${paramKey})`,
+                params: { [paramKey]: values },
+            };
+        }
+        case 'isnull': {
+            const isNull = toBooleanValue(value);
+            if (isNull === null)
+                return null;
+            return { sql: isNull ? `e.${field} IS NULL` : `e.${field} IS NOT NULL` };
+        }
+        default:
+            return null;
+    }
+};
+const buildExpression = (node, combinator, allowedFilters, paramIndex, params) => {
+    if (!node || typeof node !== 'object')
+        return null;
+    const conditions = [];
+    const entries = Array.isArray(node)
+        ? node.map((item, index) => [String(index), item])
+        : Object.entries(node);
+    for (const [rawKey, value] of entries) {
+        if (rawKey === 'and' || rawKey === 'or') {
+            const nestedCombinator = rawKey;
+            const nestedNodes = Array.isArray(value) ? value : [value];
+            const nestedExpressions = nestedNodes
+                .map((nestedNode) => buildExpression(nestedNode, 'and', allowedFilters, paramIndex, params))
+                .filter((sql) => Boolean(sql));
+            if (nestedExpressions.length > 0) {
+                conditions.push(`(${nestedExpressions.join(` ${nestedCombinator.toUpperCase()} `)})`);
+            }
+            continue;
+        }
+        const parsed = parseFilterKey(rawKey);
+        if (!parsed)
+            continue;
+        const { field, operator } = parsed;
+        if (!SAFE_FIELD_PATTERN.test(field))
+            continue;
+        if (!allowedFilters.includes(field))
+            continue;
+        const condition = buildCondition(field, operator, value, paramIndex);
+        if (!condition)
+            continue;
+        if (condition.params)
+            Object.assign(params, condition.params);
+        conditions.push(condition.sql);
+    }
+    if (conditions.length === 0)
+        return null;
+    if (conditions.length === 1)
+        return conditions[0];
+    return `(${conditions.join(` ${combinator.toUpperCase()} `)})`;
+};
+function applyFilters(qb, filters, allowedFilters) {
+    if (!filters)
+        return;
+    const params = {};
+    const expression = buildExpression(filters, 'and', allowedFilters.map(String), { current: 0 }, params);
+    if (!expression)
+        return;
+    if (Object.keys(params).length > 0) {
+        qb.andWhere(expression, params);
+        return;
+    }
+    qb.andWhere(expression);
+}

package/dist/lib/helpers/pagination.helper.d.ts

@@ -0,0 +1,7 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+import { PaginationDto } from '../dtos/pagination.dto';
+export declare function applyPagination<Entity extends ObjectLiteral>(qb: SelectQueryBuilder<Entity>, query: PaginationDto): {
+    page: number;
+    limit: number;
+} | null;
+//# sourceMappingURL=pagination.helper.d.ts.map

package/dist/lib/helpers/pagination.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.helper.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/pagination.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,wBAAgB,eAAe,CAAC,MAAM,SAAS,aAAa,EAC1D,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAC9B,KAAK,EAAE,aAAa;;;SAgBrB"}

package/dist/lib/helpers/pagination.helper.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyPagination = applyPagination;
+function applyPagination(qb, query) {
+    const { page, limit } = query;
+    if (!page || !limit) {
+        return null;
+    }
+    const skip = (page - 1) * limit;
+    qb.skip(skip).take(limit);
+    return {
+        page,
+        limit,
+    };
+}

package/dist/lib/interceptors/response.interceptor.d.ts

@@ -0,0 +1,9 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { Reflector } from '@nestjs/core';
+export declare class ResponseInterceptor implements NestInterceptor {
+    private readonly reflector;
+    constructor(reflector: Reflector);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+//# sourceMappingURL=response.interceptor.d.ts.map

package/dist/lib/interceptors/response.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.interceptor.d.ts","sourceRoot":"","sources":["../../../src/lib/interceptors/response.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAOzC,qBACa,mBAAoB,YAAW,eAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CA+B7E"}

package/dist/lib/interceptors/response.interceptor.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseInterceptor = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const operators_1 = require("rxjs/operators");
+const core_1 = require("@nestjs/core");
+const response_message_decorator_1 = require("../decorators/response-message.decorator");
+let ResponseInterceptor = class ResponseInterceptor {
+    constructor(reflector) {
+        this.reflector = reflector;
+    }
+    intercept(context, next) {
+        const handler = context.getHandler();
+        const controller = context.getClass();
+        return next.handle().pipe((0, operators_1.map)((data) => {
+            const entityConfig = this.reflector.get(response_message_decorator_1.ENTITY_NAME_KEY, controller);
+            const action = this.reflector.get(response_message_decorator_1.MESSAGE_KEY, handler);
+            const isList = Array.isArray(data) || Array.isArray(data?.data);
+            const name = isList
+                ? entityConfig?.plural ?? 'Resources'
+                : entityConfig?.singular ?? 'Resource';
+            const finalMessage = action
+                ? `${name} ${action} successfully`
+                : 'Request successful';
+            return {
+                message: finalMessage,
+                data: data?.data ?? data ?? null,
+                meta: data?.meta,
+                status: 'success',
+            };
+        }));
+    }
+};
+exports.ResponseInterceptor = ResponseInterceptor;
+exports.ResponseInterceptor = ResponseInterceptor = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.Reflector])
+], ResponseInterceptor);

package/dist/lib/interfaces/crud.interface.d.ts

@@ -0,0 +1,23 @@
+import { FilterDto } from '../dtos/filter.dto';
+import { PaginationDto } from '../dtos/pagination.dto';
+export type CrudEndpoint = 'findAll' | 'findOne' | 'create' | 'update' | 'remove' | 'findAuditLogs';
+export interface AuditLogQuery {
+    user_id?: string;
+    start_date?: string;
+    end_date?: string;
+    page?: number;
+    limit?: number;
+}
+export interface CrudInterface<CreateDto, UpdateDto, ResponseDto> {
+    disabledEndpoints?: readonly CrudEndpoint[];
+    findAll(query: PaginationDto & FilterDto): Promise<{
+        data: ResponseDto[];
+        meta?: unknown;
+    }>;
+    findOne(id: number): Promise<ResponseDto>;
+    create(dto: CreateDto): Promise<ResponseDto>;
+    update(id: number, dto: UpdateDto): Promise<ResponseDto>;
+    remove(id: number): Promise<boolean>;
+    findAuditLogs?(query: AuditLogQuery): Promise<unknown>;
+}
+//# sourceMappingURL=crud.interface.d.ts.map

package/dist/lib/interfaces/crud.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/crud.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,eAAe,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW;IAC9D,iBAAiB,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAE5C,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;QACjD,IAAI,EAAE,WAAW,EAAE,CAAC;QACpB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1C,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC,aAAa,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD"}

package/dist/lib/interfaces/crud.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/nest-crud.module.d.ts

@@ -0,0 +1,3 @@
+export declare class NestCrudModule {
+}
+//# sourceMappingURL=nest-crud.module.d.ts.map

package/dist/lib/nest-crud.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-crud.module.d.ts","sourceRoot":"","sources":["../../src/lib/nest-crud.module.ts"],"names":[],"mappings":"AAGA,qBAIa,cAAc;CAAG"}

package/dist/lib/nest-crud.module.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestCrudModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const nest_crud_service_1 = require("./services/nest-crud.service");
+let NestCrudModule = class NestCrudModule {
+};
+exports.NestCrudModule = NestCrudModule;
+exports.NestCrudModule = NestCrudModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        providers: [nest_crud_service_1.NestCrudService],
+        exports: [nest_crud_service_1.NestCrudService],
+    })
+], NestCrudModule);

package/dist/lib/services/nest-crud.service.d.ts

@@ -0,0 +1,69 @@
+import { Type } from '@nestjs/common';
+import { ObjectLiteral, Repository } from 'typeorm';
+import { AuditLogEntity } from '@nest-util/nest-audit';
+import { PaginationDto } from '../dtos/pagination.dto';
+import { FilterDto } from '../dtos/filter.dto';
+import { CrudEndpoint, CrudInterface } from '../interfaces/crud.interface';
+export interface CrudServiceOptions<Entity extends ObjectLiteral, ResponseDto> {
+    repository: Repository<Entity>;
+    allowedFilters?: readonly (keyof Entity)[];
+    allowedSortFields?: readonly (keyof Entity)[];
+    include?: readonly string[];
+    relations?: {
+        property: keyof Entity;
+        repo: Repository<ObjectLiteral>;
+        idField?: string;
+    }[];
+    toResponseDto?: (entity: Entity | Entity[]) => ResponseDto | ResponseDto[];
+    createDtoClass?: Type<unknown>;
+    updateDtoClass?: Type<unknown>;
+    disabledEndpoints?: readonly CrudEndpoint[];
+}
+export declare class NestCrudService<Entity extends ObjectLiteral, CreateDto = Partial<Entity>, UpdateDto = Partial<Entity>, ResponseDto = Entity> implements CrudInterface<CreateDto, UpdateDto, ResponseDto> {
+    protected readonly repo: Repository<Entity>;
+    protected readonly allowedFilters: readonly (keyof Entity)[];
+    protected readonly allowedSortFields: readonly (keyof Entity)[];
+    protected readonly include: readonly string[];
+    protected readonly relations: {
+        property: keyof Entity;
+        repo: Repository<ObjectLiteral>;
+        idField?: string;
+    }[];
+    protected readonly toResponseDto?: (entity: Entity | Entity[]) => ResponseDto | ResponseDto[];
+    protected readonly createDtoClass?: Type<unknown>;
+    protected readonly updateDtoClass?: Type<unknown>;
+    readonly disabledEndpoints: readonly CrudEndpoint[];
+    constructor(options: CrudServiceOptions<Entity, ResponseDto>);
+    private resolveRelations;
+    findAll(query: PaginationDto & FilterDto): Promise<{
+        data: ResponseDto[];
+        meta: {
+            total: number;
+            page: number;
+            limit: number;
+        };
+    } | {
+        data: ResponseDto[];
+        meta?: undefined;
+    }>;
+    findOne(id: number): Promise<ResponseDto>;
+    create(payload: CreateDto): Promise<ResponseDto>;
+    update(id: number, payload: UpdateDto): Promise<ResponseDto>;
+    remove(id: number): Promise<boolean>;
+    findAuditLogs(query: {
+        user_id?: string;
+        start_date?: string;
+        end_date?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<{
+        data: AuditLogEntity[];
+        meta: {
+            total: number;
+            page: number;
+            limit: number;
+            totalPages: number;
+        };
+    }>;
+}
+//# sourceMappingURL=nest-crud.service.d.ts.map

package/dist/lib/services/nest-crud.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-crud.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/nest-crud.service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,154 @@
+"use strict";
+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 filter_helper_1 = require("../helpers/filter.helper");
+const pagination_helper_1 = require("../helpers/pagination.helper");
+let NestCrudService = class NestCrudService {
+    constructor(options) {
+        this.repo = options.repository;
+        this.allowedFilters = options.allowedFilters ?? [];
+        this.allowedSortFields = options.allowedSortFields ?? [];
+        this.include = options.include ?? [];
+        this.relations = options.relations ?? [];
+        this.toResponseDto = options.toResponseDto;
+        this.createDtoClass = options.createDtoClass;
+        this.updateDtoClass = options.updateDtoClass;
+        this.disabledEndpoints = options.disabledEndpoints ?? [];
+    }
+    async resolveRelations(payload) {
+        if (!this.relations.length)
+            return payload;
+        for (const relation of this.relations) {
+            const idField = relation.idField ?? `${String(relation.property)}Id`;
+            if (!(idField in payload))
+                continue;
+            const id = payload[idField];
+            if (!id)
+                continue;
+            const entity = await relation.repo.findOneBy({
+                id,
+            });
+            if (!entity) {
+                throw new common_1.NotFoundException(`${String(relation.property)} not found`);
+            }
+            payload[String(relation.property)] = entity;
+            delete payload[idField];
+        }
+        return payload;
+    }
+    async findAll(query) {
+        const qb = this.repo.createQueryBuilder('e');
+        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 findOne(id) {
+        const entity = await this.repo.findOne({
+            where: { id },
+            relations: this.include,
+        });
+        if (!entity) {
+            throw new common_1.NotFoundException('Resource not found');
+        }
+        return this.toResponseDto
+            ? this.toResponseDto(entity)
+            : entity;
+    }
+    async create(payload) {
+        const resolved = await this.resolveRelations(payload);
+        const entity = await this.repo.save(resolved);
+        return this.toResponseDto
+            ? this.toResponseDto(entity)
+            : entity;
+    }
+    async update(id, payload) {
+        const existing = await this.repo.findOneBy({
+            id,
+        });
+        if (!existing) {
+            throw new common_1.NotFoundException('Resource not found');
+        }
+        const resolved = await this.resolveRelations(payload);
+        await this.repo.update(id, resolved);
+        return this.findOne(id);
+    }
+    async remove(id) {
+        const result = await this.repo.delete(id);
+        if (result.affected === 0) {
+            throw new common_1.NotFoundException('Resource not found');
+        }
+        return true;
+    }
+    async findAuditLogs(query) {
+        const page = query.page ?? 1;
+        const limit = query.limit ?? 10;
+        const qb = this.repo.manager
+            .getRepository(nest_audit_1.AuditLogEntity)
+            .createQueryBuilder('auditLog')
+            .where('auditLog.entity = :entity', {
+            entity: this.repo.metadata.name,
+        })
+            .orderBy('auditLog.createdAt', 'DESC');
+        if (query.user_id) {
+            qb.andWhere('auditLog.userId = :userId', {
+                userId: query.user_id,
+            });
+        }
+        if (query.start_date) {
+            qb.andWhere('auditLog.createdAt >= :startDate', {
+                startDate: new Date(query.start_date),
+            });
+        }
+        if (query.end_date) {
+            qb.andWhere('auditLog.createdAt <= :endDate', {
+                endDate: new Date(query.end_date),
+            });
+        }
+        qb.skip((page - 1) * limit).take(limit);
+        const [data, total] = await qb.getManyAndCount();
+        return {
+            data,
+            meta: {
+                total,
+                page,
+                limit,
+                totalPages: Math.ceil(total / limit) || 1,
+            },
+        };
+    }
+};
+exports.NestCrudService = NestCrudService;
+exports.NestCrudService = NestCrudService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], NestCrudService);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@nest-util/nest-crud",
+  "version": "0.0.3",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@nest-util/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@nest-util/nest-audit": "workspace:*",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/swagger": "^11.2.6",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.3",
+    "express": "^5.2.1",
+    "typeorm": "^0.3.28",
+    "rxjs": "^7.8.0"
+  }
+}