@memberjunction/integration-connectors 5.51.0 → 6.1.0-edge.1

package/dist/ConstantContactConnector.js

@@ -1,663 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { RegisterClass } from '@memberjunction/global';
-import { Metadata } from '@memberjunction/core';
-import { BaseIntegrationConnector, BaseRESTIntegrationConnector, } from '@memberjunction/integration-engine';
-// ─── Constants ─────────────────────────────────────────────────────────
-const CC_BASE_URL = 'https://api.cc.email/v3';
-const CC_TOKEN_URL = 'https://authz.constantcontact.com/oauth2/default/v1/token';
-const DEFAULT_MAX_RETRIES = 4;
-const DEFAULT_REQUEST_TIMEOUT_MS = 60_000;
-/** Keeps us below the 4 req/sec rate limit (~250ms * 4 = 1 sec). */
-const DEFAULT_MIN_REQUEST_INTERVAL_MS = 260;
-const TOKEN_REFRESH_BUFFER_MS = 60_000;
-// ─── Connector ─────────────────────────────────────────────────────────
-/**
- * Connector for the Constant Contact V3 REST API.
- *
- * Extends BaseRESTIntegrationConnector so the generic metadata-driven fetch
- * loop handles pagination, template variables, and record normalization.
- *
- * Constant Contact-specific behavior:
- *   - OAuth 2.0 Authorization Code flow with rotating refresh tokens
- *     (the connector persists the newest refresh token after each refresh)
- *   - Cursor pagination via `_links.next.href` (full URL)
- *   - Incremental sync via `updated_after=<iso>` query param on list endpoints
- *   - Async bulk operations via the `/activities` endpoint family (read-only here;
- *     creation of activity jobs is exposed as separate actions)
- *
- * Rate limits: 10,000 calls/day and 4 calls/sec per account.
- * Reference: https://developer.constantcontact.com/api_reference/
- */
-let ConstantContactConnector = class ConstantContactConnector extends BaseRESTIntegrationConnector {
-    constructor() {
-        super(...arguments);
-        this.authState = null;
-        this.lastRequestTime = 0;
-        /** Current watermark for the in-flight FetchChanges — used by AppendDefaultQueryParams */
-        this.currentWatermark = null;
-        /** Cursor URL returned by the previous page — keeps the base class cursor loop happy. */
-        this.lastNextCursorUrl = null;
-    }
-    // ── Capability flags ────────────────────────────────────────────
-    get SupportsCreate() { return true; }
-    get SupportsUpdate() { return true; }
-    get SupportsDelete() { return true; }
-    get SupportsSearch() { return false; }
-    get SupportsListing() { return false; }
-    get IntegrationName() { return 'Constant Contact'; }
-    // ── Abstract method implementations ─────────────────────────────
-    async Authenticate(companyIntegration, contextUser) {
-        return this.GetAuth(companyIntegration, contextUser);
-    }
-    BuildHeaders(auth) {
-        const ccAuth = auth;
-        return {
-            'Authorization': `Bearer ${ccAuth.Token}`,
-            'Accept': 'application/json',
-        };
-    }
-    async MakeHTTPRequest(auth, url, method, headers, body) {
-        const ccAuth = auth;
-        const maxRetries = ccAuth.Config.MaxRetries ?? DEFAULT_MAX_RETRIES;
-        const timeoutMs = ccAuth.Config.RequestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
-        const minInterval = ccAuth.Config.MinRequestIntervalMs ?? DEFAULT_MIN_REQUEST_INTERVAL_MS;
-        const effectiveHeaders = { ...headers };
-        if (body !== undefined && !effectiveHeaders['Content-Type']) {
-            effectiveHeaders['Content-Type'] = 'application/json';
-        }
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
-            await this.Throttle(minInterval);
-            const response = await this.ExecuteFetch(url, method, effectiveHeaders, body, timeoutMs);
-            this.lastRequestTime = Date.now();
-            if (response.status === 401 && attempt < maxRetries) {
-                this.authState = null;
-                const fresh = await this.GetAuth(ccAuth.Config);
-                ccAuth.Token = fresh.Token;
-                ccAuth.ExpiresAt = fresh.ExpiresAt;
-                effectiveHeaders['Authorization'] = `Bearer ${fresh.Token}`;
-                continue;
-            }
-            if (this.ShouldRetry(response.status) && attempt < maxRetries) {
-                const delay = this.ComputeRetryDelay(response, attempt);
-                await this.Sleep(delay);
-                continue;
-            }
-            return this.BuildRESTResponse(response);
-        }
-        throw new Error(`Constant Contact API request failed after ${maxRetries} attempt(s): ${url}`);
-    }
-    NormalizeResponse(rawBody, responseDataKey) {
-        if (rawBody == null)
-            return [];
-        // Capture cursor link for the next page, regardless of data key
-        if (typeof rawBody === 'object' && !Array.isArray(rawBody)) {
-            const record = rawBody;
-            const links = record['_links'];
-            this.lastNextCursorUrl = links?.next?.href ?? null;
-            if (responseDataKey && Array.isArray(record[responseDataKey])) {
-                return record[responseDataKey];
-            }
-            // Single-object response (e.g., GET /contacts/{id})
-            if (!responseDataKey) {
-                return [record];
-            }
-            return [];
-        }
-        if (Array.isArray(rawBody)) {
-            this.lastNextCursorUrl = null;
-            return rawBody;
-        }
-        return [];
-    }
-    ExtractPaginationInfo(_rawBody, paginationType, _currentPage, _currentOffset, _pageSize) {
-        if (paginationType === 'None')
-            return { HasMore: false };
-        const nextUrl = this.lastNextCursorUrl;
-        if (!nextUrl)
-            return { HasMore: false };
-        return { HasMore: true, NextCursor: nextUrl };
-    }
-    GetBaseURL(_companyIntegration, _auth) {
-        return CC_BASE_URL;
-    }
-    /**
-     * Constant Contact pagination uses a full `_links.next.href` URL. When the
-     * engine supplies a cursor that is already an absolute URL we honor it as-is;
-     * otherwise we append the `limit` query param to the base path.
-     */
-    BuildPaginatedURL(basePath, obj, _page, _offset, cursor, effectivePageSize) {
-        if (cursor && this.IsAbsoluteURL(cursor)) {
-            return cursor;
-        }
-        const pageSize = effectivePageSize ?? obj.DefaultPageSize ?? 50;
-        const separator = basePath.includes('?') ? '&' : '?';
-        return `${basePath}${separator}limit=${pageSize}`;
-    }
-    /**
-     * Inject watermark filter (updated_after=<iso>) when an incremental sync is active.
-     * Skip the injection when the URL is already an absolute cursor URL (the
-     * cursor preserves the original filter state on subsequent pages).
-     */
-    AppendDefaultQueryParams(url, obj) {
-        if (this.IsAbsoluteCursorURL(url))
-            return url;
-        let result = super.AppendDefaultQueryParams(url, obj);
-        if (this.currentWatermark && obj.SupportsIncrementalSync) {
-            const separator = result.includes('?') ? '&' : '?';
-            result = `${result}${separator}updated_after=${encodeURIComponent(this.currentWatermark)}`;
-        }
-        return result;
-    }
-    // ── Public API: TestConnection, FetchChanges, CRUD ──────────────
-    async TestConnection(companyIntegration, contextUser) {
-        try {
-            const auth = await this.GetAuth(companyIntegration, contextUser, true);
-            const url = `${auth.BaseUrl}/account/summary`;
-            const headers = this.BuildHeaders(auth);
-            const response = await this.MakeHTTPRequest(auth, url, 'GET', headers);
-            if (response.Status >= 200 && response.Status < 300) {
-                return {
-                    Success: true,
-                    Message: 'Connected to Constant Contact V3 API',
-                    ServerVersion: 'Constant Contact V3',
-                };
-            }
-            return { Success: false, Message: `Constant Contact responded HTTP ${response.Status}` };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return { Success: false, Message: `Connection failed: ${message}` };
-        }
-    }
-    /**
-     * Canonical Constant Contact v3 API top-level objects.  Returns the
-     * vendor-documented standard catalog (merged with anything already
-     * persisted in IntegrationObject via super.DiscoverObjects so operator-
-     * curated custom rows aren't lost).  CC's schema is fixed — there are no
-     * "custom tables" to surface, but the per-account custom-fields ARE
-     * discovered via DiscoverFields('Contacts') which queries the live
-     * `/contact_custom_fields` endpoint and merges them into the Contacts
-     * field set.
-     */
-    async DiscoverObjects(companyIntegration, contextUser) {
-        const persisted = await super.DiscoverObjects(companyIntegration, contextUser);
-        const canonical = [
-            { Name: 'Contacts', Label: 'Contacts', Description: 'Contact records (people on mailing lists). v3 API /contacts.', SupportsIncrementalSync: true, SupportsWrite: true },
-            { Name: 'ContactLists', Label: 'Contact Lists', Description: 'Mailing lists. v3 API /contact_lists.', SupportsIncrementalSync: true, SupportsWrite: true },
-            { Name: 'ContactCustomFields', Label: 'Contact Custom Fields', Description: 'Account-defined custom fields available on Contacts. v3 API /contact_custom_fields.', SupportsIncrementalSync: false, SupportsWrite: true },
-            { Name: 'ContactTags', Label: 'Contact Tags', Description: 'Account-defined contact tags. v3 API /contact_tags.', SupportsIncrementalSync: false, SupportsWrite: true },
-            { Name: 'EmailCampaigns', Label: 'Email Campaigns', Description: 'Email campaigns. v3 API /emails.', SupportsIncrementalSync: true, SupportsWrite: true },
-            { Name: 'EmailCampaignActivities', Label: 'Email Campaign Activities', Description: 'Per-campaign send/open/click activity. v3 API /emails/activities.', SupportsIncrementalSync: true, SupportsWrite: false },
-            { Name: 'Segments', Label: 'Segments', Description: 'Audience segments. v3 API /segments.', SupportsIncrementalSync: true, SupportsWrite: true },
-            { Name: 'Activities', Label: 'Activities', Description: 'Bulk activity records (contact import jobs, etc). v3 API /activities.', SupportsIncrementalSync: true, SupportsWrite: false },
-        ];
-        const byName = new Map();
-        for (const o of persisted)
-            byName.set(o.Name.toLowerCase(), o);
-        for (const c of canonical) {
-            if (!byName.has(c.Name.toLowerCase()))
-                byName.set(c.Name.toLowerCase(), c);
-        }
-        return [...byName.values()];
-    }
-    async DiscoverFields(companyIntegration, objectName, contextUser) {
-        const staticFields = await super.DiscoverFields(companyIntegration, objectName, contextUser);
-        // For Contacts, custom fields are account-defined. Runtime-discover them
-        // so mapping UIs can present them even if they aren't in static metadata.
-        if (objectName.toLowerCase() === 'contacts' || objectName.toLowerCase() === 'contact') {
-            try {
-                const customFieldDefs = await this.FetchCustomFieldDefinitions(companyIntegration, contextUser);
-                const customFields = customFieldDefs.map(cf => this.CustomFieldToSchema(cf));
-                return this.MergeFieldSchemas(staticFields, customFields);
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : String(err);
-                console.warn(`[Constant Contact] Custom field discovery failed: ${message}`);
-            }
-        }
-        return staticFields;
-    }
-    async FetchChanges(ctx) {
-        this.currentWatermark = ctx.WatermarkValue;
-        this.lastNextCursorUrl = null;
-        try {
-            const result = await super.FetchChanges(ctx);
-            result.NewWatermarkValue = this.ComputeNewWatermark(result.Records, ctx.WatermarkValue);
-            return result;
-        }
-        finally {
-            this.currentWatermark = null;
-        }
-    }
-    // ── Write operations ────────────────────────────────────────────
-    async CreateRecord(ctx) {
-        const companyIntegration = ctx.CompanyIntegration;
-        const contextUser = ctx.ContextUser;
-        const auth = await this.GetAuth(companyIntegration, contextUser);
-        const path = this.ResolveCRUDPath(ctx.ObjectName);
-        const url = `${auth.BaseUrl}${path}`;
-        const headers = this.BuildHeaders(auth);
-        const response = await this.MakeHTTPRequest(auth, url, 'POST', headers, ctx.Attributes);
-        if (response.Status >= 200 && response.Status < 300) {
-            const body = response.Body;
-            return this.BuildCreatedResult(this.ExtractIdFromRecord(body, ctx.ObjectName), response.Status, ctx.ObjectName);
-        }
-        return this.BuildCRUDError(response, 'CreateRecord', ctx.ObjectName);
-    }
-    async UpdateRecord(ctx) {
-        const companyIntegration = ctx.CompanyIntegration;
-        const contextUser = ctx.ContextUser;
-        const auth = await this.GetAuth(companyIntegration, contextUser);
-        const path = this.ResolveCRUDPath(ctx.ObjectName);
-        const url = `${auth.BaseUrl}${path}/${encodeURIComponent(ctx.ExternalID)}`;
-        const headers = this.BuildHeaders(auth);
-        const method = this.PreferredUpdateMethod(ctx.ObjectName);
-        const response = await this.MakeHTTPRequest(auth, url, method, headers, ctx.Attributes);
-        if (response.Status >= 200 && response.Status < 300) {
-            return { Success: true, ExternalID: ctx.ExternalID, StatusCode: response.Status };
-        }
-        return this.BuildCRUDError(response, 'UpdateRecord', ctx.ObjectName);
-    }
-    async DeleteRecord(ctx) {
-        const companyIntegration = ctx.CompanyIntegration;
-        const contextUser = ctx.ContextUser;
-        const auth = await this.GetAuth(companyIntegration, contextUser);
-        const path = this.ResolveCRUDPath(ctx.ObjectName);
-        const url = `${auth.BaseUrl}${path}/${encodeURIComponent(ctx.ExternalID)}`;
-        const headers = this.BuildHeaders(auth);
-        const response = await this.MakeHTTPRequest(auth, url, 'DELETE', headers);
-        if (response.Status >= 200 && response.Status < 300) {
-            return { Success: true, ExternalID: ctx.ExternalID, StatusCode: response.Status };
-        }
-        return this.BuildCRUDError(response, 'DeleteRecord', ctx.ObjectName);
-    }
-    async GetRecord(ctx) {
-        const companyIntegration = ctx.CompanyIntegration;
-        const contextUser = ctx.ContextUser;
-        const auth = await this.GetAuth(companyIntegration, contextUser);
-        const path = this.ResolveCRUDPath(ctx.ObjectName);
-        const url = `${auth.BaseUrl}${path}/${encodeURIComponent(ctx.ExternalID)}`;
-        const headers = this.BuildHeaders(auth);
-        const response = await this.MakeHTTPRequest(auth, url, 'GET', headers);
-        if (response.Status < 200 || response.Status >= 300)
-            return null;
-        if (response.Body == null || typeof response.Body !== 'object')
-            return null;
-        return {
-            ExternalID: ctx.ExternalID,
-            ObjectType: ctx.ObjectName,
-            Fields: response.Body,
-        };
-    }
-    // ── Default configuration / field mappings ──────────────────────
-    GetDefaultConfiguration() {
-        return {
-            DefaultSchemaName: 'ConstantContact',
-            DefaultObjects: [],
-        };
-    }
-    GetDefaultFieldMappings(objectName, _entityName) {
-        switch (objectName) {
-            case 'Contacts':
-                return [
-                    { SourceFieldName: 'contact_id', DestinationFieldName: 'ExternalID', IsKeyField: true },
-                    { SourceFieldName: 'email_address', DestinationFieldName: 'Email' },
-                    { SourceFieldName: 'first_name', DestinationFieldName: 'FirstName' },
-                    { SourceFieldName: 'last_name', DestinationFieldName: 'LastName' },
-                    { SourceFieldName: 'company_name', DestinationFieldName: 'CompanyName' },
-                    { SourceFieldName: 'job_title', DestinationFieldName: 'JobTitle' },
-                    { SourceFieldName: 'created_at', DestinationFieldName: 'CreatedAt' },
-                    { SourceFieldName: 'updated_at', DestinationFieldName: 'UpdatedAt' },
-                ];
-            case 'ContactLists':
-                return [
-                    { SourceFieldName: 'list_id', DestinationFieldName: 'ExternalID', IsKeyField: true },
-                    { SourceFieldName: 'name', DestinationFieldName: 'Name' },
-                    { SourceFieldName: 'description', DestinationFieldName: 'Description' },
-                    { SourceFieldName: 'membership_count', DestinationFieldName: 'MembershipCount' },
-                ];
-            case 'EmailCampaigns':
-                return [
-                    { SourceFieldName: 'campaign_id', DestinationFieldName: 'ExternalID', IsKeyField: true },
-                    { SourceFieldName: 'name', DestinationFieldName: 'Name' },
-                    { SourceFieldName: 'current_status', DestinationFieldName: 'Status' },
-                    { SourceFieldName: 'type', DestinationFieldName: 'CampaignType' },
-                    { SourceFieldName: 'created_at', DestinationFieldName: 'CreatedAt' },
-                    { SourceFieldName: 'updated_at', DestinationFieldName: 'UpdatedAt' },
-                ];
-            default:
-                return [];
-        }
-    }
-    // ─────────────────────────────────────────────────────────────────
-    //                         Private helpers
-    // ─────────────────────────────────────────────────────────────────
-    // ── Auth helpers ────────────────────────────────────────────────
-    async GetAuth(source, contextUser, forceRefresh = false) {
-        if (!forceRefresh && this.authState && this.IsTokenValid(this.authState)) {
-            return this.authState;
-        }
-        const config = this.IsConfig(source)
-            ? source
-            : await this.ParseConfig(source, contextUser);
-        this.authState = await this.RefreshAccessToken(config, source, contextUser);
-        return this.authState;
-    }
-    IsConfig(src) {
-        return src.ClientId !== undefined
-            && src.RefreshToken !== undefined;
-    }
-    IsTokenValid(auth) {
-        return auth.ExpiresAt.getTime() > Date.now() + TOKEN_REFRESH_BUFFER_MS;
-    }
-    async RefreshAccessToken(config, companyIntegration, contextUser) {
-        const basicAuth = Buffer.from(`${config.ClientId}:${config.ClientSecret}`).toString('base64');
-        const body = new URLSearchParams();
-        body.set('grant_type', 'refresh_token');
-        body.set('refresh_token', config.RefreshToken);
-        const response = await fetch(CC_TOKEN_URL, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Basic ${basicAuth}`,
-                'Content-Type': 'application/x-www-form-urlencoded',
-                'Accept': 'application/json',
-            },
-            body: body.toString(),
-        });
-        if (!response.ok) {
-            const text = await response.text();
-            throw new Error(`Constant Contact token refresh failed (${response.status}): ${text.slice(0, 300)}`);
-        }
-        const payload = await response.json();
-        config.AccessToken = payload.access_token;
-        // Refresh tokens rotate — persist the newest one or auth will break on next refresh.
-        config.RefreshToken = payload.refresh_token;
-        const expiresAt = new Date(Date.now() + (payload.expires_in ?? 86_400) * 1000);
-        // Best-effort: persist the rotated refresh token back to the Credential record.
-        if (companyIntegration?.CredentialID && contextUser) {
-            await this.PersistRotatedRefreshToken(companyIntegration.CredentialID, contextUser, config);
-        }
-        return {
-            Token: payload.access_token,
-            ExpiresAt: expiresAt,
-            Config: config,
-            BaseUrl: CC_BASE_URL,
-        };
-    }
-    /**
-     * Persist the newly-rotated refresh token back to the MJ: Credentials record
-     * so the next cold-start refresh uses the correct token.
-     */
-    async PersistRotatedRefreshToken(credentialID, contextUser, config, provider) {
-        try {
-            const md = provider ?? new Metadata();
-            const credential = await md.GetEntityObject('MJ: Credentials', contextUser);
-            const loaded = await credential.Load(credentialID);
-            if (!loaded || !credential.Values)
-                return;
-            const parsed = JSON.parse(credential.Values);
-            const updated = {
-                ...parsed,
-                RefreshToken: config.RefreshToken,
-            };
-            if (config.AccessToken)
-                updated.AccessToken = config.AccessToken;
-            credential.Values = JSON.stringify(updated);
-            const saved = await credential.Save();
-            if (!saved) {
-                const detail = credential.LatestResult?.CompleteMessage ?? 'unknown';
-                console.warn(`[Constant Contact] Failed to persist rotated refresh token: ${detail}`);
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            console.warn(`[Constant Contact] Refresh-token persistence error: ${message}`);
-        }
-    }
-    // ── Configuration parsing ───────────────────────────────────────
-    async ParseConfig(companyIntegration, contextUser) {
-        if (companyIntegration.CredentialID) {
-            const config = await this.ParseConfigFromCredential(companyIntegration.CredentialID, contextUser);
-            if (config)
-                return config;
-        }
-        if (companyIntegration.Configuration) {
-            const parsed = JSON.parse(companyIntegration.Configuration);
-            return this.ExtractConfig(parsed);
-        }
-        throw new Error('Constant Contact connector requires either CredentialID or Configuration JSON');
-    }
-    async ParseConfigFromCredential(credentialID, contextUser, provider) {
-        const md = provider ?? new Metadata();
-        const credential = await md.GetEntityObject('MJ: Credentials', contextUser);
-        const loaded = await credential.Load(credentialID);
-        if (!loaded || !credential.Values)
-            return null;
-        const values = JSON.parse(credential.Values);
-        return this.ExtractConfig(values);
-    }
-    ExtractConfig(values) {
-        const get = (...keys) => {
-            for (const key of keys) {
-                const hit = Object.entries(values).find(([k]) => k.toLowerCase() === key.toLowerCase());
-                if (hit)
-                    return String(hit[1] ?? '');
-            }
-            return undefined;
-        };
-        const clientId = get('ClientId', 'clientId', 'client_id', 'apiKey', 'api_key');
-        const clientSecret = get('ClientSecret', 'clientSecret', 'client_secret', 'appSecret', 'app_secret');
-        const refreshToken = get('RefreshToken', 'refreshToken', 'refresh_token');
-        if (!clientId)
-            throw new Error('Constant Contact configuration missing required field: ClientId');
-        if (!clientSecret)
-            throw new Error('Constant Contact configuration missing required field: ClientSecret');
-        if (!refreshToken)
-            throw new Error('Constant Contact configuration missing required field: RefreshToken');
-        return {
-            ClientId: clientId,
-            ClientSecret: clientSecret,
-            RefreshToken: refreshToken,
-            AccessToken: get('AccessToken', 'accessToken', 'access_token'),
-            RedirectUri: get('RedirectUri', 'redirectUri', 'redirect_uri'),
-        };
-    }
-    // ── Custom field discovery ──────────────────────────────────────
-    async FetchCustomFieldDefinitions(companyIntegration, contextUser) {
-        const auth = await this.GetAuth(companyIntegration, contextUser);
-        const url = `${auth.BaseUrl}/contact_custom_fields?limit=100`;
-        const headers = this.BuildHeaders(auth);
-        const response = await this.MakeHTTPRequest(auth, url, 'GET', headers);
-        if (response.Status < 200 || response.Status >= 300)
-            return [];
-        const body = response.Body;
-        const arr = body['custom_fields'];
-        return Array.isArray(arr) ? arr : [];
-    }
-    CustomFieldToSchema(cf) {
-        const name = String(cf['name'] ?? cf['label'] ?? 'custom_field');
-        const label = String(cf['label'] ?? name);
-        const type = String(cf['type'] ?? 'string');
-        return {
-            Name: `custom.${name}`,
-            Label: `Custom: ${label}`,
-            Description: `Account custom field (type: ${type})`,
-            DataType: this.MapCustomFieldType(type),
-            IsRequired: false,
-            IsUniqueKey: false,
-            IsReadOnly: false,
-        };
-    }
-    MapCustomFieldType(type) {
-        switch (type.toLowerCase()) {
-            case 'number': return 'decimal';
-            case 'boolean': return 'boolean';
-            case 'date': return 'date';
-            case 'datetime': return 'datetime';
-            case 'currency': return 'decimal';
-            default: return 'string';
-        }
-    }
-    MergeFieldSchemas(staticFields, extra) {
-        const staticNames = new Set(staticFields.map(f => f.Name.toLowerCase()));
-        return [...staticFields, ...extra.filter(f => !staticNames.has(f.Name.toLowerCase()))];
-    }
-    // ── Path + response helpers ─────────────────────────────────────
-    /**
-     * Map MJ IntegrationObject names to Constant Contact REST paths for CRUD.
-     * Object names follow the MJ naming (PascalCase) while the API paths use snake_case.
-     */
-    ResolveCRUDPath(objectName) {
-        switch (objectName) {
-            case 'Contacts': return '/contacts';
-            case 'ContactLists': return '/contact_lists';
-            case 'ContactCustomFields': return '/contact_custom_fields';
-            case 'ContactTags': return '/contact_tags';
-            case 'EmailCampaigns': return '/emails';
-            case 'EmailCampaignActivities': return '/emails/activities';
-            case 'Segments': return '/segments';
-            case 'Activities': return '/activities';
-            default: return `/${objectName}`;
-        }
-    }
-    /**
-     * Some Constant Contact resources accept PATCH for partial updates; most
-     * require PUT for full replace. Default to PUT and promote the handful of
-     * resources that are known to support PATCH.
-     */
-    PreferredUpdateMethod(objectName) {
-        const patchSupported = new Set(['ContactCustomFields', 'Segments', 'ContactTags']);
-        return patchSupported.has(objectName) ? 'PATCH' : 'PUT';
-    }
-    ExtractIdFromRecord(body, objectName) {
-        // Each Constant Contact resource has a named PK; try the most likely ones first.
-        const order = {
-            Contacts: ['contact_id'],
-            ContactLists: ['list_id'],
-            ContactCustomFields: ['custom_field_id'],
-            ContactTags: ['tag_id'],
-            EmailCampaigns: ['campaign_id'],
-            EmailCampaignActivities: ['campaign_activity_id'],
-            Segments: ['segment_id'],
-            Activities: ['activity_id'],
-        };
-        const candidates = order[objectName] ?? ['id'];
-        for (const key of [...candidates, 'id']) {
-            const value = body[key];
-            if (value !== undefined && value !== null)
-                return String(value);
-        }
-        return '';
-    }
-    ComputeNewWatermark(records, current) {
-        const candidateKeys = ['updated_at', 'edited_at', 'modified_at', 'last_updated_at'];
-        let latest;
-        for (const record of records) {
-            for (const key of candidateKeys) {
-                const value = record.Fields[key];
-                if (typeof value === 'string' && (!latest || value > latest))
-                    latest = value;
-            }
-        }
-        if (!latest)
-            return current ?? undefined;
-        if (current && latest <= current)
-            return current;
-        return latest;
-    }
-    // ── HTTP helpers ────────────────────────────────────────────────
-    async ExecuteFetch(url, method, headers, body, timeoutMs) {
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), timeoutMs);
-        try {
-            return await fetch(url, {
-                method,
-                headers,
-                body: body !== undefined ? JSON.stringify(body) : undefined,
-                signal: controller.signal,
-            });
-        }
-        finally {
-            clearTimeout(timer);
-        }
-    }
-    async BuildRESTResponse(response) {
-        const headers = {};
-        response.headers.forEach((v, k) => { headers[k.toLowerCase()] = v; });
-        const contentType = headers['content-type'] ?? '';
-        let bodyValue;
-        if (contentType.includes('application/json')) {
-            bodyValue = await this.ParseJsonSafely(response);
-        }
-        else {
-            bodyValue = await response.text();
-        }
-        return { Status: response.status, Body: bodyValue, Headers: headers };
-    }
-    async ParseJsonSafely(response) {
-        try {
-            return await response.json();
-        }
-        catch {
-            return null;
-        }
-    }
-    ShouldRetry(status) {
-        return status === 429 || status === 502 || status === 503 || status === 504;
-    }
-    ComputeRetryDelay(response, attempt) {
-        const retryAfter = response.headers.get('retry-after');
-        if (retryAfter) {
-            const seconds = Number.parseInt(retryAfter, 10);
-            if (!Number.isNaN(seconds) && seconds > 0)
-                return seconds * 1000;
-        }
-        return Math.min(Math.pow(2, attempt) * 1000, 15_000);
-    }
-    async Throttle(minIntervalMs) {
-        const elapsed = Date.now() - this.lastRequestTime;
-        if (elapsed < minIntervalMs)
-            await this.Sleep(minIntervalMs - elapsed);
-    }
-    Sleep(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-    IsAbsoluteURL(value) {
-        return /^https?:\/\//i.test(value);
-    }
-    IsAbsoluteCursorURL(url) {
-        return this.IsAbsoluteURL(url) && url.startsWith(CC_BASE_URL);
-    }
-    BuildCRUDError(response, operation, objectName) {
-        const body = response.Body;
-        let detail;
-        if (typeof body === 'string') {
-            detail = body.slice(0, 500);
-        }
-        else if (body && typeof body === 'object') {
-            const asRecord = body;
-            const msg = asRecord['error_message'] ?? asRecord['message'] ?? asRecord['error_key'];
-            detail = msg !== undefined ? String(msg) : JSON.stringify(body).slice(0, 500);
-        }
-        else {
-            detail = `HTTP ${response.Status}`;
-        }
-        return {
-            Success: false,
-            ErrorMessage: `Constant Contact ${operation} failed on ${objectName}: ${detail}`,
-            StatusCode: response.Status,
-        };
-    }
-};
-ConstantContactConnector = __decorate([
-    RegisterClass(BaseIntegrationConnector, 'ConstantContactConnector')
-], ConstantContactConnector);
-export { ConstantContactConnector };
-/** Tree-shaking prevention — import and call from module entry point */
-export function LoadConstantContactConnector() { }
-//# sourceMappingURL=ConstantContactConnector.js.map