@memberjunction/core-entities-server 6.2.0-edge.5 → 6.2.0-edge.6

package/dist/custom/MJDuplicateRunEntityServer.server.js

@@ -5,10 +5,42 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { BaseEntity, LogError, LogStatus, PotentialDuplicateRequest, RunView } from "@memberjunction/core";
-import { RegisterClass, GetGlobalObjectStore } from "@memberjunction/global";
+import { RegisterClass, GetGlobalObjectStore, EscapeSQLString, UUIDsEqual } from "@memberjunction/global";
 import { MJDuplicateRunEntity } from "@memberjunction/core-entities";
 import { DuplicateRecordDetector } from "@memberjunction/ai-vector-dupe";
 const PIPELINE_PROGRESS_TOPIC = 'PIPELINE_PROGRESS';
+/** Entity Document Type name of documents built for duplicate detection. */
+const RECORD_DUPLICATE_DOCUMENT_TYPE = 'Record Duplicate';
+/**
+ * Chooses the default entity document for a new duplicate run that was created without one, from
+ * the entity's active documents ordered newest-updated first. A 'Record Duplicate' document wins
+ * over any other type: an entity can also have a Search document (MJ ships one for several core
+ * entities), whose template and vectors are built for search, not for matching records. Without a
+ * 'Record Duplicate' document, the newest active document is used.
+ *
+ * Only callers that name no document get this default; the Duplicates tab always names the one
+ * the user picked.
+ *
+ * @param activeDocuments the entity's active documents, newest `__mj_UpdatedAt` first
+ * @returns the document to use, or null when there is none
+ */
+export function PickDuplicateDetectionDocument(activeDocuments) {
+    const recordDuplicate = activeDocuments.find(d => d.Type === RECORD_DUPLICATE_DOCUMENT_TYPE);
+    return recordDuplicate ?? activeDocuments[0] ?? null;
+}
+/**
+ * Checks that the entity document a run names belongs to the run's entity.
+ *
+ * @param entityDocument the run's document
+ * @param entityID the run's EntityID
+ * @returns why the document cannot be used, or null when it can
+ */
+export function CheckRunEntityDocument(entityDocument, entityID) {
+    if (!UUIDsEqual(entityDocument.EntityID, entityID)) {
+        return `Entity Document "${entityDocument.Name}" belongs to a different entity than this duplicate run`;
+    }
+    return null;
+}
 /**
  * Key under which we stash the "detection in flight" set in the MJ global object
  * store. Using the global store (rather than a plain module-level variable) keeps
@@ -40,13 +72,21 @@ function detectionInFlightSet() {
 const PHASE_TO_STAGE = {
     'Loading': 'extract',
     'Vectorizing': 'vectorize',
-    'Embedding': 'autotag',
+    'Embedding': 'extract',
     'Querying': 'extract',
     'Matching': 'autotag',
-    'Merging': 'complete'
+    'Merging': 'autotag'
 };
 let MJDuplicateRunEntityServer = class MJDuplicateRunEntityServer extends MJDuplicateRunEntity {
     async Save(options) {
+        // A run must name its entity document. Server-side callers that create a run without one
+        // (GetRecordDuplicates, scripts) get the entity's default duplicate-detection document.
+        if (!this.IsSaved && !this.EntityDocumentID) {
+            const defaultDocument = await this.findDefaultEntityDocument();
+            if (defaultDocument) {
+                this.EntityDocumentID = defaultDocument.ID;
+            }
+        }
         const saveResult = await super.Save(options);
         // Only kick off detection on the INITIAL save of an unfinished run, and never
         // while a detection pass for this run is already in flight. The detector saves
@@ -68,7 +108,7 @@ let MJDuplicateRunEntityServer = class MJDuplicateRunEntityServer extends MJDupl
     }
     /**
      * Run duplicate detection asynchronously. On failure, updates the run's
-     * ProcessingStatus to 'Error' so the UI can surface the problem.
+     * ProcessingStatus to 'Failed' with ProcessingErrorMessage so the UI can surface the problem.
      */
     async runDetectionAsync() {
         const startTime = Date.now();
@@ -81,23 +121,15 @@ let MJDuplicateRunEntityServer = class MJDuplicateRunEntityServer extends MJDupl
             const request = new PotentialDuplicateRequest();
             request.EntityID = this.EntityID;
             request.ListID = this.SourceListID || undefined; // Optional — if not set, scans all entity records
-            // Find the first active entity document for this entity to get template/thresholds
-            const rv = new RunView(this.RunViewProviderToUse);
-            const edResult = await rv.RunView({
-                EntityName: 'MJ: Entity Documents',
-                ExtraFilter: `EntityID='${this.EntityID}' AND Status='Active'`,
-                MaxRows: 1,
-                ResultType: 'entity_object'
-            }, this.ContextCurrentUser);
-            if (edResult.Success && edResult.Results.length > 0) {
-                request.EntityDocumentID = edResult.Results[0].ID;
-            }
+            // The run's entity document supplies the template, vectors and thresholds.
+            const entityDocument = await this.loadRunEntityDocument();
+            request.EntityDocumentID = entityDocument.ID;
             // Build detection options with threshold normalization.
-            // Entity document defaults are 1.0 (100%) which means nothing ever matches.
-            // Normalize to sensible fallbacks when the stored value is effectively unconfigured.
-            const potentialThreshold = this.normalizeThreshold(edResult.Success && edResult.Results.length > 0 ? edResult.Results[0].PotentialMatchThreshold : 1.0, 0.70 // fallback: 70% for potential matches
+            // A threshold left at 1.0 (100%) matches nothing, so treat it as unconfigured and use
+            // the fallback instead.
+            const potentialThreshold = this.normalizeThreshold(entityDocument.PotentialMatchThreshold, 0.70 // fallback: 70% for potential matches
             );
-            const absoluteThreshold = this.normalizeThreshold(edResult.Success && edResult.Results.length > 0 ? edResult.Results[0].AbsoluteMatchThreshold : 1.0, 0.95 // fallback: 95% for absolute matches
+            const absoluteThreshold = this.normalizeThreshold(entityDocument.AbsoluteMatchThreshold, 0.95 // fallback: 95% for absolute matches
             );
             const detectionOptions = {
                 DuplicateRunID: this.ID,
@@ -109,19 +141,25 @@ let MJDuplicateRunEntityServer = class MJDuplicateRunEntityServer extends MJDupl
             };
             request.Options = detectionOptions;
             // Publish initial progress
-            this.publishPipelineNotification('autotag', 0, 0, 0, startTime, 'Starting duplicate detection...');
-            await detector.GetDuplicateRecords(request, this.ContextCurrentUser);
+            this.publishPipelineNotification('extract', 0, 0, 0, startTime, 'Starting duplicate detection...');
+            const response = await detector.GetDuplicateRecords(request, this.ContextCurrentUser);
+            if (response.Status === 'Error') {
+                throw new Error(response.ErrorMessage || 'Duplicate detection failed');
+            }
             LogStatus(`Duplicate detection completed for run ${this.ID}`);
             // Publish completion
             this.publishPipelineNotification('complete', 100, 100, 100, startTime);
         }
         catch (error) {
-            LogError(`Duplicate detection error for run ${this.ID}`, undefined, error);
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            LogError(`Duplicate detection error for run ${this.ID}: ${errorMsg}`, undefined, error);
             // Publish error
-            this.publishPipelineNotification('error', 0, 0, 0, startTime, String(error));
+            this.publishPipelineNotification('error', 0, 0, 0, startTime, errorMsg);
             // Update the run record to reflect the error
             try {
+                await this.Load(this.ID);
                 this.ProcessingStatus = 'Failed';
+                this.ProcessingErrorMessage = errorMsg;
                 this.EndedAt = new Date();
                 await super.Save();
             }
@@ -130,6 +168,48 @@ let MJDuplicateRunEntityServer = class MJDuplicateRunEntityServer extends MJDupl
             }
         }
     }
