katanakit-js 3.2.2 → 4.0.3

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,5 @@
+export { useCreateQueryClient, useInitQueryClient, useQueryClient, useSafeQueryFn, } from "../../core/services/query.service.js";
+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,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACd,MAAM,sCAAsC,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/adapters/solid/index.js

@@ -0,0 +1,5 @@
+export { useCreateQueryClient, useInitQueryClient, useQueryClient, useSafeQueryFn, } from "../../core/services/query.service.js";
+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,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACd,MAAM,sCAAsC,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,60 @@
+import { type MutationObserverOptions, type MutationObserverResult, type QueryClient, type QueryObserverOptions, type QueryObserverResult } from "@tanstack/query-core";
+/** Options for the Solid binding: a plain object or a reactive getter. */
+export type SolidQueryOptions<TQueryFnData, TError, TData> = QueryObserverOptions<TQueryFnData, TError, TData> | (() => QueryObserverOptions<TQueryFnData, TError, TData>);
+/**
+ * Solid primitive for a cached query, backed by TanStack Query Core.
+ *
+ * Returns a reactive {@link QueryObserverResult} store — read `query.data`,
+ * `query.isPending`, `query.isError`, `query.status`, etc. directly. Pass a
+ * getter (`() => ({ queryKey, queryFn })`) to react to key changes.
+ *
+ * Call it inside a component or `createRoot` so `onCleanup` disposes the observer.
+ *
+ * @param options - TanStack query options, or a getter returning them.
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns A reactive {@link QueryObserverResult} store.
+ *
+ * @example
+ * ```tsx
+ * import { Show } from "solid-js";
+ * import { useQuery, useSafeQueryFn } from "katanakit-js/adapters/solid";
+ * import { useGetApi } from "katanakit-js";
+ *
+ * function Pokemon() {
+ *   const query = useQuery(() => ({
+ *     queryKey: ["pokemon", 25],
+ *     queryFn: useSafeQueryFn(() => useGetApi("pokeapi", "pokemonById", { params: { id: 25 } })),
+ *   }));
+ *   return (
+ *     <Show when={!query.isPending} fallback={<div>Loading…</div>}>
+ *       <div>{query.data?.name}</div>
+ *     </Show>
+ *   );
+ * }
+ * ```
+ */
+export declare function useQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData>(options: SolidQueryOptions<TQueryFnData, TError, TData>, client?: QueryClient): QueryObserverResult<TData, TError>;
+/**
+ * Solid primitive for a mutation, backed by TanStack Query Core.
+ *
+ * @param options - TanStack mutation options, or a getter returning them.
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns A reactive {@link MutationObserverResult} store.
+ *
+ * @example
+ * ```tsx
+ * import { useMutation, useQueryClient } from "katanakit-js/adapters/solid";
+ * import { usePost } from "katanakit-js";
+ *
+ * function CreateUser() {
+ *   const qc = useQueryClient();
+ *   const mutation = useMutation(() => ({
+ *     mutationFn: (name: string) => usePost("api", "createUser", { name }),
+ *     onSuccess: () => qc.invalidateQueries({ queryKey: ["users"] }),
+ *   }));
+ *   return <button disabled={mutation.isPending} onClick={() => mutation.mutate("Ada")}>Create</button>;
+ * }
+ * ```
+ */
+export declare function useMutation<TData = unknown, TError = Error, TVariables = void, TContext = unknown>(options: MutationObserverOptions<TData, TError, TVariables, TContext> | (() => MutationObserverOptions<TData, TError, TVariables, TContext>), client?: QueryClient): MutationObserverResult<TData, TError, TVariables, TContext>;
+//# 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,EAEN,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAEhB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,MAAM,sBAAsB,CAAC;AAM9B,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,IACtD,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,GACjD,CAAC,MAAM,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,QAAQ,CAAC,YAAY,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,KAAK,GAAG,YAAY,EACpF,OAAO,EAAE,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EACvD,MAAM,CAAC,EAAE,WAAW,GAClB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAsBpC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,OAAO,EACjG,OAAO,EACJ,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,GAC5D,CAAC,MAAM,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,EACvE,MAAM,CAAC,EAAE,WAAW,GAClB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAqB7D"}

