wok-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Peak Tai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# node 后端框架
+
+一个简洁易用的 Nodejs 后端框架，使用 Typescript 开发，有完整的类型约束和定义，注释详细，文档齐全，支持国际化。
+
+主要功能：配置，日志，国际化，校验，缓存，MVC，mysql，mongodb ，周期任务 。
+
+[查看文档](./documentation/zh-cn/index.md)
+
+## 优点
+
+- 学习成本较低，函数式为主，少量面向对象，未使用代理和装饰器等增强技术
+- 功能简单，使用方便，保持克制，不引入太多特性
+- 轻量封装，最大限度兼容已有生态，支持集成第三方 http 相关的库来处理请求
+- 支持国际化，自带多种语言的支持，国际化内容支持扩展
+- 有完整的类型约束和定义，结合 IDE 的代码补全功能，开发效率高
+- 注释详细，文档就在代码中，方法和参数都有详细说明，可在 IDE 的辅助下方便查看
+
+## Hello world
+
+```ts
+startWebServer({
+  routers: {
+    '/': async exchange => exchange.respondText('Hello world !')
+  }
+}).catch(e => {
+  console.error('Start server failed', e)
+})
+```
+
+上面的代码启动了 web 服务，访问路径 `http://localhost:8080` 将输出文本 “Hello world !”。
+
+相关的设置可以通过环境变量来修改，查看[完整文档](./documentation/zh-cn/index.md)了解细节。
+
+## 一些问题的说明
+
+### 为什么直接集成依赖库
+
+项目中对 mysql 客户端和 mongodb 的驱动直接打包集成了，也没有将这两个组件
+单独拆分成一个独立的包以供按需引入。这样做是为了方便，不需要安装那么多包，安装的包多了
+之后，还有可能需要解决依赖冲突问题，找到版本匹配的包，使用和维护都麻烦。对于后端程序来说，
+体积大一些问题也不大。
+
+### 为什么部分可选功能需要第三方库，而又没有集成
+
+对于 wesocket 和文件上传等功能，框架没有实现，而是需要使用者引入第三方库，框架没有集成这些库。
+这些库是基于 Nodejs 内置的模块 http，不用担心与框架的兼容性问题，框架只要保持支持即可，
+也可以充分利用已有的生态，不需要专门为框架编写扩展。

package/dist/cache/cache.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cache = void 0;
+const config_1 = require("./config");
+class Cache {
+    valueMap;
+    stat;
+    /**
+     * promise 表，作用是处理异步并发问题，如果有相同的 key 同时请求，保证异步的 provider 只执行一次
+     */
+    promiseMap = new Map();
+    constructor(valueMap, stat) {
+        this.valueMap = valueMap;
+        this.stat = stat;
+    }
+    /**
+     * 放入缓存
+     * @param key
+     * @param val
+     * @param expiresInSeconds
+     */
+    put(key, val, expiresInSeconds) {
+        const finalExpiresInSeconds = typeof expiresInSeconds === 'number' ? expiresInSeconds : config_1.config.defaultExpireInSeconds;
+        this.valueMap.set(key, {
+            val,
+            expireAt: new Date().getTime() + finalExpiresInSeconds * 1000
+        });
+    }
+    /**
+     * 获取缓存值
+     * @param key
+     * @returns
+     */
+    get(key) {
+        const content = this.valueMap.get(key);
+        if (!content) {
+            this.stat.addGet(false);
+            return undefined;
+        }
+        if (content.expireAt < new Date().getTime()) {
+            this.stat.addGet(false);
+            this.valueMap.delete(key);
+            return undefined;
+        }
+        this.stat.addGet(true);
+        return content.val;
+    }
+    /**
+     * 清除所有缓存
+     */
+    clear() {
+        this.valueMap.clear();
+        this.stat.clear();
+    }
+    /**
+     * 删除.
+     * @param key
+     */
+    remove(key) {
+        this.valueMap.delete(key);
+    }
+    /**
+     * 在缓存值不存在时计算缓存的值，然后放入并返回.
+     * @param key
+     * @param provider
+     * @param expiresInSeconds
+     */
+    async computeIfAbsent(key, provider, expiresInSeconds) {
+        const content = this.valueMap.get(key);
+        if (content && content.expireAt >= new Date().getTime()) {
+            this.stat.addGet(true);
+            return content.val;
+        }
+        this.stat.addGet(false);
+        // 如果已经在处理中，则直接返回 promise
+        const ep = this.promiseMap.get(key);
+        if (ep) {
+            return ep;
+        }
+        // 创建新的异步流程
+        const promise = Promise.resolve().then(async () => {
+            const finalExpireInSeconds = typeof expiresInSeconds === 'number' ? expiresInSeconds : config_1.config.defaultExpireInSeconds;
+            // 计算值
+            const res = provider();
+            const val = res instanceof Promise ? await res : res;
+            this.put(key, val, finalExpireInSeconds);
+            this.promiseMap.delete(key);
+            return val;
+        });
+        this.promiseMap.set(key, promise);
+        return promise;
+    }
+}
+exports.Cache = Cache;

