Adapter padrão (BSON local)
Use o adapter local em BSON com persistência automática em .tile/database.
Adapter padrão (BSON local)
O adapter padrão é a forma mais simples de usar o Tile Database.
Ele já vem junto com @tile.js/database, grava documentos em BSON, mantém metadados em JSON e não exige nenhuma dependência externa.
Uso implícito ou explícito
import { Database } from "@tile.js/database";
const database = new Database({
dbName: "app",
});import { Database, defaultAdapter } from "@tile.js/database";
const database = new Database({
storage: defaultAdapter({
dbName: "app",
storage: "workspace",
compression: false,
}),
});Configuração do adapter
Prop
Type
Onde os arquivos ficam
workspace vs global
workspace
Salva os dados em process.cwd()/.tile/database/<dbName>.
É a opção ideal para aplicações, APIs e projetos onde os dados precisam acompanhar o diretório atual do app.
global
Salva os dados em ~/.tile/database/<dbName>.
É útil para CLIs, ferramentas de linha de comando e cenários onde você quer compartilhar a mesma base entre múltiplos projetos do mesmo usuário.
Índices e metadados
- cada campo com
unique: truegera um índice local em JSON - o schema descrito é salvo em
_schema.json - o adapter prepara a collection automaticamente na primeira utilização
Flush e encerramento do processo
O adapter local acumula operações de escrita/remoção e faz flush assíncrono. Chamar database.disconnect() é a forma mais segura de garantir persistência antes do encerramento da aplicação.
Quando usar
- protótipos e MVPs
- CLIs e automações
- apps locais ou embarcadas
- testes de integração sem depender de um banco remoto