@carlonicora/nestjs-neo4jsonapi 8.9.0 → 8.10.1

package/dist/foundations/email-blast/repositories/email-blast-delivery.repository.js

@@ -0,0 +1,273 @@
+"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.EmailBlastDeliveryRepository = void 0;
+const common_1 = require("@nestjs/common");
+const neo4j_driver_1 = require("neo4j-driver");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const email_blast_constants_1 = require("../email-blast.constants");
+const email_blast_delivery_1 = require("../entities/email-blast-delivery");
+const email_blast_delivery_meta_1 = require("../entities/email-blast-delivery.meta");
+const email_blast_meta_1 = require("../entities/email-blast.meta");
+/** Alias of the blast whose counter a delivery write raises (never the return statement's alias). */
+const COUNTED_BLAST = "countedBlast";
+/**
+ * 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.
+ */
+let EmailBlastDeliveryRepository = class EmailBlastDeliveryRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = email_blast_delivery_1.EmailBlastDeliveryDescriptor;
+    }
+    /**
+     * 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.
+     */
+    async createSnapshot(params) {
+        const blast = email_blast_meta_1.emailBlastMeta.nodeName;
+        const delivery = email_blast_delivery_meta_1.emailBlastDeliveryMeta.nodeName;
+        const query = `
+      MATCH (${blast}:${email_blast_meta_1.emailBlastMeta.labelName} {id: $blastId})
+      SET ${blast}._lock = true
+      REMOVE ${blast}._lock
+      WITH ${blast}
+      WHERE NOT EXISTS {
+        MATCH (${blast})-[:HAS_DELIVERY]->(:${email_blast_delivery_meta_1.emailBlastDeliveryMeta.labelName})
+      }
+      CALL {
+        ${email_blast_constants_1.ELIGIBLE_RECIPIENTS_CYPHER}
+        RETURN collect({ email: email, recipient: recipient }) AS rows
+      }
+      FOREACH (row IN rows |
+        CREATE (${delivery}:${email_blast_delivery_meta_1.emailBlastDeliveryMeta.labelName} {
+          id: randomUUID(),
+          email: row.email,
+          name: row.recipient.name,
+          userId: row.recipient.id,
+          status: "pending",
+          unsubscribeToken: randomUUID(),
+          createdAt: datetime(),
+          updatedAt: datetime()
+        })
+        CREATE (${blast})-[:HAS_DELIVERY]->(${delivery})
+      )
+      SET ${blast}.recipientCount = size(rows),
+          ${blast}.updatedAt = datetime()
+    `;
+        await this.neo4j.executeInTransaction([{ query, params: { blastId: params.blastId } }]);
+    }
+    /**
+     * Claims up to `limit` pending deliveries of a blast (pending to sending), oldest first.
+     */
+    async claimBatch(params) {
+        const { nodeName } = email_blast_delivery_meta_1.emailBlastDeliveryMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_delivery_1.EmailBlastDeliveryDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            blastId: params.blastId,
+            limit: (0, neo4j_driver_1.int)(params.limit),
+            claimedAt: params.claimedAt.toISOString(),
+        };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${nodeName}.status = "pending"
+      AND EXISTS {
+        MATCH (${nodeName})<-[:HAS_DELIVERY]-(:${email_blast_meta_1.emailBlastMeta.labelName} {id: $blastId})
+      }
+      WITH ${nodeName}
+      ORDER BY ${nodeName}.createdAt ASC
+      LIMIT $limit
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.status = "pending"
+      SET ${nodeName}.status = "sending",
+          ${nodeName}.claimedAt = datetime($claimedAt),
+          ${nodeName}.updatedAt = datetime()
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        return (await this.neo4j.writeAndReturnMany(query)) ?? [];
+    }
+    /**
+     * A claimed delivery was sent: sending to sent, and the blast's sentCount + 1.
+     */
+    async markSent(params) {
+        const { nodeName } = email_blast_delivery_meta_1.emailBlastDeliveryMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_delivery_1.EmailBlastDeliveryDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            searchValue: params.id,
+            sentAt: params.sentAt.toISOString(),
+        };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.status = "sending"
+      ${this._lockCountedBlast()}
+      SET ${nodeName}.status = "sent",
+          ${nodeName}.sentAt = datetime($sentAt),
+          ${nodeName}.updatedAt = datetime(),
+          ${COUNTED_BLAST}.sentCount = coalesce(${COUNTED_BLAST}.sentCount, 0) + 1
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    /**
+     * A claimed delivery failed to send: sending to failed (never retried), and the blast's
+     * failedCount + 1.
+     */
+    async markFailed(params) {
+        const { nodeName } = email_blast_delivery_meta_1.emailBlastDeliveryMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_delivery_1.EmailBlastDeliveryDescriptor.model });
+        query.queryParams = { ...query.queryParams, searchValue: params.id, error: params.error };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.status = "sending"
+      ${this._lockCountedBlast()}
+      SET ${nodeName}.status = "failed",
+          ${nodeName}.error = $error,
+          ${nodeName}.updatedAt = datetime(),
+          ${COUNTED_BLAST}.failedCount = coalesce(${COUNTED_BLAST}.failedCount, 0) + 1
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    /**
+     * A claimed delivery whose address opted out after the snapshot: sending to skipped. No counter.
+     */
+    async markSkipped(params) {
+        const { nodeName } = email_blast_delivery_meta_1.emailBlastDeliveryMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_delivery_1.EmailBlastDeliveryDescriptor.model });
+        query.queryParams = { ...query.queryParams, searchValue: params.id };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.status = "sending"
+      SET ${nodeName}.status = "skipped",
+          ${nodeName}.updatedAt = datetime()
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    /**
+     * 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.
+     */
+    async failStuck(params) {
+        const { nodeName } = email_blast_delivery_meta_1.emailBlastDeliveryMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_delivery_1.EmailBlastDeliveryDescriptor.model });
+        query.queryParams = { ...query.queryParams, claimedBefore: params.claimedBefore.toISOString() };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${nodeName}.status = "sending"
+      AND ${nodeName}.claimedAt < datetime($claimedBefore)
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.status = "sending"
+      AND ${nodeName}.claimedAt < datetime($claimedBefore)
+      ${this._lockCountedBlast()}
+      SET ${nodeName}.status = "failed",
+          ${nodeName}.error = "stuck",
+          ${nodeName}.updatedAt = datetime(),
+          ${COUNTED_BLAST}.failedCount = coalesce(${COUNTED_BLAST}.failedCount, 0) + 1
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        await this.neo4j.writeAndReturnMany(query);
+    }
+    /**
+     * The delivery an unsubscribe link belongs to, with its blast.
+     */
+    async findByUnsubscribeToken(params) {
+        const query = this.neo4j.initQuery({ serialiser: email_blast_delivery_1.EmailBlastDeliveryDescriptor.model });
+        query.queryParams = { ...query.queryParams, searchValue: params.token };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "unsubscribeToken" })}
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readOne(query);
+    }
+    /**
+     * Stamps the first unsubscribe of a delivery and raises the blast's unsubscribedCount, once.
+     * True when this call was the one that matched.
+     */
+    async markUnsubscribed(params) {
+        const { nodeName } = email_blast_delivery_meta_1.emailBlastDeliveryMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_delivery_1.EmailBlastDeliveryDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            searchValue: params.id,
+            unsubscribedAt: params.unsubscribedAt.toISOString(),
+        };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.unsubscribedAt IS NULL
+      ${this._lockCountedBlast()}
+      SET ${nodeName}.unsubscribedAt = datetime($unsubscribedAt),
+          ${nodeName}.updatedAt = datetime(),
+          ${COUNTED_BLAST}.unsubscribedCount = coalesce(${COUNTED_BLAST}.unsubscribedCount, 0) + 1
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        return !!(await this.neo4j.writeOne(query));
+    }
+    /** Binds the delivery's blast as COUNTED_BLAST and takes its write lock before a counter is read. */
+    _lockCountedBlast() {
+        const { nodeName } = email_blast_delivery_meta_1.emailBlastDeliveryMeta;
+        return `
+      MATCH (${nodeName})<-[:HAS_DELIVERY]-(${COUNTED_BLAST}:${email_blast_meta_1.emailBlastMeta.labelName})
+      SET ${COUNTED_BLAST}._lock = true
+      REMOVE ${COUNTED_BLAST}._lock
+      WITH ${nodeName}, ${COUNTED_BLAST}
+    `;
+    }
+};
+exports.EmailBlastDeliveryRepository = EmailBlastDeliveryRepository;
+exports.EmailBlastDeliveryRepository = EmailBlastDeliveryRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], EmailBlastDeliveryRepository);
+//# sourceMappingURL=email-blast-delivery.repository.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast-delivery.repository.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/repositories/email-blast-delivery.repository.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+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 { EmailBlastAudience, EmailBlastAudienceDescriptor } from "../entities/email-blast-audience";
+export declare class EmailBlastAdminRepository extends AbstractRepository<EmailBlastAudience, typeof EmailBlastAudienceDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<EmailBlastAudience, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * How many distinct addresses a blast would reach right now (the same eligibility block the
+     * snapshot uses). `id` is the blast id.
+     */
+    countEligibleRecipients(params: {
+        blastId: string;
+    }): Promise<EmailBlastAudience>;
+    /** Seeds a query with only the parameters it needs: none (never the caller's companyId). */
+    private _adminQuery;
+}
+//# sourceMappingURL=email-blast.admin.repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.admin.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/repositories/email-blast.admin.repository.ts"],"names":[],"mappings":"AAWA,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;AAIpG,qBACa,yBAA0B,SAAQ,kBAAkB,CAC/D,kBAAkB,EAClB,OAAO,4BAA4B,CAAC,aAAa,CAClD;IAEC,SAAS,CAAC,QAAQ,CAAC,UAAU,8DAAgC;gBAEjD,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;OAGG;IACG,uBAAuB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiBvF,4FAA4F;IAC5F,OAAO,CAAC,WAAW;CAGpB"}

