@venturialstd/audit 0.0.2

package/dist/audit.module.d.ts

@@ -0,0 +1,17 @@
+import { DynamicModule, InjectionToken } from '@nestjs/common';
+import { type IAuditUserLookup } from './services/audit-query.service';
+export interface AuditModuleOptions {
+    /** Optional: join with users table when querying with details (actorType 'user') */
+    userLookup?: IAuditUserLookup;
+}
+export interface AuditModuleAsyncOptions {
+    imports?: DynamicModule['imports'];
+    inject?: InjectionToken[];
+    useFactory: (...args: unknown[]) => AuditModuleOptions | Promise<AuditModuleOptions>;
+}
+export declare class AuditModule {
+    static forRoot(options?: AuditModuleOptions): DynamicModule;
+    static forRootAsync(asyncOptions: AuditModuleAsyncOptions): DynamicModule;
+    static forFeature(): DynamicModule;
+}
+//# sourceMappingURL=audit.module.d.ts.map

package/dist/audit.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.module.d.ts","sourceRoot":"","sources":["../src/audit.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAU,MAAM,gBAAgB,CAAC;AAMvE,OAAO,EAAwC,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAG7G,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACtF;AAED,qBACa,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa;IAgB/D,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,uBAAuB,GAAG,aAAa;IAwBzE,MAAM,CAAC,UAAU,IAAI,aAAa;CAGnC"}

package/dist/audit.module.js

@@ -0,0 +1,64 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var AuditModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditModule = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const audit_controller_1 = require("./controllers/audit.controller");
+const audit_log_change_entity_1 = require("./entities/audit-log-change.entity");
+const audit_log_entity_1 = require("./entities/audit-log.entity");
+const audit_query_service_1 = require("./services/audit-query.service");
+const audit_service_1 = require("./services/audit.service");
+let AuditModule = AuditModule_1 = class AuditModule {
+    static forRoot(options = {}) {
+        const providers = [
+            audit_service_1.AuditService,
+            audit_query_service_1.AuditQueryService,
+            { provide: audit_query_service_1.AUDIT_USER_LOOKUP, useValue: options.userLookup ?? null },
+        ];
+        return {
+            module: AuditModule_1,
+            imports: [typeorm_1.TypeOrmModule.forFeature([audit_log_entity_1.AuditLog, audit_log_change_entity_1.AuditLogChange])],
+            controllers: [audit_controller_1.AuditController],
+            providers,
+            exports: [audit_service_1.AuditService, audit_query_service_1.AuditQueryService],
+        };
+    }
+    static forRootAsync(asyncOptions) {
+        return {
+            module: AuditModule_1,
+            imports: [
+                ...(asyncOptions.imports ?? []),
+                typeorm_1.TypeOrmModule.forFeature([audit_log_entity_1.AuditLog, audit_log_change_entity_1.AuditLogChange]),
+            ],
+            controllers: [audit_controller_1.AuditController],
+            providers: [
+                audit_service_1.AuditService,
+                audit_query_service_1.AuditQueryService,
+                {
+                    provide: audit_query_service_1.AUDIT_USER_LOOKUP,
+                    useFactory: async (...args) => {
+                        const options = await Promise.resolve(asyncOptions.useFactory(...args));
+                        return options.userLookup ?? null;
+                    },
+                    inject: asyncOptions.inject ?? [],
+                },
+            ],
+            exports: [audit_service_1.AuditService, audit_query_service_1.AuditQueryService],
+        };
+    }
+    static forFeature() {
+        return AuditModule_1.forRoot({});
+    }
+};
+exports.AuditModule = AuditModule;
+exports.AuditModule = AuditModule = AuditModule_1 = __decorate([
+    (0, common_1.Module)({})
+], AuditModule);
+//# sourceMappingURL=audit.module.js.map

package/dist/audit.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.module.js","sourceRoot":"","sources":["../src/audit.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuE;AACvE,6CAAgD;AAEhD,qEAAiE;AACjE,gFAAoE;AACpE,kEAAuD;AACvD,wEAA6G;AAC7G,4DAAwD;AAcjD,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,UAA8B,EAAE;QAC7C,MAAM,SAAS,GAA+B;YAC5C,4BAAY;YACZ,uCAAiB;YACjB,EAAE,OAAO,EAAE,uCAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE;SACrE,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,OAAO,EAAE,CAAC,uBAAa,CAAC,UAAU,CAAC,CAAC,2BAAQ,EAAE,wCAAc,CAAC,CAAC,CAAC;YAC/D,WAAW,EAAE,CAAC,kCAAe,CAAC;YAC9B,SAAS;YACT,OAAO,EAAE,CAAC,4BAAY,EAAE,uCAAiB,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,YAAqC;QACvD,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,OAAO,EAAE;gBACP,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC/B,uBAAa,CAAC,UAAU,CAAC,CAAC,2BAAQ,EAAE,wCAAc,CAAC,CAAC;aACrD;YACD,WAAW,EAAE,CAAC,kCAAe,CAAC;YAC9B,SAAS,EAAE;gBACT,4BAAY;gBACZ,uCAAiB;gBACjB;oBACE,OAAO,EAAE,uCAAiB;oBAC1B,UAAU,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;wBACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;wBACxE,OAAO,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;oBACpC,CAAC;oBACD,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,EAAE;iBAClC;aACF;YACD,OAAO,EAAE,CAAC,4BAAY,EAAE,uCAAiB,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU;QACf,OAAO,aAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;CACF,CAAA;AA5CY,kCAAW;sBAAX,WAAW;IADvB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,WAAW,CA4CvB"}

