ramose

An immutable, Datomic-inspired graph database for Cloudflare (Workers + Durable Objects + R2), built on Effect. Your data model is one TypeScript value; queries and authoritative operations are portable values too.

bun add ramosedb effect@rc

npm install and pnpm add work the same. effect is a required peer: operation input and output codecs are Effect Schemas, and declaring the peer keeps strict dependency resolvers on one compatible Effect instance. Alchemy comes with RamoseDB. Apps using ramosedb/better-auth also need the optional peers better-auth and zod.

RamoseDB is pre-release: expect the API to change between minor versions.

The public entries

| Import | What it is | | --- | --- | | ramosedb/db | Portable schemas, fields, queries, owned operation types, and tagged errors. | | ramosedb/client | The offline-first browser client: createClient, interned database handles, local query execution over a durable authorized replica, and framework-neutral subscriptions. | | ramosedb/react | React hooks for queries, operation receipts, synchronization state, and Suspense. | | ramosedb | Deployment resources: Server, Database, JWT claims, providers, and HTTP error mapping. | | ramosedb/worker | The peer Worker itself. Hand it to Alchemy as main: import.meta.resolve("ramosedb/worker") — main is a path, so a bare specifier there silently resolves to nothing. | | ramosedb/better-auth/client | Browser credential provider with bearer caching, renewal, offline fallback, and sign-out cleanup. | | ramosedb/better-auth | The Better Auth plugin that mints the identity JWT a peer verifies. Needs optional peers better-auth and zod. |

App schemas use Ramose.string() / boolean() / enumeration([...]). Declare operations inside an entity or trait’s operations callback. Operation codecs import effect/Schema from the application's declared Effect peer.

A first look

// schema.ts
import * as Ramose from "ramosedb/db";

export const Todo = Ramose.Entity("todo", {
  title: Ramose.string(),
  done: Ramose.boolean(),
});

export const Todos = Ramose.Schema("todos", { todo: Todo });

Todos.applyPolicy(({ policy }) => {
  policy.todo.read.always();
});

Docs

Full documentation lives at ramose.ai.

License

Apache-2.0 — see LICENSE and NOTICE.