@fozy-labs/rx-toolkit 0.5.3 → 0.6.0

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

@@ -1,136 +0,0 @@
-import { applyPatches, enablePatches, produceWithPatches } from "immer";
-enablePatches();
-export class ResourceRef {
-    _resource;
-    _args;
-    _cacheItem = null;
-    constructor(_resource, _args) {
-        this._resource = _resource;
-        this._args = _args;
-    }
-    get has() {
-        if (this._cacheItem)
-            return true;
-        this._cacheItem = this._resource.getQueryCache(this._args) ?? null;
-        return !!this._cacheItem;
-    }
-    lock() {
-        this._cacheItem = this._resource.incrementLock(this._args, { cache: this._cacheItem ?? undefined });
-        let isLocked = true;
-        return {
-            unlock: () => {
-                if (!isLocked)
-                    return;
-                isLocked = false;
-                this._resource.decrementLock(this._args, { cache: this._cacheItem });
-            },
-        };
-    }
-    unlockOne() {
-        this._cacheItem = this._resource.decrementLock(this._args, { cache: this._cacheItem });
-    }
-    patch(patchFn) {
-        let isSkipped = true;
-        const reapplyFn = (data, savedData, transactions) => {
-            if (!transactions || transactions.length === 0) {
-                return { data, transactions, savedData };
-            }
-            // Все валидные committed - пропускаем и убираем из очереди
-            // Все aborted - применяем и убираем из очереди
-            // Все pending - применяем и оставляем в очереди
-            // Все commited (которые после pending) - применяем, но оставляем в очереди
-            // Все aborted (которые после pending) - откатываем, но оставляем в очереди
-            // Если после aborted нет pending - пропускаем и убираем из очереди
-            // Те после применения всех транзакций, очередь должна начинаться с первой pending транзакции (если есть), включая все, что после неё.
-            let newSavedData = savedData ?? data;
-            let currentData = savedData ?? data;
-            const remainingTransactions = [];
-            let foundPending = false;
-            const lastPendingIndex = transactions.findLastIndex((t) => t.status === "pending");
-            transactions.forEach((transaction, index) => {
-                if (transaction.status === "pending") {
-                    foundPending = true;
-                    // Применяем pending транзакцию и оставляем в очереди
-                    currentData = applyPatches(currentData, transaction.patches);
-                    remainingTransactions.push(transaction);
-                }
-                else if (foundPending) {
-                    // После pending транзакции
-                    if (transaction.status === "committed") {
-                        // Применяем и оставляем в очереди
-                        currentData = applyPatches(currentData, transaction.patches);
-                        remainingTransactions.push(transaction);
-                    }
-                    else if (transaction.status === "aborted") {
-                        // Проверяем, есть ли pending после текущей aborted
-                        const hasPendingAfter = index < lastPendingIndex;
-                        if (hasPendingAfter) {
-                            currentData = applyPatches(currentData, transaction.inversePatches);
-                            remainingTransactions.push(transaction);
-                        }
-                        // Если pending нет - пропускаем и убираем из очереди
-                    }
-                }
-                else {
-                    // До первой pending транзакции
-                    if (transaction.status === "committed") {
-                        // Применяем и убираем из очереди
-                        const patches = transaction.patches;
-                        currentData = applyPatches(currentData, patches);
-                        newSavedData = currentData;
-                    }
-                }
-            });
-            const hasTransactions = remainingTransactions.length > 0;
-            return {
-                data: currentData,
-                transactions: hasTransactions ? remainingTransactions : null,
-                savedData: hasTransactions ? newSavedData : null,
-            };
-        };
-        const reapplyTransactions = () => {
-            this._resource.update(this._args, reapplyFn, { cache: this._cacheItem ?? undefined });
-        };
-        const transaction = {
-            patches: [],
-            inversePatches: [],
-            status: "pending",
-            abort() {
-                if (this.status !== "pending")
-                    return;
-                this.status = "aborted";
-                reapplyTransactions();
-            },
-            commit() {
-                if (this.status !== "pending")
-                    return;
-                this.status = "committed";
-                reapplyTransactions();
-            },
-        };
-        const updateFn = (data, savedData, transactions) => {
-            isSkipped = false;
-            const [newData, patches, inversePatches] = produceWithPatches(data, (draft) => patchFn(draft));
-            transaction.patches = patches;
-            transaction.inversePatches = inversePatches;
-            const newTransactions = [...(transactions ?? [])];
-            newTransactions.push(transaction);
-            return {
-                data: newData,
-                transactions: newTransactions,
-                savedData: savedData ?? data,
-            };
-        };
-        this._cacheItem = this._resource.update(this._args, updateFn, { cache: this._cacheItem ?? undefined });
-        if (isSkipped) {
-            return null;
-        }
-        return transaction;
-    }
-    create(data) {
-        this._cacheItem = this._resource.createWithData(this._args, data, { cache: this._cacheItem ?? undefined });
-    }
-    invalidate() {
-        this._cacheItem = this._resource.initiate(this._args, { cache: this._cacheItem ?? undefined });
-    }
-}

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