package/dist/constants/audit.constant.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Actor types for the Flexible Actor Model (ID-Only).
+ * Used by audit logs to identify who performed an action without duplicating data.
+ */
+export declare const ACTOR_TYPE: {
+    readonly USER: "user";
+    readonly SYSTEM: "system";
+    readonly EXTERNAL: "external";
+    readonly AUTOMATION: "automation";
+    readonly WEBHOOK: "webhook";
+};
+export type ActorType = (typeof ACTOR_TYPE)[keyof typeof ACTOR_TYPE];
+export declare const AUDIT_LOG_STATUS: {
+    readonly SUCCESS: "success";
+    readonly FAILED: "failed";
+    readonly PENDING: "pending";
+};
+export type AuditLogStatus = (typeof AUDIT_LOG_STATUS)[keyof typeof AUDIT_LOG_STATUS];
+//# sourceMappingURL=audit.constant.d.ts.map

package/dist/constants/audit.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.constant.d.ts","sourceRoot":"","sources":["../../src/constants/audit.constant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/constants/audit.constant.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIT_LOG_STATUS = exports.ACTOR_TYPE = void 0;
+/**
+ * Actor types for the Flexible Actor Model (ID-Only).
+ * Used by audit logs to identify who performed an action without duplicating data.
+ */
+exports.ACTOR_TYPE = {
+    USER: 'user',
+    SYSTEM: 'system',
+    EXTERNAL: 'external',
+    AUTOMATION: 'automation',
+    WEBHOOK: 'webhook',
+};
+exports.AUDIT_LOG_STATUS = {
+    SUCCESS: 'success',
+    FAILED: 'failed',
+    PENDING: 'pending',
+};
+//# sourceMappingURL=audit.constant.js.map

package/dist/constants/audit.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.constant.js","sourceRoot":"","sources":["../../src/constants/audit.constant.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;CACV,CAAC;AAIE,QAAA,gBAAgB,GAAG;IAC9B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC"}

package/dist/controllers/audit.controller.d.ts

@@ -0,0 +1,9 @@
+import { AuditQueryService, type AuditLogWithActor } from '../services/audit-query.service';
+import type { AuditLog } from '../entities/audit-log.entity';
+export declare class AuditController {
+    private readonly auditQueryService;
+    constructor(auditQueryService: AuditQueryService);
+    getLogs(actorType?: string, actorId?: string, entityType?: string, entityId?: string, action?: string, from?: string, to?: string, withDetails?: string, limit?: string, offset?: string): Promise<AuditLogWithActor[] | AuditLog[]>;
+    getLogsByActor(actorType: string, actorId: string, withDetails?: string, limit?: string, offset?: string): Promise<AuditLogWithActor[] | AuditLog[]>;
+}
+//# sourceMappingURL=audit.controller.d.ts.map

package/dist/controllers/audit.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/audit.controller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,qBAEa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,iBAAiB;IAU3D,OAAO,CACS,SAAS,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACF,WAAW,CAAC,EAAE,MAAM,EAC1B,KAAK,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,iBAAiB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAsBtC,cAAc,CACE,SAAS,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EAC1B,KAAK,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,iBAAiB,EAAE,GAAG,QAAQ,EAAE,CAAC;CAY7C"}

package/dist/controllers/audit.controller.js

