@diia-inhouse/utils 5.3.30 → 6.0.9

package/dist/address.d.ts

@@ -0,0 +1,7 @@
+//#region src/address.d.ts
+declare class AddressUtils {
+  private readonly regionAtuIdByCode;
+  getRegionAtuIdByKatottgCode(katottgCode: string): number | null;
+}
+//#endregion
+export { AddressUtils };

package/dist/address.js

@@ -1,41 +1,38 @@
-"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
+//#region src/address.ts
+var AddressUtils = class {
+	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;
+	}
+};
+//#endregion
+export { AddressUtils };

package/dist/applicationUtils.d.ts

@@ -0,0 +1,225 @@
+import { ToRelativeUnit } from "luxon";
+import { ApiError } from "@diia-inhouse/errors";
+import { ActHeaders, ActionSession, ActionVersion, AppVersions, Gender, HashedFile, HashedFileWithSignature, PlatformType, SignedItem, TokenData, UserTokenData, WithAppVersions } from "@diia-inhouse/types";
+
+//#region src/applicationUtils.d.ts
+declare class ApplicationUtils {
+  private static documentTypeToCamelCaseExceptions;
+  private static camelCaseToDocumentTypeExceptions;
+  private static defaultItnDate;
+  private static defaultFormat;
+  private static readonly cyrillicToLatin;
+  private static readonly nameComponentsToLowerCase;
+  static documentTypeToCamelCase(documentType: string): string;
+  static camelCaseToDocumentType(camelCaseDocumentType: string): string;
+  static isItnChecksumValid(itn: string): boolean;
+  static getBirthDayFromItn(itn: string): string;
+  static getGenderFromItn(itn: string): Gender;
+  static isItnFormatValid(itn: string): boolean;
+  static capitalizeName(name: string | undefined | null): string;
+  static capitalizeFirstLetter(str: string): string;
+  static lowerFirstLetter(str: string): string;
+  static mapCyrillic(value: string): string;
+  static mapLatin(value: string): string;
+  /**
+  * Validates the Ukrainian IBAN number by format and checksum.
+  */
+  static isIbanNumberValid(iban: string): boolean;
+  /**
+  * 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: string): string;
+  static getStreetName(street: string, streetType: string): string;
+  static toHashedFilesWithSignatures(hashedFiles: HashedFile[], signedItems: SignedItem[]): [HashedFileWithSignature[], string[]];
+  static handleError<T = never>(err: unknown, cb: (err: ApiError) => T): T;
+  static makeSession(data: TokenData): ActionSession;
+  static getActionNameWithVersion(actionName: string, actionVersion?: ActionVersion): string;
+  static getGreeting(fName: string, skipEmogi?: boolean): string;
+  /**
+  * Get age from birth date. Powered by {@link https://moment.github.io/luxon/#/ luxon}
+  *
+  * @param birthDay Input birth date.
+  * @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: string, params?: {
+    format?: string;
+    unitOfTime?: ToRelativeUnit;
+    relativeTo?: string;
+  }): number;
+  static getFullName(lastName: string, firstName: string, middleName?: string, separator?: string): string;
+  static getShortName(lastName: string, firstName: string, middleName?: string): string;
+  static getUserFullName(user: UserTokenData): string;
+  static getPassportFullName({
+    lastNameUA,
+    firstNameUA,
+    middleNameUA
+  }: {
+    lastNameUA: string;
+    firstNameUA: string;
+    middleNameUA?: string;
+  }): string;
+  static getChildFullName({
+    child: {
+      lastName,
+      firstName,
+      middleName
+    }
+  }: {
+    child: {
+      lastName: string;
+      firstName: string;
+      middleName?: string;
+    };
+  }): string;
+  static encodeObjectToBase64<T>(object: T): string;
+  static decodeObjectFromBase64<T>(encodedObject: string): T;
+  /**
+  * Format string or Date to the specified string format. Powered by {@link https://moment.github.io/luxon/#/ luxon}
+  *
+  * @param date Input date
+  * @param format Output date format (https://moment.github.io/luxon/#/formatting?id=table-of-tokens)
+  * @param fromFormat Input date format (https://moment.github.io/luxon/#/formatting?id=table-of-tokens). Used for string `date`. Default - 'dd.MM.yyyy'
+  *
+  * @throws If input date is invalid
+  */
+  static formatDate(date: string | Date, format: string, fromFormat?: string): string;
+  /**
+  * Check if the input date is valid. Powered by {@link https://moment.github.io/luxon/#/ luxon}
+  *
+  * @param date Input date.
+  * @param format `date` format (https://moment.github.io/luxon/#/formatting?id=table-of-tokens). Default - 'yyyy-MM-dd'
+  *
+  * @throws If input date is invalid
+  */
+  static validateDate(date: string, format?: string): void | never;
+  static formatPhoneNumber(rawPhone: string, separator?: string, prefix?: string): string;
+  /**
+  * Format number as: "XX XXX,XX {units}".
+  *
+  * @param amount Input number
+  * @param units Unit to be append at the end of the formatted number
+  * @param minimumFractionDigits Minimum number of fraction digits
+  */
+  static formatAmountWithThousandsSeparator(amount: number, units?: string, minimumFractionDigits?: number): string;
+  static convertToPennies(amount: number): number;
+  static convertFromPennies(amount: number): number;
+  static multiplySum(amount: number, multiplier: number, decimalPlaces?: number): number;
+  static toDecimalPlaces(amount: number, decimalPlaces?: number): number;
+  static filterByAppVersions<T extends WithAppVersions>(items: T[], headers: Pick<ActHeaders, "appVersion" | "platformType"> | undefined): T[];
+  static isAppVersionMatch(appVersion: string, platformType: PlatformType, appVersions: AppVersions): boolean;
+  static getFileName(name: string, id: string, requestDateTime?: string, postFix?: string): string;
+  static sanitizeString(input: string): string;
+  /**
+  * 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: number, one: string, few: string, many: string, other?: string, locale?: string): string;
+  /**
+  * 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(): string;
+  /**
+  * 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(): string;
+  /**
+  * 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: string, mask: string): string;
+  /**
+  * 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<T extends (...args: Parameters<T>) => ReturnType<T>>(fn: T, ttl?: number): T;
+  /**
+  * 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: object | string): object | string;
+  /**
+  * 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: object | string): object | string;
+  private static mod97;
+  private static toApiError;
+  private static getPackageJson;
+  private static processObject;
+  private static processValues;
+}
+//#endregion
+export { ApplicationUtils };