@russ-b/nestjs-common-tools 2.1.1 → 2.2.0

package/dist/modules/outbox/services/outbox.service.js

@@ -0,0 +1,235 @@
+"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.OutboxService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("typeorm");
+const entities_1 = require("../entities");
+const enums_1 = require("../enums");
+const outbox_constants_1 = require("../outbox.constants");
+let OutboxService = class OutboxService {
+    constructor(outboxRepository, options) {
+        this.outboxRepository = outboxRepository;
+        this.options = options;
+    }
+    getOperationalPolicy() {
+        return this.options.operationalPolicy;
+    }
+    async createEvent(eventType, payload, manager) {
+        const repo = manager
+            ? manager.getRepository(entities_1.OutboxEvent)
+            : this.outboxRepository;
+        const event = repo.create({
+            eventType,
+            payload,
+            status: enums_1.OutboxEventStatus.PENDING,
+        });
+        return repo.save(event);
+    }
+    async claimById(eventId) {
+        return this.outboxRepository.manager.transaction(async (manager) => {
+            const processingStartedAt = new Date();
+            const result = await manager
+                .createQueryBuilder()
+                .update(entities_1.OutboxEvent)
+                .set({
+                status: enums_1.OutboxEventStatus.PROCESSING,
+                processingStartedAt,
+            })
+                .where('id = :id', { id: eventId })
+                .andWhere('status = :status', { status: enums_1.OutboxEventStatus.PENDING })
+                .execute();
+            if (!result.affected) {
+                return null;
+            }
+            return manager.findOne(entities_1.OutboxEvent, { where: { id: eventId } });
+        });
+    }
+    async claimPendingEventsByTypes(eventTypes, limit = this.options.operationalPolicy.claimBatchSize) {
+        if (eventTypes.length === 0) {
+            return [];
+        }
+        return this.outboxRepository.manager.transaction(async (manager) => {
+            const events = await manager
+                .createQueryBuilder(entities_1.OutboxEvent, 'outbox')
+                .where('outbox.status = :status', { status: enums_1.OutboxEventStatus.PENDING })
+                .andWhere('outbox.eventType IN (:...eventTypes)', { eventTypes })
+                .orderBy('outbox.createdAt', 'ASC')
+                .limit(limit)
+                .setLock('pessimistic_write')
+                .setOnLocked('skip_locked')
+                .getMany();
+            if (events.length > 0) {
+                const eventIds = events.map((e) => e.id);
+                const processingStartedAt = new Date();
+                await manager
+                    .createQueryBuilder()
+                    .update(entities_1.OutboxEvent)
+                    .set({
+                    status: enums_1.OutboxEventStatus.PROCESSING,
+                    processingStartedAt,
+                })
+                    .whereInIds(eventIds)
+                    .execute();
+                events.forEach((e) => {
+                    e.status = enums_1.OutboxEventStatus.PROCESSING;
+                    e.processingStartedAt = processingStartedAt;
+                });
+            }
+            return events;
+        });
+    }
+    async claimPendingEvents(eventType, limit = this.options.operationalPolicy.claimBatchSize) {
+        return this.outboxRepository.manager.transaction(async (manager) => {
+            // Fetch pending events with pessimistic lock
+            const events = await manager
+                .createQueryBuilder(entities_1.OutboxEvent, 'outbox')
+                .where('outbox.status = :status', { status: enums_1.OutboxEventStatus.PENDING })
+                .andWhere('outbox.eventType = :eventType', { eventType })
+                .orderBy('outbox.createdAt', 'ASC')
+                .limit(limit)
+                .setLock('pessimistic_write')
+                .setOnLocked('skip_locked')
+                .getMany();
+            // Immediately mark as PROCESSING while we hold the lock
+            if (events.length > 0) {
+                const eventIds = events.map((e) => e.id);
+                const processingStartedAt = new Date();
+                await manager
+                    .createQueryBuilder()
+                    .update(entities_1.OutboxEvent)
+                    .set({
+                    status: enums_1.OutboxEventStatus.PROCESSING,
+                    processingStartedAt,
+                })
+                    .whereInIds(eventIds)
+                    .execute();
+                // Update the in-memory objects too
+                events.forEach((e) => {
+                    e.status = enums_1.OutboxEventStatus.PROCESSING;
+                    e.processingStartedAt = processingStartedAt;
+                });
+            }
+            return events;
+        });
+    }
+    async markAsProcessing(eventId) {
+        await this.outboxRepository.update(eventId, {
+            status: enums_1.OutboxEventStatus.PROCESSING,
+            processingStartedAt: new Date(),
+        });
+    }
+    async markAsProcessed(eventId, expectedProcessingStartedAt) {
+        return this.updateEvent(eventId, {
+            status: enums_1.OutboxEventStatus.PROCESSED,
+            processingStartedAt: null,
+            processedAt: new Date(),
+        }, expectedProcessingStartedAt);
+    }
+    async incrementRetry(eventId, error, maxRetries = this.options.operationalPolicy.maxRetries, expectedProcessingStartedAt) {
+        const event = await this.findEventForProcessingUpdate(eventId, expectedProcessingStartedAt);
+        if (!event) {
+            return false;
+        }
+        const newRetryCount = event.retryCount + 1;
+        if (newRetryCount >= maxRetries) {
+            return this.updateEvent(eventId, {
+                status: enums_1.OutboxEventStatus.FAILED,
+                lastError: error,
+                retryCount: newRetryCount,
+                processingStartedAt: null,
+            }, expectedProcessingStartedAt);
+        }
+        return this.updateEvent(eventId, {
+            status: enums_1.OutboxEventStatus.PENDING,
+            lastError: error,
+            retryCount: newRetryCount,
+            processingStartedAt: null,
+        }, expectedProcessingStartedAt);
+    }
+    async markAsFailed(eventId, error, expectedProcessingStartedAt) {
+        const event = await this.findEventForProcessingUpdate(eventId, expectedProcessingStartedAt);
+        return this.updateEvent(eventId, {
+            status: enums_1.OutboxEventStatus.FAILED,
+            lastError: error,
+            retryCount: event?.retryCount || 0,
+            processingStartedAt: null,
+        }, expectedProcessingStartedAt);
+    }
+    async deleteProcessed(olderThanHours = this.options.operationalPolicy
+        .processedEventRetentionHours) {
+        const threshold = new Date(Date.now() - olderThanHours * 60 * 60 * 1000);
+        const result = await this.outboxRepository
+            .createQueryBuilder()
+            .delete()
+            .where('status = :status', { status: enums_1.OutboxEventStatus.PROCESSED })
+            .andWhere('processed_at < :threshold', { threshold })
+            .execute();
+        return result.affected || 0;
+    }
+    async resetStaleProcessingEvents(staleMinutes = this.options.operationalPolicy.staleProcessingMinutes) {
+        const staleThreshold = new Date(Date.now() - staleMinutes * 60 * 1000);
+        const result = await this.outboxRepository
+            .createQueryBuilder()
+            .update(entities_1.OutboxEvent)
+            .set({
+            status: enums_1.OutboxEventStatus.PENDING,
+            processingStartedAt: null,
+        })
+            .where('status = :status', { status: enums_1.OutboxEventStatus.PROCESSING })
+            .andWhere('processing_started_at < :staleThreshold', { staleThreshold })
+            .execute();
+        return result.affected || 0;
+    }
+    async findEventForProcessingUpdate(eventId, expectedProcessingStartedAt) {
+        const query = this.outboxRepository
+            .createQueryBuilder('outbox')
+            .where('outbox.id = :eventId', { eventId });
+        this.addProcessingOwnershipCondition(query, expectedProcessingStartedAt);
+        return query.getOne();
+    }
+    async updateEvent(eventId, values, expectedProcessingStartedAt) {
+        const query = this.outboxRepository
+            .createQueryBuilder()
+            .update(entities_1.OutboxEvent)
+            .set(values)
+            .where('id = :eventId', { eventId });
+        this.addProcessingOwnershipCondition(query, expectedProcessingStartedAt);
+        const result = await query.execute();
+        return Boolean(result.affected);
+    }
+    addProcessingOwnershipCondition(query, expectedProcessingStartedAt) {
+        if (expectedProcessingStartedAt === undefined) {
+            return;
+        }
+        query.andWhere('status = :processingStatus', {
+            processingStatus: enums_1.OutboxEventStatus.PROCESSING,
+        });
+        if (expectedProcessingStartedAt === null) {
+            query.andWhere('processing_started_at IS NULL');
+            return;
+        }
+        query.andWhere('processing_started_at = :expectedProcessingStartedAt', {
+            expectedProcessingStartedAt,
+        });
+    }
+};
+exports.OutboxService = OutboxService;
+exports.OutboxService = OutboxService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(outbox_constants_1.OUTBOX_EVENT_REPOSITORY)),
+    __param(1, (0, common_1.Inject)(outbox_constants_1.OUTBOX_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [typeorm_1.Repository, Object])
+], OutboxService);
+//# sourceMappingURL=outbox.service.js.map

