@nest-util/nest-crud 1.1.5 → 1.2.2

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './lib/dtos/pagination.dto';
 export * from './lib/dtos/cursor-pagination.dto';
 export * from './lib/dtos/list-audit-logs.dto';
 export * from './lib/dtos/status-change.dto';
+export * from './lib/dtos/request-modification.dto';
 export * from './lib/decorators/response-message.decorator';
 export * from './lib/decorators/audit-log.decorator';
 export * from './lib/interceptors/response.interceptor';
@@ -15,10 +16,13 @@ export * from './lib/interfaces/cursor-strategy.interface';
 export * from './lib/interfaces/hooks.interface';
 export * from './lib/interfaces/find-mine.interface';
 export * from './lib/interfaces/status-pipeline.interface';
+export * from './lib/interfaces/approval-pipeline.interface';
 export * from './lib/interfaces/audit-log.interface';
 export * from './lib/helpers/exception-filter.helper';
 export * from './lib/helpers/cursor-pagination.helper';
 export * from './lib/entities/audit-log.entity';
+export * from './lib/entities/approval-status.entity';
+export * from './lib/entities/modification-request-history.entity';
 export * from './lib/services/audit-log.service';
 export * from './lib/events';
 //# 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,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,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,4CAA4C,CAAC;AAC3D,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,cAAc,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,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,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,4CAA4C,CAAC;AAC3D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oDAAoD,CAAC;AACnE,cAAc,kCAAkC,CAAC;AACjD,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -9,6 +9,7 @@ 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/dtos/status-change.dto"), exports);
