@dxtmisha/functional 1.12.0 → 1.12.1

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.12.1] - 2026-05-21
+
+### Fixed
+- **`GeoFlagRef`**: Methods `get()`, `getFlag()`, `getList()`, and `getNational()` now accept `RefOrNormal<...>` reactive arguments instead of plain values. Parameters are unwrapped internally via `getRef()`, enabling reactive bindings to be passed directly without manual `.value` access.
+
+## [1.12.0] - 2026-05-19
+
+### Added
+- **`UseApiRequestSetup` interface**: Introduced a new exported interface that centralises all configuration for `useApiRequest` into a single typed options object (`path`, `method`, `action`, `transformation`, `validateRequestContract`, `validateResponseContract`, `errorContract`).
+- **`validateRequestContract`**: Added to both `UseApiRequestSetup` and `ApiManagementRequest` — a validation function that verifies the outgoing request payload matches the expected structure before the request is sent.
+- **`validateResponseContract`**: Added to both `UseApiRequestSetup` and `ApiManagementRequest` — a validation function (recommended for use with `@effect/schema`) that verifies the API response matches the expected structure and returns an `ApiDataValidation` result.
+- **`isApiSuccess` import**: Integrated `isApiSuccess` from `@dxtmisha/functional-basic` into `useApiRequest` for internal contract-validation branching.
+
+### Changed / Improved
+- **`useApiRequest` (Breaking)**: Refactored to accept a single `UseApiRequestSetup<T>` options object instead of multiple positional parameters. All call sites must be updated.
+- **`useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete`**: Updated to accept their own dedicated setup objects aligned with the new `UseApiRequestSetup` signature, forwarding `validateRequestContract` and `validateResponseContract` down the chain.
+- **`useApiManagementRef`**: Refactored to forward the new `validateRequestContract` and `validateResponseContract` properties when constructing request setup objects.
+- **`ApiManagementRequest` type**: Extended with a `Request` generic parameter and the two new contract-validation fields.
+- **Tests**: Updated all unit test suites (`useApiRequest`, `useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete`) to follow the new single-object signature and correctly mock `getStatus`.
+- **Documentation**: Updated multilingual MDX docs (EN / RU / VI) for `useApiRequest`, `useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete`, and `useApiManagementRef` to reflect the refactored API.
+
 ## [1.11.13] - 2026-05-18
 
 ### Added

package/dist/library.js

@@ -341,19 +341,19 @@ var Oe = class {
 		return this.code;
 	}
 	get(e = this.code.value) {
-		return I(() => this.flag.get(e));
+		return I(() => this.flag.get(U(e)));
 	}
 	getFlag(e = this.code.value) {
 		return I(() => {
 			var t;
-			return (t = this.flag.get(e)) == null ? void 0 : t.icon;
+			return (t = this.flag.get(U(e))) == null ? void 0 : t.icon;
 		});
 	}
 	getList(e) {
-		return I(() => this.flag.getList(e));
+		return I(() => this.flag.getList(U(e)));
 	}
 	getNational(e) {
-		return I(() => this.flag.getNational(e));
+		return I(() => this.flag.getNational(U(e)));
 	}
 }, J, Y = class {
 	static get() {

package/dist/src/classes/ref/GeoFlagRef.d.ts

@@ -26,26 +26,26 @@ export declare class GeoFlagRef {
      * Возвращает информацию о стране и её флаге.
      * @param code country code/ код страны
      */
-    get(code?: string): ComputedRef<GeoFlagItem | undefined>;
+    get(code?: RefOrNormal<string>): ComputedRef<GeoFlagItem | undefined>;
     /**
      * Getting a link to the flag.
      *
      * Получение ссылки на флаг.
      * @param code country code/ код страны
      */
-    getFlag(code?: string): ComputedRef<string | undefined>;
+    getFlag(code?: RefOrNormal<string>): ComputedRef<string | undefined>;
     /**
      * Getting a list of countries by an array of codes.
      *
      * Получение списка стран по массиву с кодами.
      * @param codes country code/ код страны
      */
-    getList(codes?: string[]): ComputedRef<GeoFlagItem[]>;
+    getList(codes?: RefOrNormal<string[] | undefined>): ComputedRef<GeoFlagItem[]>;
     /**
      * Getting a list of countries by an array of codes in national language.
      *
      * Получение списка стран по массиву с кодами на национальный язык.
      * @param codes country code/ код страны.
      */
-    getNational(codes?: string[]): ComputedRef<GeoFlagNational[]>;
+    getNational(codes?: RefOrNormal<string[] | undefined>): ComputedRef<GeoFlagNational[]>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional",
   "private": false,
-  "version": "1.12.0",
+  "version": "1.12.1",
   "type": "module",
   "description": "A comprehensive library of utilities, base classes, and Vue 3 composables for reactive web development. Extends @dxtmisha/functional-basic with Composition API.",
   "keywords": [