@memberjunction/integration-engine 0.0.1 → 5.9.0

package/dist/index.js

@@ -0,0 +1,19 @@
+// Error classification helpers
+export { IsRetryableError, ClassifyError } from './types.js';
+// Connector
+export { BaseIntegrationConnector, WithTimeout, DEFAULT_OPERATION_TIMEOUTS, } from './BaseIntegrationConnector.js';
+// REST Connector Base
+export { BaseRESTIntegrationConnector } from './BaseRESTIntegrationConnector.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';
+// Integration Engine (server-side, wraps IntegrationEngineBase via composition)
+// NOTE: For IntegrationEngineBase (client-safe metadata), import from @memberjunction/integration-engine-base
+export { IntegrationEngine } from './IntegrationEngine.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;AAYvC,sBAAsB;AACtB,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAQjF,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,gFAAgF;AAChF,8GAA8G;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,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":""}

package/dist/types.d.ts

@@ -0,0 +1,196 @@
+import type { TransformStep } from './transforms.js';
+/** Direction of data synchronization between MJ and external system */
+export type SyncDirection = 'Pull' | 'Push' | 'Bidirectional';
+/** What triggers a sync run */
+export type SyncTriggerType = 'Scheduled' | 'Manual' | 'Webhook';
+/** Type of watermark used for incremental sync */
+export type WatermarkType = 'Timestamp' | 'Cursor' | 'ChangeToken' | 'Version';
+/** How to resolve conflicts when both sides have changes */
+export type ConflictResolution = 'SourceWins' | 'DestWins' | 'MostRecent' | 'Manual';
+/** What to do when the external system marks a record as deleted */
+export type DeleteBehavior = 'SoftDelete' | 'DoNothing' | 'HardDelete';
+/** Classification of the change to apply to an MJ record */
+export type RecordChangeType = 'Create' | 'Update' | 'Delete' | 'Skip';
+/** Status of a running integration sync */
+export type IntegrationRunStatus = 'Pending' | 'In Progress' | 'Success' | 'Failed';
+/** Classification of sync errors for retry/alert decisions */
+export type SyncErrorCode = 'VALIDATION_ERROR' | 'FK_CONSTRAINT_VIOLATION' | 'DUPLICATE_KEY' | 'NETWORK_TIMEOUT' | 'RATE_LIMIT_EXCEEDED' | 'CONNECTOR_ERROR' | 'TRANSFORM_ERROR' | 'MATCH_RESOLUTION_ERROR' | 'DATABASE_ERROR' | 'WATERMARK_INVALID' | 'CONFIGURATION_ERROR' | 'UNKNOWN_ERROR';
+/** Severity level of a sync error */
+export type ErrorSeverity = 'Critical' | 'Warning' | 'Info';
+/** Whether an error with the given code is retryable */
+export declare function IsRetryableError(code: SyncErrorCode): boolean;
+/** Classify an error from its message/type into a structured code and severity */
+export declare function ClassifyError(error: unknown): {
+    Code: SyncErrorCode;
+    Severity: ErrorSeverity;
+};
+/** A record fetched from an external system */
+export interface ExternalRecord {
+    /** Unique identifier in the external system */
+    ExternalID: string;
+    /** Object type name in the external system (e.g., "Contact", "Company") */
+    ObjectType: string;
+    /** Field name→value pairs from the external system */
+    Fields: Record<string, unknown>;
+    /** When this record was last modified externally */
+    ModifiedAt?: Date;
+    /** Whether this record has been deleted in the external system */
+    IsDeleted?: boolean;
+}
+/** A record that has been mapped from external fields to MJ entity fields */
+export interface MappedRecord {
+    /** The original external record */
+    ExternalRecord: ExternalRecord;
+    /** Target MJ entity name */
+    MJEntityName: string;
+    /** Fields mapped to MJ entity field names */
+    MappedFields: Record<string, unknown>;
+    /** What kind of change to apply */
+    ChangeType: RecordChangeType;
+    /** ID of an existing MJ record if matched */
+    MatchedMJRecordID?: string;
+}
+/** Aggregate result of a sync operation */
+export interface SyncResult {
+    /** Whether the overall sync completed without fatal errors */
+    Success: boolean;
+    /** Total records processed */
+    RecordsProcessed: number;
+    /** New records created in MJ */
+    RecordsCreated: number;
+    /** Existing records updated in MJ */
+    RecordsUpdated: number;
+    /** Records deleted/soft-deleted in MJ */
+    RecordsDeleted: number;
+    /** Records that encountered errors */
+    RecordsErrored: number;
+    /** Records that were skipped */
+    RecordsSkipped: number;
+    /** Details of individual record errors */
+    Errors: SyncRecordError[];
+    /** Watermark value after this sync for incremental next-run */
+    WatermarkAfter?: string;
+}
+/** Error details for a single record during sync */
+export interface SyncRecordError {
+    /** External system record identifier */
+    ExternalID: string;
+    /** The intended change type that failed */
+    ChangeType: RecordChangeType;
+    /** Human-readable error description */
+    ErrorMessage: string;
+    /** Structured error code for programmatic handling */
+    ErrorCode: SyncErrorCode;
+    /** Severity of this error */
+    Severity: ErrorSeverity;
+    /** The external record that caused the error, if available */
+    ExternalRecord?: ExternalRecord;
+}
+/** Progress tracking for a running sync operation */
+export interface SyncProgress {
+    /** Index of the current entity map being processed (0-based) */
+    EntityMapIndex: number;
+    /** Total number of entity maps to process */
+    TotalEntityMaps: number;
+    /** Number of records processed in the current entity map */
+    RecordsProcessedInCurrentMap: number;
+    /** Total records fetched for the current entity map */
+    TotalRecordsInCurrentMap: number;
+    /** Overall percent complete (0-100) */
+    PercentComplete: number;
+}
+/** Callback for progress tracking during sync */
+export type OnProgressCallback = (progress: SyncProgress) => void;
+/** Notification event type — what triggered the notification */
+export type SyncNotificationEvent = 'SyncCompleted' | 'SyncFailed' | 'SyncCompletedWithErrors';
+/** Severity level for a sync notification */
+export type SyncNotificationSeverity = 'Info' | 'Warning' | 'Error';
+/** Notification emitted after a sync run completes or fails */
+export interface SyncNotification {
+    /** What happened to trigger this notification */
+    Event: SyncNotificationEvent;
+    /** Overall severity */
+    Severity: SyncNotificationSeverity;
+    /** ID of the CompanyIntegration that was synced */
+    CompanyIntegrationID: string;
+    /** ID of the run record created for this sync */
+    RunID: string;
+    /** Human-readable summary suitable for email subject lines */
+    Subject: string;
+    /** Full text body — formatted for human consumption */
+    Body: string;
+    /** The aggregate sync result for programmatic access */
+    Result: SyncResult;
+    /** When the notification was emitted */
+    OccurredAt: Date;
+}
+/** Callback invoked after a sync run completes (success or failure) */
+export type OnNotificationCallback = (notification: SyncNotification) => void;
+/** Top-level container returned by a connector's IntrospectSchema(). */
+export interface SourceSchemaInfo {
+    /** All objects (tables, API entities) discovered in the source system. */
+    Objects: SourceObjectInfo[];
+}
+/** One source object (table, API entity) discovered during introspection. */
+export interface SourceObjectInfo {
+    /** Name in the source system (e.g., "deals", "MemberList"). */
+    ExternalName: string;
+    /** Human-readable label (e.g., "Deals", "Members"). */
+    ExternalLabel: string;
+    /** Human-readable description of the object's purpose (used for sp_addextendedproperty on the table). */
+    Description?: string;
+    /** Fields/columns in the source object. */
+    Fields: SourceFieldInfo[];
+    /** Primary key field name(s). */
+    PrimaryKeyFields: string[];
+    /** Foreign key relationships to other source objects. */
+    Relationships: SourceRelationshipInfo[];
+}
+/** One field/column in a source object discovered during introspection. */
+export interface SourceFieldInfo {
+    /** Field name in the source system. */
+    Name: string;
+    /** Human-readable label. */
+    Label: string;
+    /** Human-readable description of the field's purpose (used for sp_addextendedproperty on the column). */
+    Description?: string;
+    /** Generic source type (e.g., "string", "integer", "datetime", "boolean"). */
+    SourceType: string;
+    /** Whether the field is required/non-nullable. */
+    IsRequired: boolean;
+    /** Maximum length for string types (null if not applicable). */
+    MaxLength: number | null;
+    /** Precision for numeric types (null if not applicable). */
+    Precision: number | null;
+    /** Scale for numeric types (null if not applicable). */
+    Scale: number | null;
+    /** Default value expression (null if none). */
+    DefaultValue: string | null;
+    /** Whether this field is part of the primary key. */
+    IsPrimaryKey: boolean;
+    /** Whether this field is a foreign key. */
+    IsForeignKey: boolean;
+    /** If FK, which source object it references (null if not a FK). */
+    ForeignKeyTarget: string | null;
+}
+/** One foreign key relationship in a source object. */
+export interface SourceRelationshipInfo {
+    /** Field in this object that references another object. */
+    FieldName: string;
+    /** Target source object name. */
+    TargetObject: string;
+    /** Target field name (usually the PK). */
+    TargetField: string;
+}
+/** A default field mapping returned by a connector's discovery */
+export interface DefaultFieldMapping {
+    /** Field name in the external system */
+    SourceFieldName: string;
+    /** Corresponding MJ entity field name */
+    DestinationFieldName: string;
+    /** Optional transform pipeline to apply */
+    TransformPipeline?: TransformStep[];
+    /** Whether this field is used for record matching */
+    IsKeyField?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,44 @@
+/** Whether an error with the given code is retryable */
+export function IsRetryableError(code) {
+    return code === 'NETWORK_TIMEOUT' || code === 'RATE_LIMIT_EXCEEDED' || code === 'DATABASE_ERROR';
+}
+/** Classify an error from its message/type into a structured code and severity */
+export function ClassifyError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const lower = message.toLowerCase();
+    if (lower.includes('timeout') || lower.includes('timed out') || lower.includes('econnreset')) {
+        return { Code: 'NETWORK_TIMEOUT', Severity: 'Warning' };
+    }
+    if (lower.includes('rate limit') || lower.includes('throttl') || lower.includes('429')) {
+        return { Code: 'RATE_LIMIT_EXCEEDED', Severity: 'Warning' };
+    }
+    if (lower.includes('foreign key') || lower.includes('fk_') || lower.includes('reference constraint')) {
+        return { Code: 'FK_CONSTRAINT_VIOLATION', Severity: 'Critical' };
+    }
+    if (lower.includes('duplicate') || lower.includes('unique constraint') || lower.includes('primary key')) {
+        return { Code: 'DUPLICATE_KEY', Severity: 'Warning' };
+    }
+    if (lower.includes('validation') || lower.includes('validate')) {
+        return { Code: 'VALIDATION_ERROR', Severity: 'Warning' };
+    }
+    if (lower.includes('transform') || lower.includes('mapping')) {
+        return { Code: 'TRANSFORM_ERROR', Severity: 'Warning' };
+    }
+    if (lower.includes('match') || lower.includes('resolve')) {
+        return { Code: 'MATCH_RESOLUTION_ERROR', Severity: 'Warning' };
+    }
+    if (lower.includes('watermark') || lower.includes('invalid watermark')) {
+        return { Code: 'WATERMARK_INVALID', Severity: 'Warning' };
+    }
+    if (lower.includes('configuration') || lower.includes('config')) {
+        return { Code: 'CONFIGURATION_ERROR', Severity: 'Critical' };
+    }
+    if (lower.includes('connect') || lower.includes('econnrefused') || lower.includes('sql')) {
+        return { Code: 'DATABASE_ERROR', Severity: 'Critical' };
+    }
+    if (lower.includes('connector')) {
+        return { Code: 'CONNECTOR_ERROR', Severity: 'Critical' };
+    }
+    return { Code: 'UNKNOWN_ERROR', Severity: 'Critical' };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,10 +1,33 @@
 {
   "name": "@memberjunction/integration-engine",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/integration-engine",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.9.0",
+  "description": "MemberJunction Integration Engine - orchestration, field mapping, and connector framework",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@memberjunction/core": "5.9.0",
+    "@memberjunction/core-entities": "5.9.0",
+    "@memberjunction/global": "5.9.0",
+    "@memberjunction/integration-engine-base": "5.9.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "tsc-alias": "^1.8.16",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC"
 }