fix: fix mail.d.ts types

package.json

@@ -11,6 +11,7 @@
     "@babel/cli": "^7.7.7",
     "@babel/core": "^7.7.7",
     "@babel/node": "^7.7.7",
+    "@types/node": "17.0.41",
     "chai": "4.2.0",
     "chai-as-promised": "^7.1.1",
     "dirty-chai": "^2.0.1",

packages/mail/src/mail.d.ts

@@ -7,12 +7,12 @@ declare class MailService {
   /**
    * SendGrid API key passthrough for convenience.
    */
-  setApiKey(apiKey: string): void;
+  setApiKey(apiKey: string): this;
 
   /**
    * Client to use for invoking underlying API
    */
-  setClient(client: Client): void;
+  setClient(client: Client): this;
 
   /**
    * Twilio Email Auth passthrough for convenience.
@@ -27,7 +27,7 @@ declare class MailService {
   /**
    * Set substitution wrappers
    */
-  setSubstitutionWrappers(left: string, right: string): void;
+  setSubstitutionWrappers(left: string, right: string): this;
 
   /**
    * Send email

packages/mail/src/mail.spec.js

@@ -132,5 +132,16 @@ describe('sgMail.send()', () => {
       sgMail.send(data, false, {});
     }).to.throw(Error);
   });
+
+  it("can be chained", () => {
+    const sgMailChain = require('./mail');
+    sgMailChain.client.setDefaultHeader('X-Mock', 202)
+    sgMailChain
+      .setApiKey('SendGrid API Key')
+      .send(data)
+      .then(([response, body]) => {
+        expect(response.statusCode).to.equal(202);
+      });
+  })
 });
 

test/typescript/mail.ts

@@ -1,5 +1,5 @@
 import { Client } from "@sendgrid/client";
-import sgMail = require("@sendgrid/mail");
+import sgMail from "@sendgrid/mail";
 
 // Test setClient() method
 sgMail.setClient(new Client());
@@ -277,3 +277,14 @@ sgMail.send({
   mailSettings: {},
   trackingSettings: {},
 });
+
+//supports chaining with ts
+sgMail.setClient(new Client())
+  .setApiKey("MY_SENDGRID_API_KEY")
+  .send({
+    to: '[email protected]',
+    from: '[email protected]',
+    subject: 'Hello email with categories',
+    html: '<p>Some email content</p>',
+    category: 'transactional',
+  });

tsconfig.json

@@ -1,6 +1,7 @@
 {
     "compilerOptions": {
         "noEmit": true,
+        "esModuleInterop": true,
         "module": "commonjs",
         "target": "es6",
         "baseUrl": ".",