@hed-hog/core 0.0.295 → 0.0.296

package/dist/integration/services/outbox.processor.job.js

@@ -0,0 +1,100 @@
+"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 OutboxProcessorJob_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboxProcessorJob = void 0;
+const common_1 = require("@nestjs/common");
+const integration_settings_service_1 = require("./integration-settings.service");
+const outbox_polling_coordinator_1 = require("./outbox-polling.coordinator");
+const outbox_notifier_1 = require("./outbox.notifier");
+const outbox_processor_1 = require("./outbox.processor");
+/**
+ * Hybrid background job for outbox processing
+ * Combines startup recovery, immediate notification reactions, and periodic polling
+ */
+let OutboxProcessorJob = OutboxProcessorJob_1 = class OutboxProcessorJob {
+    constructor(processor, notifier, coordinator, integrationSettingsService) {
+        this.processor = processor;
+        this.notifier = notifier;
+        this.coordinator = coordinator;
+        this.integrationSettingsService = integrationSettingsService;
+        this.logger = new common_1.Logger(OutboxProcessorJob_1.name);
+    }
+    /**
+     * Called when module initializes
+     * 1. Drain pending events from startup
+     * 2. Start hybrid processing loop
+     */
+    async onModuleInit() {
+        const settings = await this.integrationSettingsService.getRuntimeSettings();
+        const isEnabled = settings.outboxEnabled;
+        if (!isEnabled) {
+            this.logger.debug('Outbox integration disabled in settings');
+            return;
+        }
+        // Step 1: Startup drain
+        const startupDrainEnabled = settings.startupDrainEnabled;
+        if (startupDrainEnabled) {
+            this.logger.log('Starting outbox startup drain...');
+            try {
+                const processed = await this.processor.startupDrain();
+                this.logger.log(`Outbox startup drain completed: ${processed} events`);
+            }
+            catch (error) {
+                this.logger.error('Outbox startup drain failed:', error);
+            }
+        }
+        // Step 2: Start hybrid processing loop
+        const processorEnabled = settings.outboxProcessorEnabled;
+        if (processorEnabled) {
+            this.logger.log('Starting outbox hybrid processing loop');
+            try {
+                await this.coordinator.startProcessingLoop();
+            }
+            catch (error) {
+                this.logger.error('Failed to start outbox processing loop:', error);
+            }
+        }
+        else {
+            this.logger.debug('Outbox processor disabled in settings');
+        }
+    }
+    /**
+     * Called when module is destroyed
+     * Gracefully stop the processing loop
+     */
+    async onModuleDestroy() {
+        this.logger.log('Shutting down outbox processing');
+        try {
+            await this.coordinator.stopProcessingLoop();
+        }
+        catch (error) {
+            this.logger.error('Error stopping outbox processing loop:', error);
+        }
+    }
+    /**
+     * Get current processing statistics
+     * Useful for health checks and monitoring
+     */
+    async getStats() {
+        const stats = await this.processor.getStats();
+        return Object.assign(Object.assign({}, stats), { pollingLoopRunning: this.coordinator.isRunning() });
+    }
+};
+exports.OutboxProcessorJob = OutboxProcessorJob;
+exports.OutboxProcessorJob = OutboxProcessorJob = OutboxProcessorJob_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [outbox_processor_1.OutboxProcessor,
+        outbox_notifier_1.OutboxNotifier,
+        outbox_polling_coordinator_1.OutboxPollingCoordinator,
+        integration_settings_service_1.IntegrationSettingsService])
+], OutboxProcessorJob);
+//# sourceMappingURL=outbox.processor.job.js.map

