@memberjunction/integration-engine 0.0.1 → 5.8.0

package/dist/IntegrationOrchestrator.js

@@ -0,0 +1,548 @@
+import { CompositeKey, Metadata, RunView } from '@memberjunction/core';
+import { ClassifyError } from './types.js';
+import { ConnectorFactory } from './ConnectorFactory.js';
+import { FieldMappingEngine } from './FieldMappingEngine.js';
+import { MatchEngine } from './MatchEngine.js';
+import { WatermarkService } from './WatermarkService.js';
+/** Default batch size for fetching records from external systems */
+const DEFAULT_BATCH_SIZE = 200;
+/**
+ * Top-level orchestrator that runs an end-to-end integration sync.
+ * Coordinates connector, field mapping, match resolution, and entity persistence.
+ */
+export class IntegrationOrchestrator {
+    constructor() {
+        this.fieldMappingEngine = new FieldMappingEngine();
+        this.matchEngine = new MatchEngine();
+        this.watermarkService = new WatermarkService();
+        /** Configurable maximum batch size. Connector batches exceeding this are truncated. */
+        this.MaxBatchSize = DEFAULT_BATCH_SIZE;
+    }
+    /** In-process lock map to prevent concurrent syncs for the same CompanyIntegration */
+    static { this.activeSyncs = new Map(); }
+    /**
+     * Executes a full sync run for a company integration.
+     * If a sync is already running for the same integration, waits for it to finish
+     * and returns the existing result (concurrency lock).
+     *
+     * @param companyIntegrationID - ID of the CompanyIntegration to sync
+     * @param contextUser - User context for all data operations
+     * @param triggerType - What triggered this sync (defaults to 'Manual')
+     * @param onProgress - Optional callback invoked with progress updates during sync
+     * @param onNotification - Optional callback invoked with a notification when the sync completes or fails
+     * @returns Aggregate sync result with record counts and errors
+     */
+    async RunSync(companyIntegrationID, contextUser, triggerType = 'Manual', onProgress, onNotification) {
+        const lockKey = companyIntegrationID.toLowerCase();
+        const existing = IntegrationOrchestrator.activeSyncs.get(lockKey);
+        if (existing) {
+            console.warn(`[IntegrationOrchestrator] Sync already running for ${lockKey}, waiting...`);
+            return existing;
+        }
+        const syncPromise = this.executeSyncInternal(companyIntegrationID, contextUser, triggerType, onProgress, onNotification);
+        IntegrationOrchestrator.activeSyncs.set(lockKey, syncPromise);
+        try {
+            return await syncPromise;
+        }
+        finally {
+            IntegrationOrchestrator.activeSyncs.delete(lockKey);
+        }
+    }
+    /**
+     * Internal sync execution method. Contains the full orchestration logic.
+     */
+    async executeSyncInternal(companyIntegrationID, contextUser, triggerType, onProgress, onNotification) {
+        const config = await this.LoadRunConfiguration(companyIntegrationID, contextUser);
+        const run = await this.CreateRunRecord(config.companyIntegration, triggerType, contextUser);
+        try {
+            const result = await this.ExecuteEntityMaps(config, run, contextUser, onProgress);
+            await this.FinalizeRun(run, result, contextUser, onNotification);
+            return result;
+        }
+        catch (err) {
+            await this.FailRun(run, err, contextUser, onNotification);
+            throw err;
+        }
+    }
+    /**
+     * Loads all configuration needed for a sync run.
+     */
+    async LoadRunConfiguration(companyIntegrationID, contextUser) {
+        const rv = new RunView();
+        const [ciResult, entityMapsResult, integrationsResult, sourceTypesResult] = await rv.RunViews([
+            {
+                EntityName: 'MJ: Company Integrations',
+                ExtraFilter: `ID='${companyIntegrationID}'`,
+                MaxRows: 1,
+                ResultType: 'entity_object',
+            },
+            {
+                EntityName: 'MJ: Company Integration Entity Maps',
+                ExtraFilter: `CompanyIntegrationID='${companyIntegrationID}' AND SyncEnabled=1 AND Status='Active'`,
+                OrderBy: 'Priority ASC',
+                ResultType: 'entity_object',
+            },
+            {
+                EntityName: 'MJ: Integrations',
+                ExtraFilter: '',
+                ResultType: 'entity_object',
+            },
+            {
+                EntityName: 'MJ: Integration Source Types',
+                ExtraFilter: `Status='Active'`,
+                ResultType: 'entity_object',
+            },
+        ], contextUser);
+        const companyIntegration = ciResult.Results[0];
+        if (!companyIntegration) {
+            throw new Error(`CompanyIntegration not found: ${companyIntegrationID}`);
+        }
+        const integration = integrationsResult.Results
+            .find(i => i.Get('ID') === companyIntegration.IntegrationID);
+        if (!integration) {
+            throw new Error(`Integration not found for CompanyIntegration: ${companyIntegrationID}`);
+        }
+        const connector = ConnectorFactory.Resolve(integration, sourceTypesResult.Results);
+        return {
+            companyIntegration,
+            entityMaps: entityMapsResult.Results,
+            integration,
+            connector,
+        };
+    }
+    /**
+     * Creates a new CompanyIntegrationRun record to track this sync.
+     */
+    async CreateRunRecord(companyIntegration, triggerType, contextUser) {
+        const md = new Metadata();
+        const run = await md.GetEntityObject('MJ: Company Integration Runs', contextUser);
+        run.NewRecord();
+        run.CompanyIntegrationID = companyIntegration.Get('ID');
+        run.RunByUserID = contextUser.ID;
+        run.StartedAt = new Date();
+        run.Status = 'In Progress';
+        run.TotalRecords = 0;
+        run.ConfigData = JSON.stringify({ triggerType });
+        const saved = await run.Save();
+        if (!saved) {
+            throw new Error('Failed to create CompanyIntegrationRun record');
+        }
+        return run;
+    }
+    /**
+     * Processes all entity maps, aggregating results with progress tracking.
+     */
+    async ExecuteEntityMaps(config, run, contextUser, onProgress) {
+        const aggregate = {
+            Success: true,
+            RecordsProcessed: 0,
+            RecordsCreated: 0,
+            RecordsUpdated: 0,
+            RecordsDeleted: 0,
+            RecordsErrored: 0,
+            RecordsSkipped: 0,
+            Errors: [],
+        };
+        const totalMaps = config.entityMaps.length;
+        for (let i = 0; i < totalMaps; i++) {
+            const entityMap = config.entityMaps[i];
+            const mapResult = await this.ProcessSingleEntityMap(config, entityMap, run, contextUser, i, totalMaps, onProgress);
+            this.MergeResult(aggregate, mapResult);
+        }
+        return aggregate;
+    }
+    /**
+     * Processes a single entity map: fetch → map → match → validate → apply.
+     */
+    async ProcessSingleEntityMap(config, entityMap, run, contextUser, entityMapIndex, totalEntityMaps, onProgress) {
+        const entityMapID = entityMap.Get('ID');
+        const fieldMaps = await this.LoadFieldMaps(entityMapID, contextUser);
+        const watermark = await this.watermarkService.Load(entityMapID, contextUser);
+        // A6: Validate watermark before using it
+        let initialWatermark = watermark?.WatermarkValue ?? null;
+        if (initialWatermark && watermark) {
+            const watermarkType = (watermark.WatermarkType ?? 'Timestamp');
+            if (!this.watermarkService.ValidateWatermark(initialWatermark, watermarkType)) {
+                console.warn(`[IntegrationOrchestrator] Invalid watermark '${initialWatermark}' for EntityMap ${entityMap.Get('ID')}, resetting to full fetch`);
+                initialWatermark = null;
+            }
+        }
+        const result = {
+            Success: true,
+            RecordsProcessed: 0,
+            RecordsCreated: 0,
+            RecordsUpdated: 0,
+            RecordsDeleted: 0,
+            RecordsErrored: 0,
+            RecordsSkipped: 0,
+            Errors: [],
+        };
+        let hasMore = true;
+        let currentWatermark = initialWatermark;
+        let recordsInMap = 0;
+        while (hasMore) {
+            const ctx = {
+                CompanyIntegration: config.companyIntegration,
+                ObjectName: entityMap.ExternalObjectName,
+                WatermarkValue: currentWatermark,
+                BatchSize: this.MaxBatchSize,
+                ContextUser: contextUser,
+            };
+            const batch = await config.connector.FetchChanges(ctx);
+            // A7: Batch size enforcement — truncate if connector returns more than MaxBatchSize
+            let batchRecords = batch.Records;
+            if (batchRecords.length > this.MaxBatchSize) {
+                console.warn(`[IntegrationOrchestrator] Connector returned ${batchRecords.length} records, exceeding MaxBatchSize of ${this.MaxBatchSize}. Truncating.`);
+                batchRecords = batchRecords.slice(0, this.MaxBatchSize);
+            }
+            const mapped = this.fieldMappingEngine.Apply(batchRecords, fieldMaps, entityMap.Entity);
+            const resolved = await this.matchEngine.Resolve(mapped, entityMap, fieldMaps, contextUser);
+            await this.ApplyRecords(resolved, config.companyIntegration, entityMap, result, contextUser);
+            recordsInMap += batchRecords.length;
+            // A8: Progress tracking
+            if (onProgress) {
+                this.emitProgress(onProgress, entityMapIndex, totalEntityMaps, recordsInMap, recordsInMap);
+            }
+            if (batch.NewWatermarkValue) {
+                currentWatermark = batch.NewWatermarkValue;
+            }
+            hasMore = batch.HasMore;
+        }
+        if (currentWatermark) {
+            await this.watermarkService.Update(entityMapID, currentWatermark, contextUser);
+            result.WatermarkAfter = currentWatermark;
+        }
+        await this.CreateRunDetail(run, entityMap, result, contextUser);
+        return result;
+    }
+    /**
+     * Emits a progress update via the callback.
+     */
+    emitProgress(onProgress, entityMapIndex, totalEntityMaps, processedInMap, totalInMap) {
+        const mapProgress = totalEntityMaps > 0 ? entityMapIndex / totalEntityMaps : 0;
+        const inMapProgress = totalInMap > 0 ? processedInMap / totalInMap : 0;
+        const overallPercent = Math.round((mapProgress + inMapProgress / totalEntityMaps) * 100);
+        const progress = {
+            EntityMapIndex: entityMapIndex,
+            TotalEntityMaps: totalEntityMaps,
+            RecordsProcessedInCurrentMap: processedInMap,
+            TotalRecordsInCurrentMap: totalInMap,
+            PercentComplete: Math.min(overallPercent, 100),
+        };
+        onProgress(progress);
+    }
+    /**
+     * Loads active field maps for a given entity map.
+     */
+    async LoadFieldMaps(entityMapID, contextUser) {
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: 'MJ: Company Integration Field Maps',
+            ExtraFilter: `EntityMapID='${entityMapID}' AND Status='Active'`,
+            OrderBy: 'Priority ASC',
+            ResultType: 'entity_object',
+        }, contextUser);
+        return result.Success ? result.Results : [];
+    }
+    /**
+     * Applies resolved records to MJ, handling each individually for error isolation.
+     */
+    async ApplyRecords(records, companyIntegration, entityMap, result, contextUser) {
+        for (const record of records) {
+            result.RecordsProcessed++;
+            try {
+                await this.ApplySingleRecord(record, companyIntegration, entityMap, result, contextUser);
+            }
+            catch (err) {
+                const classified = ClassifyError(err);
+                result.RecordsErrored++;
+                result.Errors.push({
+                    ExternalID: record.ExternalRecord.ExternalID,
+                    ChangeType: record.ChangeType,
+                    ErrorMessage: err instanceof Error ? err.message : String(err),
+                    ErrorCode: classified.Code,
+                    Severity: classified.Severity,
+                    ExternalRecord: record.ExternalRecord,
+                });
+            }
+        }
+    }
+    /**
+     * Applies a single record change (Create, Update, Delete, or Skip).
+     */
+    async ApplySingleRecord(record, companyIntegration, entityMap, result, contextUser) {
+        switch (record.ChangeType) {
+            case 'Create':
+                await this.CreateRecord(record, companyIntegration, entityMap, contextUser);
+                result.RecordsCreated++;
+                break;
+            case 'Update':
+                await this.UpdateRecord(record, contextUser);
+                result.RecordsUpdated++;
+                break;
+            case 'Delete':
+                await this.DeleteRecord(record, entityMap, contextUser);
+                result.RecordsDeleted++;
+                break;
+            case 'Skip':
+                result.RecordsSkipped++;
+                break;
+        }
+    }
+    /**
+     * Creates a new MJ record with pre-write validation and saves a record map entry.
+     */
+    async CreateRecord(record, companyIntegration, entityMap, contextUser) {
+        const md = new Metadata();
+        const entity = await md.GetEntityObject(record.MJEntityName, contextUser);
+        entity.NewRecord();
+        this.SetEntityFields(entity, record.MappedFields);
+        // A5: Pre-write validation
+        this.validateEntity(entity, record.MJEntityName);
+        const saved = await entity.Save();
+        if (!saved) {
+            throw new Error(`Failed to create ${record.MJEntityName} record`);
+        }
+        await this.SaveRecordMap(companyIntegration.Get('ID'), record.ExternalRecord.ExternalID, entityMap.EntityID, entity.Get('ID'), contextUser);
+    }
+    /**
+     * Updates an existing MJ record with pre-write validation.
+     */
+    async UpdateRecord(record, contextUser) {
+        if (!record.MatchedMJRecordID) {
+            throw new Error('Cannot update record without MatchedMJRecordID');
+        }
+        const md = new Metadata();
+        const entity = await md.GetEntityObject(record.MJEntityName, contextUser);
+        const loaded = await entity.InnerLoad(this.BuildCompositeKey(record.MatchedMJRecordID));
+        if (!loaded) {
+            throw new Error(`Failed to load ${record.MJEntityName} record ${record.MatchedMJRecordID}`);
+        }
+        this.SetEntityFields(entity, record.MappedFields);
+        // A5: Pre-write validation
+        this.validateEntity(entity, record.MJEntityName);
+        const saved = await entity.Save();
+        if (!saved) {
+            throw new Error(`Failed to update ${record.MJEntityName} record ${record.MatchedMJRecordID}`);
+        }
+    }
+    /**
+     * Runs Validate() on an entity if the method exists.
+     * Throws a validation error with details if validation fails.
+     */
+    validateEntity(entity, entityName) {
+        if (typeof entity.Validate !== 'function')
+            return;
+        const validationResult = entity.Validate();
+        if (validationResult && !validationResult.Success) {
+            const messages = validationResult.Errors?.map(e => e.Message).join('; ') ?? 'Validation failed';
+            throw new Error(`Validation failed for ${entityName}: ${messages}`);
+        }
+    }
+    /**
+     * Deletes (or soft-deletes) an MJ record based on the entity map's DeleteBehavior.
+     */
+    async DeleteRecord(record, entityMap, contextUser) {
+        if (!record.MatchedMJRecordID) {
+            throw new Error('Cannot delete record without MatchedMJRecordID');
+        }
+        if (entityMap.DeleteBehavior === 'DoNothing')
+            return;
+        const md = new Metadata();
+        const entity = await md.GetEntityObject(record.MJEntityName, contextUser);
+        const loaded = await entity.InnerLoad(this.BuildCompositeKey(record.MatchedMJRecordID));
+        if (!loaded) {
+            throw new Error(`Failed to load ${record.MJEntityName} for deletion: ${record.MatchedMJRecordID}`);
+        }
+        const deleted = await entity.Delete();
+        if (!deleted) {
+            throw new Error(`Failed to delete ${record.MJEntityName} record ${record.MatchedMJRecordID}`);
+        }
+    }
+    /**
+     * Builds a CompositeKey for a single ID field.
+     */
+    BuildCompositeKey(id) {
+        const key = new CompositeKey();
+        key.KeyValuePairs.push({ FieldName: 'ID', Value: id });
+        return key;
+    }
+    /**
+     * Sets fields on a BaseEntity instance from a field value map.
+     */
+    SetEntityFields(entity, fields) {
+        for (const [fieldName, value] of Object.entries(fields)) {
+            entity.Set(fieldName, value);
+        }
+    }
+    /**
+     * Creates or updates a CompanyIntegrationRecordMap entry to track the external↔MJ mapping.
+     */
+    async SaveRecordMap(companyIntegrationID, externalID, entityID, entityRecordID, contextUser) {
+        const md = new Metadata();
+        const recordMap = await md.GetEntityObject('MJ: Company Integration Record Maps', contextUser);
+        recordMap.NewRecord();
+        recordMap.CompanyIntegrationID = companyIntegrationID;
+        recordMap.ExternalSystemRecordID = externalID;
+        recordMap.EntityID = entityID;
+        recordMap.EntityRecordID = entityRecordID;
+        const saved = await recordMap.Save();
+        if (!saved) {
+            throw new Error(`Failed to save record map for external ID: ${externalID}`);
+        }
+    }
+    /**
+     * Creates a CompanyIntegrationRunDetail record for audit/reporting.
+     */
+    async CreateRunDetail(run, entityMap, result, contextUser) {
+        const md = new Metadata();
+        const detail = await md.GetEntityObject('MJ: Company Integration Run Details', contextUser);
+        detail.NewRecord();
+        detail.CompanyIntegrationRunID = run.Get('ID');
+        detail.EntityID = entityMap.EntityID;
+        detail.RecordID = `Processed:${result.RecordsProcessed}`;
+        detail.Action = result.RecordsCreated > 0 ? 'INSERT' : 'UPDATE';
+        detail.IsSuccess = result.RecordsErrored === 0;
+        await detail.Save();
+    }
+    /**
+     * Merges an entity-map-level result into the aggregate result.
+     */
+    MergeResult(aggregate, mapResult) {
+        aggregate.RecordsProcessed += mapResult.RecordsProcessed;
+        aggregate.RecordsCreated += mapResult.RecordsCreated;
+        aggregate.RecordsUpdated += mapResult.RecordsUpdated;
+        aggregate.RecordsDeleted += mapResult.RecordsDeleted;
+        aggregate.RecordsErrored += mapResult.RecordsErrored;
+        aggregate.RecordsSkipped += mapResult.RecordsSkipped;
+        aggregate.Errors.push(...mapResult.Errors);
+        if (mapResult.RecordsErrored > 0) {
+            aggregate.Success = false;
+        }
+    }
+    /**
+     * Finalizes a successful run with aggregate totals and emits a completion notification.
+     */
+    async FinalizeRun(run, result, _contextUser, onNotification) {
+        run.EndedAt = new Date();
+        run.TotalRecords = result.RecordsProcessed;
+        run.Status = result.RecordsErrored > 0 ? 'Failed' : 'Success';
+        if (result.Errors.length > 0) {
+            run.ErrorLog = JSON.stringify(result.Errors.slice(0, 100));
+        }
+        await run.Save();
+        if (onNotification) {
+            const notification = this.buildCompletionNotification(run, result);
+            this.safeNotify(onNotification, notification);
+        }
+    }
+    /**
+     * Marks a run as failed after an unrecoverable error and emits a failure notification.
+     */
+    async FailRun(run, err, _contextUser, onNotification) {
+        run.EndedAt = new Date();
+        run.Status = 'Failed';
+        run.ErrorLog = err instanceof Error ? err.message : String(err);
+        await run.Save();
+        if (onNotification) {
+            const failResult = {
+                Success: false,
+                RecordsProcessed: 0,
+                RecordsCreated: 0,
+                RecordsUpdated: 0,
+                RecordsDeleted: 0,
+                RecordsErrored: 0,
+                RecordsSkipped: 0,
+                Errors: [],
+            };
+            const notification = this.buildFailureNotification(run, err, failResult);
+            this.safeNotify(onNotification, notification);
+        }
+    }
+    /**
+     * Builds a SyncNotification for a completed run (success or completed-with-errors).
+     */
+    buildCompletionNotification(run, result) {
+        const hasErrors = result.RecordsErrored > 0;
+        const event = hasErrors ? 'SyncCompletedWithErrors' : 'SyncCompleted';
+        const severity = hasErrors ? 'Warning' : 'Info';
+        const integrationName = run.Get('Integration') ?? 'Unknown Integration';
+        const subject = hasErrors
+            ? `Integration Sync Completed with Errors: ${integrationName}`
+            : `Integration Sync Completed: ${integrationName}`;
+        const body = this.buildSyncResultBody(integrationName, result);
+        return {
+            Event: event,
+            Severity: severity,
+            CompanyIntegrationID: run.CompanyIntegrationID,
+            RunID: run.Get('ID'),
+            Subject: subject,
+            Body: body,
+            Result: result,
+            OccurredAt: new Date(),
+        };
+    }
+    /**
+     * Builds a SyncNotification for a catastrophically failed run.
+     */
+    buildFailureNotification(run, err, result) {
+        const integrationName = run.Get('Integration') ?? 'Unknown Integration';
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        const subject = `Integration Sync Failed: ${integrationName}`;
+        const body = [
+            `Integration: ${integrationName}`,
+            `Status: Failed`,
+            `Error: ${errorMessage}`,
+            `Time: ${new Date().toISOString()}`,
+        ].join('\n');
+        return {
+            Event: 'SyncFailed',
+            Severity: 'Error',
+            CompanyIntegrationID: run.CompanyIntegrationID,
+            RunID: run.Get('ID'),
+            Subject: subject,
+            Body: body,
+            Result: result,
+            OccurredAt: new Date(),
+        };
+    }
+    /**
+     * Formats a human-readable sync result body for notification messages.
+     */
+    buildSyncResultBody(integrationName, result) {
+        const lines = [
+            `Integration: ${integrationName}`,
+            `Status: ${result.RecordsErrored > 0 ? 'Completed with errors' : 'Success'}`,
+            '',
+            'Record Counts:',
+            `  Processed:  ${result.RecordsProcessed}`,
+            `  Created:    ${result.RecordsCreated}`,
+            `  Updated:    ${result.RecordsUpdated}`,
+            `  Deleted:    ${result.RecordsDeleted}`,
+            `  Skipped:    ${result.RecordsSkipped}`,
+        ];
+        if (result.RecordsErrored > 0) {
+            lines.push(`  Errors:     ${result.RecordsErrored}`);
+            if (result.Errors.length > 0) {
+                lines.push('', 'Error Summary (first 5):');
+                for (const e of result.Errors.slice(0, 5)) {
+                    lines.push(`  [${e.ErrorCode}] ${e.ExternalID}: ${e.ErrorMessage}`);
+                }
+            }
+        }
+        lines.push('', `Completed at: ${new Date().toISOString()}`);
+        return lines.join('\n');
+    }
+    /**
+     * Invokes the notification callback without propagating exceptions.
+     */
+    safeNotify(callback, notification) {
+        try {
+            callback(notification);
+        }
+        catch (notifyErr) {
+            console.warn('[IntegrationOrchestrator] Notification callback threw:', notifyErr);
+        }
+    }
+}
+//# sourceMappingURL=IntegrationOrchestrator.js.map

