JokeAPI-v2/src/translate.js

const fs = require("fs-extra");
const jsl = require("svjsl");

const debug = require("./verboseLogging")
const settings = require("../settings");


/** Whether this module was initialized */
let initialized = false;
let trFile = {};

/**
 * Initializes the translation module by caching the translations so they only need to be read from disk once
 * @returns {Promise}
 */
function init()
{
    debug("Translate", `Initializing - loading translations from "${settings.languages.translationsFile}"`);
    return new Promise((resolve, reject) => {
        fs.readFile(settings.languages.translationsFile, (err, res) => {
            if(err)
                return reject(`Error while reading translations file: ${err}`);
            else
            {
                trFile = JSON.parse(res.toString());
                debug("Translate", `Found ${Object.keys(trFile.tr).length} translations`);
                initialized = true;
                return resolve();
            }
        });
    });
}

/**
 * Returns the translation of a sentence of a specified language.
 * @param {String} lang Language code
 * @param {String} id The name of the translation node
 * @param {...any} args Arguments to replace numbered %-placeholders with. Only use objects that are strings or convertable to them with `.toString()`!
 * @returns {String|null} Returns `null` if no translation is available. Else returns a string
 */
function translate(lang, id, ...args)
{
    if(!initialized)
        throw new Error("translate module isnt't initialized");

    if(!lang)
        lang = settings.languages.defaultLanguage;

    let langTr = trFile.tr[id];
    if(!langTr)
        return null;

    let translation = langTr[lang.toString().toLowerCase()];
    if(!translation)
        translation = langTr[settings.languages.defaultLanguage];
    
    translation = translation.toString();

    if(Array.isArray(args) && translation.includes("%"))
    {
        args.forEach((arg, i) => {
            let rex = new RegExp(`%${i + 1}`);
            if(translation.match(rex))
            {
                try
                {
                    translation = translation.replace(rex, arg.toString());
                }
                catch(err)
                {
                    jsl.unused(err);
                }
            }
        });
    }

    // debug("Translate", `Translating "${id}" into ${lang} - result: ${translation}`);

    return translation;
}

/**
 * Returns a list of system languages (2 char code)
 * @returns {Array<String>}
 */
function systemLangs()
{
    return trFile.languages;
}

module.exports = translate;
module.exports.init = init;
module.exports.systemLangs = systemLangs;