@carlonicora/nestjs-neo4jsonapi 8.8.0 → 8.10.0

package/dist/foundations/email-blast/entities/email-blast-delivery.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailBlastDeliveryDescriptor = void 0;
+const common_1 = require("../../../common");
+const email_blast_delivery_meta_1 = require("./email-blast-delivery.meta");
+const email_blast_meta_1 = require("./email-blast.meta");
+exports.EmailBlastDeliveryDescriptor = (0, common_1.defineEntity)()({
+    ...email_blast_delivery_meta_1.emailBlastDeliveryMeta,
+    // Deliveries belong to a (non company-scoped) blast
+    isCompanyScoped: false,
+    tenancy: "internal",
+    fields: {
+        email: { type: "string", required: true },
+        name: { type: "string" },
+        userId: { type: "string", required: true },
+        status: { type: "string", required: true },
+        unsubscribeToken: { type: "string", required: true },
+        claimedAt: { type: "datetime" },
+        sentAt: { type: "datetime" },
+        unsubscribedAt: { type: "datetime" },
+        error: { type: "string" },
+    },
+    relationships: {
+        blast: {
+            model: email_blast_meta_1.emailBlastMeta,
+            direction: "in",
+            relationship: "HAS_DELIVERY",
+            cardinality: "one",
+            required: true,
+            dtoKey: "blast",
+        },
+    },
+});
+//# sourceMappingURL=email-blast-delivery.js.map

package/dist/foundations/email-blast/entities/email-blast-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast-delivery.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/entities/email-blast-delivery.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AAEvD,2EAAqE;AACrE,yDAAoD;AAqBvC,QAAA,4BAA4B,GAAG,IAAA,qBAAY,GAAsB,CAAC;IAC7E,GAAG,kDAAsB;IAEzB,oDAAoD;IACpD,eAAe,EAAE,KAAK;IACtB,OAAO,EAAE,UAAU;IAEnB,MAAM,EAAE;QACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpD,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC5B,cAAc,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QACpC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B;IAED,aAAa,EAAE;QACb,KAAK,EAAE;YACL,KAAK,EAAE,iCAAc;YACrB,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,cAAc;YAC5B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,OAAO;SAChB;KACF;CACF,CAAC,CAAC"}

package/dist/foundations/email-blast/entities/email-blast-delivery.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const emailBlastDeliveryMeta: DataMeta;
+//# sourceMappingURL=email-blast-delivery.meta.d.ts.map

package/dist/foundations/email-blast/entities/email-blast-delivery.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast-delivery.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/entities/email-blast-delivery.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,sBAAsB,EAAE,QAKpC,CAAC"}

package/dist/foundations/email-blast/entities/email-blast-delivery.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emailBlastDeliveryMeta = void 0;
+exports.emailBlastDeliveryMeta = {
+    type: "email-blast-deliveries",
+    endpoint: "email-blast-deliveries",
+    nodeName: "emailBlastDelivery",
+    labelName: "EmailBlastDelivery",
+};
+//# sourceMappingURL=email-blast-delivery.meta.js.map

package/dist/foundations/email-blast/entities/email-blast-delivery.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast-delivery.meta.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/entities/email-blast-delivery.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAa;IAC9C,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,wBAAwB;IAClC,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,oBAAoB;CAChC,CAAC"}

package/dist/foundations/email-blast/entities/email-blast.d.ts

@@ -0,0 +1,16 @@
+import { Entity } from "../../../common";
+export type EmailBlastStatus = "draft" | "sending" | "sent";
+export type EmailBlast = Entity & {
+    subject: string;
+    body: string;
+    replyTo?: string;
+    status: EmailBlastStatus;
+    sentAt?: Date;
+    recipientCount?: number;
+    sentCount: number;
+    failedCount: number;
+    unsubscribedCount: number;
+};
+export declare const EmailBlastDescriptor: import("../../../common").EntityDescriptor<EmailBlast, {}>;
+export type EmailBlastDescriptorType = typeof EmailBlastDescriptor;
+//# sourceMappingURL=email-blast.d.ts.map