package/dist/cache/config.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+const config_1 = require("../config");
+const validation_1 = require("../validation");
+const ENV_PREFIX = 'CACHE';
+exports.config = (0, config_1.registerConfig)({
+    defaultExpireInSeconds: 60,
+    statTaskEnabled: false,
+    statInterval: 300,
+    maxElements: 1024,
+    cleaningInterval: 60
+}, ENV_PREFIX, {
+    defaultExpireInSeconds: [(0, validation_1.notNull)(), (0, validation_1.min)(1), (0, validation_1.max)(3600)],
+    statTaskEnabled: [(0, validation_1.notNull)()],
+    statInterval: [(0, validation_1.notNull)(), (0, validation_1.min)(1), (0, validation_1.max)(3600 * 24)],
+    maxElements: [(0, validation_1.notNull)(), (0, validation_1.min)(1), (0, validation_1.max)(Number.MAX_VALUE)],
+    cleaningInterval: [(0, validation_1.notNull)(), (0, validation_1.min)(1), (0, validation_1.max)(3600)]
+});

package/dist/cache/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCache = void 0;
+const task_1 = require("../task");
+const cache_1 = require("./cache");
+const config_1 = require("./config");
+const purge_task_1 = require("./purge-task");
+const stat_1 = require("./stat");
+const valueMap = new Map();
+const stat = new stat_1.CacheStat(valueMap);
+const cache = new cache_1.Cache(valueMap, stat);
+// 清理任务
+(0, task_1.scheduleWithFixedDelay)(config_1.config.cleaningInterval, config_1.config.cleaningInterval, new purge_task_1.PurgeTask(valueMap));
+// 统计任务
+if (config_1.config.statTaskEnabled) {
+    (0, task_1.scheduleWithFixedDelay)(config_1.config.statInterval, config_1.config.statInterval, {
+        name: 'cache statistics',
+        async run() {
+            stat.log();
+            stat.clear();
+        }
+    });
+}
+function getCache() {
+    return cache;
+}
+exports.getCache = getCache;