@@ -0,0 +1,98 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const audit_query_service_1 = require("../services/audit-query.service");
+let AuditController = class AuditController {
+    auditQueryService;
+    constructor(auditQueryService) {
+        this.auditQueryService = auditQueryService;
+    }
+    async getLogs(actorType, actorId, entityType, entityId, action, from, to, withDetails, limit, offset) {
+        const filters = {
+            actorType,
+            actorId,
+            entityType,
+            entityId,
+            action,
+            limit: limit ? parseInt(limit, 10) : undefined,
+            offset: offset ? parseInt(offset, 10) : undefined,
+        };
+        if (from)
+            filters.from = new Date(from);
+        if (to)
+            filters.to = new Date(to);
+        if (withDetails === 'true' || withDetails === '1') {
+            return this.auditQueryService.queryWithActorDetails(filters);
+        }
+        return this.auditQueryService.query(filters);
+    }
+    async getLogsByActor(actorType, actorId, withDetails, limit, offset) {
+        const filters = {
+            actorType,
+            actorId,
+            limit: limit ? parseInt(limit, 10) : undefined,
+            offset: offset ? parseInt(offset, 10) : undefined,
+        };
+        if (withDetails === 'true' || withDetails === '1') {
+            return this.auditQueryService.queryWithActorDetails(filters);
+        }
+        return this.auditQueryService.query(filters);
+    }
+};
+exports.AuditController = AuditController;
+__decorate([
+    (0, common_1.Get)('logs'),
+    (0, swagger_1.ApiOperation)({ summary: 'Get audit logs with optional filters' }),
+    (0, swagger_1.ApiQuery)({ name: 'actorType', required: false }),
+    (0, swagger_1.ApiQuery)({ name: 'actorId', required: false }),
+    (0, swagger_1.ApiQuery)({ name: 'withDetails', required: false, type: Boolean }),
+    (0, swagger_1.ApiQuery)({ name: 'limit', required: false }),
+    (0, swagger_1.ApiQuery)({ name: 'offset', required: false }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'List of audit logs' }),
+    __param(0, (0, common_1.Query)('actorType')),
+    __param(1, (0, common_1.Query)('actorId')),
+    __param(2, (0, common_1.Query)('entityType')),
+    __param(3, (0, common_1.Query)('entityId')),
+    __param(4, (0, common_1.Query)('action')),
+    __param(5, (0, common_1.Query)('from')),
+    __param(6, (0, common_1.Query)('to')),
+    __param(7, (0, common_1.Query)('withDetails')),
+    __param(8, (0, common_1.Query)('limit')),
+    __param(9, (0, common_1.Query)('offset')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String, String, String, String, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], AuditController.prototype, "getLogs", null);
+__decorate([
+    (0, common_1.Get)('actor/:actorType/:actorId/logs'),
+    (0, swagger_1.ApiOperation)({ summary: 'Get audit logs for a specific actor' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'List of audit logs for the actor' }),
+    __param(0, (0, common_1.Param)('actorType')),
+    __param(1, (0, common_1.Param)('actorId')),
+    __param(2, (0, common_1.Query)('withDetails')),
+    __param(3, (0, common_1.Query)('limit')),
+    __param(4, (0, common_1.Query)('offset')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], AuditController.prototype, "getLogsByActor", null);
+exports.AuditController = AuditController = __decorate([
+    (0, swagger_1.ApiTags)('audit'),
+    (0, common_1.Controller)('audit'),
+    __metadata("design:paramtypes", [audit_query_service_1.AuditQueryService])
+], AuditController);
+//# sourceMappingURL=audit.controller.js.map

package/dist/controllers/audit.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.controller.js","sourceRoot":"","sources":["../../src/controllers/audit.controller.ts"],"names":[],"mappings":"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"}

package/dist/dtos/audit-log-params.dto.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Parameters for the generic audit log() method.
+ * Flexible Actor Model: actorType + actorId only; no duplicated actor data.
+ */
+export interface AuditLogChangeDto {
+    field: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+export interface AuditLogParams {
+    actorType: string;
+    actorId: string | null;
+    entityType: string;
+    entityId?: string | null;
+    action: string;
+    category?: string | null;
+    description?: string | null;
+    changes?: AuditLogChangeDto[];
+    ipAddress?: string | null;
+    userAgent?: string | null;
+    location?: string | null;
+    metadata?: Record<string, unknown> | null;
+    requestId?: string | null;
+    correlationId?: string | null;
+    status?: string;
+    errorMessage?: string | null;
+    expiresAt?: Date | null;
+}
+export interface AuditQueryFilters {
+    actorType?: string;
+    actorId?: string;
+    entityType?: string;
+    entityId?: string;
+    action?: string;
+    from?: Date;
+    to?: Date;
+    limit?: number;
+    offset?: number;
+}
+//# sourceMappingURL=audit-log-params.dto.d.ts.map

package/dist/dtos/audit-log-params.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-params.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/audit-log-params.dto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/dtos/audit-log-params.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=audit-log-params.dto.js.map

package/dist/dtos/audit-log-params.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-params.dto.js","sourceRoot":"","sources":["../../src/dtos/audit-log-params.dto.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,10 @@
+import { AuditLog } from './audit-log.entity';
+export declare class AuditLogChange {
+    id: string;
+    auditLogId: string;
+    auditLog: AuditLog;
+    field: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+//# sourceMappingURL=audit-log-change.entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-change.entity.d.ts","sourceRoot":"","sources":["../../src/entities/audit-log-change.entity.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,qBACa,cAAc;IAEzB,EAAE,EAAG,MAAM,CAAC;IAGZ,UAAU,EAAG,MAAM,CAAC;IAIpB,QAAQ,EAAG,QAAQ,CAAC;IAGpB,KAAK,EAAG,MAAM,CAAC;IAGf,QAAQ,EAAG,OAAO,CAAC;IAGnB,QAAQ,EAAG,OAAO,CAAC;CACpB"}

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

@@ -0,0 +1,52 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogChange = void 0;
+const typeorm_1 = require("typeorm");
+const audit_log_entity_1 = require("./audit-log.entity");
+let AuditLogChange = class AuditLogChange {
+    id;
+    auditLogId;
+    auditLog;
+    field;
+    oldValue;
+    newValue;
+};
+exports.AuditLogChange = AuditLogChange;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], AuditLogChange.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    __metadata("design:type", String)
+], AuditLogChange.prototype, "auditLogId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => audit_log_entity_1.AuditLog, (log) => log.changes, { onDelete: 'CASCADE' }),
+    (0, typeorm_1.JoinColumn)({ name: 'auditLogId' }),
+    __metadata("design:type", audit_log_entity_1.AuditLog)
+], AuditLogChange.prototype, "auditLog", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], AuditLogChange.prototype, "field", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb', nullable: true }),
+    __metadata("design:type", Object)
+], AuditLogChange.prototype, "oldValue", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb', nullable: true }),
+    __metadata("design:type", Object)
+], AuditLogChange.prototype, "newValue", void 0);
+exports.AuditLogChange = AuditLogChange = __decorate([
+    (0, typeorm_1.Entity)('audit_log_change')
+], AuditLogChange);
+//# sourceMappingURL=audit-log-change.entity.js.map

