katanakit-js 3.2.1 → 4.0.2

package/dist/adapters/solid/query.js

@@ -0,0 +1,163 @@
+import { createEffect, createSignal, onCleanup } from "solid-js";
+import { useQueryClient, } from "../../core/services/query.service.js";
+/**
+ * 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 function useQuery(config, client) {
+    const qc = client ?? useQueryClient();
+    const [data, setData] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const [isLoading, setIsLoading] = createSignal(false);
+    const [isSuccess, setIsSuccess] = createSignal(false);
+    const [isError, setIsError] = createSignal(false);
+    const [isStale, setIsStale] = createSignal(true);
+    const [status, setStatus] = createSignal("idle");
+    const sync = (state) => {
+        // Updater form avoids Solid's "function as value" ambiguity for generic T.
+        setData(() => state.data);
+        setError(state.error);
+        setIsLoading(state.isLoading);
+        setIsSuccess(state.isSuccess);
+        setIsError(state.isError);
+        setIsStale(state.isStale);
+        setStatus(state.status);
+    };
+    createEffect(() => {
+        const qKey = config.queryKey;
+        const unsubscribe = qc.subscribe(qKey, (next) => sync(next));
+        const existing = qc.getQueryState(qKey);
+        if (existing)
+            sync(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.
+            });
+        }
+        onCleanup(unsubscribe);
+    });
+    const refetch = 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.
+        });
+    };
+    return { data, error, isLoading, isSuccess, isError, isStale, status, refetch };
+}
+/**
+ * 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 function useMutation(config) {
+    const [data, setData] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const [isLoading, setIsLoading] = createSignal(false);
+    const [isSuccess, setIsSuccess] = createSignal(false);
+    const [isError, setIsError] = createSignal(false);
+    const [status, setStatus] = createSignal("idle");
+    const mutate = async (variables) => {
+        setIsLoading(true);
+        setIsSuccess(false);
+        setIsError(false);
+        setStatus("loading");
+        try {
+            const result = await config.mutationFn(variables);
+            if (result.ok) {
+                setData(() => result.data);
+                setError(null);
+                setIsSuccess(true);
+                setStatus("success");
+                config.onSuccess?.(result.data, variables);
+                config.onSettled?.(result.data, null, variables);
+            }
+            else {
+                setData(null);
+                setError(result.error);
+                setIsError(true);
+                setStatus("error");
+                config.onError?.(result.error, variables);
+                config.onSettled?.(null, result.error, variables);
+            }
+        }
+        catch (caught) {
+            const apiError = caught instanceof Error
+                ? { message: caught.message, status: 0 }
+                : { message: String(caught), status: 0 };
+            setData(null);
+            setError(apiError);
+            setIsError(true);
+            setStatus("error");
+            config.onError?.(apiError, variables);
+            config.onSettled?.(null, apiError, variables);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    };
+    const reset = () => {
+        setData(null);
+        setError(null);
+        setIsLoading(false);
+        setIsSuccess(false);
+        setIsError(false);
+        setStatus("idle");
+    };
+    return { data, error, isLoading, isSuccess, isError, status, mutate, reset };
+}
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/adapters/solid/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAe,MAAM,UAAU,CAAC;AAE9E,OAAO,EAIN,cAAc,GACd,MAAM,sCAAsC,CAAC;AAwD9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAI,MAAyB,EAAE,MAAoB;IAC1E,MAAM,EAAE,GAAG,MAAM,IAAI,cAAc,EAAE,CAAC;IAEtC,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,SAAS,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,YAAY,CAA0B,MAAM,CAAC,CAAC;IAE1E,MAAM,IAAI,GAAG,CAAC,KAAoB,EAAQ,EAAE;QAC3C,2EAA2E;QAC3E,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1B,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1B,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,YAAY,CAAC,GAAG,EAAE;QACjB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC7B,MAAM,WAAW,GAAG,EAAE,CAAC,SAAS,CAAI,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAqB,CAAC,CAAC,CAAC;QAEjF,MAAM,QAAQ,GAAG,EAAE,CAAC,aAAa,CAAI,IAAI,CAAC,CAAC;QAC3C,IAAI,QAAQ;YAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE7B,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC9B,KAAK,EAAE;iBACL,UAAU,CAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC7B,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACX,iDAAiD;YAClD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,SAAS,CAAC,WAAW,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,EAAE;aACN,UAAU,CAAI;YACd,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC7B,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACX,iDAAiD;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACjF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CAC1B,MAA4C;IAE5C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,YAAY,CAAe,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAkB,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,YAAY,CAA2C,MAAM,CAAC,CAAC;IAE3F,MAAM,MAAM,GAAG,KAAK,EAAE,SAAqB,EAAiB,EAAE;QAC7D,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,SAAS,CAAC,SAAS,CAAC,CAAC;QAErB,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAElD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnB,SAAS,CAAC,SAAS,CAAC,CAAC;gBACrB,MAAM,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAC3C,MAAM,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvB,UAAU,CAAC,IAAI,CAAC,CAAC;gBACjB,SAAS,CAAC,OAAO,CAAC,CAAC;gBACnB,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAC1C,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACnD,CAAC;QACF,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,GACb,MAAM,YAAY,KAAK;gBACtB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE;gBACxC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACtC,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAS,EAAE;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,SAAS,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC9E,CAAC"}

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

@@ -0,0 +1,32 @@
+/** Options for {@link useWatch}. Accepted for API parity; Solid tracks deep reads natively. */
+export interface UseWatchOptions {
+    deep?: boolean;
+}
+/**
+ * Solid effect-based watcher that invokes `callback` whenever any signal read
+ * inside `source` changes. Tracks the previous value so the callback receives
+ * `(value, previous)`.
+ *
+ * Solid's fine-grained reactivity means nested mutations are tracked
+ * automatically, so `deep` is effectively always on. Runs once on creation and
+ * on every tracked change; cleans up with the owning component.
+ *
+ * @typeParam T - The watched value type.
+ * @param source - A getter that reads the signals to watch.
+ * @param callback - Invoked on change as `(value, previous)`.
+ * @param options - Accepted for API parity (ignored).
+ *
+ * @example
+ * ```tsx
+ * import { createSignal } from "solid-js";
+ * import { useWatch } from "katanakit-js/adapters/solid";
+ *
+ * function Form() {
+ *   const [product, setProduct] = createSignal({ name: "", price: 0 });
+ *   useWatch(() => product(), (next, prev) => console.log(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/solid/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/adapters/solid/watch.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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,QAAQ,GAAE,eAAoB,GAC5B,IAAI,CAQN"}

package/dist/adapters/solid/watch.js

@@ -0,0 +1,36 @@
+import { createEffect } from "solid-js";
+/**
+ * Solid effect-based watcher that invokes `callback` whenever any signal read
+ * inside `source` changes. Tracks the previous value so the callback receives
+ * `(value, previous)`.
+ *
+ * Solid's fine-grained reactivity means nested mutations are tracked
+ * automatically, so `deep` is effectively always on. Runs once on creation and
+ * on every tracked change; cleans up with the owning component.
+ *
+ * @typeParam T - The watched value type.
+ * @param source - A getter that reads the signals to watch.
+ * @param callback - Invoked on change as `(value, previous)`.
+ * @param options - Accepted for API parity (ignored).
+ *
+ * @example
+ * ```tsx
+ * import { createSignal } from "solid-js";
+ * import { useWatch } from "katanakit-js/adapters/solid";
+ *
+ * function Form() {
+ *   const [product, setProduct] = createSignal({ name: "", price: 0 });
+ *   useWatch(() => product(), (next, prev) => console.log(next, prev));
+ *   // ...
+ * }
+ * ```
+ */
+export function useWatch(source, callback, _options = {}) {
+    let previous;
+    createEffect(() => {
+        const value = source();
+        callback(value, previous);
+        previous = value;
+    });
+}
+//# sourceMappingURL=watch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/adapters/solid/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAOxC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,QAAQ,CACvB,MAAe,EACf,QAAqD,EACrD,WAA4B,EAAE;IAE9B,IAAI,QAAuB,CAAC;IAE5B,YAAY,CAAC,GAAG,EAAE;QACjB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1B,QAAQ,GAAG,KAAK,CAAC;IAClB,CAAC,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,40 @@
+import { type Readable } from "svelte/store";
+import type { ApiError, UrlOptions } from "../../types/index.js";
+/** Reactive state exposed by the {@link useRequest} factory (Svelte stores). */
+export interface RequestState<T = unknown> {
+    data: Readable<T | null>;
+    error: Readable<ApiError | null>;
+    loading: Readable<boolean>;
+    refetch: () => Promise<void>;
+}
+/**
+ * Svelte store factory that wraps KatanaKit's HTTP GET. Bridges the Safe
+ * Result pattern to idiomatic Svelte stores and never throws on HTTP errors.
+ *
+ * Stale responses are ignored via a request version counter and AbortController;
+ * in-flight requests are aborted on component destroy.
+ *
+ * @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 Readable stores `{ data, error, loading }` plus `refetch`.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useRequest } from "katanakit-js/adapters/svelte";
+ *
+ *   const { data, error, loading } = useRequest("pokeapi", "pokemonById", { params: { id: 25 } });
+ * </script>
+ *
+ * {#if $loading}
+ *   <div>Loading…</div>
+ * {:else if $error}
+ *   <div>{$error.message}</div>
+ * {:else}
+ *   <div>{$data?.name}</div>
+ * {/if}
+ * ```
+ */
+export declare function useRequest<T>(apiName: string, endpointName: string, options?: UrlOptions): RequestState<T>;
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/adapters/svelte/fetch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAC;AAGvD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEjE,gFAAgF;AAChF,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,KAAK,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACjC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,UAAU,GAClB,YAAY,CAAC,CAAC,CAAC,CA+CjB"}

