@prisma/client-engine-runtime 6.8.0-dev.11 → 6.8.0-dev.12

package/dist/QueryPlan.d.ts

@@ -141,4 +141,51 @@ export type QueryPlanNode = {
         expr: QueryPlanNode;
         structure: ResultNode;
     };
+} | {
+    type: 'validate';
+    args: {
+        expr: QueryPlanNode;
+        rules: DataRule[];
+    } & ValidationError;
+};
+export type DataRule = {
+    type: 'rowCountEq';
+    args: number;
+} | {
+    type: 'rowCountNeq';
+    args: number;
+};
+export type ValidationError = {
+    error_identifier: 'RELATION_VIOLATION';
+    context: {
+        relation: string;
+        modelA: string;
+        modelB: string;
+    };
+} | {
+    error_identifier: 'MISSING_RELATED_RECORD';
+    context: {
+        model: string;
+        relation: string;
+        relationType: string;
+        operation: string;
+        neededFor?: string;
+    };
+} | {
+    error_identifier: 'MISSING_RECORD';
+    context: {
+        operation: string;
+    };
+} | {
+    error_identifier: 'INCOMPLETE_CONNECT_INPUT';
+    context: {
+        expectedRows: number;
+    };
+} | {
+    error_identifier: 'RECORDS_NOT_CONNECTED';
+    context: {
+        relation: string;
+        parent: string;
+        child: string;
+    };
 };

package/dist/index.d.mts

@@ -7,6 +7,14 @@ import { SqlQueryable } from '@prisma/driver-adapter-utils';
 import { SqlResultSet } from '@prisma/driver-adapter-utils';
 import { Transaction } from '@prisma/driver-adapter-utils';
 
+export declare type DataRule = {
+    type: 'rowCountEq';
+    args: number;
+} | {
+    type: 'rowCountNeq';
+    args: number;
+};
+
 declare type ExtendedSpanOptions = SpanOptions & {
     name: string;
 };
@@ -194,6 +202,12 @@ export declare type QueryPlanNode = {
         expr: QueryPlanNode;
         structure: ResultNode;
     };
+} | {
+    type: 'validate';
+    args: {
+        expr: QueryPlanNode;
+        rules: DataRule[];
+    } & ValidationError;
 };
 
 export declare type ResultNode = {
@@ -266,6 +280,41 @@ export declare class UserFacingError extends Error {
     };
 }
 
+export declare type ValidationError = {
+    error_identifier: 'RELATION_VIOLATION';
+    context: {
+        relation: string;
+        modelA: string;
+        modelB: string;
+    };
+} | {
+    error_identifier: 'MISSING_RELATED_RECORD';
+    context: {
+        model: string;
+        relation: string;
+        relationType: string;
+        operation: string;
+        neededFor?: string;
+    };
+} | {
+    error_identifier: 'MISSING_RECORD';
+    context: {
+        operation: string;
+    };
+} | {
+    error_identifier: 'INCOMPLETE_CONNECT_INPUT';
+    context: {
+        expectedRows: number;
+    };
+} | {
+    error_identifier: 'RECORDS_NOT_CONNECTED';
+    context: {
+        relation: string;
+        parent: string;
+        child: string;
+    };
+};
+
 /**
  * The general type of values each node can evaluate to.
  */

package/dist/index.d.ts

@@ -7,6 +7,14 @@ import { SqlQueryable } from '@prisma/driver-adapter-utils';
 import { SqlResultSet } from '@prisma/driver-adapter-utils';
 import { Transaction } from '@prisma/driver-adapter-utils';
 
+export declare type DataRule = {
+    type: 'rowCountEq';
+    args: number;
+} | {
+    type: 'rowCountNeq';
+    args: number;
+};
+
 declare type ExtendedSpanOptions = SpanOptions & {
     name: string;
 };
@@ -194,6 +202,12 @@ export declare type QueryPlanNode = {
         expr: QueryPlanNode;
         structure: ResultNode;
     };