package/dist/integration/services/outbox.processor.job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.processor.job.js","sourceRoot":"","sources":["../../../src/integration/services/outbox.processor.job.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAKwB;AACxB,iFAA4E;AAC5E,6EAAwE;AACxE,uDAAmD;AACnD,yDAAqD;AAErD;;;GAGG;AAEI,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAG7B,YACmB,SAA0B,EAC1B,QAAwB,EACxB,WAAqC,EACrC,0BAAsD;QAHtD,cAAS,GAAT,SAAS,CAAiB;QAC1B,aAAQ,GAAR,QAAQ,CAAgB;QACxB,gBAAW,GAAX,WAAW,CAA0B;QACrC,+BAA0B,GAA1B,0BAA0B,CAA4B;QANxD,WAAM,GAAG,IAAI,eAAM,CAAC,oBAAkB,CAAC,IAAI,CAAC,CAAC;IAO3D,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,kBAAkB,EAAE,CAAC;QAC5E,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC;QACzC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,MAAM,mBAAmB,GAAG,QAAQ,CAAC,mBAAmB,CAAC;QAEzD,IAAI,mBAAmB,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,mCAAmC,SAAS,SAAS,CACtD,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,sBAAsB,CAAC;QAEzD,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;YAC/C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,wCAAwC,EACxC,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,uCACK,KAAK,KACR,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,IAChD;IACJ,CAAC;CACF,CAAA;AAhFY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;qCAKmB,kCAAe;QAChB,gCAAc;QACX,qDAAwB;QACT,yDAA0B;GAP9D,kBAAkB,CAgF9B"}

package/dist/integration/services/outbox.processor.js

