@memberjunction/integration-engine 0.0.1 → 5.9.0

package/dist/BaseRESTIntegrationConnector.js

@@ -0,0 +1,482 @@
+import { RunView } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { IntegrationEngineBase } from '@memberjunction/integration-engine-base';
+import { BaseIntegrationConnector, } from './BaseIntegrationConnector.js';
+/** Maximum number of pages to fetch before stopping (safety limit to prevent infinite loops) */
+const MAX_PAGINATION_PAGES = 200;
+// ─── BaseRESTIntegrationConnector ────────────────────────────────────
+/**
+ * Abstract base class for REST API integration connectors.
+ *
+ * Implements the generic REST sync pattern: reads IntegrationObject/Field
+ * metadata from the MJ database, handles pagination, template variable
+ * resolution (per-parent iteration), and converts raw API responses to
+ * ExternalRecord format.
+ *
+ * Concrete connectors (YourMembership, Salesforce, HubSpot, etc.) extend
+ * this class and implement only auth, HTTP transport, and response normalization.
+ */
+export class BaseRESTIntegrationConnector extends BaseIntegrationConnector {
+    // ── BaseIntegrationConnector implementations ─────────────────────
+    /**
+     * Discovers available objects from the IntegrationEngineBase cache.
+     */
+    async DiscoverObjects(companyIntegration, _contextUser) {
+        const objects = IntegrationEngineBase.Instance.GetActiveIntegrationObjects(companyIntegration.IntegrationID);
+        return objects.map(obj => ({
+            Name: obj.Name,
+            Label: obj.DisplayName ?? obj.Name,
+            Description: obj.Description ?? undefined,
+            SupportsIncrementalSync: obj.SupportsIncrementalSync,
+            SupportsWrite: obj.SupportsWrite,
+        }));
+    }
+    /**
+     * Discovers fields for a specific object from the IntegrationEngineBase cache.
+     */
+    async DiscoverFields(companyIntegration, objectName, _contextUser) {
+        const obj = this.GetCachedObject(companyIntegration.IntegrationID, objectName);
+        const fields = this.GetCachedFields(obj.ID);
+        return fields.map(f => this.FieldEntityToSchema(f));
+    }
+    /**
+     * Builds SourceSchemaInfo from IntegrationEngineBase cached metadata.
+     * Provides richer metadata than the base class implementation, including
+     * FK relationships derived from RelatedIntegrationObjectID.
+     */
+    async IntrospectSchema(companyIntegration, _contextUser) {
+        const integrationID = companyIntegration.IntegrationID;
+        const objects = IntegrationEngineBase.Instance.GetActiveIntegrationObjects(integrationID);
+        const result = { Objects: [] };
+        for (const obj of objects) {
+            const fields = this.GetCachedFields(obj.ID);
+            const sourceObject = this.BuildSourceObjectInfo(obj, fields, objects);
+            result.Objects.push(sourceObject);
+        }
+        return result;
+    }
+    /**
+     * Fetches records from the external REST API using metadata-driven configuration.
+     * Handles both flat endpoints and template-variable (per-parent) endpoints.
+     */
+    async FetchChanges(ctx) {
+        const obj = this.GetCachedObject(ctx.CompanyIntegration.IntegrationID, ctx.ObjectName);
+        const fields = this.GetCachedFields(obj.ID);
+        const auth = await this.Authenticate(ctx.CompanyIntegration);
+        const baseURL = this.GetBaseURL(ctx.CompanyIntegration);
+        const templateVars = this.DetectTemplateVars(obj.APIPath);
+        if (templateVars.length > 0) {
+            return this.FetchWithTemplateVars(auth, baseURL, obj, fields, templateVars, ctx);
+        }
+        return this.FetchFlat(auth, baseURL, obj, fields, ctx);
+    }
+    // ── Flat fetch (no template variables) ───────────────────────────
+    /**
+     * Fetches records from a flat endpoint (no template variable substitution).
+     */
+    async FetchFlat(auth, baseURL, obj, fields, ctx) {
+        const fullPath = this.BuildFullURL(baseURL, obj.APIPath);
+        const result = await this.FetchWithPagination(auth, fullPath, obj, ctx.BatchSize);
+        const pkFieldName = this.FindPrimaryKeyFieldName(fields);
+        return {
+            Records: result.Records.map(r => this.ToExternalRecord(r, ctx.ObjectName, pkFieldName)),
+            HasMore: result.HasMore,
+        };
+    }
+    // ── Per-parent fetch (template variables) ────────────────────────
+    /**
+     * Fetches records from a template-variable endpoint by iterating over parent records.
+     * Identifies the parent object from FK field metadata, loads parent IDs from the
+     * local database, then fetches child records per parent.
+     */
+    async FetchWithTemplateVars(auth, baseURL, obj, fields, templateVars, ctx) {
+        const parentInfo = this.ResolveParentInfo(fields, templateVars, ctx.CompanyIntegration.IntegrationID);
+        if (!parentInfo) {
+            console.warn(`[BaseRESTIntegrationConnector] Skipping "${obj.Name}": template variables ` +
+                `[${templateVars.join(', ')}] could not be resolved to a parent object.`);
+            return { Records: [], HasMore: false };
+        }
+        const parentIDs = await this.LoadParentIDs(parentInfo.parentObjectID, ctx.ContextUser);
+        const pkFieldName = this.FindPrimaryKeyFieldName(fields);
+        const allRecords = [];
+        for (const parentID of parentIDs) {
+            const resolvedPath = this.SubstituteTemplateVars(obj.APIPath, parentInfo.templateVar, parentID);
+            const fullURL = this.BuildFullURL(baseURL, resolvedPath);
+            const result = await this.FetchWithPagination(auth, fullURL, obj, ctx.BatchSize - allRecords.length);
+            const tagged = result.Records.map(r => {
+                r[parentInfo.fkFieldName] = parentID;
+                return this.ToExternalRecord(r, ctx.ObjectName, pkFieldName);
+            });
+            allRecords.push(...tagged);
+            if (allRecords.length >= ctx.BatchSize)
+                break;
+        }
+        return { Records: allRecords, HasMore: false };
+    }
+    /**
+     * Resolves which template variable maps to which FK field + parent object.
+     *
+     * Resolution strategy (in order):
+     * 1. Explicit: FK field with RelatedIntegrationObjectID that matches a template var name
+     * 2. PK fallback: finds a sibling integration object whose primary key field name
+     *    matches the template var, allowing resolution without explicit FK metadata
+     *
+     * Returns null if no match is found by either strategy.
+     */
+    ResolveParentInfo(fields, templateVars, integrationID) {
+        // Strategy 1: Explicit FK field with RelatedIntegrationObjectID
+        for (const field of fields) {
+            if (!field.RelatedIntegrationObjectID)
+                continue;
+            for (const tVar of templateVars) {
+                if (field.Name.toLowerCase().includes(tVar.toLowerCase())) {
+                    return {
+                        templateVar: tVar,
+                        fkFieldName: field.Name,
+                        parentObjectID: field.RelatedIntegrationObjectID,
+                    };
+                }
+            }
+        }
+        // Strategy 2: Match template var against PK fields of sibling objects
+        return this.ResolveParentByPKMatch(templateVars, integrationID);
+    }
+    /**
+     * Fallback resolution: finds a sibling integration object whose primary key
+     * field name matches one of the template variables (case-insensitive).
+     * E.g., {ProfileID} matches Members object which has PK field "ProfileID".
+     */
+    ResolveParentByPKMatch(templateVars, integrationID) {
+        const siblingObjects = IntegrationEngineBase.Instance.GetActiveIntegrationObjects(integrationID);
+        for (const tVar of templateVars) {
+            const tVarLower = tVar.toLowerCase();
+            for (const sibling of siblingObjects) {
+                const siblingFields = IntegrationEngineBase.Instance.GetIntegrationObjectFields(sibling.ID);
+                const pkField = siblingFields.find(f => f.IsPrimaryKey);
+                if (!pkField)
+                    continue;
+                if (pkField.Name.toLowerCase() === tVarLower) {
+                    return {
+                        templateVar: tVar,
+                        fkFieldName: tVar, // Use the template var name as the FK field name
+                        parentObjectID: sibling.ID,
+                    };
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Loads parent record IDs from the local MJ database.
+     * Uses IntegrationEngineBase cache for object/field metadata lookups,
+     * then queries the MJ entity via RunView for actual synced record IDs.
+     */
+    async LoadParentIDs(parentObjectID, contextUser) {
+        // Use engine cache for metadata lookups
+        const parentObj = IntegrationEngineBase.Instance.GetIntegrationObjectByID(parentObjectID);
+        if (!parentObj) {
+            throw new Error(`Parent IntegrationObject not found: ${parentObjectID}`);
+        }
+        const parentFields = this.GetCachedFields(parentObj.ID);
+        const pkField = parentFields.find(f => f.IsPrimaryKey);
+        const pkFieldName = pkField ? pkField.Name : 'ID';
+        // Query the parent object's corresponding MJ entity for synced records
+        const rv = new RunView();
+        const entityMapResult = await rv.RunView({
+            EntityName: 'MJ: Company Integration Entity Maps',
+            ExtraFilter: `ExternalObjectName='${parentObj.Name}' AND SyncEnabled=1`,
+            Fields: ['EntityID', 'Entity'],
+            MaxRows: 1,
+            ResultType: 'simple',
+        }, contextUser);
+        if (!entityMapResult.Success || entityMapResult.Results.length === 0) {
+            return [];
+        }
+        const entityName = entityMapResult.Results[0].Entity;
+        const idResult = await rv.RunView({
+            EntityName: entityName,
+            Fields: [pkFieldName],
+            ResultType: 'simple',
+        }, contextUser);
+        if (!idResult.Success)
+            return [];
+        return idResult.Results.map(r => String(r[pkFieldName]));
+    }
+    // ── Pagination loop ──────────────────────────────────────────────
+    /**
+     * Fetches records from a single URL with pagination support.
+     * Loops through pages until no more data or maxRecords is reached.
+     */
+    async FetchWithPagination(auth, basePath, obj, maxRecords) {
+        if (!obj.SupportsPagination || obj.PaginationType === 'None') {
+            return this.FetchSinglePage(auth, basePath, obj);
+        }
+        return this.FetchPaginatedLoop(auth, basePath, obj, maxRecords);
+    }
+    /**
+     * Fetches a single non-paginated page.
+     */
+    async FetchSinglePage(auth, url, obj) {
+        const requestURL = this.AppendDefaultQueryParams(url, obj);
+        const headers = this.BuildHeaders(auth);
+        const response = await this.MakeHTTPRequest(auth, requestURL, 'GET', headers);
+        this.ValidateHTTPResponse(response, requestURL);
+        const records = this.NormalizeResponse(response.Body, obj.ResponseDataKey);
+        return { Records: records, HasMore: false };
+    }
+    /**
+     * Iterates through paginated responses until exhausted or maxRecords is reached.
+     */
+    async FetchPaginatedLoop(auth, basePath, obj, maxRecords) {
+        const allRecords = [];
+        let page = 1;
+        let offset = 0;
+        let cursor;
+        let hasMore = true;
+        let pageCount = 0;
+        let previousFirstRecordKey;
+        while (hasMore && allRecords.length < maxRecords && pageCount < MAX_PAGINATION_PAGES) {
+            pageCount++;
+            const url = this.BuildPaginatedURL(basePath, obj, page, offset, cursor);
+            const requestURL = this.AppendDefaultQueryParams(url, obj);
+            const headers = this.BuildHeaders(auth);
+            const response = await this.MakeHTTPRequest(auth, requestURL, 'GET', headers);
+            this.ValidateHTTPResponse(response, requestURL);
+            const records = this.NormalizeResponse(response.Body, obj.ResponseDataKey);
+            if (records.length === 0) {
+                hasMore = false;
+                break;
+            }
+            // Detect duplicate pages: if the first record matches the previous page's first record,
+            // the API's pagination is broken (returning the same data repeatedly)
+            const currentFirstRecordKey = JSON.stringify(records[0]);
+            if (previousFirstRecordKey !== undefined && currentFirstRecordKey === previousFirstRecordKey) {
+                console.warn(`[BaseRESTIntegrationConnector] Duplicate page detected for "${obj.Name}" ` +
+                    `on page ${pageCount}. API pagination appears broken. Stopping.`);
+                hasMore = false;
+                break;
+            }
+            previousFirstRecordKey = currentFirstRecordKey;
+            allRecords.push(...records);
+            const paginationState = this.ExtractPaginationInfo(response.Body, obj.PaginationType, page, offset, obj.DefaultPageSize);
+            hasMore = paginationState.HasMore;
+            page = paginationState.NextPage ?? page + 1;
+            offset = paginationState.NextOffset ?? offset + records.length;
+            cursor = paginationState.NextCursor;
+        }
+        if (pageCount >= MAX_PAGINATION_PAGES) {
+            console.warn(`[BaseRESTIntegrationConnector] Pagination safety limit (${MAX_PAGINATION_PAGES} pages) ` +
+                `reached for "${obj.Name}". ${allRecords.length} records fetched so far.`);
+            hasMore = false; // prevent the engine's outer loop from restarting pagination
+        }
+        return { Records: allRecords, HasMore: hasMore };
+    }
+    // ── URL building helpers ─────────────────────────────────────────
+    /**
+     * Combines baseURL and apiPath into a full URL.
+     */
+    BuildFullURL(baseURL, apiPath) {
+        const base = baseURL.endsWith('/') ? baseURL.slice(0, -1) : baseURL;
+        const path = apiPath.startsWith('/') ? apiPath : `/${apiPath}`;
+        return `${base}${path}`;
+    }
+    /**
+     * Appends pagination parameters to a URL based on the object's PaginationType.
+     * Override in subclasses to use vendor-specific parameter names.
+     */
+    BuildPaginatedURL(basePath, obj, page, offset, cursor) {
+        const separator = basePath.includes('?') ? '&' : '?';
+        switch (obj.PaginationType) {
+            case 'PageNumber':
+                return `${basePath}${separator}page=${page}&pageSize=${obj.DefaultPageSize}`;
+            case 'Offset':
+                return `${basePath}${separator}offset=${offset}&limit=${obj.DefaultPageSize}`;
+            case 'Cursor':
+                return cursor
+                    ? `${basePath}${separator}cursor=${encodeURIComponent(cursor)}&limit=${obj.DefaultPageSize}`
+                    : `${basePath}${separator}limit=${obj.DefaultPageSize}`;
+            default:
+                return basePath;
+        }
+    }
+    /**
+     * Appends default query parameters from the IntegrationObject metadata.
+     * DefaultQueryParams is stored as a JSON object like {"key": "value"}.
+     * Automatically skips params whose key (case-insensitive) already appears
+     * in the URL to avoid duplicates with pagination params.
+     */
+    AppendDefaultQueryParams(url, obj) {
+        if (!obj.DefaultQueryParams)
+            return url;
+        try {
+            const params = JSON.parse(obj.DefaultQueryParams);
+            const entries = Object.entries(params);
+            if (entries.length === 0)
+                return url;
+            // Extract existing param keys from the URL (case-insensitive) to avoid duplicates
+            const existingKeys = this.ExtractURLParamKeys(url);
+            // Filter out any default params whose key already exists in the URL
+            const filtered = entries.filter(([k]) => !existingKeys.has(k.toLowerCase()));
+            if (filtered.length === 0)
+                return url;
+            const separator = url.includes('?') ? '&' : '?';
+            const queryString = filtered
+                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+                .join('&');
+            return `${url}${separator}${queryString}`;
+        }
+        catch {
+            console.warn(`[BaseRESTIntegrationConnector] Invalid DefaultQueryParams JSON for object "${obj.Name}"`);
+            return url;
+        }
+    }
+    /**
+     * Extracts query parameter keys from a URL, returned as a Set of lowercase strings.
+     * Used to detect duplicates between pagination params and DefaultQueryParams.
+     */
+    ExtractURLParamKeys(url) {
+        const keys = new Set();
+        const qIndex = url.indexOf('?');
+        if (qIndex < 0)
+            return keys;
+        const queryString = url.substring(qIndex + 1);
+        for (const pair of queryString.split('&')) {
+            const eqIndex = pair.indexOf('=');
+            const key = eqIndex >= 0 ? pair.substring(0, eqIndex) : pair;
+            keys.add(decodeURIComponent(key).toLowerCase());
+        }
+        return keys;
+    }
+    // ── Template variable helpers ────────────────────────────────────
+    /**
+     * Detects template variables in an API path. Template variables use
+     * the format {VariableName} (e.g., "/profiles/{ProfileID}/events").
+     */
+    DetectTemplateVars(apiPath) {
+        const matches = apiPath.match(/\{(\w+)\}/g);
+        return matches ? matches.map(m => m.slice(1, -1)) : [];
+    }
+    /**
+     * Substitutes a single template variable in a path.
+     */
+    SubstituteTemplateVars(apiPath, varName, value) {
+        return apiPath.replace(`{${varName}}`, encodeURIComponent(value));
+    }
+    // ── Cached metadata accessors ───────────────────────────────────
+    /**
+     * Gets an IntegrationObject from the engine's cache by integration ID and object name.
+     * Throws if not found.
+     */
+    GetCachedObject(integrationID, objectName) {
+        const obj = IntegrationEngineBase.Instance.GetIntegrationObject(integrationID, objectName);
+        if (!obj) {
+            throw new Error(`IntegrationObject not found: "${objectName}" for integration ${integrationID}`);
+        }
+        return obj;
+    }
+    /**
+     * Gets IntegrationObjectField records from the engine's cache for a given object ID.
+     * Returns only active fields sorted by Sequence.
+     */
+    GetCachedFields(objectID) {
+        return IntegrationEngineBase.Instance.GetIntegrationObjectFields(objectID)
+            .filter(f => f.Status === 'Active')
+            .sort((a, b) => a.Sequence - b.Sequence);
+    }
+    // ── Conversion helpers ───────────────────────────────────────────
+    /**
+     * Converts a raw API record object to the ExternalRecord format.
+     */
+    ToExternalRecord(raw, objectType, pkFieldName) {
+        const externalID = raw[pkFieldName] != null ? String(raw[pkFieldName]) : '';
+        return {
+            ExternalID: externalID,
+            ObjectType: objectType,
+            Fields: raw,
+        };
+    }
+    /**
+     * Finds the primary key field name from a set of IntegrationObjectField records.
+     * Falls back to "ID" if no PK field is explicitly marked.
+     */
+    FindPrimaryKeyFieldName(fields) {
+        const pkField = fields.find(f => f.IsPrimaryKey);
+        return pkField ? pkField.Name : 'ID';
+    }
+    /**
+     * Converts an IntegrationObjectFieldEntity to the ExternalFieldSchema format.
+     */
+    FieldEntityToSchema(f) {
+        return {
+            Name: f.Name,
+            Label: f.DisplayName ?? f.Name,
+            Description: f.Description ?? undefined,
+            DataType: f.Type,
+            IsRequired: f.IsRequired,
+            IsUniqueKey: f.IsUniqueKey,
+            IsReadOnly: f.IsReadOnly,
+            IsForeignKey: f.RelatedIntegrationObjectID != null,
+            ForeignKeyTarget: f.RelatedIntegrationObject ?? null,
+        };
+    }
+    /**
+     * Builds a SourceObjectInfo from an IntegrationObject and its fields.
+     * Resolves FK relationships using the RelatedIntegrationObjectID.
+     */
+    BuildSourceObjectInfo(obj, fields, allObjects) {
+        const relationships = this.BuildRelationships(fields, allObjects);
+        return {
+            ExternalName: obj.Name,
+            ExternalLabel: obj.DisplayName ?? obj.Name,
+            Description: obj.Description ?? undefined,
+            Fields: fields.map(f => ({
+                Name: f.Name,
+                Label: f.DisplayName ?? f.Name,
+                Description: f.Description ?? undefined,
+                SourceType: f.Type,
+                IsRequired: f.IsRequired,
+                MaxLength: f.Length,
+                Precision: f.Precision,
+                Scale: f.Scale,
+                DefaultValue: f.DefaultValue,
+                IsPrimaryKey: f.IsPrimaryKey,
+                IsForeignKey: f.RelatedIntegrationObjectID != null,
+                ForeignKeyTarget: f.RelatedIntegrationObject ?? null,
+            })),
+            PrimaryKeyFields: fields.filter(f => f.IsPrimaryKey).map(f => f.Name),
+            Relationships: relationships,
+        };
+    }
+    /**
+     * Builds SourceRelationshipInfo entries from FK fields.
+     */
+    BuildRelationships(fields, allObjects) {
+        const relationships = [];
+        for (const field of fields) {
+            if (!field.RelatedIntegrationObjectID)
+                continue;
+            const targetObj = allObjects.find(o => UUIDsEqual(o.ID, field.RelatedIntegrationObjectID));
+            if (!targetObj)
+                continue;
+            relationships.push({
+                FieldName: field.Name,
+                TargetObject: targetObj.Name,
+                TargetField: field.RelatedIntegrationObjectFieldName ?? 'ID',
+            });
+        }
+        return relationships;
+    }
+    // ── Validation ───────────────────────────────────────────────────
+    /**
+     * Validates an HTTP response and throws a descriptive error on non-2xx status.
+     */
+    ValidateHTTPResponse(response, url) {
+        if (response.Status < 200 || response.Status >= 300) {
+            const bodyPreview = typeof response.Body === 'string'
+                ? response.Body.slice(0, 500)
+                : JSON.stringify(response.Body).slice(0, 500);
+            throw new Error(`HTTP ${response.Status} from ${url}: ${bodyPreview}`);
+        }
+    }
+}
+//# sourceMappingURL=BaseRESTIntegrationConnector.js.map

package/dist/BaseRESTIntegrationConnector.js.map

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

package/dist/ConnectorFactory.d.ts

@@ -0,0 +1,28 @@
+import type { MJIntegrationEntity } from '@memberjunction/core-entities';
+import { BaseIntegrationConnector } from './BaseIntegrationConnector.js';
+/**
+ * Factory for resolving integration connectors using MJGlobal.ClassFactory.
+ * Connectors register themselves via `@RegisterClass(BaseIntegrationConnector, 'DriverClassName')`.
+ *
+ * Resolution uses the `ClassName` field on the Integration entity directly —
+ * IntegrationSourceType is a general category (SaaS API, Database, File Feed)
+ * and is NOT used for connector lookup.
+ */
+export declare class ConnectorFactory {
+    /**
+     * Resolves and instantiates the appropriate connector for an integration.
+     * Uses `integration.ClassName` to look up the registered connector class
+     * in MJGlobal.ClassFactory.
+     *
+     * @param integration - The integration entity defining which external system to connect to
+     * @returns An instance of the appropriate BaseIntegrationConnector subclass
+     * @throws Error if ClassName is missing or no connector is registered for it
+     */
+    static Resolve(integration: MJIntegrationEntity): BaseIntegrationConnector;
+    /**
+     * Creates a connector instance via MJGlobal.ClassFactory.
+     * First verifies a registration exists to avoid falling back to the abstract base class.
+     */
+    private static CreateConnectorInstance;
+}
+//# sourceMappingURL=ConnectorFactory.d.ts.map

package/dist/ConnectorFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorFactory.d.ts","sourceRoot":"","sources":["../src/ConnectorFactory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IACzB;;;;;;;;OAQG;WACW,OAAO,CACjB,WAAW,EAAE,mBAAmB,GACjC,wBAAwB;IAW3B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAoBzC"}

package/dist/ConnectorFactory.js

@@ -0,0 +1,42 @@
+import { MJGlobal } from '@memberjunction/global';
+import { BaseIntegrationConnector } from './BaseIntegrationConnector.js';
+/**
+ * Factory for resolving integration connectors using MJGlobal.ClassFactory.
+ * Connectors register themselves via `@RegisterClass(BaseIntegrationConnector, 'DriverClassName')`.
+ *
+ * Resolution uses the `ClassName` field on the Integration entity directly —
+ * IntegrationSourceType is a general category (SaaS API, Database, File Feed)
+ * and is NOT used for connector lookup.
+ */
+export class ConnectorFactory {
+    /**
+     * Resolves and instantiates the appropriate connector for an integration.
+     * Uses `integration.ClassName` to look up the registered connector class
+     * in MJGlobal.ClassFactory.
+     *
+     * @param integration - The integration entity defining which external system to connect to
+     * @returns An instance of the appropriate BaseIntegrationConnector subclass
+     * @throws Error if ClassName is missing or no connector is registered for it
+     */
+    static Resolve(integration) {
+        const className = integration.ClassName;
+        if (!className) {
+            throw new Error(`Integration "${integration.Name}" does not have a ClassName configured.`);
+        }
+        return ConnectorFactory.CreateConnectorInstance(className);
+    }
+    /**
+     * Creates a connector instance via MJGlobal.ClassFactory.
+     * First verifies a registration exists to avoid falling back to the abstract base class.
+     */
+    static CreateConnectorInstance(driverClass) {
+        const registration = MJGlobal.Instance.ClassFactory.GetRegistration(BaseIntegrationConnector, driverClass);
+        if (!registration) {
+            throw new Error(`No connector registered for driver class "${driverClass}". ` +
+                `Ensure a class is decorated with @RegisterClass(BaseIntegrationConnector, '${driverClass}').`);
+        }
+        const instance = MJGlobal.Instance.ClassFactory.CreateInstance(BaseIntegrationConnector, driverClass);
+        return instance;
+    }
+}
+//# sourceMappingURL=ConnectorFactory.js.map

package/dist/ConnectorFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorFactory.js","sourceRoot":"","sources":["../src/ConnectorFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IACzB;;;;;;;;OAQG;IACI,MAAM,CAAC,OAAO,CACjB,WAAgC;QAEhC,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QACxC,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACX,gBAAgB,WAAW,CAAC,IAAI,yCAAyC,CAC5E,CAAC;QACN,CAAC;QAED,OAAO,gBAAgB,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,uBAAuB,CAAC,WAAmB;QACtD,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,eAAe,CAC/D,wBAAwB,EACxB,WAAW,CACd,CAAC;QAEF,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACX,6CAA6C,WAAW,KAAK;gBAC7D,8EAA8E,WAAW,KAAK,CACjG,CAAC;QACN,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAC1D,wBAAwB,EACxB,WAAW,CACd,CAAC;QAEF,OAAO,QAAS,CAAC;IACrB,CAAC;CACJ"}