Issue with Typescript

I have been following this documentation(https://github.com/TwilioDevEd/api-snippets/blob/master/rest/access-tokens/video-example/video-example.3.x.js) to generate a auth token.

Using "twilio": "^3.19.1" with "@types/twilio": "0.0.9", seems like the VideoGrant is unavailable and the Typescript and AccessToken.toJwt() requires a String parameter which is not necessary.

I ended up doing the following, but it would be nice to fix these.

Version: ^3.19.1

Code Snippet

const VideoGrant = require('twilio').AccessToken.VideoGrant;
//...
res.json({ jwt: token.toJwt('HS256') });

Thanks

[et]

Awesome.

For those of you who want to define the type for the client too, this is what I did:

import * as twilio from 'twilio';
import * as TwilioClient from 'twilio/lib/rest/Twilio';
const client: TwilioClient = twilio(accountSid, authToken);

and now you’ll have nice autocompletion:

[dkundel]

Hey folks,

Yes we silently released TS bindings with the latest release and definitely require feedback with this 😃

@Crazometer your comment is correct. I made that decision because of the way that the Twilio lib is written I had to decide between twilio being a function or a class. The recommended way to use it right now is (as per TypeScript documentation for libs written in such a way)

import twilio = require('twilio');
const client = twilio();

The first two examples are both from the old library. Since version 3.X TwiML is nested under twiml and specific to the type like VoiceResponse, MessagingResponse and FaxResponse:

import twilio = require('twilio');
const myTwiml = new twilio.twiml.VoiceResponse();
myTwiml.say({ voice: 'alice' }, 'Ahoy');

console.log(myTwiml.toString());

Note There is a known issue where right now you have to pass options to the respective TwiML methods. I hope it gets fixed soon. The code snippet above is also depending on a PR being merged that fixes a few of these issues.

For the AccessTokens, they are now under jwt nested since version 3.X and I open a PR to make the algorithm optional. Then this should work:

// create AccessToken
const accessToken = new twilio.jwt.AccessToken(
  process.env.TWILIO_ACCOUNT_SID!,
  process.env.TWILIO_API_KEY!,
  process.env.TWILIO_API_SECRET!,
  {
    ttl: 360,
  }
);

// create Grant
const grant = new twilio.jwt.AccessToken.VideoGrant();
grant.toPayload();

const AccessToken = twilio.jwt.AccessToken;
const voiceGrant = new AccessToken.VoiceGrant({
  incomingAllow: true,
  outgoingApplicationSid: 'someSid',
});
voiceGrant.toPayload();

accessToken.addGrant(voiceGrant);
accessToken.addGrant(grant);

const token = accessToken.toJwt();
console.log(token);

I hope this helps and your feedback is definitely wanted and helpful 😃