add batch email api (#149)

* add bulk email * add bulk email api * add batch email sdk changes
2025-04-19 21:45:17 +10:00
parent 44e4f43e66
commit 3fe96b477f
10 changed files with 724 additions and 49 deletions
@@ -0,0 +1,40 @@
+import { z } from "@hono/zod-openapi";
+
+/**
+ * Reusable Zod schema for a single email payload used in public API requests.
+ */
+export const emailSchema = z
+  .object({
+    to: z.string().email().or(z.array(z.string().email())),
+    from: z.string().email(),
+    subject: z.string().min(1).optional().openapi({
+      description: "Optional when templateId is provided",
+    }),
+    templateId: z.string().optional().openapi({
+      description: "ID of a template from the dashboard",
+    }),
+    variables: z.record(z.string()).optional(),
+    replyTo: z.string().email().or(z.array(z.string().email())).optional(),
+    cc: z.string().email().or(z.array(z.string().email())).optional(),
+    bcc: z.string().email().or(z.array(z.string().email())).optional(),
+    text: z.string().min(1).optional().nullable(),
+    html: z.string().min(1).optional().nullable(),
+    attachments: z
+      .array(
+        z.object({
+          filename: z.string().min(1),
+          content: z.string().min(1), // Consider base64 validation if needed
+        })
+      )
+      .max(10) // Limit attachments array size if desired
+      .optional(),
+    scheduledAt: z.string().datetime({ offset: true }).optional(), // Ensure ISO 8601 format with offset
+  })
+  .refine(
+    (data) => !!data.subject || !!data.templateId,
+    "Either subject or templateId must be provided."
+  )
+  .refine(
+    (data) => !!data.text || !!data.html,
+    "Either text or html content must be provided."
+  );