@memberjunction/core-entities-server 6.1.0-edge.1 → 6.1.0-edge.3

package/dist/custom/MJMaterializedResultEntityServer.server.js

@@ -0,0 +1,64 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseEntity, BaseEntityResult, LogError, RunView } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { MJMaterializedResultEntity } from '@memberjunction/core-entities';
+/**
+ * Server-side `MJ: Materialized Results` entity. Removes the `MJ: Materialized Result Queries` join row(s)
+ * that reference this materialization BEFORE the row itself is deleted.
+ *
+ * The join FKs deliberately have NO `ON DELETE CASCADE` (the MaterializedResult↔Query cascade is kept at the
+ * application layer so a physical snapshot is never silently dropped by the DB engine). When a *Query* is
+ * deleted, the generated `spDeleteQuery` already cascades its join row; this override covers the REVERSE
+ * direction — deleting the MaterializedResult directly — which would otherwise surface a raw
+ * `FK_MaterializedResultQuery_MaterializedResult` violation. FK-cleanup-before-delete pattern
+ * (guides/BASE_ENTITY_SERVER_PATTERNS.md).
+ *
+ * Out of scope here (tracked as follow-ups): dropping the physical `materialized_vw<…>` snapshot table/view on
+ * delete, and whether deleting a source Query should cascade-delete or block on its materialization — both
+ * involve DDL on the delete path and a cascade-vs-block semantics decision.
+ */
+let MJMaterializedResultEntityServer = class MJMaterializedResultEntityServer extends MJMaterializedResultEntity {
+    async Delete(options) {
+        if (this.IsSaved) {
+            const md = this.ProviderToUse;
+            const rv = RunView.FromMetadataProvider(md);
+            const links = await rv.RunView({
+                EntityName: 'MJ: Materialized Result Queries',
+                ExtraFilter: `MaterializedResultID='${this.ID.replace(/'/g, "''")}'`,
+                ResultType: 'entity_object',
+            }, this.ContextCurrentUser);
+            if (!links.Success) {
+                return this.failDelete(`Failed to load linked MaterializedResultQuery rows: ${links.ErrorMessage ?? 'unknown error'}`);
+            }
+            for (const link of links.Results ?? []) {
+                const deleted = await link.Delete();
+                if (!deleted) {
+                    return this.failDelete(`Failed to delete linked MaterializedResultQuery ${link.ID}: ${link.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+            }
+        }
+        return super.Delete(options);
+    }
+    /** Records a delete failure on the result history and returns false (Delete does not throw on a logical failure). */
+    failDelete(message) {
+        LogError(`MJMaterializedResultEntityServer.Delete: ${message}`);
+        const result = new BaseEntityResult();
+        result.StartedAt = new Date();
+        result.Success = false;
+        result.Type = 'delete';
+        result.Message = message;
+        result.EndedAt = new Date();
+        this.RegisterResultHistoryEntry(result);
+        return false;
+    }
+};
+MJMaterializedResultEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Materialized Results')
+], MJMaterializedResultEntityServer);
+export { MJMaterializedResultEntityServer };
+//# sourceMappingURL=MJMaterializedResultEntityServer.server.js.map

package/dist/custom/MJMaterializedResultEntityServer.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MJMaterializedResultEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJMaterializedResultEntityServer.server.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAA0C,QAAQ,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/H,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAmC,MAAM,+BAA+B,CAAC;AAE5G;;;;;;;;;;;;;;GAcG;AAEI,IAAM,gCAAgC,GAAtC,MAAM,gCAAiC,SAAQ,0BAA0B;IAC5D,KAAK,CAAC,MAAM,CAAC,OAA6B;QACtD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,EAAE,GAAG,IAAI,CAAC,aAA6C,CAAC;YAC9D,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAC1B;gBACI,UAAU,EAAE,iCAAiC;gBAC7C,WAAW,EAAE,yBAAyB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG;gBACpE,UAAU,EAAE,eAAe;aAC9B,EACD,IAAI,CAAC,kBAAkB,CAC1B,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,IAAI,CAAC,UAAU,CAAC,uDAAuD,KAAK,CAAC,YAAY,IAAI,eAAe,EAAE,CAAC,CAAC;YAC3H,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,UAAU,CAAC,mDAAmD,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,YAAY,EAAE,eAAe,IAAI,eAAe,EAAE,CAAC,CAAC;gBACnJ,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,qHAAqH;IAC7G,UAAU,CAAC,OAAe;QAC9B,QAAQ,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;QACvB,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,MAAM,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ,CAAA;AAtCY,gCAAgC;IAD5C,aAAa,CAAC,UAAU,EAAE,0BAA0B,CAAC;GACzC,gCAAgC,CAsC5C"}

package/dist/custom/MJRecordProcessEntityServer.server.d.ts

@@ -6,7 +6,11 @@
  * definition is the single source of truth — editing it keeps its schedule in sync, no separate
  * Scheduled Job management.
  *
- * (On-change reconciliation — owning an Entity Action — is a separate follow-up; see the plan §18.)
+ * It also owns the **on-change** trigger the same way: `OnChangeEnabled` reconciles an Entity Action
+ * binding on the process's target entity, and `OnChangeFilter` compiles into that binding's Action
+ * Filter — which is what those two columns have always claimed to do. The substrate work lives in
+ * `RecordProcessOnChangeReconciler` so this class stays a dispatcher rather than growing a second
+ * hundred-line reconciler inside `Save()`.
  * @module @memberjunction/core-entities-server
  */
 import { EntitySaveOptions } from '@memberjunction/core';
@@ -45,8 +49,19 @@ export declare class MJRecordProcessEntityServer extends MJRecordProcessEntity {
      * save — the record itself is valid; a reconciliation error is logged for the operator.
      */
     Save(options?: EntitySaveOptions): Promise<boolean>;
-    /** True when any field affecting the owned Scheduled Job is dirty (fast-path before save). */
-    private scheduleFieldsDirty;
+    /**
+     * Runs one reconciliation without letting it fail the save.
+     *
+     * The record itself is valid and already persisted; a substrate error is an operator problem,
+     * not a reason to reject the user's edit. Each trigger is wrapped separately so a failure in one
+     * cannot skip the other — a process whose schedule reconciliation broke should still get its
+     * on-change binding.
+     */
+    private reconcileSafely;
+    /** True when any of the named fields is dirty (fast-path, read before the save clears them). */
+    private anyFieldDirty;
+    /** Ensures the owned Entity Action binding matches the process's on-change settings. */
+    private reconcileOnChangeBinding;
     /** Ensures the owned Scheduled Job matches the process's current schedule state. */
     private reconcileScheduledJob;
     /** Resolves the "Run Record Process" Scheduled Job Type ID, or throws if the seed is absent. */

package/dist/custom/MJRecordProcessEntityServer.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MJRecordProcessEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJRecordProcessEntityServer.server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAEH,iBAAiB,EAKpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAkD,MAAM,+BAA+B,CAAC;AAQtH,wGAAwG;AACxG,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,cAAc,CAEnI;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CAC3B,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CASzH;AAED,qBACa,2BAA4B,SAAQ,qBAAqB;IAClE;;;;OAIG;IACmB,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAazE,8FAA8F;IAC9F,OAAO,CAAC,mBAAmB;IAI3B,oFAAoF;YACtE,qBAAqB;IAcnC,gGAAgG;YAClF,gBAAgB;IAa9B,4FAA4F;YAC9E,YAAY;IAgB1B,yFAAyF;YAC3E,eAAe;IA4B7B,iFAAiF;YACnE,mBAAmB;CAUpC"}
+{"version":3,"file":"MJRecordProcessEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJRecordProcessEntityServer.server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAEH,iBAAiB,EAKpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAkD,MAAM,+BAA+B,CAAC;AAkBtH,wGAAwG;AACxG,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,cAAc,CAEnI;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CAC3B,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CASzH;AAED,qBACa,2BAA4B,SAAQ,qBAAqB;IAClE;;;;OAIG;IACmB,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBzE;;;;;;;OAOG;YACW,eAAe;IAW7B,gGAAgG;IAChG,OAAO,CAAC,aAAa;IAIrB,wFAAwF;YAC1E,wBAAwB;IAOtC,oFAAoF;YACtE,qBAAqB;IAcnC,gGAAgG;YAClF,gBAAgB;IAa9B,4FAA4F;YAC9E,YAAY;IAgB1B,yFAAyF;YAC3E,eAAe;IA4B7B,iFAAiF;YACnE,mBAAmB;CAUpC"}

package/dist/custom/MJRecordProcessEntityServer.server.js

@@ -6,7 +6,11 @@
  * definition is the single source of truth — editing it keeps its schedule in sync, no separate
  * Scheduled Job management.
  *
- * (On-change reconciliation — owning an Entity Action — is a separate follow-up; see the plan §18.)
+ * It also owns the **on-change** trigger the same way: `OnChangeEnabled` reconciles an Entity Action
+ * binding on the process's target entity, and `OnChangeFilter` compiles into that binding's Action
+ * Filter — which is what those two columns have always claimed to do. The substrate work lives in
+ * `RecordProcessOnChangeReconciler` so this class stays a dispatcher rather than growing a second
+ * hundred-line reconciler inside `Save()`.
  * @module @memberjunction/core-entities-server
  */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
@@ -18,10 +22,19 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { RegisterClass, SafeJSONParse, UUIDsEqual } from '@memberjunction/global';
 import { BaseEntity, LogError, RunView, } from '@memberjunction/core';
 import { MJRecordProcessEntity } from '@memberjunction/core-entities';
+import { ReconcileRecordProcessOnChange } from './RecordProcessOnChangeReconciler.js';
 /** The `MJ: Scheduled Job Types.Name` seeded for record-process recurrence (metadata-driven). */
 const RUN_RECORD_PROCESS_JOB_TYPE = 'Run Record Process';
 /** Fields whose change can affect the owned Scheduled Job — reconcile only when one is dirty. */
 const SCHEDULE_RELEVANT_FIELDS = ['ScheduleEnabled', 'CronExpression', 'Timezone', 'Status', 'Name'];
+/**
+ * Fields whose change can affect the owned Entity Action binding.
+ *
+ * `EntityID` is in the list because the binding is anchored to it: repointing a process at a
+ * different entity while its old binding still fires would leave the process running against
+ * records it no longer describes.
+ */
+const ON_CHANGE_RELEVANT_FIELDS = ['OnChangeEnabled', 'OnChangeInvocationType', 'OnChangeFilter', 'Status', 'EntityID'];
 /**
  * PURE decision (exported for tests): a process owns an *active* recurrence job only when it is
  * `Active`, has `ScheduleEnabled`, and carries a non-empty `CronExpression`; otherwise the owned
@@ -48,21 +61,49 @@ let MJRecordProcessEntityServer = class MJRecordProcessEntityServer extends MJRe
      * save — the record itself is valid; a reconciliation error is logged for the operator.
      */
     async Save(options) {
-        const shouldReconcile = !this.IsSaved || this.scheduleFieldsDirty();
+        // Both reads happen BEFORE the save, because saving resets every dirty flag — asking
+        // afterwards would report that nothing changed and reconcile nothing, forever.
+        const isNew = !this.IsSaved;
+        const reconcileSchedule = isNew || this.anyFieldDirty(SCHEDULE_RELEVANT_FIELDS);
+        const reconcileOnChange = isNew || this.anyFieldDirty(ON_CHANGE_RELEVANT_FIELDS);
         const saved = await super.Save(options);
-        if (saved && shouldReconcile) {
-            try {
-                await this.reconcileScheduledJob();
-            }
-            catch (e) {
-                LogError(`MJRecordProcessEntityServer: schedule reconciliation failed for '${this.Name}' (${this.ID}): ${e instanceof Error ? e.message : String(e)}`);
-            }
+        if (!saved)
+            return saved;
+        if (reconcileSchedule) {
+            await this.reconcileSafely('schedule', () => this.reconcileScheduledJob());
+        }
+        if (reconcileOnChange) {
+            await this.reconcileSafely('on-change', () => this.reconcileOnChangeBinding());
         }
         return saved;
     }
-    /** True when any field affecting the owned Scheduled Job is dirty (fast-path before save). */
-    scheduleFieldsDirty() {
-        return SCHEDULE_RELEVANT_FIELDS.some((f) => this.GetFieldByName(f)?.Dirty ?? false);
+    /**
+     * Runs one reconciliation without letting it fail the save.
+     *
+     * The record itself is valid and already persisted; a substrate error is an operator problem,
+     * not a reason to reject the user's edit. Each trigger is wrapped separately so a failure in one
+     * cannot skip the other — a process whose schedule reconciliation broke should still get its
+     * on-change binding.
+     */
+    async reconcileSafely(label, work) {
+        try {
+            await work();
+        }
+        catch (e) {
+            LogError(`MJRecordProcessEntityServer: ${label} reconciliation failed for '${this.Name}' (${this.ID}): ` +
+                `${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    /** True when any of the named fields is dirty (fast-path, read before the save clears them). */
+    anyFieldDirty(fields) {
+        return fields.some((f) => this.GetFieldByName(f)?.Dirty ?? false);
+    }
+    /** Ensures the owned Entity Action binding matches the process's on-change settings. */
+    async reconcileOnChangeBinding() {
+        await ReconcileRecordProcessOnChange(this, {
+            Provider: this.ProviderToUse,
+            ContextUser: this.ContextCurrentUser,
+        });
     }
     /** Ensures the owned Scheduled Job matches the process's current schedule state. */
     async reconcileScheduledJob() {

package/dist/custom/MJRecordProcessEntityServer.server.js.map

@@ -1 +1 @@
-{"version":3,"file":"MJRecordProcessEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJRecordProcessEntityServer.server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MJRecordProcessEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJRecordProcessEntityServer.server.ts"],"names":[],"mappings":"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"}

package/dist/custom/MJVectorIndexEntityServer.server.d.ts

@@ -33,8 +33,15 @@ export declare class MJVectorIndexEntityServer extends MJVectorIndexEntity {
      */
     private getVectorDBInstance;
     /**
-     * Resolve embedding dimensions from the associated AI model.
-     * Default to 1536 (OpenAI text-embedding-3-small) if not determinable.
+     * Resolve the embedding dimensions to create the provider index at.
+     *
+     * Prefers this index's own `Dimensions` column, which is where the operator states it and what the
+     * embedding call already honors. Falling straight through to 1536 ignored that column entirely, so
+     * an index for any other model was created at the wrong width — harmless with providers that don't
+     * enforce it, and fatal with ones that do: a colocated SQL Server index is a `VECTOR(n)` column, and
+     * inserting 384-dimension vectors into a `VECTOR(1536)` is rejected outright.
+     *
+     * 1536 (OpenAI text-embedding-3-small) remains the fallback for records that never set it.
      */
     private resolveDimensions;
     /**

package/dist/custom/MJVectorIndexEntityServer.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MJVectorIndexEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJVectorIndexEntityServer.server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAA0B,MAAM,+BAA+B,CAAC;AAI5F;;;;GAIG;AACH,qBACa,yBAA0B,SAAQ,mBAAmB;IAC9D;;OAEG;IACmB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAa9C;;OAEG;IACmB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAShD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;YACW,qBAAqB;IAuCnC;;OAEG;YACW,uBAAuB;IAkBrC;;;OAGG;YACW,mBAAmB;IAmCjC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;YACW,oBAAoB;CAiCrC"}
+{"version":3,"file":"MJVectorIndexEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJVectorIndexEntityServer.server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAA0B,MAAM,+BAA+B,CAAC;AAI5F;;;;GAIG;AACH,qBACa,yBAA0B,SAAQ,mBAAmB;IAC9D;;OAEG;IACmB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAa9C;;OAEG;IACmB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAShD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;YACW,qBAAqB;IAuCnC;;OAEG;YACW,uBAAuB;IAkBrC;;;OAGG;YACW,mBAAmB;IAgDjC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;YACW,oBAAoB;CAiCrC"}

package/dist/custom/MJVectorIndexEntityServer.server.js

@@ -143,21 +143,39 @@ let MJVectorIndexEntityServer = class MJVectorIndexEntityServer extends MJVector
             LogError(`VectorDatabase "${vectorDB.Name}" has no ClassKey configured`);
             return null;
         }
+        // Instantiate BEFORE gating on the key, then wire the host connection. A colocated provider
+        // (SQLServerVectorDatabase, pgvector) stores vectors in this same database: it has no
+        // credentials to present, and it throws "requires a host connection" unless the active data
+        // provider is handed to it. Neither is knowable until the instance exists. Same ordering as
+        // the EntityDocument and ContentSource vectorization pipelines.
+        // The sentinel is required: `VectorDBBase`'s constructor rejects an empty key and colocated
+        // providers do not override it, so '' would throw for the very case this supports.
         const apiKey = GetAIAPIKey(classKey);
-        if (!apiKey) {
+        const instance = MJGlobal.Instance.ClassFactory.CreateInstance(VectorDBBase, classKey, apiKey || 'colocated');
+        if (!instance) {
+            LogError(`Failed to create vector DB instance for "${classKey}"`);
+            return null;
+        }
+        instance.TryWireColocatedHost(this.ProviderToUse);
+        if (!instance.SupportsColocatedQuery && instance.RequiresAPIKey && !apiKey) {
             LogError(`No API key found for vector DB provider "${classKey}"`);
             return null;
         }
-        return MJGlobal.Instance.ClassFactory.CreateInstance(VectorDBBase, classKey, apiKey);
+        return instance;
     }
     /**
-     * Resolve embedding dimensions from the associated AI model.
-     * Default to 1536 (OpenAI text-embedding-3-small) if not determinable.
+     * Resolve the embedding dimensions to create the provider index at.
+     *
+     * Prefers this index's own `Dimensions` column, which is where the operator states it and what the
+     * embedding call already honors. Falling straight through to 1536 ignored that column entirely, so
+     * an index for any other model was created at the wrong width — harmless with providers that don't
+     * enforce it, and fatal with ones that do: a colocated SQL Server index is a `VECTOR(n)` column, and
+     * inserting 384-dimension vectors into a `VECTOR(1536)` is rejected outright.
+     *
+     * 1536 (OpenAI text-embedding-3-small) remains the fallback for records that never set it.
      */
     resolveDimensions() {
-        // TODO: Look up the embedding model's dimension count from metadata
-        // For now, default to 1536 which covers most common embedding models
-        return 1536;
+        return this.Dimensions ?? 1536;
     }
     /**
      * After provider creates the index, save the returned metadata back to our record.

package/dist/custom/MJVectorIndexEntityServer.server.js.map

@@ -1 +1 @@
-{"version":3,"file":"MJVectorIndexEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJVectorIndexEntityServer.server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MJVectorIndexEntityServer.server.js","sourceRoot":"","sources":["../../src/custom/MJVectorIndexEntityServer.server.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAY,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAA0B,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAA2C,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;GAIG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,mBAAmB;IAC9D;;OAEG;IACa,KAAK,CAAC,IAAI;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC;QACrC,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAEtC,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,qBAAqB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACzC,QAAQ,CAAC,2BAA2B,IAAI,CAAC,IAAI,yBAAyB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAC9F,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,UAAU,CAAC;IACtB,CAAC;IAED;;OAEG;IACa,KAAK,CAAC,MAAM;QACxB,oFAAoF;QACpF,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACjD,QAAQ,CAAC,2BAA2B,IAAI,CAAC,IAAI,6DAA6D,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAClI,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,IAAY;QAClC,iGAAiG;QACjG,IAAI,SAAS,GAAG,IAAI;aACf,WAAW,EAAE;aACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;aACvB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;aAC1B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAO,4BAA4B;aACtD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAK,gCAAgC;QAEhE,IAAI,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,kGAAkG,CAAC,CAAC;QAC3I,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,QAAQ,CAAC,0DAA0D,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC5F,OAAO;QACX,CAAC;QAED,0FAA0F;QAC1F,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,SAAS,CAAC,8BAA8B,IAAI,CAAC,IAAI,SAAS,aAAa,wCAAwC,CAAC,CAAC;QACrH,CAAC;QAED,MAAM,MAAM,GAAsB;YAC9B,EAAE,EAAE,aAAa;YACjB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE;YACnC,MAAM,EAAE,QAAgC;YACxC,gBAAgB,EAAE;gBACd,UAAU,EAAE;oBACR,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,WAAW;iBACtB;aACJ;SACJ,CAAC;QAEF,SAAS,CAAC,mBAAmB,aAAa,4BAA4B,CAAC,CAAC;QACxE,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,SAAS,CAAC,UAAU,aAAa,oCAAoC,CAAC,CAAC;gBACvE,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;YACxE,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,2CAA2C,aAAa,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7F,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,QAAQ,CAAC,mCAAmC,aAAa,yBAAyB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAC1G,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,uBAAuB;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,QAAQ,CAAC,0DAA0D,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC5F,OAAO;QACX,CAAC;QAED,6FAA6F;QAC7F,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,SAAS,CAAC,mBAAmB,iBAAiB,8BAA8B,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACrE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS,CAAC,UAAU,iBAAiB,yBAAyB,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,2CAA2C,iBAAiB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjG,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mBAAmB;QAC7B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAyB;YACpD,UAAU,EAAE,sBAAsB;YAClC,WAAW,EAAE,OAAO,IAAI,CAAC,gBAAgB,GAAG;YAC5C,UAAU,EAAE,eAAe;SAC9B,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,QAAQ,CAAC,0BAA0B,IAAI,CAAC,gBAAgB,YAAY,CAAC,CAAC;YACtE,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,QAAQ,CAAC,mBAAmB,QAAQ,CAAC,IAAI,8BAA8B,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,4FAA4F;QAC5F,sFAAsF;QACtF,4FAA4F;QAC5F,4FAA4F;QAC5F,gEAAgE;QAChE,4FAA4F;QAC5F,mFAAmF;QACnF,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAC1D,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,WAAW,CAChD,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,QAAQ,CAAC,4CAA4C,QAAQ,GAAG,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,sBAAsB,IAAI,QAAQ,CAAC,cAAc,IAAI,CAAC,MAAM,EAAE,CAAC;YACzE,QAAQ,CAAC,4CAA4C,QAAQ,GAAG,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;;;;;;;OAUG;IACK,iBAAiB;QACrB,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IACnC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,oBAAoB,CAC9B,cAAmD,EACnD,MAAyB,EACzB,aAAqB;QAErB,IAAI,CAAC;YACD,qEAAqE;YACrE,IAAI,CAAC,UAAU,GAAG,aAAa,CAAC,CAAC,0CAA0C;YAC3E,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;YACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAE5B,yDAAyD;YACzD,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC;YAC7C,CAAC;YACD,IAAI,cAAc,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;gBACvD,wDAAwD;gBACxD,IAAI,MAAM,IAAI,cAAc;oBAAE,MAAM,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;gBACtE,IAAI,QAAQ,IAAI,cAAc;oBAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YAChF,CAAC;YACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAE7C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,KAAK,EAAE,CAAC;gBACR,SAAS,CAAC,sCAAsC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,+CAA+C,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;YACjH,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,QAAQ,CAAC,6CAA6C,IAAI,CAAC,IAAI,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAC1F,CAAC;IACL,CAAC;CACJ,CAAA;AA7NY,yBAAyB;IADrC,aAAa,CAAC,UAAU,EAAE,oBAAoB,CAAC;GACnC,yBAAyB,CA6NrC"}

package/dist/custom/RecordProcessOnChangeReconciler.d.ts

@@ -0,0 +1,42 @@
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { MJRecordProcessEntity } from '@memberjunction/core-entities';
+/** The Action an on-change binding dispatches to. Exists already; this only binds to it. */
+export declare const RUN_RECORD_PROCESS_ACTION = "Run Record Process";
+/**
+ * Turns the record that changed into the action's `Scope` parameter.
+ *
+ * Evaluated per-invocation as an `EntityActionParam` of ValueType `Script`, because the whole point
+ * of an on-change trigger is that the record differs every time — a Static value would pin the
+ * binding to whichever record happened to be open when it was configured.
+ *
+ * `ToConcatenatedString()` and not `ToString()`: `RecordRef.RecordID` is documented as the primary
+ * key "serialized to a composite-key-safe string", which is that format. `ToString()` is a display
+ * format and would silently fail to resolve a composite key.
+ */
+export declare const ON_CHANGE_SCOPE_SCRIPT: string;
+/**
+ * Whether a process should own an *active* on-change binding.
+ *
+ * Pure and exported so the decision is testable without a database. An invocation type is required
+ * rather than defaulted: guessing `AfterUpdate` would produce a trigger firing on an event the
+ * author never chose, and on the wrong one there is no error — only runs nobody expected.
+ */
+export declare function decideOnChangeAction(p: {
+    status: string;
+    onChangeEnabled: boolean;
+    onChangeInvocationType: string | null;
+}): 'upsert' | 'disable';
+/** Everything the reconciler needs from its caller. */
+export type OnChangeReconcileContext = {
+    Provider: IMetadataProvider;
+    ContextUser: UserInfo;
+};
+/**
+ * Brings a Record Process's owned Entity Action binding in line with its on-change settings.
+ *
+ * Turning the trigger off **disables** the binding rather than deleting it, matching how the
+ * schedule reconciler treats its owned job: the row carries the history of what this process used to
+ * fire on, and a trigger someone switched off by mistake should be recoverable.
+ */
+export declare function ReconcileRecordProcessOnChange(process: MJRecordProcessEntity, context: OnChangeReconcileContext): Promise<void>;
+//# sourceMappingURL=RecordProcessOnChangeReconciler.d.ts.map

package/dist/custom/RecordProcessOnChangeReconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordProcessOnChangeReconciler.d.ts","sourceRoot":"","sources":["../../src/custom/RecordProcessOnChangeReconciler.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAqB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EASH,qBAAqB,EACxB,MAAM,+BAA+B,CAAC;AAGvC,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,QAEsD,CAAC;AAE1F;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;IACzB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC,GAAG,QAAQ,GAAG,SAAS,CAEvB;AAED,uDAAuD;AACvD,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,QAAQ,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAChD,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/custom/RecordProcessOnChangeReconciler.js

@@ -0,0 +1,247 @@
+/**
+ * @fileoverview Reconciles a Record Process's **on-change** trigger onto the Entity Action rows the
+ * save pipeline already reads.
+ *
+ * `RecordProcess.OnChangeEnabled` has described this since the column shipped — *"the process runs
+ * per-record on save via an owned Entity Action"* — and `OnChangeFilter` promised to *"compile into
+ * the owned Entity Action Filter"*. Neither owned anything: the schedule trigger reconciled and the
+ * change trigger was a flag that read as configured and did nothing. That is the worst shape for a
+ * trigger to be in, because the UI shows it enabled and no run ever appears.
+ *
+ * Split out of the entity subclass rather than added to it because the schedule reconciliation is
+ * already a hundred lines of the same shape and a single `Save()` override owning both would be the
+ * kind of method nobody can safely change. Both call sites stay in the subclass; the substrate work
+ * lives here.
+ *
+ * **Nothing here is new machinery.** `HandleEntityActions` has fired entity actions from the save
+ * pipeline all along, `Run Record Process` is an existing action, and `ActionFilter` evaluation with
+ * the change context landed with transition filters. What was missing was rows.
+ *
+ * @module @memberjunction/core-entities-server
+ */
+import { BuildChangeFilterCode } from '@memberjunction/actions-base';
+import { LogError, RunView } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+/** The Action an on-change binding dispatches to. Exists already; this only binds to it. */
+export const RUN_RECORD_PROCESS_ACTION = 'Run Record Process';
+/**
+ * Turns the record that changed into the action's `Scope` parameter.
+ *
+ * Evaluated per-invocation as an `EntityActionParam` of ValueType `Script`, because the whole point
+ * of an on-change trigger is that the record differs every time — a Static value would pin the
+ * binding to whichever record happened to be open when it was configured.
+ *
+ * `ToConcatenatedString()` and not `ToString()`: `RecordRef.RecordID` is documented as the primary
+ * key "serialized to a composite-key-safe string", which is that format. `ToString()` is a display
+ * format and would silently fail to resolve a composite key.
+ */
+export const ON_CHANGE_SCOPE_SCRIPT = "EntityActionContext.result = JSON.stringify({ Kind: 'records', " +
+    'RecordIDs: [EntityActionContext.entityObject.PrimaryKey.ToConcatenatedString()] });';
+/**
+ * Whether a process should own an *active* on-change binding.
+ *
+ * Pure and exported so the decision is testable without a database. An invocation type is required
+ * rather than defaulted: guessing `AfterUpdate` would produce a trigger firing on an event the
+ * author never chose, and on the wrong one there is no error — only runs nobody expected.
+ */
+export function decideOnChangeAction(p) {
+    return p.status === 'Active' && p.onChangeEnabled && !!p.onChangeInvocationType ? 'upsert' : 'disable';
+}
+/**
+ * Brings a Record Process's owned Entity Action binding in line with its on-change settings.
+ *
+ * Turning the trigger off **disables** the binding rather than deleting it, matching how the
+ * schedule reconciler treats its owned job: the row carries the history of what this process used to
+ * fire on, and a trigger someone switched off by mistake should be recoverable.
+ */
+export async function ReconcileRecordProcessOnChange(process, context) {
+    const action = decideOnChangeAction({
+        status: process.Status,
+        onChangeEnabled: process.OnChangeEnabled,
+        onChangeInvocationType: process.OnChangeInvocationType,
+    });
+    const existing = await findOwnedEntityAction(process, context);
+    if (action === 'disable') {
+        if (existing && existing.Status !== 'Disabled') {
+            existing.Status = 'Disabled';
+            if (!(await existing.Save())) {
+                throw new Error(`failed disabling the on-change binding: ${existing.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+        }
+        return;
+    }
+    const actionRow = await resolveAction(context);
+    const invocationTypeID = await resolveInvocationTypeID(process.OnChangeInvocationType, context);
+    const binding = existing ?? await context.Provider.GetEntityObject('MJ: Entity Actions', context.ContextUser);
+    if (!existing) {
+        binding.NewRecord();
+        binding.EntityID = process.EntityID;
+        binding.ActionID = actionRow.ID;
+    }
+    binding.Status = 'Active';
+    if (!(await binding.Save())) {
+        throw new Error(`failed saving the on-change binding: ${binding.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+    }
+    // The invocation type is reconciled as a set, not edited in place: switching from AfterUpdate to
+    // AfterCreate must leave the process firing on exactly one event. Editing the existing row would
+    // work; leaving the old one Active alongside a new one would double-fire, which is the failure
+    // this replaces rather than risks.
+    await reconcileInvocation(binding.ID, invocationTypeID, context);
+    await upsertActionParam(binding.ID, actionRow.ID, 'RecordProcessID', 'Static', process.ID, context);
+    await upsertActionParam(binding.ID, actionRow.ID, 'Scope', 'Script', ON_CHANGE_SCOPE_SCRIPT, context);
+    await reconcileFilter(binding.ID, process.OnChangeFilter, context);
+}
+/**
+ * The binding this process owns, if it has one.
+ *
+ * Matched on the `RecordProcessID` param rather than on entity + action, because `Run Record Process`
+ * is one shared action: every process watching a given entity would otherwise collide on the same
+ * pair, and reusing that row means rewriting its `RecordProcessID` — silently repointing the first
+ * process's trigger at the second process's definition, with the first still looking configured.
+ */
+async function findOwnedEntityAction(process, context) {
+    const rv = RunView.FromMetadataProvider(context.Provider);
+    const candidates = await rv.RunView({
+        EntityName: 'MJ: Entity Actions',
+        ExtraFilter: `EntityID='${process.EntityID}'`,
+        ResultType: 'entity_object',
+    }, context.ContextUser);
+    const rows = candidates.Results ?? [];
+    if (rows.length === 0)
+        return null;
+    const params = await rv.RunView({
+        EntityName: 'MJ: Entity Action Params',
+        ExtraFilter: `ActionParam='RecordProcessID' AND EntityActionID IN (${rows.map((r) => `'${r.ID}'`).join(',')})`,
+        ResultType: 'entity_object',
+    }, context.ContextUser);
+    const mine = (params.Results ?? []).find((p) => p.Value != null && UUIDsEqual(p.Value, process.ID));
+    return mine ? rows.find((r) => UUIDsEqual(r.ID, mine.EntityActionID)) ?? null : null;
+}
+/** Resolves the `Run Record Process` action, or says plainly that the seed is missing. */
+async function resolveAction(context) {
+    const result = await RunView.FromMetadataProvider(context.Provider).RunView({ EntityName: 'MJ: Actions', ExtraFilter: `Name='${RUN_RECORD_PROCESS_ACTION}'`, ResultType: 'entity_object' }, context.ContextUser);
+    const action = result.Results?.[0];
+    if (!action) {
+        throw new Error(`the '${RUN_RECORD_PROCESS_ACTION}' action is not present — has the metadata seed been pushed?`);
+    }
+    return action;
+}
+/** Resolves the invocation type the process named. */
+async function resolveInvocationTypeID(name, context) {
+    const result = await RunView.FromMetadataProvider(context.Provider).RunView({ EntityName: 'MJ: Entity Action Invocation Types', ExtraFilter: `Name='${name}'`, ResultType: 'simple' }, context.ContextUser);
+    const row = result.Results?.[0];
+    if (!row)
+        throw new Error(`entity action invocation type '${name}' is not seeded`);
+    return row.ID;
+}
+/** Makes the named invocation the only active one on this binding. */
+async function reconcileInvocation(entityActionID, invocationTypeID, context) {
+    const result = await RunView.FromMetadataProvider(context.Provider).RunView({
+        EntityName: 'MJ: Entity Action Invocations',
+        ExtraFilter: `EntityActionID='${entityActionID}'`,
+        ResultType: 'entity_object',
+    }, context.ContextUser);
+    let found = false;
+    for (const row of result.Results ?? []) {
+        const wanted = UUIDsEqual(row.InvocationTypeID, invocationTypeID);
+        found ||= wanted;
+        const status = wanted ? 'Active' : 'Disabled';
+        if (row.Status !== status) {
+            row.Status = status;
+            if (!(await row.Save())) {
+                LogError(`RecordProcess on-change: could not set invocation ${row.ID} to ${status}: ` +
+                    `${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+        }
+    }
+    if (found)
+        return;
+    const row = await context.Provider.GetEntityObject('MJ: Entity Action Invocations', context.ContextUser);
+    row.NewRecord();
+    row.EntityActionID = entityActionID;
+    row.InvocationTypeID = invocationTypeID;
+    row.Status = 'Active';
+    if (!(await row.Save())) {
+        throw new Error(`failed creating the on-change invocation: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+    }
+}
+/** Finds or creates one Entity Action Param binding for the on-change trigger. */
+async function upsertActionParam(entityActionID, actionID, paramName, valueType, value, context) {
+    const rv = RunView.FromMetadataProvider(context.Provider);
+    const paramResult = await rv.RunView({
+        EntityName: 'MJ: Action Params',
+        ExtraFilter: `ActionID='${actionID}' AND Name='${paramName}'`,
+        ResultType: 'entity_object',
+    }, context.ContextUser);
+    const actionParam = paramResult.Results?.[0];
+    if (!actionParam) {
+        throw new Error(`the '${RUN_RECORD_PROCESS_ACTION}' action has no ${paramName} parameter to bind`);
+    }
+    const existingResult = await rv.RunView({
+        EntityName: 'MJ: Entity Action Params',
+        ExtraFilter: `EntityActionID='${entityActionID}' AND ActionParamID='${actionParam.ID}'`,
+        ResultType: 'entity_object',
+    }, context.ContextUser);
+    const existing = existingResult.Results?.[0];
+    const row = existing ?? await context.Provider.GetEntityObject('MJ: Entity Action Params', context.ContextUser);
+    if (!existing)
+        row.NewRecord();
+    row.EntityActionID = entityActionID;
+    row.ActionParamID = actionParam.ID;
+    row.ValueType = valueType;
+    row.Value = value;
+    if (!(await row.Save())) {
+        throw new Error(`failed binding ${paramName} to the on-change trigger: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+    }
+}
+/**
+ * Compiles `OnChangeFilter` into the owned Action Filter, exactly as the column documents.
+ *
+ * Shares `BuildChangeFilterCode` with the workflow trigger, so `DidFieldChangeToValue('Status',
+ * 'Approved')` means the same thing in both places — a user who learned one surface has learned the
+ * other. Clearing the filter disables the binding rather than deleting the row, so the expression
+ * survives a mis-click.
+ */
+async function reconcileFilter(entityActionID, filter, context) {
+    const rv = RunView.FromMetadataProvider(context.Provider);
+    const bindingResult = await rv.RunView({
+        EntityName: 'MJ: Entity Action Filters',
+        ExtraFilter: `EntityActionID='${entityActionID}'`,
+        OrderBy: 'Sequence ASC',
+        ResultType: 'entity_object',
+    }, context.ContextUser);
+    const binding = bindingResult.Results?.[0] ?? null;
+    const expression = filter?.trim() ?? '';
+    if (!expression) {
+        if (binding && binding.Status !== 'Disabled') {
+            binding.Status = 'Disabled';
+            if (!(await binding.Save())) {
+                throw new Error(`failed clearing the on-change filter: ${binding.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+        }
+        return;
+    }
+    const filterRow = await context.Provider.GetEntityObject('MJ: Action Filters', context.ContextUser);
+    if (!binding?.ActionFilterID || !(await filterRow.Load(binding.ActionFilterID))) {
+        filterRow.NewRecord();
+    }
+    filterRow.Code = BuildChangeFilterCode(expression);
+    filterRow.UserDescription = expression;
+    filterRow.CodeExplanation =
+        "Generated from a Record Process's OnChangeFilter. Evaluated against the record change that fired the " +
+            'trigger; the process runs for that record only when it is true.';
+    if (!(await filterRow.Save())) {
+        throw new Error(`failed saving the on-change filter: ${filterRow.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+    }
+    const row = binding ?? await context.Provider.GetEntityObject('MJ: Entity Action Filters', context.ContextUser);
+    if (!binding)
+        row.NewRecord();
+    row.EntityActionID = entityActionID;
+    row.ActionFilterID = filterRow.ID;
+    row.Sequence = 1;
+    row.Status = 'Active';
+    if (!(await row.Save())) {
+        throw new Error(`failed binding the on-change filter: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+    }
+}
+//# sourceMappingURL=RecordProcessOnChangeReconciler.js.map