package/dist/adapters/solid/query.js

@@ -0,0 +1,88 @@
+import { MutationObserver, QueryObserver, } from "@tanstack/query-core";
+import { createEffect, onCleanup } from "solid-js";
+import { createStore } from "solid-js/store";
+import { useQueryClient } from "../../core/services/query.service.js";
+/**
+ * Solid primitive for a cached query, backed by TanStack Query Core.
+ *
+ * Returns a reactive {@link QueryObserverResult} store — read `query.data`,
+ * `query.isPending`, `query.isError`, `query.status`, etc. directly. Pass a
+ * getter (`() => ({ queryKey, queryFn })`) to react to key changes.
+ *
+ * Call it inside a component or `createRoot` so `onCleanup` disposes the observer.
+ *
+ * @param options - TanStack query options, or a getter returning them.
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns A reactive {@link QueryObserverResult} store.
+ *
+ * @example
+ * ```tsx
+ * import { Show } from "solid-js";
+ * import { useQuery, useSafeQueryFn } from "katanakit-js/adapters/solid";
+ * import { useGetApi } from "katanakit-js";
+ *
+ * function Pokemon() {
+ *   const query = useQuery(() => ({
+ *     queryKey: ["pokemon", 25],
+ *     queryFn: useSafeQueryFn(() => useGetApi("pokeapi", "pokemonById", { params: { id: 25 } })),
+ *   }));
+ *   return (
+ *     <Show when={!query.isPending} fallback={<div>Loading…</div>}>
+ *       <div>{query.data?.name}</div>
+ *     </Show>
+ *   );
+ * }
+ * ```
+ */
+export function useQuery(options, client) {
+    const queryClient = client ?? useQueryClient();
+    const getOptions = typeof options === "function" ? options : () => options;
+    const observer = new QueryObserver(queryClient, queryClient.defaultQueryOptions(getOptions()));
+    const [state, setState] = createStore(observer.getCurrentResult());
+    const unsubscribe = observer.subscribe((result) => {
+        setState(result);
+    });
+    // Re-apply options whenever the reactive getter's dependencies change.
+    createEffect(() => {
+        observer.setOptions(queryClient.defaultQueryOptions(getOptions()));
+    });
+    onCleanup(unsubscribe);
+    return state;
+}
+/**
+ * Solid primitive for a mutation, backed by TanStack Query Core.
+ *
+ * @param options - TanStack mutation options, or a getter returning them.
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns A reactive {@link MutationObserverResult} store.
+ *
+ * @example
+ * ```tsx
+ * import { useMutation, useQueryClient } from "katanakit-js/adapters/solid";
+ * import { usePost } from "katanakit-js";
+ *
+ * function CreateUser() {
+ *   const qc = useQueryClient();
+ *   const mutation = useMutation(() => ({
+ *     mutationFn: (name: string) => usePost("api", "createUser", { name }),
+ *     onSuccess: () => qc.invalidateQueries({ queryKey: ["users"] }),
+ *   }));
+ *   return <button disabled={mutation.isPending} onClick={() => mutation.mutate("Ada")}>Create</button>;
+ * }
+ * ```
+ */
+export function useMutation(options, client) {
+    const queryClient = client ?? useQueryClient();
+    const getOptions = typeof options === "function" ? options : () => options;
+    const observer = new MutationObserver(queryClient, getOptions());
+    const [state, setState] = createStore(observer.getCurrentResult());
+    const unsubscribe = observer.subscribe((result) => {
+        setState(result);
+    });
+    createEffect(() => {
+        observer.setOptions(getOptions());
+    });
+    onCleanup(unsubscribe);
+    return state;
+}
+//# 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,EACN,gBAAgB,EAIhB,aAAa,GAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAOtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,QAAQ,CACvB,OAAuD,EACvD,MAAoB;IAEpB,MAAM,WAAW,GAAG,MAAM,IAAI,cAAc,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAmB,EAAE,CAAC,OAAO,CAAC;IAE3F,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAE/F,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,WAAW,CACpC,QAAQ,CAAC,gBAAgB,EAAE,CAC3B,CAAC;IAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;QACjD,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,YAAY,CAAC,GAAG,EAAE;QACjB,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CAC1B,OAEuE,EACvE,MAAoB;IAEpB,MAAM,WAAW,GAAG,MAAM,IAAI,cAAc,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAmB,EAAE,CAAC,OAAO,CAAC;IAE3F,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAEjE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,WAAW,CACpC,QAAQ,CAAC,gBAAgB,EAAE,CAC3B,CAAC;IAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;QACjD,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,YAAY,CAAC,GAAG,EAAE;QACjB,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO,KAAK,CAAC;AACd,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,5 @@
+export { useCreateQueryClient, useInitQueryClient, useQueryClient, useSafeQueryFn, } from "../../core/services/query.service.js";
+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,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACd,MAAM,sCAAsC,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/adapters/svelte/index.js

