Anunciando o SDK do Vonage Node v3.0.0

Isso mesmo, a v3 do SDK do Node já está totalmente disponível. Um recurso há muito solicitado foi lançado, juntamente com a divisão do SDK em componentes menores, o que ajudará a equipe a lançar novos recursos mais rapidamente.

Alterações que exigem atualização

Promessas

Todas as chamadas de retorno de função foram removidas. No futuro, você precisará usar async/await ou .then/.catch. Isso deve tornar seu código mais limpo, evitando o “callback hell”. Por exemplo:

const Vonage = require('@vonage/server-sdk')

const vonage = new Vonage({
    apiKey: VONAGE_API_KEY,
    apiSecret: VONAGE_API_SECRET,
})

const from = VONAGE_BRAND_NAME;
const to = TO_NUMBER;
const text = 'A text message sent using the Vonage SMS API'

vonage.message.sendSms(from, to, text, (err, responseData) => {
    if (err) {
        console.log(err);
        return;
    }

    if(responseData.messages[0]['status'] === "0") {
        console.log("Message sent successfully.");
        return;
    } 
    
    console.log(`Message failed with error: ${responseData.messages[0]['error-text']}`);
})

Agora, isso pode ser escrito da seguinte forma:

const { Vonage } = require('@vonage/server-sdk')

const vonage = new Vonage({
    apiKey: VONAGE_API_KEY,
    apiSecret: VONAGE_API_SECRET,
})

const from = VONAGE_BRAND_NAME;
const to = TO_NUMBER;
const text = 'A text message sent using the Vonage SMS API';

const sendSMS = async () {
    try {
        const response = await vonage.sms.send({to, from, text});
        console.log(response);
    } catch (err) {
        console.log('There was an error sending the messages.'); 
        console.error(err);
    }
};

Atualizações de parâmetros

As funções também foram atualizadas para usar objetos de parâmetro em vez de argumentos de função. Isso ajudará a tornar as funções com muitos parâmetros opcionais mais fáceis de gerenciar. Publicamos um documento de migração para cada pacote, no qual é descrito com mais detalhes quais funções foram atualizadas.

Guia de migração

Você pode encontrar guias de migração para cada pacote aqui:

• Contas

• Applications

• Mensagens

• Informações sobre números

• Numbers

• Preços

• SMS

• Verify

• Voice

Pacotes menores e Typescript

A versão 3 usa o Typescript para auxiliar na autocompletar de código no seu IDE preferido. Mas uma melhoria ainda maior é o uso de monorepos. Um monorepo divide a base de código em pacotes menores, mantendo intacta a árvore de dependências. Agora você pode usar pacotes específicos em sua aplicação, em vez de incluir todo o conjunto de produtos. Fizemos essa mudança estrategicamente para nos permitir lançar recursos beta e correções sem atrasar o ramo principal de desenvolvimento. Um exemplo disso é o novo pacote Video API (que, no passado, fazia parte do SDK do OpenTok):

import { Auth } from '@vonage/auth';
import { Video } from '@vonage/video';

const credentials = new Auth({
    apiKey: VONAGE_API_KEY,
    apiSecret: VONAGE_API_SECRET,
});

const video = new Video(credentials);

const getVideoSession = async () => {
    try {
        const session = await video.createSession({ mediaMode: 'routed' });
        console.log('Session created', session);
        return session;
    } catch (error) {
        console.log('Failed to create session');
        console.error(error);
        throw error;
    }
}

Agora você pode usar um pacote SDK beta e manter os pacotes estáveis.

Suporte

A seguir nosso documento de suporte , continuaremos a oferecer suporte à versão 2 por mais seis meses, o que nos levará até aproximadamente maio de 2023. Não adicionaremos novos recursos, apenas correções.

Para obter informações mais detalhadas, acesse a documentação do SDK ou consulte os trechos de código. Você pode entrar em contato conosco no Slack para desenvolvedores da Vonage e mantenha-se atualizado seguindo VonageDev no Twitter.