@fozy-labs/rx-toolkit 0.5.4 → 0.6.2

package/dist/query-v2/plugins/ReactHooksPlugin.d.ts

@@ -1,25 +0,0 @@
-import type { ResourceV2 } from "../../query-v2/core/resource/ResourceV2";
-import type { SKIP_TOKEN } from "../../query-v2/lib/SKIP_TOKEN";
-import type { IResourceV2AgentState, IResourceV2Ref } from "../../query-v2/types/agent.types";
-import type { IPlugin, IPluginContext } from "../../query-v2/types/plugin.types";
-import type { IResourceV2Options } from "../../query-v2/types/resource.types";
-/** Contributions added by ReactHooksPlugin to resources */
-export interface IReactHooksPluginContributions<TArgs, TData, TError = Error> {
-    useResourceV2Agent(args: TArgs | SKIP_TOKEN): IResourceV2AgentState<TArgs, TData, TError>;
-    useResourceV2Ref(args: TArgs | SKIP_TOKEN): IResourceV2Ref<TArgs, TData, TError>;
-}
-declare module "../../query-v2/types/plugin.types" {
-    interface PluginContributionMap<TArgs, TData, TError> {
-        ReactHooksPlugin: IReactHooksPluginContributions<TArgs, TData, TError>;
-    }
-}
-/**
- * Plugin that attaches `useResourceV2Agent` and `useResourceV2Ref` as methods on resources via `augmentResource`.
- * Standalone imports from `@/query-v2/react/` are available as an alternative without requiring this plugin.
- */
-export declare class ReactHooksPlugin implements IPlugin {
-    readonly name: "ReactHooksPlugin";
-    private _context;
-    install(context: IPluginContext): void;
-    augmentResource<TArgs, TData, TError>(res: ResourceV2<TArgs, TData, TError>, _options: IResourceV2Options<TArgs, TData, TError>): Record<string, unknown>;
-}

package/dist/query-v2/plugins/ReactHooksPlugin.js

@@ -1,19 +0,0 @@
-import { useResourceV2Agent } from "../../query-v2/react/useResourceV2Agent";
-import { useResourceV2Ref } from "../../query-v2/react/useResourceV2Ref";
-/**
- * Plugin that attaches `useResourceV2Agent` and `useResourceV2Ref` as methods on resources via `augmentResource`.
- * Standalone imports from `@/query-v2/react/` are available as an alternative without requiring this plugin.
- */
-export class ReactHooksPlugin {
-    name = "ReactHooksPlugin";
-    _context = null;
-    install(context) {
-        this._context = context;
-    }
-    augmentResource(res, _options) {
-        return {
-            useResourceV2Agent: (args) => useResourceV2Agent(res, args),
-            useResourceV2Ref: (args) => useResourceV2Ref(res, args),
-        };
-    }
-}

package/dist/query-v2/plugins/types.d.ts

@@ -1 +0,0 @@
-export type { IPlugin, IPluginContext, ExtractPluginContributions, PluginAugmentations, } from "../../query-v2/types/plugin.types";

package/dist/query-v2/react/__tests__/helpers.d.ts

@@ -1,12 +0,0 @@
-import { ResourceV2, type ResourceV2Config } from "../../../query-v2/core/resource/ResourceV2";
-export declare function controllableQueryFn<TArgs = unknown, TData = unknown>(): {
-    fn: import("vitest").Mock<(args: TArgs, { abortSignal }: {
-        abortSignal: AbortSignal;
-    }) => Promise<TData>>;
-    calls: {
-        args: TArgs;
-        resolve: (data: TData) => void;
-        reject: (error: Error) => void;
-    }[];
-};
-export declare function createTestResource<TArgs = unknown, TData = unknown, TError = Error>(config: Partial<ResourceV2Config<TArgs, TData, TError>> & Pick<ResourceV2Config<TArgs, TData, TError>, "queryFn">): ResourceV2<TArgs, TData, TError>;

package/dist/query-v2/react/__tests__/helpers.js

