SUPABASE_GETALL - Buscar Múltiplos Registros no Supabase

O que é este Node?

O SUPABASE_GETALL é o node responsável por buscar múltiplos registros de uma tabela Supabase com suporte a filtros, ordenação e paginação. Ele retorna uma lista de registros que atendem aos critérios especificados.

Por que este Node existe?

Em aplicações reais, raramente buscamos um único registro. Precisamos listar produtos, pedidos, usuários, etc. O SUPABASE_GETALL existe para:

Listar registros: Buscar todos os registros de uma tabela ou um subconjunto filtrado
Filtrar dados: Aplicar condições para retornar apenas registros relevantes (ex: status = 'ativo')
Ordenar resultados: Controlar ordem dos registros (crescente/decrescente por campo)
Paginar dados: Limitar quantidade de registros retornados para melhor performance
Buscar sem ID: Encontrar registros usando outros campos como critério (email, CPF, categoria, etc.)

Como funciona internamente?

Quando o SUPABASE_GETALL é executado, o sistema:

Valida configuração: Verifica se host e serviceRole do Supabase estão configurados
Cria cliente: Inicializa conexão com Supabase usando credenciais fornecidas
Monta query base: Cria SELECT * FROM tabela
Aplica filtros: Se filters fornecido, adiciona condições WHERE (ex: .eq('status', 'active'))
Aplica ordenação: Se sort fornecido, adiciona ORDER BY campo ASC/DESC
Aplica limite: Se limit fornecido e returnAll = false, adiciona LIMIT
Executa query: Busca registros do Supabase
Retorna resultado: Objeto com array rows (registros) e count (quantidade)
Salva em variável: Armazena resultado na variável especificada

Código interno (supabase.executor.ts:90-124):

private async getAllRows(
  supabase: SupabaseClient,
  table: string,
  filters: Record<string, any>,
  options: any,
  context: ExecutionContext,
): Promise<any> {
  let query = supabase.from(table).select('*');

  if (filters) {
    const replacedFilters = this.replaceObjectVariables(filters, context.variables);
    Object.entries(replacedFilters).forEach(([key, value]) => {
      query = query.eq(key, value);
    });
  }

  if (options.limit && !options.returnAll) {
    query = query.limit(parseInt(options.limit));
  }

  if (options.sort) {
    query = query.order(options.sort.field, { ascending: options.sort.ascending !== false });
  }

  const { data, error } = await query;

  if (error) {
    throw new Error(`Supabase getAll error: ${error.message}`);
  }

  return {
    rows: data,
    count: data.length,
  };
}

Quando você DEVE usar este Node?

Use SUPABASE_GETALL sempre que precisar de buscar múltiplos registros ou buscar sem saber o ID:

Casos de uso

Listar produtos de categoria: "Mostrar todos os produtos da categoria 'eletrônicos'"
Buscar pedidos pendentes: "Listar todos os pedidos com status 'pendente'"
Encontrar usuário por email: "Buscar usuário pelo email informado"
Listar últimos registros: "Mostrar os 10 últimos clientes cadastrados"
Dashboard de relatórios: "Buscar todas as vendas do mês atual"

Quando NÃO usar SUPABASE_GETALL

Buscar por ID específico: Use SUPABASE_GETROW que é otimizado para busca por ID
Filtros complexos com OR: Use queries SQL customizadas ou RPC functions do Supabase
Agregações: Use RPC functions para COUNT, SUM, AVG, etc.