async / await

[jgravois]

need to investigate the impact on our UMD / ESM output.

[jgravois]

Pros:

• typescript 2.1+ indeed transpiles async/await to ES5 anywhere Promise is available.
• it looks nice!

export function setItemAccess(/**/): Promise<> {
    // ...
    return isOrgAdmin(requestOptions).then(admin => { 
       if (admin) { 

becomes

export async function setItemAccess(/**/): Promise<> {
    // ...
    const admin = await isOrgAdmin(requestOptions)
    if (admin) {

Cons:

• the change above costs almost 1.5 KB.

┌─────────────────────────────────────────────────┐
│                                                 │
│   Destination: ./dist/umd/sharing.umd.min.js    │
│   Bundle size: 3.02 KB, Gzipped size: 1.25 KB   │
│                                                 │
└─────────────────────────────────────────────────┘

becomes

┌────────────────────────────────────────────────┐
│                                                │
│   Destination: ./dist/umd/sharing.umd.min.js   │
│   Bundle size: 4.4 KB, Gzipped size: 1.88 KB   │
│                                                │
└────────────────────────────────────────────────┘

The Async Await chapter of TypeScript Deep Dive 💯 by @basarat includes a helpful canned example of just how much ES5 transpiled code underpins the ✨ in .ts.