@endora-commerce/mod-newsletter 0.100.0

package/dist/backend/services/subscriber-admin.service.js

@@ -0,0 +1,163 @@
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { NewsletterSubscriber } from '../entities/newsletter-subscriber.entity.js';
+import { NewsletterTag } from '../entities/newsletter-tag.entity.js';
+import { NewsletterSubscriberTag } from '../entities/newsletter-subscriber-tag.entity.js';
+import { NewsletterSuppression } from '../entities/newsletter-suppression.entity.js';
+const CSV_COLUMNS = ['email', 'status', 'tags', 'source', 'consentAt', 'unsubscribedAt', 'unsubscribeReason', 'customFields'];
+function csvCell(value) {
+    return /[",\n]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+/** Admin subscriber list / detail / lifecycle / CSV export (feature 048, US3). */
+export class NewsletterSubscriberAdminService {
+    emFactory;
+    auditLog;
+    constructor(emFactory, auditLog) {
+        this.emFactory = emFactory;
+        this.auditLog = auditLog;
+    }
+    async buildWhere(em, query) {
+        const where = {};
+        if (query.status)
+            where['status'] = query.status;
+        if (query.channel)
+            where['salesChannelId'] = query.channel;
+        if (query.q)
+            where['email'] = { $ilike: `%${query.q}%` };
+        if (query.tag) {
+            const tag = await em.findOne(NewsletterTag, { code: query.tag });
+            const links = tag ? await em.find(NewsletterSubscriberTag, { tagId: tag.id }) : [];
+            where['id'] = { $in: links.map((l) => l.subscriberId) };
+        }
+        return where;
+    }
+    async tagsFor(em, subscriberIds) {
+        const map = new Map();
+        if (subscriberIds.length === 0)
+            return map;
+        const links = await em.find(NewsletterSubscriberTag, { subscriberId: { $in: subscriberIds } });
+        const tagIds = [...new Set(links.map((l) => l.tagId))];
+        const tags = await em.find(NewsletterTag, { id: { $in: tagIds } });
+        const codeById = new Map(tags.map((t) => [t.id, t.code]));
+        for (const link of links) {
+            const code = codeById.get(link.tagId);
+            if (!code)
+                continue;
+            const arr = map.get(link.subscriberId) ?? [];
+            arr.push(code);
+            map.set(link.subscriberId, arr);
+        }
+        return map;
+    }
+    async list(query) {
+        const em = this.emFactory();
+        const where = await this.buildWhere(em, query);
+        const [rows, total] = await em.findAndCount(NewsletterSubscriber, where, {
+            orderBy: { createdAt: 'desc' },
+            limit: query.pageSize,
+            offset: (query.page - 1) * query.pageSize,
+        });
+        const tagMap = await this.tagsFor(em, rows.map((r) => r.id));
+        return {
+            items: rows.map((r) => this.toSummary(r, tagMap.get(r.id) ?? [])),
+            page: query.page,
+            pageSize: query.pageSize,
+            total,
+        };
+    }
+    async getDetail(id) {
+        const em = this.emFactory();
+        const sub = await em.findOne(NewsletterSubscriber, { id });
+        if (!sub)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Subscriber not found.');
+        const tagMap = await this.tagsFor(em, [id]);
+        return this.toDetail(sub, tagMap.get(id) ?? []);
+    }
+    async deactivate(id, expectedVersion) {
+        const em = this.emFactory();
+        const sub = await em.findOne(NewsletterSubscriber, { id });
+        if (!sub)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Subscriber not found.');
+        if (sub.version !== expectedVersion) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Subscriber was modified.');
+        }
+        sub.status = 'deactivated';
+        sub.deactivatedAt = new Date();
+        sub.version += 1;
+        await em.persistAndFlush(sub);
+        await this.auditLog?.record({
+            action: 'newsletter_deactivate',
+            objectType: 'newsletter_subscriber',
+            objectId: sub.id,
+            stateAfter: { status: 'deactivated' },
+        });
+        const tagMap = await this.tagsFor(em, [id]);
+        return this.toDetail(sub, tagMap.get(id) ?? []);
+    }
+    async remove(id) {
+        const em = this.emFactory();
+        const sub = await em.findOne(NewsletterSubscriber, { id });
+        if (!sub)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Subscriber not found.');
+        // Retain a suppression keyed by email so the address stays unmailable (R6).
+        const existing = await em.findOne(NewsletterSuppression, { email: sub.email });
+        if (!existing) {
+            em.create(NewsletterSuppression, { email: sub.email, reason: 'unsubscribe', detail: 'deleted' });
+        }
+        await this.auditLog?.record({
+            action: 'newsletter_delete',
+            objectType: 'newsletter_subscriber',
+            objectId: sub.id,
+            stateBefore: { email: sub.email },
+        });
+        await em.removeAndFlush(sub); // bridges cascade via FK
+    }
+    async exportCsv(query) {
+        const em = this.emFactory();
+        const where = await this.buildWhere(em, query);
+        const rows = await em.find(NewsletterSubscriber, where, { orderBy: { createdAt: 'desc' } });
+        const tagMap = await this.tagsFor(em, rows.map((r) => r.id));
+        const lines = [CSV_COLUMNS.join(',')];
+        for (const r of rows) {
+            lines.push([
+                r.email,
+                r.status,
+                (tagMap.get(r.id) ?? []).join('|'),
+                r.source ?? '',
+                r.consentAt?.toISOString() ?? '',
+                r.unsubscribedAt?.toISOString() ?? '',
+                r.unsubscribeReason ?? '',
+                JSON.stringify(r.customFields),
+            ]
+                .map((v) => csvCell(String(v)))
+                .join(','));
+        }
+        return `${lines.join('\n')}\n`;
+    }
+    toSummary(s, tags) {
+        return {
+            id: s.id,
+            email: s.email,
+            status: s.status,
+            source: s.source,
+            salesChannelId: s.salesChannelId,
+            tags,
+            consentAt: s.consentAt?.toISOString() ?? null,
+            createdAt: s.createdAt.toISOString(),
+        };
+    }
+    toDetail(s, tags) {
+        return {
+            ...this.toSummary(s, tags),
+            customerAccountId: s.customerAccountId,
+            customFields: s.customFields,
+            confirmedAt: s.confirmedAt?.toISOString() ?? null,
+            unsubscribedAt: s.unsubscribedAt?.toISOString() ?? null,
+            unsubscribeReason: s.unsubscribeReason,
+            deactivatedAt: s.deactivatedAt?.toISOString() ?? null,
+            version: s.version,
+            updatedAt: s.updatedAt.toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=subscriber-admin.service.js.map

package/dist/backend/services/subscriber-admin.service.js.map

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

package/dist/backend/services/subscriber.service.d.ts

@@ -0,0 +1,91 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CustomerAccountReadPort, EmailMailerPort } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { NewsletterOptInService } from './opt-in.service.js';
+export interface NewsletterLinkBuilder {
+    confirm(token: string): string;
+    unsubscribe(token: string): string;
+}
+export interface SubscribeInput {
+    email: string;
+    salesChannelId: string | null;
+    tags?: string[];
+    customFields?: Record<string, string | number | boolean | null>;
+    source?: string;
+    customerAccountId?: string | null;
+}
+export interface SubscriberServiceDeps {
+    emFactory: () => EntityManager;
+    optIn: NewsletterOptInService;
+    /** Channel used for opt-in reads when a subscriber has no origin channel. */
+    /**
+     * The channel a subscriber with no origin channel belongs to, **resolved per
+     * call** since `specs/117-instance-bring-up/` Phase 6.
+     *
+     * It was a value the composition awaited and passed in, which is what made
+     * `newsletterBridge` a thing only a composition root could assemble. An
+     * accessor lets this module resolve the system-default channel itself,
+     * through the port the platform already contributes.
+     */
+    resolveDefaultChannelId: () => Promise<string | null>;
+    links: NewsletterLinkBuilder;
+    /**
+     * `customer_accounts`' read model, for the one field the owner stamp needs:
+     * the organisation the owning account belongs to (feature 087, D-187).
+     *
+     * **Required**, and it is the one dependency in this interface that is. The
+     * three optional slots beside it are collaborators a composition may
+     * genuinely lack — a transport, an audit sink, an event emitter — and each
+     * has a defined behaviour when absent. This one has none: there is no
+     * composition in which an owned subscriber written with no organisation is
+     * correct, because
+     * `newsletter_subscribers_organization_attribution_chk` refuses that row.
+     * Making it optional would move the failure from this constructor to a
+     * Postgres error naming a constraint the caller never heard of, on the first
+     * signed-in subscribe rather than at composition.
+     *
+     * Resolved through `lazyPort`, so a switched-off `customer_accounts` refuses
+     * at the call with the 503 `MODULE_DISABLED` envelope rather than at
+     * composition time.
+     */
+    customerAccounts: CustomerAccountReadPort;
+    /** `emailMailer`, owned by `email`, as its published contract (feature 075). */
+    mailer?: EmailMailerPort;
+    auditLog?: AuditPort;
+    /** Optional observability emitter (wraps the in-process EventBus). */
+    emitEvent?: (name: string, payload: Record<string, unknown>) => void;
+}
+/**
+ * Subscriber lifecycle (feature 048, US1/US3). Email is the global identity;
+ * re-submitting merges tags/custom fields. Suppression (table) overrides
+ * everything. Double opt-in creates a `pending` row + confirmation mail; single
+ * opt-in activates immediately.
+ */
+export declare class NewsletterSubscriberService {
+    #private;
+    private readonly deps;
+    constructor(deps: SubscriberServiceDeps);
+    /** Subscribe (idempotent on email). Returns the resulting status. */
+    subscribe(input: SubscribeInput): Promise<{
+        status: 'pending' | 'active';
+    }>;
+    /** Confirm a double opt-in subscriber from a signed token. Idempotent. */
+    confirm(subscriberId: string): Promise<{
+        ok: boolean;
+    }>;
+    /** Unsubscribe with an optional reason; writes a suppression row. Idempotent. */
+    unsubscribe(subscriberId: string, reason?: string): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * Suppress an address on provider feedback (hard bounce / complaint — FR-035).
+     * Writes a suppression row (idempotent) so the address is excluded from all
+     * future sends regardless of targeting; a complaint/bounce suppression is NOT
+     * lifted by a later re-subscribe (only an explicit unsubscribe is).
+     */
+    suppress(email: string, reason: 'bounce' | 'complaint', detail?: string): Promise<void>;
+    private mergeCustomFields;
+    private mergeTags;
+    private sendConfirmation;
+}
+//# sourceMappingURL=subscriber.service.d.ts.map

package/dist/backend/services/subscriber.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/subscriber.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAMlE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAsDD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,6EAA6E;IAC7E;;;;;;;;OAQG;IACH,uBAAuB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,KAAK,EAAE,qBAAqB,CAAC;IAC7B;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,gFAAgF;IAChF,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,sEAAsE;IACtE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtE;AAED;;;;;GAKG;AACH,qBAAa,2BAA2B;;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAsCxD,qEAAqE;IAC/D,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,CAAC;IAoFjF,0EAA0E;IACpE,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAmB7D,iFAAiF;IAC3E,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAgClF;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAwB/E,iBAAiB;YAejB,SAAS;YAUT,gBAAgB;CA0B/B"}

package/dist/backend/services/subscriber.service.js

@@ -0,0 +1,280 @@
+import { NewsletterSubscriber } from '../entities/newsletter-subscriber.entity.js';
+import { NewsletterTag } from '../entities/newsletter-tag.entity.js';
+import { NewsletterSubscriberTag } from '../entities/newsletter-subscriber-tag.entity.js';
+import { NewsletterCustomField } from '../entities/newsletter-custom-field.entity.js';
+import { NewsletterSuppression } from '../entities/newsletter-suppression.entity.js';
+/**
+ * The two attribution columns, written together from one resolved owner.
+ *
+ * **Both** of this module's write sites go through it — the `em.create` on a
+ * first subscribe and the adoption of an already-ownerless row — which is what
+ * one function has to cover here. It needs no de-association arm, unlike
+ * `pwa`'s: nothing in `newsletter` ever clears `customer_account_id`, so the
+ * ownerless arm below is only ever the *initial* state of a row and never a
+ * transition into one.
+ */
+function ownerColumns(owner) {
+    return owner.kind === 'customer'
+        ? { customerAccountId: owner.customerAccountId, organizationId: owner.organizationId }
+        : {
+            customerAccountId: null,
+            // FR-011 — a storefront sign-up belongs to no organisation, and the
+            // constraint says nothing about it. On this table that is the ordinary
+            // case: `POST /api/v1/newsletter/subscribe` passes no account. Who such
+            // a row *should* belong to is R-6's open question and is not answered
+            // here — in particular not by matching `email` against
+            // `customer_accounts.email`, which is that question guessed.
+            organizationId: null,
+        };
+}
+/**
+ * Subscriber lifecycle (feature 048, US1/US3). Email is the global identity;
+ * re-submitting merges tags/custom fields. Suppression (table) overrides
+ * everything. Double opt-in creates a `pending` row + confirmation mail; single
+ * opt-in activates immediately.
+ */
+export class NewsletterSubscriberService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * The organisation that owns a subscriber belonging to this account — feature
+     * 087 Group B, D-187.
+     *
+     * Total, and refuses rather than returning `null`:
+     * `customer_accounts.organization_id` is `NOT NULL` (D-178), so an account
+     * that resolves always has one, and an account that does not resolve is a
+     * caller naming a row that is not there. Either way there is no organisation
+     * to stamp, and a subscriber written without one is a buyer hidden from the
+     * representative who serves them — and absent from that representative's CSV
+     * export, which is the surface R-6 is about. So the write stops here, where
+     * the message can name the account, instead of at the constraint.
+     */
+    async #organizationOf(customerAccountId) {
+        const account = await this.deps.customerAccounts.findById(customerAccountId);
+        if (!account) {
+            throw new Error(`NewsletterSubscriberService: customer account ${customerAccountId} does not resolve, ` +
+                'so the subscriber it would own has no organisation to carry.');
+        }
+        return account.organizationId;
+    }
+    /** The caller's owner input, with the organisation a customer owner implies. */
+    async #resolveOwner(customerAccountId) {
+        if (customerAccountId === null || customerAccountId === undefined)
+            return { kind: 'anonymous' };
+        return {
+            kind: 'customer',
+            customerAccountId,
+            organizationId: await this.#organizationOf(customerAccountId),
+        };
+    }
+    /** Subscribe (idempotent on email). Returns the resulting status. */
+    async subscribe(input) {
+        const em = this.deps.emFactory();
+        const email = input.email.trim().toLowerCase();
+        const channelId = input.salesChannelId;
+        const settingsChannelId = channelId ?? (await this.deps.resolveDefaultChannelId());
+        const mode = await this.deps.optIn.resolveMode(settingsChannelId);
+        // Suppressed (complaint/bounce) addresses are not silently re-subscribed.
+        const suppressed = await em.findOne(NewsletterSuppression, { email });
+        // D-187 — resolved **before** the first managed entity is touched, not
+        // between the account assignment and the flush. Both `em.create` and the
+        // adoption below register the row with the unit of work, so a throw after
+        // either would leave an owned, unattributed subscriber there for whatever
+        // flushes this request next.
+        const owner = await this.#resolveOwner(input.customerAccountId);
+        let subscriber = await em.findOne(NewsletterSubscriber, { email });
+        const isNew = !subscriber;
+        if (!subscriber) {
+            subscriber = em.create(NewsletterSubscriber, {
+                email,
+                status: 'pending',
+                source: input.source ?? null,
+                salesChannelId: channelId,
+                // D-187 — the only place a subscriber is inserted, and the organisation
+                // goes in with the account. `ownerColumns` takes a *resolved* owner, so
+                // the customer branch has no shape in which the organisation could be
+                // omitted; the anonymous branch has none to carry (FR-011).
+                ...ownerColumns(owner),
+            });
+        }
+        if (owner.kind === 'customer' && !subscriber.customerAccountId) {
+            // The adoption: a subscriber who signed up anonymously and has now signed
+            // in. D-187 — the account and the organisation move together here too.
+            // `em.assign` rather than two statements, for the same reason
+            // `ownerColumns` returns both columns as one value: two statements are two
+            // things to remember, and the second one is the one that was never
+            // written.
+            em.assign(subscriber, ownerColumns(owner));
+        }
+        // Activation policy: single opt-in (or already confirmed) → active now;
+        // double opt-in → pending until the email link is followed.
+        const wasActive = subscriber.status === 'active';
+        if (mode === 'single' || subscriber.confirmedAt) {
+            subscriber.status = 'active';
+            subscriber.consentAt ??= new Date();
+            if (mode === 'single')
+                subscriber.confirmedAt ??= new Date();
+        }
+        else if (!wasActive) {
+            subscriber.status = 'pending';
+            subscriber.consentAt ??= new Date();
+        }
+        if (suppressed && subscriber.status === 'active') {
+            // An explicit re-subscribe lifts a prior self-unsubscribe suppression.
+            if (suppressed.reason === 'unsubscribe') {
+                await em.removeAndFlush(suppressed);
+            }
+        }
+        await this.mergeCustomFields(em, subscriber, input.customFields);
+        await em.persistAndFlush(subscriber);
+        await this.mergeTags(em, subscriber.id, input.tags);
+        if (subscriber.status === 'pending') {
+            await this.sendConfirmation(subscriber.id, email, settingsChannelId);
+        }
+        await this.deps.auditLog?.record({
+            action: isNew ? 'newsletter_subscribe' : 'newsletter_resubscribe',
+            objectType: 'newsletter_subscriber',
+            objectId: subscriber.id,
+            stateAfter: { email, status: subscriber.status, source: input.source ?? null },
+        });
+        this.deps.emitEvent?.('newsletter.subscribed.v1', {
+            subscriberId: subscriber.id,
+            email,
+            status: subscriber.status,
+        });
+        return { status: subscriber.status === 'active' ? 'active' : 'pending' };
+    }
+    /** Confirm a double opt-in subscriber from a signed token. Idempotent. */
+    async confirm(subscriberId) {
+        const em = this.deps.emFactory();
+        const subscriber = await em.findOne(NewsletterSubscriber, { id: subscriberId });
+        if (!subscriber)
+            return { ok: false };
+        if (subscriber.status === 'pending') {
+            subscriber.status = 'active';
+            subscriber.confirmedAt = new Date();
+            subscriber.consentAt ??= new Date();
+            await em.persistAndFlush(subscriber);
+            await this.deps.auditLog?.record({
+                action: 'newsletter_confirm',
+                objectType: 'newsletter_subscriber',
+                objectId: subscriber.id,
+                stateAfter: { status: 'active' },
+            });
+        }
+        return { ok: true };
+    }
+    /** Unsubscribe with an optional reason; writes a suppression row. Idempotent. */
+    async unsubscribe(subscriberId, reason) {
+        const em = this.deps.emFactory();
+        const subscriber = await em.findOne(NewsletterSubscriber, { id: subscriberId });
+        if (!subscriber)
+            return { ok: false };
+        if (subscriber.status !== 'unsubscribed') {
+            subscriber.status = 'unsubscribed';
+            subscriber.unsubscribedAt = new Date();
+            subscriber.unsubscribeReason = reason ?? null;
+            const existing = await em.findOne(NewsletterSuppression, { email: subscriber.email });
+            if (!existing) {
+                em.create(NewsletterSuppression, {
+                    email: subscriber.email,
+                    reason: 'unsubscribe',
+                    detail: reason ?? null,
+                });
+            }
+            await em.persistAndFlush(subscriber);
+            await this.deps.auditLog?.record({
+                action: 'newsletter_unsubscribe',
+                objectType: 'newsletter_subscriber',
+                objectId: subscriber.id,
+                stateAfter: { status: 'unsubscribed', reason: reason ?? null },
+            });
+            this.deps.emitEvent?.('newsletter.unsubscribed.v1', {
+                subscriberId: subscriber.id,
+                email: subscriber.email,
+                reason: reason ?? null,
+            });
+        }
+        return { ok: true };
+    }
+    /**
+     * Suppress an address on provider feedback (hard bounce / complaint — FR-035).
+     * Writes a suppression row (idempotent) so the address is excluded from all
+     * future sends regardless of targeting; a complaint/bounce suppression is NOT
+     * lifted by a later re-subscribe (only an explicit unsubscribe is).
+     */
+    async suppress(email, reason, detail) {
+        const em = this.deps.emFactory();
+        const normalized = email.trim().toLowerCase();
+        const existing = await em.findOne(NewsletterSuppression, { email: normalized });
+        if (existing) {
+            existing.reason = reason;
+            if (detail)
+                existing.detail = detail;
+        }
+        else {
+            em.create(NewsletterSuppression, { email: normalized, reason, detail: detail ?? null });
+        }
+        const subscriber = await em.findOne(NewsletterSubscriber, { email: normalized });
+        if (subscriber && subscriber.status === 'active') {
+            subscriber.status = 'deactivated';
+            subscriber.deactivatedAt = new Date();
+        }
+        await em.flush();
+        await this.deps.auditLog?.record({
+            action: `newsletter_${reason}`,
+            objectType: 'newsletter_subscriber',
+            objectId: subscriber?.id ?? normalized,
+            stateAfter: { email: normalized, reason },
+        });
+    }
+    async mergeCustomFields(em, subscriber, incoming) {
+        if (!incoming || Object.keys(incoming).length === 0)
+            return;
+        const defined = await em.find(NewsletterCustomField, {});
+        const allowed = new Set(defined.map((f) => f.key));
+        const merged = { ...subscriber.customFields };
+        for (const [k, v] of Object.entries(incoming)) {
+            if (allowed.has(k))
+                merged[k] = v;
+        }
+        subscriber.customFields = merged;
+    }
+    async mergeTags(em, subscriberId, codes) {
+        if (!codes || codes.length === 0)
+            return;
+        const tags = await em.find(NewsletterTag, { code: { $in: codes } });
+        for (const tag of tags) {
+            const existing = await em.findOne(NewsletterSubscriberTag, { subscriberId, tagId: tag.id });
+            if (!existing)
+                em.create(NewsletterSubscriberTag, { subscriberId, tagId: tag.id });
+        }
+        await em.flush();
+    }
+    async sendConfirmation(subscriberId, email, salesChannelId) {
+        if (!this.deps.mailer)
+            return;
+        const token = await this.deps.optIn.mintConfirmToken(subscriberId, salesChannelId);
+        const url = this.deps.links.confirm(token);
+        const outcome = await this.deps.mailer.send({
+            messageId: `newsletter-confirm-${token}`,
+            to: email,
+            subject: 'Confirm your newsletter subscription',
+            text: `Please confirm your subscription by opening this link:\n${url}\n`,
+            html: `<p>Please confirm your subscription:</p><p><a href="${url}">Confirm subscription</a></p>`,
+            kind: 'newsletter_confirmation',
+        });
+        if (outcome.status !== 'sent') {
+            // The subscriber row exists in `pending` either way; without the message
+            // the double opt-in never completes, so it is named — and D-59's record
+            // is what an operator reads when the subscriber says it never arrived.
+            console.warn('[newsletter] the confirmation e-mail was not sent', {
+                subscriberId,
+                reason: outcome.reason,
+            });
+        }
+    }
+}
+//# sourceMappingURL=subscriber.service.js.map

package/dist/backend/services/subscriber.service.js.map

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

package/dist/backend/services/tag.service.d.ts

@@ -0,0 +1,16 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CreateNewsletterTagRequest, type NewsletterTag as NewsletterTagDto, type UpdateNewsletterTagRequest } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+/** Newsletter tag CRUD (feature 048, US3). */
+export declare class NewsletterTagService {
+    #private;
+    private readonly emFactory;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, auditLog?: AuditPort | undefined);
+    list(): Promise<NewsletterTagDto[]>;
+    create(input: CreateNewsletterTagRequest): Promise<NewsletterTagDto>;
+    update(id: string, input: UpdateNewsletterTagRequest): Promise<NewsletterTagDto>;
+    remove(id: string): Promise<void>;
+    private toDto;
+}
+//# sourceMappingURL=tag.service.d.ts.map

package/dist/backend/services/tag.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/tag.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAe,KAAK,0BAA0B,EAAE,KAAK,aAAa,IAAI,gBAAgB,EAAE,KAAK,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAInK,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,8CAA8C;AAC9C,qBAAa,oBAAoB;;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,CAAC,EAAE,SAAS,YAAA;IAejC,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMnC,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAepE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAWhF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvC,OAAO,CAAC,KAAK;CAGd"}