@dxtmisha/functional-basic 1.4.0 → 1.4.2

package/dist/library.js

@@ -1597,9 +1597,9 @@ var Ye = "d-response-loading", Xe = class {
 	}
 }, Ze = class {
 	constructor(e = "/api/", t = {}) {
-		w(this, "url", void 0), w(this, "headers", void 0), w(this, "requestDefault", void 0), w(this, "status", void 0), w(this, "response", void 0), w(this, "preparation", void 0), w(this, "loading", void 0), w(this, "errorCenter", void 0), w(this, "hydration", void 0), w(this, "timeout", 16e3), w(this, "origin", void 0), this.url = e;
-		let { headersClass: n = We, requestDefaultClass: r = Be, statusClass: i = Le, responseClass: a = Xe, preparationClass: o = qe, loadingClass: s = N.getItem(), errorCenterClass: c = T.getItem(), hydrationClass: l = Ke } = t;
-		this.headers = new n(), this.requestDefault = new r(), this.status = new i(), this.response = new a(this.requestDefault), this.preparation = new o(), this.loading = s, this.errorCenter = c, this.hydration = new l(), this.hydration.initResponse(this.response);
+		w(this, "url", void 0), w(this, "headers", void 0), w(this, "requestDefault", void 0), w(this, "status", void 0), w(this, "response", void 0), w(this, "preparation", void 0), w(this, "loading", void 0), w(this, "errorCenter", void 0), w(this, "hydration", void 0), w(this, "timeout", 16e3), w(this, "origin", void 0), w(this, "wrapper", void 0), this.url = e;
+		let { headersClass: n = We, requestDefaultClass: r = Be, statusClass: i = Le, responseClass: a = Xe, preparationClass: o = qe, loadingClass: s = N.getItem(), errorCenterClass: c = T.getItem(), hydrationClass: l = Ke, wrapper: u } = t;
+		this.headers = new n(), this.requestDefault = new r(), this.status = new i(), this.response = new a(this.requestDefault), this.preparation = new o(), this.loading = s, this.errorCenter = c, this.hydration = new l(), this.wrapper = u, this.hydration.initResponse(this.response);
 	}
 	isLocalhost() {
 		return s() && typeof location < "u" && location.hostname === "localhost";
@@ -1654,8 +1654,13 @@ var Ye = "d-response-loading", Xe = class {
 	setOrigin(e) {
 		return this.origin = e, this;
 	}
+	setWrapper(e) {
+		return this.wrapper = e, this;
+	}
 	async request(e) {
-		return d(e) ? await this.fetch({ path: e }) : await this.fetch(e);
+		var t;
+		let n = d(e) ? { path: e } : e, r = (t = n.wrapper) == null ? this.wrapper : t;
+		return r ? await r(() => this.fetch(n), n) : await this.fetch(n);
 	}
 	get(e) {
 		return this.request({
@@ -1862,8 +1867,11 @@ var Ye = "d-response-loading", Xe = class {
 	static setOrigin(e) {
 		this.getItem().setOrigin(e);
 	}
+	static setWrapper(e) {
+		this.getItem().setWrapper(e);
+	}
 	static setConfig(e) {
-		e && n(e) && (e.urlRoot && this.setUrl(e.urlRoot), e.headers && this.setHeaders(e.headers), e.requestDefault && this.setRequestDefault(e.requestDefault), e.preparation && this.setPreparation(e.preparation), e.end && this.setEnd(e.end), e.timeout && this.setTimeout(e.timeout), e.devMode && this.getResponse().setDevMode(e.devMode), e.origin && this.setOrigin(e.origin));
+		e && n(e) && (e.urlRoot && this.setUrl(e.urlRoot), e.headers && this.setHeaders(e.headers), e.requestDefault && this.setRequestDefault(e.requestDefault), e.preparation && this.setPreparation(e.preparation), e.end && this.setEnd(e.end), e.timeout && this.setTimeout(e.timeout), e.devMode && this.getResponse().setDevMode(e.devMode), e.origin && this.setOrigin(e.origin), e.wrapper && this.setWrapper(e.wrapper));
 	}
 	static async request(e) {
 		return this.getItem().request(e);
@@ -2682,8 +2690,10 @@ var H = /* @__PURE__ */ function(e) {
 			var r;
 			let t = this.getCountry(n);
 			return {
-				language: this.getLanguage(n),
+				language: this.getLanguageName(n),
+				languageCode: n.language,
 				country: t,
+				countryCode: n.country,
 				standard: n.standard,
 				icon: (r = e.flags) == null ? void 0 : r[n.country],
 				label: t,
@@ -2692,6 +2702,14 @@ var H = /* @__PURE__ */ function(e) {
 			};
 		}
 	}
+	getLanguage(e = this.getCode()) {
+		let t = this.get(e);
+		if (t) return {
+			...t,
+			label: t.language,
+			value: t.languageCode
+		};
+	}
 	getCode() {
 		return this.code || A.getLocation();
 	}
@@ -2703,6 +2721,13 @@ var H = /* @__PURE__ */ function(e) {
 		let n = r(this.getCodes(e), (e) => this.get(e));
 		return t ? new R().sort(n, (e, t) => [e.label, t.label]) : n;
 	}
+	getListLanguage(e, t = !0) {
+		let n = [], i = /* @__PURE__ */ new Set();
+		return r(this.getCodes(e), (e) => {
+			let t = this.getLanguage(e);
+			t && !i.has(t.value) && (n.push(t), i.add(t.value));
+		}), t ? new R().sort(n, (e, t) => [e.label, t.label]) : n;
+	}
 	getNational(t, n = !0) {
 		let i = r(this.getList(t, !1), (t) => {
 			let n = new e(t.standard).get(t.standard);
@@ -2715,6 +2740,18 @@ var H = /* @__PURE__ */ function(e) {
 		});
 		return n ? new R().sort(i, (e, t) => [e.label, t.label]) : i;
 	}
+	getNationalLanguage(t, n = !0) {
+		let i = r(this.getListLanguage(t, !1), (t) => {
+			let n = new e(t.standard).getLanguage(t.standard);
+			return {
+				...t,
+				description: n == null ? void 0 : n.language,
+				nationalLanguage: n == null ? void 0 : n.language,
+				nationalCountry: n == null ? void 0 : n.country
+			};
+		});
+		return n ? new R().sort(i, (e, t) => [e.label, t.label]) : i;
+	}
 	setCode(e) {
 		return this.code = e, this;
 	}
@@ -2724,7 +2761,7 @@ var H = /* @__PURE__ */ function(e) {
 	getCodes(t) {
 		return t == null ? Object.keys(e.flags) : t;
 	}
-	getLanguage(e) {
+	getLanguageName(e) {
 		return this.getLocation().languageName(e.language);
 	}
 	getCountry(e) {
@@ -2732,13 +2769,62 @@ var H = /* @__PURE__ */ function(e) {
 	}
 };
 w(ct, "flags", {
+	RU: "f-ru",
+	FR: "f-fr",
+	GB: "f-gb",
+	US: "f-us",
+	DE: "f-de",
+	ES: "f-es",
+	VN: "f-vn",
+	CN: "f-cn",
+	IT: "f-it",
+	JP: "f-jp",
+	KR: "f-kr",
+	PT: "f-pt",
+	TR: "f-tr",
+	PL: "f-pl",
+	NL: "f-nl",
+	UA: "f-ua",
+	BY: "f-by",
+	KZ: "f-kz",
+	GR: "f-gr",
+	CZ: "f-cz",
+	HU: "f-hu",
+	RO: "f-ro",
+	BG: "f-bg",
+	HR: "f-hr",
+	RS: "f-rs",
+	SK: "f-sk",
+	SI: "f-si",
+	LT: "f-lt",
+	LV: "f-lv",
+	EE: "f-ee",
+	FI: "f-fi",
+	SE: "f-se",
+	NO: "f-no",
+	DK: "f-dk",
+	IL: "f-il",
+	TH: "f-th",
+	ID: "f-id",
+	MY: "f-my",
+	PH: "f-ph",
+	SA: "f-sa",
+	IR: "f-ir",
+	PK: "f-pk",
+	AM: "f-am",
+	GE: "f-ge",
+	AZ: "f-az",
+	TJ: "f-tj",
+	KG: "f-kg",
+	UZ: "f-uz",
+	TM: "f-tm",
+	MN: "f-mn",
 	AD: "f-ad",
 	AE: "f-ae",
 	AF: "f-af",
 	AG: "f-ag",
 	AI: "f-ai",
 	AL: "f-al",
-	AM: "f-am",
 	AN: "f-an",
 	AO: "f-ao",
 	AQ: "f-aq",
@@ -2747,13 +2833,11 @@ w(ct, "flags", {
 	AT: "f-at",
 	AU: "f-au",
 	AW: "f-aw",
-	AZ: "f-az",
 	BA: "f-ba",
 	BB: "f-bb",
 	BD: "f-bd",
 	BE: "f-be",
 	BF: "f-bf",
-	BG: "f-bg",
 	BH: "f-bh",
 	BI: "f-bi",
 	BJ: "f-bj",
@@ -2765,7 +2849,6 @@ w(ct, "flags", {
 	BS: "f-bs",
 	BT: "f-bt",
 	BW: "f-bw",
-	BY: "f-by",
 	BZ: "f-bz",
 	CA: "f-ca",
 	CC: "f-cc",
@@ -2777,7 +2860,6 @@ w(ct, "flags", {
 	CK: "f-ck",
 	CL: "f-cl",
 	CM: "f-cm",
-	CN: "f-cn",
 	CO: "f-co",
 	CR: "f-cr",
 	CU: "f-cu",
@@ -2785,29 +2867,20 @@ w(ct, "flags", {
 	CW: "f-cw",
 	CX: "f-cx",
 	CY: "f-cy",
-	CZ: "f-cz",
-	DE: "f-de",
 	DJ: "f-dj",
-	DK: "f-dk",
 	DM: "f-dm",
 	DZ: "f-dz",
 	EC: "f-ec",
-	EE: "f-ee",
 	EG: "f-eg",
 	EH: "f-eh",
 	ER: "f-er",
-	ES: "f-es",
 	ET: "f-et",
-	FI: "f-fi",
 	FJ: "f-fj",
 	FK: "f-fk",
 	FM: "f-fm",
 	FO: "f-fo",
-	FR: "f-fr",
 	GA: "f-ga",
-	GB: "f-gb",
 	GD: "f-gd",
-	GE: "f-ge",
 	GF: "f-gf",
 	GG: "f-gg",
 	GH: "f-gh",
@@ -2816,41 +2889,29 @@ w(ct, "flags", {
 	GM: "f-gm",
 	GN: "f-gn",
 	GQ: "f-gq",
-	GR: "f-gr",
 	GT: "f-gt",
 	GU: "f-gu",
 	GW: "f-gw",
 	GY: "f-gy",
 	HK: "f-hk",
 	HN: "f-hn",
-	HR: "f-hr",
 	HT: "f-ht",
-	HU: "f-hu",
-	ID: "f-id",
 	IE: "f-ie",
-	IL: "f-il",
 	IM: "f-im",
-	IN: "f-in",
 	IO: "f-io",
 	IQ: "f-iq",
-	IR: "f-ir",
 	IS: "f-is",
-	IT: "f-it",
 	JE: "f-je",
 	JM: "f-jm",
 	JO: "f-jo",
-	JP: "f-jp",
 	KE: "f-ke",
-	KG: "f-kg",
 	KH: "f-kh",
 	KI: "f-ki",
 	KM: "f-km",
 	KN: "f-kn",
 	KP: "f-kp",
-	KR: "f-kr",
 	KW: "f-kw",
 	KY: "f-ky",
-	KZ: "f-kz",
 	LA: "f-la",
 	LB: "f-lb",
 	LC: "f-lc",
@@ -2858,9 +2919,7 @@ w(ct, "flags", {
 	LK: "f-lk",
 	LR: "f-lr",
 	LS: "f-ls",
-	LT: "f-lt",
 	LU: "f-lu",
-	LV: "f-lv",
 	LY: "f-ly",
 	MA: "f-ma",
 	MC: "f-mc",
@@ -2872,7 +2931,6 @@ w(ct, "flags", {
 	MK: "f-mk",
 	ML: "f-ml",
 	MM: "f-mm",
-	MN: "f-mn",
 	MO: "f-mo",
 	MP: "f-mp",
 	MQ: "f-mq",
@@ -2883,7 +2941,6 @@ w(ct, "flags", {
 	MV: "f-mv",
 	MW: "f-mw",
 	MX: "f-mx",
-	MY: "f-my",
 	MZ: "f-mz",
 	NA: "f-na",
 	NC: "f-nc",
@@ -2891,8 +2948,6 @@ w(ct, "flags", {
 	NF: "f-nf",
 	NG: "f-ng",
 	NI: "f-ni",
-	NL: "f-nl",
-	NO: "f-no",
 	NP: "f-np",
 	NR: "f-nr",
 	NU: "f-nu",
@@ -2902,32 +2957,21 @@ w(ct, "flags", {
 	PE: "f-pe",
 	PF: "f-pf",
 	PG: "f-pg",
-	PH: "f-ph",
-	PK: "f-pk",
-	PL: "f-pl",
 	PM: "f-pm",
 	PN: "f-pn",
 	PR: "f-pr",
 	PS: "f-ps",
-	PT: "f-pt",
 	PW: "f-pw",
 	PY: "f-py",
 	QA: "f-qa",
 	RE: "f-re",
-	RO: "f-ro",
-	RS: "f-rs",
-	RU: "f-ru",
 	RW: "f-rw",
-	SA: "f-sa",
 	SB: "f-sb",
 	SC: "f-sc",
 	SD: "f-sd",
-	SE: "f-se",
 	SG: "f-sg",
 	SH: "f-sh",
-	SI: "f-si",
 	SJ: "f-sj",
-	SK: "f-sk",
 	SL: "f-sl",
 	SM: "f-sm",
 	SN: "f-sn",
@@ -2942,29 +2986,21 @@ w(ct, "flags", {
 	TC: "f-tc",
 	TD: "f-td",
 	TG: "f-tg",
-	TH: "f-th",
-	TJ: "f-tj",
 	TK: "f-tk",
 	TL: "f-tl",
-	TM: "f-tm",
 	TN: "f-tn",
 	TO: "f-to",
-	TR: "f-tr",
 	TT: "f-tt",
 	TV: "f-tv",
 	TW: "f-tw",
 	TZ: "f-tz",
-	UA: "f-ua",
 	UG: "f-ug",
-	US: "f-us",
 	UY: "f-uy",
-	UZ: "f-uz",
 	VA: "f-va",
 	VC: "f-vc",
 	VE: "f-ve",
 	VG: "f-vg",
 	VI: "f-vi",
-	VN: "f-vn",
 	VU: "f-vu",
 	WF: "f-wf",
 	WS: "f-ws",

package/dist/src/classes/Api.d.ts

@@ -142,6 +142,14 @@ export declare class Api {
      * @returns void / ничего не возвращает
      */
     static setOrigin(origin: string): void;
+    /**
+     * Sets the wrapper function for requests.
+     *
+     * Устанавливает функцию-обертку для запросов.
+     * @param wrapper wrapper function / функция-обертка
+     * @returns void / ничего не возвращает
+     */
+    static setWrapper(wrapper: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>): void;
     /**
      * Sets multiple API configuration options at once.
      *

package/dist/src/classes/ApiInstance.d.ts

@@ -26,6 +26,8 @@ export type ApiInstanceOptions = {
     errorCenterClass?: ErrorCenterInstance;
     /** Class for working with hydration / Класс для работы с гидратацией */
     hydrationClass?: typeof ApiHydration;
+    /** Wrapper function for requests / Функция-обертка для запросов */
+    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
 };
 /**
  * Core class for managing HTTP requests using the Fetch API.
@@ -53,6 +55,8 @@ export declare class ApiInstance {
     /** Timeout for the request in milliseconds / Таймаут запроса в миллисекундах */
     protected timeout: number;
     protected origin?: string;
+    /** Wrapper function for requests / Функция-обертка для запросов */
+    protected wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
     /**
      * Constructor
      * @param url base path to the script / базовый путь к скрипту
@@ -178,6 +182,13 @@ export declare class ApiInstance {
      * @param origin protocol and domain / протокол и домен
      */
     setOrigin(origin: string): this;
+    /**
+     * Sets the wrapper function for requests.
+     *
+     * Устанавливает функцию-обертку для запросов.
+     * @param wrapper wrapper function / функция-обертка
+     */
+    setWrapper(wrapper: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>): this;
     /**
      * Executes a request with the given path or configuration.
      *

package/dist/src/classes/GeoFlag.d.ts

@@ -30,6 +30,14 @@ export declare class GeoFlag {
      * @returns country information / информация о стране
      */
     get(code?: string): GeoFlagItem | undefined;
+    /**
+     * Returns information about the language and its flag.
+     *
+     * Возвращает информацию о языке и его флаге.
+     * @param code country code / код страны
+     * @returns language information / информация о языке
+     */
+    getLanguage(code?: string): GeoFlagItem | undefined;
     /**
      * Returns the country code.
      *
@@ -56,6 +64,17 @@ export declare class GeoFlag {
      * @returns list of countries / список стран
      */
     getList(codes?: string[], sort?: boolean): GeoFlagItem[];
+    /**
+     * Returns a list of languages based on the provided codes.
+     * If no codes are provided, returns all available languages.
+     *
+     * Возвращает список языков на основе предоставленных кодов.
+     * Если коды не переданы, возвращает все доступные языки.
+     * @param codes array of country codes / массив кодов стран
+     * @param sort whether to sort the list / сортировать ли список
+     * @returns list of languages / список языков
+     */
+    getListLanguage(codes?: string[], sort?: boolean): GeoFlagItem[];
     /**
      * Returns a list of countries in their national languages.
      *
@@ -65,6 +84,15 @@ export declare class GeoFlag {
      * @returns list of countries with national names / список стран с национальными названиями
      */
     getNational(codes?: string[], sort?: boolean): GeoFlagNational[];
+    /**
+     * Returns a list of languages in their national names.
+     *
+     * Возвращает список языков на их национальных названиях.
+     * @param codes array of country codes / массив кодов стран
+     * @param sort whether to sort the list / сортировать ли список
+     * @returns list of languages with national names / список языков с национальными названиями
+     */
+    getNationalLanguage(codes?: string[], sort?: boolean): GeoFlagNational[];
     /**
      * Changes the current locale/location.
      *
@@ -96,7 +124,7 @@ export declare class GeoFlag {
      * Получение названия языка.
      * @param data object with information of data/ объект с информацией данных
      */
-    protected getLanguage(data: GeoItemFull): string;
+    protected getLanguageName(data: GeoItemFull): string;
     /**
      * Getting the name of the country.
      *

package/dist/src/types/apiTypes.d.ts

@@ -65,6 +65,8 @@ export type ApiConfig = {
     timeout?: number;
     /** Enable development logging/ Включить логирование разработки */
     devMode?: boolean;
+    /** Wrapper function for requests / Функция-обертка для запросов */
+    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
 };
 /**
  * Shape of API response data wrapper/ Структура обёртки данных ответа API
@@ -163,6 +165,8 @@ export type ApiFetch = {
     cacheId?: number | string;
     /** Limit of end reset/ Лимит сброса end */
     endResetLimit?: number;
+    /** Wrapper function for requests / Функция-обертка для запросов */
+    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
 };
 /**
  * Type of API hydration item/ Тип элемента гидратации API

package/dist/src/types/geoTypes.d.ts

@@ -49,8 +49,12 @@ export interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
 export interface GeoFlagItem {
     /** Language name/ Название языка */
     language: string;
+    /** Language code/ Код языка */
+    languageCode: string;
     /** Country name/ Название страны */
     country: string;
+    /** Country code/ Код страны */
+    countryCode: string;
     /** Standard locale code/ Стандартный код локали */
     standard: string;
     /** Flag icon identifier/ Идентификатор иконки флага */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.4.0",
+  "version": "1.4.2",
   "type": "module",
   "description": "Foundational utility library for modern web development — HTTP client, geolocation, i18n, SEO meta tags, caching, storage, DOM utilities, and more. Framework-agnostic, zero dependencies, TypeScript-first.",
   "keywords": [