@quickback-dev/cli 0.66.9 → 0.66.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/skill/SKILL.md +12 -6
- package/dist/skill/agents/quickback-specialist/AGENT.md +1 -1
- package/dist/skill/docs/api/batch-operations.md +14 -8
- package/dist/skill/docs/define/changesets.md +1 -1
- package/dist/skill/docs/define/firewall.md +7 -0
- package/dist/skill/docs/define/schema.md +3 -3
- package/dist/skill/docs/define/security.md +22 -0
- package/dist/skill/docs/platform/auth/index.md +5 -1
- package/dist/skill/docs/tooling/cli.md +2 -2
- package/dist/skill/docs/tooling/output.md +19 -0
- package/package.json +1 -1
- package/src/skill/SKILL.md +12 -6
- package/src/skill/agents/quickback-specialist/AGENT.md +1 -1
- package/src/skill/docs/api/batch-operations.md +14 -8
- package/src/skill/docs/define/changesets.md +1 -1
- package/src/skill/docs/define/firewall.md +7 -0
- package/src/skill/docs/define/schema.md +3 -3
- package/src/skill/docs/define/security.md +22 -0
- package/src/skill/docs/platform/auth/index.md +5 -1
- package/src/skill/docs/tooling/cli.md +2 -2
- package/src/skill/docs/tooling/output.md +19 -0
package/dist/index.js
CHANGED
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,8DAA8D;AAC9D,MAAM,WAAW,GAAG,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/skill/SKILL.md
CHANGED
|
@@ -6,18 +6,24 @@ allowed-tools: Read, Grep, Glob, Edit, Write
|
|
|
6
6
|
|
|
7
7
|
# Quickback
|
|
8
8
|
|
|
9
|
-
Quickback is a **backend compiler**. Define your database schema and security rules in TypeScript; compile them into
|
|
9
|
+
Quickback is a **backend compiler**. Define your database schema and security rules in TypeScript; compile them into a Hono API running on Cloudflare Workers. Pair the output with the Quickback Stack for a complete Supabase alternative on Cloudflare.
|
|
10
10
|
|
|
11
11
|
It's two products:
|
|
12
12
|
|
|
13
13
|
## 1. Quickback Compiler — the build tool
|
|
14
14
|
|
|
15
|
-
Define schema + security in TypeScript. Compile to
|
|
15
|
+
Define schema + security in TypeScript. Compile to a full Hono application with
|
|
16
|
+
CRUD, batch endpoints, OpenAPI, and an MCP server, on one of three registered
|
|
17
|
+
database providers:
|
|
16
18
|
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
+
- **`cloudflare-d1`** — edge SQLite, the default.
|
|
20
|
+
- **`neon`** — Postgres over HTTP, WebSocket or Cloudflare Hyperdrive.
|
|
21
|
+
- **`planetscale-postgres`** — the same Postgres emitters, Hyperdrive only. Compiler support; live acceptance pending. `planetscale` without the suffix means MySQL and is not registered.
|
|
19
22
|
|
|
20
|
-
The same `defineTable()` definitions work
|
|
23
|
+
The same `defineTable()` definitions work across every provider. On Postgres,
|
|
24
|
+
the compiler additionally emits **backstop** Row Level Security: it fences
|
|
25
|
+
tenant scope, soft delete and lane admission only — roles, status, transitions
|
|
26
|
+
and masking stay with the API. The compiler runs as a remote service at `compiler.quickback.dev` (override with `QUICKBACK_API_URL`) — the CLI is a thin client that sends config + features and writes the generated files.
|
|
21
27
|
|
|
22
28
|
## 2. Quickback Stack — the runtime services
|
|
23
29
|
|
|
@@ -409,7 +415,7 @@ The path layout mirrors the public docs site (https://docs.quickback.dev). Open
|
|
|
409
415
|
|
|
410
416
|
**Platform services** (`docs/platform/<topic>.md`)
|
|
411
417
|
- `cloudflare` — the Workers runtime target
|
|
412
|
-
- `database/{index,d1,neon}` — D1 and Neon/Postgres
|
|
418
|
+
- `database/{index,d1,neon,planetscale-postgres}` — D1, and Neon / PlanetScale Postgres
|
|
413
419
|
- `auth` — Better Auth integration, JWT optimization, plugins, device-auth, security
|
|
414
420
|
- `storage/{kv,r2}` — using KV and R2 in actions
|
|
415
421
|
- `realtime` — Durable Objects, WebSocket
|
|
@@ -70,7 +70,7 @@ When explaining compile outputs:
|
|
|
70
70
|
|
|
71
71
|
Detect the database dialect from `quickback.config.ts`:
|
|
72
72
|
- Cloudflare D1 / SQLite: Use `sqliteTable`, `text`, `integer` from `drizzle-orm/sqlite-core`
|
|
73
|
-
-
|
|
73
|
+
- Neon / PlanetScale Postgres / PostgreSQL: Use `pgTable`, `text`, `boolean`, `timestamp` from `drizzle-orm/pg-core`
|
|
74
74
|
|
|
75
75
|
### Table Definition Pattern (recommended: `feature()` + `q.scope()`)
|
|
76
76
|
|
|
@@ -273,24 +273,30 @@ and, for Neon, its **connection mode** — supports interactive transactions.
|
|
|
273
273
|
The response's `meta.transactional` flag tells you which guarantee you
|
|
274
274
|
actually got — inspect it in clients that care about rollback.
|
|
275
275
|
|
|
276
|
-
Neon is transactional
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
276
|
+
Neon is transactional over **websocket** (`connectionMode: 'websocket'`, the
|
|
277
|
+
default on Node/Bun runtimes) and over **hyperdrive** (postgres.js on a
|
|
278
|
+
Cloudflare Hyperdrive binding — the only Neon mode with interactive
|
|
279
|
+
transactions on Workers). Over HTTP — the default on Cloudflare Workers — the
|
|
280
|
+
`drizzle-orm/neon-http` driver has no `db.transaction()` (it throws at
|
|
281
|
+
runtime), so Neon-over-HTTP batches behave exactly like D1: fail-fast
|
|
282
|
+
per-record loop, `meta.transactional: false`.
|
|
283
|
+
|
|
284
|
+
[PlanetScale Postgres](/platform/database/planetscale-postgres) is Hyperdrive-only
|
|
285
|
+
and therefore always transactional — it shares the `postgres-js-hyperdrive`
|
|
286
|
+
transport with Neon's hyperdrive mode.
|
|
281
287
|
|
|
282
288
|
### Per-Provider Matrix
|
|
283
289
|
|
|
284
290
|
| Endpoint | Provider | `failFast` | `meta.transactional` | Behavior |
|
|
285
291
|
|----------|----------|-----------|----------------------|----------|
|
|
286
|
-
| `PATCH /batch` (update) | tx-supporting (postgres, neon over websocket) | `true` | `true` | `db.transaction()` wraps the per-record loop. Any failure rolls back ALL writes in the batch. |
|
|
292
|
+
| `PATCH /batch` (update) | tx-supporting (postgres, neon over websocket/hyperdrive, planetscale-postgres) | `true` | `true` | `db.transaction()` wraps the per-record loop. Any failure rolls back ALL writes in the batch. |
|
|
287
293
|
| `PATCH /batch` (update) | (any) | `false` | `false` | Per-record loop, partial success. Each record commits independently. |
|
|
288
294
|
| `PATCH /batch` (update) | cloudflare-d1, neon over http (Cloudflare default) | `true` | `false` | Fail-fast loop without rollback — the driver has no `db.transaction`. Records before the failure stay committed. |
|
|
289
|
-
| `PUT /batch` (upsert) | tx-supporting (postgres, neon over websocket) | `true` | `true` | Bulk insert + per-record update share one transaction. Any failure rolls back both. |
|
|
295
|
+
| `PUT /batch` (upsert) | tx-supporting (postgres, neon over websocket/hyperdrive, planetscale-postgres) | `true` | `true` | Bulk insert + per-record update share one transaction. Any failure rolls back both. |
|
|
290
296
|
| `PUT /batch` (upsert) | cloudflare-d1, neon over http (Cloudflare default) | `true` | `false` | Bulk insert commits; per-record update loop is fail-fast without rollback. |
|
|
291
297
|
| `POST /batch` (create) | (any) | (any) | `true` | Single bulk `INSERT` — atomic at the DB level. |
|
|
292
298
|
| `DELETE /batch` | (any) | (any) | `true` | Single bulk `UPDATE` (soft) or `DELETE` (hard) — atomic at the DB level. |
|
|
293
|
-
| [Changeset](/define/changesets) (`application/vnd.quickback.changeset+json`) | tx-supporting (postgres, neon over websocket/hyperdrive) | n/a | `true` | Root op + every child op share one transaction; any op failure rolls back the whole changeset. |
|
|
299
|
+
| [Changeset](/define/changesets) (`application/vnd.quickback.changeset+json`) | tx-supporting (postgres, neon over websocket/hyperdrive, planetscale-postgres) | n/a | `true` | Root op + every child op share one transaction; any op failure rolls back the whole changeset. |
|
|
294
300
|
| [Changeset](/define/changesets) | cloudflare-d1, neon over http (Cloudflare default) | n/a | `false` | Deterministic parent-first fail-fast — the first op failure stops the changeset; already-applied ops stay committed (a consistent, independently-authorized prefix). |
|
|
295
301
|
|
|
296
302
|
### Reading `meta.transactional` in clients
|
|
@@ -417,7 +417,7 @@ it; `meta.transactional` reports the actual guarantee (same contract as
|
|
|
417
417
|
|
|
418
418
|
| Provider | transactional | Behavior |
|
|
419
419
|
|---|---|---|
|
|
420
|
-
| postgres /
|
|
420
|
+
| postgres / neon (websocket / hyperdrive) / planetscale-postgres (hyperdrive) / libsql / better-sqlite3 / bun-sqlite | `true` | One transaction; any op failure rolls back the root op and every child op |
|
|
421
421
|
| cloudflare-d1, neon over http (the Cloudflare default) | `false` | Deterministic parent-first **fail-fast**: the first failure stops the changeset; ops already applied stay committed (a consistent prefix — each was independently authorized) |
|
|
422
422
|
|
|
423
423
|
## Calling it from authored code
|
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
The firewall generates WHERE clauses automatically to isolate data by user, organization, or team.
|
|
4
4
|
|
|
5
|
+
The firewall is also **the only security pillar that lowers to SQL**. On a Postgres
|
|
6
|
+
provider the compiler mirrors it into backstop Row Level Security — tenant scope,
|
|
7
|
+
owner scope, soft delete and lane admission — so a custom route or a mis-scoped
|
|
8
|
+
handle cannot escape it. Roles, status, transitions and masking stay in the API and
|
|
9
|
+
appear in no policy. See [Security Overview](/define/security#where-each-pillar-is-enforced)
|
|
10
|
+
and [Row Level Security](/platform/database/neon#row-level-security).
|
|
11
|
+
|
|
5
12
|
## Basic Usage
|
|
6
13
|
|
|
7
14
|
The cleanest pattern is `q.scope()` — declare the tenant column once and the firewall is auto-derived:
|
|
@@ -224,8 +224,8 @@ If you have an existing Drizzle schema you're bringing forward — or need a dia
|
|
|
224
224
|
| Target Database | Import From | Table Function |
|
|
225
225
|
|-----------------|-------------|----------------|
|
|
226
226
|
| Cloudflare D1, Turso, SQLite | `drizzle-orm/sqlite-core` | `sqliteTable` |
|
|
227
|
-
|
|
|
228
|
-
|
|
|
227
|
+
| Neon, PlanetScale Postgres, PostgreSQL | `drizzle-orm/pg-core` | `pgTable` |
|
|
228
|
+
| MySQL (`planetscale`, `mysql`) — dialect only, no registered provider | `drizzle-orm/mysql-core` | `mysqlTable` |
|
|
229
229
|
|
|
230
230
|
```typescript
|
|
231
231
|
// quickback/features/jobs/jobs.ts
|
|
@@ -274,7 +274,7 @@ Default to `feature()`. Drop to Drizzle only when:
|
|
|
274
274
|
|
|
275
275
|
Features in the same project may mix freely — Quickback dispatches per feature — so one interop table doesn't force the rest of the project off `feature()`.
|
|
276
276
|
|
|
277
|
-
One dialect rule: interop files **without** a `defineTable(...)` default export (internal child tables) are not dialect-translated — author them in the target database's dialect. On Postgres providers (
|
|
277
|
+
One dialect rule: interop files **without** a `defineTable(...)` default export (internal child tables) are not dialect-translated — author them in the target database's dialect. On Postgres providers (`neon`, `planetscale-postgres`), a `sqliteTable` interop source without `defineTable` is a compile-time error; write it with `pgTable` from `drizzle-orm/pg-core` instead. Sources **with** `defineTable(...)` keep compiling across dialects automatically.
|
|
278
278
|
|
|
279
279
|
### Drizzle Column Types
|
|
280
280
|
|
|
@@ -19,6 +19,28 @@ Views and Guards are documented under **Reads** and **Writes** rather than under
|
|
|
19
19
|
Security, because that is where you are when you need them: a view is a shape you
|
|
20
20
|
return, a guard is a rule about a write. They are security mechanisms either way.
|
|
21
21
|
|
|
22
|
+
## Where each pillar is enforced
|
|
23
|
+
|
|
24
|
+
All six pillars run in the API. On a Postgres provider ([Neon](/platform/database/neon),
|
|
25
|
+
[PlanetScale Postgres](/platform/database/planetscale-postgres)) the compiler *also*
|
|
26
|
+
emits Row Level Security — but only as a **backstop**, and only for one pillar:
|
|
27
|
+
|
|
28
|
+
> **The firewall is the only pillar that lowers to SQL.** Generated RLS fences tenant
|
|
29
|
+
> scope, owner scope, soft delete and lane admission. Roles, status, transitions,
|
|
30
|
+
> masking and record conditions are the API's job and appear in no policy body — no
|
|
31
|
+
> generated policy names an authored role.
|
|
32
|
+
|
|
33
|
+
The backstop exists so a bug in a custom route or a mis-scoped handle cannot cross a
|
|
34
|
+
tenant, resurrect a soft-deleted row, or read another owner's row. It is not a second
|
|
35
|
+
copy of `access`. A scoped-role gate or an `access.record` owner rule is an **Access**
|
|
36
|
+
decision and stays in the API; if an owner boundary must hold at the database, author
|
|
37
|
+
it as `firewall.owner`, which does lower.
|
|
38
|
+
|
|
39
|
+
Better Auth's tables carry the same backstop, and **Better Auth's own API is the gate
|
|
40
|
+
for its tables** — the caller lane never writes them. On D1 there is no RLS at all:
|
|
41
|
+
enforcement is the API plus the fact that the database is unreachable except through
|
|
42
|
+
your Worker. See [D1 vs Neon RLS](/platform/database/d1#comparison-with-neon-rls).
|
|
43
|
+
|
|
22
44
|
## Firewall — which rows
|
|
23
45
|
|
|
24
46
|
The firewall is tenant isolation. It rewrites every query so a caller can only ever
|
|
@@ -56,7 +56,11 @@ These are Better Auth's built-in organization roles — no configuration needed.
|
|
|
56
56
|
|
|
57
57
|
> **Tip:** Account UI's role picker uses these exact three roles. Use `["owner", "admin", "member"]` in your [Access](/define/access) rules so generated projects plug into Better Auth and Account UI seamlessly.
|
|
58
58
|
|
|
59
|
-
Roles are used throughout the security layers — in [Access](/define/access) rules
|
|
59
|
+
Roles are used throughout the security layers — in [Access](/define/access) rules and
|
|
60
|
+
[Firewall](/define/firewall) owner checks. Roles are an **API** gate: they do not reach SQL.
|
|
61
|
+
Generated [Row Level Security](/platform/database/neon#row-level-security) is a backstop that
|
|
62
|
+
fences tenant scope, soft delete and lane admission only, and no generated policy body names a
|
|
63
|
+
role. Better Auth's own API is the gate for its tables.
|
|
60
64
|
|
|
61
65
|
## Next Steps
|
|
62
66
|
|
|
@@ -167,8 +167,8 @@ blocks the write.
|
|
|
167
167
|
|
|
168
168
|
The SQL dialect for written declarations comes from your configured database
|
|
169
169
|
provider — the same provider→dialect table the compiler uses. Postgres
|
|
170
|
-
providers (`
|
|
171
|
-
get Postgres declarations; SQLite providers (`cloudflare-d1`,
|
|
170
|
+
providers (`neon`, `planetscale-postgres`, `supabase`, `vercel-postgres`,
|
|
171
|
+
`postgres`, `postgresql`) get Postgres declarations; SQLite providers (`cloudflare-d1`,
|
|
172
172
|
`better-sqlite3`, `bun-sqlite`, `libsql`, `turso`) get SQLite. MySQL
|
|
173
173
|
providers are refused with an error rather than written in the wrong
|
|
174
174
|
dialect; no provider (or an unrecognized one) defaults to SQLite.
|
|
@@ -254,6 +254,25 @@ projects acquire build and deployment fixes without losing unrelated tooling.
|
|
|
254
254
|
|
|
255
255
|
These files are generated only when the corresponding features are configured:
|
|
256
256
|
|
|
257
|
+
### Database provider setup files
|
|
258
|
+
|
|
259
|
+
Every compile emits an environment example named for the configured provider.
|
|
260
|
+
Postgres providers additionally emit a setup guide under `docs/` and the auth
|
|
261
|
+
schema qualifier script:
|
|
262
|
+
|
|
263
|
+
| Provider | Emitted |
|
|
264
|
+
|----------|---------|
|
|
265
|
+
| `cloudflare-d1` | `.env.cloudflare-d1.example`, `wrangler.d1.example`, `drizzle.auth.config.ts` (dual-database mode) |
|
|
266
|
+
| `neon` | `.env.neon.example`, `.dev.vars.example`, `docs/neon-setup.md`, `scripts/quickback-qualify-auth-schema.mjs` |
|
|
267
|
+
| `planetscale-postgres` | `.env.planetscale.example`, `.dev.vars.example`, `docs/planetscale-postgres-setup.md`, `scripts/quickback-qualify-auth-schema.mjs` |
|
|
268
|
+
|
|
269
|
+
The setup guide is host-specific — role bootstrap, the connection username, the
|
|
270
|
+
Hyperdrive binding and named environments — and is regenerated on every compile.
|
|
271
|
+
Both Postgres providers keep auth and feature tables in **one** database, so
|
|
272
|
+
they emit a single `drizzle.config.ts` rather than the D1 dual-database pair.
|
|
273
|
+
See [Neon](/platform/database/neon) and
|
|
274
|
+
[PlanetScale Postgres](/platform/database/planetscale-postgres).
|
|
275
|
+
|
|
257
276
|
### Embeddings
|
|
258
277
|
|
|
259
278
|
When any feature has `embeddings` configured:
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@quickback-dev/cli",
|
|
3
|
-
"version": "0.66.
|
|
3
|
+
"version": "0.66.10",
|
|
4
4
|
"description": "CLI for Quickback — define your backend in TypeScript, compile to a fully wired Cloudflare Worker (or Bun / Node) with auth, database, migrations, security, CMS, and Account UI.",
|
|
5
5
|
"author": "Kardoe Incorporated <paul@kardoe.com>",
|
|
6
6
|
"license": "MIT",
|
package/src/skill/SKILL.md
CHANGED
|
@@ -6,18 +6,24 @@ allowed-tools: Read, Grep, Glob, Edit, Write
|
|
|
6
6
|
|
|
7
7
|
# Quickback
|
|
8
8
|
|
|
9
|
-
Quickback is a **backend compiler**. Define your database schema and security rules in TypeScript; compile them into
|
|
9
|
+
Quickback is a **backend compiler**. Define your database schema and security rules in TypeScript; compile them into a Hono API running on Cloudflare Workers. Pair the output with the Quickback Stack for a complete Supabase alternative on Cloudflare.
|
|
10
10
|
|
|
11
11
|
It's two products:
|
|
12
12
|
|
|
13
13
|
## 1. Quickback Compiler — the build tool
|
|
14
14
|
|
|
15
|
-
Define schema + security in TypeScript. Compile to
|
|
15
|
+
Define schema + security in TypeScript. Compile to a full Hono application with
|
|
16
|
+
CRUD, batch endpoints, OpenAPI, and an MCP server, on one of three registered
|
|
17
|
+
database providers:
|
|
16
18
|
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
+
- **`cloudflare-d1`** — edge SQLite, the default.
|
|
20
|
+
- **`neon`** — Postgres over HTTP, WebSocket or Cloudflare Hyperdrive.
|
|
21
|
+
- **`planetscale-postgres`** — the same Postgres emitters, Hyperdrive only. Compiler support; live acceptance pending. `planetscale` without the suffix means MySQL and is not registered.
|
|
19
22
|
|
|
20
|
-
The same `defineTable()` definitions work
|
|
23
|
+
The same `defineTable()` definitions work across every provider. On Postgres,
|
|
24
|
+
the compiler additionally emits **backstop** Row Level Security: it fences
|
|
25
|
+
tenant scope, soft delete and lane admission only — roles, status, transitions
|
|
26
|
+
and masking stay with the API. The compiler runs as a remote service at `compiler.quickback.dev` (override with `QUICKBACK_API_URL`) — the CLI is a thin client that sends config + features and writes the generated files.
|
|
21
27
|
|
|
22
28
|
## 2. Quickback Stack — the runtime services
|
|
23
29
|
|
|
@@ -409,7 +415,7 @@ The path layout mirrors the public docs site (https://docs.quickback.dev). Open
|
|
|
409
415
|
|
|
410
416
|
**Platform services** (`docs/platform/<topic>.md`)
|
|
411
417
|
- `cloudflare` — the Workers runtime target
|
|
412
|
-
- `database/{index,d1,neon}` — D1 and Neon/Postgres
|
|
418
|
+
- `database/{index,d1,neon,planetscale-postgres}` — D1, and Neon / PlanetScale Postgres
|
|
413
419
|
- `auth` — Better Auth integration, JWT optimization, plugins, device-auth, security
|
|
414
420
|
- `storage/{kv,r2}` — using KV and R2 in actions
|
|
415
421
|
- `realtime` — Durable Objects, WebSocket
|
|
@@ -70,7 +70,7 @@ When explaining compile outputs:
|
|
|
70
70
|
|
|
71
71
|
Detect the database dialect from `quickback.config.ts`:
|
|
72
72
|
- Cloudflare D1 / SQLite: Use `sqliteTable`, `text`, `integer` from `drizzle-orm/sqlite-core`
|
|
73
|
-
-
|
|
73
|
+
- Neon / PlanetScale Postgres / PostgreSQL: Use `pgTable`, `text`, `boolean`, `timestamp` from `drizzle-orm/pg-core`
|
|
74
74
|
|
|
75
75
|
### Table Definition Pattern (recommended: `feature()` + `q.scope()`)
|
|
76
76
|
|
|
@@ -273,24 +273,30 @@ and, for Neon, its **connection mode** — supports interactive transactions.
|
|
|
273
273
|
The response's `meta.transactional` flag tells you which guarantee you
|
|
274
274
|
actually got — inspect it in clients that care about rollback.
|
|
275
275
|
|
|
276
|
-
Neon is transactional
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
276
|
+
Neon is transactional over **websocket** (`connectionMode: 'websocket'`, the
|
|
277
|
+
default on Node/Bun runtimes) and over **hyperdrive** (postgres.js on a
|
|
278
|
+
Cloudflare Hyperdrive binding — the only Neon mode with interactive
|
|
279
|
+
transactions on Workers). Over HTTP — the default on Cloudflare Workers — the
|
|
280
|
+
`drizzle-orm/neon-http` driver has no `db.transaction()` (it throws at
|
|
281
|
+
runtime), so Neon-over-HTTP batches behave exactly like D1: fail-fast
|
|
282
|
+
per-record loop, `meta.transactional: false`.
|
|
283
|
+
|
|
284
|
+
[PlanetScale Postgres](/platform/database/planetscale-postgres) is Hyperdrive-only
|
|
285
|
+
and therefore always transactional — it shares the `postgres-js-hyperdrive`
|
|
286
|
+
transport with Neon's hyperdrive mode.
|
|
281
287
|
|
|
282
288
|
### Per-Provider Matrix
|
|
283
289
|
|
|
284
290
|
| Endpoint | Provider | `failFast` | `meta.transactional` | Behavior |
|
|
285
291
|
|----------|----------|-----------|----------------------|----------|
|
|
286
|
-
| `PATCH /batch` (update) | tx-supporting (postgres, neon over websocket) | `true` | `true` | `db.transaction()` wraps the per-record loop. Any failure rolls back ALL writes in the batch. |
|
|
292
|
+
| `PATCH /batch` (update) | tx-supporting (postgres, neon over websocket/hyperdrive, planetscale-postgres) | `true` | `true` | `db.transaction()` wraps the per-record loop. Any failure rolls back ALL writes in the batch. |
|
|
287
293
|
| `PATCH /batch` (update) | (any) | `false` | `false` | Per-record loop, partial success. Each record commits independently. |
|
|
288
294
|
| `PATCH /batch` (update) | cloudflare-d1, neon over http (Cloudflare default) | `true` | `false` | Fail-fast loop without rollback — the driver has no `db.transaction`. Records before the failure stay committed. |
|
|
289
|
-
| `PUT /batch` (upsert) | tx-supporting (postgres, neon over websocket) | `true` | `true` | Bulk insert + per-record update share one transaction. Any failure rolls back both. |
|
|
295
|
+
| `PUT /batch` (upsert) | tx-supporting (postgres, neon over websocket/hyperdrive, planetscale-postgres) | `true` | `true` | Bulk insert + per-record update share one transaction. Any failure rolls back both. |
|
|
290
296
|
| `PUT /batch` (upsert) | cloudflare-d1, neon over http (Cloudflare default) | `true` | `false` | Bulk insert commits; per-record update loop is fail-fast without rollback. |
|
|
291
297
|
| `POST /batch` (create) | (any) | (any) | `true` | Single bulk `INSERT` — atomic at the DB level. |
|
|
292
298
|
| `DELETE /batch` | (any) | (any) | `true` | Single bulk `UPDATE` (soft) or `DELETE` (hard) — atomic at the DB level. |
|
|
293
|
-
| [Changeset](/define/changesets) (`application/vnd.quickback.changeset+json`) | tx-supporting (postgres, neon over websocket/hyperdrive) | n/a | `true` | Root op + every child op share one transaction; any op failure rolls back the whole changeset. |
|
|
299
|
+
| [Changeset](/define/changesets) (`application/vnd.quickback.changeset+json`) | tx-supporting (postgres, neon over websocket/hyperdrive, planetscale-postgres) | n/a | `true` | Root op + every child op share one transaction; any op failure rolls back the whole changeset. |
|
|
294
300
|
| [Changeset](/define/changesets) | cloudflare-d1, neon over http (Cloudflare default) | n/a | `false` | Deterministic parent-first fail-fast — the first op failure stops the changeset; already-applied ops stay committed (a consistent, independently-authorized prefix). |
|
|
295
301
|
|
|
296
302
|
### Reading `meta.transactional` in clients
|
|
@@ -417,7 +417,7 @@ it; `meta.transactional` reports the actual guarantee (same contract as
|
|
|
417
417
|
|
|
418
418
|
| Provider | transactional | Behavior |
|
|
419
419
|
|---|---|---|
|
|
420
|
-
| postgres /
|
|
420
|
+
| postgres / neon (websocket / hyperdrive) / planetscale-postgres (hyperdrive) / libsql / better-sqlite3 / bun-sqlite | `true` | One transaction; any op failure rolls back the root op and every child op |
|
|
421
421
|
| cloudflare-d1, neon over http (the Cloudflare default) | `false` | Deterministic parent-first **fail-fast**: the first failure stops the changeset; ops already applied stay committed (a consistent prefix — each was independently authorized) |
|
|
422
422
|
|
|
423
423
|
## Calling it from authored code
|
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
The firewall generates WHERE clauses automatically to isolate data by user, organization, or team.
|
|
4
4
|
|
|
5
|
+
The firewall is also **the only security pillar that lowers to SQL**. On a Postgres
|
|
6
|
+
provider the compiler mirrors it into backstop Row Level Security — tenant scope,
|
|
7
|
+
owner scope, soft delete and lane admission — so a custom route or a mis-scoped
|
|
8
|
+
handle cannot escape it. Roles, status, transitions and masking stay in the API and
|
|
9
|
+
appear in no policy. See [Security Overview](/define/security#where-each-pillar-is-enforced)
|
|
10
|
+
and [Row Level Security](/platform/database/neon#row-level-security).
|
|
11
|
+
|
|
5
12
|
## Basic Usage
|
|
6
13
|
|
|
7
14
|
The cleanest pattern is `q.scope()` — declare the tenant column once and the firewall is auto-derived:
|
|
@@ -224,8 +224,8 @@ If you have an existing Drizzle schema you're bringing forward — or need a dia
|
|
|
224
224
|
| Target Database | Import From | Table Function |
|
|
225
225
|
|-----------------|-------------|----------------|
|
|
226
226
|
| Cloudflare D1, Turso, SQLite | `drizzle-orm/sqlite-core` | `sqliteTable` |
|
|
227
|
-
|
|
|
228
|
-
|
|
|
227
|
+
| Neon, PlanetScale Postgres, PostgreSQL | `drizzle-orm/pg-core` | `pgTable` |
|
|
228
|
+
| MySQL (`planetscale`, `mysql`) — dialect only, no registered provider | `drizzle-orm/mysql-core` | `mysqlTable` |
|
|
229
229
|
|
|
230
230
|
```typescript
|
|
231
231
|
// quickback/features/jobs/jobs.ts
|
|
@@ -274,7 +274,7 @@ Default to `feature()`. Drop to Drizzle only when:
|
|
|
274
274
|
|
|
275
275
|
Features in the same project may mix freely — Quickback dispatches per feature — so one interop table doesn't force the rest of the project off `feature()`.
|
|
276
276
|
|
|
277
|
-
One dialect rule: interop files **without** a `defineTable(...)` default export (internal child tables) are not dialect-translated — author them in the target database's dialect. On Postgres providers (
|
|
277
|
+
One dialect rule: interop files **without** a `defineTable(...)` default export (internal child tables) are not dialect-translated — author them in the target database's dialect. On Postgres providers (`neon`, `planetscale-postgres`), a `sqliteTable` interop source without `defineTable` is a compile-time error; write it with `pgTable` from `drizzle-orm/pg-core` instead. Sources **with** `defineTable(...)` keep compiling across dialects automatically.
|
|
278
278
|
|
|
279
279
|
### Drizzle Column Types
|
|
280
280
|
|
|
@@ -19,6 +19,28 @@ Views and Guards are documented under **Reads** and **Writes** rather than under
|
|
|
19
19
|
Security, because that is where you are when you need them: a view is a shape you
|
|
20
20
|
return, a guard is a rule about a write. They are security mechanisms either way.
|
|
21
21
|
|
|
22
|
+
## Where each pillar is enforced
|
|
23
|
+
|
|
24
|
+
All six pillars run in the API. On a Postgres provider ([Neon](/platform/database/neon),
|
|
25
|
+
[PlanetScale Postgres](/platform/database/planetscale-postgres)) the compiler *also*
|
|
26
|
+
emits Row Level Security — but only as a **backstop**, and only for one pillar:
|
|
27
|
+
|
|
28
|
+
> **The firewall is the only pillar that lowers to SQL.** Generated RLS fences tenant
|
|
29
|
+
> scope, owner scope, soft delete and lane admission. Roles, status, transitions,
|
|
30
|
+
> masking and record conditions are the API's job and appear in no policy body — no
|
|
31
|
+
> generated policy names an authored role.
|
|
32
|
+
|
|
33
|
+
The backstop exists so a bug in a custom route or a mis-scoped handle cannot cross a
|
|
34
|
+
tenant, resurrect a soft-deleted row, or read another owner's row. It is not a second
|
|
35
|
+
copy of `access`. A scoped-role gate or an `access.record` owner rule is an **Access**
|
|
36
|
+
decision and stays in the API; if an owner boundary must hold at the database, author
|
|
37
|
+
it as `firewall.owner`, which does lower.
|
|
38
|
+
|
|
39
|
+
Better Auth's tables carry the same backstop, and **Better Auth's own API is the gate
|
|
40
|
+
for its tables** — the caller lane never writes them. On D1 there is no RLS at all:
|
|
41
|
+
enforcement is the API plus the fact that the database is unreachable except through
|
|
42
|
+
your Worker. See [D1 vs Neon RLS](/platform/database/d1#comparison-with-neon-rls).
|
|
43
|
+
|
|
22
44
|
## Firewall — which rows
|
|
23
45
|
|
|
24
46
|
The firewall is tenant isolation. It rewrites every query so a caller can only ever
|
|
@@ -56,7 +56,11 @@ These are Better Auth's built-in organization roles — no configuration needed.
|
|
|
56
56
|
|
|
57
57
|
> **Tip:** Account UI's role picker uses these exact three roles. Use `["owner", "admin", "member"]` in your [Access](/define/access) rules so generated projects plug into Better Auth and Account UI seamlessly.
|
|
58
58
|
|
|
59
|
-
Roles are used throughout the security layers — in [Access](/define/access) rules
|
|
59
|
+
Roles are used throughout the security layers — in [Access](/define/access) rules and
|
|
60
|
+
[Firewall](/define/firewall) owner checks. Roles are an **API** gate: they do not reach SQL.
|
|
61
|
+
Generated [Row Level Security](/platform/database/neon#row-level-security) is a backstop that
|
|
62
|
+
fences tenant scope, soft delete and lane admission only, and no generated policy body names a
|
|
63
|
+
role. Better Auth's own API is the gate for its tables.
|
|
60
64
|
|
|
61
65
|
## Next Steps
|
|
62
66
|
|
|
@@ -167,8 +167,8 @@ blocks the write.
|
|
|
167
167
|
|
|
168
168
|
The SQL dialect for written declarations comes from your configured database
|
|
169
169
|
provider — the same provider→dialect table the compiler uses. Postgres
|
|
170
|
-
providers (`
|
|
171
|
-
get Postgres declarations; SQLite providers (`cloudflare-d1`,
|
|
170
|
+
providers (`neon`, `planetscale-postgres`, `supabase`, `vercel-postgres`,
|
|
171
|
+
`postgres`, `postgresql`) get Postgres declarations; SQLite providers (`cloudflare-d1`,
|
|
172
172
|
`better-sqlite3`, `bun-sqlite`, `libsql`, `turso`) get SQLite. MySQL
|
|
173
173
|
providers are refused with an error rather than written in the wrong
|
|
174
174
|
dialect; no provider (or an unrecognized one) defaults to SQLite.
|
|
@@ -254,6 +254,25 @@ projects acquire build and deployment fixes without losing unrelated tooling.
|
|
|
254
254
|
|
|
255
255
|
These files are generated only when the corresponding features are configured:
|
|
256
256
|
|
|
257
|
+
### Database provider setup files
|
|
258
|
+
|
|
259
|
+
Every compile emits an environment example named for the configured provider.
|
|
260
|
+
Postgres providers additionally emit a setup guide under `docs/` and the auth
|
|
261
|
+
schema qualifier script:
|
|
262
|
+
|
|
263
|
+
| Provider | Emitted |
|
|
264
|
+
|----------|---------|
|
|
265
|
+
| `cloudflare-d1` | `.env.cloudflare-d1.example`, `wrangler.d1.example`, `drizzle.auth.config.ts` (dual-database mode) |
|
|
266
|
+
| `neon` | `.env.neon.example`, `.dev.vars.example`, `docs/neon-setup.md`, `scripts/quickback-qualify-auth-schema.mjs` |
|
|
267
|
+
| `planetscale-postgres` | `.env.planetscale.example`, `.dev.vars.example`, `docs/planetscale-postgres-setup.md`, `scripts/quickback-qualify-auth-schema.mjs` |
|
|
268
|
+
|
|
269
|
+
The setup guide is host-specific — role bootstrap, the connection username, the
|
|
270
|
+
Hyperdrive binding and named environments — and is regenerated on every compile.
|
|
271
|
+
Both Postgres providers keep auth and feature tables in **one** database, so
|
|
272
|
+
they emit a single `drizzle.config.ts` rather than the D1 dual-database pair.
|
|
273
|
+
See [Neon](/platform/database/neon) and
|
|
274
|
+
[PlanetScale Postgres](/platform/database/planetscale-postgres).
|
|
275
|
+
|
|
257
276
|
### Embeddings
|
|
258
277
|
|
|
259
278
|
When any feature has `embeddings` configured:
|