@application-kit/audit-log 0.0.0-stage → 0.1.1

package/dist/esm/nest/application/queries/dtos/index.d.ts

@@ -0,0 +1 @@
+export * from './audit-record.dto.js';

package/dist/esm/nest/application/queries/dtos/index.js

@@ -0,0 +1 @@
+export * from './audit-record.dto.js';

package/dist/esm/nest/application/queries/get-audit-records.query.d.ts

@@ -0,0 +1,6 @@
+import type { ListingQueryResultInterface } from '@application-kit/typeorm/nest';
+import { ListingQuery } from '@application-kit/typeorm/nest';
+import type { AuditRecordDto } from './dtos/audit-record.dto.js';
+export type GetAuditRecordsQueryResult = ListingQueryResultInterface<AuditRecordDto>;
+export declare class GetAuditRecordsQuery extends ListingQuery {
+}

package/dist/esm/nest/application/queries/get-audit-records.query.js

@@ -0,0 +1,3 @@
+import { ListingQuery } from '@application-kit/typeorm/nest';
+export class GetAuditRecordsQuery extends ListingQuery {
+}

package/dist/esm/nest/application/queries/handlers/get-audit-records.handler.d.ts

@@ -0,0 +1,9 @@
+import type { IQueryHandler } from '@nestjs/cqrs';
+import { ListingHandler } from '@application-kit/typeorm/nest';
+import type { AuditLogReadInterface } from '../../ports/audit-log-read.interface.js';
+import { AuditRecordDto } from '../dtos/audit-record.dto.js';
+import { GetAuditRecordsQuery, GetAuditRecordsQueryResult } from '../get-audit-records.query.js';
+export declare class GetAuditRecordsHandler extends ListingHandler<AuditRecordDto> implements IQueryHandler<GetAuditRecordsQuery, GetAuditRecordsQueryResult> {
+    constructor(auditLogRepository: AuditLogReadInterface);
+    execute(query: GetAuditRecordsQuery): Promise<GetAuditRecordsQueryResult>;
+}

package/dist/esm/nest/application/queries/handlers/get-audit-records.handler.js

@@ -0,0 +1,32 @@
+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); }
+};
+import { ListingHandler } from '@application-kit/typeorm/nest';
+import { Inject } from '@nestjs/common';
+import { QueryHandler } from '@nestjs/cqrs';
+import { AUDIT_LOG_READ_PORT } from '../../../constants.js';
+import { GetAuditRecordsQuery, } from '../get-audit-records.query.js';
+const MAX_LIMIT = 200;
+let GetAuditRecordsHandler = class GetAuditRecordsHandler extends ListingHandler {
+    constructor(auditLogRepository) {
+        super(auditLogRepository);
+    }
+    async execute(query) {
+        return super.execute(new GetAuditRecordsQuery({ ...query.paginator, limit: Math.min(query.paginator.limit, MAX_LIMIT) }, query.filters, query.sorting));
+    }
+};
+GetAuditRecordsHandler = __decorate([
+    QueryHandler(GetAuditRecordsQuery),
+    __param(0, Inject(AUDIT_LOG_READ_PORT)),
+    __metadata("design:paramtypes", [Object])
+], GetAuditRecordsHandler);
+export { GetAuditRecordsHandler };

package/dist/esm/nest/application/queries/handlers/index.d.ts

@@ -0,0 +1 @@
+export * from './get-audit-records.handler.js';

package/dist/esm/nest/application/queries/handlers/index.js

@@ -0,0 +1 @@
+export * from './get-audit-records.handler.js';

package/dist/esm/nest/application/queries/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/index.js';
+export * from './handlers/index.js';
+export * from './get-audit-records.query.js';

package/dist/esm/nest/application/queries/index.js

@@ -0,0 +1,3 @@
+export * from './dtos/index.js';
+export * from './handlers/index.js';
+export * from './get-audit-records.query.js';

package/dist/esm/nest/audit-log-consumers.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AuditLogConsumersModule {
+}

package/dist/esm/nest/audit-log-consumers.module.js

