@parsrun/email 0.1.0

package/README.md

@@ -0,0 +1,145 @@
+# @parsrun/email
+
+Edge-compatible email sending for Pars with multiple provider support.
+
+## Features
+
+- **Multi-Provider**: Resend, SendGrid, Postmark
+- **Edge-Compatible**: Works on Cloudflare Workers, Deno
+- **Templates**: Built-in email templates
+- **Queue Support**: Async email sending
+
+## Installation
+
+```bash
+pnpm add @parsrun/email
+```
+
+## Quick Start
+
+```typescript
+import { createEmailService } from '@parsrun/email';
+
+const email = createEmailService({
+  provider: 'resend',
+  apiKey: process.env.RESEND_API_KEY,
+  from: 'noreply@example.com',
+});
+
+await email.send({
+  to: 'user@example.com',
+  subject: 'Welcome!',
+  html: '<h1>Hello World</h1>',
+});
+```
+
+## API Overview
+
+### Providers
+
+#### Resend
+
+```typescript
+import { createResendProvider } from '@parsrun/email/providers/resend';
+
+const provider = createResendProvider({
+  apiKey: process.env.RESEND_API_KEY,
+});
+```
+
+#### SendGrid
+
+```typescript
+import { createSendGridProvider } from '@parsrun/email/providers/sendgrid';
+
+const provider = createSendGridProvider({
+  apiKey: process.env.SENDGRID_API_KEY,
+});
+```
+
+#### Postmark
+
+```typescript
+import { createPostmarkProvider } from '@parsrun/email/providers/postmark';
+
+const provider = createPostmarkProvider({
+  serverToken: process.env.POSTMARK_SERVER_TOKEN,
+});
+```
+
+#### Console (Development)
+
+```typescript
+import { createConsoleProvider } from '@parsrun/email/providers/console';
+
+const provider = createConsoleProvider(); // Logs emails to console
+```
+
+### Email Service
+
+```typescript
+const email = createEmailService({
+  provider: resendProvider,
+  from: 'noreply@example.com',
+  replyTo: 'support@example.com',
+});
+
+// Send simple email
+await email.send({
+  to: 'user@example.com',
+  subject: 'Hello',
+  html: '<p>Hello World</p>',
+  text: 'Hello World',
+});
+
+// Send with attachments
+await email.send({
+  to: 'user@example.com',
+  subject: 'Report',
+  html: '<p>See attached</p>',
+  attachments: [
+    {
+      filename: 'report.pdf',
+      content: pdfBuffer,
+    },
+  ],
+});
+```
+
+### Templates
+
+```typescript
+import { templates } from '@parsrun/email/templates';
+
+// OTP Email
+const html = templates.otp({
+  code: '123456',
+  expiresIn: '10 minutes',
+});
+
+// Welcome Email
+const html = templates.welcome({
+  name: 'John',
+  appName: 'MyApp',
+});
+
+// Magic Link
+const html = templates.magicLink({
+  url: 'https://app.example.com/verify?token=...',
+  expiresIn: '15 minutes',
+});
+```
+
+## Exports
+
+```typescript
+import { ... } from '@parsrun/email';                  // Main exports
+import { ... } from '@parsrun/email/providers/resend';   // Resend
+import { ... } from '@parsrun/email/providers/sendgrid'; // SendGrid
+import { ... } from '@parsrun/email/providers/postmark'; // Postmark
+import { ... } from '@parsrun/email/templates';          // Email templates
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+import { EmailServiceConfig, EmailProviderType, EmailOptions, EmailResult, BatchEmailOptions, BatchEmailResult, EmailProviderConfig, EmailProvider } from './types.js';
+export { EmailAddress, EmailAttachment, EmailError, EmailErrorCodes, EmailTemplate, TemplateData } from './types.js';
+export { ResendProvider, createResendProvider } from './providers/resend.js';
+export { SendGridProvider, createSendGridProvider } from './providers/sendgrid.js';
+export { PostmarkProvider, createPostmarkProvider } from './providers/postmark.js';
+export { ConsoleProvider, createConsoleProvider } from './providers/console.js';
+export { InvitationTemplateData, MagicLinkTemplateData, OTPTemplateData, PasswordResetTemplateData, VerificationTemplateData, WelcomeTemplateData, invitationTemplate, magicLinkTemplate, otpTemplate, passwordResetTemplate, renderFunctions, renderInvitationEmail, renderMagicLinkEmail, renderOTPEmail, renderPasswordResetEmail, renderTemplate, renderVerificationEmail, renderWelcomeEmail, templates, verificationTemplate, welcomeTemplate, wrapEmailHtml } from './templates/index.js';
+export { EmailConfig, EmailSendResult, EmailAddress as ParsEmailAddress, EmailAttachment as ParsEmailAttachment, PostmarkConfig, ResendConfig, SendEmailOptions, SendTemplateEmailOptions, SendgridConfig, SesConfig, SmtpConfig, emailAddress, emailAttachment, emailConfig, emailSendResult, postmarkConfig, resendConfig, sendEmailOptions, sendTemplateEmailOptions, sendgridConfig, sesConfig, smtpConfig, type } from '@parsrun/types';
+
+/**
+ * @parsrun/email
+ * Edge-compatible email sending for Pars
+ *
+ * Supports multiple providers:
+ * - Resend (recommended)
+ * - SendGrid
+ * - Postmark
+ * - Console (development)
+ *
+ * @example
+ * ```typescript
+ * import { createEmailService } from '@parsrun/email';
+ *
+ * const email = createEmailService({
+ *   provider: 'resend',
+ *   apiKey: process.env.RESEND_API_KEY,
+ *   fromEmail: 'hello@example.com',
+ *   fromName: 'My App',
+ * });
+ *
+ * await email.send({
+ *   to: 'user@example.com',
+ *   subject: 'Hello',
+ *   html: '<p>Hello World!</p>',
+ * });
+ * ```
+ */
+
+/**
+ * Email Service
+ * High-level email service with provider abstraction
+ */
+declare class EmailService {
+    private provider;
+    private debug;
+    constructor(config: EmailServiceConfig);
+    private createProvider;
+    /**
+     * Get the provider type
+     */
+    get providerType(): EmailProviderType;
+    /**
+     * Send a single email
+     */
+    send(options: EmailOptions): Promise<EmailResult>;
+    /**
+     * Send multiple emails
+     */
+    sendBatch(options: BatchEmailOptions): Promise<BatchEmailResult>;
+    /**
+     * Verify provider configuration
+     */
+    verify(): Promise<boolean>;
+}
+/**
+ * Create an email service
+ *
+ * @example
+ * ```typescript
+ * // With Resend
+ * const email = createEmailService({
+ *   provider: 'resend',
+ *   apiKey: process.env.RESEND_API_KEY,
+ *   fromEmail: 'hello@example.com',
+ * });
+ *
+ * // With SendGrid
+ * const email = createEmailService({
+ *   provider: 'sendgrid',
+ *   apiKey: process.env.SENDGRID_API_KEY,
+ *   fromEmail: 'hello@example.com',
+ * });
+ *
+ * // For development
+ * const email = createEmailService({
+ *   provider: 'console',
+ *   apiKey: 'not-needed',
+ *   fromEmail: 'test@example.com',
+ * });
+ * ```
+ */
+declare function createEmailService(config: EmailServiceConfig): EmailService;
+/**
+ * Create an email provider directly
+ */
+declare function createEmailProvider(type: EmailProviderType, config: EmailProviderConfig): EmailProvider;
+declare const _default: {
+    EmailService: typeof EmailService;
+    createEmailService: typeof createEmailService;
+    createEmailProvider: typeof createEmailProvider;
+};
+
+export { BatchEmailOptions, BatchEmailResult, EmailOptions, EmailProvider, EmailProviderConfig, EmailProviderType, EmailResult, EmailService, EmailServiceConfig, createEmailProvider, createEmailService, _default as default };