@tabl.io/auth 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 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 { RealtimePostgresChangesPayload } from '@supabase/supabase-js';
 import { StoreApi } from 'zustand';
 import { SupabaseClient } from '@supabase/supabase-js';
 import { UseBoundStore } from 'zustand';
@@ -21,6 +24,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.
@@ -101,6 +126,32 @@ export declare interface LoginPageProps {
     logo?: React.ReactNode;
 }
 
+export declare type RealtimeEventType = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+
+export declare type RealtimeListener<T extends Record<string, unknown> = Record<string, unknown>> = (payload: RealtimePostgresChangesPayload<T>) => void;
+
+declare class RealtimeRegistry {
+    private readonly tables;
+    private supabase;
+    private authWatchActive;
+    /**
+     * Registra um listener para eventos de uma tabela.
+     * Canal criado no primeiro registro, destruído no último unsubscribe.
+     *
+     * IMPORTANTE: a tabela precisa estar na publication do Supabase Realtime
+     * (`ALTER PUBLICATION supabase_realtime ADD TABLE <tabela>`).
+     * Subscrever uma tabela fora da publication gera CHANNEL_ERROR em loop.
+     */
+    subscribe(supabase: SupabaseClient, table: string, event: RealtimeEventType, listener: RealtimeListener): () => void;
+    private watchAuth;
+    private reconnectAll;
+    private createChannel;
+    private dispatch;
+    private scheduleReconnect;
+}
+
+export declare const realtimeRegistry: RealtimeRegistry;
+
 /**
  * Wrapper declarativo que protege conteúdo por role.
  * Não redireciona — use `useRequireRole` para redirecionamento de rota.