@@ -1,33 +0,0 @@
-import { vi } from "vitest";
-import { ResourceV2 } from "../../../query-v2/core/resource/ResourceV2";
-export function controllableQueryFn() {
-    const calls = [];
-    const fn = vi.fn((args, { abortSignal }) => {
-        return new Promise((resolve, reject) => {
-            let settled = false;
-            const wrappedResolve = (data) => {
-                if (!settled) {
-                    settled = true;
-                    resolve(data);
-                }
-            };
-            const wrappedReject = (error) => {
-                if (!settled) {
-                    settled = true;
-                    reject(error);
-                }
-            };
-            calls.push({ args, resolve: wrappedResolve, reject: wrappedReject });
-            abortSignal.addEventListener("abort", () => {
-                wrappedReject(new DOMException("Aborted", "AbortError"));
-            });
-        });
-    });
-    return { fn, calls };
-}
-export function createTestResource(config) {
-    return new ResourceV2({
-        key: "test-resource",
-        ...config,
-    });
-}

package/dist/query-v2/react/index.d.ts

@@ -1,2 +0,0 @@
-export { useResourceV2Agent } from "./useResourceV2Agent";
-export { useResourceV2Ref } from "./useResourceV2Ref";

package/dist/query-v2/react/index.js

@@ -1,2 +0,0 @@
-export { useResourceV2Agent } from "./useResourceV2Agent";
-export { useResourceV2Ref } from "./useResourceV2Ref";

package/dist/query-v2/react/useResourceV2Agent.d.ts

@@ -1,12 +0,0 @@
-import type { ResourceV2 } from "../../query-v2/core/resource/ResourceV2";
-import { type SKIP_TOKEN } from "../../query-v2/lib/SKIP_TOKEN";
-import type { IResourceV2AgentState } from "../../query-v2/types/agent.types";
-/**
- * React hook that creates a ResourceV2Agent and returns its reactive state (SWR).
- *
- * @param resource - The resource to observe.
- * @param args - Query arguments, or `SKIP_TOKEN` to skip the query.
- * @returns Reactive agent state with `data`, `error`, status flags, etc.
- * @see docs/query-v2/README.md
- */
-export declare function useResourceV2Agent<TArgs, TData, TError>(resource: ResourceV2<TArgs, TData, TError>, args: TArgs | SKIP_TOKEN): IResourceV2AgentState<TArgs, TData, TError>;

package/dist/query-v2/react/useResourceV2Agent.js

@@ -1,36 +0,0 @@
-import React from "react";
-import { useConstant } from "../../common/react/useConstant";
-import { SKIP } from "../../query-v2/lib/SKIP_TOKEN";
-import { useSignal } from "../../signals/react/useSignal";
-/**
- * React hook that creates a ResourceV2Agent and returns its reactive state (SWR).
- *
- * @param resource - The resource to observe.
- * @param args - Query arguments, or `SKIP_TOKEN` to skip the query.
- * @returns Reactive agent state with `data`, `error`, status flags, etc.
- * @see docs/query-v2/README.md
- */
-export function useResourceV2Agent(resource, args) {
-    const prevArgsRef = React.useRef(SKIP);
-    const agent = useConstant(() => {
-        const agent = resource.createAgent();
-        if (args !== SKIP) {
-            agent.start(args);
-        }
-        return agent;
-    });
-    if (!compareArgs(args, prevArgsRef.current, resource)) {
-        prevArgsRef.current = args;
-        if (args !== SKIP) {
-            agent.start(args);
-        }
-    }
-    return useSignal(agent.state$);
-}
-function compareArgs(args, prevArgs, resource) {
-    if (args === SKIP && prevArgs === SKIP)
-        return true;
-    if (args === SKIP || prevArgs === SKIP)
-        return false;
-    return resource.compareArgs(args, prevArgs);
-}

package/dist/query-v2/react/useResourceV2Ref.d.ts

@@ -1,12 +0,0 @@
-import type { ResourceV2 } from "../../query-v2/core/resource/ResourceV2";
-import { type SKIP_TOKEN } from "../../query-v2/lib/SKIP_TOKEN";
-import type { IResourceV2Ref } from "../../query-v2/types/agent.types";
-/**
- * React hook that provides an imperative ref handle for a cache entry (lock, invalidate, patch, create).
- *
- * @param resource - The resource to access.
- * @param args - Query arguments, or `SKIP_TOKEN` to return a no-op ref.
- * @returns Imperative ref with `has`, `lock`, `invalidate`, `createPatch`, `create`.
- * @see docs/query-v2/optimistic-updates.md
- */
-export declare function useResourceV2Ref<TArgs, TData, TError>(resource: ResourceV2<TArgs, TData, TError>, args: TArgs | SKIP_TOKEN): IResourceV2Ref<TArgs, TData, TError>;

