@memberjunction/connector-wild-apricot 1.2.0

package/dist/WildApricotConnector.d.ts

@@ -0,0 +1,190 @@
+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 RateLimitPolicy, type SourceSchemaInfo } from '@memberjunction/integration-engine';
+/**
+ * Wild Apricot membership-management connector (Admin API v2.3).
+ *
+ * ── AUTH ──────────────────────────────────────────────────────────────────
+ * OAuth 2.0 `client_credentials`. The admin API Key is sent as the HTTP-Basic
+ * USERNAME (empty password) on `POST https://oauth.wildapricot.org/auth/token`
+ * with `grant_type=client_credentials&scope=auto`. Both the Basic token-endpoint
+ * header AND the resulting `Authorization: Bearer <access_token>` header are built
+ * via the shared auth-helpers ({@link OAuth2TokenManager} with `UseBasicAuth:true`)
+ * — no inline base64/crypto lives in this connector. The access token is cached +
+ * auto-refreshed by the manager; the `client_credentials` grant returns no refresh
+ * token, so expiry re-mints via the same API key (per Configuration.TokenRefreshStrategy).
+ *
+ * ── TENANT ANCHOR (accountId) ───────────────────────────────────────────────
+ * Every data path is `/accounts/{accountId}/…`. The accountId is a per-tenant anchor,
+ * NOT a synced parent record: {@link TestConnection} / {@link Authenticate} resolve it
+ * by issuing `GET /v2.3/accounts` (no id in path) and taking the first account's Id when
+ * the credential omits AccountId (Configuration.accountIdDiscovery). It is cached on the
+ * auth context and substituted into `{accountId}` in {@link MakeHTTPRequest}. It is
+ * per-tenant config — NEVER hardcoded.
+ *
+ * ── DISCOVERY (mechanism only — NO baked catalog) ───────────────────────────
+ * Wild Apricot's object/field universe is credential-free-documented (public OpenAPI
+ * 9.14.0), so it is seeded as Declared metadata in the integration file. This connector
+ * therefore carries NO `WILD_APRICOT_OBJECTS` catalog constant (the deprecated
+ * connector's anti-pattern): {@link DiscoverObjects}/{@link DiscoverFields} inherit the
+ * base cache-driven implementation that reads the Declared metadata. That is the
+ * sanctioned "case-1 → Declared metadata" mechanism.
+ *
+ * ── CRUD ────────────────────────────────────────────────────────────────────
+ * Generic per-operation CRUD from {@link BaseRESTIntegrationConnector} (reads
+ * Create/Update/Delete APIPath/Method/BodyShape/IDLocation off each IO row) is used
+ * as-is; create fails LOUDLY on an empty response ID via `BuildCreatedResult`. No CRUD
+ * verb is re-implemented here.
+ *
+ * ── PAGINATION ──────────────────────────────────────────────────────────────
+ * Offset pagination via Wild Apricot's `$top`/`$skip` params (NOT the base's
+ * `limit`/`offset`), clamped to a 100-item max page per spec — {@link BuildPaginatedURL}
+ * + {@link ExtractPaginationInfo} are overridden for the vendor param names.
+ *
+ * ── THE ONE IDIOSYNCRATIC OVERRIDE: async Contacts list ─────────────────────
+ * `GET /accounts/{accountId}/contacts` defaults to ASYNC: it returns a `ResultId`
+ * that must be polled (`?resultId=<ResultId>`) until `State=Complete`, then the same
+ * URL returns the `Contacts` array. {@link FetchChanges} overrides ONLY the `Contact`
+ * object to run that request→poll→collect flow (bounded poll timeout); every other
+ * object delegates to the base flat/nested paginated fetch. See {@link FetchContacts}.
+ */
+export declare class WildApricotConnector extends BaseRESTIntegrationConnector {
+    /** Cached OAuth2 token manager (one per connector instance; the manager caches + refreshes the token). */
+    private tokenManager;
+    /** Cached tenant anchor accountId, resolved once per instance (per-tenant, never hardcoded). */
+    private cachedAccountId;
+    /** Verbatim three-way invariant name: IntegrationName getter === MJ: Integrations.Name. */
+    get IntegrationName(): string;
+    /**
+     * IntrospectSchema — pure WIRING of MJ's existing sampler into the declared catalog (the connector
+     * sample-union standard; see CONNECTOR_DISCOVERY_STANDARD.md). This connector adds NO discovery,
+     * merge, or sync logic — it only wires `DiscoverFieldsViaFetch` (MJ's sampler) into IntrospectSchema.
+     *
+     * `super.IntrospectSchema` yields the cache-driven Declared catalog (no measured widths). For each
+     * object we then call MJ's `DiscoverFieldsViaFetch` — MJ's own read-path sampler that measures real
+     * field widths and surfaces custom columns — and the shared PURE `mergeDeclaredWithSampledFields`
+     * unions the two by field name (adopt MJ's measured width; append MJ-discovered custom columns). MJ
+     * owns everything else (measurement, type/PK inference, persistence, reconcile, sync).
+     *
+     * Recursion note: `DiscoverFieldsViaFetch` falls back to the UNCHANGED `DiscoverFields` (cache-driven)
+     * when the read path can't run — never back into THIS method — so there is no infinite recursion.
+     * This connector does NOT override `DiscoverFields` to call any ViaFetch/ViaStream.
+     *
+     * Robustness: objects are sampled IN PARALLEL under a small bounded pool; any per-object failure
+     * keeps that object's declared fields, so a single bad sample never breaks introspection.
+     */
+    IntrospectSchema(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<SourceSchemaInfo>;
+    get SupportsCreate(): boolean;
+    get SupportsUpdate(): boolean;
+    get SupportsDelete(): boolean;
+    /**
+     * Documented rate-limit policy (Configuration.RateLimitDetail). The general ceiling is
+     * 400 requests/min (≈6.67/s) for "other request types"; the two Contacts-specific
+     * ceilings (list=40/min, by-id=120/min) are lower, so the engine's AIMD bucket starts
+     * from the CONSERVATIVE general rate and backs off further on a 429 (honored via
+     * ExtractRetryAfterMs). Burst kept modest to respect the per-minute windows.
+     */
+    get RateLimitPolicy(): RateLimitPolicy | null;
+    /** Parses Wild Apricot's 429 Retry-After (seconds) into ms so the AIMD bucket waits the full window. */
+    ExtractRetryAfterMs(error: unknown): number | undefined;
+    /**
+     * Mints/refreshes the bearer token via the shared OAuth2 manager, then resolves the
+     * tenant accountId (from the credential config, else auto-discovered via GET /accounts).
+     * Returns the bearer token + accountId on the auth context.
+     */
+    protected Authenticate(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<WildApricotAuthContext>;
+    /** Bearer header for API calls, built from the manager-minted token. No inline crypto. */
+    protected BuildHeaders(auth: WildApricotAuthContext): Record<string, string>;
+    /** Base URL: host + versioned path segment (e.g. https://api.wildapricot.org/v2.3). */
+    protected GetBaseURL(_companyIntegration: MJCompanyIntegrationEntity, auth: WildApricotAuthContext): string;
+    /**
+     * Executes an HTTP request via fetch. Substitutes the resolved `{accountId}` tenant anchor
+     * into the URL (the base leaves it as a template var; here it becomes the concrete tenant id)
+     * and parses JSON responses. The concrete connector owns the transport seam so tests override it.
+     */
+    protected MakeHTTPRequest(auth: WildApricotAuthContext, url: string, method: string, headers: Record<string, string>, body?: unknown): Promise<RESTResponse>;
+    /**
+     * Extracts the record array from a Wild Apricot response. ResponseDataKey is null in the
+     * Declared metadata because the wrapper key varies by endpoint (e.g. `Contacts`, `Events`,
+     * `Invoices`) and some endpoints return a bare array. So: honor an explicit key when set,
+     * else return a root-level array, else unwrap the first array-valued property of an object,
+     * else wrap a single object. This handles both wrapped-collection and bare-array shapes.
+     */
+    protected NormalizeResponse(rawBody: unknown, responseDataKey: string | null): Record<string, unknown>[];
+    /**
+     * Wild Apricot uses OData-style `$top`/`$skip` Offset pagination (NOT the base's `limit`/`offset`).
+     * `$top` is clamped to 100 per spec ("more than 100 → maximum 100 items returned"). Overridden
+     * here so the vendor param names + the 100 clamp are honored.
+     */
+    protected BuildPaginatedURL(basePath: string, obj: MJIntegrationObjectEntity, _page: number, offset: number, _cursor?: string, effectivePageSize?: number): string;
+    /**
+     * Offset pagination termination: Wild Apricot list endpoints return fewer than `$top` items on
+     * the final page (and none past the end). More pages remain only when a FULL page came back.
+     */
+    protected ExtractPaginationInfo(rawBody: unknown, _paginationType: PaginationType, _currentPage: number, currentOffset: number, pageSize: number): PaginationState;
+    /**
+     * Tests connectivity by minting a token and listing accounts (GET /accounts). When the credential
+     * omits AccountId, the first account's Id is adopted as the tenant anchor (Configuration.accountIdDiscovery).
+     */
+    TestConnection(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<ConnectionTestResult>;
+    /**
+     * Fetches records. Only the `Contact` object is idiosyncratic — its list endpoint is ASYNC:
+     * the request returns a `ResultId` which must be polled until `State=Complete`. All other
+     * objects use the generic base flat/nested paginated fetch unchanged.
+     */
+    FetchChanges(ctx: FetchContext): Promise<FetchBatchResult>;
+    /**
+     * Contacts async list flow (the single documented idiosyncrasy):
+     *   1. GET /accounts/{accountId}/contacts?$async=true&$skip&$top  → 200/202 with a ResultId.
+     *   2. Poll GET /accounts/{accountId}/contacts?resultId=<ResultId> until State='Complete'
+     *      (or the poll budget below is exhausted), then read the Contacts array.
+     * Incremental narrowing: when a watermark is present it is applied as a `$filter` on the
+     * documented cursor field (ProfileLastUpdated). Bounded by POLL_MAX_ATTEMPTS × POLL_INTERVAL_MS
+     * so a stuck async job can never hang the sync. Watermark persists on full-page success only.
+     */
+    private FetchContacts;
+    /**
+     * Resolves the async Contacts response: if a ResultId is present, polls the same endpoint with
+     * `?resultId=<id>` until State='Complete' (bounded), then returns the Contacts array. If the
+     * initial response already carried the Contacts array synchronously, returns it directly.
+     */
+    private ResolveAsyncContacts;
+    /** Substitutes the resolved `{accountId}` tenant anchor into a URL (case-insensitive on the var name). */
+    private SubstituteAccountId;
+    /**
+     * Resolves the tenant accountId: prefers the credential-configured value, else issues
+     * GET /accounts and adopts the first account's Id. Cached per instance. NEVER hardcoded.
+     */
+    private ResolveAccountId;
+    /** Finds the first array-valued property of an object (a wrapped collection under a vendor key). */
+    private FindArrayInObject;
+    /** Reads the async-result State ('Complete'/'Processing'/'Failed'/…) from a poll body, tolerant of shape. */
+    private ReadState;
+    /** Builds a Contact record identity from its declared PK (falls back to a common id key, then a content hash). */
+    private BuildContactIdentity;
+    /** Max watermark value across a record batch (ISO8601 string comparison), never below the current one. */
+    private MaxWatermark;
+    /** Throws a descriptive error on a non-2xx contacts response (202 Accepted is treated as OK for the async kick-off). */
+    private AssertContactsOK;
+    /** Reads headers off an error-like object (for Retry-After parsing). */
+    private ExtractErrorHeaders;
+    /** Whether an error indicates a 429 rate-limit. */
+    private IsRateLimitError;
+    /**
+     * Resolves the API key + tenant config from the linked Credential entity, falling back to the
+     * CompanyIntegration.Configuration / APIKey. The credential bytes never leave this scope.
+     */
+    private LoadCredentials;
+    /** Loads credential fields from a Credential entity's Values JSON. */
+    private LoadFromCredentialEntity;
+    /** Parses a JSON string into credential/config fields (tolerant of casing/aliases). */
+    private ParseConfigJson;
+}
+/** Auth context: resolved bearer token + tenant accountId + non-secret host/version overrides. */
+interface WildApricotAuthContext extends RESTAuthContext {
+    Token: string;
+    AccountId: string;
+    BaseHost?: string;
+    ApiVersion?: string;
+}
+export {};

package/dist/WildApricotConnector.js

@@ -0,0 +1,620 @@
+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, OAuth2TokenManager, } from '@memberjunction/integration-engine';
+import { mergeDeclaredWithSampledFields } from '@memberjunction/connector-schema-merge';
+import { z } from 'zod';
+/**
+ * Wild Apricot membership-management connector (Admin API v2.3).
+ *
+ * ── AUTH ──────────────────────────────────────────────────────────────────
+ * OAuth 2.0 `client_credentials`. The admin API Key is sent as the HTTP-Basic
+ * USERNAME (empty password) on `POST https://oauth.wildapricot.org/auth/token`
+ * with `grant_type=client_credentials&scope=auto`. Both the Basic token-endpoint
+ * header AND the resulting `Authorization: Bearer <access_token>` header are built
+ * via the shared auth-helpers ({@link OAuth2TokenManager} with `UseBasicAuth:true`)
+ * — no inline base64/crypto lives in this connector. The access token is cached +
+ * auto-refreshed by the manager; the `client_credentials` grant returns no refresh
+ * token, so expiry re-mints via the same API key (per Configuration.TokenRefreshStrategy).
+ *
+ * ── TENANT ANCHOR (accountId) ───────────────────────────────────────────────
+ * Every data path is `/accounts/{accountId}/…`. The accountId is a per-tenant anchor,
+ * NOT a synced parent record: {@link TestConnection} / {@link Authenticate} resolve it
+ * by issuing `GET /v2.3/accounts` (no id in path) and taking the first account's Id when
+ * the credential omits AccountId (Configuration.accountIdDiscovery). It is cached on the
+ * auth context and substituted into `{accountId}` in {@link MakeHTTPRequest}. It is
+ * per-tenant config — NEVER hardcoded.
+ *
+ * ── DISCOVERY (mechanism only — NO baked catalog) ───────────────────────────
+ * Wild Apricot's object/field universe is credential-free-documented (public OpenAPI
+ * 9.14.0), so it is seeded as Declared metadata in the integration file. This connector
+ * therefore carries NO `WILD_APRICOT_OBJECTS` catalog constant (the deprecated
+ * connector's anti-pattern): {@link DiscoverObjects}/{@link DiscoverFields} inherit the
+ * base cache-driven implementation that reads the Declared metadata. That is the
+ * sanctioned "case-1 → Declared metadata" mechanism.
+ *
+ * ── CRUD ────────────────────────────────────────────────────────────────────
+ * Generic per-operation CRUD from {@link BaseRESTIntegrationConnector} (reads
+ * Create/Update/Delete APIPath/Method/BodyShape/IDLocation off each IO row) is used
+ * as-is; create fails LOUDLY on an empty response ID via `BuildCreatedResult`. No CRUD
+ * verb is re-implemented here.
+ *
+ * ── PAGINATION ──────────────────────────────────────────────────────────────
+ * Offset pagination via Wild Apricot's `$top`/`$skip` params (NOT the base's
+ * `limit`/`offset`), clamped to a 100-item max page per spec — {@link BuildPaginatedURL}
+ * + {@link ExtractPaginationInfo} are overridden for the vendor param names.
+ *
+ * ── THE ONE IDIOSYNCRATIC OVERRIDE: async Contacts list ─────────────────────
+ * `GET /accounts/{accountId}/contacts` defaults to ASYNC: it returns a `ResultId`
+ * that must be polled (`?resultId=<ResultId>`) until `State=Complete`, then the same
+ * URL returns the `Contacts` array. {@link FetchChanges} overrides ONLY the `Contact`
+ * object to run that request→poll→collect flow (bounded poll timeout); every other
+ * object delegates to the base flat/nested paginated fetch. See {@link FetchContacts}.
+ */
+let WildApricotConnector = class WildApricotConnector extends BaseRESTIntegrationConnector {
+    constructor() {
+        super(...arguments);
+        /** Cached OAuth2 token manager (one per connector instance; the manager caches + refreshes the token). */
+        this.tokenManager = new OAuth2TokenManager();
+        /** Cached tenant anchor accountId, resolved once per instance (per-tenant, never hardcoded). */
+        this.cachedAccountId = null;
+    }
+    /** Verbatim three-way invariant name: IntegrationName getter === MJ: Integrations.Name. */
+    get IntegrationName() {
+        return 'Wild Apricot';
+    }
+    /**
+     * IntrospectSchema — pure WIRING of MJ's existing sampler into the declared catalog (the connector
+     * sample-union standard; see CONNECTOR_DISCOVERY_STANDARD.md). This connector adds NO discovery,
+     * merge, or sync logic — it only wires `DiscoverFieldsViaFetch` (MJ's sampler) into IntrospectSchema.
+     *
+     * `super.IntrospectSchema` yields the cache-driven Declared catalog (no measured widths). For each
+     * object we then call MJ's `DiscoverFieldsViaFetch` — MJ's own read-path sampler that measures real
+     * field widths and surfaces custom columns — and the shared PURE `mergeDeclaredWithSampledFields`
+     * unions the two by field name (adopt MJ's measured width; append MJ-discovered custom columns). MJ
+     * owns everything else (measurement, type/PK inference, persistence, reconcile, sync).
+     *
+     * Recursion note: `DiscoverFieldsViaFetch` falls back to the UNCHANGED `DiscoverFields` (cache-driven)
+     * when the read path can't run — never back into THIS method — so there is no infinite recursion.
+     * This connector does NOT override `DiscoverFields` to call any ViaFetch/ViaStream.
+     *
+     * Robustness: objects are sampled IN PARALLEL under a small bounded pool; any per-object failure
+     * keeps that object's declared fields, so a single bad sample never breaks introspection.
+     */
+    async IntrospectSchema(companyIntegration, contextUser) {
+        const schema = await super.IntrospectSchema(companyIntegration, contextUser);
+        await runBounded(schema.Objects, 8, async (obj) => {
+            try {
+                const sampled = await this.DiscoverFieldsViaFetch(companyIntegration, obj.ExternalName, contextUser);
+                obj.Fields = mergeDeclaredWithSampledFields(obj.Fields, sampled);
+            }
+            catch {
+                // Keep this object's declared fields — sampling is best-effort and never breaks introspection.
+            }
+        });
+        return schema;
+    }
+    // ─── Capability surface ──────────────────────────────────────────────────
+    // Wild Apricot supports create/update/delete on many objects; the ACTUAL per-verb
+    // support is metadata-driven (each IO's Create/Update/Delete columns), and the base's
+    // generic CRUD throws for any verb whose columns are null. These getters declare the
+    // connector is capable so the engine offers the write surface.
+    get SupportsCreate() { return true; }
+    get SupportsUpdate() { return true; }
+    get SupportsDelete() { return true; }
+    /**
+     * Documented rate-limit policy (Configuration.RateLimitDetail). The general ceiling is
+     * 400 requests/min (≈6.67/s) for "other request types"; the two Contacts-specific
+     * ceilings (list=40/min, by-id=120/min) are lower, so the engine's AIMD bucket starts
+     * from the CONSERVATIVE general rate and backs off further on a 429 (honored via
+     * ExtractRetryAfterMs). Burst kept modest to respect the per-minute windows.
+     */
+    get RateLimitPolicy() {
+        return { TokensPerSec: 6, Burst: 6, ThrottleBackoffFactor: 0.5 };
+    }
+    /** Parses Wild Apricot's 429 Retry-After (seconds) into ms so the AIMD bucket waits the full window. */
+    ExtractRetryAfterMs(error) {
+        // Wild Apricot returns HTTP 429 "wait for a minute"; when a Retry-After header is present we honor it.
+        const headers = this.ExtractErrorHeaders(error);
+        const retryAfter = headers?.['retry-after'];
+        if (retryAfter) {
+            const secs = Number(retryAfter);
+            if (Number.isFinite(secs) && secs >= 0)
+                return Math.round(secs * 1000);
+        }
+        // No header → the documented guidance is "wait for a minute" on a 429.
+        if (this.IsRateLimitError(error))
+            return 60_000;
+        return undefined;
+    }
+    // ─── Auth + transport (BaseRESTIntegrationConnector abstracts) ────────────
+    /**
+     * Mints/refreshes the bearer token via the shared OAuth2 manager, then resolves the
+     * tenant accountId (from the credential config, else auto-discovered via GET /accounts).
+     * Returns the bearer token + accountId on the auth context.
+     */
+    async Authenticate(companyIntegration, contextUser) {
+        const creds = await this.LoadCredentials(companyIntegration, contextUser);
+        const token = await this.tokenManager.GetAccessToken({
+            TokenURL: creds.TokenUrl,
+            ClientId: creds.ApiKey, // API key is the Basic-auth USERNAME …
+            ClientSecret: '', // … with an EMPTY password.
+            Scopes: 'auto',
+            UseBasicAuth: true, // → Authorization: Basic base64(apiKey:) — built by the helper, no inline crypto.
+        }, 'client_credentials');
+        const accountId = await this.ResolveAccountId(creds, token.AccessToken);
+        return {
+            Token: token.AccessToken,
+            AccountId: accountId,
+            BaseHost: creds.BaseHost,
+            ApiVersion: creds.ApiVersion,
+        };
+    }
+    /** Bearer header for API calls, built from the manager-minted token. No inline crypto. */
+    BuildHeaders(auth) {
+        return {
+            'Authorization': `Bearer ${auth.Token}`,
+            'Accept': 'application/json',
+        };
+    }
+    /** Base URL: host + versioned path segment (e.g. https://api.wildapricot.org/v2.3). */
+    GetBaseURL(_companyIntegration, auth) {
+        const host = auth.BaseHost ?? WILDAPRICOT_API_HOST;
+        const version = auth.ApiVersion ?? DEFAULT_API_VERSION;
+        return `${host.replace(/\/+$/, '')}/${version}`;
+    }
+    /**
+     * Executes an HTTP request via fetch. Substitutes the resolved `{accountId}` tenant anchor
+     * into the URL (the base leaves it as a template var; here it becomes the concrete tenant id)
+     * and parses JSON responses. The concrete connector owns the transport seam so tests override it.
+     */
+    async MakeHTTPRequest(auth, url, method, headers, body) {
+        const resolvedUrl = this.SubstituteAccountId(url, auth.AccountId);
+        const init = { method, headers };
+        if (body !== undefined && method !== 'GET' && method !== 'HEAD') {
+            init.body = typeof body === 'string' ? body : JSON.stringify(body);
+            init.headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(resolvedUrl, init);
+        const responseHeaders = {};
+        response.headers.forEach((value, key) => { responseHeaders[key.toLowerCase()] = value; });
+        const text = await response.text();
+        let parsed = text;
+        const contentType = responseHeaders['content-type'] ?? '';
+        if (contentType.includes('json') || (text.length > 0 && (text[0] === '{' || text[0] === '['))) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = text;
+            }
+        }
+        return { Status: response.status, Body: parsed, Headers: responseHeaders };
+    }
+    /**
+     * Extracts the record array from a Wild Apricot response. ResponseDataKey is null in the
+     * Declared metadata because the wrapper key varies by endpoint (e.g. `Contacts`, `Events`,
+     * `Invoices`) and some endpoints return a bare array. So: honor an explicit key when set,
+     * else return a root-level array, else unwrap the first array-valued property of an object,
+     * else wrap a single object. This handles both wrapped-collection and bare-array shapes.
+     */
+    NormalizeResponse(rawBody, responseDataKey) {
+        if (responseDataKey && isRecord(rawBody)) {
+            const inner = rawBody[responseDataKey];
+            if (Array.isArray(inner))
+                return inner.filter(isRecord);
+        }
+        if (Array.isArray(rawBody))
+            return rawBody.filter(isRecord);
+        if (isRecord(rawBody)) {
+            const arr = this.FindArrayInObject(rawBody);
+            if (arr.length > 0)
+                return arr.filter(isRecord);
+            return [rawBody];
+        }
+        return [];
+    }
+    /**
+     * Wild Apricot uses OData-style `$top`/`$skip` Offset pagination (NOT the base's `limit`/`offset`).
+     * `$top` is clamped to 100 per spec ("more than 100 → maximum 100 items returned"). Overridden
+     * here so the vendor param names + the 100 clamp are honored.
+     */
+    BuildPaginatedURL(basePath, obj, _page, offset, _cursor, effectivePageSize) {
+        const pageSize = Math.min(effectivePageSize ?? obj.DefaultPageSize ?? WILDAPRICOT_MAX_PAGE_SIZE, WILDAPRICOT_MAX_PAGE_SIZE);
+        const separator = basePath.includes('?') ? '&' : '?';
+        return `${basePath}${separator}$skip=${offset}&$top=${pageSize}`;
+    }
+    /**
+     * Offset pagination termination: Wild Apricot list endpoints return fewer than `$top` items on
+     * the final page (and none past the end). More pages remain only when a FULL page came back.
+     */
+    ExtractPaginationInfo(rawBody, _paginationType, _currentPage, currentOffset, pageSize) {
+        const records = this.NormalizeResponse(rawBody, null);
+        const count = records.length;
+        const hasMore = pageSize > 0 && count >= pageSize;
+        return {
+            HasMore: hasMore,
+            NextOffset: currentOffset + count,
+        };
+    }
+    // ─── TestConnection (auto-discovers the accountId) ────────────────────────
+    /**
+     * Tests connectivity by minting a token and listing accounts (GET /accounts). When the credential
+     * omits AccountId, the first account's Id is adopted as the tenant anchor (Configuration.accountIdDiscovery).
+     */
+    async TestConnection(companyIntegration, contextUser) {
+        try {
+            const auth = await this.Authenticate(companyIntegration, contextUser);
+            const url = `${this.GetBaseURL(companyIntegration, auth)}/accounts`;
+            const response = await this.MakeHTTPRequest(auth, url, 'GET', this.BuildHeaders(auth));
+            if (response.Status === 401 || response.Status === 403) {
+                return { Success: false, Message: `Wild Apricot authentication failed (HTTP ${response.Status}) — check the API key.` };
+            }
+            if (response.Status < 200 || response.Status >= 300) {
+                return { Success: false, Message: `Wild Apricot /accounts returned HTTP ${response.Status}.` };
+            }
+            const accounts = this.NormalizeResponse(response.Body, null);
+            return {
+                Success: true,
+                Message: `Connected to Wild Apricot account ${auth.AccountId}; ${accounts.length} account(s) accessible to this API key.`,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { Success: false, Message: `Wild Apricot connection error: ${message}` };
+        }
+    }
+    // ─── THE idiosyncratic override: async Contacts list ──────────────────────
+    /**
+     * Fetches records. Only the `Contact` object is idiosyncratic — its list endpoint is ASYNC:
+     * the request returns a `ResultId` which must be polled until `State=Complete`. All other
+     * objects use the generic base flat/nested paginated fetch unchanged.
+     */
+    async FetchChanges(ctx) {
+        if (ctx.ObjectName === CONTACT_OBJECT_NAME) {
+            return this.FetchContacts(ctx);
+        }
+        return super.FetchChanges(ctx);
+    }
+    /**
+     * Contacts async list flow (the single documented idiosyncrasy):
+     *   1. GET /accounts/{accountId}/contacts?$async=true&$skip&$top  → 200/202 with a ResultId.
+     *   2. Poll GET /accounts/{accountId}/contacts?resultId=<ResultId> until State='Complete'
+     *      (or the poll budget below is exhausted), then read the Contacts array.
+     * Incremental narrowing: when a watermark is present it is applied as a `$filter` on the
+     * documented cursor field (ProfileLastUpdated). Bounded by POLL_MAX_ATTEMPTS × POLL_INTERVAL_MS
+     * so a stuck async job can never hang the sync. Watermark persists on full-page success only.
+     */
+    async FetchContacts(ctx) {
+        const auth = await this.Authenticate(ctx.CompanyIntegration, ctx.ContextUser);
+        const obj = this.GetCachedObject(ctx.CompanyIntegration.IntegrationID, ctx.ObjectName);
+        const fields = this.GetCachedFields(obj.ID);
+        const pkFieldNames = fields.filter(f => f.IsPrimaryKey).map(f => f.Name);
+        const effectivePk = pkFieldNames.length > 0 ? pkFieldNames : ['Id'];
+        const offset = ctx.CurrentOffset ?? 0;
+        const pageSize = Math.min(ctx.BatchSize && ctx.BatchSize > 0 ? ctx.BatchSize : WILDAPRICOT_MAX_PAGE_SIZE, WILDAPRICOT_MAX_PAGE_SIZE);
+        const base = `${this.GetBaseURL(ctx.CompanyIntegration, auth)}${obj.APIPath}`;
+        // Build the OData query string with LITERAL $-prefixed param names (not URLSearchParams, which
+        // percent-encodes `$` → `%24`), keeping it consistent with BuildPaginatedURL's $skip/$top.
+        const queryParts = [`$async=true`, `$skip=${offset}`, `$top=${pageSize}`];
+        if (ctx.WatermarkValue && obj.IncrementalWatermarkField) {
+            // Documented incremental strategy: $filter on ProfileLastUpdated (ISO8601 comparison).
+            queryParts.push(`$filter=${encodeURIComponent(`${obj.IncrementalWatermarkField} ge ${ctx.WatermarkValue}`)}`);
+        }
+        const requestUrl = `${base}?${queryParts.join('&')}`;
+        // Step 1: kick off the async query.
+        const start = await this.MakeHTTPRequest(auth, requestUrl, 'GET', this.BuildHeaders(auth));
+        this.AssertContactsOK(start, 'start async contacts query');
+        const records = await this.ResolveAsyncContacts(auth, base, start.Body);
+        // Step 2: emit with FULL-RECORD pass-through (Fields = raw source record).
+        const out = records.map(raw => ({
+            ExternalID: this.BuildContactIdentity(raw, effectivePk),
+            ObjectType: ctx.ObjectName,
+            Fields: raw,
+        }));
+        const hasMore = records.length >= pageSize;
+        const result = {
+            Records: out,
+            HasMore: hasMore,
+            NextOffset: offset + records.length,
+        };
+        // Persist the max watermark seen on this (full-page-success) batch.
+        if (obj.IncrementalWatermarkField) {
+            const maxWatermark = this.MaxWatermark(records, obj.IncrementalWatermarkField, ctx.WatermarkValue);
+            if (maxWatermark)
+                result.NewWatermarkValue = maxWatermark;
+        }
+        return result;
+    }
+    /**
+     * Resolves the async Contacts response: if a ResultId is present, polls the same endpoint with
+     * `?resultId=<id>` until State='Complete' (bounded), then returns the Contacts array. If the
+     * initial response already carried the Contacts array synchronously, returns it directly.
+     */
+    async ResolveAsyncContacts(auth, baseUrl, firstBody) {
+        const parsed = AsyncContactsSchema.safeParse(firstBody);
+        const resultId = parsed.success ? parsed.data.ResultId : undefined;
+        // Synchronous shape: the body already carries the Contacts array (no polling needed).
+        if (!resultId) {
+            return this.NormalizeResponse(firstBody, 'Contacts');
+        }
+        const pollUrl = `${baseUrl}?resultId=${encodeURIComponent(resultId)}`;
+        for (let attempt = 0; attempt < POLL_MAX_ATTEMPTS; attempt++) {
+            const poll = await this.MakeHTTPRequest(auth, pollUrl, 'GET', this.BuildHeaders(auth));
+            this.AssertContactsOK(poll, 'poll async contacts result');
+            const state = this.ReadState(poll.Body);
+            if (state === 'Complete') {
+                return this.NormalizeResponse(poll.Body, 'Contacts');
+            }
+            if (state === 'Failed') {
+                throw new Error(`Wild Apricot async contacts query failed (ResultId ${resultId}).`);
+            }
+            await delay(POLL_INTERVAL_MS);
+        }
+        throw new Error(`Wild Apricot async contacts query did not complete within ${(POLL_MAX_ATTEMPTS * POLL_INTERVAL_MS) / 1000}s ` +
+            `(ResultId ${resultId}) — poll timeout.`);
+    }
+    // ─── Helpers ──────────────────────────────────────────────────────────────
+    /** Substitutes the resolved `{accountId}` tenant anchor into a URL (case-insensitive on the var name). */
+    SubstituteAccountId(url, accountId) {
+        return url.replace(/\{accountId\}/gi, encodeURIComponent(accountId));
+    }
+    /**
+     * Resolves the tenant accountId: prefers the credential-configured value, else issues
+     * GET /accounts and adopts the first account's Id. Cached per instance. NEVER hardcoded.
+     */
+    async ResolveAccountId(creds, token) {
+        if (creds.AccountId)
+            return creds.AccountId;
+        if (this.cachedAccountId)
+            return this.cachedAccountId;
+        const host = creds.BaseHost ?? WILDAPRICOT_API_HOST;
+        const version = creds.ApiVersion ?? DEFAULT_API_VERSION;
+        const url = `${host.replace(/\/+$/, '')}/${version}/accounts`;
+        // Auth is not yet fully assembled (that's what we're resolving), so build a minimal context.
+        const bootstrapAuth = { Token: token, AccountId: '', BaseHost: creds.BaseHost, ApiVersion: creds.ApiVersion };
+        const response = await this.MakeHTTPRequest(bootstrapAuth, url, 'GET', this.BuildHeaders(bootstrapAuth));
+        if (response.Status < 200 || response.Status >= 300) {
+            throw new Error(`Wild Apricot account auto-discovery failed: GET /accounts returned HTTP ${response.Status}.`);
+        }
+        const accounts = this.NormalizeResponse(response.Body, null);
+        const first = accounts[0];
+        const id = first ? first['Id'] ?? first['id'] : undefined;
+        if (id == null) {
+            throw new Error('Wild Apricot account auto-discovery returned no accounts for this API key.');
+        }
+        this.cachedAccountId = String(id);
+        return this.cachedAccountId;
+    }
+    /** Finds the first array-valued property of an object (a wrapped collection under a vendor key). */
+    FindArrayInObject(obj) {
+        for (const v of Object.values(obj)) {
+            if (Array.isArray(v))
+                return v;
+        }
+        return [];
+    }
+    /** Reads the async-result State ('Complete'/'Processing'/'Failed'/…) from a poll body, tolerant of shape. */
+    ReadState(body) {
+        if (!isRecord(body))
+            return undefined;
+        const state = body['State'] ?? body['state'];
+        return typeof state === 'string' ? state : undefined;
+    }
+    /** Builds a Contact record identity from its declared PK (falls back to a common id key, then a content hash). */
+    BuildContactIdentity(raw, pkFieldNames) {
+        const parts = pkFieldNames.map(name => raw[name]).filter(v => v != null && String(v).length > 0);
+        if (parts.length === pkFieldNames.length && parts.length > 0) {
+            return parts.map(v => String(v)).join('|');
+        }
+        for (const k of ['Id', 'id', 'ID']) {
+            const v = raw[k];
+            if (v != null && String(v).length > 0)
+                return String(v);
+        }
+        return stableHash(raw);
+    }
+    /** Max watermark value across a record batch (ISO8601 string comparison), never below the current one. */
+    MaxWatermark(records, field, current) {
+        let max = current ?? '';
+        for (const r of records) {
+            const v = r[field];
+            if (typeof v === 'string' && v > max)
+                max = v;
+        }
+        return max.length > 0 && max !== (current ?? '') ? max : undefined;
+    }
+    /** Throws a descriptive error on a non-2xx contacts response (202 Accepted is treated as OK for the async kick-off). */
+    AssertContactsOK(response, action) {
+        if (response.Status === 202)
+            return;
+        if (response.Status < 200 || response.Status >= 300) {
+            throw new Error(`Wild Apricot failed to ${action}: HTTP ${response.Status}`);
+        }
+    }
+    /** Reads headers off an error-like object (for Retry-After parsing). */
+    ExtractErrorHeaders(error) {
+        if (isRecord(error)) {
+            const headers = error['Headers'] ?? error['headers'];
+            if (isRecord(headers)) {
+                const out = {};
+                for (const [k, v] of Object.entries(headers)) {
+                    if (typeof v === 'string')
+                        out[k.toLowerCase()] = v;
+                }
+                return out;
+            }
+        }
+        return undefined;
+    }
+    /** Whether an error indicates a 429 rate-limit. */
+    IsRateLimitError(error) {
+        if (isRecord(error)) {
+            const status = error['Status'] ?? error['status'] ?? error['StatusCode'];
+            if (status === 429)
+                return true;
+        }
+        const msg = error instanceof Error ? error.message : String(error ?? '');
+        return /\b429\b/.test(msg);
+    }
+    /**
+     * Resolves the API key + tenant config from the linked Credential entity, falling back to the
+     * CompanyIntegration.Configuration / APIKey. The credential bytes never leave this scope.
+     */
+    async LoadCredentials(companyIntegration, contextUser) {
+        let apiKey;
+        let accountId;
+        let tokenUrl;
+        let baseHost;
+        let apiVersion;
+        if (companyIntegration.CredentialID) {
+            const fromCred = await this.LoadFromCredentialEntity(companyIntegration.CredentialID, contextUser);
+            if (fromCred) {
+                apiKey = fromCred.ApiKey || apiKey;
+                accountId = fromCred.AccountId || accountId;
+                tokenUrl = fromCred.TokenUrl || tokenUrl;
+                baseHost = fromCred.BaseHost || baseHost;
+                apiVersion = fromCred.ApiVersion || apiVersion;
+            }
+        }
+        // Non-secret tenant config lives on Configuration JSON (AccountId, tokenUrl, host, version).
+        const configJson = companyIntegration.Configuration;
+        if (configJson) {
+            const fromConfig = this.ParseConfigJson(configJson);
+            if (fromConfig) {
+                apiKey = apiKey ?? fromConfig.ApiKey;
+                accountId = accountId ?? fromConfig.AccountId;
+                tokenUrl = tokenUrl ?? fromConfig.TokenUrl;
+                baseHost = baseHost ?? fromConfig.BaseHost;
+                apiVersion = apiVersion ?? fromConfig.ApiVersion;
+            }
+        }
+        // Legacy fallback: the API key may live on CompanyIntegration.APIKey.
+        apiKey = apiKey ?? companyIntegration.APIKey ?? undefined;
+        if (!apiKey) {
+            throw new Error('No Wild Apricot API key found — set the admin API Key on the credential, Configuration JSON, or CompanyIntegration.APIKey.');
+        }
+        return {
+            ApiKey: apiKey,
+            AccountId: accountId,
+            TokenUrl: tokenUrl ?? WILDAPRICOT_TOKEN_URL,
+            BaseHost: baseHost,
+            ApiVersion: apiVersion,
+        };
+    }
+    /** Loads credential fields from a Credential entity's Values JSON. */
+    async LoadFromCredentialEntity(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.ParseConfigJson(credential.Values);
+    }
+    /** Parses a JSON string into credential/config fields (tolerant of casing/aliases). */
+    ParseConfigJson(json) {
+        try {
+            const result = WildApricotConfigSchema.safeParse(JSON.parse(json));
+            if (!result.success)
+                return null;
+            const p = result.data;
+            const apiKey = p.ApiKey ?? p.apiKey ?? p.APIKey ?? p.Key ?? p.Token ?? p.token;
+            const accountId = p.AccountId ?? p.accountId ?? p.AccountID;
+            const tokenUrl = p.tokenUrl ?? p.TokenUrl ?? p.tokenURL;
+            const baseHost = p.apiBaseUrl ?? p.BaseURL ?? p.baseHost;
+            const apiVersion = p.ApiVersion ?? p.apiVersion;
+            return {
+                ApiKey: apiKey ?? '',
+                AccountId: accountId != null ? String(accountId) : undefined,
+                TokenUrl: tokenUrl ?? WILDAPRICOT_TOKEN_URL,
+                BaseHost: baseHost,
+                ApiVersion: apiVersion,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+};
+WildApricotConnector = __decorate([
+    RegisterClass(BaseIntegrationConnector, '@memberjunction/connector-wild-apricot')
+], WildApricotConnector);
+export { WildApricotConnector };
+// ─── Module-level constants + helpers (mechanism, NOT a catalog) ──────────────
+/** Wild Apricot API host root; the version segment (/v2.3) + tenant paths are appended at runtime. */
+const WILDAPRICOT_API_HOST = 'https://api.wildapricot.org';
+/** OAuth2 token endpoint (client_credentials). */
+const WILDAPRICOT_TOKEN_URL = 'https://oauth.wildapricot.org/auth/token';
+/** Default API version path segment. */
+const DEFAULT_API_VERSION = 'v2.3';
+/** Max page size — `$top` above 100 is silently clamped to 100 per spec. */
+const WILDAPRICOT_MAX_PAGE_SIZE = 100;
+/** The single object whose list endpoint is async (request → ResultId → poll). */
+const CONTACT_OBJECT_NAME = 'Contact';
+/** Async-contacts poll bounds: attempts × interval caps total wait so a stuck job cannot hang the sync. */
+const POLL_MAX_ATTEMPTS = 60;
+const POLL_INTERVAL_MS = 1000;
+/** Zod schema for the credential/Configuration JSON shape (tolerant of casing aliases). */
+const WildApricotConfigSchema = z.object({
+    ApiKey: z.string().optional(),
+    apiKey: z.string().optional(),
+    APIKey: z.string().optional(),
+    Key: z.string().optional(),
+    Token: z.string().optional(),
+    token: z.string().optional(),
+    AccountId: z.union([z.string(), z.number()]).optional(),
+    accountId: z.union([z.string(), z.number()]).optional(),
+    AccountID: z.union([z.string(), z.number()]).optional(),
+    tokenUrl: z.string().optional(),
+    TokenUrl: z.string().optional(),
+    tokenURL: z.string().optional(),
+    apiBaseUrl: z.string().optional(),
+    BaseURL: z.string().optional(),
+    baseHost: z.string().optional(),
+    ApiVersion: z.string().optional(),
+    apiVersion: z.string().optional(),
+}).passthrough();
+/** Zod schema for the async-contacts kick-off response (carries a ResultId to poll). */
+const AsyncContactsSchema = z.object({
+    ResultId: z.string().optional(),
+    State: z.string().optional(),
+}).passthrough();
+/** Narrows an unknown value to a plain record. */
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/** Small deterministic hash for record-identity fallback (FNV-1a, hex). */
+function stableHash(record) {
+    const json = JSON.stringify(record, Object.keys(record).sort());
+    let h = 0x811c9dc5;
+    for (let i = 0; i < json.length; i++) {
+        h ^= json.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16);
+}
+/** Awaits `ms` milliseconds (poll interval). */
+function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Minimal bounded promise-pool: runs `worker` over `items` with at most `limit` in flight.
+ * (BaseRESTIntegrationConnector.RunBounded is private, so the sample-union override brings its own
+ * tiny pool — this is local plumbing, NOT a shared framework artifact.)
+ */
+async function runBounded(items, limit, worker) {
+    const queue = [...items];
+    const size = Math.max(1, Math.min(limit, queue.length));
+    const runners = Array.from({ length: size }, async () => {
+        for (let next = queue.shift(); next !== undefined; next = queue.shift()) {
+            await worker(next);
+        }
+    });
+    await Promise.all(runners);
+}
+//# sourceMappingURL=WildApricotConnector.js.map

package/dist/WildApricotConnector.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './WildApricotConnector.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 './WildApricotConnector.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,2BAA2B,CAAC;AAE1C;oGACoG;AACpG,MAAM,UAAU,iBAAiB,KAAiD,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@memberjunction/connector-wild-apricot",
+  "version": "1.2.0",
+  "private": false,
+  "description": "MemberJunction WildApricot 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"
+  }
+}