payload-plugin-newsletter 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [0.23.0] - 2025-08-07
+
+### Added
+- **Complete webhook sync for Broadcast subscribers**: Added support for three new webhook events
+  - `subscriber.created`: Syncs new subscribers created in Broadcast interface to Payload
+  - `subscriber.updated`: Syncs subscriber updates from Broadcast to Payload
+  - `subscriber.deleted`: Removes subscribers from Payload when deleted in Broadcast
+- **Bidirectional sync**: Now provides complete two-way synchronization between Broadcast and Payload
+
+### Changed
+- Enhanced webhook event handling to support all subscriber lifecycle events
+- Improved logging for better webhook debugging
+
 ## [0.22.0] - 2025-08-07
 
 ### Changed

package/dist/server.js

@@ -2442,6 +2442,9 @@ function verifyBroadcastWebhookSignature(payload, signature, timestamp, secret)
 // src/types/webhooks.ts
 var WEBHOOK_EVENT_TYPES = {
   // Subscriber events
+  SUBSCRIBER_CREATED: "subscriber.created",
+  SUBSCRIBER_UPDATED: "subscriber.updated",
+  SUBSCRIBER_DELETED: "subscriber.deleted",
   SUBSCRIBER_SUBSCRIBED: "subscriber.subscribed",
   SUBSCRIBER_UNSUBSCRIBED: "subscriber.unsubscribed",
   // Broadcast events
@@ -2469,6 +2472,15 @@ async function handleSubscriberEvent(event, req, config) {
   const { payload } = req;
   const subscribersSlug = config.subscribersSlug || "subscribers";
   switch (event.type) {
+    case WEBHOOK_EVENT_TYPES.SUBSCRIBER_CREATED:
+      await handleSubscriberCreated(event, payload, subscribersSlug);
+      break;
+    case WEBHOOK_EVENT_TYPES.SUBSCRIBER_UPDATED:
+      await handleSubscriberUpdated(event, payload, subscribersSlug);
+      break;
+    case WEBHOOK_EVENT_TYPES.SUBSCRIBER_DELETED:
+      await handleSubscriberDeleted(event, payload, subscribersSlug);
+      break;
     case WEBHOOK_EVENT_TYPES.SUBSCRIBER_SUBSCRIBED:
       await handleSubscriberSubscribed(event, payload, subscribersSlug);
       break;
@@ -2557,6 +2569,110 @@ async function handleSubscriberUnsubscribed(event, payload, subscribersSlug) {
     throw error;
   }
 }
+async function handleSubscriberCreated(event, payload, subscribersSlug) {
+  const { data } = event;
+  try {
+    const existing = await payload.find({
+      collection: subscribersSlug,
+      where: {
+        email: {
+          equals: data.email
+        }
+      },
+      limit: 1
+    });
+    if (existing.docs.length > 0) {
+      const subscriber = existing.docs[0];
+      await payload.update({
+        collection: subscribersSlug,
+        id: subscriber.id,
+        data: {
+          name: data.name || subscriber.name,
+          externalId: data.id,
+          source: data.source || subscriber.source,
+          // Don't change subscription status on created event
+          ...data.attributes && { attributes: data.attributes }
+        }
+      });
+      console.log("[Subscriber Handler] Updated existing subscriber on created event:", data.email);
+    } else {
+      await payload.create({
+        collection: subscribersSlug,
+        data: {
+          email: data.email,
+          name: data.name,
+          subscriptionStatus: "pending",
+          // New subscribers start as pending
+          externalId: data.id,
+          source: data.source,
+          attributes: data.attributes || {}
+        }
+      });
+      console.log("[Subscriber Handler] Created new subscriber:", data.email);
+    }
+  } catch (error) {
+    console.error("[Subscriber Handler] Error handling created event:", error);
+    throw error;
+  }
+}
+async function handleSubscriberUpdated(event, payload, subscribersSlug) {
+  const { data } = event;
+  try {
+    const existing = await payload.find({
+      collection: subscribersSlug,
+      where: {
+        email: {
+          equals: data.email
+        }
+      },
+      limit: 1
+    });
+    if (existing.docs.length > 0) {
+      const subscriber = existing.docs[0];
+      await payload.update({
+        collection: subscribersSlug,
+        id: subscriber.id,
+        data: {
+          name: data.name || subscriber.name,
+          ...data.attributes && { attributes: data.attributes }
+        }
+      });
+      console.log("[Subscriber Handler] Updated subscriber:", data.email);
+    } else {
+      console.warn("[Subscriber Handler] Subscriber not found for update:", data.email);
+    }
+  } catch (error) {
+    console.error("[Subscriber Handler] Error handling updated event:", error);
+    throw error;
+  }
+}
+async function handleSubscriberDeleted(event, payload, subscribersSlug) {
+  const { data } = event;
+  try {
+    const existing = await payload.find({
+      collection: subscribersSlug,
+      where: {
+        email: {
+          equals: data.email
+        }
+      },
+      limit: 1
+    });
+    if (existing.docs.length > 0) {
+      const subscriber = existing.docs[0];
+      await payload.delete({
+        collection: subscribersSlug,
+        id: subscriber.id
+      });
+      console.log("[Subscriber Handler] Deleted subscriber:", data.email);
+    } else {
+      console.warn("[Subscriber Handler] Subscriber not found for deletion:", data.email);
+    }
+  } catch (error) {
+    console.error("[Subscriber Handler] Error handling deleted event:", error);
+    throw error;
+  }
+}
 
 // src/webhooks/handlers/broadcast.ts
 var STATUS_MAP = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payload-plugin-newsletter",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Complete newsletter management plugin for Payload CMS with subscriber management, magic link authentication, and email service integration",
   "type": "module",
   "main": "./dist/index.js",