@@ -0,0 +1,19 @@
+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;
+};
+import { Module } from '@nestjs/common';
+import { AuditLogModule } from './audit-log.module.js';
+import { RecordAuditFactHandler } from './user-interface/consumers/record-audit-fact.handler.js';
+let AuditLogConsumersModule = class AuditLogConsumersModule {
+};
+AuditLogConsumersModule = __decorate([
+    Module({
+        exports: [RecordAuditFactHandler],
+        imports: [AuditLogModule],
+        providers: [RecordAuditFactHandler],
+    })
+], AuditLogConsumersModule);
+export { AuditLogConsumersModule };

package/dist/esm/nest/audit-log-request-facts.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AuditLogRequestFactsModule {
+}

package/dist/esm/nest/audit-log-request-facts.module.js

@@ -0,0 +1,19 @@
+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;
+};
+import { TRANSACTION_OUTBOX_REQUEST_FACTS } from '@application-kit/transaction-outbox';
+import { Global, Module } from '@nestjs/common';
+import { auditRequestFacts } from './libs/audit-request-context.js';
+let AuditLogRequestFactsModule = class AuditLogRequestFactsModule {
+};
+AuditLogRequestFactsModule = __decorate([
+    Global(),
+    Module({
+        exports: [TRANSACTION_OUTBOX_REQUEST_FACTS],
+        providers: [{ provide: TRANSACTION_OUTBOX_REQUEST_FACTS, useValue: auditRequestFacts }],
+    })
+], AuditLogRequestFactsModule);
+export { AuditLogRequestFactsModule };

package/dist/esm/nest/audit-log-web.module.d.ts

@@ -0,0 +1,8 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { AuditRequestFactsResolver } from './libs/audit-request-context.js';
+export interface AuditLogWebOptionsInterface {
+    resolveRequestFacts: AuditRequestFactsResolver;
+}
+export declare class AuditLogWebModule {
+    static forRoot(options: AuditLogWebOptionsInterface): DynamicModule;
+}

package/dist/esm/nest/audit-log-web.module.js

@@ -0,0 +1,36 @@
+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;
+};
+import { Module } from '@nestjs/common';
+import { APP_INTERCEPTOR } from '@nestjs/core';
+import { CqrsModule } from '@nestjs/cqrs';
+import { AuditLogModule } from './audit-log.module.js';
+import { AUDIT_REQUEST_FACTS_RESOLVER } from './constants.js';
+import { AuditRecordsResolver } from './user-interface/controllers/graphql/audit-records/audit-records.resolver.js';
+import { AuditRequestContextInterceptor } from './user-interface/interceptors/audit-request-context.interceptor.js';
+let AuditLogWebModule = class AuditLogWebModule {
+    static forRoot(options) {
+        return {
+            imports: [AuditLogModule, CqrsModule],
+            module: this,
+            providers: [
+                AuditRecordsResolver,
+                {
+                    provide: APP_INTERCEPTOR,
+                    useClass: AuditRequestContextInterceptor,
+                },
+                {
+                    provide: AUDIT_REQUEST_FACTS_RESOLVER,
+                    useValue: options.resolveRequestFacts,
+                },
+            ],
+        };
+    }
+};
+AuditLogWebModule = __decorate([
+    Module({})
+], AuditLogWebModule);
+export { AuditLogWebModule };

package/dist/esm/nest/audit-log.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AuditLogModule {
+}

package/dist/esm/nest/audit-log.module.js

