katanakit-js 3.2.1 → 4.0.2

package/dist/adapters/react/query.js

@@ -0,0 +1,200 @@
+import { useCallback, useEffect, useState } from "react";
+import { useQueryClient, } from "../../core/services/query.service.js";
+const IDLE_STATE = {
+    status: "idle",
+    data: null,
+    error: null,
+    isLoading: false,
+    isSuccess: false,
+    isError: false,
+    isStale: true,
+    dataUpdatedAt: 0,
+    errorUpdatedAt: 0,
+    fetchCount: 0,
+};
+/**
+ * React hook that wraps the {@link QueryClient} with `useState` reactivity.
+ * Integrates with the API manager — your `queryFn` typically calls `useGetApi`
+ * or `useFetch` and returns the Safe Result.
+ *
+ * Subscribes to the global query cache, refetches when the serialized
+ * `queryKey` changes, and unsubscribes on unmount.
+ *
+ * @param config - Query configuration.
+ * @param client - Optional QueryClient instance (uses global singleton by default).
+ * @returns `{ data, error, isLoading, isSuccess, isError, isStale, status, refetch }`.
+ *
+ * @example
+ * ```tsx
+ * import { useQuery } from "katanakit-js/adapters/react";
+ * import { useGetApi } from "katanakit-js";
+ *
+ * function Pokemon({ id }: { id: number }) {
+ *   const { data, isLoading, error } = useQuery({
+ *     queryKey: ["pokemon", id],
+ *     queryFn: () => useGetApi("pokeapi", "pokemonById", { params: { id } }),
+ *   });
+ *   if (isLoading) return <div>Loading…</div>;
+ *   if (error) return <div>{error.message}</div>;
+ *   return <div>{data?.name}</div>;
+ * }
+ * ```
+ */
+export function useQuery(config, client) {
+    const qc = client ?? useQueryClient();
+    const [state, setState] = useState(IDLE_STATE);
+    // Serialize the key so React's dependency comparison tracks deep changes.
+    const keyHash = JSON.stringify(config.queryKey);
+    useEffect(() => {
+        let disposed = false;
+        const qKey = config.queryKey;
+        setState(IDLE_STATE);
+        const unsubscribe = qc.subscribe(qKey, (next) => {
+            if (!disposed)
+                setState(next);
+        });
+        const existing = qc.getQueryState(qKey);
+        if (existing)
+            setState(existing);
+        if (config.enabled !== false) {
+            void qc
+                .fetchQuery({
+                queryKey: qKey,
+                queryFn: config.queryFn,
+                staleTime: config.staleTime,
+                cacheTime: config.cacheTime,
+                retry: config.retry,
+                retryDelay: config.retryDelay,
+            })
+                .catch(() => {
+                // Error is already reflected in the cache state.
+            });
+        }
+        return () => {
+            disposed = true;
+            unsubscribe();
+        };
+    }, [keyHash, config.enabled]);
+    const refetch = useCallback(async () => {
+        await qc
+            .fetchQuery({
+            queryKey: config.queryKey,
+            queryFn: config.queryFn,
+            staleTime: 0,
+            cacheTime: config.cacheTime,
+            retry: config.retry,
+            retryDelay: config.retryDelay,
+        })
+            .catch(() => {
+            // Error is already reflected in the cache state.
+        });
+    }, [qc, keyHash]);
+    return {
+        data: state.data,
+        error: state.error,
+        isLoading: state.isLoading,
+        isSuccess: state.isSuccess,
+        isError: state.isError,
+        isStale: state.isStale,
+        status: state.status,
+        refetch,
+    };
+}
+const IDLE_MUTATION_STATE = {
+    data: null,
+    error: null,
+    isLoading: false,
+    isSuccess: false,
+    isError: false,
+    status: "idle",
+};
+/**
+ * React hook for mutations (POST/PUT/PATCH/DELETE).
+ * Does not cache — returns a `mutate` function that executes the mutation.
+ *
+ * @param config - Mutation configuration.
+ * @returns `{ data, error, isLoading, isSuccess, isError, status, mutate, reset }`.
+ *
+ * @example
+ * ```tsx
+ * import { useMutation, useQueryClient } from "katanakit-js/adapters/react";
+ * import { usePost } from "katanakit-js";
+ *
+ * function CreateUser() {
+ *   const qc = useQueryClient();
+ *   const { mutate, isLoading } = useMutation({
+ *     mutationFn: (name: string) => usePost("api", "createUser", { name }),
+ *     onSuccess: () => qc.invalidateQueries({ queryKey: ["users"] }),
+ *   });
+ *   return <button disabled={isLoading} onClick={() => mutate("Ada")}>Create</button>;
+ * }
+ * ```
+ */
+export function useMutation(config) {
+    const [state, setState] = useState(IDLE_MUTATION_STATE);
+    const mutate = useCallback(async (variables) => {
+        setState((prev) => ({
+            ...prev,
+            isLoading: true,
+            isSuccess: false,
+            isError: false,
+            status: "loading",
+        }));
+        try {
+            const result = await config.mutationFn(variables);
+            if (result.ok) {
+                setState({
+                    data: result.data,
+                    error: null,
+                    isLoading: false,
+                    isSuccess: true,
+                    isError: false,
+                    status: "success",
+                });
+                config.onSuccess?.(result.data, variables);
+                config.onSettled?.(result.data, null, variables);
+            }
+            else {
+                setState({
+                    data: null,
+                    error: result.error,
+                    isLoading: false,
+                    isSuccess: false,
+                    isError: true,
+                    status: "error",
+                });
+                config.onError?.(result.error, variables);
+                config.onSettled?.(null, result.error, variables);
+            }
+        }
+        catch (error) {
+            const apiError = error instanceof Error
+                ? { message: error.message, status: 0 }
+                : { message: String(error), status: 0 };
+            setState({
+                data: null,
+                error: apiError,
+                isLoading: false,
+                isSuccess: false,
+                isError: true,
+                status: "error",
+            });
+            config.onError?.(apiError, variables);
+            config.onSettled?.(null, apiError, variables);
+        }
+    }, []);
+    const reset = useCallback(() => {
+        setState(IDLE_MUTATION_STATE);
+    }, []);
+    return {
+        data: state.data,
+        error: state.error,
+        isLoading: state.isLoading,
+        isSuccess: state.isSuccess,
+        isError: state.isError,
+        status: state.status,
+        mutate,
+        reset,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/adapters/react/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/adapters/react/query.ts"],"names":[],"mappings":"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"}

package/dist/adapters/react/watch.d.ts

@@ -0,0 +1,37 @@
+/** Options for {@link useWatch}. */
+export interface UseWatchOptions {
+    /**
+     * Compare values deeply (via JSON serialization) instead of by reference.
+     * Defaults to `true`, matching the Vue adapter.
+     */
+    deep?: boolean;
+}
+/**
+ * React effect-based watcher that invokes `callback` whenever the value
+ * produced by `source` changes. Tracks the previous value so the callback
+ * receives `(value, previous)`.
+ *
+ * Runs once on mount (with `previous` undefined) and on every change. Cleans
+ * up automatically on unmount.
+ *
+ * @typeParam T - The watched value type.
+ * @param source - A getter returning the value to watch.
+ * @param callback - Invoked on change as `(value, previous)`.
+ * @param options - `deep` (default `true`) serializes objects for comparison.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from "react";
+ * import { useWatch } from "katanakit-js/adapters/react";
+ *
+ * function Form() {
+ *   const [product, setProduct] = useState({ name: "", price: 0 });
+ *   useWatch(() => product, (next, prev) => {
+ *     console.log("changed:", next, prev);
+ *   });
+ *   // ...
+ * }
+ * ```
+ */
+export declare function useWatch<T>(source: () => T, callback: (value: T, previous: T | undefined) => void, options?: UseWatchOptions): void;
+//# sourceMappingURL=watch.d.ts.map

package/dist/adapters/react/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/adapters/react/watch.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC/B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACzB,MAAM,EAAE,MAAM,CAAC,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACrD,OAAO,GAAE,eAAoB,GAC3B,IAAI,CAUN"}

package/dist/adapters/react/watch.js

@@ -0,0 +1,39 @@
+import { useEffect, useRef } from "react";
+/**
+ * React effect-based watcher that invokes `callback` whenever the value
+ * produced by `source` changes. Tracks the previous value so the callback
+ * receives `(value, previous)`.
+ *
+ * Runs once on mount (with `previous` undefined) and on every change. Cleans
+ * up automatically on unmount.
+ *
+ * @typeParam T - The watched value type.
+ * @param source - A getter returning the value to watch.
+ * @param callback - Invoked on change as `(value, previous)`.
+ * @param options - `deep` (default `true`) serializes objects for comparison.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from "react";
+ * import { useWatch } from "katanakit-js/adapters/react";
+ *
+ * function Form() {
+ *   const [product, setProduct] = useState({ name: "", price: 0 });
+ *   useWatch(() => product, (next, prev) => {
+ *     console.log("changed:", next, prev);
+ *   });
+ *   // ...
+ * }
+ * ```
+ */
+export function useWatch(source, callback, options = {}) {
+    const { deep = true } = options;
+    const previous = useRef(undefined);
+    const current = source();
+    const dep = deep ? JSON.stringify(current) : current;
+    useEffect(() => {
+        callback(current, previous.current);
+        previous.current = current;
+    }, [dep]);
+}
+//# sourceMappingURL=watch.js.map

package/dist/adapters/react/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/adapters/react/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAW1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,QAAQ,CACvB,MAAe,EACf,QAAqD,EACrD,UAA2B,EAAE;IAE7B,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAgB,SAAS,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAErD,SAAS,CAAC,GAAG,EAAE;QACd,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC5B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACX,CAAC"}

package/dist/adapters/solid/fetch.d.ts

@@ -0,0 +1,43 @@
+import { type Signal } from "solid-js";
+import type { ApiError, UrlOptions } from "../../types/index.js";
+/** Reactive state exposed by the {@link useRequest} primitive (Solid accessors). */
+export interface RequestState<T = unknown> {
+    data: Signal<T | null>[0];
+    error: Signal<ApiError | null>[0];
+    loading: Signal<boolean>[0];
+    refetch: () => Promise<void>;
+}
+/**
+ * Solid primitive that wraps KatanaKit's HTTP GET with fine-grained signals.
+ * Bridges the Safe Result pattern to idiomatic Solid state and never throws
+ * on HTTP errors.
+ *
+ * Stale responses are ignored via a request version counter and AbortController;
+ * in-flight requests are aborted on cleanup.
+ *
+ * @param apiName - Name of the registered API (see `useInitApis`).
+ * @param endpointName - Name of the endpoint inside that API.
+ * @param options - Optional `UrlOptions` (path/query params).
+ * @returns Signal accessors `{ data, error, loading }` plus `refetch`.
+ *
+ * @example
+ * ```tsx
+ * import { Show } from "solid-js";
+ * import { useRequest } from "katanakit-js/adapters/solid";
+ *
+ * function Pokemon() {
+ *   const { data, error, loading } = useRequest<{ name: string }>(
+ *     "pokeapi",
+ *     "pokemonById",
+ *     { params: { id: 25 } },
+ *   );
+ *   return (
+ *     <Show when={!loading() && !error()} fallback={<div>Loading…</div>}>
+ *       <div>{data()?.name}</div>
+ *     </Show>
+ *   );
+ * }
+ * ```
+ */
+export declare function useRequest<T>(apiName: string, endpointName: string, options?: UrlOptions): RequestState<T>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/adapters/solid/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/adapters/solid/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAGhE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEjE,oFAAoF;AACpF,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,UAAU,GAClB,YAAY,CAAC,CAAC,CAAC,CA2CjB"}

package/dist/adapters/solid/fetch.js

@@ -0,0 +1,72 @@
+import { createSignal, onCleanup } from "solid-js";
+import { useFetch } from "../../core/services/http.service.js";
+/**
+ * Solid primitive that wraps KatanaKit's HTTP GET with fine-grained signals.
+ * Bridges the Safe Result pattern to idiomatic Solid state and never throws
+ * on HTTP errors.
+ *
+ * Stale responses are ignored via a request version counter and AbortController;
+ * in-flight requests are aborted on cleanup.
+ *
+ * @param apiName - Name of the registered API (see `useInitApis`).
+ * @param endpointName - Name of the endpoint inside that API.
+ * @param options - Optional `UrlOptions` (path/query params).
+ * @returns Signal accessors `{ data, error, loading }` plus `refetch`.
+ *
+ * @example
+ * ```tsx
+ * import { Show } from "solid-js";
+ * import { useRequest } from "katanakit-js/adapters/solid";
+ *
+ * function Pokemon() {
+ *   const { data, error, loading } = useRequest<{ name: string }>(
+ *     "pokeapi",
+ *     "pokemonById",
+ *     { params: { id: 25 } },
+ *   );
+ *   return (
+ *     <Show when={!loading() && !error()} fallback={<div>Loading…</div>}>
+ *       <div>{data()?.name}</div>
+ *     </Show>
+ *   );
+ * }
+ * ```
+ */
+export function useRequest(apiName, endpointName, options) {
+    const [data, setData] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const [loading, setLoading] = createSignal(true);
+    let version = 0;
+    let controller = null;
+    let disposed = false;
+    const refetch = async () => {
+        const current = ++version;
+        controller?.abort();
+        const next = new AbortController();
+        controller = next;
+        setLoading(true);
+        setError(null);
+        const result = await useFetch(apiName, endpointName, {
+            method: "GET",
+            urlOptions: options,
+            signal: next.signal,
+        });
+        if (disposed || current !== version)
+            return;
+        if (result.ok) {
+            setData(() => result.data);
+            setError(null);
+        }
+        else if (!next.signal.aborted) {
+            setError(result.error);
+        }
+        setLoading(false);
+    };
+    onCleanup(() => {
+        disposed = true;
+        controller?.abort();
+    });
+    void refetch();
+    return { data, error, loading, refetch };
+}
+//# sourceMappingURL=fetch.js.map

package/dist/adapters/solid/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/adapters/solid/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAe,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAW/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,UAAU,CACzB,OAAe,EACf,YAAoB,EACpB,OAAoB;IAEpB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,YAAY,CAAW,IAAI,CAAC,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAkB,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAA2B,IAAI,CAAC;IAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,OAAO,GAAG,EAAE,OAAO,CAAC;QAC1B,UAAU,EAAE,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,UAAU,GAAG,IAAI,CAAC;QAElB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAI,OAAO,EAAE,YAAY,EAAE;YACvD,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QAEH,IAAI,QAAQ,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO;QAE5C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,UAAU,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACd,QAAQ,GAAG,IAAI,CAAC;QAChB,UAAU,EAAE,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,KAAK,OAAO,EAAE,CAAC;IAEf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/adapters/solid/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./fetch.js";
+export * from "./query.js";
+export * from "./watch.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/solid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/solid/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/adapters/solid/index.js

@@ -0,0 +1,4 @@
+export * from "./fetch.js";
+export * from "./query.js";
+export * from "./watch.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/solid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/solid/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/adapters/solid/query.d.ts

@@ -0,0 +1,102 @@
+import { type Signal } from "solid-js";
+import { type QueryClient, type QueryKey, type QueryState } from "../../core/services/query.service.js";
+import type { ApiError, FetchResult } from "../../types/index.js";
+/** Configuration for `useQuery` (Solid primitive). */
+export interface UseQueryConfig<T = unknown> {
+    /** Cache key (stable array). */
+    queryKey: QueryKey;
+    /** Fetcher function returning a Safe Result. */
+    queryFn: () => Promise<FetchResult<T>>;
+    /** Time in ms before cached data is stale (default: 0). */
+    staleTime?: number;
+    /** Time in ms to keep unused data (default: 5 min). */
+    cacheTime?: number;
+    /** Retry count on failure (default: 3). */
+    retry?: number;
+    /** Base delay for exponential backoff (default: 1000). */
+    retryDelay?: number;
+    /** Whether the query is enabled (default: true). */
+    enabled?: boolean;
+}
+/** Reactive return value of `useQuery` (Solid signals are accessors). */
+export interface UseQueryReturn<T = unknown> {
+    data: Signal<T | null>[0];
+    error: Signal<ApiError | null>[0];
+    isLoading: Signal<boolean>[0];
+    isSuccess: Signal<boolean>[0];
+    isError: Signal<boolean>[0];
+    isStale: Signal<boolean>[0];
+    status: Signal<QueryState<T>["status"]>[0];
+    /** Manually refetch the query. */
+    refetch: () => Promise<void>;
+}
+/** Configuration for `useMutation`. */
+export interface UseMutationConfig<TData = unknown, TVariables = unknown> {
+    mutationFn: (variables: TVariables) => Promise<FetchResult<TData>>;
+    onSuccess?: (data: TData, variables: TVariables) => void;
+    onError?: (error: ApiError, variables: TVariables) => void;
+    onSettled?: (data: TData | null, error: ApiError | null, variables: TVariables) => void;
+}
+/** Reactive return value of `useMutation`. */
+export interface UseMutationReturn<TData = unknown, TVariables = unknown> {
+    data: Signal<TData | null>[0];
+    error: Signal<ApiError | null>[0];
+    isLoading: Signal<boolean>[0];
+    isSuccess: Signal<boolean>[0];
+    isError: Signal<boolean>[0];
+    status: Signal<"idle" | "loading" | "success" | "error">[0];
+    /** Execute the mutation. */
+    mutate: (variables: TVariables) => Promise<void>;
+    /** Reset the mutation state. */
+    reset: () => void;
+}
+/**
+ * Solid primitive that wraps the {@link QueryClient} with fine-grained signals.
+ * Integrates with the API manager — your `queryFn` typically calls `useGetApi`
+ * or `useFetch` and returns the Safe Result.
+ *
+ * @param config - Query configuration.
+ * @param client - Optional QueryClient instance (uses global singleton by default).
+ * @returns Signal accessors for `{ data, error, isLoading, isSuccess, isError, isStale, status }` plus `refetch`.
+ *
+ * @example
+ * ```tsx
+ * import { useQuery } from "katanakit-js/adapters/solid";
+ * import { useGetApi } from "katanakit-js";
+ *
+ * function Pokemon() {
+ *   const { data, isLoading, error } = useQuery({
+ *     queryKey: ["pokemon", 25],
+ *     queryFn: () => useGetApi("pokeapi", "pokemonById", { params: { id: 25 } }),
+ *   });
+ *   return <Show when={!isLoading() && !error()} fallback={<div>Loading…</div>}>
+ *     <div>{data()?.name}</div>
+ *   </Show>;
+ * }
+ * ```
+ */
+export declare function useQuery<T>(config: UseQueryConfig<T>, client?: QueryClient): UseQueryReturn<T>;
+/**
+ * Solid primitive for mutations (POST/PUT/PATCH/DELETE).
+ * Does not cache — returns a `mutate` function that executes the mutation.
+ *
+ * @param config - Mutation configuration.
+ * @returns Signal accessors plus `{ mutate, reset }`.
+ *
+ * @example
+ * ```tsx
+ * import { useMutation, useQueryClient } from "katanakit-js/adapters/solid";
+ * import { usePost } from "katanakit-js";
+ *
+ * function CreateUser() {
+ *   const qc = useQueryClient();
+ *   const { mutate, isLoading } = useMutation({
+ *     mutationFn: (name: string) => usePost("api", "createUser", { name }),
+ *     onSuccess: () => qc.invalidateQueries({ queryKey: ["users"] }),
+ *   });
+ *   return <button disabled={isLoading()} onClick={() => mutate("Ada")}>Create</button>;
+ * }
+ * ```
+ */
+export declare function useMutation<TData = unknown, TVariables = unknown>(config: UseMutationConfig<TData, TVariables>): UseMutationReturn<TData, TVariables>;
+//# sourceMappingURL=query.d.ts.map

package/dist/adapters/solid/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/adapters/solid/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EAEf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,sDAAsD;AACtD,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IAC1C,gCAAgC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,gDAAgD;IAChD,OAAO,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,kCAAkC;IAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,OAAO,EAAE,UAAU,GAAG,OAAO;IACvE,UAAU,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,SAAS,EAAE,UAAU,KAAK,IAAI,CAAC;CACxF;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,OAAO,EAAE,UAAU,GAAG,OAAO;IACvE,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,4BAA4B;IAC5B,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,gCAAgC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CA+D9F;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,UAAU,GAAG,OAAO,EAChE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,GAC1C,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CA0DtC"}