turbine-orm 0.81.0 → 0.90.0

package/dist/cjs/prisma-compat.d.ts

@@ -67,16 +67,22 @@
  * - Fluent relation chaining (`prisma.user.findUnique().posts()`).
  * - Accelerate / Pulse / driver-adapter preview features, the Mongo API, and the
  *   `prisma migrate`/`db` CLI family (Turbine ships its own migrations).
- * - **Inclusive bare cursors whose field is not the sort key**, see
- *   {@link translateCursor}. A bare Prisma cursor is inclusive; translating it
- *   correctly needs the anchor row's sort-key value. When the cursor field is
- *   the single `orderBy` field (or the cursor is the single-column PK with no
- *   `orderBy`) it compiles to a `gte`/`lte` keyset predicate; **otherwise it
- *   throws** an {@link UnsupportedFeatureError} rather than emit an off-by-one
- *   page. Pair the cursor with `skip: 1` (Prisma's idiom) for the exact
- *   exclusive-cursor + `offset` translation.
- * - **Negative `take`** (take-from-end) and **`skip` on a nested relation
- *   include** throw, Turbine's `with` clause has no offset and no reverse-take.
+ * - **Negative `take`** (take-from-end) throws: Turbine has no reverse-take.
+ *   A **`cursor` on a nested relation include** throws: `with` has no cursor
+ *   (`take` / `skip` there page each parent's rows, as in Prisma).
+ * - **A filtered relation count** (`_count: { select: { posts: { where } } }`)
+ *   and **`distinct` on a nested include** throw `UnsupportedFeatureError`:
+ *   core counts and includes a relation whole, so honoring either would mean
+ *   returning a wrong number or duplicate rows. The message names the
+ *   alternative (a `count` / `findMany` on the related model).
+ * - **Nothing is accepted and dropped.** Every option on an included relation
+ *   and every key under `_count` is translated, refused by name (the two
+ *   above, `cursor`), or refused as unknown (`ValidationError`, with a
+ *   suggestion): a misspelled `wher`, a Turbine spelling like `limit`, a
+ *   relation `_count` does not know. The same holds for `$transaction` options
+ *   (`maxWait` is accepted, warned about once, and not applied: the pool's
+ *   `connectionTimeoutMs` bounds the wait) and for the keys of a nested write's
+ *   `{ where, data }` / `{ where, create, update }` payloads.
  * - **`limit` on `updateMany` / `deleteMany`** (Prisma 6.7+) throws. Turbine has
  *   no row-bounded mass mutation, and dropping a SAFETY BOUND with a warning
  *   would turn "change at most 10 rows" into "change every matching row".
@@ -87,9 +93,10 @@
  *   either (or any `include` on a write) THROWS, since a write returns its own
  *   row only. `omit` on READS is translated to core's own `omit`, see
  *   {@link translateOmit}.
- * - **`select` on `count`** and **`orderBy` / `cursor` / `take` / `skip` on
- *   `aggregate`** are accepted and IGNORED (they are legitimate Prisma, so they
- *   never warn); a plain number / the aggregate comes back.
+ * - **`take` / `skip` / `cursor` on `count` and `aggregate`** throw: Prisma
+ *   computes those over one page of rows and Turbine has no paged count. An
+ *   `orderBy` alone changes nothing there and is accepted. `count({ select })`
+ *   returns Prisma's per-field object (`{ _all, field }`).
  *
  * ## Type dependencies (0.41.0)
  *
@@ -185,7 +192,7 @@ export interface CompatTransactionClient {
 export interface CompatTurbineClient extends CompatTransactionClient {
     readonly schema: SchemaMetadata;
     $transaction<R>(fn: (tx: CompatTransactionClient) => Promise<R>, options?: unknown): Promise<R>;
-    $transaction(queries: readonly DeferredQuery<unknown>[]): Promise<unknown[]>;
+    $transaction(queries: readonly DeferredQuery<unknown>[], options?: unknown): Promise<unknown[]>;
 }
 /**
  * Brand marking an object as a raw-SQL fragment whose `strings` are spliced
@@ -399,10 +406,11 @@ export interface PrismaCompatClientBase<S extends Record<string, PrismaModelType
     $connect(): Promise<void>;
     $disconnect(): Promise<void>;
 }
-/** Options accepted by the callback form of `$transaction`. */
+/** Options accepted by `$transaction`, in its callback and array forms. */
 export interface PrismaCompatTxOptions {
     isolationLevel?: 'ReadUncommitted' | 'ReadCommitted' | 'RepeatableRead' | 'Serializable';
     timeout?: number;
+    /** Accepted for source compatibility and ignored; see `connectionTimeoutMs` on the client. */
     maxWait?: number;
 }
 /**