synapse-storage 4.1.1 → 5.0.3

package/dist/reactive/dispatcher/standalone.js

@@ -1,4 +1,9 @@
+// ────────────────────────────────────────────────────────────────────────────
+// Types
+// ────────────────────────────────────────────────────────────────────────────
 /**
+ * Параметры исполнения действия (мемоизация)
+ */ /**
  * Статусы жизненного цикла API-запроса.
  *
  * Сделано const-объектом (а не TS `enum`) намеренно: значения остаются обычными
@@ -15,223 +20,7 @@
     Error: 'error',
     Reset: 'reset'
 };
-// ────────────────────────────────────────────────────────────────────────────
-// defineAction
-// ────────────────────────────────────────────────────────────────────────────
-/**
- * Создаёт standalone-определение действия.
- * Фиксирует TState через первый вызов, TParams/TResult инферятся из action.
- *
- * @example
- * ```ts
- * const action = defineAction<MyState>()
- *
- * export const increment = action({
- *   action: (storage, amount: number) => {
- *     storage.update((s) => { s.count += amount })
- *     return amount
- *   },
- * })
- *
- * // Void action (без параметров и возврата):
- * export const reset = action({
- *   action: (storage) => {
- *     storage.update((s) => { s.count = 0 })
- *   },
- * })
- * ```
- */ function defineAction() {
-    return (config, executionOptions)=>({
-            _type: 'action-recipe',
-            _config: config,
-            _executionOptions: executionOptions
-        });
-}
-// ────────────────────────────────────────────────────────────────────────────
-// defineWatcher
-// ────────────────────────────────────────────────────────────────────────────
-/**
- * Создаёт standalone-определение watcher'а.
- *
- * @example
- * ```ts
- * export const watchCount = defineWatcher<MyState>()({
- *   selector: (s) => s.items.length,
- *   notifyAfterSubscribe: true,
- * })
- * ```
- */ function defineWatcher() {
-    return (config)=>({
-            _type: 'watcher-recipe',
-            _config: config
-        });
-}
-// ────────────────────────────────────────────────────────────────────────────
-// createApiActions
-// ────────────────────────────────────────────────────────────────────────────
-/**
- * Вычисляет путь к свойству через Proxy-перехват обращений.
- */ function resolvePath(accessor) {
-    const path = [];
-    const handler = {
-        get (_, prop) {
-            if (typeof prop === 'string') {
-                path.push(prop);
-            }
-            return new Proxy({}, handler);
-        }
-    };
-    accessor(new Proxy({}, handler));
-    return path;
-}
-/**
- * Записывает значение по пути в объекте.
- */ function setByPath(obj, path, value) {
-    let current = obj;
-    for(let i = 0; i < path.length - 1; i++){
-        current = current[path[i]];
-    }
-    current[path[path.length - 1]] = value;
-}
-/**
- * Создаёт набор шаблонных lifecycle-действий для API-запроса.
- * Accessor указывает на поле ApiRequestState в стейте — путь вычисляется автоматически.
- *
- * @param accessor - Функция-accessor, указывающая на поле ApiRequestState в стейте
- *
- * @typeParam TInitPayload - Тип payload'а `init`-экшена. По умолчанию `void`
- *   (init без параметров). Если задать — `init` принимает payload и возвращает
- *   его, что удобно для intent-паттерна: эффект слушает `init` и читает payload
- *   намерения (target, фильтры и т.п.), а статус при этом сбрасывается в `idle`.
- *
- * @example
- * ```ts
- * const listRequest = createApiActions<MyState>(
- *   (draft) => draft.api.listRequest
- * )
- *
- * // В dispatcher:
- * createDispatcher({ storage }, {
- *   loadListInit:    listRequest.init,
- *   loadListLoading: listRequest.loading,
- *   loadListSuccess: listRequest.success,
- *   loadListFailure: listRequest.failure,
- *   loadListReset:   listRequest.reset,
- * })
- *
- * // init с payload (intent): эффект получит { entityId } из возврата экшена.
- * const usersReq = createApiActions<MyState, { entityId: string }>(
- *   (draft) => draft.api.usersRequest
- * )
- * ```
- */ function createApiActions(accessor) {
-    const path = resolvePath(accessor);
-    const action = defineAction();
-    const update = (storage, request)=>{
-        storage.update((s)=>setByPath(s, path, request));
-    };
-    return {
-        init: action({
-            // Сбрасываем статус в idle и пробрасываем payload намерения дальше (эффектам).
-            action: (storage, payload)=>{
-                update(storage, {
-                    status: ApiStatus.Idle,
-                    error: null
-                });
-                return payload;
-            }
-        }),
-        loading: action({
-            action: (storage)=>update(storage, {
-                    status: ApiStatus.Loading,
-                    error: null
-                })
-        }),
-        success: action({
-            action: (storage)=>update(storage, {
-                    status: ApiStatus.Success,
-                    error: null
-                })
-        }),
-        failure: action({
-            action: (storage, error)=>update(storage, {
-                    status: ApiStatus.Error,
-                    error
-                })
-        }),
-        reset: action({
-            action: (storage)=>update(storage, {
-                    status: ApiStatus.Reset,
-                    error: null
-                })
-        })
-    };
-}
-// ────────────────────────────────────────────────────────────────────────────
-// createKeyedApiActions
-// ────────────────────────────────────────────────────────────────────────────
-/**
- * Keyed-вариант createApiActions: статус хранится ПО КЛЮЧУ в `Record<string,
- * ApiRequestState>`, а не один на весь запрос. Нужен, когда один и тот же запрос
- * летит параллельно для нескольких независимых ключей и у каждого свой
- * loading/error: комменты по таргетам, детали сущностей по id, per-row действия
- * в таблице/ленте, пагинация по секциям — всё, что лежит как `Record<key, data>`.
- *
- * Все статус-экшены принимают `key` (и возвращают его — удобно эффектам), кроме
- * `failure`, который принимает `{ key, error }`. Записи мутируются иммутабельно
- * по одному ключу — соседние ключи (их срезы) по ссылке не затрагиваются, что и
- * нужно для гранулярной изоляции ре-рендеров (см. useKeyedSliceSelector).
- *
- * @param accessor - Функция-accessor, указывающая на поле `Record<string, ApiRequestState>`
- *
- * @example
- * ```ts
- * const commentsReq = createKeyedApiActions<MyState>((d) => d.api.commentsRequest)
- *
- * createDispatcher({ storage }, {
- *   commentsInit:    commentsReq.init,     // (key) => key
- *   commentsLoading: commentsReq.loading,  // (key) => key
- *   commentsSuccess: commentsReq.success,  // (key) => key
- *   commentsFailure: commentsReq.failure,  // ({ key, error })
- *   commentsReset:   commentsReq.reset,    // (key) => key
- * })
- * ```
- */ function createKeyedApiActions(accessor) {
-    const path = resolvePath(accessor);
-    const action = defineAction();
-    const write = (storage, key, request)=>{
-        // [...path, key] → setByPath доходит до самого Record и кладёт значение по ключу
-        storage.update((s)=>setByPath(s, [
-                ...path,
-                key
-            ], request));
-    };
-    const writer = (status)=>action({
-            action: (storage, key)=>{
-                write(storage, key, {
-                    status,
-                    error: null
-                });
-                return key;
-            }
-        });
-    return {
-        init: writer(ApiStatus.Idle),
-        loading: writer(ApiStatus.Loading),
-        success: writer(ApiStatus.Success),
-        reset: writer(ApiStatus.Reset),
-        failure: action({
-            action: (storage, payload)=>{
-                write(storage, payload.key, {
-                    status: ApiStatus.Error,
-                    error: payload.error
-                });
-                return payload;
-            }
-        })
-    };
-}
 
