payload-plugin-newsletter 0.13.0 → 0.13.1

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## [0.13.1] - 2025-07-21
+
+### Fixed
+- Fixed Broadcast API subscriber update method to match API documentation
+- Added comprehensive debug logging for email service initialization and subscriber sync
+- Improved error handling in subscriber hooks to surface sync issues
+
+### Added
+- Debug logging for troubleshooting subscriber sync with email providers
+- Better error messages when email service configuration fails
+
 ## [0.13.0] - 2025-07-21
 
 ### Changed

package/CLAUDE.md

@@ -72,7 +72,7 @@ Use these resources for understanding patterns and best practices:
 
 1. **Plugin Documentation**:
    - Check `docs/` directory for comprehensive plugin documentation
-   - `docs/references/broadcast-docs-compiled.md` - Complete Broadcast API reference (sendbroadcast.net)
+   - `docs/references/broadcast-api-docs.md` - Complete Broadcast API reference (sendbroadcast.net)
    - `docs/guides/email-providers.md` - Email provider setup and comparison
    - `docs/development/context7-setup.md` - How to set up context7 MCP for current docs
    - `docs/architecture/` - Plugin architecture and design decisions

package/dist/index.cjs

@@ -1046,11 +1046,19 @@ var createSubscribersCollection = (pluginConfig) => {
         async ({ doc, req, operation, previousDoc }) => {
           if (operation === "create") {
             const emailService = req.payload.newsletterEmailService;
+            console.log("[Newsletter Plugin] Creating subscriber:", {
+              email: doc.email,
+              hasEmailService: !!emailService
+            });
             if (emailService) {
               try {
                 await emailService.addContact(doc);
-              } catch {
+                console.log("[Newsletter Plugin] Successfully added contact to email service");
+              } catch (error) {
+                console.error("[Newsletter Plugin] Failed to add contact to email service:", error);
               }
+            } else {
+              console.warn("[Newsletter Plugin] No email service configured for subscriber creation");
             }
             if (doc.subscriptionStatus === "active" && emailService) {
               try {
@@ -1080,10 +1088,22 @@ var createSubscribersCollection = (pluginConfig) => {
           }
           if (operation === "update" && previousDoc) {
             const emailService = req.payload.newsletterEmailService;
-            if (doc.subscriptionStatus !== previousDoc.subscriptionStatus && emailService) {
-              try {
-                await emailService.updateContact(doc);
-              } catch {
+            if (doc.subscriptionStatus !== previousDoc.subscriptionStatus) {
+              console.log("[Newsletter Plugin] Subscription status changed:", {
+                email: doc.email,
+                from: previousDoc.subscriptionStatus,
+                to: doc.subscriptionStatus,
+                hasEmailService: !!emailService
+              });
+              if (emailService) {
+                try {
+                  await emailService.updateContact(doc);
+                  console.log("[Newsletter Plugin] Successfully updated contact in email service");
+                } catch (error) {
+                  console.error("[Newsletter Plugin] Failed to update contact in email service:", error);
+                }
+              } else {
+                console.warn("[Newsletter Plugin] No email service configured");
               }
             }
             if (doc.subscriptionStatus === "unsubscribed" && previousDoc.subscriptionStatus !== "unsubscribed") {
@@ -1654,6 +1674,7 @@ var BroadcastProvider = class {
         },
         body: JSON.stringify({
           email: contact.email,
+          // Email at root level to identify the subscriber
           subscriber: {
             first_name: firstName || void 0,
             last_name: lastName || void 0,
@@ -4489,6 +4510,12 @@ var newsletterPlugin = (pluginConfig) => (incomingConfig) => {
         const settings = await payload.findGlobal({
           slug: config.settingsSlug || "newsletter-settings"
         });
+        console.log("[Newsletter Plugin] Initializing with settings:", {
+          hasSettings: !!settings,
+          settingsProvider: settings?.provider,
+          configProvider: config.providers?.default,
+          hasBroadcastConfig: !!config.providers?.broadcast
+        });
         let emailServiceConfig;
         if (settings) {
           emailServiceConfig = {
@@ -4523,8 +4550,24 @@ var newsletterPlugin = (pluginConfig) => (incomingConfig) => {
             broadcast: config.providers.broadcast
           };
         }
-        payload.newsletterEmailService = createEmailService(emailServiceConfig);
-        console.warn("Newsletter plugin initialized with", payload.newsletterEmailService.getProvider(), "provider");
+        console.log("[Newsletter Plugin] Email service config:", {
+          provider: emailServiceConfig.provider,
+          hasBroadcastConfig: !!emailServiceConfig.broadcast,
+          broadcastUrl: emailServiceConfig.broadcast?.apiUrl,
+          hasToken: !!emailServiceConfig.broadcast?.token
+        });
+        try {
+          const emailService = createEmailService(emailServiceConfig);
+          payload.newsletterEmailService = emailService;
+          console.log("[Newsletter Plugin] Email service initialized:", {
+            provider: emailService.getProvider(),
+            hasProvider: !!emailService,
+            payloadHasService: !!payload.newsletterEmailService
+          });
+        } catch (emailServiceError) {
+          console.error("[Newsletter Plugin] Failed to create email service:", emailServiceError);
+          console.error("[Newsletter Plugin] Email service config was:", emailServiceConfig);
+        }
         if (config.features?.newsletterManagement?.enabled) {
           try {
             let broadcastProvider;