@prisma/driver-adapter-utils 5.20.0-dev.2 → 5.20.0-dev.21

package/dist/index.d.mts

@@ -9,6 +9,13 @@ export declare type ArgType = 'Int32' | 'Int64' | 'Float' | 'Double' | 'Text' |
 
 export declare const bindAdapter: (adapter: DriverAdapter) => ErrorCapturingDriverAdapter;
 
+export declare interface BoundDriverAdapter extends Queryable, WithTransaction {
+    /**
+     * Optional method that returns extra connection info
+     */
+    getConnectionInfo?(): Result<ConnectionInfo>;
+}
+
 export declare type ColumnType = (typeof ColumnTypeEnum)[keyof typeof ColumnTypeEnum];
 
 export declare const ColumnTypeEnum: {
@@ -53,11 +60,7 @@ export declare type ConnectionInfo = {
 
 export { Debug }
 
-export declare interface DriverAdapter extends Queryable {
-    /**
-     * Starts new transaction.
-     */
-    startTransaction(): Promise<Result<Transaction>>;
+export declare interface DriverAdapter extends Queryable, WithTransactionDeprecated, WithTransaction {
     /**
      * Optional method that returns extra connection info
      */
@@ -95,7 +98,7 @@ declare type Error_2 = {
 };
 export { Error_2 as Error }
 
-export declare interface ErrorCapturingDriverAdapter extends DriverAdapter {
+export declare interface ErrorCapturingDriverAdapter extends BoundDriverAdapter {
     readonly errorRegistry: ErrorRegistry;
 }
 
@@ -185,8 +188,31 @@ export declare interface Transaction extends Queryable {
     rollback(): Promise<Result<void>>;
 }
 
+export declare interface TransactionContext extends Queryable {
+    /**
+     * Starts new transaction.
+     */
+    startTransaction(): Promise<Result<Transaction>>;
+}
+
 export declare type TransactionOptions = {
     usePhantomQuery: boolean;
 };
 
+declare interface WithTransaction extends Queryable {
+    /**
+     * Starts new transaction.
+     * If `startTransaction` is not defined, `transactionContext` must be defined.
+     */
+    transactionContext?(): Promise<Result<TransactionContext>>;
+}
+
+declare interface WithTransactionDeprecated extends Queryable {
+    /**
+     * Starts new transaction.
+     * @deprecated Use `transactionContext` instead.
+     */
+    startTransaction?(): Promise<Result<Transaction>>;
+}
+
 export { }

package/dist/index.d.ts

@@ -9,6 +9,13 @@ export declare type ArgType = 'Int32' | 'Int64' | 'Float' | 'Double' | 'Text' |
 
 export declare const bindAdapter: (adapter: DriverAdapter) => ErrorCapturingDriverAdapter;
 
+export declare interface BoundDriverAdapter extends Queryable, WithTransaction {
+    /**
+     * Optional method that returns extra connection info
+     */
+    getConnectionInfo?(): Result<ConnectionInfo>;
+}
+
 export declare type ColumnType = (typeof ColumnTypeEnum)[keyof typeof ColumnTypeEnum];
 
 export declare const ColumnTypeEnum: {
@@ -53,11 +60,7 @@ export declare type ConnectionInfo = {
 
 export { Debug }
 
-export declare interface DriverAdapter extends Queryable {
-    /**
-     * Starts new transaction.
-     */
-    startTransaction(): Promise<Result<Transaction>>;
+export declare interface DriverAdapter extends Queryable, WithTransactionDeprecated, WithTransaction {
     /**
      * Optional method that returns extra connection info
      */
@@ -95,7 +98,7 @@ declare type Error_2 = {
 };
 export { Error_2 as Error }
 
-export declare interface ErrorCapturingDriverAdapter extends DriverAdapter {
+export declare interface ErrorCapturingDriverAdapter extends BoundDriverAdapter {
     readonly errorRegistry: ErrorRegistry;
 }
 
@@ -185,8 +188,31 @@ export declare interface Transaction extends Queryable {
     rollback(): Promise<Result<void>>;
 }
 
+export declare interface TransactionContext extends Queryable {
+    /**
+     * Starts new transaction.
+     */
+    startTransaction(): Promise<Result<Transaction>>;
+}
+
 export declare type TransactionOptions = {
     usePhantomQuery: boolean;
 };
 
+declare interface WithTransaction extends Queryable {
+    /**
+     * Starts new transaction.
+     * If `startTransaction` is not defined, `transactionContext` must be defined.
+     */
+    transactionContext?(): Promise<Result<TransactionContext>>;
+}
+
+declare interface WithTransactionDeprecated extends Queryable {
+    /**
+     * Starts new transaction.
+     * @deprecated Use `transactionContext` instead.
+     */
+    startTransaction?(): Promise<Result<Transaction>>;
+}
+
 export { }

package/dist/index.js

@@ -73,16 +73,23 @@ var ErrorRegistryInternal = class {
 };
 var bindAdapter = (adapter) => {
   const errorRegistry = new ErrorRegistryInternal();
-  const startTransaction = wrapAsync(errorRegistry, adapter.startTransaction.bind(adapter));
+  if (adapter.transactionContext === void 0 && adapter.startTransaction === void 0) {
+    throw new Error(
+      "[prisma:driverAdapters] Either `adapter.transactionContext` or `adapter.startTransaction` must be defined."
+    );
+  }
+  const createTransactionContext = adapter.transactionContext === void 0 ? wrapAsync(errorRegistry, () => {
+    return Promise.resolve(ok(adapter));
+  }) : wrapAsync(errorRegistry, adapter.transactionContext.bind(adapter));
   const boundAdapter = {
     adapterName: adapter.adapterName,
     errorRegistry,
     queryRaw: wrapAsync(errorRegistry, adapter.queryRaw.bind(adapter)),
     executeRaw: wrapAsync(errorRegistry, adapter.executeRaw.bind(adapter)),
     provider: adapter.provider,
-    startTransaction: async (...args) => {
-      const result = await startTransaction(...args);
-      return result.map((tx) => bindTransaction(errorRegistry, tx));
+    transactionContext: async (...args) => {
+      const ctx = await createTransactionContext(...args);
+      return ctx.map((tx) => bindTransactionContext(errorRegistry, tx));
     }
   };
   if (adapter.getConnectionInfo) {
@@ -90,6 +97,19 @@ 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,

package/dist/index.mjs

@@ -43,16 +43,23 @@ var ErrorRegistryInternal = class {
 };
 var bindAdapter = (adapter) => {
   const errorRegistry = new ErrorRegistryInternal();
-  const startTransaction = wrapAsync(errorRegistry, adapter.startTransaction.bind(adapter));
+  if (adapter.transactionContext === void 0 && adapter.startTransaction === void 0) {
+    throw new Error(
+      "[prisma:driverAdapters] Either `adapter.transactionContext` or `adapter.startTransaction` must be defined."
+    );
+  }
+  const createTransactionContext = adapter.transactionContext === void 0 ? wrapAsync(errorRegistry, () => {
+    return Promise.resolve(ok(adapter));
+  }) : wrapAsync(errorRegistry, adapter.transactionContext.bind(adapter));
   const boundAdapter = {
     adapterName: adapter.adapterName,
     errorRegistry,
     queryRaw: wrapAsync(errorRegistry, adapter.queryRaw.bind(adapter)),
     executeRaw: wrapAsync(errorRegistry, adapter.executeRaw.bind(adapter)),
     provider: adapter.provider,
-    startTransaction: async (...args) => {
-      const result = await startTransaction(...args);
-      return result.map((tx) => bindTransaction(errorRegistry, tx));
+    transactionContext: async (...args) => {
+      const ctx = await createTransactionContext(...args);
+      return ctx.map((tx) => bindTransactionContext(errorRegistry, tx));
     }
   };
   if (adapter.getConnectionInfo) {
@@ -60,6 +67,19 @@ 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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/driver-adapter-utils",
-  "version": "5.20.0-dev.2",
+  "version": "5.20.0-dev.21",
   "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": "5.20.0-dev.2"
+    "@prisma/debug": "5.20.0-dev.21"
   },
   "scripts": {
     "dev": "DEV=true tsx helpers/build.ts",