[TypeDefinition] SendGrid.API should return Promise<T> instead of PromiseLike<T>

[IOAyman]

Issue Summary

I think the SendGrid.API function should return a object on which either .then() or .catch() can be called upon.

The current implementation uses PromiseLike interface which only ensures .then().
But the problem would be solved by using Promise interface instead.

Demo

SendGridClient
    .API(request)
    .then(okFunction)
    .catch(noOkFunction)  // this line will not be reported as an error anymore

Technical details:

• sendgrid-nodejs Version: master (latest commit: [https://github.com/sendgrid/sendgrid-nodejs/commit/d01e7ef])
• Node.js Version: 6.9.1
• TypeScript Version: 2.0.3

---

This references #308
/cc @spartan563

[notheotherben]

👍 Looks good to me

[heitortsergent]

[thinkingserious]

Hello @IOAyman!

Thanks for the PR, great work :)

Could you please sign our CLA so that we can merge it?

[IOAyman]

@thinkingserious I sent an email on Nov.11.2016 asking a question but no response.

[thinkingserious]

@IOAyman,

My apologies, looks like I sent it to the wrong email address (facepalm)

I have now forwarded my response.

[ksiegel]

Hey folks! Running into this issue myself. Hopefully y'all are emailing back and forth to get this merged.

as Promise<any> for now! 😃

[thinkingserious]

Hi @ksiegel,

This one is still climbing up our backlog. I've now added your vote to bump it up further, thanks!

[thinkingserious]

Thanks again @IOAyman!

Please take a moment to fill out this form so that we can send you some swag :)

[IOAyman]

Very much appreciated, thank you 🎆 😄