package/dist/foundations/email-blast/repositories/email-blast.admin.repository.js

@@ -0,0 +1,63 @@
+"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.EmailBlastAdminRepository = void 0;
+// nja-lint-ignore-file: cross-tenant administrative read repository.
+//
+// The recipient count of a blast covers every company's users, so buildDefaultMatch(), which
+// scopes to the caller's company, would undercount; initQuery() is skipped for the same reason
+// (it prepends the caller's company MATCH). The query returns one scalar count, which
+// readOne()/readMany() cannot map. Only EmailBlastController.findAudience and .send reach it,
+// gated by JwtAuthGuard and Roles(SystemRoles.Administrator).
+//
+// Queries seed themselves from _adminQuery(); no query here binds a parameter named companyId.
+const common_1 = require("@nestjs/common");
+const neo4j_driver_1 = require("neo4j-driver");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const email_blast_constants_1 = require("../email-blast.constants");
+const email_blast_audience_1 = require("../entities/email-blast-audience");
+let EmailBlastAdminRepository = class EmailBlastAdminRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        // Only satisfies the base class: nothing here goes through the inherited CRUD.
+        this.descriptor = email_blast_audience_1.EmailBlastAudienceDescriptor;
+    }
+    /**
+     * How many distinct addresses a blast would reach right now (the same eligibility block the
+     * snapshot uses). `id` is the blast id.
+     */
+    async countEligibleRecipients(params) {
+        const seed = this._adminQuery();
+        seed.query = `
+      ${email_blast_constants_1.ELIGIBLE_RECIPIENTS_CYPHER}
+      RETURN count(email) AS recipientCount
+    `;
+        const result = await this.neo4j.read(seed.query, seed.queryParams);
+        const raw = result.records[0]?.get("recipientCount");
+        return {
+            id: params.blastId,
+            recipientCount: (0, neo4j_driver_1.isInt)(raw) ? raw.toNumber() : Number(raw ?? 0),
+        };
+    }
+    /** Seeds a query with only the parameters it needs: none (never the caller's companyId). */
+    _adminQuery() {
+        return { query: "", queryParams: {} };
+    }
+};
+exports.EmailBlastAdminRepository = EmailBlastAdminRepository;
+exports.EmailBlastAdminRepository = EmailBlastAdminRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], EmailBlastAdminRepository);
+//# sourceMappingURL=email-blast.admin.repository.js.map

