@fozy-labs/rx-toolkit 0.5.4 → 0.6.0

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

@@ -1,110 +0,0 @@
-import { Computed, Signal } from "../../../signals";
-export class ResourceAgent {
-    _resource;
-    _resources$ = Signal.state({
-        previous$: null,
-        current$: null,
-    }, { isDisabled: true });
-    state$ = Computed.create(() => {
-        const resources = this._resources$.get();
-        let prevState;
-        const currState = resources.current$?.value$.get();
-        // Отлавливаем кейс, когда ресурс был спрошен.
-        // На данные момент единсвенная причина сброса - resetAllQueriesCache(),
-        //  но в будущем могут быть и другие причины, что потребует доработку.
-        if (currState && !currState.isInitiated) {
-            this._resource.initiate(currState.args, { cache: resources.current$ });
-            return {
-                isInitiated: true,
-                isLoading: true,
-                isInitialLoading: true,
-                isDone: false,
-                isSuccess: false,
-                isError: false,
-                isReloading: false,
-                error: undefined,
-                data: undefined,
-                // TODO вообще нет точного представлния, как блокировака доложна работать.
-                //  Мб тут стоит брать currState.isLocked.
-                isLocked: false,
-                args: currState.args,
-            };
-        }
-        if (!currState?.isDone) {
-            prevState = resources.previous$?.value;
-        }
-        // Нет текущего состояния — дефолт
-        if (!currState) {
-            return {
-                isInitiated: false,
-                isLoading: false,
-                isInitialLoading: false,
-                isDone: false,
-                isSuccess: false,
-                isError: false,
-                isLocked: false,
-                isReloading: false,
-                error: undefined,
-                data: undefined,
-                args: undefined,
-            };
-        }
-        // Если идёт загрузка, но есть успешные данные из прошлого запроса — показываем их
-        const isShowPrev = currState.isLoading && prevState && prevState.isSuccess;
-        return {
-            isInitiated: currState.isInitiated || !!prevState,
-            isLoading: currState.isLoading,
-            isInitialLoading: currState.isLoading && !currState.isDone && !prevState?.isDone,
-            isDone: currState.isDone,
-            isSuccess: currState.isSuccess,
-            isError: currState.isError,
-            isLocked: currState.isLocked,
-            isReloading: currState.isReloading,
-            error: isShowPrev ? (prevState.error ?? undefined) : (currState.error ?? undefined),
-            data: isShowPrev ? (prevState.data ?? undefined) : (currState.data ?? undefined),
-            args: currState.args ?? undefined,
-        };
-    }, { isDisabled: true });
-    constructor(_resource) {
-        this._resource = _resource;
-    }
-    initiate(args, force = false) {
-        const current = this._resources$.peek().current$;
-        const cache = this._resource.getQueryCache(args);
-        if (!cache) {
-            const newCache = this._resource.initiate(args);
-            this._next(newCache);
-            return;
-        }
-        if (force || !(cache.value.isDone || cache.value.isLoading)) {
-            this._resource.initiate(args, { cache });
-        }
-        if (current !== cache) {
-            this._next(cache);
-        }
-    }
-    compareArgs(args, otherArgs) {
-        return this._resource.compareArgs(args, otherArgs);
-    }
-    _next(newCache) {
-        const { previous$, current$ } = this._resources$.peek();
-        if (!current$) {
-            this._resources$.set({
-                previous$: null,
-                current$: newCache,
-            });
-            return;
-        }
-        if (!current$.value$.peek().isDone && previous$?.value$.peek().isDone) {
-            this._resources$.set({
-                previous$: previous$,
-                current$: newCache,
-            });
-            return;
-        }
-        this._resources$.set({
-            previous$: current$,
-            current$: newCache,
-        });
-    }
-}

package/dist/query/core/Resource/ResourceDuplicator.d.ts

