@diia-inhouse/i18n 2.3.0 → 2.8.2

package/LICENCE.md

@@ -18,40 +18,40 @@ or has expressed by any other means his willingness to license under the EUPL.
 
 In this Licence, the following terms have the following meaning:
 
--   ‘The Licence’: this Licence.
+- ‘The Licence’: this Licence.
 
--   ‘The Original Work’: the work or software distributed or communicated by the
-    Licensor under this Licence, available as Source Code and also as Executable
-    Code as the case may be.
+- ‘The Original Work’: the work or software distributed or communicated by the
+  Licensor under this Licence, available as Source Code and also as Executable
+  Code as the case may be.
 
--   ‘Derivative Works’: the works or software that could be created by the
-    Licensee, based upon the Original Work or modifications thereof. This Licence
-    does not define the extent of modification or dependence on the Original Work
-    required in order to classify a work as a Derivative Work; this extent is
-    determined by copyright law applicable in the country mentioned in Article 15.
+- ‘Derivative Works’: the works or software that could be created by the
+  Licensee, based upon the Original Work or modifications thereof. This Licence
+  does not define the extent of modification or dependence on the Original Work
+  required in order to classify a work as a Derivative Work; this extent is
+  determined by copyright law applicable in the country mentioned in Article 15.
 
--   ‘The Work’: the Original Work or its Derivative Works.
+- ‘The Work’: the Original Work or its Derivative Works.
 
--   ‘The Source Code’: the human-readable form of the Work which is the most
-    convenient for people to study and modify.
+- ‘The Source Code’: the human-readable form of the Work which is the most
+  convenient for people to study and modify.
 
--   ‘The Executable Code’: any code which has generally been compiled and which is
-    meant to be interpreted by a computer as a program.
+- ‘The Executable Code’: any code which has generally been compiled and which is
+  meant to be interpreted by a computer as a program.
 
--   ‘The Licensor’: the natural or legal person that distributes or communicates
-    the Work under the Licence.
+- ‘The Licensor’: the natural or legal person that distributes or communicates
+  the Work under the Licence.
 
--   ‘Contributor(s)’: any natural or legal person who modifies the Work under the
-    Licence, or otherwise contributes to the creation of a Derivative Work.
+- ‘Contributor(s)’: any natural or legal person who modifies the Work under the
+  Licence, or otherwise contributes to the creation of a Derivative Work.
 
--   ‘The Licensee’ or ‘You’: any natural or legal person who makes any usage of
-    the Work under the terms of the Licence.
+- ‘The Licensee’ or ‘You’: any natural or legal person who makes any usage of
+  the Work under the terms of the Licence.
 
--   ‘Distribution’ or ‘Communication’: any act of selling, giving, lending,
-    renting, distributing, communicating, transmitting, or otherwise making
-    available, online or offline, copies of the Work or providing access to its
-    essential functionalities at the disposal of any other natural or legal
-    person.
+- ‘Distribution’ or ‘Communication’: any act of selling, giving, lending,
+  renting, distributing, communicating, transmitting, or otherwise making
+  available, online or offline, copies of the Work or providing access to its
+  essential functionalities at the disposal of any other natural or legal
+  person.
 
 2. Scope of the rights granted by the Licence
 
@@ -59,15 +59,15 @@ The Licensor hereby grants You a worldwide, royalty-free, non-exclusive,
 sublicensable licence to do the following, for the duration of copyright vested
 in the Original Work:
 
--   use the Work in any circumstance and for all usage,
--   reproduce the Work,
--   modify the Work, and make Derivative Works based upon the Work,
--   communicate to the public, including the right to make available or display
-    the Work or copies thereof to the public and perform publicly, as the case may
-    be, the Work,
--   distribute the Work or copies thereof,
--   lend and rent the Work or copies thereof,
--   sublicense rights in the Work or copies thereof.
+- use the Work in any circumstance and for all usage,
+- reproduce the Work,
+- modify the Work, and make Derivative Works based upon the Work,
+- communicate to the public, including the right to make available or display
+  the Work or copies thereof to the public and perform publicly, as the case may
+  be, the Work,
+- distribute the Work or copies thereof,
+- lend and rent the Work or copies thereof,
+- sublicense rights in the Work or copies thereof.
 
 Those rights can be exercised on any media, supports and formats, whether now
 known or later invented, as far as the applicable law permits so.