-export { ApiStatus, createApiActions, createKeyedApiActions, defineAction, defineWatcher };
+export { ApiStatus };
 
 //# sourceMappingURL=standalone.js.map

package/dist/reactive/dispatcher/standalone.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactive/dispatcher/standalone.js","sources":["../../../src/reactive/dispatcher/standalone.ts"],"sourcesContent":["import type { IStorage } from '../../core'\n\n// ────────────────────────────────────────────────────────────────────────────\n// Types\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Параметры исполнения действия (мемоизация)\n */\nexport interface ActionExecutionOptions<TParams, TResult> {\n  memoize?: (currentArgs: TParams, previousArgs: TParams, previousResult: TResult) => boolean\n}\n\n/**\n * Рецепт действия — standalone-определение, не привязанное к хранилищу.\n * Привязывается к storage при регистрации в createDispatcher.\n */\nexport interface ActionRecipe<TState extends Record<string, any>, TParams, TResult> {\n  readonly _type: 'action-recipe'\n  readonly _config: {\n    action: (storage: IStorage<TState>, params: TParams) => Promise<TResult> | TResult\n    meta?: Record<string, any>\n  }\n  readonly _executionOptions?: ActionExecutionOptions<TParams, TResult>\n}\n\n/**\n * Рецепт watcher'а — standalone-определение, не привязанное к хранилищу.\n */\nexport interface WatcherRecipe<TState extends Record<string, any>, R> {\n  readonly _type: 'watcher-recipe'\n  readonly _config: {\n    selector: (state: TState) => R\n    meta?: Record<string, any>\n    shouldTrigger?: (prev: R | undefined, current: R) => boolean\n    notifyAfterSubscribe?: boolean\n  }\n}\n\n/**\n * Статусы жизненного цикла API-запроса.\n *\n * Сделано const-объектом (а не TS `enum`) намеренно: значения остаются обычными\n * строковыми литералами, поэтому `ApiStatus.Loading` и строка `'loading'`\n * взаимозаменяемы и тип обратно совместим с прежним строковым union'ом. С `enum`\n * это не так — его член не присваивается к литералу и наоборот.\n *\n * `ApiStatus` — одновременно значение (для `ApiStatus.Loading` в коде) и тип\n * (union всех статусов).\n */\nexport const ApiStatus = {\n  Idle: 'idle',\n  Loading: 'loading',\n  Success: 'success',\n  Error: 'error',\n  Reset: 'reset',\n} as const\n\nexport type ApiStatus = (typeof ApiStatus)[keyof typeof ApiStatus]\n\n/**\n * Состояние API-запроса для createApiActions / createKeyedApiActions\n */\nexport interface ApiRequestState {\n  status: ApiStatus\n  error: string | null\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// defineAction\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Создаёт standalone-определение действия.\n * Фиксирует TState через первый вызов, TParams/TResult инферятся из action.\n *\n * @example\n * ```ts\n * const action = defineAction<MyState>()\n *\n * export const increment = action({\n *   action: (storage, amount: number) => {\n *     storage.update((s) => { s.count += amount })\n *     return amount\n *   },\n * })\n *\n * // Void action (без параметров и возврата):\n * export const reset = action({\n *   action: (storage) => {\n *     storage.update((s) => { s.count = 0 })\n *   },\n * })\n * ```\n */\nexport function defineAction<TState extends Record<string, any>>() {\n  return <TParams = void, TResult = void>(\n    config: {\n      action: (storage: IStorage<TState>, params: TParams) => Promise<TResult> | TResult\n      meta?: Record<string, any>\n    },\n    executionOptions?: ActionExecutionOptions<TParams, TResult>,\n  ): ActionRecipe<TState, TParams, TResult> => ({\n    _type: 'action-recipe' as const,\n    _config: config,\n    _executionOptions: executionOptions,\n  })\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// defineWatcher\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Создаёт standalone-определение watcher'а.\n *\n * @example\n * ```ts\n * export const watchCount = defineWatcher<MyState>()({\n *   selector: (s) => s.items.length,\n *   notifyAfterSubscribe: true,\n * })\n * ```\n */\nexport function defineWatcher<TState extends Record<string, any>>() {\n  return <R>(config: {\n    selector: (state: TState) => R\n    meta?: Record<string, any>\n    shouldTrigger?: (prev: R | undefined, current: R) => boolean\n    notifyAfterSubscribe?: boolean\n  }): WatcherRecipe<TState, R> => ({\n    _type: 'watcher-recipe' as const,\n    _config: config,\n  })\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// createApiActions\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Вычисляет путь к свойству через Proxy-перехват обращений.\n */\nfunction resolvePath<T>(accessor: (draft: T) => any): string[] {\n  const path: string[] = []\n  const handler: ProxyHandler<any> = {\n    get(_, prop) {\n      if (typeof prop === 'string') {\n        path.push(prop)\n      }\n      return new Proxy({}, handler)\n    },\n  }\n  accessor(new Proxy({}, handler) as T)\n  return path\n}\n\n/**\n * Записывает значение по пути в объекте.\n */\nfunction setByPath(obj: any, path: string[], value: any): void {\n  let current = obj\n  for (let i = 0; i < path.length - 1; i++) {\n    current = current[path[i]]\n  }\n  current[path[path.length - 1]] = value\n}\n\n/**\n * Создаёт набор шаблонных lifecycle-действий для API-запроса.\n * Accessor указывает на поле ApiRequestState в стейте — путь вычисляется автоматически.\n *\n * @param accessor - Функция-accessor, указывающая на поле ApiRequestState в стейте\n *\n * @typeParam TInitPayload - Тип payload'а `init`-экшена. По умолчанию `void`\n *   (init без параметров). Если задать — `init` принимает payload и возвращает\n *   его, что удобно для intent-паттерна: эффект слушает `init` и читает payload\n *   намерения (target, фильтры и т.п.), а статус при этом сбрасывается в `idle`.\n *\n * @example\n * ```ts\n * const listRequest = createApiActions<MyState>(\n *   (draft) => draft.api.listRequest\n * )\n *\n * // В dispatcher:\n * createDispatcher({ storage }, {\n *   loadListInit:    listRequest.init,\n *   loadListLoading: listRequest.loading,\n *   loadListSuccess: listRequest.success,\n *   loadListFailure: listRequest.failure,\n *   loadListReset:   listRequest.reset,\n * })\n *\n * // init с payload (intent): эффект получит { entityId } из возврата экшена.\n * const usersReq = createApiActions<MyState, { entityId: string }>(\n *   (draft) => draft.api.usersRequest\n * )\n * ```\n */\nexport function createApiActions<TState extends Record<string, any>, TInitPayload = void>(accessor: (draft: TState) => ApiRequestState) {\n  const path = resolvePath(accessor)\n  const action = defineAction<TState>()\n\n  const update = (storage: IStorage<TState>, request: ApiRequestState) => {\n    storage.update((s) => setByPath(s, path, request))\n  }\n\n  return {\n    init: action<TInitPayload, TInitPayload>({\n      // Сбрасываем статус в idle и пробрасываем payload намерения дальше (эффектам).\n      action: (storage, payload: TInitPayload) => {\n        update(storage, { status: ApiStatus.Idle, error: null })\n        return payload\n      },\n    }),\n\n    loading: action({\n      action: (storage) => update(storage, { status: ApiStatus.Loading, error: null }),\n    }),\n\n    success: action({\n      action: (storage) => update(storage, { status: ApiStatus.Success, error: null }),\n    }),\n\n    failure: action({\n      action: (storage, error: string) => update(storage, { status: ApiStatus.Error, error }),\n    }),\n\n    reset: action({\n      action: (storage) => update(storage, { status: ApiStatus.Reset, error: null }),\n    }),\n  }\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// createKeyedApiActions\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Keyed-вариант createApiActions: статус хранится ПО КЛЮЧУ в `Record<string,\n * ApiRequestState>`, а не один на весь запрос. Нужен, когда один и тот же запрос\n * летит параллельно для нескольких независимых ключей и у каждого свой\n * loading/error: комменты по таргетам, детали сущностей по id, per-row действия\n * в таблице/ленте, пагинация по секциям — всё, что лежит как `Record<key, data>`.\n *\n * Все статус-экшены принимают `key` (и возвращают его — удобно эффектам), кроме\n * `failure`, который принимает `{ key, error }`. Записи мутируются иммутабельно\n * по одному ключу — соседние ключи (их срезы) по ссылке не затрагиваются, что и\n * нужно для гранулярной изоляции ре-рендеров (см. useKeyedSliceSelector).\n *\n * @param accessor - Функция-accessor, указывающая на поле `Record<string, ApiRequestState>`\n *\n * @example\n * ```ts\n * const commentsReq = createKeyedApiActions<MyState>((d) => d.api.commentsRequest)\n *\n * createDispatcher({ storage }, {\n *   commentsInit:    commentsReq.init,     // (key) => key\n *   commentsLoading: commentsReq.loading,  // (key) => key\n *   commentsSuccess: commentsReq.success,  // (key) => key\n *   commentsFailure: commentsReq.failure,  // ({ key, error })\n *   commentsReset:   commentsReq.reset,    // (key) => key\n * })\n * ```\n */\nexport function createKeyedApiActions<TState extends Record<string, any>>(accessor: (draft: TState) => Record<string, ApiRequestState>) {\n  const path = resolvePath(accessor)\n  const action = defineAction<TState>()\n\n  const write = (storage: IStorage<TState>, key: string, request: ApiRequestState) => {\n    // [...path, key] → setByPath доходит до самого Record и кладёт значение по ключу\n    storage.update((s) => setByPath(s, [...path, key], request))\n  }\n\n  const writer = (status: ApiStatus) =>\n    action<string, string>({\n      action: (storage, key: string) => {\n        write(storage, key, { status, error: null })\n        return key\n      },\n    })\n\n  return {\n    init: writer(ApiStatus.Idle),\n    loading: writer(ApiStatus.Loading),\n    success: writer(ApiStatus.Success),\n    reset: writer(ApiStatus.Reset),\n\n    failure: action<{ key: string; error: string }, { key: string; error: string }>({\n      action: (storage, payload: { key: string; error: string }) => {\n        write(storage, payload.key, { status: ApiStatus.Error, error: payload.error })\n        return payload\n      },\n    }),\n  }\n}\n"],"names":["ApiStatus","defineAction","config","executionOptions","defineWatcher","resolvePath","accessor","path","handler","_","prop","Proxy","setByPath","obj","value","current","i","createApiActions","action","update","storage","request","s","payload","error","createKeyedApiActions","write","key","writer","status"],"mappings":"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"}
+{"version":3,"file":"reactive/dispatcher/standalone.js","sources":["../../../src/reactive/dispatcher/standalone.ts"],"sourcesContent":["// ────────────────────────────────────────────────────────────────────────────\n// Types\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Параметры исполнения действия (мемоизация)\n */\nexport interface ActionExecutionOptions<TParams, TResult> {\n  memoize?: (currentArgs: TParams, previousArgs: TParams, previousResult: TResult) => boolean\n}\n\n/**\n * Статусы жизненного цикла API-запроса.\n *\n * Сделано const-объектом (а не TS `enum`) намеренно: значения остаются обычными\n * строковыми литералами, поэтому `ApiStatus.Loading` и строка `'loading'`\n * взаимозаменяемы и тип обратно совместим с прежним строковым union'ом. С `enum`\n * это не так — его член не присваивается к литералу и наоборот.\n *\n * `ApiStatus` — одновременно значение (для `ApiStatus.Loading` в коде) и тип\n * (union всех статусов).\n */\nexport const ApiStatus = {\n  Idle: 'idle',\n  Loading: 'loading',\n  Success: 'success',\n  Error: 'error',\n  Reset: 'reset',\n} as const\n\nexport type ApiStatus = (typeof ApiStatus)[keyof typeof ApiStatus]\n\n/**\n * Состояние API-запроса (`this.apiActions` / `this.keyedApiActions`)\n */\nexport interface ApiRequestState {\n  status: ApiStatus\n  error: string | null\n}\n"],"names":["ApiStatus"],"mappings":"AAAA,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;CAEC,GAKD;;;;;;;;;;CAUC,GACM,MAAMA,SAASA,GAAG;IACvB,MAAM;IACN,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;AACT,EAAU"}