@@ -1,19 +0,0 @@
-type CompareFn<T> = (a: T, b: T) => boolean;
-export declare class IndirectMap<KEY, VALUE> {
-    private _compareObjectsFn;
-    private _compareCache;
-    private _map;
-    constructor(_compareObjectsFn?: CompareFn<KEY>);
-    private _getCachedKey;
-    get(key: KEY): VALUE | undefined;
-    set(key: KEY, value: VALUE): void;
-    /**
-     * Удаляет элемент из кеша, не зависимо от того,
-     *  ссылается ли на него другой объект или нет
-     * @param key
-     */
-    delete(key: KEY): void;
-    has(key: KEY): boolean;
-    values(): MapIterator<VALUE>;
-}
-export {};

package/dist/query/lib/IndirectMap.js

@@ -1,88 +0,0 @@
-import { shallowEqual } from "../../common/utils";
-export class IndirectMap {
-    _compareObjectsFn;
-    _compareCache = new WeakMap();
-    _map = new Map();
-    constructor(_compareObjectsFn = shallowEqual) {
-        this._compareObjectsFn = _compareObjectsFn;
-    }
-    _getCachedKey(key) {
-        const cachedKey = this._compareCache.get(key);
-        if (cachedKey) {
-            return cachedKey;
-        }
-        for (const cachedKey of this._map.keys()) {
-            if (this._compareObjectsFn(key, cachedKey)) {
-                this._compareCache.set(key, cachedKey);
-                return cachedKey;
-            }
-        }
-        return undefined;
-    }
-    get(key) {
-        const item = this._map.get(key);
-        if (!item) {
-            const isObject = typeof key === "object" && key !== null;
-            if (!isObject) {
-                return undefined;
-            }
-            const cachedKey = this._getCachedKey(key);
-            if (!cachedKey) {
-                return undefined;
-            }
-            return this._map.get(cachedKey);
-        }
-        return item;
-    }
-    set(key, value) {
-        const has = this._map.has(key);
-        if (has) {
-            this._map.set(key, value);
-        }
-        else {
-            const isObject = typeof key === "object" && key !== null;
-            if (!isObject) {
-                this._map.set(key, value);
-                return;
-            }
-            const cachedKey = this._getCachedKey(key);
-            if (cachedKey) {
-                this._map.set(cachedKey, value);
-            }
-            else {
-                this._map.set(key, value);
-                this._compareCache.set(key, key);
-            }
-        }
-    }
-    /**
-     * Удаляет элемент из кеша, не зависимо от того,
-     *  ссылается ли на него другой объект или нет
-     * @param key
-     */
-    delete(key) {
-        const isObject = typeof key === "object" && key !== null;
-        if (isObject) {
-            const cachedKey = this._getCachedKey(key);
-            if (cachedKey) {
-                this._map.delete(cachedKey);
-                this._compareCache.delete(key);
-            }
-        }
-        this._map.delete(key);
-    }
-    has(key) {
-        const has = this._map.has(key);
-        if (!has && typeof key === "object" && key !== null) {
-            const cachedKey = this._getCachedKey(key);
-            if (!cachedKey) {
-                return false;
-            }
-            return this._map.has(cachedKey);
-        }
-        return has;
-    }
-    values() {
-        return this._map.values();
-    }
-}

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

@@ -1,62 +0,0 @@
-import { Observable, Subject } from "rxjs";
-import { ReadableSignalLike } from "../../signals/types";
-type Options<VALUE> = {
-    /**
-     * Начальное состояние кэша
-     */
-    initialState: VALUE;
-    /**
-     * Время жизни кэша в миллисекундах (пока нет подписок на кеш)
-     * Если указано `false`, кэш не будет очищаться автоматически.
-     * Если указано `0` или меньше, кэш будет очищаться сразу после отписки от него.
-     * @default 60_000 (1 минута)
-     */
-    cacheLifeTime?: number | false;
-};
-/**
- * Класс `ReactiveCache` представляет собой реактивный кэш,
- * который позволяет управлять состоянием и временем жизни кэшированных данных.
- *
- * @template VALUE Тип значения, хранимого в кэше.
- */
-export declare class ReactiveCache<VALUE> {
-    /**
-     * Внутренний `BehaviorSubject`, хранящий текущее состояние кэша.
-     * @private
-     */
-    private _state$;
-    /**
-     * Реактивное значене (Observable)
-     */
-    value$: ReadableSignalLike<VALUE>;
-    /**
-     * Значение без сайд-эффектов (для использования в DevTools)
-     */
-    spy$: Observable<VALUE>;
-    /**
-     * Subject, уведомляющий об очистке кэша.
-     */
-    onClean$: Subject<VALUE>;
-    closed: boolean;
-    /**
-     * Создает новый экземпляр `ReactiveCacheItem`.
-     *
-     * @param options Параметры для настройки элемента кэша.
-     * @param options.initialState Начальное состояние кэша.
-     * @param options.cacheLifeTime Время жизни кэша в миллисекундах (по умолчанию 60_000).
-     */
-    constructor(options: Options<VALUE>);
-    private _getOnRefCountZero;
-    get value(): VALUE;
-    /**
-     * Устанавливает новое значение в кэш и обновляет поток состояния.
-     *
-     * @param value Новое значение для кэша.
-     */
-    next(value: VALUE): void;
-    /**
-     * Завершает работу кэша, закрывая все потоки и уведомляя об очистке.
-     */
-    complete(): void;
-}
-export {};