@@ -0,0 +1,34 @@
+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;
+};
+import { Module } from '@nestjs/common';
+import { CqrsModule } from '@nestjs/cqrs';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { GetAuditRecordsHandler, } from './application/queries/handlers/get-audit-records.handler.js';
+import { AuditLogRequestFactsModule } from './audit-log-request-facts.module.js';
+import { AUDIT_LOG_READ_PORT, AUDIT_LOG_WRITE_PORT } from './constants.js';
+import { AuditRecordEntity } from './infrastructure/database/typeorm/entities/audit-record.entity.js';
+import { AuditRecordRepository, } from './infrastructure/database/typeorm/repositories/audit-record.repository.js';
+let AuditLogModule = class AuditLogModule {
+};
+AuditLogModule = __decorate([
+    Module({
+        exports: [AUDIT_LOG_READ_PORT, AUDIT_LOG_WRITE_PORT],
+        imports: [AuditLogRequestFactsModule, CqrsModule, TypeOrmModule.forFeature([AuditRecordEntity])],
+        providers: [
+            GetAuditRecordsHandler,
+            {
+                provide: AUDIT_LOG_READ_PORT,
+                useClass: AuditRecordRepository,
+            },
+            {
+                provide: AUDIT_LOG_WRITE_PORT,
+                useClass: AuditRecordRepository,
+            },
+        ],
+    })
+], AuditLogModule);
+export { AuditLogModule };

package/dist/esm/nest/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const AUDIT_LOG_READ_PORT: unique symbol;
+export declare const AUDIT_LOG_WRITE_PORT: unique symbol;
+export declare const AUDIT_REQUEST_FACTS_RESOLVER: unique symbol;

package/dist/esm/nest/constants.js

@@ -0,0 +1,3 @@
+export const AUDIT_LOG_READ_PORT = Symbol('AUDIT_LOG_READ_PORT');
+export const AUDIT_LOG_WRITE_PORT = Symbol('AUDIT_LOG_WRITE_PORT');
+export const AUDIT_REQUEST_FACTS_RESOLVER = Symbol('AUDIT_REQUEST_FACTS_RESOLVER');

package/dist/esm/nest/domain/audit-record.d.ts

@@ -0,0 +1,15 @@
+import { AbstractEntity, Uuid } from '@libs-for-dev/nestjs-ddd-library';
+export interface AuditRecordPropsInterface {
+    action: string;
+    actorId: null | string;
+    actorRole: null | string;
+    eventId: null | string;
+    ip: null | string;
+    subjectId: string;
+    userAgent: null | string;
+}
+export declare const AUDIT_IP_MAX_LENGTH = 64;
+export declare const AUDIT_USER_AGENT_MAX_LENGTH = 512;
+export declare class AuditRecord extends AbstractEntity<Uuid, AuditRecordPropsInterface> {
+    static create: (properties: AuditRecordPropsInterface) => AuditRecord;
+}

package/dist/esm/nest/domain/audit-record.js

@@ -0,0 +1,11 @@
+import { AbstractEntity, Uuid } from '@libs-for-dev/nestjs-ddd-library';
+export const AUDIT_IP_MAX_LENGTH = 64;
+export const AUDIT_USER_AGENT_MAX_LENGTH = 512;
+const truncate = (value, maxLength) => (value === null ? null : value.slice(0, maxLength));
+export class AuditRecord extends AbstractEntity {
+    static create = (properties) => new AuditRecord(Uuid.generate(), {
+        ...properties,
+        ip: truncate(properties.ip, AUDIT_IP_MAX_LENGTH),
+        userAgent: truncate(properties.userAgent, AUDIT_USER_AGENT_MAX_LENGTH),
+    });
+}

package/dist/esm/nest/domain/index.d.ts

@@ -0,0 +1 @@
+export * from './audit-record.js';

package/dist/esm/nest/domain/index.js

@@ -0,0 +1 @@
+export * from './audit-record.js';

package/dist/esm/nest/index.d.ts

@@ -0,0 +1,11 @@
+export * from './application/index.js';
+export * from './domain/index.js';
+export * from './infrastructure/index.js';
+export * from './libs/index.js';
+export * from './user-interface/index.js';
+export * from './audit-log-consumers.module.js';
+export * from './audit-log-request-facts.module.js';
+export * from './audit-log-web.module.js';
+export * from './audit-log.module.js';
+export * from './constants.js';
+export * from './policy-handlers.js';

package/dist/esm/nest/index.js