+tslib_1.__exportStar(require("./lib/dtos/request-modification.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);
@@ -18,9 +19,12 @@ tslib_1.__exportStar(require("./lib/interfaces/cursor-strategy.interface"), expo
 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/status-pipeline.interface"), exports);
+tslib_1.__exportStar(require("./lib/interfaces/approval-pipeline.interface"), exports);
 tslib_1.__exportStar(require("./lib/interfaces/audit-log.interface"), exports);
 tslib_1.__exportStar(require("./lib/helpers/exception-filter.helper"), exports);
 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/entities/approval-status.entity"), exports);
+tslib_1.__exportStar(require("./lib/entities/modification-request-history.entity"), exports);
 tslib_1.__exportStar(require("./lib/services/audit-log.service"), exports);
 tslib_1.__exportStar(require("./lib/events"), exports);

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

@@ -5,6 +5,7 @@ import { FilterDto } from '../dtos/filter.dto';
 import { ListAuditLogsDto } from '../dtos/list-audit-logs.dto';
 import { StatusChangeDto } from '../dtos/status-change.dto';
 import type { OwnershipUser } from '../interfaces/find-mine.interface';
+import type { ApprovalHistoryView, ApprovalStatusView, RequestModificationPayload } from '../interfaces/approval-pipeline.interface';
 export declare const AUTH_PERMISSIONS_METADATA_KEY = "auth:permissions";
 export type CrudEndpointPermissions = string | readonly string[];
 export type CrudPermissionsMap = Partial<Record<CrudEndpoint, CrudEndpointPermissions>>;
@@ -24,6 +25,14 @@ export interface IBaseController<CD, UD, RD> {
     changeStatus?(id: number, dto: StatusChangeDto, user?: OwnershipUser): Promise<RD>;
     remove(id: number, user?: OwnershipUser): Promise<boolean>;
     findAuditLogs?(query: ListAuditLogsDto): Promise<unknown>;
+    getApproval?(id: number, user?: OwnershipUser): Promise<{
+        approval: ApprovalStatusView;
+        history: ApprovalHistoryView[];
+    }>;
+    approveApproval?(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    rejectApproval?(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    requestModification?(id: number, dto: RequestModificationPayload, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    resubmitApproval?(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
 }
 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

@@ -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;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,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,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/D,YAAY,CAAC,CACX,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,eAAe,EACpB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,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,CA2JnC"}
+{"version":3,"file":"nest-crud.controller.d.ts","sourceRoot":"","sources":["../../../src/lib/controllers/nest-crud.controller.ts"],"names":[],"mappings":"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"}

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

@@ -9,6 +9,7 @@ const response_message_decorator_1 = require("../decorators/response-message.dec
 const audit_log_decorator_1 = require("../decorators/audit-log.decorator");
 const list_audit_logs_dto_1 = require("../dtos/list-audit-logs.dto");
 const status_change_dto_1 = require("../dtos/status-change.dto");
+const request_modification_dto_1 = require("../dtos/request-modification.dto");
 const nest_auth_1 = require("@nest-util/nest-auth");
 exports.AUTH_PERMISSIONS_METADATA_KEY = 'auth:permissions';
 const toPermissionList = (permissionValue) => {
@@ -84,6 +85,41 @@ function CreateNestedCrudController(createDto, updateDto, responseDto, options)
             }
             return this.service.changeStatus(id, dto.status, user);
         }
+        getApproval(id, user) {
+            this.ensureEndpointEnabled('getApproval');
+            if (!this.service.getApproval) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+            return this.service.getApproval(id, user);
+        }
+        approveApproval(id, user) {
+            this.ensureEndpointEnabled('approveApproval');
+            if (!this.service.approveApproval) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+            return this.service.approveApproval(id, user);
+        }
+        rejectApproval(id, user) {
+            this.ensureEndpointEnabled('rejectApproval');
+            if (!this.service.rejectApproval) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+            return this.service.rejectApproval(id, user);
+        }
+        requestModification(id, dto, user) {
+            this.ensureEndpointEnabled('requestModification');
+            if (!this.service.requestModification) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+            return this.service.requestModification(id, dto, user);
+        }
+        resubmitApproval(id, user) {
+            this.ensureEndpointEnabled('resubmitApproval');
+            if (!this.service.resubmitApproval) {
+                throw new common_1.NotFoundException('Resource not found');
+            }
+            return this.service.resubmitApproval(id, user);
+        }
         remove(id, user) {
             this.ensureEndpointEnabled('remove');
             return this.service.remove(id, user);
@@ -187,6 +223,62 @@ function CreateNestedCrudController(createDto, updateDto, responseDto, options)
         tslib_1.__metadata("design:paramtypes", [Number, status_change_dto_1.StatusChangeDto, Object]),
         tslib_1.__metadata("design:returntype", void 0)
     ], BaseController.prototype, "changeStatus", null);
+    tslib_1.__decorate([
+        (0, common_1.Get)(':id/approval'),
+        (0, response_message_decorator_1.Message)('fetched approval'),
+        (0, swagger_1.ApiResponse)({ description: 'Approval status and modification history' }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__param(1, (0, nest_auth_1.CurrentUser)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number, Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "getApproval", null);
+    tslib_1.__decorate([
+        (0, common_1.Post)(':id/approval/approve'),
+        (0, response_message_decorator_1.Message)('approved'),
+        (0, audit_log_decorator_1.Audit)({ action: 'APPROVE' }),
+        (0, swagger_1.ApiResponse)({ description: 'The updated approval status' }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__param(1, (0, nest_auth_1.CurrentUser)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number, Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "approveApproval", null);
+    tslib_1.__decorate([
+        (0, common_1.Post)(':id/approval/reject'),
+        (0, response_message_decorator_1.Message)('rejected'),
+        (0, audit_log_decorator_1.Audit)({ action: 'REJECT' }),
+        (0, swagger_1.ApiResponse)({ description: 'The updated approval status' }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__param(1, (0, nest_auth_1.CurrentUser)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number, Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "rejectApproval", null);
+    tslib_1.__decorate([
+        (0, common_1.Post)(':id/approval/request-modification'),
+        (0, response_message_decorator_1.Message)('modification requested'),
+        (0, audit_log_decorator_1.Audit)({ action: 'REQUEST_MODIFICATION' }),
+        (0, swagger_1.ApiBody)({ type: request_modification_dto_1.RequestModificationDto }),
+        (0, swagger_1.ApiResponse)({ description: 'The updated approval status' }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__param(1, (0, common_1.Body)()),
+        tslib_1.__param(2, (0, nest_auth_1.CurrentUser)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number, request_modification_dto_1.RequestModificationDto, Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "requestModification", null);
+    tslib_1.__decorate([
+        (0, common_1.Post)(':id/approval/resubmit'),
+        (0, response_message_decorator_1.Message)('resubmitted'),
+        (0, audit_log_decorator_1.Audit)({ action: 'RESUBMIT' }),
+        (0, swagger_1.ApiResponse)({ description: 'The updated approval status' }),
+        tslib_1.__param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+        tslib_1.__param(1, (0, nest_auth_1.CurrentUser)()),
+        tslib_1.__metadata("design:type", Function),
+        tslib_1.__metadata("design:paramtypes", [Number, Object]),
+        tslib_1.__metadata("design:returntype", void 0)
+    ], BaseController.prototype, "resubmitApproval", null);
     tslib_1.__decorate([
         (0, common_1.Delete)(':id'),
         (0, response_message_decorator_1.Message)('deleted'),

package/dist/lib/dtos/request-modification.dto.d.ts

@@ -0,0 +1,11 @@
+export declare class ModificationItemDto {
+    field: string;
+    currentValue?: unknown;
+    wantedValue: unknown;
+    note?: string;
+}
+export declare class RequestModificationDto {
+    modifications: ModificationItemDto[];
+    note?: string;
+}
+//# sourceMappingURL=request-modification.dto.d.ts.map

package/dist/lib/dtos/request-modification.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-modification.dto.d.ts","sourceRoot":"","sources":["../../../src/lib/dtos/request-modification.dto.ts"],"names":[],"mappings":"AAWA,qBAAa,mBAAmB;IAG9B,KAAK,EAAG,MAAM,CAAC;IAOf,YAAY,CAAC,EAAE,OAAO,CAAC;IAIvB,WAAW,EAAG,OAAO,CAAC;IAKtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,sBAAsB;IASjC,aAAa,EAAG,mBAAmB,EAAE,CAAC;IAQtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/lib/dtos/request-modification.dto.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestModificationDto = exports.ModificationItemDto = void 0;
+const tslib_1 = require("tslib");
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+class ModificationItemDto {
+}
+exports.ModificationItemDto = ModificationItemDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Entity field to modify, e.g. "title"' }),
+    (0, class_validator_1.IsString)(),
+    tslib_1.__metadata("design:type", String)
+], ModificationItemDto.prototype, "field", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Value currently stored on the record (captured at request time)',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    tslib_1.__metadata("design:type", Object)
+], ModificationItemDto.prototype, "currentValue", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Value the reviewer wants instead' }),
+    (0, class_validator_1.IsDefined)(),
+    tslib_1.__metadata("design:type", Object)
+], ModificationItemDto.prototype, "wantedValue", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Optional explanation', required: false }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    tslib_1.__metadata("design:type", String)
+], ModificationItemDto.prototype, "note", void 0);
+class RequestModificationDto {
+}
+exports.RequestModificationDto = RequestModificationDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'List of requested modifications',
+        type: [ModificationItemDto],
+    }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ModificationItemDto),
+    tslib_1.__metadata("design:type", Array)
+], RequestModificationDto.prototype, "modifications", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Optional overall note explaining the requested changes',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    tslib_1.__metadata("design:type", String)
+], RequestModificationDto.prototype, "note", void 0);

package/dist/lib/entities/approval-status.entity.d.ts

@@ -0,0 +1,29 @@
+import type { ModificationItem } from '../interfaces/approval-pipeline.interface';
+/**
+ * Tracks the approval lifecycle of a created record. One row per approved-or-
+ * pending entity, polymorphically referencing the target row via the table
+ * name (`entity`) and its primary key (`entityId`).
+ */
+export declare class ApprovalStatusEntity {
+    id: number;
+    /** Target table name, e.g. 'posts'. */
+    entity: string;
+    /** Stringified primary key of the target row (works for int and uuid). */
+    entityId: string;
+    /** pending | approved | rejected | modification_requested | resubmitted */
+    status: string;
+    /** User who submitted the record for approval. */
+    requestedBy?: string | null;
+    requestedAt: Date;
+    /** Active list of requested modifications: { field, wantedValue, ... }. */
+    currentModifications?: ModificationItem[] | null;
+    /** User who approved or rejected the record. */
+    decidedBy?: string | null;
+    decidedAt?: Date | null;
+    /** User who resubmitted the record after modifications. */
+    resubmittedBy?: string | null;
+    resubmittedAt?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=approval-status.entity.d.ts.map

package/dist/lib/entities/approval-status.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-status.entity.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/approval-status.entity.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAElF;;;;GAIG;AACH,qBACa,oBAAoB;IAE/B,EAAE,EAAG,MAAM,CAAC;IAEZ,uCAAuC;IAGvC,MAAM,EAAG,MAAM,CAAC;IAEhB,0EAA0E;IAG1E,QAAQ,EAAG,MAAM,CAAC;IAElB,2EAA2E;IAG3E,MAAM,EAAG,MAAM,CAAC;IAEhB,kDAAkD;IAGlD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B,WAAW,EAAG,IAAI,CAAC;IAEnB,2EAA2E;IAE3E,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAEjD,gDAAgD;IAEhD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAExB,2DAA2D;IAE3D,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,aAAa,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAG5B,SAAS,EAAG,IAAI,CAAC;IAGjB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/lib/entities/approval-status.entity.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalStatusEntity = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+/**
+ * Tracks the approval lifecycle of a created record. One row per approved-or-
+ * pending entity, polymorphically referencing the target row via the table
+ * name (`entity`) and its primary key (`entityId`).
+ */
+let ApprovalStatusEntity = class ApprovalStatusEntity {
+};
+exports.ApprovalStatusEntity = ApprovalStatusEntity;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)(),
+    tslib_1.__metadata("design:type", Number)
+], ApprovalStatusEntity.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)(),
+    tslib_1.__metadata("design:type", String)
+], ApprovalStatusEntity.prototype, "entity", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)(),
+    tslib_1.__metadata("design:type", String)
+], ApprovalStatusEntity.prototype, "entityId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ default: 'pending' }),
+    tslib_1.__metadata("design:type", String)
+], ApprovalStatusEntity.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ type: 'varchar', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalStatusEntity.prototype, "requestedBy", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    tslib_1.__metadata("design:type", Date)
+], ApprovalStatusEntity.prototype, "requestedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalStatusEntity.prototype, "currentModifications", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalStatusEntity.prototype, "decidedBy", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'timestamptz', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalStatusEntity.prototype, "decidedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalStatusEntity.prototype, "resubmittedBy", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'timestamptz', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalStatusEntity.prototype, "resubmittedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    tslib_1.__metadata("design:type", Date)
+], ApprovalStatusEntity.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)({ type: 'timestamptz' }),
+    tslib_1.__metadata("design:type", Date)
+], ApprovalStatusEntity.prototype, "updatedAt", void 0);
+exports.ApprovalStatusEntity = ApprovalStatusEntity = tslib_1.__decorate([
+    (0, typeorm_1.Entity)('approval_statuses')
+], ApprovalStatusEntity);

