@prisma/client-engine-runtime 6.7.0-dev.1 → 6.7.0-dev.10

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

@@ -1,8 +1,15 @@
+import type { Context } from '@opentelemetry/api';
 import type { IsolationLevel } from '@prisma/driver-adapter-utils';
+import type { Span } from '@opentelemetry/api';
+import type { SpanOptions } from '@opentelemetry/api';
 import { SqlDriverAdapter } from '@prisma/driver-adapter-utils';
 import { SqlQueryable } from '@prisma/driver-adapter-utils';
 import { Transaction } from '@prisma/driver-adapter-utils';
 
+declare type ExtendedSpanOptions = SpanOptions & {
+    name: string;
+};
+
 export declare type Fragment = {
     type: 'stringChunk';
     value: string;
@@ -22,6 +29,8 @@ export declare type JoinExpression = {
     parentField: string;
 };
 
+export declare const noopTracingHelper: TracingHelper;
+
 export declare interface PlaceholderFormat {
     prefix: string;
     hasNumbering: boolean;
@@ -54,7 +63,7 @@ export declare type QueryEvent = {
 
 export declare class QueryInterpreter {
     #private;
-    constructor({ transactionManager, placeholderValues, onQuery }: QueryInterpreterOptions);
+    constructor({ transactionManager, placeholderValues, onQuery, tracingHelper }: QueryInterpreterOptions);
     run(queryPlan: QueryPlanNode, queryable: SqlQueryable): Promise<unknown>;
     private interpretNode;
 }
@@ -63,6 +72,7 @@ export declare type QueryInterpreterOptions = {
     transactionManager: QueryInterpreterTransactionManager;
     placeholderValues: Record<string, unknown>;
     onQuery?: (event: QueryEvent) => void;
+    tracingHelper: TracingHelper;
 };
 
 export declare type QueryInterpreterTransactionManager = {
@@ -145,18 +155,27 @@ export declare type QueryPlanNode = {
     args: QueryPlanNode;
 };
 
+declare type SpanCallback<R> = (span?: Span, context?: Context) => R;
+
+export declare interface TracingHelper {
+    runInChildSpan<R>(nameOrOptions: string | ExtendedSpanOptions, callback: SpanCallback<R>): R;
+}
+
 export declare type TransactionInfo = {
     id: string;
 };
 
 export declare class TransactionManager {
+    #private;
     private transactions;
     private closedTransactions;
     private readonly driverAdapter;
     private readonly transactionOptions;
-    constructor({ driverAdapter, transactionOptions }: {
+    private readonly tracingHelper;
+    constructor({ driverAdapter, transactionOptions, tracingHelper, }: {
         driverAdapter: SqlDriverAdapter;
         transactionOptions: TransactionOptions;
+        tracingHelper: TracingHelper;
     });
     startTransaction(options?: TransactionOptions): Promise<TransactionInfo>;
     commitTransaction(transactionId: string): Promise<void>;
@@ -181,4 +200,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

@@ -1,8 +1,15 @@
+import type { Context } from '@opentelemetry/api';
 import type { IsolationLevel } from '@prisma/driver-adapter-utils';
+import type { Span } from '@opentelemetry/api';
+import type { SpanOptions } from '@opentelemetry/api';
 import { SqlDriverAdapter } from '@prisma/driver-adapter-utils';
 import { SqlQueryable } from '@prisma/driver-adapter-utils';
 import { Transaction } from '@prisma/driver-adapter-utils';
 
+declare type ExtendedSpanOptions = SpanOptions & {
+    name: string;
+};
+
 export declare type Fragment = {
     type: 'stringChunk';
     value: string;
@@ -22,6 +29,8 @@ export declare type JoinExpression = {
     parentField: string;
 };
 
+export declare const noopTracingHelper: TracingHelper;
+
 export declare interface PlaceholderFormat {
     prefix: string;
     hasNumbering: boolean;
@@ -54,7 +63,7 @@ export declare type QueryEvent = {
 
 export declare class QueryInterpreter {
     #private;
-    constructor({ transactionManager, placeholderValues, onQuery }: QueryInterpreterOptions);
+    constructor({ transactionManager, placeholderValues, onQuery, tracingHelper }: QueryInterpreterOptions);
     run(queryPlan: QueryPlanNode, queryable: SqlQueryable): Promise<unknown>;
     private interpretNode;
 }
@@ -63,6 +72,7 @@ export declare type QueryInterpreterOptions = {
     transactionManager: QueryInterpreterTransactionManager;
     placeholderValues: Record<string, unknown>;
     onQuery?: (event: QueryEvent) => void;
+    tracingHelper: TracingHelper;
 };
 
 export declare type QueryInterpreterTransactionManager = {
@@ -145,18 +155,27 @@ export declare type QueryPlanNode = {
     args: QueryPlanNode;
 };
 
+declare type SpanCallback<R> = (span?: Span, context?: Context) => R;
+
+export declare interface TracingHelper {
+    runInChildSpan<R>(nameOrOptions: string | ExtendedSpanOptions, callback: SpanCallback<R>): R;
+}
+
 export declare type TransactionInfo = {
     id: string;
 };
 
 export declare class TransactionManager {
+    #private;
     private transactions;
     private closedTransactions;
     private readonly driverAdapter;
     private readonly transactionOptions;
-    constructor({ driverAdapter, transactionOptions }: {
+    private readonly tracingHelper;
+    constructor({ driverAdapter, transactionOptions, tracingHelper, }: {
         driverAdapter: SqlDriverAdapter;
         transactionOptions: TransactionOptions;
+        tracingHelper: TracingHelper;
     });
     startTransaction(options?: TransactionOptions): Promise<TransactionInfo>;
     commitTransaction(transactionId: string): Promise<void>;
@@ -181,4 +200,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,183 @@ __export(index_exports, {
   QueryInterpreter: () => QueryInterpreter,
   TransactionManager: () => TransactionManager,
   TransactionManagerError: () => TransactionManagerError,
+  UserFacingError: () => UserFacingError,
   isPrismaValueGenerator: () => isPrismaValueGenerator,
-  isPrismaValuePlaceholder: () => isPrismaValuePlaceholder
+  isPrismaValuePlaceholder: () => isPrismaValuePlaceholder,
+  noopTracingHelper: () => noopTracingHelper
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/interpreter/QueryInterpreter.ts
+var import_api = require("@opentelemetry/api");
+
+// src/utils.ts
+function assertNever(_, message) {
+  throw new Error(message);
+}
+
+// src/tracing.ts
+var noopTracingHelper = {
+  runInChildSpan(_, callback) {
+    return callback();
+  }
+};
+function providerToOtelSystem(provider) {
+  switch (provider) {
+    case "postgres":
+      return "postgresql";
+    case "mysql":
+      return "mysql";
+    case "sqlite":
+      return "sqlite";
+    default:
+      assertNever(provider, `Unknown provider: ${provider}`);
+  }
+}
+
+// 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:
+      assertNever(err.cause, `Unknown error: ${err.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:
+      assertNever(err.cause, `Unknown error: ${err.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");
@@ -123,11 +295,6 @@ function isPrismaValueGenerator(value) {
   return typeof value === "object" && value !== null && value["prisma__type"] === "generatorCall";
 }
 
-// src/utils.ts
-function assertNever(_, message) {
-  throw new Error(message);
-}
-
 // src/interpreter/renderQuery.ts
 function renderQuery(dbQuery, scope, generators) {
   const queryType = dbQuery.type;
@@ -278,13 +445,17 @@ var QueryInterpreter = class {
   #placeholderValues;
   #onQuery;
   #generators = new GeneratorRegistry();
-  constructor({ transactionManager, placeholderValues, onQuery }) {
+  #tracingHelper;
+  constructor({ transactionManager, placeholderValues, onQuery, tracingHelper }) {
     this.#transactionManager = transactionManager;
     this.#placeholderValues = placeholderValues;
     this.#onQuery = onQuery;
+    this.#tracingHelper = tracingHelper;
   }
   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) {
@@ -323,13 +494,13 @@ var QueryInterpreter = class {
       }
       case "execute": {
         const query = renderQuery(node.args, scope, generators);
-        return this.#withQueryEvent(query, async () => {
+        return this.#withQueryEvent(query, queryable, async () => {
           return await queryable.executeRaw(query);
         });
       }
       case "query": {
         const query = renderQuery(node.args, scope, generators);
-        return this.#withQueryEvent(query, async () => {
+        return this.#withQueryEvent(query, queryable, async () => {
           return serialize(await queryable.queryRaw(query));
         });
       }
@@ -390,24 +561,34 @@ var QueryInterpreter = class {
           throw e;
         }
       }
-      default: {
-        node;
-        throw new Error(`Unexpected node type: ${node.type}`);
-      }
+      default:
+        assertNever(node, `Unexpected node type: ${node.type}`);
     }
   }
-  async #withQueryEvent(query, execute) {
-    const timestamp = /* @__PURE__ */ new Date();
-    const startInstant = performance.now();
-    const result = await execute();
-    const endInstant = performance.now();
-    this.#onQuery?.({
-      timestamp,
-      duration: endInstant - startInstant,
-      query: query.sql,
-      params: query.args
-    });
-    return result;
+  #withQueryEvent(query, queryable, execute) {
+    return this.#tracingHelper.runInChildSpan(
+      {
+        name: "db_query",
+        kind: import_api.SpanKind.CLIENT,
+        attributes: {
+          "db.query.text": query.sql,
+          "db.system.name": providerToOtelSystem(queryable.provider)
+        }
+      },
+      async () => {
+        const timestamp = /* @__PURE__ */ new Date();
+        const startInstant = performance.now();
+        const result = await execute();
+        const endInstant = performance.now();
+        this.#onQuery?.({
+          timestamp,
+          duration: endInstant - startInstant,
+          query: query.sql,
+          params: query.args
+        });
+        return result;
+      }
+    );
   }
 };
 function isEmpty(value) {
@@ -486,11 +667,6 @@ var TransactionManagerError = class extends Error {
   }
   code = "P2028";
 };
-var TransactionDriverAdapterError = class extends TransactionManagerError {
-  constructor(message, errorParams) {
-    super(`Error from Driver Adapter: ${message}`, { ...errorParams.driverAdapterError });
-  }
-};
 var TransactionNotFoundError = class extends TransactionManagerError {
   constructor() {
     super(
@@ -508,7 +684,7 @@ var TransactionRolledBackError = class extends TransactionManagerError {
     super(`Transaction already closed: A ${operation} cannot be executed on a committed transaction`);
   }
 };
-var TransactionStartTimoutError = class extends TransactionManagerError {
+var TransactionStartTimeoutError = class extends TransactionManagerError {
   constructor() {
     super("Unable to start a transaction in the given time.");
   }
@@ -545,11 +721,20 @@ var TransactionManager = class {
   closedTransactions = [];
   driverAdapter;
   transactionOptions;
-  constructor({ driverAdapter, transactionOptions }) {
+  tracingHelper;
+  constructor({
+    driverAdapter,
+    transactionOptions,
+    tracingHelper
+  }) {
     this.driverAdapter = driverAdapter;
     this.transactionOptions = transactionOptions;
+    this.tracingHelper = tracingHelper;
   }
   async startTransaction(options) {
+    return await this.tracingHelper.runInChildSpan("start_transaction", () => this.#startTransactionImpl(options));
+  }
+  async #startTransactionImpl(options) {
     const validatedOptions = options !== void 0 ? this.validateOptions(options) : this.transactionOptions;
     const transaction = {
       id: await randomUUID(),
@@ -561,14 +746,7 @@ var TransactionManager = class {
     };
     this.transactions.set(transaction.id, transaction);
     transaction.timer = this.startTransactionTimeout(transaction.id, validatedOptions.maxWait);
-    let startedTransaction;
-    try {
-      startedTransaction = await this.driverAdapter.startTransaction(validatedOptions.isolationLevel);
-    } catch (error) {
-      throw new TransactionDriverAdapterError("Failed to start transaction.", {
-        driverAdapterError: error
-      });
-    }
+    const startedTransaction = await this.driverAdapter.startTransaction(validatedOptions.isolationLevel);
     switch (transaction.status) {
       case "waiting":
         transaction.transaction = startedTransaction;
@@ -578,7 +756,7 @@ var TransactionManager = class {
         transaction.timer = this.startTransactionTimeout(transaction.id, validatedOptions.timeout);
         return { id: transaction.id };
       case "timed_out":
-        throw new TransactionStartTimoutError();
+        throw new TransactionStartTimeoutError();
       case "running":
       case "committed":
       case "rolled_back":
@@ -590,12 +768,16 @@ var TransactionManager = class {
     }
   }
   async commitTransaction(transactionId) {
-    const txw = this.getActiveTransaction(transactionId, "commit");
-    await this.closeTransaction(txw, "committed");
+    return await this.tracingHelper.runInChildSpan("commit_transaction", async () => {
+      const txw = this.getActiveTransaction(transactionId, "commit");
+      await this.closeTransaction(txw, "committed");
+    });
   }
   async rollbackTransaction(transactionId) {
-    const txw = this.getActiveTransaction(transactionId, "rollback");
-    await this.closeTransaction(txw, "rolled_back");
+    return await this.tracingHelper.runInChildSpan("rollback_transaction", async () => {
+      const txw = this.getActiveTransaction(transactionId, "rollback");
+      await this.closeTransaction(txw, "rolled_back");
+    });
   }
   getTransaction(txInfo, operation) {
     const tx = this.getActiveTransaction(txInfo.id, operation);
@@ -651,24 +833,12 @@ var TransactionManager = class {
     debug("Closing transaction.", { transactionId: tx.id, status });
     tx.status = status;
     if (tx.transaction && status === "committed") {
-      try {
-        await tx.transaction.commit();
-      } catch (error) {
-        throw new TransactionDriverAdapterError("Failed to commit transaction.", {
-          driverAdapterError: error
-        });
-      }
+      await tx.transaction.commit();
       if (!tx.transaction.options.usePhantomQuery) {
         await tx.transaction.executeRaw(COMMIT_QUERY());
       }
     } else if (tx.transaction) {
-      try {
-        await tx.transaction.rollback();
-      } catch (error) {
-        throw new TransactionDriverAdapterError("Failed to rollback transaction.", {
-          driverAdapterError: error
-        });
-      }
+      await tx.transaction.rollback();
       if (!tx.transaction.options.usePhantomQuery) {
         await tx.transaction.executeRaw(ROLLBACK_QUERY());
       }
@@ -697,6 +867,8 @@ var TransactionManager = class {
   QueryInterpreter,
   TransactionManager,
   TransactionManagerError,
+  UserFacingError,
   isPrismaValueGenerator,
-  isPrismaValuePlaceholder
+  isPrismaValuePlaceholder,
+  noopTracingHelper
 });

package/dist/index.mjs

@@ -1,3 +1,173 @@
+// src/interpreter/QueryInterpreter.ts
+import { SpanKind } from "@opentelemetry/api";
+
+// src/utils.ts
+function assertNever(_, message) {
+  throw new Error(message);
+}
+
+// src/tracing.ts
+var noopTracingHelper = {
+  runInChildSpan(_, callback) {
+    return callback();
+  }
+};
+function providerToOtelSystem(provider) {
+  switch (provider) {
+    case "postgres":
+      return "postgresql";
+    case "mysql":
+      return "mysql";
+    case "sqlite":
+      return "sqlite";
+    default:
+      assertNever(provider, `Unknown provider: ${provider}`);
+  }
+}
+
+// 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:
+      assertNever(err.cause, `Unknown error: ${err.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:
+      assertNever(err.cause, `Unknown error: ${err.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";
@@ -83,11 +253,6 @@ function isPrismaValueGenerator(value) {
   return typeof value === "object" && value !== null && value["prisma__type"] === "generatorCall";
 }
 
-// src/utils.ts
-function assertNever(_, message) {
-  throw new Error(message);
-}
-
 // src/interpreter/renderQuery.ts
 function renderQuery(dbQuery, scope, generators) {
   const queryType = dbQuery.type;
@@ -238,13 +403,17 @@ var QueryInterpreter = class {
   #placeholderValues;
   #onQuery;
   #generators = new GeneratorRegistry();
-  constructor({ transactionManager, placeholderValues, onQuery }) {
+  #tracingHelper;
+  constructor({ transactionManager, placeholderValues, onQuery, tracingHelper }) {
     this.#transactionManager = transactionManager;
     this.#placeholderValues = placeholderValues;
     this.#onQuery = onQuery;
+    this.#tracingHelper = tracingHelper;
   }
   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) {
@@ -283,13 +452,13 @@ var QueryInterpreter = class {
       }
       case "execute": {
         const query = renderQuery(node.args, scope, generators);
-        return this.#withQueryEvent(query, async () => {
+        return this.#withQueryEvent(query, queryable, async () => {
           return await queryable.executeRaw(query);
         });
       }
       case "query": {
         const query = renderQuery(node.args, scope, generators);
-        return this.#withQueryEvent(query, async () => {
+        return this.#withQueryEvent(query, queryable, async () => {
           return serialize(await queryable.queryRaw(query));
         });
       }
@@ -350,24 +519,34 @@ var QueryInterpreter = class {
           throw e;
         }
       }
-      default: {
-        node;
-        throw new Error(`Unexpected node type: ${node.type}`);
-      }
+      default:
+        assertNever(node, `Unexpected node type: ${node.type}`);
     }
   }
-  async #withQueryEvent(query, execute) {
-    const timestamp = /* @__PURE__ */ new Date();
-    const startInstant = performance.now();
-    const result = await execute();
-    const endInstant = performance.now();
-    this.#onQuery?.({
-      timestamp,
-      duration: endInstant - startInstant,
-      query: query.sql,
-      params: query.args
-    });
-    return result;
+  #withQueryEvent(query, queryable, execute) {
+    return this.#tracingHelper.runInChildSpan(
+      {
+        name: "db_query",
+        kind: SpanKind.CLIENT,
+        attributes: {
+          "db.query.text": query.sql,
+          "db.system.name": providerToOtelSystem(queryable.provider)
+        }
+      },
+      async () => {
+        const timestamp = /* @__PURE__ */ new Date();
+        const startInstant = performance.now();
+        const result = await execute();
+        const endInstant = performance.now();
+        this.#onQuery?.({
+          timestamp,
+          duration: endInstant - startInstant,
+          query: query.sql,
+          params: query.args
+        });
+        return result;
+      }
+    );
   }
 };
 function isEmpty(value) {
@@ -446,11 +625,6 @@ var TransactionManagerError = class extends Error {
   }
   code = "P2028";
 };
-var TransactionDriverAdapterError = class extends TransactionManagerError {
-  constructor(message, errorParams) {
-    super(`Error from Driver Adapter: ${message}`, { ...errorParams.driverAdapterError });
-  }
-};
 var TransactionNotFoundError = class extends TransactionManagerError {
   constructor() {
     super(
@@ -468,7 +642,7 @@ var TransactionRolledBackError = class extends TransactionManagerError {
     super(`Transaction already closed: A ${operation} cannot be executed on a committed transaction`);
   }
 };
-var TransactionStartTimoutError = class extends TransactionManagerError {
+var TransactionStartTimeoutError = class extends TransactionManagerError {
   constructor() {
     super("Unable to start a transaction in the given time.");
   }
@@ -505,11 +679,20 @@ var TransactionManager = class {
   closedTransactions = [];
   driverAdapter;
   transactionOptions;
-  constructor({ driverAdapter, transactionOptions }) {
+  tracingHelper;
+  constructor({
+    driverAdapter,
+    transactionOptions,
+    tracingHelper
+  }) {
     this.driverAdapter = driverAdapter;
     this.transactionOptions = transactionOptions;
+    this.tracingHelper = tracingHelper;
   }
   async startTransaction(options) {
+    return await this.tracingHelper.runInChildSpan("start_transaction", () => this.#startTransactionImpl(options));
+  }
+  async #startTransactionImpl(options) {
     const validatedOptions = options !== void 0 ? this.validateOptions(options) : this.transactionOptions;
     const transaction = {
       id: await randomUUID(),
@@ -521,14 +704,7 @@ var TransactionManager = class {
     };
     this.transactions.set(transaction.id, transaction);
     transaction.timer = this.startTransactionTimeout(transaction.id, validatedOptions.maxWait);
-    let startedTransaction;
-    try {
-      startedTransaction = await this.driverAdapter.startTransaction(validatedOptions.isolationLevel);
-    } catch (error) {
-      throw new TransactionDriverAdapterError("Failed to start transaction.", {
-        driverAdapterError: error
-      });
-    }
+    const startedTransaction = await this.driverAdapter.startTransaction(validatedOptions.isolationLevel);
     switch (transaction.status) {
       case "waiting":
         transaction.transaction = startedTransaction;
@@ -538,7 +714,7 @@ var TransactionManager = class {
         transaction.timer = this.startTransactionTimeout(transaction.id, validatedOptions.timeout);
         return { id: transaction.id };
       case "timed_out":
-        throw new TransactionStartTimoutError();
+        throw new TransactionStartTimeoutError();
       case "running":
       case "committed":
       case "rolled_back":
@@ -550,12 +726,16 @@ var TransactionManager = class {
     }
   }
   async commitTransaction(transactionId) {
-    const txw = this.getActiveTransaction(transactionId, "commit");
-    await this.closeTransaction(txw, "committed");
+    return await this.tracingHelper.runInChildSpan("commit_transaction", async () => {
+      const txw = this.getActiveTransaction(transactionId, "commit");
+      await this.closeTransaction(txw, "committed");
+    });
   }
   async rollbackTransaction(transactionId) {
-    const txw = this.getActiveTransaction(transactionId, "rollback");
-    await this.closeTransaction(txw, "rolled_back");
+    return await this.tracingHelper.runInChildSpan("rollback_transaction", async () => {
+      const txw = this.getActiveTransaction(transactionId, "rollback");
+      await this.closeTransaction(txw, "rolled_back");
+    });
   }
   getTransaction(txInfo, operation) {
     const tx = this.getActiveTransaction(txInfo.id, operation);
@@ -611,24 +791,12 @@ var TransactionManager = class {
     debug("Closing transaction.", { transactionId: tx.id, status });
     tx.status = status;
     if (tx.transaction && status === "committed") {
-      try {
-        await tx.transaction.commit();
-      } catch (error) {
-        throw new TransactionDriverAdapterError("Failed to commit transaction.", {
-          driverAdapterError: error
-        });
-      }
+      await tx.transaction.commit();
       if (!tx.transaction.options.usePhantomQuery) {
         await tx.transaction.executeRaw(COMMIT_QUERY());
       }
     } else if (tx.transaction) {
-      try {
-        await tx.transaction.rollback();
-      } catch (error) {
-        throw new TransactionDriverAdapterError("Failed to rollback transaction.", {
-          driverAdapterError: error
-        });
-      }
+      await tx.transaction.rollback();
       if (!tx.transaction.options.usePhantomQuery) {
         await tx.transaction.executeRaw(ROLLBACK_QUERY());
       }
@@ -656,6 +824,8 @@ export {
   QueryInterpreter,
   TransactionManager,
   TransactionManagerError,
+  UserFacingError,
   isPrismaValueGenerator,
-  isPrismaValuePlaceholder
+  isPrismaValuePlaceholder,
+  noopTracingHelper
 };

package/dist/interpreter/QueryInterpreter.d.ts

@@ -1,6 +1,7 @@
 import { SqlQueryable } from '@prisma/driver-adapter-utils';
 import { QueryEvent } from '../events';
 import { QueryPlanNode } from '../QueryPlan';
+import { type TracingHelper } from '../tracing';
 import { type TransactionManager } from '../transactionManager/TransactionManager';
 export type QueryInterpreterTransactionManager = {
     enabled: true;
@@ -12,10 +13,11 @@ export type QueryInterpreterOptions = {
     transactionManager: QueryInterpreterTransactionManager;
     placeholderValues: Record<string, unknown>;
     onQuery?: (event: QueryEvent) => void;
+    tracingHelper: TracingHelper;
 };
 export declare class QueryInterpreter {
     #private;
-    constructor({ transactionManager, placeholderValues, onQuery }: QueryInterpreterOptions);
+    constructor({ transactionManager, placeholderValues, onQuery, tracingHelper }: QueryInterpreterOptions);
     run(queryPlan: QueryPlanNode, queryable: SqlQueryable): Promise<unknown>;
     private interpretNode;
 }

package/dist/tracing.d.ts

@@ -0,0 +1,11 @@
+import type { Context, Span, SpanOptions } from '@opentelemetry/api';
+import type { Provider } from '@prisma/driver-adapter-utils';
+export type SpanCallback<R> = (span?: Span, context?: Context) => R;
+export type ExtendedSpanOptions = SpanOptions & {
+    name: string;
+};
+export interface TracingHelper {
+    runInChildSpan<R>(nameOrOptions: string | ExtendedSpanOptions, callback: SpanCallback<R>): R;
+}
+export declare const noopTracingHelper: TracingHelper;
+export declare function providerToOtelSystem(provider: Provider): string;

package/dist/transactionManager/TransactionManager.d.ts

@@ -1,13 +1,17 @@
 import { SqlDriverAdapter, Transaction } from '@prisma/driver-adapter-utils';
+import { TracingHelper } from '../tracing';
 import { Options, TransactionInfo } from './Transaction';
 export declare class TransactionManager {
+    #private;
     private transactions;
     private closedTransactions;
     private readonly driverAdapter;
     private readonly transactionOptions;
-    constructor({ driverAdapter, transactionOptions }: {
+    private readonly tracingHelper;
+    constructor({ driverAdapter, transactionOptions, tracingHelper, }: {
         driverAdapter: SqlDriverAdapter;
         transactionOptions: Options;
+        tracingHelper: TracingHelper;
     });
     startTransaction(options?: Options): Promise<TransactionInfo>;
     commitTransaction(transactionId: string): Promise<void>;

package/dist/transactionManager/TransactionManagerErrors.d.ts

@@ -1,14 +1,8 @@
-import { Error as DriverAdapterError } from '@prisma/driver-adapter-utils';
 export declare class TransactionManagerError extends Error {
     meta?: Record<string, unknown> | undefined;
     code: string;
     constructor(message: string, meta?: Record<string, unknown> | undefined);
 }
-export declare class TransactionDriverAdapterError extends TransactionManagerError {
-    constructor(message: string, errorParams: {
-        driverAdapterError: DriverAdapterError;
-    });
-}
 export declare class TransactionNotFoundError extends TransactionManagerError {
     constructor();
 }
@@ -18,7 +12,7 @@ export declare class TransactionClosedError extends TransactionManagerError {
 export declare class TransactionRolledBackError extends TransactionManagerError {
     constructor(operation: string);
 }
-export declare class TransactionStartTimoutError extends TransactionManagerError {
+export declare class TransactionStartTimeoutError extends TransactionManagerError {
     constructor();
 }
 export declare class TransactionExecutionTimeoutError extends TransactionManagerError {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/client-engine-runtime",
-  "version": "6.7.0-dev.1",
+  "version": "6.7.0-dev.10",
   "description": "This package is intended for Prisma's internal use",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -25,12 +25,13 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@bugsnag/cuid": "3.2.1",
+    "@opentelemetry/api": "1.9.0",
     "@paralleldrive/cuid2": "2.2.2",
     "nanoid": "5.1.5",
     "ulid": "3.0.0",
     "uuid": "11.1.0",
-    "@prisma/debug": "6.7.0-dev.1",
-    "@prisma/driver-adapter-utils": "6.7.0-dev.1"
+    "@prisma/debug": "6.7.0-dev.10",
+    "@prisma/driver-adapter-utils": "6.7.0-dev.10"
   },
   "devDependencies": {
     "@types/jest": "29.5.14",