@endora-commerce/mod-newsletter 0.100.0

package/dist/backend/entities/newsletter-send-record.entity.js

@@ -0,0 +1,89 @@
+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);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * NewsletterSendRecord — feature 048. Per-recipient send + the atomic
+ * idempotency claim (Principle X). `id` is the stable provider messageId.
+ * Unique (campaign_id, subscriber_id) / (automation_run_id, step_index,
+ * subscriber_id) partial indexes are created in the migration.
+ */
+let NewsletterSendRecord = class NewsletterSendRecord {
+    [OptionalProps];
+    id = randomUUID();
+    campaignId = null;
+    automationRunId = null;
+    stepIndex = null;
+    subscriberId;
+    status = 'queued';
+    providerMessageId = null;
+    error = null;
+    openedAt = null;
+    clickCount = 0;
+    sentAt = null;
+    createdAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], NewsletterSendRecord.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'campaign_id', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSendRecord.prototype, "campaignId", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'automation_run_id', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSendRecord.prototype, "automationRunId", void 0);
+__decorate([
+    Property({ type: 'integer', fieldName: 'step_index', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSendRecord.prototype, "stepIndex", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'subscriber_id' }),
+    __metadata("design:type", String)
+], NewsletterSendRecord.prototype, "subscriberId", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], NewsletterSendRecord.prototype, "status", void 0);
+__decorate([
+    Property({ type: 'string', length: 255, fieldName: 'provider_message_id', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSendRecord.prototype, "providerMessageId", void 0);
+__decorate([
+    Property({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSendRecord.prototype, "error", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'opened_at', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSendRecord.prototype, "openedAt", void 0);
+__decorate([
+    Property({ type: 'integer', fieldName: 'click_count' }),
+    __metadata("design:type", Number)
+], NewsletterSendRecord.prototype, "clickCount", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'sent_at', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSendRecord.prototype, "sentAt", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'created_at', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], NewsletterSendRecord.prototype, "createdAt", void 0);
+NewsletterSendRecord = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'newsletter_send_records' }),
+    Index({ properties: ['subscriberId'] }),
+    Index({ properties: ['status'] })
+], NewsletterSendRecord);
+export { NewsletterSendRecord };
+//# sourceMappingURL=newsletter-send-record.entity.js.map

package/dist/backend/entities/newsletter-send-record.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-send-record.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-send-record.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;GAKG;AAKI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,CAAC,aAAa,CAAC,CAUC;IAGhB,EAAE,GAAW,UAAU,EAAE,CAAC;IAG1B,UAAU,GAAkB,IAAI,CAAC;IAGjC,eAAe,GAAkB,IAAI,CAAC;IAGtC,SAAS,GAAkB,IAAI,CAAC;IAGhC,YAAY,CAAU;IAGtB,MAAM,GAA4D,QAAQ,CAAC;IAG3E,iBAAiB,GAAkB,IAAI,CAAC;IAGxC,KAAK,GAAkB,IAAI,CAAC;IAG5B,QAAQ,GAAgB,IAAI,CAAC;IAG7B,UAAU,GAAW,CAAC,CAAC;IAGvB,MAAM,GAAgB,IAAI,CAAC;IAG3B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAlCC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;gDACH;AAG1B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wDACpC;AAGjC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;6DACrC;AAGtC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDACvC;AAGhC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;;0DACjC;AAGtB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;oDACkC;AAG3E;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+DACpD;AAGxC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACf;AAG5B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDAC1C;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;;wDACjC;AAGvB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;oDAC1C;AAG3B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BACzE,IAAI;uDAAc;AA/ClB,oBAAoB;IAJhC,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,yBAAyB,EAAE,CAAC;IAChD,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;GACrB,oBAAoB,CAgDhC"}

package/dist/backend/entities/newsletter-subscriber-tag.entity.d.ts

@@ -0,0 +1,6 @@
+/** NewsletterSubscriberTag — feature 048. Bridge subscriber ⇆ tag. */
+export declare class NewsletterSubscriberTag {
+    subscriberId: string;
+    tagId: string;
+}
+//# sourceMappingURL=newsletter-subscriber-tag.entity.d.ts.map

package/dist/backend/entities/newsletter-subscriber-tag.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-subscriber-tag.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-subscriber-tag.entity.ts"],"names":[],"mappings":"AAGA,sEAAsE;AACtE,qBAGa,uBAAuB;IAElC,YAAY,EAAG,MAAM,CAAC;IAGtB,KAAK,EAAG,MAAM,CAAC;CAChB"}

package/dist/backend/entities/newsletter-subscriber-tag.entity.js

@@ -0,0 +1,31 @@
+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);
+};
+import { Entity, Index, PrimaryKey } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+/** NewsletterSubscriberTag — feature 048. Bridge subscriber ⇆ tag. */
+let NewsletterSubscriberTag = class NewsletterSubscriberTag {
+    subscriberId;
+    tagId;
+};
+__decorate([
+    PrimaryKey({ type: 'uuid', fieldName: 'subscriber_id' }),
+    __metadata("design:type", String)
+], NewsletterSubscriberTag.prototype, "subscriberId", void 0);
+__decorate([
+    PrimaryKey({ type: 'uuid', fieldName: 'tag_id' }),
+    __metadata("design:type", String)
+], NewsletterSubscriberTag.prototype, "tagId", void 0);
+NewsletterSubscriberTag = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'newsletter_subscriber_tags' }),
+    Index({ properties: ['tagId'] })
+], NewsletterSubscriberTag);
+export { NewsletterSubscriberTag };
+//# sourceMappingURL=newsletter-subscriber-tag.entity.js.map