package/dist/lib/entities/modification-request-history.entity.d.ts

@@ -0,0 +1,20 @@
+import type { ModificationItem } from '../interfaces/approval-pipeline.interface';
+import { ApprovalStatusEntity } from './approval-status.entity';
+/**
+ * Immutable record of every modification request ever made against an
+ * approval status. A new row is appended each time modifications are
+ * requested.
+ */
+export declare class ModificationRequestHistoryEntity {
+    id: number;
+    approvalStatus: ApprovalStatusEntity;
+    approvalStatusId: number;
+    /** The requested modifications: { field, wantedValue, ... }. */
+    modifications: ModificationItem[];
+    /** User who requested the modifications. */
+    requestedBy?: string | null;
+    /** Optional overall note explaining the requested changes. */
+    note?: string | null;
+    requestedAt: Date;
+}
+//# sourceMappingURL=modification-request-history.entity.d.ts.map

package/dist/lib/entities/modification-request-history.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modification-request-history.entity.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/modification-request-history.entity.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;GAIG;AACH,qBACa,gCAAgC;IAE3C,EAAE,EAAG,MAAM,CAAC;IAKZ,cAAc,EAAG,oBAAoB,CAAC;IAGtC,gBAAgB,EAAG,MAAM,CAAC;IAE1B,gEAAgE;IAEhE,aAAa,EAAG,gBAAgB,EAAE,CAAC;IAEnC,4CAA4C;IAG5C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,8DAA8D;IAE9D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,WAAW,EAAG,IAAI,CAAC;CACpB"}