package/dist/entities/audit-log-change.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-change.entity.js","sourceRoot":"","sources":["../../src/entities/audit-log-change.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAMiB;AAEjB,yDAA8C;AAGvC,IAAM,cAAc,GAApB,MAAM,cAAc;IAEzB,EAAE,CAAU;IAGZ,UAAU,CAAU;IAIpB,QAAQ,CAAY;IAGpB,KAAK,CAAU;IAGf,QAAQ,CAAW;IAGnB,QAAQ,CAAW;CACpB,CAAA;AAnBY,wCAAc;AAEzB;IADC,IAAA,gCAAsB,EAAC,MAAM,CAAC;;0CACnB;AAGZ;IADC,IAAA,gBAAM,GAAE;;kDACW;AAIpB;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,2BAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACxE,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BACxB,2BAAQ;gDAAC;AAGpB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;6CAC1B;AAGf;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDACvB;AAGnB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDACvB;yBAlBR,cAAc;IAD1B,IAAA,gBAAM,EAAC,kBAAkB,CAAC;GACd,cAAc,CAmB1B"}

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

@@ -0,0 +1,36 @@
+import { AuditLogChange } from './audit-log-change.entity';
+export declare class AuditLog {
+    id: string;
+    /** WHO: type of actor (user, system, external, automation, webhook) */
+    actorType: string;
+    /** WHO: identifier for the actor (user UUID, external entity ID, automation name, etc.) */
+    actorId: string | null;
+    /** WHAT: type of entity affected (e.g. workflow, transaction, account) */
+    entityType: string;
+    /** WHAT: ID of the affected entity */
+    entityId: string | null;
+    /** Action performed (e.g. created, updated, deleted, login_success) */
+    action: string;
+    /** Optional category (e.g. security, workflow_management) */
+    category: string | null;
+    /** Optional detailed description */
+    description: string | null;
+    /** WHEN */
+    timestamp: Date;
+    /** WHERE: optional origin */
+    ipAddress: string | null;
+    userAgent: string | null;
+    location: string | null;
+    /** Field-level changes */
+    changes: AuditLogChange[];
+    /** Extra context (jsonb) */
+    metadata: Record<string, unknown> | null;
+    requestId: string | null;
+    correlationId: string | null;
+    /** Result of the action */
+    status: string;
+    errorMessage: string | null;
+    /** Optional retention: when this log can be purged */
+    expiresAt: Date | null;
+}
+//# sourceMappingURL=audit-log.entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.entity.d.ts","sourceRoot":"","sources":["../../src/entities/audit-log.entity.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,qBAKa,QAAQ;IAEnB,EAAE,EAAG,MAAM,CAAC;IAEZ,uEAAuE;IAGvE,SAAS,EAAG,MAAM,CAAC;IAEnB,2FAA2F;IAG3F,OAAO,EAAG,MAAM,GAAG,IAAI,CAAC;IAExB,0EAA0E;IAE1E,UAAU,EAAG,MAAM,CAAC;IAEpB,sCAAsC;IAEtC,QAAQ,EAAG,MAAM,GAAG,IAAI,CAAC;IAEzB,uEAAuE;IAEvE,MAAM,EAAG,MAAM,CAAC;IAEhB,6DAA6D;IAE7D,QAAQ,EAAG,MAAM,GAAG,IAAI,CAAC;IAEzB,oCAAoC;IAEpC,WAAW,EAAG,MAAM,GAAG,IAAI,CAAC;IAE5B,WAAW;IAEX,SAAS,EAAG,IAAI,CAAC;IAEjB,6BAA6B;IAE7B,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAG1B,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAG1B,QAAQ,EAAG,MAAM,GAAG,IAAI,CAAC;IAEzB,0BAA0B;IAE1B,OAAO,EAAG,cAAc,EAAE,CAAC;IAE3B,4BAA4B;IAE5B,QAAQ,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAG1C,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAG1B,aAAa,EAAG,MAAM,GAAG,IAAI,CAAC;IAE9B,2BAA2B;IAE3B,MAAM,EAAG,MAAM,CAAC;IAGhB,YAAY,EAAG,MAAM,GAAG,IAAI,CAAC;IAE7B,sDAAsD;IAEtD,SAAS,EAAG,IAAI,GAAG,IAAI,CAAC;CACzB"}

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

