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

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# @application-kit/audit-log
+
+## 0.1.1
+
+### Patch Changes
+
+- 3a2f7ed: `graphql`: класс аргументов листинга `Payload` (`@ArgsType`) переименован в `ListingArgs` — имя говорит, чьи это аргументы.
+  **Ломающее:** потребителю — заменить импорт и тип `Payload` на `ListingArgs`; схема GraphQL не меняется, имя класса в неё не попадает.
+
+  `audit-log`: резолвер `auditRecords` принимает `ListingArgs`.
+- Updated dependencies [3a2f7ed]
+- Updated dependencies [79a405c]
+- Updated dependencies [c5a41d7]
+  - @application-kit/graphql@0.8.0
+  - @application-kit/typeorm@0.5.2
+
+## 0.1.0
+
+### Minor Changes
+
+- fb8e06d: Новый пакет `@application-kit/audit-log`: журнал аудита с append-only таблицей, записью из событий и чтением через GraphQL.
+  Вся схема — одной миграцией `AuditRecordsAppendOnly1789712401337`: база с полной прежней цепочкой считает её применённой,
+  база с неполной цепочкой падает на `CREATE TABLE`, такую базу пересоздают. Подключение и право на чтение — в README пакета.
+
+  В `transaction-outbox` хук `TRANSACTION_OUTBOX_REQUEST_FACTS` стал необязательным: без него события с
+  `carriesRequestFacts` пишутся без `facts`. Приложениям, которые хук регистрируют, ничего менять не нужно.
+
+### Patch Changes
+
+- Updated dependencies [fb8e06d]
+  - @application-kit/transaction-outbox@0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 application-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# @application-kit/audit-log
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Журнал аудита для NestJS-приложений: append-only таблица с триггерами, запись из событий, чтение через GraphQL и
+факты запроса для `@application-kit/transaction-outbox`. Пакет не знает ролей и действий продукта: журнал хранит их
+строками, а кому читать журнал, решает карта грантов приложения.
+
+## Входы
+
+| Вход | Для чего | Тянет |
+|------|----------|-------|
+| `@application-kit/audit-log` | сервер и браузер: `AuditRecordWireInterface`, `AUDIT_LOG_MODULE_NAME`, право `AuditRecord` | только типы `@application-kit/authorization` |
+| `@application-kit/audit-log/nest` | сервер: модули, порты, `RecordAuditFactHandler`, `orm` | `@nestjs/*`, `typeorm`, `class-validator` |
+| `@application-kit/audit-log/testing` | фейки портов чтения и записи | — |
+
+## Подключение
+
+```ts
+import { AuditLogConsumersModule, AuditLogModule, AuditLogWebModule, orm as auditLogOrm } from '@application-kit/audit-log/nest'
+
+// Web-процесс. Каким заголовкам верить, знает только продукт: это зависит от прокси перед его подами.
+AuditLogWebModule.forRoot({ resolveRequestFacts: (request) => resolveRequestFacts(request, { trustedHeaders: ['cf-connecting-ip'] }) })
+
+// Консьюмер-процесс: владелец событий держит `@MessagePattern` и зовёт `RecordAuditFactHandler`.
+AuditLogConsumersModule
+
+// CLI миграций.
+createCliDataSource({ ..., packages: [auditLogOrm] }) // @application-kit/typeorm/nest
+```
+
+Таблица называется по naming strategy продукта: миграция рассчитана на `TypeormPluralNamingStrategy` (`audit_records`, snake_case).
+
+`AuditLogModule` регистрирует хук `TRANSACTION_OUTBOX_REQUEST_FACTS` глобально. Продукт без журнала его не подключает:
+outbox пишет события без `facts`.
+
+## Право на чтение
+
+```ts
+import { AUDIT_LOG_MODULE_NAME } from '@application-kit/audit-log'
+
+export const auditLogGrants = {
+  grants: { ADMIN: (builder) => { builder.can('read', 'AuditRecord') } },
+  name: AUDIT_LOG_MODULE_NAME,
+}
+```
+
+## Миграция
+
+Одна: `AuditRecordsAppendOnly1789712401337`. Её имя совпадает с последней миграцией прежней цепочки, поэтому на базе с полной
+цепочкой она считается применённой. База с неполной цепочкой падает на `CREATE TABLE`, такую базу пересоздают.
+`down` удаляет таблицу вместе с записями.
+
+Журнал: `UPDATE` и `DELETE` по таблице останавливают триггеры с ошибкой. Это защита от бага приложения и tamper-evidence, а не
+от владельца БД: он может удалить триггер тем же соединением.