@@ -0,0 +1,11 @@
+export * from './application/index.js';
+export * from './domain/index.js';
+export * from './infrastructure/index.js';
+export * from './libs/index.js';
+export * from './user-interface/index.js';
+export * from './audit-log-consumers.module.js';
+export * from './audit-log-request-facts.module.js';
+export * from './audit-log-web.module.js';
+export * from './audit-log.module.js';
+export * from './constants.js';
+export * from './policy-handlers.js';

package/dist/esm/nest/infrastructure/database/index.d.ts

@@ -0,0 +1 @@
+export * from './typeorm/index.js';

package/dist/esm/nest/infrastructure/database/index.js

@@ -0,0 +1 @@
+export * from './typeorm/index.js';

package/dist/esm/nest/infrastructure/database/typeorm/entities/audit-record.entity.d.ts

@@ -0,0 +1,11 @@
+export declare class AuditRecordEntity {
+    action: string;
+    actorId: null | string;
+    actorRole: null | string;
+    createdAt: Date;
+    eventId: null | string;
+    id: string;
+    ip: null | string;
+    subjectId: string;
+    userAgent: null | string;
+}

package/dist/esm/nest/infrastructure/database/typeorm/entities/audit-record.entity.js

@@ -0,0 +1,66 @@
+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);
+};
+import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
+import { AUDIT_IP_MAX_LENGTH, AUDIT_USER_AGENT_MAX_LENGTH } from '../../../../domain/audit-record.js';
+const DICTIONARY_VALUE_LENGTH = 64;
+let AuditRecordEntity = class AuditRecordEntity {
+    action;
+    actorId;
+    actorRole;
+    createdAt;
+    eventId;
+    id;
+    ip;
+    subjectId;
+    userAgent;
+};
+__decorate([
+    Column({ length: DICTIONARY_VALUE_LENGTH, nullable: false, type: 'varchar' }),
+    __metadata("design:type", String)
+], AuditRecordEntity.prototype, "action", void 0);
+__decorate([
+    Column({ nullable: true, type: 'uuid' }),
+    __metadata("design:type", Object)
+], AuditRecordEntity.prototype, "actorId", void 0);
+__decorate([
+    Column({ length: DICTIONARY_VALUE_LENGTH, nullable: true, type: 'varchar' }),
+    __metadata("design:type", Object)
+], AuditRecordEntity.prototype, "actorRole", void 0);
+__decorate([
+    CreateDateColumn({ type: 'timestamp without time zone' }),
+    __metadata("design:type", Date)
+], AuditRecordEntity.prototype, "createdAt", void 0);
+__decorate([
+    Column({ nullable: true, type: 'uuid', unique: true }),
+    __metadata("design:type", Object)
+], AuditRecordEntity.prototype, "eventId", void 0);
+__decorate([
+    PrimaryGeneratedColumn('uuid'),
+    __metadata("design:type", String)
+], AuditRecordEntity.prototype, "id", void 0);
+__decorate([
+    Column({ length: AUDIT_IP_MAX_LENGTH, nullable: true, type: 'varchar' }),
+    __metadata("design:type", Object)
+], AuditRecordEntity.prototype, "ip", void 0);
+__decorate([
+    Column({ nullable: false, type: 'uuid' }),
+    __metadata("design:type", String)
+], AuditRecordEntity.prototype, "subjectId", void 0);
+__decorate([
+    Column({ length: AUDIT_USER_AGENT_MAX_LENGTH, nullable: true, type: 'varchar' }),
+    __metadata("design:type", Object)
+], AuditRecordEntity.prototype, "userAgent", void 0);
+AuditRecordEntity = __decorate([
+    Entity(),
+    Index(['action', 'createdAt']),
+    Index(['createdAt']),
+    Index(['subjectId'])
+], AuditRecordEntity);
+export { AuditRecordEntity };

package/dist/esm/nest/infrastructure/database/typeorm/entities/index.d.ts

@@ -0,0 +1 @@
+export * from './audit-record.entity.js';

package/dist/esm/nest/infrastructure/database/typeorm/entities/index.js

@@ -0,0 +1 @@
+export * from './audit-record.entity.js';