package/dist/query-v2/react/useResourceV2Ref.js

@@ -1,57 +0,0 @@
-import React from "react";
-import { shallowEqual } from "../../common/utils/shallowEqual";
-import { SKIP } from "../../query-v2/lib/SKIP_TOKEN";
-/**
- * React hook that provides an imperative ref handle for a cache entry (lock, invalidate, patch, create).
- *
- * @param resource - The resource to access.
- * @param args - Query arguments, or `SKIP_TOKEN` to return a no-op ref.
- * @returns Imperative ref with `has`, `lock`, `invalidate`, `createPatch`, `create`.
- * @see docs/query-v2/optimistic-updates.md
- */
-export function useResourceV2Ref(resource, args) {
-    const stableArgsRef = React.useRef(args);
-    if (!shallowEqual(stableArgsRef.current, args)) {
-        stableArgsRef.current = args;
-    }
-    return React.useMemo(() => {
-        if (stableArgsRef.current === SKIP) {
-            return createSkippedRef();
-        }
-        return createRefHandle(resource, stableArgsRef.current);
-    }, [stableArgsRef.current]);
-}
-function createRefHandle(resource, args) {
-    return {
-        get has() {
-            return resource.hasEntry(args);
-        },
-        lock() {
-            return resource.lockEntry(args);
-        },
-        invalidate() {
-            resource.invalidate(args);
-        },
-        createPatch(patchFn) {
-            return resource.createEntryPatch(args, patchFn);
-        },
-        create(data) {
-            resource.populateEntry(args, data);
-        },
-    };
-}
-function createSkippedRef() {
-    return {
-        get has() {
-            return false;
-        },
-        lock() {
-            return { unlock: () => { } };
-        },
-        invalidate() { },
-        createPatch() {
-            return null;
-        },
-        create() { },
-    };
-}

package/dist/query-v2/snapshot/Snapshot.d.ts

@@ -1,13 +0,0 @@
-import type { ResourceV2 } from "../../query-v2/core/resource/ResourceV2";
-import type { TApiSnapshot } from "../../query-v2/types/snapshot.types";
-export declare const CURRENT_SNAPSHOT_VERSION = 1;
-/**
- * Capture snapshot from all registered resources.
- * Only `MachineSuccess` entries are included (per design §5).
- */
-export declare function getSnapshot(resources: Map<string, ResourceV2<any, any, any>>, keyPrefix: string | null, keyStrategy: "serialize" | "compare"): TApiSnapshot;
-/**
- * Hydrate resources from a snapshot.
- * Validates version and keyPrefix before applying.
- */
-export declare function hydrateSnapshot(snapshot: TApiSnapshot, resources: Map<string, ResourceV2<any, any, any>>, apiKeyPrefix: string | null, maxSnapshotDataAge: number): void;

package/dist/query-v2/snapshot/Snapshot.js

