Backend
Portabilidade de runtime
Uma custom function é um app Hono, e o Hono roda em qualquer runtime JavaScript de servidor. Se a sua função pode rodar em outro lugar além de um processo Node depende, portanto, do que o próprio arquivo dela importa e acessa.
Nada aqui é uma restrição ao que você pode escrever hoje. Toda implantação do Rebase é um processo Node, uma função que lê um arquivo ou abre um socket é uma função perfeitamente válida, e nenhum build ou deploy falha por causa disso. Isso está documentado para que a resposta seja conhecida agora, em vez de descoberta arquivo por arquivo mais tarde.
Portátil — funciona em qualquer runtime:
- Tudo o que é exportado de
@rebasepro/server/functions getDriver(c)erebase.dataAsAdmin— ambos trafegam pela mesma conexão onde quer que sejam executadosrebase.auth,rebase.storage,rebase.emailfetch,Request/Response,URL,crypto.subtle,TextEncoder— a plataforma web- Qualquer dependência que não precise do Node
Exclusivo do Node:
rebase.sql()— a conexão de proprietário do banco de dados (database owner) é um socket TCP- Um cliente Drizzle ou
pgimportado diretamente, pelo mesmo motivo - Módulos nativos do Node (built-ins):
fs,path,crypto(o módulo do Node —globalThis.cryptoé portátil),child_process, … - Pacotes construídos sobre eles:
jsonwebtoken,nodemailer,sharp,bcrypt, …
Bugs latentes em todos os runtimes — vale a pena corrigi-los independentemente disso:
- Leitura de
process.envno escopo do módulo (veja Configuração e Segredos) - Promises no padrão fire-and-forget em vez de
waitUntil - Depender de um handler continuar executando após a requisição atingir o timeout. No Node ele continua; essa é uma propriedade do processo, não uma garantia que o framework oferece
Verificando suas próprias funções
Seção intitulada “Verificando suas próprias funções”O rebase build imprime uma linha por constatação acionável e registra o veredito por função no manifesto do bundle:
{ "functions": [ { "name": "hello", "file": "backend/functions/hello.js", "portable": true }, { "name": "reports", "file": "backend/functions/reports.js", "portable": false, "requires": ["imports the Node built-in \"fs\""] } ]}O rebase doctor relata a mesma coisa sem compilar.
Se você precisar de um caminho específico para o runtime
Seção intitulada “Se você precisar de um caminho específico para o runtime”O runtimeKey() retorna "node", "workerd", "deno", "bun", "edge-light", "fastly" ou "other"; isNodeRuntime() é a verificação mais comum. Use-os para degradar recursos, não para bifurcar uma implementação — uma função que precisa de duas implementações são duas funções.
import { defineFunction, isNodeRuntime } from "@rebasepro/server/functions";
export default defineFunction((app, { rebase }) => { app.get("/stats", async (c) => { if (!isNodeRuntime()) return c.json({ error: "Not available here" }, 501); const rows = await rebase.sql("SELECT count(*) AS total FROM jobs"); return c.json({ totalJobs: Number(rows[0]?.total ?? 0) }); });});