package/dist/backend/entities/newsletter-subscriber-tag.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-subscriber-tag.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-subscriber-tag.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,sEAAsE;AAI/D,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAElC,YAAY,CAAU;IAGtB,KAAK,CAAU;CAChB,CAAA;AAJC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;;6DACnC;AAGtB;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;;sDACnC;AALJ,uBAAuB;IAHnC,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,4BAA4B,EAAE,CAAC;IACnD,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;GACpB,uBAAuB,CAMnC"}

package/dist/backend/entities/newsletter-subscriber.entity.d.ts

@@ -0,0 +1,63 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * NewsletterSubscriber — feature 048. Identity is the email (global unique).
+ * `status` drives mailability (only `active` + not suppressed is mailable).
+ * `customFields` holds operator-defined values keyed by NewsletterCustomField.key.
+ */
+export declare class NewsletterSubscriber {
+    [OptionalProps]?: 'status' | 'source' | 'salesChannelId' | 'customerAccountId' | 'organizationId' | 'customFields' | 'consentAt' | 'confirmedAt' | 'unsubscribedAt' | 'unsubscribeReason' | 'deactivatedAt' | 'version' | 'createdAt' | 'updatedAt';
+    id: string;
+    email: string;
+    status: 'pending' | 'active' | 'unsubscribed' | 'deactivated';
+    source: string | null;
+    salesChannelId: string | null;
+    customerAccountId: string | null;
+    /**
+     * The organisation that owns this subscriber — feature 087 Group B, ruling
+     * D-187.
+     *
+     * Derived from {@link customerAccountId}'s account and stamped at the write,
+     * never resolved on read: `customerOrganizationColumn` asks the ORM's own
+     * metadata whether this property exists, so its presence is what makes
+     * `customerFilterCond`'s `allowed-set` arm **grant** on this table rather
+     * than refuse it whole. A sales representative assigned to the buyer's
+     * organisation sees this subscriber, and their CSV export of it, because
+     * this column is here.
+     *
+     * Nullable, and the constraint is an implication rather than an equivalence:
+     * `newsletter_subscribers_organization_attribution_chk` requires an
+     * organisation of a row that names an account and says nothing about a row
+     * that names none. On this table the ownerless row is the ordinary case
+     * rather than the edge — `POST /api/v1/newsletter/subscribe` passes no
+     * account at all, so every subscriber who has never signed in is one — and
+     * who they belong to is R-6's open question, which a constraint must not
+     * answer.
+     *
+     * It is written together with {@link customerAccountId} at both of this
+     * module's two write sites, and there is no third: `subscriber.service.ts`
+     * creates the row with an owner or without one, and adopts an ownerless row
+     * into an account when a subscriber who signed up anonymously later signs
+     * in. Nothing here ever clears the account, so unlike `pwa` there is no
+     * de-association direction, and unlike `pwa` the shape the implication
+     * leaves open — an ownerless row still carrying an organisation — is not
+     * reachable.
+     *
+     * **Not derived from {@link email}.** This column is globally unique and
+     * `customer_accounts` has an e-mail too, so a match is available and is
+     * deliberately not taken: it would attribute rows the schema does not link,
+     * silently and irreversibly, for whoever signed up with the address their
+     * employer later registered. That is R-6 answer (2) guessed rather than
+     * decided.
+     */
+    organizationId: string | null;
+    customFields: Record<string, string | number | boolean | null>;
+    consentAt: Date | null;
+    confirmedAt: Date | null;
+    unsubscribedAt: Date | null;
+    unsubscribeReason: string | null;
+    deactivatedAt: Date | null;
+    version: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=newsletter-subscriber.entity.d.ts.map

package/dist/backend/entities/newsletter-subscriber.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-subscriber.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-subscriber.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAI7F;;;;GAIG;AACH,qBAEa,oBAAoB;IAC/B,CAAC,aAAa,CAAC,CAAC,EACZ,QAAQ,GACR,QAAQ,GACR,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,SAAS,GACT,WAAW,GACX,WAAW,CAAC;IAGhB,EAAE,EAAE,MAAM,CAAgB;IAI1B,KAAK,EAAG,MAAM,CAAC;IAIf,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAa;IAG1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAI7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IAGH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAM;IAGpE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAG9B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGhC,cAAc,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGxC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGlC,OAAO,EAAE,MAAM,CAAK;IAGpB,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/newsletter-subscriber.entity.js

@@ -0,0 +1,147 @@
+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);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { CustomerScoped } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * NewsletterSubscriber — feature 048. Identity is the email (global unique).
+ * `status` drives mailability (only `active` + not suppressed is mailable).
+ * `customFields` holds operator-defined values keyed by NewsletterCustomField.key.
+ */
+let NewsletterSubscriber = class NewsletterSubscriber {
+    [OptionalProps];
+    id = randomUUID();
+    email;
+    status = 'pending';
+    source = null;
+    salesChannelId = null;
+    customerAccountId = null;
+    /**
+     * The organisation that owns this subscriber — feature 087 Group B, ruling
+     * D-187.
+     *
+     * Derived from {@link customerAccountId}'s account and stamped at the write,
+     * never resolved on read: `customerOrganizationColumn` asks the ORM's own
+     * metadata whether this property exists, so its presence is what makes
+     * `customerFilterCond`'s `allowed-set` arm **grant** on this table rather
+     * than refuse it whole. A sales representative assigned to the buyer's
+     * organisation sees this subscriber, and their CSV export of it, because
+     * this column is here.
+     *
+     * Nullable, and the constraint is an implication rather than an equivalence:
+     * `newsletter_subscribers_organization_attribution_chk` requires an
+     * organisation of a row that names an account and says nothing about a row
+     * that names none. On this table the ownerless row is the ordinary case
+     * rather than the edge — `POST /api/v1/newsletter/subscribe` passes no
+     * account at all, so every subscriber who has never signed in is one — and
+     * who they belong to is R-6's open question, which a constraint must not
+     * answer.
+     *
+     * It is written together with {@link customerAccountId} at both of this
+     * module's two write sites, and there is no third: `subscriber.service.ts`
+     * creates the row with an owner or without one, and adopts an ownerless row
+     * into an account when a subscriber who signed up anonymously later signs
+     * in. Nothing here ever clears the account, so unlike `pwa` there is no
+     * de-association direction, and unlike `pwa` the shape the implication
+     * leaves open — an ownerless row still carrying an organisation — is not
+     * reachable.
+     *
+     * **Not derived from {@link email}.** This column is globally unique and
+     * `customer_accounts` has an e-mail too, so a match is available and is
+     * deliberately not taken: it would attribute rows the schema does not link,
+     * silently and irreversibly, for whoever signed up with the address their
+     * employer later registered. That is R-6 answer (2) guessed rather than
+     * decided.
+     */
+    organizationId = null;
+    customFields = {};
+    consentAt = null;
+    confirmedAt = null;
+    unsubscribedAt = null;
+    unsubscribeReason = null;
+    deactivatedAt = null;
+    version = 1;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], NewsletterSubscriber.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 320 }),
+    Unique(),
+    __metadata("design:type", String)
+], NewsletterSubscriber.prototype, "email", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    Index(),
+    __metadata("design:type", String)
+], NewsletterSubscriber.prototype, "status", void 0);
+__decorate([
+    Property({ type: 'string', length: 64, nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "source", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'sales_channel_id', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "salesChannelId", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'customer_account_id', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "customerAccountId", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'organization_id', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "organizationId", void 0);
+__decorate([
+    Property({ type: 'json', fieldName: 'custom_fields' }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "customFields", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'consent_at', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "consentAt", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'confirmed_at', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "confirmedAt", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'unsubscribed_at', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "unsubscribedAt", void 0);
+__decorate([
+    Property({ type: 'text', fieldName: 'unsubscribe_reason', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "unsubscribeReason", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'deactivated_at', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSubscriber.prototype, "deactivatedAt", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], NewsletterSubscriber.prototype, "version", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'created_at', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], NewsletterSubscriber.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'updated_at', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], NewsletterSubscriber.prototype, "updatedAt", void 0);
+NewsletterSubscriber = __decorate([
+    CustomerScoped(),
+    Entity({ tableName: 'newsletter_subscribers' })
+], NewsletterSubscriber);
+export { NewsletterSubscriber };
+//# sourceMappingURL=newsletter-subscriber.entity.js.map

package/dist/backend/entities/newsletter-subscriber.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-subscriber.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-subscriber.entity.ts"],"names":[],"mappings":"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"}

package/dist/backend/entities/newsletter-suppression.entity.d.ts

@@ -0,0 +1,14 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * NewsletterSuppression — feature 048. Email-keyed exclusion list that
+ * survives subscriber deletion and overrides all targeting.
+ */
+export declare class NewsletterSuppression {
+    [OptionalProps]?: 'detail' | 'createdAt';
+    id: string;
+    email: string;
+    reason: 'unsubscribe' | 'bounce' | 'complaint';
+    detail: string | null;
+    createdAt: Date;
+}
+//# sourceMappingURL=newsletter-suppression.entity.d.ts.map

package/dist/backend/entities/newsletter-suppression.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-suppression.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-suppression.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAItF;;;GAGG;AACH,qBAEa,qBAAqB;IAChC,CAAC,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAGzC,EAAE,EAAE,MAAM,CAAgB;IAI1B,KAAK,EAAG,MAAM,CAAC;IAGf,MAAM,EAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC;IAGhD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/newsletter-suppression.entity.js

@@ -0,0 +1,51 @@
+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);
+};
+import { Entity, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * NewsletterSuppression — feature 048. Email-keyed exclusion list that
+ * survives subscriber deletion and overrides all targeting.
+ */
+let NewsletterSuppression = class NewsletterSuppression {
+    [OptionalProps];
+    id = randomUUID();
+    email;
+    reason;
+    detail = null;
+    createdAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], NewsletterSuppression.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 320 }),
+    Unique(),
+    __metadata("design:type", String)
+], NewsletterSuppression.prototype, "email", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], NewsletterSuppression.prototype, "reason", void 0);
+__decorate([
+    Property({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterSuppression.prototype, "detail", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'created_at', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], NewsletterSuppression.prototype, "createdAt", void 0);
+NewsletterSuppression = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'newsletter_suppressions' })
+], NewsletterSuppression);
+export { NewsletterSuppression };
+//# sourceMappingURL=newsletter-suppression.entity.js.map