@@ -1,76 +0,0 @@
-import { Machine } from "../../query-v2/core/machines/Machine";
-import { MachineSuccess } from "../../query-v2/core/machines/MachineSuccess";
-export const CURRENT_SNAPSHOT_VERSION = 1;
-/**
- * Capture snapshot from all registered resources.
- * Only `MachineSuccess` entries are included (per design §5).
- */
-export function getSnapshot(resources, keyPrefix, keyStrategy) {
-    if (keyStrategy === "compare") {
-        throw new Error('getSnapshot() is not supported with keyStrategy "compare". ' +
-            'SSR snapshots require keyStrategy "serialize" so that cache keys are serializable strings.');
-    }
-    const resourceSnapshots = {};
-    for (const [resourceKey, resource] of resources) {
-        const entries = {};
-        let hasEntries = false;
-        for (const [key, cacheEntry] of resource.cacheEntries()) {
-            const machine = cacheEntry.peek();
-            if (!(machine instanceof MachineSuccess))
-                continue;
-            const state = machine.state;
-            entries[key] = {
-                status: "success",
-                args: state.args,
-                data: state.data,
-                updatedAt: state.updatedAt,
-            };
-            hasEntries = true;
-        }
-        if (hasEntries) {
-            resourceSnapshots[resourceKey] = { entries };
-        }
-    }
-    return {
-        version: CURRENT_SNAPSHOT_VERSION,
-        keyPrefix,
-        resources: resourceSnapshots,
-    };
-}
-/**
- * Hydrate resources from a snapshot.
- * Validates version and keyPrefix before applying.
- */
-export function hydrateSnapshot(snapshot, resources, apiKeyPrefix, maxSnapshotDataAge) {
-    // Fatal: snapshot format incompatibility — the serialization schema has changed between versions.
-    // This cannot be recovered from; the snapshot must be regenerated.
-    if (snapshot.version !== CURRENT_SNAPSHOT_VERSION) {
-        throw new Error(`Snapshot version mismatch: expected ${CURRENT_SNAPSHOT_VERSION}, got ${snapshot.version}. ` +
-            `The snapshot format is incompatible with the current version of query-v2.`);
-    }
-    // Fatal: wrong API instance — the snapshot was created by a different keyPrefix configuration.
-    // Applying it would pollute the cache with data from an unrelated API.
-    if (snapshot.keyPrefix !== apiKeyPrefix) {
-        throw new Error(`Snapshot keyPrefix mismatch: expected "${apiKeyPrefix}", got "${snapshot.keyPrefix}". ` +
-            `Ensure the snapshot was created by the same API instance configuration.`);
-    }
-    const now = Date.now();
-    for (const [resourceKey, resourceSnapshot] of Object.entries(snapshot.resources)) {
-        const resource = resources.get(resourceKey);
-        if (!resource) {
-            // Non-fatal: a resource may have been removed between versions — skip gracefully.
-            console.warn(`[rx-toolkit] hydrateSnapshot: unknown resource key "${resourceKey}", skipping.`);
-            continue;
-        }
-        for (const [, slice] of Object.entries(resourceSnapshot.entries)) {
-            const machine = Machine.fromSnapshot(slice);
-            // Reconstruct args from the slice
-            const args = slice.args;
-            resource.hydrateEntry(args, machine);
-            // S3: stale entries trigger invalidation
-            if (now - slice.updatedAt > maxSnapshotDataAge) {
-                resource.invalidate(args);
-            }
-        }
-    }
-}

package/dist/query-v2/types/agent.types.d.ts

@@ -1,54 +0,0 @@
-import type { TMachineStatus, TPatchFn } from "./machine.types";
-/** SKIP_TOKEN type alias for agent args */
-type SKIP_TOKEN = typeof import("../lib/SKIP_TOKEN").SKIP;
-/** Agent — observer with stale-while-revalidate */
-export interface IResourceV2Agent<TArgs, TData, TError = Error> {
-    /** Reactive state (computed signal) */
-    readonly state$: () => IResourceV2AgentState<TArgs, TData, TError>;
-    /** Start query with new args (returns promise) */
-    start(args: TArgs | SKIP_TOKEN): Promise<void>;
-    /** Compare previous and new args */
-    compareArgs(a: TArgs, b: TArgs): boolean;
-}
-/** Agent's computed state shape */
-export interface IResourceV2AgentState<TArgs, TData, TError = Error> {
-    /** Current machine status */
-    status: TMachineStatus;
-    /** Current data (may be stale during loading) */
-    data: TData | null;
-    /** Current error */
-    error: TError | null;
-    /** Current args (fresh) */
-    args: TArgs | null;
-    /** Loading indicator */
-    isLoading: boolean;
-    /** True only on first load (no previous data) */
-    isInitialLoading: boolean;
-    /** True when refreshing existing data */
-    isRefreshing: boolean;
-    /** True when data is available */
-    isSuccess: boolean;
-    /** True when in error state */
-    isError: boolean;
-    /** Error from a failed background refresh (stale data preserved) */
-    refreshError: TError | null;
-}
-/** Ref — imperative access to a specific cache entry by args */
-export interface IResourceV2Ref<_TArgs, TData, _TError = Error> {
-    /** Check if cache entry exists */
-    readonly has: boolean;
-    /** Lock cache entry (prevent eviction) */
-    lock(): {
-        unlock: () => void;
-    };
-    /** Invalidate (force re-fetch) */
-    invalidate(): void;
-    /** Create optimistic patch */
-    createPatch(patchFn: TPatchFn<TData>): {
-        commit: () => void;
-        abort: () => void;
-    } | null;
-    /** Pre-populate cache with data */
-    create(data: TData): void;
-}
-export {};

package/dist/query-v2/types/api.types.d.ts

