@prisma/client-engine-runtime 6.8.2 → 6.9.0-dev.10

package/dist/QueryPlan.d.ts

@@ -47,6 +47,7 @@ export type PrismaValueType = {
 export type ResultNode = {
     type: 'Object';
     fields: Record<string, ResultNode>;
+    flattened: boolean;
 } | {
     type: 'Value';
     dbName: string;
@@ -84,6 +85,7 @@ export type JoinExpression = {
     child: QueryPlanNode;
     on: [left: string, right: string][];
     parentField: string;
+    isRelationUnique: boolean;
 };
 export type QueryPlanNode = {
     type: 'seq';
@@ -168,6 +170,24 @@ export type QueryPlanNode = {
         from: QueryPlanNode;
         to: QueryPlanNode;
     };
+} | {
+    type: 'distinctBy';
+    args: {
+        expr: QueryPlanNode;
+        fields: string[];
+    };
+} | {
+    type: 'paginate';
+    args: {
+        expr: QueryPlanNode;
+        pagination: Pagination;
+    };
+};
+export type Pagination = {
+    cursor: Record<string, PrismaValue> | null;
+    take: number | null;
+    skip: number | null;
+    linkingFields: string[] | null;
 };
 export type DataRule = {
     type: 'rowCountEq';

package/dist/index.d.mts

@@ -32,6 +32,11 @@ export declare type Fragment = {
     type: 'parameterTupleList';
 };
 
+/**
+ * Checks if two objects are deeply equal, recursively checking all properties for strict equality.
+ */
+export declare function isDeepStrictEqual(a: unknown, b: unknown): boolean;
+
 export declare function isPrismaValueBytes(value: unknown): value is PrismaValueBytes;
 
 export declare function isPrismaValueGenerator(value: unknown): value is PrismaValueGenerator;
@@ -42,10 +47,18 @@ export declare type JoinExpression = {
     child: QueryPlanNode;
     on: [left: string, right: string][];
     parentField: string;
+    isRelationUnique: boolean;
 };
 
 export declare const noopTracingHelper: TracingHelper;
 
+export declare type Pagination = {
+    cursor: Record<string, PrismaValue> | null;
+    take: number | null;
+    skip: number | null;
+    linkingFields: string[] | null;
+};
+
 export declare interface PlaceholderFormat {
     prefix: string;
     hasNumbering: boolean;
@@ -233,11 +246,24 @@ export declare type QueryPlanNode = {
         from: QueryPlanNode;
         to: QueryPlanNode;
     };
+} | {
+    type: 'distinctBy';
+    args: {
+        expr: QueryPlanNode;
+        fields: string[];
+    };
+} | {
+    type: 'paginate';
+    args: {
+        expr: QueryPlanNode;
+        pagination: Pagination;
+    };
 };
 
 export declare type ResultNode = {
     type: 'Object';
     fields: Record<string, ResultNode>;
+    flattened: boolean;
 } | {
     type: 'Value';
     dbName: string;

package/dist/index.d.ts

@@ -32,6 +32,11 @@ export declare type Fragment = {
     type: 'parameterTupleList';
 };
 
+/**
+ * Checks if two objects are deeply equal, recursively checking all properties for strict equality.
+ */
+export declare function isDeepStrictEqual(a: unknown, b: unknown): boolean;
+
 export declare function isPrismaValueBytes(value: unknown): value is PrismaValueBytes;
 
 export declare function isPrismaValueGenerator(value: unknown): value is PrismaValueGenerator;
@@ -42,10 +47,18 @@ export declare type JoinExpression = {
     child: QueryPlanNode;
     on: [left: string, right: string][];
     parentField: string;
+    isRelationUnique: boolean;
 };
 
 export declare const noopTracingHelper: TracingHelper;
 
+export declare type Pagination = {
+    cursor: Record<string, PrismaValue> | null;
+    take: number | null;
+    skip: number | null;
+    linkingFields: string[] | null;
+};
+
 export declare interface PlaceholderFormat {
     prefix: string;
     hasNumbering: boolean;
@@ -233,11 +246,24 @@ export declare type QueryPlanNode = {
         from: QueryPlanNode;
         to: QueryPlanNode;
     };
+} | {
+    type: 'distinctBy';
+    args: {
+        expr: QueryPlanNode;
+        fields: string[];
+    };
+} | {
+    type: 'paginate';
+    args: {
+        expr: QueryPlanNode;
+        pagination: Pagination;
+    };
 };
 
 export declare type ResultNode = {
     type: 'Object';
     fields: Record<string, ResultNode>;
+    flattened: boolean;
 } | {
     type: 'Value';
     dbName: string;

package/dist/index.js

@@ -34,6 +34,7 @@ __export(index_exports, {
   TransactionManager: () => TransactionManager,
   TransactionManagerError: () => TransactionManagerError,
   UserFacingError: () => UserFacingError,
+  isDeepStrictEqual: () => isDeepStrictEqual,
   isPrismaValueBytes: () => isPrismaValueBytes,
   isPrismaValueGenerator: () => isPrismaValueGenerator,
   isPrismaValuePlaceholder: () => isPrismaValuePlaceholder,
@@ -48,6 +49,9 @@ var import_api = require("@opentelemetry/api");
 function assertNever(_, message) {
   throw new Error(message);
 }
+function isDeepStrictEqual(a, b) {
+  return a === b || a !== null && b !== null && typeof a === "object" && typeof b === "object" && Object.keys(a).length === Object.keys(b).length && Object.keys(a).every((key) => isDeepStrictEqual(a[key], b[key]));
+}
 
 // src/tracing.ts
 var noopTracingHelper = {
@@ -242,15 +246,16 @@ function mapObject(data, fields) {
   const result = {};
   for (const [name, node] of Object.entries(fields)) {
     switch (node.type) {
-      case "Object":
-        if (Object.hasOwn(data, name)) {
-          result[name] = mapArrayOrObject(data[name], node.fields);
-        } else {
+      case "Object": {
+        if (!node.flattened && !Object.hasOwn(data, name)) {
           throw new Error(
             `DataMapper: Missing data field (Object): '${name}'; node: ${JSON.stringify(node)}; data: ${JSON.stringify(data)}`
           );
         }
+        const target = node.flattened ? data : data[name];
+        result[name] = mapArrayOrObject(target, node.fields);
         break;
+      }
       case "Value":
         {
           const dbName = node.dbName;
@@ -665,8 +670,11 @@ var QueryInterpreter = class _QueryInterpreter {
   async interpretNode(node, queryable, scope, generators) {
     switch (node.type) {
       case "seq": {
-        const results = await Promise.all(node.args.map((arg) => this.interpretNode(arg, queryable, scope, generators)));
-        return results[results.length - 1];
+        let result;
+        for (const arg of node.args) {
+          result = await this.interpretNode(arg, queryable, scope, generators);
+        }
+        return result;
       }
       case "get": {
         return scope[node.args.name];
@@ -790,6 +798,38 @@ var QueryInterpreter = class _QueryInterpreter {
         const toSet = new Set(asList(to));
         return asList(from).filter((item) => !toSet.has(item));
       }
+      case "distinctBy": {
+        const value = await this.interpretNode(node.args.expr, queryable, scope, generators);
+        const seen = /* @__PURE__ */ new Set();
+        const result = [];
+        for (const item of asList(value)) {
+          const key = getRecordKey(item, node.args.fields);
+          if (!seen.has(key)) {
+            seen.add(key);
+            result.push(item);
+          }
+        }
+        return result;
+      }
+      case "paginate": {
+        const value = await this.interpretNode(node.args.expr, queryable, scope, generators);
+        const list = asList(value);
+        const linkingFields = node.args.pagination.linkingFields;
+        if (linkingFields !== null) {
+          const groupedByParent = /* @__PURE__ */ new Map();
+          for (const item of list) {
+            const parentKey = getRecordKey(item, linkingFields);
+            if (!groupedByParent.has(parentKey)) {
+              groupedByParent.set(parentKey, []);
+            }
+            groupedByParent.get(parentKey).push(item);
+          }
+          const groupList = Array.from(groupedByParent.entries());
+          groupList.sort(([aId], [bId]) => aId < bId ? -1 : aId > bId ? 1 : 0);
+          return groupList.flatMap(([, elems]) => paginate(elems, node.args.pagination));
+        }
+        return paginate(list, node.args.pagination);
+      }
       default:
         assertNever(node, `Unexpected node type: ${node.type}`);
     }
@@ -861,7 +901,12 @@ function attachChildrenToParent(parentRecord, children) {
 }
 function filterChildRecords(records, parentRecord, joinExpr) {
   if (Array.isArray(records)) {
-    return records.filter((record) => childRecordMatchesParent(asRecord(record), parentRecord, joinExpr));
+    const filtered = records.filter((record) => childRecordMatchesParent(asRecord(record), parentRecord, joinExpr));
+    if (joinExpr.isRelationUnique) {
+      return filtered.length > 0 ? filtered[0] : null;
+    } else {
+      return filtered;
+    }
   } else if (records === null) {
     return null;
   } else {
@@ -877,6 +922,26 @@ function childRecordMatchesParent(childRecord, parentRecord, joinExpr) {
   }
   return true;
 }
+function paginate(list, { cursor, skip, take }) {
+  const cursorIndex = cursor !== null ? list.findIndex((item) => doesMatchCursor(item, cursor)) : 0;
+  if (cursorIndex === -1) {
+    return [];
+  }
+  const start = cursorIndex + (skip ?? 0);
+  const end = take !== null ? start + take : list.length;
+  return list.slice(start, end);
+}
+function getRecordKey(record, fields) {
+  return JSON.stringify(fields.map((field) => record[field]));
+}
+function doesMatchCursor(item, cursor) {
+  return Object.keys(cursor).every((key) => {
+    if (typeof item[key] !== typeof cursor[key] && (typeof item[key] === "number" || typeof cursor[key] === "number")) {
+      return `${item[key]}` === `${cursor[key]}`;
+    }
+    return isDeepStrictEqual(cursor[key], item[key]);
+  });
+}
 
 // src/transactionManager/TransactionManager.ts
 var import_debug = require("@prisma/debug");
@@ -1099,6 +1164,7 @@ var TransactionManager = class {
   TransactionManager,
   TransactionManagerError,
   UserFacingError,
+  isDeepStrictEqual,
   isPrismaValueBytes,
   isPrismaValueGenerator,
   isPrismaValuePlaceholder,

package/dist/index.mjs

@@ -5,6 +5,9 @@ import { SpanKind } from "@opentelemetry/api";
 function assertNever(_, message) {
   throw new Error(message);
 }
+function isDeepStrictEqual(a, b) {
+  return a === b || a !== null && b !== null && typeof a === "object" && typeof b === "object" && Object.keys(a).length === Object.keys(b).length && Object.keys(a).every((key) => isDeepStrictEqual(a[key], b[key]));
+}
 
 // src/tracing.ts
 var noopTracingHelper = {
@@ -199,15 +202,16 @@ function mapObject(data, fields) {
   const result = {};
   for (const [name, node] of Object.entries(fields)) {
     switch (node.type) {
-      case "Object":
-        if (Object.hasOwn(data, name)) {
-          result[name] = mapArrayOrObject(data[name], node.fields);
-        } else {
+      case "Object": {
+        if (!node.flattened && !Object.hasOwn(data, name)) {
           throw new Error(
             `DataMapper: Missing data field (Object): '${name}'; node: ${JSON.stringify(node)}; data: ${JSON.stringify(data)}`
           );
         }
+        const target = node.flattened ? data : data[name];
+        result[name] = mapArrayOrObject(target, node.fields);
         break;
+      }
       case "Value":
         {
           const dbName = node.dbName;
@@ -622,8 +626,11 @@ var QueryInterpreter = class _QueryInterpreter {
   async interpretNode(node, queryable, scope, generators) {
     switch (node.type) {
       case "seq": {
-        const results = await Promise.all(node.args.map((arg) => this.interpretNode(arg, queryable, scope, generators)));
-        return results[results.length - 1];
+        let result;
+        for (const arg of node.args) {
+          result = await this.interpretNode(arg, queryable, scope, generators);
+        }
+        return result;
       }
       case "get": {
         return scope[node.args.name];
@@ -747,6 +754,38 @@ var QueryInterpreter = class _QueryInterpreter {
         const toSet = new Set(asList(to));
         return asList(from).filter((item) => !toSet.has(item));
       }
+      case "distinctBy": {
+        const value = await this.interpretNode(node.args.expr, queryable, scope, generators);
+        const seen = /* @__PURE__ */ new Set();
+        const result = [];
+        for (const item of asList(value)) {
+          const key = getRecordKey(item, node.args.fields);
+          if (!seen.has(key)) {
+            seen.add(key);
+            result.push(item);
+          }
+        }
+        return result;
+      }
+      case "paginate": {
+        const value = await this.interpretNode(node.args.expr, queryable, scope, generators);
+        const list = asList(value);
+        const linkingFields = node.args.pagination.linkingFields;
+        if (linkingFields !== null) {
+          const groupedByParent = /* @__PURE__ */ new Map();
+          for (const item of list) {
+            const parentKey = getRecordKey(item, linkingFields);
+            if (!groupedByParent.has(parentKey)) {
+              groupedByParent.set(parentKey, []);
+            }
+            groupedByParent.get(parentKey).push(item);
+          }
+          const groupList = Array.from(groupedByParent.entries());
+          groupList.sort(([aId], [bId]) => aId < bId ? -1 : aId > bId ? 1 : 0);
+          return groupList.flatMap(([, elems]) => paginate(elems, node.args.pagination));
+        }
+        return paginate(list, node.args.pagination);
+      }
       default:
         assertNever(node, `Unexpected node type: ${node.type}`);
     }
@@ -818,7 +857,12 @@ function attachChildrenToParent(parentRecord, children) {
 }
 function filterChildRecords(records, parentRecord, joinExpr) {
   if (Array.isArray(records)) {
-    return records.filter((record) => childRecordMatchesParent(asRecord(record), parentRecord, joinExpr));
+    const filtered = records.filter((record) => childRecordMatchesParent(asRecord(record), parentRecord, joinExpr));
+    if (joinExpr.isRelationUnique) {
+      return filtered.length > 0 ? filtered[0] : null;
+    } else {
+      return filtered;
+    }
   } else if (records === null) {
     return null;
   } else {
@@ -834,6 +878,26 @@ function childRecordMatchesParent(childRecord, parentRecord, joinExpr) {
   }
   return true;
 }
+function paginate(list, { cursor, skip, take }) {
+  const cursorIndex = cursor !== null ? list.findIndex((item) => doesMatchCursor(item, cursor)) : 0;
+  if (cursorIndex === -1) {
+    return [];
+  }
+  const start = cursorIndex + (skip ?? 0);
+  const end = take !== null ? start + take : list.length;
+  return list.slice(start, end);
+}
+function getRecordKey(record, fields) {
+  return JSON.stringify(fields.map((field) => record[field]));
+}
+function doesMatchCursor(item, cursor) {
+  return Object.keys(cursor).every((key) => {
+    if (typeof item[key] !== typeof cursor[key] && (typeof item[key] === "number" || typeof cursor[key] === "number")) {
+      return `${item[key]}` === `${cursor[key]}`;
+    }
+    return isDeepStrictEqual(cursor[key], item[key]);
+  });
+}
 
 // src/transactionManager/TransactionManager.ts
 import { Debug } from "@prisma/debug";
@@ -1055,6 +1119,7 @@ export {
   TransactionManager,
   TransactionManagerError,
   UserFacingError,
+  isDeepStrictEqual,
   isPrismaValueBytes,
   isPrismaValueGenerator,
   isPrismaValuePlaceholder,

package/dist/utils.d.ts

@@ -1 +1,5 @@
 export declare function assertNever(_: never, message: string): never;
+/**
+ * Checks if two objects are deeply equal, recursively checking all properties for strict equality.
+ */
+export declare function isDeepStrictEqual(a: unknown, b: unknown): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/client-engine-runtime",
-  "version": "6.8.2",
+  "version": "6.9.0-dev.10",
   "description": "This package is intended for Prisma's internal use",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,8 +31,8 @@
     "nanoid": "5.1.5",
     "ulid": "3.0.0",
     "uuid": "11.1.0",
-    "@prisma/debug": "6.8.2",
-    "@prisma/driver-adapter-utils": "6.8.2"
+    "@prisma/debug": "6.9.0-dev.10",
+    "@prisma/driver-adapter-utils": "6.9.0-dev.10"
   },
   "devDependencies": {
     "@types/jest": "29.5.14",