@tabl.io/auth 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { JSX } from 'react/jsx-runtime';
 import { PersistOptions } from 'zustand/middleware';
+import { QueryClient } from '@tanstack/react-query';
+import { QueryClientConfig } from '@tanstack/react-query';
 import { ReactNode } from 'react';
 import { StoreApi } from 'zustand';
 import { SupabaseClient } from '@supabase/supabase-js';
@@ -21,6 +23,28 @@ export declare interface AuthState {
     signOut: (supabase: SupabaseClient) => Promise<void>;
 }
 
+/**
+ * Cria um QueryClient com tratamento centralizado de token JWT expirado.
+ *
+ * Comportamento ao detectar erro de token:
+ * 1. Tenta renovar a sessão via `supabase.auth.refreshSession()` (uma única
+ *    tentativa — requisições simultâneas são deduplicadas).
+ * 2. Sucesso → invalida as queries afetadas para refetch transparente.
+ * 3. Falha → chama `supabase.auth.signOut()`. O `onAuthStateChange` existente
+ *    no `useAuthStore.init()` detecta o evento e reseta o estado, fazendo o
+ *    App re-renderizar para a LoginPage sem nenhum código extra.
+ *
+ * @example
+ * // main.tsx
+ * import { supabase } from './api/supabase'
+ * import { createAuthAwareQueryClient } from '@tabl.io/auth'
+ *
+ * const queryClient = createAuthAwareQueryClient(supabase, {
+ *   defaultOptions: { queries: { staleTime: 0, gcTime: 0 } },
+ * })
+ */
+export declare function createAuthAwareQueryClient(supabase: SupabaseClient, options?: Omit<QueryClientConfig, 'queryCache'>): QueryClient;
+
 /**
  * Cria um cliente Supabase com as configurações padrão dos apps Tabl.
  * Cada app instancia o seu próprio cliente via esta factory.