turbine-orm 0.28.1 → 0.28.3

package/README.md

@@ -14,7 +14,7 @@ Every TS ORM now resolves nested relations in a single `json_agg` query — Pris
 
 1. **Read-only Studio your DBA will approve.** `npx turbine studio` spins up a loopback-bound web UI with 192-bit auth tokens, `BEGIN READ ONLY` transactions, and — since v0.19 — no raw-SQL surface at all: queries are composed in the ORM's own validated builder. The only TS ORM Studio that physically cannot mutate your database.
 2. **PII-safe error messages.** Turbine errors show WHERE keys, not values. A `UniqueConstraintError` says which column violated the constraint — never the actual user data. Safe to log, safe to surface to monitoring, no scrubbing needed.
-3. **One runtime dependency (`pg`).** No engine binary, no WASM, no adapter packages to keep in lockstep. The main entry bundles to ~42 kB brotli; the edge entry to ~33 kB brotli. Prisma 7 dropped its Rust query engine, but its client still ships a TypeScript/WASM query compiler — a ~1.6 MB bundle, down from the ~14 MB Rust-era client.
+3. **One runtime dependency (`pg`).** No engine binary, no WASM, no adapter packages to keep in lockstep. The main entry's **import graph** is ~42 kB brotli (edge ~33 kB) with `pg` external — that is the client footprint your bundler sees, not the dual ESM+CJS install size on disk (~3 MB). Prisma 7 dropped its Rust query engine, but its client still ships a TypeScript/WASM query compiler — a ~1.6 MB bundle, down from the ~14 MB Rust-era client.
 4. **SQL-first migrations with drift detection.** Write real SQL. SHA-256 checksums catch modified migration files. `pg_try_advisory_lock()` prevents concurrent runs. Each migration in its own transaction. No shadow database, no magic DSL.
 5. **Edge-native — one import swap.** `turbineHttp(pool, SCHEMA)` — same API on Neon, Vercel Postgres, Cloudflare Hyperdrive, Supabase. No WASM bundle, no adapter package, no separate serverless build.
 6. **Pipeline batching via wire protocol.** Real Parse/Bind/Execute pipeline — not queries wrapped in a transaction. N independent queries in one round-trip.
@@ -882,7 +882,7 @@ Everything is honest about what ports and what doesn't. Features marked **PG-onl
 
 **Engine notes:** SQLite uses `RETURNING` (≥ 3.35) just like Postgres. MySQL has no `RETURNING`, so writes re-`SELECT` the affected row and **`createMany` returns `[]`** (the rows ARE inserted — re-query if you need them). SQL Server returns rows via `OUTPUT`/`MERGE`; `DISTINCT ON` is Postgres-only. Only Postgres streams via a true cursor (constant memory); the other engines' `findManyStream` materializes the result then yields it in batches. Optimistic locking throws `OptimisticLockError` on all engines (on MySQL the conflict is detected from the version-checked UPDATE's affected-row count). The `turbine` CLI (`generate`, `migrate`) is currently PostgreSQL-only — point the engine factories at a hand-written or programmatically introspected `SCHEMA`.
 