package/dist/adapters/svelte/fetch.js

@@ -0,0 +1,75 @@
+import { onDestroy } from "svelte";
+import { writable } from "svelte/store";
+import { useFetch } from "../../core/services/http.service.js";
+/**
+ * Svelte store factory that wraps KatanaKit's HTTP GET. Bridges the Safe
+ * Result pattern to idiomatic Svelte stores and never throws on HTTP errors.
+ *
+ * Stale responses are ignored via a request version counter and AbortController;
+ * in-flight requests are aborted on component destroy.
+ *
+ * @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 Readable stores `{ data, error, loading }` plus `refetch`.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useRequest } from "katanakit-js/adapters/svelte";
+ *
+ *   const { data, error, loading } = useRequest("pokeapi", "pokemonById", { params: { id: 25 } });
+ * </script>
+ *
+ * {#if $loading}
+ *   <div>Loading…</div>
+ * {:else if $error}
+ *   <div>{$error.message}</div>
+ * {:else}
+ *   <div>{$data?.name}</div>
+ * {/if}
+ * ```
+ */
+export function useRequest(apiName, endpointName, options) {
+    const data = writable(null);
+    const error = writable(null);
+    const loading = writable(true);
+    let version = 0;
+    let controller = null;
+    let disposed = false;
+    const refetch = async () => {
+        const current = ++version;
+        controller?.abort();
+        const next = new AbortController();
+        controller = next;
+        loading.set(true);
+        error.set(null);
+        const result = await useFetch(apiName, endpointName, {
+            method: "GET",
+            urlOptions: options,
+            signal: next.signal,
+        });
+        if (disposed || current !== version)
+            return;
+        if (result.ok) {
+            data.set(result.data);
+            error.set(null);
+        }
+        else if (!next.signal.aborted) {
+            error.set(result.error);
+        }
+        loading.set(false);
+    };
+    try {
+        onDestroy(() => {
+            disposed = true;
+            controller?.abort();
+        });
+    }
+    catch {
+        // Not inside a component init — the caller owns teardown.
+    }
+    void refetch();
+    return { data, error, loading, refetch };
+}
+//# sourceMappingURL=fetch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/adapters/svelte/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAW/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,UAAU,CACzB,OAAe,EACf,YAAoB,EACpB,OAAoB;IAEpB,MAAM,IAAI,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAkB,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE/B,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,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhB,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,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,IAAI,CAAC;QACJ,SAAS,CAAC,GAAG,EAAE;YACd,QAAQ,GAAG,IAAI,CAAC;YAChB,UAAU,EAAE,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACR,0DAA0D;IAC3D,CAAC;IAED,KAAK,OAAO,EAAE,CAAC;IAEf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/adapters/svelte/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/svelte/index.d.ts.map

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