package/dist/esm/nest/infrastructure/database/typeorm/index.d.ts

@@ -0,0 +1,5 @@
+export * from './entities/index.js';
+export * from './mappers/index.js';
+export * from './migrations/index.js';
+export * from './repositories/index.js';
+export * from './orm.js';

package/dist/esm/nest/infrastructure/database/typeorm/index.js

@@ -0,0 +1,5 @@
+export * from './entities/index.js';
+export * from './mappers/index.js';
+export * from './migrations/index.js';
+export * from './repositories/index.js';
+export * from './orm.js';

package/dist/esm/nest/infrastructure/database/typeorm/mappers/audit-record.mapper.d.ts

@@ -0,0 +1,10 @@
+import type { Repository } from 'typeorm';
+import type { AuditRecord } from '../../../../domain/audit-record.js';
+import type { AuditRecordEntity } from '../entities/audit-record.entity.js';
+import { AuditRecordDto } from '../../../../application/queries/dtos/audit-record.dto.js';
+export declare class AuditRecordMapper {
+    private readonly repository;
+    constructor(repository: Repository<AuditRecordEntity>);
+    toDto(entity: AuditRecordEntity): AuditRecordDto;
+    toOrmEntity(domain: AuditRecord): AuditRecordEntity;
+}

package/dist/esm/nest/infrastructure/database/typeorm/mappers/audit-record.mapper.js

@@ -0,0 +1,31 @@
+import { AuditRecordDto } from '../../../../application/queries/dtos/audit-record.dto.js';
+export class AuditRecordMapper {
+    repository;
+    constructor(repository) {
+        this.repository = repository;
+    }
+    toDto(entity) {
+        return new AuditRecordDto({
+            action: entity.action,
+            actorId: entity.actorId,
+            actorRole: entity.actorRole,
+            createdAt: entity.createdAt,
+            id: entity.id,
+            ip: entity.ip,
+            subjectId: entity.subjectId,
+            userAgent: entity.userAgent,
+        });
+    }
+    toOrmEntity(domain) {
+        return this.repository.create({
+            action: domain.props.action,
+            actorId: domain.props.actorId,
+            actorRole: domain.props.actorRole,
+            eventId: domain.props.eventId,
+            id: domain.id.value,
+            ip: domain.props.ip,
+            subjectId: domain.props.subjectId,
+            userAgent: domain.props.userAgent,
+        });
+    }
+}

package/dist/esm/nest/infrastructure/database/typeorm/mappers/index.d.ts

@@ -0,0 +1 @@
+export * from './audit-record.mapper.js';

package/dist/esm/nest/infrastructure/database/typeorm/mappers/index.js

@@ -0,0 +1 @@
+export * from './audit-record.mapper.js';

package/dist/esm/nest/infrastructure/database/typeorm/migrations/audit-records-append-only.migration.d.ts

@@ -0,0 +1,6 @@
+import type { MigrationInterface, QueryRunner } from 'typeorm';
+export declare class AuditRecordsAppendOnly1789712401337 implements MigrationInterface {
+    name: string;
+    down(queryRunner: QueryRunner): Promise<void>;
+    up(queryRunner: QueryRunner): Promise<void>;
+}

package/dist/esm/nest/infrastructure/database/typeorm/migrations/audit-records-append-only.migration.js