@@ -1,22 +0,0 @@
-import type { IPlugin, PluginAugmentations } from "./plugin.types";
-import type { IResourceV2, IResourceV2Options } from "./resource.types";
-import type { TCompareArgsFn, TSerializeArgsFn } from "./shared.types";
-import type { TApiSnapshot } from "./snapshot.types";
-/** Options for createApi factory */
-export interface ICreateApiOptions<TPlugins extends IPlugin[] = []> {
-    keyPrefix?: string | null;
-    keyStrategy?: "serialize" | "compare";
-    serializeArgs?: TSerializeArgsFn;
-    compareArg?: TCompareArgsFn;
-    initialSnapshot?: TApiSnapshot | null;
-    cacheLifetime?: number;
-    plugins?: TPlugins;
-    maxSnapshotDataAge?: number;
-    doCacheArgs?: boolean;
-}
-/** API instance returned by createApi */
-export interface IApi<TPlugins extends IPlugin[] = []> {
-    createResource<TArgs, TData, TError = Error>(options: IResourceV2Options<TArgs, TData, TError>): IResourceV2<TArgs, TData, TError> & PluginAugmentations<TPlugins, TArgs, TData, TError>;
-    resetAll(): void;
-    getSnapshot(): TApiSnapshot;
-}

package/dist/query-v2/types/cache.types.d.ts

@@ -1,37 +0,0 @@
-import type { IMachineBox } from "./machine.types";
-import type { TCompareArgsFn, TSerializeArgsFn } from "./shared.types";
-/** Single reactive cache unit holding a Machine */
-export interface ICacheEntry<TData, TError = Error> {
-    /** Reactive signal holding current machine state */
-    readonly machine$: () => IMachineBox<TData, TError>;
-    /** Synchronous peek at current machine */
-    peek(): IMachineBox<TData, TError>;
-    /** Update machine state */
-    set(machine: IMachineBox<TData, TError>): void;
-    /** Cleanup — complete and release */
-    complete(): void;
-    /** Observable for cache lifetime management */
-    readonly onClean$: {
-        subscribe(cb: () => void): {
-            unsubscribe(): void;
-        };
-    };
-}
-/** Dual-strategy cache abstraction */
-export interface ICacheMap<TArgs, TData, TError = Error> {
-    get(args: TArgs): ICacheEntry<TData, TError> | undefined;
-    set(args: TArgs, entry: ICacheEntry<TData, TError>): void;
-    delete(args: TArgs): boolean;
-    has(args: TArgs): boolean;
-    values(): Iterable<ICacheEntry<TData, TError>>;
-    entries(): Iterable<[TArgs | string, ICacheEntry<TData, TError>]>;
-    clear(): void;
-    readonly size: number;
-}
-/** Factory options for creating appropriate cache map */
-export interface ICacheMapOptions<_TArgs> {
-    keyStrategy: "serialize" | "compare";
-    serializeArgs: TSerializeArgsFn;
-    compareArg: TCompareArgsFn;
-    doCacheArgs: boolean;
-}

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

@@ -1,9 +0,0 @@
-export * from "./shared.types";
-export * from "./machine.types";
-export * from "./cache.types";
-export * from "./resource.types";
-export * from "./agent.types";
-export * from "./api.types";
-export * from "./plugin.types";
-export * from "./snapshot.types";
-export * from "./lifecycle.types";

package/dist/query-v2/types/index.js

@@ -1,9 +0,0 @@
-export * from "./shared.types";
-export * from "./machine.types";
-export * from "./cache.types";
-export * from "./resource.types";
-export * from "./agent.types";
-export * from "./api.types";
-export * from "./plugin.types";
-export * from "./snapshot.types";
-export * from "./lifecycle.types";

package/dist/query-v2/types/lifecycle.types.d.ts

@@ -1,25 +0,0 @@
-import type { ICacheEntry } from "./cache.types";
-import type { TMachine } from "./machine.types";
-/** Tools provided to onCacheEntryAdded */
-export interface TCacheEntryAddedTools<TData> {
-    /** Resolves when first MachineSuccess is set */
-    $cacheDataLoaded: Promise<TData>;
-    /** Resolves when cache entry is removed */
-    $cacheEntryRemoved: Promise<void>;
-    /** Get current machine state */
-    getCacheEntry(): TMachine<TData, any>;
-}
-/** onCacheEntryAdded callback type */
-export type TOnCacheEntryAdded<TArgs, TData> = (args: TArgs, tools: TCacheEntryAddedTools<TData>) => void | Promise<void>;
-/** Tools provided to onQueryStarted */
-export interface TQueryStartedTools<TData> {
-    /** Resolves/rejects when query completes */
-    $queryFulfilled: Promise<{
-        data: TData;
-        isError: false;
-    }>;
-    /** Get current cache entry for patching */
-    getCacheEntry(): ICacheEntry<TData, any>;
-}
-/** onQueryStarted callback type */
-export type TOnQueryStarted<TArgs, TData> = (args: TArgs, tools: TQueryStartedTools<TData>) => void | Promise<void>;

