Hello from the contact form!
',\r\n });\r\n \r\n alert('Message sent successfully!');\r\n } catch (err) {\r\n console.error('Failed to send message:', err);\r\n alert('Failed to send message. Please try again.');\r\n }\r\n };\r\n \r\n return (\r\n \r\n );\r\n}\r\n```\r\n\r\n## CLI Setup\r\n\r\nFor a quick setup, use the included CLI:\r\n\r\n```bash\r\nnpx @api-buddy/sendgrid\r\n```\r\n\r\nThis will:\r\n1. Install required dependencies\r\n2. Create an API route for sending emails\r\n3. Generate a custom `useEmail` hook\r\n4. Set up an example contact form component\r\n5. Update your environment variables\r\n\r\n## API Reference\r\n\r\n### `SendGridProvider`\r\n\r\nA context provider that makes the SendGrid client available throughout your application.\r\n\r\n#### Props\r\n\r\n- `config`: Configuration object\r\n - `apiKey`: Your SendGrid API key (optional, defaults to `process.env.SENDGRID_API_KEY`)\r\n - `defaultFrom`: Default \"from\" email address\r\n - `defaultReplyTo`: Default \"reply to\" email address\r\n - `mailSettings`: Default mail settings for all emails\r\n - `trackingSettings`: Default tracking settings for all emails\r\n - `asm`: Default ASM (Advanced Suppression Manager) settings\r\n - `ipPoolName`: Default IP pool name\r\n\r\n### `useSendGrid()`\r\n\r\nA hook to access the SendGrid client and config from the nearest `SendGridProvider`.\r\n\r\n#### Returns\r\n\r\n- `client`: The SendGrid client instance\r\n- `config`: The current SendGrid configuration\r\n\r\n### `sendEmail(options: EmailOptions): PromiseThis is a test email
',\r\n});\r\n```\r\n\r\n### Using Dynamic Templates\r\n\r\n```typescript\r\nawait sendEmail({\r\n to: 'recipient@example.com',\r\n from: 'sender@example.com',\r\n templateId: 'd-1234567890abcdef1234567890abcdef',\r\n dynamicTemplateData: {\r\n name: 'John Doe',\r\n verificationLink: 'https://example.com/verify?token=abc123',\r\n },\r\n});\r\n```\r\n\r\n### Sending to Multiple Recipients\r\n\r\n```typescript\r\nawait sendEmail({\r\n to: ['user1@example.com', 'user2@example.com'],\r\n from: 'sender@example.com',\r\n subject: 'Hello everyone!',\r\n text: 'This email is sent to multiple recipients',\r\n});\r\n```\r\n\r\n## Error Handling\r\n\r\nAll email sending methods throw a `SendGridApiError` when something goes wrong. You can catch and handle these errors:\r\n\r\n```typescript\r\ntry {\r\n await sendEmail({\r\n // ...\r\n });\r\n} catch (error) {\r\n if (error.isRateLimit) {\r\n console.error('Rate limit exceeded:', error.message);\r\n } else if (error.isAuthError) {\r\n console.error('Authentication error:', error.message);\r\n } else {\r\n console.error('Error sending email:', error.message);\r\n }\r\n}\r\n```\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please open an issue or submit a pull request.\r\n\r\n## License\r\n\r\nMIT\r\n\r\n## Acknowledgments\r\n\r\n- [SendGrid](https://sendgrid.com/) - Email delivery service\r\n- [@sendgrid/mail](https://www.npmjs.com/package/@sendgrid/mail) - Official SendGrid Node.js library\r\n","readmeFilename":"README.md"}