turbine-orm 0.13.0 → 0.13.2

package/dist/cjs/dialect.js

@@ -8,6 +8,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.postgresDialect = void 0;
+const errors_js_1 = require("./errors.js");
 /** PostgreSQL implementation of the dialect contract. */
 exports.postgresDialect = {
     name: 'postgresql',
@@ -41,7 +42,7 @@ exports.postgresDialect = {
     },
     buildBulkInsertStatement(input) {
         if (!input.columnArrayTypes || input.columnArrayTypes.length !== input.columns.length) {
-            throw new Error('PostgreSQL bulk insert requires one array type per column');
+            throw new errors_js_1.ValidationError('PostgreSQL bulk insert requires one array type per column');
         }
         const columnArrays = input.columns.map((_, columnIndex) => input.rowValues.map((row) => row[columnIndex]));
         const unnestArgs = input.columns.map((_, i) => `${this.paramPlaceholder(i + 1)}::${input.columnArrayTypes[i]}`);

package/dist/cjs/query/builder.js

@@ -1538,8 +1538,7 @@ class QueryInterface {
             }
             // Array filter
             if (typeof value === 'object' && !Array.isArray(value) && isArrayFilter(value)) {
-                const aKeys = Object.keys(value).sort();
-                parts.push(`${key}:arr(${aKeys.join(',')})`);
+                parts.push(`${key}:arr(${this.fingerprintArrayFilter(value)})`);
                 continue;
             }
             // Plain equality
@@ -1547,6 +1546,15 @@ class QueryInterface {
         }
         return parts.join('&');
     }
+    /**
+     * Produce a value-invariant fingerprint for array filters while preserving
+     * parameterless boolean operators that change SQL shape.
+     */
+    fingerprintArrayFilter(filter) {
+        const keys = Object.keys(filter).sort();
+        const suffix = filter.isEmpty === undefined ? '' : `:empty=${filter.isEmpty ? 'true' : 'false'}`;
+        return `${keys.join(',')}${suffix}`;
+    }
     /**
      * Fingerprint a relation filter sub-where for some/every/none.
      */
@@ -1742,8 +1750,10 @@ class QueryInterface {
             if (!spec)
                 continue;
             const relDef = meta.relations[relName];
-            if (!relDef)
+            if (!relDef) {
+                parts.push(`unknown:${relName}`);
                 continue;
+            }
             if (spec === true) {
                 parts.push(relName);
                 continue;
@@ -2653,12 +2663,12 @@ class QueryInterface {
             clauses.push(`${column} && ${this.p(params.length)}::${elementType}[]`);
         }
         if (filter.isEmpty === true) {
-            // array_length(column, 1) IS NULL
-            clauses.push(`array_length(${column}, 1) IS NULL`);
+            // Treat NULL and empty arrays as empty for Prisma-compatible ergonomics.
+            clauses.push(`COALESCE(cardinality(${column}), 0) = 0`);
         }
         else if (filter.isEmpty === false) {
-            // array_length(column, 1) IS NOT NULL
-            clauses.push(`array_length(${column}, 1) IS NOT NULL`);
+            // Require at least one element; excludes both NULL and ARRAY[] values.
+            clauses.push(`cardinality(${column}) > 0`);
         }
         return clauses;
     }

package/dist/dialect.js

@@ -5,6 +5,7 @@
  * PostgreSQL-native by default, but query generation now depends on this
  * contract for the SQL primitives that vary across MySQL and SQLite.
  */
+import { ValidationError } from './errors.js';
 /** PostgreSQL implementation of the dialect contract. */
 export const postgresDialect = {
     name: 'postgresql',
@@ -38,7 +39,7 @@ export const postgresDialect = {
     },
     buildBulkInsertStatement(input) {
         if (!input.columnArrayTypes || input.columnArrayTypes.length !== input.columns.length) {
-            throw new Error('PostgreSQL bulk insert requires one array type per column');
+            throw new ValidationError('PostgreSQL bulk insert requires one array type per column');
         }
         const columnArrays = input.columns.map((_, columnIndex) => input.rowValues.map((row) => row[columnIndex]));
         const unnestArgs = input.columns.map((_, i) => `${this.paramPlaceholder(i + 1)}::${input.columnArrayTypes[i]}`);

package/dist/query/builder.d.ts

@@ -258,6 +258,11 @@ export declare class QueryInterface<T extends object, R extends object = {}> {
      * @internal Exposed as package-private for testing via class access.
      */
     fingerprintWhere(where: Record<string, unknown>): string;
+    /**
+     * Produce a value-invariant fingerprint for array filters while preserving
+     * parameterless boolean operators that change SQL shape.
+     */
+    private fingerprintArrayFilter;
     /**
      * Fingerprint a relation filter sub-where for some/every/none.
      */

package/dist/query/builder.js

@@ -1535,8 +1535,7 @@ export class QueryInterface {
             }
             // Array filter
             if (typeof value === 'object' && !Array.isArray(value) && isArrayFilter(value)) {
-                const aKeys = Object.keys(value).sort();
-                parts.push(`${key}:arr(${aKeys.join(',')})`);
+                parts.push(`${key}:arr(${this.fingerprintArrayFilter(value)})`);
                 continue;
             }
             // Plain equality
@@ -1544,6 +1543,15 @@ export class QueryInterface {
         }
         return parts.join('&');
     }
+    /**
+     * Produce a value-invariant fingerprint for array filters while preserving
+     * parameterless boolean operators that change SQL shape.
+     */
+    fingerprintArrayFilter(filter) {
+        const keys = Object.keys(filter).sort();
+        const suffix = filter.isEmpty === undefined ? '' : `:empty=${filter.isEmpty ? 'true' : 'false'}`;
+        return `${keys.join(',')}${suffix}`;
+    }
     /**
      * Fingerprint a relation filter sub-where for some/every/none.
      */
@@ -1739,8 +1747,10 @@ export class QueryInterface {
             if (!spec)
                 continue;
             const relDef = meta.relations[relName];
-            if (!relDef)
+            if (!relDef) {
+                parts.push(`unknown:${relName}`);
                 continue;
+            }
             if (spec === true) {
                 parts.push(relName);
                 continue;
@@ -2650,12 +2660,12 @@ export class QueryInterface {
             clauses.push(`${column} && ${this.p(params.length)}::${elementType}[]`);
         }
         if (filter.isEmpty === true) {
-            // array_length(column, 1) IS NULL
-            clauses.push(`array_length(${column}, 1) IS NULL`);
+            // Treat NULL and empty arrays as empty for Prisma-compatible ergonomics.
+            clauses.push(`COALESCE(cardinality(${column}), 0) = 0`);
         }
         else if (filter.isEmpty === false) {
-            // array_length(column, 1) IS NOT NULL
-            clauses.push(`array_length(${column}, 1) IS NOT NULL`);
+            // Require at least one element; excludes both NULL and ARRAY[] values.
+            clauses.push(`cardinality(${column}) > 0`);
         }
         return clauses;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "turbine-orm",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "Postgres-native TypeScript ORM — runs on Neon, Vercel Postgres, Cloudflare, Supabase. Streaming cursors, typed errors, single-query nested relations. 1 dependency, ~110KB",
   "type": "module",
   "exports": {
@@ -41,7 +41,7 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "prebuild": "node scripts/build-studio-ui.mjs",
+    "prebuild": "npm run gen:studio",
     "build": "tsc && tsc --project tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit --project tsconfig.test.json",
@@ -63,7 +63,12 @@
     "db:reset": "psql $DATABASE_URL -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public;' && npm run db:seed",
     "site:dev": "cd site && npm run dev",
     "site:build": "cd site && npm run build",
-    "site:deploy": "cd site && vercel --prod"
+    "site:deploy": "cd site && vercel --prod",
+    "gen:studio": "node scripts/build-studio-ui.mjs",
+    "pretypecheck": "npm run gen:studio",
+    "pretest": "npm run gen:studio",
+    "pretest:unit": "npm run gen:studio",
+    "pretest:coverage": "npm run gen:studio"
   },
   "engines": {
     "node": ">=18.0.0"