opticore-translator 1.0.0

package/dist/index.cjs

@@ -0,0 +1,136 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TranslationLoader: () => TranslationLoader
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/loaders/translation.loader.ts
+var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
+var import_opticore_logger = require("opticore-logger");
+var import_opticore_http_response = require("opticore-http-response");
+
+// src/core/config/logger/logger.config.ts
+var import_opticore_env_access = require("opticore-env-access");
+var loggerConfig = {
+  logLevels: [
+    import_opticore_env_access.getEnvVariable.logLevelInfo,
+    import_opticore_env_access.getEnvVariable.logLevelWarning,
+    import_opticore_env_access.getEnvVariable.logLevelSuccess,
+    import_opticore_env_access.getEnvVariable.logLevelError,
+    import_opticore_env_access.getEnvVariable.logLevelDebug
+  ],
+  transports: {
+    file: {
+      enabled: import_opticore_env_access.getEnvVariable.logFileEnabled,
+      maxSizeMB: import_opticore_env_access.getEnvVariable.logFileMaxSize,
+      rotate: import_opticore_env_access.getEnvVariable.logFileRotate
+    },
+    console: {
+      enabled: import_opticore_env_access.getEnvVariable.logConsoleEnabled
+    },
+    remote: {
+      enabled: import_opticore_env_access.getEnvVariable.logRemoteEnabled,
+      endpoint: import_opticore_env_access.getEnvVariable.logRemoteEndPoint
+    }
+  }
+};
+
+// src/domains/constants/local/translateLanguage.local.ts
+var import_opticore_env_access2 = require("opticore-env-access");
+var CTranslateLanguageLocal = import_opticore_env_access2.getEnvVariable.defaultLocal;
+
+// src/domains/constants/local.constant.ts
+var CLocal = CTranslateLanguageLocal;
+
+// src/core/loaders/translation.loader.ts
+var TranslationLoader = class {
+  /**
+   *
+   * @param directory
+   * @param defaultLocale
+   */
+  static loadTranslations(directory, defaultLocale = CLocal) {
+    this.defaultLocale = defaultLocale;
+    const files = import_fs.default.readdirSync(directory);
+    files.forEach((file) => {
+      if (file.endsWith(".json")) {
+        const locale = import_path.default.basename(file, ".json");
+        const filePath = import_path.default.join(directory, file);
+        try {
+          this.translations[locale] = JSON.parse(import_fs.default.readFileSync(filePath, "utf-8"));
+          this.logger.success("Translation Loaded", `Translations loaded for locale: ${locale}`);
+        } catch (error) {
+          this.logger.error(error.message, `Error loading translations for ${locale}`, "Translation error", error.stack, import_opticore_http_response.HttpStatusCode.INTERNAL_SERVER_ERROR);
+        }
+      }
+    });
+  }
+  /**
+   *
+   * @param template
+   * @param params
+   */
+  static formatMessage(template, params) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => {
+      const value = params[key];
+      if (Array.isArray(value)) {
+        return value.join(", ");
+      }
+      const formattedValue = value !== void 0 ? value.toString() : `{${key}}`;
+      this.logger.info("Formatting message", `Replacing {${key}} with: ${formattedValue}`);
+      return formattedValue;
+    });
+  }
+  /**
+   *
+   * @param key
+   * @param locale
+   * @param params
+   *
+   * using example :
+   * const errorMessage = TranslationLoader.t('mongoServerError', 'en', { dbHost: '127.0.0.1' });
+   */
+  static t(key, locale = this.defaultLocale, params = {}) {
+    var _a, _b;
+    const message = ((_a = this.translations[locale]) == null ? void 0 : _a[key]) || ((_b = this.translations[this.defaultLocale]) == null ? void 0 : _b[key]) || key;
+    return this.formatMessage(message, params);
+  }
+};
+TranslationLoader.translations = {};
+TranslationLoader.defaultLocale = CLocal;
+TranslationLoader.logger = new import_opticore_logger.LoggerCore(loggerConfig);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TranslationLoader
+});

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+declare class TranslationLoader {
+    private static translations;
+    private static defaultLocale;
+    private static logger;
+    /**
+     *
+     * @param directory
+     * @param defaultLocale
+     */
+    static loadTranslations(directory: string, defaultLocale?: string): void;
+    /**
+     *
+     * @param template
+     * @param params
+     */
+    static formatMessage(template: string, params: Record<string, any>): string;
+    /**
+     *
+     * @param key
+     * @param locale
+     * @param params
+     *
+     * using example :
+     * const errorMessage = TranslationLoader.t('mongoServerError', 'en', { dbHost: '127.0.0.1' });
+     */
+    static t(key: string, locale?: string, params?: Record<string, string>): string;
+}
+
+export { TranslationLoader };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+declare class TranslationLoader {
+    private static translations;
+    private static defaultLocale;
+    private static logger;
+    /**
+     *
+     * @param directory
+     * @param defaultLocale
+     */
+    static loadTranslations(directory: string, defaultLocale?: string): void;
+    /**
+     *
+     * @param template
+     * @param params
+     */
+    static formatMessage(template: string, params: Record<string, any>): string;
+    /**
+     *
+     * @param key
+     * @param locale
+     * @param params
+     *
+     * using example :
+     * const errorMessage = TranslationLoader.t('mongoServerError', 'en', { dbHost: '127.0.0.1' });
+     */
+    static t(key: string, locale?: string, params?: Record<string, string>): string;
+}
+
+export { TranslationLoader };