@@ -0,0 +1,5 @@
+export { useCreateQueryClient, useInitQueryClient, useQueryClient, useSafeQueryFn, } from "../../core/services/query.service.js";
+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,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACd,MAAM,sCAAsC,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,60 @@
+import { type MutationObserverOptions, type MutationObserverResult, type QueryClient, type QueryObserverOptions, type QueryObserverResult } from "@tanstack/query-core";
+import { type Readable } from "svelte/store";
+/**
+ * Svelte store factory for a cached query, backed by TanStack Query Core.
+ *
+ * Returns a `Readable` of TanStack's {@link QueryObserverResult}. Subscribe
+ * with `$query` — `$query.data`, `$query.isPending`, `$query.isError`,
+ * `$query.status`, etc.
+ *
+ * @param options - TanStack query options (`queryKey`, `queryFn`, `staleTime`, …).
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns A `Readable` of the TanStack {@link QueryObserverResult}.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useQuery, useSafeQueryFn } from "katanakit-js/adapters/svelte";
+ *   import { useGetApi } from "katanakit-js";
+ *
+ *   const query = useQuery({
+ *     queryKey: ["pokemon", 25],
+ *     queryFn: useSafeQueryFn(() => useGetApi("pokeapi", "pokemonById", { params: { id: 25 } })),
+ *   });
+ * </script>
+ *
+ * {#if $query.isPending}
+ *   <div>Loading…</div>
+ * {:else if $query.isError}
+ *   <div>{$query.error?.message}</div>
+ * {:else}
+ *   <div>{$query.data?.name}</div>
+ * {/if}
+ * ```
+ */
+export declare function useQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData>(options: QueryObserverOptions<TQueryFnData, TError, TData>, client?: QueryClient): Readable<QueryObserverResult<TData, TError>>;
+/**
+ * Svelte store factory for a mutation, backed by TanStack Query Core.
+ *
+ * @param options - TanStack mutation options (`mutationFn`, `onSuccess`, …).
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns A `Readable` of the TanStack {@link MutationObserverResult}.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useMutation, useQueryClient } from "katanakit-js/adapters/svelte";
+ *   import { usePost } from "katanakit-js";
+ *
+ *   const qc = useQueryClient();
+ *   const mutation = useMutation({
+ *     mutationFn: (name: string) => usePost("api", "createUser", { name }),
+ *     onSuccess: () => qc.invalidateQueries({ queryKey: ["users"] }),
+ *   });
+ * </script>
+ *
+ * <button disabled={$mutation.isPending} on:click={() => $mutation.mutate("Ada")}>Create</button>
+ * ```
+ */
+export declare function useMutation<TData = unknown, TError = Error, TVariables = void, TContext = unknown>(options: MutationObserverOptions<TData, TError, TVariables, TContext>, client?: QueryClient): Readable<MutationObserverResult<TData, TError, TVariables, TContext>>;
+//# 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":"AAAA,OAAO,EAEN,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAEhB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAC;AAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,QAAQ,CAAC,YAAY,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,KAAK,GAAG,YAAY,EACpF,OAAO,EAAE,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAC1D,MAAM,CAAC,EAAE,WAAW,GAClB,QAAQ,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAS9C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,OAAO,EACjG,OAAO,EAAE,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EACrE,MAAM,CAAC,EAAE,WAAW,GAClB,QAAQ,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAavE"}