@nest-util/nest-crud 0.0.3 → 1.0.0

package/README.md

@@ -7,11 +7,21 @@ This library was generated with [Nx](https://nx.dev).
 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
+pnpm add https://github.com/nigussolomon/nest-util/releases/download/latest/nest-util-nest-crud-0.1.1.tgz
 ```
 
-> [!TIP]
-> This tarball contains only the compiled code and its specific dependencies, making it as clean as a standard npm package.
+> **Tip:** This tarball contains only the compiled code and its specific dependencies, making it as clean as a standard npm package.
+
+## Features
+
+- Generic CRUD service with filtering, pagination, and sorting
+- Controller factory that generates 7 REST endpoints
+- Built-in audit logging with `@Audit()` decorator
+- Lifecycle hooks (before/after) with transaction support
+- Cursor-based pagination for efficient large-dataset traversal
+- User-scoped record retrieval via `GET /resource/mine`
+- Automatic Swagger documentation
+- TypeORM exception filter for duplicate key errors
 
 ## Building
 

package/dist/index.d.ts

@@ -3,9 +3,19 @@ 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/dtos/cursor-pagination.dto';
+export * from './lib/dtos/list-audit-logs.dto';
 export * from './lib/decorators/response-message.decorator';
+export * from './lib/decorators/audit-log.decorator';
 export * from './lib/interceptors/response.interceptor';
+export * from './lib/interceptors/audit-log.interceptor';
 export * from './lib/interfaces/crud.interface';
+export * from './lib/interfaces/cursor-strategy.interface';
+export * from './lib/interfaces/hooks.interface';
+export * from './lib/interfaces/find-mine.interface';
+export * from './lib/interfaces/audit-log.interface';
 export * from './lib/helpers/exception-filter.helper';
-export { Audit, AuditLogEntity } from '@nest-util/nest-audit';
+export * from './lib/helpers/cursor-pagination.helper';
+export * from './lib/entities/audit-log.entity';
+export * from './lib/services/audit-log.service';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sCAAsC,CAAC;AACrD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC"}

package/dist/index.js

@@ -1,16 +1,23 @@
 "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/dtos/cursor-pagination.dto"), exports);
+tslib_1.__exportStar(require("./lib/dtos/list-audit-logs.dto"), exports);
 tslib_1.__exportStar(require("./lib/decorators/response-message.decorator"), exports);
+tslib_1.__exportStar(require("./lib/decorators/audit-log.decorator"), exports);
 tslib_1.__exportStar(require("./lib/interceptors/response.interceptor"), exports);
+tslib_1.__exportStar(require("./lib/interceptors/audit-log.interceptor"), exports);
 tslib_1.__exportStar(require("./lib/interfaces/crud.interface"), exports);
+tslib_1.__exportStar(require("./lib/interfaces/cursor-strategy.interface"), exports);
+tslib_1.__exportStar(require("./lib/interfaces/hooks.interface"), exports);
+tslib_1.__exportStar(require("./lib/interfaces/find-mine.interface"), exports);
+tslib_1.__exportStar(require("./lib/interfaces/audit-log.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; } });
+tslib_1.__exportStar(require("./lib/helpers/cursor-pagination.helper"), exports);
+tslib_1.__exportStar(require("./lib/entities/audit-log.entity"), exports);
+tslib_1.__exportStar(require("./lib/services/audit-log.service"), exports);

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

@@ -2,12 +2,13 @@ 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';
+import { ListAuditLogsDto } from '../dtos/list-audit-logs.dto';
 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;
+    enableFindMine?: boolean;
 }
 export interface IBaseController<CD, UD, RD> {
     service: CrudInterface<CD, UD, RD>;

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

@@ -1 +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"}
+{"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;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,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;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;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,CA8HnC"}

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

@@ -6,7 +6,9 @@ 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");
+const audit_log_decorator_1 = require("../decorators/audit-log.decorator");
+const list_audit_logs_dto_1 = require("../dtos/list-audit-logs.dto");
+const nest_auth_1 = require("@nest-util/nest-auth");
 exports.AUTH_PERMISSIONS_METADATA_KEY = 'auth:permissions';
 const toPermissionList = (permissionValue) => {
     if (Array.isArray(permissionValue)) {
@@ -50,8 +52,22 @@ function CreateNestedCrudController(createDto, updateDto, responseDto, options)
         }
         findAll(query) {
             this.ensureEndpointEnabled('findAll');
+            // Cursor-based pagination: dispatch to cursor endpoint
+            if (query.cursor !== undefined) {
+                if (!this.service.findAllWithCursor) {
+                    throw new common_1.NotFoundException('Resource not found');
+                }
+                return this.service.findAllWithCursor(query);
+            }
             return this.service.findAll(query);
         }
+        findMine(user, query) {
+            this.ensureEndpointEnabled('findMine');
+            if (!this.service.findMine) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+            return this.service.findMine(user.id, query);
+        }
         create(dto) {
             this.ensureEndpointEnabled('create');
             return this.service.create(dto);
@@ -100,15 +116,35 @@ function CreateNestedCrudController(createDto, updateDto, responseDto, options)
             required: false,
             enum: ['ASC', 'DESC'],
         }),
+        (0, swagger_1.ApiQuery)({ name: 'cursor', required: false, type: String }),
+        (0, swagger_1.ApiQuery)({ name: 'includeTotal', required: false, type: Boolean }),
         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.Get)('mine'),
+        (0, response_message_decorator_1.Message)('fetched'),
+        (0, swagger_1.ApiResponse)({ type: [responseDto] }),
+        (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, nest_auth_1.CurrentUser)()),
+        tslib_1.__param(1, (0, common_1.Query)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Object, Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "findMine", null);
     tslib_1.__decorate([
         (0, common_1.Post)(),
         (0, response_message_decorator_1.Message)('created'),
-        (0, nest_audit_1.Audit)({ action: 'CREATE' }),
+        (0, audit_log_decorator_1.Audit)({ action: 'CREATE' }),
         (0, swagger_1.ApiBody)({ type: createDto }),
         (0, swagger_1.ApiResponse)({ type: responseDto }),
         tslib_1.__param(0, (0, common_1.Body)()),
@@ -119,7 +155,7 @@ function CreateNestedCrudController(createDto, updateDto, responseDto, options)
     tslib_1.__decorate([
         (0, common_1.Patch)(':id'),
         (0, response_message_decorator_1.Message)('updated'),
-        (0, nest_audit_1.Audit)({ action: 'UPDATE' }),
+        (0, audit_log_decorator_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)),
@@ -131,7 +167,7 @@ function CreateNestedCrudController(createDto, updateDto, responseDto, options)
     tslib_1.__decorate([
         (0, common_1.Delete)(':id'),
         (0, response_message_decorator_1.Message)('deleted'),
-        (0, nest_audit_1.Audit)({ action: 'DELETE' }),
+        (0, audit_log_decorator_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]),
@@ -142,7 +178,7 @@ function CreateNestedCrudController(createDto, updateDto, responseDto, options)
         (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:paramtypes", [list_audit_logs_dto_1.ListAuditLogsDto]),
         tslib_1.__metadata("design:returntype", void 0)
     ], BaseController.prototype, "findAuditLogs", null);
     tslib_1.__decorate([

package/dist/lib/decorators/audit-log.decorator.d.ts

@@ -0,0 +1,7 @@
+export declare const AUDIT_METADATA_KEY = "nest_util_audit";
+export interface AuditOptions {
+    action: string;
+    entity?: string;
+}
+export declare const Audit: (options: AuditOptions) => import("@nestjs/common").CustomDecorator<string>;
+//# sourceMappingURL=audit-log.decorator.d.ts.map

package/dist/lib/decorators/audit-log.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.decorator.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators/audit-log.decorator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,KAAK,GAAI,SAAS,YAAY,qDACD,CAAC"}

package/dist/lib/decorators/audit-log.decorator.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Audit = exports.AUDIT_METADATA_KEY = void 0;
+const common_1 = require("@nestjs/common");
+exports.AUDIT_METADATA_KEY = 'nest_util_audit';
+const Audit = (options) => (0, common_1.SetMetadata)(exports.AUDIT_METADATA_KEY, options);
+exports.Audit = Audit;

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

@@ -0,0 +1,6 @@
+export declare class CursorPaginationDto {
+    cursor?: string;
+    limit?: number;
+    includeTotal?: boolean;
+}
+//# sourceMappingURL=cursor-pagination.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-pagination.dto.d.ts","sourceRoot":"","sources":["../../../src/lib/dtos/cursor-pagination.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,mBAAmB;IAO9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAahB,KAAK,CAAC,EAAE,MAAM,CAAM;IASpB,YAAY,CAAC,EAAE,OAAO,CAAS;CAChC"}

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorPaginationDto = 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 CursorPaginationDto {
+    constructor() {
+        this.limit = 10;
+        this.includeTotal = false;
+    }
+}
+exports.CursorPaginationDto = CursorPaginationDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Opaque cursor returned from a previous response. Omit to fetch the first page.',
+        example: 'eyJpZCI6NDJ9',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    tslib_1.__metadata("design:type", String)
+], CursorPaginationDto.prototype, "cursor", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Maximum number of items to return',
+        minimum: 1,
+        maximum: 100,
+        default: 10,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    tslib_1.__metadata("design:type", Number)
+], CursorPaginationDto.prototype, "limit", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Include totalCount in the response. Disabled by default for performance.',
+        default: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value === 'true' || value === true),
+    (0, class_validator_1.IsBoolean)(),
+    tslib_1.__metadata("design:type", Boolean)
+], CursorPaginationDto.prototype, "includeTotal", void 0);

package/dist/lib/dtos/list-audit-logs.dto.d.ts

@@ -0,0 +1,8 @@
+export declare class ListAuditLogsDto {
+    user_id?: string;
+    start_date?: string;
+    end_date?: string;
+    page?: number;
+    limit?: number;
+}
+//# sourceMappingURL=list-audit-logs.dto.d.ts.map

package/dist/lib/dtos/list-audit-logs.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-audit-logs.dto.d.ts","sourceRoot":"","sources":["../../../src/lib/dtos/list-audit-logs.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,gBAAgB;IAO3B,OAAO,CAAC,EAAE,MAAM,CAAC;IAQjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAQpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAWlB,IAAI,CAAC,EAAE,MAAM,CAAK;IAWlB,KAAK,CAAC,EAAE,MAAM,CAAM;CACrB"}

package/dist/lib/dtos/list-audit-logs.dto.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListAuditLogsDto = void 0;
+const tslib_1 = require("tslib");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const swagger_1 = require("@nestjs/swagger");
+class ListAuditLogsDto {
+    constructor() {
+        this.page = 1;
+        this.limit = 10;
+    }
+}
+exports.ListAuditLogsDto = ListAuditLogsDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        name: 'user_id',
+        description: 'Filter by user identifier',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    tslib_1.__metadata("design:type", String)
+], ListAuditLogsDto.prototype, "user_id", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        name: 'start_date',
+        description: 'Filter logs created at or after this date (ISO-8601)',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    tslib_1.__metadata("design:type", String)
+], ListAuditLogsDto.prototype, "start_date", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        name: 'end_date',
+        description: 'Filter logs created at or before this date (ISO-8601)',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    tslib_1.__metadata("design:type", String)
+], ListAuditLogsDto.prototype, "end_date", void 0);
+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)
+], ListAuditLogsDto.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)
+], ListAuditLogsDto.prototype, "limit", void 0);

package/dist/lib/entities/audit-log.entity.d.ts

@@ -0,0 +1,13 @@
+export declare class AuditLogEntity {
+    id: string;
+    tenantId?: string;
+    action: string;
+    entity?: string;
+    entityId?: string;
+    userId?: string;
+    metadata?: Record<string, unknown>;
+    ip?: string;
+    userAgent?: string;
+    createdAt: Date;
+}
+//# sourceMappingURL=audit-log.entity.d.ts.map

package/dist/lib/entities/audit-log.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.entity.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/audit-log.entity.ts"],"names":[],"mappings":"AAQA,qBACa,cAAc;IAEzB,EAAE,EAAG,MAAM,CAAC;IAIZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,MAAM,EAAG,MAAM,CAAC;IAIhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAIhB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGnC,EAAE,CAAC,EAAE,MAAM,CAAC;IAIZ,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/lib/entities/audit-log.entity.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogEntity = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+let AuditLogEntity = class AuditLogEntity {
+};
+exports.AuditLogEntity = AuditLogEntity;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "tenantId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)(),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "action", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "entity", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "entityId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "userId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], AuditLogEntity.prototype, "metadata", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "ip", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], AuditLogEntity.prototype, "userAgent", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    tslib_1.__metadata("design:type", Date)
+], AuditLogEntity.prototype, "createdAt", void 0);
+exports.AuditLogEntity = AuditLogEntity = tslib_1.__decorate([
+    (0, typeorm_1.Entity)('audit_logs')
+], AuditLogEntity);

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

@@ -0,0 +1,9 @@
+import { SelectQueryBuilder, Repository } from 'typeorm';
+import { CursorStrategy, DecodedCursor } from '../interfaces/cursor-strategy.interface';
+export declare function base64UrlEncode(payload: Record<string, unknown>): string;
+export declare function base64UrlDecode(raw: string): Record<string, unknown>;
+export declare function decodeCursor(raw: string, strategy: CursorStrategy): DecodedCursor;
+export declare function applyCursorFilter(qb: SelectQueryBuilder<any>, decoded: DecodedCursor, strategy: CursorStrategy, orderDirection: 'ASC' | 'DESC'): void;
+export declare function buildNextCursor<T extends Record<string, unknown>>(entities: T[], strategy: CursorStrategy): string | null;
+export declare function detectCursorStrategy(repository: Repository<any>): CursorStrategy;
+//# sourceMappingURL=cursor-pagination.helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-pagination.helper.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/cursor-pagination.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EACL,cAAc,EACd,aAAa,EAGd,MAAM,yCAAyC,CAAC;AAIjD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMxE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGpE;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,aAAa,CAyBjF;AAKD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAC3B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,KAAK,GAAG,MAAM,GAC7B,IAAI,CAoBN;AAID,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,QAAQ,EAAE,CAAC,EAAE,EACb,QAAQ,EAAE,cAAc,GACvB,MAAM,GAAG,IAAI,CAcf;AAID,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,GAC1B,cAAc,CAoBhB"}

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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.base64UrlEncode = base64UrlEncode;
+exports.base64UrlDecode = base64UrlDecode;
+exports.decodeCursor = decodeCursor;
+exports.applyCursorFilter = applyCursorFilter;
+exports.buildNextCursor = buildNextCursor;
+exports.detectCursorStrategy = detectCursorStrategy;
+// ─── Base64-URL helpers ──────────────────────────────────────────────
+function base64UrlEncode(payload) {
+    return Buffer.from(JSON.stringify(payload))
+        .toString('base64')
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=+$/, '');
+}
+function base64UrlDecode(raw) {
+    const base64 = raw.replace(/-/g, '+').replace(/_/g, '/') + '=='.slice((raw.length + 3) % 4);
+    return JSON.parse(Buffer.from(base64, 'base64').toString('utf8'));
+}
+// ─── Cursor decode / validate ─────────────────────────────────────────
+function decodeCursor(raw, strategy) {
+    let parsed;
+    try {
+        parsed = base64UrlDecode(raw);
+    }
+    catch {
+        throw new Error('Invalid cursor format');
+    }
+    if (strategy.type === 'integer') {
+        if (typeof parsed.id !== 'number') {
+            throw new Error('Invalid integer cursor: missing numeric id');
+        }
+        return { type: 'integer', id: parsed.id };
+    }
+    // UUID / composite cursor
+    const tsCol = strategy.timestampColumn ?? 'createdAt';
+    if (typeof parsed[tsCol] !== 'string' || typeof parsed.id !== 'string') {
+        throw new Error(`Invalid UUID cursor: missing ${tsCol} or id`);
+    }
+    return {
+        type: 'uuid',
+        createdAt: parsed[tsCol],
+        id: parsed.id,
+    };
+}
+// ─── Query-builder mutations ──────────────────────────────────────────
+/* eslint-disable @typescript-eslint/no-explicit-any */
+function applyCursorFilter(qb, decoded, strategy, orderDirection) {
+    // DESC order means "next page" goes to lower IDs → `< :cursorId`
+    // ASC  order means "next page" goes to higher IDs → `> :cursorId`
+    const comparator = orderDirection === 'DESC' ? '<' : '>';
+    if (decoded.type === 'integer') {
+        qb.andWhere(`${qb.expressionMap.mainAlias.name}.id ${comparator} :cursorId`, {
+            cursorId: decoded.id,
+        });
+        return;
+    }
+    // UUID composite cursor: (col1, col2) < (val1, val2)
+    const alias = qb.expressionMap.mainAlias.name;
+    const tsCol = strategy.timestampColumn ?? 'createdAt';
+    qb.andWhere(`(${alias}.${tsCol}, ${alias}.id) ${comparator} (:cursorTs, :cursorId)`, { cursorTs: decoded.createdAt, cursorId: decoded.id });
+}
+// ─── Build next cursor from result set ────────────────────────────────
+function buildNextCursor(entities, strategy) {
+    if (entities.length === 0)
+        return null;
+    const last = entities[entities.length - 1];
+    if (strategy.type === 'integer') {
+        return base64UrlEncode({ id: Number(last['id']) });
+    }
+    const tsCol = strategy.timestampColumn ?? 'createdAt';
+    return base64UrlEncode({
+        [tsCol]: String(last[tsCol]),
+        id: String(last['id']),
+    });
+}
+// ─── Detect strategy from repository metadata ─────────────────────────
+function detectCursorStrategy(repository) {
+    const primaryColumn = repository.metadata.primaryColumns[0];
+    if (!primaryColumn) {
+        return { type: 'integer' };
+    }
+    const typeValue = primaryColumn.type;
+    // Handle both () => String and String constructor patterns
+    const typeName = typeof typeValue === 'function'
+        ? typeValue.name
+        : String(typeValue);
+    if (typeName === 'String') {
+        return { type: 'uuid' };
+    }
+    return { type: 'integer' };
+}

package/dist/lib/interceptors/audit-log.interceptor.d.ts

@@ -0,0 +1,12 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { AuditService } from '../services/audit-log.service';
+export declare class AuditInterceptor implements NestInterceptor {
+    private readonly auditService;
+    private readonly reflector;
+    constructor(auditService: AuditService, reflector: Reflector);
+    intercept(context: ExecutionContext, next: CallHandler<unknown>): Observable<unknown>;
+    private resolveEntityName;
+}
+//# sourceMappingURL=audit-log.interceptor.d.ts.map

package/dist/lib/interceptors/audit-log.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.interceptor.d.ts","sourceRoot":"","sources":["../../../src/lib/interceptors/audit-log.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAO,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAS7D,qBACa,gBAAiB,YAAW,eAAe;IAEpD,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS;IAGvC,SAAS,CACP,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GACzB,UAAU,CAAC,OAAO,CAAC;IAyCtB,OAAO,CAAC,iBAAiB;CAwB1B"}

package/dist/lib/interceptors/audit-log.interceptor.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditInterceptor = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const rxjs_1 = require("rxjs");
+const audit_log_service_1 = require("../services/audit-log.service");
+const audit_log_decorator_1 = require("../decorators/audit-log.decorator");
+const CONTROLLER_ENTITY_NAME_KEY = 'entityName';
+const ENTITY_ENTITY_NAME_KEY = 'custom:entityName';
+let AuditInterceptor = class AuditInterceptor {
+    constructor(auditService, reflector) {
+        this.auditService = auditService;
+        this.reflector = reflector;
+    }
+    intercept(context, next) {
+        const handler = context.getHandler();
+        const auditOptions = this.reflector.get(audit_log_decorator_1.AUDIT_METADATA_KEY, handler);
+        if (!auditOptions) {
+            return next.handle();
+        }
+        const request = context.switchToHttp().getRequest();
+        const userId = request.user?.id;
+        const ip = request.ip;
+        const userAgent = request.headers?.['user-agent'];
+        let entityName = auditOptions.entity;
+        if (!entityName) {
+            entityName = this.resolveEntityName(context);
+        }
+        return next.handle().pipe((0, rxjs_1.tap)(async (result) => {
+            await this.auditService.log({
+                action: auditOptions.action,
+                entity: entityName,
+                userId,
+                ip,
+                userAgent,
+                metadata: {
+                    body: request.body,
+                    params: request.params,
+                    query: request.query,
+                    response: result,
+                },
+            });
+        }));
+    }
+    resolveEntityName(context) {
+        const controllerClass = context.getClass();
+        const controllerMeta = Reflect.getMetadata(CONTROLLER_ENTITY_NAME_KEY, controllerClass);
+        if (controllerMeta?.singular) {
+            return controllerMeta.singular;
+        }
+        try {
+            const controllerInstance = controllerClass.prototype;
+            const serviceInstance = controllerInstance?.service;
+            const repositoryTarget = serviceInstance?.repository?.target;
+            const entityMeta = repositoryTarget
+                ? Reflect.getMetadata(ENTITY_ENTITY_NAME_KEY, repositoryTarget)
+                : null;
+            return entityMeta?.singular ?? 'Resource';
+        }
+        catch {
+            return 'Resource';
+        }
+    }
+};
+exports.AuditInterceptor = AuditInterceptor;
+exports.AuditInterceptor = AuditInterceptor = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [audit_log_service_1.AuditService,
+        core_1.Reflector])
+], AuditInterceptor);