legend-transactional 2.2.2 → 2.3.0

package/dist/index.d.mts

@@ -72,6 +72,12 @@ declare const availableMicroservices: {
      * Represents the "legend-storage" microservice.
      */
     readonly Storage: "legend-storage";
+    /**
+     * Represents the "audit-eda" microservice for event-driven architecture auditing.
+     * This microservice consumes audit events (audit.received, audit.processed, audit.dead_letter)
+     * to track event lifecycle and debugging purposes.
+     */
+    readonly AuditEda: "audit-eda";
 };
 /**
  * Type of available microservices in the system.
@@ -345,6 +351,17 @@ interface EventPayload {
     'legend_rankings.rankings_finished': {
         completedRankings: CompletedRanking[];
     };
+    /**
+     * Event to deliver intermediate reward (e.g., first game)
+     */
+    'legend_rankings.intermediate_reward': {
+        userId: string;
+        rankingId: number;
+        intermediateRewardType: string;
+        rewardConfig: Record<string, unknown>;
+        templateName: string;
+        templateData: Record<string, unknown>;
+    };
     /**
      * Event to notify when a ranking is created
      */
@@ -449,6 +466,89 @@ interface EventPayload {
         bucketName: string;
         filePaths: string[];
     };
+    /**
+     * Emitted when an event is received by a microservice before processing starts (audit tracking)
+     */
+    'audit.received': {
+        /**
+         * The microservice that received the event
+         */
+        microservice: string;
+        /**
+         * The event that was received
+         */
+        receivedEvent: string;
+        /**
+         * Timestamp when the event was received (UNIX timestamp in seconds)
+         */
+        receivedAt: number;
+        /**
+         * The queue name from which the event was consumed
+         */
+        queueName: string;
+        /**
+         * Optional event identifier for tracking
+         */
+        eventId?: string;
+    };
+    /**
+     * Emitted when an event is successfully processed by a microservice for audit tracking
+     */
+    'audit.processed': {
+        /**
+         * The microservice that processed the event
+         */
+        microservice: string;
+        /**
+         * The original event that was processed
+         */
+        processedEvent: string;
+        /**
+         * Timestamp when the event was processed (UNIX timestamp in seconds)
+         */
+        processedAt: number;
+        /**
+         * The queue name where the event was consumed
+         */
+        queueName: string;
+        /**
+         * Optional event identifier for tracking
+         */
+        eventId?: string;
+    };
+    /**
+     * Emitted when a message is rejected/nacked and sent to dead letter queue
+     */
+    'audit.dead_letter': {
+        /**
+         * The microservice that rejected the event
+         */
+        microservice: string;
+        /**
+         * The original event that was rejected
+         */
+        rejectedEvent: string;
+        /**
+         * Timestamp when the event was rejected (UNIX timestamp in seconds)
+         */
+        rejectedAt: number;
+        /**
+         * The queue name where the event was rejected from
+         */
+        queueName: string;
+        /**
+         * Reason for rejection (delay, fibonacci_strategy, etc.)
+         */
+        rejectionReason: 'delay' | 'fibonacci_strategy';
+        /**
+         * Optional retry count
+         */
+        retryCount?: number;
+        /**
+         * Optional event identifier for tracking
+         */
+        eventId?: string;
+    };
 }
 /**
  * Represents the available events in the system.
@@ -456,6 +556,9 @@ interface EventPayload {
 declare const microserviceEvent: {
     readonly 'TEST.IMAGE': "test.image";
     readonly 'TEST.MINT': "test.mint";
+    readonly 'AUDIT.RECEIVED': "audit.received";
+    readonly 'AUDIT.PROCESSED': "audit.processed";
+    readonly 'AUDIT.DEAD_LETTER': "audit.dead_letter";
     readonly 'AUTH.DELETED_USER': "auth.deleted_user";
     readonly 'AUTH.LOGOUT_USER': "auth.logout_user";
     readonly 'AUTH.NEW_USER': "auth.new_user";
@@ -472,6 +575,7 @@ declare const microserviceEvent: {
     readonly 'LEGEND_MISSIONS.SEND_EMAIL_NFT_MISSION_COMPLETED': "legend_missions.send_email_nft_mission_completed";
     readonly 'LEGEND_RANKINGS.RANKINGS_FINISHED': "legend_rankings.rankings_finished";
     readonly 'LEGEND_RANKINGS.NEW_RANKING_CREATED': "legend_rankings.new_ranking_created";
+    readonly 'LEGEND_RANKINGS.INTERMEDIATE_REWARD': "legend_rankings.intermediate_reward";
     readonly 'LEGEND_SHOWCASE.PRODUCT_VIRTUAL_DELETED': "legend_showcase.product_virtual_deleted";
     readonly 'LEGEND_SHOWCASE.UPDATE_ALLOWED_MISSION_SUBSCRIPTION_IDS': "legend_showcase.update_allowed_mission_subscription_ids";
     readonly 'LEGEND_SHOWCASE.UPDATE_ALLOWED_RANKING_SUBSCRIPTION_IDS': "legend_showcase.update_allowed_ranking_subscription_ids";
@@ -547,7 +651,7 @@ declare abstract class ConsumeChannel {
      *
      * @see NACKING_DELAY_MS
      */