@@ -240,43 +240,43 @@ their choice.
 
 Without prejudice to specific agreement between parties,
 
--   any litigation resulting from the interpretation of this License, arising
-    between the European Union institutions, bodies, offices or agencies, as a
-    Licensor, and any Licensee, will be subject to the jurisdiction of the Court
-    of Justice of the European Union, as laid down in article 272 of the Treaty on
-    the Functioning of the European Union,
+- any litigation resulting from the interpretation of this License, arising
+  between the European Union institutions, bodies, offices or agencies, as a
+  Licensor, and any Licensee, will be subject to the jurisdiction of the Court
+  of Justice of the European Union, as laid down in article 272 of the Treaty on
+  the Functioning of the European Union,
 
--   any litigation arising between other parties and resulting from the
-    interpretation of this License, will be subject to the exclusive jurisdiction
-    of the competent court where the Licensor resides or conducts its primary
-    business.
+- any litigation arising between other parties and resulting from the
+  interpretation of this License, will be subject to the exclusive jurisdiction
+  of the competent court where the Licensor resides or conducts its primary
+  business.
 
 15. Applicable Law
 
 Without prejudice to specific agreement between parties,
 
--   this Licence shall be governed by the law of the European Union Member State
-    where the Licensor has his seat, resides or has his registered office,
+- this Licence shall be governed by the law of the European Union Member State
+  where the Licensor has his seat, resides or has his registered office,
 
--   this licence shall be governed by Belgian law if the Licensor has no seat,
-    residence or registered office inside a European Union Member State.
+- this licence shall be governed by Belgian law if the Licensor has no seat,
+  residence or registered office inside a European Union Member State.
 
 Appendix
 
 ‘Compatible Licences’ according to Article 5 EUPL are:
 
--   GNU General Public License (GPL) v. 2, v. 3
--   GNU Affero General Public License (AGPL) v. 3
--   Open Software License (OSL) v. 2.1, v. 3.0
--   Eclipse Public License (EPL) v. 1.0
--   CeCILL v. 2.0, v. 2.1
--   Mozilla Public Licence (MPL) v. 2
--   GNU Lesser General Public Licence (LGPL) v. 2.1, v. 3
--   Creative Commons Attribution-ShareAlike v. 3.0 Unported (CC BY-SA 3.0) for
-    works other than software
--   European Union Public Licence (EUPL) v. 1.1, v. 1.2
--   Québec Free and Open-Source Licence — Reciprocity (LiLiQ-R) or Strong
-    Reciprocity (LiLiQ-R+).
+- GNU General Public License (GPL) v. 2, v. 3
+- GNU Affero General Public License (AGPL) v. 3
+- Open Software License (OSL) v. 2.1, v. 3.0
+- Eclipse Public License (EPL) v. 1.0
+- CeCILL v. 2.0, v. 2.1
+- Mozilla Public Licence (MPL) v. 2
+- GNU Lesser General Public Licence (LGPL) v. 2.1, v. 3
+- Creative Commons Attribution-ShareAlike v. 3.0 Unported (CC BY-SA 3.0) for
+  works other than software
+- European Union Public Licence (EUPL) v. 1.1, v. 1.2
+- Québec Free and Open-Source Licence — Reciprocity (LiLiQ-R) or Strong
+  Reciprocity (LiLiQ-R+).
 
 The European Commission may update this Appendix to later versions of the above
 licences without producing a new version of the EUPL, as long as they provide

package/dist/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./services"), exports);
+__exportStar(require("./metrics"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA0B;AAE1B,4CAAyB"}

package/dist/interfaces/metrics/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/interfaces/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/metrics/index.ts"],"names":[],"mappings":""}

package/dist/interfaces/services/i18n.js

@@ -1,3 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCALE = void 0;
+exports.LOCALE = {
+    uk: 'uk',
+    en: 'en',
+};
 //# sourceMappingURL=i18n.js.map

package/dist/interfaces/services/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/interfaces/services/i18n.ts"],"names":[],"mappings":""}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/interfaces/services/i18n.ts"],"names":[],"mappings":";;;AAOa,QAAA,MAAM,GAAG;IAClB,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;CACX,CAAA"}

