synapse-storage 4.1.2 → 5.0.3

package/dist/react/hooks/useObservable.js

@@ -0,0 +1,38 @@
+import { useEffect, useRef, useState } from "react";
+
+
+
+/**
+ * Подписка на Observable из компонента.
+ *
+ * `source` — либо готовый `Observable<T>` (например `selector.$`), либо фабрика
+ * `() => Observable<T>`, собирающая цепочку (`pipe(debounceTime(...))`) при подписке.
+ *
+ * До первого эмита возвращается `initialValue`. Подписка снимается на unmount и
+ * пересоздаётся при смене `deps` (вся цепочка строится заново — актуально для
+ * операторов с состоянием вроде `debounceTime`/`scan`). Если `deps` не переданы:
+ * для прямого Observable цепочка пересоздаётся при смене ссылки `source`, для
+ * фабрики — создаётся один раз.
+ *
+ * @template T тип значения потока
+ */ function useObservable(source, initialValue, deps) {
+    const [value, setValue] = useState(initialValue);
+    // Держим source в ref, чтобы замыкание эффекта всегда читало актуальную фабрику,
+    // но переподписка управлялась исключительно через deps.
+    const sourceRef = useRef(source);
+    sourceRef.current = source;
+    const effectDeps = deps ?? (typeof source === 'function' ? [] : [
+        source
+    ]);
+    useEffect(()=>{
+        const current = sourceRef.current;
+        const observable = typeof current === 'function' ? current() : current;
+        const subscription = observable.subscribe((next)=>setValue(next));
+        return ()=>subscription.unsubscribe();
+    }, effectDeps);
+    return value;
+}
+
+export { useObservable };
+
+//# sourceMappingURL=useObservable.js.map