+} | {
+    type: 'validate';
+    args: {
+        expr: QueryPlanNode;
+        rules: DataRule[];
+    } & ValidationError;
 };
 
 export declare type ResultNode = {
@@ -266,6 +280,41 @@ export declare class UserFacingError extends Error {
     };
 }
 
+export declare type ValidationError = {
+    error_identifier: 'RELATION_VIOLATION';
+    context: {
+        relation: string;
+        modelA: string;
+        modelB: string;
+    };
+} | {
+    error_identifier: 'MISSING_RELATED_RECORD';
+    context: {
+        model: string;
+        relation: string;
+        relationType: string;
+        operation: string;
+        neededFor?: string;
+    };
+} | {
+    error_identifier: 'MISSING_RECORD';
+    context: {
+        operation: string;
+    };
+} | {
+    error_identifier: 'INCOMPLETE_CONNECT_INPUT';
+    context: {
+        expectedRows: number;
+    };
+} | {
+    error_identifier: 'RECORDS_NOT_CONNECTED';
+    context: {
+        relation: string;
+        parent: string;
+        child: string;
+    };
+};
+
 /**
  * The general type of values each node can evaluate to.
  */

package/dist/index.js

@@ -581,6 +581,67 @@ function serializeSql(resultSet) {
   );
 }
 
+// src/interpreter/validation.ts
+function performValidation(data, rules, error) {
+  if (!rules.every((rule) => doesSatisfyRule(data, rule))) {
+    const message = renderMessage(data, error);
+    const code = getErrorCode2(error);
+    throw new UserFacingError(message, code, error.context);
+  }
+}
+function doesSatisfyRule(data, rule) {
+  switch (rule.type) {
+    case "rowCountEq":
+      if (Array.isArray(data)) {
+        return data.length === rule.args;
+      }
+      if (data === null) {
+        return rule.args === 0;
+      }
+      return rule.args === 1;
+    case "rowCountNeq":
+      if (Array.isArray(data)) {
+        return data.length !== rule.args;
+      }
+      if (data === null) {
+        return rule.args !== 0;
+      }
+      return rule.args !== 1;
+  }
+}
+function renderMessage(data, error) {
+  switch (error.error_identifier) {
+    case "RELATION_VIOLATION":
+      return `The change you are trying to make would violate the required relation '${error.context.relation}' between the \`${error.context.modelA}\` and \`${error.context.modelB}\` models.`;
+    case "MISSING_RECORD":
+      return `No record was found for ${error.context.operation}.`;
+    case "MISSING_RELATED_RECORD": {
+      const hint = error.context.neededFor ? ` (needed to ${error.context.neededFor})` : "";
+      return `An operation failed because it depends on one or more records that were required but not found. No '${error.context.model}' record${hint} was found for ${error.context.operation} on ${error.context.relationType} relation '${error.context.relation}'.`;
+    }
+    case "INCOMPLETE_CONNECT_INPUT":
+      return `An operation failed because it depends on one or more records that were required but not found. Expected ${error.context.expectedRows} records to be connected, found only ${Array.isArray(data) ? data.length : 0}.`;
+    case "RECORDS_NOT_CONNECTED":
+      return `The records for relation \`${error.context.relation}\` between the \`${error.context.parent}\` and \`${error.context.child}\` models are not connected.`;
+    default:
+      assertNever(error, `Unknown error identifier: ${error}`);
+  }
+}
+function getErrorCode2(error) {
+  switch (error.error_identifier) {
+    case "RELATION_VIOLATION":
+      return "P2014";
+    case "RECORDS_NOT_CONNECTED":
+      return "P2017";
+    case "MISSING_RECORD":
+    case "MISSING_RELATED_RECORD":
+    case "INCOMPLETE_CONNECT_INPUT":
+      return "P2025";
+    default:
+      assertNever(error, `Unknown error identifier: ${error}`);
+  }
+}
+
 // src/interpreter/QueryInterpreter.ts
 var QueryInterpreter = class _QueryInterpreter {
   #transactionManager;
@@ -718,6 +779,11 @@ var QueryInterpreter = class _QueryInterpreter {
         const data = await this.interpretNode(node.args.expr, queryable, scope, generators);
         return applyDataMap(data, node.args.structure);
       }
+      case "validate": {
+        const data = await this.interpretNode(node.args.expr, queryable, scope, generators);
+        performValidation(data, node.args.rules, node.args);
+        return data;
+      }
       default:
         assertNever(node, `Unexpected node type: ${node.type}`);
     }

