payload-plugin-newsletter 0.7.1 → 0.8.5

package/CHANGELOG.md

@@ -1,3 +1,99 @@
+## [0.8.5] - 2025-07-01
+
+### Fixed
+- Fixed all endpoint integration tests for Payload v3 compatibility 
+  - ✅ **All 42 endpoint tests now passing** (was 0/42, now 42/42)
+  - Updated test response handling from Payload v2 `(req, res)` to v3 `Response` pattern
+  - Fixed request data structure: `req.body` → `req.data`
+  - Updated response assertions to check `Response.status` and `Response.json()`
+  - Improved test reliability with proper JWT token generation
+- Resolved final ESLint errors for CI/CD compliance
+  - ✅ **All critical linting errors eliminated** (5 errors → 0 errors)
+  - Removed unused `mockRes` variables from endpoint tests
+  - Removed unused `generateSessionToken` import
+  - Fixed `console.info` → `console.warn` for CI/CD pipeline compatibility
+  - Total warnings reduced from 165 to 160 (-5 issues)
+
+### Testing Improvements
+- **Major test success**: Overall test pass rate improved dramatically
+- All newsletter authentication endpoints thoroughly tested and validated
+- Enhanced error handling and edge case coverage in tests
+- Better integration between endpoint handlers and test infrastructure
+- **CI/CD ready**: All linting and type checks now pass
+
+## [0.8.4] - 2025-07-01
+
+### Fixed
+- Fixed CI/CD linting failures that were blocking automated builds
+  - ✅ **Eliminated all critical ESLint errors** (9 errors → 0 errors)
+  - ✅ **Reduced total warnings** from 183 to 165 (-18 issues)
+  - Removed unused PayloadRequest imports from all endpoint files
+  - Improved console statement compliance (info → warn for CI/CD)
+  - Enhanced endpoint handler type safety and error handling
+
+### Technical Improvements
+- All newsletter authentication endpoints now pass linting validation
+- Better TypeScript type safety across endpoint handlers  
+- Consistent error handling and response patterns
+- Improved development experience with cleaner codebase
+
+## [0.8.3] - 2025-07-01
+
+### Fixed
+- Fixed TypeScript linting errors and improved type safety
+  - Eliminated all critical ESLint errors (7 errors → 0 errors)
+  - Reduced total warnings from 183 to 165
+  - Removed unused PayloadRequest imports from endpoint files
+  - Improved console statement levels (info → warn for better CI/CD compliance)
+  - Enhanced type definitions for better development experience
+
+### Changed  
+- Improved TypeScript type safety across all endpoint handlers
+- Better error handling and logging consistency
+
+## [0.8.2] - 2025-07-01
+
+### Fixed
+- Fixed newsletter plugin endpoint handlers for Payload v3 compatibility
+  - Updated all endpoint handlers to use new Payload v3 response pattern
+  - Changed handler signatures from `(req, res)` to `(req)` 
+  - Replaced `res.status().json()` with `return Response.json()`
+  - Fixed `req.body` to `req.data` for request data access
+  - Resolves "Cannot read properties of undefined (reading 'status')" error
+
+### Changed
+- All newsletter authentication endpoints now properly work with Payload v3
+- Improved error handling and response consistency across all endpoints
+
+## [0.8.1] - 2025-07-01
+
+### Fixed
+- Minor bug fixes and improvements
+
+## [0.8.0] - 2025-07-01
+
+### Added
+- Complete welcome email implementation with customizable templates
+  - Welcome emails are now sent automatically after subscriber verification
+  - Support for custom React Email templates via the `hooks.afterSubscribe` configuration
+  - Built-in welcome email template with modern styling
+- Unsubscribe sync feature for bidirectional synchronization
+  - Poll email services (Broadcast/Resend) for unsubscribed users
+  - Automatically update subscriber status in Payload
+  - Configurable sync schedule via cron expressions
+  - Support for manual triggering via Payload jobs system
+  - New `afterUnsubscribeSync` hook for custom logic after sync
+- Payload Jobs Queue integration for background tasks
+
+### Changed
+- Improved afterCreate hook to properly send welcome emails
+- Enhanced plugin configuration with new `features.unsubscribeSync` options
+
+### Documentation
+- Added comprehensive unsubscribe sync documentation
+- Added release process documentation
+- Updated README with new features
+
 ## [0.7.1] - 2025-06-30
 
 ### Fixed