package/dist/backend/entities/newsletter-suppression.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-suppression.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-suppression.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;GAGG;AAGI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,CAAC,aAAa,CAAC,CAA0B;IAGzC,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,KAAK,CAAU;IAGf,MAAM,CAA0C;IAGhD,MAAM,GAAkB,IAAI,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAdC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;iDACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACzC,MAAM,EAAE;;oDACM;AAGf;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;qDACO;AAGhD;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDACd;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BACzE,IAAI;wDAAc;AAjBlB,qBAAqB;IAFjC,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,yBAAyB,EAAE,CAAC;GACpC,qBAAqB,CAkBjC"}

package/dist/backend/entities/newsletter-tag.entity.d.ts

@@ -0,0 +1,12 @@
+import { OptionalProps } from '@mikro-orm/core';
+/** NewsletterTag — feature 048. Operator-defined label for segmentation. */
+export declare class NewsletterTag {
+    [OptionalProps]?: 'description' | 'createdAt' | 'updatedAt';
+    id: string;
+    code: string;
+    name: string;
+    description: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=newsletter-tag.entity.d.ts.map

package/dist/backend/entities/newsletter-tag.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-tag.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-tag.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAItF,4EAA4E;AAC5E,qBAEa,aAAa;IACxB,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAG5D,EAAE,EAAE,MAAM,CAAgB;IAI1B,IAAI,EAAG,MAAM,CAAC;IAGd,IAAI,EAAG,MAAM,CAAC;IAGd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGlC,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/newsletter-tag.entity.js

@@ -0,0 +1,53 @@
+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);
+};
+import { Entity, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/** NewsletterTag — feature 048. Operator-defined label for segmentation. */
+let NewsletterTag = class NewsletterTag {
+    [OptionalProps];
+    id = randomUUID();
+    code;
+    name;
+    description = null;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], NewsletterTag.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 64 }),
+    Unique(),
+    __metadata("design:type", String)
+], NewsletterTag.prototype, "code", void 0);
+__decorate([
+    Property({ type: 'string', length: 160 }),
+    __metadata("design:type", String)
+], NewsletterTag.prototype, "name", void 0);
+__decorate([
+    Property({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], NewsletterTag.prototype, "description", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'created_at', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], NewsletterTag.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', fieldName: 'updated_at', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], NewsletterTag.prototype, "updatedAt", void 0);
+NewsletterTag = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'newsletter_tags' })
+], NewsletterTag);
+export { NewsletterTag };
+//# sourceMappingURL=newsletter-tag.entity.js.map