@@ -0,0 +1,24 @@
+export class AuditRecordsAppendOnly1789712401337 {
+    name = 'AuditRecordsAppendOnly1789712401337';
+    async down(queryRunner) {
+        await queryRunner.query(`DROP TABLE "audit_records"`);
+        await queryRunner.query(`DROP FUNCTION "public"."audit_records_block_modification"()`);
+    }
+    async up(queryRunner) {
+        await queryRunner.query(`CREATE TABLE "audit_records" ("created_at" TIMESTAMP NOT NULL DEFAULT now(), "id" uuid NOT NULL DEFAULT uuid_generate_v4(), "actor_id" uuid, "subject_id" uuid NOT NULL, "action" character varying(64) NOT NULL, "ip" character varying(64), "user_agent" character varying(512), "actor_role" character varying(64), "event_id" uuid, CONSTRAINT "UQ_058b8b524336ce9f786a7040f4c" UNIQUE ("event_id"), CONSTRAINT "PK_f903ebdf175f062be69747b0f18" PRIMARY KEY ("id"))`);
+        await queryRunner.query(`CREATE INDEX "IDX_78ba6f5763e4f42e8b759150a7" ON "audit_records"  ("subject_id") `);
+        await queryRunner.query(`CREATE INDEX "IDX_9f4e4098cb280b3872c86ba5d9" ON "audit_records"  ("created_at") `);
+        await queryRunner.query(`CREATE INDEX "IDX_347b1ef38175e0ec6beac451f1" ON "audit_records"  ("action", "created_at") `);
+        await queryRunner.query(`
+      CREATE OR REPLACE FUNCTION "public"."audit_records_block_modification"() RETURNS TRIGGER AS $$
+      BEGIN
+        RAISE EXCEPTION '% is append-only; UPDATE/DELETE forbidden', TG_TABLE_NAME;
+      END;
+      $$ LANGUAGE plpgsql
+    `);
+        await queryRunner.query(`CREATE TRIGGER "audit_records_block_update" BEFORE UPDATE ON "audit_records" `
+            + `FOR EACH ROW EXECUTE FUNCTION "public"."audit_records_block_modification"()`);
+        await queryRunner.query(`CREATE TRIGGER "audit_records_block_delete" BEFORE DELETE ON "audit_records" `
+            + `FOR EACH ROW EXECUTE FUNCTION "public"."audit_records_block_modification"()`);
+    }
+}

package/dist/esm/nest/infrastructure/database/typeorm/migrations/index.d.ts

@@ -0,0 +1 @@
+export * from './audit-records-append-only.migration.js';

package/dist/esm/nest/infrastructure/database/typeorm/migrations/index.js

@@ -0,0 +1 @@
+export * from './audit-records-append-only.migration.js';

package/dist/esm/nest/infrastructure/database/typeorm/orm.d.ts

@@ -0,0 +1,6 @@
+import { AuditRecordEntity } from './entities/audit-record.entity.js';
+import { AuditRecordsAppendOnly1789712401337 } from './migrations/audit-records-append-only.migration.js';
+export declare const orm: {
+    entities: (typeof AuditRecordEntity)[];
+    migrations: (typeof AuditRecordsAppendOnly1789712401337)[];
+};

package/dist/esm/nest/infrastructure/database/typeorm/orm.js

@@ -0,0 +1,6 @@
+import { AuditRecordEntity } from './entities/audit-record.entity.js';
+import { AuditRecordsAppendOnly1789712401337 } from './migrations/audit-records-append-only.migration.js';
+export const orm = {
+    entities: [AuditRecordEntity],
+    migrations: [AuditRecordsAppendOnly1789712401337],
+};

package/dist/esm/nest/infrastructure/database/typeorm/repositories/audit-record.repository.d.ts

@@ -0,0 +1,14 @@
+import type { FilterInterface, ListingResultInterface, PaginatorInterface, SortingInterface } from '@application-kit/typeorm/listing';
+import { Repository } from 'typeorm';
+import { AuditLogReadInterface } from '../../../../application/ports/audit-log-read.interface.js';
+import { AuditLogWriteInterface } from '../../../../application/ports/audit-log-write.interface.js';
+import { AuditRecordDto } from '../../../../application/queries/dtos/audit-record.dto.js';
+import { AuditRecord } from '../../../../domain/audit-record.js';
+import { AuditRecordEntity } from '../entities/audit-record.entity.js';
+export declare class AuditRecordRepository implements AuditLogReadInterface, AuditLogWriteInterface {
+    private readonly repository;
+    private readonly mapper;
+    constructor(repository: Repository<AuditRecordEntity>);
+    append(record: AuditRecord): Promise<void>;
+    list(paginator: PaginatorInterface, sorting?: SortingInterface[], filters?: FilterInterface[]): Promise<ListingResultInterface<AuditRecordDto>>;
+}

