@merkaly/nest 0.2.0 → 0.2.2

package/README.md

@@ -39,10 +39,11 @@ strict-peer-dependencies=false
 import {
   env, loadEnv, // config
   LoggerModule, LoggerService, // logger
-  requestLogger, requestOrigin, requestContext, bodyParsers, bodyParserReason, // uma linha por request
+  requestLogger, requestOrigin, requestContext, noteRequest, bodyParsers, bodyParserReason, // uma linha por request
   AbstractExceptionFilter, ExceptionsFilter, rememberError, // filtros (motivo do erro para o log)
-  RabbitModule, EventsPublisher, rabbitConsumerOptions, OnRabbitEvent, ackMessage, nackMessage,
-  WebhookEvent, WebhookPatterns, WebhookPattern, AliexpressOrderStatus, createWebhookEvent, toPattern,
+  RabbitModule, EventsPublisher, EventsConsumer, EventRejectedException, // eventos
+  rabbitConsumerOptions, assertConsumerTopology, OnMerkalyEvent,
+  MerkalyEvent, MerkalyEventType, MerkalyProducer, EventDataMap, createMerkalyEvent, AliexpressOrderStatus,
   SignatureGuard, safeCompare, hmacDigest, verifyHmac,
 } from '@merkaly/nest';
 ```
@@ -54,9 +55,8 @@ import {
   imports: [
     LoggerModule.forRoot({ service: 'webhooks.merkaly.io' }), // global
     RabbitModule.forRoot({
-      url: env.string('RABBITMQ_URL'), // sem url: publish rejeita com 503
-      queue: env.string('RABBITMQ_QUEUE', 'api.merkaly.io-queue'), // <repo>-queue
-      routes: { [WebhookPatterns.asaas.PAYMENT_CONFIRMED]: 'payments.merkaly.io-queue' }, // opcional
+      url: env.string('RABBITMQ_URL'), // sem url: emit rejeita com 503
+      producer: MerkalyProducer.WEBHOOKS, // vai em todo evento
       timeout: env.number('RABBITMQ_PUBLISH_TIMEOUT', 5000),
       required: env.isProduction, // produção não sobe sem url
     }),
@@ -68,7 +68,7 @@ export class AppModule {}
 
 `RabbitModule.forRootAsync({ imports, inject, useFactory })` aceita a config injetada.
 
-**Filas**: o nome é o do repositório do serviço que consome, `<repo>-queue` (ex.: `api.merkaly.io-queue`, `payments.merkaly.io-queue`). O pacote não tem fila padrão: cada app passa a sua.
+**Exchange e filas**: o produtor publica no exchange topic `merkaly.events` com o tipo do evento como routing key e nunca conhece uma fila. Cada consumidor declara a sua fila, com o nome do repositório (`api.merkaly.io`, `payments.merkaly.io`), e o Nest a liga a cada tipo que ele escuta. Um consumidor novo não toca no produtor.
 
 **Health check**: o pacote não registra controllers. O Swagger servido em `/` responde 200 e funciona como health check.
 
@@ -89,16 +89,17 @@ Error: boom
 
 - **ORIGIN** (24): quem fez o request, nas linhas de request e nos logs internos emitidos durante ele: `x-merkaly-host`, senão o host do `Origin`, `cf-connecting-ip`, o primeiro `x-forwarded-for` ou o socket (`requestOrigin`). Fora de um request, o `service`.
 - **SCOPE** (22): contexto de negócio definido pelo app (`requestLogger({ scope })` ou `LoggerModule({ scope })`, ex.: id da organização). Nas linhas de request é resolvido ao terminar a resposta, então pega o que os guards definiram.
-- **KIND** (16): método HTTP nas linhas de request; nos logs internos, o `group` de quem loga.
+- **KIND** (16): método HTTP nas linhas de request; nos logs internos, o `group` de quem loga. Com `requestLogger({ kind })` a linha de request usa esse valor (ex.: o evento do webhook) e o método passa a abrir a mensagem: `PAYMENT_RECEIVED POST /asaas 200 44ms`.
 - **MESSAGE**: `/path STATUS Nms "motivo"` (motivo cortado em 200, sem query, body nem headers) ou o texto. Nível: `ERROR` em 5xx com o stack embaixo, `WARN` em 4xx, `LOG` no resto.
 
 ```ts
 // main.ts