package/dist/query-v2/types/machine.types.d.ts

@@ -1,67 +0,0 @@
-import type { NO_VALUE } from "./shared.types";
-/** Discriminated union of all machine statuses */
-export type TMachineStatus = "idle" | "pending" | "success" | "error" | "refreshing";
-/** Idle state — initial, no data */
-export interface TResourceV2IdleState {
-    status: "idle";
-    args: null;
-    data: null;
-    error: null;
-    updatedAt: null;
-}
-/** Pending state — query in progress, no data yet */
-export interface TResourceV2PendingState<TData = unknown> {
-    status: "pending";
-    args: unknown;
-    data: null;
-    error: null;
-    updatedAt: null;
-    originalData: TData | NO_VALUE;
-}
-/** Success state — data loaded successfully */
-export interface TResourceV2SuccessState<TData = unknown> {
-    status: "success";
-    args: unknown;
-    data: TData;
-    error: null;
-    updatedAt: number;
-    originalData: TData | NO_VALUE;
-    patches: TResourceV2Patch[] | null;
-}
-/** Error state — query failed */
-export interface TResourceV2ErrorState<TError = Error> {
-    status: "error";
-    args: unknown;
-    data: null;
-    error: TError;
-    updatedAt: null;
-}
-/** Refreshing state — re-fetching while holding stale data */
-export interface TResourceV2RefreshingState<TData = unknown> {
-    status: "refreshing";
-    args: unknown;
-    data: TData;
-    error: null;
-    updatedAt: number;
-    originalData: TData | NO_VALUE;
-    patches: TResourceV2Patch[] | null;
-}
-/** Patch record in the queue (Immer-based) */
-export interface TResourceV2Patch {
-    patches: unknown[];
-    inversePatches: unknown[];
-    status: "pending" | "committed" | "aborted";
-}
-/** Patch function (Immer recipe) */
-export type TPatchFn<TData> = (draft: TData) => void;
-/**
- * Discriminated union of all machine states (flat state shapes).
- */
-export type TMachine<TData, TError = Error> = TResourceV2IdleState | TResourceV2PendingState<TData> | TResourceV2SuccessState<TData> | TResourceV2ErrorState<TError> | TResourceV2RefreshingState<TData>;
-/**
- * Boxed machine — structural type matching runtime machine class instances.
- * Each machine class wraps its flat state in a `readonly state` property.
- */
-export interface IMachineBox<TData = unknown, TError = Error> {
-    readonly state: TMachine<TData, TError>;
-}

package/dist/query-v2/types/plugin.types.d.ts

@@ -1,38 +0,0 @@
-import type { ResourceV2 } from "../../query-v2";
-import type { IApi } from "./api.types";
-import type { IResourceV2Options } from "./resource.types";
-import type { Prettify } from "./shared.types";
-/** Plugin interface — all plugins must implement this */
-export interface IPlugin {
-    /** Unique plugin name */
-    readonly name: string;
-    /** Called once when createApi installs the plugin */
-    install(context: IPluginContext): void;
-    /** Called for each createResource — returns augmented resource */
-    augmentResource<TArgs, TData, TError>(resource: ResourceV2<TArgs, TData, TError>, options: IResourceV2Options<TArgs, TData, TError>): Record<string, unknown>;
-}
-/** Context provided to plugins during install */
-export interface IPluginContext {
-    /** The API instance */
-    readonly api: IApi<any>;
-    /** Key strategy for this API */
-    readonly keyStrategy: "serialize" | "compare";
-}
-/** Helper: converts a union to an intersection */
-type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
-/**
- * Extract plugin contributions from a single plugin.
- * Each plugin extends PluginContributionMap via declaration merging.
- * The name property is used as the key lookup.
- */
-export interface PluginContributionMap<TArgs, TData, TError> {
-}
-export type ExtractPluginContributions<P extends IPlugin, TArgs, TData, TError> = P extends {
-    name: infer N;
-} ? N extends keyof PluginContributionMap<TArgs, TData, TError> ? PluginContributionMap<TArgs, TData, TError>[N] : object : object;
-/**
- * Type-level utility: extracts and merges augmentations from a plugin tuple.
- * Uses UnionToIntersection + Prettify as per ADR-1.
- */
-export type PluginAugmentations<TPlugins extends IPlugin[], TArgs, TData, TError> = TPlugins extends [] ? object : Prettify<UnionToIntersection<TPlugins[number] extends infer P ? P extends IPlugin ? ExtractPluginContributions<P, TArgs, TData, TError> : never : never>>;
-export {};