package/dist/lib/entities/modification-request-history.entity.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModificationRequestHistoryEntity = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const approval_status_entity_1 = require("./approval-status.entity");
+/**
+ * Immutable record of every modification request ever made against an
+ * approval status. A new row is appended each time modifications are
+ * requested.
+ */
+let ModificationRequestHistoryEntity = class ModificationRequestHistoryEntity {
+};
+exports.ModificationRequestHistoryEntity = ModificationRequestHistoryEntity;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)(),
+    tslib_1.__metadata("design:type", Number)
+], ModificationRequestHistoryEntity.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.ManyToOne)(() => approval_status_entity_1.ApprovalStatusEntity, { onDelete: 'CASCADE' }),
+    (0, typeorm_1.JoinColumn)({ name: 'approvalStatusId' }),
+    tslib_1.__metadata("design:type", approval_status_entity_1.ApprovalStatusEntity)
+], ModificationRequestHistoryEntity.prototype, "approvalStatus", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ name: 'approvalStatusId' }),
+    tslib_1.__metadata("design:type", Number)
+], ModificationRequestHistoryEntity.prototype, "approvalStatusId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb' }),
+    tslib_1.__metadata("design:type", Array)
+], ModificationRequestHistoryEntity.prototype, "modifications", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ type: 'varchar', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ModificationRequestHistoryEntity.prototype, "requestedBy", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ModificationRequestHistoryEntity.prototype, "note", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    tslib_1.__metadata("design:type", Date)
+], ModificationRequestHistoryEntity.prototype, "requestedAt", void 0);
+exports.ModificationRequestHistoryEntity = ModificationRequestHistoryEntity = tslib_1.__decorate([
+    (0, typeorm_1.Entity)('approval_modification_history')
+], ModificationRequestHistoryEntity);