package/dist/cache/purge-task.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PurgeTask = void 0;
+const log_1 = require("../log");
+const config_1 = require("./config");
+/**
+ * 缓存清理任务
+ */
+class PurgeTask {
+    valueMap;
+    name = 'cache purge';
+    constructor(valueMap) {
+        this.valueMap = valueMap;
+    }
+    async run() {
+        let removeCount = 0;
+        for (const entry of this.valueMap.entries()) {
+            const [key, value] = entry;
+            if (value.expireAt < new Date().getTime()) {
+                this.valueMap.delete(key);
+                removeCount++;
+            }
+        }
+        if (removeCount > 0) {
+            if (removeCount > 1) {
+                (0, log_1.getLogger)().info(`A total of ${removeCount} expired cache records have been cleared.`);
+            }
+            else {
+                (0, log_1.getLogger)().info(`A total of ${removeCount} expired cache record has been cleared.`);
+            }
+        }
+        // 如果过期的都清理掉，但是元素总数仍然超出，则删除多余元素，删除是从头开始删除的
+        // 看上去是按put顺序清理最早的，实际上随机的，重复 set 相同的 key，key 的位置是不会变的，不保证 key 的顺序
+        // 所以，缓存是随机驱逐的
+        // 目前没有考虑支持其它的策略，因为需要额外记录信息，清理的逻辑也可能更复杂
+        // nodejs 是单线程模式的，规模上去后，可能需要执行较长的时间带来阻塞
+        if (this.valueMap.size > config_1.config.maxElements) {
+            let diff = this.valueMap.size - config_1.config.maxElements;
+            let evictedCount = 0;
+            for (const key of this.valueMap.keys()) {
+                this.valueMap.delete(key);
+                evictedCount++;
+                if (evictedCount >= diff) {
+                    break;
+                }
+            }
+            if (evictedCount > 1) {
+                (0, log_1.getLogger)().info(`A total of ${evictedCount} cache records have been evicted.`);
+            }
+            else {
+                (0, log_1.getLogger)().info(`A total of ${evictedCount} cache record has been evicted.`);
+            }
+        }
+    }
+}
+exports.PurgeTask = PurgeTask;

package/dist/cache/stat.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheStat = void 0;
+const log_1 = require("../log");
+const date_1 = require("../log/date");
+const config_1 = require("./config");
+/**
+ * 缓存统计.
+ */
+class CacheStat {
+    valueMap;
+    /**
+     * 开始统计时间
+     */
+    start;
+    totalGet = 0;
+    totalHit = 0;
+    constructor(valueMap) {
+        this.valueMap = valueMap;
+        this.start = new Date();
+    }
+    /**
+     * 添加 get 次数
+     * @param hit 是否命中
+     */
+    addGet(hit) {
+        this.totalGet++;
+        if (hit) {
+            this.totalHit++;
+        }
+    }
+    /**
+     * 清空统计信息，重新开始统计.
+     */
+    clear() {
+        this.start = new Date();
+        this.totalGet = 0;
+        this.totalHit = 0;
+    }
+    /**
+     * 输出日志
+     */
+    log() {
+        (0, log_1.getLogger)().info(`Cache statistics，time window ：${(0, date_1.formatDateTime)(this.start)} - now， hit ：${this.totalHit}/${this.totalGet}，capacity：${this.valueMap.size}/${config_1.config.maxElements}`);
+    }
+}
+exports.CacheStat = CacheStat;

package/dist/config/convert.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convert = void 0;
+const exception_1 = require("./exception");
+/**
+ * 转换值.
+ * @param val
+ * @param defaultVal
+ */
+function convert(val, defaultVal) {
+    if (typeof defaultVal === 'string') {
+        return val;
+    }
+    else if (typeof defaultVal === 'number') {
+        const num = parseFloat(val);
+        if (isNaN(num)) {
+            throw new exception_1.ConfigException(`Unable to convert value to number ：${val}`);
+        }
+        return num;
+    }
+    else if (typeof defaultVal === 'boolean') {
+        if (val === 'true') {
+            return true;
+        }
+        else if (val === 'false') {
+            return false;
+        }
+        else {
+            throw new exception_1.ConfigException(`Cannot convert value to a boolean type：${val}`);
+        }
+    }
+    else {
+        throw new exception_1.ConfigException(`Unsupported conversion type ：${typeof defaultVal}`);
+    }
+}
+exports.convert = convert;

