turbine-orm 0.19.1 → 0.19.2

package/dist/query/types.d.ts

@@ -6,6 +6,13 @@
 export type OrderDirection = 'asc' | 'desc';
 /** Operator object for advanced where filtering */
 export interface WhereOperator<V = unknown> {
+    /**
+     * Explicit equality: `{ equals: value }` → `column = $n`.
+     * `{ equals: null }` → `column IS NULL`.
+     * On json/jsonb columns `equals` routes to the JSONB containment filter
+     * ({@link JsonFilter}) instead.
+     */
+    equals?: V | null;
     gt?: V;
     gte?: V;
     lt?: V;
@@ -225,8 +232,12 @@ export interface FindManyStreamArgs<T, R extends object = {}, W extends TypedWit
      */
     batchSize?: number;
 }
-export interface CreateArgs<T> {
-    data: Partial<T>;
+export interface CreateArgs<T, R extends object = {}> {
+    /**
+     * Row data. On typed clients, relation names additionally accept nested
+     * write ops ({@link NestedCreateOp}): `create` / `connect` / `connectOrCreate`.
+     */
+    data: CreateDataInput<T, R>;
     /** Query timeout in milliseconds. Rejects with an error if exceeded. */
     timeout?: number;
 }
@@ -267,9 +278,14 @@ export type UpdateOperatorInput<V> = {
 export type UpdateInput<T> = {
     [K in keyof T]?: T[K] | UpdateOperatorInput<T[K]>;
 };
-export interface UpdateArgs<T> {
+export interface UpdateArgs<T, R extends object = {}> {
     where: WhereClause<T>;
-    data: UpdateInput<T>;
+    /**
+     * Update data. On typed clients, relation names additionally accept nested
+     * write ops ({@link NestedUpdateOp}): `create` / `connect` / `connectOrCreate`
+     * / `disconnect` / `set` / `delete` / `update` / `upsert`.
+     */
+    data: UpdateDataInput<T, R>;
     /** Query timeout in milliseconds. Rejects with an error if exceeded. */
     timeout?: number;
     /**
@@ -331,23 +347,57 @@ export interface UpsertArgs<T> {
     /** Query timeout in milliseconds. Rejects with an error if exceeded. */
     timeout?: number;
 }
-export interface ConnectOrCreateOp<T> {
+/** `connectOrCreate` op: connect to the row matching `where`, or create it. */
+export interface ConnectOrCreateOp<T, TR extends object = {}> {
     where: Partial<T>;
-    create: Partial<T>;
+    create: CreateDataInput<T, TR>;
 }
-export interface NestedCreateOp<T> {
-    create?: Partial<T> | Partial<T>[];
+/** Nested write ops valid inside `create()` data for a relation field. */
+export interface NestedCreateOp<T, TR extends object = {}> {
+    create?: CreateDataInput<T, TR> | CreateDataInput<T, TR>[];
     connect?: Partial<T> | Partial<T>[];
-    connectOrCreate?: ConnectOrCreateOp<T> | ConnectOrCreateOp<T>[];
+    connectOrCreate?: ConnectOrCreateOp<T, TR> | ConnectOrCreateOp<T, TR>[];
+}
+/** A nested `update` op item: update the related row(s) matching `where`. `where` is optional for belongsTo relations (derived from the parent's FK). */
+export interface NestedUpdateOpItem<T, TR extends object = {}> {
+    where?: Partial<T>;
+    data: UpdateDataInput<T, TR>;
 }
-export interface NestedUpdateOp<T> {
-    create?: Partial<T> | Partial<T>[];
+/** A nested `upsert` op item: update the row matching `where` or create it. */
+export interface NestedUpsertOpItem<T, TR extends object = {}> {
+    where: Partial<T>;
+    create: CreateDataInput<T, TR>;
+    update: UpdateDataInput<T, TR>;
+}
+/** Nested write ops valid inside `update()` data for a relation field. */
+export interface NestedUpdateOp<T, TR extends object = {}> {
+    create?: CreateDataInput<T, TR> | CreateDataInput<T, TR>[];
     connect?: Partial<T> | Partial<T>[];
-    connectOrCreate?: ConnectOrCreateOp<T> | ConnectOrCreateOp<T>[];
+    connectOrCreate?: ConnectOrCreateOp<T, TR> | ConnectOrCreateOp<T, TR>[];
     disconnect?: Partial<T> | Partial<T>[];
     set?: Partial<T>[];
     delete?: Partial<T> | Partial<T>[];
+    update?: NestedUpdateOpItem<T, TR> | NestedUpdateOpItem<T, TR>[];
+    upsert?: NestedUpsertOpItem<T, TR> | NestedUpsertOpItem<T, TR>[];
 }
+/**
+ * `create()` data input. When the relations map `R` is known (typed clients),
+ * each relation name additionally accepts a {@link NestedCreateOp} for the
+ * relation's target entity — recursively, via the target's own relations map.
+ * When `R` is `{}` (untyped escape hatch) this collapses to plain `Partial<T>`.
+ */
+export type CreateDataInput<T, R extends object = {}> = [keyof R] extends [never] ? Partial<T> : Partial<T> & {
+    [K in keyof R]?: NestedCreateOp<RelationTarget<R[K]> & object, RelationRelations<R[K]> & object>;
+};
+/**
+ * `update()` data input. Like {@link CreateDataInput} but relation fields
+ * accept the full {@link NestedUpdateOp} surface (disconnect / set / delete /
+ * update / upsert in addition to the create-context ops), and scalar fields
+ * accept atomic {@link UpdateOperatorInput} objects.
+ */
+export type UpdateDataInput<T, R extends object = {}> = [keyof R] extends [never] ? UpdateInput<T> : UpdateInput<T> & {
+    [K in keyof R]?: NestedUpdateOp<RelationTarget<R[K]> & object, RelationRelations<R[K]> & object>;
+};
 export interface CountArgs<T> {
     where?: WhereClause<T>;
     /** Query timeout in milliseconds. Rejects with an error if exceeded. */

package/dist/query/utils.js

@@ -99,6 +99,7 @@ export function sqlToPreparedName(sql) {
 }
 /** Known operator keys — used to detect operator objects vs plain values */
 export const OPERATOR_KEYS = new Set([
+    'equals',
     'gt',
     'gte',
     'lt',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "turbine-orm",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "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": {
@@ -50,7 +50,7 @@
     "examples": "tsx examples/examples.ts",
     "dogfood": "tsx examples/dogfood.ts",
     "test": "tsx --test --test-concurrency=1 src/test/*.test.ts",
-    "test:unit": "tsx --test src/test/schema-builder.test.ts src/test/errors.test.ts src/test/stress.test.ts src/test/migrate.test.ts src/test/update-operators.test.ts src/test/empty-where-guard.test.ts src/test/cli.test.ts src/test/serverless.test.ts src/test/pipeline.test.ts src/test/pipeline-submittable.test.ts src/test/with-inference.test.ts src/test/operator-validation.test.ts src/test/unlimited-warning.test.ts src/test/generate-relations.test.ts src/test/stream-and-parse.test.ts src/test/sql-cache.test.ts src/test/dialect.test.ts src/test/studio.test.ts src/test/sql-injection.test.ts src/test/cli-flags.test.ts src/test/cockroachdb-adapter.test.ts src/test/yugabytedb-adapter.test.ts src/test/pg-compat.test.ts src/test/relation-filter-validation.test.ts src/test/client-coverage.test.ts src/test/schema-diff.test.ts src/test/composite-fk.test.ts src/test/retry.test.ts src/test/text-search.test.ts src/test/optimistic-lock.test.ts src/test/sql-safety-property.test.ts src/test/nested-write.test.ts src/test/nested-write-update-upsert.test.ts src/test/cursor-pagination.test.ts src/test/client-branches.test.ts src/test/is-isNot-filter.test.ts src/test/event-emitter.test.ts src/test/observe.test.ts src/test/relation-limit-param.test.ts src/test/where-guard-cache-and-relation-where.test.ts",
+    "test:unit": "DATABASE_URL= tsx --test src/test/*.test.ts",
     "test:coverage": "c8 tsx --test --test-concurrency=1 src/test/*.test.ts",
     "lint": "biome check src/",
     "lint:fix": "biome check --write src/",
@@ -59,7 +59,7 @@
     "prepare": "husky",
     "size": "size-limit",
     "size:check": "size-limit",
-    "test:watch": "tsx --watch --test src/test/schema-builder.test.ts src/test/errors.test.ts src/test/stress.test.ts",
+    "test:watch": "tsx --watch --test src/test/*.test.ts",
     "db:seed": "psql $DATABASE_URL -v ON_ERROR_STOP=1 -f src/test/fixtures/seed.sql",
     "db:reset": "psql $DATABASE_URL -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public;' && npm run db:seed",
     "site:dev": "cd site && npm run dev",