@superdb/client

Drop-in replacement para @supabase/supabase-js — aponta para o SuperDB ao invés de Supabase Cloud.

Por que existir?

Aceleração de migração. Trocando 1 import:

- import { createClient } from '@supabase/supabase-js';
+ import { createClient } from '@superdb/client';

…seu código de auth funciona idêntico, agora apontando para SuperDB.

O que esta implementado (Sprint 2)

• client.auth.signUp
• client.auth.signInWithPassword
• client.auth.signInWithOtp (email)
• client.auth.verifyOtp
• client.auth.signInWithOAuth (google/github/apple)
• client.auth.signOut
• client.auth.getSession / getUser / refreshSession
• client.auth.mfa.enroll / verify / factors

Dados — implementado

• client.from(table) — query builder PostgREST real (select/insert/update/delete + eq/neq/gt/gte/lt/lte/like/ilike/is/in, order/limit/range/single, thenable). Fala com o data-plane (https://api.superdb.com.br, SEM /rest/v1), mandando o data_plane_token ES256 da sessão + Accept-Profile: proj_<slug>. Exige project: '<slug>' no createClient.
• client.rpc(fn, args) — POST /rpc/<fn> no data-plane.

Ainda stub (jogam erro com mensagem clara)

• client.storage.from(bucket) — use @supabase/storage-js apontando para https://storage.superdb.com.br.
• client.channel(name) — use @supabase/realtime-js apontando para https://realtime.superdb.com.br.

Install

bun add @superdb/client
# ou npm/pnpm/yarn

Quickstart

import { createClient } from '@superdb/client';

const supabase = createClient('https://acme.superdb.com.br', 'anon-key', {
  project: 'acme', // X-SuperDB-Project header
});

const { data, error } = await supabase.auth.signInWithPassword({
  email: '[email protected]',
  password: 'senha-forte',
});

const { data: { session } } = await supabase.auth.getSession();

Compat shape

Pra que codigo que usa import type { SupabaseClient } from '@supabase/supabase-js' ainda compile, exportamos os mesmos tipos com nomes alinhados:

import type { SupabaseClient, Session, User, AuthError } from '@superdb/client';

User é o SuperDBUser reexportado.

License

MIT — (c) 2026 SuperDB