-**PowDB** speaks its own non-SQL query language (PowQL), so it sits outside the SQL matrix above. It uses `reselect` writes with client-assigned UUID PKs, N+1 relation loaders (no `json_agg`), single-writer transactions (no nesting), and `defineSchema` (no introspection). Embedded `syncMode: 'normal'` writes beat SQLite; the networked transport runs the same data over a socket. many-to-many, nested writes, composite keys, cursor streaming, and the Postgres-only trio throw `UnsupportedFeatureError`. Full details: **[turbineorm.dev/engines#powdb](https://turbineorm.dev/engines#powdb)**.
+**PowDB** speaks its own non-SQL query language (PowQL), so it sits outside the SQL matrix above. Writes use a trailing **`returning`** keyword (upsert reselects by PK). PKs are server-assigned `auto` ints **or** client UUIDs. Nested relations load client-side (N+1, including many-to-many via the junction — no `json_agg`). Nested writes cover hasMany/hasOne/belongsTo; many-to-many nested writes are not supported. Transactions are single-writer (no nested savepoints). Schema is code-first via `defineSchema` (no wire introspection). Embedded `syncMode: 'normal'` moves fsync off the commit path; the networked transport runs the same data over a socket. Cursor streaming and the Postgres-only trio (pgvector / LISTEN/NOTIFY / RLS session GUCs) throw `UnsupportedFeatureError`. Full details: **[turbineorm.dev/engines#powdb](https://turbineorm.dev/engines#powdb)**.
 
 Full setup, signatures, and the complete support matrix: **[turbineorm.dev/engines](https://turbineorm.dev/engines)**.
 

package/dist/cjs/generate.js

@@ -523,7 +523,7 @@ function generateIndex(schema) {
     const lines = [
         ...generatedFileHeader(),
         "import { TurbineClient as BaseTurbineClient, TransactionClient as BaseTransactionClient, QueryInterface } from 'turbine-orm';",
-        "import type { TurbineConfig, TransactionOptions } from 'turbine-orm';",
+        "import type { TurbineConfig, TransactionOptions, DeferredQuery, PipelineResults } from 'turbine-orm';",
         "import { SCHEMA } from './metadata.js';",
     ];
     // Import all entity types and relations maps
@@ -607,9 +607,13 @@ function generateIndex(schema) {
     lines.push('');
     // Augment TurbineClient via interface merging with a typed $transaction
     // overload. The callback parameter is narrowed to `TypedTransactionClient`
-    // so users get autocomplete on `tx.users`, `tx.posts`, etc. The base
-    // signature (callback parameter `BaseTransactionClient`) remains valid as
-    // an overload, so prior usage continues to typecheck.
+    // so users get autocomplete on `tx.users`, `tx.posts`, etc.
+    //
+    // IMPORTANT: the merged member must be compatible with the base class's
+    // $transaction ON ITS OWN (TS2415) — since v0.26 the base method also has a
+    // batch-array overload (`$transaction([...queries])`), so the merged
+    // interface must redeclare BOTH signatures. Emitting only the callback form
+    // makes every generated client fail `tsc` with "incorrectly extends".
     lines.push('export interface TurbineClient {');
     lines.push('  /**');
     lines.push('   * Run a callback inside a transaction. The callback receives a typed');
@@ -619,6 +623,13 @@ function generateIndex(schema) {
     lines.push('    fn: (tx: TypedTransactionClient) => Promise<R>,');
     lines.push('    options?: TransactionOptions,');
     lines.push('  ): Promise<R>;');
+    lines.push('  /**');
+    lines.push('   * Batch form: run several deferred queries in one transaction and get');
+    lines.push('   * their results as a tuple (same as the base client).');
+    lines.push('   */');
+    lines.push('  $transaction<T extends readonly DeferredQuery<unknown>[]>(');
+    lines.push('    queries: readonly [...T],');
+    lines.push('  ): Promise<PipelineResults<T>>;');
     lines.push('}');
     lines.push('');
     // Factory function with JSDoc

package/dist/generate.js

@@ -516,7 +516,7 @@ export function generateIndex(schema) {
     const lines = [
         ...generatedFileHeader(),
         "import { TurbineClient as BaseTurbineClient, TransactionClient as BaseTransactionClient, QueryInterface } from 'turbine-orm';",
-        "import type { TurbineConfig, TransactionOptions } from 'turbine-orm';",
+        "import type { TurbineConfig, TransactionOptions, DeferredQuery, PipelineResults } from 'turbine-orm';",
         "import { SCHEMA } from './metadata.js';",
     ];
     // Import all entity types and relations maps
@@ -600,9 +600,13 @@ export function generateIndex(schema) {
     lines.push('');
     // Augment TurbineClient via interface merging with a typed $transaction
     // overload. The callback parameter is narrowed to `TypedTransactionClient`
-    // so users get autocomplete on `tx.users`, `tx.posts`, etc. The base
-    // signature (callback parameter `BaseTransactionClient`) remains valid as
-    // an overload, so prior usage continues to typecheck.
+    // so users get autocomplete on `tx.users`, `tx.posts`, etc.
+    //
+    // IMPORTANT: the merged member must be compatible with the base class's
+    // $transaction ON ITS OWN (TS2415) — since v0.26 the base method also has a
+    // batch-array overload (`$transaction([...queries])`), so the merged
+    // interface must redeclare BOTH signatures. Emitting only the callback form
+    // makes every generated client fail `tsc` with "incorrectly extends".
     lines.push('export interface TurbineClient {');
     lines.push('  /**');
     lines.push('   * Run a callback inside a transaction. The callback receives a typed');
@@ -612,6 +616,13 @@ export function generateIndex(schema) {
     lines.push('    fn: (tx: TypedTransactionClient) => Promise<R>,');
     lines.push('    options?: TransactionOptions,');
     lines.push('  ): Promise<R>;');
+    lines.push('  /**');
+    lines.push('   * Batch form: run several deferred queries in one transaction and get');
+    lines.push('   * their results as a tuple (same as the base client).');
+    lines.push('   */');
+    lines.push('  $transaction<T extends readonly DeferredQuery<unknown>[]>(');
+    lines.push('    queries: readonly [...T],');
+    lines.push('  ): Promise<PipelineResults<T>>;');
     lines.push('}');
     lines.push('');
     // Factory function with JSDoc

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "turbine-orm",
-  "version": "0.28.1",
+  "version": "0.28.3",
   "description": "Postgres-native TypeScript ORM — runs on Neon, Vercel Postgres, Cloudflare, Supabase. Streaming cursors, typed errors, single-query nested relations. One dependency, no WASM engine",
   "type": "module",
   "exports": {
@@ -94,10 +94,10 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
+    "@types/pg": "^8.11.11",
     "pg": "^8.13.1"
   },
   "devDependencies": {
-    "@types/pg": "^8.11.11",
     "@biomejs/biome": "^2.4.10",
     "@size-limit/esbuild": "^12.1.0",
     "@size-limit/file": "^12.1.0",