package/dist/query/lib/ReactiveCache.js

@@ -1,80 +0,0 @@
-import { BehaviorSubject, finalize, ReplaySubject, share, Subject, takeUntil, timer } from "rxjs";
-import { signalize } from "../../signals";
-/**
- * Класс `ReactiveCache` представляет собой реактивный кэш,
- * который позволяет управлять состоянием и временем жизни кэшированных данных.
- *
- * @template VALUE Тип значения, хранимого в кэше.
- */
-export class ReactiveCache {
-    /**
-     * Внутренний `BehaviorSubject`, хранящий текущее состояние кэша.
-     * @private
-     */
-    _state$;
-    /**
-     * Реактивное значене (Observable)
-     */
-    value$;
-    /**
-     * Значение без сайд-эффектов (для использования в DevTools)
-     */
-    spy$;
-    /**
-     * Subject, уведомляющий об очистке кэша.
-     */
-    onClean$ = new Subject();
-    closed = false;
-    /**
-     * Создает новый экземпляр `ReactiveCacheItem`.
-     *
-     * @param options Параметры для настройки элемента кэша.
-     * @param options.initialState Начальное состояние кэша.
-     * @param options.cacheLifeTime Время жизни кэша в миллисекундах (по умолчанию 60_000).
-     */
-    constructor(options) {
-        const cacheLifeTime = options.cacheLifeTime ?? 60_000;
-        this._state$ = new BehaviorSubject(options.initialState);
-        this.spy$ = this._state$.pipe(takeUntil(this.onClean$));
-        this.value$ = signalize(this._state$.pipe(finalize(() => {
-            this.complete();
-        }), share({
-            connector: () => new ReplaySubject(1),
-            resetOnRefCountZero: this._getOnRefCountZero(cacheLifeTime),
-            resetOnComplete: true,
-        })));
-    }
-    _getOnRefCountZero(cacheLifeTime) {
-        if (cacheLifeTime === false) {
-            return false;
-        }
-        if (cacheLifeTime <= 0) {
-            return true;
-        }
-        return () => {
-            return timer(cacheLifeTime);
-        };
-    }
-    get value() {
-        return this._state$.getValue();
-    }
-    /**
-     * Устанавливает новое значение в кэш и обновляет поток состояния.
-     *
-     * @param value Новое значение для кэша.
-     */
-    next(value) {
-        this._state$.next(value);
-    }
-    /**
-     * Завершает работу кэша, закрывая все потоки и уведомляя об очистке.
-     */
-    complete() {
-        if (this.closed)
-            return;
-        this.closed = true;
-        this._state$.complete();
-        this.onClean$.next(this._state$.getValue());
-        this.onClean$.complete();
-    }
-}

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

@@ -1,24 +0,0 @@
-import type { CommandAgentInstance, CommandDefinition, CommandQueryState, Prettify } from "../../query/types";
-type WithAgent<D extends CommandDefinition> = {
-    createAgent: () => CommandAgentInstance<D>;
-};
-type TriggerFn<D extends CommandDefinition> = (args: D["Args"]) => Promise<D["Data"]>;
-type Result<D extends CommandDefinition> = [TriggerFn<D>, Prettify<CommandQueryState<D>>];
-/**
- * React hook для работы с командой (Command).
- *
- * Возвращает кортеж `[trigger, state]`:
- * - `trigger(args)` — инициирует выполнение команды и возвращает Promise с результатом.
- * - `state` — реактивное состояние выполнения команды.
- *
- * @example
- * ```tsx
- * const [updateUser, state] = useCommandAgent(api.updateUser);
- *
- * const handleSubmit = async () => {
- *   const result = await updateUser({ id: 1, name: 'New Name' });
- * };
- * ```
- */
-export declare function useCommandAgent<D extends CommandDefinition>(op: WithAgent<D>): Result<D>;
-export {};