package/dist/backend/entities/newsletter-tag.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-tag.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/newsletter-tag.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,4EAA4E;AAGrE,IAAM,aAAa,GAAnB,MAAM,aAAa;IACxB,CAAC,aAAa,CAAC,CAA6C;IAG5D,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,IAAI,CAAU;IAGd,IAAI,CAAU;IAGd,WAAW,GAAkB,IAAI,CAAC;IAGlC,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAjBC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;yCACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,MAAM,EAAE;;2CACK;AAGd;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;2CAC5B;AAGd;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACT;AAGlC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BACzE,IAAI;gDAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BACzE,IAAI;gDAAc;AApBlB,aAAa;IAFzB,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;GAC5B,aAAa,CAqBzB"}

package/dist/backend/index.d.ts

@@ -0,0 +1,120 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { Redis } from 'ioredis';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { EventBus } from '@endora-commerce/platform/events';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { newsletterModule, type NewsletterModuleOptions } from './plugin.js';
+import { NewsletterAutomationRun } from './entities/newsletter-automation-run.entity.js';
+import { NewsletterAutomation } from './entities/newsletter-automation.entity.js';
+import { NewsletterCampaignSubscriber } from './entities/newsletter-campaign-subscriber.entity.js';
+import { NewsletterCampaign } from './entities/newsletter-campaign.entity.js';
+import { NewsletterCustomField } from './entities/newsletter-custom-field.entity.js';
+import { NewsletterEmailBlockSalesChannel } from './entities/newsletter-email-block-sales-channel.entity.js';
+import { NewsletterEmailBlock } from './entities/newsletter-email-block.entity.js';
+import { NewsletterEngagementEvent } from './entities/newsletter-engagement-event.entity.js';
+import { NewsletterSendRecord } from './entities/newsletter-send-record.entity.js';
+import { NewsletterSubscriberTag } from './entities/newsletter-subscriber-tag.entity.js';
+import { NewsletterSubscriber } from './entities/newsletter-subscriber.entity.js';
+import { NewsletterSuppression } from './entities/newsletter-suppression.entity.js';
+import { NewsletterTag } from './entities/newsletter-tag.entity.js';
+/**
+ * `newsletter` — the module whose secret the harness pins (feature 072, wave 2,
+ * T114), and which assembled nine of its own inputs in a composition root until
+ * `specs/117-instance-bring-up/` Phase 6.
+ *
+ * **`newsletterBridge` is gone.** It was contributed by
+ * `backend/src/composition.ts` and by `backend/test/helpers/test-server.ts` and
+ * by nothing else, so a composition that is neither — which is every client
+ * instance, whose whole composition is one `composeApp({ deploymentRoot })`
+ * call — could not resolve it, and the module's own registration read
+ * `b.tokenSecret` eagerly, so that composition failed the moment anything
+ * touched `newsletter`.
+ *
+ * The argument for the bridge was that the harness differs from production and
+ * *"what the harness does differently is information about the seam"*. That is
+ * still true and it is an argument for a **contribution point**, not for a
+ * required value: a module default the harness overwrites says the same thing
+ * and leaves a composition that overwrites nothing with a working module.
+ * `newsletterEmailBranding`, eleven lines below, has been the right shape all
+ * along.
+ *
+ * Every member was a port, a platform contribution or an environment input —
+ * none was a judgement anybody makes:
+ *
+ *  - `tokenSecret` -> `newsletterTokenSecret`, the platform's own value, so
+ *    `NEWSLETTER_TOKEN_SECRET` stays a platform-declared input that
+ *    `check:env-inputs` can see (T6-B1 route (b)).
+ *  - `defaultChannelId` -> `salesChannelResolutionPort.getSystemDefault()`, as
+ *    an accessor: it was the one member only a root could produce, because it
+ *    was an *awaited value*.
+ *  - `resolveChannelIdByCode` -> `salesChannelCodeIdPort`.
+ *  - `publicBaseUrl` -> `resolvePublicApiBaseUrl()`, the platform's helper.
+ *  - `storefrontBaseUrl` -> the platform's own registration of that name.
+ *  - `loadCustomerEmail` -> `customerAccountReadPort`, already resolved eleven
+ *    lines down for `customerAccounts`.
+ *  - `mailer` -> `emailMailer`.
+ *  - `emitEvent` -> `eventBus`.
+ *  - `resolveCustomerAccountId` -> the platform's `customerAccountIdResolver`,
+ *    which is the identical closure under its own name.
+ *
+ * `auditLog` stops being optional: subscribing and unsubscribing are consent
+ * records, and consent that was recorded nowhere is indistinguishable from
+ * consent that was never given.
+ *
+ * `resolveEmailBranding` is a **contribution point this module owns**, absent by
+ * default. The logo and accent come from `transactional_emails`, which hands
+ * them out through an `exposeBranding` callback a root holds — so a port would
+ * make `newsletter` declare a dependency on a module that only *later* announces
+ * the value. Absent, campaign email renders with the module's own neutral
+ * fallback, which is what the harness has always exercised.
+ */
+export interface NewsletterCradle {
+    readonly emFactory: () => EntityManager;
+    readonly auditLogService: AuditPort;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly requireCustomer: NonNullable<NewsletterModuleOptions['requireCustomer']>;
+    readonly settingsReadPort: NonNullable<NewsletterModuleOptions['settings']>;
+    readonly settingsAdminService: NonNullable<NewsletterModuleOptions['settingsWrite']>;
+    readonly adminAuditActorResolver: NonNullable<NewsletterModuleOptions['resolveAuditContext']>;
+    readonly credentialsService: NonNullable<NewsletterModuleOptions['credentials']>;
+    /** Undefined in a composition with no queue infrastructure; dispatch then runs inline. */
+    readonly moduleQueueRedis: Redis | undefined;
+    /**
+     * The key confirmation and unsubscribe links are signed with. The platform's
+     * own registration — `NEWSLETTER_TOKEN_SECRET`, falling back to the session
+     * key — so that the environment read stays in the tree `check:env-inputs`
+     * judges (T6-B1). A harness pins it, because a token signed on one request
+     * and verified on another has to be predictable for a test to assert a link.
+     */
+    readonly newsletterTokenSecret: string;
+    readonly emailMailer: NonNullable<NewsletterModuleOptions['mailer']>;
+    readonly customerAccountIdResolver: NonNullable<NewsletterModuleOptions['resolveCustomerAccountId']>;
+    readonly storefrontBaseUrl: string;
+    readonly eventBus: EventBus;
+    readonly salesChannelResolutionPort: {
+        getSystemDefault(): Promise<{
+            id: string;
+        }>;
+    };
+    readonly salesChannelCodeIdPort: {
+        idByCode(code: string): Promise<string | null>;
+    };
+    /** Contribution point: absent means campaign email renders with the neutral fallback. */
+    readonly newsletterEmailBranding: NewsletterModuleOptions['resolveEmailBranding'];
+    readonly newsletter: ReturnType<typeof newsletterModule>;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export declare const entities: (typeof NewsletterSubscriber | typeof NewsletterTag | typeof NewsletterSubscriberTag | typeof NewsletterCustomField | typeof NewsletterSuppression | typeof NewsletterCampaign | typeof NewsletterSendRecord | typeof NewsletterCampaignSubscriber | typeof NewsletterAutomation | typeof NewsletterAutomationRun | typeof NewsletterEngagementEvent | typeof NewsletterEmailBlock | typeof NewsletterEmailBlockSalesChannel)[];
+//# sourceMappingURL=index.d.ts.map