@@ -0,0 +1,208 @@
+"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 OutboxProcessor_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboxProcessor = void 0;
+const common_1 = require("@nestjs/common");
+const types_1 = require("../types");
+const event_subscriber_registry_1 = require("./event-subscriber.registry");
+const inbox_service_1 = require("./inbox.service");
+const integration_link_service_1 = require("./integration-link.service");
+const integration_settings_service_1 = require("./integration-settings.service");
+const outbox_service_1 = require("./outbox.service");
+let OutboxProcessor = OutboxProcessor_1 = class OutboxProcessor {
+    constructor(outboxService, inboxService, linkService, registry, integrationSettingsService) {
+        this.outboxService = outboxService;
+        this.inboxService = inboxService;
+        this.linkService = linkService;
+        this.registry = registry;
+        this.integrationSettingsService = integrationSettingsService;
+        this.logger = new common_1.Logger(OutboxProcessor_1.name);
+    }
+    /**
+     * Process a batch of pending events
+     * Called in a loop or by scheduled job
+     */
+    async processBatch(options) {
+        var _a;
+        const settings = await this.integrationSettingsService.getRuntimeSettings();
+        const batchSize = (_a = options === null || options === void 0 ? void 0 : options.batchSizeOverride) !== null && _a !== void 0 ? _a : settings.batchSize;
+        const leaseMs = settings.processingLeaseMs;
+        // Find pending events
+        const events = await this.outboxService.findPending(batchSize, leaseMs);
+        if (events.length === 0) {
+            return 0;
+        }
+        this.logger.debug(`Processing ${events.length} outbox events`);
+        let processedCount = 0;
+        for (const event of events) {
+            try {
+                // Mark as processing with lease
+                await this.outboxService.markProcessing(event.id, leaseMs);
+                // Get handlers for this event
+                const handlers = this.registry.getHandlers(event.eventName);
+                if (handlers.length === 0) {
+                    this.logger.warn(`No handlers registered for event: ${event.eventName}`);
+                    // Mark as processed even though no handlers
+                    await this.outboxService.updateStatus(event.id, types_1.OutboxEventStatus.PROCESSED, {
+                        processedAt: new Date(),
+                    });
+                    processedCount++;
+                    continue;
+                }
+                // Execute each handler
+                let anyFailed = false;
+                for (const handlerDef of handlers) {
+                    const inboxEvent = await this.inboxService.getOrCreate(event.id, handlerDef.consumerName);
+                    // Skip if already processed
+                    if (inboxEvent.status === types_1.InboxEventStatus.PROCESSED) {
+                        this.logger.debug(`Event ${event.id} already processed by ${handlerDef.consumerName}`);
+                        continue;
+                    }
+                    await this.inboxService.markProcessing(inboxEvent.id);
+                    try {
+                        // Execute handler
+                        await handlerDef.handler({
+                            eventName: event.eventName,
+                            sourceModule: event.sourceModule,
+                            aggregateType: event.aggregateType,
+                            aggregateId: event.aggregateId,
+                            payload: event.payload,
+                            timestamp: event.createdAt,
+                        }, {
+                            logger: this.logger,
+                            inboxService: this.inboxService,
+                            linkService: this.linkService,
+                        });
+                        // Mark as processed
+                        await this.inboxService.markProcessed(inboxEvent.id);
+                        this.logger.debug(`Handler ${handlerDef.consumerName} processed event ${event.id}`);
+                    }
+                    catch (error) {
+                        anyFailed = true;
+                        this.logger.error(`Handler ${handlerDef.consumerName} failed for event ${event.id}:`, error);
+                        await this.inboxService.markFailed(inboxEvent.id, error instanceof Error ? error.message : String(error));
+                    }
+                }
+                // Update outbox event status based on handler results
+                if (!anyFailed) {
+                    await this.outboxService.updateStatus(event.id, types_1.OutboxEventStatus.PROCESSED, {
+                        processedAt: new Date(),
+                    });
+                    processedCount++;
+                }
+                else {
+                    // At least one handler failed, retry logic applies
+                    await this.handleEventFailure(event.id);
+                }
+            }
+            catch (error) {
+                this.logger.error(`Error processing event ${event.id}:`, error);
+                await this.handleEventFailure(event.id);
+            }
+        }
+        return processedCount;
+    }
+    /**
+     * Handle event that failed to process
+     */
+    async handleEventFailure(eventId) {
+        const settings = await this.integrationSettingsService.getRuntimeSettings();
+        const maxAttempts = settings.maxAttempts;
+        const retryBaseDelayMs = settings.retryBaseDelayMs;
+        const deadLetterEnabled = settings.deadLetterEnabled;
+        const event = await this.outboxService.getById(eventId);
+        if (!event) {
+            return;
+        }
+        const nextAttemptCount = event.attemptCount + 1;
+        if (nextAttemptCount >= maxAttempts) {
+            if (deadLetterEnabled) {
+                this.logger.warn(`Event ${eventId} moved to dead letter after ${maxAttempts} attempts`);
+                await this.outboxService.updateStatus(eventId, types_1.OutboxEventStatus.DEAD_LETTER, {
+                    attemptCount: nextAttemptCount,
+                });
+            }
+            else {
+                this.logger.warn(`Event ${eventId} failed after ${maxAttempts} attempts (dead letter disabled)`);
+                await this.outboxService.updateStatus(eventId, types_1.OutboxEventStatus.FAILED, {
+                    attemptCount: nextAttemptCount,
+                });
+            }
+        }
+        else {
+            // Calculate exponential backoff
+            const delayMs = retryBaseDelayMs * Math.pow(2, event.attemptCount);
+            const availableAt = new Date(Date.now() + delayMs);
+            this.logger.debug(`Retrying event ${eventId} in ${delayMs}ms (attempt ${nextAttemptCount}/${maxAttempts})`);
+            await this.outboxService.updateStatus(eventId, types_1.OutboxEventStatus.PENDING, {
+                attemptCount: nextAttemptCount,
+                availableAt,
+            });
+        }
+    }
+    /**
+     * Process all pending events at startup (drain)
+     */
+    async startupDrain() {
+        const settings = await this.integrationSettingsService.getRuntimeSettings();
+        const drainBatchSize = settings.startupDrainBatchSize;
+        this.logger.log(`Starting outbox drain with batch size: ${drainBatchSize}`);
+        let totalProcessed = 0;
+        // Keep processing until no more events
+        let processed = 1;
+        while (processed > 0) {
+            processed = await this.processBatch({
+                batchSizeOverride: drainBatchSize,
+            });
+            totalProcessed += processed;
+            // Small delay to prevent overwhelming the system
+            if (processed > 0) {
+                await new Promise((resolve) => setTimeout(resolve, 100));
+            }
+        }
+        this.logger.log(`Startup drain completed. Processed ${totalProcessed} events`);
+        return totalProcessed;
+    }
+    /**
+     * Get processor statistics
+     */
+    async getStats() {
+        const pendingCount = await this.outboxService.countByStatus(types_1.OutboxEventStatus.PENDING);
+        const processingCount = await this.outboxService.countByStatus(types_1.OutboxEventStatus.PROCESSING);
+        const processedCount = await this.outboxService.countByStatus(types_1.OutboxEventStatus.PROCESSED);
+        const failedCount = await this.outboxService.countByStatus(types_1.OutboxEventStatus.FAILED);
+        const deadLetterCount = await this.outboxService.countByStatus(types_1.OutboxEventStatus.DEAD_LETTER);
+        return {
+            pending: pendingCount,
+            processing: processingCount,
+            processed: processedCount,
+            failed: failedCount,
+            dead_letter: deadLetterCount,
+            total: pendingCount +
+                processingCount +
+                processedCount +
+                failedCount +
+                deadLetterCount,
+            handlerCount: this.registry.getHandlerCount(),
+        };
+    }
+};
+exports.OutboxProcessor = OutboxProcessor;
+exports.OutboxProcessor = OutboxProcessor = OutboxProcessor_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [outbox_service_1.OutboxService,
+        inbox_service_1.InboxService,
+        integration_link_service_1.IntegrationLinkService,
+        event_subscriber_registry_1.EventSubscriberRegistry,
+        integration_settings_service_1.IntegrationSettingsService])
+], OutboxProcessor);
+//# sourceMappingURL=outbox.processor.js.map

