@prisma/client-engine-runtime 6.7.0-dev.3 → 6.7.0-dev.4

package/dist/UserFacingError.d.ts

@@ -0,0 +1,16 @@
+export declare class UserFacingError extends Error {
+    name: string;
+    code: string;
+    meta: unknown;
+    constructor(message: string, code: string, meta?: unknown);
+    toQueryResponseErrorObject(): {
+        error: string;
+        user_facing_error: {
+            is_panic: boolean;
+            message: string;
+            meta: unknown;
+            error_code: string;
+        };
+    };
+}
+export declare function rethrowAsUserFacing(error: any): never;

package/dist/index.d.mts

@@ -181,4 +181,20 @@ export declare type TransactionOptions = {
     isolationLevel?: IsolationLevel;
 };
 
+export declare class UserFacingError extends Error {
+    name: string;
+    code: string;
+    meta: unknown;
+    constructor(message: string, code: string, meta?: unknown);
+    toQueryResponseErrorObject(): {
+        error: string;
+        user_facing_error: {
+            is_panic: boolean;
+            message: string;
+            meta: unknown;
+            error_code: string;
+        };
+    };
+}
+
 export { }

package/dist/index.d.ts

@@ -181,4 +181,20 @@ export declare type TransactionOptions = {
     isolationLevel?: IsolationLevel;
 };
 
+export declare class UserFacingError extends Error {
+    name: string;
+    code: string;
+    meta: unknown;
+    constructor(message: string, code: string, meta?: unknown);
+    toQueryResponseErrorObject(): {
+        error: string;
+        user_facing_error: {
+            is_panic: boolean;
+            message: string;
+            meta: unknown;
+            error_code: string;
+        };
+    };
+}
+
 export { }

package/dist/index.js

@@ -33,11 +33,159 @@ __export(index_exports, {
   QueryInterpreter: () => QueryInterpreter,
   TransactionManager: () => TransactionManager,
   TransactionManagerError: () => TransactionManagerError,
+  UserFacingError: () => UserFacingError,
   isPrismaValueGenerator: () => isPrismaValueGenerator,
   isPrismaValuePlaceholder: () => isPrismaValuePlaceholder
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/UserFacingError.ts
+var import_driver_adapter_utils = require("@prisma/driver-adapter-utils");
+var UserFacingError = class extends Error {
+  name = "UserFacingError";
+  code;
+  meta;
+  constructor(message, code, meta) {
+    super(message);
+    this.code = code;
+    this.meta = meta;
+  }
+  toQueryResponseErrorObject() {
+    return {
+      error: this.message,
+      user_facing_error: {
+        is_panic: false,
+        message: this.message,
+        meta: this.meta,
+        error_code: this.code
+      }
+    };
+  }
+};
+function rethrowAsUserFacing(error) {
+  if (!(0, import_driver_adapter_utils.isDriverAdapterError)(error)) {
+    throw error;
+  }
+  const code = getErrorCode(error);
+  const message = renderErrorMessage(error);
+  if (!code || !message) {
+    throw error;
+  }
+  throw new UserFacingError(message, code, error);
+}
+function getErrorCode(err) {
+  switch (err.cause.kind) {
+    case "AuthenticationFailed":
+      return "P1000";
+    case "DatabaseDoesNotExist":
+      return "P1003";
+    case "SocketTimeout":
+      return "P1008";
+    case "DatabaseAlreadyExists":
+      return "P1009";
+    case "DatabaseAccessDenied":
+      return "P1010";
+    case "LengthMismatch":
+      return "P2000";
+    case "UniqueConstraintViolation":
+      return "P2002";
+    case "ForeignKeyConstraintViolation":
+      return "P2003";
+    case "UnsupportedNativeDataType":
+      return "P2010";
+    case "NullConstraintViolation":
+      return "P2011";
+    case "TableDoesNotExist":
+      return "P2021";
+    case "ColumnNotFound":
+      return "P2022";
+    case "InvalidIsolationLevel":
+      return "P2023";
+    case "TransactionWriteConflict":
+      return "P2034";
+    case "GenericJs":
+      return "P2036";
+    case "TooManyConnections":
+      return "P2037";
+    case "postgres":
+    case "sqlite":
+    case "mysql":
+      return;
+    default: {
+      const cause = err.cause;
+      throw new Error(`Unknown error: ${cause}`);
+    }
+  }
+}
+function renderErrorMessage(err) {
+  switch (err.cause.kind) {
+    case "AuthenticationFailed": {
+      const user = err.cause.user ?? "(not available)";
+      return `Authentication failed against the database server, the provided database credentials for \`${user}\` are not valid`;
+    }
+    case "DatabaseDoesNotExist": {
+      const db = err.cause.db ?? "(not available)";
+      return `Database \`${db}\` does not exist on the database server`;
+    }
+    case "SocketTimeout":
+      return `Operation has timed out`;
+    case "DatabaseAlreadyExists": {
+      const db = err.cause.db ?? "(not available)";
+      return `Database \`${db}\` already exists on the database server`;
+    }
+    case "DatabaseAccessDenied": {
+      const db = err.cause.db ?? "(not available)";
+      return `User was denied access on the database \`${db}\``;
+    }
+    case "LengthMismatch": {
+      const column = err.cause.column ?? "(not available)";
+      return `The provided value for the column is too long for the column's type. Column: ${column}`;
+    }
+    case "UniqueConstraintViolation":
+      return `Unique constraint failed on the ${renderConstraint({ fields: err.cause.fields })}`;
+    case "ForeignKeyConstraintViolation":
+      return `Foreign key constraint violated on the ${renderConstraint(err.cause.constraint)}`;
+    case "UnsupportedNativeDataType":
+      return `Failed to deserialize column of type '${err.cause.type}'. If you're using $queryRaw and this column is explicitly marked as \`Unsupported\` in your Prisma schema, try casting this column to any supported Prisma type such as \`String\`.`;
+    case "NullConstraintViolation":
+      return `Null constraint violation on the ${renderConstraint({ fields: err.cause.fields })}`;
+    case "TableDoesNotExist": {
+      const table = err.cause.table ?? "(not available)";
+      return `The table \`${table}\` does not exist in the current database.`;
+    }
+    case "ColumnNotFound": {
+      const column = err.cause.column ?? "(not available)";
+      return `The column \`${column}\` does not exist in the current database.`;
+    }
+    case "InvalidIsolationLevel":
+      return `Invalid isolation level \`${err.cause.level}\``;
+    case "TransactionWriteConflict":
+      return `Transaction failed due to a write conflict or a deadlock. Please retry your transaction`;
+    case "GenericJs":
+      return `Error in external connector (id ${err.cause.id})`;
+    case "TooManyConnections":
+      return `Too many database connections opened: ${err.cause.cause}`;
+    case "sqlite":
+    case "postgres":
+    case "mysql":
+      return;
+    default: {
+      const cause = err.cause;
+      throw new Error(`Unknown error: ${cause}`);
+    }
+  }
+}
+function renderConstraint(constraint) {
+  if (constraint && "fields" in constraint) {
+    return `fields: (${constraint.fields.map((field) => `\`${field}\``).join(", ")})`;
+  } else if (constraint && "index" in constraint) {
+    return `constraint: \`${constraint.index}\``;
+  } else if (constraint && "foreignKey" in constraint) {
+    return `foreign key`;
+  }
+  return "(not available)";
+}
+
 // src/interpreter/generators.ts
 var import_cuid = __toESM(require("@bugsnag/cuid"));
 var import_cuid2 = require("@paralleldrive/cuid2");