package/dist/esm/nest/infrastructure/database/typeorm/repositories/audit-record.repository.js

@@ -0,0 +1,44 @@
+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); }
+};
+import { getListByCursor } from '@application-kit/typeorm';
+import { Injectable } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Repository } from 'typeorm';
+import { AuditRecordEntity } from '../entities/audit-record.entity.js';
+import { AuditRecordMapper } from '../mappers/audit-record.mapper.js';
+let AuditRecordRepository = class AuditRecordRepository {
+    repository;
+    mapper;
+    constructor(repository) {
+        this.repository = repository;
+        this.mapper = new AuditRecordMapper(repository);
+    }
+    async append(record) {
+        await this.repository
+            .createQueryBuilder()
+            .insert()
+            .into(AuditRecordEntity)
+            .values(this.mapper.toOrmEntity(record))
+            .orIgnore()
+            .execute();
+    }
+    async list(paginator, sorting, filters) {
+        return getListByCursor(AuditRecordEntity, this.repository.createQueryBuilder('auditRecord'), (entities) => entities.map((entity) => this.mapper.toDto(entity)), paginator, filters, sorting);
+    }
+};
+AuditRecordRepository = __decorate([
+    Injectable(),
+    __param(0, InjectRepository(AuditRecordEntity)),
+    __metadata("design:paramtypes", [Repository])
+], AuditRecordRepository);
+export { AuditRecordRepository };

package/dist/esm/nest/infrastructure/database/typeorm/repositories/index.d.ts

@@ -0,0 +1 @@
+export * from './audit-record.repository.js';

package/dist/esm/nest/infrastructure/database/typeorm/repositories/index.js

@@ -0,0 +1 @@
+export * from './audit-record.repository.js';

package/dist/esm/nest/infrastructure/index.d.ts

@@ -0,0 +1 @@
+export * from './database/index.js';

package/dist/esm/nest/infrastructure/index.js

@@ -0,0 +1 @@
+export * from './database/index.js';

package/dist/esm/nest/libs/audit-request-context.d.ts

@@ -0,0 +1,25 @@
+export interface AuditRequestFactsInterface {
+    actorId: null | string;
+    actorRole: null | string;
+    ip: null | string;
+    userAgent: null | string;
+}
+export type AuditRequestFactsResolver = (request: AuditRequestInterface) => Pick<AuditRequestFactsInterface, 'ip' | 'userAgent'>;
+export interface AuditRequestInterface {
+    headers?: Record<string, string | string[] | undefined> | undefined;
+    ip?: string | undefined;
+    raw?: {
+        socket?: {
+            remoteAddress?: string | undefined;
+        } | undefined;
+    } | undefined;
+    socket?: {
+        remoteAddress?: string | undefined;
+    } | undefined;
+    user?: {
+        id?: string;
+        role?: string;
+    } | undefined;
+}
+export declare const auditRequestFacts: () => AuditRequestFactsInterface;
+export declare const runWithAuditRequest: <T>(request: AuditRequestInterface | undefined, resolveRequestFacts: AuditRequestFactsResolver, callback: () => T) => T;

package/dist/esm/nest/libs/audit-request-context.js

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const storage = new AsyncLocalStorage();
+const EMPTY_FACTS = { actorId: null, actorRole: null, ip: null, userAgent: null };
+const actorFacts = (user) => {
+    const { id = null, role = null } = user ?? {};
+    return { actorId: id, actorRole: role };
+};
+export const auditRequestFacts = () => {
+    const store = storage.getStore();
+    if (store === undefined) {
+        return EMPTY_FACTS;
+    }
+    return {
+        ...actorFacts(store.request.user),
+        ...store.resolveRequestFacts(store.request),
+    };
+};
+export const runWithAuditRequest = (request, resolveRequestFacts, callback) => storage.run(request === undefined ? undefined : { request, resolveRequestFacts }, callback);

package/dist/esm/nest/libs/index.d.ts

@@ -0,0 +1 @@
+export * from './audit-request-context.js';