package/dist/foundations/email-blast/entities/email-blast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/entities/email-blast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAGvD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,oBAAoB,4DAqB/B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,oBAAoB,CAAC"}

package/dist/foundations/email-blast/entities/email-blast.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailBlastDescriptor = void 0;
+const common_1 = require("../../../common");
+const email_blast_meta_1 = require("./email-blast.meta");
+exports.EmailBlastDescriptor = (0, common_1.defineEntity)()({
+    ...email_blast_meta_1.emailBlastMeta,
+    // Blasts are NOT company-scoped: administrators send them to the whole app
+    isCompanyScoped: false,
+    tenancy: "internal",
+    fields: {
+        subject: { type: "string", required: true },
+        body: { type: "string", required: true },
+        replyTo: { type: "string" },
+        // Not required: the POST DTO never carries it, the default sets it
+        status: { type: "string", default: "draft" },
+        sentAt: { type: "datetime" },
+        recipientCount: { type: "number" },
+        sentCount: { type: "number", default: 0 },
+        failedCount: { type: "number", default: 0 },
+        unsubscribedCount: { type: "number", default: 0 },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=email-blast.js.map

package/dist/foundations/email-blast/entities/email-blast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/entities/email-blast.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,yDAAoD;AAgBvC,QAAA,oBAAoB,GAAG,IAAA,qBAAY,GAAc,CAAC;IAC7D,GAAG,iCAAc;IAEjB,2EAA2E;IAC3E,eAAe,EAAE,KAAK;IACtB,OAAO,EAAE,UAAU;IAEnB,MAAM,EAAE;QACN,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,mEAAmE;QACnE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC5B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;QACzC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;QAC3C,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;KAClD;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/email-blast/entities/email-blast.meta.d.ts

@@ -0,0 +1,13 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const emailBlastMeta: DataMeta;
+/** Public unsubscribe route segment: `email-blasts/unsubscribe/:token`. */
+export declare const EMAIL_BLAST_UNSUBSCRIBE_SEGMENT = "unsubscribe";
+/** JSON:API type of the unsubscribe request body. */
+export declare const EMAIL_BLAST_UNSUBSCRIBE_TYPE = "email-blast-unsubscribes";
+/** Admin route segment: `email-blasts/:emailBlastId/test`. */
+export declare const EMAIL_BLAST_TEST_SEGMENT = "test";
+/** Admin route segment: `email-blasts/:emailBlastId/send`. */
+export declare const EMAIL_BLAST_SEND_SEGMENT = "send";
+/** Admin route segment: `email-blasts/:emailBlastId/recipient-count`. */
+export declare const EMAIL_BLAST_AUDIENCE_SEGMENT = "recipient-count";
+//# sourceMappingURL=email-blast.meta.d.ts.map

package/dist/foundations/email-blast/entities/email-blast.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/entities/email-blast.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,cAAc,EAAE,QAK5B,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,gBAAgB,CAAC;AAE7D,qDAAqD;AACrD,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AAEvE,8DAA8D;AAC9D,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAE/C,8DAA8D;AAC9D,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAE/C,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,oBAAoB,CAAC"}

package/dist/foundations/email-blast/entities/email-blast.meta.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_BLAST_AUDIENCE_SEGMENT = exports.EMAIL_BLAST_SEND_SEGMENT = exports.EMAIL_BLAST_TEST_SEGMENT = exports.EMAIL_BLAST_UNSUBSCRIBE_TYPE = exports.EMAIL_BLAST_UNSUBSCRIBE_SEGMENT = exports.emailBlastMeta = void 0;
+exports.emailBlastMeta = {
+    type: "email-blasts",
+    endpoint: "email-blasts",
+    nodeName: "emailBlast",
+    labelName: "EmailBlast",
+};
+/** Public unsubscribe route segment: `email-blasts/unsubscribe/:token`. */
+exports.EMAIL_BLAST_UNSUBSCRIBE_SEGMENT = "unsubscribe";
+/** JSON:API type of the unsubscribe request body. */
+exports.EMAIL_BLAST_UNSUBSCRIBE_TYPE = "email-blast-unsubscribes";
+/** Admin route segment: `email-blasts/:emailBlastId/test`. */
+exports.EMAIL_BLAST_TEST_SEGMENT = "test";
+/** Admin route segment: `email-blasts/:emailBlastId/send`. */
+exports.EMAIL_BLAST_SEND_SEGMENT = "send";
+/** Admin route segment: `email-blasts/:emailBlastId/recipient-count`. */
+exports.EMAIL_BLAST_AUDIENCE_SEGMENT = "recipient-count";
+//# sourceMappingURL=email-blast.meta.js.map

package/dist/foundations/email-blast/entities/email-blast.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.meta.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/entities/email-blast.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAa;IACtC,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,YAAY;IACtB,SAAS,EAAE,YAAY;CACxB,CAAC;AAEF,2EAA2E;AAC9D,QAAA,+BAA+B,GAAG,aAAa,CAAC;AAE7D,qDAAqD;AACxC,QAAA,4BAA4B,GAAG,0BAA0B,CAAC;AAEvE,8DAA8D;AACjD,QAAA,wBAAwB,GAAG,MAAM,CAAC;AAE/C,8DAA8D;AACjD,QAAA,wBAAwB,GAAG,MAAM,CAAC;AAE/C,yEAAyE;AAC5D,QAAA,4BAA4B,GAAG,iBAAiB,CAAC"}

package/dist/foundations/email-blast/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./email-blast.module";
+export * from "./email-blast.constants";
+export * from "./entities/email-blast";
+export * from "./entities/email-blast.meta";
+export * from "./entities/email-blast-delivery";
+export * from "./entities/email-blast-delivery.meta";
+export * from "./entities/email-blast-audience";
+export * from "./entities/email-blast-audience.meta";
+export * from "./dtos/email-blast.post.dto";
+export * from "./dtos/email-blast.patch.dto";
+export * from "./dtos/email-blast-unsubscribe.dto";
+export * from "./repositories/email-blast.repository";
+export * from "./repositories/email-blast-delivery.repository";
+export * from "./repositories/email-blast.admin.repository";
+export * from "./services/email-blast.service";
+export * from "./services/email-blast-delivery.service";
+export * from "./utils/email-blast.renderer";
+export * from "./processors/email-blast.processor";
+export * from "./cron/email-blast-recovery.cron";
+//# sourceMappingURL=index.d.ts.map

package/dist/foundations/email-blast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/email-blast/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AAGrC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,6CAA6C,CAAC;AAG5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AAGxD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC"}

package/dist/foundations/email-blast/index.js

@@ -0,0 +1,44 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Module
+__exportStar(require("./email-blast.module"), exports);
+// Constants
+__exportStar(require("./email-blast.constants"), exports);
+// Entities + metas
+__exportStar(require("./entities/email-blast"), exports);
+__exportStar(require("./entities/email-blast.meta"), exports);
+__exportStar(require("./entities/email-blast-delivery"), exports);
+__exportStar(require("./entities/email-blast-delivery.meta"), exports);
+__exportStar(require("./entities/email-blast-audience"), exports);
+__exportStar(require("./entities/email-blast-audience.meta"), exports);
+// DTOs
+__exportStar(require("./dtos/email-blast.post.dto"), exports);
+__exportStar(require("./dtos/email-blast.patch.dto"), exports);
+__exportStar(require("./dtos/email-blast-unsubscribe.dto"), exports);
+// Repositories
+__exportStar(require("./repositories/email-blast.repository"), exports);
+__exportStar(require("./repositories/email-blast-delivery.repository"), exports);
+__exportStar(require("./repositories/email-blast.admin.repository"), exports);
+// Services
+__exportStar(require("./services/email-blast.service"), exports);
+__exportStar(require("./services/email-blast-delivery.service"), exports);
+// Renderer
+__exportStar(require("./utils/email-blast.renderer"), exports);
+// Worker
+__exportStar(require("./processors/email-blast.processor"), exports);
+__exportStar(require("./cron/email-blast-recovery.cron"), exports);
+//# sourceMappingURL=index.js.map

package/dist/foundations/email-blast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/email-blast/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS;AACT,uDAAqC;AAErC,YAAY;AACZ,0DAAwC;AAExC,mBAAmB;AACnB,yDAAuC;AACvC,8DAA4C;AAC5C,kEAAgD;AAChD,uEAAqD;AACrD,kEAAgD;AAChD,uEAAqD;AAErD,OAAO;AACP,8DAA4C;AAC5C,+DAA6C;AAC7C,qEAAmD;AAEnD,eAAe;AACf,wEAAsD;AACtD,iFAA+D;AAC/D,8EAA4D;AAE5D,WAAW;AACX,iEAA+C;AAC/C,0EAAwD;AAExD,WAAW;AACX,+DAA6C;AAE7C,SAAS;AACT,qEAAmD;AACnD,mEAAiD"}

package/dist/foundations/email-blast/processors/email-blast.processor.d.ts

@@ -0,0 +1,23 @@
+import { WorkerHost } from "@nestjs/bullmq";
+import { Job } from "bullmq";
+import { ClsService } from "nestjs-cls";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { EmailBlastJobData } from "../email-blast.constants";
+import { EmailBlastDeliveryService } from "../services/email-blast-delivery.service";
+/**
+ * Worker for `QueueId.EMAIL_BLAST` (registered with `createWorkerProvider`).
+ * One job at a time with a long lock: a blast to every consenting user can run for minutes.
+ * Each job runs in its own CLS context with no company set: the recipients span every
+ * company (owner decision D-1/D-3).
+ */
+export declare class EmailBlastProcessor extends WorkerHost {
+    private readonly deliveryService;
+    private readonly clsService;
+    private readonly logger;
+    constructor(deliveryService: EmailBlastDeliveryService, clsService: ClsService, logger: AppLoggingService);
+    onActive(job: Job): void;
+    onFailed(job: Job): void;
+    onCompleted(job: Job): void;
+    process(job: Job<EmailBlastJobData>): Promise<void>;
+}
+//# sourceMappingURL=email-blast.processor.d.ts.map

package/dist/foundations/email-blast/processors/email-blast.processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.processor.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/processors/email-blast.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAyB,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAErF;;;;;GAKG;AACH,qBACa,mBAAoB,SAAQ,UAAU;IAE/C,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,eAAe,EAAE,yBAAyB,EAC1C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,iBAAiB;IAM5C,QAAQ,CAAC,GAAG,EAAE,GAAG;IAKjB,QAAQ,CAAC,GAAG,EAAE,GAAG;IAKjB,WAAW,CAAC,GAAG,EAAE,GAAG;IAId,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB1D"}

package/dist/foundations/email-blast/processors/email-blast.processor.js

@@ -0,0 +1,80 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailBlastProcessor = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const bullmq_2 = require("bullmq");
+const nestjs_cls_1 = require("nestjs-cls");
+const queue_id_1 = require("../../../config/enums/queue.id");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const email_blast_constants_1 = require("../email-blast.constants");
+const email_blast_delivery_service_1 = require("../services/email-blast-delivery.service");
+/**
+ * Worker for `QueueId.EMAIL_BLAST` (registered with `createWorkerProvider`).
+ * One job at a time with a long lock: a blast to every consenting user can run for minutes.
+ * Each job runs in its own CLS context with no company set: the recipients span every
+ * company (owner decision D-1/D-3).
+ */
+let EmailBlastProcessor = class EmailBlastProcessor extends bullmq_1.WorkerHost {
+    constructor(deliveryService, clsService, logger) {
+        super();
+        this.deliveryService = deliveryService;
+        this.clsService = clsService;
+        this.logger = logger;
+    }
+    onActive(job) {
+        this.logger.debug(`Processing ${job.name} job (ID: ${job.id})`);
+    }
+    onFailed(job) {
+        this.logger.error(`Failed ${job.name} job (ID: ${job.id}). Reason: ${job.failedReason}`);
+    }
+    onCompleted(job) {
+        this.logger.debug(`Completed ${job.name} job (ID: ${job.id})`);
+    }
+    async process(job) {
+        switch (job.name) {
+            case email_blast_constants_1.EMAIL_BLAST_JOB_NAMES.sendBlast: {
+                const { blastId } = job.data;
+                const { sent, skipped, failed } = await this.clsService.run(() => this.deliveryService.processBlast({ blastId }));
+                this.logger.log(`Email blast ${blastId}: ${sent} sent, ${skipped} skipped, ${failed} failed`, "EmailBlastProcessor");
+                return;
+            }
+            default:
+                this.logger.warn(`Unknown email-blast job ${job.name} (ID: ${job.id})`);
+        }
+    }
+};
+exports.EmailBlastProcessor = EmailBlastProcessor;
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("active"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], EmailBlastProcessor.prototype, "onActive", null);
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("failed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], EmailBlastProcessor.prototype, "onFailed", null);
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("completed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], EmailBlastProcessor.prototype, "onCompleted", null);
+exports.EmailBlastProcessor = EmailBlastProcessor = __decorate([
+    (0, bullmq_1.Processor)(queue_id_1.QueueId.EMAIL_BLAST, { concurrency: 1, lockDuration: 15 * 60 * 1000 }),
+    __metadata("design:paramtypes", [email_blast_delivery_service_1.EmailBlastDeliveryService,
+        nestjs_cls_1.ClsService,
+        logging_service_1.AppLoggingService])
+], EmailBlastProcessor);
+//# sourceMappingURL=email-blast.processor.js.map

package/dist/foundations/email-blast/processors/email-blast.processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.processor.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/processors/email-blast.processor.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsE;AACtE,mCAA6B;AAC7B,2CAAwC;AACxC,6DAAyD;AACzD,oFAAmF;AACnF,oEAAoF;AACpF,2FAAqF;AAErF;;;;;GAKG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,mBAAU;IACjD,YACmB,eAA0C,EAC1C,UAAsB,EACtB,MAAyB;QAE1C,KAAK,EAAE,CAAC;QAJS,oBAAe,GAAf,eAAe,CAA2B;QAC1C,eAAU,GAAV,UAAU,CAAY;QACtB,WAAM,GAAN,MAAM,CAAmB;IAG5C,CAAC;IAGD,QAAQ,CAAC,GAAQ;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IAGD,QAAQ,CAAC,GAAQ;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,cAAc,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;IAC3F,CAAC;IAGD,WAAW,CAAC,GAAQ;QAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAA2B;QACvC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,6CAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;gBACrC,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;gBAC7B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAC/D,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAC/C,CAAC;gBACF,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,eAAe,OAAO,KAAK,IAAI,UAAU,OAAO,aAAa,MAAM,SAAS,EAC5E,qBAAqB,CACtB,CAAC;gBACF,OAAO;YACT,CAAC;YACD;gBACE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACF,CAAA;AAzCY,kDAAmB;AAU9B;IADC,IAAA,sBAAa,EAAC,QAAQ,CAAC;;qCACV,YAAG;;mDAEhB;AAGD;IADC,IAAA,sBAAa,EAAC,QAAQ,CAAC;;qCACV,YAAG;;mDAEhB;AAGD;IADC,IAAA,sBAAa,EAAC,WAAW,CAAC;;qCACV,YAAG;;sDAEnB;8BAtBU,mBAAmB;IAD/B,IAAA,kBAAS,EAAC,kBAAO,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;qCAG3C,wDAAyB;QAC9B,uBAAU;QACd,mCAAiB;GAJjC,mBAAmB,CAyC/B"}

package/dist/foundations/email-blast/repositories/email-blast-delivery.repository.d.ts

@@ -0,0 +1,98 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { EmailBlastDelivery, EmailBlastDeliveryDescriptor } from "../entities/email-blast-delivery";
+/**
+ * Every guarded write that changes a counter takes the delivery's write lock first and re-checks
+ * its guard after it (SET _lock / REMOVE _lock / WITH / WHERE), so two concurrent calls never both
+ * pass. The blast's lock is taken before its counter is read, so concurrent increments never lose
+ * one. A counter moves in the same query as the status it counts.
+ */
+export declare class EmailBlastDeliveryRepository extends AbstractRepository<EmailBlastDelivery, typeof EmailBlastDeliveryDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<EmailBlastDelivery, {
+        blast: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Builds the recipient list of a blast once: one pending delivery per eligible, distinct
+     * lower-cased email, and the blast's recipientCount (0 when nobody is eligible).
+     *
+     * Owner-approved exception (Carlo, 2026-10-27, decision D-1 of the email-blasts plan):
+     * - Only caller: EmailBlastDeliveryService.processBlast in the worker job, never an HTTP request.
+     * - The recipients are every company's users, so the query reads User nodes across companies
+     *   instead of buildDefaultMatch(), which scopes to one company.
+     * - initQuery() is not used: the worker CLS carries no company, and the query needs no
+     *   request alias. The blast is matched by an explicit id parameter.
+     * - Deliveries store userId as a field, never an edge to User.
+     * - validateRelatedNodes is not called: the only relationship target is the blast, matched by
+     *   id in the same query, and for a tenancy "internal" target with no company in context the
+     *   check is existence only.
+     * - The write returns no node, so it runs through executeInTransaction.
+     * - A second run does nothing: the blast's write lock is taken first, then the query stops
+     *   when the blast already has a delivery.
+     */
+    createSnapshot(params: {
+        blastId: string;
+    }): Promise<void>;
+    /**
+     * Claims up to `limit` pending deliveries of a blast (pending to sending), oldest first.
+     */
+    claimBatch(params: {
+        blastId: string;
+        limit: number;
+        claimedAt: Date;
+    }): Promise<EmailBlastDelivery[]>;
+    /**
+     * A claimed delivery was sent: sending to sent, and the blast's sentCount + 1.
+     */
+    markSent(params: {
+        id: string;
+        sentAt: Date;
+    }): Promise<void>;
+    /**
+     * A claimed delivery failed to send: sending to failed (never retried), and the blast's
+     * failedCount + 1.
+     */
+    markFailed(params: {
+        id: string;
+        error: string;
+    }): Promise<void>;
+    /**
+     * A claimed delivery whose address opted out after the snapshot: sending to skipped. No counter.
+     */
+    markSkipped(params: {
+        id: string;
+    }): Promise<void>;
+    /**
+     * Every delivery claimed before `claimedBefore` and still sending goes to failed (never resent),
+     * and its blast's failedCount rises by one per delivery, in one query.
+     */
+    failStuck(params: {
+        claimedBefore: Date;
+    }): Promise<void>;
+    /**
+     * The delivery an unsubscribe link belongs to, with its blast.
+     */
+    findByUnsubscribeToken(params: {
+        token: string;
+    }): Promise<EmailBlastDelivery | null>;
+    /**
+     * Stamps the first unsubscribe of a delivery and raises the blast's unsubscribedCount, once.
+     * True when this call was the one that matched.
+     */
+    markUnsubscribed(params: {
+        id: string;
+        unsubscribedAt: Date;
+    }): Promise<boolean>;
+    /** Binds the delivery's blast as COUNTED_BLAST and takes its write lock before a counter is read. */
+    private _lockCountedBlast;
+}
+//# sourceMappingURL=email-blast-delivery.repository.d.ts.map

package/dist/foundations/email-blast/repositories/email-blast-delivery.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast-delivery.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/repositories/email-blast-delivery.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAEnF,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAOpG;;;;;GAKG;AACH,qBACa,4BAA6B,SAAQ,kBAAkB,CAClE,kBAAkB,EAClB,OAAO,4BAA4B,CAAC,aAAa,CAClD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAAgC;gBAEjD,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoChE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkC5G;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BnE;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBtE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxD;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/D;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAa3F;;;OAGG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BtF,qGAAqG;IACrG,OAAO,CAAC,iBAAiB;CAS1B"}