synapse-storage 3.0.19 → 4.0.1

package/README.md

@@ -1,191 +1,51 @@
 # Synapse Storage
 
-> **🇺🇸 English** | [🇷🇺 Русский](./docs/ru/README.md) | [📝  ChangeLog](./CHANGELOG.md)
-
-State management toolkit + API client
-
 [![npm version](https://badge.fury.io/js/synapse-storage.svg)](https://badge.fury.io/js/synapse-storage)
 [![Bundle Size](https://img.shields.io/bundlephobia/minzip/synapse-storage)](https://bundlephobia.com/package/synapse-storage)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue)](https://www.typescriptlang.org/)
 [![RxJS Version](https://img.shields.io/badge/RxJS-%5E7.8.2-red?logo=reactivex)](https://rxjs.dev/)
 
-## ✨ Key Features
-
-- 🚀 **Framework Agnostic** - You can use Synapse with any framework or independently
-- 💾 **Various Storage Adapters** - Memory, LocalStorage, IndexedDB
-- 🧮 **Different Ways to Access Data** - Computed values with memoization
-    - Ability to create Redux-style computed selectors
-    - Ability to directly subscribe to specific properties in storage
-    - Ability to subscribe to reactive state
-- 🌐 **API Client Creation** - HTTP client with caching capabilities (Similar to RTK Query)
-- ⚛️ **React** - Several convenient hooks for React
-- ⚡ **RxJS** - Ability to create Redux-Observable style effects
-- ⚙️ **Custom Middleware Support** - Ability to extend storage functionality with custom middlewares
-- 🔌 **Custom Plugin Support** - Ability to extend storage functionality with custom plugins
-
----
-## Author
-
-**Vladislav** — Senior Frontend Developer (React, TypeScript)
-
-> ### 🔎 Currently looking for new career opportunities!
->
-> [GitHub](https://github.com/Vlad92msk/) | [LinkedIn](https://www.linkedin.com/in/vlad-firsov/)
+Framework-agnostic state management toolkit and API client for TypeScript applications.
+Combines reactive storage, memoized selectors, Redux-Observable style effects, and a tag-based HTTP cache — all in one library.
 
----
-*PS: Not recommended for production use yet as I develop this in my free time.
-The library works in general, but I can provide guarantees only after full integration into my pet project - Social Network.
-This won't happen before changing my current workplace and country of residence*
----
-
-## 📦 Installation
+## Quick Start
 
 ```bash
 npm install synapse-storage
 ```
 
-```bash
-# For reactive capabilities
-npm install rxjs
-
-# For React integration  
-npm install react react-dom
-
-# All at once for full functionality
-npm install synapse-storage rxjs react react-dom
-```
-
-| Module | Description | Dependencies |
-|--------|-------------|--------------|
-| `synapse-storage/core` | base | - |
-| `synapse-storage/react` | React | React 18+ |
-| `synapse-storage/reactive` | RxJS | RxJS 7.8.2+ |
-| `synapse-storage/api` | HTTP client | - |
-| `synapse-storage/utils` | Utils | - |
-
-> **💡 Tip:** Import only the modules you need for optimal bundle size
-
-### tsconfig.json:
-```json
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022", 
-    "moduleResolution": "bundler"
-  }
-}
-```
-
-## 📚 Documentation
-
-- [📖 Main](./README.md)
-- [🚀 Basic Usage](./docs/en/basic-usage.md)
-- [🧮 Redux-style Computed Selectors](./docs/en/redux-selectors.md)
-- [⚙️ Middlewares](./docs/en/middlewares.md)
-- [🌐 API Client](./docs/en/api-client.md)
-- ⚡ Reactive Approach
-    - [⚡ Creating Dispatcher](./docs/en/create-dispatcher.md)
-    - [⚡ Creating Effects](./docs/en/create-effects.md)
-    - [⚡ Creating Effects Module](./docs/en/create-effects-module.md)
-- [🛠️ createSynapse Utility](./docs/en/create-synapse.md)
-- [🔌 Creating Custom Plugins](./docs/en/custom-plugins.md)
-- [⚙️ Creating Custom Middlewares](./docs/en/custom-middlewares.md)
-- [📋 Additional](./docs/en/additional.md)
-
-## 🎯 Examples
-
-- [GitHub](https://github.com/Vlad92msk/synapse-examples)
-- [YouTube](https://www.youtube.com/channel/UCGENI_i4qmBkPp98P2HvvGw)
-
----
-
-## 📊 Why Synapse Storage?
-
-**One library instead of many** - Synapse combines functionality that usually requires multiple dependencies:
-
-| What you get | Traditional approach | Synapse Storage |
-|--------------|---------------------|---------|
-| **State Management** | Redux + RTK (~45KB) | ✅ |
-| **HTTP Client + Caching** | React Query (~39KB) | ✅|
-| **Reactive Effects** | Redux-Observable (~25KB) | ✅|
-| **Storage Adapters** | Custom solutions | ✅|
-| **React Integration** | Custom hooks | ✅|
-| **Computed Selectors** | Reselect (~5KB) | ✅|
-| **Middleware System** | Custom implementation | ✅|
-| **Plugin Architecture** | Custom implementation | ✅|
-
-### Bundle Size Comparison
-
-```typescript
-// Traditional stack
-import { configureStore } from '@reduxjs/toolkit'     // ~45KB
-import { createApi } from '@reduxjs/toolkit/query'    // included in RTK
-import { QueryClient } from '@tanstack/react-query'  // ~39KB  
-import { createEpicMiddleware } from 'redux-observable' // ~25KB
-// Total: ~109KB + custom implementations
-
-// Synapse Storage
-import { createSynapse } from 'synapse-storage'       // ~171KB
-// Total: 171KB with ALL features included
-```
-
-### Modular Usage
-
-Don't need everything? Import only what you use:
-
-| Use Case          | Import                 | Size | Comparison                |
-|-------------------|------------------------|------|---------------------------|
-| **Basic state**   | `synapse-storage/core` | ~42KB | vs Redux: 45KB            |
-| **+ HTTP client** | `+ /api`               | +13KB | vs React Query: 39KB      |
-| **+ Reactive**    | `+ /reactive`          | +8KB | vs Redux-Observable: 25KB |
-| **+ React hooks** | `+ /react`             | +5KB | vs Custom hooks           |
-| **Full package**  | all modules            | ~171KB |vs 109KB stack + custom   |
-
-> **🎯 Result:** Similar or better performance with unified API and TypeScript support out of the box
-
-## 🧩 Modular Architecture "Like a Constructor"
-
-**Use only what you need** - each module works independently:
-
-### 🎯 Flexible Usage Scenarios
-
 ```typescript
-// 📦 Minimal project - storage only
 import { MemoryStorage } from 'synapse-storage/core'
-
-// 📦 + Add HTTP client when needed  
-import { ApiClient } from 'synapse-storage/api'
-
-// 📦 + Add reactive effects when required
-import { createDispatcher } from 'synapse-storage/reactive'
-
-// 📦 + Add React hooks for UI
+import { createSynapse } from 'synapse-storage/utils'
 import { useSelector } from 'synapse-storage/react'
-```
 
-### 🔧 Or Create Your Own Implementation
-
-```typescript
-// Use core + your solutions
-import { IStorage } from 'synapse-storage/core'
-
-// Implement your HTTP client
-class MyApiClient { /* your logic */ }
+const synapse = createSynapse({
+  storage: new MemoryStorage({
+    name: 'counter',
+    initialState: { count: 0 },
+  }),
+  createSelectorsFn: (s) => ({
+    count: s.createSelector((state) => state.count),
+  }),
+})
+```
 
-// Implement your React hooks  
-const useMyCustomHook = () => { /* your logic */ }
+## Key Features
 
-// Combine as convenient!
-```
+- **Sync & Async Storage** — MemoryStorage, LocalStorage (synchronous), IndexedDB (async) with unified API
+- **Selectors** — memoized computed values with dependency tracking
+- **Immer-like Updates** — mutate state directly inside `update()` callbacks
+- **API Client** — HTTP client with tag-based caching and invalidation
+- **React Integration** — hooks on `useSyncExternalStore` (Concurrent Mode safe)
+- **RxJS Effects** — dispatchers, effects, and watchers (Redux-Observable style)
+- **Middleware & Plugins** — extensible sync/async pipelines
+- **EventBus** — decoupled inter-module communication with wildcards
+- **Cross-tab Sync** — BroadcastChannel middleware for multi-tab state
 
-### 🎨 Constructor Approach Benefits
+## Documentation
 
-- **🚀 Quick Start** - begin with core, add modules as project grows
-- **📦 Optimal Bundle** - don't pay for unused functionality
-- **🔄 Flexibility** - replace any module with your implementation
-- **🛠️ Compatibility** - modules work independently but integrate perfectly
-- **📈 Scalability** - from simple state to full-featured architecture
+Full documentation, API reference, and examples available on [GitHub](https://github.com/Vlad92msk/synapse).
 
-> **💡 Evolution Example:** Started with MemoryStorage → added ApiClient → connected reactive effects → integrated React hooks. **Each step is optional!**
+## License
 
----
+MIT

package/dist/_utils/chunk.util.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Разбивает массив на группы элементов указанного размера.
+ * @param array - Массив для разбиения
+ * @param size - Размер каждой группы
+ * @returns Массив групп элементов
+ */
+export declare function chunk<T>(array: T[], size?: number): T[][];
+//# sourceMappingURL=chunk.util.d.ts.map

package/dist/_utils/chunk.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.util.d.ts","sourceRoot":"","sources":["../../src/_utils/chunk.util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,GAAE,MAAU,GAAG,CAAC,EAAE,EAAE,CAe5D"}

package/dist/_utils/chunk.util.js

@@ -0,0 +1,21 @@
+/**
+ * Разбивает массив на группы элементов указанного размера.
+ * @param array - Массив для разбиения
+ * @param size - Размер каждой группы
+ * @returns Массив групп элементов
+ */ function chunk(array, size = 1) {
+    if (size <= 0) throw new Error('Size must be greater than 0');
+    if (!array || !array.length) return [];
+    const result = [];
+    const length = array.length;
+    let index = 0;
+    while(index < length){
+        result.push(array.slice(index, index + size));
+        index += size;
+    }
+    return result;
+}
+
+export { chunk };
+
+//# sourceMappingURL=chunk.util.js.map

package/dist/_utils/chunk.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils/chunk.util.js","sources":["../../src/_utils/chunk.util.ts"],"sourcesContent":["/**\n * Разбивает массив на группы элементов указанного размера.\n * @param array - Массив для разбиения\n * @param size - Размер каждой группы\n * @returns Массив групп элементов\n */\nexport function chunk<T>(array: T[], size: number = 1): T[][] {\n  if (size <= 0) throw new Error('Size must be greater than 0')\n\n  if (!array || !array.length) return []\n\n  const result: T[][] = []\n  const length = array.length\n  let index = 0\n\n  while (index < length) {\n    result.push(array.slice(index, index + size))\n    index += size\n  }\n\n  return result\n}\n"],"names":["chunk","array","size","Error","result","length","index"],"mappings":"AAAA;;;;;CAKC,GACM,SAASA,KAAKA,CAAIC,KAAU,EAAEC,OAAe,CAAC;IACnD,IAAIA,QAAQ,GAAG,MAAM,IAAIC,MAAM;IAE/B,IAAI,CAACF,SAAS,CAACA,MAAM,MAAM,EAAE,OAAO,EAAE;IAEtC,MAAMG,SAAgB,EAAE;IACxB,MAAMC,SAASJ,MAAM,MAAM;IAC3B,IAAIK,QAAQ;IAEZ,MAAOA,QAAQD,OAAQ;QACrBD,OAAO,IAAI,CAACH,MAAM,KAAK,CAACK,OAAOA,QAAQJ;QACvCI,SAASJ;IACX;IAEA,OAAOE;AACT"}

package/dist/_utils/deepMerge.util.d.ts

@@ -0,0 +1,2 @@
+export declare const deepMerge: (target: any, source: any) => any;
+//# sourceMappingURL=deepMerge.util.d.ts.map

package/dist/_utils/deepMerge.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.util.d.ts","sourceRoot":"","sources":["../../src/_utils/deepMerge.util.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,QAAQ,GAAG,EAAE,QAAQ,GAAG,QAcjD,CAAA"}

package/dist/_utils/deepMerge.util.js

@@ -0,0 +1,19 @@
+const deepMerge = (target, source)=>{
+    for(const key in source){
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            if (typeof source[key] === 'object' && source[key] !== null && !Array.isArray(source[key])) {
+                if (!target[key] || typeof target[key] !== 'object') {
+                    target[key] = {};
+                }
+                deepMerge(target[key], source[key]);
+            } else {
+                target[key] = source[key];
+            }
+        }
+    }
+    return target;
+};
+
+export { deepMerge };
+
+//# sourceMappingURL=deepMerge.util.js.map

package/dist/_utils/deepMerge.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils/deepMerge.util.js","sources":["../../src/_utils/deepMerge.util.ts"],"sourcesContent":["export const deepMerge = (target: any, source: any) => {\n  for (const key in source) {\n    if (Object.prototype.hasOwnProperty.call(source, key)) {\n      if (typeof source[key] === 'object' && source[key] !== null && !Array.isArray(source[key])) {\n        if (!target[key] || typeof target[key] !== 'object') {\n          target[key] = {}\n        }\n        deepMerge(target[key], source[key])\n      } else {\n        target[key] = source[key]\n      }\n    }\n  }\n  return target\n}\n"],"names":["deepMerge","target","source","key","Object","Array"],"mappings":"AAAO,MAAMA,SAASA,GAAG,CAACC,QAAaC;IACrC,IAAK,MAAMC,OAAOD,OAAQ;QACxB,IAAIE,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACF,QAAQC,MAAM;YACrD,IAAI,OAAOD,MAAM,CAACC,IAAI,KAAK,YAAYD,MAAM,CAACC,IAAI,KAAK,QAAQ,CAACE,MAAM,OAAO,CAACH,MAAM,CAACC,IAAI,GAAG;gBAC1F,IAAI,CAACF,MAAM,CAACE,IAAI,IAAI,OAAOF,MAAM,CAACE,IAAI,KAAK,UAAU;oBACnDF,MAAM,CAACE,IAAI,GAAG,CAAC;gBACjB;gBACAH,SAASA,CAACC,MAAM,CAACE,IAAI,EAAED,MAAM,CAACC,IAAI;YACpC,OAAO;gBACLF,MAAM,CAACE,IAAI,GAAGD,MAAM,CAACC,IAAI;YAC3B;QACF;IACF;IACA,OAAOF;AACT,EAAC"}

package/dist/_utils/error-handling.util.d.ts

@@ -0,0 +1,50 @@
+import type { ILogger } from '../core/storage/storage.interface';
+/**
+ * Базовый класс ошибок Synapse.
+ * Позволяет отличать ошибки библиотеки от прочих через `instanceof`.
+ */
+export declare class SynapseError extends Error {
+    readonly context?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, context?: string | undefined, cause?: unknown | undefined);
+}
+/**
+ * Категории обработки ошибок в Synapse:
+ *
+ * - CRITICAL:   Ошибки конфигурации/инициализации → log + throw (fail fast)
+ * - OPERATION:  Ошибки CRUD-операций → log + rethrow (вызывающий код решает)
+ * - CALLBACK:   Ошибки в пользовательских callback'ах → log + swallow (не крашим приложение)
+ * - CLEANUP:    Ошибки при destroy/unsubscribe → log + swallow (best-effort)
+ */
+type LogMethod = 'error' | 'warn';
+/**
+ * Логирует ошибку через ILogger (если есть) или через console-fallback.
+ */
+export declare function logError(message: string, error: unknown, logger?: ILogger | null, level?: LogMethod): void;
+/**
+ * OPERATION pattern: логирует и пробрасывает ошибку.
+ * Для CRUD-операций (get, set, update, delete) и инициализации.
+ */
+export declare function handleOperationError(context: string, error: unknown, logger?: ILogger | null): never;
+/**
+ * CALLBACK pattern: логирует и проглатывает ошибку.
+ * Для пользовательских callback'ов, подписчиков, эффектов.
+ * Ошибка в одном callback'е не должна ломать остальные.
+ */
+export declare function handleCallbackError(context: string, error: unknown, logger?: ILogger | null): void;
+/**
+ * CLEANUP pattern: логирует предупреждение и продолжает.
+ * Для destroy(), unsubscribe() и прочих cleanup-операций.
+ */
+export declare function handleCleanupError(context: string, error: unknown, logger?: ILogger | null): void;
+/**
+ * Обёртка для безопасного вызова callback'а (CALLBACK pattern).
+ * Возвращает результат или undefined при ошибке.
+ */
+export declare function safeCallback<T>(fn: () => T, context: string, logger?: ILogger | null): T | undefined;
+/**
+ * Обёртка для promise в fire-and-forget сценариях (CLEANUP pattern).
+ */
+export declare function safePromise(promise: Promise<unknown>, context: string, logger?: ILogger | null): void;
+export {};
+//# sourceMappingURL=error-handling.util.d.ts.map

package/dist/_utils/error-handling.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handling.util.d.ts","sourceRoot":"","sources":["../../src/_utils/error-handling.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAA;AAGhE;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,OAAO,CAAC,EAAE,MAAM;aAChB,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,YAAA,EAChB,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;;;;;;GAOG;AAEH,KAAK,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAEjC;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,GAAE,SAAmB,GAAG,IAAI,CAOnH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,CAGpG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAElG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAEjG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,SAAS,CAOpG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAErG"}

package/dist/_utils/error-handling.util.js

@@ -0,0 +1,67 @@
+import { loggerConsole } from "./logger-console.util.js";
+
+
+
+/**
+ * Базовый класс ошибок Synapse.
+ * Позволяет отличать ошибки библиотеки от прочих через `instanceof`.
+ */ class SynapseError extends Error {
+    context;
+    cause;
+    constructor(message, context, cause){
+        super(context ? `[${context}] ${message}` : message), this.context = context, this.cause = cause;
+        this.name = 'SynapseError';
+    }
+}
+/**
+ * Логирует ошибку через ILogger (если есть) или через console-fallback.
+ */ function logError(message, error, logger, level = 'error') {
+    const meta = {
+        error: error instanceof Error ? error.message : String(error)
+    };
+    if (logger) {
+        logger[level](message, meta);
+    } else {
+        loggerConsole[level](`[Synapse] ${message}`, error);
+    }
+}
+/**
+ * OPERATION pattern: логирует и пробрасывает ошибку.
+ * Для CRUD-операций (get, set, update, delete) и инициализации.
+ */ function handleOperationError(context, error, logger) {
+    logError(context, error, logger);
+    throw error;
+}
+/**
+ * CALLBACK pattern: логирует и проглатывает ошибку.
+ * Для пользовательских callback'ов, подписчиков, эффектов.
+ * Ошибка в одном callback'е не должна ломать остальные.
+ */ function handleCallbackError(context, error, logger) {
+    logError(context, error, logger);
+}
+/**
+ * CLEANUP pattern: логирует предупреждение и продолжает.
+ * Для destroy(), unsubscribe() и прочих cleanup-операций.
+ */ function handleCleanupError(context, error, logger) {
+    logError(context, error, logger, 'warn');
+}
+/**
+ * Обёртка для безопасного вызова callback'а (CALLBACK pattern).
+ * Возвращает результат или undefined при ошибке.
+ */ function safeCallback(fn, context, logger) {
+    try {
+        return fn();
+    } catch (error) {
+        handleCallbackError(context, error, logger);
+        return undefined;
+    }
+}
+/**
+ * Обёртка для promise в fire-and-forget сценариях (CLEANUP pattern).
+ */ function safePromise(promise, context, logger) {
+    promise.catch((error)=>handleCleanupError(context, error, logger));
+}
+
+export { SynapseError, handleCallbackError, handleCleanupError, handleOperationError, logError, safeCallback, safePromise };
+
+//# sourceMappingURL=error-handling.util.js.map

package/dist/_utils/error-handling.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils/error-handling.util.js","sources":["../../src/_utils/error-handling.util.ts"],"sourcesContent":["import type { ILogger } from '../core/storage/storage.interface'\nimport { loggerConsole } from './logger-console.util'\n\n/**\n * Базовый класс ошибок Synapse.\n * Позволяет отличать ошибки библиотеки от прочих через `instanceof`.\n */\nexport class SynapseError extends Error {\n  constructor(\n    message: string,\n    public readonly context?: string,\n    public readonly cause?: unknown,\n  ) {\n    super(context ? `[${context}] ${message}` : message)\n    this.name = 'SynapseError'\n  }\n}\n\n/**\n * Категории обработки ошибок в Synapse:\n *\n * - CRITICAL:   Ошибки конфигурации/инициализации → log + throw (fail fast)\n * - OPERATION:  Ошибки CRUD-операций → log + rethrow (вызывающий код решает)\n * - CALLBACK:   Ошибки в пользовательских callback'ах → log + swallow (не крашим приложение)\n * - CLEANUP:    Ошибки при destroy/unsubscribe → log + swallow (best-effort)\n */\n\ntype LogMethod = 'error' | 'warn'\n\n/**\n * Логирует ошибку через ILogger (если есть) или через console-fallback.\n */\nexport function logError(message: string, error: unknown, logger?: ILogger | null, level: LogMethod = 'error'): void {\n  const meta = { error: error instanceof Error ? error.message : String(error) }\n  if (logger) {\n    logger[level](message, meta)\n  } else {\n    loggerConsole[level](`[Synapse] ${message}`, error)\n  }\n}\n\n/**\n * OPERATION pattern: логирует и пробрасывает ошибку.\n * Для CRUD-операций (get, set, update, delete) и инициализации.\n */\nexport function handleOperationError(context: string, error: unknown, logger?: ILogger | null): never {\n  logError(context, error, logger)\n  throw error\n}\n\n/**\n * CALLBACK pattern: логирует и проглатывает ошибку.\n * Для пользовательских callback'ов, подписчиков, эффектов.\n * Ошибка в одном callback'е не должна ломать остальные.\n */\nexport function handleCallbackError(context: string, error: unknown, logger?: ILogger | null): void {\n  logError(context, error, logger)\n}\n\n/**\n * CLEANUP pattern: логирует предупреждение и продолжает.\n * Для destroy(), unsubscribe() и прочих cleanup-операций.\n */\nexport function handleCleanupError(context: string, error: unknown, logger?: ILogger | null): void {\n  logError(context, error, logger, 'warn')\n}\n\n/**\n * Обёртка для безопасного вызова callback'а (CALLBACK pattern).\n * Возвращает результат или undefined при ошибке.\n */\nexport function safeCallback<T>(fn: () => T, context: string, logger?: ILogger | null): T | undefined {\n  try {\n    return fn()\n  } catch (error) {\n    handleCallbackError(context, error, logger)\n    return undefined\n  }\n}\n\n/**\n * Обёртка для promise в fire-and-forget сценариях (CLEANUP pattern).\n */\nexport function safePromise(promise: Promise<unknown>, context: string, logger?: ILogger | null): void {\n  promise.catch((error) => handleCleanupError(context, error, logger))\n}\n"],"names":["loggerConsole","SynapseError","Error","message","context","cause","logError","error","logger","level","meta","String","handleOperationError","handleCallbackError","handleCleanupError","safeCallback","fn","undefined","safePromise","promise"],"mappings":";;;AACqD;AAErD;;;CAGC,GACM,MAAMC,YAAYA,SAASC;;;IAChC,YACEC,OAAe,EACCC,OAAgB,EAChBC,KAAe,CAC/B;QACA,KAAK,CAACD,UAAU,CAAC,CAAC,EAAEA,QAAQ,EAAE,EAAED,SAAS,GAAGA,eAH5BC,UAAAA,cACAC,QAAAA;QAGhB,IAAI,CAAC,IAAI,GAAG;IACd;AACF;AAaA;;CAEC,GACM,SAASC,QAAQA,CAACH,OAAe,EAAEI,KAAc,EAAEC,MAAuB,EAAEC,QAAmB,OAAO;IAC3G,MAAMC,OAAO;QAAE,OAAOH,iBAAiBL,QAAQK,MAAM,OAAO,GAAGI,OAAOJ;IAAO;IAC7E,IAAIC,QAAQ;QACVA,MAAM,CAACC,MAAM,CAACN,SAASO;IACzB,OAAO;QACLV,aAAa,CAACS,MAAM,CAAC,CAAC,UAAU,EAAEN,SAAS,EAAEI;IAC/C;AACF;AAEA;;;CAGC,GACM,SAASK,oBAAoBA,CAACR,OAAe,EAAEG,KAAc,EAAEC,MAAuB;IAC3FF,QAAQA,CAACF,SAASG,OAAOC;IACzB,MAAMD;AACR;AAEA;;;;CAIC,GACM,SAASM,mBAAmBA,CAACT,OAAe,EAAEG,KAAc,EAAEC,MAAuB;IAC1FF,QAAQA,CAACF,SAASG,OAAOC;AAC3B;AAEA;;;CAGC,GACM,SAASM,kBAAkBA,CAACV,OAAe,EAAEG,KAAc,EAAEC,MAAuB;IACzFF,QAAQA,CAACF,SAASG,OAAOC,QAAQ;AACnC;AAEA;;;CAGC,GACM,SAASO,YAAYA,CAAIC,EAAW,EAAEZ,OAAe,EAAEI,MAAuB;IACnF,IAAI;QACF,OAAOQ;IACT,EAAE,OAAOT,OAAO;QACdM,mBAAmBA,CAACT,SAASG,OAAOC;QACpC,OAAOS;IACT;AACF;AAEA;;CAEC,GACM,SAASC,WAAWA,CAACC,OAAyB,EAAEf,OAAe,EAAEI,MAAuB;IAC7FW,QAAQ,KAAK,CAAC,CAACZ,QAAUO,kBAAkBA,CAACV,SAASG,OAAOC;AAC9D"}

package/dist/_utils/flatMap.util.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Создает новый массив, применяя функцию к каждому элементу массива,
+ * а затем сглаживает результат на один уровень.
+ *
+ * @param array - Исходный массив
+ * @param iteratee - Функция, применяемая к каждому элементу
+ * @returns Новый сглаженный массив
+ */
+export declare function flatMap<T, R>(array: T[], iteratee: (value: T, index: number, array: T[]) => R | R[]): R[];
+//# sourceMappingURL=flatMap.util.d.ts.map

package/dist/_utils/flatMap.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatMap.util.d.ts","sourceRoot":"","sources":["../../src/_utils/flatMap.util.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAczG"}

package/dist/_utils/flatMap.util.js

@@ -0,0 +1,23 @@
+/**
+ * Создает новый массив, применяя функцию к каждому элементу массива,
+ * а затем сглаживает результат на один уровень.
+ *
+ * @param array - Исходный массив
+ * @param iteratee - Функция, применяемая к каждому элементу
+ * @returns Новый сглаженный массив
+ */ function flatMap(array, iteratee) {
+    if (!array || !array.length) return [];
+    return array.reduce((acc, value, index)=>{
+        const mapped = iteratee(value, index, array);
+        if (Array.isArray(mapped)) {
+            acc.push(...mapped);
+        } else {
+            acc.push(mapped);
+        }
+        return acc;
+    }, []);
+}
+
+export { flatMap };
+
+//# sourceMappingURL=flatMap.util.js.map

package/dist/_utils/flatMap.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils/flatMap.util.js","sources":["../../src/_utils/flatMap.util.ts"],"sourcesContent":["/**\n * Создает новый массив, применяя функцию к каждому элементу массива,\n * а затем сглаживает результат на один уровень.\n *\n * @param array - Исходный массив\n * @param iteratee - Функция, применяемая к каждому элементу\n * @returns Новый сглаженный массив\n */\nexport function flatMap<T, R>(array: T[], iteratee: (value: T, index: number, array: T[]) => R | R[]): R[] {\n  if (!array || !array.length) return []\n\n  return array.reduce((acc: R[], value: T, index: number) => {\n    const mapped = iteratee(value, index, array)\n\n    if (Array.isArray(mapped)) {\n      acc.push(...mapped)\n    } else {\n      acc.push(mapped)\n    }\n\n    return acc\n  }, [])\n}\n"],"names":["flatMap","array","iteratee","acc","value","index","mapped","Array"],"mappings":"AAAA;;;;;;;CAOC,GACM,SAASA,OAAOA,CAAOC,KAAU,EAAEC,QAA0D;IAClG,IAAI,CAACD,SAAS,CAACA,MAAM,MAAM,EAAE,OAAO,EAAE;IAEtC,OAAOA,MAAM,MAAM,CAAC,CAACE,KAAUC,OAAUC;QACvC,MAAMC,SAASJ,SAASE,OAAOC,OAAOJ;QAEtC,IAAIM,MAAM,OAAO,CAACD,SAAS;YACzBH,IAAI,IAAI,IAAIG;QACd,OAAO;YACLH,IAAI,IAAI,CAACG;QACX;QAEA,OAAOH;IACT,GAAG,EAAE;AACP"}

package/dist/_utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './chunk.util';
+export * from './deepMerge.util';
+export * from './error-handling.util';
+export * from './flatMap.util';
+export * from './logger-console.util';
+//# sourceMappingURL=index.d.ts.map

package/dist/_utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/_utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA"}

package/dist/_utils/index.js

@@ -0,0 +1,13 @@
+export * from "./chunk.util.js";
+export * from "./deepMerge.util.js";
+export * from "./error-handling.util.js";
+export * from "./flatMap.util.js";
+export * from "./logger-console.util.js";
+
+
+
+
+
+
+
+//# sourceMappingURL=index.js.map

package/dist/_utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils/index.js","sources":["../../src/_utils/index.ts"],"sourcesContent":["export * from './chunk.util'\nexport * from './deepMerge.util'\nexport * from './error-handling.util'\nexport * from './flatMap.util'\nexport * from './logger-console.util'\n"],"names":[],"mappings":";;;;;AAA4B;AACI;AACK;AACP;AACO"}

package/dist/_utils/logger-console.util.d.ts

@@ -0,0 +1,9 @@
+export declare const loggerConsole: {
+    log: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    group: (...args: any[]) => void;
+    groupEnd: () => void;
+    groupCollapsed: (...args: any[]) => void;
+};
+//# sourceMappingURL=logger-console.util.d.ts.map

package/dist/_utils/logger-console.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-console.util.d.ts","sourceRoot":"","sources":["../../src/_utils/logger-console.util.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa;mBACT,GAAG,EAAE;oBACJ,GAAG,EAAE;qBACJ,GAAG,EAAE;qBACL,GAAG,EAAE;;8BAEI,GAAG,EAAE;CAChC,CAAA"}

package/dist/_utils/logger-console.util.js

@@ -0,0 +1,14 @@
+const globalConsole = globalThis.console;
+// Экспортируем обертку, которая использует console через globalThis
+const loggerConsole = {
+    log: (...args)=>globalConsole.log(...args),
+    warn: (...args)=>globalConsole.warn(...args),
+    error: (...args)=>globalConsole.error(...args),
+    group: (...args)=>globalConsole.group(...args),
+    groupEnd: ()=>globalConsole.groupEnd(),
+    groupCollapsed: (...args)=>globalConsole.groupCollapsed(...args)
+};
+
+export { loggerConsole };
+
+//# sourceMappingURL=logger-console.util.js.map

package/dist/_utils/logger-console.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils/logger-console.util.js","sources":["../../src/_utils/logger-console.util.ts"],"sourcesContent":["const globalConsole = globalThis.console\n\n// Экспортируем обертку, которая использует console через globalThis\nexport const loggerConsole = {\n  log: (...args: any[]) => globalConsole.log(...args),\n  warn: (...args: any[]) => globalConsole.warn(...args),\n  error: (...args: any[]) => globalConsole.error(...args),\n  group: (...args: any[]) => globalConsole.group(...args),\n  groupEnd: () => globalConsole.groupEnd(),\n  groupCollapsed: (...args: any[]) => globalConsole.groupCollapsed(...args),\n}\n"],"names":["globalConsole","globalThis","loggerConsole","args"],"mappings":"AAAA,MAAMA,aAAaA,GAAGC,WAAW,OAAO;AAExC,oEAAoE;AAC7D,MAAMC,aAAaA,GAAG;IAC3B,KAAK,CAAC,GAAGC,OAAgBH,aAAaA,CAAC,GAAG,IAAIG;IAC9C,MAAM,CAAC,GAAGA,OAAgBH,aAAaA,CAAC,IAAI,IAAIG;IAChD,OAAO,CAAC,GAAGA,OAAgBH,aAAaA,CAAC,KAAK,IAAIG;IAClD,OAAO,CAAC,GAAGA,OAAgBH,aAAaA,CAAC,KAAK,IAAIG;IAClD,UAAU,IAAMH,aAAaA,CAAC,QAAQ;IACtC,gBAAgB,CAAC,GAAGG,OAAgBH,aAAaA,CAAC,cAAc,IAAIG;AACtE,EAAC"}

package/dist/api/api.module.d.ts

@@ -0,0 +1,46 @@
+import { CreateApiClientOptions, ExtractParamsType, ExtractResultType } from './types/api.interface';
+import { CreateEndpoint, Endpoint as EndpointType, EndpointConfig } from './types/endpoint.interface';
+import { QueryOptions, QueryResult } from './types/query.interface';
+type EndpointsResult<F> = F extends (create: any) => Promise<infer R> ? R : never;
+type EndpointsMap<EndpointsFn> = {
+    [K in keyof EndpointsResult<EndpointsFn>]: EndpointType<ExtractParamsType<EndpointsResult<EndpointsFn>[K]>, ExtractResultType<EndpointsResult<EndpointsFn>[K]>>;
+};
+export declare class ApiClient<EndpointsFn extends (create: CreateEndpoint) => Promise<Record<string, EndpointConfig<any, any>>>> {
+    /** Хранилище запросов */
+    private queryStorage;
+    /** Флаг завершённой инициализации */
+    private _initialized;
+    /** Промис текущей инициализации (для дедупликации параллельных вызовов) */
+    private _initPromise;
+    private readonly cacheableHeaderKeys;
+    private readonly globalCacheConfig;
+    private readonly baseQueryConfig;
+    private readonly storageExternal;
+    private readonly globalRetryConfig;
+    private readonly createEndpoints;
+    /** Реестр эндпоинтов */
+    private endpoints;
+    constructor(options: Omit<CreateApiClientOptions, 'endpoints'> & {
+        endpoints: EndpointsFn;
+    });
+    init(): Promise<this>;
+    private _doInit;
+    private initializeEndpoints;
+    private ensureInitialized;
+    /**
+     * Получает все эндпоинты с улучшенной типизацией
+     * @returns Типизированный объект эндпоинтов
+     */
+    getEndpoints(): EndpointsMap<EndpointsFn>;
+    /**
+     * Выполняет запрос к API с типизацией и обработкой ошибок
+     * @param endpointName Имя эндпоинта (с подсказками TypeScript)
+     * @param params Параметры запроса (с типизацией)
+     * @param options Опции запроса
+     * @returns Promise с типизированным результатом запроса
+     */
+    request<K extends keyof EndpointsResult<EndpointsFn> & string>(endpointName: K, params: ExtractParamsType<EndpointsResult<EndpointsFn>[K]>, options?: QueryOptions): Promise<QueryResult<ExtractResultType<EndpointsResult<EndpointsFn>[K]>, Error>>;
+    destroy(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=api.module.d.ts.map

package/dist/api/api.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.module.d.ts","sourceRoot":"","sources":["../../src/api/api.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACpG,OAAO,EAAE,cAAc,EAAE,QAAQ,IAAI,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AACrG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAInE,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAGjF,KAAK,YAAY,CAAC,WAAW,IAAI;KAC9B,CAAC,IAAI,MAAM,eAAe,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC,iBAAiB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAChK,CAAA;AAED,qBAAa,SAAS,CAAC,WAAW,SAAS,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACtH,yBAAyB;IACzB,OAAO,CAAC,YAAY,CAAe;IAEnC,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAAQ;IAE5B,2EAA2E;IAC3E,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA+C;IAEnF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IAEnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IAErE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IAEnE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IAEnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAE7C,wBAAwB;IACxB,OAAO,CAAC,SAAS,CAEX;gBAEM,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,EAAE,WAAW,CAAA;KAAE;IAU9E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAQpB,OAAO;YAgBP,mBAAmB;IAqBjC,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACI,YAAY,IAAI,YAAY,CAAC,WAAW,CAAC;IAKhD;;;;;;OAMG;IACU,OAAO,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,WAAW,CAAC,GAAG,MAAM,EACxE,YAAY,EAAE,CAAC,EACf,MAAM,EAAE,iBAAiB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1D,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAmBrE,OAAO;CAerB"}