katanakit-js 6.2.0 → 6.6.1

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

@@ -8,8 +8,133 @@ import { QueryClient, } from "@tanstack/query-core";
  * without installing TanStack separately.
  */
 export * from "@tanstack/query-core";
-/** Module-level {@link QueryClient} singleton shared by every adapter (browser). */
-let instance = null;
+/**
+ * QueryClientFactory - Factory Pattern para crear instancias de QueryClient.
+ *
+ * Centraliza la creación de clientes: `create()` fabrica un cliente nuevo
+ * (por petición en SSR) y `createShared()` reemplaza el singleton compartido.
+ * El resto del código no llama `new QueryClient()` directamente, así que la
+ * política de creación vive en un único punto (Open/Closed).
+ *
+ * @example
+ * ```ts
+ * // SSR: un cliente por petición
+ * const client = QueryClientFactory.create({ defaultOptions: { queries: { staleTime: 60_000 } } });
+ *
+ * // Browser: singleton compartido
+ * QueryClientFactory.createShared();
+ * ```
+ */
+export class QueryClientFactory {
+    /**
+     * Fabrica un **nuevo** {@link QueryClient}. Úsalo en el servidor (SSR) para
+     * obtener un cliente por petición y evitar compartir la caché global.
+     *
+     * @param config - TanStack {@link QueryClientConfig} (caches, default options).
+     * @returns Un {@link QueryClient} fresco.
+     *
+     * @example
+     * ```ts
+     * const client = QueryClientFactory.create();
+     * await client.prefetchQuery({ queryKey, queryFn });
+     * ```
+     */
+    static create(config = {}) {
+        return new QueryClient(config);
+    }
+    /**
+     * Reemplaza el singleton compartido con un cliente configurado.
+     * Limpia la caché del cliente anterior antes de intercambiarlo.
+     *
+     * @param config - TanStack {@link QueryClientConfig}.
+     * @returns El nuevo {@link QueryClient} compartido.
+     */
+    static createShared(config = {}) {
+        return QueryService.getInstance().useInit(config);
+    }
+}
+/**
+ * QueryService - Singleton para el QueryClient compartido.
+ *
+ * Aplica el patrón Singleton: una única instancia mantiene el
+ * {@link QueryClient} global que comparten todos los adaptadores de
+ * framework (browser). En SSR, usa {@link QueryClientFactory.create} para
+ * un cliente por petición.
+ *
+ * @example
+ * ```ts
+ * const client = QueryService.getInstance().useGetClient();
+ * await client.invalidateQueries({ queryKey: ["users"] });
+ * ```
+ */
+export class QueryService {
+    static instance;
+    /** Shared {@link QueryClient} singleton (browser). */
+    client = null;
+    /**
+     * Constructor privado - enforce singleton.
+     */
+    constructor() { }
+    /**
+     * Obtiene la instancia única del QueryService (Singleton).
+     *
+     * @returns La instancia única de {@link QueryService}.
+     */
+    static getInstance() {
+        if (!QueryService.instance) {
+            QueryService.instance = new QueryService();
+        }
+        return QueryService.instance;
+    }
+    /**
+     * Returns the shared {@link QueryClient}, 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 QueryClientFactory.create} per request when running under SSR.
+     *
+     * @returns The shared {@link QueryClient}.
+     */
+    useGetClient() {
+        this.client ??= QueryClientFactory.create();
+        return this.client;
+    }
+    /**
+     * Replaces the shared {@link QueryClient} 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}.
+     */
+    useInit(config = {}) {
+        this.client?.clear();
+        this.client = QueryClientFactory.create(config);
+        return this.client;
+    }
+    /**
+     * 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.
+     *
+     * @typeParam T - The resolved data type.
+     * @param fn - A function returning a Safe Result (e.g. `() => useGetApi(...)`).
+     * @returns A `queryFn` that throws on error.
+     */
+    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;
+        };
+    }
+}
 /**
  * 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.
@@ -26,7 +151,7 @@ let instance = null;
  * ```
  */
 export function useCreateQueryClient(config = {}) {
-    return new QueryClient(config);
+    return QueryClientFactory.create(config);
 }
 /**
  * Returns the shared {@link QueryClient} singleton, creating one on first call.
@@ -46,7 +171,7 @@ export function useCreateQueryClient(config = {}) {
  * ```
  */
 export function useQueryClient() {
-    return (instance ??= new QueryClient());
+    return QueryService.getInstance().useGetClient();
 }
 /**
  * Replaces the shared {@link QueryClient} singleton with a configured instance.
@@ -65,9 +190,7 @@ export function useQueryClient() {
  * ```
  */
 export function useInitQueryClient(config = {}) {
-    instance?.clear();
-    instance = new QueryClient(config);
-    return instance;
+    return QueryService.getInstance().useInit(config);
 }
 /**
  * Bridges a KatanaKit Safe Result fetcher into a TanStack `queryFn`.
@@ -99,12 +222,6 @@ export function useInitQueryClient(config = {}) {
  * ```
  */
 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;
-    };
+    return QueryService.getInstance().useSafeQueryFn(fn);
 }
 //# 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":"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"}
+{"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;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,kBAAkB;IAC9B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,CAAC,SAA4B,EAAE;QAC3C,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,SAA4B,EAAE;QACjD,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;CACD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,YAAY;IAChB,MAAM,CAAC,QAAQ,CAAe;IAEtC,sDAAsD;IAC9C,MAAM,GAAuB,IAAI,CAAC;IAE1C;;OAEG;IACH,gBAAuB,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC5B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY;QACX,IAAI,CAAC,MAAM,KAAK,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,SAA4B,EAAE;QACrC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,cAAc,CACb,EAA8D;QAE9D,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;oBACpD,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC3B,CAAC,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,IAAS,CAAC;QACzB,CAAC,CAAC;IACH,CAAC;CACD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA4B,EAAE;IAClE,OAAO,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA4B,EAAE;IAChE,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,cAAc,CAC7B,EAA8D;IAE9D,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC"}