package/dist/index.js

@@ -0,0 +1,99 @@
+// src/core/loaders/translation.loader.ts
+import fs from "fs";
+import path from "path";
+import { LoggerCore } from "opticore-logger";
+import { HttpStatusCode } from "opticore-http-response";
+
+// src/core/config/logger/logger.config.ts
+import { getEnvVariable } from "opticore-env-access";
+var loggerConfig = {
+  logLevels: [
+    getEnvVariable.logLevelInfo,
+    getEnvVariable.logLevelWarning,
+    getEnvVariable.logLevelSuccess,
+    getEnvVariable.logLevelError,
+    getEnvVariable.logLevelDebug
+  ],
+  transports: {
+    file: {
+      enabled: getEnvVariable.logFileEnabled,
+      maxSizeMB: getEnvVariable.logFileMaxSize,
+      rotate: getEnvVariable.logFileRotate
+    },
+    console: {
+      enabled: getEnvVariable.logConsoleEnabled
+    },
+    remote: {
+      enabled: getEnvVariable.logRemoteEnabled,
+      endpoint: getEnvVariable.logRemoteEndPoint
+    }
+  }
+};
+
+// src/domains/constants/local/translateLanguage.local.ts
+import { getEnvVariable as getEnvVariable2 } from "opticore-env-access";
+var CTranslateLanguageLocal = getEnvVariable2.defaultLocal;
+
+// src/domains/constants/local.constant.ts
+var CLocal = CTranslateLanguageLocal;
+
+// src/core/loaders/translation.loader.ts
+var TranslationLoader = class {
+  /**
+   *
+   * @param directory
+   * @param defaultLocale
+   */
+  static loadTranslations(directory, defaultLocale = CLocal) {
+    this.defaultLocale = defaultLocale;
+    const files = fs.readdirSync(directory);
+    files.forEach((file) => {
+      if (file.endsWith(".json")) {
+        const locale = path.basename(file, ".json");
+        const filePath = path.join(directory, file);
+        try {
+          this.translations[locale] = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+          this.logger.success("Translation Loaded", `Translations loaded for locale: ${locale}`);
+        } catch (error) {
+          this.logger.error(error.message, `Error loading translations for ${locale}`, "Translation error", error.stack, HttpStatusCode.INTERNAL_SERVER_ERROR);
+        }
+      }
+    });
+  }
+  /**
+   *
+   * @param template
+   * @param params
+   */
+  static formatMessage(template, params) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => {
+      const value = params[key];
+      if (Array.isArray(value)) {
+        return value.join(", ");
+      }
+      const formattedValue = value !== void 0 ? value.toString() : `{${key}}`;
+      this.logger.info("Formatting message", `Replacing {${key}} with: ${formattedValue}`);
+      return formattedValue;
+    });
+  }
+  /**
+   *
+   * @param key
+   * @param locale
+   * @param params
+   *
+   * using example :
+   * const errorMessage = TranslationLoader.t('mongoServerError', 'en', { dbHost: '127.0.0.1' });
+   */
+  static t(key, locale = this.defaultLocale, params = {}) {
+    var _a, _b;
+    const message = ((_a = this.translations[locale]) == null ? void 0 : _a[key]) || ((_b = this.translations[this.defaultLocale]) == null ? void 0 : _b[key]) || key;
+    return this.formatMessage(message, params);
+  }
+};
+TranslationLoader.translations = {};
+TranslationLoader.defaultLocale = CLocal;
+TranslationLoader.logger = new LoggerCore(loggerConfig);
+export {
+  TranslationLoader
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "opticore-translator",
+  "version": "1.0.0",
+  "description": "opticore translator to translate according language",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsup"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guyzoum77/opticore-translator.git"
+  },
+  "keywords": [
+    "opticore"
+  ],
+  "author": "Guy-serge Kouacou",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/guyzoum77/opticore-translator/issues"
+  },
+  "homepage": "https://github.com/guyzoum77/opticore-translator#readme",
+  "dependencies": {
+    "ansi-colors": "^4.1.3",
+    "chalk": "^5.4.1",
+    "opticore-env-access": "^1.0.2",
+    "opticore-http-response": "^1.0.3",
+    "opticore-logger": "^1.0.11"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.5",
+    "tslib": "^2.8.1",
+    "tsup": "^8.4.0",
+    "typescript": "^5.4.5"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "noImplicitAny": true,
+    "esModuleInterop": true,
+    "strictNullChecks": true,
+    "module": "commonjs",
+    "pretty": true,
+    "target": "es2017",
+    "moduleResolution": "node",
+    "declaration": true,
+    "isolatedModules": true,
+    "noEmit": false,
+    "types": ["reflect-metadata", "node"],
+    "experimentalDecorators": true,
+    "outDir": "./dist",
+    "importHelpers": true,
+    "resolveJsonModule": true,
+    "baseUrl": "src",
+    "paths": {
+      "@translator/*": ["*"],
+    }
+  },
+  "include": ["src/**/*.ts", "src/**/*.json", ".env"],
+  "exclude": ["node_modules"]
+}