-app.use(requestLogger(app)); // antes do Swagger; opcional { scope: (req) => 'stripe' }
+app.use(requestLogger(app)); // antes do Swagger; opcional { scope: (req) => 'stripe', kind: (req) => req.body?.event }
 bodyParsers(app, { raw: ['/webhook/stripe'] }); // json + urlencoded com motivo seguro ("Invalid JSON body")
 SwaggerModule.setup('/', app, document);
 ```
 
+- `noteRequest(texto, nível?)` soma um resultado ao fim da linha do request (`-> payment.received`, `"discarded"`) em vez de uma linha separada; o nível só sobe (`warn`/`error`). Fora de um request devolve `false`. O `EventsPublisher` usa isso: dentro de um request o `emit` vira `-> <tipo>` na linha do request, fora dele continua com linha própria.
 - O ORIGIN do request fica num `AsyncLocalStorage` do pacote (`requestContext`). O `requestLogger` cria o contexto e o `LoggerModule` registra um middleware que volta a entrar nele depois dos body parsers (que podem perder o contexto assíncrono), igual ao `nestjs-cls`.
 - `bodyParsers(app, { raw?, rawBody? })`: `raw` mantém o body como Buffer nesses paths; `rawBody: true` preenche `req.rawBody` (igual ao `NestFactory.create(..., { rawBody: true })`, que deixa de registrar os próprios parsers).
 - SCOPE com CLS, sem o pacote depender de `nestjs-cls`:
@@ -114,32 +115,51 @@ LoggerModule.forRootAsync({
 
 ### Eventos
 
-Envelope `WebhookEvent<T>`: `{ id, source, type, receivedAt, organization?, data }`. Padrão do nome: `<source>.<evento>` em minúsculas (`toPattern('asaas', 'PAYMENT_CONFIRMED')` = `asaas.payment_confirmed`). Os padrões conhecidos ficam em `WebhookPatterns` e são a fonte única para produtores e consumidores, iguais ao que o webhooks publica:
-
-- Asaas: `asaas.<evento em minúsculas>` (ex.: `asaas.payment_received`).
-- Stripe: tipo pontuado original (ex.: `stripe.invoice.paid`, `stripe.customer.subscription.updated`).
-- Auth0: nome legível do código de log (ex.: `auth0.success_signup`, `auth0.success_login`, `auth0.user_deleted`) e `auth0.user_login` da Action.
-- AliExpress: tópico do `message_type` (53 `aliexpress.dropshipper_order_status_update`, 18 `aliexpress.waybill_changed`, 15 `aliexpress.product_deleted`); status do pedido DS em `AliexpressOrderStatus`.
+Contrato completo em [`docs/events.md`](docs/events.md). Eventos de negócio normalizados (`payment.received`, nunca `asaas.payment_received`): se o provedor muda, o consumidor não muda.
 
 ```ts
-await this.events.publish(
-  WebhookPatterns.asaas.PAYMENT_CONFIRMED,
-  createWebhookEvent({ id: body.id, source: 'asaas', type: body.event, data: body.payment }),
-); // resolve só com ack do broker; timeout ou falha: ServiceUnavailableException
+// produtor: data tipado pelo tipo; resolve com o evento ou ServiceUnavailableException (o provedor reintenta)
+await this.events.emit(MerkalyEventType.PAYMENT_RECEIVED, { ...paymentRef, receivedAt }, {
+  id: `asaas:${body.id}`, source: 'asaas', organization, occurredAt, raw: { type: body.event, payload },
+});
 ```
 
-Consumidor (quando o api ou o payments passarem a consumir):
+Consumidor:
 
 ```ts
-app.connectMicroservice(rabbitConsumerOptions({ url, queue: 'api.merkaly.io-queue' }));
+// main.ts
+const consumer = { url, queue: 'api.merkaly.io' };
+await assertConsumerTopology(consumer); // cria .retry e .dlq
+app.connectMicroservice(rabbitConsumerOptions(consumer));
 await app.startAllMicroservices();
 
