payload-plugin-newsletter 0.13.3 → 0.14.0

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [0.14.0] - 2025-07-22
+
+### Added
+- New authentication configuration options for flexible subscriber management
+  - `auth.allowUnsubscribedSignin`: Allow unsubscribed users to sign in
+  - `auth.allowResubscribe`: Allow unsubscribed users to resubscribe
+- Improved subscribe endpoint behavior:
+  - Already subscribed users now receive a sign-in link instead of an error
+  - Unsubscribed users can resubscribe (when enabled)
+- Enhanced response formats with status indicators:
+  - `requiresSubscribe`: Indicates user needs to subscribe first
+  - `requiresResubscribe`: Indicates user needs to resubscribe
+  - `wasResubscribed`: Indicates user was successfully resubscribed
+  - `alreadySubscribed`: Indicates user is already subscribed
+
+### Changed
+- Sign-in endpoint now returns more detailed error information for better UX
+- Subscribe endpoint handles existing subscribers more gracefully
+
+### Fixed
+- Unsubscribed users can now manage their preferences when `allowUnsubscribedSignin` is enabled
+
 ## [0.13.3] - 2025-07-21
 
 ### Added

package/dist/index.cjs

@@ -1278,6 +1278,44 @@ var createNewsletterSettingsGlobal = (pluginConfig) => {
               }
             ]
           },
+          {
+            label: "Brand Settings",
+            fields: [
+              {
+                name: "brandSettings",
+                type: "group",
+                label: "Brand Settings",
+                fields: [
+                  {
+                    name: "siteName",
+                    type: "text",
+                    label: "Site Name",
+                    required: true,
+                    defaultValue: "Newsletter",
+                    admin: {
+                      description: "Your website or newsletter name"
+                    }
+                  },
+                  {
+                    name: "siteUrl",
+                    type: "text",
+                    label: "Site URL",
+                    admin: {
+                      description: "Your website URL (optional)"
+                    }
+                  },
+                  {
+                    name: "logoUrl",
+                    type: "text",
+                    label: "Logo URL",
+                    admin: {
+                      description: "URL to your logo image (optional)"
+                    }
+                  }
+                ]
+              }
+            ]
+          },
           {
             label: "Email Templates",
             fields: [
@@ -2021,20 +2059,93 @@ var createSubscribeEndpoint = (config) => {
         if (existing.docs.length > 0) {
           const subscriber2 = existing.docs[0];
           if (subscriber2.subscriptionStatus === "unsubscribed") {
+            const allowResubscribe = config.auth?.allowResubscribe ?? false;
+            if (!allowResubscribe) {
+              return Response.json({
+                success: false,
+                error: "This email has been unsubscribed. Please contact support to resubscribe."
+              }, { status: 400 });
+            }
+            const updated = await req.payload.update({
+              collection: config.subscribersSlug || "subscribers",
+              id: subscriber2.id,
+              data: {
+                subscriptionStatus: "active",
+                resubscribedAt: (/* @__PURE__ */ new Date()).toISOString(),
+                // Preserve preferences but update metadata
+                signupMetadata: {
+                  ...metadata,
+                  source: source || "resubscribe",
+                  resubscribedFrom: subscriber2.signupMetadata?.source
+                }
+              },
+              overrideAccess: true
+            });
+            if (config.hooks?.afterSubscribe) {
+              await config.hooks.afterSubscribe({
+                doc: updated,
+                req
+              });
+            }
+            const emailService = req.payload.newsletterEmailService;
+            if (emailService) {
+              const settings2 = await req.payload.findGlobal({
+                slug: config.settingsSlug || "newsletter-settings"
+              });
+              const html = await renderEmail("welcome", {
+                name: updated.name || "",
+                email: updated.email,
+                siteName: settings2?.brandSettings?.siteName || "Newsletter",
+                siteUrl: req.payload.config.serverURL || ""
+              });
+              await emailService.send({
+                to: updated.email,
+                subject: `Welcome back to ${settings2?.brandSettings?.siteName || "our newsletter"}!`,
+                html
+              });
+            }
             return Response.json({
-              success: false,
-              error: "This email has been unsubscribed. Please contact support to resubscribe."
-            }, { status: 400 });
+              success: true,
+              message: "Welcome back! You have been resubscribed.",
+              subscriber: {
+                id: updated.id,
+                email: updated.email,
+                subscriptionStatus: updated.subscriptionStatus
+              },
+              wasResubscribed: true
+            });
           }
-          return Response.json({
-            success: false,
-            error: "Already subscribed",
-            subscriber: {
-              id: subscriber2.id,
-              email: subscriber2.email,
-              subscriptionStatus: subscriber2.subscriptionStatus
+          if (subscriber2.subscriptionStatus === "active") {
+            const token = generateMagicLinkToken(
+              String(subscriber2.id),
+              subscriber2.email,
+              config
+            );
+            const serverURL = req.payload.config.serverURL || process.env.PAYLOAD_PUBLIC_SERVER_URL || "";
+            const magicLinkURL = generateMagicLinkURL(token, serverURL, config);
+            const emailService = req.payload.newsletterEmailService;
+            if (emailService) {
+              const settings2 = await req.payload.findGlobal({
+                slug: config.settingsSlug || "newsletter-settings"
+              });
+              const html = await renderEmail("signin", {
+                magicLink: magicLinkURL,
+                email: subscriber2.email,
+                siteName: settings2?.brandSettings?.siteName || "Newsletter",
+                expiresIn: config.auth?.tokenExpiration || "7d"
+              });
+              await emailService.send({
+                to: subscriber2.email,
+                subject: `Sign in to ${settings2?.brandSettings?.siteName || "your account"}`,
+                html
+              });
             }
-          }, { status: 400 });
+            return Response.json({
+              success: true,
+              message: "You are already subscribed! Check your email for a sign-in link.",
+              alreadySubscribed: true
+            });
+          }
         }
         const ipAddress = req.ip || req.connection?.remoteAddress;
         const maxPerIP = settings?.subscriptionSettings?.maxSubscribersPerIP || 10;
@@ -2575,8 +2686,7 @@ var createSigninEndpoint = (config) => {
         const result = await req.payload.find({
           collection: config.subscribersSlug || "subscribers",
           where: {
-            email: { equals: email.toLowerCase() },
-            subscriptionStatus: { equals: "active" }
+            email: { equals: email.toLowerCase() }
           },
           limit: 1,
           overrideAccess: true
@@ -2585,10 +2695,24 @@ var createSigninEndpoint = (config) => {
         if (result.docs.length === 0) {
           return Response.json({
             success: false,
-            error: "Email not found. Please subscribe first."
+            error: "Email not found. Please subscribe first.",
+            requiresSubscribe: true
           }, { status: 404 });
         }
         const subscriber = result.docs[0];
+        const allowUnsubscribed = config.auth?.allowUnsubscribedSignin ?? false;
+        if (subscriber.subscriptionStatus === "unsubscribed" && !allowUnsubscribed) {
+          return Response.json({
+            success: false,
+            error: "Your subscription is inactive. Please resubscribe to sign in.",
+            subscriber: {
+              id: subscriber.id,
+              email: subscriber.email,
+              subscriptionStatus: subscriber.subscriptionStatus
+            },
+            requiresResubscribe: true
+          }, { status: 403 });
+        }
         const token = generateMagicLinkToken(
           String(subscriber.id),
           subscriber.email,