InigoValentin/backend/inigovalentin/app/services/locale.service.js

/**
 * @file Provides a service to handle languages and localizations.
 * @author Inigo Valentin
 * @since 4.0.0
 */

/**
 * Handles localization of elements.
 */
class LocaleService {

    /**
     * Database connection.
     */
    #db;

    /**
     * List of available languages.
     *
     * The one at index 0 is the default language.
     */
    #availableLanguages = Array();

    /**
     * Constructor.
     *
     * @param db Database connection.
     * @constructor
     */
    constructor(db){
        this.#db = db;
        this.#init();
    }

    /**
     * Initializes the service.
     *
     * Called automatically from the constructor.
     */
    async #init(){
        var result = await this.#db.sequelize.query('SELECT code FROM langs WHERE active = 1 ORDER by PRIORITY ASC ', { type: this.#db.sequelize.QueryTypes.SELECT })
        for (const r of result) this.#availableLanguages.push(r.code.toLowerCase().substring(0, 2));
    }

    /**
     * Selects the language to use.
     *
     * If the language is not in the request, using the GET parameter "lang", the default one set
     * in the database will be used.
     *
     * @param req The request received by the server.
     * @return Two letter language code to use.
     */
    selectLanguage(req){
        if (!req.query.lang) return this.#availableLanguages[0];
        var requestedLang = req.query.lang.toLowerCase().substring(0, 2)
        if (this.#availableLanguages.indexOf(requestedLang) != -1) return requestedLang;
        return this.#availableLanguages[0];
    }

    /**
     * Decodes a text from the database.
     * 
     * @param result Result of a query to the table 'texts'. Must have at least the columns 'text' and 'file'.
     * @return The text.
     */
    async #decodeText(key, lang){
        var result = await this.#db.sequelize.query('SELECT text, file FROM texts WHERE lang = ? AND id = ?', { replacements: [lang, key], type: this.#db.sequelize.QueryTypes.SELECT })
        for (const r of result) {
            if (r.text) return "" + r.text;
            if (r.file) return "" + r.file; // TODO: Return file CONTENTS
        }
        return "";
    }
    
    /**
     * Generates a localized object for text storing in database.
     * 
     * @param obj The object with the text in multiple languages. Language codes must be keys.
     * @param key The key to assign to the text.
     * @param section The section identifier for the text.
     * @return An object with those values:
     *   - valid: True if the object is valid and can be stored in database.
     *   - key: Identifier for the text.
     *   - section: Identifier fot the text section.
     *   - texts{}: An array for the text in different languages. Language codes are keys.
     */
    generateLocalizedObject(obj, key, section){
        let l = {
            valid: true,
            key: key,
            section: section,
            texts: {}
        };
        if (!key) l.valid = false;
        if (!section) l.valid = false;
        l.key = key;
        l.section = section;
        let body;
        try{
            body = JSON.parse(obj);
            for (let i = 0; i < this.#availableLanguages.length; i ++)
                if (body[this.#availableLanguages[i]] != undefined) l.texts[this.#availableLanguages[i]] = body[this.#availableLanguages[i]];
            if (l.texts.length == 0) l.valid = false;
        }
        catch(err){
            l.valid = false;
        }
        return l;
    }

    /**
     * Saves a localized object in the database.
     * 
     * @param obj The object, as provided by {@see generateLocalizedObject}.
     * @return True on success, false on error.
     */
    async saveLocalizedObject(obj, key, section){
        if (!obj.valid || obj.valid != true || !obj.texts || obj.texts.length < 1) return false;
        for (const [lang, text] of Object.entries(obj.texts))
            let res = await this.#db.sequelize.query('INSERT INTO texts (id, lang, section, text, file) VALUES (?, ?, ?, ?, ?)', {replacements: [obj.key, lang, obj.section, text, null], type: this.#db.sequelize.QueryTypes.INSERT});
        return true;
    }

    /**
     * Localizes a project.
     *
     * Localizes all localizable items in a project, using the language provided in the request or
     * the default one.
     *
     * @param data The project object to localize.
     * @param req The request received by the server.
     * @return The project object, with all of the fields localized.
     */
    async localizeProject(data, req){
        var lang = this.selectLanguage(req);
        data.dataValues.title = await this.#decodeText(data.dataValues.title, lang);
        data.dataValues.header = await this.#decodeText(data.dataValues.header, lang);
        data.dataValues.text = await this.#decodeText(data.dataValues.text, lang);
        data.dataValues.comment = await this.#decodeText(data.dataValues.comment, lang);
        if (data.dataValues.type){
            data.dataValues.type.title = await this.#decodeText(data.dataValues.type.title, lang);
            data.dataValues.type.summary = await this.#decodeText(data.dataValues.type.summary, lang);
        }
        if (data.dataValues.license){
            data.dataValues.license.summary = await this.#decodeText(data.dataValues.license.summary, lang);
            data.dataValues.license.legal = await this.#decodeText(data.dataValues.license.legal, lang);
        }
        for (var i = 0; i < data.dataValues.tags.length; i ++)
            data.dataValues.tags[i].tag = await this.#decodeText(data.dataValues.tags[i].tag, lang);
        for (var i = 0; i < data.dataValues["project-urls"].length; i ++){
            data.dataValues["project-urls"][i].dataValues.type.dataValues.title = await this.#decodeText(data.dataValues["project-urls"][i].dataValues.type.dataValues.title, lang);
            data.dataValues["project-urls"][i].dataValues.type.dataValues.summary = await this.#decodeText(data.dataValues["project-urls"][i].dataValues.type.dataValues.summary, lang);
        }
        for (var i = 0; i < data.dataValues["project-images"].length; i ++)
            data.dataValues["project-images"][i].dataValues.alt = await this.#decodeText(data.dataValues["project-images"][i].dataValues.alt, lang);
        //console.log(data.dataValues.projectUrls)
        return data;
    }

    /**
     * Localizes a list of projects.
     *
     * Localizes all localizable items in all projects, using the language provided in the request or
     * the default one.
     *
     * @param data The project object list to localize.
     * @param req The request received by the server.
     * @return The project list, with all of their fields localized.
     */
    async localizeProjects(data, req){
        for (var d of data) d = await this.localizeProject(d, req);
        return data;
    }

    /**
     * Localizes a license.
     *
     * Localizes all localizable items in a license, using the language provided in the request or
     * the default one.
     *
     * @param data The license object to localize.
     * @param req The request received by the server.
     * @return The license object, with all of the fields localized.
     */
    async localizeLicense(data, req){
        var lang = this.selectLanguage(req);
        data.dataValues.summary = await this.#decodeText(data.dataValues.summary, lang);
        data.dataValues.legal = await this.#decodeText(data.dataValues.legal, lang);
        return data;
    }

    /**
     * Localizes a list of projects licenses.
     *
     * Localizes all localizable items in all licenses, using the language provided in the request or
     * the default one.
     *
     * @param data The license object list to localize.
     * @param req The request received by the server.
     * @return The license list, with all of their fields localized.
     */
    async localizeLicenses(data, req){
        for (var d of data) d = await this.localizeLicense(d, req);
        return data;
    }

    /**
     * Localizes a project type.
     *
     * Localizes all localizable items in a project type, using the language provided in the request or
     * the default one.
     *
     * @param data The project type object to localize.
     * @param req The request received by the server.
     * @return The project type object, with all of the fields localized.
     */
    async localizeProjectType(data, req){
        var lang = this.selectLanguage(req);
        data.dataValues.title = await this.#decodeText(data.dataValues.title, lang);
        data.dataValues.summary = await this.#decodeText(data.dataValues.summary, lang);
        return data;
    }
    
    /**
     * Localizes a list of projects project types.
     *
     * Localizes all localizable items in all project types, using the language provided in the request or
     * the default one.
     *
     * @param data The project type object list to localize.
     * @param req The request received by the server.
     * @return The project type list, with all of their fields localized.
     */
    async localizeProjectTypes(data, req){
        for (var d of data) d = await this.localizeProjectType(d, req);
        return data;
    }
    
    /**
     * Localizes a user.
     *
     * Localizes all localizable items in a user, using the language provided in the request or
     * the default one.
     *
     * @param data The user object to localize.
     * @param req The request received by the server.
     * @return The user object, with all of the fields localized.
     */
    async localizeUser(data, req){
        var lang = this.selectLanguage(req);
        // TODO
        //data.dataValues.title = await this.#decodeText(data.dataValues.title, lang);
        //data.dataValues.summary = await this.#decodeText(data.dataValues.summary, lang);
        return data;
    }
    
    /**
     * Localize a list of users project types.
     *
     * Localize all localizable items in all users, using the language provided in the request or
     * the default one.
     *
     * @param data The user object list to localize.
     * @param req The request received by the server.
     * @return The user list, with all of their fields localized.
     */
    async localizeUserss(data, req){
        for (var d of data) d = await this.localizeUser(d, req);
        return data;
    }

}
module.exports = LocaleService;