package/dist/integration/services/outbox.processor.js.map

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

package/dist/integration/services/outbox.service.d.ts

@@ -0,0 +1,53 @@
+import { PrismaService } from '@hed-hog/api-prisma';
+import { OutboxEvent, OutboxEventStatus } from '../types';
+export interface CreateOutboxEventDto {
+    eventName: string;
+    sourceModule: string;
+    aggregateType: string;
+    aggregateId: string;
+    payload: Record<string, any>;
+}
+export interface OutboxEventPersistenceClient {
+    outbox_event: PrismaService['outbox_event'];
+}
+export declare class OutboxService {
+    private readonly prisma;
+    constructor(prisma: PrismaService);
+    private toDomainEvent;
+    private toDatabaseId;
+    private toDatabaseUpdate;
+    /**
+     * Write a new event to the outbox
+     */
+    createEvent(dto: CreateOutboxEventDto, persistenceClient?: OutboxEventPersistenceClient): Promise<OutboxEvent>;
+    /**
+     * Find pending events available for processing, ordered by creation time
+     */
+    findPending(limit: number, leaseMs: number): Promise<OutboxEvent[]>;
+    /**
+     * Update event status and related fields
+     */
+    updateStatus(eventId: string | number, status: OutboxEventStatus, partialUpdate?: {
+        attemptCount?: number;
+        lastError?: string | null;
+        availableAt?: Date;
+        processedAt?: Date | null;
+    }): Promise<OutboxEvent>;
+    /**
+     * Mark event as processing and set lease time
+     */
+    markProcessing(eventId: string | number, leaseMs: number): Promise<OutboxEvent>;
+    /**
+     * Increment attempt count and optionally update error
+     */
+    incrementAttempt(eventId: string | number, error?: string): Promise<OutboxEvent>;
+    /**
+     * Get event by ID
+     */
+    getById(eventId: string | number): Promise<OutboxEvent | null>;
+    /**
+     * Count events by status
+     */
+    countByStatus(status: OutboxEventStatus): Promise<number>;
+}
+//# sourceMappingURL=outbox.service.d.ts.map

