@zenstackhq/runtime 3.0.0-alpha.31 → 3.0.0-alpha.32

package/dist/index.cjs

@@ -37,13 +37,13 @@ __export(src_exports, {
   QueryError: () => QueryError,
   ZenStackClient: () => ZenStackClient,
   definePlugin: () => definePlugin,
-  sql: () => import_kysely17.sql
+  sql: () => import_kysely18.sql
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/client/client-impl.ts
-var import_common_helpers14 = require("@zenstackhq/common-helpers");
-var import_kysely16 = require("kysely");
+var import_common_helpers16 = require("@zenstackhq/common-helpers");
+var import_kysely17 = require("kysely");
 
 // src/client/crud/operations/aggregate.ts
 var import_kysely9 = require("kysely");
@@ -2740,6 +2740,16 @@ function clone(value) {
 }
 __name(clone, "clone");
 
+// src/client/contract.ts
+var TransactionIsolationLevel = /* @__PURE__ */ function(TransactionIsolationLevel2) {
+  TransactionIsolationLevel2["ReadUncommitted"] = "read uncommitted";
+  TransactionIsolationLevel2["ReadCommitted"] = "read committed";
+  TransactionIsolationLevel2["RepeatableRead"] = "repeatable read";
+  TransactionIsolationLevel2["Serializable"] = "serializable";
+  TransactionIsolationLevel2["Snapshot"] = "snapshot";
+  return TransactionIsolationLevel2;
+}({});
+
 // src/client/crud/operations/base.ts
 var BaseOperationHandler = class {
   static {
@@ -3978,7 +3988,7 @@ var BaseOperationHandler = class {
       return callback(this.kysely);
     } else {
       let txBuilder = this.kysely.transaction();
-      txBuilder = txBuilder.setIsolationLevel(isolationLevel ?? "repeatable read");
+      txBuilder = txBuilder.setIsolationLevel(isolationLevel ?? TransactionIsolationLevel.RepeatableRead);
       return txBuilder.execute(callback);
     }
   }
@@ -5544,7 +5554,11 @@ var ZenStackDriver = class {
       this.#txConnections.delete(connection);
       if (callbacks) {
         for (const callback of callbacks) {
-          await callback();
+          try {
+            await callback();
+          } catch (err) {
+            console.error(`Error executing transaction commit callback: ${err}`);
+          }
         }
       }
       return result;
@@ -5662,14 +5676,33 @@ function performanceNow() {
 __name(performanceNow, "performanceNow");
 
 // src/client/executor/zenstack-query-executor.ts
-var import_kysely13 = require("kysely");
-var import_nanoid2 = require("nanoid");
+var import_common_helpers12 = require("@zenstackhq/common-helpers");
+var import_kysely14 = require("kysely");
 var import_ts_pattern16 = require("ts-pattern");
 
-// src/client/executor/name-mapper.ts
+// src/client/executor/kysely-utils.ts
 var import_common_helpers10 = require("@zenstackhq/common-helpers");
 var import_kysely12 = require("kysely");
-var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
+function stripAlias(node) {
+  if (import_kysely12.AliasNode.is(node)) {
+    (0, import_common_helpers10.invariant)(import_kysely12.IdentifierNode.is(node.alias), "Expected identifier as alias");
+    return {
+      alias: node.alias.name,
+      node: node.node
+    };
+  } else {
+    return {
+      alias: void 0,
+      node
+    };
+  }
+}
+__name(stripAlias, "stripAlias");
+
+// src/client/executor/name-mapper.ts
+var import_common_helpers11 = require("@zenstackhq/common-helpers");
+var import_kysely13 = require("kysely");
+var QueryNameMapper = class extends import_kysely13.OperationNodeTransformer {
   static {
     __name(this, "QueryNameMapper");
   }
@@ -5726,8 +5759,8 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
     };
   }
   transformJoin(node) {
-    const { alias, node: innerNode } = this.stripAlias(node.table);
-    if (import_kysely12.TableNode.is(innerNode)) {
+    const { alias, node: innerNode } = stripAlias(node.table);
+    if (import_kysely13.TableNode.is(innerNode)) {
       const modelName = innerNode.table.identifier.name;
       if (this.hasMappedColumns(modelName)) {
         const select = this.createSelectAll(modelName);
@@ -5740,7 +5773,7 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
     return super.transformJoin(node);
   }
   transformReference(node) {
-    if (!import_kysely12.ColumnNode.is(node.column)) {
+    if (!import_kysely13.ColumnNode.is(node.column)) {
       return super.transformReference(node);
     }
     const { fieldDef, modelDef, scope } = this.resolveFieldFromScopes(node.column.column.name, node.table?.table.identifier.name);
@@ -5753,7 +5786,7 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
           mappedTableName = this.mapTableName(scope.model);
         }
       }
-      return import_kysely12.ReferenceNode.create(import_kysely12.ColumnNode.create(mappedFieldName), mappedTableName ? import_kysely12.TableNode.create(mappedTableName) : void 0);
+      return import_kysely13.ReferenceNode.create(import_kysely13.ColumnNode.create(mappedFieldName), mappedTableName ? import_kysely13.TableNode.create(mappedTableName) : void 0);
     } else {
       return super.transformReference(node);
     }
@@ -5764,11 +5797,14 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
       return super.transformColumn(node);
     }
     const mappedName = this.mapFieldName(modelDef.name, fieldDef.name);
-    return import_kysely12.ColumnNode.create(mappedName);
+    return import_kysely13.ColumnNode.create(mappedName);
   }
   transformUpdateQuery(node) {
-    const { alias, node: innerTable } = this.stripAlias(node.table);
-    if (!innerTable || !import_kysely12.TableNode.is(innerTable)) {
+    if (!node.table) {
+      return super.transformUpdateQuery(node);
+    }
+    const { alias, node: innerTable } = stripAlias(node.table);
+    if (!innerTable || !import_kysely13.TableNode.is(innerTable)) {
       return super.transformUpdateQuery(node);
     }
     return this.withScope({
@@ -5785,8 +5821,8 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
   transformDeleteQuery(node) {
     const scopes = this.createScopesFromFroms(node.from, false);
     const froms = node.from.froms.map((from) => {
-      const { alias, node: innerNode } = this.stripAlias(from);
-      if (import_kysely12.TableNode.is(innerNode)) {
+      const { alias, node: innerNode } = stripAlias(from);
+      if (import_kysely13.TableNode.is(innerNode)) {
         return this.wrapAlias(this.processTableRef(innerNode), alias);
       } else {
         return super.transformNode(from);
@@ -5795,7 +5831,7 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
     return this.withScopes(scopes, () => {
       return {
         ...super.transformDeleteQuery(node),
-        from: import_kysely12.FromNode.create(froms)
+        from: import_kysely13.FromNode.create(froms)
       };
     });
   }
@@ -5852,22 +5888,22 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
     }
   }
   wrapAlias(node, alias) {
-    return alias ? import_kysely12.AliasNode.create(node, import_kysely12.IdentifierNode.create(alias)) : node;
+    return alias ? import_kysely13.AliasNode.create(node, import_kysely13.IdentifierNode.create(alias)) : node;
   }
   ensureAlias(node, alias, fallbackName) {
     if (!node) {
       return node;
     }
-    return alias ? import_kysely12.AliasNode.create(node, import_kysely12.IdentifierNode.create(alias)) : import_kysely12.AliasNode.create(node, import_kysely12.IdentifierNode.create(fallbackName));
+    return alias ? import_kysely13.AliasNode.create(node, import_kysely13.IdentifierNode.create(alias)) : import_kysely13.AliasNode.create(node, import_kysely13.IdentifierNode.create(fallbackName));
   }
   processTableRef(node) {
     if (!node) {
       return node;
     }
-    if (!import_kysely12.TableNode.is(node)) {
+    if (!import_kysely13.TableNode.is(node)) {
       return super.transformNode(node);
     }
-    return import_kysely12.TableNode.create(this.mapTableName(node.table.identifier.name));
+    return import_kysely13.TableNode.create(this.mapTableName(node.table.identifier.name));
   }
   getMappedName(def) {
     const mapAttr = def.attributes?.find((attr) => attr.name === "@@map" || attr.name === "@map");
@@ -5895,25 +5931,6 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
       return tableName;
     }
   }
-  stripAlias(node) {
-    if (!node) {
-      return {
-        alias: void 0,
-        node
-      };
-    }
-    if (import_kysely12.AliasNode.is(node)) {
-      (0, import_common_helpers10.invariant)(import_kysely12.IdentifierNode.is(node.alias), "Expected identifier as alias");
-      return {
-        alias: node.alias.name,
-        node: node.node
-      };
-    }
-    return {
-      alias: void 0,
-      node
-    };
-  }
   hasMappedColumns(modelName) {
     return [
       ...this.fieldToColumnMap.keys()
@@ -5924,8 +5941,8 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
       return [];
     }
     return node.froms.map((from) => {
-      const { alias, node: innerNode } = this.stripAlias(from);
-      if (innerNode && import_kysely12.TableNode.is(innerNode)) {
+      const { alias, node: innerNode } = stripAlias(from);
+      if (innerNode && import_kysely13.TableNode.is(innerNode)) {
         return {
           model: innerNode.table.identifier.name,
           alias,
@@ -5941,11 +5958,11 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
     return {
       ...super.transformFrom(node),
       froms: node.froms.map((from) => {
-        const { alias, node: innerNode } = this.stripAlias(from);
+        const { alias, node: innerNode } = stripAlias(from);
         if (!innerNode) {
           return super.transformNode(from);
         }
-        if (import_kysely12.TableNode.is(innerNode)) {
+        if (import_kysely13.TableNode.is(innerNode)) {
           if (this.hasMappedColumns(innerNode.table.identifier.name)) {
             const selectAll = this.createSelectAll(innerNode.table.identifier.name);
             return this.ensureAlias(selectAll, alias, innerNode.table.identifier.name);
@@ -5961,17 +5978,17 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
     const tableName = this.mapTableName(model);
     return {
       kind: "SelectQueryNode",
-      from: import_kysely12.FromNode.create([
-        import_kysely12.TableNode.create(tableName)
+      from: import_kysely13.FromNode.create([
+        import_kysely13.TableNode.create(tableName)
       ]),
       selections: this.getModelFields(modelDef).map((fieldDef) => {
         const columnName = this.mapFieldName(model, fieldDef.name);
-        const columnRef = import_kysely12.ReferenceNode.create(import_kysely12.ColumnNode.create(columnName), import_kysely12.TableNode.create(tableName));
+        const columnRef = import_kysely13.ReferenceNode.create(import_kysely13.ColumnNode.create(columnName), import_kysely13.TableNode.create(tableName));
         if (columnName !== fieldDef.name) {
-          const aliased = import_kysely12.AliasNode.create(columnRef, import_kysely12.IdentifierNode.create(fieldDef.name));
-          return import_kysely12.SelectionNode.create(aliased);
+          const aliased = import_kysely13.AliasNode.create(columnRef, import_kysely13.IdentifierNode.create(fieldDef.name));
+          return import_kysely13.SelectionNode.create(aliased);
         } else {
-          return import_kysely12.SelectionNode.create(columnRef);
+          return import_kysely13.SelectionNode.create(columnRef);
         }
       })
     };
@@ -5982,22 +5999,22 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
   processSelections(selections) {
     const result = [];
     selections.forEach((selection) => {
-      if (import_kysely12.SelectAllNode.is(selection.selection)) {
+      if (import_kysely13.SelectAllNode.is(selection.selection)) {
         const processed = this.processSelectAll(selection.selection);
         if (Array.isArray(processed)) {
-          result.push(...processed.map((s) => import_kysely12.SelectionNode.create(s)));
+          result.push(...processed.map((s) => import_kysely13.SelectionNode.create(s)));
         } else {
-          result.push(import_kysely12.SelectionNode.create(processed));
+          result.push(import_kysely13.SelectionNode.create(processed));
         }
       } else {
-        result.push(import_kysely12.SelectionNode.create(this.processSelection(selection.selection)));
+        result.push(import_kysely13.SelectionNode.create(this.processSelection(selection.selection)));
       }
     });
     return result;
   }
   processSelection(node) {
     let alias;
-    if (!import_kysely12.AliasNode.is(node)) {
+    if (!import_kysely13.AliasNode.is(node)) {
       alias = this.extractFieldName(node);
     }
     const result = super.transformNode(node);
@@ -6005,21 +6022,21 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
   }
   processSelectAll(node) {
     const scope = this.modelScopes[this.modelScopes.length - 1];
-    (0, import_common_helpers10.invariant)(scope);
+    (0, import_common_helpers11.invariant)(scope);
     if (!this.hasMappedColumns(scope.model)) {
       return super.transformSelectAll(node);
     }
     const modelDef = requireModel(this.schema, scope.model);
     return this.getModelFields(modelDef).map((fieldDef) => {
       const columnName = this.mapFieldName(scope.model, fieldDef.name);
-      const columnRef = import_kysely12.ReferenceNode.create(import_kysely12.ColumnNode.create(columnName));
+      const columnRef = import_kysely13.ReferenceNode.create(import_kysely13.ColumnNode.create(columnName));
       return columnName !== fieldDef.name ? this.wrapAlias(columnRef, fieldDef.name) : columnRef;
     });
   }
   extractFieldName(node) {
-    if (import_kysely12.ReferenceNode.is(node) && import_kysely12.ColumnNode.is(node.column)) {
+    if (import_kysely13.ReferenceNode.is(node) && import_kysely13.ColumnNode.is(node.column)) {
       return node.column.column.name;
-    } else if (import_kysely12.ColumnNode.is(node)) {
+    } else if (import_kysely13.ColumnNode.is(node)) {
       return node.column.name;
     } else {
       return void 0;
@@ -6028,7 +6045,7 @@ var QueryNameMapper = class extends import_kysely12.OperationNodeTransformer {
 };
 
 // src/client/executor/zenstack-query-executor.ts
-var ZenStackQueryExecutor = class _ZenStackQueryExecutor extends import_kysely13.DefaultQueryExecutor {
+var ZenStackQueryExecutor = class _ZenStackQueryExecutor extends import_kysely14.DefaultQueryExecutor {
   static {
     __name(this, "ZenStackQueryExecutor");
   }
@@ -6036,9 +6053,10 @@ var ZenStackQueryExecutor = class _ZenStackQueryExecutor extends import_kysely13
   driver;
   compiler;
   connectionProvider;
+  suppressMutationHooks;
   nameMapper;
-  constructor(client, driver, compiler, adapter, connectionProvider, plugins = []) {
-    super(compiler, adapter, connectionProvider, plugins), this.client = client, this.driver = driver, this.compiler = compiler, this.connectionProvider = connectionProvider;
+  constructor(client, driver, compiler, adapter, connectionProvider, plugins = [], suppressMutationHooks = false) {
+    super(compiler, adapter, connectionProvider, plugins), this.client = client, this.driver = driver, this.compiler = compiler, this.connectionProvider = connectionProvider, this.suppressMutationHooks = suppressMutationHooks;
     this.nameMapper = new QueryNameMapper(client.$schema);
   }
   get kysely() {
@@ -6047,38 +6065,13 @@ var ZenStackQueryExecutor = class _ZenStackQueryExecutor extends import_kysely13
   get options() {
     return this.client.$options;
   }
-  async executeQuery(compiledQuery, _queryId) {
-    let queryNode = compiledQuery.query;
-    let mutationInterceptionInfo;
-    if (this.isMutationNode(queryNode) && this.hasMutationHooks) {
-      mutationInterceptionInfo = await this.callMutationInterceptionFilters(queryNode);
-    }
-    const task = /* @__PURE__ */ __name(async () => {
-      if (this.isMutationNode(queryNode)) {
-        await this.callBeforeMutationHooks(queryNode, mutationInterceptionInfo);
-      }
-      const oldQueryNode = queryNode;
-      if ((import_kysely13.InsertQueryNode.is(queryNode) || import_kysely13.UpdateQueryNode.is(queryNode)) && mutationInterceptionInfo?.loadAfterMutationEntities) {
-        queryNode = {
-          ...queryNode,
-          returning: import_kysely13.ReturningNode.create([
-            import_kysely13.SelectionNode.createSelectAll()
-          ])
-        };
-      }
-      const queryParams = compiledQuery.$raw ? compiledQuery.parameters : void 0;
-      const result = await this.proceedQueryWithKyselyInterceptors(queryNode, queryParams);
-      if (this.isMutationNode(queryNode)) {
-        await this.callAfterMutationHooks(result.result, queryNode, mutationInterceptionInfo, result.connection);
-      }
-      if (oldQueryNode !== queryNode) {
-      }
-      return result.result;
-    }, "task");
-    return task();
+  async executeQuery(compiledQuery, queryId) {
+    const queryParams = compiledQuery.$raw ? compiledQuery.parameters : void 0;
+    const result = await this.proceedQueryWithKyselyInterceptors(compiledQuery.query, queryParams, queryId.queryId);
+    return result.result;
   }
-  proceedQueryWithKyselyInterceptors(queryNode, parameters) {
-    let proceed = /* @__PURE__ */ __name((q) => this.proceedQuery(q, parameters), "proceed");
+  async proceedQueryWithKyselyInterceptors(queryNode, parameters, queryId) {
+    let proceed = /* @__PURE__ */ __name((q) => this.proceedQuery(q, parameters, queryId), "proceed");
     const hooks = [];
     for (const plugin of this.client.$options.plugins ?? []) {
       if (plugin.onKyselyQuery) {
@@ -6088,10 +6081,8 @@ var ZenStackQueryExecutor = class _ZenStackQueryExecutor extends import_kysely13
     for (const hook of hooks) {
       const _proceed = proceed;
       proceed = /* @__PURE__ */ __name(async (query) => {
-        let connection;
         const _p = /* @__PURE__ */ __name(async (q) => {
           const r = await _proceed(q);
-          connection = r.connection;
           return r.result;
         }, "_p");
         const hookResult = await hook({
@@ -6102,190 +6093,232 @@ var ZenStackQueryExecutor = class _ZenStackQueryExecutor extends import_kysely13
           proceed: _p
         });
         return {
-          result: hookResult,
-          connection
+          result: hookResult
         };
       }, "proceed");
     }
-    return proceed(queryNode);
+    const result = await proceed(queryNode);
+    return result;
   }
-  async proceedQuery(query, parameters) {
-    const finalQuery = this.nameMapper.transformNode(query);
-    let compiled = this.compileQuery(finalQuery);
-    if (parameters) {
-      compiled = {
-        ...compiled,
-        parameters
-      };
-    }
+  getMutationInfo(queryNode) {
+    const model = this.getMutationModel(queryNode);
+    const { action, where } = (0, import_ts_pattern16.match)(queryNode).when(import_kysely14.InsertQueryNode.is, () => ({
+      action: "create",
+      where: void 0
+    })).when(import_kysely14.UpdateQueryNode.is, (node) => ({
+      action: "update",
+      where: node.where
+    })).when(import_kysely14.DeleteQueryNode.is, (node) => ({
+      action: "delete",
+      where: node.where
+    })).exhaustive();
+    return {
+      model,
+      action,
+      where
+    };
+  }
+  async proceedQuery(query, parameters, queryId) {
+    let compiled;
     try {
       return await this.provideConnection(async (connection) => {
-        const result = await connection.executeQuery(compiled);
-        return {
-          result,
-          connection
-        };
+        if (this.suppressMutationHooks || !this.isMutationNode(query) || !this.hasEntityMutationPlugins) {
+          const finalQuery2 = this.nameMapper.transformNode(query);
+          compiled = this.compileQuery(finalQuery2);
+          if (parameters) {
+            compiled = {
+              ...compiled,
+              parameters
+            };
+          }
+          const result = await connection.executeQuery(compiled);
+          return {
+            result
+          };
+        }
+        if ((import_kysely14.InsertQueryNode.is(query) || import_kysely14.UpdateQueryNode.is(query)) && this.hasEntityMutationPluginsWithAfterMutationHooks) {
+          query = {
+            ...query,
+            returning: import_kysely14.ReturningNode.create([
+              import_kysely14.SelectionNode.createSelectAll()
+            ])
+          };
+        }
+        const finalQuery = this.nameMapper.transformNode(query);
+        compiled = this.compileQuery(finalQuery);
+        if (parameters) {
+          compiled = {
+            ...compiled,
+            parameters
+          };
+        }
+        const currentlyInTx = this.driver.isTransactionConnection(connection);
+        const connectionClient = this.createClientForConnection(connection, currentlyInTx);
+        const mutationInfo = this.getMutationInfo(finalQuery);
+        let beforeMutationEntities;
+        const loadBeforeMutationEntities = /* @__PURE__ */ __name(async () => {
+          if (beforeMutationEntities === void 0 && (import_kysely14.UpdateQueryNode.is(query) || import_kysely14.DeleteQueryNode.is(query))) {
+            beforeMutationEntities = await this.loadEntities(mutationInfo.model, mutationInfo.where, connection);
+          }
+          return beforeMutationEntities;
+        }, "loadBeforeMutationEntities");
+        await this.callBeforeMutationHooks(finalQuery, mutationInfo, loadBeforeMutationEntities, connectionClient, queryId);
+        const shouldCreateTx = this.hasPluginRequestingAfterMutationWithinTransaction && !this.driver.isTransactionConnection(connection);
+        if (!shouldCreateTx) {
+          const result = await connection.executeQuery(compiled);
+          if (!this.driver.isTransactionConnection(connection)) {
+            await this.callAfterMutationHooks(result, finalQuery, mutationInfo, connectionClient, "all", queryId);
+          } else {
+            await this.callAfterMutationHooks(result, finalQuery, mutationInfo, connectionClient, "inTx", queryId);
+            this.driver.registerTransactionCommitCallback(connection, () => this.callAfterMutationHooks(result, finalQuery, mutationInfo, connectionClient, "outTx", queryId));
+          }
+          return {
+            result
+          };
+        } else {
+          await this.driver.beginTransaction(connection, {
+            isolationLevel: TransactionIsolationLevel.ReadCommitted
+          });
+          try {
+            const result = await connection.executeQuery(compiled);
+            await this.callAfterMutationHooks(result, finalQuery, mutationInfo, connectionClient, "inTx", queryId);
+            await this.driver.commitTransaction(connection);
+            await this.callAfterMutationHooks(result, finalQuery, mutationInfo, connectionClient, "outTx", queryId);
+            return {
+              result
+            };
+          } catch (err) {
+            await this.driver.rollbackTransaction(connection);
+            throw err;
+          }
+        }
       });
     } catch (err) {
-      const message = `Failed to execute query: ${err}, sql: ${compiled.sql}`;
+      const message = `Failed to execute query: ${err}, sql: ${compiled?.sql}`;
       throw new QueryError(message, err);
     }
   }
+  createClientForConnection(connection, inTx) {
+    const innerExecutor = this.withConnectionProvider(new import_kysely14.SingleConnectionProvider(connection));
+    innerExecutor.suppressMutationHooks = true;
+    const innerClient = this.client.withExecutor(innerExecutor);
+    if (inTx) {
+      innerClient.forceTransaction();
+    }
+    return innerClient;
+  }
+  get hasEntityMutationPlugins() {
+    return (this.client.$options.plugins ?? []).some((plugin) => plugin.onEntityMutation);
+  }
+  get hasEntityMutationPluginsWithAfterMutationHooks() {
+    return (this.client.$options.plugins ?? []).some((plugin) => plugin.onEntityMutation?.afterEntityMutation);
+  }
+  get hasPluginRequestingAfterMutationWithinTransaction() {
+    return (this.client.$options.plugins ?? []).some((plugin) => plugin.onEntityMutation?.runAfterMutationWithinTransaction);
+  }
   isMutationNode(queryNode) {
-    return import_kysely13.InsertQueryNode.is(queryNode) || import_kysely13.UpdateQueryNode.is(queryNode) || import_kysely13.DeleteQueryNode.is(queryNode);
+    return import_kysely14.InsertQueryNode.is(queryNode) || import_kysely14.UpdateQueryNode.is(queryNode) || import_kysely14.DeleteQueryNode.is(queryNode);
   }
   withPlugin(plugin) {
     return new _ZenStackQueryExecutor(this.client, this.driver, this.compiler, this.adapter, this.connectionProvider, [
       ...this.plugins,
       plugin
-    ]);
+    ], this.suppressMutationHooks);
   }
   withPlugins(plugins) {
     return new _ZenStackQueryExecutor(this.client, this.driver, this.compiler, this.adapter, this.connectionProvider, [
       ...this.plugins,
       ...plugins
-    ]);
+    ], this.suppressMutationHooks);
   }
   withPluginAtFront(plugin) {
     return new _ZenStackQueryExecutor(this.client, this.driver, this.compiler, this.adapter, this.connectionProvider, [
       plugin,
       ...this.plugins
-    ]);
+    ], this.suppressMutationHooks);
   }
   withoutPlugins() {
-    return new _ZenStackQueryExecutor(this.client, this.driver, this.compiler, this.adapter, this.connectionProvider, []);
+    return new _ZenStackQueryExecutor(this.client, this.driver, this.compiler, this.adapter, this.connectionProvider, [], this.suppressMutationHooks);
   }
   withConnectionProvider(connectionProvider) {
-    const newExecutor = new _ZenStackQueryExecutor(this.client, this.driver, this.compiler, this.adapter, connectionProvider);
+    const newExecutor = new _ZenStackQueryExecutor(this.client, this.driver, this.compiler, this.adapter, connectionProvider, this.plugins, this.suppressMutationHooks);
     newExecutor.client = this.client.withExecutor(newExecutor);
     return newExecutor;
   }
-  get hasMutationHooks() {
-    return this.client.$options.plugins?.some((plugin) => !!plugin.onEntityMutation);
-  }
   getMutationModel(queryNode) {
-    return (0, import_ts_pattern16.match)(queryNode).when(import_kysely13.InsertQueryNode.is, (node) => node.into.table.identifier.name).when(import_kysely13.UpdateQueryNode.is, (node) => node.table.table.identifier.name).when(import_kysely13.DeleteQueryNode.is, (node) => {
-      if (node.from.froms.length !== 1) {
-        throw new InternalError(`Delete query must have exactly one from table`);
-      }
-      return node.from.froms[0].table.identifier.name;
+    return (0, import_ts_pattern16.match)(queryNode).when(import_kysely14.InsertQueryNode.is, (node) => {
+      (0, import_common_helpers12.invariant)(node.into, "InsertQueryNode must have an into clause");
+      return node.into.table.identifier.name;
+    }).when(import_kysely14.UpdateQueryNode.is, (node) => {
+      (0, import_common_helpers12.invariant)(node.table, "UpdateQueryNode must have a table");
+      const { node: tableNode } = stripAlias(node.table);
+      (0, import_common_helpers12.invariant)(import_kysely14.TableNode.is(tableNode), "UpdateQueryNode must use a TableNode");
+      return tableNode.table.identifier.name;
+    }).when(import_kysely14.DeleteQueryNode.is, (node) => {
+      (0, import_common_helpers12.invariant)(node.from.froms.length === 1, "Delete query must have exactly one from table");
+      const { node: tableNode } = stripAlias(node.from.froms[0]);
+      (0, import_common_helpers12.invariant)(import_kysely14.TableNode.is(tableNode), "DeleteQueryNode must use a TableNode");
+      return tableNode.table.identifier.name;
     }).otherwise((node) => {
       throw new InternalError(`Invalid query node: ${node}`);
     });
   }
-  async callMutationInterceptionFilters(queryNode) {
-    const plugins = this.client.$options.plugins;
-    if (plugins) {
-      const mutationModel = this.getMutationModel(queryNode);
-      const result = {
-        intercept: false
-      };
-      const { action, where } = (0, import_ts_pattern16.match)(queryNode).when(import_kysely13.InsertQueryNode.is, () => ({
-        action: "create",
-        where: void 0
-      })).when(import_kysely13.UpdateQueryNode.is, (node) => ({
-        action: "update",
-        where: node.where
-      })).when(import_kysely13.DeleteQueryNode.is, (node) => ({
-        action: "delete",
-        where: node.where
-      })).exhaustive();
-      for (const plugin of plugins) {
-        const onEntityMutation = plugin.onEntityMutation;
-        if (!onEntityMutation) {
-          continue;
-        }
-        if (!onEntityMutation.mutationInterceptionFilter) {
-          result.intercept = true;
-        } else {
-          const filterResult = await onEntityMutation.mutationInterceptionFilter({
-            model: mutationModel,
-            action,
-            queryNode
-          });
-          result.intercept ||= filterResult.intercept;
-          result.loadBeforeMutationEntities ||= filterResult.loadBeforeMutationEntities;
-          result.loadAfterMutationEntities ||= filterResult.loadAfterMutationEntities;
-        }
-      }
-      let beforeMutationEntities;
-      if (result.loadBeforeMutationEntities && (import_kysely13.UpdateQueryNode.is(queryNode) || import_kysely13.DeleteQueryNode.is(queryNode))) {
-        beforeMutationEntities = await this.loadEntities(mutationModel, where);
-      }
-      return {
-        ...result,
-        mutationModel,
-        action,
-        where,
-        beforeMutationEntities
-      };
-    } else {
-      return void 0;
-    }
-  }
-  async callBeforeMutationHooks(queryNode, mutationInterceptionInfo) {
-    if (!mutationInterceptionInfo?.intercept) {
-      return;
-    }
+  async callBeforeMutationHooks(queryNode, mutationInfo, loadBeforeMutationEntities, client, queryId) {
     if (this.options.plugins) {
-      const mutationModel = this.getMutationModel(queryNode);
       for (const plugin of this.options.plugins) {
         const onEntityMutation = plugin.onEntityMutation;
-        if (onEntityMutation?.beforeEntityMutation) {
-          await onEntityMutation.beforeEntityMutation({
-            model: mutationModel,
-            action: mutationInterceptionInfo.action,
-            queryNode,
-            entities: mutationInterceptionInfo.beforeMutationEntities
-          });
+        if (!onEntityMutation?.beforeEntityMutation) {
+          continue;
         }
+        await onEntityMutation.beforeEntityMutation({
+          model: mutationInfo.model,
+          action: mutationInfo.action,
+          queryNode,
+          loadBeforeMutationEntities,
+          client,
+          queryId
+        });
       }
     }
   }
-  async callAfterMutationHooks(queryResult, queryNode, mutationInterceptionInfo, connection) {
-    if (!mutationInterceptionInfo?.intercept) {
-      return;
-    }
+  async callAfterMutationHooks(queryResult, queryNode, mutationInfo, client, filterFor, queryId) {
     const hooks = [];
     for (const plugin of this.options.plugins ?? []) {
       const onEntityMutation = plugin.onEntityMutation;
-      if (onEntityMutation?.afterEntityMutation) {
-        hooks.push(onEntityMutation.afterEntityMutation.bind(plugin));
+      if (!onEntityMutation?.afterEntityMutation) {
+        continue;
       }
+      if (filterFor === "inTx" && !onEntityMutation.runAfterMutationWithinTransaction) {
+        continue;
+      }
+      if (filterFor === "outTx" && onEntityMutation.runAfterMutationWithinTransaction) {
+        continue;
+      }
+      hooks.push(onEntityMutation.afterEntityMutation.bind(plugin));
     }
     if (hooks.length === 0) {
       return;
     }
     const mutationModel = this.getMutationModel(queryNode);
-    const inTransaction = this.driver.isTransactionConnection(connection);
-    for (const hook of hooks) {
-      let afterMutationEntities = void 0;
-      if (mutationInterceptionInfo.loadAfterMutationEntities) {
-        if (import_kysely13.InsertQueryNode.is(queryNode) || import_kysely13.UpdateQueryNode.is(queryNode)) {
-          afterMutationEntities = queryResult.rows;
-        }
-      }
-      const action = /* @__PURE__ */ __name(async () => {
-        try {
-          await hook({
-            model: mutationModel,
-            action: mutationInterceptionInfo.action,
-            queryNode,
-            beforeMutationEntities: mutationInterceptionInfo.beforeMutationEntities,
-            afterMutationEntities
-          });
-        } catch (err) {
-          console.error(`Error in afterEntityMutation hook for model "${mutationModel}": ${err}`);
-        }
-      }, "action");
-      if (inTransaction) {
-        this.driver.registerTransactionCommitCallback(connection, action);
+    const loadAfterMutationEntities = /* @__PURE__ */ __name(async () => {
+      if (mutationInfo.action === "delete") {
+        return void 0;
       } else {
-        await action();
+        return queryResult.rows;
       }
+    }, "loadAfterMutationEntities");
+    for (const hook of hooks) {
+      await hook({
+        model: mutationModel,
+        action: mutationInfo.action,
+        queryNode,
+        loadAfterMutationEntities,
+        client,
+        queryId
+      });
     }
   }
-  async loadEntities(model, where) {
+  async loadEntities(model, where, connection) {
     const selectQuery = this.kysely.selectFrom(model).selectAll();
     let selectQueryNode = selectQuery.toOperationNode();
     selectQueryNode = {
@@ -6293,16 +6326,14 @@ var ZenStackQueryExecutor = class _ZenStackQueryExecutor extends import_kysely13
       where: this.andNodes(selectQueryNode.where, where)
     };
     const compiled = this.compileQuery(selectQueryNode);
-    const result = await this.executeQuery(compiled, {
-      queryId: `zenstack-${(0, import_nanoid2.nanoid)()}`
-    });
+    const result = await connection.executeQuery(compiled);
     return result.rows;
   }
   andNodes(condition1, condition2) {
     if (condition1 && condition2) {
-      return import_kysely13.WhereNode.create(import_kysely13.AndNode.create(condition1, condition2));
+      return import_kysely14.WhereNode.create(import_kysely14.AndNode.create(condition1, condition2));
     } else if (condition1) {
-      return import_kysely13.WhereNode.create(condition1);
+      return import_kysely14.WhereNode.create(condition1);
     } else {
       return condition2;
     }
@@ -6324,8 +6355,8 @@ __export(functions_exports, {
   search: () => search,
   startsWith: () => startsWith
 });
-var import_common_helpers11 = require("@zenstackhq/common-helpers");
-var import_kysely14 = require("kysely");
+var import_common_helpers13 = require("@zenstackhq/common-helpers");
+var import_kysely15 = require("kysely");
 var import_ts_pattern17 = require("ts-pattern");
 var contains = /* @__PURE__ */ __name((eb, args) => {
   const [field, search2, caseInsensitive = false] = args;
@@ -6336,9 +6367,9 @@ var contains = /* @__PURE__ */ __name((eb, args) => {
     throw new Error('"search" parameter is required');
   }
   const searchExpr = eb.fn("CONCAT", [
-    import_kysely14.sql.lit("%"),
+    import_kysely15.sql.lit("%"),
     search2,
-    import_kysely14.sql.lit("%")
+    import_kysely15.sql.lit("%")
   ]);
   return eb(field, caseInsensitive ? "ilike" : "like", searchExpr);
 }, "contains");
@@ -6355,7 +6386,7 @@ var startsWith = /* @__PURE__ */ __name((eb, args) => {
   }
   return eb(field, "like", eb.fn("CONCAT", [
     search2,
-    import_kysely14.sql.lit("%")
+    import_kysely15.sql.lit("%")
   ]));
 }, "startsWith");
 var endsWith = /* @__PURE__ */ __name((eb, args) => {
@@ -6367,7 +6398,7 @@ var endsWith = /* @__PURE__ */ __name((eb, args) => {
     throw new Error('"search" parameter is required');
   }
   return eb(field, "like", eb.fn("CONCAT", [
-    import_kysely14.sql.lit("%"),
+    import_kysely15.sql.lit("%"),
     search2
   ]));
 }, "endsWith");
@@ -6408,10 +6439,10 @@ var isEmpty = /* @__PURE__ */ __name((eb, args, { dialect }) => {
   if (!field) {
     throw new Error('"field" parameter is required');
   }
-  return eb(dialect.buildArrayLength(eb, field), "=", import_kysely14.sql.lit(0));
+  return eb(dialect.buildArrayLength(eb, field), "=", import_kysely15.sql.lit(0));
 }, "isEmpty");
 var now = /* @__PURE__ */ __name((eb, _args, { dialect }) => {
-  return (0, import_ts_pattern17.match)(dialect.provider).with("postgresql", () => eb.fn("now")).with("sqlite", () => import_kysely14.sql.raw("CURRENT_TIMESTAMP")).exhaustive();
+  return (0, import_ts_pattern17.match)(dialect.provider).with("postgresql", () => eb.fn("now")).with("sqlite", () => import_kysely15.sql.raw("CURRENT_TIMESTAMP")).exhaustive();
 }, "now");
 var currentModel = /* @__PURE__ */ __name((_eb, args, { model }) => {
   let result = model;
@@ -6419,7 +6450,7 @@ var currentModel = /* @__PURE__ */ __name((_eb, args, { model }) => {
   if (casing) {
     result = processCasing(casing, result, model);
   }
-  return import_kysely14.sql.lit(result);
+  return import_kysely15.sql.lit(result);
 }, "currentModel");
 var currentOperation = /* @__PURE__ */ __name((_eb, args, { operation }) => {
   let result = operation;
@@ -6427,12 +6458,12 @@ var currentOperation = /* @__PURE__ */ __name((_eb, args, { operation }) => {
   if (casing) {
     result = processCasing(casing, result, operation);
   }
-  return import_kysely14.sql.lit(result);
+  return import_kysely15.sql.lit(result);
 }, "currentOperation");
 function processCasing(casing, result, model) {
   const opNode = casing.toOperationNode();
-  (0, import_common_helpers11.invariant)(import_kysely14.ValueNode.is(opNode) && typeof opNode.value === "string", '"casting" parameter must be a string value');
-  result = (0, import_ts_pattern17.match)(opNode.value).with("original", () => model).with("upper", () => result.toUpperCase()).with("lower", () => result.toLowerCase()).with("capitalize", () => (0, import_common_helpers11.upperCaseFirst)(result)).with("uncapitalize", () => (0, import_common_helpers11.lowerCaseFirst)(result)).otherwise(() => {
+  (0, import_common_helpers13.invariant)(import_kysely15.ValueNode.is(opNode) && typeof opNode.value === "string", '"casting" parameter must be a string value');
+  result = (0, import_ts_pattern17.match)(opNode.value).with("original", () => model).with("upper", () => result.toUpperCase()).with("lower", () => result.toLowerCase()).with("capitalize", () => (0, import_common_helpers13.upperCaseFirst)(result)).with("uncapitalize", () => (0, import_common_helpers13.lowerCaseFirst)(result)).otherwise(() => {
     throw new Error(`Invalid casing value: ${opNode.value}. Must be "original", "upper", "lower", "capitalize", or "uncapitalize".`);
   });
   return result;
@@ -6440,8 +6471,8 @@ function processCasing(casing, result, model) {
 __name(processCasing, "processCasing");
 
 // src/client/helpers/schema-db-pusher.ts
-var import_common_helpers12 = require("@zenstackhq/common-helpers");
-var import_kysely15 = require("kysely");
+var import_common_helpers14 = require("@zenstackhq/common-helpers");
+var import_kysely16 = require("kysely");
 var import_toposort = __toESM(require("toposort"), 1);
 var import_ts_pattern18 = require("ts-pattern");
 var SchemaDbPusher = class {
@@ -6536,7 +6567,7 @@ var SchemaDbPusher = class {
   }
   addUniqueConstraint(table, modelDef) {
     for (const [key, value] of Object.entries(modelDef.uniqueFields)) {
-      (0, import_common_helpers12.invariant)(typeof value === "object", "expecting an object");
+      (0, import_common_helpers14.invariant)(typeof value === "object", "expecting an object");
       if ("type" in value) {
         const fieldDef = modelDef.fields[key];
         if (fieldDef.unique) {
@@ -6559,7 +6590,7 @@ var SchemaDbPusher = class {
       if (fieldDef.default !== void 0) {
         if (typeof fieldDef.default === "object" && "kind" in fieldDef.default) {
           if (ExpressionUtils.isCall(fieldDef.default) && fieldDef.default.function === "now") {
-            col = col.defaultTo(import_kysely15.sql`CURRENT_TIMESTAMP`);
+            col = col.defaultTo(import_kysely16.sql`CURRENT_TIMESTAMP`);
           }
         } else {
           col = col.defaultTo(fieldDef.default);
@@ -6579,7 +6610,7 @@ var SchemaDbPusher = class {
   }
   mapFieldType(fieldDef) {
     if (this.schema.enums?.[fieldDef.type]) {
-      return this.schema.provider.type === "postgresql" ? import_kysely15.sql.ref(fieldDef.type) : "text";
+      return this.schema.provider.type === "postgresql" ? import_kysely16.sql.ref(fieldDef.type) : "text";
     }
     if (this.isAutoIncrement(fieldDef) && this.schema.provider.type === "postgresql") {
       return "serial";
@@ -6592,7 +6623,7 @@ var SchemaDbPusher = class {
       throw new Error(`Unsupported field type: ${type}`);
     });
     if (fieldDef.array) {
-      return import_kysely15.sql.raw(`${result}[]`);
+      return import_kysely16.sql.raw(`${result}[]`);
     } else {
       return result;
     }
@@ -6604,7 +6635,7 @@ var SchemaDbPusher = class {
     return fieldDef.default && ExpressionUtils.isCall(fieldDef.default) && fieldDef.default.function === "autoincrement";
   }
   addForeignKeyConstraint(table, model, fieldName, fieldDef) {
-    (0, import_common_helpers12.invariant)(fieldDef.relation, "field must be a relation");
+    (0, import_common_helpers14.invariant)(fieldDef.relation, "field must be a relation");
     if (!fieldDef.relation.fields || !fieldDef.relation.references) {
       return table;
     }
@@ -6659,7 +6690,7 @@ function valueToPromise(thing) {
 __name(valueToPromise, "valueToPromise");
 
 // src/client/result-processor.ts
-var import_common_helpers13 = require("@zenstackhq/common-helpers");
+var import_common_helpers15 = require("@zenstackhq/common-helpers");
 var import_decimal2 = __toESM(require("decimal.js"), 1);
 var import_ts_pattern19 = require("ts-pattern");
 var ResultProcessor = class {
@@ -6759,14 +6790,14 @@ var ResultProcessor = class {
     if (value instanceof import_decimal2.default) {
       return value;
     }
-    (0, import_common_helpers13.invariant)(typeof value === "string" || typeof value === "number" || value instanceof import_decimal2.default, `Expected string, number or Decimal, got ${typeof value}`);
+    (0, import_common_helpers15.invariant)(typeof value === "string" || typeof value === "number" || value instanceof import_decimal2.default, `Expected string, number or Decimal, got ${typeof value}`);
     return new import_decimal2.default(value);
   }
   transformBigInt(value) {
     if (typeof value === "bigint") {
       return value;
     }
-    (0, import_common_helpers13.invariant)(typeof value === "string" || typeof value === "number", `Expected string or number, got ${typeof value}`);
+    (0, import_common_helpers15.invariant)(typeof value === "string" || typeof value === "number", `Expected string or number, got ${typeof value}`);
     return BigInt(value);
   }
   transformBoolean(value) {
@@ -6810,7 +6841,7 @@ var ResultProcessor = class {
   }
   transformJson(value) {
     return (0, import_ts_pattern19.match)(this.schema.provider.type).with("sqlite", () => {
-      (0, import_common_helpers13.invariant)(typeof value === "string", "Expected string, got " + typeof value);
+      (0, import_common_helpers15.invariant)(typeof value === "string", "Expected string, got " + typeof value);
       return JSON.parse(value);
     }).otherwise(() => value);
   }
@@ -6844,15 +6875,15 @@ var ClientImpl = class _ClientImpl {
     if (baseClient) {
       this.kyselyProps = {
         ...baseClient.kyselyProps,
-        executor: executor ?? new ZenStackQueryExecutor(this, baseClient.kyselyProps.driver, baseClient.kyselyProps.dialect.createQueryCompiler(), baseClient.kyselyProps.dialect.createAdapter(), new import_kysely16.DefaultConnectionProvider(baseClient.kyselyProps.driver))
+        executor: executor ?? new ZenStackQueryExecutor(this, baseClient.kyselyProps.driver, baseClient.kyselyProps.dialect.createQueryCompiler(), baseClient.kyselyProps.dialect.createAdapter(), new import_kysely17.DefaultConnectionProvider(baseClient.kyselyProps.driver))
       };
       this.kyselyRaw = baseClient.kyselyRaw;
       this.auth = baseClient.auth;
     } else {
-      const driver = new ZenStackDriver(options.dialect.createDriver(), new import_kysely16.Log(this.$options.log ?? []));
+      const driver = new ZenStackDriver(options.dialect.createDriver(), new import_kysely17.Log(this.$options.log ?? []));
       const compiler = options.dialect.createQueryCompiler();
       const adapter = options.dialect.createAdapter();
-      const connectionProvider = new import_kysely16.DefaultConnectionProvider(driver);
+      const connectionProvider = new import_kysely17.DefaultConnectionProvider(driver);
       this.kyselyProps = {
         config: {
           dialect: options.dialect,
@@ -6862,12 +6893,12 @@ var ClientImpl = class _ClientImpl {
         driver,
         executor: executor ?? new ZenStackQueryExecutor(this, driver, compiler, adapter, connectionProvider)
       };
-      this.kyselyRaw = new import_kysely16.Kysely({
+      this.kyselyRaw = new import_kysely17.Kysely({
         ...this.kyselyProps,
-        executor: new import_kysely16.DefaultQueryExecutor(compiler, adapter, connectionProvider, [])
+        executor: new import_kysely17.DefaultQueryExecutor(compiler, adapter, connectionProvider, [])
       });
     }
-    this.kysely = new import_kysely16.Kysely(this.kyselyProps);
+    this.kysely = new import_kysely17.Kysely(this.kyselyProps);
     return createClientProxy(this);
   }
   get $qb() {
@@ -6887,13 +6918,18 @@ var ClientImpl = class _ClientImpl {
   }
   // implementation
   async $transaction(input, options) {
-    (0, import_common_helpers14.invariant)(typeof input === "function" || Array.isArray(input) && input.every((p) => p.then && p.cb), "Invalid transaction input, expected a function or an array of ZenStackPromise");
+    (0, import_common_helpers16.invariant)(typeof input === "function" || Array.isArray(input) && input.every((p) => p.then && p.cb), "Invalid transaction input, expected a function or an array of ZenStackPromise");
     if (typeof input === "function") {
       return this.interactiveTransaction(input, options);
     } else {
       return this.sequentialTransaction(input, options);
     }
   }
+  forceTransaction() {
+    if (!this.kysely.isTransaction) {
+      this.kysely = new import_kysely17.Transaction(this.kyselyProps);
+    }
+  }
   async interactiveTransaction(callback, options) {
     if (this.kysely.isTransaction) {
       return callback(this);
@@ -6998,7 +7034,7 @@ var ClientImpl = class _ClientImpl {
   }
   $executeRaw(query, ...values) {
     return createZenStackPromise(async () => {
-      const result = await (0, import_kysely16.sql)(query, ...values).execute(this.kysely);
+      const result = await (0, import_kysely17.sql)(query, ...values).execute(this.kysely);
       return Number(result.numAffectedRows ?? 0);
     });
   }
@@ -7011,7 +7047,7 @@ var ClientImpl = class _ClientImpl {
   }
   $queryRaw(query, ...values) {
     return createZenStackPromise(async () => {
-      const result = await (0, import_kysely16.sql)(query, ...values).execute(this.kysely);
+      const result = await (0, import_kysely17.sql)(query, ...values).execute(this.kysely);
       return result.rows;
     });
   }
@@ -7023,7 +7059,7 @@ var ClientImpl = class _ClientImpl {
     });
   }
   createRawCompiledQuery(query, values) {
-    const q = import_kysely16.CompiledQuery.raw(query, values);
+    const q = import_kysely17.CompiledQuery.raw(query, values);
     return {
       ...q,
       $raw: true
@@ -7150,7 +7186,7 @@ function definePlugin(plugin) {
 __name(definePlugin, "definePlugin");
 
 // src/client/index.ts
-var import_kysely17 = require("kysely");
+var import_kysely18 = require("kysely");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   InputValidationError,