From 7422d4186668dcfc76e2e2143a231d66bbca9bba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Piotr=20Po=C5=9Bpiech?= <ptkpospiech@gmail.com>
Date: Mon, 5 Sep 2022 18:27:05 +0200
Subject: [PATCH] Add types for email package

---
 packages/email/email.d.ts         | 43 +++++++++++++++++++++++++++++++
 packages/email/package-types.json |  3 +++
 packages/email/package.js         |  1 +
 3 files changed, 47 insertions(+)
 create mode 100644 packages/email/email.d.ts
 create mode 100644 packages/email/package-types.json

diff --git a/packages/email/email.d.ts b/packages/email/email.d.ts
new file mode 100644
index 0000000000..6b9a356721
--- /dev/null
+++ b/packages/email/email.d.ts
@@ -0,0 +1,43 @@
+export namespace Email {
+  interface EmailOptions {
+    from?: string | undefined;
+    to?: string | string[] | undefined;
+    cc?: string | string[] | undefined;
+    bcc?: string | string[] | undefined;
+    replyTo?: string | string[] | undefined;
+    subject?: string | undefined;
+    text?: string | undefined;
+    html?: string | undefined;
+    headers?: Object | undefined;
+    attachments?: Object[] | undefined;
+    mailComposer?: MailComposer | undefined;
+  }
+
+  interface CustomEmailOptions extends EmailOptions {
+    packageSettings?: unknown;
+  }
+
+  function send(options: EmailOptions): void;
+  function hookSend(fn: (options: EmailOptions) => boolean): void;
+  function customTransport(fn: (options: CustomEmailOptions) => void): void;
+}
+
+export interface MailComposerOptions {
+  escapeSMTP: boolean;
+  encoding: string;
+  charset: string;
+  keepBcc: boolean;
+  forceEmbeddedImages: boolean;
+}
+
+export var MailComposer: MailComposerStatic;
+export interface MailComposerStatic {
+  new (options: MailComposerOptions): MailComposer;
+}
+
+export interface MailComposer {
+  addHeader(name: string, value: string): void;
+  setMessageOption(from: string, to: string, body: string, html: string): void;
+  streamMessage(): void;
+  pipe(stream: any /** fs.WriteStream **/): void;
+}
diff --git a/packages/email/package-types.json b/packages/email/package-types.json
new file mode 100644
index 0000000000..de228d2fc5
--- /dev/null
+++ b/packages/email/package-types.json
@@ -0,0 +1,3 @@
+{
+  "typesEntry": "email.d.ts"
+}
diff --git a/packages/email/package.js b/packages/email/package.js
index 3fb07dae92..b3f6de4894 100644
--- a/packages/email/package.js
+++ b/packages/email/package.js
@@ -10,6 +10,7 @@ Npm.depends({
 
 Package.onUse(function(api) {
   api.use(['ecmascript', 'logging', 'callback-hook'], 'server');
+  api.addAssets('email.d.ts', ['client', 'server']);
   api.mainModule('email.js', 'server');
   api.export(['Email', 'EmailInternals'], 'server');
   api.export('EmailTest', 'server', { testOnly: true });