package/dist/reactive/effects/effects.base.d.ts

@@ -0,0 +1,62 @@
+import type { Observable } from 'rxjs';
+import type { Action } from '../dispatcher';
+import type { Dispatcher } from '../dispatcher/dispatcher.base';
+import { type Effect, type EffectOptions } from './effects.module';
+/**
+ * Контекст эффекта в class-стиле — узкий надтип контекста EffectsModule. Рецепт читает
+ * только эти два поля; остальное (services, externalStates) приходит через конструктор
+ * класса и захватывается замыканием.
+ */
+export interface EffectCtx<TDispatcher, TExternalDispatchers = Record<string, never>> {
+    /** Инстанс нашего class-диспетчера: `ofType(d.loadPosts)` + `d.applyPosts(...)`. */
+    dispatcher: TDispatcher;
+    /** Внешние диспетчеры (их экшены уже влиты в общий `action$`). */
+    external: TExternalDispatchers;
+}
+/** Рецепт эффекта: отложенная функция, вызываемая один раз при `EffectsModule.start()`. */
+export type EffectRecipe<TState, TDispatcher, TExternalDispatchers> = (action$: Observable<Action>, state$: Observable<TState>, ctx: EffectCtx<TDispatcher, TExternalDispatchers>) => Observable<unknown>;
+/**
+ * Публичный class-based слой эффектов. Эффекты объявляются как поля класса через
+ * `this.effect(fn)`. Сервисы и внешние сторы передаются через конструктор и
+ * захватываются в замыкание рецепта (`this.api`, `this.core$`).
+ *
+ * @example
+ * ```ts
+ * class PostsEffects extends Effects<PostsState, PostsDispatcher> {
+ *   constructor(private readonly api: PostsEndpoints, private readonly core$: Observable<CoreState>) {
+ *     super()
+ *   }
+ *
+ *   readonly loadPosts = this.effect((action$, state$, { dispatcher: d }) =>
+ *     action$.pipe(ofType(d.loadPosts), validateMap({ apiCall: () => fromRequest(this.api.getPosts.request()) })))
+ *
+ *   override onDestroy() { this.socket.disconnect() }
+ * }
+ * ```
+ *
+ * **Правило**: сервисы из конструктора (`this.api`) можно *захватывать в замыкание*
+ * рецепта, но не дереференсить прямо в инициализаторе поля — parameter properties
+ * присваиваются ПОСЛЕ инициализаторов полей derived-класса.
+ */
+export declare abstract class Effects<TState extends Record<string, any>, TDispatcher, TExternalDispatchers extends Record<string, Dispatcher<any>> = Record<string, never>> {
+    #private;
+    /**
+     * Регистрирует рецепт эффекта. Сам рецепт НЕ вызывается при конструировании — он
+     * вызывается лениво при `EffectsModule.start()` с реальными потоками. Возвращает тот
+     * же `fn`, так что поле остаётся вызываемым рецептом (удобно для юнит-тестов в изоляции).
+     *
+     * @param fn рецепт `(action$, state$, ctx) => Observable`
+     * @param options опции эффекта (например, `resubscribeOnError`)
+     */
+    protected effect(fn: EffectRecipe<TState, TDispatcher, TExternalDispatchers>, options?: EffectOptions): EffectRecipe<TState, TDispatcher, TExternalDispatchers>;
+    /**
+     * Список module-совместимых эффектов в порядке объявления полей. Сборщик скармливает
+     * его в `effectsModule.addEffects(...)`.
+     *
+     * Попутно (вне production) предупреждает о полях-функциях, не обёрнутых в `this.effect`.
+     * @internal
+     */
+    getEffects(): Effect[];
+    /** Опциональный teardown (закрыть сокет и т.п.) — вызывается сборщиком при `synapse.destroy()`. */
+    onDestroy?(): void | Promise<void>;
+}

