example.js

'use strict'

const IntentoConnector = require('./src/index')

// Quickly load .env files into the environment
// The next line requires `dotenv` installed (`yarn add -D dotenv` or `npm install --save-dev dotenv`)
//require('dotenv').config()

const apikey = process.env.INTENTO_API_KEY
const google_api_key = process.env.GOOGLE_API_KEY

if (!google_api_key) {
    console.warn('Missing Google api key. Some examples might not work.')
}

const client = new IntentoConnector({ apikey })

if (client.error) {
    console.error(client.error)
    if (!apikey) {
        console.error(
            'Consider one of the options https://github.com/intento/intento-nodejs#how-to-pass-your-api-keys-to-your-environment'
        )
    }
    process.exit(1)
}

// This is an intent to translate text from one language to another.
// More on that in the documentation here https://github.com/intento/intento-api/blob/master/ai.text.translate.md
client.ai.text.translate
    .fulfill({ text: "How's it going?", to: 'es' })
    .then(defaultCallback)
    .catch(prettyCatch)

// This is an intent to analyze the sentiment of the provided text.
// More on that in the documentation here https://github.com/intento/intento-api/blob/master/ai.text.sentiment.md
client.ai.text.sentiment
    .fulfill({
        text: 'We love this place',
        lang: 'en',
        provider: 'ai.text.sentiment.ibm.natural_language_understanding',
    })
    .then(defaultCallback)
    .catch(prettyCatch)

// This is an intent to get meanings of text in selected language.
// More on that in the documentation here https://github.com/intento/intento-api/blob/master/ai.text.dictionary.md
client.ai.text.dictionary
    .fulfill({
        text: 'meaning',
        from: 'en',
        to: 'ru',
    })
    .then(data => {
        console.log(
            'Dictionary results:\n',
            JSON.stringify(data, null, 4),
            '\n'
        )
    })

/* Explore providers */

// Documentation on providers:
//   - Translation: https://github.com/intento/intento-api/blob/master/ai.text.translate.md#getting-available-providers
//   - Sentiment analysis: https://github.com/intento/intento-api/blob/master/ai.text.sentiment.md#getting-available-providers
//   - Text meanings: https://github.com/intento/intento-api/blob/master/ai.text.dictionary.md#getting-available-providers
client.ai.text.translate
    .providers()
    .then(prettyPrintProviders)
    .catch(prettyCatch)

// Providers for sentiment analysis
client.ai.text.sentiment
    .providers()
    .then(prettyPrintProviders)
    .catch(prettyCatch)

// Providers to get meanings of texts in selected languages
client.ai.text.dictionary
    .providers()
    .then(prettyPrintProviders)
    .catch(prettyCatch)

// more examples with exploring providers here https://github.com/intento/intento-nodejs/blob/master/samples/server-side-app/explore-providers.js

/* Advanced usage */

// Translate with specific strategy
client.ai.text.translate
    .fulfill({
        text: "How's it going?",
        to: 'pt',
        routing: 'best_price',
    })
    .then(data => {
        console.log('\nTranslate with a "best_price" strategy \n')
        defaultCallback(data)
    })
    .catch(prettyCatch)

/* Advanced general examples */

client
    .makeRequest({
        path: '/ai/text/translate',
        method: 'POST',
        content: {
            context: {
                text: 'A sample text',
                to: 'es',
            },
            service: {
                provider: 'ai.text.translate.microsoft.translator_text_api.2-0',
            },
        },
    })
    .then(data => {
        console.log('Basic usage example\n')
        defaultCallback(data)
    })
    .catch(prettyCatch)

// With custom google api key
client
    .makeRequest({
        path: '/ai/text/translate',
        method: 'POST',
        content: {
            context: {
                text: 'A sample text!',
                to: 'es',
            },
            service: {
                provider: 'ai.text.translate.google.translate_api.2-0',
                auth: {
                    'ai.text.translate.google.translate_api.2-0': [
                        { key: `${google_api_key}` },
                    ],
                },
            },
        },
    })
    .then(data => {
        console.log('Example with your google api key\n')
        defaultCallback(data)
    })
    .catch(prettyCatch)

// One can pass request parameters as raw json specified as a `data` parameter
// Make sure your json is valid. For example one can validate json online  here https://jsonformatter.curiousconcept.com/
client
    .makeRequest({
        path: '/ai/text/translate',
        method: 'POST',
        data: `{
            "context": {
                "text": "Validation is the king",
                "to": "es"
            },
            "service": {
                "provider": "ai.text.translate.microsoft.translator_text_api.2-0"
            }
        }`,
    })
    .then(defaultCallback)
    .catch(prettyCatch)

/* helpers */

function defaultCallback(data) {
    console.log('API response:\n', JSON.stringify(data, null, 4), '\n\n')
}

function prettyPrintProviders(data) {
    if (!data || !data.length) {
        console.log(`\nThere are  no providers.`)
    } else if (data.length === 1) {
        console.log(`\nThere is one provider:`)
    } else {
        console.log(`\nThere are overall ${data.length} providers:`)
    }
    data.forEach((p, i) => console.log(`  ${i + 1}. ${p.name}`))
    console.log('\n\n')
}

function prettyCatch(errorResponse) {
    console.log('\nError: ' + errorResponse.message)
    console.log('\n\n')
}