@memberjunction/connector-mailchimp 2.0.0

package/dist/MailchimpConnector.d.ts

@@ -0,0 +1,182 @@
+import { type UserInfo } from '@memberjunction/core';
+import type { MJCompanyIntegrationEntity, MJIntegrationObjectEntity } from '@memberjunction/core-entities';
+import { BaseRESTIntegrationConnector, type RESTAuthContext, type RESTResponse, type PaginationState, type PaginationType, type ConnectionTestResult, type FetchContext, type FetchBatchResult, type CreateRecordContext, type UpdateRecordContext, type DeleteRecordContext, type CRUDResult, type SourceSchemaInfo } from '@memberjunction/integration-engine';
+/** Extended auth context carrying the resolved Basic/Bearer header + the per-account data center. */
+interface MailchimpAuthContext extends RESTAuthContext {
+    /** Full `Authorization` header value (Basic or Bearer). */
+    AuthHeader: string;
+    /** Resolved data-center prefix used to build every request host (e.g. `us15`). */
+    DataCenter: string;
+    /** Optional explicit full base-URL override (sandbox/test/mock); wins over the dc host in GetBaseURL. */
+    BaseURLOverride?: string;
+}
+/**
+ * Mailchimp Marketing API (v3.0) connector — extends BaseRESTIntegrationConnector (REST/JSON over HTTP).
+ *
+ * Discovery, template-var read traversal (second-layer objects resolve their parent via
+ * Configuration.parentObjectName — e.g. `lists/{list_id}/members` iterates over synced `lists`), and the
+ * paginated GET loop are inherited. This class supplies only the Mailchimp-specific protocol surface:
+ * Basic auth, per-account base URL, offset pagination, per-endpoint incremental date filtering, connection
+ * testing, generic per-operation CRUD with named parent-var path templating, and the §7/§10
+ * sync-efficiency hooks the frozen contract evidences.
+ */
+export declare class MailchimpConnector extends BaseRESTIntegrationConnector {
+    /** Cached auth for the lifetime of a single sync run (Mailchimp API keys don't expire). */
+    private cachedAuth;
+    /** Active watermark for the current FetchChanges call — exposed to AppendDefaultQueryParams. */
+    private currentWatermark;
+    /** Verbatim `MJ: Integrations.Name`. Load-bearing: the T1 three-way name check compares this === metadata Name. */
+    get IntegrationName(): string;
+    get SupportsCreate(): boolean;
+    get SupportsUpdate(): boolean;
+    get SupportsDelete(): boolean;
+    /**
+     * Discovery is NON-authoritative: DiscoverObjects / IntrospectSchema are cache-driven (they re-read
+     * persisted ACTIVE Declared metadata, NOT a live full-gamut enumeration). Mailchimp exposes no complete
+     * describe endpoint; per-list custom merge fields flow through the sample-union enrichment below plus the
+     * framework's custom-column capture. Absence in a refresh proves nothing → never deactivate. Matches the
+     * frozen contract (no complete-gamut describe endpoint).
+     */
+    get DiscoveryIsAuthoritative(): boolean;
+    /**
+     * Mailchimp's documented limit is a CONCURRENCY cap ("a limit of 10 simultaneous connections"), NOT a
+     * documented requests-per-window token rate — and it emits no `X-RateLimit-*` / `Retry-After` headers.
+     * So the evidenced hook is the concurrency ceiling (below); RateLimitPolicy stays null (no token rate to
+     * fabricate — the engine derives a conservative rate) and ExtractRetryAfterMs stays default (nothing to
+     * parse). The internal transport still honors an opportunistic Retry-After on a 429 as defensive backoff.
+     */
+    get MaxConcurrencyHint(): number | null;
+    /**
+     * Sample-union enrichment: Declared metadata is spec-derived and misses a tenant's per-list custom merge
+     * fields. After the base cache-driven introspection, we sample each object's live read shape via
+     * `DiscoverFieldsViaFetch` and UNION it into the declared field set with `mergeDeclaredWithSampledFields`
+     * (never-shrink, declared-wins, capacities widened). Best-effort + parallel; a sample failure leaves the
+     * declared set untouched. We override `IntrospectSchema` (NOT `DiscoverFields` — that would recurse into
+     * `DiscoverFieldsViaFetch`'s own fallback). Connector-agnostic: no Mailchimp-specific field logic.
+     */
+    IntrospectSchema(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<SourceSchemaInfo>;
+    /** Pings the Mailchimp API root (`/ping`) to verify connectivity + authentication (read-only). */
+    TestConnection(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<ConnectionTestResult>;
+    /**
+     * Overridden ONLY to expose the active watermark to AppendDefaultQueryParams (which appends the
+     * per-endpoint `since_<field>` incremental filter). All read traversal — flat, offset-paginated, and
+     * per-parent template-var — is delegated to the inherited base implementation.
+     */
+    FetchChanges(ctx: FetchContext): Promise<FetchBatchResult>;
+    /** Resolves credentials + data center once per run and pre-builds the Authorization header via the helper. */
+    protected Authenticate(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<MailchimpAuthContext>;
+    /** Static request headers; the Authorization value was built once in Authenticate. */
+    protected BuildHeaders(auth: RESTAuthContext): Record<string, string>;
+    /**
+     * HTTP transport (fetch), with bounded 429/503 backoff. Owns the wire boundary; test subclasses override
+     * this to capture the outbound request and return canned responses.
+     */
+    protected MakeHTTPRequest(auth: RESTAuthContext, url: string, method: string, headers: Record<string, string>, body?: unknown): Promise<RESTResponse>;
+    /**
+     * Strips the Mailchimp collection envelope to the per-object record array
+     * (`{ members: [...], total_items }` → ResponseDataKey='members'). A single-record GET (no data key, or
+     * the key absent) is returned as a one-element array. A bare array body passes through unchanged.
+     */
+    protected NormalizeResponse(rawBody: unknown, responseDataKey: string | null): Record<string, unknown>[];
+    /**
+     * Offset pagination: continue while `offset + fetched < total_items` (when the envelope reports a total),
+     * else while a full page came back. The base loop advances `offset` by the fetched count.
+     *
+     * Mailchimp's collection pagination is UNIFORMLY count/offset with a `total_items` count across every
+     * list endpoint — including the single IO the frozen contract classifies `Cursor`
+     * (`audiences/{audience_id}/contacts`), which returns the identical `{ <key>: [...], total_items }`
+     * envelope over the same `count`/`offset` params. So Offset AND Cursor advance by offset+fetched here;
+     * only `None` (and unknown types) are single-page. Treating the lone Cursor IO via the same mechanism
+     * prevents a silent one-page truncation (the endpoint could otherwise drop everything past page 1).
+     * Flagged RequiresLiveVerification in CODE_REPORT — the reality probe could not fill `{audience_id}`.
+     */
+    protected ExtractPaginationInfo(rawBody: unknown, paginationType: PaginationType, _currentPage: number, currentOffset: number, pageSize: number): PaginationState;
+    /** Mailchimp offset pagination params: `count=<n>` (≤1000) + `offset=<n>` (NOT the base default `limit`/`offset`). */
+    protected BuildPaginatedURL(basePath: string, obj: MJIntegrationObjectEntity, _page: number, offset: number, _cursor?: string, effectivePageSize?: number): string;
+    /**
+     * Appends the per-endpoint incremental filter on a watermarked fetch: `since_<IncrementalWatermarkField>`
+     * (Mailchimp's documented date-filter convention — e.g. `since_last_changed` for list members). Only
+     * fires for objects the metadata marks `SupportsIncrementalSync` with a watermark field AND when a
+     * watermark value is present. Then delegates to the base for any metadata-declared DefaultQueryParams.
+     */
+    protected AppendDefaultQueryParams(url: string, obj: MJIntegrationObjectEntity): string;
+    /** Per-account base host. The `/3.0` version segment is included; each object's APIPath is appended by the base. */
+    protected GetBaseURL(_companyIntegration: MJCompanyIntegrationEntity, auth: RESTAuthContext): string;
+    /**
+     * OVERRIDE (idiosyncrasy): Mailchimp single-record paths use NAMED vars (`/campaigns/{campaign_id}`), not
+     * the base's `{ID}` placeholder. Fill each named `{var}` from the ExternalID — left-to-right across the
+     * `|`-split components of a composite ExternalID (mirrors ToExternalRecord's composite-PK join), so a
+     * single-var top-level path takes the whole ExternalID. This makes the INHERITED generic
+     * UpdateRecord / DeleteRecord / GetRecord work for all top-level writable IOs. (Nested paths that carry a
+     * PARENT var not present in the single-key ExternalID are handled by the Create/Update overrides below.)
+     */
+    protected SubstituteIDInPath(path: string, externalID: string, idLocation: string | null): string;
+    /** Create: nested paths fill parent vars from the record attributes; top-level delegates to the generic path. */
+    CreateRecord(ctx: CreateRecordContext): Promise<CRUDResult>;
+    /** Update: nested paths fill parent vars from attributes + the innermost var from the ExternalID; top-level delegates. */
+    UpdateRecord(ctx: UpdateRecordContext): Promise<CRUDResult>;
+    /**
+     * Delete: nested paths resolve every `{var}` from the `|`-split composite ExternalID (right-aligned:
+     * `{list_id}`,`{subscriber_hash}` ← `list1|hashaaa`); top-level delegates. A nested delete whose parent
+     * var still can't be resolved (e.g. a single-component ExternalID that carries only the child key) fails
+     * loudly rather than issuing a request with an unresolved `{parent}` — a live-verification concern flagged
+     * in CODE_REPORT.
+     */
+    DeleteRecord(ctx: DeleteRecordContext): Promise<CRUDResult>;
+    /**
+     * Counts the records in a Mailchimp collection envelope by finding the per-object data array (the first
+     * array-valued property that isn't the `_links` HATEOAS list). Used for pagination advancement — the
+     * data key isn't passed to ExtractPaginationInfo, so we locate the array structurally. Returns 0 for a
+     * single-record body (no array), which correctly reports "no more pages".
+     */
+    private countEnvelopeRecords;
+    /** Extracts `{var}` names from a path template, in left-to-right order. */
+    private detectPathVars;
+    /**
+     * Fills each `{var}` in a nested write path by resolving, per var, in this order:
+     *   1. a same-named attribute on the record (e.g. the base tags fetched children with their parent FK
+     *      field, so a synced member carries `list_id`);
+     *   2. the RIGHT-ALIGNED component of the `|`-split ExternalID — mirroring ToExternalRecord's composite-PK
+     *      join order (`parent|…|child`): the innermost (last) var is the record's OWN key, preceding vars are
+     *      the parent id(s). So a member's ExternalID `list1|hashaaa` fills `{list_id}`→`list1`,
+     *      `{subscriber_hash}`→`hashaaa`, which is exactly what a nested update/delete needs even with no
+     *      attributes present.
+     * Create paths pass externalID=null and thus fill purely from attributes. Any var that resolves to nothing
+     * is left in place so {@link assertPathResolved} / the delete guard can surface it (fail loudly, never
+     * issue a request with an unresolved `{parent}`).
+     */
+    private fillPathFromAttributes;
+    /** Throws a clear error if a nested write path still has unresolved `{var}`s (missing parent id). */
+    private assertPathResolved;
+    /** True when a URL already carries a query param with `name` (case-insensitive). */
+    private urlHasParam;
+    /** Loads credentials from the linked Credential entity (preferred) or the CompanyIntegration Configuration JSON. */
+    private loadCredentials;
+    /** Loads a credential row and parses its Values JSON. */
+    private loadFromCredential;
+    /** Parses a Mailchimp credential/config JSON blob, tolerant of key casing variants. */
+    private parseCredentialJson;
+    /**
+     * Resolves the data-center prefix (e.g. `us15`):
+     *   1. explicit DataCenter / ServerPrefix from config/credential;
+     *   2. the `-<dc>` suffix parsed off the API key;
+     *   3. (runtime fallback for an OAuth bearer token with no dc) the OAuth2 metadata endpoint.
+     * A BaseURLOverride short-circuits the need for a real dc (used for sandbox/test/mock).
+     */
+    private resolveDataCenter;
+    /** Extracts `<dc>` from a Mailchimp API key of the form `<secret>-<dc>` (e.g. `abc123-us15` → `us15`). */
+    private parseDataCenterFromKey;
+    /** Runtime fallback: GET /oauth2/metadata to discover the data center for an OAuth access token. */
+    private fetchDataCenterFromOAuthMetadata;
+    /** Returns the first non-empty string value among the candidate keys, else undefined. */
+    private firstString;
+    /** Returns the first candidate key whose value is a valid absolute http(s) URL, else undefined. */
+    private firstBaseURL;
+    /** Computes a 429/503 backoff delay, honoring an opportunistic Retry-After header when present. */
+    private computeBackoffMs;
+    /** Sleep helper. */
+    private sleep;
+}
+/** Tree-shaking prevention — call from the package entry point. */
+export declare function LoadMailchimpConnector(): void;
+export {};

package/dist/MailchimpConnector.js

@@ -0,0 +1,549 @@
+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, buildBasicAuthHeaderValue, } from '@memberjunction/integration-engine';
+import { mergeDeclaredWithSampledFields } from '@memberjunction/connector-schema-merge';
+// ─── Constants ────────────────────────────────────────────────────────────
+/** OAuth2 metadata endpoint — resolves the data center for an OAuth access token when not otherwise known. */
+const MAILCHIMP_OAUTH_METADATA_URL = 'https://login.mailchimp.com/oauth2/metadata';
+/** Default page size (metadata DefaultPageSize normally supplies this; safe fallback well below the ceiling). */
+const DEFAULT_PAGE_SIZE = 200;
+/** Absolute per-page ceiling enforced by the Mailchimp API (`count` maxes at 1000). */
+const MAX_PAGE_SIZE = 1000;
+/** Basic-auth userid — Mailchimp ignores the userid, so any non-empty string works (`anystring` per docs). */
+const BASIC_AUTH_USERID = 'anystring';
+/** Max in-flight backoff retries for a 429 / 503 transient response. */
+const DEFAULT_MAX_RETRIES = 5;
+// ─── MailchimpConnector ─────────────────────────────────────────────────
+/**
+ * Mailchimp Marketing API (v3.0) connector — extends BaseRESTIntegrationConnector (REST/JSON over HTTP).
+ *
+ * Discovery, template-var read traversal (second-layer objects resolve their parent via
+ * Configuration.parentObjectName — e.g. `lists/{list_id}/members` iterates over synced `lists`), and the
+ * paginated GET loop are inherited. This class supplies only the Mailchimp-specific protocol surface:
+ * Basic auth, per-account base URL, offset pagination, per-endpoint incremental date filtering, connection
+ * testing, generic per-operation CRUD with named parent-var path templating, and the §7/§10
+ * sync-efficiency hooks the frozen contract evidences.
+ */
+let MailchimpConnector = class MailchimpConnector extends BaseRESTIntegrationConnector {
+    constructor() {
+        super(...arguments);
+        /** Cached auth for the lifetime of a single sync run (Mailchimp API keys don't expire). */
+        this.cachedAuth = null;
+        /** Active watermark for the current FetchChanges call — exposed to AppendDefaultQueryParams. */
+        this.currentWatermark = null;
+    }
+    // ── Identity (T1 three-way invariant) ────────────────────────────
+    /** Verbatim `MJ: Integrations.Name`. Load-bearing: the T1 three-way name check compares this === metadata Name. */
+    get IntegrationName() {
+        return 'mailchimp';
+    }
+    // ── Capability getters (kept in lockstep with the per-op metadata columns) ──
+    get SupportsCreate() { return true; }
+    get SupportsUpdate() { return true; }
+    get SupportsDelete() { return true; }
+    /**
+     * Discovery is NON-authoritative: DiscoverObjects / IntrospectSchema are cache-driven (they re-read
+     * persisted ACTIVE Declared metadata, NOT a live full-gamut enumeration). Mailchimp exposes no complete
+     * describe endpoint; per-list custom merge fields flow through the sample-union enrichment below plus the
+     * framework's custom-column capture. Absence in a refresh proves nothing → never deactivate. Matches the
+     * frozen contract (no complete-gamut describe endpoint).
+     */
+    get DiscoveryIsAuthoritative() {
+        return false;
+    }
+    // ── Sync-efficiency hooks (§7/§10 — populated ONLY from evidenced frozen-contract facts) ──
+    /**
+     * Mailchimp's documented limit is a CONCURRENCY cap ("a limit of 10 simultaneous connections"), NOT a
+     * documented requests-per-window token rate — and it emits no `X-RateLimit-*` / `Retry-After` headers.
+     * So the evidenced hook is the concurrency ceiling (below); RateLimitPolicy stays null (no token rate to
+     * fabricate — the engine derives a conservative rate) and ExtractRetryAfterMs stays default (nothing to
+     * parse). The internal transport still honors an opportunistic Retry-After on a 429 as defensive backoff.
+     */
+    get MaxConcurrencyHint() { return 10; }
+    // ── Sample-union field enrichment (MJ connector standard) ─────────
+    /**
+     * Sample-union enrichment: Declared metadata is spec-derived and misses a tenant's per-list custom merge
+     * fields. After the base cache-driven introspection, we sample each object's live read shape via
+     * `DiscoverFieldsViaFetch` and UNION it into the declared field set with `mergeDeclaredWithSampledFields`
+     * (never-shrink, declared-wins, capacities widened). Best-effort + parallel; a sample failure leaves the
+     * declared set untouched. We override `IntrospectSchema` (NOT `DiscoverFields` — that would recurse into
+     * `DiscoverFieldsViaFetch`'s own fallback). Connector-agnostic: no Mailchimp-specific field logic.
+     */
+    async IntrospectSchema(companyIntegration, contextUser) {
+        const info = await super.IntrospectSchema(companyIntegration, contextUser);
+        await Promise.all(info.Objects.map(async (obj) => {
+            try {
+                const sampled = await this.DiscoverFieldsViaFetch(companyIntegration, obj.ExternalName, contextUser);
+                obj.Fields = mergeDeclaredWithSampledFields(obj.Fields, sampled);
+            }
+            catch {
+                /* best-effort — a sample failure leaves the declared fields as-is */
+            }
+        }));
+        return info;
+    }
+    // ── TestConnection ────────────────────────────────────────────────
+    /** Pings the Mailchimp API root (`/ping`) to verify connectivity + authentication (read-only). */
+    async TestConnection(companyIntegration, contextUser) {
+        try {
+            const auth = await this.Authenticate(companyIntegration, contextUser);
+            const url = `${this.GetBaseURL(companyIntegration, auth)}/ping`;
+            const response = await this.MakeHTTPRequest(auth, url, 'GET', this.BuildHeaders(auth));
+            if (response.Status >= 200 && response.Status < 300) {
+                const body = response.Body;
+                return {
+                    Success: true,
+                    Message: `Connected to Mailchimp (${auth.DataCenter}): ${body?.health_status ?? 'OK'}`,
+                    ServerVersion: 'Mailchimp Marketing API v3.0',
+                };
+            }
+            if (response.Status === 401 || response.Status === 403) {
+                return { Success: false, Message: `Mailchimp authentication failed (HTTP ${response.Status}).` };
+            }
+            return { Success: false, Message: `Mailchimp /ping returned HTTP ${response.Status}.` };
+        }
+        catch (err) {
+            return { Success: false, Message: `Connection failed: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+    // ── FetchChanges override (watermark exposure only) ───────────────
+    /**
+     * Overridden ONLY to expose the active watermark to AppendDefaultQueryParams (which appends the
+     * per-endpoint `since_<field>` incremental filter). All read traversal — flat, offset-paginated, and
+     * per-parent template-var — is delegated to the inherited base implementation.
+     */
+    async FetchChanges(ctx) {
+        this.currentWatermark = ctx.WatermarkValue ?? null;
+        try {
+            return await super.FetchChanges(ctx);
+        }
+        finally {
+            this.currentWatermark = null;
+        }
+    }
+    // ── Abstract REST hooks ───────────────────────────────────────────
+    /** Resolves credentials + data center once per run and pre-builds the Authorization header via the helper. */
+    async Authenticate(companyIntegration, contextUser) {
+        if (this.cachedAuth)
+            return this.cachedAuth;
+        const creds = await this.loadCredentials(companyIntegration, contextUser);
+        if (!creds.ApiKey) {
+            throw new Error('Mailchimp connector: no API key found on the Credential or CompanyIntegration Configuration.');
+        }
+        const dataCenter = await this.resolveDataCenter(creds);
+        const authHeader = creds.Scheme === 'bearer'
+            ? `Bearer ${creds.ApiKey}`
+            : buildBasicAuthHeaderValue({ Username: BASIC_AUTH_USERID, Password: creds.ApiKey });
+        this.cachedAuth = {
+            AuthHeader: authHeader,
+            DataCenter: dataCenter,
+            BaseURLOverride: creds.BaseURLOverride,
+        };
+        return this.cachedAuth;
+    }
+    /** Static request headers; the Authorization value was built once in Authenticate. */
+    BuildHeaders(auth) {
+        return {
+            'Authorization': auth.AuthHeader,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        };
+    }
+    /**
+     * HTTP transport (fetch), with bounded 429/503 backoff. Owns the wire boundary; test subclasses override
+     * this to capture the outbound request and return canned responses.
+     */
+    async MakeHTTPRequest(auth, url, method, headers, body) {
+        for (let attempt = 0; attempt <= DEFAULT_MAX_RETRIES; attempt++) {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body !== undefined && body !== null ? JSON.stringify(body) : undefined,
+            });
+            if ((response.status === 429 || response.status === 503) && attempt < DEFAULT_MAX_RETRIES) {
+                await this.sleep(this.computeBackoffMs(response, attempt));
+                continue;
+            }
+            const respHeaders = {};
+            response.headers.forEach((v, k) => { respHeaders[k.toLowerCase()] = v; });
+            const text = await response.text();
+            let parsed = null;
+            if (text.length > 0) {
+                try {
+                    parsed = JSON.parse(text);
+                }
+                catch {
+                    parsed = text;
+                }
+            }
+            return { Status: response.status, Body: parsed, Headers: respHeaders };
+        }
+        throw new Error(`Mailchimp request failed after ${DEFAULT_MAX_RETRIES} retries: ${method} ${url}`);
+    }
+    /**
+     * Strips the Mailchimp collection envelope to the per-object record array
+     * (`{ members: [...], total_items }` → ResponseDataKey='members'). A single-record GET (no data key, or
+     * the key absent) is returned as a one-element array. A bare array body passes through unchanged.
+     */
+    NormalizeResponse(rawBody, responseDataKey) {
+        if (rawBody == null)
+            return [];
+        if (Array.isArray(rawBody))
+            return rawBody;
+        if (typeof rawBody !== 'object')
+            return [];
+        const body = rawBody;
+        if (responseDataKey) {
+            const arr = body[responseDataKey];
+            if (Array.isArray(arr))
+                return arr;
+        }
+        // Single-record / already-unwrapped object (or an empty/mismatched data key).
+        return [body];
+    }
+    /**
+     * Offset pagination: continue while `offset + fetched < total_items` (when the envelope reports a total),
+     * else while a full page came back. The base loop advances `offset` by the fetched count.
+     *
+     * Mailchimp's collection pagination is UNIFORMLY count/offset with a `total_items` count across every
+     * list endpoint — including the single IO the frozen contract classifies `Cursor`
+     * (`audiences/{audience_id}/contacts`), which returns the identical `{ <key>: [...], total_items }`
+     * envelope over the same `count`/`offset` params. So Offset AND Cursor advance by offset+fetched here;
+     * only `None` (and unknown types) are single-page. Treating the lone Cursor IO via the same mechanism
+     * prevents a silent one-page truncation (the endpoint could otherwise drop everything past page 1).
+     * Flagged RequiresLiveVerification in CODE_REPORT — the reality probe could not fill `{audience_id}`.
+     */
+    ExtractPaginationInfo(rawBody, paginationType, _currentPage, currentOffset, pageSize) {
+        if (paginationType !== 'Offset' && paginationType !== 'Cursor')
+            return { HasMore: false };
+        const env = (rawBody && typeof rawBody === 'object' ? rawBody : {});
+        const total = typeof env.total_items === 'number' ? env.total_items : undefined;
+        const fetched = this.countEnvelopeRecords(env);
+        const nextOffset = currentOffset + fetched;
+        const hasMore = total != null ? nextOffset < total : fetched >= pageSize;
+        return { HasMore: hasMore, NextOffset: hasMore ? nextOffset : undefined, TotalRecords: total };
+    }
+    /** Mailchimp offset pagination params: `count=<n>` (≤1000) + `offset=<n>` (NOT the base default `limit`/`offset`). */
+    BuildPaginatedURL(basePath, obj, _page, offset, _cursor, effectivePageSize) {
+        const pageSize = Math.min(effectivePageSize ?? obj.DefaultPageSize ?? DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE);
+        const separator = basePath.includes('?') ? '&' : '?';
+        return `${basePath}${separator}count=${pageSize}&offset=${offset}`;
+    }
+    /**
+     * Appends the per-endpoint incremental filter on a watermarked fetch: `since_<IncrementalWatermarkField>`
+     * (Mailchimp's documented date-filter convention — e.g. `since_last_changed` for list members). Only
+     * fires for objects the metadata marks `SupportsIncrementalSync` with a watermark field AND when a
+     * watermark value is present. Then delegates to the base for any metadata-declared DefaultQueryParams.
+     */
+    AppendDefaultQueryParams(url, obj) {
+        let out = super.AppendDefaultQueryParams(url, obj);
+        if (this.currentWatermark && obj.SupportsIncrementalSync && obj.IncrementalWatermarkField) {
+            const param = `since_${obj.IncrementalWatermarkField}`;
+            if (!this.urlHasParam(out, param)) {
+                out += (out.includes('?') ? '&' : '?') + `${param}=${encodeURIComponent(this.currentWatermark)}`;
+            }
+        }
+        return out;
+    }
+    /** Per-account base host. The `/3.0` version segment is included; each object's APIPath is appended by the base. */
+    GetBaseURL(_companyIntegration, auth) {
+        const ctx = auth;
+        if (ctx.BaseURLOverride)
+            return ctx.BaseURLOverride.replace(/\/+$/, '');
+        return `https://${ctx.DataCenter}.api.mailchimp.com/3.0`;
+    }
+    // ── Path templating ───────────────────────────────────────────────
+    /**
+     * OVERRIDE (idiosyncrasy): Mailchimp single-record paths use NAMED vars (`/campaigns/{campaign_id}`), not
+     * the base's `{ID}` placeholder. Fill each named `{var}` from the ExternalID — left-to-right across the
+     * `|`-split components of a composite ExternalID (mirrors ToExternalRecord's composite-PK join), so a
+     * single-var top-level path takes the whole ExternalID. This makes the INHERITED generic
+     * UpdateRecord / DeleteRecord / GetRecord work for all top-level writable IOs. (Nested paths that carry a
+     * PARENT var not present in the single-key ExternalID are handled by the Create/Update overrides below.)
+     */
+    SubstituteIDInPath(path, externalID, idLocation) {
+        if (idLocation && idLocation !== 'path')
+            return path;
+        const vars = this.detectPathVars(path);
+        if (vars.length === 0)
+            return path;
+        const parts = String(externalID).split('|');
+        let out = path;
+        vars.forEach((v, i) => {
+            const val = parts[i] ?? parts[parts.length - 1] ?? externalID;
+            out = out.replace(`{${v}}`, encodeURIComponent(val));
+        });
+        return out;
+    }
+    // ── CRUD ──────────────────────────────────────────────────────────
+    //
+    // Top-level writable IOs (campaigns, templates, lists, stores, …) use the INHERITED generic
+    // CreateRecord / UpdateRecord / DeleteRecord / GetRecord — all creates are flat-body with the new id at
+    // the response root, and single-var single-record paths resolve via the SubstituteIDInPath override
+    // above. The Create/Update/Delete methods here override ONLY the genuinely idiosyncratic case: NESTED
+    // resources whose write path carries a named PARENT var (`{list_id}`, `{store_id}`, …) that is not part
+    // of the child's single-key ExternalID and must be sourced from the record's own attributes.
+    /** Create: nested paths fill parent vars from the record attributes; top-level delegates to the generic path. */
+    async CreateRecord(ctx) {
+        const ci = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const obj = this.GetCachedObject(ci.IntegrationID, ctx.ObjectName);
+        if (!obj.CreateAPIPath || !obj.CreateMethod)
+            return super.CreateRecord(ctx);
+        if (this.detectPathVars(obj.CreateAPIPath).length === 0)
+            return super.CreateRecord(ctx);
+        const auth = await this.Authenticate(ci, contextUser);
+        const path = this.fillPathFromAttributes(obj.CreateAPIPath, ctx.Attributes, null);
+        this.assertPathResolved(path, ctx.ObjectName, 'create');
+        const url = `${this.GetBaseURL(ci, auth)}${path.startsWith('/') ? path : `/${path}`}`;
+        const body = this.BuildOperationBody(ctx.Attributes, obj.CreateBodyShape, obj.CreateBodyKey);
+        const response = await this.MakeHTTPRequest(auth, url, obj.CreateMethod, this.BuildHeaders(auth), body);
+        if (response.Status >= 200 && response.Status < 300) {
+            const externalID = this.ExtractIDFromResponse(response, obj.CreateIDLocation);
+            return this.BuildCreatedResult(externalID, response.Status, ctx.ObjectName);
+        }
+        return { Success: false, StatusCode: response.Status, ErrorMessage: this.ExtractErrorMessage(response) ?? `HTTP ${response.Status} on create` };
+    }
+    /** Update: nested paths fill parent vars from attributes + the innermost var from the ExternalID; top-level delegates. */
+    async UpdateRecord(ctx) {
+        const ci = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const obj = this.GetCachedObject(ci.IntegrationID, ctx.ObjectName);
+        if (!obj.UpdateAPIPath || !obj.UpdateMethod)
+            return super.UpdateRecord(ctx);
+        if (this.detectPathVars(obj.UpdateAPIPath).length <= 1)
+            return super.UpdateRecord(ctx);
+        const auth = await this.Authenticate(ci, contextUser);
+        const path = this.fillPathFromAttributes(obj.UpdateAPIPath, ctx.Attributes, ctx.ExternalID);
+        this.assertPathResolved(path, ctx.ObjectName, 'update');
+        const url = `${this.GetBaseURL(ci, auth)}${path.startsWith('/') ? path : `/${path}`}`;
+        const body = this.BuildOperationBody(ctx.Attributes, obj.UpdateBodyShape, obj.UpdateBodyKey);
+        const response = await this.MakeHTTPRequest(auth, url, obj.UpdateMethod, this.BuildHeaders(auth), body);
+        if (response.Status >= 200 && response.Status < 300) {
+            return { Success: true, StatusCode: response.Status, ExternalID: ctx.ExternalID };
+        }
+        return { Success: false, StatusCode: response.Status, ErrorMessage: this.ExtractErrorMessage(response) ?? `HTTP ${response.Status} on update` };
+    }
+    /**
+     * Delete: nested paths resolve every `{var}` from the `|`-split composite ExternalID (right-aligned:
+     * `{list_id}`,`{subscriber_hash}` ← `list1|hashaaa`); top-level delegates. A nested delete whose parent
+     * var still can't be resolved (e.g. a single-component ExternalID that carries only the child key) fails
+     * loudly rather than issuing a request with an unresolved `{parent}` — a live-verification concern flagged
+     * in CODE_REPORT.
+     */
+    async DeleteRecord(ctx) {
+        const ci = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const obj = this.GetCachedObject(ci.IntegrationID, ctx.ObjectName);
+        if (!obj.DeleteAPIPath || !obj.DeleteMethod)
+            return super.DeleteRecord(ctx);
+        if (this.detectPathVars(obj.DeleteAPIPath).length <= 1)
+            return super.DeleteRecord(ctx);
+        const auth = await this.Authenticate(ci, contextUser);
+        const path = this.fillPathFromAttributes(obj.DeleteAPIPath, {}, ctx.ExternalID);
+        const unresolved = this.detectPathVars(path);
+        if (unresolved.length > 0) {
+            return {
+                Success: false,
+                StatusCode: 0,
+                ErrorMessage: `Delete of nested "${ctx.ObjectName}" could not resolve parent path var(s) {${unresolved.join(', ')}} — a nested delete needs the parent id, which the delete context does not carry (requires live verification / composite key).`,
+            };
+        }
+        const url = `${this.GetBaseURL(ci, auth)}${path.startsWith('/') ? path : `/${path}`}`;
+        const response = await this.MakeHTTPRequest(auth, url, obj.DeleteMethod, this.BuildHeaders(auth));
+        if (response.Status >= 200 && response.Status < 300) {
+            return { Success: true, StatusCode: response.Status, ExternalID: ctx.ExternalID };
+        }
+        return { Success: false, StatusCode: response.Status, ErrorMessage: this.ExtractErrorMessage(response) ?? `HTTP ${response.Status} on delete` };
+    }
+    // ── Helpers ───────────────────────────────────────────────────────
+    /**
+     * Counts the records in a Mailchimp collection envelope by finding the per-object data array (the first
+     * array-valued property that isn't the `_links` HATEOAS list). Used for pagination advancement — the
+     * data key isn't passed to ExtractPaginationInfo, so we locate the array structurally. Returns 0 for a
+     * single-record body (no array), which correctly reports "no more pages".
+     */
+    countEnvelopeRecords(env) {
+        for (const [key, value] of Object.entries(env)) {
+            if (key === '_links')
+                continue;
+            if (Array.isArray(value))
+                return value.length;
+        }
+        return 0;
+    }
+    /** Extracts `{var}` names from a path template, in left-to-right order. */
+    detectPathVars(path) {
+        const matches = path.match(/\{(\w+)\}/g);
+        return matches ? matches.map(m => m.slice(1, -1)) : [];
+    }
+    /**
+     * Fills each `{var}` in a nested write path by resolving, per var, in this order:
+     *   1. a same-named attribute on the record (e.g. the base tags fetched children with their parent FK
+     *      field, so a synced member carries `list_id`);
+     *   2. the RIGHT-ALIGNED component of the `|`-split ExternalID — mirroring ToExternalRecord's composite-PK
+     *      join order (`parent|…|child`): the innermost (last) var is the record's OWN key, preceding vars are
+     *      the parent id(s). So a member's ExternalID `list1|hashaaa` fills `{list_id}`→`list1`,
+     *      `{subscriber_hash}`→`hashaaa`, which is exactly what a nested update/delete needs even with no
+     *      attributes present.
+     * Create paths pass externalID=null and thus fill purely from attributes. Any var that resolves to nothing
+     * is left in place so {@link assertPathResolved} / the delete guard can surface it (fail loudly, never
+     * issue a request with an unresolved `{parent}`).
+     */
+    fillPathFromAttributes(template, attributes, externalID) {
+        const vars = this.detectPathVars(template);
+        const components = externalID != null ? String(externalID).split('|') : [];
+        const offset = vars.length - components.length; // right-align components to the tail of the var list
+        let out = template;
+        vars.forEach((v, i) => {
+            let val = attributes[v];
+            if (val == null || val === '') {
+                const compIdx = i - offset;
+                if (compIdx >= 0 && compIdx < components.length)
+                    val = components[compIdx];
+            }
+            if (val != null && val !== '')
+                out = out.replace(`{${v}}`, encodeURIComponent(String(val)));
+        });
+        return out;
+    }
+    /** Throws a clear error if a nested write path still has unresolved `{var}`s (missing parent id). */
+    assertPathResolved(path, objectName, op) {
+        const unresolved = this.detectPathVars(path);
+        if (unresolved.length > 0) {
+            throw new Error(`Mailchimp ${op} of "${objectName}": unresolved path var(s) {${unresolved.join(', ')}} — ` +
+                `the record must carry the parent id field(s) (e.g. list_id / store_id) in its attributes.`);
+        }
+    }
+    /** True when a URL already carries a query param with `name` (case-insensitive). */
+    urlHasParam(url, name) {
+        const q = url.indexOf('?');
+        if (q < 0)
+            return false;
+        const lname = name.toLowerCase();
+        return url.substring(q + 1).split('&').some(p => {
+            const eq = p.indexOf('=');
+            const k = (eq >= 0 ? p.substring(0, eq) : p).toLowerCase();
+            return k === lname;
+        });
+    }
+    /** Loads credentials from the linked Credential entity (preferred) or the CompanyIntegration Configuration JSON. */
+    async loadCredentials(companyIntegration, contextUser) {
+        const fromConfig = companyIntegration.Configuration ? this.parseCredentialJson(companyIntegration.Configuration) : null;
+        let fromCred = null;
+        if (companyIntegration.CredentialID) {
+            fromCred = await this.loadFromCredential(companyIntegration.CredentialID, contextUser);
+        }
+        // Credential secret (ApiKey) wins; Configuration supplies non-secret dc / base-URL overrides.
+        return { ...(fromConfig ?? {}), ...(fromCred ?? {}) };
+    }
+    /** Loads a credential row and parses its Values JSON. */
+    async loadFromCredential(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;
+        return this.parseCredentialJson(credential.Values);
+    }
+    /** Parses a Mailchimp credential/config JSON blob, tolerant of key casing variants. */
+    parseCredentialJson(json) {
+        let parsed;
+        try {
+            parsed = JSON.parse(json);
+        }
+        catch {
+            return null;
+        }
+        const scheme = this.firstString(parsed, ['scheme', 'Scheme', 'authScheme', 'AuthScheme']);
+        return {
+            ApiKey: this.firstString(parsed, ['ApiKey', 'apiKey', 'API_Key', 'apikey', 'apiToken', 'ApiToken', 'token', 'Token', 'accessToken', 'AccessToken']),
+            DataCenter: this.firstString(parsed, ['DataCenter', 'dataCenter', 'ServerPrefix', 'serverPrefix', 'server', 'dc', 'prefix']),
+            BaseURLOverride: this.firstBaseURL(parsed, ['BaseURL', 'BaseUrl', 'baseURL', 'baseUrl', 'APIBaseURL', 'ApiBaseURL', 'apiBaseUrl']),
+            Scheme: scheme === 'bearer' ? 'bearer' : 'basic',
+        };
+    }
+    /**
+     * Resolves the data-center prefix (e.g. `us15`):
+     *   1. explicit DataCenter / ServerPrefix from config/credential;
+     *   2. the `-<dc>` suffix parsed off the API key;
+     *   3. (runtime fallback for an OAuth bearer token with no dc) the OAuth2 metadata endpoint.
+     * A BaseURLOverride short-circuits the need for a real dc (used for sandbox/test/mock).
+     */
+    async resolveDataCenter(creds) {
+        if (creds.DataCenter && creds.DataCenter.trim().length > 0)
+            return creds.DataCenter.trim().toLowerCase();
+        const fromKey = this.parseDataCenterFromKey(creds.ApiKey ?? '');
+        if (fromKey)
+            return fromKey;
+        if (creds.BaseURLOverride)
+            return 'override'; // dc unused when an explicit base URL is present
+        return this.fetchDataCenterFromOAuthMetadata(creds.ApiKey ?? '', creds.Scheme);
+    }
+    /** Extracts `<dc>` from a Mailchimp API key of the form `<secret>-<dc>` (e.g. `abc123-us15` → `us15`). */
+    parseDataCenterFromKey(apiKey) {
+        const idx = apiKey.lastIndexOf('-');
+        if (idx < 0 || idx >= apiKey.length - 1)
+            return null;
+        const suffix = apiKey.slice(idx + 1).toLowerCase();
+        return /^[a-z]{2}\d{1,3}$/.test(suffix) ? suffix : null;
+    }
+    /** Runtime fallback: GET /oauth2/metadata to discover the data center for an OAuth access token. */
+    async fetchDataCenterFromOAuthMetadata(token, scheme) {
+        const authValue = scheme === 'bearer' ? `Bearer ${token}` : `OAuth ${token}`;
+        const response = await fetch(MAILCHIMP_OAUTH_METADATA_URL, {
+            method: 'GET',
+            headers: { 'Authorization': authValue, 'Accept': 'application/json' },
+        });
+        if (!response.ok) {
+            throw new Error(`Mailchimp /oauth2/metadata returned ${response.status}; cannot resolve the data center. Set DataCenter (or ServerPrefix) explicitly.`);
+        }
+        const body = await response.json();
+        if (!body.dc)
+            throw new Error('Mailchimp /oauth2/metadata response did not include a dc field.');
+        return body.dc.toLowerCase();
+    }
+    /** Returns the first non-empty string value among the candidate keys, else undefined. */
+    firstString(obj, keys) {
+        for (const k of keys) {
+            const v = obj[k];
+            if (typeof v === 'string' && v.trim().length > 0)
+                return v.trim();
+            if (typeof v === 'number')
+                return String(v);
+        }
+        return undefined;
+    }
+    /** Returns the first candidate key whose value is a valid absolute http(s) URL, else undefined. */
+    firstBaseURL(obj, keys) {
+        const raw = this.firstString(obj, keys);
+        return raw && /^https?:\/\//i.test(raw) ? raw : undefined;
+    }
+    /** Computes a 429/503 backoff delay, honoring an opportunistic Retry-After header when present. */
+    computeBackoffMs(response, attempt) {
+        const retryAfter = response.headers.get('retry-after');
+        if (retryAfter) {
+            const secs = Number(retryAfter);
+            if (Number.isFinite(secs) && secs > 0)
+                return Math.min(secs * 1000, 60_000);
+        }
+        return Math.min(500 * Math.pow(2, attempt) + Math.floor(Math.random() * 250), 30_000);
+    }
+    /** Sleep helper. */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+};
+MailchimpConnector = __decorate([
+    RegisterClass(BaseIntegrationConnector, 'MailchimpConnector')
+], MailchimpConnector);
+export { MailchimpConnector };
+/** Tree-shaking prevention — call from the package entry point. */
+export function LoadMailchimpConnector() { }
+//# sourceMappingURL=MailchimpConnector.js.map

package/dist/MailchimpConnector.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './MailchimpConnector.js';
+/** Open App bootstrap entry: importing this module ran the connector's @RegisterClass decorator;
+ *  this no-op satisfies the loader's required startupExport and forces the import at MJAPI boot. */
+export declare function registerConnector(): void;

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './MailchimpConnector.js';
+/** Open App bootstrap entry: importing this module ran the connector's @RegisterClass decorator;
+ *  this no-op satisfies the loader's required startupExport and forces the import at MJAPI boot. */
+export function registerConnector() { }
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AAExC;oGACoG;AACpG,MAAM,UAAU,iBAAiB,KAAiD,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@memberjunction/connector-mailchimp",
+  "version": "2.0.0",
+  "private": false,
+  "description": "MemberJunction Mailchimp connector.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run --passWithNoTests"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "peerDependencies": {
+    "@memberjunction/core": ">=5.42.0 <6.0.0",
+    "@memberjunction/core-entities": ">=5.42.0 <6.0.0",
+    "@memberjunction/global": ">=5.42.0 <6.0.0",
+    "@memberjunction/integration-engine": ">=5.42.0 <6.0.0"
+  },
+  "dependencies": {
+    "@memberjunction/connector-schema-merge": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "@memberjunction/core": "^5.42.0",
+    "@memberjunction/core-entities": "^5.42.0",
+    "@memberjunction/global": "^5.42.0",
+    "@memberjunction/integration-engine": "^5.42.0",
+    "@memberjunction/connector-schema-merge": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/Integrations"
+  }
+}