package/dist/react/hooks/useObservable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react/hooks/useObservable.js","sources":["../../../src/react/hooks/useObservable.ts"],"sourcesContent":["import { DependencyList, useEffect, useRef, useState } from 'react'\nimport { Observable } from 'rxjs'\n\n/**\n * Подписка на Observable из компонента.\n *\n * `source` — либо готовый `Observable<T>` (например `selector.$`), либо фабрика\n * `() => Observable<T>`, собирающая цепочку (`pipe(debounceTime(...))`) при подписке.\n *\n * До первого эмита возвращается `initialValue`. Подписка снимается на unmount и\n * пересоздаётся при смене `deps` (вся цепочка строится заново — актуально для\n * операторов с состоянием вроде `debounceTime`/`scan`). Если `deps` не переданы:\n * для прямого Observable цепочка пересоздаётся при смене ссылки `source`, для\n * фабрики — создаётся один раз.\n *\n * @template T тип значения потока\n */\nexport function useObservable<T>(source: Observable<T> | (() => Observable<T>), initialValue: T, deps?: DependencyList): T {\n  const [value, setValue] = useState<T>(initialValue)\n\n  // Держим source в ref, чтобы замыкание эффекта всегда читало актуальную фабрику,\n  // но переподписка управлялась исключительно через deps.\n  const sourceRef = useRef(source)\n  sourceRef.current = source\n\n  const effectDeps = deps ?? (typeof source === 'function' ? [] : [source])\n\n  useEffect(() => {\n    const current = sourceRef.current\n    const observable = typeof current === 'function' ? (current as () => Observable<T>)() : current\n    const subscription = observable.subscribe((next) => setValue(next))\n    return () => subscription.unsubscribe()\n  }, effectDeps)\n\n  return value\n}\n"],"names":["useEffect","useRef","useState","useObservable","source","initialValue","deps","value","setValue","sourceRef","effectDeps","current","observable","subscription","next"],"mappings":";;;AAAmE;AAGnE;;;;;;;;;;;;;CAaC,GACM,SAASG,aAAaA,CAAIC,MAA6C,EAAEC,YAAe,EAAEC,IAAqB;IACpH,MAAM,CAACC,OAAOC,SAAS,GAAGN,QAAQA,CAAIG;IAEtC,iFAAiF;IACjF,wDAAwD;IACxD,MAAMI,YAAYR,MAAMA,CAACG;IACzBK,UAAU,OAAO,GAAGL;IAEpB,MAAMM,aAAaJ,QAAS,QAAOF,WAAW,aAAa,EAAE,GAAG;QAACA;KAAM;IAEvEJ,SAASA,CAAC;QACR,MAAMW,UAAUF,UAAU,OAAO;QACjC,MAAMG,aAAa,OAAOD,YAAY,aAAcA,YAAoCA;QACxF,MAAME,eAAeD,WAAW,SAAS,CAAC,CAACE,OAASN,SAASM;QAC7D,OAAO,IAAMD,aAAa,WAAW;IACvC,GAAGH;IAEH,OAAOH;AACT"}

package/dist/react/hooks/useSelector.d.ts

@@ -33,4 +33,3 @@ export declare function useSelector<T>(selector: SelectorAPI<T>, options: UseSel
  */
 export declare function useKeyedSliceSelector<V>(selector: SelectorAPI<Record<string, V>>, key: string, fallback: V): V;
 export {};
-//# sourceMappingURL=useSelector.d.ts.map

package/dist/react/hooks/useSelector.js

@@ -27,7 +27,10 @@ function useSelector(selector, options) {
     }, [
         selector
     ]);
-    const value = useSyncExternalStore(subscribe, getSnapshot);
+    // getServerSnapshot === getSnapshot: на сервере `selectSync()` синхронно читает
+    // засеянный (hydrate) стор. Без серверного снапшота useSyncExternalStore на сервере
+    // падает и откатывается на client-only рендер (контент не попадает в SSR-HTML).
+    const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
     // Подписка на статус готовности storage (используется только при withLoading)
     const subscribeToStatus = useCallback((onStoreChange)=>{
         return selector.onSourceStatusChange(()=>{
@@ -41,7 +44,7 @@ function useSelector(selector, options) {
     }, [
         selector
     ]);
-    const isLoading = useSyncExternalStore(subscribeToStatus, getStatusSnapshot);
+    const isLoading = useSyncExternalStore(subscribeToStatus, getStatusSnapshot, getStatusSnapshot);
     if (options?.withLoading) {
         return {
             data: value,

package/dist/react/hooks/useSelector.js.map

@@ -1 +1 @@
-{"version":3,"file":"react/hooks/useSelector.js","sources":["../../../src/react/hooks/useSelector.ts"],"sourcesContent":["import { useCallback, useRef, useSyncExternalStore } from 'react'\n\nimport type { SelectorAPI } from '../../core'\n\ninterface UseSelectorOptions<T> {\n  /** Функция сравнения для предотвращения лишних ререндеров */\n  equals?: (a: T, b: T) => boolean\n  /** Включать ли статус загрузки в возвращаемый результат */\n  withLoading?: boolean\n}\n\n/**\n * Хук для использования селекторов в компонентах React.\n * Использует useSyncExternalStore для корректной работы в Concurrent Mode.\n * Подписывается напрямую через selector.subscribe() — без глобального реестра.\n */\nexport function useSelector<T>(selector: SelectorAPI<T>): T\nexport function useSelector<T>(selector: SelectorAPI<T>, options: UseSelectorOptions<T> & { withLoading: true }): { data: T; isLoading: boolean }\nexport function useSelector<T>(selector: SelectorAPI<T>, options: UseSelectorOptions<T> & { withLoading?: false }): T\nexport function useSelector<T>(selector: SelectorAPI<T>, options?: UseSelectorOptions<T>): { data: T; isLoading: boolean } | T {\n  const equalsRef = useRef(options?.equals)\n\n  // Кеш для мемоизации результата getSnapshot (предотвращает лишние ререндеры)\n  const cachedRef = useRef<T | undefined>(undefined)\n\n  const subscribe = useCallback(\n    (onStoreChange: VoidFunction) => {\n      return selector.subscribe({\n        notify: () => {\n          onStoreChange()\n        },\n      })\n    },\n    [selector],\n  )\n\n  const getSnapshot = useCallback((): T => {\n    const value = selector.selectSync()\n\n    // Если есть пользовательская функция сравнения — мемоизируем\n    const equals = equalsRef.current\n    if (equals && cachedRef.current !== undefined && equals(cachedRef.current, value)) {\n      return cachedRef.current\n    }\n\n    cachedRef.current = value\n    return value\n  }, [selector])\n\n  const value = useSyncExternalStore(subscribe, getSnapshot)\n\n  // Подписка на статус готовности storage (используется только при withLoading)\n  const subscribeToStatus = useCallback(\n    (onStoreChange: VoidFunction) => {\n      return selector.onSourceStatusChange(() => {\n        onStoreChange()\n      })\n    },\n    [selector],\n  )\n\n  const getStatusSnapshot = useCallback((): boolean => {\n    return !selector.isSourceReady()\n  }, [selector])\n\n  const isLoading = useSyncExternalStore(subscribeToStatus, getStatusSnapshot)\n\n  if (options?.withLoading) {\n    return { data: value, isLoading }\n  }\n\n  return value\n}\n\n/**\n * Изоляция ре-рендеров для keyed-map стора (паттерн «equals»). Подписка идёт на\n * ВЕСЬ map (`selector`), но `equals` сравнивает только срез по `key` → компонент\n * ре-рендерится лишь когда меняется его `map[key]` по ссылке. Работает, т.к.\n * иммутабельные мутации по одному ключу не трогают ссылку чужих срезов.\n * Гранулярность живёт в месте вызова, а селекторы остаются плоскими (без фабрик\n * с `Map<key, selector>`).\n *\n * `fallback` ОБЯЗАН быть стабильной ссылкой (module-level константа), иначе\n * `?? fallback` будет давать новый объект каждый тик и рвать нижестоящие `useMemo`.\n */\nexport function useKeyedSliceSelector<V>(selector: SelectorAPI<Record<string, V>>, key: string, fallback: V): V {\n  const map = useSelector(selector, {\n    equals: (a, b) => a[key] === b[key],\n  })\n  return map[key] ?? fallback\n}\n"],"names":["useCallback","useRef","useSyncExternalStore","useSelector","selector","options","equalsRef","cachedRef","undefined","subscribe","onStoreChange","getSnapshot","value","equals","subscribeToStatus","getStatusSnapshot","isLoading","useKeyedSliceSelector","key","fallback","map","a","b"],"mappings":";;;AAAiE;AAmB1D,SAASG,WAAWA,CAAIC,QAAwB,EAAEC,OAA+B;IACtF,MAAMC,YAAYL,MAAMA,CAACI,SAAS;IAElC,6EAA6E;IAC7E,MAAME,YAAYN,MAAMA,CAAgBO;IAExC,MAAMC,YAAYT,WAAWA,CAC3B,CAACU;QACC,OAAON,SAAS,SAAS,CAAC;YACxB,QAAQ;gBACNM;YACF;QACF;IACF,GACA;QAACN;KAAS;IAGZ,MAAMO,cAAcX,WAAWA,CAAC;QAC9B,MAAMY,QAAQR,SAAS,UAAU;QAEjC,6DAA6D;QAC7D,MAAMS,SAASP,UAAU,OAAO;QAChC,IAAIO,UAAUN,UAAU,OAAO,KAAKC,aAAaK,OAAON,UAAU,OAAO,EAAEK,QAAQ;YACjF,OAAOL,UAAU,OAAO;QAC1B;QAEAA,UAAU,OAAO,GAAGK;QACpB,OAAOA;IACT,GAAG;QAACR;KAAS;IAEb,MAAMQ,QAAQV,oBAAoBA,CAACO,WAAWE;IAE9C,8EAA8E;IAC9E,MAAMG,oBAAoBd,WAAWA,CACnC,CAACU;QACC,OAAON,SAAS,oBAAoB,CAAC;YACnCM;QACF;IACF,GACA;QAACN;KAAS;IAGZ,MAAMW,oBAAoBf,WAAWA,CAAC;QACpC,OAAO,CAACI,SAAS,aAAa;IAChC,GAAG;QAACA;KAAS;IAEb,MAAMY,YAAYd,oBAAoBA,CAACY,mBAAmBC;IAE1D,IAAIV,SAAS,aAAa;QACxB,OAAO;YAAE,MAAMO;YAAOI;QAAU;IAClC;IAEA,OAAOJ;AACT;AAEA;;;;;;;;;;CAUC,GACM,SAASK,qBAAqBA,CAAIb,QAAwC,EAAEc,GAAW,EAAEC,QAAW;IACzG,MAAMC,MAAMjB,WAAWA,CAACC,UAAU;QAChC,QAAQ,CAACiB,GAAGC,IAAMD,CAAC,CAACH,IAAI,KAAKI,CAAC,CAACJ,IAAI;IACrC;IACA,OAAOE,GAAG,CAACF,IAAI,IAAIC;AACrB"}
+{"version":3,"file":"react/hooks/useSelector.js","sources":["../../../src/react/hooks/useSelector.ts"],"sourcesContent":["import { useCallback, useRef, useSyncExternalStore } from 'react'\n\nimport type { SelectorAPI } from '../../core'\n\ninterface UseSelectorOptions<T> {\n  /** Функция сравнения для предотвращения лишних ререндеров */\n  equals?: (a: T, b: T) => boolean\n  /** Включать ли статус загрузки в возвращаемый результат */\n  withLoading?: boolean\n}\n\n/**\n * Хук для использования селекторов в компонентах React.\n * Использует useSyncExternalStore для корректной работы в Concurrent Mode.\n * Подписывается напрямую через selector.subscribe() — без глобального реестра.\n */\nexport function useSelector<T>(selector: SelectorAPI<T>): T\nexport function useSelector<T>(selector: SelectorAPI<T>, options: UseSelectorOptions<T> & { withLoading: true }): { data: T; isLoading: boolean }\nexport function useSelector<T>(selector: SelectorAPI<T>, options: UseSelectorOptions<T> & { withLoading?: false }): T\nexport function useSelector<T>(selector: SelectorAPI<T>, options?: UseSelectorOptions<T>): { data: T; isLoading: boolean } | T {\n  const equalsRef = useRef(options?.equals)\n\n  // Кеш для мемоизации результата getSnapshot (предотвращает лишние ререндеры)\n  const cachedRef = useRef<T | undefined>(undefined)\n\n  const subscribe = useCallback(\n    (onStoreChange: VoidFunction) => {\n      return selector.subscribe({\n        notify: () => {\n          onStoreChange()\n        },\n      })\n    },\n    [selector],\n  )\n\n  const getSnapshot = useCallback((): T => {\n    const value = selector.selectSync()\n\n    // Если есть пользовательская функция сравнения — мемоизируем\n    const equals = equalsRef.current\n    if (equals && cachedRef.current !== undefined && equals(cachedRef.current, value)) {\n      return cachedRef.current\n    }\n\n    cachedRef.current = value\n    return value\n  }, [selector])\n\n  // getServerSnapshot === getSnapshot: на сервере `selectSync()` синхронно читает\n  // засеянный (hydrate) стор. Без серверного снапшота useSyncExternalStore на сервере\n  // падает и откатывается на client-only рендер (контент не попадает в SSR-HTML).\n  const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n\n  // Подписка на статус готовности storage (используется только при withLoading)\n  const subscribeToStatus = useCallback(\n    (onStoreChange: VoidFunction) => {\n      return selector.onSourceStatusChange(() => {\n        onStoreChange()\n      })\n    },\n    [selector],\n  )\n\n  const getStatusSnapshot = useCallback((): boolean => {\n    return !selector.isSourceReady()\n  }, [selector])\n\n  const isLoading = useSyncExternalStore(subscribeToStatus, getStatusSnapshot, getStatusSnapshot)\n\n  if (options?.withLoading) {\n    return { data: value, isLoading }\n  }\n\n  return value\n}\n\n/**\n * Изоляция ре-рендеров для keyed-map стора (паттерн «equals»). Подписка идёт на\n * ВЕСЬ map (`selector`), но `equals` сравнивает только срез по `key` → компонент\n * ре-рендерится лишь когда меняется его `map[key]` по ссылке. Работает, т.к.\n * иммутабельные мутации по одному ключу не трогают ссылку чужих срезов.\n * Гранулярность живёт в месте вызова, а селекторы остаются плоскими (без фабрик\n * с `Map<key, selector>`).\n *\n * `fallback` ОБЯЗАН быть стабильной ссылкой (module-level константа), иначе\n * `?? fallback` будет давать новый объект каждый тик и рвать нижестоящие `useMemo`.\n */\nexport function useKeyedSliceSelector<V>(selector: SelectorAPI<Record<string, V>>, key: string, fallback: V): V {\n  const map = useSelector(selector, {\n    equals: (a, b) => a[key] === b[key],\n  })\n  return map[key] ?? fallback\n}\n"],"names":["useCallback","useRef","useSyncExternalStore","useSelector","selector","options","equalsRef","cachedRef","undefined","subscribe","onStoreChange","getSnapshot","value","equals","subscribeToStatus","getStatusSnapshot","isLoading","useKeyedSliceSelector","key","fallback","map","a","b"],"mappings":";;;AAAiE;AAmB1D,SAASG,WAAWA,CAAIC,QAAwB,EAAEC,OAA+B;IACtF,MAAMC,YAAYL,MAAMA,CAACI,SAAS;IAElC,6EAA6E;IAC7E,MAAME,YAAYN,MAAMA,CAAgBO;IAExC,MAAMC,YAAYT,WAAWA,CAC3B,CAACU;QACC,OAAON,SAAS,SAAS,CAAC;YACxB,QAAQ;gBACNM;YACF;QACF;IACF,GACA;QAACN;KAAS;IAGZ,MAAMO,cAAcX,WAAWA,CAAC;QAC9B,MAAMY,QAAQR,SAAS,UAAU;QAEjC,6DAA6D;QAC7D,MAAMS,SAASP,UAAU,OAAO;QAChC,IAAIO,UAAUN,UAAU,OAAO,KAAKC,aAAaK,OAAON,UAAU,OAAO,EAAEK,QAAQ;YACjF,OAAOL,UAAU,OAAO;QAC1B;QAEAA,UAAU,OAAO,GAAGK;QACpB,OAAOA;IACT,GAAG;QAACR;KAAS;IAEb,gFAAgF;IAChF,oFAAoF;IACpF,gFAAgF;IAChF,MAAMQ,QAAQV,oBAAoBA,CAACO,WAAWE,aAAaA;IAE3D,8EAA8E;IAC9E,MAAMG,oBAAoBd,WAAWA,CACnC,CAACU;QACC,OAAON,SAAS,oBAAoB,CAAC;YACnCM;QACF;IACF,GACA;QAACN;KAAS;IAGZ,MAAMW,oBAAoBf,WAAWA,CAAC;QACpC,OAAO,CAACI,SAAS,aAAa;IAChC,GAAG;QAACA;KAAS;IAEb,MAAMY,YAAYd,oBAAoBA,CAACY,mBAAmBC,mBAAmBA;IAE7E,IAAIV,SAAS,aAAa;QACxB,OAAO;YAAE,MAAMO;YAAOI;QAAU;IAClC;IAEA,OAAOJ;AACT;AAEA;;;;;;;;;;CAUC,GACM,SAASK,qBAAqBA,CAAIb,QAAwC,EAAEc,GAAW,EAAEC,QAAW;IACzG,MAAMC,MAAMjB,WAAWA,CAACC,UAAU;QAChC,QAAQ,CAACiB,GAAGC,IAAMD,CAAC,CAACH,IAAI,KAAKI,CAAC,CAACJ,IAAI;IACrC;IACA,OAAOE,GAAG,CAACF,IAAI,IAAIC;AACrB"}

package/dist/react/hooks/useStorage.d.ts

@@ -36,4 +36,3 @@ export type UseStorageReturn<S> = {
  * ```
  */
 export declare function useStorage<S extends IStorageBase<any>>(storage: S, options?: UseStorageOptions): UseStorageReturn<S>;
-//# sourceMappingURL=useStorage.d.ts.map

package/dist/react/hooks/useStorageSubscribe.d.ts

@@ -13,4 +13,3 @@ import { IStorageBase } from '../../core';
  * @returns Значение из хранилища
  */
 export declare const useStorageSubscribe: <S extends Record<string, any>, R = any>(storage: IStorageBase<S> | null, selector: (state: S) => R) => R | undefined;
-//# sourceMappingURL=useStorageSubscribe.d.ts.map

package/dist/react/hooks/useSubscription.d.ts

@@ -0,0 +1,13 @@
+import { DependencyList } from 'react';
+import { Unsubscribable } from 'rxjs';
+/**
+ * Императивная подписка-side-effect без возврата значения в рендер.
+ *
+ * `factory` создаёт подписку (`source$.subscribe(...)`) — её side-effect'ы (логирование,
+ * императивные вызовы, диспатч) живут внутри коллбэка `subscribe`. Возвращённый
+ * `Unsubscribable` снимается на unmount и при смене `deps` (перед созданием новой
+ * подписки).
+ *
+ * В отличие от `useObservable`, ничего не рендерит — только запускает и гасит подписку.
+ */
+export declare function useSubscription(factory: () => Unsubscribable, deps: DependencyList): void;

package/dist/react/hooks/useSubscription.js

@@ -0,0 +1,23 @@
+import { useEffect } from "react";
+
+
+
+/**
+ * Императивная подписка-side-effect без возврата значения в рендер.
+ *
+ * `factory` создаёт подписку (`source$.subscribe(...)`) — её side-effect'ы (логирование,
+ * императивные вызовы, диспатч) живут внутри коллбэка `subscribe`. Возвращённый
+ * `Unsubscribable` снимается на unmount и при смене `deps` (перед созданием новой
+ * подписки).
+ *
+ * В отличие от `useObservable`, ничего не рендерит — только запускает и гасит подписку.
+ */ function useSubscription(factory, deps) {
+    useEffect(()=>{
+        const subscription = factory();
+        return ()=>subscription.unsubscribe();
+    }, deps);
+}
+
+export { useSubscription };
+
+//# sourceMappingURL=useSubscription.js.map

package/dist/react/hooks/useSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react/hooks/useSubscription.js","sources":["../../../src/react/hooks/useSubscription.ts"],"sourcesContent":["import { DependencyList, useEffect } from 'react'\nimport { Unsubscribable } from 'rxjs'\n\n/**\n * Императивная подписка-side-effect без возврата значения в рендер.\n *\n * `factory` создаёт подписку (`source$.subscribe(...)`) — её side-effect'ы (логирование,\n * императивные вызовы, диспатч) живут внутри коллбэка `subscribe`. Возвращённый\n * `Unsubscribable` снимается на unmount и при смене `deps` (перед созданием новой\n * подписки).\n *\n * В отличие от `useObservable`, ничего не рендерит — только запускает и гасит подписку.\n */\nexport function useSubscription(factory: () => Unsubscribable, deps: DependencyList): void {\n  useEffect(() => {\n    const subscription = factory()\n    return () => subscription.unsubscribe()\n  }, deps)\n}\n"],"names":["useEffect","useSubscription","factory","deps","subscription"],"mappings":";;;AAAiD;AAGjD;;;;;;;;;CASC,GACM,SAASC,eAAeA,CAACC,OAA6B,EAAEC,IAAoB;IACjFH,SAASA,CAAC;QACR,MAAMI,eAAeF;QACrB,OAAO,IAAME,aAAa,WAAW;IACvC,GAAGD;AACL"}

package/dist/react/index.d.ts

@@ -1,3 +1,2 @@
 export * from './hooks';
 export * from './utils';
-//# sourceMappingURL=index.d.ts.map

package/dist/react/utils/awaitSynapse.d.ts

@@ -1,15 +1,15 @@
 import { ComponentType, ReactNode } from 'react';
-import { IStorage } from '../../core';
-import { AnySynapseStore } from '../../utils';
+import { type AwaitableSynapse } from '../../utils';
 interface ReactAwaitSynapseOptions {
     loadingComponent?: ReactNode;
     errorComponent?: (error: Error) => ReactNode;
 }
 /**
- * React-обертка для фреймворк-независимой утилиты ожидания Synapse
- * Добавляет React-специфичные методы поверх createSynapseAwaiter
+ * React-обертка для фреймворк-независимой утилиты ожидания Synapse.
+ * Добавляет React-специфичные методы поверх createSynapseAwaiter. Принимает
+ * `SynapseModule`-handle (PromiseLike), Promise готового synapse или сам synapse.
  */
-export declare function awaitSynapse<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors = any, TActions = any>(synapseStorePromise: Promise<AnySynapseStore<TStore, TStorage, TSelectors, TActions>> | AnySynapseStore<TStore, TStorage, TSelectors, TActions>, options?: ReactAwaitSynapseOptions): {
+export declare function awaitSynapse<TStore extends AwaitableSynapse>(synapseStorePromise: PromiseLike<TStore> | TStore, options?: ReactAwaitSynapseOptions): {
     withSynapseReady: <ComponentProps>(Component: ComponentType<ComponentProps>) => {
         (props: ComponentProps): import("react/jsx-runtime").JSX.Element;
         displayName: string;
@@ -18,17 +18,16 @@ export declare function awaitSynapse<TStore extends Record<string, any>, TStorag
         isReady: boolean;
         isError: boolean;
         isPending: boolean;
-        store: AnySynapseStore<TStore, TStorage, TSelectors, TActions> | undefined;
+        store: TStore | undefined;
         error: Error | null;
     };
-    waitForReady: () => Promise<AnySynapseStore<TStore, TStorage, TSelectors, TActions>>;
+    waitForReady: () => Promise<TStore>;
     isReady: () => boolean;
-    getStoreIfReady: () => AnySynapseStore<TStore, TStorage, TSelectors, TActions> | undefined;
-    onReady: (cb: Parameters<(callback: (store: AnySynapseStore<TStore, TStorage, TSelectors, TActions>) => void) => VoidFunction>[0]) => VoidFunction;
+    getStoreIfReady: () => TStore | undefined;
+    onReady: (cb: Parameters<(callback: (store: TStore) => void) => VoidFunction>[0]) => VoidFunction;
     onError: (cb: Parameters<(callback: (error: Error) => void) => VoidFunction>[0]) => VoidFunction;
     getStatus: () => "error" | "ready" | "pending";
     getError: () => Error | null;
     destroy: () => void;
 };
 export {};
-//# sourceMappingURL=awaitSynapse.d.ts.map

package/dist/react/utils/awaitSynapse.js

@@ -9,8 +9,9 @@ import { createSynapseAwaiter } from "../../utils/index.js";
 
 
 /**
- * React-обертка для фреймворк-независимой утилиты ожидания Synapse
- * Добавляет React-специфичные методы поверх createSynapseAwaiter
+ * React-обертка для фреймворк-независимой утилиты ожидания Synapse.
+ * Добавляет React-специфичные методы поверх createSynapseAwaiter. Принимает
+ * `SynapseModule`-handle (PromiseLike), Promise готового synapse или сам synapse.
  */ function awaitSynapse(synapseStorePromise, options) {
     const { loadingComponent = /*#__PURE__*/ jsx("div", {
         children: "Инициализация..."

package/dist/react/utils/awaitSynapse.js.map

@@ -1 +1 @@
-{"version":3,"file":"react/utils/awaitSynapse.js","sources":["../../../src/react/utils/awaitSynapse.tsx"],"sourcesContent":["import { ComponentType, PropsWithChildren, ReactNode, useEffect, useState } from 'react'\n\nimport { IStorage } from '../../core'\nimport { AnySynapseStore, createSynapseAwaiter } from '../../utils'\n\ninterface ReactAwaitSynapseOptions {\n  loadingComponent?: ReactNode\n  errorComponent?: (error: Error) => ReactNode\n}\n\n/**\n * React-обертка для фреймворк-независимой утилиты ожидания Synapse\n * Добавляет React-специфичные методы поверх createSynapseAwaiter\n */\nexport function awaitSynapse<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors = any, TActions = any>(\n  synapseStorePromise: Promise<AnySynapseStore<TStore, TStorage, TSelectors, TActions>> | AnySynapseStore<TStore, TStorage, TSelectors, TActions>,\n  options?: ReactAwaitSynapseOptions,\n) {\n  const { loadingComponent = <div>Инициализация...</div>, errorComponent = (error: Error) => <div>Ошибка инициализации: {error.message}</div> } = options || {}\n\n  const awaiter = createSynapseAwaiter(synapseStorePromise)\n\n  /**\n   * Хук для получения текущего состояния готовности\n   */\n  function useSynapseReady() {\n    const [status, setStatus] = useState<'pending' | 'ready' | 'error'>(() => awaiter.getStatus())\n    const [store, setStore] = useState<AnySynapseStore<TStore, TStorage, TSelectors, TActions> | undefined>(() => awaiter.getStoreIfReady())\n    const [error, setError] = useState<Error | null>(() => awaiter.getError())\n\n    useEffect(() => {\n      // Проверяем текущее состояние при монтировании\n      const currentStatus = awaiter.getStatus()\n      const currentStore = awaiter.getStoreIfReady()\n      const currentError = awaiter.getError()\n\n      setStatus(currentStatus)\n      setStore(currentStore)\n      setError(currentError)\n\n      // Подписываемся на изменения\n      const unsubscribeReady = awaiter.onReady((readyStore) => {\n        setStatus('ready')\n        setStore(readyStore)\n        setError(null)\n      })\n\n      const unsubscribeError = awaiter.onError((err) => {\n        setStatus('error')\n        setStore(undefined)\n        setError(err)\n      })\n\n      return () => {\n        unsubscribeReady()\n        unsubscribeError()\n      }\n    }, [])\n\n    return {\n      isReady: status === 'ready',\n      isError: status === 'error',\n      isPending: status === 'pending',\n      store,\n      error,\n    }\n  }\n\n  /**\n   * Обертка, которая ждет готовности Synapse\n   */\n  function withSynapseReady<ComponentProps>(Component: ComponentType<ComponentProps>) {\n    function WrappedComponent(props: ComponentProps) {\n      const { isReady, isError, error } = useSynapseReady()\n\n      // Показываем ошибку\n      if (isError && error) return <>{errorComponent(error)}</>\n\n      // Показываем загрузку\n      if (!isReady) return <>{loadingComponent}</>\n\n      // Рендерим компонент когда все готово\n      return <Component {...(props as PropsWithChildren<ComponentProps>)} />\n    }\n\n    // Устанавливаем отображаемое имя для отладки\n    const componentName = Component.displayName || Component.name || 'Component'\n    WrappedComponent.displayName = `AwaitSynapse(${componentName})`\n\n    return WrappedComponent\n  }\n\n  return {\n    // React методы\n    withSynapseReady,\n    useSynapseReady,\n\n    // Проксируем все методы из awaiter (обёртки сохраняют контекст при деструктуризации)\n    waitForReady: () => awaiter.waitForReady(),\n    isReady: () => awaiter.isReady(),\n    getStoreIfReady: () => awaiter.getStoreIfReady(),\n    onReady: (cb: Parameters<typeof awaiter.onReady>[0]) => awaiter.onReady(cb),\n    onError: (cb: Parameters<typeof awaiter.onError>[0]) => awaiter.onError(cb),\n    getStatus: () => awaiter.getStatus(),\n    getError: () => awaiter.getError(),\n    destroy: () => awaiter.destroy(),\n  }\n}\n"],"names":["useEffect","useState","createSynapseAwaiter","awaitSynapse","synapseStorePromise","options","loadingComponent","errorComponent","error","awaiter","useSynapseReady","status","setStatus","store","setStore","setError","currentStatus","currentStore","currentError","unsubscribeReady","readyStore","unsubscribeError","err","undefined","withSynapseReady","Component","WrappedComponent","props","isReady","isError","componentName","cb"],"mappings":";;;;;;;;AAAwF;AAGrB;AAOnE;;;CAGC,GACM,SAASG,YAAYA,CAC1BC,mBAA+I,EAC/IC,OAAkC;IAElC,MAAM,EAAEC,iCAAmB,IAAC;kBAAI;MAAsB,EAAEC,iBAAiB,CAACC,sBAAiB,KAAC;;gBAAI;gBAAuBA,MAAM,OAAO;;UAAO,EAAE,GAAGH,WAAW,CAAC;IAE5J,MAAMI,UAAUP,oBAAoBA,CAACE;IAErC;;GAEC,GACD,SAASM;QACP,MAAM,CAACC,QAAQC,UAAU,GAAGX,QAAQA,CAAgC,IAAMQ,QAAQ,SAAS;QAC3F,MAAM,CAACI,OAAOC,SAAS,GAAGb,QAAQA,CAAsE,IAAMQ,QAAQ,eAAe;QACrI,MAAM,CAACD,OAAOO,SAAS,GAAGd,QAAQA,CAAe,IAAMQ,QAAQ,QAAQ;QAEvET,SAASA,CAAC;YACR,+CAA+C;YAC/C,MAAMgB,gBAAgBP,QAAQ,SAAS;YACvC,MAAMQ,eAAeR,QAAQ,eAAe;YAC5C,MAAMS,eAAeT,QAAQ,QAAQ;YAErCG,UAAUI;YACVF,SAASG;YACTF,SAASG;YAET,6BAA6B;YAC7B,MAAMC,mBAAmBV,QAAQ,OAAO,CAAC,CAACW;gBACxCR,UAAU;gBACVE,SAASM;gBACTL,SAAS;YACX;YAEA,MAAMM,mBAAmBZ,QAAQ,OAAO,CAAC,CAACa;gBACxCV,UAAU;gBACVE,SAASS;gBACTR,SAASO;YACX;YAEA,OAAO;gBACLH;gBACAE;YACF;QACF,GAAG,EAAE;QAEL,OAAO;YACL,SAASV,WAAW;YACpB,SAASA,WAAW;YACpB,WAAWA,WAAW;YACtBE;YACAL;QACF;IACF;IAEA;;GAEC,GACD,SAASgB,iBAAiCC,SAAwC;QAChF,SAASC,iBAAiBC,KAAqB;YAC7C,MAAM,EAAEC,OAAO,EAAEC,OAAO,EAAErB,KAAK,EAAE,GAAGE;YAEpC,oBAAoB;YACpB,IAAImB,WAAWrB,OAAO,qBAAO;0BAAGD,eAAeC;;YAE/C,sBAAsB;YACtB,IAAI,CAACoB,SAAS,qBAAO;0BAAGtB;;YAExB,sCAAsC;YACtC,qBAAO,IAACmB;gBAAW,GAAIE,KAAK;;QAC9B;QAEA,6CAA6C;QAC7C,MAAMG,gBAAgBL,UAAU,WAAW,IAAIA,UAAU,IAAI,IAAI;QACjEC,iBAAiB,WAAW,GAAG,CAAC,aAAa,EAAEI,cAAc,CAAC,CAAC;QAE/D,OAAOJ;IACT;IAEA,OAAO;QACL,eAAe;QACfF;QACAd;QAEA,qFAAqF;QACrF,cAAc,IAAMD,QAAQ,YAAY;QACxC,SAAS,IAAMA,QAAQ,OAAO;QAC9B,iBAAiB,IAAMA,QAAQ,eAAe;QAC9C,SAAS,CAACsB,KAA8CtB,QAAQ,OAAO,CAACsB;QACxE,SAAS,CAACA,KAA8CtB,QAAQ,OAAO,CAACsB;QACxE,WAAW,IAAMtB,QAAQ,SAAS;QAClC,UAAU,IAAMA,QAAQ,QAAQ;QAChC,SAAS,IAAMA,QAAQ,OAAO;IAChC;AACF"}
+{"version":3,"file":"react/utils/awaitSynapse.js","sources":["../../../src/react/utils/awaitSynapse.tsx"],"sourcesContent":["import { ComponentType, PropsWithChildren, ReactNode, useEffect, useState } from 'react'\n\nimport { type AwaitableSynapse, createSynapseAwaiter } from '../../utils'\n\ninterface ReactAwaitSynapseOptions {\n  loadingComponent?: ReactNode\n  errorComponent?: (error: Error) => ReactNode\n}\n\n/**\n * React-обертка для фреймворк-независимой утилиты ожидания Synapse.\n * Добавляет React-специфичные методы поверх createSynapseAwaiter. Принимает\n * `SynapseModule`-handle (PromiseLike), Promise готового synapse или сам synapse.\n */\nexport function awaitSynapse<TStore extends AwaitableSynapse>(synapseStorePromise: PromiseLike<TStore> | TStore, options?: ReactAwaitSynapseOptions) {\n  const { loadingComponent = <div>Инициализация...</div>, errorComponent = (error: Error) => <div>Ошибка инициализации: {error.message}</div> } = options || {}\n\n  const awaiter = createSynapseAwaiter<TStore>(synapseStorePromise)\n\n  /**\n   * Хук для получения текущего состояния готовности\n   */\n  function useSynapseReady() {\n    const [status, setStatus] = useState<'pending' | 'ready' | 'error'>(() => awaiter.getStatus())\n    const [store, setStore] = useState<TStore | undefined>(() => awaiter.getStoreIfReady())\n    const [error, setError] = useState<Error | null>(() => awaiter.getError())\n\n    useEffect(() => {\n      // Проверяем текущее состояние при монтировании\n      const currentStatus = awaiter.getStatus()\n      const currentStore = awaiter.getStoreIfReady()\n      const currentError = awaiter.getError()\n\n      setStatus(currentStatus)\n      setStore(currentStore)\n      setError(currentError)\n\n      // Подписываемся на изменения\n      const unsubscribeReady = awaiter.onReady((readyStore) => {\n        setStatus('ready')\n        setStore(readyStore)\n        setError(null)\n      })\n\n      const unsubscribeError = awaiter.onError((err) => {\n        setStatus('error')\n        setStore(undefined)\n        setError(err)\n      })\n\n      return () => {\n        unsubscribeReady()\n        unsubscribeError()\n      }\n    }, [])\n\n    return {\n      isReady: status === 'ready',\n      isError: status === 'error',\n      isPending: status === 'pending',\n      store,\n      error,\n    }\n  }\n\n  /**\n   * Обертка, которая ждет готовности Synapse\n   */\n  function withSynapseReady<ComponentProps>(Component: ComponentType<ComponentProps>) {\n    function WrappedComponent(props: ComponentProps) {\n      const { isReady, isError, error } = useSynapseReady()\n\n      // Показываем ошибку\n      if (isError && error) return <>{errorComponent(error)}</>\n\n      // Показываем загрузку\n      if (!isReady) return <>{loadingComponent}</>\n\n      // Рендерим компонент когда все готово\n      return <Component {...(props as PropsWithChildren<ComponentProps>)} />\n    }\n\n    // Устанавливаем отображаемое имя для отладки\n    const componentName = Component.displayName || Component.name || 'Component'\n    WrappedComponent.displayName = `AwaitSynapse(${componentName})`\n\n    return WrappedComponent\n  }\n\n  return {\n    // React методы\n    withSynapseReady,\n    useSynapseReady,\n\n    // Проксируем все методы из awaiter (обёртки сохраняют контекст при деструктуризации)\n    waitForReady: () => awaiter.waitForReady(),\n    isReady: () => awaiter.isReady(),\n    getStoreIfReady: () => awaiter.getStoreIfReady(),\n    onReady: (cb: Parameters<typeof awaiter.onReady>[0]) => awaiter.onReady(cb),\n    onError: (cb: Parameters<typeof awaiter.onError>[0]) => awaiter.onError(cb),\n    getStatus: () => awaiter.getStatus(),\n    getError: () => awaiter.getError(),\n    destroy: () => awaiter.destroy(),\n  }\n}\n"],"names":["useEffect","useState","createSynapseAwaiter","awaitSynapse","synapseStorePromise","options","loadingComponent","errorComponent","error","awaiter","useSynapseReady","status","setStatus","store","setStore","setError","currentStatus","currentStore","currentError","unsubscribeReady","readyStore","unsubscribeError","err","undefined","withSynapseReady","Component","WrappedComponent","props","isReady","isError","componentName","cb"],"mappings":";;;;;;;;AAAwF;AAEf;AAOzE;;;;CAIC,GACM,SAASG,YAAYA,CAAkCC,mBAAiD,EAAEC,OAAkC;IACjJ,MAAM,EAAEC,iCAAmB,IAAC;kBAAI;MAAsB,EAAEC,iBAAiB,CAACC,sBAAiB,KAAC;;gBAAI;gBAAuBA,MAAM,OAAO;;UAAO,EAAE,GAAGH,WAAW,CAAC;IAE5J,MAAMI,UAAUP,oBAAoBA,CAASE;IAE7C;;GAEC,GACD,SAASM;QACP,MAAM,CAACC,QAAQC,UAAU,GAAGX,QAAQA,CAAgC,IAAMQ,QAAQ,SAAS;QAC3F,MAAM,CAACI,OAAOC,SAAS,GAAGb,QAAQA,CAAqB,IAAMQ,QAAQ,eAAe;QACpF,MAAM,CAACD,OAAOO,SAAS,GAAGd,QAAQA,CAAe,IAAMQ,QAAQ,QAAQ;QAEvET,SAASA,CAAC;YACR,+CAA+C;YAC/C,MAAMgB,gBAAgBP,QAAQ,SAAS;YACvC,MAAMQ,eAAeR,QAAQ,eAAe;YAC5C,MAAMS,eAAeT,QAAQ,QAAQ;YAErCG,UAAUI;YACVF,SAASG;YACTF,SAASG;YAET,6BAA6B;YAC7B,MAAMC,mBAAmBV,QAAQ,OAAO,CAAC,CAACW;gBACxCR,UAAU;gBACVE,SAASM;gBACTL,SAAS;YACX;YAEA,MAAMM,mBAAmBZ,QAAQ,OAAO,CAAC,CAACa;gBACxCV,UAAU;gBACVE,SAASS;gBACTR,SAASO;YACX;YAEA,OAAO;gBACLH;gBACAE;YACF;QACF,GAAG,EAAE;QAEL,OAAO;YACL,SAASV,WAAW;YACpB,SAASA,WAAW;YACpB,WAAWA,WAAW;YACtBE;YACAL;QACF;IACF;IAEA;;GAEC,GACD,SAASgB,iBAAiCC,SAAwC;QAChF,SAASC,iBAAiBC,KAAqB;YAC7C,MAAM,EAAEC,OAAO,EAAEC,OAAO,EAAErB,KAAK,EAAE,GAAGE;YAEpC,oBAAoB;YACpB,IAAImB,WAAWrB,OAAO,qBAAO;0BAAGD,eAAeC;;YAE/C,sBAAsB;YACtB,IAAI,CAACoB,SAAS,qBAAO;0BAAGtB;;YAExB,sCAAsC;YACtC,qBAAO,IAACmB;gBAAW,GAAIE,KAAK;;QAC9B;QAEA,6CAA6C;QAC7C,MAAMG,gBAAgBL,UAAU,WAAW,IAAIA,UAAU,IAAI,IAAI;QACjEC,iBAAiB,WAAW,GAAG,CAAC,aAAa,EAAEI,cAAc,CAAC,CAAC;QAE/D,OAAOJ;IACT;IAEA,OAAO;QACL,eAAe;QACfF;QACAd;QAEA,qFAAqF;QACrF,cAAc,IAAMD,QAAQ,YAAY;QACxC,SAAS,IAAMA,QAAQ,OAAO;QAC9B,iBAAiB,IAAMA,QAAQ,eAAe;QAC9C,SAAS,CAACsB,KAA8CtB,QAAQ,OAAO,CAACsB;QACxE,SAAS,CAACA,KAA8CtB,QAAQ,OAAO,CAACsB;QACxE,WAAW,IAAMtB,QAAQ,SAAS;QAClC,UAAU,IAAMA,QAAQ,QAAQ;QAChC,SAAS,IAAMA,QAAQ,OAAO;IAChC;AACF"}

package/dist/react/utils/createSynapseCtx.d.ts

@@ -1,33 +1,28 @@
 import { ComponentType } from 'react';
 import { Observable } from 'rxjs';
 import { IStorage } from '../../core';
-import { SynapseStoreBasic, SynapseStoreWithDispatcher, SynapseStoreWithEffects } from '../../utils';
+import { type SynapseModule } from '../../utils';
 interface SimplifiedOptions {
     loadingComponent?: React.ReactNode;
+    /**
+     * Включает серверный рендер засеянных sync-сторов (Memory/LocalStorage). При `ssr: true`
+     * и синхронно-готовом сторе Provider рендерит children сразу (без `loadingComponent`),
+     * что даёт контент в серверном HTML и совпадающий первый кадр при гидрации.
+     * Для async-сторов (IndexedDB) поведение прежнее — гейт `loadingComponent`.
+     */
+    ssr?: boolean;
 }
-/**
- * Перегрузки для createSynapseCtx в зависимости от типа хранилища
- */
-export declare function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(synapseStorePromise: Promise<SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>, options?: SimplifiedOptions): {
-    contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>;
-    useSynapseStorage: () => TStorage;
-    useSynapseSelectors: () => TSelectors;
-    useSynapseActions: () => TActions;
-    useSynapseState$: () => Observable<TStore>;
-    cleanupSynapse: () => Promise<void>;
-};
-export declare function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(synapseStorePromise: Promise<SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>, options?: SimplifiedOptions): {
-    contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>;
-    useSynapseStorage: () => TStorage;
-    useSynapseSelectors: () => TSelectors;
-    useSynapseActions: () => TActions;
-    cleanupSynapse: () => Promise<void>;
-};
-export declare function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors>(synapseStorePromise: Promise<SynapseStoreBasic<TStore, TStorage, TSelectors>> | SynapseStoreBasic<TStore, TStorage, TSelectors>, options?: SimplifiedOptions): {
-    contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>;
-    useSynapseStorage: () => TStorage;
+export declare function createSynapseCtx<TState extends Record<string, any>, TDispatcher, TSelectors>(synapseModule: SynapseModule<TState, TDispatcher, TSelectors>, options?: SimplifiedOptions): {
+    contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps & {
+        dehydratedState?: TState;
+    }>;
+    dehydrate: (opts?: {
+        initialState?: Partial<TState>;
+    }) => Promise<TState>;
+    useSynapseStorage: () => IStorage<TState>;
     useSynapseSelectors: () => TSelectors;
+    useSynapseActions: () => TDispatcher;
+    useSynapseState$: () => Observable<TState>;
     cleanupSynapse: () => Promise<void>;
 };
 export {};
-//# sourceMappingURL=createSynapseCtx.d.ts.map

package/dist/react/utils/createSynapseCtx.js

@@ -1,7 +1,10 @@
 import { Fragment, jsx } from "react/jsx-runtime";
-import { createContext, forwardRef, useContext, useEffect, useState } from "react";
+import { createContext, forwardRef, useContext, useEffect, useRef, useState } from "react";
 import { handleCleanupError } from "../../_utils/error-handling.util.js";
-import { createSynapseAwaiter } from "../../utils/index.js";
+import { StorageStatus } from "../../core/index.js";
+import { createSynapseAwaiter, dehydrateModule } from "../../utils/index.js";
+
+
 
 
 
@@ -13,19 +16,20 @@ import { createSynapseAwaiter } from "../../utils/index.js";
 
 const ERROR_HOOK_MESSAGE = 'Хук необходимо использовать внутри компонента contextSynapse';
 const ERROR_CONTEXT_INIT = 'Ошибка при инициализации контекста:';
-// Основная реализация
-function createSynapseCtx(synapseStorePromise, options) {
+function createSynapseCtx(synapseModule, options) {
     const { loadingComponent = /*#__PURE__*/ jsx("div", {
         children: "Инициализация контекста..."
-    }) } = options || {};
-    // Lazy-инициализация: awaiter создаётся при первом обращении и сбрасывается при cleanup.
-    // Сам awaiter (createSynapseAwaiter) инкапсулирует ожидание готовности, статус и подписки.
-    let awaiter = null;
-    const getAwaiter = ()=>{
-        if (!awaiter) awaiter = createSynapseAwaiter(synapseStorePromise);
-        return awaiter;
-    };
+    }), ssr = false } = options || {};
     const SynapseContext = /*#__PURE__*/ createContext(null);
+    // ── Awaiter ───────────────────────────────────────────────────────────────
+    // Клиент сохраняет прежнюю синглтон-семантику: один awaiter на handle (общий стор,
+    // фабрика стартует один раз при первом mount). На сервере синглтон уровня модуля
+    // запрещён (request bleed), поэтому там awaiter живёт per-render-tree и не шарится.
+    let clientAwaiter = null;
+    const getClientAwaiter = ()=>{
+        if (!clientAwaiter) clientAwaiter = createSynapseAwaiter(synapseModule);
+        return clientAwaiter;
+    };
     const useSynapseStorage = ()=>{
         const context = useContext(SynapseContext);
         if (!context) throw new Error(`useSynapseStorage: ${ERROR_HOOK_MESSAGE}`);
@@ -36,36 +40,59 @@ function createSynapseCtx(synapseStorePromise, options) {
         if (!context) throw new Error(`useSynapseSelectors: ${ERROR_HOOK_MESSAGE}`);
         return context.selectors;
     };
-    // Условный хук для actions (только если есть dispatcher)
     const useSynapseActions = ()=>{
         const context = useContext(SynapseContext);
         if (!context) throw new Error(`useSynapseActions: ${ERROR_HOOK_MESSAGE}`);
-        if ('actions' in context) {
-            return context.actions;
-        }
-        throw new Error('useSynapseActions: actions недоступны для этого типа хранилища. Убедитесь, что передана функция createDispatcherFn при создании хранилища.');
+        return context.actions;
     };
-    // Условный хук для state$ (только если есть effects)
     const useSynapseState$ = ()=>{
         const context = useContext(SynapseContext);
         if (!context) throw new Error(`useSynapseState$: ${ERROR_HOOK_MESSAGE}`);
-        if ('state$' in context) {
-            return context.state$;
-        }
-        throw new Error('useSynapseState$: state$ недоступен для этого типа хранилища. Убедитесь, что переданы функции createDispatcherFn и createEffectConfig при создании хранилища.');
+        return context.state$;
     };
+    // Серверный помощник: тонкая обёртка над server-safe dehydrateModule (вся логика там).
+    // initialState — серверные данные под запрос, не статический initialState модуля; ssr — из
+    // опций контекста.
+    const dehydrate = (opts)=>dehydrateModule(synapseModule, {
+            state: opts?.initialState,
+            ssr
+        });
     /**
-   * Декоратор для обертывания компонентов в контекст Synapse
+   * Декоратор для обёртки компонентов в контекст Synapse.
    */ function contextSynapse(Component) {
         const WrappedComponent = /*#__PURE__*/ forwardRef(function WrappedComponent(props, ref) {
-            const [synapseStore, setSynapseStore] = useState(()=>getAwaiter().getStoreIfReady());
-            const [error, setError] = useState(()=>getAwaiter().getError());
+            const { dehydratedState, ...restProps } = props;
+            // Per-tree awaiter при наличии dehydratedState (изоляция server-рендера); иначе —
+            // общий клиентский awaiter (обратная совместимость).
+            const treeAwaiterRef = useRef(null);
+            const resolveAwaiter = ()=>{
+                if (dehydratedState !== undefined) {
+                    if (!treeAwaiterRef.current) treeAwaiterRef.current = createSynapseAwaiter(synapseModule);
+                    return treeAwaiterRef.current;
+                }
+                return getClientAwaiter();
+            };
+            // Синхронный засев снапшота ДО первого рендера: одинаковый HTML на сервере и клиенте.
+            const seedHydration = (store)=>{
+                if (store && dehydratedState !== undefined && store.storage.initStatus.status === StorageStatus.READY) {
+                    store.storage.hydrate(dehydratedState);
+                }
+            };
+            const [synapseStore, setSynapseStore] = useState(()=>{
+                const store = resolveAwaiter().getStoreIfReady();
+                seedHydration(store);
+                return store;
+            });
+            const [error, setError] = useState(()=>resolveAwaiter().getError());
             useEffect(()=>{
-                // awaiter мог поменять состояние между рендером и эффектом — синхронизируемся
-                const instance = getAwaiter();
-                setSynapseStore(instance.getStoreIfReady());
+                // На сервере эффект не исполняется — подписки/догрузка стартуют только на клиенте.
+                const instance = resolveAwaiter();
+                const current = instance.getStoreIfReady();
+                seedHydration(current);
+                setSynapseStore(current);
                 setError(instance.getError());
                 const unsubscribeReady = instance.onReady((store)=>{
+                    seedHydration(store);
                     setSynapseStore(store);
                     setError(null);
                 });
@@ -78,23 +105,23 @@ function createSynapseCtx(synapseStorePromise, options) {
                     unsubscribeError();
                 };
             }, []);
-            // Показываем ошибку если что-то пошло не так
             if (error) return /*#__PURE__*/ jsx("div", {
                 children: `${ERROR_CONTEXT_INIT} ${error.message}`
             });
-            // Показываем загрузку пока store не готов
+            // SSR-гейт: при ssr и синхронно-готовом сторе (сервер после dehydrate / клиентская
+            // гидрация) synapseStore уже есть → рендерим children. Иначе — прежний гейт загрузки
+            // (async-сторы и обычный клиентский старт).
             if (!synapseStore) return /*#__PURE__*/ jsx(Fragment, {
                 children: loadingComponent
             });
             return /*#__PURE__*/ jsx(SynapseContext.Provider, {
                 value: synapseStore,
                 children: /*#__PURE__*/ jsx(Component, {
-                    ...props,
+                    ...restProps,
                     ref: ref
                 })
             });
         });
-        // Устанавливаем отображаемое имя для отладки
         const componentName = Component.displayName || Component.name || 'Component';
         WrappedComponent.displayName = `SynapseContext(${componentName})`;
         // Копируем статические свойства оригинального компонента
@@ -114,20 +141,18 @@ function createSynapseCtx(synapseStorePromise, options) {
         return WrappedComponent;
     }
     const cleanupSynapse = async ()=>{
-        if (!awaiter) return;
-        const instance = awaiter;
-        awaiter = null; // сбрасываем сразу, чтобы следующий маунт создал новый awaiter
+        const instance = clientAwaiter;
+        clientAwaiter = null;
         try {
-            const store = instance.getStoreIfReady() ?? await instance.waitForReady();
-            instance.destroy();
-            await store?.destroy();
+            instance?.destroy();
+            await synapseModule.destroy();
         } catch (error) {
-            instance.destroy();
             handleCleanupError('createSynapseCtx: error during Synapse cleanup', error);
         }
     };
     return {
         contextSynapse,
+        dehydrate,
         useSynapseStorage,
         useSynapseSelectors,
         useSynapseActions,

package/dist/react/utils/createSynapseCtx.js.map

@@ -1 +1 @@
-{"version":3,"file":"react/utils/createSynapseCtx.js","sources":["../../../src/react/utils/createSynapseCtx.tsx"],"sourcesContent":["import { ComponentType, createContext, forwardRef, PropsWithChildren, useContext, useEffect, useState } from 'react'\nimport { Observable } from 'rxjs'\n\nimport { handleCleanupError } from '../../_utils/error-handling.util'\nimport { IStorage } from '../../core'\nimport { AnySynapseStore, createSynapseAwaiter, SynapseStoreBasic, SynapseStoreWithDispatcher, SynapseStoreWithEffects } from '../../utils'\n\nconst ERROR_HOOK_MESSAGE = 'Хук необходимо использовать внутри компонента contextSynapse'\nconst ERROR_CONTEXT_INIT = 'Ошибка при инициализации контекста:'\n\ninterface SimplifiedOptions {\n  loadingComponent?: React.ReactNode\n}\n\n/**\n * Перегрузки для createSynapseCtx в зависимости от типа хранилища\n */\n\n// Для хранилища с effects\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(\n  synapseStorePromise: Promise<SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  useSynapseActions: () => TActions\n  useSynapseState$: () => Observable<TStore>\n  cleanupSynapse: () => Promise<void>\n}\n\n// Для хранилища с dispatcher (без effects)\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(\n  synapseStorePromise: Promise<SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  useSynapseActions: () => TActions\n  cleanupSynapse: () => Promise<void>\n}\n\n// Для базового хранилища\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors>(\n  synapseStorePromise: Promise<SynapseStoreBasic<TStore, TStorage, TSelectors>> | SynapseStoreBasic<TStore, TStorage, TSelectors>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  cleanupSynapse: () => Promise<void>\n}\n\n// Основная реализация\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors = any, TActions = any>(\n  synapseStorePromise: Promise<AnySynapseStore<TStore, TStorage, TSelectors, TActions>> | AnySynapseStore<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n) {\n  const { loadingComponent = <div>Инициализация контекста...</div> } = options || {}\n\n  // Lazy-инициализация: awaiter создаётся при первом обращении и сбрасывается при cleanup.\n  // Сам awaiter (createSynapseAwaiter) инкапсулирует ожидание готовности, статус и подписки.\n  let awaiter: ReturnType<typeof createSynapseAwaiter<TStore, TStorage, TSelectors, TActions>> | null = null\n\n  const getAwaiter = () => {\n    if (!awaiter) awaiter = createSynapseAwaiter(synapseStorePromise)\n    return awaiter\n  }\n\n  const SynapseContext = createContext<AnySynapseStore<TStore, TStorage, TSelectors, TActions> | null>(null)\n\n  const useSynapseStorage = (): TStorage => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseStorage: ${ERROR_HOOK_MESSAGE}`)\n    return context.storage\n  }\n\n  const useSynapseSelectors = (): TSelectors => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseSelectors: ${ERROR_HOOK_MESSAGE}`)\n    return context.selectors\n  }\n\n  // Условный хук для actions (только если есть dispatcher)\n  const useSynapseActions = (): TActions => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseActions: ${ERROR_HOOK_MESSAGE}`)\n\n    if ('actions' in context) {\n      return (context as SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions> | SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>).actions\n    }\n\n    throw new Error('useSynapseActions: actions недоступны для этого типа хранилища. Убедитесь, что передана функция createDispatcherFn при создании хранилища.')\n  }\n\n  // Условный хук для state$ (только если есть effects)\n  const useSynapseState$ = (): Observable<TStore> => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseState$: ${ERROR_HOOK_MESSAGE}`)\n\n    if ('state$' in context) {\n      return (context as SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>).state$\n    }\n\n    throw new Error('useSynapseState$: state$ недоступен для этого типа хранилища. Убедитесь, что переданы функции createDispatcherFn и createEffectConfig при создании хранилища.')\n  }\n\n  /**\n   * Декоратор для обертывания компонентов в контекст Synapse\n   */\n  function contextSynapse<SelfComponentProps>(Component: ComponentType<SelfComponentProps>) {\n    const WrappedComponent = forwardRef<unknown, SelfComponentProps>(function WrappedComponent(props, ref) {\n      const [synapseStore, setSynapseStore] = useState<AnySynapseStore<TStore, TStorage, TSelectors, TActions> | undefined>(() => getAwaiter().getStoreIfReady())\n      const [error, setError] = useState<Error | null>(() => getAwaiter().getError())\n\n      useEffect(() => {\n        // awaiter мог поменять состояние между рендером и эффектом — синхронизируемся\n        const instance = getAwaiter()\n        setSynapseStore(instance.getStoreIfReady())\n        setError(instance.getError())\n\n        const unsubscribeReady = instance.onReady((store) => {\n          setSynapseStore(store)\n          setError(null)\n        })\n        const unsubscribeError = instance.onError((err) => {\n          setSynapseStore(undefined)\n          setError(err)\n        })\n\n        return () => {\n          unsubscribeReady()\n          unsubscribeError()\n        }\n      }, [])\n\n      // Показываем ошибку если что-то пошло не так\n      if (error) return <div>{`${ERROR_CONTEXT_INIT} ${error.message}`}</div>\n\n      // Показываем загрузку пока store не готов\n      if (!synapseStore) return <>{loadingComponent}</>\n\n      return (\n        <SynapseContext.Provider value={synapseStore}>\n          <Component {...(props as PropsWithChildren<SelfComponentProps>)} ref={ref} />\n        </SynapseContext.Provider>\n      )\n    })\n\n    // Устанавливаем отображаемое имя для отладки\n    const componentName = Component.displayName || Component.name || 'Component'\n    WrappedComponent.displayName = `SynapseContext(${componentName})`\n\n    // Копируем статические свойства оригинального компонента\n    const excludedKeys = new Set(['$$typeof', 'render', 'defaultProps', 'displayName', 'propTypes'])\n    Object.keys(Component).forEach((key) => {\n      if (!excludedKeys.has(key)) {\n        ;(WrappedComponent as any)[key] = (Component as any)[key]\n      }\n    })\n\n    return WrappedComponent as ComponentType<SelfComponentProps>\n  }\n\n  const cleanupSynapse = async (): Promise<void> => {\n    if (!awaiter) return\n\n    const instance = awaiter\n    awaiter = null // сбрасываем сразу, чтобы следующий маунт создал новый awaiter\n\n    try {\n      const store = instance.getStoreIfReady() ?? (await instance.waitForReady())\n      instance.destroy()\n      await store?.destroy()\n    } catch (error) {\n      instance.destroy()\n      handleCleanupError('createSynapseCtx: error during Synapse cleanup', error)\n    }\n  }\n\n  return {\n    contextSynapse,\n    useSynapseStorage,\n    useSynapseSelectors,\n    useSynapseActions,\n    useSynapseState$,\n    cleanupSynapse,\n  }\n}\n"],"names":["createContext","forwardRef","useContext","useEffect","useState","handleCleanupError","createSynapseAwaiter","ERROR_HOOK_MESSAGE","ERROR_CONTEXT_INIT","createSynapseCtx","synapseStorePromise","options","loadingComponent","awaiter","getAwaiter","SynapseContext","useSynapseStorage","context","Error","useSynapseSelectors","useSynapseActions","useSynapseState$","contextSynapse","Component","WrappedComponent","props","ref","synapseStore","setSynapseStore","error","setError","instance","unsubscribeReady","store","unsubscribeError","err","undefined","componentName","excludedKeys","Set","Object","key","cleanupSynapse"],"mappings":"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"}
+{"version":3,"file":"react/utils/createSynapseCtx.js","sources":["../../../src/react/utils/createSynapseCtx.tsx"],"sourcesContent":["import { ComponentType, createContext, forwardRef, PropsWithChildren, useContext, useEffect, useRef, useState } from 'react'\nimport { Observable } from 'rxjs'\n\nimport { handleCleanupError } from '../../_utils/error-handling.util'\nimport { IStorage, StorageStatus } from '../../core'\nimport { createSynapseAwaiter, dehydrateModule, type Synapse, type SynapseAwaiter, type SynapseModule } from '../../utils'\n\nconst ERROR_HOOK_MESSAGE = 'Хук необходимо использовать внутри компонента contextSynapse'\nconst ERROR_CONTEXT_INIT = 'Ошибка при инициализации контекста:'\n\ninterface SimplifiedOptions {\n  loadingComponent?: React.ReactNode\n  /**\n   * Включает серверный рендер засеянных sync-сторов (Memory/LocalStorage). При `ssr: true`\n   * и синхронно-готовом сторе Provider рендерит children сразу (без `loadingComponent`),\n   * что даёт контент в серверном HTML и совпадающий первый кадр при гидрации.\n   * Для async-сторов (IndexedDB) поведение прежнее — гейт `loadingComponent`.\n   */\n  ssr?: boolean\n}\n\nexport function createSynapseCtx<TState extends Record<string, any>, TDispatcher, TSelectors>(\n  synapseModule: SynapseModule<TState, TDispatcher, TSelectors>,\n  options?: SimplifiedOptions,\n) {\n  const { loadingComponent = <div>Инициализация контекста...</div>, ssr = false } = options || {}\n\n  type ReadySynapse = Synapse<TState, TDispatcher, TSelectors>\n\n  const SynapseContext = createContext<ReadySynapse | null>(null)\n\n  // ── Awaiter ───────────────────────────────────────────────────────────────\n  // Клиент сохраняет прежнюю синглтон-семантику: один awaiter на handle (общий стор,\n  // фабрика стартует один раз при первом mount). На сервере синглтон уровня модуля\n  // запрещён (request bleed), поэтому там awaiter живёт per-render-tree и не шарится.\n  let clientAwaiter: SynapseAwaiter<ReadySynapse> | null = null\n\n  const getClientAwaiter = () => {\n    if (!clientAwaiter) clientAwaiter = createSynapseAwaiter<ReadySynapse>(synapseModule)\n    return clientAwaiter\n  }\n\n  const useSynapseStorage = (): IStorage<TState> => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseStorage: ${ERROR_HOOK_MESSAGE}`)\n    return context.storage\n  }\n\n  const useSynapseSelectors = (): TSelectors => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseSelectors: ${ERROR_HOOK_MESSAGE}`)\n    return context.selectors\n  }\n\n  const useSynapseActions = (): TDispatcher => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseActions: ${ERROR_HOOK_MESSAGE}`)\n    return context.actions\n  }\n\n  const useSynapseState$ = (): Observable<TState> => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseState$: ${ERROR_HOOK_MESSAGE}`)\n    return context.state$\n  }\n\n  // Серверный помощник: тонкая обёртка над server-safe dehydrateModule (вся логика там).\n  // initialState — серверные данные под запрос, не статический initialState модуля; ssr — из\n  // опций контекста.\n  const dehydrate = (opts?: { initialState?: Partial<TState> }): Promise<TState> => dehydrateModule(synapseModule, { state: opts?.initialState, ssr })\n\n  /**\n   * Декоратор для обёртки компонентов в контекст Synapse.\n   */\n  function contextSynapse<SelfComponentProps>(Component: ComponentType<SelfComponentProps>) {\n    const WrappedComponent = forwardRef<unknown, SelfComponentProps & { dehydratedState?: TState }>(function WrappedComponent(props, ref) {\n      const { dehydratedState, ...restProps } = props as SelfComponentProps & { dehydratedState?: TState }\n\n      // Per-tree awaiter при наличии dehydratedState (изоляция server-рендера); иначе —\n      // общий клиентский awaiter (обратная совместимость).\n      const treeAwaiterRef = useRef<SynapseAwaiter<ReadySynapse> | null>(null)\n      const resolveAwaiter = (): SynapseAwaiter<ReadySynapse> => {\n        if (dehydratedState !== undefined) {\n          if (!treeAwaiterRef.current) treeAwaiterRef.current = createSynapseAwaiter<ReadySynapse>(synapseModule)\n          return treeAwaiterRef.current\n        }\n        return getClientAwaiter()\n      }\n\n      // Синхронный засев снапшота ДО первого рендера: одинаковый HTML на сервере и клиенте.\n      const seedHydration = (store: ReadySynapse | undefined) => {\n        if (store && dehydratedState !== undefined && store.storage.initStatus.status === StorageStatus.READY) {\n          store.storage.hydrate(dehydratedState)\n        }\n      }\n\n      const [synapseStore, setSynapseStore] = useState<ReadySynapse | undefined>(() => {\n        const store = resolveAwaiter().getStoreIfReady()\n        seedHydration(store)\n        return store\n      })\n      const [error, setError] = useState<Error | null>(() => resolveAwaiter().getError())\n\n      useEffect(() => {\n        // На сервере эффект не исполняется — подписки/догрузка стартуют только на клиенте.\n        const instance = resolveAwaiter()\n        const current = instance.getStoreIfReady()\n        seedHydration(current)\n        setSynapseStore(current)\n        setError(instance.getError())\n\n        const unsubscribeReady = instance.onReady((store) => {\n          seedHydration(store)\n          setSynapseStore(store)\n          setError(null)\n        })\n        const unsubscribeError = instance.onError((err) => {\n          setSynapseStore(undefined)\n          setError(err)\n        })\n\n        return () => {\n          unsubscribeReady()\n          unsubscribeError()\n        }\n      }, [])\n\n      if (error) return <div>{`${ERROR_CONTEXT_INIT} ${error.message}`}</div>\n\n      // SSR-гейт: при ssr и синхронно-готовом сторе (сервер после dehydrate / клиентская\n      // гидрация) synapseStore уже есть → рендерим children. Иначе — прежний гейт загрузки\n      // (async-сторы и обычный клиентский старт).\n      if (!synapseStore) return <>{loadingComponent}</>\n\n      return (\n        <SynapseContext.Provider value={synapseStore}>\n          <Component {...(restProps as PropsWithChildren<SelfComponentProps>)} ref={ref} />\n        </SynapseContext.Provider>\n      )\n    })\n\n    const componentName = Component.displayName || Component.name || 'Component'\n    WrappedComponent.displayName = `SynapseContext(${componentName})`\n\n    // Копируем статические свойства оригинального компонента\n    const excludedKeys = new Set(['$$typeof', 'render', 'defaultProps', 'displayName', 'propTypes'])\n    Object.keys(Component).forEach((key) => {\n      if (!excludedKeys.has(key)) {\n        ;(WrappedComponent as any)[key] = (Component as any)[key]\n      }\n    })\n\n    return WrappedComponent as ComponentType<SelfComponentProps & { dehydratedState?: TState }>\n  }\n\n  const cleanupSynapse = async (): Promise<void> => {\n    const instance = clientAwaiter\n    clientAwaiter = null\n    try {\n      instance?.destroy()\n      await synapseModule.destroy()\n    } catch (error) {\n      handleCleanupError('createSynapseCtx: error during Synapse cleanup', error)\n    }\n  }\n\n  return {\n    contextSynapse,\n    dehydrate,\n    useSynapseStorage,\n    useSynapseSelectors,\n    useSynapseActions,\n    useSynapseState$,\n    cleanupSynapse,\n  }\n}\n"],"names":["createContext","forwardRef","useContext","useEffect","useRef","useState","handleCleanupError","StorageStatus","createSynapseAwaiter","dehydrateModule","ERROR_HOOK_MESSAGE","ERROR_CONTEXT_INIT","createSynapseCtx","synapseModule","options","loadingComponent","ssr","SynapseContext","clientAwaiter","getClientAwaiter","useSynapseStorage","context","Error","useSynapseSelectors","useSynapseActions","useSynapseState$","dehydrate","opts","contextSynapse","Component","WrappedComponent","props","ref","dehydratedState","restProps","treeAwaiterRef","resolveAwaiter","undefined","seedHydration","store","synapseStore","setSynapseStore","error","setError","instance","current","unsubscribeReady","unsubscribeError","err","componentName","excludedKeys","Set","Object","key","cleanupSynapse"],"mappings":"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"}

package/dist/react/utils/index.d.ts

@@ -1,3 +1,2 @@
 export { awaitSynapse } from './awaitSynapse';
 export { createSynapseCtx } from './createSynapseCtx';
-//# sourceMappingURL=index.d.ts.map