@@ -1,73 +0,0 @@
-import { Observable, Subject } from "rxjs";
-import { ResourceDefinition } from "../../../query/types";
-import { ReadableSignalLike } from "../../../signals/types";
-import { CoreResourceQueryState, Resource } from "./Resource";
-import { ResourceDuplicatorAgent } from "./ResourceDuplicatorAgent";
-export type DuplicatorOptions<D extends DuplicatorDefinition> = {
-    resource: Resource<D["RESOURCE_DEFINITION"]>;
-    getArgKey: (item: D["ARGS_ITEM"]) => string | number;
-    getDataKey: (item: D["DATA_ITEM"]) => string | number;
-    cacheLifetime?: number | false;
-};
-export type DuplicatorDefinition<D extends ResourceDefinition = ResourceDefinition> = {
-    ARGS_ITEM: D["Args"] extends Array<any> ? D["Args"][number] : never;
-    DATA_ITEM: D["Data"] extends Array<any> ? D["Data"][number] : never;
-    RESOURCE_DEFINITION: D;
-};
-type State<D extends DuplicatorDefinition> = CoreResourceQueryState<D["RESOURCE_DEFINITION"]> & {
-    unreleasedArgs?: D["ARGS_ITEM"][];
-};
-type Cache<D extends DuplicatorDefinition> = ComputedReactiveCache<State<D>>;
-export type CoreResourceDuplicatorCache<D extends DuplicatorDefinition> = Cache<D>;
-export declare class ResourceDuplicator<D extends DuplicatorDefinition> {
-    private _options;
-    private _fis;
-    private _caches;
-    private get _resource();
-    constructor(_options: DuplicatorOptions<D>);
-    getQueryCache(args: D["ARGS_ITEM"][]): Cache<D> | undefined;
-    createCache(args: D["ARGS_ITEM"][]): Cache<D>;
-    initiate(args: D["ARGS_ITEM"][], cache?: Cache<D>): Cache<D>;
-    serialize(args: D["ARGS_ITEM"][]): string;
-    compareArgs(a: D["ARGS_ITEM"][], b: D["ARGS_ITEM"][]): boolean;
-    createAgent: () => ResourceDuplicatorAgent<D>;
-    /** @deprecated */
-    d_init(args: D["ARGS_ITEM"][]): {
-        value$: import("../../../signals").ComputeFn<State<D>>;
-    };
-}
-export declare class ComputedReactiveCache<T> {
-    /**
-     * Реактивное значене (Observable)
-     */
-    value$: ReadableSignalLike<T>;
-    /**
-     * Значение без сайд-эффектов (для использования в DevTools)
-     */
-    spy$: Observable<T>;
-    /**
-     * Subject, уведомляющий об очистке кэша.
-     */
-    onClean$: Subject<T>;
-    closed: boolean;
-    private _getValue;
-    /**
-     * Создает новый экземпляр `ReactiveCacheItem`.
-     *
-     * @param options Параметры для настройки элемента кэша.
-     * @param options.initialState Начальное состояние кэша.
-     * @param options.cacheLifeTime Время жизни кэша в миллисекундах (по умолчанию 60_000).
-     */
-    constructor(options: {
-        obs: Observable<T>;
-        getValue: () => T;
-        cacheLifeTime: number | false;
-    });
-    private _getOnRefCountZero;
-    get value(): T;
-    /**
-     * Завершает работу кэша, закрывая все потоки и уведомляя об очистке.
-     */
-    complete(): void;
-}
-export {};

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