package/dist/config/exception.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigException = void 0;
+/**
+ * 配置异常.
+ */
+class ConfigException extends Error {
+    message;
+    constructor(message) {
+        super(message);
+        this.message = message;
+    }
+}
+exports.ConfigException = ConfigException;

package/dist/config/index.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConfig = exports.getConfig = void 0;
+const tslib_1 = require("tslib");
+const dotenv_1 = require("dotenv");
+const validation_1 = require("../validation");
+const convert_1 = require("./convert");
+const exception_1 = require("./exception");
+// 初始化 .env 文件
+(0, dotenv_1.config)();
+/**
+ * 环境变量配置表.
+ */
+const configEnvMap = new Map();
+/**
+ * 获取配置
+ * @param envPrefix
+ */
+function getConfig(envPrefix) {
+    return configEnvMap.get(envPrefix);
+}
+exports.getConfig = getConfig;
+/**
+ * 注册配置信息.
+ * @param defaultConfig 默认值, 模块会根据默认值来映射环境变量，默认值所有的属性都不能是 undefined，否则无法映射.
+ * @param envPrefix 环境变量前缀.
+ * @param validation 校验规则，如果有值，初始化的时候会对配置进行校验
+ * @returns 映射了环境变量后的配置
+ */
+function registerConfig(defaultConfig, envPrefix, validation) {
+    if (configEnvMap.has(envPrefix)) {
+        throw new exception_1.ConfigException(`The prefix "${envPrefix}" has already been registered`);
+    }
+    // 环境变量匹配
+    for (const propName in defaultConfig) {
+        const defaultVal = defaultConfig[propName];
+        const envName = buildEnvName(envPrefix, propName);
+        const envVal = process.env[envName];
+        console.log(`[CONFIG]prefix：${envPrefix}，env variable：${envName} ,value：${envVal}，mapping property：${propName}`);
+        if (!envVal) {
+            continue;
+        }
+        const finalVal = (0, convert_1.convert)(envVal, defaultVal);
+        defaultConfig[propName] = finalVal;
+    }
+    // 校验
+    if (validation) {
+        try {
+            (0, validation_1.validate)(defaultConfig, validation);
+        }
+        catch (e) {
+            console.error(e);
+            throw new exception_1.ConfigException(`Error in verifying configuration information, configuration prefix：${envPrefix}`);
+        }
+    }
+    configEnvMap.set(envPrefix, defaultConfig);
+    return defaultConfig;
+}
+exports.registerConfig = registerConfig;
+function buildEnvName(envPrefix, propName) {
+    let part2 = propName.replace(/[A-Z]+/g, subStr => `_${subStr}`);
+    if (part2.startsWith('_')) {
+        part2 = part2.substring(1);
+    }
+    return `${envPrefix.toUpperCase()}_${part2.toUpperCase()}`;
+}
+tslib_1.__exportStar(require("./exception"), exports);