package/dist/cjs/audit-log.wire.d.ts

@@ -0,0 +1,10 @@
+export interface AuditRecordWireInterface<TDate = string, TRole extends string = string> {
+    action: string;
+    actorId: null | string;
+    actorRole: null | TRole;
+    createdAt: TDate;
+    id: string;
+    ip: null | string;
+    subjectId: string;
+    userAgent: null | string;
+}

package/dist/cjs/audit-log.wire.js

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

package/dist/cjs/constants.d.ts

@@ -0,0 +1,8 @@
+import type { Subject } from '@application-kit/authorization';
+export declare const AUDIT_LOG_MODULE_NAME = "audit-log";
+declare module '@application-kit/authorization' {
+    interface SubjectRegistryInterface {
+        AuditRecord: 'read';
+    }
+}
+export type AuditLogSubject = Extract<Subject, 'AuditRecord'>;

package/dist/cjs/constants.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIT_LOG_MODULE_NAME = void 0;
+exports.AUDIT_LOG_MODULE_NAME = 'audit-log';

package/dist/cjs/index.d.ts

@@ -0,0 +1,2 @@
+export * from './audit-log.wire.js';
+export * from './constants.js';

package/dist/cjs/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./audit-log.wire.js"), exports);
+__exportStar(require("./constants.js"), exports);

package/dist/cjs/nest/application/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ports/index.js';
+export * from './queries/index.js';

package/dist/cjs/nest/application/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ports/index.js"), exports);
+__exportStar(require("./queries/index.js"), exports);

package/dist/cjs/nest/application/ports/audit-log-read.interface.d.ts

@@ -0,0 +1,3 @@
+import type { ListingRepositoryInterface } from '@application-kit/typeorm/listing';
+import type { AuditRecordDto } from '../queries/dtos/audit-record.dto.js';
+export type AuditLogReadInterface = ListingRepositoryInterface<AuditRecordDto>;

package/dist/cjs/nest/application/ports/audit-log-read.interface.js

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

package/dist/cjs/nest/application/ports/audit-log-write.interface.d.ts

@@ -0,0 +1,4 @@
+import type { AuditRecord } from '../../domain/audit-record.js';
+export interface AuditLogWriteInterface {
+    append(record: AuditRecord): Promise<void>;
+}

package/dist/cjs/nest/application/ports/audit-log-write.interface.js

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

package/dist/cjs/nest/application/ports/index.d.ts

@@ -0,0 +1,2 @@
+export * from './audit-log-read.interface.js';
+export * from './audit-log-write.interface.js';

package/dist/cjs/nest/application/ports/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./audit-log-read.interface.js"), exports);
+__exportStar(require("./audit-log-write.interface.js"), exports);

package/dist/cjs/nest/application/queries/dtos/audit-record.dto.d.ts

@@ -0,0 +1,21 @@
+export interface AuditRecordDtoOptionsInterface {
+    readonly action: string;
+    readonly actorId: null | string;
+    readonly actorRole: null | string;
+    readonly createdAt: Date;
+    readonly id: string;
+    readonly ip: null | string;
+    readonly subjectId: string;
+    readonly userAgent: null | string;
+}
+export declare class AuditRecordDto {
+    readonly action: string;
+    readonly actorId: null | string;
+    readonly actorRole: null | string;
+    readonly createdAt: Date;
+    readonly id: string;
+    readonly ip: null | string;
+    readonly subjectId: string;
+    readonly userAgent: null | string;
+    constructor(options: AuditRecordDtoOptionsInterface);
+}

