velocious 1.0.705 → 1.0.706

package/package.json

@@ -3,7 +3,7 @@
     "velocious": "build/bin/velocious.js"
   },
   "name": "velocious",
-  "version": "1.0.705",
+  "version": "1.0.706",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "files": [

package/src/database/record/auditing.js

@@ -420,14 +420,18 @@ function modelParamKey(modelClass) {
  * Table detection and relationship registration happen lazily on first usage.
  * Called synchronously from Model.audited() at module-load time.
  * @param {AuditedModelClass} modelClass - Model class to audit.
+ * @param {{except?: string[]}} [options] - Audit options: `except` lists attribute names never written to the audit trail (e.g. high-frequency telemetry columns).
  * @returns {void}
  */
-function registerAuditing(modelClass) {
+function registerAuditing(modelClass, options = {}) {
   if (Object.prototype.hasOwnProperty.call(modelClass, "_auditLifecycleCallbacksRegistered") && modelClass._auditLifecycleCallbacksRegistered) {
     return
   }
 
-  modelClass._auditLifecycleCallbacksRegistered = true
+  const auditableModelClass = /** @type {AuditedModelClass & {_auditExcludedAttributes?: Set<string>}} */ (modelClass)
+
+  auditableModelClass._auditLifecycleCallbacksRegistered = true
+  auditableModelClass._auditExcludedAttributes = new Set(options.except || [])
   registerAuditRelationship(modelClass)
   modelClass.beforeCreate("captureCreateAuditChanges")
   modelClass.afterCreate("createCreateAudit")
@@ -801,10 +805,18 @@ function auditChangesForCurrentChanges(record) {
   const changes = record.changes()
   /** @type {AuditChanges} */
   const auditedChanges = {}
-  const columnNameToAttributeName = record.getModelClass().getColumnNameToAttributeNameMap()
+  const modelClass = /** @type {AuditedModelClass & {_auditExcludedAttributes?: Set<string>}} */ (record.getModelClass())
+  const columnNameToAttributeName = modelClass.getColumnNameToAttributeNameMap()
+  const excludedAttributes = modelClass._auditExcludedAttributes
 
   for (const [attributeName, change] of Object.entries(changes)) {
-    auditedChanges[columnNameToAttributeName[attributeName] || attributeName] = change[1]
+    const auditedAttributeName = columnNameToAttributeName[attributeName] || attributeName
+
+    if (excludedAttributes && (excludedAttributes.has(auditedAttributeName) || excludedAttributes.has(attributeName))) {
+      continue
+    }
+
+    auditedChanges[auditedAttributeName] = change[1]
   }
 
   return auditedChanges

package/src/database/record/index.js

@@ -734,10 +734,11 @@ class VelociousDatabaseRecord {
 
   /**
    * Enables automatic create/update/destroy auditing for this model.
+   * @param {{except?: string[]}} [options] - Audit options: `except` lists attribute names that must never be written to the audit trail. Use it for high-frequency telemetry columns (heartbeats, progress counters) whose write volume turns the audit table into a deadlock partner for the parent row.
    * @returns {void}
    */
-  static audited() {
-    registerAuditing(this)
+  static audited(options = {}) {
+    registerAuditing(this, options)
   }
 
   /**