@tc-libs/email-sender 5.2.1 → 5.3.1

package/README.md

@@ -77,6 +77,38 @@ await this.emailSenderService.sendTemplate({
 
 Il package assume l'esistenza di template email persistiti nella collection dedicata, non solo file `.html` locali.
 
+## Outbox (invio transazionale)
+
+`EmailOutboxService`, registrato da `EmailSenderModule`, separa l'evento dall'invio:
+
+- `enqueue(messaggio, { idempotencyKey, session })` scrive nella collection `emailoutboxes`. Con la `session` della transazione dell'evento, l'email esiste solo se l'evento viene confermato. La stessa chiave non crea una seconda email, nemmeno dentro la transazione: si usa un upsert, che non fallisce con un duplicate key;
+- `processDue(now?)` prende in carico le email dovute una alla volta, con un update atomico, e le invia con `sendTemplate`. In caso d'errore ritenta dopo 1, 2, 4, 8 minuti (al massimo un'ora); dopo 5 tentativi l'email resta `failed` e parte una `notifyError` senza destinatari né variabili. Gli errori salvati hanno gli indirizzi oscurati;
+- l'invio è "almeno una volta": un nodo che cade fra l'invio e la conferma fa ripartire l'email dopo 10 minuti.
+
+Le variabili si salvano su MongoDB: devono essere dati semplici (niente documenti Mongoose, metodi o stream). Gli allegati non sono ammessi: un'email con allegato resta su `sendTemplate`.
+
+```ts
+await this.emailOutbox.enqueue(
+  {
+    template: 'user_email_confirm',
+    lang: 'fr',
+    to: [user.email],
+    variables: { firstName: user.firstName, link },
+  },
+  { idempotencyKey: `signup:${code}`, session },
+);
+```
+
+### Task di invio
+
+`EmailOutboxTask` (codice `email-outbox`, ogni minuto) estende `AbstractCronTask` di `@tc-libs/task`: lock distribuito per `app.name` e nessuna transazione intorno all'invio, che è un effetto esterno. L'app:
+
+- passa `app.name` nelle opzioni di `EmailSenderModule`;
+- registra `EmailOutboxTask` fra i provider del router dei job, che importa `TaskModule` e `RetryPolicyModule` con `ScheduleModule` attivo;
+- crea e attiva il task per ambiente: i task di `@tc-libs/task` nascono inattivi, e finché non lo è nessuna email in coda parte.
+
+Nei test, con lo scheduler spento, si chiama `processDue()` direttamente.
+
 ## Sviluppo
 
 ```bash

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@tc-libs/email-sender",
-  "version": "5.2.1",
+  "version": "5.3.1",
   "dependencies": {
-    "@tc-libs/app-cache": "5.2.1",
-    "@tc-libs/database": "5.2.1",
-    "@tc-libs/errors": "5.2.1",
-    "@tc-libs/pagination": "5.2.1",
-    "@tc-libs/service": "5.2.1",
+    "@tc-libs/app-cache": "5.3.1",
+    "@tc-libs/database": "5.3.1",
+    "@tc-libs/errors": "5.3.1",
+    "@tc-libs/logger": "5.3.1",
+    "@tc-libs/pagination": "5.3.1",
+    "@tc-libs/retry-policy": "5.3.1",
+    "@tc-libs/service": "5.3.1",
+    "@tc-libs/task": "5.3.1",
     "axios": "1.8.4",
     "ejs": "3.1.10",
     "mailgun-js": "^0.22.0",
@@ -18,6 +21,7 @@
   "peerDependencies": {
     "@nestjs/common": "^11.0.0 || ^12.0.0",
     "@nestjs/mongoose": "^11.0.0 || ^12.0.0",
+    "@nestjs/schedule": "^5.0.0 || ^12.0.0",
     "class-validator": "^0.14.0",
     "mongoose": "^8.0.0 || ^9.0.0"
   },

package/src/constants/email-outbox.constant.d.ts

@@ -0,0 +1,13 @@
+export declare enum EMAIL_OUTBOX_STATUS {
+    PENDING = "pending",
+    SENDING = "sending",
+    SENT = "sent",
+    FAILED = "failed"
+}
+export declare const EMAIL_OUTBOX_TASK_CODE = "email-outbox";
+export declare const EMAIL_OUTBOX_TASK_STALE_MS: number;
+export declare const EMAIL_OUTBOX_BATCH_SIZE = 20;
+export declare const EMAIL_OUTBOX_MAX_ATTEMPTS = 5;
+export declare const EMAIL_OUTBOX_BACKOFF_BASE_MS: number;
+export declare const EMAIL_OUTBOX_BACKOFF_MAX_MS: number;
+export declare const EMAIL_OUTBOX_CLAIM_TIMEOUT_MS: number;

package/src/constants/email-outbox.constant.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_OUTBOX_CLAIM_TIMEOUT_MS = exports.EMAIL_OUTBOX_BACKOFF_MAX_MS = exports.EMAIL_OUTBOX_BACKOFF_BASE_MS = exports.EMAIL_OUTBOX_MAX_ATTEMPTS = exports.EMAIL_OUTBOX_BATCH_SIZE = exports.EMAIL_OUTBOX_TASK_STALE_MS = exports.EMAIL_OUTBOX_TASK_CODE = exports.EMAIL_OUTBOX_STATUS = void 0;
+var EMAIL_OUTBOX_STATUS;
+(function (EMAIL_OUTBOX_STATUS) {
+    EMAIL_OUTBOX_STATUS["PENDING"] = "pending";
+    // Presa in carico da un invio: se resta così oltre EMAIL_OUTBOX_CLAIM_TIMEOUT_MS il nodo è caduto e si riprova.
+    EMAIL_OUTBOX_STATUS["SENDING"] = "sending";
+    EMAIL_OUTBOX_STATUS["SENT"] = "sent";
+    EMAIL_OUTBOX_STATUS["FAILED"] = "failed";
+})(EMAIL_OUTBOX_STATUS || (exports.EMAIL_OUTBOX_STATUS = EMAIL_OUTBOX_STATUS = {}));
+exports.EMAIL_OUTBOX_TASK_CODE = 'email-outbox';
+// Lock del task: ben oltre la durata di un giro (EMAIL_OUTBOX_BATCH_SIZE invii con il timeout HTTP di Mailgun).
+exports.EMAIL_OUTBOX_TASK_STALE_MS = 10 * 60 * 1000;
+exports.EMAIL_OUTBOX_BATCH_SIZE = 20;
+// Dopo l'ultimo tentativo fallito l'email resta FAILED, con una notifica senza dati personali.
+exports.EMAIL_OUTBOX_MAX_ATTEMPTS = 5;
+// Attesa prima del tentativo n: 1, 2, 4, 8 minuti..., al massimo un'ora.
+exports.EMAIL_OUTBOX_BACKOFF_BASE_MS = 60 * 1000;
+exports.EMAIL_OUTBOX_BACKOFF_MAX_MS = 60 * 60 * 1000;
+// Un'email SENDING da più di così è rimasta orfana (nodo caduto durante l'invio) e torna disponibile.
+exports.EMAIL_OUTBOX_CLAIM_TIMEOUT_MS = 10 * 60 * 1000;
+//# sourceMappingURL=email-outbox.constant.js.map

package/src/constants/email-outbox.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-outbox.constant.js","sourceRoot":"","sources":["../../../../../packages/email-sender/src/constants/email-outbox.constant.ts"],"names":[],"mappings":";;;AAAA,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,gHAAgH;IAChH,0CAAmB,CAAA;IACnB,oCAAa,CAAA;IACb,wCAAiB,CAAA;AACnB,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B;AAEY,QAAA,sBAAsB,GAAG,cAAc,CAAC;AAErD,gHAAgH;AACnG,QAAA,0BAA0B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE5C,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAE1C,+FAA+F;AAClF,QAAA,yBAAyB,GAAG,CAAC,CAAC;AAE3C,yEAAyE;AAC5D,QAAA,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AACzC,QAAA,2BAA2B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1D,sGAAsG;AACzF,QAAA,6BAA6B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/src/email-sender.module.js

@@ -3,24 +3,36 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmailSenderModule = void 0;
 const email_sender_module_options_1 = require("./email-sender.module.options");
 const email_sender_service_1 = require("./services/email-sender.service");
+const email_outbox_service_1 = require("./services/email-outbox.service");
 const email_repository_module_1 = require("./repository/email.repository.module");
+const email_outbox_repository_module_1 = require("./repository/email-outbox.repository.module");
+// EmailOutboxTask non è fra i provider: l'app lo registra nel router dei job, dove c'è TaskModule.
 class EmailSenderModule {
     static register(options, isGlobal) {
         return {
             module: EmailSenderModule,
-            imports: [email_repository_module_1.EmailRepositoryModule],
+            imports: [email_repository_module_1.EmailRepositoryModule, email_outbox_repository_module_1.EmailOutboxRepositoryModule],
             providers: [
                 { provide: email_sender_module_options_1.EMAIL_SENDER_CONFIG_OPTIONS, useValue: options },
                 email_sender_service_1.EmailSenderService,
+                email_outbox_service_1.EmailOutboxService,
+            ],
+            exports: [
+                email_sender_module_options_1.EMAIL_SENDER_CONFIG_OPTIONS,
+                email_sender_service_1.EmailSenderService,
+                email_outbox_service_1.EmailOutboxService,
             ],
-            exports: [email_sender_service_1.EmailSenderService],
             global: isGlobal,
         };
     }
     static registerAsync(options, isGlobal) {
         return {
             module: EmailSenderModule,
-            imports: [...(options.imports || []), email_repository_module_1.EmailRepositoryModule],
+            imports: [
+                ...(options.imports || []),
+                email_repository_module_1.EmailRepositoryModule,
+                email_outbox_repository_module_1.EmailOutboxRepositoryModule,
+            ],
             providers: [
                 {
                     provide: email_sender_module_options_1.EMAIL_SENDER_CONFIG_OPTIONS,
@@ -28,8 +40,13 @@ class EmailSenderModule {
                     inject: options.inject,
                 },
                 email_sender_service_1.EmailSenderService,
+                email_outbox_service_1.EmailOutboxService,
+            ],
+            exports: [
+                email_sender_module_options_1.EMAIL_SENDER_CONFIG_OPTIONS,
+                email_sender_service_1.EmailSenderService,
+                email_outbox_service_1.EmailOutboxService,
             ],
-            exports: [email_sender_service_1.EmailSenderService],
             global: isGlobal,
         };
     }

package/src/email-sender.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"email-sender.module.js","sourceRoot":"","sources":["../../../../packages/email-sender/src/email-sender.module.ts"],"names":[],"mappings":";;;AACA,+EAGuC;AACvC,0EAAqE;AACrE,kFAA6E;AAE7E,MAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CACb,OAA2B,EAC3B,QAAkB;QAElB,OAAO;YACL,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,CAAC,+CAAqB,CAAC;YAChC,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,yDAA2B,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC3D,yCAAkB;aACnB;YACD,OAAO,EAAE,CAAC,yCAAkB,CAAC;YAC7B,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,aAAa,CAClB,OAAgC,EAChC,QAAkB;QAElB,OAAO;YACL,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,+CAAqB,CAAC;YAC5D,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,yDAA2B;oBACpC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB;gBACD,yCAAkB;aACnB;YACD,OAAO,EAAE,CAAC,yCAAkB,CAAC;YAC7B,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;CACF;AApCD,8CAoCC"}
+{"version":3,"file":"email-sender.module.js","sourceRoot":"","sources":["../../../../packages/email-sender/src/email-sender.module.ts"],"names":[],"mappings":";;;AACA,+EAGuC;AACvC,0EAAqE;AACrE,0EAAqE;AACrE,kFAA6E;AAC7E,gGAA0F;AAE1F,mGAAmG;AACnG,MAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CACb,OAA2B,EAC3B,QAAkB;QAElB,OAAO;YACL,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,CAAC,+CAAqB,EAAE,4DAA2B,CAAC;YAC7D,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,yDAA2B,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC3D,yCAAkB;gBAClB,yCAAkB;aACnB;YACD,OAAO,EAAE;gBACP,yDAA2B;gBAC3B,yCAAkB;gBAClB,yCAAkB;aACnB;YACD,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,aAAa,CAClB,OAAgC,EAChC,QAAkB;QAElB,OAAO;YACL,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE;gBACP,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC1B,+CAAqB;gBACrB,4DAA2B;aAC5B;YACD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,yDAA2B;oBACpC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB;gBACD,yCAAkB;gBAClB,yCAAkB;aACnB;YACD,OAAO,EAAE;gBACP,yDAA2B;gBAC3B,yCAAkB;gBAClB,yCAAkB;aACnB;YACD,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;CACF;AAlDD,8CAkDC"}

package/src/email-sender.module.options.d.ts

@@ -15,6 +15,7 @@ export interface EmailSenderOptions {
         templateDir: string;
     };
     app: {
+        name?: string;
         endpoints: {
             frontend: string;
             backoffice: string;

package/src/index.d.ts

@@ -1,5 +1,11 @@
 export * from './email-sender.module';
+export { EMAIL_SENDER_CONFIG_OPTIONS, EmailSenderOptions, } from './email-sender.module.options';
 export * from './interfaces/email-sender.type';
+export * from './interfaces/email-outbox.interface';
+export * from './constants/email-outbox.constant';
 export * from './services/email-sender.service';
+export * from './services/email-outbox.service';
+export * from './tasks/email-outbox.task';
 export * from './dtos/email.dto';
 export * from './repository/entities/email.entity';
+export * from './repository/entities/email-outbox.entity';

package/src/index.js

@@ -1,9 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_SENDER_CONFIG_OPTIONS = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./email-sender.module"), exports);
+var email_sender_module_options_1 = require("./email-sender.module.options");
+Object.defineProperty(exports, "EMAIL_SENDER_CONFIG_OPTIONS", { enumerable: true, get: function () { return email_sender_module_options_1.EMAIL_SENDER_CONFIG_OPTIONS; } });
 tslib_1.__exportStar(require("./interfaces/email-sender.type"), exports);
+tslib_1.__exportStar(require("./interfaces/email-outbox.interface"), exports);
+tslib_1.__exportStar(require("./constants/email-outbox.constant"), exports);
 tslib_1.__exportStar(require("./services/email-sender.service"), exports);
+tslib_1.__exportStar(require("./services/email-outbox.service"), exports);
+tslib_1.__exportStar(require("./tasks/email-outbox.task"), exports);
 tslib_1.__exportStar(require("./dtos/email.dto"), exports);
 tslib_1.__exportStar(require("./repository/entities/email.entity"), exports);
+tslib_1.__exportStar(require("./repository/entities/email-outbox.entity"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/email-sender/src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,yEAA+C;AAC/C,0EAAgD;AAChD,2DAAiC;AACjC,6EAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/email-sender/src/index.ts"],"names":[],"mappings":";;;;AAAA,gEAAsC;AACtC,6EAGuC;AAFrC,0IAAA,2BAA2B,OAAA;AAG7B,yEAA+C;AAC/C,8EAAoD;AACpD,4EAAkD;AAClD,0EAAgD;AAChD,0EAAgD;AAChD,oEAA0C;AAC1C,2DAAiC;AACjC,6EAAmD;AACnD,oFAA0D"}

package/src/interfaces/email-outbox.interface.d.ts

@@ -0,0 +1,13 @@
+import type { ClientSession } from 'mongoose';
+export interface IEmailOutboxMessage {
+    template: string;
+    lang: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    variables?: Record<string, unknown>;
+}
+export interface IEmailOutboxEnqueueOptions {
+    idempotencyKey: string;
+    session?: ClientSession;
+}

package/src/interfaces/email-outbox.interface.js

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

package/src/interfaces/email-outbox.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-outbox.interface.js","sourceRoot":"","sources":["../../../../../packages/email-sender/src/interfaces/email-outbox.interface.ts"],"names":[],"mappings":""}

package/src/repository/email-outbox.repository.module.d.ts

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

package/src/repository/email-outbox.repository.module.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailOutboxRepositoryModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const mongoose_1 = require("@nestjs/mongoose");
+const email_outbox_entity_1 = require("./entities/email-outbox.entity");
+const email_outbox_repository_1 = require("./repositories/email-outbox.repository");
+let EmailOutboxRepositoryModule = class EmailOutboxRepositoryModule {
+};
+exports.EmailOutboxRepositoryModule = EmailOutboxRepositoryModule;
+exports.EmailOutboxRepositoryModule = EmailOutboxRepositoryModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        providers: [email_outbox_repository_1.EmailOutboxRepository],
+        exports: [email_outbox_repository_1.EmailOutboxRepository],
+        controllers: [],
+        imports: [
+            mongoose_1.MongooseModule.forFeature([
+                {
+                    name: email_outbox_entity_1.EmailOutboxEntity.name,
+                    schema: email_outbox_entity_1.EmailOutboxSchema,
+                },
+            ]),
+        ],
+    })
+], EmailOutboxRepositoryModule);
+//# sourceMappingURL=email-outbox.repository.module.js.map

package/src/repository/email-outbox.repository.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-outbox.repository.module.js","sourceRoot":"","sources":["../../../../../packages/email-sender/src/repository/email-outbox.repository.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAwC;AACxC,+CAAkD;AAClD,wEAGwC;AACxC,oFAA+E;AAexE,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;CAAG,CAAA;AAA9B,kEAA2B;sCAA3B,2BAA2B;IAbvC,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,+CAAqB,CAAC;QAClC,OAAO,EAAE,CAAC,+CAAqB,CAAC;QAChC,WAAW,EAAE,EAAE;QACf,OAAO,EAAE;YACP,yBAAc,CAAC,UAAU,CAAC;gBACxB;oBACE,IAAI,EAAE,uCAAiB,CAAC,IAAI;oBAC5B,MAAM,EAAE,uCAAiB;iBAC1B;aACF,CAAC;SACH;KACF,CAAC;GACW,2BAA2B,CAAG"}

package/src/repository/entities/email-outbox.entity.d.ts

@@ -0,0 +1,30 @@
+import { DatabaseMongoEntityAbstract } from '@tc-libs/database';
+import { Document, Types } from 'mongoose';
+import { EMAIL_OUTBOX_STATUS } from '../../constants/email-outbox.constant';
+export declare class EmailOutboxEntity extends DatabaseMongoEntityAbstract {
+    idempotencyKey: string;
+    template: string;
+    lang: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    variables: Record<string, unknown>;
+    status: EMAIL_OUTBOX_STATUS;
+    attempts: number;
+    nextAttemptAt: Date;
+    claimedAt?: Date;
+    sentAt?: Date;
+    lastError?: string;
+}
+export declare const EmailOutboxSchema: import("mongoose").Schema<EmailOutboxEntity, import("mongoose").Model<EmailOutboxEntity, any, any, any, Document<unknown, any, EmailOutboxEntity> & EmailOutboxEntity & Required<{
+    _id: Types.ObjectId;
+}> & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, EmailOutboxEntity, Document<unknown, {}, import("mongoose").FlatRecord<EmailOutboxEntity>> & import("mongoose").FlatRecord<EmailOutboxEntity> & Required<{
+    _id: Types.ObjectId;
+}> & {
+    __v: number;
+}>;
+export type EmailOutboxDoc = EmailOutboxEntity & Document<Types.ObjectId> & {
+    _id: Types.ObjectId;
+};

package/src/repository/entities/email-outbox.entity.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailOutboxSchema = exports.EmailOutboxEntity = void 0;
+const tslib_1 = require("tslib");
+const mongoose_1 = require("@nestjs/mongoose");
+const database_1 = require("@tc-libs/database");
+const mongoose_2 = require("mongoose");
+const email_outbox_constant_1 = require("../../constants/email-outbox.constant");
+// Outbox delle email transazionali: l'evento la scrive nella propria transazione, EmailOutboxTask la invia.
+let EmailOutboxEntity = class EmailOutboxEntity extends database_1.DatabaseMongoEntityAbstract {
+};
+exports.EmailOutboxEntity = EmailOutboxEntity;
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ required: true }),
+    tslib_1.__metadata("design:type", String)
+], EmailOutboxEntity.prototype, "idempotencyKey", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ required: true }),
+    tslib_1.__metadata("design:type", String)
+], EmailOutboxEntity.prototype, "template", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ required: true }),
+    tslib_1.__metadata("design:type", String)
+], EmailOutboxEntity.prototype, "lang", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ required: true, type: [String] }),
+    tslib_1.__metadata("design:type", Array)
+], EmailOutboxEntity.prototype, "to", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ type: [String] }),
+    tslib_1.__metadata("design:type", Array)
+], EmailOutboxEntity.prototype, "cc", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ type: [String] }),
+    tslib_1.__metadata("design:type", Array)
+], EmailOutboxEntity.prototype, "bcc", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ type: mongoose_2.SchemaTypes.Mixed, default: {} }),
+    tslib_1.__metadata("design:type", Object)
+], EmailOutboxEntity.prototype, "variables", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({
+        required: true,
+        type: String,
+        enum: email_outbox_constant_1.EMAIL_OUTBOX_STATUS,
+        default: email_outbox_constant_1.EMAIL_OUTBOX_STATUS.PENDING,
+    }),
+    tslib_1.__metadata("design:type", String)
+], EmailOutboxEntity.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ required: true, default: 0 }),
+    tslib_1.__metadata("design:type", Number)
+], EmailOutboxEntity.prototype, "attempts", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ required: true, type: Date }),
+    tslib_1.__metadata("design:type", Date)
+], EmailOutboxEntity.prototype, "nextAttemptAt", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ type: Date }),
+    tslib_1.__metadata("design:type", Date)
+], EmailOutboxEntity.prototype, "claimedAt", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)({ type: Date }),
+    tslib_1.__metadata("design:type", Date)
+], EmailOutboxEntity.prototype, "sentAt", void 0);
+tslib_1.__decorate([
+    (0, mongoose_1.Prop)(),
+    tslib_1.__metadata("design:type", String)
+], EmailOutboxEntity.prototype, "lastError", void 0);
+exports.EmailOutboxEntity = EmailOutboxEntity = tslib_1.__decorate([
+    (0, database_1.DatabaseEntity)({ collection: 'emailoutboxes' })
+], EmailOutboxEntity);
+exports.EmailOutboxSchema = mongoose_1.SchemaFactory.createForClass(EmailOutboxEntity);
+exports.EmailOutboxSchema.index({ idempotencyKey: 1 }, { unique: true });
+exports.EmailOutboxSchema.index({ status: 1, nextAttemptAt: 1 });
+//# sourceMappingURL=email-outbox.entity.js.map

package/src/repository/entities/email-outbox.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-outbox.entity.js","sourceRoot":"","sources":["../../../../../../packages/email-sender/src/repository/entities/email-outbox.entity.ts"],"names":[],"mappings":";;;;AAAA,+CAAuD;AACvD,gDAAgF;AAChF,uCAAwD;AACxD,iFAA4E;AAE5E,4GAA4G;AAErG,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,sCAA2B;CA6CjE,CAAA;AA7CY,8CAAiB;AAE5B;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACF;AAGvB;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACR;AAGjB;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACZ;AAGb;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;;6CAC5B;AAGb;IADC,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;;6CACX;AAGd;IADC,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;;8CACV;AAGf;IADC,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,sBAAW,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;;oDACZ;AAQnC;IANC,IAAA,eAAI,EAAC;QACJ,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,2CAAmB;QACzB,OAAO,EAAE,2CAAmB,CAAC,OAAO;KACrC,CAAC;;iDAC0B;AAG5B;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;mDACpB;AAGjB;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;sCACtB,IAAI;wDAAC;AAGpB;IADC,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;sCACT,IAAI;oDAAC;AAGjB;IADC,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;sCACZ,IAAI;iDAAC;AAId;IADC,IAAA,eAAI,GAAE;;oDACY;4BA5CR,iBAAiB;IAD7B,IAAA,yBAAc,EAAC,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;GACnC,iBAAiB,CA6C7B;AAEY,QAAA,iBAAiB,GAC5B,wBAAa,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;AAElD,yBAAiB,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACjE,yBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/src/repository/repositories/email-outbox.repository.d.ts

@@ -0,0 +1,25 @@
+import { Logger } from '@nestjs/common';
+import { AppCacheService } from '@tc-libs/app-cache';
+import { DatabaseMongoRepositoryAbstract } from '@tc-libs/database';
+import { ClientSession, Connection, Model, Types } from 'mongoose';
+import { EmailOutboxDoc, EmailOutboxEntity } from '../entities/email-outbox.entity';
+export type EmailOutboxClaimed = EmailOutboxEntity & {
+    _id: Types.ObjectId;
+};
+export type EmailOutboxInsert = Omit<EmailOutboxEntity, '_id' | 'createdAt' | 'updatedAt'>;
+export declare class EmailOutboxRepository extends DatabaseMongoRepositoryAbstract<EmailOutboxEntity, EmailOutboxDoc> {
+    protected readonly _model: Model<EmailOutboxEntity>;
+    protected readonly _connection: Connection;
+    protected readonly _logger: Logger;
+    constructor(_model: Model<EmailOutboxEntity>, _connection: Connection, _cache: AppCacheService);
+    /**
+     * Upsert con $setOnInsert sulla chiave di idempotenza: una seconda richiesta con la stessa chiave non scrive nulla e,
+     * a differenza di un insert, non fallisce con un duplicate key che annullerebbe la transazione dell'evento.
+     */
+    enqueueOnce(email: EmailOutboxInsert, session?: ClientSession): Promise<void>;
+    /**
+     * Prende in carico la prossima email da inviare, in modo atomico: due nodi non ricevono la stessa. Sono dovute le
+     * PENDING con nextAttemptAt passato e le SENDING rimaste orfane da prima di staleBefore.
+     */
+    claimNext(now: Date, staleBefore: Date): Promise<EmailOutboxClaimed | null>;
+}

package/src/repository/repositories/email-outbox.repository.js

@@ -0,0 +1,59 @@
+"use strict";
+var EmailOutboxRepository_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailOutboxRepository = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const app_cache_1 = require("@tc-libs/app-cache");
+const database_1 = require("@tc-libs/database");
+const mongoose_1 = require("mongoose");
+const email_outbox_constant_1 = require("../../constants/email-outbox.constant");
+const email_outbox_entity_1 = require("../entities/email-outbox.entity");
+let EmailOutboxRepository = EmailOutboxRepository_1 = class EmailOutboxRepository extends database_1.DatabaseMongoRepositoryAbstract {
+    constructor(_model, _connection, _cache) {
+        super(_model, _connection, _cache);
+        this._model = _model;
+        this._connection = _connection;
+        this._logger = new common_1.Logger(EmailOutboxRepository_1.name);
+    }
+    /**
+     * Upsert con $setOnInsert sulla chiave di idempotenza: una seconda richiesta con la stessa chiave non scrive nulla e,
+     * a differenza di un insert, non fallisce con un duplicate key che annullerebbe la transazione dell'evento.
+     */
+    async enqueueOnce(email, session) {
+        await this._model
+            .updateOne({ idempotencyKey: email.idempotencyKey }, { $setOnInsert: email }, { upsert: true, session })
+            .exec();
+    }
+    /**
+     * Prende in carico la prossima email da inviare, in modo atomico: due nodi non ricevono la stessa. Sono dovute le
+     * PENDING con nextAttemptAt passato e le SENDING rimaste orfane da prima di staleBefore.
+     */
+    claimNext(now, staleBefore) {
+        return this._model
+            .findOneAndUpdate({
+            $or: [
+                {
+                    status: email_outbox_constant_1.EMAIL_OUTBOX_STATUS.PENDING,
+                    nextAttemptAt: { $lte: now },
+                },
+                {
+                    status: email_outbox_constant_1.EMAIL_OUTBOX_STATUS.SENDING,
+                    claimedAt: { $lte: staleBefore },
+                },
+            ],
+        }, { $set: { status: email_outbox_constant_1.EMAIL_OUTBOX_STATUS.SENDING, claimedAt: now } }, { sort: { nextAttemptAt: 1 }, new: true })
+            .lean()
+            .exec();
+    }
+};
+exports.EmailOutboxRepository = EmailOutboxRepository;
+exports.EmailOutboxRepository = EmailOutboxRepository = EmailOutboxRepository_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, database_1.DatabaseModel)(email_outbox_entity_1.EmailOutboxEntity.name)),
+    tslib_1.__param(1, (0, database_1.DatabaseConnection)()),
+    tslib_1.__metadata("design:paramtypes", [mongoose_1.Model,
+        mongoose_1.Connection,
+        app_cache_1.AppCacheService])
+], EmailOutboxRepository);
+//# sourceMappingURL=email-outbox.repository.js.map

package/src/repository/repositories/email-outbox.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-outbox.repository.js","sourceRoot":"","sources":["../../../../../../packages/email-sender/src/repository/repositories/email-outbox.repository.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,kDAAqD;AACrD,gDAI2B;AAC3B,uCAAmE;AACnE,iFAA4E;AAC5E,yEAGyC;AAWlC,IAAM,qBAAqB,6BAA3B,MAAM,qBAAsB,SAAQ,0CAG1C;IAEC,YAEE,MAA4D,EAE5D,WAAmD,EACnD,MAAuB;QAEvB,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QALP,WAAM,GAAN,MAAM,CAA0B;QAEhC,gBAAW,GAAX,WAAW,CAAY;QALlC,YAAO,GAAW,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,CAAC;IAS5E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,KAAwB,EACxB,OAAuB;QAEvB,MAAM,IAAI,CAAC,MAAM;aACd,SAAS,CACR,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,EACxC,EAAE,YAAY,EAAE,KAAK,EAAE,EACvB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAC1B;aACA,IAAI,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAS,EAAE,WAAiB;QACpC,OAAO,IAAI,CAAC,MAAM;aACf,gBAAgB,CACf;YACE,GAAG,EAAE;gBACH;oBACE,MAAM,EAAE,2CAAmB,CAAC,OAAO;oBACnC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE;iBAC7B;gBACD;oBACE,MAAM,EAAE,2CAAmB,CAAC,OAAO;oBACnC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;iBACjC;aACF;SACF,EACD,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,2CAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EACjE,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAC1C;aACA,IAAI,EAAsB;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;CACF,CAAA;AAzDY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAOR,mBAAA,IAAA,wBAAa,EAAC,uCAAiB,CAAC,IAAI,CAAC,CAAA;IAErC,mBAAA,IAAA,6BAAkB,GAAE,CAAA;6CADe,gBAAK;QAEA,qBAAU;QAC3C,2BAAe;GAVd,qBAAqB,CAyDjC"}

package/src/services/email-outbox.service.d.ts

@@ -0,0 +1,20 @@
+import { LogFactory } from '@tc-libs/logger';
+import { IEmailOutboxEnqueueOptions, IEmailOutboxMessage } from '../interfaces/email-outbox.interface';
+import { EmailOutboxRepository } from '../repository/repositories/email-outbox.repository';
+import { EmailSenderService } from './email-sender.service';
+/**
+ * Outbox delle email transazionali. Gli eventi accodano con `enqueue` nella propria transazione, EmailOutboxTask invia
+ * con `processDue`. L'invio è "almeno una volta": un nodo che cade fra l'invio e la conferma fa ripartire l'email.
+ */
+export declare class EmailOutboxService {
+    private readonly _outbox;
+    private readonly _email;
+    private readonly _logger;
+    constructor(_outbox: EmailOutboxRepository, _email: EmailSenderService, logFactory: LogFactory);
+    /** Accoda un'email; con `session` la scrittura fa parte della transazione dell'evento che la genera. */
+    enqueue({ template, lang, to, cc, bcc, variables }: IEmailOutboxMessage, { idempotencyKey, session }: IEmailOutboxEnqueueOptions): Promise<void>;
+    /** Invia le email dovute, al massimo EMAIL_OUTBOX_BATCH_SIZE per giro. Restituisce quante ne ha prese in carico. */
+    processDue(now?: Date): Promise<number>;
+    private _send;
+    private _registerFailure;
+}

package/src/services/email-outbox.service.js

@@ -0,0 +1,96 @@
+"use strict";
+var EmailOutboxService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailOutboxService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const logger_1 = require("@tc-libs/logger");
+const email_outbox_constant_1 = require("../constants/email-outbox.constant");
+const email_outbox_repository_1 = require("../repository/repositories/email-outbox.repository");
+const email_outbox_util_1 = require("../utils/email-outbox.util");
+const email_sender_service_1 = require("./email-sender.service");
+/**
+ * Outbox delle email transazionali. Gli eventi accodano con `enqueue` nella propria transazione, EmailOutboxTask invia
+ * con `processDue`. L'invio è "almeno una volta": un nodo che cade fra l'invio e la conferma fa ripartire l'email.
+ */
+let EmailOutboxService = EmailOutboxService_1 = class EmailOutboxService {
+    constructor(_outbox, _email, logFactory) {
+        this._outbox = _outbox;
+        this._email = _email;
+        this._logger = logFactory.createLogger(EmailOutboxService_1.name);
+    }
+    /** Accoda un'email; con `session` la scrittura fa parte della transazione dell'evento che la genera. */
+    async enqueue({ template, lang, to, cc, bcc, variables = {} }, { idempotencyKey, session }) {
+        await this._outbox.enqueueOnce({
+            idempotencyKey,
+            template,
+            lang,
+            to,
+            cc,
+            bcc,
+            variables,
+            status: email_outbox_constant_1.EMAIL_OUTBOX_STATUS.PENDING,
+            attempts: 0,
+            nextAttemptAt: new Date(),
+        }, session);
+    }
+    /** Invia le email dovute, al massimo EMAIL_OUTBOX_BATCH_SIZE per giro. Restituisce quante ne ha prese in carico. */
+    async processDue(now = new Date()) {
+        const staleBefore = new Date(now.getTime() - email_outbox_constant_1.EMAIL_OUTBOX_CLAIM_TIMEOUT_MS);
+        let processed = 0;
+        while (processed < email_outbox_constant_1.EMAIL_OUTBOX_BATCH_SIZE) {
+            const email = await this._outbox.claimNext(now, staleBefore);
+            if (!email)
+                break;
+            processed++;
+            await this._send(email, now);
+        }
+        return processed;
+    }
+    async _send(email, now) {
+        try {
+            await this._email.sendTemplate({
+                lang: email.lang,
+                template: email.template,
+                options: { to: email.to, cc: email.cc, bcc: email.bcc },
+                variables: email.variables,
+            });
+        }
+        catch (error) {
+            await this._registerFailure(email, error, now);
+            return;
+        }
+        await this._outbox.updateById(email._id, {
+            $set: { status: email_outbox_constant_1.EMAIL_OUTBOX_STATUS.SENT, sentAt: new Date() },
+            $unset: { claimedAt: '', lastError: '' },
+        });
+    }
+    async _registerFailure(email, error, now) {
+        const attempts = email.attempts + 1;
+        const lastError = (0, email_outbox_util_1.redactEmailError)(error);
+        const failed = attempts >= email_outbox_constant_1.EMAIL_OUTBOX_MAX_ATTEMPTS;
+        await this._outbox.updateById(email._id, {
+            $set: {
+                attempts,
+                lastError,
+                status: failed
+                    ? email_outbox_constant_1.EMAIL_OUTBOX_STATUS.FAILED
+                    : email_outbox_constant_1.EMAIL_OUTBOX_STATUS.PENDING,
+                nextAttemptAt: new Date(now.getTime() + (0, email_outbox_util_1.emailOutboxBackoffMs)(attempts)),
+            },
+            $unset: { claimedAt: '' },
+        });
+        if (failed) {
+            // Solo id, template e motivo: niente destinatari né variabili nella notifica.
+            this._logger.notifyError(new Error(`Email outbox ${email._id} (${email.template}) non inviata dopo ${attempts} tentativi: ${lastError}`));
+        }
+    }
+};
+exports.EmailOutboxService = EmailOutboxService;
+exports.EmailOutboxService = EmailOutboxService = EmailOutboxService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [email_outbox_repository_1.EmailOutboxRepository,
+        email_sender_service_1.EmailSenderService,
+        logger_1.LogFactory])
+], EmailOutboxService);
+//# sourceMappingURL=email-outbox.service.js.map

package/src/services/email-outbox.service.js.map

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

package/src/tasks/email-outbox.task.d.ts

@@ -0,0 +1,19 @@
+import { LogFactory } from '@tc-libs/logger';
+import { RetryPolicyMongoService } from '@tc-libs/retry-policy';
+import { AbstractCronTask, TaskRunService, TaskService } from '@tc-libs/task';
+import { EmailSenderOptions } from '../email-sender.module.options';
+import { EmailOutboxService } from '../services/email-outbox.service';
+/**
+ * Invio dell'outbox ogni minuto, con il lock distribuito di @tc-libs/task per `app.name`. Senza createSession: l'invio
+ * è un effetto esterno e un retry di transazione lo ripeterebbe; ogni email passa a SENDING con un update atomico.
+ * L'app lo registra fra i provider del proprio router dei job (serve TaskModule) e lo attiva per ambiente.
+ */
+export declare class EmailOutboxTask extends AbstractCronTask {
+    private readonly _outbox;
+    code: string;
+    staleMs: number;
+    private readonly _envName;
+    constructor(logFactory: LogFactory, taskService: TaskService, taskRunService: TaskRunService, retryPolicy: RetryPolicyMongoService, options: EmailSenderOptions, _outbox: EmailOutboxService);
+    handleCron(): Promise<void>;
+    protected work(): Promise<void>;
+}

package/src/tasks/email-outbox.task.js

@@ -0,0 +1,52 @@
+"use strict";
+var EmailOutboxTask_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailOutboxTask = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const logger_1 = require("@tc-libs/logger");
+const retry_policy_1 = require("@tc-libs/retry-policy");
+const task_1 = require("@tc-libs/task");
+const email_outbox_constant_1 = require("../constants/email-outbox.constant");
+const email_sender_module_options_1 = require("../email-sender.module.options");
+const email_outbox_service_1 = require("../services/email-outbox.service");
+/**
+ * Invio dell'outbox ogni minuto, con il lock distribuito di @tc-libs/task per `app.name`. Senza createSession: l'invio
+ * è un effetto esterno e un retry di transazione lo ripeterebbe; ogni email passa a SENDING con un update atomico.
+ * L'app lo registra fra i provider del proprio router dei job (serve TaskModule) e lo attiva per ambiente.
+ */
+let EmailOutboxTask = EmailOutboxTask_1 = class EmailOutboxTask extends task_1.AbstractCronTask {
+    constructor(logFactory, taskService, taskRunService, retryPolicy, options, _outbox) {
+        super(logFactory, EmailOutboxTask_1.name, taskService, taskRunService, retryPolicy);
+        this._outbox = _outbox;
+        this.code = email_outbox_constant_1.EMAIL_OUTBOX_TASK_CODE;
+        this.staleMs = email_outbox_constant_1.EMAIL_OUTBOX_TASK_STALE_MS;
+        if (!options.app.name) {
+            throw new Error('EmailOutboxTask: app.name mancante nelle opzioni di EmailSenderModule');
+        }
+        this._envName = options.app.name;
+    }
+    async handleCron() {
+        await this.run(this._envName);
+    }
+    async work() {
+        await this._outbox.processDue();
+    }
+};
+exports.EmailOutboxTask = EmailOutboxTask;
+tslib_1.__decorate([
+    (0, schedule_1.Cron)(schedule_1.CronExpression.EVERY_MINUTE, { name: email_outbox_constant_1.EMAIL_OUTBOX_TASK_CODE }),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], EmailOutboxTask.prototype, "handleCron", null);
+exports.EmailOutboxTask = EmailOutboxTask = EmailOutboxTask_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(4, (0, common_1.Inject)(email_sender_module_options_1.EMAIL_SENDER_CONFIG_OPTIONS)),
+    tslib_1.__metadata("design:paramtypes", [logger_1.LogFactory,
+        task_1.TaskService,
+        task_1.TaskRunService,
+        retry_policy_1.RetryPolicyMongoService, Object, email_outbox_service_1.EmailOutboxService])
+], EmailOutboxTask);
+//# sourceMappingURL=email-outbox.task.js.map

package/src/tasks/email-outbox.task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-outbox.task.js","sourceRoot":"","sources":["../../../../../packages/email-sender/src/tasks/email-outbox.task.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,+CAAwD;AACxD,4CAA6C;AAC7C,wDAAgE;AAChE,wCAA8E;AAC9E,8EAG4C;AAC5C,gFAGwC;AACxC,2EAAsE;AAEtE;;;;GAIG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAgB,SAAQ,uBAAgB;IAKnD,YACE,UAAsB,EACtB,WAAwB,EACxB,cAA8B,EAC9B,WAAoC,EACC,OAA2B,EAC/C,OAA2B;QAE5C,KAAK,CACH,UAAU,EACV,iBAAe,CAAC,IAAI,EACpB,WAAW,EACX,cAAc,EACd,WAAW,CACZ,CAAC;QARe,YAAO,GAAP,OAAO,CAAoB;QAVrC,SAAI,GAAG,8CAAsB,CAAC;QAC9B,YAAO,GAAG,kDAA0B,CAAC;QAkB5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IACnC,CAAC;IAGK,AAAN,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;CACF,CAAA;AApCY,0CAAe;AA6BpB;IADL,IAAA,eAAI,EAAC,yBAAc,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,8CAAsB,EAAE,CAAC;;;;iDAGnE;0BA/BU,eAAe;IAD3B,IAAA,mBAAU,GAAE;IAWR,mBAAA,IAAA,eAAM,EAAC,yDAA2B,CAAC,CAAA;6CAJxB,mBAAU;QACT,kBAAW;QACR,qBAAc;QACjB,sCAAuB,UAEV,yCAAkB;GAXnC,eAAe,CAoC3B"}

package/src/utils/email-outbox.util.d.ts

@@ -0,0 +1,4 @@
+/** Attesa prima del prossimo tentativo, dopo `attempts` fallimenti: raddoppia a ogni errore, fino al massimo. */
+export declare function emailOutboxBackoffMs(attempts: number): number;
+/** Errore da salvare o notificare senza dati personali: gli indirizzi email diventano [email]. */
+export declare function redactEmailError(error: unknown): string;

package/src/utils/email-outbox.util.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emailOutboxBackoffMs = emailOutboxBackoffMs;
+exports.redactEmailError = redactEmailError;
+const email_outbox_constant_1 = require("../constants/email-outbox.constant");
+/** Attesa prima del prossimo tentativo, dopo `attempts` fallimenti: raddoppia a ogni errore, fino al massimo. */
+function emailOutboxBackoffMs(attempts) {
+    return Math.min(email_outbox_constant_1.EMAIL_OUTBOX_BACKOFF_BASE_MS * 2 ** Math.max(attempts - 1, 0), email_outbox_constant_1.EMAIL_OUTBOX_BACKOFF_MAX_MS);
+}
+/** Errore da salvare o notificare senza dati personali: gli indirizzi email diventano [email]. */
+function redactEmailError(error) {
+    const message = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+    return message
+        .replace(/[^\s@<>"',;:]+@[^\s@<>"',;:]+/g, '[email]')
+        .slice(0, 500);
+}
+//# sourceMappingURL=email-outbox.util.js.map

package/src/utils/email-outbox.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-outbox.util.js","sourceRoot":"","sources":["../../../../../packages/email-sender/src/utils/email-outbox.util.ts"],"names":[],"mappings":";;AAMA,oDAKC;AAGD,4CAMC;AApBD,8EAG4C;AAE5C,iHAAiH;AACjH,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,OAAO,IAAI,CAAC,GAAG,CACb,oDAA4B,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC,EAC7D,mDAA2B,CAC5B,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7E,OAAO,OAAO;SACX,OAAO,CAAC,gCAAgC,EAAE,SAAS,CAAC;SACpD,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC"}