package/dist/cjs/nest/application/queries/dtos/audit-record.dto.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditRecordDto = void 0;
+class AuditRecordDto {
+    action;
+    actorId;
+    actorRole;
+    createdAt;
+    id;
+    ip;
+    subjectId;
+    userAgent;
+    constructor(options) {
+        this.action = options.action;
+        this.actorId = options.actorId;
+        this.actorRole = options.actorRole;
+        this.createdAt = options.createdAt;
+        this.id = options.id;
+        this.ip = options.ip;
+        this.subjectId = options.subjectId;
+        this.userAgent = options.userAgent;
+    }
+}
+exports.AuditRecordDto = AuditRecordDto;

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

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

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

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./audit-record.dto.js"), exports);

package/dist/cjs/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/cjs/nest/application/queries/get-audit-records.query.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetAuditRecordsQuery = void 0;
+const nest_1 = require("@application-kit/typeorm/nest");
+class GetAuditRecordsQuery extends nest_1.ListingQuery {
+}
+exports.GetAuditRecordsQuery = GetAuditRecordsQuery;

package/dist/cjs/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/cjs/nest/application/queries/handlers/get-audit-records.handler.js

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

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

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

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

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./get-audit-records.handler.js"), exports);

package/dist/cjs/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/cjs/nest/application/queries/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dtos/index.js"), exports);
+__exportStar(require("./handlers/index.js"), exports);
+__exportStar(require("./get-audit-records.query.js"), exports);

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

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

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

@@ -0,0 +1,22 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogConsumersModule = void 0;
+const common_1 = require("@nestjs/common");
+const audit_log_module_js_1 = require("./audit-log.module.js");
+const record_audit_fact_handler_js_1 = require("./user-interface/consumers/record-audit-fact.handler.js");
+let AuditLogConsumersModule = class AuditLogConsumersModule {
+};
+exports.AuditLogConsumersModule = AuditLogConsumersModule;
+exports.AuditLogConsumersModule = AuditLogConsumersModule = __decorate([
+    (0, common_1.Module)({
+        exports: [record_audit_fact_handler_js_1.RecordAuditFactHandler],
+        imports: [audit_log_module_js_1.AuditLogModule],
+        providers: [record_audit_fact_handler_js_1.RecordAuditFactHandler],
+    })
+], AuditLogConsumersModule);

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

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

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

@@ -0,0 +1,22 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogRequestFactsModule = void 0;
+const transaction_outbox_1 = require("@application-kit/transaction-outbox");
+const common_1 = require("@nestjs/common");
+const audit_request_context_js_1 = require("./libs/audit-request-context.js");
+let AuditLogRequestFactsModule = class AuditLogRequestFactsModule {
+};
+exports.AuditLogRequestFactsModule = AuditLogRequestFactsModule;
+exports.AuditLogRequestFactsModule = AuditLogRequestFactsModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        exports: [transaction_outbox_1.TRANSACTION_OUTBOX_REQUEST_FACTS],
+        providers: [{ provide: transaction_outbox_1.TRANSACTION_OUTBOX_REQUEST_FACTS, useValue: audit_request_context_js_1.auditRequestFacts }],
+    })
+], AuditLogRequestFactsModule);

package/dist/cjs/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/cjs/nest/audit-log-web.module.js

@@ -0,0 +1,39 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogWebModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const cqrs_1 = require("@nestjs/cqrs");
+const audit_log_module_js_1 = require("./audit-log.module.js");
+const constants_js_1 = require("./constants.js");
+const audit_records_resolver_js_1 = require("./user-interface/controllers/graphql/audit-records/audit-records.resolver.js");
+const audit_request_context_interceptor_js_1 = require("./user-interface/interceptors/audit-request-context.interceptor.js");
+let AuditLogWebModule = class AuditLogWebModule {
+    static forRoot(options) {
+        return {
+            imports: [audit_log_module_js_1.AuditLogModule, cqrs_1.CqrsModule],
+            module: this,
+            providers: [
+                audit_records_resolver_js_1.AuditRecordsResolver,
+                {
+                    provide: core_1.APP_INTERCEPTOR,
+                    useClass: audit_request_context_interceptor_js_1.AuditRequestContextInterceptor,
+                },
+                {
+                    provide: constants_js_1.AUDIT_REQUEST_FACTS_RESOLVER,
+                    useValue: options.resolveRequestFacts,
+                },
+            ],
+        };
+    }
+};
+exports.AuditLogWebModule = AuditLogWebModule;
+exports.AuditLogWebModule = AuditLogWebModule = __decorate([
+    (0, common_1.Module)({})
+], AuditLogWebModule);

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

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

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

