AULA 10 • CONEXÃO API & SUPABASE CLIENT

Criamos a pasta do projeto, inicializamos o package.json e instalamos as três dependências fundamentais: o servidor express, o pacote dotenv (que lê o arquivo .env) e o SDK oficial @supabase/supabase-js.

mkdir aula10-supabase-api
cd aula10-supabase-api
npm init -y
npm install express dotenv @supabase/supabase-js

Confira como deve ficar o seu package.json com o script start configurado para iniciar o arquivo server.js:

{
  "name": "aula10-supabase-api",
  "version": "1.0.0",
  "description": "Conexao Segura API Express + Supabase Client com Cofre .env",
  "main": "server.js",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "@supabase/supabase-js": "^2.45.0",
    "dotenv": "^16.4.5",
    "express": "^4.19.2"
  }
}

Assim que criar o .env, crie imediatamente o arquivo .gitignore na raiz do projeto. Note que no VS Code o arquivo .env ficará acinzentado, provando que está protegido contra uploads acidentais:

# Ignorar pasta de pacotes pesados do Node.js
node_modules/

# Ignorar rigorosamente o Cofre Digital de variaveis de ambiente
.env
.env.local
.env.production

# Ignorar logs do sistema
npm-debug.log*

Seguindo a arquitetura limpa, isolamos a conexão do banco em src/config/supabaseClient.js. Este módulo carrega os segredos via process.env, valida se eles existem e exporta a instância pronta para toda a aplicação:

// 1. Carrega as variáveis do arquivo .env para a memória (process.env)
require('dotenv').config();

// 2. Importa a função fábrica 'createClient' do SDK oficial do Supabase
const { createClient } = require('@supabase/supabase-js');

// 3. Resgata as credenciais de dentro do Cofre Digital (.env)
const supabaseUrl = process.env.SUPABASE_URL;
const supabaseKey = process.env.SUPABASE_KEY;

// 4. Validação de Segurança: impede que o servidor suba sem as chaves
if (!supabaseUrl || !supabaseKey) {
    console.error('❌ [ERRO CRÍTICO DE SEGURANÇA]: SUPABASE_URL ou SUPABASE_KEY não encontradas no arquivo .env!');
    console.error('Verifique se o arquivo .env está na raiz do projeto e sem espaços ao redor do sinal de =.');
    process.exit(1);
}

// 5. Instancia a ponte oficial de comunicação com a nuvem do Supabase
const supabase = createClient(supabaseUrl, supabaseKey);

console.log('✅ [SUPABASE SDK]: Ponte de comunicação instanciada com segurança!');

// 6. Exporta a instância única para ser reutilizada em rotas e controllers
module.exports = supabase;

Agora conectamos nossa ponte ao server.js e criamos uma rota GET /api/status que comprova que o cliente do Supabase foi carregado sem jamais revelar a chave secreta na resposta JSON:

require('dotenv').config();
const express = require('express');

// Importa a ponte configurada e segura do Supabase
const supabase = require('./src/config/supabaseClient');

const app = express();
app.use(express.json());

const PORT = process.env.PORT || 3000;

// Rota principal de diagnóstico de segurança e conexão
app.get('/api/status', (req, res) => {
    // Verifica se o objeto supabase possui os módulos internos carregados
    const clienteAtivo = Boolean(supabase && supabase.auth && supabase.rest);

    res.status(200).json({
        sistema: "API Back-End I - Controle de Acesso",
        status_servidor: "ONLINE",
        ponte_supabase_sdk: clienteAtivo ? "CONECTADA" : "FALHA",
        ambiente: process.env.AMBIENTE_EXECUCAO || "padrao",
        seguranca_cofre_env: {
            url_configurada: Boolean(process.env.SUPABASE_URL),
            chave_protegida_no_cofre: Boolean(process.env.SUPABASE_KEY),
            chave_exposta_no_codigo: false
        },
        mensagem: "Infraestrutura pronta para operações no banco na nuvem!"
    });
});

app.listen(PORT, () => {
    console.log('====================================================');
    console.log(`🚀 Servidor Express rodando em: http://localhost:${PORT}`);
    console.log(`🔍 Teste o status em: http://localhost:${PORT}/api/status`);
    console.log('🔒 Inspecionando objeto Supabase Client no terminal:');
    console.log(typeof supabase === 'object' ? 'Objeto Supabase instanciado com sucesso!' : 'Erro ao instanciar');
    console.log('====================================================');
});