@@ -0,0 +1,135 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLog = void 0;
+const typeorm_1 = require("typeorm");
+const audit_log_change_entity_1 = require("./audit-log-change.entity");
+let AuditLog = class AuditLog {
+    id;
+    /** WHO: type of actor (user, system, external, automation, webhook) */
+    actorType;
+    /** WHO: identifier for the actor (user UUID, external entity ID, automation name, etc.) */
+    actorId;
+    /** WHAT: type of entity affected (e.g. workflow, transaction, account) */
+    entityType;
+    /** WHAT: ID of the affected entity */
+    entityId;
+    /** Action performed (e.g. created, updated, deleted, login_success) */
+    action;
+    /** Optional category (e.g. security, workflow_management) */
+    category;
+    /** Optional detailed description */
+    description;
+    /** WHEN */
+    timestamp;
+    /** WHERE: optional origin */
+    ipAddress;
+    userAgent;
+    location;
+    /** Field-level changes */
+    changes;
+    /** Extra context (jsonb) */
+    metadata;
+    requestId;
+    correlationId;
+    /** Result of the action */
+    status;
+    errorMessage;
+    /** Optional retention: when this log can be purged */
+    expiresAt;
+};
+exports.AuditLog = AuditLog;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], AuditLog.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ type: 'varchar', length: 50 }),
+    __metadata("design:type", String)
+], AuditLog.prototype, "actorType", void 0);
+__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "actorId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 100 }),
+    __metadata("design:type", String)
+], AuditLog.prototype, "entityType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "entityId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 100 }),
+    __metadata("design:type", String)
+], AuditLog.prototype, "action", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 100, nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "category", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "description", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], AuditLog.prototype, "timestamp", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 45, nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "ipAddress", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "userAgent", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "location", void 0);
+__decorate([
+    (0, typeorm_1.OneToMany)(() => audit_log_change_entity_1.AuditLogChange, (change) => change.auditLog, { cascade: true }),
+    __metadata("design:type", Array)
+], AuditLog.prototype, "changes", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb', nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "metadata", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "requestId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "correlationId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 50, default: 'success' }),
+    __metadata("design:type", String)
+], AuditLog.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'timestamptz', nullable: true }),
+    __metadata("design:type", Object)
+], AuditLog.prototype, "expiresAt", void 0);
+exports.AuditLog = AuditLog = __decorate([
+    (0, typeorm_1.Entity)('audit_logs'),
+    (0, typeorm_1.Index)(['actorType', 'actorId']),
+    (0, typeorm_1.Index)(['actorType', 'timestamp']),
+    (0, typeorm_1.Index)(['entityType', 'entityId']),
+    (0, typeorm_1.Index)(['timestamp'])
+], AuditLog);
+//# sourceMappingURL=audit-log.entity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.entity.js","sourceRoot":"","sources":["../../src/entities/audit-log.entity.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { ACTOR_TYPE, AUDIT_LOG_STATUS } from './constants/audit.constant';
+export type { ActorType, AuditLogStatus } from './constants/audit.constant';
+export { AuditController } from './controllers/audit.controller';
+export type { AuditLogChangeDto, AuditLogParams, AuditQueryFilters } from './dtos/audit-log-params.dto';
+export { AuditLogChange } from './entities/audit-log-change.entity';
+export { AuditLog } from './entities/audit-log.entity';
+export { AuditModule } from './audit.module';
+export type { AuditModuleOptions, AuditModuleAsyncOptions } from './audit.module';
+export { AUDIT_USER_LOOKUP, AuditQueryService, type IAuditUserLookup, type AuditLogWithActor, } from './services/audit-query.service';
+export { AuditService } from './services/audit.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditService = exports.AuditQueryService = exports.AUDIT_USER_LOOKUP = exports.AuditModule = exports.AuditLog = exports.AuditLogChange = exports.AuditController = exports.AUDIT_LOG_STATUS = exports.ACTOR_TYPE = void 0;
+var audit_constant_1 = require("./constants/audit.constant");
+Object.defineProperty(exports, "ACTOR_TYPE", { enumerable: true, get: function () { return audit_constant_1.ACTOR_TYPE; } });
+Object.defineProperty(exports, "AUDIT_LOG_STATUS", { enumerable: true, get: function () { return audit_constant_1.AUDIT_LOG_STATUS; } });
+var audit_controller_1 = require("./controllers/audit.controller");
+Object.defineProperty(exports, "AuditController", { enumerable: true, get: function () { return audit_controller_1.AuditController; } });
+var audit_log_change_entity_1 = require("./entities/audit-log-change.entity");
+Object.defineProperty(exports, "AuditLogChange", { enumerable: true, get: function () { return audit_log_change_entity_1.AuditLogChange; } });
+var audit_log_entity_1 = require("./entities/audit-log.entity");
+Object.defineProperty(exports, "AuditLog", { enumerable: true, get: function () { return audit_log_entity_1.AuditLog; } });
+var audit_module_1 = require("./audit.module");
+Object.defineProperty(exports, "AuditModule", { enumerable: true, get: function () { return audit_module_1.AuditModule; } });
+var audit_query_service_1 = require("./services/audit-query.service");
+Object.defineProperty(exports, "AUDIT_USER_LOOKUP", { enumerable: true, get: function () { return audit_query_service_1.AUDIT_USER_LOOKUP; } });
+Object.defineProperty(exports, "AuditQueryService", { enumerable: true, get: function () { return audit_query_service_1.AuditQueryService; } });
+var audit_service_1 = require("./services/audit.service");
+Object.defineProperty(exports, "AuditService", { enumerable: true, get: function () { return audit_service_1.AuditService; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAA0E;AAAjE,4GAAA,UAAU,OAAA;AAAE,kHAAA,gBAAgB,OAAA;AAErC,mEAAiE;AAAxD,mHAAA,eAAe,OAAA;AAExB,8EAAoE;AAA3D,yHAAA,cAAc,OAAA;AACvB,gEAAuD;AAA9C,4GAAA,QAAQ,OAAA;AACjB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAEpB,sEAKwC;AAJtC,wHAAA,iBAAiB,OAAA;AACjB,wHAAA,iBAAiB,OAAA;AAInB,0DAAwD;AAA/C,6GAAA,YAAY,OAAA"}

package/dist/services/audit-query.service.d.ts

@@ -0,0 +1,31 @@
+import { Repository } from 'typeorm';
+import { AuditLog } from '../entities/audit-log.entity';
+import type { AuditQueryFilters } from '../dtos/audit-log-params.dto';
+/** Optional: provide to enrich audit logs with user details when actorType is 'user'. */
+export interface IAuditUserLookup {
+    findByIds(ids: string[]): Promise<Array<{
+        id: string;
+    } & Record<string, unknown>>>;
+}
+export declare const AUDIT_USER_LOOKUP = "AUDIT_USER_LOOKUP";
+export interface AuditLogWithActor extends AuditLog {
+    actor?: {
+        type: string;
+        id: string | null;
+    } | Record<string, unknown>;
+}
+export declare class AuditQueryService {
+    private readonly auditLogRepo;
+    private readonly userLookup;
+    constructor(auditLogRepo: Repository<AuditLog>, userLookup: IAuditUserLookup | null);
+    /**
+     * Query audit logs by filters. No join; returns only stored data (actorType + actorId).
+     */
+    query(filters: AuditQueryFilters): Promise<AuditLog[]>;
+    /**
+     * Query audit logs and optionally join with users table for display.
+     * When actorType is 'user', actor will be the full user object if AUDIT_USER_LOOKUP is provided.
+     */
+    queryWithActorDetails(filters: AuditQueryFilters): Promise<AuditLogWithActor[]>;
+}
+//# sourceMappingURL=audit-query.service.d.ts.map

package/dist/services/audit-query.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-query.service.d.ts","sourceRoot":"","sources":["../../src/services/audit-query.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpF;AAED,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvE;AAED,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAG7B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAHV,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,EAGlC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAGtD;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkB5D;;;OAGG;IACG,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAoBtF"}

package/dist/services/audit-query.service.js

@@ -0,0 +1,83 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditQueryService = exports.AUDIT_USER_LOOKUP = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const audit_constant_1 = require("../constants/audit.constant");
+const audit_log_entity_1 = require("../entities/audit-log.entity");
+exports.AUDIT_USER_LOOKUP = 'AUDIT_USER_LOOKUP';
+let AuditQueryService = class AuditQueryService {
+    auditLogRepo;
+    userLookup;
+    constructor(auditLogRepo, userLookup) {
+        this.auditLogRepo = auditLogRepo;
+        this.userLookup = userLookup;
+    }
+    /**
+     * Query audit logs by filters. No join; returns only stored data (actorType + actorId).
+     */
+    async query(filters) {
+        const qb = this.auditLogRepo
+            .createQueryBuilder('log')
+            .orderBy('log.timestamp', 'DESC')
+            .take(filters.limit ?? 100)
+            .skip(filters.offset ?? 0);
+        if (filters.actorType)
+            qb.andWhere('log.actorType = :actorType', { actorType: filters.actorType });
+        if (filters.actorId)
+            qb.andWhere('log.actorId = :actorId', { actorId: filters.actorId });
+        if (filters.entityType)
+            qb.andWhere('log.entityType = :entityType', { entityType: filters.entityType });
+        if (filters.entityId)
+            qb.andWhere('log.entityId = :entityId', { entityId: filters.entityId });
+        if (filters.action)
+            qb.andWhere('log.action = :action', { action: filters.action });
+        if (filters.from)
+            qb.andWhere('log.timestamp >= :from', { from: filters.from });
+        if (filters.to)
+            qb.andWhere('log.timestamp <= :to', { to: filters.to });
+        return qb.getMany();
+    }
+    /**
+     * Query audit logs and optionally join with users table for display.
+     * When actorType is 'user', actor will be the full user object if AUDIT_USER_LOOKUP is provided.
+     */
+    async queryWithActorDetails(filters) {
+        const logs = await this.query(filters);
+        const userLogs = logs.filter((log) => log.actorType === audit_constant_1.ACTOR_TYPE.USER);
+        const userIds = [...new Set(userLogs.map((log) => log.actorId).filter(Boolean))];
+        let userMap = new Map();
+        if (this.userLookup && userIds.length > 0) {
+            const users = await this.userLookup.findByIds(userIds);
+            userMap = new Map(users.map((u) => [u.id, u]));
+        }
+        return logs.map((log) => ({
+            ...log,
+            actor: log.actorType === audit_constant_1.ACTOR_TYPE.USER && log.actorId
+                ? (userMap.get(log.actorId) ?? { type: log.actorType, id: log.actorId })
+                : { type: log.actorType, id: log.actorId },
+        }));
+    }
+};
+exports.AuditQueryService = AuditQueryService;
+exports.AuditQueryService = AuditQueryService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, typeorm_1.InjectRepository)(audit_log_entity_1.AuditLog)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(exports.AUDIT_USER_LOOKUP)),
+    __metadata("design:paramtypes", [typeorm_2.Repository, Object])
+], AuditQueryService);
+//# sourceMappingURL=audit-query.service.js.map