-@OnRabbitEvent(WebhookPatterns.asaas.PAYMENT_CONFIRMED)
-handle(@Payload() event: WebhookEvent, @Ctx() context: RmqContext) {
-  return this.service.confirm(event).then(() => ackMessage(context));
+// módulo: `around` roda cada mensagem dentro do contexto do app (ex.: CLS com a organização)
+RabbitModule.forConsumerAsync({
+  inject: [ClsService],
+  useFactory: (cls: ClsService) => ({
+    queue: 'api.merkaly.io',
+    around: (event, next) => cls.run(() => { cls.set('identity', event.organization); return next(); }),
+  }),
+});
+
+// handler
+@OnMerkalyEvent(MerkalyEventType.PAYMENT_RECEIVED)
+received(@Payload() event: MerkalyEvent<MerkalyEventType.PAYMENT_RECEIVED>, @Ctx() context: RmqContext) {
+  return this.consumer.handle(event, context, (e) => this.payments.refresh(e.data.saleId));
 }
 ```
 
+`@OnMerkalyEvent(...types)` aceita vários tipos no mesmo handler. `EventsConsumer.handle` fecha a mensagem e loga uma linha (`ORIGIN` = provedor, `SCOPE` = organização, `KIND` = `EVENT`):
+
+| Resultado | O que acontece |
+| --- | --- |
+| Sucesso | `ack`. |
+| `EventRejectedException` (venda inexistente, valor diferente...) | `ack` + `WARN`: reintentar não resolve. |
+| Outro erro (Mongo, rede, provedor fora) | Vai para `<fila>.retry` (30 s) e volta; depois de 5 tentativas, `<fila>.dlq`. |
+| Malformado ou `version` maior que a do handler | `<fila>.dlq` direto. |
+
+A fila principal descarta para a `.dlq` o que ficar 7 dias sem consumo ou passar de 10.000 mensagens.
+
 ### Env
 
 `env.string`, `env.number`, `env.boolean`, `env.list`, `env.required`, `env.isProduction`. Carrega o `.env` (dotenv) no primeiro acesso. Valor obrigatório ausente ou inválido: **erro em produção**, aviso no log fora dela.

package/dist/events/aliexpress.d.ts

@@ -0,0 +1,10 @@
+export declare const AliexpressOrderStatus: {
+    readonly CREATED: "OrderCreated";
+    readonly PAYMENT_AUTHORIZED: "PaymentAuthorized";
+    readonly PAYMENT_FAILED: "paymentFailedEvent";
+    readonly SHIPPED: "OrderShipped";
+    readonly CONFIRMED: "OrderConfirmed";
+    readonly CLOSED: "OrderClosed";
+};
+export type AliexpressOrderStatus = (typeof AliexpressOrderStatus)[keyof typeof AliexpressOrderStatus];
+//# sourceMappingURL=aliexpress.d.ts.map

package/dist/events/aliexpress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliexpress.d.ts","sourceRoot":"","sources":["../../src/events/aliexpress.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB;;;;;;;CAOxB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/events/aliexpress.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AliexpressOrderStatus = void 0;
+exports.AliexpressOrderStatus = {
+    CREATED: 'OrderCreated',
+    PAYMENT_AUTHORIZED: 'PaymentAuthorized',
+    PAYMENT_FAILED: 'paymentFailedEvent',
+    SHIPPED: 'OrderShipped',
+    CONFIRMED: 'OrderConfirmed',
+    CLOSED: 'OrderClosed',
+};
+//# sourceMappingURL=aliexpress.js.map

package/dist/events/aliexpress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliexpress.js","sourceRoot":"","sources":["../../src/events/aliexpress.ts"],"names":[],"mappings":";;;AACa,QAAA,qBAAqB,GAAG;IACnC,OAAO,EAAE,cAAc;IACvB,kBAAkB,EAAE,mBAAmB;IACvC,cAAc,EAAE,oBAAoB;IACpC,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;CACb,CAAC"}

package/dist/events/index.d.ts

@@ -1,3 +1,3 @@
-export * from './webhook-event';
-export * from './webhook-patterns';
+export * from './aliexpress';
+export * from './merkaly-event';
 //# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/events/index.js

@@ -14,6 +14,6 @@ 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("./webhook-event"), exports);
-__exportStar(require("./webhook-patterns"), exports);
+__exportStar(require("./aliexpress"), exports);
+__exportStar(require("./merkaly-event"), exports);
 //# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC"}

package/dist/events/merkaly-event.d.ts

@@ -0,0 +1,96 @@
+export declare enum MerkalyEventType {
+    PAYMENT_CONFIRMED = "payment.confirmed",
+    PAYMENT_RECEIVED = "payment.received",
+    PAYMENT_FAILED = "payment.failed",
+    PAYMENT_OVERDUE = "payment.overdue",
+    PAYMENT_CANCELLED = "payment.cancelled",
+    PAYMENT_REFUNDED = "payment.refunded",
+    PAYMENT_CHARGEBACK_OPENED = "payment.chargeback.opened",
+    PAYMENT_CHARGEBACK_UPDATED = "payment.chargeback.updated",
+    PAYMENT_ACCOUNT_APPROVED = "payment.account.approved",
+    PAYMENT_ACCOUNT_REJECTED = "payment.account.rejected",
+    PAYMENT_ACCOUNT_STATUS_CHANGED = "payment.account.status_changed"
+}
+export declare enum MerkalyProducer {
+    WEBHOOKS = "webhooks.merkaly.io",
+    API = "api.merkaly.io",
+    PAYMENTS = "payments.merkaly.io"
+}
+export type MerkalyEventSource = 'asaas' | 'stripe' | 'auth0' | 'aliexpress';
+export type PaymentProvider = 'asaas';
+export type PaymentMethod = 'PIX' | 'CARD' | 'BOLETO';
+export interface PaymentRef {
+    provider: PaymentProvider;
+    paymentId: string;
+    saleId: string | null;
+    method: PaymentMethod;
+    amount: number;
+    netAmount: number | null;
+}
+export type PaymentAccountSection = 'general' | 'commercialInfo' | 'documentation' | 'bankAccountInfo';
+export type PaymentAccountStatus = 'PENDING' | 'AWAITING_APPROVAL' | 'APPROVED' | 'REJECTED' | 'EXPIRING_SOON' | 'EXPIRED';
+export interface PaymentAccountRef {
+    provider: PaymentProvider;
+    accountId: string;
+}
+export interface EventDataMap {
+    [MerkalyEventType.PAYMENT_CONFIRMED]: PaymentRef & {
+        confirmedAt: string;
+    };
+    [MerkalyEventType.PAYMENT_RECEIVED]: PaymentRef & {
+        receivedAt: string;
+    };
+    [MerkalyEventType.PAYMENT_FAILED]: PaymentRef & {
+        reason: 'card_refused' | 'risk_rejected';
+    };
+    [MerkalyEventType.PAYMENT_OVERDUE]: PaymentRef & {
+        dueDate: string;
+    };
+    [MerkalyEventType.PAYMENT_CANCELLED]: PaymentRef;
+    [MerkalyEventType.PAYMENT_REFUNDED]: PaymentRef & {
+        refundedAmount: number;
+        partial: boolean;
+    };
+    [MerkalyEventType.PAYMENT_CHARGEBACK_OPENED]: PaymentRef & {
+        reason: string | null;
+    };
+    [MerkalyEventType.PAYMENT_CHARGEBACK_UPDATED]: PaymentRef & {
+        stage: 'disputed' | 'awaiting_reversal';
+    };
+    [MerkalyEventType.PAYMENT_ACCOUNT_APPROVED]: PaymentAccountRef;
+    [MerkalyEventType.PAYMENT_ACCOUNT_REJECTED]: PaymentAccountRef;
+    [MerkalyEventType.PAYMENT_ACCOUNT_STATUS_CHANGED]: PaymentAccountRef & {
+        section: PaymentAccountSection;
+        status: PaymentAccountStatus;
+    };
+}
+export interface MerkalyRawEvent {
+    type: string;
+    payload?: unknown;
+    truncated?: boolean;
+}
+export interface MerkalyEvent<K extends MerkalyEventType = MerkalyEventType> {
+    id: string;
+    type: K;
+    version: number;
+    producer: MerkalyProducer;
+    source?: MerkalyEventSource;
+    organization?: string;
+    occurredAt: string;
+    publishedAt: string;
+    correlationId?: string;
+    data: EventDataMap[K];
+    raw?: MerkalyRawEvent;
+}
+export interface MerkalyEventMeta {
+    id?: string;
+    version?: number;
+    source?: MerkalyEventSource;
+    organization?: string;
+    occurredAt?: string;
+    correlationId?: string;
+    raw?: MerkalyRawEvent;
+}
+export declare const RAW_PAYLOAD_LIMIT: number;
+export declare function createMerkalyEvent<K extends MerkalyEventType>(producer: MerkalyProducer, type: K, data: EventDataMap[K], meta?: MerkalyEventMeta): MerkalyEvent<K>;
+//# sourceMappingURL=merkaly-event.d.ts.map

package/dist/events/merkaly-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merkaly-event.d.ts","sourceRoot":"","sources":["../../src/events/merkaly-event.ts"],"names":[],"mappings":"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"}

package/dist/events/merkaly-event.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAW_PAYLOAD_LIMIT = exports.MerkalyProducer = exports.MerkalyEventType = void 0;
+exports.createMerkalyEvent = createMerkalyEvent;
+const crypto_1 = require("crypto");
+var MerkalyEventType;
+(function (MerkalyEventType) {
+    MerkalyEventType["PAYMENT_CONFIRMED"] = "payment.confirmed";
+    MerkalyEventType["PAYMENT_RECEIVED"] = "payment.received";
+    MerkalyEventType["PAYMENT_FAILED"] = "payment.failed";
+    MerkalyEventType["PAYMENT_OVERDUE"] = "payment.overdue";
+    MerkalyEventType["PAYMENT_CANCELLED"] = "payment.cancelled";
+    MerkalyEventType["PAYMENT_REFUNDED"] = "payment.refunded";
+    MerkalyEventType["PAYMENT_CHARGEBACK_OPENED"] = "payment.chargeback.opened";
+    MerkalyEventType["PAYMENT_CHARGEBACK_UPDATED"] = "payment.chargeback.updated";
+    MerkalyEventType["PAYMENT_ACCOUNT_APPROVED"] = "payment.account.approved";
+    MerkalyEventType["PAYMENT_ACCOUNT_REJECTED"] = "payment.account.rejected";
+    MerkalyEventType["PAYMENT_ACCOUNT_STATUS_CHANGED"] = "payment.account.status_changed";
+})(MerkalyEventType || (exports.MerkalyEventType = MerkalyEventType = {}));
+var MerkalyProducer;
+(function (MerkalyProducer) {
+    MerkalyProducer["WEBHOOKS"] = "webhooks.merkaly.io";
+    MerkalyProducer["API"] = "api.merkaly.io";
+    MerkalyProducer["PAYMENTS"] = "payments.merkaly.io";
+})(MerkalyProducer || (exports.MerkalyProducer = MerkalyProducer = {}));
+exports.RAW_PAYLOAD_LIMIT = 16 * 1024;
+function capRaw(raw) {
+    if (!raw?.payload)
+        return raw;
+    const size = Buffer.byteLength(JSON.stringify(raw.payload) ?? '');
+    return size > exports.RAW_PAYLOAD_LIMIT ? { type: raw.type, truncated: true } : raw;
+}
+function createMerkalyEvent(producer, type, data, meta = {}) {
+    const publishedAt = new Date().toISOString();
+    return {
+        id: meta.id ?? (0, crypto_1.randomUUID)(),
+        type,
+        version: meta.version ?? 1,
+        producer,
+        source: meta.source,
+        organization: meta.organization || undefined,
+        occurredAt: meta.occurredAt ?? publishedAt,
+        publishedAt,
+        correlationId: meta.correlationId,
+        data,
+        raw: capRaw(meta.raw),
+    };
+}
+//# sourceMappingURL=merkaly-event.js.map

package/dist/events/merkaly-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merkaly-event.js","sourceRoot":"","sources":["../../src/events/merkaly-event.ts"],"names":[],"mappings":";;;AA6GA,gDAqBC;AAlID,mCAAoC;AAGpC,IAAY,gBAYX;AAZD,WAAY,gBAAgB;IAC1B,2DAAuC,CAAA;IACvC,yDAAqC,CAAA;IACrC,qDAAiC,CAAA;IACjC,uDAAmC,CAAA;IACnC,2DAAuC,CAAA;IACvC,yDAAqC,CAAA;IACrC,2EAAuD,CAAA;IACvD,6EAAyD,CAAA;IACzD,yEAAqD,CAAA;IACrD,yEAAqD,CAAA;IACrD,qFAAiE,CAAA;AACnE,CAAC,EAZW,gBAAgB,gCAAhB,gBAAgB,QAY3B;AAED,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,mDAAgC,CAAA;IAChC,yCAAsB,CAAA;IACtB,mDAAgC,CAAA;AAClC,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AA6EY,QAAA,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AAG3C,SAAS,MAAM,CAAC,GAAqB;IACnC,IAAI,CAAC,GAAG,EAAE,OAAO;QAAE,OAAO,GAAG,CAAC;IAE9B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAElE,OAAO,IAAI,GAAG,yBAAiB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9E,CAAC;AAED,SAAgB,kBAAkB,CAChC,QAAyB,EACzB,IAAO,EACP,IAAqB,EACrB,OAAyB,EAAE;IAE3B,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,IAAA,mBAAU,GAAE;QAC3B,IAAI;QACJ,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC;QAC1B,QAAQ;QACR,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS;QAC5C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,WAAW;QAC1C,WAAW;QACX,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,IAAI;QACJ,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;KACtB,CAAC;AACJ,CAAC"}

package/dist/http/request-logger.d.ts

@@ -6,6 +6,7 @@ export interface RequestLogLocals {
 }
 export interface RequestLoggerOptions {
     scope?: (request: Request) => string | undefined;
+    kind?: (request: Request) => string | undefined;
 }
 export declare function requestLogger(app: INestApplicationContext, options?: RequestLoggerOptions): RequestHandler;
 //# sourceMappingURL=request-logger.d.ts.map

package/dist/http/request-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../src/http/request-logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAgB,OAAO,EAAE,cAAc,EAAY,MAAM,SAAS,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CAClD;AAQD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,uBAAuB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,cAAc,CA8BhB"}
+{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../src/http/request-logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAgB,OAAO,EAAE,cAAc,EAAY,MAAM,SAAS,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CACjD;AAaD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,uBAAuB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAuChB"}

package/dist/http/request-logger.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.requestLogger = requestLogger;
 const logger_1 = require("../logger");
+const LEVELS = ['log', 'warn', 'error'];
+const higher = (a, b) => LEVELS.indexOf(a) >= LEVELS.indexOf(b) ? a : b;
 const MAX_REASON = 200;
 const capped = (reason) => reason.length > MAX_REASON ? `${reason.slice(0, MAX_REASON)}…` : reason;
 function requestLogger(app, options = {}) {
@@ -15,12 +17,21 @@ function requestLogger(app, options = {}) {
             const ms = Number(process.hrtime.bigint() - started) / 1e6;
             const path = request.originalUrl.split('?')[0];
             const { error, trace } = response.locals;
-            const line = `${path} ${response.statusCode} ${ms.toFixed(0)}ms`;
-            const message = error ? `${line} ${JSON.stringify(capped(error))}` : line;
-            const tier = response.statusCode >= 500 ? 'error' : response.statusCode >= 400 ? 'warn' : 'log';
+            const kind = options.kind?.(request);
+            const target = kind ? `${request.method} ${path}` : path;
+            const notes = context.notes ?? [];
+            const line = [
+                `${target} ${response.statusCode} ${ms.toFixed(0)}ms`,
+                error ? JSON.stringify(capped(error)) : '',
+                ...notes.map((note) => note.text),
+            ]
+                .filter(Boolean)
+                .join(' ');
+            const status = response.statusCode >= 500 ? 'error' : response.statusCode >= 400 ? 'warn' : 'log';
+            const tier = notes.reduce((level, note) => higher(level, note.level), status);
             logger_1.requestContext.run(context, () => logger.request(tier, {
-                method: request.method,
-                message,
+                method: kind || request.method,
+                message: line,
                 trace: tier === 'error' ? trace : undefined,
             }));
         });

package/dist/http/request-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-logger.js","sourceRoot":"","sources":["../../src/http/request-logger.ts"],"names":[],"mappings":";;AAmBA,sCAiCC;AApDD,sCAAqE;AAarE,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAChC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AAG1E,SAAgB,aAAa,CAC3B,GAA4B,EAC5B,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,sBAAa,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAEzD,OAAO,CAAC,OAAgB,EAAE,QAAkB,EAAE,IAAkB,EAAE,EAAE;QAClE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAA,kBAAS,EAAC,OAAO,CAAC,CAAC;QAEnC,IAAI,OAAO,CAAC,KAAK;YAAE,OAAO,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC;QAElE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACzB,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC;YAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,MAA0B,CAAC;YAC7D,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YACjE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,MAAM,IAAI,GACR,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YAGrF,uBAAc,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAC/B,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;gBACnB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO;gBACP,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aAC5C,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,uBAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"request-logger.js","sourceRoot":"","sources":["../../src/http/request-logger.ts"],"names":[],"mappings":"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"}

package/dist/logger/request-context.d.ts

@@ -1,11 +1,18 @@
 import { AsyncLocalStorage } from 'async_hooks';
 import { NestMiddleware } from '@nestjs/common';
 import type { NextFunction, Request, Response } from 'express';
+export type RequestNoteLevel = 'log' | 'warn' | 'error';
+export interface RequestNote {
+    text: string;
+    level: RequestNoteLevel;
+}
 export interface RequestContext {
     origin: string;
     scope?: () => string | undefined;
+    notes?: RequestNote[];
 }
 export declare const requestContext: AsyncLocalStorage<RequestContext>;
+export declare function noteRequest(text: string, level?: RequestNoteLevel): boolean;
 export declare function requestOrigin(request: Request): string;
 export declare function contextOf(request: Request): RequestContext;
 export declare class RequestContextMiddleware implements NestMiddleware {

package/dist/logger/request-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/logger/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAc,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,cAAc,mCAA0C,CAAC;AAStE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,UAS7C;AAGD,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAI1D;AAGD,qBACa,wBAAyB,YAAW,cAAc;IAC7D,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY;CAGtD"}
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/logger/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAc,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,mCAA0C,CAAC;AAGtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,gBAAwB,WAQxE;AASD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,UAS7C;AAGD,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAI1D;AAGD,qBACa,wBAAyB,YAAW,cAAc;IAC7D,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY;CAGtD"}

package/dist/logger/request-context.js

@@ -7,11 +7,19 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RequestContextMiddleware = exports.requestContext = void 0;
+exports.noteRequest = noteRequest;
 exports.requestOrigin = requestOrigin;
 exports.contextOf = contextOf;
 const async_hooks_1 = require("async_hooks");
 const common_1 = require("@nestjs/common");
 exports.requestContext = new async_hooks_1.AsyncLocalStorage();
+function noteRequest(text, level = 'log') {
+    const context = exports.requestContext.getStore();
+    if (!context)
+        return false;
+    (context.notes ??= []).push({ level, text });
+    return true;
+}
 const CONTEXT = Symbol('merkaly.request.context');
 const hostOf = (origin) => origin?.split('/').pop() || undefined;
 function requestOrigin(request) {

package/dist/logger/request-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/logger/request-context.ts"],"names":[],"mappings":";;;;;;;;;AAkBA,sCASC;AAGD,8BAIC;AAlCD,6CAAgD;AAChD,2CAA4D;AAQ/C,QAAA,cAAc,GAAG,IAAI,+BAAiB,EAAkB,CAAC;AAEtE,MAAM,OAAO,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAIlD,MAAM,MAAM,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;AAG1E,SAAgB,aAAa,CAAC,OAAgB;IAC5C,OAAO,CACL,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QACvD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QACtD,SAAS,CACV,CAAC;AACJ,CAAC;AAGD,SAAgB,SAAS,CAAC,OAAgB;IACxC,MAAM,GAAG,GAAG,OAAyB,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC;AAIM,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACnC,GAAG,CAAC,OAAgB,EAAE,CAAW,EAAE,IAAkB;QACnD,sBAAc,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AAJY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,mBAAU,GAAE;GACA,wBAAwB,CAIpC"}
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/logger/request-context.ts"],"names":[],"mappings":";;;;;;;;;AAoBA,kCAQC;AASD,sCASC;AAGD,8BAIC;AArDD,6CAAgD;AAChD,2CAA4D;AAgB/C,QAAA,cAAc,GAAG,IAAI,+BAAiB,EAAkB,CAAC;AAGtE,SAAgB,WAAW,CAAC,IAAY,EAAE,QAA0B,KAAK;IACvE,MAAM,OAAO,GAAG,sBAAc,CAAC,QAAQ,EAAE,CAAC;IAE1C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,CAAC,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAIlD,MAAM,MAAM,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;AAG1E,SAAgB,aAAa,CAAC,OAAgB;IAC5C,OAAO,CACL,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QACvD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QACtD,SAAS,CACV,CAAC;AACJ,CAAC;AAGD,SAAgB,SAAS,CAAC,OAAgB;IACxC,MAAM,GAAG,GAAG,OAAyB,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC;AAIM,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACnC,GAAG,CAAC,OAAgB,EAAE,CAAW,EAAE,IAAkB;QACnD,sBAAc,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AAJY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,mBAAU,GAAE;GACA,wBAAwB,CAIpC"}

package/dist/rabbit/events.consumer.d.ts

@@ -0,0 +1,19 @@
+import { RmqContext } from '@nestjs/microservices';
+import { MerkalyEvent, MerkalyEventType } from '../events';
+import { LoggerService } from '../logger';
+import { EventsConsumerOptions } from './rabbit.options';
+export declare class EventRejectedException extends Error {
+}
+export interface HandleOptions {
+    version?: number;
+}
+export declare class EventsConsumer {
+    private readonly options;
+    private readonly logger;
+    constructor(options: EventsConsumerOptions, logger?: LoggerService);
+    handle<K extends MerkalyEventType>(event: MerkalyEvent<K>, context: RmqContext, handler: (event: MerkalyEvent<K>) => Promise<unknown>, { version }?: HandleOptions): Promise<void>;
+    private ack;
+    private deadLetter;
+    private retry;
+}
+//# sourceMappingURL=events.consumer.d.ts.map

package/dist/rabbit/events.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.consumer.d.ts","sourceRoot":"","sources":["../../src/rabbit/events.consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAkB,MAAM,WAAW,CAAC;AAG1D,OAAO,EAAqC,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAM5F,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AAEpD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,cAAc;IAIG,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAGM,OAAO,EAAE,qBAAqB,EAC7D,MAAM,CAAC,EAAE,aAAa;IAM7B,MAAM,CAAC,CAAC,SAAS,gBAAgB,EACtC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EACrD,EAAE,OAAW,EAAE,GAAE,aAAkB,GAClC,OAAO,CAAC,IAAI,CAAC;IAoChB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,KAAK;CAiBd"}

package/dist/rabbit/events.consumer.js

@@ -0,0 +1,96 @@
+"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.EventsConsumer = exports.EventRejectedException = void 0;
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../logger");
+const events_publisher_1 = require("./events.publisher");
+const rabbit_consumer_1 = require("./rabbit.consumer");
+const rabbit_options_1 = require("./rabbit.options");
+const GROUP = 'EVENT';
+const RETRIES_HEADER = 'x-merkaly-retries';
+class EventRejectedException extends Error {
+}
+exports.EventRejectedException = EventRejectedException;
+let EventsConsumer = class EventsConsumer {
+    options;
+    logger;
+    constructor(options, logger) {
+        this.options = options;
+        this.logger = logger ?? new logger_1.LoggerService();
+    }
+    handle(event, context, handler, { version = 1 } = {}) {
+        const started = Date.now();
+        const scope = {
+            origin: event?.source ?? event?.producer ?? 'unknown',
+            scope: () => event?.organization,
+        };
+        const line = (text) => `${event?.type} (${event?.id}) ${text} ${Date.now() - started}ms`;
+        return logger_1.requestContext.run(scope, async () => {
+            if (!event?.id || !event?.type)
+                return this.deadLetter(context, line('malformed'));
+            if (event.version > version)
+                return this.deadLetter(context, line(`unknown version ${event.version}`));
+            const next = () => handler(event);
+            const run = this.options.around ? () => this.options.around(event, next) : next;
+            return Promise.resolve()
+                .then(run)
+                .then(() => {
+                this.ack(context);
+                this.logger.log({ group: GROUP, message: line('ok') });
+            })
+                .catch((error) => {
+                if (error instanceof EventRejectedException) {
+                    this.ack(context);
+                    return this.logger.warn({ group: GROUP, message: line(`rejected "${error.message}"`) });
+                }
+                return this.retry(context, line(`failed "${(0, events_publisher_1.describeError)(error)}"`), error);
+            });
+        });
+    }
+    ack(context) {
+        context.getChannelRef().ack(context.getMessage());
+    }
+    deadLetter(context, message, trace) {
+        context.getChannelRef().nack(context.getMessage(), false, false);
+        this.logger.error({
+            group: GROUP,
+            message: `${message} -> ${(0, rabbit_consumer_1.deadLetterQueue)(this.options.queue)}`,
+            trace,
+        });
+    }
+    retry(context, message, trace) {
+        const msg = context.getMessage();
+        const attempt = Number(msg.properties.headers?.[RETRIES_HEADER] ?? 0) + 1;
+        const max = this.options.retries ?? rabbit_options_1.DEFAULT_RETRIES;
+        if (attempt > max)
+            return this.deadLetter(context, `${message}, ${max} retries`, trace);
+        const channel = context.getChannelRef();
+        channel.sendToQueue((0, rabbit_consumer_1.retryQueue)(this.options.queue), msg.content, {
+            ...msg.properties,
+            headers: { ...msg.properties.headers, [RETRIES_HEADER]: attempt },
+            persistent: true,
+        });
+        channel.ack(msg);
+        this.logger.error({ group: GROUP, message: `${message}, retry ${attempt}/${max}`, trace });
+    }
+};
+exports.EventsConsumer = EventsConsumer;
+exports.EventsConsumer = EventsConsumer = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(rabbit_options_1.CONSUMER_OPTIONS)),
+    __param(1, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [Object, logger_1.LoggerService])
+], EventsConsumer);
+//# sourceMappingURL=events.consumer.js.map

package/dist/rabbit/events.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.consumer.js","sourceRoot":"","sources":["../../src/rabbit/events.consumer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8D;AAG9D,sCAA0D;AAC1D,yDAAmD;AACnD,uDAAgE;AAChE,qDAA4F;AAE5F,MAAM,KAAK,GAAG,OAAO,CAAC;AACtB,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAG3C,MAAa,sBAAuB,SAAQ,KAAK;CAAG;AAApD,wDAAoD;AAO7C,IAAM,cAAc,GAApB,MAAM,cAAc;IAIoB;IAH5B,MAAM,CAAgB;IAEvC,YAC6C,OAA8B,EAC7D,MAAsB;QADS,YAAO,GAAP,OAAO,CAAuB;QAGzE,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,sBAAa,EAAE,CAAC;IAC9C,CAAC;IAGM,MAAM,CACX,KAAsB,EACtB,OAAmB,EACnB,OAAqD,EACrD,EAAE,OAAO,GAAG,CAAC,KAAoB,EAAE;QAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG;YACZ,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,QAAQ,IAAI,SAAS;YACrD,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY;SACjC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAC5B,GAAG,KAAK,EAAE,IAAI,KAAK,KAAK,EAAE,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,CAAC;QAEpE,OAAO,uBAAc,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;YAC1C,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI;gBAAE,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAEnF,IAAI,KAAK,CAAC,OAAO,GAAG,OAAO;gBACzB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAE5E,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEjF,OAAO,OAAO,CAAC,OAAO,EAAE;iBACrB,IAAI,CAAC,GAAG,CAAC;iBACT,IAAI,CAAC,GAAG,EAAE;gBACT,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;oBAC5C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAElB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1F,CAAC;gBAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,IAAA,gCAAa,EAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,GAAG,CAAC,OAAmB;QAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpD,CAAC;IAGO,UAAU,CAAC,OAAmB,EAAE,OAAe,EAAE,KAAe;QACtE,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,GAAG,OAAO,OAAO,IAAA,iCAAe,EAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC/D,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAmB,EAAE,OAAe,EAAE,KAAc;QAChE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,gCAAe,CAAC;QAEpD,IAAI,OAAO,GAAG,GAAG;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,OAAO,KAAK,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC;QAExF,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAExC,OAAO,CAAC,WAAW,CAAC,IAAA,4BAAU,EAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE;YAC/D,GAAG,GAAG,CAAC,UAAU;YACjB,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE;YACjE,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,WAAW,OAAO,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,CAAC;CACF,CAAA;AAnFY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,eAAM,EAAC,iCAAgB,CAAC,CAAA;IACxB,WAAA,IAAA,iBAAQ,GAAE,CAAA;6CAAU,sBAAa;GALzB,cAAc,CAmF1B"}