package/dist/modules/outbox/services/outbox.service.js.map

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

package/dist/modules/outbox/types/index.d.ts

@@ -0,0 +1 @@
+export * from './outbox-module-options.interface';

package/dist/modules/outbox/types/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("./outbox-module-options.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/modules/outbox/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/outbox/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oEAAkD"}

package/dist/modules/outbox/types/outbox-module-options.interface.d.ts

@@ -0,0 +1,35 @@
+import type { ModuleMetadata } from '@nestjs/common';
+import type { DataSource, DataSourceOptions } from 'typeorm';
+export type OutboxDataSource = DataSource | DataSourceOptions | string;
+export interface OutboxOperationalPolicy {
+    claimBatchSize?: number;
+    maxRetries?: number;
+    staleProcessingMinutes?: number;
+    resetStaleProcessingEvents?: boolean;
+    maxConcurrentEvents?: number;
+    processedEventRetentionHours?: number;
+}
+export interface OutboxResolvedOperationalPolicy {
+    claimBatchSize: number;
+    maxRetries: number;
+    staleProcessingMinutes: number;
+    resetStaleProcessingEvents: boolean;
+    maxConcurrentEvents?: number;
+    processedEventRetentionHours: number;
+}
+export interface OutboxModuleOptions {
+    operationalPolicy?: OutboxOperationalPolicy;
+}
+export interface OutboxModuleRootOptions extends OutboxModuleOptions {
+    dataSource?: OutboxDataSource;
+    global?: boolean;
+}
+export interface OutboxModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useFactory: (...args: any[]) => Promise<OutboxModuleOptions> | OutboxModuleOptions;
+    inject?: any[];
+    dataSource?: OutboxDataSource;
+    global?: boolean;
+}
+export interface OutboxResolvedModuleOptions {
+    operationalPolicy: OutboxResolvedOperationalPolicy;
+}

