@memberjunction/integration-engine 0.0.1 → 5.8.0

package/dist/MatchEngine.js

@@ -0,0 +1,124 @@
+import { RunView } from '@memberjunction/core';
+/**
+ * Resolves mapped records against existing MJ data to determine
+ * whether each record should be Created, Updated, Skipped, or Deleted.
+ */
+export 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
+     */
+    async Resolve(records, entityMap, fieldMaps, contextUser) {
+        const keyFields = fieldMaps.filter(fm => fm.IsKeyField && fm.Status === 'Active');
+        const conflictResolution = entityMap.ConflictResolution;
+        const results = [];
+        for (const record of records) {
+            const resolved = await this.ResolveSingleRecord(record, entityMap, keyFields, conflictResolution, contextUser);
+            results.push(resolved);
+        }
+        return results;
+    }
+    /**
+     * Resolves a single record by checking for an existing MJ match.
+     */
+    async ResolveSingleRecord(record, entityMap, keyFields, conflictResolution, contextUser) {
+        if (record.ExternalRecord.IsDeleted) {
+            return this.ResolveDeletedRecord(record, entityMap, contextUser);
+        }
+        const existingID = await this.FindExistingRecord(record, entityMap, keyFields, contextUser);
+        if (existingID) {
+            return this.ResolveExistingRecord(record, existingID, conflictResolution);
+        }
+        return { ...record, ChangeType: 'Create' };
+    }
+    /**
+     * Handles records marked as deleted in the external system.
+     */
+    async ResolveDeletedRecord(record, entityMap, contextUser) {
+        const existingID = await this.FindRecordMapEntry(entityMap.CompanyIntegrationID, record.ExternalRecord.ExternalID, entityMap.EntityID, contextUser);
+        if (existingID) {
+            return { ...record, ChangeType: 'Delete', MatchedMJRecordID: existingID };
+        }
+        return { ...record, ChangeType: 'Skip' };
+    }
+    /**
+     * Determines change type for a record that matches an existing MJ record.
+     */
+    ResolveExistingRecord(record, existingID, conflictResolution) {
+        if (conflictResolution === 'Manual') {
+            return { ...record, ChangeType: 'Skip', MatchedMJRecordID: existingID };
+        }
+        return { ...record, ChangeType: 'Update', MatchedMJRecordID: existingID };
+    }
+    /**
+     * Attempts to find an existing MJ record by key field matching, then falls back
+     * to the CompanyIntegrationRecordMap.
+     */
+    async FindExistingRecord(record, entityMap, keyFields, contextUser) {
+        if (keyFields.length > 0) {
+            const idByKeys = await this.FindByKeyFields(record, keyFields, contextUser);
+            if (idByKeys)
+                return idByKeys;
+        }
+        return this.FindRecordMapEntry(entityMap.CompanyIntegrationID, record.ExternalRecord.ExternalID, entityMap.EntityID, contextUser);
+    }
+    /**
+     * Searches for an existing MJ record using key field values.
+     */
+    async FindByKeyFields(record, keyFields, contextUser) {
+        const filterClauses = this.BuildKeyFieldFilter(record, keyFields);
+        if (filterClauses.length === 0)
+            return null;
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: record.MJEntityName,
+            ExtraFilter: filterClauses.join(' AND '),
+            Fields: ['ID'],
+            MaxRows: 1,
+            ResultType: 'simple',
+        }, contextUser);
+        if (!result.Success || result.Results.length === 0)
+            return null;
+        return result.Results[0].ID;
+    }
+    /**
+     * Builds a SQL filter clause from key field values on a mapped record.
+     */
+    BuildKeyFieldFilter(record, keyFields) {
+        const clauses = [];
+        for (const kf of keyFields) {
+            const value = record.MappedFields[kf.DestinationFieldName];
+            if (value == null)
+                continue;
+            const escaped = String(value).replace(/'/g, "''");
+            clauses.push(`[${kf.DestinationFieldName}] = '${escaped}'`);
+        }
+        return clauses;
+    }
+    /**
+     * Checks the CompanyIntegrationRecordMap for a previous external↔MJ mapping.
+     */
+    async FindRecordMapEntry(companyIntegrationID, externalID, entityID, contextUser) {
+        const rv = new RunView();
+        const escapedExternalID = externalID.replace(/'/g, "''");
+        const result = await rv.RunView({
+            EntityName: 'MJ: Company Integration Record Maps',
+            ExtraFilter: `CompanyIntegrationID='${companyIntegrationID}' ` +
+                `AND ExternalSystemRecordID='${escapedExternalID}' ` +
+                `AND EntityID='${entityID}'`,
+            Fields: ['EntityRecordID'],
+            MaxRows: 1,
+            ResultType: 'simple',
+        }, contextUser);
+        if (!result.Success || result.Results.length === 0)
+            return null;
+        return result.Results[0].EntityRecordID;
+    }
+}
+//# sourceMappingURL=MatchEngine.js.map

package/dist/MatchEngine.js.map

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

package/dist/RetryRunner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Configuration for retry behavior with exponential backoff.
+ */
+export interface RetryConfig {
+    /** Maximum number of attempts (including the initial one). Default: 3 */
+    MaxAttempts: number;
+    /** Initial backoff delay in milliseconds. Default: 1000 */
+    InitialBackoffMs: number;
+    /** Maximum backoff delay in milliseconds. Default: 30000 */
+    MaxBackoffMs: number;
+    /** Fraction of jitter to add (0-1). Default: 0.1 */
+    JitterFraction: number;
+}
+/** Default retry configuration */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Executes an operation with retry logic using exponential backoff.
+ *
+ * @param operation - The async operation to execute
+ * @param config - Retry configuration (uses defaults if not provided)
+ * @param isRetryable - Predicate to determine if a caught error should trigger a retry
+ * @param onRetry - Optional callback invoked before each retry with attempt number, error, and delay
+ * @returns The result of the operation
+ * @throws The last error encountered if all attempts fail
+ */
+export declare function WithRetry<T>(operation: () => Promise<T>, config?: RetryConfig, isRetryable?: (error: unknown) => boolean, onRetry?: (attempt: number, error: unknown, delayMs: number) => void): Promise<T>;
+//# sourceMappingURL=RetryRunner.d.ts.map

package/dist/RetryRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryRunner.d.ts","sourceRoot":"","sources":["../src/RetryRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,kCAAkC;AAClC,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAC;AAeF;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,GAAE,WAAkC,EAC1C,WAAW,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAoB,EACrD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACrE,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/dist/RetryRunner.js

@@ -0,0 +1,59 @@
+/** Default retry configuration */
+export const DEFAULT_RETRY_CONFIG = {
+    MaxAttempts: 3,
+    InitialBackoffMs: 1000,
+    MaxBackoffMs: 30000,
+    JitterFraction: 0.1,
+};
+/**
+ * Computes the delay for a given attempt using exponential backoff with jitter.
+ * @param attempt - The current attempt number (1-based)
+ * @param config - Retry configuration
+ * @returns Delay in milliseconds
+ */
+function computeDelay(attempt, config) {
+    const exponentialDelay = config.InitialBackoffMs * Math.pow(2, attempt - 1);
+    const capped = Math.min(exponentialDelay, config.MaxBackoffMs);
+    const jitter = capped * config.JitterFraction * Math.random();
+    return capped + jitter;
+}
+/**
+ * Executes an operation with retry logic using exponential backoff.
+ *
+ * @param operation - The async operation to execute
+ * @param config - Retry configuration (uses defaults if not provided)
+ * @param isRetryable - Predicate to determine if a caught error should trigger a retry
+ * @param onRetry - Optional callback invoked before each retry with attempt number, error, and delay
+ * @returns The result of the operation
+ * @throws The last error encountered if all attempts fail
+ */
+export async function WithRetry(operation, config = DEFAULT_RETRY_CONFIG, isRetryable = () => true, onRetry) {
+    let lastError;
+    for (let attempt = 1; attempt <= config.MaxAttempts; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (err) {
+            lastError = err;
+            const isLastAttempt = attempt === config.MaxAttempts;
+            if (isLastAttempt || !isRetryable(err)) {
+                throw err;
+            }
+            const delayMs = computeDelay(attempt, config);
+            if (onRetry) {
+                onRetry(attempt, err, delayMs);
+            }
+            await sleep(delayMs);
+        }
+    }
+    // Should not reach here, but TypeScript needs this
+    throw lastError;
+}
+/**
+ * Returns a promise that resolves after the specified delay.
+ * @param ms - Delay in milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=RetryRunner.js.map

package/dist/RetryRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryRunner.js","sourceRoot":"","sources":["../src/RetryRunner.ts"],"names":[],"mappings":"AAcA,kCAAkC;AAClC,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC7C,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,KAAK;IACnB,cAAc,EAAE,GAAG;CACtB,CAAC;AAEF;;;;;GAKG;AACH,SAAS,YAAY,CAAC,OAAe,EAAE,MAAmB;IACtD,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9D,OAAO,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,SAA2B,EAC3B,SAAsB,oBAAoB,EAC1C,cAA2C,GAAG,EAAE,CAAC,IAAI,EACrD,OAAoE;IAEpE,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC;YACD,OAAO,MAAM,SAAS,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,SAAS,GAAG,GAAG,CAAC;YAEhB,MAAM,aAAa,GAAG,OAAO,KAAK,MAAM,CAAC,WAAW,CAAC;YACrD,IAAI,aAAa,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,GAAG,CAAC;YACd,CAAC;YAED,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9C,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,mDAAmD;IACnD,MAAM,SAAS,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/WatermarkService.d.ts

@@ -0,0 +1,44 @@
+import { type UserInfo } from '@memberjunction/core';
+import type { ICompanyIntegrationSyncWatermark } from './entity-types.js';
+import type { WatermarkType } from './types.js';
+/**
+ * Service for loading and updating sync watermarks used for incremental data fetching.
+ * Watermarks track the "last known position" so each sync only fetches changes since the last run.
+ */
+export declare class WatermarkService {
+    /**
+     * Loads the current watermark for a specific entity map direction.
+     *
+     * @param entityMapID - The CompanyIntegrationEntityMap ID to load the watermark for
+     * @param contextUser - User context for data access
+     * @returns The watermark entity if found, or null if no watermark exists yet
+     */
+    Load(entityMapID: string, contextUser: UserInfo): Promise<ICompanyIntegrationSyncWatermark | null>;
+    /**
+     * Updates or creates the watermark for a specific entity map.
+     * If a watermark record already exists, it is updated in place.
+     * If none exists, a new record is created.
+     *
+     * @param entityMapID - The CompanyIntegrationEntityMap ID to update the watermark for
+     * @param newValue - The new watermark value to store
+     * @param contextUser - User context for data access
+     */
+    Update(entityMapID: string, newValue: string, contextUser: UserInfo): Promise<void>;
+    /**
+     * Validates a watermark value against its expected type.
+     *
+     * @param watermarkValue - The watermark value to validate
+     * @param watermarkType - The expected type of watermark
+     * @returns true if the watermark is valid for its type, false otherwise
+     */
+    ValidateWatermark(watermarkValue: string, watermarkType: WatermarkType): boolean;
+    /**
+     * Updates an existing watermark record with a new value and timestamp.
+     */
+    private UpdateExistingWatermark;
+    /**
+     * Creates a new watermark record for the given entity map.
+     */
+    private CreateNewWatermark;
+}
+//# sourceMappingURL=WatermarkService.d.ts.map

package/dist/WatermarkService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatermarkService.d.ts","sourceRoot":"","sources":["../src/WatermarkService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,qBAAa,gBAAgB;IACzB;;;;;;OAMG;IACU,IAAI,CACb,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC;IAanD;;;;;;;;OAQG;IACU,MAAM,CACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;OAMG;IACI,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO;IAkBvF;;OAEG;YACW,uBAAuB;IAYrC;;OAEG;YACW,kBAAkB;CAuBnC"}

package/dist/WatermarkService.js

@@ -0,0 +1,97 @@
+import { Metadata, RunView } from '@memberjunction/core';
+/**
+ * Service for loading and updating sync watermarks used for incremental data fetching.
+ * Watermarks track the "last known position" so each sync only fetches changes since the last run.
+ */
+export class WatermarkService {
+    /**
+     * Loads the current watermark for a specific entity map direction.
+     *
+     * @param entityMapID - The CompanyIntegrationEntityMap ID to load the watermark for
+     * @param contextUser - User context for data access
+     * @returns The watermark entity if found, or null if no watermark exists yet
+     */
+    async Load(entityMapID, contextUser) {
+        const rv = new RunView();
+        const result = await rv.RunView({
+            EntityName: 'MJ: Company Integration Sync Watermarks',
+            ExtraFilter: `EntityMapID='${entityMapID}'`,
+            MaxRows: 1,
+            ResultType: 'entity_object',
+        }, contextUser);
+        if (!result.Success || result.Results.length === 0)
+            return null;
+        return result.Results[0];
+    }
+    /**
+     * Updates or creates the watermark for a specific entity map.
+     * If a watermark record already exists, it is updated in place.
+     * If none exists, a new record is created.
+     *
+     * @param entityMapID - The CompanyIntegrationEntityMap ID to update the watermark for
+     * @param newValue - The new watermark value to store
+     * @param contextUser - User context for data access
+     */
+    async Update(entityMapID, newValue, contextUser) {
+        const existing = await this.Load(entityMapID, contextUser);
+        if (existing) {
+            await this.UpdateExistingWatermark(existing, newValue);
+        }
+        else {
+            await this.CreateNewWatermark(entityMapID, newValue, contextUser);
+        }
+    }
+    /**
+     * Validates a watermark value against its expected type.
+     *
+     * @param watermarkValue - The watermark value to validate
+     * @param watermarkType - The expected type of watermark
+     * @returns true if the watermark is valid for its type, false otherwise
+     */
+    ValidateWatermark(watermarkValue, watermarkType) {
+        if (!watermarkValue || watermarkValue.trim().length === 0) {
+            return false;
+        }
+        switch (watermarkType) {
+            case 'Timestamp':
+                return !isNaN(Date.parse(watermarkValue));
+            case 'Version':
+                return /^\d+$/.test(watermarkValue);
+            case 'Cursor':
+            case 'ChangeToken':
+                return watermarkValue.length > 0;
+            default:
+                return watermarkValue.length > 0;
+        }
+    }
+    /**
+     * Updates an existing watermark record with a new value and timestamp.
+     */
+    async UpdateExistingWatermark(watermark, newValue) {
+        watermark.WatermarkValue = newValue;
+        watermark.LastSyncAt = new Date();
+        const saved = await watermark.Save();
+        if (!saved) {
+            throw new Error(`Failed to update watermark for EntityMapID=${watermark.EntityMapID}`);
+        }
+    }
+    /**
+     * Creates a new watermark record for the given entity map.
+     */
+    async CreateNewWatermark(entityMapID, newValue, contextUser) {
+        const md = new Metadata();
+        const watermark = await md.GetEntityObject('MJ: Company Integration Sync Watermarks', contextUser);
+        watermark.NewRecord();
+        watermark.EntityMapID = entityMapID;
+        watermark.WatermarkValue = newValue;
+        watermark.Direction = 'Pull';
+        watermark.WatermarkType = 'Timestamp';
+        watermark.LastSyncAt = new Date();
+        watermark.RecordsSynced = 0;
+        const saved = await watermark.Save();
+        if (!saved) {
+            throw new Error(`Failed to create watermark for EntityMapID=${entityMapID}`);
+        }
+    }
+}
+//# sourceMappingURL=WatermarkService.js.map

package/dist/WatermarkService.js.map

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

package/dist/entity-types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Local interface definitions for integration-engine entity types.
+ *
+ * These interfaces mirror the properties used from the generated entity classes
+ * in @memberjunction/core-entities. They are defined locally because CodeGen
+ * has not yet been run against the new integration tables, so the generated
+ * classes are not yet exported from core-entities.
+ *
+ * Once CodeGen is run and core-entities is rebuilt, these can be replaced
+ * with the real generated entity types.
+ */
+/**
+ * Mirrors MJIntegrationSourceTypeEntity from the IntegrationSourceType table.
+ * @see migrations/v2/V202603040356__v5.7.x_Create_IntegrationSourceType.sql
+ */
+export interface IIntegrationSourceType {
+    ID: string;
+    Name: string;
+    Description: string | null;
+    DriverClass: string;
+    IconClass: string | null;
+    Status: 'Active' | 'Inactive';
+    Get(fieldName: string): unknown;
+    Set?(fieldName: string, value: unknown): void;
+    Save?(): Promise<boolean>;
+}
+/**
+ * Mirrors MJCompanyIntegrationEntityMapEntity from the CompanyIntegrationEntityMap table.
+ * @see migrations/v2/V202603040357__v5.7.x_Create_CompanyIntegrationEntityMap.sql
+ */
+export interface ICompanyIntegrationEntityMap {
+    ID: string;
+    CompanyIntegrationID: string;
+    ExternalObjectName: string;
+    ExternalObjectLabel: string | null;
+    EntityID: string;
+    SyncDirection: 'Pull' | 'Push' | 'Bidirectional';
+    SyncEnabled: boolean;
+    MatchStrategy: string | null;
+    ConflictResolution: 'SourceWins' | 'DestWins' | 'MostRecent' | 'Manual';
+    Priority: number;
+    DeleteBehavior: 'SoftDelete' | 'DoNothing' | 'HardDelete';
+    Status: 'Active' | 'Inactive';
+    Configuration: string | null;
+    /** View field: joined entity name */
+    Entity: string;
+    Get(fieldName: string): unknown;
+    Set?(fieldName: string, value: unknown): void;
+    Save?(): Promise<boolean>;
+}
+/**
+ * Mirrors MJCompanyIntegrationFieldMapEntity from the CompanyIntegrationFieldMap table.
+ * @see migrations/v2/V202603040358__v5.7.x_Create_CompanyIntegrationFieldMap.sql
+ */
+export interface ICompanyIntegrationFieldMap {
+    ID: string;
+    EntityMapID: string;
+    SourceFieldName: string;
+    SourceFieldLabel: string | null;
+    DestinationFieldName: string;
+    DestinationFieldLabel: string | null;
+    Direction: 'SourceToDest' | 'DestToSource' | 'Both';
+    TransformPipeline: string | null;
+    IsKeyField: boolean;
+    IsRequired: boolean;
+    DefaultValue: string | null;
+    Priority: number;
+    Status: 'Active' | 'Inactive';
+    Get(fieldName: string): unknown;
+    Set?(fieldName: string, value: unknown): void;
+    Save?(): Promise<boolean>;
+}
+/**
+ * Mirrors MJCompanyIntegrationSyncWatermarkEntity from the CompanyIntegrationSyncWatermark table.
+ * @see migrations/v2/V202603040359__v5.7.x_Create_CompanyIntegrationSyncWatermark.sql
+ */
+export interface ICompanyIntegrationSyncWatermark {
+    ID: string;
+    EntityMapID: string;
+    Direction: 'Pull' | 'Push';
+    WatermarkType: 'Timestamp' | 'Cursor' | 'ChangeToken' | 'Version';
+    WatermarkValue: string | null;
+    LastSyncAt: Date | null;
+    RecordsSynced: number;
+    Get(fieldName: string): unknown;
+    Set?(fieldName: string, value: unknown): void;
+    Save?(): Promise<boolean>;
+    NewRecord?(): void;
+}
+//# sourceMappingURL=entity-types.d.ts.map

package/dist/entity-types.d.ts.map

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

package/dist/entity-types.js

@@ -0,0 +1,13 @@
+/**
+ * Local interface definitions for integration-engine entity types.
+ *
+ * These interfaces mirror the properties used from the generated entity classes
+ * in @memberjunction/core-entities. They are defined locally because CodeGen
+ * has not yet been run against the new integration tables, so the generated
+ * classes are not yet exported from core-entities.
+ *
+ * Once CodeGen is run and core-entities is rebuilt, these can be replaced
+ * with the real generated entity types.
+ */
+export {};
+//# sourceMappingURL=entity-types.js.map

package/dist/entity-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-types.js","sourceRoot":"","sources":["../src/entity-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export type { IIntegrationSourceType, ICompanyIntegrationEntityMap, ICompanyIntegrationFieldMap, ICompanyIntegrationSyncWatermark, } from './entity-types.js';
+export type { SyncDirection, SyncTriggerType, WatermarkType, ConflictResolution, DeleteBehavior, RecordChangeType, IntegrationRunStatus, ExternalRecord, MappedRecord, SyncResult, SyncRecordError, DefaultFieldMapping, SyncErrorCode, ErrorSeverity, SyncProgress, OnProgressCallback, SyncNotificationEvent, SyncNotificationSeverity, SyncNotification, OnNotificationCallback, SourceSchemaInfo, SourceObjectInfo, SourceFieldInfo, SourceRelationshipInfo, } from './types.js';
+export { IsRetryableError, ClassifyError } from './types.js';
+export type { TransformType, TransformOnError, TransformStep, TransformConfig, DirectConfig, RegexConfig, SplitConfig, CombineConfig, LookupConfig, FormatConfig, CoerceConfig, SubstringConfig, CustomConfig, } from './transforms.js';
+export { BaseIntegrationConnector, WithTimeout, DEFAULT_OPERATION_TIMEOUTS, } from './BaseIntegrationConnector.js';
+export type { ConnectionTestResult, ExternalObjectSchema, ExternalFieldSchema, FetchContext, FetchBatchResult, OperationTimeouts, } from './BaseIntegrationConnector.js';
+export { ConnectorFactory } from './ConnectorFactory.js';
+export { FieldMappingEngine } from './FieldMappingEngine.js';
+export { MatchEngine } from './MatchEngine.js';
+export { WatermarkService } from './WatermarkService.js';
+export { WithRetry, DEFAULT_RETRY_CONFIG } from './RetryRunner.js';
+export type { RetryConfig } from './RetryRunner.js';
+export { IntegrationOrchestrator } from './IntegrationOrchestrator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACR,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,gCAAgC,GACnC,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACR,aAAa,EACb,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG7D,YAAY,EACR,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACH,wBAAwB,EACxB,WAAW,EACX,0BAA0B,GAC7B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACR,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// Error classification helpers
+export { IsRetryableError, ClassifyError } from './types.js';
+// Connector
+export { BaseIntegrationConnector, WithTimeout, DEFAULT_OPERATION_TIMEOUTS, } from './BaseIntegrationConnector.js';
+// Factory
+export { ConnectorFactory } from './ConnectorFactory.js';
+// Engines
+export { FieldMappingEngine } from './FieldMappingEngine.js';
+export { MatchEngine } from './MatchEngine.js';
+// Services
+export { WatermarkService } from './WatermarkService.js';
+// Retry
+export { WithRetry, DEFAULT_RETRY_CONFIG } from './RetryRunner.js';
+// Orchestrator
+export { IntegrationOrchestrator } from './IntegrationOrchestrator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoCA,+BAA+B;AAC/B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAmB7D,YAAY;AACZ,OAAO,EACH,wBAAwB,EACxB,WAAW,EACX,0BAA0B,GAC7B,MAAM,+BAA+B,CAAC;AAUvC,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGnE,eAAe;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/transforms.d.ts

@@ -0,0 +1,75 @@
+/** Supported transform types for field value transformation */
+export type TransformType = 'direct' | 'regex' | 'split' | 'combine' | 'lookup' | 'format' | 'coerce' | 'substring' | 'custom';
+/** What to do when a transform step encounters an error */
+export type TransformOnError = 'Skip' | 'Null' | 'Fail';
+/** A single step in a field value transformation pipeline */
+export interface TransformStep {
+    /** The type of transform to apply */
+    Type: TransformType;
+    /** Configuration for the transform step */
+    Config: TransformConfig;
+    /** Error handling strategy for this step. Defaults to 'Fail' */
+    OnError?: TransformOnError;
+}
+/** Union of all transform configuration types */
+export type TransformConfig = DirectConfig | RegexConfig | SplitConfig | CombineConfig | LookupConfig | FormatConfig | CoerceConfig | SubstringConfig | CustomConfig;
+/** Configuration for direct pass-through (no transformation) */
+export interface DirectConfig {
+    /** Optional default value if source is null/undefined */
+    DefaultValue?: unknown;
+}
+/** Configuration for regex-based string transformation */
+export interface RegexConfig {
+    /** Regular expression pattern to match */
+    Pattern: string;
+    /** Replacement string (supports $1, $2, etc. for capture groups) */
+    Replacement: string;
+    /** Regex flags (e.g., 'gi' for global, case-insensitive) */
+    Flags?: string;
+}
+/** Configuration for splitting a string value and extracting a portion */
+export interface SplitConfig {
+    /** Delimiter to split on */
+    Delimiter: string;
+    /** Zero-based index of the part to extract */
+    Index: number;
+}
+/** Configuration for combining multiple source field values */
+export interface CombineConfig {
+    /** Names of source fields to combine */
+    SourceFields: string[];
+    /** Separator to place between combined values */
+    Separator: string;
+}
+/** Configuration for value lookup/mapping */
+export interface LookupConfig {
+    /** Map of source values to destination values. Keys are matched case-insensitively */
+    Map: Record<string, unknown>;
+    /** Value to use when the source value is not found in the map */
+    Default?: unknown;
+}
+/** Configuration for date/number formatting */
+export interface FormatConfig {
+    /** The target format string. For dates: ISO8601 locale format specifiers */
+    FormatString: string;
+    /** The type of formatting to apply */
+    FormatType: 'date' | 'number' | 'string';
+}
+/** Configuration for type coercion */
+export interface CoerceConfig {
+    /** Target type to coerce the value into */
+    TargetType: 'string' | 'number' | 'boolean' | 'date';
+}
+/** Configuration for extracting a substring */
+export interface SubstringConfig {
+    /** Start index (zero-based) */
+    Start: number;
+    /** Number of characters to extract. If omitted, extracts to end */
+    Length?: number;
+}
+/** Configuration for custom JavaScript expression evaluation */
+export interface CustomConfig {
+    /** JavaScript expression to evaluate. The source value is available as 'value' and all fields as 'fields' */
+    Expression: string;
+}
+//# sourceMappingURL=transforms.d.ts.map

package/dist/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../src/transforms.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GACnB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,QAAQ,CAAC;AAEf,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC1B,qCAAqC;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,eAAe,CAAC;IACxB,gEAAgE;IAChE,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACrB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,YAAY,CAAC;AAEnB,gEAAgE;AAChE,MAAM,WAAW,YAAY;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IACxB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IACxB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC1B,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IACzB,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IACzB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC5C;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IACzB,2CAA2C;IAC3C,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CACxD;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC5B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IACzB,6GAA6G;IAC7G,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/transforms.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transforms.js.map

package/dist/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.js","sourceRoot":"","sources":["../src/transforms.ts"],"names":[],"mappings":""}