@prisma/driver-adapter-utils 6.6.0-dev.7 → 6.6.0-dev.71

package/dist/index.d.mts

@@ -16,7 +16,9 @@ declare interface AdapterInfo {
  */
 export declare type ArgType = 'Int32' | 'Int64' | 'Float' | 'Double' | 'Text' | 'Enum' | 'EnumArray' | 'Bytes' | 'Boolean' | 'Char' | 'Array' | 'Numeric' | 'Json' | 'Xml' | 'Uuid' | 'DateTime' | 'Date' | 'Time';
 
-export declare const bindAdapter: (adapter: SqlConnection) => ErrorCapturingSqlConnection;
+export declare const bindAdapter: (adapter: SqlDriverAdapter, errorRegistry?: ErrorRegistryInternal) => ErrorCapturingSqlDriverAdapter;
+
+export declare const bindSqlAdapterFactory: (adapterFactory: SqlDriverAdapterFactory) => ErrorCapturingSqlDriverAdapterFactory;
 
 export declare type ColumnType = (typeof ColumnTypeEnum)[keyof typeof ColumnTypeEnum];
 
@@ -62,23 +64,23 @@ export declare type ConnectionInfo = {
 
 export { Debug }
 
+export declare class DriverAdapterError extends Error {
+    name: string;
+    cause: Error_2;
+    constructor(payload: Error_2);
+}
+
 /**
- * A generic driver adapter that allows the user to connect to a
- * database. The query and result types are specific to the adapter.
+ * A generic driver adapter factory that allows the user to instantiate a
+ * driver adapter. The query and result types are specific to the adapter.
  */
-declare interface DriverAdapter_2<Query, Result> extends AdapterInfo {
+export declare interface DriverAdapterFactory<Query, Result> extends AdapterInfo {
     /**
-     * Connect to the database.
+     * Instantiate a driver adapter.
      */
     connect(): Promise<Queryable<Query, Result>>;
 }
 
-export declare class DriverAdapterError extends Error {
-    name: string;
-    cause: Error_2;
-    constructor(payload: Error_2);
-}
-
 export declare function err<T>(error: Error_2): Result<T>;
 
 declare type Error_2 = {
@@ -87,6 +89,9 @@ declare type Error_2 = {
 } | {
     kind: 'UnsupportedNativeDataType';
     type: string;
+} | {
+    kind: 'InvalidIsolationLevel';
+    level: string;
 } | {
     kind: 'postgres';
     code: string;
@@ -116,18 +121,18 @@ declare type ErrorCapturingInterface<T> = {
     [K in keyof T]: ErrorCapturingFunction<T[K]>;
 };
 
-declare interface ErrorCapturingSqlConnection extends ErrorCapturingInterface<SqlConnection> {
+export declare interface ErrorCapturingSqlDriverAdapter extends ErrorCapturingInterface<SqlDriverAdapter> {
+    readonly errorRegistry: ErrorRegistry;
+}
+
+export declare interface ErrorCapturingSqlDriverAdapterFactory extends ErrorCapturingInterface<SqlDriverAdapterFactory> {
     readonly errorRegistry: ErrorRegistry;
 }
-export { ErrorCapturingSqlConnection as ErrorCapturingDriverAdapter }
-export { ErrorCapturingSqlConnection }
 
 export declare type ErrorCapturingSqlQueryable = ErrorCapturingInterface<SqlQueryable>;
 
 export declare type ErrorCapturingTransaction = ErrorCapturingInterface<Transaction>;
 
-export declare type ErrorCapturingTransactionContext = ErrorCapturingInterface<TransactionContext>;
-
 export declare type ErrorRecord = {
     error: unknown;
 };
@@ -136,13 +141,21 @@ export declare interface ErrorRegistry {
     consumeError(id: number): ErrorRecord | undefined;
 }
 
+declare class ErrorRegistryInternal implements ErrorRegistry {
+    private registeredErrors;
+    consumeError(id: number): ErrorRecord | undefined;
+    registerNewError(error: unknown): number;
+}
+
+export declare type IsolationLevel = 'READ UNCOMMITTED' | 'READ COMMITTED' | 'REPEATABLE READ' | 'SNAPSHOT' | 'SERIALIZABLE';
+
 declare const officialPrismaAdapters: readonly ["@prisma/adapter-planetscale", "@prisma/adapter-neon", "@prisma/adapter-libsql", "@prisma/adapter-d1", "@prisma/adapter-pg", "@prisma/adapter-pg-worker"];
 
 export declare function ok<T>(value: T): Result<T>;
 
 export declare type Provider = 'mysql' | 'postgres' | 'sqlite';
 
-declare interface Queryable<Query, Result> extends AdapterInfo {
+export declare interface Queryable<Query, Result> extends AdapterInfo {
     /**
      * Execute a query and return its result.
      */
@@ -164,7 +177,7 @@ export declare type Result<T> = {
     readonly error: Error_2;
 });
 
-declare interface SqlConnection extends SqlQueryable {
+export declare interface SqlDriverAdapter extends SqlQueryable {
     /**
      * Execute multiple SQL statements separated by semicolon.
      */
@@ -172,7 +185,7 @@ declare interface SqlConnection extends SqlQueryable {
     /**
      * Start new transaction.
      */
-    transactionContext(): Promise<TransactionContext>;
+    startTransaction(isolationLevel?: IsolationLevel): Promise<Transaction>;
     /**
      * Optional method that returns extra connection info
      */
@@ -182,19 +195,17 @@ declare interface SqlConnection extends SqlQueryable {
      */
     dispose(): Promise<void>;
 }
-export { SqlConnection as DriverAdapter }
-export { SqlConnection }
 
-declare interface SqlDriverAdapter extends DriverAdapter_2<SqlQuery, SqlResultSet> {
-    connect(): Promise<SqlConnection>;
+export declare interface SqlDriverAdapterFactory extends DriverAdapterFactory<SqlQuery, SqlResultSet> {
+    connect(): Promise<SqlDriverAdapter>;
 }
 
 /**
  * An SQL migration adapter that is aware of the notion of a shadow database
  * and can create a connection to it.
  */
-export declare interface SqlMigrationAwareDriverAdapter extends SqlDriverAdapter {
-    connectToShadowDb(): Promise<SqlConnection>;
+export declare interface SqlMigrationAwareDriverAdapterFactory extends SqlDriverAdapterFactory {
+    connectToShadowDb(): Promise<SqlDriverAdapter>;
 }
 
 export declare type SqlQuery = {
@@ -243,13 +254,6 @@ export declare interface Transaction extends AdapterInfo, SqlQueryable {
     rollback(): Promise<void>;
 }
 
-export declare interface TransactionContext extends AdapterInfo, SqlQueryable {
-    /**
-     * Start new transaction.
-     */
-    startTransaction(): Promise<Transaction>;
-}
-
 export declare type TransactionOptions = {
     usePhantomQuery: boolean;
 };

package/dist/index.d.ts

@@ -16,7 +16,9 @@ declare interface AdapterInfo {
  */
 export declare type ArgType = 'Int32' | 'Int64' | 'Float' | 'Double' | 'Text' | 'Enum' | 'EnumArray' | 'Bytes' | 'Boolean' | 'Char' | 'Array' | 'Numeric' | 'Json' | 'Xml' | 'Uuid' | 'DateTime' | 'Date' | 'Time';
 
-export declare const bindAdapter: (adapter: SqlConnection) => ErrorCapturingSqlConnection;
+export declare const bindAdapter: (adapter: SqlDriverAdapter, errorRegistry?: ErrorRegistryInternal) => ErrorCapturingSqlDriverAdapter;
+
+export declare const bindSqlAdapterFactory: (adapterFactory: SqlDriverAdapterFactory) => ErrorCapturingSqlDriverAdapterFactory;
 
 export declare type ColumnType = (typeof ColumnTypeEnum)[keyof typeof ColumnTypeEnum];
 
@@ -62,23 +64,23 @@ export declare type ConnectionInfo = {
 
 export { Debug }
 
+export declare class DriverAdapterError extends Error {
+    name: string;
+    cause: Error_2;
+    constructor(payload: Error_2);
+}
+
 /**
- * A generic driver adapter that allows the user to connect to a
- * database. The query and result types are specific to the adapter.
+ * A generic driver adapter factory that allows the user to instantiate a
+ * driver adapter. The query and result types are specific to the adapter.
  */
-declare interface DriverAdapter_2<Query, Result> extends AdapterInfo {
+export declare interface DriverAdapterFactory<Query, Result> extends AdapterInfo {
     /**
-     * Connect to the database.
+     * Instantiate a driver adapter.
      */
     connect(): Promise<Queryable<Query, Result>>;
 }
 
-export declare class DriverAdapterError extends Error {
-    name: string;
-    cause: Error_2;
-    constructor(payload: Error_2);
-}
-
 export declare function err<T>(error: Error_2): Result<T>;
 
 declare type Error_2 = {
@@ -87,6 +89,9 @@ declare type Error_2 = {
 } | {
     kind: 'UnsupportedNativeDataType';
     type: string;
+} | {
+    kind: 'InvalidIsolationLevel';
+    level: string;
 } | {
     kind: 'postgres';
     code: string;
@@ -116,18 +121,18 @@ declare type ErrorCapturingInterface<T> = {
     [K in keyof T]: ErrorCapturingFunction<T[K]>;
 };
 
-declare interface ErrorCapturingSqlConnection extends ErrorCapturingInterface<SqlConnection> {
+export declare interface ErrorCapturingSqlDriverAdapter extends ErrorCapturingInterface<SqlDriverAdapter> {
+    readonly errorRegistry: ErrorRegistry;
+}
+
+export declare interface ErrorCapturingSqlDriverAdapterFactory extends ErrorCapturingInterface<SqlDriverAdapterFactory> {
     readonly errorRegistry: ErrorRegistry;
 }
-export { ErrorCapturingSqlConnection as ErrorCapturingDriverAdapter }
-export { ErrorCapturingSqlConnection }
 
 export declare type ErrorCapturingSqlQueryable = ErrorCapturingInterface<SqlQueryable>;
 
 export declare type ErrorCapturingTransaction = ErrorCapturingInterface<Transaction>;
 
-export declare type ErrorCapturingTransactionContext = ErrorCapturingInterface<TransactionContext>;
-
 export declare type ErrorRecord = {
     error: unknown;
 };
@@ -136,13 +141,21 @@ export declare interface ErrorRegistry {
     consumeError(id: number): ErrorRecord | undefined;
 }
 
+declare class ErrorRegistryInternal implements ErrorRegistry {
+    private registeredErrors;
+    consumeError(id: number): ErrorRecord | undefined;
+    registerNewError(error: unknown): number;
+}
+
+export declare type IsolationLevel = 'READ UNCOMMITTED' | 'READ COMMITTED' | 'REPEATABLE READ' | 'SNAPSHOT' | 'SERIALIZABLE';
+
 declare const officialPrismaAdapters: readonly ["@prisma/adapter-planetscale", "@prisma/adapter-neon", "@prisma/adapter-libsql", "@prisma/adapter-d1", "@prisma/adapter-pg", "@prisma/adapter-pg-worker"];
 
 export declare function ok<T>(value: T): Result<T>;
 
 export declare type Provider = 'mysql' | 'postgres' | 'sqlite';
 
-declare interface Queryable<Query, Result> extends AdapterInfo {
+export declare interface Queryable<Query, Result> extends AdapterInfo {
     /**
      * Execute a query and return its result.
      */
@@ -164,7 +177,7 @@ export declare type Result<T> = {
     readonly error: Error_2;
 });
 
-declare interface SqlConnection extends SqlQueryable {
+export declare interface SqlDriverAdapter extends SqlQueryable {
     /**
      * Execute multiple SQL statements separated by semicolon.
      */
@@ -172,7 +185,7 @@ declare interface SqlConnection extends SqlQueryable {
     /**
      * Start new transaction.
      */
-    transactionContext(): Promise<TransactionContext>;
+    startTransaction(isolationLevel?: IsolationLevel): Promise<Transaction>;
     /**
      * Optional method that returns extra connection info
      */
@@ -182,19 +195,17 @@ declare interface SqlConnection extends SqlQueryable {
      */
     dispose(): Promise<void>;
 }
-export { SqlConnection as DriverAdapter }
-export { SqlConnection }
 
-declare interface SqlDriverAdapter extends DriverAdapter_2<SqlQuery, SqlResultSet> {
-    connect(): Promise<SqlConnection>;
+export declare interface SqlDriverAdapterFactory extends DriverAdapterFactory<SqlQuery, SqlResultSet> {
+    connect(): Promise<SqlDriverAdapter>;
 }
 
 /**
  * An SQL migration adapter that is aware of the notion of a shadow database
  * and can create a connection to it.
  */
-export declare interface SqlMigrationAwareDriverAdapter extends SqlDriverAdapter {
-    connectToShadowDb(): Promise<SqlConnection>;
+export declare interface SqlMigrationAwareDriverAdapterFactory extends SqlDriverAdapterFactory {
+    connectToShadowDb(): Promise<SqlDriverAdapter>;
 }
 
 export declare type SqlQuery = {
@@ -243,13 +254,6 @@ export declare interface Transaction extends AdapterInfo, SqlQueryable {
     rollback(): Promise<void>;
 }
 
-export declare interface TransactionContext extends AdapterInfo, SqlQueryable {
-    /**
-     * Start new transaction.
-     */
-    startTransaction(): Promise<Transaction>;
-}
-
 export declare type TransactionOptions = {
     usePhantomQuery: boolean;
 };

package/dist/index.js

@@ -3,7 +3,6 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -17,7 +16,6 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/index.ts
 var index_exports = {};
@@ -26,6 +24,7 @@ __export(index_exports, {
   Debug: () => import_debug.Debug,
   DriverAdapterError: () => DriverAdapterError,
   bindAdapter: () => bindAdapter,
+  bindSqlAdapterFactory: () => bindSqlAdapterFactory,
   err: () => err,
   ok: () => ok
 });
@@ -33,10 +32,10 @@ module.exports = __toCommonJS(index_exports);
 
 // src/error.ts
 var DriverAdapterError = class extends Error {
+  name = "DriverAdapterError";
+  cause;
   constructor(payload) {
     super(typeof payload["message"] === "string" ? payload["message"] : payload.kind);
-    __publicField(this, "name", "DriverAdapterError");
-    __publicField(this, "cause");
     this.cause = payload;
   }
 };
@@ -72,9 +71,7 @@ function err(error) {
 
 // src/binder.ts
 var ErrorRegistryInternal = class {
-  constructor() {
-    __publicField(this, "registeredErrors", []);
-  }
+  registeredErrors = [];
   consumeError(id) {
     return this.registeredErrors[id];
   }
@@ -87,9 +84,20 @@ var ErrorRegistryInternal = class {
     return i;
   }
 };
-var bindAdapter = (adapter) => {
+var bindSqlAdapterFactory = (adapterFactory) => {
   const errorRegistry = new ErrorRegistryInternal();
-  const createTransactionContext = wrapAsync(errorRegistry, adapter.transactionContext.bind(adapter));
+  const boundFactory = {
+    adapterName: adapterFactory.adapterName,
+    provider: adapterFactory.provider,
+    errorRegistry,
+    connect: async (...args) => {
+      const ctx = await wrapAsync(errorRegistry, adapterFactory.connect.bind(adapterFactory))(...args);
+      return ctx.map((ctx2) => bindAdapter(ctx2, errorRegistry));
+    }
+  };
+  return boundFactory;
+};
+var bindAdapter = (adapter, errorRegistry = new ErrorRegistryInternal()) => {
   const boundAdapter = {
     adapterName: adapter.adapterName,
     errorRegistry,
@@ -98,9 +106,9 @@ var bindAdapter = (adapter) => {
     executeScript: wrapAsync(errorRegistry, adapter.executeScript.bind(adapter)),
     dispose: wrapAsync(errorRegistry, adapter.dispose.bind(adapter)),
     provider: adapter.provider,
-    transactionContext: async (...args) => {
-      const ctx = await createTransactionContext(...args);
-      return ctx.map((ctx2) => bindTransactionContext(errorRegistry, ctx2));
+    startTransaction: async (...args) => {
+      const ctx = await wrapAsync(errorRegistry, adapter.startTransaction.bind(adapter))(...args);
+      return ctx.map((ctx2) => bindTransaction(errorRegistry, ctx2));
     }
   };
   if (adapter.getConnectionInfo) {
@@ -108,19 +116,6 @@ var bindAdapter = (adapter) => {
   }
   return boundAdapter;
 };
-var bindTransactionContext = (errorRegistry, ctx) => {
-  const startTransaction = wrapAsync(errorRegistry, ctx.startTransaction.bind(ctx));
-  return {
-    adapterName: ctx.adapterName,
-    provider: ctx.provider,
-    queryRaw: wrapAsync(errorRegistry, ctx.queryRaw.bind(ctx)),
-    executeRaw: wrapAsync(errorRegistry, ctx.executeRaw.bind(ctx)),
-    startTransaction: async (...args) => {
-      const result = await startTransaction(...args);
-      return result.map((tx) => bindTransaction(errorRegistry, tx));
-    }
-  };
-};
 var bindTransaction = (errorRegistry, transaction) => {
   return {
     adapterName: transaction.adapterName,
@@ -206,6 +201,7 @@ var import_debug = require("@prisma/debug");
   Debug,
   DriverAdapterError,
   bindAdapter,
+  bindSqlAdapterFactory,
   err,
   ok
 });

package/dist/index.mjs

@@ -1,13 +1,9 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-
 // src/error.ts
 var DriverAdapterError = class extends Error {
+  name = "DriverAdapterError";
+  cause;
   constructor(payload) {
     super(typeof payload["message"] === "string" ? payload["message"] : payload.kind);
-    __publicField(this, "name", "DriverAdapterError");
-    __publicField(this, "cause");
     this.cause = payload;
   }
 };
@@ -43,9 +39,7 @@ function err(error) {
 
 // src/binder.ts
 var ErrorRegistryInternal = class {
-  constructor() {
-    __publicField(this, "registeredErrors", []);
-  }
+  registeredErrors = [];
   consumeError(id) {
     return this.registeredErrors[id];
   }
@@ -58,9 +52,20 @@ var ErrorRegistryInternal = class {
     return i;
   }
 };
-var bindAdapter = (adapter) => {
+var bindSqlAdapterFactory = (adapterFactory) => {
   const errorRegistry = new ErrorRegistryInternal();
-  const createTransactionContext = wrapAsync(errorRegistry, adapter.transactionContext.bind(adapter));
+  const boundFactory = {
+    adapterName: adapterFactory.adapterName,
+    provider: adapterFactory.provider,
+    errorRegistry,
+    connect: async (...args) => {
+      const ctx = await wrapAsync(errorRegistry, adapterFactory.connect.bind(adapterFactory))(...args);
+      return ctx.map((ctx2) => bindAdapter(ctx2, errorRegistry));
+    }
+  };
+  return boundFactory;
+};
+var bindAdapter = (adapter, errorRegistry = new ErrorRegistryInternal()) => {
   const boundAdapter = {
     adapterName: adapter.adapterName,
     errorRegistry,
@@ -69,9 +74,9 @@ var bindAdapter = (adapter) => {
     executeScript: wrapAsync(errorRegistry, adapter.executeScript.bind(adapter)),
     dispose: wrapAsync(errorRegistry, adapter.dispose.bind(adapter)),
     provider: adapter.provider,
-    transactionContext: async (...args) => {
-      const ctx = await createTransactionContext(...args);
-      return ctx.map((ctx2) => bindTransactionContext(errorRegistry, ctx2));
+    startTransaction: async (...args) => {
+      const ctx = await wrapAsync(errorRegistry, adapter.startTransaction.bind(adapter))(...args);
+      return ctx.map((ctx2) => bindTransaction(errorRegistry, ctx2));
     }
   };
   if (adapter.getConnectionInfo) {
@@ -79,19 +84,6 @@ var bindAdapter = (adapter) => {
   }
   return boundAdapter;
 };
-var bindTransactionContext = (errorRegistry, ctx) => {
-  const startTransaction = wrapAsync(errorRegistry, ctx.startTransaction.bind(ctx));
-  return {
-    adapterName: ctx.adapterName,
-    provider: ctx.provider,
-    queryRaw: wrapAsync(errorRegistry, ctx.queryRaw.bind(ctx)),
-    executeRaw: wrapAsync(errorRegistry, ctx.executeRaw.bind(ctx)),
-    startTransaction: async (...args) => {
-      const result = await startTransaction(...args);
-      return result.map((tx) => bindTransaction(errorRegistry, tx));
-    }
-  };
-};
 var bindTransaction = (errorRegistry, transaction) => {
   return {
     adapterName: transaction.adapterName,
@@ -176,6 +168,7 @@ export {
   Debug,
   DriverAdapterError,
   bindAdapter,
+  bindSqlAdapterFactory,
   err,
   ok
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/driver-adapter-utils",
-  "version": "6.6.0-dev.7",
+  "version": "6.6.0-dev.71",
   "description": "Internal set of utilities and types for Prisma's driver adapters.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,7 +31,7 @@
   "license": "Apache-2.0",
   "sideEffects": false,
   "dependencies": {
-    "@prisma/debug": "6.6.0-dev.7"
+    "@prisma/debug": "6.6.0-dev.71"
   },
   "scripts": {
     "dev": "DEV=true tsx helpers/build.ts",