package/dist/foundations/email-blast/repositories/email-blast.admin.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.admin.repository.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/repositories/email-blast.admin.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qEAAqE;AACrE,EAAE;AACF,6FAA6F;AAC7F,+FAA+F;AAC/F,sFAAsF;AACtF,8FAA8F;AAC9F,8DAA8D;AAC9D,EAAE;AACF,+FAA+F;AAC/F,2CAA4C;AAC5C,+CAAqC;AACrC,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,oEAAsE;AACtE,2EAAoG;AAK7F,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,wCAG9C;IAIC,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAJ5C,+EAA+E;QAC5D,eAAU,GAAG,mDAA4B,CAAC;IAI7D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,uBAAuB,CAAC,MAA2B;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEhC,IAAI,CAAC,KAAK,GAAG;QACT,kDAA0B;;KAE7B,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,MAAM,GAAG,GAAI,MAAM,CAAC,OAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAEhE,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,cAAc,EAAE,IAAA,oBAAK,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;SACzC,CAAC;IAC1B,CAAC;IAED,4FAA4F;IACpF,WAAW;QACjB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;CACF,CAAA;AApCY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;qCAQQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAP9E,yBAAyB,CAoCrC"}

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

@@ -0,0 +1,29 @@
+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 { EmailBlast, EmailBlastDescriptor } from "../entities/email-blast";
+export declare class EmailBlastRepository extends AbstractRepository<EmailBlast, typeof EmailBlastDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<EmailBlast, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Moves a draft to `sending` and stamps `sentAt`. The node's write lock is taken before the
+     * draft check, so of two concurrent calls only one matches; null when it is not a draft.
+     */
+    markSending(params: {
+        id: string;
+        sentAt: Date;
+    }): Promise<EmailBlast | null>;
+    /**
+     * Moves a `sending` blast to `sent` once none of its deliveries is `pending` or `sending`.
+     * Null when the blast is not done yet (or not sending).
+     */
+    markSentIfDone(params: {
+        id: string;
+    }): Promise<EmailBlast | null>;
+    /**
+     * Every blast still sending (the recovery cron re-enqueues them).
+     */
+    findSending(): Promise<EmailBlast[]>;
+}
+//# sourceMappingURL=email-blast.repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/repositories/email-blast.repository.ts"],"names":[],"mappings":"AACA,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;AACnF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAI3E,qBACa,oBAAqB,SAAQ,kBAAkB,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC,aAAa,CAAC;IACjH,SAAS,CAAC,QAAQ,CAAC,UAAU,sDAAwB;gBAEzC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA0BnF;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAyBxE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;CAa3C"}