package/dist/services/audit-query.service.js.map

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

package/dist/services/audit.service.d.ts

@@ -0,0 +1,19 @@
+import { Repository } from 'typeorm';
+import { AuditLogChange } from '../entities/audit-log-change.entity';
+import { AuditLog } from '../entities/audit-log.entity';
+import type { AuditLogParams } from '../dtos/audit-log-params.dto';
+export declare class AuditService {
+    private readonly auditLogRepo;
+    private readonly auditLogChangeRepo;
+    constructor(auditLogRepo: Repository<AuditLog>, auditLogChangeRepo: Repository<AuditLogChange>);
+    /**
+     * Generic log method. Flexible Actor Model: only actorType + actorId stored.
+     */
+    log(params: AuditLogParams): Promise<AuditLog>;
+    logUserAction(userId: string, params: Omit<AuditLogParams, 'actorType' | 'actorId'>): Promise<AuditLog>;
+    logSystemAction(systemId: string, params: Omit<AuditLogParams, 'actorType' | 'actorId'>): Promise<AuditLog>;
+    logExternalAction(externalId: string, params: Omit<AuditLogParams, 'actorType' | 'actorId'>): Promise<AuditLog>;
+    logAutomationAction(automationName: string, params: Omit<AuditLogParams, 'actorType' | 'actorId'>): Promise<AuditLog>;
+    logWebhookAction(webhookId: string, params: Omit<AuditLogParams, 'actorType' | 'actorId'>): Promise<AuditLog>;
+}
+//# sourceMappingURL=audit.service.d.ts.map