package/dist/IntegrationOrchestrator.js.map

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

package/dist/MatchEngine.d.ts

@@ -0,0 +1,50 @@
+import { type UserInfo } from '@memberjunction/core';
+import type { ICompanyIntegrationFieldMap, ICompanyIntegrationEntityMap } from './entity-types.js';
+import type { MappedRecord } from './types.js';
+/**
+ * Resolves mapped records against existing MJ data to determine
+ * whether each record should be Created, Updated, Skipped, or Deleted.
+ */
+export declare class MatchEngine {
+    /**
+     * Resolves change types for a batch of mapped records by checking for existing
+     * MJ records via key field matching and record map lookups.
+     *
+     * @param records - Mapped records with preliminary change types
+     * @param entityMap - The entity map configuration for this object
+     * @param fieldMaps - Active field maps for identifying key fields
+     * @param contextUser - User context for data access
+     * @returns Updated mapped records with resolved ChangeType and MatchedMJRecordID
+     */
+    Resolve(records: MappedRecord[], entityMap: ICompanyIntegrationEntityMap, fieldMaps: ICompanyIntegrationFieldMap[], contextUser: UserInfo): Promise<MappedRecord[]>;
+    /**
+     * Resolves a single record by checking for an existing MJ match.
+     */
+    private ResolveSingleRecord;
+    /**
+     * Handles records marked as deleted in the external system.
+     */
+    private ResolveDeletedRecord;
+    /**
+     * Determines change type for a record that matches an existing MJ record.
+     */
+    private ResolveExistingRecord;
+    /**
+     * Attempts to find an existing MJ record by key field matching, then falls back
+     * to the CompanyIntegrationRecordMap.
+     */
+    private FindExistingRecord;
+    /**
+     * Searches for an existing MJ record using key field values.
+     */
+    private FindByKeyFields;
+    /**
+     * Builds a SQL filter clause from key field values on a mapped record.
+     */
+    private BuildKeyFieldFilter;
+    /**
+     * Checks the CompanyIntegrationRecordMap for a previous external↔MJ mapping.
+     */
+    private FindRecordMapEntry;
+}
+//# sourceMappingURL=MatchEngine.d.ts.map

package/dist/MatchEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatchEngine.d.ts","sourceRoot":"","sources":["../src/MatchEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAEnE;;;GAGG;AACH,qBAAa,WAAW;IACpB;;;;;;;;;OASG;IACU,OAAO,CAChB,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,4BAA4B,EACvC,SAAS,EAAE,2BAA2B,EAAE,EACxC,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IAkB1B;;OAEG;YACW,mBAAmB;IAsBjC;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;OAGG;YACW,kBAAkB;IAmBhC;;OAEG;YACW,eAAe;IAqB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;YACW,kBAAkB;CAsBnC"}