+    /**
+     * The entity's default duplicate-detection document (see {@link PickDuplicateDetectionDocument}),
+     * or null when the entity has no active document.
+     */
+    async findDefaultEntityDocument() {
+        const rv = new RunView(this.RunViewProviderToUse);
+        const result = await rv.RunView({
+            EntityName: 'MJ: Entity Documents',
+            ExtraFilter: `EntityID='${EscapeSQLString(this.EntityID)}' AND Status='Active'`,
+            OrderBy: '__mj_UpdatedAt DESC',
+            ResultType: 'entity_object'
+        }, this.ContextCurrentUser);
+        if (!result.Success) {
+            LogError(`Duplicate run: could not load entity documents for entity ${this.EntityID}: ${result.ErrorMessage}`);
+            return null;
+        }
+        return PickDuplicateDetectionDocument(result.Results);
+    }
+    /**
+     * Loads the entity document this run names. Throws when it is missing or belongs to another
+     * entity, which fails the run with that message.
+     */
+    async loadRunEntityDocument() {
+        const rv = new RunView(this.RunViewProviderToUse);
+        const result = await rv.RunView({
+            EntityName: 'MJ: Entity Documents',
+            ExtraFilter: `ID='${EscapeSQLString(this.EntityDocumentID)}'`,
+            ResultType: 'entity_object'
+        }, this.ContextCurrentUser);
+        if (!result.Success) {
+            throw new Error(`Could not load Entity Document ${this.EntityDocumentID}: ${result.ErrorMessage}`);
+        }
+        const entityDocument = result.Results[0];
+        if (!entityDocument) {
+            throw new Error(`Entity Document ${this.EntityDocumentID} was not found`);
+        }
+        const problem = CheckRunEntityDocument(entityDocument, this.EntityID);
+        if (problem) {
+            throw new Error(problem);
+        }
+        return entityDocument;
+    }
     /**
      * Convert a DuplicateDetectionProgress callback into a PipelineProgress notification.
      */

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

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

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