package/dist/reactive/effects/effects.base.js

@@ -0,0 +1,90 @@
+import { logError } from "../../_utils/error-handling.util.js";
+import { EFFECT_NAME, EFFECT_OPTIONS } from "./effects.module.js";
+
+
+
+
+
+/**
+ * Маркер «продукта `this.effect`» на функции-рецепте. По его отсутствию dev-проверка
+ * находит поля-функции, которые забыли обернуть в `this.effect(...)` (иначе они не
+ * попадут в реестр и молча не запустятся).
+ * @internal
+ */ const EFFECT_MARKER = Symbol('synapse.effect.recipe');
+/** Имена членов базового класса — не считаются «забытыми эффектами». */ const RESERVED_NAMES = new Set([
+    'onDestroy'
+]);
+/**
+ * Публичный class-based слой эффектов. Эффекты объявляются как поля класса через
+ * `this.effect(fn)`. Сервисы и внешние сторы передаются через конструктор и
+ * захватываются в замыкание рецепта (`this.api`, `this.core$`).
+ *
+ * @example
+ * ```ts
+ * class PostsEffects extends Effects<PostsState, PostsDispatcher> {
+ *   constructor(private readonly api: PostsEndpoints, private readonly core$: Observable<CoreState>) {
+ *     super()
+ *   }
+ *
+ *   readonly loadPosts = this.effect((action$, state$, { dispatcher: d }) =>
+ *     action$.pipe(ofType(d.loadPosts), validateMap({ apiCall: () => fromRequest(this.api.getPosts.request()) })))
+ *
+ *   override onDestroy() { this.socket.disconnect() }
+ * }
+ * ```
+ *
+ * **Правило**: сервисы из конструктора (`this.api`) можно *захватывать в замыкание*
+ * рецепта, но не дереференсить прямо в инициализаторе поля — parameter properties
+ * присваиваются ПОСЛЕ инициализаторов полей derived-класса.
+ */ class Effects {
+    /** Реестр module-совместимых эффектов в порядке объявления полей. */ #effects = [];
+    /**
+   * Регистрирует рецепт эффекта. Сам рецепт НЕ вызывается при конструировании — он
+   * вызывается лениво при `EffectsModule.start()` с реальными потоками. Возвращает тот
+   * же `fn`, так что поле остаётся вызываемым рецептом (удобно для юнит-тестов в изоляции).
+   *
+   * @param fn рецепт `(action$, state$, ctx) => Observable`
+   * @param options опции эффекта (например, `resubscribeOnError`)
+   */ effect(fn, options) {
+        // Module-совместимая обёртка: широкий контекст EffectsModule → узкий EffectCtx рецепта.
+        const moduleEffect = (action$, state$, context)=>fn(action$, state$, {
+                dispatcher: context.dispatcher,
+                external: context.externalDispatchers
+            });
+        if (options) {
+            ;
+            moduleEffect[EFFECT_OPTIONS] = options;
+        }
+        this.#effects.push(moduleEffect);
+        fn[EFFECT_MARKER] = true;
+        return fn;
+    }
+    /**
+   * Список module-совместимых эффектов в порядке объявления полей. Сборщик скармливает
+   * его в `effectsModule.addEffects(...)`.
+   *
+   * Попутно (вне production) предупреждает о полях-функциях, не обёрнутых в `this.effect`.
+   * @internal
+   */ getEffects() {
+        // Имена полей-рецептов идут в порядке объявления — ровно как и #effects (каждый
+        // this.effect() пушит в #effects и помечает свой fn). Зипуем их, чтобы EffectsModule
+        // мог назвать упавший эффект по имени поля, а не по индексу.
+        const recipeNames = [];
+        for (const [name, value] of Object.entries(this)){
+            if (typeof value === 'function' && value[EFFECT_MARKER]) {
+                recipeNames.push(name);
+            } else if (process.env.NODE_ENV !== 'production' && typeof value === 'function' && !RESERVED_NAMES.has(name)) {
+                logError(`Effects: поле "${name}" — функция, но не обёрнута в this.effect(...). Эффекты регистрируются только через this.effect, иначе они молча не запустятся.`, value, null, 'warn');
+            }
+        }
+        this.#effects.forEach((moduleEffect, i)=>{
+            const name = recipeNames[i];
+            if (name) moduleEffect[EFFECT_NAME] = name;
+        });
+        return this.#effects;
+    }
+}
+
+export { Effects };
+
+//# sourceMappingURL=effects.base.js.map

