@fozy-labs/rx-toolkit 0.4.2 → 0.4.4

package/dist/query/core/Resource/ResourceRef.js

@@ -29,22 +29,6 @@ export class ResourceRef {
     unlockOne() {
         this._cacheItem = this._resource.decrementLock(this._args, { cache: this._cacheItem });
     }
-    update(updateFn) {
-        const cacheItem = this._cacheItem ?? this._resource.getQueryCache(this._args);
-        if (!cacheItem) {
-            console.warn('Trying to update non-existing cache item');
-            return {
-                rollback: () => { }
-            };
-        }
-        const value = cacheItem.value;
-        this._resource.updateData_legacy(this._args, updateFn, { cache: cacheItem });
-        return {
-            rollback: () => {
-                this._resource.updateData_legacy(this._args, () => value.data, { cache: cacheItem });
-            }
-        };
-    }
     patch(patchFn) {
         let isSkipped = true;
         const reapplyFn = (data, savedData, transactions) => {
@@ -56,12 +40,14 @@ export class ResourceRef {
             // Все pending - применяем и оставляем в очереди
             // Все commited (которые после pending) - применяем, но оставляем в очереди
             // Все aborted (которые после pending) - откатываем, но оставляем в очереди
+            // Если после aborted нет pending - пропускаем и убираем из очереди
             // Те после применения всех транзакций, очередь должна начинаться с первой pending транзакции (если есть), включая все, что после неё.
             let newSavedData = savedData ?? data;
             let currentData = savedData ?? data;
             const remainingTransactions = [];
             let foundPending = false;
-            transactions.forEach((transaction) => {
+            const lastPendingIndex = transactions.findLastIndex(t => t.status === 'pending');
+            transactions.forEach((transaction, index) => {
                 if (transaction.status === 'pending') {
                     foundPending = true;
                     // Применяем pending транзакцию и оставляем в очереди
@@ -76,9 +62,13 @@ export class ResourceRef {
                         remainingTransactions.push(transaction);
                     }
                     else if (transaction.status === 'aborted') {
-                        // Откатываем и оставляем в очереди
-                        currentData = applyPatches(currentData, transaction.inversePatches);
-                        remainingTransactions.push(transaction);
+                        // Проверяем, есть ли pending после текущей aborted
+                        const hasPendingAfter = index < lastPendingIndex;
+                        if (hasPendingAfter) {
+                            currentData = applyPatches(currentData, transaction.inversePatches);
+                            remainingTransactions.push(transaction);
+                        }
+                        // Если pending нет - пропускаем и убираем из очереди
                     }
                 }
                 else {

package/dist/query/index.d.ts

@@ -1,6 +1,5 @@
 export * from './api/createResource';
 export * from './api/createOperation';
-export * from './api/DefaultOptions';
 export * from './SKIP_TOKEN';
 export * from './react/useResourceAgent';
 export * from './react/useResourceRef';

package/dist/query/index.js

@@ -1,6 +1,5 @@
 export * from './api/createResource';
 export * from './api/createOperation';
-export * from './api/DefaultOptions';
 export * from './SKIP_TOKEN';
 export * from './react/useResourceAgent';
 export * from './react/useResourceRef';

package/dist/query/lib/IndirectMap.js

@@ -1,4 +1,4 @@
-import { shallowEqual } from "../../query/lib/shallowEqual";
+import { shallowEqual } from "./shallowEqual";
 export class IndirectMap {
     _compareObjectsFn;
     _compareCache = new WeakMap();

package/dist/query/lib/ReactiveCache.d.ts

@@ -1,4 +1,5 @@
 import { Observable, Subject } from "rxjs";
+import { ReadableSignalLike } from "../../signals";
 type Options<VALUE> = {
     /**
      * Начальное состояние кэша
@@ -6,9 +7,11 @@ type Options<VALUE> = {
     initialState: VALUE;
     /**
      * Время жизни кэша в миллисекундах (пока нет подписок на кеш)
+     * Если указано `false`, кэш не будет очищаться автоматически.
+     * Если указано `0` или меньше, кэш будет очищаться сразу после отписки от него.
      * @default 60_000 (1 минута)
      */
-    cacheLifeTime?: number;
+    cacheLifeTime?: number | false;
 };
 /**
  * Класс `ReactiveCache` представляет собой реактивный кэш,
@@ -17,26 +20,15 @@ type Options<VALUE> = {
  * @template VALUE Тип значения, хранимого в кэше.
  */
 export declare class ReactiveCache<VALUE> {
-    /**
-     * Время жизни кэша в миллисекундах.
-     * Если значение больше 0, то кэш очищается через указанное время после отписки.
-     * @private
-     */
-    private readonly _cacheLifeTime;
     /**
      * Внутренний `BehaviorSubject`, хранящий текущее состояние кэша.
      * @private
      */
     private _state$;
-    /**
-     * Текущее значение.
-     * @private
-     */
-    private _value;
     /**
      * Реактивное значене (Observable)
      */
-    value$: Observable<VALUE>;
+    value$: ReadableSignalLike<VALUE>;
     /**
      * Значение без сайд-эффектов (для использования в DevTools)
      */
@@ -53,16 +45,8 @@ export declare class ReactiveCache<VALUE> {
      * @param options.cacheLifeTime Время жизни кэша в миллисекундах (по умолчанию 60_000).
      */
     constructor(options: Options<VALUE>);
-    /**
-     * Возвращает текущее значение кэша.
-     * @returns {VALUE} Текущее значение кэша.
-     */
+    private _getOnRefCountZero;
     get value(): VALUE;
-    /**
-     * Возвращает текущее значение кэша.
-     * @returns {VALUE} Текущее значение кэша.
-     */
-    peek(): VALUE;
     /**
      * Устанавливает новое значение в кэш и обновляет поток состояния.
      *

package/dist/query/lib/ReactiveCache.js

@@ -1,5 +1,5 @@
-import { finalize, ReplaySubject, share, Subject, takeUntil, timer } from "rxjs";
-import { Signal } from "../../signals";
+import { BehaviorSubject, finalize, ReplaySubject, share, Subject, takeUntil, timer } from "rxjs";
+import { signalize } from "../../signals";
 /**
  * Класс `ReactiveCache` представляет собой реактивный кэш,
  * который позволяет управлять состоянием и временем жизни кэшированных данных.
@@ -7,22 +7,11 @@ import { Signal } from "../../signals";
  * @template VALUE Тип значения, хранимого в кэше.
  */
 export class ReactiveCache {
-    /**
-     * Время жизни кэша в миллисекундах.
-     * Если значение больше 0, то кэш очищается через указанное время после отписки.
-     * @private
-     */
-    _cacheLifeTime;
     /**
      * Внутренний `BehaviorSubject`, хранящий текущее состояние кэша.
      * @private
      */
     _state$;
-    /**
-     * Текущее значение.
-     * @private
-     */
-    _value;
     /**
      * Реактивное значене (Observable)
      */
@@ -43,46 +32,37 @@ export class ReactiveCache {
      * @param options.cacheLifeTime Время жизни кэша в миллисекундах (по умолчанию 60_000).
      */
     constructor(options) {
-        this._cacheLifeTime = options.cacheLifeTime || 60_000;
-        this._state$ = new Signal(options.initialState, { disableDevtools: true });
-        this._value = options.initialState;
+        const cacheLifeTime = options.cacheLifeTime ?? 60_000;
+        this._state$ = new BehaviorSubject(options.initialState);
         this.spy$ = this._state$.pipe(takeUntil(this.onClean$));
-        this.value$ = this._state$.pipe(finalize(() => {
+        this.value$ = signalize(this._state$.pipe(finalize(() => {
             this.complete();
         }), share({
             connector: () => new ReplaySubject(1),
-            /**
-             * Если lifetime больше 0,
-             * то очистим кэш значения по истечении этого времени,
-             * иначе очищаем сразу после отписки.
-             */
-            resetOnRefCountZero: this._cacheLifeTime > 0
-                ? () => timer(this._cacheLifeTime)
-                : true,
+            resetOnRefCountZero: this._getOnRefCountZero(cacheLifeTime),
             resetOnComplete: true,
-        }));
+        })));
+    }
+    _getOnRefCountZero(cacheLifeTime) {
+        if (cacheLifeTime === false) {
+            return false;
+        }
+        if (cacheLifeTime <= 0) {
+            return true;
+        }
+        return () => {
+            return timer(cacheLifeTime);
+        };
     }
-    /**
-     * Возвращает текущее значение кэша.
-     * @returns {VALUE} Текущее значение кэша.
-     */
     get value() {
         return this._state$.value;
     }
-    /**
-     * Возвращает текущее значение кэша.
-     * @returns {VALUE} Текущее значение кэша.
-     */
-    peek() {
-        return this._value;
-    }
     /**
      * Устанавливает новое значение в кэш и обновляет поток состояния.
      *
      * @param value Новое значение для кэша.
      */
     next(value) {
-        this._value = value;
         this._state$.next(value);
     }
     /**
@@ -90,7 +70,7 @@ export class ReactiveCache {
      */
     complete() {
         this._state$.complete();
-        this.onClean$.next(this._value);
+        this.onClean$.next(this._state$.value);
         this.onClean$.complete();
     }
 }

package/dist/query/react/useOperationAgent.d.ts

@@ -1,5 +1,4 @@
-import { OperationAgentInstanse, OperationDefinition, OperationQueryState } from "../types/Operation.types";
-import { Prettify } from "../types/shared.types";
+import type { Prettify, OperationAgentInstanse, OperationDefinition, OperationQueryState } from "../../query/types";
 type WithAgent<D extends OperationDefinition> = {
     createAgent: () => OperationAgentInstanse<D>;
 };

package/dist/query/react/useOperationAgent.js

@@ -1,4 +1,5 @@
-import { useConstant, useEventHandler, useSignal } from "../../react-hooks";
+import { useConstant, useEventHandler } from "../../common/react";
+import { useSignal } from "../../signals/react";
 export function useOperationAgent(op) {
     const agent = useConstant(() => op.createAgent());
     const state = useSignal(agent.state$);

package/dist/query/react/useResourceAgent.d.ts

@@ -1,9 +1,5 @@
-import { ResourceAgentInstance, ResourceDefinition, ResourceQueryState } from "../types/Resource.types";
-import { Prettify } from "../types/shared.types";
-import { SKIP } from "../SKIP_TOKEN";
-type WithAgent<D extends ResourceDefinition> = {
-    createAgent: () => ResourceAgentInstance<D>;
-};
+import { Prettify, ResourceDefinition, ResourceInstance, ResourceQueryState } from "../../query/types";
+import { SKIP } from "../../query/SKIP_TOKEN";
 type Result<D extends ResourceDefinition> = Prettify<ResourceQueryState<D>>;
-export declare function useResourceAgent<D extends ResourceDefinition>(res: WithAgent<D>, ...argss: D['Args'] extends void ? [] | [typeof SKIP] : [D['Args'] | typeof SKIP]): Result<D>;
+export declare function useResourceAgent<D extends ResourceDefinition>(res: ResourceInstance<D>, ...argss: D['Args'] extends void ? [] | [typeof SKIP] : [D['Args'] | typeof SKIP]): Result<D>;
 export {};

package/dist/query/react/useResourceAgent.js

@@ -1,7 +1,8 @@
 import React from "react";
-import { useConstant, useSignal } from "../../react-hooks";
-import { shallowEqual } from "../lib/shallowEqual";
-import { SKIP } from "../SKIP_TOKEN";
+import { useConstant } from "../../common/react";
+import { useSignal } from "../../signals/react";
+import { shallowEqual } from "../../query/lib/shallowEqual";
+import { SKIP } from "../../query/SKIP_TOKEN";
 export function useResourceAgent(res, ...argss) {
     const args = (argss[0] === SKIP ? SKIP : argss[0]);
     const agent = useConstant(() => {
@@ -21,5 +22,8 @@ export function useResourceAgent(res, ...argss) {
         }
         agent.initiate(args);
     }, [args]);
+    React.useEffect(() => () => {
+        agent.complete();
+    }, []);
     return useSignal(agent.state$);
 }

package/dist/query/react/useResourceRef.d.ts

@@ -1,6 +1,5 @@
 import { SKIP } from "../../query/SKIP_TOKEN";
-import { ResourceDefinition, ResourceInstance, ResourceRefInstanse } from "../../query/types/Resource.types";
-import { Prettify } from "../../query/types/shared.types";
+import type { Prettify, ResourceDefinition, ResourceInstance, ResourceRefInstanse } from "../../query/types";
 type Result<D extends ResourceDefinition> = Prettify<ResourceRefInstanse<D>> | null;
 export declare function useResourceRef<D extends ResourceDefinition>(res: ResourceInstance<D>, ...argss: D['Args'] extends void ? [] | [typeof SKIP] : [D['Args'] | typeof SKIP]): Result<D>;
 export {};

package/dist/query/react/useResourceRef.js

@@ -1,5 +1,5 @@
-import { SKIP } from "../../query/SKIP_TOKEN";
 import React from "react";
+import { SKIP } from "../../query/SKIP_TOKEN";
 export function useResourceRef(res, ...argss) {
     const args = (argss[0] === SKIP ? SKIP : argss[0]);
     return React.useMemo(() => {

package/dist/query/types/Operation.types.d.ts

@@ -1,5 +1,5 @@
 import { ReadableSignalLike } from "../../signals";
-import { FallbackOnNever } from "../../query/types/shared.types";
+import { FallbackOnNever } from "./shared.types";
 import { ResourceDefinition, ResourceInstance } from "./Resource.types";
 /**
  * Функция создания операции

package/dist/query/types/Resource.types.d.ts

@@ -1,6 +1,6 @@
-import { ReadableSignalLike } from "../../signals";
-import { FallbackOnNever } from "../../query/types/shared.types";
 import { Patch as ImmerPatch } from "immer";
+import { ReadableSignalLike } from "../../signals";
+import { FallbackOnNever } from "./shared.types";
 /**
  * Функция создания ресурса
  */
@@ -13,6 +13,31 @@ export type ResourceCreateOptions<D extends ResourceDefinition> = {
     select?: (data: D["Result"]) => D["Selected"];
     /** Функция запроса данных */
     queryFn: (args: D["Args"], tools: ResourceQueryFnTools) => Promise<D["Result"]>;
+    /**
+     * Время жизни кеша в миллисекундах. По умолчанию 60_000 (1 минута).
+     * Если указано false - кеш не удаляется автоматически.
+     */
+    cacheLifetime?: number | false;
+    onCacheEntryAdded?: (args: D["Args"], tools: CacheEntryAddedTools<D>) => void;
+    onQueryStarted?: (args: D["Args"], tools: QueryStartedTools<D>) => void;
+};
+export type CacheEntryAddedTools<D extends ResourceDefinition> = {
+    /** Функция для ожидания загрузки данных в кеш */
+    $cacheDataLoaded: Promise<void>;
+    /** Функция для ожидания удаления кеша */
+    $cacheEntryRemoved: Promise<void>;
+};
+export type QueryStartedTools<D extends ResourceDefinition> = {
+    /** Функция для уведомления об успешном завершении запроса */
+    $queryFulfilled: Promise<{
+        data: D["Result"];
+        error: undefined;
+        isError: false;
+    } | {
+        data: undefined;
+        error: unknown;
+        isError: true;
+    }>;
 };
 /**
  * Определение типов ресурса
@@ -45,8 +70,8 @@ export type ResourceAgentInstance<D extends ResourceDefinition> = {
     state$: ReadableSignalLike<ResourceQueryState<D>>;
     /** Инициирует запрос с указанными аргументами */
     initiate(args: D["Args"], force?: boolean): void;
-    /** Создает новый агент */
-    createAgent(): ResourceAgentInstance<D>;
+    /** Завершает работу агента, позволяя освободить ресурсы */
+    complete(): void;
 };
 /**
  * Состояние запроса ресурса
@@ -93,12 +118,6 @@ export type ResourceRefInstanse<D extends ResourceDefinition> = {
         unlock: () => void;
     };
     unlockOne(): void;
-    /**
-     * @deprecated
-     */
-    update(updateFn: (data: D['Data']) => D['Data']): {
-        rollback: () => void;
-    };
     patch(patchFn: (data: D['Data']) => void): ResourceTransaction | null;
     invalidate(): void;
     create(data: D['Data']): void;

package/dist/query/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Operation.types';
+export * from './Resource.types';
+export * from './shared.types';

package/dist/query/types/index.js

@@ -0,0 +1,3 @@
+export * from './Operation.types';
+export * from './Resource.types';
+export * from './shared.types';

package/dist/signals/base/Computed.js

@@ -20,8 +20,7 @@ export class Computed extends Signal {
         this._effect = effect;
     }
     unsubscribe() {
-        this._effect.unsubscribe();
-        super.unsubscribe();
+        this.complete();
     }
     complete() {
         this._effect.unsubscribe();

package/dist/signals/base/Effect.js

@@ -11,10 +11,10 @@ export class Effect {
      * Выполняет функцию в tracked-контексте, подписываясь на Tracker.
      */
     _runInTrackedContext(effectFn, isAsyncRun = false) {
-        // Отписываемся от предыдущих подписок
+        let prevSubscriptions;
         if (!isAsyncRun) {
             this._rang = 0;
-            this._subscriptions.forEach((sub) => sub.unsubscribe());
+            prevSubscriptions = this._subscriptions;
             this._subscriptions = [];
         }
         let isTrackedContext = true;
@@ -43,6 +43,7 @@ export class Effect {
         trackerSub.unsubscribe();
         isTrackedContext = false;
         scheduler = Batcher.scheduler(this._rang);
+        prevSubscriptions?.forEach((sub) => sub.unsubscribe());
     }
     unsubscribe() {
         this.closed = true;

package/dist/signals/base/ReadonlySignal.d.ts

@@ -1,9 +1,8 @@
 import { Observable, Subscriber, TeardownLogic } from "rxjs";
-import { SyncObservable } from "./SyncObservable";
 import type { ReadableSignalLike } from "./types";
+import { SyncObservable } from "./SyncObservable";
 export declare class ReadonlySignal<T> extends SyncObservable<T> implements ReadableSignalLike<T> {
-    private readonly _devtools;
-    private static _logIdIndex;
+    protected rang: number;
     constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic);
     get value(): T;
     peek(): T;

package/dist/signals/base/ReadonlySignal.js

@@ -1,21 +1,12 @@
-import { SharedOptions } from "../../query/core/SharedOptions";
 import { SyncObservable } from "./SyncObservable";
 import { Tracker } from "./Tracker";
 export class ReadonlySignal extends SyncObservable {
-    _devtools;
-    static _logIdIndex = 0;
+    rang = 0;
     constructor(subscribe) {
         super(subscribe);
-        const stateDevtools = SharedOptions.DEVTOOLS?.state;
-        if (stateDevtools) {
-            const id = ReadonlySignal._logIdIndex++;
-            const key = `ReadonlySignal:i=${id}`;
-            const initialValue = this.peek();
-            this._devtools = stateDevtools(key, initialValue);
-        }
     }
     get value() {
-        Tracker.next_legacy(this);
+        Tracker.next(this.rang, this);
         return super.value;
     }
     peek() {

package/dist/signals/base/Signal.d.ts

@@ -1,10 +1,10 @@
 import { BehaviorSubject, Observable } from "rxjs";
-import { type ReadableSignalLike, UnaryFunction } from "./types";
+import type { ReadableSignalLike, SignalLike, UnaryFunction } from "./types";
 type SignalOptions = {
     disableDevtools?: boolean;
     devtoolsName?: string;
 };
-export declare class Signal<T> extends BehaviorSubject<T> implements ReadableSignalLike<T> {
+export declare class Signal<T> extends BehaviorSubject<T> implements SignalLike<T> {
     private readonly _devtools;
     protected _rang: number;
     constructor(initialValue: T, options?: SignalOptions);

package/dist/signals/base/Signal.js

@@ -1,5 +1,5 @@
-import { SharedOptions } from "../../query/core/SharedOptions";
 import { BehaviorSubject } from "rxjs";
+import { SharedOptions } from "../../common/options/SharedOptions";
 import { Batcher } from "./Batcher";
 import { Indexer } from "./Indexer";
 import { Tracker } from "./Tracker";

package/dist/signals/base/Tracker.d.ts

@@ -4,10 +4,6 @@ type TrackedValue = {
     obsv$: Observable<unknown>;
 };
 export declare const Tracker: {
-    /** @deprecated */
-    tracked_legacy$: Subject<Observable<unknown>>;
-    /** @deprecated */
-    next_legacy(value: Observable<unknown>): void;
     tracked$: Subject<TrackedValue>;
     next(rang: number, observable: Observable<unknown>): void;
 };

package/dist/signals/base/Tracker.js

@@ -1,11 +1,5 @@
 import { Subject } from "rxjs";
 export const Tracker = {
-    /** @deprecated */
-    tracked_legacy$: new Subject(),
-    /** @deprecated */
-    next_legacy(value) {
-        Tracker.tracked_legacy$.next(value);
-    },
     tracked$: new Subject(),
     next(rang, observable) {
         Tracker.tracked$.next({ rang, obsv$: observable, });

package/dist/signals/base/types.d.ts

@@ -7,6 +7,15 @@ export interface ReadableSignalLike<T = unknown> extends Observable<T> {
      */
     get(): T;
 }
+export interface SignalLike<T = unknown> extends ReadableSignalLike<T> {
+    set value(value: T);
+    next(value: T): void;
+    asReadonly(): ReadableSignalLike<T>;
+    /**
+     * @deprecated use `value` instead.
+     */
+    set(value: T): void;
+}
 export interface UnaryFunction<T, R> {
     (source: T): R;
 }

package/dist/signals/index.d.ts

@@ -1,3 +1,4 @@
 export * from './base';
 export * from './extends';
 export * from './operators';
+export * from './react';

package/dist/signals/index.js

@@ -1,3 +1,4 @@
 export * from './base';
 export * from './extends';
 export * from './operators';
+export * from './react';

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

@@ -0,0 +1 @@
+export * from './useSignal';

package/dist/signals/react/index.js

@@ -0,0 +1 @@
+export * from './useSignal';

package/dist/{react-hooks → signals/react}/useSignal.d.ts

@@ -1,2 +1,2 @@
-import { ReadableSignalLike } from "../signals";
+import { ReadableSignalLike } from "../../signals";
 export declare function useSignal<T>(signal$: ReadableSignalLike<T>): T;

package/dist/{react-hooks → signals/react}/useSignal.js

@@ -1,5 +1,5 @@
 import React from "react";
-import { useEventHandler } from "../react-hooks";
+import { useEventHandler } from "../../common/react";
 export function useSignal(signal$) {
     const subscribe = React.useCallback((update) => {
         const subscription = signal$.subscribe(update);

package/docs/signals/README.md

@@ -17,7 +17,7 @@ const age = new Signal(25);
 // Подписка на изменения
 const subscription = name.subscribe(newName => {
   console.log(`Name changed to: ${newName}`);
-});
+}); // Выведет: "Name changed to: John" при инициализации
 
 name.value = 'Jane'; // Выведет: "Name changed to: Jane"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fozy-labs/rx-toolkit",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "type": "module",

package/dist/devtools/reduxDevtools.d.ts

@@ -1,2 +0,0 @@
-import { DevtoolsLike } from "../query/types/devtools";
-export declare function reduxDevtools(): DevtoolsLike;

package/dist/query/api/createSubResource.js

@@ -1 +0,0 @@
-"use strict";