payload-plugin-newsletter 0.9.2 → 0.10.0

package/CHANGELOG.md

@@ -1,3 +1,46 @@
+## [0.10.0] - 2025-07-20
+
+### Changed
+- **BREAKING**: Simplified plugin architecture to single-channel design
+  - Removed Channels collection entirely 
+  - Each Payload instance now connects to a single Broadcast channel
+  - Channel is determined by the API token (Broadcast tokens are channel-specific)
+  - Removed `channelId` field from Broadcast type
+  - Removed channel management methods from providers
+- Updated newsletter management configuration
+  - Removed `collections.channels` from plugin config
+  - Broadcasts no longer have channel relationships
+  - All broadcasts use the global provider configuration
+- Improved provider capabilities
+  - Set `supportsMultipleChannels` to `false` for all providers
+  - Removed channel-specific error codes (`CHANNEL_NOT_FOUND`, `INVALID_CHANNEL`)
+
+### Added
+- Comprehensive documentation for single-channel architecture (`docs/guides/single-channel-broadcast.md`)
+- Clear migration path from multi-channel to single-channel design
+
+### Removed
+- Channels collection (`src/collections/Channels.ts`)
+- Channel utility functions (`src/providers/utils/getChannelProvider.ts`)
+- Channel type definitions (`src/types/channel.ts`)
+- Channel imports and references throughout the codebase
+
+## [0.9.3] - 2025-07-20
+
+### Changed
+- Simplified Broadcast provider configuration to use a single token instead of separate development/production tokens
+  - Changed `tokens: { production, development }` to `token` field
+  - Users should now manage different tokens via environment variables
+- Improved settings configuration hierarchy
+  - Settings from Payload admin UI now properly override config defaults
+  - Added support for configuring `fromAddress`, `fromName`, and `replyTo` in admin UI
+- Enhanced reply-to email handling
+  - Broadcast provider now supports fallback chain: request → settings → from address
+  - Added `replyTo` field support to match Broadcast API capabilities
+
+### Fixed
+- Fixed Broadcast provider tests to match new single token configuration
+
 ## [0.9.2] - 2025-07-20
 
 ### Fixed

package/README.md

@@ -587,17 +587,18 @@ providers: {
 providers: {
   default: 'broadcast',
   broadcast: {
-    apiUrl: 'https://broadcast.yoursite.com',
-    tokens: {
-      production: process.env.BROADCAST_TOKEN,
-      development: process.env.BROADCAST_DEV_TOKEN,
-    },
+    apiUrl: process.env.BROADCAST_API_URL,
+    token: process.env.BROADCAST_TOKEN,
+    // Optional: These can be set here as defaults or configured in the admin UI
     fromAddress: 'hello@yoursite.com',
     fromName: 'Your Newsletter',
+    replyTo: 'replies@yoursite.com',
   },
 }
 ```
 
+**Note**: Settings configured in the Payload admin UI take precedence over these config values. The config values serve as defaults when settings haven't been configured yet.
+
 ## TypeScript
 
 The plugin is fully typed. Import types as needed:

package/dist/components.cjs

@@ -1210,7 +1210,6 @@ var EmailPreview = ({
   content,
   subject,
   preheader,
-  channel,
   mode = "desktop",
   onValidation
 }) => {
@@ -1233,7 +1232,7 @@ var EmailPreview = ({
         const personalizedHtml = replacePersonalizationTags(emailHtml, SAMPLE_DATA);
         const previewHtml = addEmailHeader(personalizedHtml, {
           subject,
-          from: channel ? `${channel.fromName} <${channel.fromEmail}>` : "Newsletter <noreply@example.com>",
+          from: "Newsletter <noreply@example.com>",
           to: SAMPLE_DATA["subscriber.email"]
         });
         setHtml(previewHtml);
@@ -1248,7 +1247,7 @@ var EmailPreview = ({
       }
     };
     convertContent();
-  }, [content, subject, preheader, channel, onValidation]);
+  }, [content, subject, preheader, onValidation]);
   (0, import_react5.useEffect)(() => {
     if (iframeRef.current && html) {
       const doc = iframeRef.current.contentDocument;
@@ -1485,7 +1484,6 @@ var EmailPreviewField = () => {
         content: fields.content?.value || null,
         subject: fields.subject?.value || "Email Subject",
         preheader: fields.preheader?.value,
-        channel: fields.channel?.value,
         mode: previewMode,
         onValidation: handleValidation
       }
@@ -1505,8 +1503,7 @@ var BroadcastEditor = (props) => {
   const [validationSummary, setValidationSummary] = (0, import_react7.useState)("");
   const fields = (0, import_ui2.useFormFields)(([fields2]) => ({
     subject: fields2.subject,
-    preheader: fields2.preheader,
-    channel: fields2.channel
+    preheader: fields2.preheader
   }));
   const handleValidation = (0, import_react7.useCallback)((result) => {
     setIsValid(result.valid);
@@ -1644,7 +1641,6 @@ var BroadcastEditor = (props) => {
           content: value,
           subject: fields.subject?.value || "Email Subject",
           preheader: fields.preheader?.value,
-          channel: fields.channel?.value,
           mode: previewMode,
           onValidation: handleValidation
         }