@@ -0,0 +1,37 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogModule = void 0;
+const common_1 = require("@nestjs/common");
+const cqrs_1 = require("@nestjs/cqrs");
+const typeorm_1 = require("@nestjs/typeorm");
+const get_audit_records_handler_js_1 = require("./application/queries/handlers/get-audit-records.handler.js");
+const audit_log_request_facts_module_js_1 = require("./audit-log-request-facts.module.js");
+const constants_js_1 = require("./constants.js");
+const audit_record_entity_js_1 = require("./infrastructure/database/typeorm/entities/audit-record.entity.js");
+const audit_record_repository_js_1 = require("./infrastructure/database/typeorm/repositories/audit-record.repository.js");
+let AuditLogModule = class AuditLogModule {
+};
+exports.AuditLogModule = AuditLogModule;
+exports.AuditLogModule = AuditLogModule = __decorate([
+    (0, common_1.Module)({
+        exports: [constants_js_1.AUDIT_LOG_READ_PORT, constants_js_1.AUDIT_LOG_WRITE_PORT],
+        imports: [audit_log_request_facts_module_js_1.AuditLogRequestFactsModule, cqrs_1.CqrsModule, typeorm_1.TypeOrmModule.forFeature([audit_record_entity_js_1.AuditRecordEntity])],
+        providers: [
+            get_audit_records_handler_js_1.GetAuditRecordsHandler,
+            {
+                provide: constants_js_1.AUDIT_LOG_READ_PORT,
+                useClass: audit_record_repository_js_1.AuditRecordRepository,
+            },
+            {
+                provide: constants_js_1.AUDIT_LOG_WRITE_PORT,
+                useClass: audit_record_repository_js_1.AuditRecordRepository,
+            },
+        ],
+    })
+], AuditLogModule);

package/dist/cjs/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/cjs/nest/constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIT_REQUEST_FACTS_RESOLVER = exports.AUDIT_LOG_WRITE_PORT = exports.AUDIT_LOG_READ_PORT = void 0;
+exports.AUDIT_LOG_READ_PORT = Symbol('AUDIT_LOG_READ_PORT');
+exports.AUDIT_LOG_WRITE_PORT = Symbol('AUDIT_LOG_WRITE_PORT');
+exports.AUDIT_REQUEST_FACTS_RESOLVER = Symbol('AUDIT_REQUEST_FACTS_RESOLVER');

package/dist/cjs/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/cjs/nest/domain/audit-record.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditRecord = exports.AUDIT_USER_AGENT_MAX_LENGTH = exports.AUDIT_IP_MAX_LENGTH = void 0;
+const nestjs_ddd_library_1 = require("@libs-for-dev/nestjs-ddd-library");
+exports.AUDIT_IP_MAX_LENGTH = 64;
+exports.AUDIT_USER_AGENT_MAX_LENGTH = 512;
+const truncate = (value, maxLength) => (value === null ? null : value.slice(0, maxLength));
+class AuditRecord extends nestjs_ddd_library_1.AbstractEntity {
+    static create = (properties) => new AuditRecord(nestjs_ddd_library_1.Uuid.generate(), {
+        ...properties,
+        ip: truncate(properties.ip, exports.AUDIT_IP_MAX_LENGTH),
+        userAgent: truncate(properties.userAgent, exports.AUDIT_USER_AGENT_MAX_LENGTH),
+    });
+}
+exports.AuditRecord = AuditRecord;

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

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

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

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./audit-record.js"), exports);