package/dist/query/react/useCommandAgent.js

@@ -1,39 +0,0 @@
-import { useConstant, useEventHandler } from "../../common/react";
-import { useSignal } from "../../signals/react";
-/**
- * React hook для работы с командой (Command).
- *
- * Возвращает кортеж `[trigger, state]`:
- * - `trigger(args)` — инициирует выполнение команды и возвращает Promise с результатом.
- * - `state` — реактивное состояние выполнения команды.
- *
- * @example
- * ```tsx
- * const [updateUser, state] = useCommandAgent(api.updateUser);
- *
- * const handleSubmit = async () => {
- *   const result = await updateUser({ id: 1, name: 'New Name' });
- * };
- * ```
- */
-export function useCommandAgent(op) {
-    const agent = useConstant(() => op.createAgent());
-    const state = useSignal(agent.state$);
-    const trigger = useEventHandler((args) => {
-        agent.initiate(args);
-        return new Promise((resolve, reject) => {
-            const sub = agent.state$.obs.subscribe((s) => {
-                if (s.isDone && !s.isLoading) {
-                    sub.unsubscribe();
-                    if (s.isSuccess) {
-                        resolve(s.data);
-                    }
-                    else {
-                        reject(s.error);
-                    }
-                }
-            });
-        });
-    });
-    return [trigger, state];
-}

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

@@ -1,6 +0,0 @@
-import { useCommandAgent } from "./useCommandAgent";
-/**
- * @deprecated Use `useCommandAgent` instead. Will be removed in v0.6.0.
- * @see useCommandAgent
- */
-export declare const useOperationAgent: typeof useCommandAgent;

package/dist/query/react/useOperationAgent.js

@@ -1,6 +0,0 @@
-import { useCommandAgent } from "./useCommandAgent";
-/**
- * @deprecated Use `useCommandAgent` instead. Will be removed in v0.6.0.
- * @see useCommandAgent
- */
-export const useOperationAgent = useCommandAgent;

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

@@ -1,6 +0,0 @@
-import { DuplicatorDefinition, ResourceDuplicator } from "../../query/core/Resource/ResourceDuplicator";
-import { SKIP } from "../../query/SKIP_TOKEN";
-import { Prettify, ResourceDefinition, ResourceInstance, ResourceQueryState } from "../../query/types";
-type Result<D extends ResourceDefinition> = Prettify<ResourceQueryState<D>>;
-export declare function useResourceAgent<D extends ResourceDefinition>(res: ResourceInstance<D> | ResourceDuplicator<DuplicatorDefinition<D>>, ...argss: D["Args"] extends void ? [] | [typeof SKIP] : [D["Args"] | typeof SKIP]): Result<D>;
-export {};

package/dist/query/react/useResourceAgent.js

@@ -1,31 +0,0 @@
-import React from "react";
-import { useConstant } from "../../common/react";
-import { SKIP } from "../../query/SKIP_TOKEN";
-import { useSignal } from "../../signals/react";
-export function useResourceAgent(res, ...argss) {
-    const args = (argss[0] === SKIP ? SKIP : argss[0]);
-    const prevArgsRef = React.useRef(SKIP);
-    const agent = useConstant(() => {
-        const agent = res.createAgent();
-        if (args !== SKIP) {
-            agent.initiate(args);
-        }
-        return agent;
-    });
-    if (!compare(args, prevArgsRef.current, agent)) {
-        prevArgsRef.current = args;
-        if (args !== SKIP) {
-            agent.initiate(args);
-        }
-    }
-    return useSignal(agent.state$);
-}
-function compare(args, prevArgs, agent) {
-    if (args === SKIP && prevArgs === SKIP) {
-        return true;
-    }
-    if (args === SKIP || prevArgs === SKIP) {
-        return false;
-    }
-    return agent.compareArgs(args, prevArgs);
-}

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

@@ -1,5 +0,0 @@
-import { SKIP } from "../../query/SKIP_TOKEN";
-import type { Prettify, ResourceDefinition, ResourceInstance, ResourceRefInstance } from "../../query/types";
-type Result<D extends ResourceDefinition> = Prettify<ResourceRefInstance<D>>;
-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,13 +0,0 @@
-import React from "react";
-import { shallowEqual } from "../../common/utils/shallowEqual";
-import { SKIP } from "../../query/SKIP_TOKEN";
-export function useResourceRef(res, ...argss) {
-    const args = (argss[0] === SKIP ? SKIP : argss[0]);
-    const stableArgsRef = React.useRef(args);
-    if (!shallowEqual(stableArgsRef.current, args)) {
-        stableArgsRef.current = args;
-    }
-    return React.useMemo(() => {
-        return res.createRef(stableArgsRef.current);
-    }, [stableArgsRef.current]);
-}