@@ -1,227 +0,0 @@
-import { finalize, ReplaySubject, share, Subject, takeUntil, timer } from "rxjs";
-import { Signal, signalize } from "../../../signals";
-import { ResourceDuplicatorAgent } from "./ResourceDuplicatorAgent";
-export class ResourceDuplicator {
-    _options;
-    _fis = new Map();
-    _caches;
-    get _resource() {
-        return this._options.resource;
-    }
-    constructor(_options) {
-        this._options = _options;
-        this._caches = new Map();
-    }
-    getQueryCache(args) {
-        const key = this.serialize(args);
-        return this._caches.get(key);
-    }
-    createCache(args) {
-        const key = this.serialize(args);
-        const { value$ } = this.d_init(args);
-        const cache = new ComputedReactiveCache({
-            cacheLifeTime: this._options.cacheLifetime ?? 60_000,
-            getValue: () => value$.get(),
-            obs: value$.obs,
-        });
-        cache.onClean$.subscribe(() => {
-            args.forEach((arg) => {
-                const argKey = this._options.getArgKey(arg);
-                const fi = this._fis.get(argKey);
-                if (!fi)
-                    return;
-                fi.k--;
-                if (fi.k <= 0) {
-                    this._fis.delete(argKey);
-                }
-            });
-            this._caches.delete(key);
-        });
-        this._caches.set(key, cache);
-        return cache;
-    }
-    initiate(args, cache) {
-        const cacheInstance = cache ?? this.getQueryCache(args) ?? this.createCache(args);
-        const unreleasedArgs = cacheInstance.value.unreleasedArgs;
-        if (unreleasedArgs && unreleasedArgs.length !== 0) {
-            this._resource.initiate(unreleasedArgs);
-        }
-        const uninitiatedCaches = new Set();
-        args.forEach((arg) => {
-            const argKey = this._options.getArgKey(arg);
-            const fi = this._fis.get(argKey);
-            if (fi && !fi.cache.value.isInitiated) {
-                uninitiatedCaches.add(fi.cache);
-            }
-        });
-        uninitiatedCaches.forEach((c) => {
-            this._resource.initiate(c.value.args, { cache: c });
-        });
-        return cacheInstance;
-    }
-    serialize(args) {
-        if (!args)
-            return "";
-        const argsKeys = args.map((a) => this._options.getArgKey(a));
-        return argsKeys.join("|");
-    }
-    compareArgs(a, b) {
-        return this.serialize(a) === this.serialize(b);
-    }
-    createAgent = () => {
-        return new ResourceDuplicatorAgent(this);
-    };
-    /** @deprecated */
-    d_init(args) {
-        const argsKeys = args.map((a) => this._options.getArgKey(a));
-        const releasedCaches = new Set();
-        const unreleasedArgs = [];
-        args.forEach((arg) => {
-            const argKey = this._options.getArgKey(arg);
-            const fi = this._fis.get(argKey);
-            if (!fi || !fi.cache.value.isInitiated) {
-                unreleasedArgs.push(arg);
-                return;
-            }
-            fi.k++;
-            releasedCaches.add(fi.cache);
-        });
-        const queryCache = unreleasedArgs?.length > 0 ? this._resource.createQueryCache(unreleasedArgs) : null;
-        unreleasedArgs.forEach((arg) => {
-            const argKey = this._options.getArgKey(arg);
-            let fi = this._fis.get(argKey);
-            if (!fi) {
-                fi = {
-                    k: 1,
-                    cache: queryCache,
-                };
-                this._fis.set(argKey, fi);
-            }
-        });
-        return {
-            value$: Signal.compute(() => {
-                const itemsAcc = [];
-                if (queryCache) {
-                    itemsAcc.push(queryCache.value$.get());
-                }
-                for (const rc of releasedCaches) {
-                    itemsAcc.push(rc.value$.get());
-                }
-                const isNotInitiated = itemsAcc.some((i) => !i.isInitiated);
-                const baseReturn = {
-                    transactions: null,
-                    abortController: null,
-                    args,
-                    savedData: null,
-                    data: null,
-                    error: null,
-                    isError: false,
-                    isLoading: false,
-                    isReloading: false,
-                    isDone: false,
-                    isSuccess: false,
-                    isLocked: false,
-                    isInitiated: true,
-                    lockCount: 0,
-                    unreleasedArgs,
-                };
-                if (isNotInitiated)
-                    return {
-                        ...baseReturn,
-                        isInitiated: false,
-                    };
-                const isError = itemsAcc.some((i) => i.isError);
-                if (isError) {
-                    const firstError = itemsAcc.find((i) => i.isError);
-                    return {
-                        ...baseReturn,
-                        isError: true,
-                        isDone: true,
-                        error: firstError.error,
-                    };
-                }
-                const isLoading = itemsAcc.some((i) => i.isLoading);
-                if (isLoading)
-                    return {
-                        ...baseReturn,
-                        isLoading: true,
-                    };
-                const dataAcc = [];
-                itemsAcc.forEach((item) => {
-                    item.data?.forEach((d) => {
-                        const dataKey = this._options.getDataKey(d);
-                        const index = argsKeys.findIndex((ak) => ak === dataKey);
-                        if (index === -1)
-                            return;
-                        dataAcc[index] = d;
-                    });
-                });
-                return {
-                    ...baseReturn,
-                    isSuccess: true,
-                    isDone: true,
-                    data: dataAcc,
-                };
-            }, { isDisabled: true }),
-        };
-    }
-}
-export class ComputedReactiveCache {
-    /**
-     * Реактивное значене (Observable)
-     */
-    value$;
-    /**
-     * Значение без сайд-эффектов (для использования в DevTools)
-     */
-    spy$;
-    /**
-     * Subject, уведомляющий об очистке кэша.
-     */
-    onClean$ = new Subject();
-    closed = false;
-    _getValue;
-    /**
-     * Создает новый экземпляр `ReactiveCacheItem`.
-     *
-     * @param options Параметры для настройки элемента кэша.
-     * @param options.initialState Начальное состояние кэша.
-     * @param options.cacheLifeTime Время жизни кэша в миллисекундах (по умолчанию 60_000).
-     */
-    constructor(options) {
-        const cacheLifeTime = options.cacheLifeTime ?? 60_000;
-        this.spy$ = options.obs.pipe(takeUntil(this.onClean$));
-        this.value$ = signalize(options.obs.pipe(finalize(() => {
-            this.complete();
-        }), share({
-            connector: () => new ReplaySubject(1),
-            resetOnRefCountZero: this._getOnRefCountZero(cacheLifeTime),
-            resetOnComplete: true,
-        })));
-        this._getValue = options.getValue;
-    }
-    _getOnRefCountZero(cacheLifeTime) {
-        if (cacheLifeTime === false) {
-            return false;
-        }
-        if (cacheLifeTime <= 0) {
-            return true;
-        }
-        return () => {
-            return timer(cacheLifeTime);
-        };
-    }
-    get value() {
-        return this._getValue();
-    }
-    /**
-     * Завершает работу кэша, закрывая все потоки и уведомляя об очистке.
-     */
-    complete() {
-        if (this.closed)
-            return;
-        this.closed = true;
-        this.onClean$.next(this._getValue());
-        this.onClean$.complete();
-    }
-}