@@ -284,7 +432,9 @@ var QueryInterpreter = class {
     this.#onQuery = onQuery;
   }
   async run(queryPlan, queryable) {
-    return this.interpretNode(queryPlan, queryable, this.#placeholderValues, this.#generators.snapshot());
+    return this.interpretNode(queryPlan, queryable, this.#placeholderValues, this.#generators.snapshot()).catch(
+      (e) => rethrowAsUserFacing(e)
+    );
   }
   async interpretNode(node, queryable, scope, generators) {
     switch (node.type) {
@@ -673,6 +823,7 @@ var TransactionManager = class {
   QueryInterpreter,
   TransactionManager,
   TransactionManagerError,
+  UserFacingError,
   isPrismaValueGenerator,
   isPrismaValuePlaceholder
 });

package/dist/index.mjs

@@ -1,3 +1,150 @@
+// src/UserFacingError.ts
+import { isDriverAdapterError } from "@prisma/driver-adapter-utils";
+var UserFacingError = class extends Error {
+  name = "UserFacingError";
+  code;
+  meta;
+  constructor(message, code, meta) {
+    super(message);
+    this.code = code;
+    this.meta = meta;
+  }
+  toQueryResponseErrorObject() {
+    return {
+      error: this.message,
+      user_facing_error: {
+        is_panic: false,
+        message: this.message,
+        meta: this.meta,
+        error_code: this.code
+      }
+    };
+  }
+};
+function rethrowAsUserFacing(error) {
+  if (!isDriverAdapterError(error)) {
+    throw error;
+  }
+  const code = getErrorCode(error);
+  const message = renderErrorMessage(error);
+  if (!code || !message) {
+    throw error;
+  }
+  throw new UserFacingError(message, code, error);
+}
+function getErrorCode(err) {
+  switch (err.cause.kind) {
+    case "AuthenticationFailed":
+      return "P1000";
+    case "DatabaseDoesNotExist":
+      return "P1003";
+    case "SocketTimeout":
+      return "P1008";
+    case "DatabaseAlreadyExists":
+      return "P1009";
+    case "DatabaseAccessDenied":
+      return "P1010";
+    case "LengthMismatch":
+      return "P2000";
+    case "UniqueConstraintViolation":
+      return "P2002";
+    case "ForeignKeyConstraintViolation":
+      return "P2003";
+    case "UnsupportedNativeDataType":
+      return "P2010";
+    case "NullConstraintViolation":
+      return "P2011";
+    case "TableDoesNotExist":
+      return "P2021";
+    case "ColumnNotFound":
+      return "P2022";
+    case "InvalidIsolationLevel":
+      return "P2023";
+    case "TransactionWriteConflict":
+      return "P2034";
+    case "GenericJs":
+      return "P2036";
+    case "TooManyConnections":
+      return "P2037";
+    case "postgres":
+    case "sqlite":
+    case "mysql":
+      return;
+    default: {
+      const cause = err.cause;
+      throw new Error(`Unknown error: ${cause}`);
+    }
+  }
+}
+function renderErrorMessage(err) {
+  switch (err.cause.kind) {
+    case "AuthenticationFailed": {
+      const user = err.cause.user ?? "(not available)";
+      return `Authentication failed against the database server, the provided database credentials for \`${user}\` are not valid`;
+    }
+    case "DatabaseDoesNotExist": {
+      const db = err.cause.db ?? "(not available)";
+      return `Database \`${db}\` does not exist on the database server`;
+    }
+    case "SocketTimeout":
+      return `Operation has timed out`;
+    case "DatabaseAlreadyExists": {
+      const db = err.cause.db ?? "(not available)";
+      return `Database \`${db}\` already exists on the database server`;
+    }
+    case "DatabaseAccessDenied": {
+      const db = err.cause.db ?? "(not available)";
+      return `User was denied access on the database \`${db}\``;
+    }
+    case "LengthMismatch": {
+      const column = err.cause.column ?? "(not available)";
+      return `The provided value for the column is too long for the column's type. Column: ${column}`;
+    }
+    case "UniqueConstraintViolation":
+      return `Unique constraint failed on the ${renderConstraint({ fields: err.cause.fields })}`;
+    case "ForeignKeyConstraintViolation":
+      return `Foreign key constraint violated on the ${renderConstraint(err.cause.constraint)}`;
+    case "UnsupportedNativeDataType":
+      return `Failed to deserialize column of type '${err.cause.type}'. If you're using $queryRaw and this column is explicitly marked as \`Unsupported\` in your Prisma schema, try casting this column to any supported Prisma type such as \`String\`.`;
+    case "NullConstraintViolation":
+      return `Null constraint violation on the ${renderConstraint({ fields: err.cause.fields })}`;
+    case "TableDoesNotExist": {
+      const table = err.cause.table ?? "(not available)";
+      return `The table \`${table}\` does not exist in the current database.`;
+    }
+    case "ColumnNotFound": {
+      const column = err.cause.column ?? "(not available)";
+      return `The column \`${column}\` does not exist in the current database.`;
+    }
+    case "InvalidIsolationLevel":
+      return `Invalid isolation level \`${err.cause.level}\``;
+    case "TransactionWriteConflict":
+      return `Transaction failed due to a write conflict or a deadlock. Please retry your transaction`;
+    case "GenericJs":
+      return `Error in external connector (id ${err.cause.id})`;
+    case "TooManyConnections":
+      return `Too many database connections opened: ${err.cause.cause}`;
+    case "sqlite":
+    case "postgres":
+    case "mysql":
+      return;
+    default: {
+      const cause = err.cause;
+      throw new Error(`Unknown error: ${cause}`);
+    }
+  }
+}
+function renderConstraint(constraint) {
+  if (constraint && "fields" in constraint) {
+    return `fields: (${constraint.fields.map((field) => `\`${field}\``).join(", ")})`;
+  } else if (constraint && "index" in constraint) {
+    return `constraint: \`${constraint.index}\``;
+  } else if (constraint && "foreignKey" in constraint) {
+    return `foreign key`;
+  }
+  return "(not available)";
+}
+
 // src/interpreter/generators.ts
 import cuid1 from "@bugsnag/cuid";
 import { createId as cuid2 } from "@paralleldrive/cuid2";
@@ -244,7 +391,9 @@ var QueryInterpreter = class {
     this.#onQuery = onQuery;
   }
   async run(queryPlan, queryable) {
-    return this.interpretNode(queryPlan, queryable, this.#placeholderValues, this.#generators.snapshot());
+    return this.interpretNode(queryPlan, queryable, this.#placeholderValues, this.#generators.snapshot()).catch(
+      (e) => rethrowAsUserFacing(e)
+    );
   }
   async interpretNode(node, queryable, scope, generators) {
     switch (node.type) {
@@ -632,6 +781,7 @@ export {
   QueryInterpreter,
   TransactionManager,
   TransactionManagerError,
+  UserFacingError,
   isPrismaValueGenerator,
   isPrismaValuePlaceholder
 };

package/package.json

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