package/dist/foundations/email-blast/repositories/email-blast.repository.js

@@ -0,0 +1,97 @@
+"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.EmailBlastRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const email_blast_1 = require("../entities/email-blast");
+const email_blast_delivery_meta_1 = require("../entities/email-blast-delivery.meta");
+const email_blast_meta_1 = require("../entities/email-blast.meta");
+let EmailBlastRepository = class EmailBlastRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = email_blast_1.EmailBlastDescriptor;
+    }
+    /**
+     * Moves a draft to `sending` and stamps `sentAt`. The node's write lock is taken before the
+     * draft check, so of two concurrent calls only one matches; null when it is not a draft.
+     */
+    async markSending(params) {
+        const { nodeName } = email_blast_meta_1.emailBlastMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_1.EmailBlastDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            searchValue: params.id,
+            sentAt: params.sentAt.toISOString(),
+        };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.status = "draft"
+      SET ${nodeName}.status = "sending",
+          ${nodeName}.sentAt = datetime($sentAt),
+          ${nodeName}.updatedAt = datetime()
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.writeOne(query);
+    }
+    /**
+     * Moves a `sending` blast to `sent` once none of its deliveries is `pending` or `sending`.
+     * Null when the blast is not done yet (or not sending).
+     */
+    async markSentIfDone(params) {
+        const { nodeName } = email_blast_meta_1.emailBlastMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_1.EmailBlastDescriptor.model });
+        query.queryParams = { ...query.queryParams, searchValue: params.id };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      SET ${nodeName}._lock = true
+      REMOVE ${nodeName}._lock
+      WITH ${nodeName}
+      WHERE ${nodeName}.status = "sending"
+      AND NOT EXISTS {
+        MATCH (${nodeName})-[:HAS_DELIVERY]->(open:${email_blast_delivery_meta_1.emailBlastDeliveryMeta.labelName})
+        WHERE open.status IN ["pending", "sending"]
+      }
+      SET ${nodeName}.status = "sent",
+          ${nodeName}.updatedAt = datetime()
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.writeOne(query);
+    }
+    /**
+     * Every blast still sending (the recovery cron re-enqueues them).
+     */
+    async findSending() {
+        const { nodeName } = email_blast_meta_1.emailBlastMeta;
+        const query = this.neo4j.initQuery({ serialiser: email_blast_1.EmailBlastDescriptor.model });
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${nodeName}.status = "sending"
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readMany(query);
+    }
+};
+exports.EmailBlastRepository = EmailBlastRepository;
+exports.EmailBlastRepository = EmailBlastRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], EmailBlastRepository);
+//# sourceMappingURL=email-blast.repository.js.map