package/dist/adapters/svelte/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/svelte/index.js.map

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

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

@@ -0,0 +1,108 @@
+import { type Readable } from "svelte/store";
+import { type QueryClient, type QueryKey, type QueryState } from "../../core/services/query.service.js";
+import type { ApiError, FetchResult } from "../../types/index.js";
+/** Configuration for `useQuery` (Svelte store factory). */
+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` (Svelte readable stores). */
+export interface UseQueryReturn<T = unknown> {
+    data: Readable<T | null>;
+    error: Readable<ApiError | null>;
+    isLoading: Readable<boolean>;
+    isSuccess: Readable<boolean>;
+    isError: Readable<boolean>;
+    isStale: Readable<boolean>;
+    status: Readable<QueryState<T>["status"]>;
+    /** 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: Readable<TData | null>;
+    error: Readable<ApiError | null>;
+    isLoading: Readable<boolean>;
+    isSuccess: Readable<boolean>;
+    isError: Readable<boolean>;
+    status: Readable<"idle" | "loading" | "success" | "error">;
+    /** Execute the mutation. */
+    mutate: (variables: TVariables) => Promise<void>;
+    /** Reset the mutation state. */
+    reset: () => void;
+}
+/**
+ * Svelte store factory that wraps the {@link QueryClient}.
+ * Integrates with the API manager — your `queryFn` typically calls `useGetApi`
+ * or `useFetch` and returns the Safe Result.
+ *
+ * Unsubscribes automatically on component destroy when called during init.
+ *
+ * @param config - Query configuration.
+ * @param client - Optional QueryClient instance (uses global singleton by default).
+ * @returns Readable stores `{ data, error, isLoading, isSuccess, isError, isStale, status }` plus `refetch`.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useQuery } from "katanakit-js/adapters/svelte";
+ *   import { useGetApi } from "katanakit-js";
+ *
+ *   const { data, isLoading, error } = useQuery({
+ *     queryKey: ["pokemon", 25],
+ *     queryFn: () => useGetApi("pokeapi", "pokemonById", { params: { id: 25 } }),
+ *   });
+ * </script>
+ *
+ * {#if $isLoading}
+ *   <div>Loading…</div>
+ * {:else if $error}
+ *   <div>{$error.message}</div>
+ * {:else}
+ *   <div>{$data?.name}</div>
+ * {/if}
+ * ```
+ */
+export declare function useQuery<T>(config: UseQueryConfig<T>, client?: QueryClient): UseQueryReturn<T>;
+/**
+ * Svelte store factory for mutations (POST/PUT/PATCH/DELETE).
+ * Does not cache — returns a `mutate` function that executes the mutation.
+ *
+ * @param config - Mutation configuration.
+ * @returns Readable stores plus `{ mutate, reset }`.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useMutation, useQueryClient } from "katanakit-js/adapters/svelte";
+ *   import { usePost } from "katanakit-js";
+ *
+ *   const qc = useQueryClient();
+ *   const { mutate, isLoading } = useMutation({
+ *     mutationFn: (name: string) => usePost("api", "createUser", { name }),
+ *     onSuccess: () => qc.invalidateQueries({ queryKey: ["users"] }),
+ *   });
+ * </script>
+ * ```
+ */
+export declare function useMutation<TData = unknown, TVariables = unknown>(config: UseMutationConfig<TData, TVariables>): UseMutationReturn<TData, TVariables>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/adapters/svelte/query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAC;AAEvD,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,2DAA2D;AAC3D,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,oEAAoE;AACpE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,KAAK,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1C,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,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC7B,KAAK,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IAC3D,4BAA4B;IAC5B,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,gCAAgC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CAgE9F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;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"}