package/dist/modules/outbox/types/outbox-module-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=outbox-module-options.interface.js.map

package/dist/modules/outbox/types/outbox-module-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-module-options.interface.js","sourceRoot":"","sources":["../../../../src/modules/outbox/types/outbox-module-options.interface.ts"],"names":[],"mappings":""}

package/dist/zod/filters/index.d.ts

@@ -0,0 +1,3 @@
+export * from './zod-express-exception.filter';
+export * from './zod-fastify-exception.filter';
+export * from './zod-validation-error-response';

package/dist/zod/filters/index.js

@@ -0,0 +1,20 @@
+"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("./zod-express-exception.filter"), exports);
+__exportStar(require("./zod-fastify-exception.filter"), exports);
+__exportStar(require("./zod-validation-error-response"), exports);
+//# sourceMappingURL=index.js.map

package/dist/zod/filters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/zod/filters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,iEAA+C;AAC/C,kEAAgD"}

package/dist/zod/filters/zod-express-exception.filter.d.ts

@@ -0,0 +1,8 @@
+import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+import { ZodError } from 'zod';
+import { ZodExceptionFilterOptions } from './zod-validation-error-response';
+export declare class ZodExpressExceptionFilter implements ExceptionFilter<ZodError> {
+    private readonly options;
+    constructor(options?: ZodExceptionFilterOptions);
+    catch(exception: ZodError, host: ArgumentsHost): void;
+}

package/dist/zod/filters/zod-express-exception.filter.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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZodExpressExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const zod_validation_error_response_1 = require("./zod-validation-error-response");
+let ZodExpressExceptionFilter = class ZodExpressExceptionFilter {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    catch(exception, host) {
+        if (host.getType() !== 'http') {
+            throw exception;
+        }
+        const response = host.switchToHttp().getResponse();
+        response
+            .status(common_1.HttpStatus.BAD_REQUEST)
+            .json((0, zod_validation_error_response_1.createZodValidationErrorResponse)(exception, this.options));
+    }
+};
+exports.ZodExpressExceptionFilter = ZodExpressExceptionFilter;
+exports.ZodExpressExceptionFilter = ZodExpressExceptionFilter = __decorate([
+    (0, common_1.Catch)(zod_1.ZodError),
+    __metadata("design:paramtypes", [Object])
+], ZodExpressExceptionFilter);
+//# sourceMappingURL=zod-express-exception.filter.js.map