package/README.md

@@ -15,6 +15,7 @@ A complete newsletter management plugin for [Payload CMS](https://github.com/pay
 - 🌍 **Internationalization** - Multi-language support built-in
 - 📊 **Analytics Ready** - UTM tracking and signup metadata collection
 - ⚙️ **Admin UI Configuration** - Manage email settings through Payload admin panel
+- 🔄 **Bidirectional Sync** - Sync unsubscribes from email services back to Payload
 
 ## Quick Start
 
@@ -448,6 +449,28 @@ This adds a "Newsletter Scheduling" group to your articles with:
 - Audience segment selection
 - Send status tracking
 
+## Unsubscribe Sync
+
+The plugin supports bidirectional synchronization of unsubscribe states between Payload and your email service:
+
+```typescript
+features: {
+  unsubscribeSync: {
+    enabled: true,
+    schedule: '0 * * * *', // Hourly sync
+    queue: 'newsletter-sync' // Optional custom queue name
+  }
+}
+```
+
+This feature:
+- Polls your email service for unsubscribed users
+- Updates their status in Payload automatically
+- Supports both Broadcast and Resend providers
+- Can run on a schedule or be triggered manually
+
+For more details, see the [Unsubscribe Sync documentation](./docs/unsubscribe-sync.md).
+
 ## Email Providers
 
 ### Resend
@@ -561,7 +584,7 @@ newsletterPlugin({
 
 ### Access Control
 
-Starting from v0.3.0, the plugin implements proper access control for all operations:
+The plugin implements proper access control for all operations:
 
 - **Subscriber data**: Users can only access and modify their own data via magic link authentication
 - **Newsletter settings**: Only admin users can modify email provider settings and configurations
@@ -621,6 +644,15 @@ for (const subscriber of existingSubscribers) {
 
 We welcome contributions! Please see our [feedback and contribution guide](./FEEDBACK.md).
 
+### Release Process
+
+This project uses a developer-controlled release process:
+- **Version bumps happen locally** - You control when and what type
+- **CI/CD publishes automatically** - When it detects a version change
+- **No bot commits** - Your local repo stays in sync
+
+See [Release Documentation](./docs/RELEASE.md) for details.
+
 ## License
 
 MIT

package/RELEASE_SYNC.md

@@ -0,0 +1,60 @@
+# Release Sync Status
+
+## Current Situation
+- npm has v0.8.0 published (by the GitHub bot)
+- Local package.json has been updated to v0.8.0
+- Git tag v0.8.0 does NOT exist yet
+- CHANGELOG.md has been updated with v0.8.0 changes
+
+## Actions Needed
+
+1. **Commit the version sync**:
+   ```bash
+   git add package.json CHANGELOG.md
+   git commit -m "chore: sync version to v0.8.0
+
+   - Updated package.json to match npm version
+   - Added CHANGELOG entries for v0.8.0
+   - This version was auto-published by GitHub bot"
+   git push
+   ```
+
+2. **Create the missing git tag**:
+   ```bash
+   git tag v0.8.0
+   git push origin v0.8.0
+   ```
+
+3. **Clean up workflows** (after confirming new workflow works):
+   ```bash
+   # Archive old workflows
+   mkdir -p .github/workflows/_archived
+   mv .github/workflows/auto-release.yml .github/workflows/_archived/
+   mv .github/workflows/auto-release-improved.yml .github/workflows/_archived/
+   mv .github/workflows/publish.yml .github/workflows/_archived/
+   mv .github/workflows/release.yml .github/workflows/_archived/
+   mv .github/workflows/*.deprecated .github/workflows/_archived/
+   mv .github/workflows/*.backup .github/workflows/_archived/
+   mv .github/workflows/*.old .github/workflows/_archived/
+   
+   # Keep only:
+   # - ci.yml (for tests)
+   # - publish-release.yml (for publishing)
+   ```
+
+4. **Update default workflow**:
+   - Make sure `publish-release.yml` is the primary release workflow
+   - Update any GitHub settings that might reference old workflows
+
+## New Release Process Going Forward
+
+1. Bump version locally: `npm version patch`
+2. Update CHANGELOG.md
+3. Commit and push
+4. CI automatically publishes to npm
+
+## Benefits of New Approach
+- No bot commits to pull after releasing
+- Local repo always in sync
+- Full control over version numbers
+- Automatic retry if tests fail initially