Annonce du SDK Vonage Node v3.0.0

C'est exact, v3 du kit de développement de nœuds est désormais promise. Une fonctionnalité demandée depuis longtemps a été publiée, ainsi que la décomposition du SDK en composants plus petits, ce qui aidera l'équipe à publier de nouvelles fonctionnalités plus rapidement.

Rupture des changements

Promesses

Tous les rappels de fonctions ont été supprimés. À l'avenir, vous devrez utiliser async/await ou .then/.catch. Cela devrait rendre votre code plus propre en évitant l'enfer des callbacks. Par exemple :

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']}`);
})

On peut maintenant l'écrire comme suit :

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);
    }
};

Mises à jour des paramètres

Les fonctions ont également été mises à jour afin d'utiliser des objets paramètres au lieu d'arguments de fonction. Cela permettra de mieux gérer les fonctions comportant de nombreux paramètres facultatifs. Nous avons publié un document de migration pour chaque paquet qui décrit plus en détail les fonctions qui ont été mises à jour.

Guide de migration

Vous trouverez ici les guides de migration pour chaque paquet :

• Account

• Applications

• Messages

• Numbers en bref

• Numbers

• Tarification

• SMS

• Verify

• Voice

Petits paquets et Typescript

La version 3 utilise Typescript pour faciliter la complétion du code dans votre IDE préféré. Mais une amélioration encore plus importante est l'utilisation de monorepos. Une monorepo divise la base de code en paquets plus petits tout en conservant l'arbre des dépendances intact. Vous pouvez désormais utiliser des paquets spécifiques dans votre application plutôt que d'inclure l'ensemble de la suite de produits. Nous avons fait ce changement stratégiquement pour nous permettre de publier des fonctionnalités bêta et des correctifs sans retarder la branche principale de développement. Un exemple de ce changement est le nouveau paquetage Video API (qui faisait auparavant partie du paquetage OpenTok SDK) :

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;
    }
}

Vous pouvez désormais utiliser un paquet SDK bêta et conserver les paquets stables.

Soutien

Suite à notre document nous continuerons à assurer le support de la version 2 pendant encore six mois, ce qui nous amènera aux alentours de mai 2023. Nous n'ajouterons pas de nouvelles fonctionnalités, seulement des correctifs.

Pour de plus amples informations, veuillez consulter la documentation du SDK ou les extraits de code. Vous pouvez nous contacter sur le Slack des développeurs de Vonage et rester dans la boucle en suivant VonageDev sur Twitter.