package/dist/lib/interfaces/approval-pipeline.interface.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Lifecycle of an approval status row.
+ *
+ *   pending ──────────> approved
+ *      │  └───────────> rejected
+ *      └─> modification_requested ──> resubmitted ──> approved / rejected
+ *                 │                                    │
+ *                 └────────────────────────────────────┘
+ *               (modifications may be requested again)
+ */
+export declare const APPROVAL_STATUS: {
+    readonly pending: "pending";
+    readonly approved: "approved";
+    readonly rejected: "rejected";
+    readonly modificationRequested: "modification_requested";
+    readonly resubmitted: "resubmitted";
+};
+export type ApprovalStatus = (typeof APPROVAL_STATUS)[keyof typeof APPROVAL_STATUS];
+/**
+ * A single requested modification on a pending record. Each item names the
+ * field to change and the value the reviewer wants instead.
+ */
+export interface ModificationItem {
+    /** Entity field to modify, e.g. 'title'. */
+    field: string;
+    /** Value currently stored on the record (captured at request time). */
+    currentValue?: unknown;
+    /** Value the reviewer wants instead. */
+    wantedValue: unknown;
+    /** Optional human-readable explanation. */
+    note?: string;
+}
+export interface ApprovalStatusView {
+    id: number;
+    entity: string;
+    entityId: string;
+    status: ApprovalStatus;
+    requestedBy?: string | null;
+    requestedAt: Date;
+    currentModifications?: ModificationItem[] | null;
+    decidedBy?: string | null;
+    decidedAt?: Date | null;
+    resubmittedBy?: string | null;
+    resubmittedAt?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface ApprovalHistoryView {
+    id: number;
+    approvalStatusId: number;
+    modifications: ModificationItem[];
+    requestedBy?: string | null;
+    requestedAt: Date;
+    note?: string | null;
+}
+export interface ApprovalPipelinePermissions {
+    /** Required permission to approve (pending/resubmitted -> approved). */
+    approve?: string;
+    /** Required permission to reject (pending/resubmitted -> rejected). */
+    reject?: string;
+    /** Required permission to request modifications. */
+    requestModification?: string;
+    /** Required permission to resubmit after modifications. */
+    resubmit?: string;
+}
+export interface ApprovalPipelineConfig {
+    /**
+     * When true, every created record also gets a pending approval status row
+     * (created in the same transaction). Defaults to true when the option is
+     * provided.
+     */
+    enabled?: boolean;
+    /**
+     * Optional permission strings required to perform each action. When unset,
+     * the action is allowed for any authenticated (or anonymous) caller.
+     */
+    permissions?: ApprovalPipelinePermissions;
+    /**
+     * When set, read endpoints (findAll / findOne / findMine /
+     * findAllWithCursor) only return records whose approval status is in this
+     * list, e.g. ['approved']. When unset, all records are visible regardless
+     * of approval state.
+     */
+    visibleStatuses?: readonly ApprovalStatus[];
+}
+export interface RequestModificationPayload {
+    modifications: ModificationItem[];
+    note?: string;
+}
+//# sourceMappingURL=approval-pipeline.interface.d.ts.map

package/dist/lib/interfaces/approval-pipeline.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-pipeline.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/approval-pipeline.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,IAAI,CAAC;IAClB,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,IAAI,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAE1C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/lib/interfaces/approval-pipeline.interface.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPROVAL_STATUS = void 0;
+/**
+ * Lifecycle of an approval status row.
+ *
+ *   pending ──────────> approved
+ *      │  └───────────> rejected
+ *      └─> modification_requested ──> resubmitted ──> approved / rejected
+ *                 │                                    │
+ *                 └────────────────────────────────────┘
+ *               (modifications may be requested again)
+ */
+exports.APPROVAL_STATUS = {
+    pending: 'pending',
+    approved: 'approved',
+    rejected: 'rejected',
+    modificationRequested: 'modification_requested',
+    resubmitted: 'resubmitted',
+};

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

@@ -3,7 +3,8 @@ import { PaginationDto } from '../dtos/pagination.dto';
 import { CursorPaginationDto } from '../dtos/cursor-pagination.dto';
 import { OwnershipUser } from './find-mine.interface';
 import { StatusValue } from './status-pipeline.interface';
-export type CrudEndpoint = 'findAll' | 'findOne' | 'create' | 'update' | 'changeStatus' | 'remove' | 'findAuditLogs' | 'findMine';
+import { ApprovalHistoryView, ApprovalStatusView, RequestModificationPayload } from './approval-pipeline.interface';
+export type CrudEndpoint = 'findAll' | 'findOne' | 'create' | 'update' | 'changeStatus' | 'remove' | 'findAuditLogs' | 'findMine' | 'getApproval' | 'approveApproval' | 'rejectApproval' | 'requestModification' | 'resubmitApproval';
 export interface AuditLogQuery {
     user_id?: string;
     start_date?: string;
@@ -37,5 +38,13 @@ export interface CrudInterface<CreateDto, UpdateDto, ResponseDto> {
         data: ResponseDto[];
         meta?: unknown;
     }>;
+    getApproval?(id: number, user?: OwnershipUser): Promise<{
+        approval: ApprovalStatusView;
+        history: ApprovalHistoryView[];
+    }>;
+    approveApproval?(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    rejectApproval?(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    requestModification?(id: number, dto: RequestModificationPayload, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    resubmitApproval?(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
 }
 //# sourceMappingURL=crud.interface.d.ts.map

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

@@ -1 +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;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,eAAe,GACf,UAAU,CAAC;AAEf,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,sBAAsB,CAAC,CAAC;IACvC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;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,iBAAiB,CAAC,CAChB,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC;IAEhD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEhE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE/E,YAAY,CAAC,CACX,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,aAAa,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvD,QAAQ,CAAC,CACP,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrD"}
+{"version":3,"file":"crud.interface.d.ts","sourceRoot":"","sources":["../../../src/lib/interfaces/crud.interface.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -5,13 +5,21 @@ const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
 const typeorm_1 = require("@nestjs/typeorm");
 const audit_log_entity_1 = require("./entities/audit-log.entity");
+const approval_status_entity_1 = require("./entities/approval-status.entity");
+const modification_request_history_entity_1 = require("./entities/modification-request-history.entity");
 const audit_log_service_1 = require("./services/audit-log.service");
 let NestCrudModule = class NestCrudModule {
 };
 exports.NestCrudModule = NestCrudModule;
 exports.NestCrudModule = NestCrudModule = tslib_1.__decorate([
     (0, common_1.Module)({
-        imports: [typeorm_1.TypeOrmModule.forFeature([audit_log_entity_1.AuditLogEntity])],
+        imports: [
+            typeorm_1.TypeOrmModule.forFeature([
+                audit_log_entity_1.AuditLogEntity,
+                approval_status_entity_1.ApprovalStatusEntity,
+                modification_request_history_entity_1.ModificationRequestHistoryEntity,
+            ]),
+        ],
         providers: [audit_log_service_1.AuditService],
         exports: [audit_log_service_1.AuditService],
     })

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

@@ -9,6 +9,7 @@ import { CursorStrategy } from '../interfaces/cursor-strategy.interface';
 import { CrudHooks, TransactionConfig } from '../interfaces/hooks.interface';
 import { FindMineConfig, OwnershipUser } from '../interfaces/find-mine.interface';
 import { StatusPipelineConfig, StatusTransitionAction, StatusValue } from '../interfaces/status-pipeline.interface';
+import { ApprovalPipelineConfig, ApprovalStatusView, ApprovalHistoryView, RequestModificationPayload } from '../interfaces/approval-pipeline.interface';
 export interface CrudServiceOptions<Entity extends ObjectLiteral, ResponseDto> extends FindMineConfig<Entity> {
     repository: Repository<Entity>;
     allowedFilters?: readonly (keyof Entity | (string & {}))[];
@@ -27,6 +28,7 @@ export interface CrudServiceOptions<Entity extends ObjectLiteral, ResponseDto> e
     hooks?: CrudHooks<Entity, any, any>;
     transactionConfig?: TransactionConfig;
     statusPipeline?: StatusPipelineConfig<Entity>;
+    approvalPipeline?: ApprovalPipelineConfig;
 }
 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>;
@@ -60,6 +62,7 @@ export declare class NestCrudService<Entity extends ObjectLiteral, CreateDto = P
         permission?: string;
         action?: StatusTransitionAction<Entity>;
     }>;
+    protected readonly approvalPipeline?: ApprovalPipelineConfig;
     constructor(options: CrudServiceOptions<Entity, ResponseDto>);
     private normalizeStatusTransitions;
     private resolveRelations;
@@ -99,6 +102,28 @@ export declare class NestCrudService<Entity extends ObjectLiteral, CreateDto = P
     create(payload: CreateDto, user?: OwnershipUser): Promise<ResponseDto>;
     update(id: number, payload: UpdateDto, user?: OwnershipUser): Promise<ResponseDto>;
     changeStatus(id: number, status: StatusValue, user?: OwnershipUser): Promise<ResponseDto>;
+    getApproval(id: number, user?: OwnershipUser): Promise<{
+        approval: ApprovalStatusView;
+        history: ApprovalHistoryView[];
+    }>;
+    approveApproval(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    rejectApproval(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    requestModification(id: number, payload: RequestModificationPayload, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    resubmitApproval(id: number, user?: OwnershipUser): Promise<ApprovalStatusView>;
+    private isApprovalPipelineConfigured;
+    private hasApprovalVisibilityFilter;
+    private getApprovalRepository;
+    private getHistoryRepository;
+    private createWithApproval;
+    private resolveEntityForApproval;
+    private loadApprovalStatus;
+    private transitionApproval;
+    private assertTransitionAllowed;
+    private userHasPermission;
+    private applyApprovalVisibility;
+    private approvalIdCastExpression;
+    private toApprovalStatusView;
+    private toApprovalHistoryView;
     private applyUpdateCore;
     remove(id: number, user?: OwnershipUser): Promise<boolean>;
     findAuditLogs(query: {

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

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

@@ -7,6 +7,9 @@ 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");
+const approval_status_entity_1 = require("../entities/approval-status.entity");
+const modification_request_history_entity_1 = require("../entities/modification-request-history.entity");
+const approval_pipeline_interface_1 = require("../interfaces/approval-pipeline.interface");
 let NestCrudService = class NestCrudService {
     constructor(options) {
         this.statusTransitions = new Map();
@@ -41,6 +44,7 @@ let NestCrudService = class NestCrudService {
         if (options.statusPipeline?.transitions) {
             this.statusTransitions = this.normalizeStatusTransitions(options.statusPipeline.transitions);
         }
+        this.approvalPipeline = options.approvalPipeline;
     }
     normalizeStatusTransitions(transitions) {
         const result = new Map();
@@ -318,6 +322,7 @@ let NestCrudService = class NestCrudService {
     async findAll(query) {
         const qb = this.repo.createQueryBuilder('e');
         this.applyIncludeJoins(qb);
+        this.applyApprovalVisibility(qb);
         (0, filter_helper_1.applyFilters)(qb, query.filter, this.allowedFilters, this.include);
         const paginationMeta = (0, pagination_helper_1.applyPagination)(qb, query);
         this.applyOrderBy(qb, query.orderBy, query.orderDirection === 'ASC' ? 'ASC' : 'DESC');
@@ -336,6 +341,7 @@ let NestCrudService = class NestCrudService {
         const qb = this.repo.createQueryBuilder('e');
         this.applyOwnershipCondition(qb, userId);
         this.applyIncludeJoins(qb);
+        this.applyApprovalVisibility(qb);
         (0, filter_helper_1.applyFilters)(qb, query.filter, this.allowedFilters, this.include);
         const paginationMeta = (0, pagination_helper_1.applyPagination)(qb, query);
         this.applyOrderBy(qb, query.orderBy, query.orderDirection === 'ASC' ? 'ASC' : 'DESC');
@@ -354,6 +360,7 @@ let NestCrudService = class NestCrudService {
         const qb = this.repo.createQueryBuilder('e');
         // Join relations
         this.applyIncludeJoins(qb);
+        this.applyApprovalVisibility(qb);
         // Apply filters
         (0, filter_helper_1.applyFilters)(qb, query.filter, this.allowedFilters, this.include);
         // Apply cursor filter
@@ -376,6 +383,7 @@ let NestCrudService = class NestCrudService {
             // Build a clean count query (reuse same filters but no cursor/order/take)
             const countQb = this.repo.createQueryBuilder('e');
             this.applyIncludeJoins(countQb, false);
+            this.applyApprovalVisibility(countQb);
             (0, filter_helper_1.applyFilters)(countQb, query.filter, this.allowedFilters, this.include);
             total = await countQb.getCount();
         }
@@ -398,6 +406,13 @@ let NestCrudService = class NestCrudService {
         if (this.enforceOwnershipFor(user)) {
             entity = await this.findOwnedEntity(id, user);
         }
+        else if (this.hasApprovalVisibilityFilter()) {
+            const qb = this.repo.createQueryBuilder('e');
+            this.applyIncludeJoins(qb);
+            this.applyApprovalVisibility(qb);
+            qb.andWhere('e.id = :id', { id });
+            entity = await qb.getOne();
+        }
         else {
             const relationsObj = this.include.length > 0
                 ? this.buildRelationsObject(this.include)
@@ -448,7 +463,9 @@ let NestCrudService = class NestCrudService {
         await this.executeHook(this.hooks.beforeCreate, { payload });
         const payloadSnapshot = { ...payload };
         const resolved = await this.resolveRelations(payload);
-        const entity = await this.repo.save(resolved);
+        const entity = this.isApprovalPipelineConfigured()
+            ? await this.createWithApproval(resolved, user)
+            : await this.repo.save(resolved);
         const result = this.toResponseDto
             ? this.toResponseDto(entity)
             : entity;
@@ -465,6 +482,202 @@ let NestCrudService = class NestCrudService {
         const payload = { [String(this.statusField)]: status };
         return this.applyUpdateCore(id, payload, user);
     }
+    async getApproval(id, user) {
+        if (!this.isApprovalPipelineConfigured()) {
+            throw new common_1.NotFoundException('Resource not found');
+        }
+        const approval = await this.loadApprovalStatus(id, user);
+        if (!approval) {
+            throw new common_1.NotFoundException('Resource not found');
+        }
+        const history = await this.getHistoryRepository().find({
+            where: { approvalStatusId: approval.id },
+            order: { requestedAt: 'DESC' },
+        });
+        return {
+            approval: this.toApprovalStatusView(approval),
+            history: history.map((entry) => this.toApprovalHistoryView(entry)),
+        };
+    }
+    async approveApproval(id, user) {
+        return this.transitionApproval(id, 'approve', user);
+    }
+    async rejectApproval(id, user) {
+        return this.transitionApproval(id, 'reject', user);
+    }
+    async requestModification(id, payload, user) {
+        return this.transitionApproval(id, 'requestModification', user, payload.modifications, payload.note);
+    }
+    async resubmitApproval(id, user) {
+        return this.transitionApproval(id, 'resubmit', user);
+    }
+    isApprovalPipelineConfigured() {
+        return Boolean(this.approvalPipeline && this.approvalPipeline.enabled !== false);
+    }
+    hasApprovalVisibilityFilter() {
+        if (!this.isApprovalPipelineConfigured()) {
+            return false;
+        }
+        const visible = this.approvalPipeline?.visibleStatuses;
+        return Boolean(visible && visible.length > 0);
+    }
+    getApprovalRepository() {
+        return this.repo.manager.getRepository(approval_status_entity_1.ApprovalStatusEntity);
+    }
+    getHistoryRepository() {
+        return this.repo.manager.getRepository(modification_request_history_entity_1.ModificationRequestHistoryEntity);
+    }
+    async createWithApproval(resolved, user) {
+        const entity = await this.repo.manager.transaction(async (manager) => {
+            const entityRepo = manager.getRepository(this.repo.target);
+            const saved = await entityRepo.save(resolved);
+            const approvalRepo = manager.getRepository(approval_status_entity_1.ApprovalStatusEntity);
+            const approval = approvalRepo.create({
+                entity: this.repo.metadata.tableName,
+                entityId: String(saved.id),
+                status: approval_pipeline_interface_1.APPROVAL_STATUS.pending,
+                requestedBy: user?.id != null ? String(user.id) : null,
+            });
+            await approvalRepo.save(approval);
+            return saved;
+        });
+        return entity;
+    }
+    async resolveEntityForApproval(id, user) {
+        if (this.enforceOwnershipFor(user)) {
+            return this.findOwnedEntity(id, user);
+        }
+        return this.repo.findOneBy({ id });
+    }
+    async loadApprovalStatus(id, user) {
+        const entity = await this.resolveEntityForApproval(id, user);
+        if (!entity) {
+            return null;
+        }
+        const approval = await this.getApprovalRepository().findOneBy({
+            entity: this.repo.metadata.tableName,
+            entityId: String(id),
+        });
+        return approval ?? null;
+    }
+    async transitionApproval(id, action, user, modifications, note) {
+        if (!this.isApprovalPipelineConfigured()) {
+            throw new common_1.NotFoundException('Resource not found');
+        }
+        const permission = this.approvalPipeline?.permissions?.[action];
+        if (permission && !this.userHasPermission(user, permission)) {
+            throw new common_1.ForbiddenException(`Missing required permission '${permission}' for ${action}`);
+        }
+        const approval = await this.loadApprovalStatus(id, user);
+        if (!approval) {
+            throw new common_1.NotFoundException('Resource not found');
+        }
+        const current = approval.status;
+        const now = new Date();
+        const userId = user?.id != null ? String(user.id) : null;
+        const transitionable = [
+            approval_pipeline_interface_1.APPROVAL_STATUS.pending,
+            approval_pipeline_interface_1.APPROVAL_STATUS.resubmitted,
+        ];
+        switch (action) {
+            case 'approve':
+                this.assertTransitionAllowed(action, current, transitionable);
+                approval.status = approval_pipeline_interface_1.APPROVAL_STATUS.approved;
+                approval.decidedBy = userId;
+                approval.decidedAt = now;
+                approval.currentModifications = null;
+                break;
+            case 'reject':
+                this.assertTransitionAllowed(action, current, transitionable);
+                approval.status = approval_pipeline_interface_1.APPROVAL_STATUS.rejected;
+                approval.decidedBy = userId;
+                approval.decidedAt = now;
+                approval.currentModifications = null;
+                break;
+            case 'requestModification':
+                this.assertTransitionAllowed(action, current, transitionable);
+                approval.status = approval_pipeline_interface_1.APPROVAL_STATUS.modificationRequested;
+                approval.currentModifications = modifications ?? [];
+                await this.getHistoryRepository().save(this.getHistoryRepository().create({
+                    approvalStatusId: approval.id,
+                    modifications: modifications ?? [],
+                    requestedBy: userId,
+                    note: note ?? null,
+                }));
+                break;
+            case 'resubmit':
+                if (current !== approval_pipeline_interface_1.APPROVAL_STATUS.modificationRequested) {
+                    throw new common_1.BadRequestException(`Cannot resubmit approval from status '${current}'`);
+                }
+                approval.status = approval_pipeline_interface_1.APPROVAL_STATUS.resubmitted;
+                approval.currentModifications = null;
+                approval.resubmittedBy = userId;
+                approval.resubmittedAt = now;
+                break;
+        }
+        const saved = await this.getApprovalRepository().save(approval);
+        return this.toApprovalStatusView(saved);
+    }
+    assertTransitionAllowed(action, current, allowedFrom) {
+        if (!allowedFrom.includes(current)) {
+            throw new common_1.BadRequestException(`Cannot ${action} approval from status '${current}'`);
+        }
+    }
+    userHasPermission(user, permission) {
+        if (!user) {
+            return false;
+        }
+        const permissions = this.resolveUserPermissions(user);
+        return permissions.includes(permission);
+    }
+    applyApprovalVisibility(qb) {
+        if (!this.hasApprovalVisibilityFilter()) {
+            return;
+        }
+        const visible = this.approvalPipeline?.visibleStatuses;
+        const tableName = this.repo.metadata.tableName;
+        qb.innerJoin(approval_status_entity_1.ApprovalStatusEntity, 'approvalStatus', `approvalStatus.entity = :approvalEntityName AND approvalStatus.entityId = ${this.approvalIdCastExpression()} AND approvalStatus.status IN (:...approvalVisibleStatuses)`, {
+            approvalEntityName: tableName,
+            approvalVisibleStatuses: [...visible],
+        });
+    }
+    approvalIdCastExpression() {
+        const type = this.repo.manager.connection.options.type;
+        if (type === 'mysql' || type === 'mariadb' || type === 'aurora-mysql') {
+            return 'CAST(e.id AS CHAR)';
+        }
+        if (type === 'better-sqlite3' || type === 'sqljs' || type === 'capacitor') {
+            return 'CAST(e.id AS TEXT)';
+        }
+        return 'CAST(e.id AS varchar)';
+    }
+    toApprovalStatusView(entity) {
+        return {
+            id: entity.id,
+            entity: entity.entity,
+            entityId: entity.entityId,
+            status: entity.status,
+            requestedBy: entity.requestedBy,
+            requestedAt: entity.requestedAt,
+            currentModifications: entity.currentModifications,
+            decidedBy: entity.decidedBy,
+            decidedAt: entity.decidedAt,
+            resubmittedBy: entity.resubmittedBy,
+            resubmittedAt: entity.resubmittedAt,
+            createdAt: entity.createdAt,
+            updatedAt: entity.updatedAt,
+        };
+    }
+    toApprovalHistoryView(entity) {
+        return {
+            id: entity.id,
+            approvalStatusId: entity.approvalStatusId,
+            modifications: entity.modifications,
+            requestedBy: entity.requestedBy,
+            note: entity.note,
+            requestedAt: entity.requestedAt,
+        };
+    }
     async applyUpdateCore(id, payload, user) {
         let existing;
         if (this.enforceOwnershipFor(user)) {

package/dist/lib/testing/mock-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-repository.d.ts","sourceRoot":"","sources":["../../../src/lib/testing/mock-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,YAAY,IAAI,gBAAgB,CAgB/C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,aAAa,EAChE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GACpD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAiClC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,SAAS,aAAa,EACnE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GACpB,OAAO,CAuCT"}
+{"version":3,"file":"mock-repository.d.ts","sourceRoot":"","sources":["../../../src/lib/testing/mock-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,YAAY,IAAI,gBAAgB,CAiB/C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,aAAa,EAChE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GACpD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAkClC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,SAAS,aAAa,EACnE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GACpB,OAAO,CAuCT"}

package/dist/lib/testing/mock-repository.js

@@ -7,6 +7,7 @@ function createMockQb() {
     const qb = {
         where: jest.fn().mockReturnThis(),
         andWhere: jest.fn().mockReturnThis(),
+        innerJoin: jest.fn().mockReturnThis(),
         leftJoinAndSelect: jest.fn().mockReturnThis(),
         leftJoin: jest.fn().mockReturnThis(),
         orderBy: jest.fn().mockReturnThis(),
@@ -33,6 +34,7 @@ function createMockRepository(entity, overrides) {
         find: jest.fn().mockResolvedValue([mockEntity]),
         metadata: {
             name: entity.name,
+            tableName: entity.name.toLowerCase(),
             primaryColumns: [{ propertyPath: 'id', type: () => Number }],
         },
         manager: {

package/dist/lib/testing/testing.interface.d.ts

@@ -39,6 +39,7 @@ export interface CrudTestContext {
 export interface MockQueryBuilder {
     where: jest.Mock;
     andWhere: jest.Mock;
+    innerJoin: jest.Mock;
     leftJoinAndSelect: jest.Mock;
     leftJoin: jest.Mock;
     orderBy: jest.Mock;

package/dist/lib/testing/testing.interface.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nest-util/nest-crud",
-  "version": "1.1.5",
+  "version": "1.2.2",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",