package/dist/reactive/effects/effects.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive/effects/effects.base.js","sources":["../../../src/reactive/effects/effects.base.ts"],"sourcesContent":["import type { Observable } from 'rxjs'\n\nimport { logError } from '../../_utils/error-handling.util'\nimport type { Action } from '../dispatcher'\nimport type { Dispatcher } from '../dispatcher/dispatcher.base'\nimport { type Effect, EFFECT_NAME, EFFECT_OPTIONS, type EffectOptions } from './effects.module'\n\n/**\n * Маркер «продукта `this.effect`» на функции-рецепте. По его отсутствию dev-проверка\n * находит поля-функции, которые забыли обернуть в `this.effect(...)` (иначе они не\n * попадут в реестр и молча не запустятся).\n * @internal\n */\nconst EFFECT_MARKER = Symbol('synapse.effect.recipe')\n\n/** Имена членов базового класса — не считаются «забытыми эффектами». */\nconst RESERVED_NAMES = new Set(['onDestroy'])\n\n/**\n * Контекст эффекта в class-стиле — узкий надтип контекста EffectsModule. Рецепт читает\n * только эти два поля; остальное (services, externalStates) приходит через конструктор\n * класса и захватывается замыканием.\n */\nexport interface EffectCtx<TDispatcher, TExternalDispatchers = Record<string, never>> {\n  /** Инстанс нашего class-диспетчера: `ofType(d.loadPosts)` + `d.applyPosts(...)`. */\n  dispatcher: TDispatcher\n  /** Внешние диспетчеры (их экшены уже влиты в общий `action$`). */\n  external: TExternalDispatchers\n}\n\n/** Рецепт эффекта: отложенная функция, вызываемая один раз при `EffectsModule.start()`. */\nexport type EffectRecipe<TState, TDispatcher, TExternalDispatchers> = (\n  action$: Observable<Action>,\n  state$: Observable<TState>,\n  ctx: EffectCtx<TDispatcher, TExternalDispatchers>,\n) => Observable<unknown>\n\n/**\n * Публичный class-based слой эффектов. Эффекты объявляются как поля класса через\n * `this.effect(fn)`. Сервисы и внешние сторы передаются через конструктор и\n * захватываются в замыкание рецепта (`this.api`, `this.core$`).\n *\n * @example\n * ```ts\n * class PostsEffects extends Effects<PostsState, PostsDispatcher> {\n *   constructor(private readonly api: PostsEndpoints, private readonly core$: Observable<CoreState>) {\n *     super()\n *   }\n *\n *   readonly loadPosts = this.effect((action$, state$, { dispatcher: d }) =>\n *     action$.pipe(ofType(d.loadPosts), validateMap({ apiCall: () => fromRequest(this.api.getPosts.request()) })))\n *\n *   override onDestroy() { this.socket.disconnect() }\n * }\n * ```\n *\n * **Правило**: сервисы из конструктора (`this.api`) можно *захватывать в замыкание*\n * рецепта, но не дереференсить прямо в инициализаторе поля — parameter properties\n * присваиваются ПОСЛЕ инициализаторов полей derived-класса.\n */\nexport abstract class Effects<TState extends Record<string, any>, TDispatcher, TExternalDispatchers extends Record<string, Dispatcher<any>> = Record<string, never>> {\n  /** Реестр module-совместимых эффектов в порядке объявления полей. */\n  readonly #effects: Effect[] = []\n\n  /**\n   * Регистрирует рецепт эффекта. Сам рецепт НЕ вызывается при конструировании — он\n   * вызывается лениво при `EffectsModule.start()` с реальными потоками. Возвращает тот\n   * же `fn`, так что поле остаётся вызываемым рецептом (удобно для юнит-тестов в изоляции).\n   *\n   * @param fn рецепт `(action$, state$, ctx) => Observable`\n   * @param options опции эффекта (например, `resubscribeOnError`)\n   */\n  protected effect(fn: EffectRecipe<TState, TDispatcher, TExternalDispatchers>, options?: EffectOptions): EffectRecipe<TState, TDispatcher, TExternalDispatchers> {\n    // Module-совместимая обёртка: широкий контекст EffectsModule → узкий EffectCtx рецепта.\n    const moduleEffect: Effect<TState, TDispatcher> = (action$, state$, context) =>\n      fn(action$, state$, {\n        dispatcher: context.dispatcher,\n        external: context.externalDispatchers as unknown as TExternalDispatchers,\n      })\n\n    if (options) {\n      ;(moduleEffect as { [EFFECT_OPTIONS]?: EffectOptions })[EFFECT_OPTIONS] = options\n    }\n    this.#effects.push(moduleEffect)\n\n    // Маркируем сам рецепт, чтобы dev-проверка не приняла его за «забытый эффект».\n    ;(fn as { [EFFECT_MARKER]?: true })[EFFECT_MARKER] = true\n    return fn\n  }\n\n  /**\n   * Список module-совместимых эффектов в порядке объявления полей. Сборщик скармливает\n   * его в `effectsModule.addEffects(...)`.\n   *\n   * Попутно (вне production) предупреждает о полях-функциях, не обёрнутых в `this.effect`.\n   * @internal\n   */\n  getEffects(): Effect[] {\n    // Имена полей-рецептов идут в порядке объявления — ровно как и #effects (каждый\n    // this.effect() пушит в #effects и помечает свой fn). Зипуем их, чтобы EffectsModule\n    // мог назвать упавший эффект по имени поля, а не по индексу.\n    const recipeNames: string[] = []\n    for (const [name, value] of Object.entries(this)) {\n      if (typeof value === 'function' && (value as { [EFFECT_MARKER]?: true })[EFFECT_MARKER]) {\n        recipeNames.push(name)\n      } else if (process.env.NODE_ENV !== 'production' && typeof value === 'function' && !RESERVED_NAMES.has(name)) {\n        logError(\n          `Effects: поле \"${name}\" — функция, но не обёрнута в this.effect(...). Эффекты регистрируются только через this.effect, иначе они молча не запустятся.`,\n          value,\n          null,\n          'warn',\n        )\n      }\n    }\n\n    this.#effects.forEach((moduleEffect, i) => {\n      const name = recipeNames[i]\n      if (name) (moduleEffect as { [EFFECT_NAME]?: string })[EFFECT_NAME] = name\n    })\n\n    return this.#effects\n  }\n\n  /** Опциональный teardown (закрыть сокет и т.п.) — вызывается сборщиком при `synapse.destroy()`. */\n  onDestroy?(): void | Promise<void>\n}\n"],"names":["logError","EFFECT_NAME","EFFECT_OPTIONS","EFFECT_MARKER","Symbol","RESERVED_NAMES","Set","Effects","fn","options","moduleEffect","action$","state$","context","recipeNames","name","value","Object","process","i"],"mappings":";;;;;AAE2D;AAGoC;AAE/F;;;;;CAKC,GACD,MAAMG,aAAaA,GAAGC,OAAO;AAE7B,sEAAsE,GACtE,MAAMC,cAAcA,GAAG,IAAIC,IAAI;IAAC;CAAY;AAqB5C;;;;;;;;;;;;;;;;;;;;;;CAsBC,GACM,MAAeC,OAAOA;IAC3B,mEAAmE,GAC1D,QAAQ,GAAa,EAAE;IAEhC;;;;;;;GAOC,GACS,OAAOC,EAA2D,EAAEC,OAAuB,EAA2D;QAC9J,wFAAwF;QACxF,MAAMC,eAA4C,CAACC,SAASC,QAAQC,UAClEL,GAAGG,SAASC,QAAQ;gBAClB,YAAYC,QAAQ,UAAU;gBAC9B,UAAUA,QAAQ,mBAAmB;YACvC;QAEF,IAAIJ,SAAS;;YACTC,YAAqD,CAACR,cAAcA,CAAC,GAAGO;QAC5E;QACA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAACC;QAGjBF,EAAiC,CAACL,aAAaA,CAAC,GAAG;QACrD,OAAOK;IACT;IAEA;;;;;;GAMC,GACD,aAAuB;QACrB,gFAAgF;QAChF,qFAAqF;QACrF,6DAA6D;QAC7D,MAAMM,cAAwB,EAAE;QAChC,KAAK,MAAM,CAACC,MAAMC,MAAM,IAAIC,OAAO,OAAO,CAAC,IAAI,EAAG;YAChD,IAAI,OAAOD,UAAU,cAAeA,KAAoC,CAACb,aAAaA,CAAC,EAAE;gBACvFW,YAAY,IAAI,CAACC;YACnB,OAAO,IAAIG,QAAQ,GAAG,CAAC,QAAQ,KAAK,gBAAgB,OAAOF,UAAU,cAAc,CAACX,cAAcA,CAAC,GAAG,CAACU,OAAO;gBAC5Gf,QAAQA,CACN,CAAC,eAAe,EAAEe,KAAK,+HAA+H,CAAC,EACvJC,OACA,MACA;YAEJ;QACF;QAEA,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAACN,cAAcS;YACnC,MAAMJ,OAAOD,WAAW,CAACK,EAAE;YAC3B,IAAIJ,MAAOL,YAA2C,CAACT,WAAWA,CAAC,GAAGc;QACxE;QAEA,OAAO,IAAI,CAAC,QAAQ;IACtB;AAIF"}