-    nackWithDelay: (delay?: number, maxRetries?: number) => {
+    nackWithDelay(delay?: number, maxRetries?: number): {
         count: number;
         delay: number;
     };
@@ -564,7 +668,7 @@ declare abstract class ConsumeChannel {
      *   - `occurrence`: The current occurrence count for the Fibonacci sequence.
      * @see MAX_OCCURRENCE
      */
-    nackWithFibonacciStrategy: (maxOccurrence?: number, maxRetries?: number) => {
+    nackWithFibonacciStrategy(maxOccurrence?: number, maxRetries?: number): {
         count: number;
         delay: number;
         occurrence: number;
@@ -583,14 +687,48 @@ declare abstract class ConsumeChannel {
 
 /**
  * Represents a **_consume_** channel for handling saga events/commands.
- * Extends the abstract ConsumeChannel class.
+ * Extends the abstract ConsumeChannel class with automatic audit event emission.
  *
  */
 declare class EventsConsumeChannel extends ConsumeChannel {
+    /**
+     * The microservice name that is processing the event
+     */
+    private readonly microservice;
+    /**
+     * The original event that was received
+     */
+    private readonly processedEvent;
+    /**
+     * Creates a new EventsConsumeChannel instance
+     *
+     * @param channel - The AMQP Channel
+     * @param msg - The consumed message
+     * @param queueName - The queue name
+     * @param microservice - The microservice name processing the event
+     * @param processedEvent - The event type being processed
+     */
+    constructor(channel: Channel, msg: ConsumeMessage, queueName: string, microservice: string, processedEvent: string);
     /**
      * Acknowledges the consumed saga event/command.
+     * Automatically emits audit.processed event after successful ACK.
      */
     ackMessage(): void;
+    /**
+     * Override nackWithDelay to emit audit.dead_letter event
+     */
+    nackWithDelay(delay?: number, maxRetries?: number): {
+        count: number;
+        delay: number;
+    };
+    /**
+     * Override nackWithFibonacciStrategy to emit audit.dead_letter event
+     */
+    nackWithFibonacciStrategy(maxOccurrence?: number, maxRetries?: number): {
+        count: number;
+        delay: number;
+        occurrence: number;
+    };
 }
 
 /**
@@ -611,6 +749,13 @@ type MicroserviceConsumeEvents<T extends MicroserviceEvent> = {
  * Represents the names of specific message queues in the RabbitMQ context.
  */
 declare const queue: {
+    /**
+     * Audit queue names for separate audit event types
+     * @constant
+     */
+    readonly AuditReceived: "audit_received_commands";
+    readonly AuditProcessed: "audit_processed_commands";
+    readonly AuditDeadLetter: "audit_dead_letter_commands";
     /**
      * Queue used for sending replies in response to saga events.
      */
@@ -624,6 +769,10 @@ declare const queue: {
  * Represents the names of exchanges, which act as message routing hubs in the RabbitMQ context.
  */
 declare const exchange: {
+    /**
+     * Audit exchange name for direct routing of audit events
+     */
+    readonly Audit: "audit_exchange";
     /**
      * Exchange dedicated to requeueing messages that require further processing in a saga process
      */
@@ -681,6 +830,15 @@ declare const authCommands: {
  */
 type AuthCommands = (typeof authCommands)[keyof typeof authCommands];
 
+/**
+ * Different commands related to the "audit-eda" microservice.
+ */
+declare const auditEdaCommands: {};
+/**
+ * Available commands for the "audit-eda" microservice.
+ */
+type AuditEdaCommands = (typeof auditEdaCommands)[keyof typeof auditEdaCommands];
+
 /**
  * Different commands related to the "blockchain" microservice.
  */
@@ -895,6 +1053,10 @@ interface CommandMap {
      * Represents the mapping of "auth" microservice commands.
      */
     [availableMicroservices.Auth]: AuthCommands;
+    /**
+     * Represents the mapping of "audit-eda" microservice commands.
+     */
+    [availableMicroservices.AuditEda]: AuditEdaCommands;
     /**
      * Represents the mapping of "blockchain" microservice commands.
      */
@@ -1160,6 +1322,24 @@ declare const createConsumers: (consumers: QueueConsumerProps[]) => Promise<void
  */
 declare const createHeaderConsumers: (queueName: string, events: MicroserviceEvent[]) => Promise<void>;
 
+/**
+ * Creates audit logging infrastructure with direct exchange and separate queues
+ * Uses direct exchange for efficient single-consumer delivery to audit microservice
+ *
+ * This function sets up the RabbitMQ infrastructure needed for audit event tracking:
+ * - Creates a direct exchange for audit events
+ * - Creates 3 separate queues (audit.received, audit.processed, audit.dead_letter)
+ * - Binds each queue to the audit exchange with appropriate routing keys
+ *
+ * The direct exchange strategy ensures that:
+ * - Only the audit microservice consumes audit events
+ * - Routing is efficient (no pattern matching needed)
+ * - Each audit event type has its own queue for isolation
+ *
+ * @internal This is called automatically when connecting to events
+ */
+declare const createAuditLoggingResources: () => Promise<void>;
+
 declare const sagaTitle: {
     /**
      * Saga used in the flow to purchase resources and deduct coins from the user.
@@ -1745,4 +1925,22 @@ declare const getEventObject: (event: MicroserviceEvent) => {
     [x: string]: MicroserviceEvent;
 };
 
-export { type AuthCommands, type AvailableMicroservices, type BlockchainCommands, type CoinsCommands, type CommandMap, type CommenceSaga, type CommenceSagaEvents, type CommenceSagaHandler, type CompletedRanking, type EventPayload, EventsConsumeChannel, type EventsHandler, type Exchange, type Gender, MAX_NACK_RETRIES, MAX_OCCURRENCE, type MicroserviceCommand, MicroserviceConsumeChannel, type MicroserviceConsumeEvents, type MicroserviceConsumeSagaEvents, type MicroserviceEvent, type MicroserviceHandler, NACKING_DELAY_MS, type Nack, type PaymentEmailType, PaymentEmailTypes, type QueueConsumerProps, type RankingWinners, type RankingsCommands, type RapidMessagingCommands, type Room, type RoomCreatorCommands, type RoomInventoryCommands, type RoomSnapshotCommands, type RoomType, RoomTypes, Saga, SagaCommenceConsumeChannel, type SagaCommencePayload, SagaConsumeChannel, type SagaConsumeSagaEvents, type SagaHandler, type SagaStep, type SagaStepDefaults, type SagaTitle, type SendEmailCommands, type ShowcaseCommands, type SocialCommands, type SocialMediaRoomsCommands, type SocialUser, type Status, type StorageCommands, type TestImageCommands, type TestMintCommands, Transactional, type TransactionalConfig, type UserLocation, authCommands, availableMicroservices, blockchainCommands, closeConsumeChannel, closeRabbitMQConn, closeSendChannel, coinsCommands, commenceSaga, commenceSagaConsumeCallback, commenceSagaListener, connectToEvents, connectToSagaCommandEmitter, consume, createConsumers, createHeaderConsumers, eventCallback, exchange, fibonacci, gender, getConsumeChannel, getEventKey, getEventObject, getQueueConsumer, getQueueName, getRabbitMQConn, getSendChannel, isConnectionHealthy, microserviceEvent, nodeDataDefaults, publishEvent, queue, rankingsCommands, rapidMessagingCommands, roomCreatorCommands, roomInventoryCommands, roomSnapshotCommands, sagaConsumeCallback, sagaStepCallback, sagaTitle, saveQueueForHealthCheck, saveUri, sendEmailCommands, sendToQueue, showcaseCommands, socialCommands, socialMediaRoomsCommands, startGlobalSagaStepListener, status, stopRabbitMQ, storageCommands, testImageCommands, testMintCommands };
+/**
+ * Extracts the microservice name from a queue name
+ *
+ * Queue names follow the pattern: `{microservice}_match_commands` or `{microservice}_saga_commands`
+ * This utility extracts the microservice part from the queue name.
+ *
+ * @param queueName - The queue name (e.g., 'auth_match_commands', 'coins_saga_commands')
+ * @returns The microservice name (e.g., 'auth', 'coins')
+ *
+ * @example
+ * ```typescript
+ * extractMicroserviceFromQueue('auth_match_commands'); // Returns: 'auth'
+ * extractMicroserviceFromQueue('coins_saga_commands'); // Returns: 'coins'
+ * extractMicroserviceFromQueue('audit-eda_match_commands'); // Returns: 'audit-eda'
+ * ```
+ */
+declare function extractMicroserviceFromQueue(queueName: string): string;
+
+export { type AuditEdaCommands, type AuthCommands, type AvailableMicroservices, type BlockchainCommands, type CoinsCommands, type CommandMap, type CommenceSaga, type CommenceSagaEvents, type CommenceSagaHandler, type CompletedRanking, type EventPayload, EventsConsumeChannel, type EventsHandler, type Exchange, type Gender, MAX_NACK_RETRIES, MAX_OCCURRENCE, type MicroserviceCommand, MicroserviceConsumeChannel, type MicroserviceConsumeEvents, type MicroserviceConsumeSagaEvents, type MicroserviceEvent, type MicroserviceHandler, NACKING_DELAY_MS, type Nack, type PaymentEmailType, PaymentEmailTypes, type QueueConsumerProps, type RankingWinners, type RankingsCommands, type RapidMessagingCommands, type Room, type RoomCreatorCommands, type RoomInventoryCommands, type RoomSnapshotCommands, type RoomType, RoomTypes, Saga, SagaCommenceConsumeChannel, type SagaCommencePayload, SagaConsumeChannel, type SagaConsumeSagaEvents, type SagaHandler, type SagaStep, type SagaStepDefaults, type SagaTitle, type SendEmailCommands, type ShowcaseCommands, type SocialCommands, type SocialMediaRoomsCommands, type SocialUser, type Status, type StorageCommands, type TestImageCommands, type TestMintCommands, Transactional, type TransactionalConfig, type UserLocation, auditEdaCommands, authCommands, availableMicroservices, blockchainCommands, closeConsumeChannel, closeRabbitMQConn, closeSendChannel, coinsCommands, commenceSaga, commenceSagaConsumeCallback, commenceSagaListener, connectToEvents, connectToSagaCommandEmitter, consume, createAuditLoggingResources, createConsumers, createHeaderConsumers, eventCallback, exchange, extractMicroserviceFromQueue, fibonacci, gender, getConsumeChannel, getEventKey, getEventObject, getQueueConsumer, getQueueName, getRabbitMQConn, getSendChannel, isConnectionHealthy, microserviceEvent, nodeDataDefaults, publishEvent, queue, rankingsCommands, rapidMessagingCommands, roomCreatorCommands, roomInventoryCommands, roomSnapshotCommands, sagaConsumeCallback, sagaStepCallback, sagaTitle, saveQueueForHealthCheck, saveUri, sendEmailCommands, sendToQueue, showcaseCommands, socialCommands, socialMediaRoomsCommands, startGlobalSagaStepListener, status, stopRabbitMQ, storageCommands, testImageCommands, testMintCommands };

package/dist/index.d.ts

@@ -72,6 +72,12 @@ declare const availableMicroservices: {
      * Represents the "legend-storage" microservice.
      */
     readonly Storage: "legend-storage";
+    /**
+     * Represents the "audit-eda" microservice for event-driven architecture auditing.
+     * This microservice consumes audit events (audit.received, audit.processed, audit.dead_letter)
+     * to track event lifecycle and debugging purposes.
+     */
+    readonly AuditEda: "audit-eda";
 };
 /**
  * Type of available microservices in the system.
@@ -345,6 +351,17 @@ interface EventPayload {
     'legend_rankings.rankings_finished': {
         completedRankings: CompletedRanking[];
     };
+    /**
+     * Event to deliver intermediate reward (e.g., first game)
+     */
+    'legend_rankings.intermediate_reward': {
+        userId: string;
+        rankingId: number;
+        intermediateRewardType: string;
+        rewardConfig: Record<string, unknown>;
+        templateName: string;
+        templateData: Record<string, unknown>;
+    };
     /**
      * Event to notify when a ranking is created
      */
@@ -449,6 +466,89 @@ interface EventPayload {
         bucketName: string;
         filePaths: string[];
     };
+    /**
+     * Emitted when an event is received by a microservice before processing starts (audit tracking)
+     */
+    'audit.received': {
+        /**
+         * The microservice that received the event
+         */
+        microservice: string;
+        /**
+         * The event that was received
+         */
+        receivedEvent: string;
+        /**
+         * Timestamp when the event was received (UNIX timestamp in seconds)
+         */
+        receivedAt: number;
+        /**
+         * The queue name from which the event was consumed
+         */
+        queueName: string;
+        /**
+         * Optional event identifier for tracking
+         */
+        eventId?: string;
+    };
+    /**
+     * Emitted when an event is successfully processed by a microservice for audit tracking
+     */
+    'audit.processed': {
+        /**
+         * The microservice that processed the event
+         */
+        microservice: string;
+        /**
+         * The original event that was processed
+         */
+        processedEvent: string;
+        /**
+         * Timestamp when the event was processed (UNIX timestamp in seconds)
+         */
+        processedAt: number;
+        /**
+         * The queue name where the event was consumed
+         */
+        queueName: string;
+        /**
+         * Optional event identifier for tracking
+         */
+        eventId?: string;
+    };
+    /**
+     * Emitted when a message is rejected/nacked and sent to dead letter queue
+     */
+    'audit.dead_letter': {
+        /**
+         * The microservice that rejected the event
+         */
+        microservice: string;
+        /**
+         * The original event that was rejected
+         */
+        rejectedEvent: string;
+        /**
+         * Timestamp when the event was rejected (UNIX timestamp in seconds)
+         */
+        rejectedAt: number;
+        /**
+         * The queue name where the event was rejected from
+         */
+        queueName: string;
+        /**
+         * Reason for rejection (delay, fibonacci_strategy, etc.)
+         */
+        rejectionReason: 'delay' | 'fibonacci_strategy';
+        /**
+         * Optional retry count
+         */
+        retryCount?: number;
+        /**
+         * Optional event identifier for tracking
+         */
+        eventId?: string;
+    };
 }
 /**
  * Represents the available events in the system.
@@ -456,6 +556,9 @@ interface EventPayload {
 declare const microserviceEvent: {
     readonly 'TEST.IMAGE': "test.image";
     readonly 'TEST.MINT': "test.mint";
+    readonly 'AUDIT.RECEIVED': "audit.received";
+    readonly 'AUDIT.PROCESSED': "audit.processed";
+    readonly 'AUDIT.DEAD_LETTER': "audit.dead_letter";
     readonly 'AUTH.DELETED_USER': "auth.deleted_user";
     readonly 'AUTH.LOGOUT_USER': "auth.logout_user";
     readonly 'AUTH.NEW_USER': "auth.new_user";
@@ -472,6 +575,7 @@ declare const microserviceEvent: {
     readonly 'LEGEND_MISSIONS.SEND_EMAIL_NFT_MISSION_COMPLETED': "legend_missions.send_email_nft_mission_completed";
     readonly 'LEGEND_RANKINGS.RANKINGS_FINISHED': "legend_rankings.rankings_finished";
     readonly 'LEGEND_RANKINGS.NEW_RANKING_CREATED': "legend_rankings.new_ranking_created";
+    readonly 'LEGEND_RANKINGS.INTERMEDIATE_REWARD': "legend_rankings.intermediate_reward";
     readonly 'LEGEND_SHOWCASE.PRODUCT_VIRTUAL_DELETED': "legend_showcase.product_virtual_deleted";
     readonly 'LEGEND_SHOWCASE.UPDATE_ALLOWED_MISSION_SUBSCRIPTION_IDS': "legend_showcase.update_allowed_mission_subscription_ids";
     readonly 'LEGEND_SHOWCASE.UPDATE_ALLOWED_RANKING_SUBSCRIPTION_IDS': "legend_showcase.update_allowed_ranking_subscription_ids";
@@ -547,7 +651,7 @@ declare abstract class ConsumeChannel {
      *
      * @see NACKING_DELAY_MS
      */
-    nackWithDelay: (delay?: number, maxRetries?: number) => {
+    nackWithDelay(delay?: number, maxRetries?: number): {
         count: number;
         delay: number;
     };
@@ -564,7 +668,7 @@ declare abstract class ConsumeChannel {
      *   - `occurrence`: The current occurrence count for the Fibonacci sequence.
      * @see MAX_OCCURRENCE
      */
-    nackWithFibonacciStrategy: (maxOccurrence?: number, maxRetries?: number) => {
+    nackWithFibonacciStrategy(maxOccurrence?: number, maxRetries?: number): {
         count: number;
         delay: number;
         occurrence: number;
@@ -583,14 +687,48 @@ declare abstract class ConsumeChannel {
 
 /**
  * Represents a **_consume_** channel for handling saga events/commands.
- * Extends the abstract ConsumeChannel class.
+ * Extends the abstract ConsumeChannel class with automatic audit event emission.
  *
  */
 declare class EventsConsumeChannel extends ConsumeChannel {
+    /**
+     * The microservice name that is processing the event
+     */
+    private readonly microservice;
+    /**
+     * The original event that was received
+     */
+    private readonly processedEvent;
+    /**
+     * Creates a new EventsConsumeChannel instance
+     *
+     * @param channel - The AMQP Channel
+     * @param msg - The consumed message
+     * @param queueName - The queue name
+     * @param microservice - The microservice name processing the event
+     * @param processedEvent - The event type being processed
+     */
+    constructor(channel: Channel, msg: ConsumeMessage, queueName: string, microservice: string, processedEvent: string);
     /**
      * Acknowledges the consumed saga event/command.
+     * Automatically emits audit.processed event after successful ACK.
      */
     ackMessage(): void;
+    /**
+     * Override nackWithDelay to emit audit.dead_letter event
+     */
+    nackWithDelay(delay?: number, maxRetries?: number): {
+        count: number;
+        delay: number;
+    };
+    /**
+     * Override nackWithFibonacciStrategy to emit audit.dead_letter event
+     */
+    nackWithFibonacciStrategy(maxOccurrence?: number, maxRetries?: number): {
+        count: number;
+        delay: number;
+        occurrence: number;
+    };
 }
 
 /**
@@ -611,6 +749,13 @@ type MicroserviceConsumeEvents<T extends MicroserviceEvent> = {
  * Represents the names of specific message queues in the RabbitMQ context.
  */
 declare const queue: {
+    /**
+     * Audit queue names for separate audit event types
+     * @constant
+     */
+    readonly AuditReceived: "audit_received_commands";
+    readonly AuditProcessed: "audit_processed_commands";
+    readonly AuditDeadLetter: "audit_dead_letter_commands";
     /**
      * Queue used for sending replies in response to saga events.
      */
@@ -624,6 +769,10 @@ declare const queue: {
  * Represents the names of exchanges, which act as message routing hubs in the RabbitMQ context.
  */
 declare const exchange: {
+    /**
+     * Audit exchange name for direct routing of audit events
+     */
+    readonly Audit: "audit_exchange";
     /**
      * Exchange dedicated to requeueing messages that require further processing in a saga process
      */
@@ -681,6 +830,15 @@ declare const authCommands: {
  */
 type AuthCommands = (typeof authCommands)[keyof typeof authCommands];
 
+/**
+ * Different commands related to the "audit-eda" microservice.
+ */
+declare const auditEdaCommands: {};
+/**
+ * Available commands for the "audit-eda" microservice.
+ */
+type AuditEdaCommands = (typeof auditEdaCommands)[keyof typeof auditEdaCommands];
+
 /**
  * Different commands related to the "blockchain" microservice.
  */
@@ -895,6 +1053,10 @@ interface CommandMap {
      * Represents the mapping of "auth" microservice commands.
      */
     [availableMicroservices.Auth]: AuthCommands;
+    /**
+     * Represents the mapping of "audit-eda" microservice commands.
+     */
+    [availableMicroservices.AuditEda]: AuditEdaCommands;
     /**
      * Represents the mapping of "blockchain" microservice commands.
      */
@@ -1160,6 +1322,24 @@ declare const createConsumers: (consumers: QueueConsumerProps[]) => Promise<void
  */
 declare const createHeaderConsumers: (queueName: string, events: MicroserviceEvent[]) => Promise<void>;
 
+/**
+ * Creates audit logging infrastructure with direct exchange and separate queues
+ * Uses direct exchange for efficient single-consumer delivery to audit microservice
+ *
+ * This function sets up the RabbitMQ infrastructure needed for audit event tracking:
+ * - Creates a direct exchange for audit events
+ * - Creates 3 separate queues (audit.received, audit.processed, audit.dead_letter)
+ * - Binds each queue to the audit exchange with appropriate routing keys
+ *
+ * The direct exchange strategy ensures that:
+ * - Only the audit microservice consumes audit events
+ * - Routing is efficient (no pattern matching needed)
+ * - Each audit event type has its own queue for isolation
+ *
+ * @internal This is called automatically when connecting to events
+ */
+declare const createAuditLoggingResources: () => Promise<void>;
+
 declare const sagaTitle: {
     /**
      * Saga used in the flow to purchase resources and deduct coins from the user.
@@ -1745,4 +1925,22 @@ declare const getEventObject: (event: MicroserviceEvent) => {
     [x: string]: MicroserviceEvent;
 };
 
-export { type AuthCommands, type AvailableMicroservices, type BlockchainCommands, type CoinsCommands, type CommandMap, type CommenceSaga, type CommenceSagaEvents, type CommenceSagaHandler, type CompletedRanking, type EventPayload, EventsConsumeChannel, type EventsHandler, type Exchange, type Gender, MAX_NACK_RETRIES, MAX_OCCURRENCE, type MicroserviceCommand, MicroserviceConsumeChannel, type MicroserviceConsumeEvents, type MicroserviceConsumeSagaEvents, type MicroserviceEvent, type MicroserviceHandler, NACKING_DELAY_MS, type Nack, type PaymentEmailType, PaymentEmailTypes, type QueueConsumerProps, type RankingWinners, type RankingsCommands, type RapidMessagingCommands, type Room, type RoomCreatorCommands, type RoomInventoryCommands, type RoomSnapshotCommands, type RoomType, RoomTypes, Saga, SagaCommenceConsumeChannel, type SagaCommencePayload, SagaConsumeChannel, type SagaConsumeSagaEvents, type SagaHandler, type SagaStep, type SagaStepDefaults, type SagaTitle, type SendEmailCommands, type ShowcaseCommands, type SocialCommands, type SocialMediaRoomsCommands, type SocialUser, type Status, type StorageCommands, type TestImageCommands, type TestMintCommands, Transactional, type TransactionalConfig, type UserLocation, authCommands, availableMicroservices, blockchainCommands, closeConsumeChannel, closeRabbitMQConn, closeSendChannel, coinsCommands, commenceSaga, commenceSagaConsumeCallback, commenceSagaListener, connectToEvents, connectToSagaCommandEmitter, consume, createConsumers, createHeaderConsumers, eventCallback, exchange, fibonacci, gender, getConsumeChannel, getEventKey, getEventObject, getQueueConsumer, getQueueName, getRabbitMQConn, getSendChannel, isConnectionHealthy, microserviceEvent, nodeDataDefaults, publishEvent, queue, rankingsCommands, rapidMessagingCommands, roomCreatorCommands, roomInventoryCommands, roomSnapshotCommands, sagaConsumeCallback, sagaStepCallback, sagaTitle, saveQueueForHealthCheck, saveUri, sendEmailCommands, sendToQueue, showcaseCommands, socialCommands, socialMediaRoomsCommands, startGlobalSagaStepListener, status, stopRabbitMQ, storageCommands, testImageCommands, testMintCommands };
+/**
+ * Extracts the microservice name from a queue name
+ *
+ * Queue names follow the pattern: `{microservice}_match_commands` or `{microservice}_saga_commands`
+ * This utility extracts the microservice part from the queue name.
+ *
+ * @param queueName - The queue name (e.g., 'auth_match_commands', 'coins_saga_commands')
+ * @returns The microservice name (e.g., 'auth', 'coins')
+ *
+ * @example
+ * ```typescript
+ * extractMicroserviceFromQueue('auth_match_commands'); // Returns: 'auth'
+ * extractMicroserviceFromQueue('coins_saga_commands'); // Returns: 'coins'
+ * extractMicroserviceFromQueue('audit-eda_match_commands'); // Returns: 'audit-eda'
+ * ```
+ */
+declare function extractMicroserviceFromQueue(queueName: string): string;
+
+export { type AuditEdaCommands, type AuthCommands, type AvailableMicroservices, type BlockchainCommands, type CoinsCommands, type CommandMap, type CommenceSaga, type CommenceSagaEvents, type CommenceSagaHandler, type CompletedRanking, type EventPayload, EventsConsumeChannel, type EventsHandler, type Exchange, type Gender, MAX_NACK_RETRIES, MAX_OCCURRENCE, type MicroserviceCommand, MicroserviceConsumeChannel, type MicroserviceConsumeEvents, type MicroserviceConsumeSagaEvents, type MicroserviceEvent, type MicroserviceHandler, NACKING_DELAY_MS, type Nack, type PaymentEmailType, PaymentEmailTypes, type QueueConsumerProps, type RankingWinners, type RankingsCommands, type RapidMessagingCommands, type Room, type RoomCreatorCommands, type RoomInventoryCommands, type RoomSnapshotCommands, type RoomType, RoomTypes, Saga, SagaCommenceConsumeChannel, type SagaCommencePayload, SagaConsumeChannel, type SagaConsumeSagaEvents, type SagaHandler, type SagaStep, type SagaStepDefaults, type SagaTitle, type SendEmailCommands, type ShowcaseCommands, type SocialCommands, type SocialMediaRoomsCommands, type SocialUser, type Status, type StorageCommands, type TestImageCommands, type TestMintCommands, Transactional, type TransactionalConfig, type UserLocation, auditEdaCommands, authCommands, availableMicroservices, blockchainCommands, closeConsumeChannel, closeRabbitMQConn, closeSendChannel, coinsCommands, commenceSaga, commenceSagaConsumeCallback, commenceSagaListener, connectToEvents, connectToSagaCommandEmitter, consume, createAuditLoggingResources, createConsumers, createHeaderConsumers, eventCallback, exchange, extractMicroserviceFromQueue, fibonacci, gender, getConsumeChannel, getEventKey, getEventObject, getQueueConsumer, getQueueName, getRabbitMQConn, getSendChannel, isConnectionHealthy, microserviceEvent, nodeDataDefaults, publishEvent, queue, rankingsCommands, rapidMessagingCommands, roomCreatorCommands, roomInventoryCommands, roomSnapshotCommands, sagaConsumeCallback, sagaStepCallback, sagaTitle, saveQueueForHealthCheck, saveUri, sendEmailCommands, sendToQueue, showcaseCommands, socialCommands, socialMediaRoomsCommands, startGlobalSagaStepListener, status, stopRabbitMQ, storageCommands, testImageCommands, testMintCommands };

package/dist/index.js

@@ -75,7 +75,13 @@ var availableMicroservices = {
   /**
    * Represents the "legend-storage" microservice.
    */
-  Storage: "legend-storage"
+  Storage: "legend-storage",
+  /**
+   * Represents the "audit-eda" microservice for event-driven architecture auditing.
+   * This microservice consumes audit events (audit.received, audit.processed, audit.dead_letter)
+   * to track event lifecycle and debugging purposes.
+   */
+  AuditEda: "audit-eda"
 };
 
 // src/@types/event/events.ts
@@ -98,6 +104,11 @@ var microserviceEvent = {
   "TEST.IMAGE": "test.image",
   "TEST.MINT": "test.mint",
   ///////////////////////////
+  // AUDIT EVENTS - For tracking event lifecycle
+  "AUDIT.RECEIVED": "audit.received",
+  "AUDIT.PROCESSED": "audit.processed",
+  "AUDIT.DEAD_LETTER": "audit.dead_letter",
+  ///////////////////////////
   "AUTH.DELETED_USER": "auth.deleted_user",
   "AUTH.LOGOUT_USER": "auth.logout_user",
   "AUTH.NEW_USER": "auth.new_user",
@@ -114,6 +125,7 @@ var microserviceEvent = {
   "LEGEND_MISSIONS.SEND_EMAIL_NFT_MISSION_COMPLETED": "legend_missions.send_email_nft_mission_completed",
   "LEGEND_RANKINGS.RANKINGS_FINISHED": "legend_rankings.rankings_finished",
   "LEGEND_RANKINGS.NEW_RANKING_CREATED": "legend_rankings.new_ranking_created",
+  "LEGEND_RANKINGS.INTERMEDIATE_REWARD": "legend_rankings.intermediate_reward",
   "LEGEND_SHOWCASE.PRODUCT_VIRTUAL_DELETED": "legend_showcase.product_virtual_deleted",
   "LEGEND_SHOWCASE.UPDATE_ALLOWED_MISSION_SUBSCRIPTION_IDS": "legend_showcase.update_allowed_mission_subscription_ids",
   "LEGEND_SHOWCASE.UPDATE_ALLOWED_RANKING_SUBSCRIPTION_IDS": "legend_showcase.update_allowed_ranking_subscription_ids",
@@ -131,6 +143,13 @@ var microserviceEvent = {
 
 // src/@types/rabbit-mq.ts
 var queue = {
+  /**
+   * Audit queue names for separate audit event types
+   * @constant
+   */
+  AuditReceived: "audit_received_commands",
+  AuditProcessed: "audit_processed_commands",
+  AuditDeadLetter: "audit_dead_letter_commands",
   /**
    * Queue used for sending replies in response to saga events.
    */
@@ -141,6 +160,10 @@ var queue = {
   CommenceSaga: "commence_saga"
 };
 var exchange = {
+  /**
+   * Audit exchange name for direct routing of audit events
+   */
+  Audit: "audit_exchange",
   /**
    * Exchange dedicated to requeueing messages that require further processing in a saga process
    */
@@ -175,6 +198,9 @@ var authCommands = {
   CreateUser: "create_user"
 };
 
+// src/@types/saga/commands/audit-eda.ts
+var auditEdaCommands = {};
+
 // src/@types/saga/commands/blockchain.ts
 var blockchainCommands = {
   /**
@@ -457,6 +483,11 @@ var getEventObject = (event) => {
   };
 };
 
+// src/utils/extractMicroservice.ts
+function extractMicroserviceFromQueue(queueName) {
+  return queueName.replace(/_match_commands$/, "").replace(/_saga_commands$/, "");
+}
+
 // src/Consumer/channels/Consume.ts
 var ConsumeChannel = class {
   /**
@@ -496,10 +527,10 @@ var ConsumeChannel = class {
    *
    * @see NACKING_DELAY_MS
    */
-  nackWithDelay = (delay = NACKING_DELAY_MS, maxRetries) => {
+  nackWithDelay(delay = NACKING_DELAY_MS, maxRetries) {
     const { delay: delayNackRetry, count } = this.nack({ delay, maxRetries });
     return { count, delay: delayNackRetry };
-  };
+  }
   /**
    * Negatively acknowledges (NACKs) the message using a Fibonacci backoff strategy.
    *
@@ -513,9 +544,9 @@ var ConsumeChannel = class {
    *   - `occurrence`: The current occurrence count for the Fibonacci sequence.
    * @see MAX_OCCURRENCE
    */
-  nackWithFibonacciStrategy = (maxOccurrence = MAX_OCCURRENCE, maxRetries) => {
+  nackWithFibonacciStrategy(maxOccurrence = MAX_OCCURRENCE, maxRetries) {
     return this.nack({ maxOccurrence, maxRetries });
-  };
+  }
   /**
    * Private helper function to handle the actual NACK logic.
    *
@@ -525,11 +556,7 @@ var ConsumeChannel = class {
    *   - `delay` and `maxRetries`: For linear backoff with a fixed delay and retry limit.
    *   - `maxOccurrence`: For Fibonacci backoff with a maximum occurrence count.
    */
-  nack = ({
-    maxRetries,
-    maxOccurrence,
-    delay
-  }) => {
+  nack({ maxRetries, maxOccurrence, delay }) {
     const { msg, queueName, channel } = this;
     channel.nack(msg, false, false);
     let count = 0;
@@ -586,7 +613,7 @@ var ConsumeChannel = class {
       });
     }
     return { count, delay: nackDelay, occurrence };
-  };
+  }
 };
 var Consume_default = ConsumeChannel;
 
@@ -618,13 +645,109 @@ var commenceSagaConsumeCallback = (msg, channel, e, queueName) => {
   e.emit(saga.title, { saga, channel: responseChannel });
 };
 
+// src/Broker/PublishAuditEvent.ts
+async function publishAuditEvent(channel, eventType, payload) {
+  try {
+    const routingKey = eventType;
+    const messageBuffer = Buffer.from(JSON.stringify(payload));
+    channel.publish(exchange.Audit, routingKey, messageBuffer, {
+      contentType: "application/json",
+      deliveryMode: 2
+      // persistent
+    });
+  } catch (error) {
+    console.error(`Failed to publish audit event ${eventType}:`, error);
+  }
+}
+async function publishAuditReceived(channel, payload) {
+  await publishAuditEvent(channel, "audit.received", payload);
+}
+async function publishAuditProcessed(channel, payload) {
+  await publishAuditEvent(channel, "audit.processed", payload);
+}
+async function publishAuditDeadLetter(channel, payload) {
+  await publishAuditEvent(channel, "audit.dead_letter", payload);
+}
+
 // src/Consumer/channels/Events.ts
 var EventsConsumeChannel = class extends Consume_default {
+  /**
+   * The microservice name that is processing the event
+   */
+  microservice;
+  /**
+   * The original event that was received
+   */
+  processedEvent;
+  /**
+   * Creates a new EventsConsumeChannel instance
+   *
+   * @param channel - The AMQP Channel
+   * @param msg - The consumed message
+   * @param queueName - The queue name
+   * @param microservice - The microservice name processing the event
+   * @param processedEvent - The event type being processed
+   */
+  constructor(channel, msg, queueName, microservice, processedEvent) {
+    super(channel, msg, queueName);
+    this.microservice = microservice;
+    this.processedEvent = processedEvent;
+  }
   /**
    * Acknowledges the consumed saga event/command.
+   * Automatically emits audit.processed event after successful ACK.
    */
   ackMessage() {
     this.channel.ack(this.msg, false);
+    const timestamp = Math.floor(Date.now() / 1e3);
+    publishAuditProcessed(this.channel, {
+      microservice: this.microservice,
+      processedEvent: this.processedEvent,
+      processedAt: timestamp,
+      queueName: this.queueName,
+      eventId: void 0
+      // Optional: can be enhanced later
+    }).catch((error) => {
+      console.error("Failed to emit audit.processed event:", error);
+    });
+  }
+  /**
+   * Override nackWithDelay to emit audit.dead_letter event
+   */
+  nackWithDelay(delay = NACKING_DELAY_MS, maxRetries) {
+    const parentNack = super.nackWithDelay(delay, maxRetries);
+    const timestamp = Math.floor(Date.now() / 1e3);
+    publishAuditDeadLetter(this.channel, {
+      microservice: this.microservice,
+      rejectedEvent: this.processedEvent,
+      rejectedAt: timestamp,
+      queueName: this.queueName,
+      rejectionReason: "delay",
+      retryCount: parentNack.count,
+      eventId: void 0
+    }).catch((error) => {
+      console.error("Failed to emit audit.dead_letter event:", error);
+    });
+    return parentNack;
+  }
+  /**
+   * Override nackWithFibonacciStrategy to emit audit.dead_letter event
+   */
+  nackWithFibonacciStrategy(maxOccurrence = MAX_OCCURRENCE, maxRetries) {
+    const parentNack = super.nackWithFibonacciStrategy(maxOccurrence, maxRetries);
+    const timestamp = Math.floor(Date.now() / 1e3);
+    publishAuditDeadLetter(this.channel, {
+      microservice: this.microservice,
+      rejectedEvent: this.processedEvent,
+      rejectedAt: timestamp,
+      queueName: this.queueName,
+      rejectionReason: "fibonacci_strategy",
+      retryCount: parentNack.count,
+      eventId: void 0
+    }).catch((error) => {
+      console.error("Failed to emit audit.dead_letter event:", error);
+    });
+    return parentNack;
   }
 };
 
@@ -667,7 +790,20 @@ var eventCallback = (msg, channel, e, queueName) => {
       { headersReceived: headers, eventsDetected: event }
     );
   }
-  const responseChannel = new EventsConsumeChannel(channel, msg, queueName);
+  const microservice = extractMicroserviceFromQueue(queueName);
+  const receivedEvent = event[0];
+  const timestamp = Math.floor(Date.now() / 1e3);
+  publishAuditReceived(channel, {
+    microservice,
+    receivedEvent,
+    receivedAt: timestamp,
+    queueName,
+    eventId: void 0
+    // Optional: can be enhanced later with message ID tracking
+  }).catch((error) => {
+    console.error("Failed to emit audit.received event:", error);
+  });
+  const responseChannel = new EventsConsumeChannel(channel, msg, queueName, microservice, receivedEvent);
   e.emit(event[0], { payload, channel: responseChannel });
 };
 
@@ -834,6 +970,25 @@ var createHeaderConsumers = async (queueName, events) => {
     }
   }
 };
+
+// src/Consumer/auditInfrastructure.ts
+var createAuditLoggingResources = async () => {
+  const channel = await getConsumeChannel();
+  await Promise.all([
+    // Create direct exchange for audit events
+    channel.assertExchange(exchange.Audit, "direct", { durable: true }),
+    // Create queues for audit events
+    channel.assertQueue(queue.AuditReceived, { durable: true }),
+    channel.assertQueue(queue.AuditProcessed, { durable: true }),
+    channel.assertQueue(queue.AuditDeadLetter, { durable: true })
+  ]);
+  await Promise.all([
+    // Bind each queue to its specific routing key
+    channel.bindQueue(queue.AuditReceived, exchange.Audit, "audit.received"),
+    channel.bindQueue(queue.AuditProcessed, exchange.Audit, "audit.processed"),
+    channel.bindQueue(queue.AuditDeadLetter, exchange.Audit, "audit.dead_letter")
+  ]);
+};
 var isReady = false;
 var prepare = async (url2) => {
   if (isReady) return;
@@ -893,6 +1048,7 @@ var connectToEvents = async (config) => {
   const queueName = `${config.microservice}_match_commands`;
   const e = mitt__default.default();
   await createHeaderConsumers(queueName, config.events);
+  await createAuditLoggingResources();
   void consume(e, queueName, eventCallback);
   return e;
 };
@@ -978,6 +1134,7 @@ exports.Saga = Saga;
 exports.SagaCommenceConsumeChannel = SagaCommenceConsumeChannel;
 exports.SagaConsumeChannel = SagaConsumeChannel;
 exports.Transactional = Transactional;
+exports.auditEdaCommands = auditEdaCommands;
 exports.authCommands = authCommands;
 exports.availableMicroservices = availableMicroservices;
 exports.blockchainCommands = blockchainCommands;
@@ -991,10 +1148,12 @@ exports.commenceSagaListener = commenceSagaListener;
 exports.connectToEvents = connectToEvents;
 exports.connectToSagaCommandEmitter = connectToSagaCommandEmitter;
 exports.consume = consume;
+exports.createAuditLoggingResources = createAuditLoggingResources;
 exports.createConsumers = createConsumers;
 exports.createHeaderConsumers = createHeaderConsumers;
 exports.eventCallback = eventCallback;
 exports.exchange = exchange;
+exports.extractMicroserviceFromQueue = extractMicroserviceFromQueue;
 exports.fibonacci = fibonacci;
 exports.gender = gender;
 exports.getConsumeChannel = getConsumeChannel;

package/dist/index.mjs

@@ -68,7 +68,13 @@ var availableMicroservices = {
   /**
    * Represents the "legend-storage" microservice.
    */
-  Storage: "legend-storage"
+  Storage: "legend-storage",
+  /**
+   * Represents the "audit-eda" microservice for event-driven architecture auditing.
+   * This microservice consumes audit events (audit.received, audit.processed, audit.dead_letter)
+   * to track event lifecycle and debugging purposes.
+   */
+  AuditEda: "audit-eda"
 };
 
 // src/@types/event/events.ts
@@ -91,6 +97,11 @@ var microserviceEvent = {
   "TEST.IMAGE": "test.image",
   "TEST.MINT": "test.mint",
   ///////////////////////////
+  // AUDIT EVENTS - For tracking event lifecycle
+  "AUDIT.RECEIVED": "audit.received",
+  "AUDIT.PROCESSED": "audit.processed",
+  "AUDIT.DEAD_LETTER": "audit.dead_letter",
+  ///////////////////////////
   "AUTH.DELETED_USER": "auth.deleted_user",
   "AUTH.LOGOUT_USER": "auth.logout_user",
   "AUTH.NEW_USER": "auth.new_user",
@@ -107,6 +118,7 @@ var microserviceEvent = {
   "LEGEND_MISSIONS.SEND_EMAIL_NFT_MISSION_COMPLETED": "legend_missions.send_email_nft_mission_completed",
   "LEGEND_RANKINGS.RANKINGS_FINISHED": "legend_rankings.rankings_finished",
   "LEGEND_RANKINGS.NEW_RANKING_CREATED": "legend_rankings.new_ranking_created",
+  "LEGEND_RANKINGS.INTERMEDIATE_REWARD": "legend_rankings.intermediate_reward",
   "LEGEND_SHOWCASE.PRODUCT_VIRTUAL_DELETED": "legend_showcase.product_virtual_deleted",
   "LEGEND_SHOWCASE.UPDATE_ALLOWED_MISSION_SUBSCRIPTION_IDS": "legend_showcase.update_allowed_mission_subscription_ids",
   "LEGEND_SHOWCASE.UPDATE_ALLOWED_RANKING_SUBSCRIPTION_IDS": "legend_showcase.update_allowed_ranking_subscription_ids",
@@ -124,6 +136,13 @@ var microserviceEvent = {
 
 // src/@types/rabbit-mq.ts
 var queue = {
+  /**
+   * Audit queue names for separate audit event types
+   * @constant
+   */
+  AuditReceived: "audit_received_commands",
+  AuditProcessed: "audit_processed_commands",
+  AuditDeadLetter: "audit_dead_letter_commands",
   /**
    * Queue used for sending replies in response to saga events.
    */
@@ -134,6 +153,10 @@ var queue = {
   CommenceSaga: "commence_saga"
 };
 var exchange = {
+  /**
+   * Audit exchange name for direct routing of audit events
+   */
+  Audit: "audit_exchange",
   /**
    * Exchange dedicated to requeueing messages that require further processing in a saga process
    */
@@ -168,6 +191,9 @@ var authCommands = {
   CreateUser: "create_user"
 };
 
+// src/@types/saga/commands/audit-eda.ts
+var auditEdaCommands = {};
+
 // src/@types/saga/commands/blockchain.ts
 var blockchainCommands = {
   /**
@@ -450,6 +476,11 @@ var getEventObject = (event) => {
   };
 };
 
+// src/utils/extractMicroservice.ts
+function extractMicroserviceFromQueue(queueName) {
+  return queueName.replace(/_match_commands$/, "").replace(/_saga_commands$/, "");
+}
+
 // src/Consumer/channels/Consume.ts
 var ConsumeChannel = class {
   /**
@@ -489,10 +520,10 @@ var ConsumeChannel = class {
    *
    * @see NACKING_DELAY_MS
    */
-  nackWithDelay = (delay = NACKING_DELAY_MS, maxRetries) => {
+  nackWithDelay(delay = NACKING_DELAY_MS, maxRetries) {
     const { delay: delayNackRetry, count } = this.nack({ delay, maxRetries });
     return { count, delay: delayNackRetry };
-  };
+  }
   /**
    * Negatively acknowledges (NACKs) the message using a Fibonacci backoff strategy.
    *
@@ -506,9 +537,9 @@ var ConsumeChannel = class {
    *   - `occurrence`: The current occurrence count for the Fibonacci sequence.
    * @see MAX_OCCURRENCE
    */
-  nackWithFibonacciStrategy = (maxOccurrence = MAX_OCCURRENCE, maxRetries) => {
+  nackWithFibonacciStrategy(maxOccurrence = MAX_OCCURRENCE, maxRetries) {
     return this.nack({ maxOccurrence, maxRetries });
-  };
+  }
   /**
    * Private helper function to handle the actual NACK logic.
    *
@@ -518,11 +549,7 @@ var ConsumeChannel = class {
    *   - `delay` and `maxRetries`: For linear backoff with a fixed delay and retry limit.
    *   - `maxOccurrence`: For Fibonacci backoff with a maximum occurrence count.
    */
-  nack = ({
-    maxRetries,
-    maxOccurrence,
-    delay
-  }) => {
+  nack({ maxRetries, maxOccurrence, delay }) {
     const { msg, queueName, channel } = this;
     channel.nack(msg, false, false);
     let count = 0;
@@ -579,7 +606,7 @@ var ConsumeChannel = class {
       });
     }
     return { count, delay: nackDelay, occurrence };
-  };
+  }
 };
 var Consume_default = ConsumeChannel;
 
@@ -611,13 +638,109 @@ var commenceSagaConsumeCallback = (msg, channel, e, queueName) => {
   e.emit(saga.title, { saga, channel: responseChannel });
 };
 
+// src/Broker/PublishAuditEvent.ts
+async function publishAuditEvent(channel, eventType, payload) {
+  try {
+    const routingKey = eventType;
+    const messageBuffer = Buffer.from(JSON.stringify(payload));
+    channel.publish(exchange.Audit, routingKey, messageBuffer, {
+      contentType: "application/json",
+      deliveryMode: 2
+      // persistent
+    });
+  } catch (error) {
+    console.error(`Failed to publish audit event ${eventType}:`, error);
+  }
+}
+async function publishAuditReceived(channel, payload) {
+  await publishAuditEvent(channel, "audit.received", payload);
+}
+async function publishAuditProcessed(channel, payload) {
+  await publishAuditEvent(channel, "audit.processed", payload);
+}
+async function publishAuditDeadLetter(channel, payload) {
+  await publishAuditEvent(channel, "audit.dead_letter", payload);
+}
+
 // src/Consumer/channels/Events.ts
 var EventsConsumeChannel = class extends Consume_default {
+  /**
+   * The microservice name that is processing the event
+   */
+  microservice;
+  /**
+   * The original event that was received
+   */
+  processedEvent;
+  /**
+   * Creates a new EventsConsumeChannel instance
+   *
+   * @param channel - The AMQP Channel
+   * @param msg - The consumed message
+   * @param queueName - The queue name
+   * @param microservice - The microservice name processing the event
+   * @param processedEvent - The event type being processed
+   */
+  constructor(channel, msg, queueName, microservice, processedEvent) {
+    super(channel, msg, queueName);
+    this.microservice = microservice;
+    this.processedEvent = processedEvent;
+  }
   /**
    * Acknowledges the consumed saga event/command.
+   * Automatically emits audit.processed event after successful ACK.
    */
   ackMessage() {
     this.channel.ack(this.msg, false);
+    const timestamp = Math.floor(Date.now() / 1e3);
+    publishAuditProcessed(this.channel, {
+      microservice: this.microservice,
+      processedEvent: this.processedEvent,
+      processedAt: timestamp,
+      queueName: this.queueName,
+      eventId: void 0
+      // Optional: can be enhanced later
+    }).catch((error) => {
+      console.error("Failed to emit audit.processed event:", error);
+    });
+  }
+  /**
+   * Override nackWithDelay to emit audit.dead_letter event
+   */
+  nackWithDelay(delay = NACKING_DELAY_MS, maxRetries) {
+    const parentNack = super.nackWithDelay(delay, maxRetries);
+    const timestamp = Math.floor(Date.now() / 1e3);
+    publishAuditDeadLetter(this.channel, {
+      microservice: this.microservice,
+      rejectedEvent: this.processedEvent,
+      rejectedAt: timestamp,
+      queueName: this.queueName,
+      rejectionReason: "delay",
+      retryCount: parentNack.count,
+      eventId: void 0
+    }).catch((error) => {
+      console.error("Failed to emit audit.dead_letter event:", error);
+    });
+    return parentNack;
+  }
+  /**
+   * Override nackWithFibonacciStrategy to emit audit.dead_letter event
+   */
+  nackWithFibonacciStrategy(maxOccurrence = MAX_OCCURRENCE, maxRetries) {
+    const parentNack = super.nackWithFibonacciStrategy(maxOccurrence, maxRetries);
+    const timestamp = Math.floor(Date.now() / 1e3);
+    publishAuditDeadLetter(this.channel, {
+      microservice: this.microservice,
+      rejectedEvent: this.processedEvent,
+      rejectedAt: timestamp,
+      queueName: this.queueName,
+      rejectionReason: "fibonacci_strategy",
+      retryCount: parentNack.count,
+      eventId: void 0
+    }).catch((error) => {
+      console.error("Failed to emit audit.dead_letter event:", error);
+    });
+    return parentNack;
   }
 };
 
@@ -660,7 +783,20 @@ var eventCallback = (msg, channel, e, queueName) => {
       { headersReceived: headers, eventsDetected: event }
     );
   }
-  const responseChannel = new EventsConsumeChannel(channel, msg, queueName);
+  const microservice = extractMicroserviceFromQueue(queueName);
+  const receivedEvent = event[0];
+  const timestamp = Math.floor(Date.now() / 1e3);
+  publishAuditReceived(channel, {
+    microservice,
+    receivedEvent,
+    receivedAt: timestamp,
+    queueName,
+    eventId: void 0
+    // Optional: can be enhanced later with message ID tracking
+  }).catch((error) => {
+    console.error("Failed to emit audit.received event:", error);
+  });
+  const responseChannel = new EventsConsumeChannel(channel, msg, queueName, microservice, receivedEvent);
   e.emit(event[0], { payload, channel: responseChannel });
 };
 
@@ -827,6 +963,25 @@ var createHeaderConsumers = async (queueName, events) => {
     }
   }
 };
+
+// src/Consumer/auditInfrastructure.ts
+var createAuditLoggingResources = async () => {
+  const channel = await getConsumeChannel();
+  await Promise.all([
+    // Create direct exchange for audit events
+    channel.assertExchange(exchange.Audit, "direct", { durable: true }),
+    // Create queues for audit events
+    channel.assertQueue(queue.AuditReceived, { durable: true }),
+    channel.assertQueue(queue.AuditProcessed, { durable: true }),
+    channel.assertQueue(queue.AuditDeadLetter, { durable: true })
+  ]);
+  await Promise.all([
+    // Bind each queue to its specific routing key
+    channel.bindQueue(queue.AuditReceived, exchange.Audit, "audit.received"),
+    channel.bindQueue(queue.AuditProcessed, exchange.Audit, "audit.processed"),
+    channel.bindQueue(queue.AuditDeadLetter, exchange.Audit, "audit.dead_letter")
+  ]);
+};
 var isReady = false;
 var prepare = async (url2) => {
   if (isReady) return;
@@ -886,6 +1041,7 @@ var connectToEvents = async (config) => {
   const queueName = `${config.microservice}_match_commands`;
   const e = mitt();
   await createHeaderConsumers(queueName, config.events);
+  await createAuditLoggingResources();
   void consume(e, queueName, eventCallback);
   return e;
 };
@@ -960,4 +1116,4 @@ var publishEvent = async (msg, event) => {
   });
 };
 
-export { EventsConsumeChannel, MAX_NACK_RETRIES, MAX_OCCURRENCE, MicroserviceConsumeChannel, NACKING_DELAY_MS, PaymentEmailTypes, RoomTypes, Saga, SagaCommenceConsumeChannel, SagaConsumeChannel, Transactional, authCommands, availableMicroservices, blockchainCommands, closeConsumeChannel, closeRabbitMQConn, closeSendChannel, coinsCommands, commenceSaga, commenceSagaConsumeCallback, commenceSagaListener, connectToEvents, connectToSagaCommandEmitter, consume, createConsumers, createHeaderConsumers, eventCallback, exchange, fibonacci, gender, getConsumeChannel, getEventKey, getEventObject, getQueueConsumer, getQueueName, getRabbitMQConn, getSendChannel, isConnectionHealthy, microserviceEvent, nodeDataDefaults, publishEvent, queue, rankingsCommands, rapidMessagingCommands, roomCreatorCommands, roomInventoryCommands, roomSnapshotCommands, sagaConsumeCallback, sagaStepCallback, sagaTitle, saveQueueForHealthCheck, saveUri, sendEmailCommands, sendToQueue, showcaseCommands, socialCommands, socialMediaRoomsCommands, startGlobalSagaStepListener, status, stopRabbitMQ, storageCommands, testImageCommands, testMintCommands };
+export { EventsConsumeChannel, MAX_NACK_RETRIES, MAX_OCCURRENCE, MicroserviceConsumeChannel, NACKING_DELAY_MS, PaymentEmailTypes, RoomTypes, Saga, SagaCommenceConsumeChannel, SagaConsumeChannel, Transactional, auditEdaCommands, authCommands, availableMicroservices, blockchainCommands, closeConsumeChannel, closeRabbitMQConn, closeSendChannel, coinsCommands, commenceSaga, commenceSagaConsumeCallback, commenceSagaListener, connectToEvents, connectToSagaCommandEmitter, consume, createAuditLoggingResources, createConsumers, createHeaderConsumers, eventCallback, exchange, extractMicroserviceFromQueue, fibonacci, gender, getConsumeChannel, getEventKey, getEventObject, getQueueConsumer, getQueueName, getRabbitMQConn, getSendChannel, isConnectionHealthy, microserviceEvent, nodeDataDefaults, publishEvent, queue, rankingsCommands, rapidMessagingCommands, roomCreatorCommands, roomInventoryCommands, roomSnapshotCommands, sagaConsumeCallback, sagaStepCallback, sagaTitle, saveQueueForHealthCheck, saveUri, sendEmailCommands, sendToQueue, showcaseCommands, socialCommands, socialMediaRoomsCommands, startGlobalSagaStepListener, status, stopRabbitMQ, storageCommands, testImageCommands, testMintCommands };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "legend-transactional",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "A simple transactional, event-driven communication framework for microservices using RabbitMQ",
   "author": "Jorge Clavijo <jym272@gmail.com> (https://github.com/jym272)",
   "license": "MIT",