package/dist/http-client/index.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getJson = exports.postJson = exports.doRequest = void 0;
+const http_1 = require("http");
+const https_1 = require("https");
+const url_1 = require("url");
+/**
+ * 发送 http 请求.
+ * @param opts
+ * @returns
+ */
+function doRequest(opts) {
+    return new Promise((resolve, reject) => {
+        const url = new url_1.URL(opts.url);
+        // query
+        if (opts.query) {
+            Object.entries(opts.query).forEach(entry => {
+                const [key, val] = entry;
+                if (typeof val === 'string') {
+                    url.searchParams.append(key, val);
+                }
+                else if (Array.isArray(val)) {
+                    val.forEach(v => url.searchParams.append(key, v));
+                }
+                else {
+                    throw new Error(`The value is neither of string nor string[] type：${val}`);
+                }
+            });
+        }
+        const request = url.protocol === 'https:' ? https_1.request : http_1.request;
+        const req = request(url, {
+            method: opts.method,
+            headers: opts.headers,
+            timeout: opts.timeout && opts.timeout > 0 ? opts.timeout : 5000,
+            rejectUnauthorized: false
+        }, res => {
+            const chunks = [];
+            res.on('error', reject);
+            res.on('data', chunk => chunks.push(chunk));
+            res.on('end', () => {
+                // 重定向支持
+                if (opts.followRedirect) {
+                    // 301、302、303、307、308
+                    if (res.statusCode === 301 ||
+                        res.statusCode === 302 ||
+                        res.statusCode === 303 ||
+                        res.statusCode === 307 ||
+                        res.statusCode === 308) {
+                        if (res.headers.location) {
+                            // 重新请求，但是重定向标记改为 false ，只重定向一次，防止无限重定向造成死循环
+                            resolve(doRequest(Object.assign({}, opts, { url: res.headers.location, followRedirect: false })));
+                            return;
+                        }
+                    }
+                }
+                const buffer = Buffer.concat(chunks);
+                resolve({
+                    status: res.statusCode || 0,
+                    body: buffer,
+                    headers: res.headers
+                });
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => reject('Request timeout'));
+        if (opts.body) {
+            req.write(opts.body);
+        }
+        req.end();
+    });
+}
+exports.doRequest = doRequest;
+/**
+ * 发送 json 格式的 post 请求，body 是未序列化的普通对象，表示要发送的请求数据.
+ * @param opts
+ */
+async function postJson(opts) {
+    const headers = Object.assign({}, opts.headers || {}, {
+        'Content-Type': 'application/json; charset=utf-8'
+    });
+    const res = await doRequest({
+        url: opts.url,
+        query: opts.query,
+        headers: headers,
+        timeout: opts.timeout,
+        method: 'POST',
+        body: JSON.stringify(opts.body),
+        followRedirect: false
+    });
+    if (res.status !== 200) {
+        if (res.body.byteLength < 1024) {
+            throw new Error(`Request failed，status code：${res.status}，url：${opts.url}，body：${res.body.toString('utf-8')}`);
+        }
+        else {
+            throw new Error(`Request failed，status code：${res.status}，url：${opts.url}`);
+        }
+    }
+    const bodyText = res.body.toString('utf8');
+    if (!bodyText) {
+        return {};
+    }
+    return JSON.parse(bodyText);
+}
+exports.postJson = postJson;
+/**
+ * get 请求获取 json 格式数据.
+ * @param opts
+ */
+async function getJson(opts) {
+    const res = await doRequest({
+        url: opts.url,
+        query: opts.query,
+        headers: opts.headers,
+        timeout: opts.timeout,
+        method: 'GET',
+        followRedirect: true
+    });
+    if (res.status !== 200) {
+        if (res.body.byteLength < 1024) {
+            throw new Error(`Request failed，status code：${res.status}，url：${opts.url}，body：${res.body.toString('utf-8')}`);
+        }
+        else {
+            throw new Error(`Request failed，status code：${res.status}，url：${opts.url}`);
+        }
+    }
+    const bodyText = res.body.toString('utf8');
+    if (!bodyText) {
+        return {};
+    }
+    return JSON.parse(bodyText);
+}
+exports.getJson = getJson;

package/dist/i18n/ar.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ar = void 0;
+exports.ar = {
+    'validate-err-array': 'القيمة لست مصفوفة',
+    'validate-err-enum': 'يجب أن تكون القيمة واحدة من {}',
+    'validate-err-numer': 'القيمة ليست رقمًا',
+    'validate-err-max': 'يجب ألا تكون أكبر من {}',
+    'validate-err-min': 'يجب ألا تكون أصغر من {}',
+    'validate-err-empty': 'لا يمكن أن يكونارغًا',
+    'validate-err-string': 'القيمة ليست من نوع سلسلة الحروف',
+    'validate-err-incorrect-format': 'التنسيق غير صحيح',
+    'validate-err-no-length': 'تعذر العثور على خاصية "length"',
+    'validate-err-length-not-number': 'خاصية "length" ليست رقما',
+    'validate-err-min-length': 'لا يجوز أن يكن الطول أقل من {}',
+    'validate-err-max-length': 'لا يجوز أن يكون الطول أكبر من {}'
+};

package/dist/i18n/de.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.de = void 0;
+exports.de = {
+    'validate-err-array': 'Der Wert ist kein Array',
+    'validate-err-enum': 'Der Wert muss einer von sein',
+    'validate-err-numer': 'Der Wert ist keine Zahl',
+    'validate-err-max': 'Darf nicht größer als {} sein',
+    'validate-err-min': 'f nicht kleiner als {} sein',
+    'validate-err-empty': 'Darf nicht leer',
+    'validate-err-string': 'Der Wert ist kein Zeichenketten-Typ',
+    'validate-err-incorrect-format': 'Das Format ist nicht korrekt',
+    'validate-err-no-length': 'length kann nicht gefunden werden',
+    'validate-err-length-not-number': 'Eigenschaft length ist keine zahl',
+    'validate-err-min-length': 'Die L darf nicht kleiner als {} sein',
+    'validate-err-max-length': 'Die Länge nicht größer als {} sein'
+};

package/dist/i18n/en-us.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enUS = void 0;
+exports.enUS = {
+    'validate-err-array': 'Value is not a array type.',
+    'validate-err-enum': ' Value must be one of [{}].',
+    'validate-err-numer': 'Value is not a number type.',
+    'validate-err-max': 'Not greater than {}.',
+    'validate-err-min': 'Not less than {}.',
+    'validate-err-empty': 'Cannot be empty.',
+    'validate-err-string': 'Value is not a string type.',
+    'validate-err-incorrect-format': 'Incorrect format.',
+    'validate-err-no-length': 'Unable to find length field.',
+    'validate-err-length-not-number': 'Length field is not a number type.',
+    'validate-err-min-length': 'The length should not be less than {}.',
+    'validate-err-max-length': 'The length must not exceed {}.'
+};

package/dist/i18n/es.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.es = void 0;
+exports.es = {
+    'validate-err-array': 'El valor no es un arreglo',
+    'validate-err-enum': 'El valor debe ser uno de {}',
+    'validate-err-numer': 'El valor no es un número',
+    'validate-err-max': 'No debe ser mayor que {}',
+    'validate-err-min': 'No debe ser menor que {}',
+    'validate-err-empty': 'No puede estar vacío',
+    'validate-err-string': 'El valor no es un tipo de cadena',
+    'validate-err-incorrect-format': 'El formato no es correcto',
+    'validate-err-no-length': 'No se encontró la propiedad de longitud',
+    'validate-err-length-not-number': ' propiedad de longitud no es un número',
+    'validate-err-min-length': 'La longitud no debe ser menor que {}',
+    'validate-err-max-length': 'La longitud no debe ser mayor que'
+};

package/dist/i18n/fr.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fr = void 0;
+exports.fr = {
+    'validate-err-array': "La valeur n'est pas un tableau",
+    'validate-err-enum': "La valeur doit être l'un de {}",
+    'validate-err-numer': "La n'est pas un nombre",
+    'validate-err-max': 'Ne doit pas supérieur à {}',
+    'validate-err-min': 'Ne doit pas être inférieur à {}',
+    'validate-err-empty': 'Ne doit pas être vide',
+    'validate-err-string': "La valeur n'est pas de type chaîne de caractères",
+    'validate-err-incorrect-format': 'Format incorrect',
+    'validate-err-no-length': 'Impossible de trouver la propriété "length"',
+    'validate-err-length-not-number': `propriété "length" n'est pas un nombre`,
+    'validate-err-min-length': 'La longueur ne doit pas être infure {}',
+    'validate-err-max-length': 'La longueur ne doit pas être supérieure à {}'
+};