package/dist/metrics/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.missedInterpolationParamsTotalMetric = exports.missedLocaleKeysTotalMetric = void 0;
+const diia_metrics_1 = require("@diia-inhouse/diia-metrics");
+exports.missedLocaleKeysTotalMetric = new diia_metrics_1.Counter('diia_i18n_missed_locale_keys_total', ['locale', 'status'], 'Track amount of missed locale keys');
+exports.missedInterpolationParamsTotalMetric = new diia_metrics_1.Counter('diia_i18n_missed_interpolation_params_total', ['locale'], 'Track amount of missed interpolation params');
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":";;;AAEA,6DAAoD;AAEvC,QAAA,2BAA2B,GAAG,IAAI,sBAAO,CAClD,oCAAoC,EACpC,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACpB,oCAAoC,CACvC,CAAA;AAEY,QAAA,oCAAoC,GAAG,IAAI,sBAAO,CAC3D,6CAA6C,EAC7C,CAAC,QAAQ,CAAC,EACV,6CAA6C,CAChD,CAAA"}

package/dist/services/i18n.js

@@ -1,27 +1,55 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.I18nService = void 0;
+const he_1 = __importDefault(require("he"));
 const i18n_1 = require("i18n");
+const i18n_2 = require("../interfaces/services/i18n");
+/**
+ * @deprecated I18nService is deprecated. Use I18nextService instead.
+ *
+ * Migration guide:
+ * 1. Replace I18nService with I18nextService in your constructor
+ * 2. Use the ns() method to create namespaced translation functions
+ * 3. Replace get() calls with the namespaced translation function
+ *
+ * Example:
+ * ```typescript
+ * // Old way
+ * constructor(private readonly i18n: I18nService) {}
+ * const text = this.i18n.get('key.path.to.translation')
+ *
+ * // New way
+ * constructor(private readonly i18next: I18nextService) {}
+ * private readonly t = this.i18next.ns<LocalesType>('namespace/path')
+ * const text = this.t('key.path.to.translation')
+ * ```
+ */
 class I18nService {
     asyncLocalStorage;
     i18n;
     headerName = 'appLocale';
-    constructor(asyncLocalStorage) {
+    constructor(asyncLocalStorage, localesDirectory = './dist/locales') {
         this.asyncLocalStorage = asyncLocalStorage;
         this.i18n = new i18n_1.I18n();
         this.i18n.configure({
-            directory: './dist/locales',
+            directory: localesDirectory,
             fallbacks: {
-                'en-*': 'en',
-                'uk-*': 'uk',
+                'en-*': i18n_2.LOCALE.en,
+                'uk-*': i18n_2.LOCALE.uk,
             },
             autoReload: false,
             updateFiles: false,
             objectNotation: true,
             header: this.headerName,
-            defaultLocale: 'uk',
+            defaultLocale: i18n_2.LOCALE.uk,
         });
     }
+    /**
+     * @deprecated Use I18nextService with namespaced translation functions instead.
+     */
     get(key, valuesToReplace, returnKeyIfNotFound = true) {
         const locale = this.getLocaleFromStore();
         // eslint-disable-next-line no-underscore-dangle
@@ -29,8 +57,11 @@ class I18nService {
         if (!foundItem && returnKeyIfNotFound) {
             return key;
         }
-        return foundItem;
+        return he_1.default.decode(foundItem);
     }
+    /**
+     * @deprecated Use I18nextService.getLocale() instead.
+     */
     getLocale() {
         const locale = this.getLocaleFromStore();
         return this.i18n.setLocale({}, locale);

package/dist/services/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/services/i18n.ts"],"names":[],"mappings":";;;AAEA,+BAAyC;AAMzC,MAAa,WAAW;IAKS;IAJZ,IAAI,CAAM;IAEV,UAAU,GAAG,WAAW,CAAA;IAEzC,YAA6B,iBAA6C;QAA7C,sBAAiB,GAAjB,iBAAiB,CAA4B;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,WAAI,EAAE,CAAA;QAEtB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YAChB,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE;gBACP,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,IAAI;aACf;YACD,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,KAAK;YAClB,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,IAAI,CAAC,UAAU;YACvB,aAAa,EAAE,IAAI;SACtB,CAAC,CAAA;IACN,CAAC;IAED,GAAG,CAAC,GAAe,EAAE,eAA8B,EAAE,mBAAmB,GAAG,IAAI;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;QAExC,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAU,GAAG,EAAE,EAAE,eAAe,IAAI,EAAE,CAAC,CAAA;QAEtF,IAAI,CAAC,SAAS,IAAI,mBAAmB,EAAE;YACnC,OAAe,GAAG,CAAA;SACrB;QAED,OAAO,SAAS,CAAA;IACpB,CAAC;IAED,SAAS;QACL,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;QAExC,OAAyB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAE,CAAA;IAC7D,CAAC;IAEO,kBAAkB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAA;QAE/C,OAAO,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;IAClD,CAAC;CACJ;AA9CD,kCA8CC"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/services/i18n.ts"],"names":[],"mappings":";;;;;;AAEA,4CAAmB;AACnB,+BAAyC;AAIzC,sDAA6D;AAE7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,WAAW;IAMC;IALJ,IAAI,CAAM;IAEV,UAAU,GAAG,WAAW,CAAA;IAEzC,YACqB,iBAA6C,EAC9D,gBAAgB,GAAG,gBAAgB;QADlB,sBAAiB,GAAjB,iBAAiB,CAA4B;QAG9D,IAAI,CAAC,IAAI,GAAG,IAAI,WAAI,EAAE,CAAA;QAEtB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YAChB,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE;gBACP,MAAM,EAAE,aAAM,CAAC,EAAE;gBACjB,MAAM,EAAE,aAAM,CAAC,EAAE;aACpB;YACD,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,KAAK;YAClB,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,IAAI,CAAC,UAAU;YACvB,aAAa,EAAE,aAAM,CAAC,EAAE;SAC3B,CAAC,CAAA;IACN,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAe,EAAE,eAA8B,EAAE,mBAAmB,GAAG,IAAI;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;QAExC,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAa,EAAE,EAAE,eAAe,IAAI,EAAE,CAAC,CAAA;QAExF,IAAI,CAAC,SAAS,IAAI,mBAAmB,EAAE,CAAC;YACpC,OAAO,GAAa,CAAA;QACxB,CAAC;QAED,OAAO,YAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,SAAS;QACL,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;QAExC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAsB,CAAA;IAC/D,CAAC;IAEO,kBAAkB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAA;QAE/C,OAAO,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;IAClD,CAAC;CACJ;AAvDD,kCAuDC"}

package/dist/services/i18next.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.I18nextService = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const i18next = __importStar(require("i18next"));
+const i18next_fs_backend_1 = __importDefault(require("i18next-fs-backend"));
+const i18n_1 = require("../interfaces/services/i18n");
+const metrics_1 = require("../metrics");
+class I18nextService {
+    localesDirectory;
+    initOptions;
+    asyncLocalStorage;
+    logger;
+    i18nextInstance;
+    headerName = 'appLocale';
+    constructor(localesDirectory = './dist/locales', initOptions = {}, asyncLocalStorage, logger) {
+        this.localesDirectory = localesDirectory;
+        this.initOptions = initOptions;
+        this.asyncLocalStorage = asyncLocalStorage;
+        this.logger = logger;
+        this.i18nextInstance = this.initializeI18next();
+    }
+    ns(namespace) {
+        return (key, options = {}) => {
+            const locale = this.getLocaleFromStore();
+            return this.i18nextInstance.t(key, {
+                lng: locale,
+                ns: namespace,
+                ...options,
+            });
+        };
+    }
+    get(key, options = {}) {
+        const locale = this.getLocaleFromStore();
+        return this.i18nextInstance.t(key, {
+            lng: locale,
+            ...options,
+        });
+    }
+    getLocale() {
+        return this.getLocaleFromStore();
+    }
+    getInstance() {
+        return this.i18nextInstance;
+    }
+    getLocaleFromStore() {
+        const store = this.asyncLocalStorage.getStore();
+        return store?.headers?.[this.headerName] || i18n_1.LOCALE.uk;
+    }
+    initializeI18next() {
+        const namespaces = this.findAllNamespaces();
+        this.logger.info(`Found namespaces: ${namespaces.join(', ')}`);
+        const defaultOptions = {
+            fallbackLng: i18n_1.LOCALE.uk,
+            lng: i18n_1.LOCALE.uk,
+            returnEmptyString: false,
+            returnNull: false,
+            returnObjects: true,
+            initImmediate: false,
+            initAsync: false,
+            saveMissing: true,
+            interpolation: {
+                escapeValue: false,
+            },
+            backend: {
+                loadPath: node_path_1.default.join(this.localesDirectory, '{{lng}}/{{ns}}.json'),
+            },
+            ns: namespaces.length > 0 ? namespaces : ['translation'],
+            defaultNS: namespaces.length > 0 ? namespaces[0] : 'translation',
+            missingKeyHandler: (_lngs, ns, key, fallbackValue) => {
+                const requestedLocale = this.getLocaleFromStore();
+                const isFallbackUsed = fallbackValue && fallbackValue !== key;
+                if (isFallbackUsed) {
+                    metrics_1.missedLocaleKeysTotalMetric.increment({ locale: requestedLocale, status: 'fallback_used' });
+                    this.logger.warn(`Using fallback for key: ${key} in locale: ${requestedLocale}, namespace: ${ns}`);
+                }
+                else {
+                    metrics_1.missedLocaleKeysTotalMetric.increment({ locale: requestedLocale, status: 'missing' });
+                    this.logger.error(`Missing translation key: ${key} for locale: ${requestedLocale}, namespace: ${ns}`);
+                }
+            },
+            missingInterpolationHandler: (text, value) => {
+                const requestedLocale = this.getLocaleFromStore();
+                metrics_1.missedInterpolationParamsTotalMetric.increment({ locale: requestedLocale });
+                this.logger.error(`Missing interpolation parameter: ${value[1]} in text: ${text} for locale: ${requestedLocale}`);
+            },
+        };
+        const mergedOptions = { ...defaultOptions, ...this.initOptions };
+        const instance = i18next.createInstance();
+        void instance.use(i18next_fs_backend_1.default).init(mergedOptions);
+        return instance;
+    }
+    findAllNamespaces() {
+        const namespaces = [];
+        try {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            const dirs = (0, node_fs_1.readdirSync)(this.localesDirectory); // nosemgrep: eslint.detect-non-literal-fs-filename
+            const langDirs = dirs.filter((dir) => 
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            (0, node_fs_1.lstatSync)(node_path_1.default.join(this.localesDirectory, dir)).isDirectory());
+            for (const lang of langDirs) {
+                const langDir = node_path_1.default.join(this.localesDirectory, lang);
+                this.findJsonFiles(langDir, namespaces);
+            }
+        }
+        catch (err) {
+            this.logger.error(`Error finding namespaces: ${err}`);
+        }
+        return namespaces;
+    }
+    findJsonFiles(dir, namespaces, prefix = '') {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        const entries = (0, node_fs_1.readdirSync)(dir); // nosemgrep: eslint.detect-non-literal-fs-filename
+        for (const entry of entries) {
+            const fullPath = node_path_1.default.join(dir, entry);
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            const isDir = (0, node_fs_1.lstatSync)(fullPath).isDirectory(); // nosemgrep: eslint.detect-non-literal-fs-filename
+            if (isDir) {
+                this.findJsonFiles(fullPath, namespaces, `${prefix}${entry}/`);
+            }
+            else if (entry.endsWith('.json')) {
+                const ns = `${prefix}${entry.replace('.json', '')}`;
+                if (!namespaces.includes(ns)) {
+                    namespaces.push(ns);
+                }
+            }
+        }
+    }
+}
+exports.I18nextService = I18nextService;
+//# sourceMappingURL=i18next.js.map

package/dist/services/i18next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18next.js","sourceRoot":"","sources":["../../src/services/i18next.ts"],"names":[],"mappings":"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"}

package/dist/services/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./i18n"), exports);
+__exportStar(require("./i18next"), exports);
 //# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AAEtB,4CAAyB"}

package/dist/types/index.d.ts

@@ -1 +1,2 @@
 export * from './services';
+export * from './metrics';

package/dist/types/interfaces/metrics/index.d.ts

@@ -0,0 +1,8 @@
+import { LocaleType } from '../services/i18n';
+export interface MissedLocaleKeysTotalLabelsMap {
+    locale: LocaleType;
+    status: 'missing' | 'fallback_used';
+}
+export interface MissedInterpolationParamsTotalLabelsMap {
+    locale: LocaleType;
+}

package/dist/types/interfaces/services/i18n.d.ts

@@ -1,2 +1,12 @@
 import { Paths } from 'type-fest';
-export type I18nKey<L> = L extends object ? Paths<L> : string;
+/**
+ * @deprecated I18nKey is deprecated along with I18nService. Use I18nextService with TranslationFunction<T> instead.
+ */
+export type I18nKey<L> = L extends object ? Paths<L, {
+    maxRecursionDepth: 15;
+}> : string;
+export declare const LOCALE: {
+    uk: string;
+    en: string;
+};
+export type LocaleType = (typeof LOCALE)[keyof typeof LOCALE];

package/dist/types/metrics/index.d.ts

@@ -0,0 +1,4 @@
+import { MissedInterpolationParamsTotalLabelsMap, MissedLocaleKeysTotalLabelsMap } from 'src/interfaces/metrics';
+import { Counter } from '@diia-inhouse/diia-metrics';
+export declare const missedLocaleKeysTotalMetric: Counter<MissedLocaleKeysTotalLabelsMap>;
+export declare const missedInterpolationParamsTotalMetric: Counter<MissedInterpolationParamsTotalLabelsMap>;

package/dist/types/services/i18n.d.ts

@@ -1,14 +1,39 @@
-/// <reference types="node" />
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { Replacements } from 'i18n';
 import { AlsData } from '@diia-inhouse/types';
 import { I18nKey } from '../interfaces/services/i18n';
+/**
+ * @deprecated I18nService is deprecated. Use I18nextService instead.
+ *
+ * Migration guide:
+ * 1. Replace I18nService with I18nextService in your constructor
+ * 2. Use the ns() method to create namespaced translation functions
+ * 3. Replace get() calls with the namespaced translation function
+ *
+ * Example:
+ * ```typescript
+ * // Old way
+ * constructor(private readonly i18n: I18nService) {}
+ * const text = this.i18n.get('key.path.to.translation')
+ *
+ * // New way
+ * constructor(private readonly i18next: I18nextService) {}
+ * private readonly t = this.i18next.ns<LocalesType>('namespace/path')
+ * const text = this.t('key.path.to.translation')
+ * ```
+ */
 export declare class I18nService<L = string> {
     private readonly asyncLocalStorage;
     private readonly i18n;
     private readonly headerName;
-    constructor(asyncLocalStorage: AsyncLocalStorage<AlsData>);
+    constructor(asyncLocalStorage: AsyncLocalStorage<AlsData>, localesDirectory?: string);
+    /**
+     * @deprecated Use I18nextService with namespaced translation functions instead.
+     */
     get(key: I18nKey<L>, valuesToReplace?: Replacements, returnKeyIfNotFound?: boolean): string;
+    /**
+     * @deprecated Use I18nextService.getLocale() instead.
+     */
     getLocale(): string;
     private getLocaleFromStore;
 }

package/dist/types/services/i18next.d.ts

@@ -0,0 +1,25 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import * as i18next from 'i18next';
+import { AlsData, Logger } from '@diia-inhouse/types';
+type DotNestedKeys<T> = T extends object ? {
+    [K in keyof T]: K extends string ? (T[K] extends object ? `${K}.${DotNestedKeys<T[K]>}` | K : K) : never;
+}[keyof T & string] : '';
+export type TranslationFunction<TResource> = <K extends DotNestedKeys<TResource>>(key: K, options?: i18next.TOptions) => string;
+export declare class I18nextService {
+    private readonly localesDirectory;
+    private readonly initOptions;
+    private readonly asyncLocalStorage;
+    private readonly logger;
+    private readonly i18nextInstance;
+    private readonly headerName;
+    constructor(localesDirectory: string | undefined, initOptions: Partial<i18next.InitOptions> | undefined, asyncLocalStorage: AsyncLocalStorage<AlsData>, logger: Logger);
+    ns<TResource>(namespace: string): TranslationFunction<TResource>;
+    get(key: string, options?: object): string;
+    getLocale(): string;
+    getInstance(): i18next.i18n;
+    private getLocaleFromStore;
+    private initializeI18next;
+    private findAllNamespaces;
+    private findJsonFiles;
+}
+export {};

package/dist/types/services/index.d.ts

@@ -1 +1,2 @@
 export * from './i18n';
+export * from './i18next';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@diia-inhouse/i18n",
-    "version": "2.3.0",
+    "version": "2.8.2",
     "description": "Internationalization package",
     "repository": "https://github.com/diia-open-source/be-pkg-i18n.git",
     "license": "SEE LICENSE IN LICENSE.md",
@@ -10,19 +10,20 @@
     "files": [
         "dist"
     ],
+    "engines": {
+        "node": ">=22"
+    },
     "scripts": {
         "prebuild": "rimraf dist",
         "build": "tsc",
         "find-circulars": "madge --circular ./",
-        "lint": "eslint --ext .ts . && prettier --check .",
-        "lint-fix": "eslint '*/**/*.{js,ts}' --fix && prettier --write .",
+        "lint": "eslint . && prettier --check .",
+        "lint-fix": "eslint . --fix && prettier --write .",
         "lint:lockfile": "lockfile-lint --path package-lock.json --allowed-hosts registry.npmjs.org --validate-https",
         "prepare": "npm run build",
         "semantic-release": "semantic-release",
-        "start": "npm run build && node dist/index.js",
-        "test": "jest",
-        "test:coverage": "jest --coverage",
-        "test:unit": "npm run test --selectProjects unit --"
+        "test": "vitest run",
+        "test:watch": "vitest watch"
     },
     "commitlint": {
         "extends": "@diia-inhouse/configs/dist/commitlint"
@@ -50,33 +51,38 @@
         ],
         "extends": "@diia-inhouse/configs/dist/semantic-release/package"
     },
-    "jest": {
-        "preset": "@diia-inhouse/configs/dist/jest"
-    },
     "dependencies": {
-        "@types/i18n": "0.13.10",
-        "i18n": "0.15.1",
-        "type-fest": "4.10.2"
+        "@diia-inhouse/diia-logger": "3.16.5",
+        "@diia-inhouse/diia-metrics": "6.5.3",
+        "@types/i18n": "0.13.12",
+        "glob": "11.1.0",
+        "he": "1.2.0",
+        "i18n": "0.15.3",
+        "i18next": "25.8.13",
+        "i18next-fs-backend": "2.6.1",
+        "type-fest": "4.38.0"
     },
     "devDependencies": {
-        "@commitlint/cli": "18.4.3",
-        "@diia-inhouse/configs": "1.31.1",
-        "@diia-inhouse/eslint-config": "5.1.0",
-        "@diia-inhouse/test": "6.3.0",
-        "@diia-inhouse/types": "6.24.0",
-        "@types/jest": "29.5.11",
-        "@types/node": "20.10.5",
-        "lockfile-lint": "4.12.1",
-        "madge": "6.1.0",
-        "rimraf": "5.0.5",
-        "semantic-release": "21.1.2"
+        "@commitlint/cli": "20.4.2",
+        "@diia-inhouse/configs": "6.1.1",
+        "@diia-inhouse/eslint-config": "8.4.0",
+        "@diia-inhouse/test": "7.3.4",
+        "@diia-inhouse/types": "11.5.0",
+        "@types/he": "1.2.3",
+        "@types/node": "25.3.3",
+        "@vitest/coverage-v8": "4.0.18",
+        "@vitest/ui": "4.0.18",
+        "lockfile-lint": "4.14.1",
+        "madge": "8.0.0",
+        "rimraf": "6.1.3",
+        "semantic-release": "24.2.9",
+        "vite-tsconfig-paths": "6.1.1",
+        "vitest": "4.0.18",
+        "vitest-mock-extended": "3.1.0"
     },
     "peerDependencies": {
         "@diia-inhouse/types": ">=1.0.0"
     },
-    "engines": {
-        "node": ">=18"
-    },
     "madge": {
         "tsConfig": "./tsconfig.json"
     }