@endora-commerce/mod-newsletter 0.100.0

package/dist/backend/services/provider/smtp-provider.d.ts

@@ -0,0 +1,30 @@
+import type { NewsletterSendMessage, NewsletterSendProvider } from '@endora-commerce/contracts';
+export interface SmtpProviderConfig {
+    host: string;
+    port: number;
+    secure: boolean;
+    username: string;
+    /** Decrypted secret (from Settings `secret` value type). */
+    password: string;
+}
+/**
+ * Bulk SMTP provider (feature 048, research R7). Built on the already-present
+ * `nodemailer`, it reaches Amazon SES (SMTP interface), Mailgun, Postmark, or
+ * any relay. This transport is OWNED by the newsletter module and is
+ * independent of the transactional `email` module's mailer. Throughput
+ * throttling is applied by the BullMQ send-worker limiter, not here.
+ */
+export declare class SmtpProvider implements NewsletterSendProvider {
+    private readonly transport;
+    constructor(config: SmtpProviderConfig);
+    send(msg: NewsletterSendMessage): Promise<{
+        providerMessageId?: string;
+    }>;
+    verify(): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=smtp-provider.d.ts.map

package/dist/backend/services/provider/smtp-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-provider.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/provider/smtp-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEhG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,sBAAsB;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAE5B,MAAM,EAAE,kBAAkB;IAShC,IAAI,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAczE,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAQrE"}

package/dist/backend/services/provider/smtp-provider.js

@@ -0,0 +1,42 @@
+import nodemailer, {} from 'nodemailer';
+/**
+ * Bulk SMTP provider (feature 048, research R7). Built on the already-present
+ * `nodemailer`, it reaches Amazon SES (SMTP interface), Mailgun, Postmark, or
+ * any relay. This transport is OWNED by the newsletter module and is
+ * independent of the transactional `email` module's mailer. Throughput
+ * throttling is applied by the BullMQ send-worker limiter, not here.
+ */
+export class SmtpProvider {
+    transport;
+    constructor(config) {
+        this.transport = nodemailer.createTransport({
+            host: config.host,
+            port: config.port,
+            secure: config.secure,
+            auth: config.username ? { user: config.username, pass: config.password } : undefined,
+        });
+    }
+    async send(msg) {
+        const from = msg.fromName ? `"${msg.fromName}" <${msg.fromEmail}>` : msg.fromEmail;
+        const info = await this.transport.sendMail({
+            from,
+            to: msg.to,
+            subject: msg.subject,
+            text: msg.text,
+            html: msg.html,
+            messageId: msg.messageId,
+            headers: msg.headers,
+        });
+        return { providerMessageId: info.messageId ?? msg.messageId };
+    }
+    async verify() {
+        try {
+            await this.transport.verify();
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+}
+//# sourceMappingURL=smtp-provider.js.map

package/dist/backend/services/provider/smtp-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-provider.js","sourceRoot":"","sources":["../../../../src/backend/services/provider/smtp-provider.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAoB,MAAM,YAAY,CAAC;AAY1D;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACN,SAAS,CAAc;IAExC,YAAY,MAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC;YAC1C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;SACrF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAA0B;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;QACnF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACzC,IAAI;YACJ,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;QACH,OAAO,EAAE,iBAAiB,EAAE,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC9B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAChF,CAAC;IACH,CAAC;CACF"}

package/dist/backend/services/provider-admin.service.d.ts

@@ -0,0 +1,39 @@
+import { type ProviderConfig, type PutProviderRequest } from '@endora-commerce/contracts';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import type { AdminAuditContext } from './provider-admin.types.js';
+import type { NewsletterProviderRegistry } from './provider/provider-registry.js';
+/** Minimal write surface of the Settings admin service used here. */
+export interface SettingsWriter {
+    setValueForAllChannels(code: string, rawValue: unknown, expectedVersion: string | null, actor: AdminAuditContext): Promise<unknown>;
+}
+/**
+ * Provider configuration admin (feature 048, US7; feature 058). The SMTP
+ * connection + credentials now live in a reusable `email_adapter` credential
+ * configuration referenced by `newsletter.email_credentials` (managed on the
+ * Credentials / Settings screen). This surface manages only the non-credential
+ * sender + throttle config, and exposes a `test()` that resolves the referenced
+ * provider and verifies it.
+ */
+export declare class NewsletterProviderAdminService {
+    private readonly settings;
+    private readonly writer;
+    private readonly providers;
+    constructor(settings: SettingsReadPort, writer: SettingsWriter, providers: NewsletterProviderRegistry);
+    /**
+     * Platform-wide reads (feature 072, D-41), the exact mirror of this class's
+     * own writes: `putConfig` below goes through `setValueForAllChannels`, so
+     * reading at a channel could only ever return what the global tier already
+     * holds — when it did not throw on a sentinel channel id first.
+     */
+    private str;
+    private num;
+    getConfig(): Promise<ProviderConfig>;
+    putConfig(input: PutProviderRequest, actor: AdminAuditContext): Promise<ProviderConfig>;
+    test(): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=provider-admin.service.d.ts.map

package/dist/backend/services/provider-admin.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-admin.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/provider-admin.service.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACpH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,sBAAsB,CACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,8BAA8B;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,0BAA0B;IAGxD;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,GAAG;IAIL,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAapC,SAAS,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAYvF,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAInE"}

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

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { NEWSLETTER_SETTING_CODES } from '@endora-commerce/contracts';
+/**
+ * Provider configuration admin (feature 048, US7; feature 058). The SMTP
+ * connection + credentials now live in a reusable `email_adapter` credential
+ * configuration referenced by `newsletter.email_credentials` (managed on the
+ * Credentials / Settings screen). This surface manages only the non-credential
+ * sender + throttle config, and exposes a `test()` that resolves the referenced
+ * provider and verifies it.
+ */
+export class NewsletterProviderAdminService {
+    settings;
+    writer;
+    providers;
+    constructor(settings, writer, providers) {
+        this.settings = settings;
+        this.writer = writer;
+        this.providers = providers;
+    }
+    /**
+     * Platform-wide reads (feature 072, D-41), the exact mirror of this class's
+     * own writes: `putConfig` below goes through `setValueForAllChannels`, so
+     * reading at a channel could only ever return what the global tier already
+     * holds — when it did not throw on a sentinel channel id first.
+     */
+    str(code) {
+        return this.settings.get(code, null, z.string()).catch(() => '');
+    }
+    num(code, fallback) {
+        return this.settings.get(code, null, z.number()).catch(() => fallback);
+    }
+    async getConfig() {
+        const C = NEWSLETTER_SETTING_CODES;
+        const [fromEmail, fromName, rate] = await Promise.all([
+            this.str(C.SENDER_FROM_EMAIL),
+            this.str(C.SENDER_FROM_NAME),
+            this.num(C.RATE_LIMIT_PER_SECOND, 14),
+        ]);
+        return {
+            sender: { fromEmail, fromName },
+            rateLimitPerSecond: rate,
+        };
+    }
+    async putConfig(input, actor) {
+        const C = NEWSLETTER_SETTING_CODES;
+        const w = (code, value) => this.writer.setValueForAllChannels(code, value, null, actor);
+        await Promise.all([
+            w(C.SENDER_FROM_EMAIL, input.sender.fromEmail),
+            w(C.SENDER_FROM_NAME, input.sender.fromName),
+            w(C.RATE_LIMIT_PER_SECOND, input.rateLimitPerSecond),
+        ]);
+        return this.getConfig();
+    }
+    async test() {
+        const provider = await this.providers.resolveProvider();
+        return provider.verify();
+    }
+}
+//# sourceMappingURL=provider-admin.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-admin.service.js","sourceRoot":"","sources":["../../../src/backend/services/provider-admin.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAgD,MAAM,4BAA4B,CAAC;AAepH;;;;;;;GAOG;AACH,MAAM,OAAO,8BAA8B;IAEtB;IACA;IACA;IAHnB,YACmB,QAA0B,EAC1B,MAAsB,EACtB,SAAqC;QAFrC,aAAQ,GAAR,QAAQ,CAAkB;QAC1B,WAAM,GAAN,MAAM,CAAgB;QACtB,cAAS,GAAT,SAAS,CAA4B;IACrD,CAAC;IAEJ;;;;;OAKG;IACK,GAAG,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACO,GAAG,CAAC,IAAY,EAAE,QAAgB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,CAAC,GAAG,wBAAwB,CAAC;QACnC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB,EAAE,EAAE,CAAC;SACtC,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;YAC/B,kBAAkB,EAAE,IAAI;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAyB,EAAE,KAAwB;QACjE,MAAM,CAAC,GAAG,wBAAwB,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,KAAc,EAAoB,EAAE,CAC3D,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/D,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;YAC9C,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC5C,CAAC,CAAC,CAAC,CAAC,qBAAqB,EAAE,KAAK,CAAC,kBAAkB,CAAC;SACrD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/backend/services/provider-admin.types.d.ts

@@ -0,0 +1,6 @@
+/** Admin audit context (mirrors the Settings module's AdminAuditContext). */
+export interface AdminAuditContext {
+    actorAdminUserId: string | null;
+    requestId?: string | null;
+}
+//# sourceMappingURL=provider-admin.types.d.ts.map

package/dist/backend/services/provider-admin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-admin.types.d.ts","sourceRoot":"","sources":["../../../src/backend/services/provider-admin.types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/backend/services/provider-admin.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-admin.types.js.map

package/dist/backend/services/provider-admin.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-admin.types.js","sourceRoot":"","sources":["../../../src/backend/services/provider-admin.types.ts"],"names":[],"mappings":""}

package/dist/backend/services/queues/newsletter-queues.d.ts

@@ -0,0 +1,34 @@
+import { Queue, Worker, type Processor, type QueueOptions, type WorkerOptions } from 'bullmq';
+import type { Redis } from 'ioredis';
+/**
+ * BullMQ queues for newsletter dispatch (feature 048, Principle X). Durable,
+ * Redis-backed, atomic-claim + idempotent handlers (the unique send-record row),
+ * producer-only-enqueue, and consumed by the separable `worker.ts` entrypoint.
+ *
+ *  - `newsletter.campaign.plan` — one job per send/scheduled-fire; resolves the
+ *    audience and claims + enqueues per-recipient send jobs.
+ *  - `newsletter.send` — one job per claimed recipient; renders + dispatches.
+ *  - `newsletter.automation.step` — one job per (run, step); send or delayed wait.
+ */
+export declare const CAMPAIGN_PLAN_QUEUE = "newsletter.campaign.plan";
+export declare const SEND_QUEUE = "newsletter.send";
+export declare const AUTOMATION_STEP_QUEUE = "newsletter.automation.step";
+export interface CampaignPlanJobData {
+    campaignId: string;
+}
+export interface SendJobData {
+    recordId: string;
+}
+export interface AutomationStepJobData {
+    runId: string;
+    stepIndex: number;
+}
+export declare function createCampaignPlanQueue(redis: Redis, o?: Partial<QueueOptions>): Queue<CampaignPlanJobData>;
+export declare function createSendQueue(redis: Redis, o?: Partial<QueueOptions>): Queue<SendJobData>;
+export declare function createAutomationStepQueue(redis: Redis, o?: Partial<QueueOptions>): Queue<AutomationStepJobData>;
+export declare function createCampaignPlanWorker(redis: Redis, processor: Processor<CampaignPlanJobData>, overrides?: Partial<WorkerOptions>): Worker<CampaignPlanJobData>;
+export declare function createSendWorker(redis: Redis, processor: Processor<SendJobData>, 
+/** Per-second throughput cap (provider throttle, FR-033). */
+ratePerSecond: number, overrides?: Partial<WorkerOptions>): Worker<SendJobData>;
+export declare function createAutomationStepWorker(redis: Redis, processor: Processor<AutomationStepJobData>, overrides?: Partial<WorkerOptions>): Worker<AutomationStepJobData>;
+//# sourceMappingURL=newsletter-queues.d.ts.map

package/dist/backend/services/queues/newsletter-queues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-queues.d.ts","sourceRoot":"","sources":["../../../../src/backend/services/queues/newsletter-queues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC9F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAC9D,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAC5C,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAE3G;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAE3F;AACD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACxB,KAAK,CAAC,qBAAqB,CAAC,CAE9B;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,CAAC,mBAAmB,CAAC,EACzC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,MAAM,CAAC,mBAAmB,CAAC,CAM7B;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC;AACjC,6DAA6D;AAC7D,aAAa,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,MAAM,CAAC,WAAW,CAAC,CAOrB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,CAAC,qBAAqB,CAAC,EAC3C,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,MAAM,CAAC,qBAAqB,CAAC,CAM/B"}

package/dist/backend/services/queues/newsletter-queues.js

@@ -0,0 +1,58 @@
+import { Queue, Worker } from 'bullmq';
+import { enterSystemScope } from '@endora-commerce/platform/kernel';
+/**
+ * BullMQ queues for newsletter dispatch (feature 048, Principle X). Durable,
+ * Redis-backed, atomic-claim + idempotent handlers (the unique send-record row),
+ * producer-only-enqueue, and consumed by the separable `worker.ts` entrypoint.
+ *
+ *  - `newsletter.campaign.plan` — one job per send/scheduled-fire; resolves the
+ *    audience and claims + enqueues per-recipient send jobs.
+ *  - `newsletter.send` — one job per claimed recipient; renders + dispatches.
+ *  - `newsletter.automation.step` — one job per (run, step); send or delayed wait.
+ */
+export const CAMPAIGN_PLAN_QUEUE = 'newsletter.campaign.plan';
+export const SEND_QUEUE = 'newsletter.send';
+export const AUTOMATION_STEP_QUEUE = 'newsletter.automation.step';
+const DEFAULT_JOB_OPTIONS = {
+    attempts: 5,
+    backoff: { type: 'exponential', delay: 2_000 },
+    removeOnComplete: { count: 1_000 },
+    removeOnFail: { count: 5_000 },
+};
+function makeQueue(name, redis, overrides) {
+    return new Queue(name, { connection: redis, defaultJobOptions: DEFAULT_JOB_OPTIONS, ...overrides });
+}
+export function createCampaignPlanQueue(redis, o) {
+    return makeQueue(CAMPAIGN_PLAN_QUEUE, redis, o);
+}
+export function createSendQueue(redis, o) {
+    return makeQueue(SEND_QUEUE, redis, o);
+}
+export function createAutomationStepQueue(redis, o) {
+    return makeQueue(AUTOMATION_STEP_QUEUE, redis, o);
+}
+export function createCampaignPlanWorker(redis, processor, overrides) {
+    return new Worker(CAMPAIGN_PLAN_QUEUE, (job) => enterSystemScope('newsletter campaign-plan', () => processor(job)), {
+        connection: redis,
+        concurrency: 4,
+        ...overrides,
+    });
+}
+export function createSendWorker(redis, processor, 
+/** Per-second throughput cap (provider throttle, FR-033). */
+ratePerSecond, overrides) {
+    return new Worker(SEND_QUEUE, (job) => enterSystemScope('newsletter send', () => processor(job)), {
+        connection: redis,
+        concurrency: 8,
+        limiter: { max: Math.max(1, ratePerSecond), duration: 1_000 },
+        ...overrides,
+    });
+}
+export function createAutomationStepWorker(redis, processor, overrides) {
+    return new Worker(AUTOMATION_STEP_QUEUE, (job) => enterSystemScope('newsletter automation-step', () => processor(job)), {
+        connection: redis,
+        concurrency: 4,
+        ...overrides,
+    });
+}
+//# sourceMappingURL=newsletter-queues.js.map

package/dist/backend/services/queues/newsletter-queues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter-queues.js","sourceRoot":"","sources":["../../../../src/backend/services/queues/newsletter-queues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAyD,MAAM,QAAQ,CAAC;AAG9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAalE,MAAM,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,EAAE,IAAI,EAAE,aAAsB,EAAE,KAAK,EAAE,KAAK,EAAE;IACvD,gBAAgB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;IAClC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;CAC/B,CAAC;AAEF,SAAS,SAAS,CAAI,IAAY,EAAE,KAAY,EAAE,SAAiC;IACjF,OAAO,IAAI,KAAK,CAAI,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAY,EAAE,CAAyB;IAC7E,OAAO,SAAS,CAAsB,mBAAmB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,CAAyB;IACrE,OAAO,SAAS,CAAc,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AACD,MAAM,UAAU,yBAAyB,CACvC,KAAY,EACZ,CAAyB;IAEzB,OAAO,SAAS,CAAwB,qBAAqB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAY,EACZ,SAAyC,EACzC,SAAkC;IAElC,OAAO,IAAI,MAAM,CAAsB,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,0BAA0B,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE;QACvI,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,CAAC;QACd,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAY,EACZ,SAAiC;AACjC,6DAA6D;AAC7D,aAAqB,EACrB,SAAkC;IAElC,OAAO,IAAI,MAAM,CAAc,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE;QAC7G,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC7D,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAY,EACZ,SAA2C,EAC3C,SAAkC;IAElC,OAAO,IAAI,MAAM,CAAwB,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE;QAC7I,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,CAAC;QACd,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { SelfNewsletterStatus } from '@endora-commerce/contracts';
+import type { NewsletterSubscriberService } from './subscriber.service.js';
+/** Customer self-service newsletter view (feature 048, US9). */
+export declare class NewsletterSelfService {
+    private readonly emFactory;
+    private readonly subscribers;
+    constructor(emFactory: () => EntityManager, subscribers: NewsletterSubscriberService);
+    getStatus(email: string): Promise<SelfNewsletterStatus>;
+    subscribe(email: string, customerAccountId: string, tags?: string[], customFields?: Record<string, string | number | boolean | null>): Promise<{
+        status: 'pending' | 'active';
+    }>;
+    unsubscribe(email: string, reason?: string): Promise<{
+        ok: boolean;
+    }>;
+}
+//# sourceMappingURL=self.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"self.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/self.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,gEAAgE;AAChE,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,SAAS,EAAE,MAAM,aAAa,EAC9B,WAAW,EAAE,2BAA2B;IAGrD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAcvD,SAAS,CACb,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,GAC9D,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,CAAC;IAWtC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;CAM5E"}

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

@@ -0,0 +1,44 @@
+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';
+/** Customer self-service newsletter view (feature 048, US9). */
+export class NewsletterSelfService {
+    emFactory;
+    subscribers;
+    constructor(emFactory, subscribers) {
+        this.emFactory = emFactory;
+        this.subscribers = subscribers;
+    }
+    async getStatus(email) {
+        const em = this.emFactory();
+        const sub = await em.findOne(NewsletterSubscriber, { email: email.toLowerCase() });
+        if (!sub)
+            return { subscribed: false, status: null, tags: [], canManage: true };
+        const links = await em.find(NewsletterSubscriberTag, { subscriberId: sub.id });
+        const tags = await em.find(NewsletterTag, { id: { $in: links.map((l) => l.tagId) } });
+        return {
+            subscribed: sub.status === 'active',
+            status: sub.status,
+            tags: tags.map((t) => ({ code: t.code, name: t.name })),
+            canManage: true,
+        };
+    }
+    async subscribe(email, customerAccountId, tags, customFields) {
+        return this.subscribers.subscribe({
+            email,
+            salesChannelId: null,
+            source: 'account',
+            customerAccountId,
+            ...(tags ? { tags } : {}),
+            ...(customFields ? { customFields } : {}),
+        });
+    }
+    async unsubscribe(email, reason) {
+        const em = this.emFactory();
+        const sub = await em.findOne(NewsletterSubscriber, { email: email.toLowerCase() });
+        if (!sub)
+            return { ok: true };
+        return this.subscribers.unsubscribe(sub.id, reason);
+    }
+}
+//# sourceMappingURL=self.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"self.service.js","sourceRoot":"","sources":["../../../src/backend/services/self.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAG1F,gEAAgE;AAChE,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,SAA8B,EAC9B,WAAwC;QADxC,cAAS,GAAT,SAAS,CAAqB;QAC9B,gBAAW,GAAX,WAAW,CAA6B;IACxD,CAAC;IAEJ,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,OAAO;YACL,UAAU,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ;YACnC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAAa,EACb,iBAAyB,EACzB,IAAe,EACf,YAA+D;QAE/D,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;YAChC,KAAK;YACL,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,SAAS;YACjB,iBAAiB;YACjB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,MAAe;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;CACF"}

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

@@ -0,0 +1,10 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CampaignStats } from '@endora-commerce/contracts';
+/** Campaign / automation engagement statistics (feature 048, US6). */
+export declare class NewsletterStatsService {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    campaignStats(campaignId: string): Promise<CampaignStats>;
+    private perLink;
+}
+//# sourceMappingURL=stats.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/stats.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQhE,sEAAsE;AACtE,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YAuBjD,OAAO;CAetB"}

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

@@ -0,0 +1,45 @@
+import { NewsletterSendRecord } from '../entities/newsletter-send-record.entity.js';
+import { NewsletterEngagementEvent } from '../entities/newsletter-engagement-event.entity.js';
+function rate(n, d) {
+    return d > 0 ? Math.round((n / d) * 1000) / 1000 : 0;
+}
+/** Campaign / automation engagement statistics (feature 048, US6). */
+export class NewsletterStatsService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async campaignStats(campaignId) {
+        const em = this.emFactory();
+        const records = await em.find(NewsletterSendRecord, { campaignId });
+        const sent = records.filter((r) => r.status === 'sent').length;
+        const failed = records.filter((r) => r.status === 'failed' || r.status === 'bounced' || r.status === 'complained').length;
+        const opened = records.filter((r) => r.openedAt !== null).length;
+        const clicked = records.filter((r) => r.clickCount > 0).length;
+        const recordIds = records.map((r) => r.id);
+        const perLinkClicks = recordIds.length > 0 ? await this.perLink(em, recordIds) : [];
+        return {
+            sent,
+            delivered: sent,
+            failed,
+            opened,
+            clicked,
+            openRate: rate(opened, sent),
+            clickRate: rate(clicked, sent),
+            perLinkClicks,
+        };
+    }
+    async perLink(em, recordIds) {
+        const events = await em.find(NewsletterEngagementEvent, {
+            sendRecordId: { $in: recordIds },
+            type: 'click',
+        });
+        const counts = new Map();
+        for (const e of events) {
+            const url = e.url ?? '';
+            counts.set(url, (counts.get(url) ?? 0) + 1);
+        }
+        return [...counts.entries()].map(([url, clicks]) => ({ url, clicks }));
+    }
+}
+//# sourceMappingURL=stats.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.service.js","sourceRoot":"","sources":["../../../src/backend/services/stats.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mDAAmD,CAAC;AAE9F,SAAS,IAAI,CAAC,CAAS,EAAE,CAAS;IAChC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,sEAAsE;AACtE,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,SAA8B;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAE/D,KAAK,CAAC,aAAa,CAAC,UAAkB;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC;QAC1H,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;QACjE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QAE/D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpF,OAAO;YACL,IAAI;YACJ,SAAS,EAAE,IAAI;YACf,MAAM;YACN,MAAM;YACN,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;YAC5B,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;YAC9B,aAAa;SACd,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,EAAiB,EACjB,SAAmB;QAEnB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,yBAAyB,EAAE;YACtD,YAAY,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;YAChC,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;CACF"}

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

@@ -0,0 +1,26 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type SubscriberDetail, type SubscriberListQuery, type SubscriberListResponse, type SubscriberStatus } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+/** Filter fields shared by list + export (explicit `| undefined` for exactOptionalPropertyTypes). */
+export interface SubscriberFilter {
+    status?: SubscriberStatus | undefined;
+    tag?: string | undefined;
+    channel?: string | undefined;
+    q?: string | undefined;
+}
+/** Admin subscriber list / detail / lifecycle / CSV export (feature 048, US3). */
+export declare class NewsletterSubscriberAdminService {
+    private readonly emFactory;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, auditLog?: AuditPort | undefined);
+    private buildWhere;
+    private tagsFor;
+    list(query: SubscriberListQuery): Promise<SubscriberListResponse>;
+    getDetail(id: string): Promise<SubscriberDetail>;
+    deactivate(id: string, expectedVersion: number): Promise<SubscriberDetail>;
+    remove(id: string): Promise<void>;
+    exportCsv(query: SubscriberFilter): Promise<string>;
+    private toSummary;
+    private toDetail;
+}
+//# sourceMappingURL=subscriber-admin.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-admin.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/subscriber-admin.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAEtB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAMlE,qGAAqG;AACrG,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxB;AAQD,kFAAkF;AAClF,qBAAa,gCAAgC;IAEzC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,CAAC,EAAE,SAAS,YAAA;YAGzB,UAAU;YAaV,OAAO;IAiBf,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiBjE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQhD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqB1E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjC,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBzD,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,QAAQ;CAajB"}