[Email Worker] Update type (#22204)

harshil1712 · ToriLindsay · kodster28 · daisyfaithauma · commit 0de20f69d8a3 · 2025-05-07T14:01:53.000+03:00
* update types and add note for service worker

* Update src/content/docs/email-routing/email-workers/runtime-api.mdx

* Retrigger CI

---------

Co-authored-by: ToriLindsay &lt;tgalatro@cloudflare.com&gt;
Co-authored-by: Kody Jackson &lt;kody@cloudflare.com&gt;
diff --git a/src/content/docs/email-routing/email-workers/runtime-api.mdx b/src/content/docs/email-routing/email-workers/runtime-api.mdx
@@ -10,28 +10,6 @@ sidebar:
 
 An `EmailEvent` is the event type to programmatically process your emails with a Worker. You can reject, forward, or drop emails according to the logic you construct in your Worker.
 
-***
-
-## Syntax: Service Worker
-
-`EmailEvent` can be handled in Workers functions written using the Service Worker syntax by attaching to the `email` event with `addEventListener`:
-
-```js
-addEventListener("email", async (event) => {
-  await event.message.forward("<YOUR_EMAIL>");
-});
-```
-
-### Properties
-
-
-
-* `event.message` EmailMessage
-
-  * An [`EmailMessage` object](#emailmessage-definition).
-
-
-
 ***
 
 ## Syntax: ES modules
@@ -50,9 +28,9 @@ export default {
 
 
 
-* `message` EmailMessage
+* `message` ForwardableEmailMessage
 
-  * An [`EmailMessage` object](#emailmessage-definition).
+  * A [`ForwardableEmailMessage` object](#forwardableemailmessage-definition).
 
 * `env` object
 
@@ -65,10 +43,38 @@ export default {
 
 ***
 
-## `EmailMessage` definition
+## Syntax: Service Worker
+
+:::caution[Service Workers are deprecated]
+
+Service Workers are deprecated but still supported. We recommend using [Module Workers](/workers/reference/migrate-to-module-workers/) instead. New features may not be supported for Service Workers.
+
+:::
+
+`EmailEvent` can be handled in Workers functions written using the Service Worker syntax by attaching to the `email` event with `addEventListener`:
+
+```js
+addEventListener("email", async (event) => {
+  await event.message.forward("<YOUR_EMAIL>");
+});
+```
+
+### Properties
+
+
+
+* `event.message` ForwardableEmailMessage
+
+  * An [`ForwardableEmailMessage` object](#forwardableemailmessage-definition).
+
+
+
+***
+
+## `ForwardableEmailMessage` definition
 
 ```ts
- interface EmailMessage<Body = unknown> {
+ interface ForwardableEmailMessage<Body = unknown> {
   readonly from: string;
   readonly to: string;
   readonly headers: Headers;
@@ -83,7 +89,7 @@ export default {
 }
 ```
 
-
+An email message that is sent to a consumer Worker and can be rejected/forwarded.
 
 * `from` string
 
@@ -114,7 +120,27 @@ export default {
   * Forward this email message to a verified destination address of the account. If you want, you can add extra headers to the email message. Only `X-*` headers are allowed.
   * When the promise resolves, the message is confirmed to be forwarded to a verified destination address.
 
-* <code>reply(messageEmailMessage)</code> : Promise
+* <code>reply(EmailMessage)</code> : Promise
 
   * Reply to the sender of this email message with a new EmailMessage object.
   * When the promise resolves, the message is confirmed to be replied.
+
+
+## `EmailMessage` definition
+
+```ts
+interface EmailMessage {
+    readonly from: string;
+    readonly to: string;
+}
+```
+
+An email message that can be sent from a Worker.
+
+* `from` string
+
+  * `Envelope From` attribute of the email message.
+
+* `to` string
+
+  * `Envelope To` attribute of the email message.
