complexqa_frontend_core 1.18.5 → 1.18.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.18.5",
+  "version": "1.18.7",
   "description": "core of web ",
   "type": "module",
   "exports": {

package/publish/api/api_abstract_class.js

@@ -17,6 +17,7 @@ export class ApiAbstractClass
 	api_prefix    = '';
 	method;
 	headers;
+	search_cache_enabled = false;
 
 
 	/**

package/publish/api/api_abstract_reference_class.js

@@ -1,4 +1,5 @@
 import { ApiAbstractClass } from "./api_abstract_class.js";
+import { resolveCachedSearch } from "./cache/api_search_cache.js";
 
 /**
  *
@@ -9,6 +10,9 @@ export class ApiAbstractReferenceClass extends ApiAbstractClass
 
 	api_prefix = 'api';
 
+	/** @type {boolean} */
+	search_cache_enabled = true;
+
 	/**
 	 *
 	 * @version			v.1.0 (03/06/2026)
@@ -16,7 +20,7 @@ export class ApiAbstractReferenceClass extends ApiAbstractClass
 	 */
 	constructor(options)
 	{
-		super();
+		super(options);
 	}
 
 
@@ -31,6 +35,22 @@ export class ApiAbstractReferenceClass extends ApiAbstractClass
 	 * @param {?object|undefined} 	payload.response
 	 */
 	async search(payload = {})
+	{
+		return resolveCachedSearch(
+			this,
+			'search',
+			payload,
+			(p) => this.executeSearch(p),
+			{ useCache: this.search_cache_enabled },
+		);
+	}
+
+
+	/**
+	 * @param {object|typeFOR} payload
+	 * @returns {Promise<{response: *, payload: *}>}
+	 */
+	async executeSearch(payload = {})
 	{
 		if (!this.module_prefix)
 		{
@@ -50,7 +70,7 @@ export class ApiAbstractReferenceClass extends ApiAbstractClass
 
 		return {
 			response: response,
-			payload : payload
+			payload : payload,
 		};
 	}
 }

package/publish/api/cache/api_search_cache.js

@@ -0,0 +1,138 @@
+import { clone_object } from "../../utils/utils.js";
+import { MemoryCacheStore } from "./memory_cache_store.js";
+
+export const DEFAULT_SEARCH_CACHE_TTL_MS = 4 * 60 * 60 * 1000;
+
+let cacheStore = new MemoryCacheStore();
+
+/**
+ * DI: подмена хранилища кеша (например, persistent/store с TTL).
+ *
+ * @param {MemoryCacheStore} store
+ */
+export function setApiSearchCacheStore(store)
+{
+	cacheStore = store;
+}
+
+
+/**
+ * @returns {MemoryCacheStore}
+ */
+export function getApiSearchCacheStore()
+{
+	return cacheStore;
+}
+
+
+/**
+ * @param {object} apiInstance
+ * @param {string} methodName
+ * @returns {string}
+ */
+export function buildSearchCacheKey(apiInstance, methodName = 'search')
+{
+	return `${ apiInstance?.constructor?.name || 'Api' }.${ methodName }`;
+}
+
+
+/**
+ * Дефолтный запрос: без фильтров и без options.
+ *
+ * @param {object|false|undefined} payload
+ * @returns {boolean}
+ */
+export function isDefaultSearchPayload(payload)
+{
+	const filters = payload?.filters ?? payload?.filter ?? [];
+
+	if (!Array.isArray(filters) || filters.length > 0)
+	{
+		return false;
+	}
+
+	const options = payload?.options;
+
+	if (options === false || options == null)
+	{
+		return true;
+	}
+
+	if (typeof options === 'object' && Object.keys(options).length === 0)
+	{
+		return true;
+	}
+
+	return false;
+}
+
+
+/**
+ * @param {{ response: Promise<*>|*, payload: * }} result
+ * @returns {Promise<{ response: *, payload: * }>}
+ */
+async function materializeSearchResult(result)
+{
+	return {
+		response: await result.response,
+		payload : result.payload,
+	};
+}
+
+
+/**
+ * @param {{ response: *, payload: * }} result
+ * @returns {{ response: Promise<*>, payload: * }}
+ */
+function wrapSearchResult(result)
+{
+	return {
+		response: Promise.resolve(result.response),
+		payload : result.payload,
+	};
+}
+
+
+/**
+ * @param {object} apiInstance
+ * @param {string} methodName
+ * @param {object|false|undefined} payload
+ * @param {Function} searchFn
+ * @param {object} [config]
+ * @param {boolean} [config.useCache]
+ * @param {number} [config.ttlMs]
+ * @returns {Promise<*>}
+ */
+export async function resolveCachedSearch(
+	apiInstance,
+	methodName,
+	payload,
+	searchFn,
+	config = {},
+)
+{
+	const {
+		useCache = false,
+		ttlMs = DEFAULT_SEARCH_CACHE_TTL_MS,
+	} = config;
+
+	if (!useCache || !isDefaultSearchPayload(payload))
+	{
+		return searchFn(payload);
+	}
+
+	const cacheKey = buildSearchCacheKey(apiInstance, methodName);
+	const cached = cacheStore.get(cacheKey);
+
+	if (cached !== undefined)
+	{
+		return wrapSearchResult(clone_object(cached));
+	}
+
+	const result       = await searchFn(payload);
+	const materialized = await materializeSearchResult(result);
+
+	cacheStore.set(cacheKey, clone_object(materialized), ttlMs);
+
+	return wrapSearchResult(materialized);
+}

package/publish/api/cache/index.js

@@ -0,0 +1,9 @@
+export { MemoryCacheStore } from "./memory_cache_store.js";
+export {
+	DEFAULT_SEARCH_CACHE_TTL_MS,
+	setApiSearchCacheStore,
+	getApiSearchCacheStore,
+	buildSearchCacheKey,
+	isDefaultSearchPayload,
+	resolveCachedSearch,
+} from "./api_search_cache.js";

package/publish/api/cache/memory_cache_store.js

@@ -0,0 +1,64 @@
+/**
+ * Простое in-memory key-value хранилище с TTL.
+ *
+ * @version			v.1.0 (13/06/2026)
+ */
+export class MemoryCacheStore
+{
+	constructor()
+	{
+		this._entries = new Map();
+	}
+
+
+	/**
+	 * @param {string} key
+	 * @returns {*|undefined}
+	 */
+	get(key)
+	{
+		const entry = this._entries.get(key);
+
+		if (!entry)
+		{
+			return undefined;
+		}
+
+		if (entry.expiresAt <= Date.now())
+		{
+			this._entries.delete(key);
+			return undefined;
+		}
+
+		return entry.value;
+	}
+
+
+	/**
+	 * @param {string} key
+	 * @param {*} value
+	 * @param {number} ttlMs
+	 */
+	set(key, value, ttlMs)
+	{
+		this._entries.set(key, {
+			value,
+			expiresAt: Date.now() + ttlMs,
+		});
+	}
+
+
+	/**
+	 * @param {string} key
+	 */
+	delete(key)
+	{
+		this._entries.delete(key);
+	}
+
+
+	clear()
+	{
+		this._entries.clear();
+	}
+}