Ga naar inhoud
tapedb.

Installatie en entrypoints

Installeren

Section titled “Installeren”

tapedb init richt één Durable Object-klasse en twee R2-buckets in je eigen Cloudflare-account in. Het schrijft ook tapedb.schema.ts, de Worker, de Wrangler-config en de eerste migratie.

Terminal window
npx tapedb init

tapedb dev start een lokale database met een development-claimroute, zodat de client tijdens het bouwen geen sessie nodig heeft. tapedb studio opent een lokale tabelbrowser op http://127.0.0.1:4400.

Terminal window
npx tapedb dev
npx tapedb studio

Wat init inricht

Section titled “Wat init inricht”

De gegenereerde Worker declareert drie resources: één Durable Object-klasse, de DATA R2-bucket voor logsegmenten en snapshots, en de FILES R2-bucket voor uploads. Er is geen D1-database. Lidmaatschappen en sessies blijven in je identity-systeem; de engine leest één workspace-claim.

Entrypoints

Section titled “Entrypoints”
import bevat React
tapedb createClient, schema-builders, id geen runtime-deps
tapedb/schema schema, model, t, role, filter, check nee
tapedb/react useLive, useLivePage, usePresence, useBroadcast peer
tapedb/worker defineTapeDB, de Durable Object-klasse nee
tapedb/cli init, migrate, dev, studio, deploy nee

CLI

Section titled “CLI”
commando doet
tapedb init [--dir] [--name] [--force] Schrijft het schema, de Worker, wrangler.jsonc, .dev.vars en de eerste migratie. Bestaande bestanden blijven staan tenzij --force.
tapedb dev [--dir] [--port] Start de lokale database met wrangler dev (standaardpoort 8787).
tapedb studio [--url] [--workspace] [--port] Opent een lokale tabelbrowser (standaardpoort 4400).
tapedb migrate dev --name <name> [--rename old=new] [--accept-data-loss] [--dir] [--schema] Schrijft de volgende migratie.
tapedb migrate status | check [--dir] [--schema] Toont migraties; check faalt bij ongemigreerde schemawijzigingen.
tapedb deploy [--env] Controleert ENVIRONMENT, dev-claims en migraties en draait daarna wrangler deploy.
tapedb export --workspace <uuid> [--url] [--out] Streamt de workspace als NDJSON.

Vereisten

Section titled “Vereisten”
  • Een Cloudflare Worker met een Durable Object en twee R2-buckets; init genereert de bindings.
  • Node.js 20 of later voor de CLI.
  • React 19 (optioneel) voor tapedb/react; de core-entry blijft React-vrij en heeft geen runtime-dependencies.

Licentie

Section titled “Licentie”

MIT.

Volgende stap: het schema definiëren of lezen hoe je migraties deployt.