velocious 1.0.568 → 1.0.570

package/build/database/query/model-class-query.js

@@ -24,7 +24,7 @@ import WhereParser from "../query-parser/where-parser.js"
 /**
  * Defines this typedef.
  * @template {typeof import("../record/index.js").default} [MC=typeof import("../record/index.js").default]
- * @typedef {import("./index.js").QueryArgsType & {modelClass: MC, joinBasePath?: string[], joinTracker?: import("./join-tracker.js").default, forceQualifyBaseTable?: boolean, withCount?: import("./with-count.js").WithCountEntry[], queryData?: import("./query-data.js").QueryDataEntry[]}} ModelClassQueryArgsType
+ * @typedef {import("./index.js").QueryArgsType & {modelClass: MC, joinBasePath?: string[], joinTracker?: import("./join-tracker.js").default, forceQualifyBaseTable?: boolean, withCount?: import("./with-count.js").WithCountEntry[], queryData?: import("./query-data.js").QueryDataEntry[], operation?: import("../operation.js").default}} ModelClassQueryArgsType
  */
 /**
  * Runs unquote sql identifier.
@@ -200,6 +200,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
     this._joinBasePath = args.joinBasePath || []
     this._joinTracker = args.joinTracker || new JoinTracker({modelClass: this.modelClass})
     this._forceQualifyBaseTable = Boolean(args.forceQualifyBaseTable)
+    this._operation = args.operation
 
     /**
      * Narrows the runtime value to the documented type.
@@ -240,7 +241,8 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
       joinTracker: this._joinTracker.clone(),
       forceQualifyBaseTable: this._forceQualifyBaseTable,
       withCount: [...this._withCount],
-      queryData: [...this._queryData]
+      queryData: [...this._queryData],
+      operation: this._operation
     }))
 
     // @ts-expect-error
@@ -723,7 +725,11 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
    * @returns {VelociousDatabaseQueryModelClassQuery<MC>} - The scoped join query.
    */
   buildJoinScopeQuery(targetModelClass, joinPath) {
-    const scopedQuery = /** @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (targetModelClass._newQuery())
+    const scopedQuery = /** @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (
+      this._operation
+        ? this._operation.forModel(targetModelClass)
+        : targetModelClass._newQuery()
+    )
 
     scopedQuery._joinTracker = this._joinTracker
     scopedQuery._joinBasePath = joinPath
@@ -864,8 +870,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
 
     if (record) return record
 
-    const ModelClass = this.getModelClass()
-    const newRecord = /** @type {InstanceType<MC>} */ (new ModelClass(conditions))
+    const newRecord = this.build(conditions)
 
     if (callback) {
       callback(newRecord)
@@ -874,6 +879,33 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
     return newRecord
   }
 
+  /**
+   * Builds a record owned by the query's operation, when present.
+   * @param {Record<string, ?>} [attributes] - Initial attributes.
+   * @returns {InstanceType<MC>} - Built record.
+   */
+  build(attributes = {}) {
+    const ModelClass = this.getModelClass()
+    const record = /** @type {InstanceType<MC>} */ (new ModelClass(attributes))
+
+    if (this._operation) this._operation.bindRecord(record)
+
+    return record
+  }
+
+  /**
+   * Creates a record owned by the query's operation, when present.
+   * @param {Record<string, ?>} [attributes] - Initial attributes.
+   * @returns {Promise<InstanceType<MC>>} - Created record.
+   */
+  async create(attributes = {}) {
+    const record = this.build(attributes)
+
+    await record.save()
+
+    return record
+  }
+
   /**
    * Runs first.
    * @returns {Promise<InstanceType<MC> | null>} - Resolves with the first.
@@ -917,8 +949,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
     const results = await this.results()
 
     for (const result of results) {
-      const ModelClass = this.getModelClass()
-      const model = /** @type {InstanceType<MC>} */ (new ModelClass())
+      const model = this.build()
 
       model.loadExistingRecord(result)
       models.push(model)

package/build/database/query/preloader/belongs-to.js

@@ -2,6 +2,7 @@
 
 import ensureModelClassInitialized from "./ensure-model-class-initialized.js"
 import PreloaderSelection from "./selection.js"
+import preloadQueryForModel from "./query-for-model.js"
 import restArgsError from "../../../utils/rest-args-error.js"
 
 export default class VelociousDatabaseQueryPreloaderBelongsTo {
@@ -94,7 +95,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
       whereArgs[primaryKey] = [...foreignKeyValues]
 
       // Load target models to be preloaded on the given models
-      let query = targetModelClass.where(whereArgs)
+      let query = preloadQueryForModel(modelsToLoad, targetModelClass).where(whereArgs)
 
       query = this.relationship.applyScope(query)
       query = this.selection.applyToQuery({query, targetModelClass, mappingColumns: [primaryKey]})
@@ -211,7 +212,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
       whereArgs[primaryKey] = [...foreignKeyValuesByType[targetType]]
 
-      let query = targetModelClass.where(whereArgs)
+      let query = preloadQueryForModel(this.models, targetModelClass).where(whereArgs)
 
       query = this.relationship.applyScope(query)
       query = this.selection.applyToQuery({query, targetModelClass, mappingColumns: [primaryKey]})

package/build/database/query/preloader/has-many.js

@@ -2,6 +2,7 @@
 
 import ensureModelClassInitialized from "./ensure-model-class-initialized.js"
 import PreloaderSelection from "./selection.js"
+import preloadQueryForModel from "./query-for-model.js"
 import restArgsError from "../../../utils/rest-args-error.js"
 
 /**
@@ -155,7 +156,7 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
     }
 
     // Step 1: Query the through table to build parent→target ID mapping
-    const throughModels = await throughModelClass
+    const throughModels = await preloadQueryForModel(modelsToLoad, throughModelClass)
       .where({[throughForeignKey]: [...modelsPrimaryKeyValues]})
       .toArray()
 
@@ -186,7 +187,7 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
     let targetModels = []
 
     if (allTargetIds.size > 0) {
-      let query = targetModelClass.where({[targetForeignKey]: [...allTargetIds]})
+      let query = preloadQueryForModel(modelsToLoad, targetModelClass).where({[targetForeignKey]: [...allTargetIds]})
 
       query = this.relationship.applyScope(query)
       query = this.selection.applyToQuery({query, targetModelClass, mappingColumns: [targetForeignKey]})
@@ -299,7 +300,7 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
 
     await ensureModelClassInitialized(targetModelClass, this.relationship.getConfiguration())
 
-    let query = targetModelClass.where(whereArgs)
+    let query = preloadQueryForModel(modelsToLoad, targetModelClass).where(whereArgs)
 
     query = this.relationship.applyScope(query)
     query = this.selection.applyToQuery({query, targetModelClass, mappingColumns: [foreignKey]})

package/build/database/query/preloader/has-one.js

@@ -2,6 +2,7 @@
 
 import ensureModelClassInitialized from "./ensure-model-class-initialized.js"
 import PreloaderSelection from "./selection.js"
+import preloadQueryForModel from "./query-for-model.js"
 import restArgsError from "../../../utils/rest-args-error.js"
 
 export default class VelociousDatabaseQueryPreloaderHasOne {
@@ -87,7 +88,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
     await ensureModelClassInitialized(targetModelClass, this.relationship.getConfiguration())
 
     // Load target models to be preloaded on the given models
-    let query = targetModelClass.where(whereArgs)
+    let query = preloadQueryForModel(this.models, targetModelClass).where(whereArgs)
 
     query = this.relationship.applyScope(query)
     query = this.selection.applyToQuery({query, targetModelClass, mappingColumns: [foreignKey]})

package/build/database/query/preloader/query-for-model.js

@@ -0,0 +1,17 @@
+// @ts-check
+
+/**
+ * Builds a target query preserving the explicit database operation owned by
+ * the source records.
+ * @template {typeof import("../../record/index.js").default} MC
+ * @param {import("../../record/index.js").default[]} models - Source records.
+ * @param {MC} ModelClass - Target model class.
+ * @returns {import("../model-class-query.js").default<MC>} - Target query.
+ */
+export default function preloadQueryForModel(models, ModelClass) {
+  const sourceModel = models[0]
+
+  if (!sourceModel) throw new Error("Cannot build a preload query without source records")
+
+  return sourceModel.queryForModel(ModelClass)
+}

package/build/database/query/query-data.js

@@ -190,7 +190,15 @@ export async function runQueryData({rootModelClass, rootModels, entries}) {
 
   const primaryKey = rootModelClass.primaryKey()
   const rootIds = rootModels.map((model) => /** @type {string | number} */ (model.readColumn(primaryKey)))
-  const preparedEntries = entries.map((entry, entryIndex) => prepareEntry({entry, entryIndex, primaryKey, rootIds, rootModelClass}))
+  const sourceModel = rootModels[0]
+  const preparedEntries = entries.map((entry, entryIndex) => prepareEntry({
+    entry,
+    entryIndex,
+    primaryKey,
+    rootIds,
+    rootModelClass,
+    sourceModel
+  }))
   /**
    * Compatible query groups.
    * @type {Array<{aliases: Set<string>, query: import("./model-class-query.js").default, signature: string}>} */
@@ -231,9 +239,10 @@ export async function runQueryData({rootModelClass, rootModels, entries}) {
  * @param {string} args.primaryKey - Root model primary key column.
  * @param {Array<string | number>} args.rootIds - Root primary-key values.
  * @param {typeof import("../record/index.js").default} args.rootModelClass - Root model class.
+ * @param {import("../record/index.js").default} args.sourceModel - Loaded operation owner.
  * @returns {{aliases: string[], query: import("./model-class-query.js").default, signature: string}} - Prepared entry.
  */
-function prepareEntry({entry, entryIndex, primaryKey, rootIds, rootModelClass}) {
+function prepareEntry({entry, entryIndex, primaryKey, rootIds, rootModelClass, sourceModel}) {
   const targetModelClass = resolveTargetModelClass(rootModelClass, entry.chain)
   const fn = targetModelClass.getQueryDataByName(entry.fnName)
 
@@ -242,7 +251,7 @@ function prepareEntry({entry, entryIndex, primaryKey, rootIds, rootModelClass})
       `Declare it with ${targetModelClass.name}.queryData(${JSON.stringify(entry.fnName)}, ({query, tableName}) => query.select(...))`)
   }
 
-  const query = rootModelClass._newQuery()
+  const query = sourceModel.queryForModel(rootModelClass)
 
   // Empty out any defaults the query factory added — queryData runs
   // a bare aggregate, not a full model load.

package/build/database/query/with-count.js

@@ -111,10 +111,11 @@ export async function runWithCount({models, modelClass, entries}) {
 
   const primaryKey = modelClass.primaryKey()
   const parentIds = models.map((model) => /** @type {string | number} */ (model.readColumn(primaryKey)))
+  const sourceModel = models[0]
   const queryGroups = new Map()
 
   for (const entry of entries) {
-    const countQuery = queryForEntry({entry, modelClass, parentIds})
+    const countQuery = queryForEntry({entry, modelClass, parentIds, sourceModel})
     const sql = countQuery.toSql()
     const existingGroup = queryGroups.get(sql)
 
@@ -138,9 +139,10 @@ export async function runWithCount({models, modelClass, entries}) {
  * @param {WithCountEntry} args.entry - Entry being evaluated.
  * @param {typeof import("../record/index.js").default} args.modelClass - Parent model class.
  * @param {Array<string | number>} args.parentIds - Primary keys of the loaded parents.
+ * @param {import("../record/index.js").default} args.sourceModel - Loaded operation owner.
  * @returns {import("./model-class-query.js").default} - Prepared count query.
  */
-function queryForEntry({entry, modelClass, parentIds}) {
+function queryForEntry({entry, modelClass, parentIds, sourceModel}) {
   const relationship = modelClass.getRelationshipByName(entry.relationshipName)
 
   if (!relationship) {
@@ -172,7 +174,7 @@ function queryForEntry({entry, modelClass, parentIds}) {
     Object.assign(whereConditions, entry.where)
   }
 
-  const baseQuery = targetModelClass._newQuery()
+  const baseQuery = sourceModel.queryForModel(targetModelClass)
   baseQuery._forceQualifyBaseTable = true
   baseQuery.where(whereConditions)
 

package/build/database/record/acts-as-list.js

@@ -173,7 +173,7 @@ function assertPositivePosition({position, positionColumn, persisted = false}) {
  */
 async function placeMovedRecord({record, positionColumn, scope, scopeValue, position}) {
   const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
-  const connection = modelClass.connection()
+  const connection = record.connection()
   const tableSql = connection.quoteTable(modelClass._getTable().getName())
   const scopeCol = modelClass.getColumnNameForAttributeName(scope)
   const posCol = modelClass.getColumnNameForAttributeName(positionColumn)
@@ -224,7 +224,7 @@ function clearBelongsToChangeForScope(record) {
  */
 async function shiftPositionsUp({record, positionColumn, scope, fromPosition, toPosition, scopeValue, excludeRecordId}) {
   const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
-  const connection = modelClass.connection()
+  const connection = record.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
@@ -239,7 +239,8 @@ async function shiftPositionsUp({record, positionColumn, scope, fromPosition, to
   const quotedScope = connection.quote(resolvedScopeValue)
 
   // Load rows in descending order so we bump the highest first
-  let query = modelClass
+  let query = record
+    .queryForModel(modelClass)
     .select(modelClass.primaryKey())
     .select(positionColumn)
     .where({[scopeColumnName]: resolvedScopeValue})
@@ -289,7 +290,7 @@ async function shiftPositionsUp({record, positionColumn, scope, fromPosition, to
  */
 async function shiftPositionsDown({record, positionColumn, scope, fromPosition, toPosition, scopeValue}) {
   const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
-  const connection = modelClass.connection()
+  const connection = record.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
@@ -304,7 +305,8 @@ async function shiftPositionsDown({record, positionColumn, scope, fromPosition,
   const quotedScope = connection.quote(resolvedScopeValue)
 
   // Load rows in ascending order so we shift the lowest gap first
-  let query = modelClass
+  let query = record
+    .queryForModel(modelClass)
     .select(modelClass.primaryKey())
     .select(positionColumn)
     .where({[scopeColumnName]: resolvedScopeValue})
@@ -345,7 +347,7 @@ async function shiftPositionsDown({record, positionColumn, scope, fromPosition,
  */
 async function highestPositionInScope({record, positionColumn, scope, scopeValue}) {
   const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
-  const connection = modelClass.connection()
+  const connection = record.connection()
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
   const positionColumnName = modelClass.getColumnNameForAttributeName(positionColumn)
   const positionColumnSql = connection.quoteColumn(positionColumnName)
@@ -353,7 +355,8 @@ async function highestPositionInScope({record, positionColumn, scope, scopeValue
 
   if (resolvedScopeValue == null) return 0
 
-  const rows = await modelClass
+  const rows = await record
+    .queryForModel(modelClass)
     .select(positionColumn)
     .where({[scopeColumnName]: resolvedScopeValue})
     .order(`${positionColumnSql} DESC`)
@@ -415,7 +418,7 @@ function resolveScopeValue(record, scope) {
  */
 async function moveOutOfWay({record, positionColumn, scope, scopeValue}) {
   const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
-  const connection = modelClass.connection()
+  const connection = record.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
 

package/build/database/record/attachments/store.js

@@ -88,9 +88,10 @@ export default class RecordAttachmentsStore {
 
   /**
    * Runs ensure ready.
+   * @param {import("../index.js").default} [model] - Operation-owning model.
    * @returns {Promise<void>} - Resolves when schema is ready.
    */
-  async ensureReady() {
+  async ensureReady(model) {
     if (this._readyPromise) {
       await this._readyPromise
       return
@@ -124,7 +125,7 @@ export default class RecordAttachmentsStore {
         await db.createTable(table)
         this._driverColumnsAvailable = true
         this._contentBase64Nullable = true
-      })
+      }, model)
     })()
 
     try {
@@ -144,7 +145,7 @@ export default class RecordAttachmentsStore {
    * @returns {Promise<void>} - Resolves when complete.
    */
   async attach({input, model, name, replace}) {
-    await this.ensureReady()
+    await this.ensureReady(model)
     const attachmentsConfiguration = this.configuration.getAttachmentsConfiguration?.() || {}
     const allowPathInput = attachmentsConfiguration.allowPathInput === true
     const allowedPathPrefixes = Array.isArray(attachmentsConfiguration.allowedPathPrefixes)
@@ -298,7 +299,7 @@ export default class RecordAttachmentsStore {
         })
 
         rowPersisted = true
-      })
+      }, model)
     } catch (error) {
       if (!rowPersisted && storageKey && typeof attachmentDriver.delete === "function") {
         try {
@@ -435,7 +436,7 @@ export default class RecordAttachmentsStore {
    * @returns {Promise<Record<string, ?> | null>} - Attachment row.
    */
   async findOne({id, model, name}) {
-    await this.ensureReady()
+    await this.ensureReady(model)
 
     return await this._withDb(async (db) => {
       const recordType = model.getModelClass().getModelName()
@@ -455,7 +456,7 @@ export default class RecordAttachmentsStore {
       const rows = await query.results()
 
       return rows[0] || null
-    })
+    }, model)
   }
 
   /**
@@ -466,7 +467,7 @@ export default class RecordAttachmentsStore {
    * @returns {Promise<Array<Record<string, ?>>>} - Attachment rows.
    */
   async findMany({model, name}) {
-    await this.ensureReady()
+    await this.ensureReady(model)
 
     return await this._withDb(async (db) => {
       const recordType = model.getModelClass().getModelName()
@@ -479,7 +480,7 @@ export default class RecordAttachmentsStore {
         .order("created_at_ms ASC")
 
       return await query.results()
-    })
+    }, model)
   }
 
   /**
@@ -517,7 +518,7 @@ export default class RecordAttachmentsStore {
    * @returns {Promise<number>} - Number of attachments purged.
    */
   async purgeAll({model, name}) {
-    await this.ensureReady()
+    await this.ensureReady(model)
 
     return await this._withDb(async (db) => {
       const recordType = model.getModelClass().getModelName()
@@ -549,7 +550,7 @@ export default class RecordAttachmentsStore {
       }
 
       return rows.length
-    })
+    }, model)
   }
 
   /**
@@ -732,9 +733,12 @@ export default class RecordAttachmentsStore {
    * Runs with db.
    * @template T
    * @param {(db: import("../../../database/drivers/base.js").default) => Promise<T>} callback - Callback.
+   * @param {import("../index.js").default} [model] - Operation-owning model.
    * @returns {Promise<T>} - Callback result.
    */
-  async _withDb(callback) {
+  async _withDb(callback, model) {
+    if (model && model.databaseOperation()) return await callback(model.connection())
+
     const pool = this.configuration.getDatabasePool(this.databaseIdentifier)
     /**
      * Defines result.

package/build/database/record/auditing.js

@@ -148,18 +148,20 @@ function dedicatedAuditTableName(modelClass) {
  * Resolves audit table data for a model class. Cached per model.
  * Called lazily on first createAudit / withoutAudit / relationship usage.
  * @param {AuditedModelClass} modelClass - Audited model class.
+ * @param {import("../drivers/base.js").default} [connection] - Explicit record-owned connection.
  * @returns {Promise<AuditTableData>} Resolved audit table metadata.
  */
-async function resolveAuditTableData(modelClass) {
+async function resolveAuditTableData(modelClass, connection) {
   if (modelClass._auditTableResolved && modelClass._auditTableData) {
     return modelClass._auditTableData
   }
 
-  const tableData = await buildAuditTableData(modelClass)
+  const resolvedConnection = connection || modelClass.connection()
+  const tableData = await buildAuditTableData(modelClass, resolvedConnection)
   const configuration = modelClass._getConfiguration()
 
   tableData.auditClass.registerRecordClass({configuration})
-  await tableData.auditClass.initializeRecord({configuration})
+  await tableData.auditClass.initializeRecord({configuration, connection: resolvedConnection})
 
   modelClass._auditTableData = tableData
   modelClass._auditTableResolved = true
@@ -174,11 +176,12 @@ async function resolveAuditTableData(modelClass) {
  * registered Audit model for shared tables; falls back to a framework-owned
  * dynamic class.
  * @param {AuditedModelClass} modelClass - Audited model class.
+ * @param {import("../drivers/base.js").default} connection - Explicit record-owned connection.
  * @returns {Promise<AuditTableData>} Audit table metadata.
  */
-async function buildAuditTableData(modelClass) {
+async function buildAuditTableData(modelClass, connection) {
   const dedicatedTable = dedicatedAuditTableName(modelClass)
-  const dedicatedExists = await dedicatedTableExistsForConnection(modelClass, dedicatedTable)
+  const dedicatedExists = await dedicatedTableExistsForConnection(modelClass, dedicatedTable, connection)
 
   if (dedicatedExists) {
     const auditClass = dedicatedAuditClass(modelClass, dedicatedTable)
@@ -217,9 +220,10 @@ async function buildAuditTableData(modelClass) {
  * Checks whether a dedicated audit table exists for a model's connection.
  * @param {AuditedModelClass} modelClass - Audited model class.
  * @param {string} tableName - Dedicated audit table name to check.
+ * @param {import("../drivers/base.js").default} connection - Explicit record-owned connection.
  * @returns {Promise<boolean>} Whether the table exists.
  */
-async function dedicatedTableExistsForConnection(modelClass, tableName) {
+async function dedicatedTableExistsForConnection(modelClass, tableName, connection) {
   const databaseIdentifier = modelClass.getDatabaseIdentifier()
   const cacheKey = `${databaseIdentifier}:${tableName}`
   const cached = dedicatedTableCache.get(cacheKey)
@@ -228,7 +232,6 @@ async function dedicatedTableExistsForConnection(modelClass, tableName) {
     return cached
   }
 
-  const connection = modelClass.connection()
   const table = await connection.getTableByName(tableName, {throwError: false})
   const exists = Boolean(table)
 
@@ -546,11 +549,11 @@ async function createAudit(record, args) {
 async function createAuditWithCurrentConnection(record, args, modelClass) {
   if (!record.isPersisted()) throw new Error(`Cannot audit unpersisted ${modelClass.getModelName()} record`)
 
-  const tableData = await resolveAuditTableData(modelClass)
+  const db = record.connection()
+  const tableData = await resolveAuditTableData(modelClass, db)
   const action = normalizeAction(args.action)
   const auditedChanges = args.auditedChanges === undefined ? null : args.auditedChanges
   const params = args.params === undefined ? null : args.params
-  const db = modelClass.connection()
   const currentDate = new Date()
 
   const auditActionId = await findOrCreateLookupId({

package/build/database/record/counter-cache-magnitude.js

@@ -204,9 +204,11 @@ async function incrementParentCounter(record, definition, parentId, amount) {
     throw new Error(`magnitudeCounterCache on ${modelClass.getModelName()} could not resolve the "${definition.belongsTo}" parent model class`)
   }
 
-  // Update through the PARENT model's connection: the row being modified belongs
-  // to the parent, which may live on a different database/tenant than the child.
-  const db = parentModelClass.connection()
+  // Resolve through the record so an operation both owns the parent write and
+  // rejects a relationship whose parent routes to another database.
+  const db = record
+    .queryForModel(parentModelClass)
+    .driver
   const counterColumnSql = db.quoteColumn(definition.counterColumn)
   const truncatedAmount = Math.trunc(amount)