@diia-inhouse/utils 4.1.0 → 5.3.0

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/address.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressUtils = void 0;
+class AddressUtils {
+    // For details see https://uk.wikipedia.org/wiki/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA_%D0%BA%D0%BE%D0%B4%D1%96%D0%B2_%D0%9A%D0%9E%D0%90%D0%A2%D0%A3%D0%A3_%D0%B4%D0%BB%D1%8F_%D0%BE%D0%B1%D0%BB%D0%B0%D1%81%D1%82%D0%B5%D0%B9
+    regionAtuIdByCode = {
+        '01': 1, // Автономна Республіка Крим
+        '05': 2, // Вінницька область
+        '07': 3, // Волинська область
+        '12': 4, // Дніпропетровська область
+        '14': 5, // Донецька область
+        '18': 6, // Житомирська область
+        '21': 7, // Закарпатська область
+        '23': 8, // Запорізька область
+        '26': 9, // Івано-Франківська область
+        '32': 10, // Київська область
+        '35': 11, // Кіровоградська область
+        '44': 12, // Луганська область
+        '46': 13, // Львівська область
+        '48': 14, // Миколаївська область
+        '51': 15, // Одеська область
+        '53': 16, // Полтавська область
+        '56': 17, // Рівненська область
+        '59': 18, // Сумська область
+        '61': 19, // Тернопільська область
+        '63': 20, // Харківська область
+        '65': 21, // Херсонська область
+        '68': 22, // Хмельницька область
+        '71': 23, // Черкаська область
+        '73': 24, // Чернівецька область
+        '74': 25, // Чернігівська область
+        '80': 26, // Київ
+        '85': 27, // Севастополь
+    };
+    getRegionAtuIdByKatottgCode(katottgCode) {
+        const code = katottgCode.slice(2, 4);
+        return this.regionAtuIdByCode[code] ?? null;
+    }
+}
+exports.AddressUtils = AddressUtils;
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAY;IACrB,6NAA6N;IAC5M,iBAAiB,GAA2B;QACzD,IAAI,EAAE,CAAC,EAAE,4BAA4B;QACrC,IAAI,EAAE,CAAC,EAAE,oBAAoB;QAC7B,IAAI,EAAE,CAAC,EAAE,oBAAoB;QAC7B,IAAI,EAAE,CAAC,EAAE,2BAA2B;QACpC,IAAI,EAAE,CAAC,EAAE,mBAAmB;QAC5B,IAAI,EAAE,CAAC,EAAE,sBAAsB;QAC/B,IAAI,EAAE,CAAC,EAAE,uBAAuB;QAChC,IAAI,EAAE,CAAC,EAAE,qBAAqB;QAC9B,IAAI,EAAE,CAAC,EAAE,4BAA4B;QACrC,IAAI,EAAE,EAAE,EAAE,mBAAmB;QAC7B,IAAI,EAAE,EAAE,EAAE,yBAAyB;QACnC,IAAI,EAAE,EAAE,EAAE,oBAAoB;QAC9B,IAAI,EAAE,EAAE,EAAE,oBAAoB;QAC9B,IAAI,EAAE,EAAE,EAAE,uBAAuB;QACjC,IAAI,EAAE,EAAE,EAAE,kBAAkB;QAC5B,IAAI,EAAE,EAAE,EAAE,qBAAqB;QAC/B,IAAI,EAAE,EAAE,EAAE,qBAAqB;QAC/B,IAAI,EAAE,EAAE,EAAE,kBAAkB;QAC5B,IAAI,EAAE,EAAE,EAAE,wBAAwB;QAClC,IAAI,EAAE,EAAE,EAAE,qBAAqB;QAC/B,IAAI,EAAE,EAAE,EAAE,qBAAqB;QAC/B,IAAI,EAAE,EAAE,EAAE,sBAAsB;QAChC,IAAI,EAAE,EAAE,EAAE,oBAAoB;QAC9B,IAAI,EAAE,EAAE,EAAE,sBAAsB;QAChC,IAAI,EAAE,EAAE,EAAE,uBAAuB;QACjC,IAAI,EAAE,EAAE,EAAE,OAAO;QACjB,IAAI,EAAE,EAAE,EAAE,cAAc;KAC3B,CAAA;IAED,2BAA2B,CAAC,WAAmB;QAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAEpC,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAA;IAC/C,CAAC;CACJ;AArCD,oCAqCC"}

