katanakit-js 4.0.2 → 4.0.3

package/dist/core/services/query.service.js

@@ -1,389 +1,110 @@
-// ============================================================
-// Helpers
-// ============================================================
-const FIVE_MINUTES = 5 * 60 * 1_000;
-function hashQueryKey(key) {
-    return JSON.stringify(key, (_, v) => typeof v === "object" && v !== null && !Array.isArray(v)
-        ? Object.keys(v)
-            .sort()
-            .reduce((sorted, k) => {
-            sorted[k] = v[k];
-            return sorted;
-        }, {})
-        : v);
-}
-function delayMs(base, attempt) {
-    return Math.min(base * 2 ** attempt, 30_000);
-}
-function isKeyPrefix(prefix, key) {
-    if (prefix.length > key.length)
-        return false;
-    return prefix.every((part, index) => part === key[index]);
-}
-// ============================================================
-// QueryCache — manages individual query entries
-// ============================================================
-class QueryCache {
-    entries = new Map();
-    get(hash) {
-        return this.entries.get(hash);
-    }
-    set(hash, entry) {
-        this.entries.set(hash, entry);
-    }
-    delete(hash) {
-        const entry = this.entries.get(hash);
-        if (entry?.gcTimeout)
-            clearTimeout(entry.gcTimeout);
-        this.entries.delete(hash);
-    }
-    entries_() {
-        return this.entries;
-    }
-    scheduleGC(hash, cacheTime) {
-        const entry = this.get(hash);
-        if (!entry || entry.subscriberCount > 0)
-            return;
-        entry.gcTimeout = setTimeout(() => {
-            this.delete(hash);
-        }, cacheTime);
-    }
-    cancelGC(hash) {
-        const entry = this.get(hash);
-        if (entry?.gcTimeout) {
-            clearTimeout(entry.gcTimeout);
-            entry.gcTimeout = null;
-        }
-    }
-}
-// ============================================================
-// QueryClient — the main public API
-// ============================================================
-export class QueryClient {
-    cache;
-    defaults;
-    constructor(config = {}) {
-        this.cache = new QueryCache();
-        this.defaults = config.defaultOptions ?? {};
-    }
-    // ----------------------------------------------------------
-    // Core: fetchQuery
-    // ----------------------------------------------------------
-    /**
-     * Fetches data for a query key, using the cache when possible.
-     * Returns the cached data immediately if fresh, then optionally
-     * refetches in the background (stale-while-revalidate).
-     */
-    async fetchQuery(config) {
-        const mergedConfig = this.mergeDefaults(config);
-        const hash = hashQueryKey(mergedConfig.queryKey);
-        let entry = this.cache.get(hash);
-        if (!entry) {
-            entry = this.createEntry(mergedConfig);
-            this.cache.set(hash, entry);
-        }
-        else {
-            // `subscribe()` may have created a placeholder entry whose `queryFn`
-            // returns an empty result. Always refresh the config with the real one.
-            entry.config = mergedConfig;
-        }
-        // Cancel GC if the entry was scheduled for removal.
-        this.cache.cancelGC(hash);
-        // A new fetch supersedes any prior cancellation.
-        entry.cancelled = false;
-        // If data is fresh, return it immediately.
-        if (entry.state.status === "success" && !this.isStale(entry)) {
-            return entry.state.data;
-        }
-        // If a fetch is already in flight, deduplicate.
-        if (entry.fetchPromise) {
-            const result = await entry.fetchPromise;
-            if (result.ok)
-                return result.data;
-            throw result.error;
-        }
-        // Execute fetch.
-        return this.executeFetch(entry, hash);
-    }
-    /**
-     * Prefetches data into the cache without returning it.
-     * Useful for anticipatory fetching.
-     */
-    async prefetchQuery(config) {
-        try {
-            await this.fetchQuery(config);
-        }
-        catch {
-            // Prefetch errors are silently ignored.
-        }
-    }
-    /**
-     * Returns the cached data for a query key, or undefined if not cached.
-     */
-    getQueryData(queryKey) {
-        const hash = hashQueryKey(queryKey);
-        const entry = this.cache.get(hash);
-        return entry?.state.data ?? undefined;
-    }
-    /**
-     * Sets query data directly in the cache (optimistic updates).
-     */
-    setQueryData(queryKey, updater) {
-        const hash = hashQueryKey(queryKey);
-        const entry = this.cache.get(hash);
-        if (!entry)
-            return;
-        const oldData = entry.state.data;
-        const newData = typeof updater === "function" ? updater(oldData) : updater;
-        entry.state = {
-            ...entry.state,
-            data: newData,
-            status: "success",
-            dataUpdatedAt: Date.now(),
-            isLoading: false,
-            isSuccess: true,
-            isError: false,
-        };
-        this.notifyObservers(entry);
-    }
-    /**
-     * Marks queries matching the filter as stale and optionally refetches
-     * active queries.
-     */
-    async invalidateQueries(filters) {
-        const prefixKey = filters?.queryKey;
-        for (const entry of this.cache.entries_().values()) {
-            const entryKey = entry.config.queryKey;
-            if (prefixKey && !isKeyPrefix(prefixKey, entryKey))
-                continue;
-            entry.state.isStale = true;
-            this.notifyObservers(entry);
-        }
-    }
-    /**
-     * Removes a query from the cache.
-     */
-    removeQueries(queryKey) {
-        const hash = hashQueryKey(queryKey);
-        this.cache.delete(hash);
-    }
-    /**
-     * Clears the entire cache.
-     */
-    clear() {
-        for (const [hash] of this.cache.entries_()) {
-            this.cache.delete(hash);
-        }
-    }
-    /**
-     * Returns the current state of a cached query (reactive signal).
-     * Subscribes to future updates.
-     */
-    getQueryState(queryKey) {
-        const hash = hashQueryKey(queryKey);
-        const entry = this.cache.get(hash);
-        return entry?.state;
-    }
-    /**
-     * Subscribes to state changes for a specific query.
-     * Returns an unsubscribe function.
-     */
-    subscribe(queryKey, observer) {
-        const hash = hashQueryKey(queryKey);
-        let entry = this.cache.get(hash);
-        if (!entry) {
-            entry = this.createEntry({
-                queryKey,
-                queryFn: () => Promise.resolve({ data: null, error: null, url: "", status: 0, ok: true }),
-            });
-            this.cache.set(hash, entry);
-        }
-        entry.observers.add(observer);
-        entry.subscriberCount++;
-        this.cache.cancelGC(hash);
-        const captured = entry;
-        return () => {
-            captured.observers.delete(observer);
-            captured.subscriberCount--;
-            if (captured.subscriberCount === 0) {
-                this.cache.scheduleGC(hash, captured.config.cacheTime ?? FIVE_MINUTES);
-            }
-        };
-    }
-    /**
-     * Cancels an in-flight request for a query.
-     *
-     * Marks the entry as cancelled; the next time its fetch resolves, the
-     * result is discarded without updating state or notifying observers.
-     */
-    cancelQueries(queryKey) {
-        const hash = hashQueryKey(queryKey);
-        const entry = this.cache.get(hash);
-        if (!entry)
-            return;
-        entry.cancelled = true;
-        entry.fetchPromise = null;
-    }
-    // ----------------------------------------------------------
-    // Internal
-    // ----------------------------------------------------------
-    mergeDefaults(config) {
-        const qDefaults = this.defaults?.queries ?? {};
-        return {
-            staleTime: 0,
-            cacheTime: FIVE_MINUTES,
-            retry: 3,
-            retryDelay: 1000,
-            refetchOnWindowFocus: true,
-            refetchOnReconnect: true,
-            enabled: true,
-            ...qDefaults,
-            ...config,
-        };
-    }
-    createEntry(config) {
-        return {
-            state: {
-                status: "idle",
-                data: null,
-                error: null,
-                isLoading: false,
-                isSuccess: false,
-                isError: false,
-                isStale: true,
-                dataUpdatedAt: 0,
-                errorUpdatedAt: 0,
-                fetchCount: 0,
-            },
-            config,
-            observers: new Set(),
-            gcTimeout: null,
-            retryCount: 0,
-            fetchPromise: null,
-            subscriberCount: 0,
-            cancelled: false,
-        };
-    }
-    isStale(entry) {
-        if (entry.state.isStale)
-            return true;
-        const staleTime = entry.config.staleTime ?? 0;
-        if (staleTime === Infinity)
-            return false;
-        return Date.now() - entry.state.dataUpdatedAt > staleTime;
-    }
-    async executeFetch(entry, hash) {
-        const maxRetries = entry.config.retry ?? 3;
-        const baseDelay = entry.config.retryDelay ?? 1000;
-        entry.state = {
-            ...entry.state,
-            status: "loading",
-            isLoading: true,
-            fetchCount: entry.state.fetchCount + 1,
-        };
-        this.notifyObservers(entry);
-        const fetchWithRetry = async (attempt) => {
-            const result = await entry.config.queryFn();
-            if (!result.ok && attempt < maxRetries) {
-                await new Promise((r) => setTimeout(r, delayMs(baseDelay, attempt)));
-                entry.retryCount = attempt + 1;
-                return fetchWithRetry(attempt + 1);
-            }
-            return result;
-        };
-        const fetchPromise = fetchWithRetry(0);
-        entry.fetchPromise = fetchPromise;
-        let result;
-        try {
-            result = await fetchPromise;
-        }
-        catch (err) {
-            entry.fetchPromise = null;
-            const error = err instanceof Error
-                ? { message: err.message, status: 0 }
-                : { message: String(err), status: 0 };
-            this.applyError(entry, hash, error);
-            throw error;
-        }
-        entry.fetchPromise = null;
-        // Cancellation wins over result application.
-        if (entry.cancelled) {
-            return Promise.reject({
-                message: "Query cancelled",
-                status: 0,
-            });
-        }
-        // If the entry was removed or superseded, discard.
-        if (this.cache.get(hash) !== entry) {
-            return result.ok ? result.data : Promise.reject(result.error);
-        }
-        if (result.ok) {
-            entry.state = {
-                status: "success",
-                data: result.data,
-                error: null,
-                isLoading: false,
-                isSuccess: true,
-                isError: false,
-                isStale: false,
-                dataUpdatedAt: Date.now(),
-                errorUpdatedAt: entry.state.errorUpdatedAt,
-                fetchCount: entry.state.fetchCount,
-            };
-            entry.retryCount = 0;
-            entry.config.onSuccess?.(result.data);
-            this.notifyObservers(entry);
-            return result.data;
-        }
-        this.applyError(entry, hash, result.error);
-        entry.config.onError?.(result.error);
-        throw result.error;
-    }
-    applyError(entry, hash, error) {
-        if (this.cache.get(hash) !== entry)
-            return;
-        entry.state = {
-            ...entry.state,
-            status: "error",
-            error,
-            isLoading: false,
-            isSuccess: false,
-            isError: true,
-            errorUpdatedAt: Date.now(),
-        };
-        this.notifyObservers(entry);
-    }
-    notifyObservers(entry) {
-        for (const observer of entry.observers) {
-            try {
-                observer(entry.state);
-            }
-            catch {
-                // Observer errors are swallowed.
-            }
-        }
-    }
-}
-// ============================================================
-// Singleton facade
-// ============================================================
+import { QueryClient, } from "@tanstack/query-core";
+/**
+ * Query engine — a thin facade over {@link https://tanstack.com/query | TanStack Query Core}.
+ *
+ * The full `@tanstack/query-core` API is re-exported from here (and therefore
+ * from `katanakit-js`), so consumers get TanStack's cache, retries, stale-while-
+ * revalidate, focus/reconnect refetch, garbage collection and infinite queries
+ * without installing TanStack separately.
+ */
+export * from "@tanstack/query-core";
+/** Module-level {@link QueryClient} singleton shared by every adapter (browser). */
 let instance = null;
 /**
- * Returns the global {@link QueryClient} singleton.
- * Creates one with default options on first call.
+ * Creates a **new** {@link QueryClient}. Use this on the server (SSR) to get one
+ * client per request and avoid sharing a process-global cache across users.
+ *
+ * @param config - TanStack {@link QueryClientConfig} (caches, default options).
+ * @returns A fresh {@link QueryClient}.
+ *
+ * @example
+ * ```ts
+ * // Server: one client per request, then dehydrate/hydrate.
+ * const client = useCreateQueryClient();
+ * await client.prefetchQuery({ queryKey, queryFn });
+ * const state = dehydrate(client);
+ * ```
+ */
+export function useCreateQueryClient(config = {}) {
+    return new QueryClient(config);
+}
+/**
+ * Returns the shared {@link QueryClient} singleton, creating one on first call.
+ *
+ * This is a **process-global** instance: it is the right default in the browser,
+ * but on the server it would leak cached data across requests. Use
+ * {@link useCreateQueryClient} per request when running under SSR.
+ *
+ * @returns The shared {@link QueryClient}.
+ *
+ * @example
+ * ```ts
+ * import { useQueryClient } from "katanakit-js";
+ *
+ * const client = useQueryClient();
+ * await client.invalidateQueries({ queryKey: ["users"] });
+ * ```
  */
 export function useQueryClient() {
-    if (!instance) {
-        instance = new QueryClient();
-    }
-    return instance;
+    return (instance ??= new QueryClient());
 }
 /**
- * Initialises the global {@link QueryClient} singleton with custom options.
- * Must be called before any `useQuery` call.
+ * Replaces the shared {@link QueryClient} singleton with a configured instance.
+ * The previous client's caches are cleared before swapping.
+ *
+ * @param config - TanStack {@link QueryClientConfig} (caches, default options).
+ * @returns The newly created {@link QueryClient}.
+ *
+ * @example
+ * ```ts
+ * import { useInitQueryClient } from "katanakit-js";
+ *
+ * useInitQueryClient({
+ *   defaultOptions: { queries: { staleTime: 60_000, retry: 2 } },
+ * });
+ * ```
  */