package/dist/foundations/email-blast/repositories/email-blast.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast.repository.js","sourceRoot":"","sources":["../../../../src/foundations/email-blast/repositories/email-blast.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,yDAA2E;AAC3E,qFAA+E;AAC/E,mEAA8D;AAGvD,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,wCAAyE;IAGjH,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,kCAAoB,CAAC;IAIrD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,MAAoC;QACpD,MAAM,EAAE,QAAQ,EAAE,GAAG,iCAAc,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,kCAAoB,CAAC,KAAK,EAAE,CAAC,CAAC;QAE/E,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,WAAW,EAAE,MAAM,CAAC,EAAE;YACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,KAAK,CAAC,KAAK,IAAI;QACX,IAAI,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACzC,QAAQ;eACL,QAAQ;aACV,QAAQ;cACP,QAAQ;YACV,QAAQ;YACR,QAAQ;YACR,QAAQ;aACP,QAAQ;QACb,IAAI,CAAC,oBAAoB,EAAE;KAC9B,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAsB;QACzC,MAAM,EAAE,QAAQ,EAAE,GAAG,iCAAc,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,kCAAoB,CAAC,KAAK,EAAE,CAAC,CAAC;QAE/E,KAAK,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAErE,KAAK,CAAC,KAAK,IAAI;QACX,IAAI,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACzC,QAAQ;eACL,QAAQ;aACV,QAAQ;cACP,QAAQ;;iBAEL,QAAQ,4BAA4B,kDAAsB,CAAC,SAAS;;;YAGzE,QAAQ;YACR,QAAQ;aACP,QAAQ;QACb,IAAI,CAAC,oBAAoB,EAAE;KAC9B,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,EAAE,QAAQ,EAAE,GAAG,iCAAc,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,kCAAoB,CAAC,KAAK,EAAE,CAAC,CAAC;QAE/E,KAAK,CAAC,KAAK,IAAI;QACX,IAAI,CAAC,iBAAiB,EAAE;cAClB,QAAQ;aACT,QAAQ;QACb,IAAI,CAAC,oBAAoB,EAAE;KAC9B,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AAlFY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAIQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAH9E,oBAAoB,CAkFhC"}

package/dist/foundations/email-blast/services/email-blast-delivery.service.d.ts