package/dist/applicationUtils.js

@@ -1,9 +1,15 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApplicationUtils = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 const compare_versions_1 = require("compare-versions");
 const lodash_1 = require("lodash");
 const luxon_1 = require("luxon");
+const map_age_cleaner_1 = __importDefault(require("map-age-cleaner"));
 const errors_1 = require("@diia-inhouse/errors");
 const types_1 = require("@diia-inhouse/types");
 class ApplicationUtils {
@@ -17,7 +23,6 @@ class ApplicationUtils {
     };
     static defaultItnDate = '31.12.1899';
     static defaultFormat = 'dd.MM.yyyy';
-    static nameDelimiters = [' ', '-'];
     static cyrillicToLatin = new Map([
         ['і', 'i'],
         ['е', 'e'],
@@ -43,6 +48,28 @@ class ApplicationUtils {
         ['М', 'M'],
         ['У', 'Y'],
     ]);
+    static nameComponentsToLowerCase = [
+        'огли',
+        'оглу',
+        'заде',
+        'кизи',
+        'бей',
+        'бек',
+        'паша',
+        'хан',
+        'шах',
+        'мелік',
+        'зуль',
+        'ібн',
+        'тер',
+        'аль',
+        'ель',
+        'аш',
+        'ас',
+        'ад',
+        'ель',
+        'ес',
+    ];
     static documentTypeToCamelCase(documentType) {
         return ApplicationUtils.documentTypeToCamelCaseExceptions[documentType] || (0, lodash_1.camelCase)(documentType);
     }
@@ -77,21 +104,22 @@ class ApplicationUtils {
         return true;
     }
     static capitalizeName(name) {
-        const foundDelimiters = this.nameDelimiters.filter((delimiter) => {
-            const regex = new RegExp(delimiter);
-            return regex.test(name);
-        });
-        let resultName = name?.toLowerCase();
-        if (foundDelimiters.length > 0) {
-            for (const foundDelimiter of foundDelimiters) {
-                resultName = resultName
-                    .split(foundDelimiter)
-                    .map((partName) => ApplicationUtils.capitalizeFirstLetter(partName))
-                    .join(foundDelimiter);
+        if (!name) {
+            return '';
+        }
+        const loweredNameParts = name.toLowerCase().split(' ');
+        if (loweredNameParts.length === 1) {
+            const [namePart] = loweredNameParts;
+            if (this.nameComponentsToLowerCase.includes(namePart)) {
+                return this.capitalizeFirstLetter(namePart);
             }
-            return resultName;
         }
-        return ApplicationUtils.capitalizeFirstLetter(resultName);
+        return loweredNameParts
+            .map((word) => word
+            .split('-')
+            .map((namePart) => this.nameComponentsToLowerCase.includes(namePart) ? namePart : this.capitalizeFirstLetter(namePart))
+            .join('-'))
+            .join(' ');
     }
     static capitalizeFirstLetter(str) {
         if (typeof str !== 'string') {
@@ -118,6 +146,9 @@ class ApplicationUtils {
             .map((char) => latinToCyrillic.get(char) || char)
             .join('');
     }
+    /**
+     * Validates the Ukrainian IBAN number by format and checksum.
+     */
     static isIbanNumberValid(iban) {
         const CODE_LENGTHS = {
             UA: 29,
@@ -132,6 +163,18 @@ class ApplicationUtils {
         });
         return this.mod97(digits) === 1;
     }
+    /**
+     * Extracts the bank code (МФО) from Ukrainian IBAN (4-10 digits). Does not validate the IBAN.
+     *
+     * @link https://en.wikipedia.org/wiki/International_Bank_Account_Number#IBAN_formats_by_country
+     * @example
+     * ```typescript
+     * const bankCode = extractBankCodeFromIban('UA833052991234567890123456789') // '305299'
+     * ```
+     */
+    static extractBankCodeFromIban(iban) {
+        return iban.slice(4, 10);
+    }
     static getStreetName(street, streetType) {
         if (!street) {
             return '';
@@ -185,9 +228,6 @@ class ApplicationUtils {
             case types_1.SessionType.EResidentApplicant: {
                 return { sessionType, user: data };
             }
-            case types_1.SessionType.CabinetUser: {
-                return { sessionType, user: data };
-            }
             case types_1.SessionType.Acquirer: {
                 return { sessionType, acquirer: data };
             }
@@ -223,17 +263,21 @@ class ApplicationUtils {
      * Get age from birth date. Powered by {@link https://moment.github.io/luxon/#/ luxon}
      *
      * @param birthDay Input birth date.
-     * @param format `birthDay` format (https://moment.github.io/luxon/#/formatting?id=table-of-tokens). Default - 'dd.MM.yyyy'
-     * @param unitOfTime Unit of time to return. Default - 'years'
+     * @param params Additional parameters. Default: `{ format: 'dd.MM.yyyy', unitOfTime: 'years' }`
+     * @param params.format Input date format (https://moment.github.io/luxon/#/formatting?id=table-of-tokens). Default - 'dd.MM.yyyy'
+     * @param params.unitOfTime Unit of time to get the difference in. Default - 'years'
+     * @param params.relativeTo Date to compare the input date to. Default - current date
      *
      * @returns Age in years if other `unitOfTime` is not specified
      * @throws If input date is invalid
      */
-    static getAge(birthDay, format = 'dd.MM.yyyy', unitOfTime = 'years') {
+    static getAge(birthDay, params = {}) {
+        const { format = 'dd.MM.yyyy', unitOfTime = 'years', relativeTo } = params;
         const birthdayDate = luxon_1.DateTime.fromFormat(birthDay, format);
         if (!birthdayDate.isValid) {
             throw new Error('Invalid user birthday');
         }
+        const fromDate = relativeTo ? luxon_1.DateTime.fromISO(relativeTo) : luxon_1.DateTime.now();
         /* Added an array of "units" with milliseconds to ensure that all larger unit values are integers.
             For instance:
                 birthDay = '24.03.2009'
@@ -243,7 +287,7 @@ class ApplicationUtils {
                 DateTime.now().diff(birthdayDate, ['years', 'milliseconds'])['years'] => 14
                 DateTime.now().diff(birthdayDate, ['months', 'milliseconds'])['months'] => 168
         */
-        return luxon_1.DateTime.now().diff(birthdayDate, [unitOfTime, 'milliseconds'])[unitOfTime];
+        return fromDate.diff(birthdayDate, [unitOfTime, 'milliseconds'])[unitOfTime];
     }
     static getFullName(lastName, firstName, middleName, separator = ' ') {
         return [lastName, firstName, middleName].filter(Boolean).join(separator).trim();
@@ -365,6 +409,205 @@ class ApplicationUtils {
     static sanitizeString(input) {
         return input.replaceAll(/[^\da-zа-яєіїґ]/gi, '');
     }
+    /**
+     * Returns the appropriate plural form of a string based on the specified numeric value and locale.
+     * Uses the pluralization rules for the provided locale to determine the correct form among the options.
+     *
+     * @param value - The number used to determine the plural form.
+     * @param one - The form for singular (e.g., "one item").
+     * @param few - The form for a few items (e.g., "few items").
+     * @param many - The form for many items (e.g., "many items").
+     * @param other - Optional. The fallback form if none of the specific plural rules match.
+     *                           Defaults to the 'many' form if not provided.
+     * @param locale - The locale used for pluralization rules. Defaults to 'uk' (Ukrainian).
+     * @returns The appropriate pluralized string based on the value.
+     *
+     * @example
+     * getPluralForm(1, 'яблуко', 'яблука', 'яблук'); // 'яблуко'
+     * getPluralForm(2, 'яблуко', 'яблука', 'яблук'); // 'яблука'
+     * getPluralForm(0, 'яблуко', 'яблука', 'яблук', 'плоди'); // 'плоди'
+     * getPluralForm(0, 'яблуко', 'яблука', 'яблук'); // 'яблук' (uses 'many' as default fallback)
+     */
+    static pluralizeString(value, one, few, many, other, locale = 'uk') {
+        const rules = new Intl.PluralRules(locale);
+        switch (rules.select(value)) {
+            case 'one': {
+                return one;
+            }
+            case 'few': {
+                return few;
+            }
+            case 'many': {
+                return many;
+            }
+            default: {
+                return other || many;
+            }
+        }
+    }
+    /**
+     * Returns the name of a service from a package.json in the current working directory (process.cwd()) converted to PascalCase.
+     * If the name is scoped, it will be returned without the scope.
+     * If the name is not found, an empty string is returned. Also, all whitespace characters are removed.
+     *
+     * @returns The name of the service in PascalCase.
+     *
+     * @example
+     * getServiceName() // 'my-service' -> 'MyService'
+     * getServiceName() // '@scope/my-service' -> 'MyService'
+     */
+    static getServiceName() {
+        try {
+            const packageName = this.getPackageJson().name || '';
+            let nameWithoutScope = packageName;
+            if (packageName.startsWith('@')) {
+                const parts = packageName.split('/');
+                if (parts.length > 1) {
+                    nameWithoutScope = parts[1];
+                }
+            }
+            return (0, lodash_1.startCase)((0, lodash_1.camelCase)(nameWithoutScope)).replaceAll(/\s/g, '');
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Returns the version of a service from a package.json in the current working directory (process.cwd()).
+     * If the version is not found, an empty string is returned.
+     *
+     * @returns The version of the service.
+     *
+     * @example
+     * getServiceVersion() // '1.143.0-rc.2'
+     */
+    static getServiceVersion() {
+        try {
+            const packageJson = this.getPackageJson();
+            return packageJson.version || '';
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Format string according to mask pattern
+     *
+     * Basic Examples:
+     * '12345' with '##-###'    -> '12-345'
+     * 'AB345' with '##-###'    -> 'AB-345'
+     * '123456' with '##.####'  -> '12.3456'
+     * '12345' with '### ##'    -> '123 45'
+     * 'ABCDEF' with '##-##-##' -> 'AB-CD-EF'
+     */
+    static formatMask(rawData, mask) {
+        if (!rawData || !mask) {
+            return rawData;
+        }
+        let result = '';
+        let dataIndex = 0;
+        for (const element of mask) {
+            if (dataIndex >= rawData.length) {
+                break;
+            }
+            if (element === '#') {
+                result += rawData[dataIndex];
+                dataIndex++;
+            }
+            else {
+                result += element;
+            }
+        }
+        result += rawData.slice(dataIndex);
+        return result;
+    }
+    /**
+     * Memoize a function.
+     * The function is memoized by the arguments (`JSON.stringify(args)`) and the result is cached for the specified time to live in milliseconds.
+     * If the function is called with the same arguments again, the cached result is returned.
+     * If the function is called with the same arguments again after the time to live has expired, the function is called again and the result is cached again.
+     *
+     * @param fn - The function to memoize.
+     * @param ttl - The time to live for the cached value in milliseconds.
+     * @returns The memoized function.
+     */
+    static memoize(fn, ttl = Infinity) {
+        const promiseCache = new Map();
+        const cache = new Map();
+        (0, map_age_cleaner_1.default)(cache);
+        const memoized = (async (...args) => {
+            const key = JSON.stringify(args);
+            const cachedPromise = promiseCache.get(key);
+            if (cachedPromise) {
+                return cachedPromise;
+            }
+            const cachedValue = cache.get(key);
+            if (cachedValue) {
+                return cachedValue.data;
+            }
+            try {
+                const promise = fn(...args);
+                promiseCache.set(key, promise);
+                const result = await promise;
+                cache.set(key, { data: result, maxAge: Date.now() + ttl });
+                return result;
+            }
+            finally {
+                promiseCache.delete(key);
+            }
+        });
+        return memoized;
+    }
+    /**
+     * Recursively encodes all string values in an object or string using encodeURIComponent.
+     * For objects, it creates a deep clone and processes all string values.
+     * For strings, it directly applies the encoding.
+     *
+     * @param data Input data to encode - can be an object or string
+     * @returns Deep cloned object with encoded string values, or encoded string if input was string
+     * @example
+     * ```typescript
+     * const data = { name: 'John Doe', email: 'john@example.com' }
+     * const encoded = ApplicationUtils.encodeValuesWithIterator(data)
+     * // Result: { name: 'John%20Doe', email: 'john%40example.com' }
+     * ```
+     */
+    static encodeValuesWithIterator(data) {
+        return this.processValues(data, encodeURIComponent);
+    }
+    /**
+     * Recursively decodes all string values in an object or string using decodeURIComponent.
+     * For objects, it creates a deep clone and processes all string values.
+     * For strings, it directly applies the decoding.
+     *
+     * @param data Input data to decode - can be an object or string
+     * @returns Deep cloned object with decoded string values, or decoded string if input was string
+     * @example
+     * ```typescript
+     * const data = { name: 'John%20Doe', email: 'john%40example.com' }
+     * const decoded = ApplicationUtils.decodeValuesWithIterator(data)
+     * // Result: { name: 'John Doe', email: 'john@example.com' }
+     * ```
+     */
+    static decodeValuesWithIterator(data) {
+        return this.processValues(data, decodeURIComponent);
+    }
+    static removeUnderscoreFields(value) {
+        if (Array.isArray(value)) {
+            return value.map((item) => this.removeUnderscoreFields(item));
+        }
+        if (typeof value === 'object' && value !== null) {
+            const objectField = {};
+            for (const key in value) {
+                if (!key.startsWith('_')) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    objectField[key] = this.removeUnderscoreFields(value[key]);
+                }
+            }
+            return objectField;
+        }
+        return value;
+    }
     static mod97(string) {
         let checksum = string.slice(0, 2);
         let fragment;
@@ -375,8 +618,61 @@ class ApplicationUtils {
         return checksum;
     }
     static toApiError(err) {
-        const { type, code, message, data } = err;
-        return new errors_1.ApiError(message, code || types_1.HttpStatusCode.INTERNAL_SERVER_ERROR, data, data?.processCode, type);
+        const { type, code, message, data = {}, keyValue } = err;
+        const processCode = data.processCode;
+        if (code === 11000 && keyValue) {
+            data.keyValue = keyValue;
+        }
+        return new errors_1.ApiError(message, code || types_1.HttpStatusCode.INTERNAL_SERVER_ERROR, data, processCode, type);
+    }
+    static getPackageJson() {
+        const packageJsonPath = node_path_1.default.resolve(process.cwd(), 'package.json');
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        return JSON.parse(node_fs_1.default.readFileSync(packageJsonPath, 'utf8')); // nosemgrep: eslint.detect-non-literal-fs-filename
+    }
+    static processObject(obj, processor) {
+        if (typeof obj === 'string') {
+            try {
+                return processor(obj);
+            }
+            catch {
+                return obj;
+            }
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => {
+                return this.processObject(item, processor);
+            });
+        }
+        if (obj && typeof obj === 'object') {
+            if (obj instanceof Date ||
+                obj instanceof RegExp ||
+                obj instanceof Map ||
+                obj instanceof Set ||
+                obj instanceof Error ||
+                obj instanceof URL ||
+                obj instanceof URLSearchParams) {
+                return obj;
+            }
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                result[key] = this.processObject(value, processor);
+            }
+            return result;
+        }
+        return obj;
+    }
+    static processValues(data, processor) {
+        if (typeof data === 'string') {
+            try {
+                return processor(data);
+            }
+            catch {
+                return data;
+            }
+        }
+        const clonedData = (0, lodash_1.cloneDeep)(data);
+        return this.processObject(clonedData, processor);
     }
 }
 exports.ApplicationUtils = ApplicationUtils;