-export function useInitQueryClient(config) {
+export function useInitQueryClient(config = {}) {
+    instance?.clear();
     instance = new QueryClient(config);
     return instance;
 }
+/**
+ * Bridges a KatanaKit Safe Result fetcher into a TanStack `queryFn`.
+ *
+ * TanStack expects `queryFn` to resolve with data and **throw** on failure;
+ * KatanaKit returns `{ data, error, ok }`. This adapter unwraps the Safe Result
+ * so the two fit together. Throws a real `Error` (with `status`) so `instanceof`
+ * checks and error boundaries work; the upstream response body is **not** placed
+ * on the thrown error.
+ *
+ * Receives TanStack's {@link QueryFunctionContext}, so you can forward
+ * `signal` for real request cancellation.
+ *
+ * @typeParam T - The resolved data type.
+ * @param fn - A function returning a Safe Result (e.g. `() => useGetApi(...)`).
+ * @returns A `queryFn` that throws on error.
+ *
+ * @example
+ * ```ts
+ * import { useSafeQueryFn, useGetApi, useFetch } from "katanakit-js";
+ *
+ * // Simple: the Safe Result gate.
+ * queryFn: useSafeQueryFn(() => useGetApi("pokeapi", "pokemonById", { params: { id } }))
+ *
+ * // With cancellation: forward TanStack's AbortSignal into the request.
+ * queryFn: useSafeQueryFn(({ signal }) =>
+ *   useFetch("pokeapi", "pokemonById", { method: "GET", urlOptions: { params: { id } }, signal }),
+ * )
+ * ```
+ */
+export function useSafeQueryFn(fn) {
+    return async (context) => {
+        const result = await fn(context);
+        if (!result.ok) {
+            throw Object.assign(new Error(result.error.message), { status: result.error.status });
+        }
+        return result.data;
+    };
+}
 //# sourceMappingURL=query.service.js.map

package/dist/core/services/query.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.service.js","sourceRoot":"","sources":["../../../src/core/services/query.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query.service.js","sourceRoot":"","sources":["../../../src/core/services/query.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,GAGX,MAAM,sBAAsB,CAAC;AAI9B;;;;;;;GAOG;AACH,cAAc,sBAAsB,CAAC;AAErC,oFAAoF;AACpF,IAAI,QAAQ,GAAuB,IAAI,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA4B,EAAE;IAClE,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,CAAC,QAAQ,KAAK,IAAI,WAAW,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA4B,EAAE;IAChE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,QAAQ,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,cAAc,CAC7B,EAA8D;IAE9D,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,MAAM,CAAC,IAAS,CAAC;IACzB,CAAC,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "katanakit-js",
-  "version": "4.0.2",
+	"version": "4.0.3",
 	"description": "KatanaKit — a sharp, framework-agnostic TypeScript service toolkit organized with hexagonal architecture.",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -82,6 +82,11 @@
 			"import": "./dist/adapters/angular/index.js",
 			"default": "./dist/adapters/angular/index.js"
 		},
