@openlup/platform 0.15.0 → 0.17.0

package/dist/communications/contracts/shipmentDelivered.js

@@ -0,0 +1,24 @@
+import { guideCardBlock } from "./guideCard.js";
+import { heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createShipmentDeliveredContentFactory(input) {
+    const { commerceEmailContent, formatCustomerOrderReference } = input;
+    function shipmentDeliveredEmailContent(locale, vars, signoff) {
+        const copy = commerceEmailContent.shipmentDelivered[locale];
+        const orderRef = formatCustomerOrderReference(vars.orderId, commerceEmailContent.orderRefPrefix);
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(copy.intro(orderRef, vars.contextName ?? null)),
+            guideCardBlock(copy.startGuide, vars.siteOrigin, vars.contextName ?? null),
+        ];
+        blocks.push(paragraph(copy.outro));
+        blocks.push(paragraph(signoff));
+        return {
+            subject: copy.subject(orderRef),
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { shipmentDeliveredEmailContent };
+}

package/dist/communications/contracts/shipmentDispatched.d.ts

@@ -0,0 +1,27 @@
+import type { CommerceEmailContent } from "./commerceEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface ShipmentDispatchedEmailVars {
+    firstName: string | null;
+    orderId: string;
+    /** Opaque carrier tracking number, or null when none is available. */
+    trackingNumber: string | null;
+    /** Absolute tracking URL (carrier page); rendered as a "track parcel" link. */
+    trackingUrl?: string | null;
+    /** Site origin (absolute, no trailing slash) the guide links are built on. */
+    siteOrigin: string;
+    /** Optional deployment-specific context consumed by the selected copy pack. */
+    contextName?: string | null;
+}
+export interface ShipmentDispatchedEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createShipmentDispatchedContentFactory(input: {
+    commerceEmailContent: Pick<CommerceEmailContent, "shipmentDispatched" | "orderRefPrefix">;
+    formatCustomerOrderReference: (orderId: string, prefix: string) => string;
+}): {
+    shipmentDispatchedEmailContent: (locale: Locale, vars: ShipmentDispatchedEmailVars, signoff: string) => ShipmentDispatchedEmailContent;
+};

package/dist/communications/contracts/shipmentDispatched.js

@@ -0,0 +1,35 @@
+import { guideCardBlock } from "./guideCard.js";
+import { accentBox, dataTable, heading, linkParagraph, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createShipmentDispatchedContentFactory(input) {
+    const { commerceEmailContent, formatCustomerOrderReference } = input;
+    function shipmentDispatchedEmailContent(locale, vars, signoff) {
+        const copy = commerceEmailContent.shipmentDispatched[locale];
+        const orderRef = formatCustomerOrderReference(vars.orderId, commerceEmailContent.orderRefPrefix);
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(copy.intro(orderRef)),
+        ];
+        // Tracking is the job-to-be-done of this message: the number and the
+        // carrier page share one box, and the guide card is the only button.
+        const trackLink = vars.trackingUrl ? { label: copy.trackParcel, href: vars.trackingUrl } : undefined;
+        if (vars.trackingNumber) {
+            blocks.push(dataTable([{ label: copy.trackingLabel, value: vars.trackingNumber }], { link: trackLink }));
+        }
+        else {
+            blocks.push(accentBox(copy.noTracking, { label: copy.noTrackingLabel }));
+            if (trackLink)
+                blocks.push(linkParagraph(trackLink.label, trackLink.href));
+        }
+        blocks.push(guideCardBlock(copy.accountGuide, vars.siteOrigin, vars.contextName ?? null));
+        blocks.push(paragraph(copy.outro(vars.contextName ?? null)));
+        blocks.push(paragraph(signoff));
+        return {
+            subject: copy.subject(orderRef),
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { shipmentDispatchedEmailContent };
+}

package/dist/communications/contracts/shipmentException.d.ts

@@ -0,0 +1,21 @@
+import type { CommerceEmailContent } from "./commerceEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface ShipmentExceptionEmailVars {
+    firstName: string | null;
+    orderId: string;
+    /** Absolute URL to the customer's order/account page; null/absent → no button. */
+    ctaUrl?: string | null;
+}
+export interface ShipmentExceptionEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createShipmentExceptionContentFactory(input: {
+    commerceEmailContent: Pick<CommerceEmailContent, "shipmentException" | "orderRefPrefix">;
+    formatCustomerOrderReference: (orderId: string, prefix: string) => string;
+}): {
+    shipmentExceptionEmailContent: (locale: Locale, vars: ShipmentExceptionEmailVars, signoff: string) => ShipmentExceptionEmailContent;
+};

package/dist/communications/contracts/shipmentException.js

@@ -0,0 +1,26 @@
+import { accentBox, button, heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createShipmentExceptionContentFactory(input) {
+    const { commerceEmailContent, formatCustomerOrderReference } = input;
+    function shipmentExceptionEmailContent(locale, vars, signoff) {
+        const copy = commerceEmailContent.shipmentException[locale];
+        const orderRef = formatCustomerOrderReference(vars.orderId, commerceEmailContent.orderRefPrefix);
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(copy.intro(orderRef)),
+            accentBox(copy.reassurance, { label: copy.reassuranceLabel }),
+        ];
+        if (vars.ctaUrl) {
+            blocks.push(button(copy.cta, vars.ctaUrl));
+        }
+        blocks.push(paragraph(copy.outro));
+        blocks.push(paragraph(signoff));
+        return {
+            subject: copy.subject(orderRef),
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { shipmentExceptionEmailContent };
+}

package/dist/communications/contracts/subscriptionActivationActionRequired.d.ts

@@ -0,0 +1,17 @@
+import type { SubscriptionEmailContent } from "./subscriptionEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface SubscriptionActivationActionRequiredVars {
+    firstName: string | null;
+    ctaUrl: string;
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createSubscriptionActivationActionRequiredContentFactory(input: {
+    subscriptionEmailContent: Pick<SubscriptionEmailContent, "activationActionRequired">;
+}): {
+    subscriptionActivationActionRequiredEmailContent: (locale: Locale, vars: SubscriptionActivationActionRequiredVars, signoff: string) => {
+        subject: string;
+        preheader: string;
+        blocks: EmailBlock[];
+    };
+};

package/dist/communications/contracts/subscriptionActivationActionRequired.js

@@ -0,0 +1,22 @@
+import { accentBox, button, heading, paragraph } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createSubscriptionActivationActionRequiredContentFactory(input) {
+    const { subscriptionEmailContent } = input;
+    function subscriptionActivationActionRequiredEmailContent(locale, vars, signoff) {
+        const copy = subscriptionEmailContent.activationActionRequired[locale];
+        return {
+            subject: copy.subject,
+            preheader: copy.preheader,
+            blocks: [
+                heading(copy.heading),
+                paragraph(copy.greeting(vars.firstName)),
+                paragraph(copy.intro),
+                accentBox(copy.facts),
+                button(copy.cta, vars.ctaUrl),
+                paragraph(copy.outro),
+                paragraph(signoff),
+            ],
+        };
+    }
+    return { subscriptionActivationActionRequiredEmailContent };
+}

package/dist/communications/contracts/subscriptionAddressChanged.d.ts

@@ -0,0 +1,19 @@
+import type { SubscriptionEmailContent } from "./subscriptionEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface SubscriptionAddressChangedEmailVars {
+    firstName: string | null;
+    /** Absolute CTA URL (manage subscription); null/absent → no button. */
+    ctaUrl?: string | null;
+}
+export interface SubscriptionAddressChangedEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createSubscriptionAddressChangedContentFactory(input: {
+    subscriptionEmailContent: Pick<SubscriptionEmailContent, "addressChanged">;
+}): {
+    subscriptionAddressChangedEmailContent: (locale: Locale, vars: SubscriptionAddressChangedEmailVars, signoff: string) => SubscriptionAddressChangedEmailContent;
+};

package/dist/communications/contracts/subscriptionAddressChanged.js

@@ -0,0 +1,25 @@
+import { accentBox, button, heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createSubscriptionAddressChangedContentFactory(input) {
+    const { subscriptionEmailContent } = input;
+    function subscriptionAddressChangedEmailContent(locale, vars, signoff) {
+        const copy = subscriptionEmailContent.addressChanged[locale];
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(copy.intro),
+            accentBox(copy.reassurance),
+        ];
+        if (vars.ctaUrl) {
+            blocks.push(button(copy.cta, vars.ctaUrl));
+        }
+        blocks.push(paragraph(copy.outro));
+        blocks.push(paragraph(signoff));
+        return {
+            subject: copy.subject,
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { subscriptionAddressChangedEmailContent };
+}

package/dist/communications/contracts/subscriptionCancelled.d.ts

@@ -0,0 +1,19 @@
+import type { SubscriptionEmailContent } from "./subscriptionEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface SubscriptionCancelledEmailVars {
+    firstName: string | null;
+    /** Absolute CTA URL (back to shop / re-subscribe); null/absent → no button. */
+    ctaUrl?: string | null;
+}
+export interface SubscriptionCancelledEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createSubscriptionCancelledContentFactory(input: {
+    subscriptionEmailContent: Pick<SubscriptionEmailContent, "cancelled">;
+}): {
+    subscriptionCancelledEmailContent: (locale: Locale, vars: SubscriptionCancelledEmailVars, signoff: string) => SubscriptionCancelledEmailContent;
+};

package/dist/communications/contracts/subscriptionCancelled.js

@@ -0,0 +1,25 @@
+import { accentBox, button, heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createSubscriptionCancelledContentFactory(input) {
+    const { subscriptionEmailContent } = input;
+    function subscriptionCancelledEmailContent(locale, vars, signoff) {
+        const copy = subscriptionEmailContent.cancelled[locale];
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(copy.intro),
+            accentBox(copy.reassurance),
+        ];
+        blocks.push(paragraph(copy.outro));
+        if (vars.ctaUrl) {
+            blocks.push(button(copy.cta, vars.ctaUrl));
+        }
+        blocks.push(paragraph(signoff));
+        return {
+            subject: copy.subject,
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { subscriptionCancelledEmailContent };
+}

package/dist/communications/contracts/subscriptionCycleSkipped.d.ts

@@ -0,0 +1,25 @@
+import type { SubscriptionEmailContent } from "./subscriptionEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface SubscriptionCycleSkippedEmailVars {
+    firstName: string | null;
+    /** Localized next CHARGE date after the skip, or null when unavailable. */
+    chargeDateLabel?: string | null;
+    /** Localized estimated delivery window after the skip, or null when unavailable. */
+    deliveryWindowLabel?: string | null;
+    /** Localized holiday caveat; present ONLY when a holiday moved the window. */
+    holidayNote?: string | null;
+    /** Absolute CTA URL (manage subscription); null/absent → no button. */
+    ctaUrl?: string | null;
+}
+export interface SubscriptionCycleSkippedEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createSubscriptionCycleSkippedContentFactory(input: {
+    subscriptionEmailContent: Pick<SubscriptionEmailContent, "cycleSkipped">;
+}): {
+    subscriptionCycleSkippedEmailContent: (locale: Locale, vars: SubscriptionCycleSkippedEmailVars, signoff: string) => SubscriptionCycleSkippedEmailContent;
+};

package/dist/communications/contracts/subscriptionCycleSkipped.js

@@ -0,0 +1,40 @@
+import { accentBox, button, dataTable, heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createSubscriptionCycleSkippedContentFactory(input) {
+    const { subscriptionEmailContent } = input;
+    function subscriptionCycleSkippedEmailContent(locale, vars, signoff) {
+        const copy = subscriptionEmailContent.cycleSkipped[locale];
+        const hasSchedule = Boolean(vars.chargeDateLabel && vars.deliveryWindowLabel);
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(hasSchedule ? copy.intro : copy.introWithoutDates),
+        ];
+        if (locale === "pl" && hasSchedule) {
+            blocks.push(dataTable([
+                { label: copy.deliveryLabel, value: vars.deliveryWindowLabel },
+                { label: copy.chargeLabel, value: vars.chargeDateLabel },
+            ]));
+        }
+        const reassurance = [
+            ...(locale !== "pl" && hasSchedule
+                ? [copy.dateLine(vars.deliveryWindowLabel, vars.chargeDateLabel)]
+                : []),
+            ...(vars.holidayNote ? [vars.holidayNote] : []),
+            ...copy.reassurance,
+        ];
+        blocks.push(accentBox(reassurance));
+        blocks.push(paragraph(copy.manageLine));
+        if (vars.ctaUrl) {
+            blocks.push(button(copy.cta, vars.ctaUrl));
+        }
+        blocks.push(paragraph(copy.outro));
+        blocks.push(paragraph(signoff));
+        return {
+            subject: hasSchedule ? copy.subject : copy.subjectWithoutDates,
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { subscriptionCycleSkippedEmailContent };
+}

package/dist/communications/contracts/subscriptionDeliveryRescheduled.d.ts

@@ -0,0 +1,25 @@
+import type { SubscriptionEmailContent } from "./subscriptionEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface SubscriptionDeliveryRescheduledEmailVars {
+    firstName: string | null;
+    /** Localized new CHARGE date (the date the customer picked), or null. */
+    chargeDateLabel?: string | null;
+    /** Localized estimated delivery window derived from the new charge date, or null. */
+    deliveryWindowLabel?: string | null;
+    /** Localized holiday caveat; present ONLY when a holiday moved the window. */
+    holidayNote?: string | null;
+    /** Absolute CTA URL (manage subscription); null/absent → no button. */
+    ctaUrl?: string | null;
+}
+export interface SubscriptionDeliveryRescheduledEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createSubscriptionDeliveryRescheduledContentFactory(input: {
+    subscriptionEmailContent: Pick<SubscriptionEmailContent, "deliveryRescheduled">;
+}): {
+    subscriptionDeliveryRescheduledEmailContent: (locale: Locale, vars: SubscriptionDeliveryRescheduledEmailVars, signoff: string) => SubscriptionDeliveryRescheduledEmailContent;
+};

package/dist/communications/contracts/subscriptionDeliveryRescheduled.js

@@ -0,0 +1,39 @@
+import { accentBox, button, dataTable, heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createSubscriptionDeliveryRescheduledContentFactory(input) {
+    const { subscriptionEmailContent } = input;
+    function subscriptionDeliveryRescheduledEmailContent(locale, vars, signoff) {
+        const copy = subscriptionEmailContent.deliveryRescheduled[locale];
+        const hasSchedule = Boolean(vars.chargeDateLabel && vars.deliveryWindowLabel);
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(hasSchedule ? copy.intro : copy.introWithoutDates),
+        ];
+        if (locale === "pl" && hasSchedule) {
+            blocks.push(dataTable([
+                { label: copy.deliveryLabel, value: vars.deliveryWindowLabel },
+                { label: copy.chargeLabel, value: vars.chargeDateLabel },
+            ]));
+        }
+        const reassurance = [
+            ...(locale !== "pl" && hasSchedule
+                ? [copy.dateLine(vars.deliveryWindowLabel, vars.chargeDateLabel)]
+                : []),
+            ...(vars.holidayNote ? [vars.holidayNote] : []),
+            ...copy.reassurance,
+        ];
+        blocks.push(accentBox(reassurance));
+        if (vars.ctaUrl) {
+            blocks.push(button(copy.cta, vars.ctaUrl));
+        }
+        blocks.push(paragraph(copy.outro));
+        blocks.push(paragraph(signoff));
+        return {
+            subject: hasSchedule ? copy.subject : copy.subjectWithoutDates,
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { subscriptionDeliveryRescheduledEmailContent };
+}

package/dist/communications/contracts/subscriptionEmailContent.d.ts

@@ -0,0 +1,145 @@
+import type { Locale } from "./email.js";
+type Localized<T> = Readonly<Record<Locale, T>>;
+export interface SubscriptionBaseCopy {
+    subject: string;
+    preheader: string;
+    heading: string;
+    greeting: (firstName: string | null) => string;
+}
+export interface SubscriptionActionCopy extends SubscriptionBaseCopy {
+    intro: string;
+    reassurance: string[];
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionActivationCopy extends SubscriptionBaseCopy {
+    intro: string;
+    facts: string[];
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionScheduleCopy extends SubscriptionBaseCopy {
+    subjectWithoutDates: string;
+    intro: string;
+    introWithoutDates: string;
+    deliveryLabel: string;
+    chargeLabel: string;
+    dateLine: (window: string, chargeDate: string) => string;
+    reassurance: string[];
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionPackageChangedCopy extends SubscriptionBaseCopy {
+    intro: (actionLabel: string | null) => string;
+    reassurance: string[];
+    actionLabels: Readonly<Record<string, string>>;
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionPauseReminderCopy extends SubscriptionBaseCopy {
+    intro: (brandName: string) => string;
+    resume: (resumeDate: string) => string;
+    reassurance: string[];
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionPausedCopy extends SubscriptionBaseCopy {
+    intro: string;
+    reassurance: (brandName: string) => string[];
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionRenewalUpcomingCopy extends SubscriptionBaseCopy {
+    intro: (contextName: string | null) => string;
+    dateLine: (label: string) => string;
+    deliveryLine: (window: string) => string;
+    editCutoffLine: (label: string) => string;
+    noDateLine: string;
+    amountLine: (label: string) => string;
+    starterGraduationLine: (units: number, cadenceDays: number, detail?: string | null) => string;
+    detailsLabel: string;
+    manageLine: string;
+    cta: string;
+}
+export interface SubscriptionResumedCopy extends SubscriptionBaseCopy {
+    intro: (contextName: string | null) => string;
+    reassurance: (brandName: string) => string[];
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionWelcomeCopy extends SubscriptionBaseCopy {
+    intro: string;
+    cadenceLine: (days: number) => string;
+    deliveryLine: (window: string, chargeDate: string) => string;
+    editCutoffLine: (label: string) => string;
+    fallbackLine: string;
+    starterDelivery2Line: (amount: string) => string;
+    starterSteadyLine: (units: number, cadenceDays: number, detail?: string | null) => string;
+    detailsLabel: string;
+    manageLine: string;
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionWinbackCopy extends SubscriptionBaseCopy {
+    intro: string;
+    reasonsLabel?: (brandName: string) => string;
+    reasons: string[];
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionPaymentExpiredCopy extends SubscriptionBaseCopy {
+    preheaderWithCta: string;
+    intro: string;
+    detail: (amountLabel: string | null) => string[];
+    ctaDetail: string;
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionPaymentFailedCopy extends SubscriptionBaseCopy {
+    intro: string;
+    amountLine: (amountLabel: string) => string;
+    noAmountLine: string;
+    noAmountLineNoRetry: string;
+    methodLine: (scheme: string, lastDigits: string) => string;
+    reassurance: (attempt: number, dateLabel: string | null) => string;
+    noRetryAction: string;
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionPaymentRecoveredCopy extends SubscriptionBaseCopy {
+    intro: string;
+    detail: (amountLabel: string | null) => string[];
+    outro: string;
+}
+export interface SubscriptionRenewalAtRiskCopy extends SubscriptionBaseCopy {
+    intro: (renewalDateLabel: string | null) => string;
+    consequence: string;
+    cta: string;
+    outro: string;
+}
+export interface SubscriptionLifecycleEmailContent {
+    activationActionRequired: Localized<SubscriptionActivationCopy>;
+    addressChanged: Localized<SubscriptionActionCopy>;
+    cancelled: Localized<SubscriptionActionCopy>;
+    cycleSkipped: Localized<SubscriptionScheduleCopy & {
+        manageLine: string;
+    }>;
+    deliveryRescheduled: Localized<SubscriptionScheduleCopy>;
+    packageChanged: Localized<SubscriptionPackageChangedCopy>;
+    pauseReminder: Localized<SubscriptionPauseReminderCopy>;
+    paused: Localized<SubscriptionPausedCopy>;
+    renewalUpcoming: Localized<SubscriptionRenewalUpcomingCopy>;
+    resumed: Localized<SubscriptionResumedCopy>;
+    welcome: Localized<SubscriptionWelcomeCopy>;
+    winback: Localized<SubscriptionWinbackCopy>;
+}
+export interface SubscriptionDunningEmailContent {
+    paymentExpired: Localized<SubscriptionPaymentExpiredCopy>;
+    paymentFailed: Localized<SubscriptionPaymentFailedCopy>;
+    paymentRecovered: Localized<SubscriptionPaymentRecoveredCopy>;
+    renewalAtRisk: Localized<SubscriptionRenewalAtRiskCopy>;
+}
+export interface SubscriptionEmailContent extends SubscriptionLifecycleEmailContent, SubscriptionDunningEmailContent {
+    id: "example" | "deployment-overlay";
+}
+export {};

package/dist/communications/contracts/subscriptionEmailContent.js

@@ -0,0 +1 @@
+export {};

package/dist/communications/contracts/subscriptionPackageChanged.d.ts

@@ -0,0 +1,20 @@
+import type { SubscriptionEmailContent } from "./subscriptionEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface SubscriptionPackageChangedEmailVars {
+    firstName: string | null;
+    action?: string | null;
+    /** Absolute CTA URL (manage subscription); null/absent → no button. */
+    ctaUrl?: string | null;
+}
+export interface SubscriptionPackageChangedEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createSubscriptionPackageChangedContentFactory(input: {
+    subscriptionEmailContent: Pick<SubscriptionEmailContent, "packageChanged">;
+}): {
+    subscriptionPackageChangedEmailContent: (locale: Locale, vars: SubscriptionPackageChangedEmailVars, signoff: string) => SubscriptionPackageChangedEmailContent;
+};

package/dist/communications/contracts/subscriptionPackageChanged.js

@@ -0,0 +1,26 @@
+import { accentBox, button, heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createSubscriptionPackageChangedContentFactory(input) {
+    const { subscriptionEmailContent } = input;
+    function subscriptionPackageChangedEmailContent(locale, vars, signoff) {
+        const copy = subscriptionEmailContent.packageChanged[locale];
+        const actionLabel = vars.action ? copy.actionLabels[vars.action] ?? null : null;
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(copy.intro(actionLabel)),
+            accentBox(copy.reassurance),
+        ];
+        if (vars.ctaUrl) {
+            blocks.push(button(copy.cta, vars.ctaUrl));
+        }
+        blocks.push(paragraph(copy.outro));
+        blocks.push(paragraph(signoff));
+        return {
+            subject: copy.subject,
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { subscriptionPackageChangedEmailContent };
+}

package/dist/communications/contracts/subscriptionPauseReminder.d.ts

@@ -0,0 +1,23 @@
+import type { SubscriptionEmailContent } from "./subscriptionEmailContent.js";
+import type { Locale } from "./email.js";
+import { type EmailBlock } from "./blocks.js";
+export interface SubscriptionPauseReminderEmailVars {
+    firstName: string | null;
+    /** Consumer-facing brand label injected by the app/composition root. */
+    brandName: string;
+    /** Pre-formatted resume date, or null when unknown. */
+    resumeDateLabel: string | null;
+    /** Absolute CTA URL to manage the subscription. */
+    ctaUrl: string;
+}
+export interface SubscriptionPauseReminderEmailContent {
+    subject: string;
+    preheader: string;
+    blocks: EmailBlock[];
+}
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export declare function createSubscriptionPauseReminderContentFactory(input: {
+    subscriptionEmailContent: Pick<SubscriptionEmailContent, "pauseReminder">;
+}): {
+    subscriptionPauseReminderEmailContent: (locale: Locale, vars: SubscriptionPauseReminderEmailVars, signoff: string) => SubscriptionPauseReminderEmailContent;
+};

package/dist/communications/contracts/subscriptionPauseReminder.js

@@ -0,0 +1,29 @@
+import { accentBox, button, heading, paragraph, } from "./blocks.js";
+/** Bind host-selected copy and pure helpers without provider or environment access. */
+export function createSubscriptionPauseReminderContentFactory(input) {
+    const { subscriptionEmailContent } = input;
+    function subscriptionPauseReminderEmailContent(locale, vars, signoff) {
+        const copy = subscriptionEmailContent.pauseReminder[locale];
+        const resumeDate = vars.resumeDateLabel
+            ? locale === "en"
+                ? ` on ${vars.resumeDateLabel}`
+                : ` ${vars.resumeDateLabel}`
+            : "";
+        const blocks = [
+            heading(copy.heading),
+            paragraph(copy.greeting(vars.firstName)),
+            paragraph(copy.intro(vars.brandName)),
+            paragraph(copy.resume(resumeDate)),
+            accentBox(copy.reassurance),
+            button(copy.cta, vars.ctaUrl),
+            paragraph(copy.outro),
+            paragraph(signoff),
+        ];
+        return {
+            subject: copy.subject,
+            preheader: copy.preheader,
+            blocks,
+        };
+    }
+    return { subscriptionPauseReminderEmailContent };
+}