package/dist/index.mjs

@@ -539,6 +539,67 @@ function serializeSql(resultSet) {
   );
 }
 
+// src/interpreter/validation.ts
+function performValidation(data, rules, error) {
+  if (!rules.every((rule) => doesSatisfyRule(data, rule))) {
+    const message = renderMessage(data, error);
+    const code = getErrorCode2(error);
+    throw new UserFacingError(message, code, error.context);
+  }
+}
+function doesSatisfyRule(data, rule) {
+  switch (rule.type) {
+    case "rowCountEq":
+      if (Array.isArray(data)) {
+        return data.length === rule.args;
+      }
+      if (data === null) {
+        return rule.args === 0;
+      }
+      return rule.args === 1;
+    case "rowCountNeq":
+      if (Array.isArray(data)) {
+        return data.length !== rule.args;
+      }
+      if (data === null) {
+        return rule.args !== 0;
+      }
+      return rule.args !== 1;
+  }
+}
+function renderMessage(data, error) {
+  switch (error.error_identifier) {
+    case "RELATION_VIOLATION":
+      return `The change you are trying to make would violate the required relation '${error.context.relation}' between the \`${error.context.modelA}\` and \`${error.context.modelB}\` models.`;
+    case "MISSING_RECORD":
+      return `No record was found for ${error.context.operation}.`;
+    case "MISSING_RELATED_RECORD": {
+      const hint = error.context.neededFor ? ` (needed to ${error.context.neededFor})` : "";
+      return `An operation failed because it depends on one or more records that were required but not found. No '${error.context.model}' record${hint} was found for ${error.context.operation} on ${error.context.relationType} relation '${error.context.relation}'.`;
+    }
+    case "INCOMPLETE_CONNECT_INPUT":
+      return `An operation failed because it depends on one or more records that were required but not found. Expected ${error.context.expectedRows} records to be connected, found only ${Array.isArray(data) ? data.length : 0}.`;
+    case "RECORDS_NOT_CONNECTED":
+      return `The records for relation \`${error.context.relation}\` between the \`${error.context.parent}\` and \`${error.context.child}\` models are not connected.`;
+    default:
+      assertNever(error, `Unknown error identifier: ${error}`);
+  }
+}
+function getErrorCode2(error) {
+  switch (error.error_identifier) {
+    case "RELATION_VIOLATION":
+      return "P2014";
+    case "RECORDS_NOT_CONNECTED":
+      return "P2017";
+    case "MISSING_RECORD":
+    case "MISSING_RELATED_RECORD":
+    case "INCOMPLETE_CONNECT_INPUT":
+      return "P2025";
+    default:
+      assertNever(error, `Unknown error identifier: ${error}`);
+  }
+}
+
 // src/interpreter/QueryInterpreter.ts
 var QueryInterpreter = class _QueryInterpreter {
   #transactionManager;
@@ -676,6 +737,11 @@ var QueryInterpreter = class _QueryInterpreter {
         const data = await this.interpretNode(node.args.expr, queryable, scope, generators);
         return applyDataMap(data, node.args.structure);
       }
+      case "validate": {
+        const data = await this.interpretNode(node.args.expr, queryable, scope, generators);
+        performValidation(data, node.args.rules, node.args);
+        return data;
+      }
       default:
         assertNever(node, `Unexpected node type: ${node.type}`);
     }

package/dist/interpreter/validation.d.ts

@@ -0,0 +1,2 @@
+import { DataRule, ValidationError } from '../QueryPlan';
+export declare function performValidation(data: unknown, rules: DataRule[], error: ValidationError): void;

package/package.json

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