package/dist/services/audit.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.service.d.ts","sourceRoot":"","sources":["../../src/services/audit.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,qBACa,YAAY;IAGrB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAFlB,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,EAElC,kBAAkB,EAAE,UAAU,CAAC,cAAc,CAAC;IAGjE;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqC9C,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,SAAS,CAAC,GACpD,OAAO,CAAC,QAAQ,CAAC;IAQd,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,SAAS,CAAC,GACpD,OAAO,CAAC,QAAQ,CAAC;IAQd,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,SAAS,CAAC,GACpD,OAAO,CAAC,QAAQ,CAAC;IAQd,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,SAAS,CAAC,GACpD,OAAO,CAAC,QAAQ,CAAC;IAQd,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,SAAS,CAAC,GACpD,OAAO,CAAC,QAAQ,CAAC;CAOrB"}

package/dist/services/audit.service.js

@@ -0,0 +1,108 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const audit_constant_1 = require("../constants/audit.constant");
+const audit_log_change_entity_1 = require("../entities/audit-log-change.entity");
+const audit_log_entity_1 = require("../entities/audit-log.entity");
+let AuditService = class AuditService {
+    auditLogRepo;
+    auditLogChangeRepo;
+    constructor(auditLogRepo, auditLogChangeRepo) {
+        this.auditLogRepo = auditLogRepo;
+        this.auditLogChangeRepo = auditLogChangeRepo;
+    }
+    /**
+     * Generic log method. Flexible Actor Model: only actorType + actorId stored.
+     */
+    async log(params) {
+        const log = this.auditLogRepo.create({
+            actorType: params.actorType,
+            actorId: params.actorId ?? null,
+            entityType: params.entityType,
+            entityId: params.entityId ?? null,
+            action: params.action,
+            category: params.category ?? null,
+            description: params.description ?? null,
+            ipAddress: params.ipAddress ?? null,
+            userAgent: params.userAgent ?? null,
+            location: params.location ?? null,
+            metadata: params.metadata ?? null,
+            requestId: params.requestId ?? null,
+            correlationId: params.correlationId ?? null,
+            status: params.status ?? audit_constant_1.AUDIT_LOG_STATUS.SUCCESS,
+            errorMessage: params.errorMessage ?? null,
+            expiresAt: params.expiresAt ?? null,
+        });
+        const saved = await this.auditLogRepo.save(log);
+        if (params.changes?.length) {
+            const changeEntities = params.changes.map((c) => this.auditLogChangeRepo.create({
+                auditLogId: saved.id,
+                field: c.field,
+                oldValue: c.oldValue,
+                newValue: c.newValue,
+            }));
+            await this.auditLogChangeRepo.save(changeEntities);
+            saved.changes = changeEntities;
+        }
+        return saved;
+    }
+    async logUserAction(userId, params) {
+        return this.log({
+            ...params,
+            actorType: audit_constant_1.ACTOR_TYPE.USER,
+            actorId: userId,
+        });
+    }
+    async logSystemAction(systemId, params) {
+        return this.log({
+            ...params,
+            actorType: audit_constant_1.ACTOR_TYPE.SYSTEM,
+            actorId: systemId,
+        });
+    }
+    async logExternalAction(externalId, params) {
+        return this.log({
+            ...params,
+            actorType: audit_constant_1.ACTOR_TYPE.EXTERNAL,
+            actorId: externalId,
+        });
+    }
+    async logAutomationAction(automationName, params) {
+        return this.log({
+            ...params,
+            actorType: audit_constant_1.ACTOR_TYPE.AUTOMATION,
+            actorId: automationName,
+        });
+    }
+    async logWebhookAction(webhookId, params) {
+        return this.log({
+            ...params,
+            actorType: audit_constant_1.ACTOR_TYPE.WEBHOOK,
+            actorId: webhookId,
+        });
+    }
+};
+exports.AuditService = AuditService;
+exports.AuditService = AuditService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, typeorm_1.InjectRepository)(audit_log_entity_1.AuditLog)),
+    __param(1, (0, typeorm_1.InjectRepository)(audit_log_change_entity_1.AuditLogChange)),
+    __metadata("design:paramtypes", [typeorm_2.Repository,
+        typeorm_2.Repository])
+], AuditService);
+//# sourceMappingURL=audit.service.js.map

package/dist/services/audit.service.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@venturialstd/audit",
+  "version": "0.0.2",
+  "description": "Business-agnostic audit logging with Flexible Actor Model (ID-Only)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "rimraf dist",
+    "build": "tsc -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/typeorm": "^11.0.0",
+    "typeorm": "^0.3.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.11",
+    "@nestjs/testing": "^11.0.5",
+    "@nestjs/typeorm": "^11.0.0",
+    "typeorm": "^0.3.20",
+    "typescript": "^5.9.0",
+    "rimraf": "^6.0.0"
+  }
+}