package/dist/zod/filters/zod-express-exception.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-express-exception.filter.js","sourceRoot":"","sources":["../../../src/zod/filters/zod-express-exception.filter.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAKwB;AAExB,6BAA+B;AAC/B,mFAGyC;AAGlC,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,YAA6B,UAAqC,EAAE;QAAvC,YAAO,GAAP,OAAO,CAAgC;IAAG,CAAC;IAExE,KAAK,CAAC,SAAmB,EAAE,IAAmB;QAC5C,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;YAC9B,MAAM,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,WAAW,EAAY,CAAC;QAE7D,QAAQ;aACL,MAAM,CAAC,mBAAU,CAAC,WAAW,CAAC;aAC9B,IAAI,CAAC,IAAA,gEAAgC,EAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;CACF,CAAA;AAdY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,cAAK,EAAC,cAAQ,CAAC;;GACH,yBAAyB,CAcrC"}

package/dist/zod/filters/zod-fastify-exception.filter.d.ts

@@ -0,0 +1,8 @@
+import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+import { ZodError } from 'zod';
+import { ZodExceptionFilterOptions } from './zod-validation-error-response';
+export declare class ZodFastifyExceptionFilter implements ExceptionFilter<ZodError> {
+    private readonly options;
+    constructor(options?: ZodExceptionFilterOptions);
+    catch(exception: ZodError, host: ArgumentsHost): void;
+}

package/dist/zod/filters/zod-fastify-exception.filter.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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZodFastifyExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const zod_validation_error_response_1 = require("./zod-validation-error-response");
+let ZodFastifyExceptionFilter = class ZodFastifyExceptionFilter {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    catch(exception, host) {
+        if (host.getType() !== 'http') {
+            throw exception;
+        }
+        const response = host.switchToHttp().getResponse();
+        response
+            .code(common_1.HttpStatus.BAD_REQUEST)
+            .send((0, zod_validation_error_response_1.createZodValidationErrorResponse)(exception, this.options));
+    }
+};
+exports.ZodFastifyExceptionFilter = ZodFastifyExceptionFilter;
+exports.ZodFastifyExceptionFilter = ZodFastifyExceptionFilter = __decorate([
+    (0, common_1.Catch)(zod_1.ZodError),
+    __metadata("design:paramtypes", [Object])
+], ZodFastifyExceptionFilter);
+//# sourceMappingURL=zod-fastify-exception.filter.js.map

package/dist/zod/filters/zod-fastify-exception.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-fastify-exception.filter.js","sourceRoot":"","sources":["../../../src/zod/filters/zod-fastify-exception.filter.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAKwB;AAExB,6BAA+B;AAC/B,mFAGyC;AAGlC,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,YAA6B,UAAqC,EAAE;QAAvC,YAAO,GAAP,OAAO,CAAgC;IAAG,CAAC;IAExE,KAAK,CAAC,SAAmB,EAAE,IAAmB;QAC5C,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;YAC9B,MAAM,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,WAAW,EAAgB,CAAC;QAEjE,QAAQ;aACL,IAAI,CAAC,mBAAU,CAAC,WAAW,CAAC;aAC5B,IAAI,CAAC,IAAA,gEAAgC,EAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;CACF,CAAA;AAdY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,cAAK,EAAC,cAAQ,CAAC;;GACH,yBAAyB,CAcrC"}

package/dist/zod/filters/zod-validation-error-response.d.ts

@@ -0,0 +1,6 @@
+import type { ZodError } from 'zod';
+import type { ApiErrorResponse } from '../../errors';
+export interface ZodExceptionFilterOptions {
+    message?: string;
+}
+export declare function createZodValidationErrorResponse(exception: ZodError, options?: ZodExceptionFilterOptions): ApiErrorResponse;

package/dist/zod/filters/zod-validation-error-response.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createZodValidationErrorResponse = createZodValidationErrorResponse;
+const common_1 = require("@nestjs/common");
+const errors_1 = require("../../errors");
+const DEFAULT_VALIDATION_ERROR_MESSAGE = 'Validation failed';
+function createZodValidationErrorResponse(exception, options = {}) {
+    return (0, errors_1.createApiErrorResponse)({
+        statusCode: common_1.HttpStatus.BAD_REQUEST,
+        message: options.message ?? DEFAULT_VALIDATION_ERROR_MESSAGE,
+        code: errors_1.ApiErrorCode.VALIDATION_FAILED,
+        errors: exception.issues.map((issue) => ({
+            field: formatZodIssuePath(issue.path),
+            message: issue.message,
+        })),
+    });
+}
+function formatZodIssuePath(path) {
+    if (path.length === 0) {
+        return errors_1.API_ERROR_ROOT_FIELD;
+    }
+    return path.map(String).join('.');
+}
+//# sourceMappingURL=zod-validation-error-response.js.map