package/dist/query/core/Resource/ResourceDuplicatorAgent.d.ts

@@ -1,35 +0,0 @@
-import { DuplicatorDefinition, ResourceDuplicator } from "../../../query/core/Resource/ResourceDuplicator";
-import { ResourceAgentInstance } from "../../../query/types";
-export declare class ResourceDuplicatorAgent<D extends DuplicatorDefinition> implements ResourceAgentInstance<D["RESOURCE_DEFINITION"]> {
-    private _resource;
-    private _resources$;
-    state$: import("../../../signals").ComputeFn<{
-        isInitiated: boolean;
-        isLoading: boolean;
-        isInitialLoading: boolean;
-        isDone: boolean;
-        isSuccess: boolean;
-        isError: boolean;
-        isLocked: boolean;
-        isReloading: boolean;
-        error: undefined;
-        data: undefined;
-        args: D["ARGS_ITEM"][];
-    } | {
-        isInitiated: boolean;
-        isLoading: boolean;
-        isInitialLoading: boolean;
-        isDone: boolean;
-        isSuccess: boolean;
-        isError: boolean;
-        isLocked: boolean;
-        isReloading: boolean;
-        error: {} | undefined;
-        data: NonNullable<D["RESOURCE_DEFINITION"]["Data"]> | undefined;
-        args: NonNullable<D["RESOURCE_DEFINITION"]["Args"]> | undefined;
-    }>;
-    constructor(_resource: ResourceDuplicator<D>);
-    initiate(args: D["ARGS_ITEM"][], force?: boolean): void;
-    compareArgs(args: D["ARGS_ITEM"][], otherArgs: D["ARGS_ITEM"][]): boolean;
-    private _next;
-}

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