package/dist/integration/services/outbox.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.service.d.ts","sourceRoot":"","sources":["../../../src/integration/services/outbox.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CAC7C;AAkBD,qBACa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACG,WAAW,CACf,GAAG,EAAE,oBAAoB,EACzB,iBAAiB,CAAC,EAAE,4BAA4B,GAC/C,OAAO,CAAC,WAAW,CAAC;IAmBvB;;OAEG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,EAAE,CAAC;IAqBzB;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,iBAAiB,EACzB,aAAa,CAAC,EAAE;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,WAAW,CAAC,EAAE,IAAI,CAAC;QACnB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;KAC3B,GACA,OAAO,CAAC,WAAW,CAAC;IAYvB;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC;IAOvB;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAgBvB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQpE;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAKhE"}

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

@@ -0,0 +1,149 @@
+"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.OutboxService = void 0;
+const api_prisma_1 = require("@hed-hog/api-prisma");
+const common_1 = require("@nestjs/common");
+const types_1 = require("../types");
+let OutboxService = class OutboxService {
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    toDomainEvent(record) {
+        return {
+            id: String(record.id),
+            eventName: record.event_name,
+            sourceModule: record.source_module,
+            aggregateType: record.aggregate_type,
+            aggregateId: record.aggregate_id,
+            payload: record.payload,
+            status: record.status,
+            attemptCount: record.attempt_count,
+            lastError: record.last_error,
+            availableAt: record.available_at,
+            processedAt: record.processed_at,
+            createdAt: record.created_at,
+            updatedAt: record.updated_at,
+        };
+    }
+    toDatabaseId(eventId) {
+        return typeof eventId === 'number' ? eventId : Number(eventId);
+    }
+    toDatabaseUpdate(partialUpdate) {
+        if (!partialUpdate) {
+            return undefined;
+        }
+        return {
+            attempt_count: partialUpdate.attemptCount,
+            last_error: partialUpdate.lastError,
+            available_at: partialUpdate.availableAt,
+            processed_at: partialUpdate.processedAt,
+        };
+    }
+    /**
+     * Write a new event to the outbox
+     */
+    async createEvent(dto, persistenceClient) {
+        const client = persistenceClient !== null && persistenceClient !== void 0 ? persistenceClient : this.prisma;
+        const record = await client.outbox_event.create({
+            data: {
+                event_name: dto.eventName,
+                source_module: dto.sourceModule,
+                aggregate_type: dto.aggregateType,
+                aggregate_id: dto.aggregateId,
+                payload: dto.payload,
+                status: types_1.OutboxEventStatus.PENDING,
+                available_at: new Date(),
+                attempt_count: 0,
+            },
+        });
+        return this.toDomainEvent(record);
+    }
+    /**
+     * Find pending events available for processing, ordered by creation time
+     */
+    async findPending(limit, leaseMs) {
+        const now = new Date();
+        const leaseThreshold = new Date(now.getTime() - leaseMs);
+        const records = await this.prisma.outbox_event.findMany({
+            where: {
+                OR: [
+                    { status: types_1.OutboxEventStatus.PENDING },
+                    {
+                        status: types_1.OutboxEventStatus.PROCESSING,
+                        available_at: { lte: leaseThreshold },
+                    },
+                ],
+            },
+            orderBy: { created_at: 'asc' },
+            take: limit,
+        });
+        return records.map((record) => this.toDomainEvent(record));
+    }
+    /**
+     * Update event status and related fields
+     */
+    async updateStatus(eventId, status, partialUpdate) {
+        const record = await this.prisma.outbox_event.update({
+            where: { id: this.toDatabaseId(eventId) },
+            data: Object.assign({ status }, this.toDatabaseUpdate(partialUpdate)),
+        });
+        return this.toDomainEvent(record);
+    }
+    /**
+     * Mark event as processing and set lease time
+     */
+    async markProcessing(eventId, leaseMs) {
+        const leaseUntil = new Date(Date.now() + leaseMs);
+        return this.updateStatus(eventId, types_1.OutboxEventStatus.PROCESSING, {
+            availableAt: leaseUntil,
+        });
+    }
+    /**
+     * Increment attempt count and optionally update error
+     */
+    async incrementAttempt(eventId, error) {
+        const record = await this.prisma.outbox_event.findUnique({
+            where: { id: this.toDatabaseId(eventId) },
+        });
+        if (!record) {
+            throw new Error(`Event ${eventId} not found`);
+        }
+        const event = this.toDomainEvent(record);
+        return this.updateStatus(eventId, event.status, {
+            attemptCount: event.attemptCount + 1,
+            lastError: error || null,
+        });
+    }
+    /**
+     * Get event by ID
+     */
+    async getById(eventId) {
+        const record = await this.prisma.outbox_event.findUnique({
+            where: { id: this.toDatabaseId(eventId) },
+        });
+        return record ? this.toDomainEvent(record) : null;
+    }
+    /**
+     * Count events by status
+     */
+    async countByStatus(status) {
+        return this.prisma.outbox_event.count({
+            where: { status },
+        });
+    }
+};
+exports.OutboxService = OutboxService;
+exports.OutboxService = OutboxService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [api_prisma_1.PrismaService])
+], OutboxService);
+//# sourceMappingURL=outbox.service.js.map

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

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

