Plunk

# Required
PLUNK_API_KEY=sk_your_plunk_api_key_here

# Optional - explicitly set Plunk as provider
EMAIL_PROVIDER=plunk

# Email defaults
DEFAULT_FROM_EMAIL=noreply@yourdomain.com
DEFAULT_FROM_NAME=Your App Name

// package.json (already installed)
"@plunk/node": "^3.0.3"

bun add @plunk/node

import { sendEmail, getActiveProviderName } from '@/lib/messaging/email';

// Verify Plunk is active
console.log('Active provider:', getActiveProviderName()); // Should output: 'plunk'

// Send test email
const result = await sendEmail({
  to: 'test@example.com',
  subject: 'Test from ShipFree via Plunk',
  html: '<h1>Success!</h1><p>Plunk is working correctly.</p>',
});

if (result.success) {
  console.log('Email sent via Plunk!', result.data);
} else {
  console.error('Failed:', result.message);
}

import { sendEmail } from '@/lib/messaging/email';

await sendEmail({
  to: 'user@example.com',
  subject: 'Welcome to ShipFree',
  html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
});

await sendEmail({
  to: ['user1@example.com', 'user2@example.com'],
  subject: 'Team Update',
  html: '<p>Important team announcement...</p>',
});

await sendEmail({
  to: 'user@example.com',
  subject: 'Newsletter',
  html: '<h1>Monthly Update</h1><p>Check out what\'s new...</p>',
  text: 'Monthly Update\n\nCheck out what\'s new...', // Used as fallback
});

import { sendBatchEmails } from '@/lib/messaging/email';

// These will be sent sequentially
await sendBatchEmails({
  emails: [
    { to: 'user1@example.com', subject: 'Hi', html: '<p>Hello</p>' },
    { to: 'user2@example.com', subject: 'Hi', html: '<p>Hello</p>' },
    // ... more emails
  ],
});

# .env.development
PLUNK_API_KEY=sk_your_test_api_key
DEFAULT_FROM_EMAIL=dev@plunk.dev
DEFAULT_FROM_NAME=ShipFree Dev

# .env.production
PLUNK_API_KEY=sk_your_production_api_key
DEFAULT_FROM_EMAIL=noreply@yourdomain.com
DEFAULT_FROM_NAME=Your App Name

src/lib/messaging/email/providers/plunk.ts