package/dist/query-v2/types/resource.types.d.ts

@@ -1,35 +0,0 @@
-import type { IResourceV2Agent } from "./agent.types";
-import type { ICacheEntry } from "./cache.types";
-import type { TOnCacheEntryAdded, TOnQueryStarted } from "./lifecycle.types";
-import type { TMachine } from "./machine.types";
-import type { TBeforeDevtoolsPushFn, TCompareArgsFn, TQueryFn, TSerializeArgsFn } from "./shared.types";
-/** Options for api.createResource */
-export interface IResourceV2Options<TArgs, TData, TError = Error> {
-    key?: string;
-    queryFn: TQueryFn<TArgs, TData>;
-    onCacheEntryAdded?: TOnCacheEntryAdded<TArgs, TData>;
-    onQueryStarted?: TOnQueryStarted<TArgs, TData>;
-    serializeArgs?: TSerializeArgsFn;
-    compareArg?: TCompareArgsFn;
-    cacheLifetime?: number;
-    beforeDevtoolsPush?: TBeforeDevtoolsPushFn<TMachine<TData, TError>>;
-    maxSnapshotDataAge?: number;
-    doCacheArgs?: boolean;
-}
-/** ResourceV2 instance (public API) */
-export interface IResourceV2<TArgs, TData, TError = Error> {
-    /** Create an agent (observer with SWR) */
-    createAgent(): IResourceV2Agent<TArgs, TData, TError>;
-    /** Execute query, returns promise of cache entry */
-    query(args: TArgs, doForce?: boolean): Promise<ICacheEntry<TData, TError>>;
-    /** Reactive query — returns current machine state as signal read */
-    query$(args: TArgs, doForce?: boolean): TMachine<TData, TError>;
-    /** Get raw cache entry (non-reactive) */
-    entry(args: TArgs, doInitiate?: boolean): ICacheEntry<TData, TError> | null;
-    /** Get cache entry signal (reactive) */
-    entry$(args: TArgs, doInitiate?: boolean): TMachine<TData, TError>;
-    /** Force re-fetch for given args */
-    invalidate(args: TArgs): void;
-    /** Compare two args values */
-    compareArgs(a: TArgs, b: TArgs): boolean;
-}

package/dist/query-v2/types/resource.types.js

@@ -1 +0,0 @@
-export {};

package/dist/query-v2/types/shared.types.d.ts

@@ -1,20 +0,0 @@
-export type Prettify<T> = {
-    [KeyType in keyof T]: T[KeyType];
-} & {};
-/** Serialize args to string cache key */
-export type TSerializeArgsFn = (args: unknown) => string;
-/** Compare two args for equality (used in 'compare' strategy) */
-export type TCompareArgsFn = (a: unknown, b: unknown) => boolean;
-/**
- * Intercepts machine state before pushing to Redux DevTools.
- * Default behavior: push machine.state (plain object).
- * User can transform or filter.
- */
-export type TBeforeDevtoolsPushFn<TMachineState> = (newValue: TMachineState, push: (value: TMachineState) => void) => void;
-/** Query function signature */
-export type TQueryFn<TArgs, TData> = (args: TArgs, tools: TQueryFnTools) => Promise<TData>;
-export interface TQueryFnTools {
-    abortSignal: AbortSignal;
-}
-/** NO_VALUE type alias — the runtime value lives in lib/NO_VALUE.ts */
-export type NO_VALUE = typeof import("../lib/NO_VALUE").NO_VALUE;

package/dist/query-v2/types/shared.types.js

@@ -1 +0,0 @@
-export {};