package/dist/integration/types/event.types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Event status throughout the integration lifecycle
+ */
+export declare enum OutboxEventStatus {
+    PENDING = "pending",
+    PROCESSING = "processing",
+    PROCESSED = "processed",
+    FAILED = "failed",
+    DEAD_LETTER = "dead_letter"
+}
+/**
+ * Inbox event processing status per consumer
+ */
+export declare enum InboxEventStatus {
+    RECEIVED = "received",
+    PROCESSING = "processing",
+    PROCESSED = "processed",
+    FAILED = "failed",
+    SKIPPED = "skipped"
+}
+/**
+ * Type of link between entities from different modules
+ */
+export declare enum LinkType {
+    REFERENCE = "reference",
+    CASCADE = "cascade",
+    AGGREGATE_ROOT = "aggregate_root"
+}
+/**
+ * Domain event interface that is published and processed
+ */
+export interface DomainEvent {
+    eventName: string;
+    sourceModule: string;
+    aggregateType: string;
+    aggregateId: string;
+    payload: Record<string, any>;
+    timestamp: Date;
+}
+/**
+ * Outbox event record from database
+ */
+export interface OutboxEvent {
+    id: string;
+    eventName: string;
+    sourceModule: string;
+    aggregateType: string;
+    aggregateId: string;
+    payload: Record<string, any>;
+    status: OutboxEventStatus;
+    attemptCount: number;
+    lastError: string | null;
+    availableAt: Date;
+    processedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Inbox event record from database for idempotency tracking
+ */
+export interface InboxEvent {
+    id: string;
+    outboxEventId: string;
+    consumerName: string;
+    status: InboxEventStatus;
+    attemptCount: number;
+    lastError: string | null;
+    processedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Integration link between entities across modules
+ */
+export interface IntegrationLink {
+    id: string;
+    sourceModule: string;
+    sourceEntityType: string;
+    sourceEntityId: string;
+    targetModule: string;
+    targetEntityType: string;
+    targetEntityId: string;
+    linkType: LinkType;
+    metadata: Record<string, any> | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=event.types.d.ts.map

package/dist/integration/types/event.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.types.d.ts","sourceRoot":"","sources":["../../../src/integration/types/event.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,CAAC;IAClB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}