+		"./adapters/vanilla": {
+			"types": "./dist/adapters/vanilla/index.d.ts",
+			"import": "./dist/adapters/vanilla/index.js",
+			"default": "./dist/adapters/vanilla/index.js"
+		},
 		"./prisma": {
 			"types": "./dist/prisma/index.d.ts",
 			"import": "./dist/prisma/index.js",
@@ -113,6 +118,7 @@
 		"whatsapp:dev": "tsx src/adapters/whatsapp/main.ts",
 		"clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
 		"check": "eslint ./src && tsc6 --noEmit && vitest run",
+		"examples:check": "tsc6 -p tsconfig.examples.json && tsc6 -p tsconfig.examples.solid.json",
 		"fix": "eslint --fix ./src && tsc6 --noEmit && vitest run",
 		"build": "bun run clean && bun run check && tsc6 -p tsconfig.json",
 		"release": "bun run build && bun run bump:patch && npm publish --access public && git push && git push --tags && node scripts/generate-release-notes.mjs \"v$(node -p \"require('./package.json').version\")\" | gh release create \"v$(node -p \"require('./package.json').version\")\" --notes-file -",
@@ -132,7 +138,7 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "git@github.com:senseikatana/katanakit.git"
+		"url": "git+https://github.com/senseikatana/katanakit-js.git"
 	},
 	"keywords": [
 		"api",
@@ -158,13 +164,14 @@
 	"author": "senseikatana - Sergio Jurado",
 	"license": "MIT",
 	"bugs": {
-		"url": "https://github.com/senseikatana/katanakit/issues"
+		"url": "https://github.com/senseikatana/katanakit-js/issues"
 	},
 	"unpkg": "./dist/index.js",
 	"jsdelivr": "./dist/index.js",
 	"dependencies": {
 		"@js-temporal/polyfill": "0.5.1",
 		"@prisma/orm-postgres": "8.0.0-rc.8",
+		"@tanstack/query-core": "5.103.2",
 		"express-rate-limit": "8.7.0"
 	},
 	"peerDependencies": {