@@ -0,0 +1,73 @@
+import { EntitySaveOptions, ValidationResult } from "@memberjunction/core";
+import { MJEntityAlternateBaseViewEntity } from "@memberjunction/core-entities";
+/**
+ * Server-side entity subclass for `MJ: Entity Alternate Base Views`.
+ *
+ * Enforces:
+ * - Immutability of `EntityID` on existing saved records
+ * - Logical `Name` format (`IsValidAlternateBaseViewName` — non-empty, no `|`, `:`, or leading `//`)
+ * - Physical `ViewName` and optional `SchemaName` identifier format (`IsValidSQLIdentifier`)
+ * - Same-entity logical `Name` uniqueness
+ * - Cross-entity `(EffectiveSchemaName, ViewName)` uniqueness against every entity's
+ *   `BaseView`, `BaseTable`, and registered `AlternateBaseViews` (D13)
+ * - Same-entity `ParentID` hierarchy validation and cycle detection (D15)
+ * - Live database row and physical SQL view existence verification in `ValidateAsync`
+ * - Automatic AST inference of `ParentID` on save when `ParentID` is unset and
+ *   the view's SQL definition references a single sibling alternate base view on the same entity (D15)
+ */
+export declare class MJEntityAlternateBaseViewEntityServer extends MJEntityAlternateBaseViewEntity {
+    Validate(): ValidationResult;
+    ValidateAsync(): Promise<ValidationResult>;
+    Save(options?: EntitySaveOptions): Promise<boolean>;
+    private validateEntityIDImmutability;
+    /**
+     * Validates `Name`, `ViewName`, and optional `SchemaName` using zero-dependency
+     * validators from `@memberjunction/core`.
+     */
+    private validateNameAndIdentifiers;
+    /**
+     * Validates:
+     * 1. Same-entity logical `Name` uniqueness
+     * 2. Cross-entity `(EffectiveSchemaName, ViewName)` uniqueness against every entity's
+     *    `BaseView`, `BaseTable`, and registered `AlternateBaseViews` (D13)
+     */
+    private validateUniquenessAndCollisions;
+    private checkSameEntityLogicalNameDuplicate;
+    private checkCrossEntityPhysicalCollision;
+    private checkExistingAlternateViewCollisionsOnEntity;
+    /**
+     * Validates `ParentID` (when set):
+     * - Cannot self-reference (`ParentID === ID`)
+     * - Parent must exist and belong to the same `EntityID`
+     * - Parent chain must be acyclic
+     */
+    private validateParentHierarchy;
+    private checkCrossEntityParentOwner;
+    private checkParentChainForCycle;
+    /**
+     * Queries `MJ: Entity Alternate Base Views` with `BypassCache: true` so uniqueness,
+     * cross-entity collision, and `ParentID` hierarchy checks also catch rows created
+     * since the last metadata refresh.
+     */
+    private validateAgainstLiveDatabaseRows;
+    private checkLiveDatabaseRowsForConflicts;
+    /**
+     * When `Status` is `'Active'` or `'Deprecated'` and a database provider is active, verifies
+     * that the physical SQL view exists in the database catalog.
+     */
+    private validatePhysicalViewExistsIfUsable;
+    /**
+     * Queries the database catalog for the SQL definition of `EffectiveSchemaName.ViewName`
+     * when running against a database provider, then invokes `TryAutoPopulateParentIDFromAST`.
+     */
+    private resolveAndPopulateParentIDFromDatabase;
+    /**
+     * Inspects `viewDefinitionSQL` with `SQLParser.ExtractTableRefs` and, if the SQL
+     * references exactly one sibling alternate base view on the same entity (without creating
+     * a cycle), automatically populates `this.ParentID`.
+     */
+    TryAutoPopulateParentIDFromAST(viewDefinitionSQL: string): void;
+    private findMatchingSiblingsInTableRefs;
+    private wouldCreateCycle;
+}
+//# sourceMappingURL=MJEntityAlternateBaseViewEntityServer.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MJEntityAlternateBaseViewEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJEntityAlternateBaseViewEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,iBAAiB,EAQjB,gBAAgB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAchF;;;;;;;;;;;;;;GAcG;AACH,qBACa,qCAAsC,SAAQ,+BAA+B;IACtE,QAAQ,IAAI,gBAAgB;IAiCtB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAkB1C,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBzE,OAAO,CAAC,4BAA4B;IAapC;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IAoBvC,OAAO,CAAC,mCAAmC;IAoB3C,OAAO,CAAC,iCAAiC;IA+BzC,OAAO,CAAC,4CAA4C;IAwBpD;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,2BAA2B;IAoBnC,OAAO,CAAC,wBAAwB;IA6BhC;;;;OAIG;YACW,+BAA+B;IA8C7C,OAAO,CAAC,iCAAiC;IAkDzC;;;OAGG;YACW,kCAAkC;IAsChD;;;OAGG;YACW,sCAAsC;IAuCpD;;;;OAIG;IACI,8BAA8B,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAkCtE,OAAO,CAAC,+BAA+B;IA0BvC,OAAO,CAAC,gBAAgB;CAoB3B"}