@@ -1,110 +0,0 @@
-import { Computed, Signal } from "../../../signals";
-export class ResourceDuplicatorAgent {
-    _resource;
-    _resources$ = Signal.state({
-        previous$: null,
-        current$: null,
-    }, { isDisabled: true });
-    state$ = Computed.create(() => {
-        const resources = this._resources$.get();
-        let prevState;
-        const currState = resources.current$?.value$.get();
-        // Отлавливаем кейс, когда ресурс был спрошен.
-        // На данные момент единсвенная причина сброса - resetAllQueriesCache(),
-        //  но в будущем могут быть и другие причины, что потребует доработку.
-        if (currState && !currState.isInitiated) {
-            this._resource.initiate(currState.args, resources.current$);
-            return {
-                isInitiated: true,
-                isLoading: true,
-                isInitialLoading: true,
-                isDone: false,
-                isSuccess: false,
-                isError: false,
-                isReloading: false,
-                error: undefined,
-                data: undefined,
-                // TODO вообще нет точного представлния, как блокировака доложна работать.
-                //  Мб тут стоит брать currState.isLocked.
-                isLocked: false,
-                args: currState.args,
-            };
-        }
-        if (!currState?.isDone) {
-            prevState = resources.previous$?.value;
-        }
-        // Нет текущего состояния — дефолт
-        if (!currState) {
-            return {
-                isInitiated: false,
-                isLoading: false,
-                isInitialLoading: false,
-                isDone: false,
-                isSuccess: false,
-                isError: false,
-                isLocked: false,
-                isReloading: false,
-                error: undefined,
-                data: undefined,
-                args: undefined,
-            };
-        }
-        // Если идёт загрузка, но есть успешные данные из прошлого запроса — показываем их
-        const isShowPrev = currState.isLoading && prevState && prevState.isSuccess;
-        return {
-            isInitiated: currState.isInitiated || !!prevState,
-            isLoading: currState.isLoading,
-            isInitialLoading: currState.isLoading && !currState.isDone && !prevState?.isDone,
-            isDone: currState.isDone,
-            isSuccess: currState.isSuccess,
-            isError: currState.isError,
-            isLocked: currState.isLocked,
-            isReloading: currState.isReloading,
-            error: isShowPrev ? (prevState.error ?? undefined) : (currState.error ?? undefined),
-            data: isShowPrev ? (prevState.data ?? undefined) : (currState.data ?? undefined),
-            args: currState.args ?? undefined,
-        };
-    }, { isDisabled: true });
-    constructor(_resource) {
-        this._resource = _resource;
-    }
-    initiate(args, force = false) {
-        const current = this._resources$.peek().current$;
-        const cache = this._resource.getQueryCache(args);
-        if (!cache) {
-            const newCache = this._resource.initiate(args);
-            this._next(newCache);
-            return;
-        }
-        if (force || !(cache.value.isDone || cache.value.isLoading)) {
-            this._resource.initiate(args, cache);
-        }
-        if (current !== cache) {
-            this._next(cache);
-        }
-    }
-    compareArgs(args, otherArgs) {
-        return this._resource.compareArgs(args, otherArgs);
-    }
-    _next(newCache) {
-        const { previous$, current$ } = this._resources$.peek();
-        if (!current$) {
-            this._resources$.set({
-                previous$: null,
-                current$: newCache,
-            });
-            return;
-        }
-        if (!current$.value$.peek().isDone && previous$?.value$.peek().isDone) {
-            this._resources$.set({
-                previous$: previous$,
-                current$: newCache,
-            });
-            return;
-        }
-        this._resources$.set({
-            previous$: current$,
-            current$: newCache,
-        });
-    }
-}

package/dist/query/core/Resource/ResourceRef.d.ts

@@ -1,16 +0,0 @@
-import { ResourceDefinition, ResourceRefInstance, ResourceTransaction } from "../../../query/types";
-import { Resource } from "./Resource";
-export declare class ResourceRef<D extends ResourceDefinition> implements ResourceRefInstance<D> {
-    private readonly _resource;
-    private readonly _args;
-    private _cacheItem;
-    constructor(_resource: Resource<D>, _args: D["Args"]);
-    get has(): boolean;
-    lock(): {
-        unlock: () => void;
-    };
-    unlockOne(): void;
-    patch(patchFn: (data: D["Data"]) => void): ResourceTransaction | null;
-    create(data: D["Data"]): void;
-    invalidate(): void;
-}