@@ -0,0 +1,79 @@
+import { ConfigService } from "@nestjs/config";
+import { Queue } from "bullmq";
+import { ClsService } from "nestjs-cls";
+import { BaseConfigInterface } from "../../../config/interfaces";
+import { CacheService } from "../../../core/cache/services/cache.service";
+import { EmailService } from "../../../core/email/services/email.service";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { EmailAutomationEnrollmentRepository } from "../../email-automation/repositories/email-automation-enrollment.repository";
+import { EmailOptOutRepository } from "../../email-automation/repositories/email-opt-out.repository";
+import { ResponseLanguageService } from "../../user/services/response-language.service";
+import { EmailBlastDelivery, EmailBlastDeliveryDescriptor } from "../entities/email-blast-delivery";
+import { EmailBlastDeliveryRepository } from "../repositories/email-blast-delivery.repository";
+import { EmailBlastRepository } from "../repositories/email-blast.repository";
+/**
+ * The whole delivery lifecycle of a blast: the worker send run, the recovery of stuck
+ * deliveries and the public unsubscribe.
+ *
+ * Never twice beats never missing anyone: a delivery is claimed (`pending` → `sending`)
+ * before the provider call; a send error marks it `failed` and it is never retried; a
+ * delivery left in `sending` by a dead worker is failed by `recoverStuck`, never resent.
+ *
+ * The worker has no route for `@CacheInvalidate`, so the send run and the recovery
+ * invalidate the `email-blasts` cache by hand (owner decision D-7).
+ */
+export declare class EmailBlastDeliveryService extends AbstractService<EmailBlastDelivery, typeof EmailBlastDeliveryDescriptor.relationships> {
+    private readonly deliveryRepository;
+    private readonly blastRepository;
+    private readonly optOutRepository;
+    private readonly enrollmentRepository;
+    private readonly emailService;
+    private readonly responseLanguage;
+    private readonly configService;
+    private readonly cacheService;
+    private readonly queue;
+    private readonly logger;
+    protected readonly descriptor: import("../../..").EntityDescriptor<EmailBlastDelivery, {
+        blast: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+        };
+    }>;
+    constructor(jsonApiService: JsonApiService, deliveryRepository: EmailBlastDeliveryRepository, clsService: ClsService, blastRepository: EmailBlastRepository, optOutRepository: EmailOptOutRepository, enrollmentRepository: EmailAutomationEnrollmentRepository, emailService: EmailService, responseLanguage: ResponseLanguageService, configService: ConfigService<BaseConfigInterface>, cacheService: CacheService, queue: Queue, logger: AppLoggingService);
+    /**
+     * Snapshots the recipients (once per blast) and sends every pending delivery in batches.
+     * Safe to run again after a crash: claimed deliveries are never claimed twice.
+     */
+    processBlast(params: {
+        blastId: string;
+    }): Promise<{
+        sent: number;
+        skipped: number;
+        failed: number;
+    }>;
+    /**
+     * Fails every delivery claimed more than EMAIL_BLAST_STUCK_MINUTES ago (never resent),
+     * then queues the send job again for every blast still `sending`, so a crashed run ends.
+     */
+    recoverStuck(params: {
+        now: Date;
+    }): Promise<void>;
+    /**
+     * Stops every marketing email to the delivery's address: counts the unsubscribe on the
+     * blast once, finishes the address's active automation enrolments and writes the shared
+     * opt-out. Idempotent. Answers nothing, so a token holder never learns the email or user.
+     */
+    unsubscribe(params: {
+        token: string;
+        source: "link" | "header";
+    }): Promise<void>;
+    private deliverOne;
+    private invalidateCache;
+}
+//# sourceMappingURL=email-blast-delivery.service.d.ts.map

package/dist/foundations/email-blast/services/email-blast-delivery.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-blast-delivery.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/email-blast/services/email-blast-delivery.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAA0C,MAAM,4BAA4B,CAAC;AAEzG,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,mCAAmC,EAAE,MAAM,4EAA4E,CAAC;AACjI,OAAO,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAUxF,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAEpG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAO9E;;;;;;;;;;GAUG;AACH,qBACa,yBAA0B,SAAQ,eAAe,CAC5D,kBAAkB,EAClB,OAAO,4BAA4B,CAAC,aAAa,CAClD;IAKG,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IACK,OAAO,CAAC,QAAQ,CAAC,KAAK;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdzB,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAAgC;gBAG3D,cAAc,EAAE,cAAc,EACb,kBAAkB,EAAE,4BAA4B,EACjE,UAAU,EAAE,UAAU,EACL,eAAe,EAAE,oBAAoB,EACrC,gBAAgB,EAAE,qBAAqB,EACvC,oBAAoB,EAAE,mCAAmC,EACzD,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,uBAAuB,EACzC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EACjD,YAAY,EAAE,YAAY,EACQ,KAAK,EAAE,KAAK,EAC9C,MAAM,EAAE,iBAAiB;IAK5C;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA2C3G;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxD;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAqBxE,UAAU;YAoDV,eAAe;CAG9B"}