package/dist/zod/filters/zod-validation-error-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-validation-error-response.js","sourceRoot":"","sources":["../../../src/zod/filters/zod-validation-error-response.ts"],"names":[],"mappings":";;AAeA,4EAaC;AA5BD,2CAA4C;AAE5C,yCAIsB;AAOtB,MAAM,gCAAgC,GAAG,mBAAmB,CAAC;AAE7D,SAAgB,gCAAgC,CAC9C,SAAmB,EACnB,UAAqC,EAAE;IAEvC,OAAO,IAAA,+BAAsB,EAAC;QAC5B,UAAU,EAAE,mBAAU,CAAC,WAAW;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,gCAAgC;QAC5D,IAAI,EAAE,qBAAY,CAAC,iBAAiB;QACpC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;YACrC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,IAA4B;IAE5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,6BAAoB,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/zod/index.d.ts

@@ -0,0 +1 @@
+export * from './filters';

package/dist/zod/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("./filters"), exports);
+//# sourceMappingURL=index.js.map

package/dist/zod/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/zod/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@russ-b/nestjs-common-tools",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "NestJS utility tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -64,10 +64,26 @@
       "types": "./dist/modules/index.d.ts",
       "default": "./dist/modules/index.js"
     },
+    "./modules/outbox": {
+      "types": "./dist/modules/outbox/index.d.ts",
+      "default": "./dist/modules/outbox/index.js"
+    },
     "./logger": {
       "types": "./dist/logger/index.d.ts",
       "default": "./dist/logger/index.js"
     },
+    "./logger/pino": {
+      "types": "./dist/logger/pino/index.d.ts",
+      "default": "./dist/logger/pino/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "default": "./dist/errors/index.js"
+    },
+    "./zod": {
+      "types": "./dist/zod/index.d.ts",
+      "default": "./dist/zod/index.js"
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {
@@ -93,8 +109,20 @@
       "modules": [
         "dist/modules/index.d.ts"
       ],
+      "modules/outbox": [
+        "dist/modules/outbox/index.d.ts"
+      ],
       "logger": [
         "dist/logger/index.d.ts"
+      ],
+      "logger/pino": [
+        "dist/logger/pino/index.d.ts"
+      ],
+      "errors": [
+        "dist/errors/index.d.ts"
+      ],
+      "zod": [
+        "dist/zod/index.d.ts"
       ]
     }
   },
@@ -110,11 +138,37 @@
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/config": "^3.0.0 || ^4.0.0",
     "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
+    "fastify": "^4.0.0 || ^5.0.0",
     "nest-winston": "^1.10.2",
+    "nestjs-pino": "^4.6.1",
+    "pino": "^10.3.1",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.1.3",
     "typeorm": "^0.3.20",
     "winston": "^3.17.0",
+    "winston-loki": "^6.1.3",
     "winston-transport": "^4.9.0",
-    "winston-loki": "^6.1.3"
+    "zod": "^3.0.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "fastify": {
+      "optional": true
+    },
+    "nestjs-pino": {
+      "optional": true
+    },
+    "pino": {
+      "optional": true
+    },
+    "pino-http": {
+      "optional": true
+    },
+    "pino-pretty": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",
@@ -126,12 +180,18 @@
     "eslint": "^9.18.0",
     "eslint-config-prettier": "^10.0.1",
     "eslint-plugin-prettier": "^5.2.2",
+    "fastify": "^5.8.5",
     "jest": "^29.7.0",
+    "nestjs-pino": "^4.6.1",
+    "pino": "^10.3.1",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.1.3",
     "prettier": "^3.4.2",
     "ts-jest": "^29.2.5",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^5.7.3",
-    "typescript-eslint": "^8.20.0"
+    "typescript-eslint": "^8.20.0",
+    "zod": "^4.0.0"
   },
   "jest": {
     "moduleFileExtensions": [

package/dist/common/filters/index.d.ts

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

package/dist/common/filters/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/filters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC"}