payload-plugin-newsletter 0.23.0 → 0.25.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## [0.25.0] - 2025-08-08
+
+### Changed
+- **Improved welcome email behavior**: Plugin now properly handles all subscription scenarios
+  - New signups via frontend: Send welcome email ✓
+  - Resubscriptions via frontend: Send welcome email ✓
+  - Webhook imports (new subscribers): No welcome email ✓
+  - Webhook reactivations: No welcome email ✓
+- **Resubscription support**: Users who resubscribe through the frontend now receive a "Welcome back" email
+- **Better UX**: Welcome emails now check the `importedFromProvider` flag by default
+
+### Fixed
+- Fixed missing welcome emails for user-initiated resubscriptions
+- Fixed unwanted welcome emails for webhook-imported subscribers
+
+## [0.24.0] - 2025-08-08
+
+### Added
+- **Skip welcome email for webhook imports**: Added `importedFromProvider` field to subscribers
+  - Set to `true` for all subscribers created via webhook events
+  - Allows projects to skip welcome emails for bulk imports from Broadcast
+  - Field is read-only in admin UI to prevent accidental changes
+
 ## [0.23.0] - 2025-08-07
 
 ### Added

package/dist/client.d.ts

@@ -12,6 +12,7 @@ interface Subscriber {
         [key: string]: boolean | undefined;
     };
     source?: string;
+    importedFromProvider?: boolean;
     utmParameters?: {
         source?: string;
         medium?: string;

package/dist/collections.cjs

@@ -2967,6 +2967,17 @@ var createSubscribersCollection = (pluginConfig) => {
       admin: {
         description: "Where the subscriber signed up from"
       }
+    },
+    // Import tracking
+    {
+      name: "importedFromProvider",
+      type: "checkbox",
+      defaultValue: false,
+      admin: {
+        description: "Indicates this subscriber was imported from an external provider via webhook",
+        position: "sidebar",
+        readOnly: true
+      }
     }
   ];
   if (pluginConfig.features?.utmTracking?.enabled) {
@@ -3077,7 +3088,7 @@ var createSubscribersCollection = (pluginConfig) => {
             } else {
               console.warn("[Newsletter Plugin] No email service configured for subscriber creation");
             }
-            if (doc.subscriptionStatus === "active" && emailService) {
+            if (doc.subscriptionStatus === "active" && emailService && !doc.importedFromProvider) {
               try {
                 const settings = await req.payload.findGlobal({
                   slug: pluginConfig.settingsSlug || "newsletter-settings"
@@ -3123,6 +3134,30 @@ var createSubscribersCollection = (pluginConfig) => {
                 console.warn("[Newsletter Plugin] No email service configured");
               }
             }
+            if (doc.subscriptionStatus === "active" && previousDoc.subscriptionStatus === "unsubscribed" && !doc.importedFromProvider && emailService) {
+              try {
+                const settings = await req.payload.findGlobal({
+                  slug: pluginConfig.settingsSlug || "newsletter-settings"
+                });
+                const serverURL = req.payload.config.serverURL || process.env.PAYLOAD_PUBLIC_SERVER_URL || "";
+                const html = await renderEmail("welcome", {
+                  email: doc.email,
+                  siteName: settings?.brandSettings?.siteName || "Newsletter",
+                  preferencesUrl: `${serverURL}/account/preferences`
+                }, pluginConfig);
+                await emailService.send({
+                  to: doc.email,
+                  subject: settings?.brandSettings?.siteName ? `Welcome back to ${settings.brandSettings.siteName}!` : "Welcome back!",
+                  html
+                });
+                console.warn(`Welcome email sent to resubscribed user: ${doc.email}`);
+              } catch (error) {
+                console.error("Failed to send resubscription welcome email:", error);
+              }
+              if (pluginConfig.hooks?.afterSubscribe) {
+                await pluginConfig.hooks.afterSubscribe({ doc, req });
+              }
+            }
             if (doc.subscriptionStatus === "unsubscribed" && previousDoc.subscriptionStatus !== "unsubscribed") {
               doc.unsubscribedAt = (/* @__PURE__ */ new Date()).toISOString();
               if (pluginConfig.hooks?.afterUnsubscribe) {