@memberjunction/connector-microsoft-dynamics-365-dataverse 1.0.0

package/dist/DynamicsDataverseConnector.d.ts

@@ -0,0 +1,295 @@
+import { type UserInfo } from '@memberjunction/core';
+import type { MJCompanyIntegrationEntity, MJIntegrationObjectEntity, MJIntegrationObjectFieldEntity } from '@memberjunction/core-entities';
+import { BaseRESTIntegrationConnector, type RESTAuthContext, type RESTResponse, type PaginationState, type PaginationType, type ConnectionTestResult, type ExternalObjectSchema, type ExternalFieldSchema, type FetchContext, type FetchBatchResult, type RateLimitPolicy } from '@memberjunction/integration-engine';
+/**
+ * Connection configuration parsed from the CompanyIntegration's MJ Credential
+ * (preferred) or its Configuration JSON. Dynamics 365 / Dataverse is reached
+ * through the OData v4 Web API using a Microsoft Entra ID (Azure AD)
+ * client-credentials (server-to-server / app-only) token.
+ *
+ * Field names are read case-insensitively so a credential authored as
+ * `tenantId`/`TenantID`/`tenant_id` all resolve.
+ */
+export interface DynamicsConnectionConfig {
+    /** Microsoft Entra ID tenant GUID (or `common`/`organizations`). */
+    TenantId: string;
+    /** Application (client) registration GUID. */
+    ClientId: string;
+    /** Application client secret. */
+    ClientSecret: string;
+    /**
+     * The Dataverse environment URL, e.g. `https://contoso.crm.dynamics.com`.
+     * Per-customer — NEVER hardcoded. The OAuth resource/audience scope is
+     * `<EnvironmentUrl>/.default` and the Web API base is `<EnvironmentUrl>/api/data/v9.2`.
+     */
+    EnvironmentUrl: string;
+    /** Override the Web API version segment. Default: `v9.2`. */
+    ApiVersion?: string;
+    /** Override the Entra ID token endpoint origin. Default: `https://login.microsoftonline.com`. */
+    AuthorityHost?: string;
+    /** Override the OAuth scope. Default: `<EnvironmentUrl>/.default`. */
+    Scope?: string;
+    /** Maximum retries for rate-limited / transient failures. Default: 5. */
+    MaxRetries?: number;
+    /** HTTP request timeout in milliseconds. Default: 60000. */
+    RequestTimeoutMs?: number;
+    /** Minimum milliseconds between API requests. Default: 0 (governed by the engine's adaptive bucket). */
+    MinRequestIntervalMs?: number;
+    /** Requested OData max page size (capped at 5000 by the service). Default: 5000. */
+    MaxPageSize?: number;
+}
+/** Auth context carrying the minted bearer token plus the resolved Web API base URL + config. */
+interface DynamicsAuthContext extends RESTAuthContext {
+    Config: DynamicsConnectionConfig;
+    /**
+     * Org ROOT URL (`<EnvironmentUrl>`) used by the base class's BuildFullURL(baseURL, APIPath).
+     * The frozen IO `APIPath`s are ABSOLUTE-from-root (they already include `/api/data/v9.2/...`), so
+     * the base must be the org root to avoid doubling the version segment.
+     */
+    BaseUrl: string;
+    /** Versioned Web API base (`<EnvironmentUrl>/api/data/v9.2`) for the connector's OWN calls (WhoAmI, EntityDefinitions, delta). */
+    ApiBaseUrl: string;
+}
+/**
+ * Connector for Microsoft Dynamics 365 / Dataverse (Common Data Service) via the
+ * OData v4 Web API.
+ *
+ * - **Auth**: Microsoft Entra ID OAuth 2.0 client-credentials (app-only). Token is
+ *   minted/cached by the shared {@link OAuth2TokenManager}; the credential bytes are
+ *   resolved at runtime from the connection's MJ Credential / Configuration — never baked.
+ * - **Base URL**: `<EnvironmentUrl>/api/data/v9.2`, per-connection (every customer
+ *   environment differs — nothing is hardcoded).
+ * - **Discovery**: `DiscoverObjects` / `DiscoverFields` parse the credentialed
+ *   `EntityDefinitions` describe endpoint at runtime (case-2 auth-gated discovery) so
+ *   BOTH standard and custom/solution-installed tables surface. The documented standard
+ *   catalog lives in the Declared metadata file, not in this class.
+ * - **Pagination**: OData `@odata.nextLink` cursor, followed verbatim.
+ * - **Write**: generic per-operation CRUD from {@link BaseRESTIntegrationConnector}
+ *   (flat body; create ID read from the `OData-EntityId` response header; update PATCH
+ *   `/<entityset>(id)`; delete DELETE `/<entityset>(id)`; alternate-key upsert path form).
+ * - **Incremental**: change-tracking delta (`Prefer: odata.track-changes` →
+ *   `@odata.deltaLink`) when a table declares it; `modifiedon`-polling fallback otherwise.
+ */
+export declare class DynamicsDataverseConnector extends BaseRESTIntegrationConnector {
+    private readonly tokenManager;
+    private cachedAuth;
+    /** Verbatim from the upstream identity handoff. Drives the three-way name invariant.
+     *  Returned as a string literal (not the INTEGRATION_NAME const ref) so the T1
+     *  ThreeWayName static parser can extract it from source. */
+    get IntegrationName(): string;
+    get SupportsCreate(): boolean;
+    get SupportsUpdate(): boolean;
+    get SupportsDelete(): boolean;
+    /**
+     * §7 — `EntityDefinitions` enumerates the COMPLETE credentialed gamut (standard + custom +
+     * solution-installed tables / attributes), not a filtered subset, so a comprehensive refresh
+     * may safely + reversibly deactivate objects no longer in the response.
+     */
+    get DiscoveryIsAuthoritative(): boolean;
+    /**
+     * §7 — the watermark this connector advances (delta-link / modifiedon high-water) IS monotonic:
+     * change-tracking yields a forward-only delta token, and the modifiedon fallback fetches in
+     * ascending `modifiedon` order so the last batch carries the true maximum. Lets the engine narrow
+     * the next incremental instead of advancing to wall-clock now.
+     */
+    get MonotonicWatermark(): boolean;
+    /**
+     * §7 — keyset/seek resume key for watermark-less objects: the table's GUID primary key
+     * (`<logicalName>id`), read from the IO's Configuration. Stable + monotonic-enough for
+     * resume-from-last-seen; `null` when no PK is known.
+     */
+    StableOrderingKey(objectName: string): string | null;
+    /**
+     * §7 — Dataverse enforces a per-environment Web API service-protection limit (≈ 6000 requests /
+     * 300s sliding window, plus an execution-time budget). Conservative sustained rate keeps the
+     * connector under the request-count limit; the engine's AIMD bucket adapts on 429s via
+     * {@link ExtractRetryAfterMs}. (≈6000/300 ≈ 20 req/s; we stay below to leave headroom.)
+     */
+    get RateLimitPolicy(): RateLimitPolicy | null;
+    get MaxConcurrencyHint(): number | null;
+    /**
+     * Parse Dataverse's throttle signal. The service returns HTTP 429 with a `Retry-After` header
+     * (seconds) on a service-protection limit; honor it precisely.
+     */
+    ExtractRetryAfterMs(error: unknown): number | undefined;
+    /**
+     * Validates the service principal can reach the environment by issuing a fresh token and a
+     * lightweight `WhoAmI` call (an unbound function returning the calling user/org GUIDs).
+     */
+    TestConnection(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<ConnectionTestResult>;
+    /**
+     * Case-2 (auth-gated) runtime discovery: enumerates EVERY table the credential can see via the
+     * `EntityDefinitions` describe endpoint (standard + custom + solution-installed) — NOT a baked
+     * catalog. The documented standard catalog seeded in the Declared metadata file is the floor;
+     * this returns what the live environment actually exposes (the ceiling), which is strictly a
+     * superset for custom-bearing tenants.
+     */
+    DiscoverObjects(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo): Promise<ExternalObjectSchema[]>;
+    /**
+     * Case-2 runtime discovery for a single object's columns: describes the table's `Attributes`
+     * collection and maps each Property → {@link ExternalFieldSchema}, surfacing Type/MaxLength,
+     * the GUID PK (`IsPrimaryId` / `PrimaryIdAttribute` → `IsPrimaryKey`), and scalar Lookup
+     * columns → FK (with `ForeignKeyTarget` = the referenced table's logical name).
+     */
+    DiscoverFields(companyIntegration: MJCompanyIntegrationEntity, objectName: string, contextUser: UserInfo): Promise<ExternalFieldSchema[]>;
+    /**
+     * Routes to the change-tracking delta path when the table declares it AND a watermark exists;
+     * otherwise delegates to the base metadata-driven fetch (which applies the `modifiedon` watermark
+     * fallback + standard `@odata.nextLink` pagination). The base path already handles
+     * `TransformRecord` (annotation stripping) + full-record pass-through, so the delta path mirrors it.
+     */
+    FetchChanges(ctx: FetchContext): Promise<FetchBatchResult>;
+    /**
+     * Removes the OData control annotations (`@odata.etag`, `@odata.context`, `@odata.id`,
+     * `<lookup>@odata.bind`, `<lookup>@OData.Community.Display.V1.FormattedValue`, etc.) Dataverse
+     * sprinkles onto every record — they are response transport metadata, not columns. Every other
+     * source key is preserved (full-record pass-through); the removed keys are declared in
+     * {@link ExcludedSourceKeys} so the base re-add doesn't restore them and change-detection ignores them.
+     */
+    protected TransformRecord(raw: Record<string, unknown>, _obj: MJIntegrationObjectEntity, _fields: MJIntegrationObjectFieldEntity[]): Record<string, unknown>;
+    /**
+     * The well-known static OData control annotation keys {@link TransformRecord} drops. The base
+     * `applyTransformPreservingKeys` uses this to avoid re-adding them. Dataverse ALSO emits dynamic,
+     * per-lookup annotation suffixes (`<col>@odata.bind`, `<col>@OData.Community.Display.V1.FormattedValue`,
+     * `<col>@Microsoft.Dynamics.CRM.lookuplogicalname`) whose exact names vary by record and cannot be
+     * enumerated statically — those are handled by the {@link applyTransformPreservingKeys} override
+     * below (predicate exclusion), so they never re-appear. This static list covers the always-present
+     * envelope keys for completeness / auditability.
+     */
+    protected ExcludedSourceKeys(_objectName: string): string[];
+    /**
+     * Overrides the base re-add so the DYNAMIC OData annotation keys (`<col>@odata.bind`, FormattedValue,
+     * lookuplogicalname, etc.) {@link TransformRecord} strips are NOT restored. The base loop re-adds any
+     * `raw` key absent from the transform output unless it is in the static {@link ExcludedSourceKeys}
+     * set — which can't enumerate the per-record annotation suffixes. Here we re-add a dropped key only
+     * when it is neither statically excluded NOR an annotation key (by predicate). This keeps full-record
+     * pass-through for genuine columns while making the annotation removal stick (auditable, by rule).
+     */
+    protected applyTransformPreservingKeys(raw: Record<string, unknown>, obj: MJIntegrationObjectEntity, fields: MJIntegrationObjectFieldEntity[]): Record<string, unknown>;
+    /**
+     * Mints/caches a Microsoft Entra ID access token via client-credentials. The scope is the
+     * environment's `.default` (`<EnvironmentUrl>/.default`) so the token's audience matches the
+     * Dataverse resource. Token is cached by {@link OAuth2TokenManager} until near expiry.
+     */
+    protected Authenticate(companyIntegration: MJCompanyIntegrationEntity, contextUser: UserInfo, forceRefresh?: boolean): Promise<DynamicsAuthContext>;
+    /** Runs the client_credentials token round-trip through {@link OAuth2TokenManager}. */
+    private MintToken;
+    /** Standard OData/Dataverse headers — bearer token + JSON + OData version + return-representation. */
+    protected BuildHeaders(auth: RESTAuthContext): Record<string, string>;
+    /**
+     * HTTP transport with retry/backoff on 429/503/504 (Dataverse service-protection limits). The
+     * thrown error on a retryable status carries the response headers so {@link ExtractRetryAfterMs}
+     * can read `Retry-After` for the engine's adaptive bucket.
+     */
+    protected MakeHTTPRequest(auth: RESTAuthContext, url: string, method: string, headers: Record<string, string>, body?: unknown): Promise<RESTResponse>;
+    /**
+     * Unwraps the OData collection envelope's `value` array. A single-record GET (`/<set>(id)`) is
+     * returned as a one-element array. Honors a metadata-declared `ResponseDataKey` if set, defaulting
+     * to the OData `value` convention.
+     */
+    protected NormalizeResponse(rawBody: unknown, responseDataKey: string | null): Record<string, unknown>[];
+    /**
+     * Cursor pagination via `@odata.nextLink`. The nextLink is an ABSOLUTE continuation URL that
+     * encodes the exact next request (including the opaque `$skiptoken`); it is followed VERBATIM and
+     * never hand-built. A present nextLink means another page exists.
+     */
+    protected ExtractPaginationInfo(rawBody: unknown, _paginationType: PaginationType, _currentPage: number, _currentOffset: number, _pageSize: number): PaginationState;
+    /**
+     * Per-connection base the engine joins the IO `APIPath` onto. The frozen Dataverse IO APIPaths are
+     * ABSOLUTE-from-root (they already include `/api/data/v9.2/...`), so this returns the org ROOT
+     * (`<EnvironmentUrl>`) and the resolved request URL is `<EnvironmentUrl>/api/data/v9.2/<entityset>`.
+     * The versioned Web API base (`<EnvironmentUrl>/api/data/v9.2`) is `ApiBaseUrl`, used by the
+     * connector's OWN calls (WhoAmI / EntityDefinitions / delta). Never a hardcoded org URL.
+     */
+    protected GetBaseURL(_companyIntegration: MJCompanyIntegrationEntity, auth: RESTAuthContext): string;
+    /**
+     * Honors the OData `@odata.nextLink` cursor (used verbatim) and otherwise injects the page-size
+     * request as a `$top`-free first page — Dataverse caps page size via the `Prefer: odata.maxpagesize`
+     * header (added in {@link MakeFirstPageHeaders}), NOT a query param, and does NOT support `$skip`.
+     */
+    protected BuildPaginatedURL(basePath: string, _obj: MJIntegrationObjectEntity, _page: number, _offset: number, cursor?: string, _effectivePageSize?: number): string;
+    /**
+     * Dataverse returns the created record's URI in the `OData-EntityId` response header
+     * (e.g. `https://org.crm.dynamics.com/api/data/v9.2/accounts(00000000-...)`); the GUID is the
+     * trailing `(...)` segment. Falls back to the `Location` header, then the body PK, so a tenant
+     * configured to return-representation still resolves. An empty ID makes the create FAIL LOUDLY
+     * via the base's BuildCreatedResult (never a silent duplicate-create).
+     */
+    protected ExtractIDFromResponse(response: RESTResponse, idLocation: string | null): string | undefined;
+    /**
+     * Substitutes the target ID into a Dataverse single-record path. Supports the standard GUID form
+     * `/<entityset>(id)` AND the alternate-key upsert form `/<entityset>(<altkey>='<value>')` — when
+     * the ExternalID already contains an `=` it is an alternate-key expression and is inserted as-is
+     * (only the value is escaped); otherwise it is treated as a GUID. Handles both `({id})` template
+     * placeholders and a bare `(id)` suffix.
+     */
+    protected SubstituteIDInPath(path: string, externalID: string, idLocation: string | null): string;
+    /**
+     * Builds the OData key expression for a single-record path. A plain GUID → `00000000-...`. An
+     * alternate-key expression (`key='value'` or `k1='v1',k2='v2'`) is passed through with each value
+     * single-quote-escaped. This realizes the alternate-key upsert path form the metadata may declare.
+     */
+    private BuildKeyExpression;
+    /** Whether a table is configured for change tracking (Configuration.changeTrackingHeader present). */
+    private ObjectUsesChangeTracking;
+    /**
+     * Fetches changed records via Dataverse change tracking. The watermark holds the previous poll's
+     * `@odata.deltaLink` (a full URL carrying `$deltatoken`) — followed VERBATIM. Deleted records
+     * arrive as `$deletedEntity` references; they are surfaced with `IsDeleted=true`. The last page's
+     * `@odata.deltaLink` becomes the new watermark for the next poll.
+     */
+    private FetchChangesViaDelta;
+    /** Maps one change-tracking row (live record OR `$deletedEntity` tombstone) to an ExternalRecord. */
+    private DeltaRowToExternalRecord;
+    /** Fetches the full table list via `EntityDefinitions` (paged, following @odata.nextLink). */
+    private FetchEntityDefinitions;
+    /** Describes one table + its Attributes by logical name. Returns null if not visible to the credential. */
+    private FetchEntityDefinition;
+    /** Resolves the Dataverse logical name for an IO (Configuration.logicalName, else the IO name). */
+    private ResolveLogicalName;
+    /** Maps a Dataverse table describe entry → ExternalObjectSchema. */
+    private EntityMetadataToObjectSchema;
+    /** Maps a Dataverse attribute describe entry → ExternalFieldSchema. */
+    private AttributeMetadataToFieldSchema;
+    /** Reads a Dataverse localized label, falling back to undefined. */
+    private LocalizedLabel;
+    /** Parses the connection config, preferring the attached MJ Credential over Configuration JSON. */
+    private ParseConfig;
+    /** Loads the OAuth2 config from the MJ: Credentials entity Values JSON. */
+    private ParseConfigFromCredential;
+    /** Validates the parsed config + applies defaults. Field names are read case-insensitively. */
+    private ValidateConfig;
+    /** Resolves the Web API base URL: `<EnvironmentUrl>/api/data/v9.2`. */
+    private ResolveBaseUrl;
+    private ExecuteOneRequest;
+    private ParseResponseBody;
+    private ExtractHeaders;
+    private IsRetryable;
+    private ComputeBackoffDelay;
+    private Sleep;
+    /**
+     * True for any OData/Dataverse annotation key. Genuine columns never contain `@`; every annotation
+     * does — the response-level controls (`@odata.etag`, `@odata.context`, …) and the per-column
+     * suffixes (`<col>@odata.bind`, `<col>@OData.Community.Display.V1.FormattedValue`,
+     * `<col>@Microsoft.Dynamics.CRM.lookuplogicalname`). So an `@`-containing key is an annotation.
+     */
+    private IsODataAnnotationKey;
+    private buildDataverseURL;
+    private previewBody;
+    /** Integration ID of the most recent fetch — lets the no-arg StableOrderingKey hook locate the IO. */
+    private lastIntegrationID;
+    /**
+     * Best-effort cached-object lookup by NAME using the last-seen integration ID. Used by
+     * {@link StableOrderingKey}, which the engine calls without a CompanyIntegration; returns null
+     * (keyset resume simply unavailable) before any fetch has run.
+     */
+    private tryGetCachedObject;
+    private tryGetCachedObjectFor;
+    /** Reads a trimmed string from an IO's Configuration JSON, tolerant of absent/invalid. */
+    private readObjectConfigString;
+    /** Extracts response headers from a thrown error, when the connector throws an error carrying them. */
+    private extractHeadersFromError;
+}
+/** Tree-shaking prevention function — import and call from the package entry point. */
+export declare function LoadDynamicsDataverseConnector(): void;
+export {};

package/dist/DynamicsDataverseConnector.js

@@ -0,0 +1,790 @@
+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';
+// ─── Constants ───────────────────────────────────────────────────────
+/** Default Web API version segment. */
+const DEFAULT_API_VERSION = 'v9.2';
+/** Default Entra ID authority host. */
+const DEFAULT_AUTHORITY_HOST = 'https://login.microsoftonline.com';
+/** Default HTTP request timeout (Dataverse can be slow under load). */
+const DEFAULT_REQUEST_TIMEOUT_MS = 60_000;
+/** Default retry count for retryable (429 / 503 / 504) responses. */
+const DEFAULT_MAX_RETRIES = 5;
+/** OData service hard cap on page size; the service silently ignores requests above this. */
+const MAX_ODATA_PAGE_SIZE = 5_000;
+/**
+ * Connector for Microsoft Dynamics 365 / Dataverse (Common Data Service) via the
+ * OData v4 Web API.
+ *
+ * - **Auth**: Microsoft Entra ID OAuth 2.0 client-credentials (app-only). Token is
+ *   minted/cached by the shared {@link OAuth2TokenManager}; the credential bytes are
+ *   resolved at runtime from the connection's MJ Credential / Configuration — never baked.
+ * - **Base URL**: `<EnvironmentUrl>/api/data/v9.2`, per-connection (every customer
+ *   environment differs — nothing is hardcoded).
+ * - **Discovery**: `DiscoverObjects` / `DiscoverFields` parse the credentialed
+ *   `EntityDefinitions` describe endpoint at runtime (case-2 auth-gated discovery) so
+ *   BOTH standard and custom/solution-installed tables surface. The documented standard
+ *   catalog lives in the Declared metadata file, not in this class.
+ * - **Pagination**: OData `@odata.nextLink` cursor, followed verbatim.
+ * - **Write**: generic per-operation CRUD from {@link BaseRESTIntegrationConnector}
+ *   (flat body; create ID read from the `OData-EntityId` response header; update PATCH
+ *   `/<entityset>(id)`; delete DELETE `/<entityset>(id)`; alternate-key upsert path form).
+ * - **Incremental**: change-tracking delta (`Prefer: odata.track-changes` →
+ *   `@odata.deltaLink`) when a table declares it; `modifiedon`-polling fallback otherwise.
+ */
+let DynamicsDataverseConnector = class DynamicsDataverseConnector extends BaseRESTIntegrationConnector {
+    constructor() {
+        // ── State ────────────────────────────────────────────────────────
+        super(...arguments);
+        this.tokenManager = new OAuth2TokenManager();
+        this.cachedAuth = null;
+        /** Integration ID of the most recent fetch — lets the no-arg StableOrderingKey hook locate the IO. */
+        this.lastIntegrationID = null;
+    }
+    // ── Identity + capabilities ──────────────────────────────────────
+    /** Verbatim from the upstream identity handoff. Drives the three-way name invariant.
+     *  Returned as a string literal (not the INTEGRATION_NAME const ref) so the T1
+     *  ThreeWayName static parser can extract it from source. */
+    get IntegrationName() { return 'Microsoft Dynamics 365 (Dataverse)'; }
+    get SupportsCreate() { return true; }
+    get SupportsUpdate() { return true; }
+    get SupportsDelete() { return true; }
+    /**
+     * §7 — `EntityDefinitions` enumerates the COMPLETE credentialed gamut (standard + custom +
+     * solution-installed tables / attributes), not a filtered subset, so a comprehensive refresh
+     * may safely + reversibly deactivate objects no longer in the response.
+     */
+    get DiscoveryIsAuthoritative() { return true; }
+    /**
+     * §7 — the watermark this connector advances (delta-link / modifiedon high-water) IS monotonic:
+     * change-tracking yields a forward-only delta token, and the modifiedon fallback fetches in
+     * ascending `modifiedon` order so the last batch carries the true maximum. Lets the engine narrow
+     * the next incremental instead of advancing to wall-clock now.
+     */
+    get MonotonicWatermark() { return true; }
+    /**
+     * §7 — keyset/seek resume key for watermark-less objects: the table's GUID primary key
+     * (`<logicalName>id`), read from the IO's Configuration. Stable + monotonic-enough for
+     * resume-from-last-seen; `null` when no PK is known.
+     */
+    StableOrderingKey(objectName) {
+        const obj = this.tryGetCachedObject(objectName);
+        if (!obj)
+            return null;
+        return this.readObjectConfigString(obj, 'primaryIdAttribute')
+            ?? this.readObjectConfigString(obj, 'stableOrderingKey');
+    }
+    /**
+     * §7 — Dataverse enforces a per-environment Web API service-protection limit (≈ 6000 requests /
+     * 300s sliding window, plus an execution-time budget). Conservative sustained rate keeps the
+     * connector under the request-count limit; the engine's AIMD bucket adapts on 429s via
+     * {@link ExtractRetryAfterMs}. (≈6000/300 ≈ 20 req/s; we stay below to leave headroom.)
+     */
+    get RateLimitPolicy() {
+        return { TokensPerSec: 15, Burst: 30, ThrottleBackoffFactor: 0.5 };
+    }
+    get MaxConcurrencyHint() { return 4; }
+    /**
+     * Parse Dataverse's throttle signal. The service returns HTTP 429 with a `Retry-After` header
+     * (seconds) on a service-protection limit; honor it precisely.
+     */
+    ExtractRetryAfterMs(error) {
+        const headers = this.extractHeadersFromError(error);
+        if (!headers)
+            return undefined;
+        const retryAfter = headers['retry-after'];
+        if (retryAfter) {
+            const asSeconds = Number(retryAfter);
+            if (!Number.isNaN(asSeconds))
+                return Math.max(0, asSeconds * 1_000);
+            const asDate = new Date(retryAfter).getTime();
+            if (!Number.isNaN(asDate))
+                return Math.max(0, asDate - Date.now());
+        }
+        return undefined;
+    }
+    // ── TestConnection ───────────────────────────────────────────────
+    /**
+     * Validates the service principal can reach the environment by issuing a fresh token and a
+     * lightweight `WhoAmI` call (an unbound function returning the calling user/org GUIDs).
+     */
+    async TestConnection(companyIntegration, contextUser) {
+        try {
+            const auth = await this.Authenticate(companyIntegration, contextUser, true);
+            const url = `${auth.ApiBaseUrl}/WhoAmI`;
+            const response = await this.MakeHTTPRequest(auth, url, 'GET', this.BuildHeaders(auth));
+            if (response.Status < 200 || response.Status >= 300) {
+                return {
+                    Success: false,
+                    Message: `Dataverse WhoAmI failed: HTTP ${response.Status} — ${this.previewBody(response.Body)}`,
+                };
+            }
+            const body = response.Body;
+            return {
+                Success: true,
+                Message: `Connected to Dataverse (org ${body.OrganizationId ?? 'unknown'})`,
+                ServerVersion: `Web API ${auth.Config.ApiVersion ?? DEFAULT_API_VERSION}`,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { Success: false, Message: `Connection failed: ${message}` };
+        }
+    }
+    // ── DiscoverObjects / DiscoverFields (runtime $metadata discovery) ──
+    /**
+     * Case-2 (auth-gated) runtime discovery: enumerates EVERY table the credential can see via the
+     * `EntityDefinitions` describe endpoint (standard + custom + solution-installed) — NOT a baked
+     * catalog. The documented standard catalog seeded in the Declared metadata file is the floor;
+     * this returns what the live environment actually exposes (the ceiling), which is strictly a
+     * superset for custom-bearing tenants.
+     */
+    async DiscoverObjects(companyIntegration, contextUser) {
+        try {
+            const entities = await this.FetchEntityDefinitions(companyIntegration, contextUser);
+            return entities
+                .filter(e => typeof e.LogicalName === 'string' && typeof e.EntitySetName === 'string' && e.EntitySetName.length > 0)
+                .map(e => this.EntityMetadataToObjectSchema(e));
+        }
+        catch (err) {
+            // Case-2 (auth-gated) discovery: the live EntityDefinitions endpoint requires credentials.
+            // When the config/credential is absent, re-throw with an EXPLICIT credential-absence signal
+            // so a credential-free run is classified as "discovery requires credentials" (cross-pass
+            // consistency is proven at the live tier) rather than a hard discovery failure. A genuine
+            // live API error (credentials present) keeps its original message and propagates.
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/CredentialID or Configuration JSON|missing required field|could not be loaded|not a valid object/i.test(msg)) {
+                throw new Error(`DynamicsDataverseConnector requires credentials to discover (auth-gated EntityDefinitions endpoint): ${msg}`);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Case-2 runtime discovery for a single object's columns: describes the table's `Attributes`
+     * collection and maps each Property → {@link ExternalFieldSchema}, surfacing Type/MaxLength,
+     * the GUID PK (`IsPrimaryId` / `PrimaryIdAttribute` → `IsPrimaryKey`), and scalar Lookup
+     * columns → FK (with `ForeignKeyTarget` = the referenced table's logical name).
+     */
+    async DiscoverFields(companyIntegration, objectName, contextUser) {
+        const entity = await this.FetchEntityDefinition(companyIntegration, objectName, contextUser);
+        if (!entity) {
+            // Fall back to the Declared metadata cache if the live describe returned nothing
+            // (object not visible to these credentials) — degrade gracefully rather than drop it.
+            return super.DiscoverFields(companyIntegration, objectName, contextUser);
+        }
+        const primaryId = entity.PrimaryIdAttribute ?? `${entity.LogicalName}id`;
+        const attributes = entity.Attributes ?? [];
+        return attributes
+            .filter(a => typeof a.LogicalName === 'string' && a.LogicalName.length > 0)
+            .map(a => this.AttributeMetadataToFieldSchema(a, primaryId));
+    }
+    // ── FetchChanges (change-tracking delta override) ────────────────
+    /**
+     * Routes to the change-tracking delta path when the table declares it AND a watermark exists;
+     * otherwise delegates to the base metadata-driven fetch (which applies the `modifiedon` watermark
+     * fallback + standard `@odata.nextLink` pagination). The base path already handles
+     * `TransformRecord` (annotation stripping) + full-record pass-through, so the delta path mirrors it.
+     */
+    async FetchChanges(ctx) {
+        this.lastIntegrationID = ctx.CompanyIntegration.IntegrationID;
+        const obj = this.GetCachedObject(ctx.CompanyIntegration.IntegrationID, ctx.ObjectName);
+        if (obj.SupportsIncrementalSync && this.ObjectUsesChangeTracking(obj) && ctx.WatermarkValue) {
+            return this.FetchChangesViaDelta(ctx, obj);
+        }
+        return super.FetchChanges(ctx);
+    }
+    // ── TransformRecord — strip OData annotations (auditable removal) ──
+    /**
+     * Removes the OData control annotations (`@odata.etag`, `@odata.context`, `@odata.id`,
+     * `<lookup>@odata.bind`, `<lookup>@OData.Community.Display.V1.FormattedValue`, etc.) Dataverse
+     * sprinkles onto every record — they are response transport metadata, not columns. Every other
+     * source key is preserved (full-record pass-through); the removed keys are declared in
+     * {@link ExcludedSourceKeys} so the base re-add doesn't restore them and change-detection ignores them.
+     */
+    TransformRecord(raw, _obj, _fields) {
+        const out = {};
+        for (const [key, value] of Object.entries(raw)) {
+            if (this.IsODataAnnotationKey(key))
+                continue;
+            out[key] = value;
+        }
+        return out;
+    }
+    /**
+     * The well-known static OData control annotation keys {@link TransformRecord} drops. The base
+     * `applyTransformPreservingKeys` uses this to avoid re-adding them. Dataverse ALSO emits dynamic,
+     * per-lookup annotation suffixes (`<col>@odata.bind`, `<col>@OData.Community.Display.V1.FormattedValue`,
+     * `<col>@Microsoft.Dynamics.CRM.lookuplogicalname`) whose exact names vary by record and cannot be
+     * enumerated statically — those are handled by the {@link applyTransformPreservingKeys} override
+     * below (predicate exclusion), so they never re-appear. This static list covers the always-present
+     * envelope keys for completeness / auditability.
+     */
+    ExcludedSourceKeys(_objectName) {
+        return ['@odata.etag', '@odata.context', '@odata.id', '@odata.editLink', '@odata.type'];
+    }
+    /**
+     * Overrides the base re-add so the DYNAMIC OData annotation keys (`<col>@odata.bind`, FormattedValue,
+     * lookuplogicalname, etc.) {@link TransformRecord} strips are NOT restored. The base loop re-adds any
+     * `raw` key absent from the transform output unless it is in the static {@link ExcludedSourceKeys}
+     * set — which can't enumerate the per-record annotation suffixes. Here we re-add a dropped key only
+     * when it is neither statically excluded NOR an annotation key (by predicate). This keeps full-record
+     * pass-through for genuine columns while making the annotation removal stick (auditable, by rule).
+     */
+    applyTransformPreservingKeys(raw, obj, fields) {
+        const transformed = this.TransformRecord(raw, obj, fields);
+        if (transformed === raw)
+            return raw;
+        const excluded = new Set(this.ExcludedSourceKeys(obj.Name));
+        const out = { ...transformed };
+        for (const key of Object.keys(raw)) {
+            if (key in out || excluded.has(key) || this.IsODataAnnotationKey(key))
+                continue;
+            out[key] = raw[key];
+        }
+        return out;
+    }
+    // ─── BaseRESTIntegrationConnector abstract hooks ────────────────
+    /**
+     * Mints/caches a Microsoft Entra ID access token via client-credentials. The scope is the
+     * environment's `.default` (`<EnvironmentUrl>/.default`) so the token's audience matches the
+     * Dataverse resource. Token is cached by {@link OAuth2TokenManager} until near expiry.
+     */
+    async Authenticate(companyIntegration, contextUser, forceRefresh = false) {
+        if (forceRefresh) {
+            this.cachedAuth = null;
+            this.tokenManager.Reset();
+        }
+        else if (this.cachedAuth) {
+            // Re-mint through the manager (cheap when cached) so an expired token refreshes.
+            const refreshed = await this.MintToken(this.cachedAuth.Config);
+            return { ...this.cachedAuth, Token: refreshed };
+        }
+        const config = await this.ParseConfig(companyIntegration, contextUser);
+        const token = await this.MintToken(config);
+        const auth = {
+            Token: token,
+            Config: config,
+            BaseUrl: config.EnvironmentUrl.replace(/\/+$/, ''), // org root — IO APIPaths are absolute-from-root
+            ApiBaseUrl: this.ResolveBaseUrl(config), // versioned base for the connector's own calls
+        };
+        this.cachedAuth = auth;
+        return auth;
+    }
+    /** Runs the client_credentials token round-trip through {@link OAuth2TokenManager}. */
+    async MintToken(config) {
+        const authorityHost = (config.AuthorityHost ?? DEFAULT_AUTHORITY_HOST).replace(/\/+$/, '');
+        const tokenURL = `${authorityHost}/${encodeURIComponent(config.TenantId)}/oauth2/v2.0/token`;
+        const scope = config.Scope ?? `${config.EnvironmentUrl.replace(/\/+$/, '')}/.default`;
+        const req = {
+            TokenURL: tokenURL,
+            ClientId: config.ClientId,
+            ClientSecret: config.ClientSecret,
+            // Entra ID v2.0 accepts client_id/client_secret in the form body for confidential clients.
+            Scopes: scope,
+            ScopeParam: 'scope',
+            TimeoutMs: config.RequestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+        };
+        const token = await this.tokenManager.GetAccessToken(req, 'client_credentials');
+        return token.AccessToken;
+    }
+    /** Standard OData/Dataverse headers — bearer token + JSON + OData version + return-representation. */
+    BuildHeaders(auth) {
+        const token = auth.Token ?? '';
+        return {
+            'Authorization': `Bearer ${token}`,
+            'Accept': 'application/json',
+            'Content-Type': 'application/json; charset=utf-8',
+            'OData-MaxVersion': '4.0',
+            'OData-Version': '4.0',
+            // Ask Dataverse to return the created/updated record so create can read OData-EntityId / body.
+            'Prefer': 'return=representation',
+        };
+    }
+    /**
+     * HTTP transport with retry/backoff on 429/503/504 (Dataverse service-protection limits). The
+     * thrown error on a retryable status carries the response headers so {@link ExtractRetryAfterMs}
+     * can read `Retry-After` for the engine's adaptive bucket.
+     */
+    async MakeHTTPRequest(auth, url, method, headers, body) {
+        const config = auth.Config;
+        const maxRetries = config.MaxRetries ?? DEFAULT_MAX_RETRIES;
+        const timeoutMs = config.RequestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            const response = await this.ExecuteOneRequest(url, method, headers, body, timeoutMs);
+            if (this.IsRetryable(response) && attempt < maxRetries) {
+                const delay = this.ComputeBackoffDelay(attempt, response.Headers['retry-after']);
+                await this.Sleep(delay);
+                continue;
+            }
+            return response;
+        }
+        throw new Error(`DynamicsDataverseConnector: exhausted ${maxRetries + 1} attempts for ${method} ${url}`);
+    }
+    /**
+     * Unwraps the OData collection envelope's `value` array. A single-record GET (`/<set>(id)`) is
+     * returned as a one-element array. Honors a metadata-declared `ResponseDataKey` if set, defaulting
+     * to the OData `value` convention.
+     */
+    NormalizeResponse(rawBody, responseDataKey) {
+        if (rawBody == null || typeof rawBody !== 'object')
+            return [];
+        const body = rawBody;
+        const key = responseDataKey ?? 'value';
+        const data = body[key];
+        if (Array.isArray(data))
+            return data;
+        // Single-record detail response (has at least one non-annotation key) → wrap.
+        const hasRecordShape = Object.keys(body).some(k => !this.IsODataAnnotationKey(k));
+        return hasRecordShape ? [body] : [];
+    }
+    /**
+     * Cursor pagination via `@odata.nextLink`. The nextLink is an ABSOLUTE continuation URL that
+     * encodes the exact next request (including the opaque `$skiptoken`); it is followed VERBATIM and
+     * never hand-built. A present nextLink means another page exists.
+     */
+    ExtractPaginationInfo(rawBody, _paginationType, _currentPage, _currentOffset, _pageSize) {
+        const body = rawBody;
+        const nextLink = body?.['@odata.nextLink'];
+        return {
+            HasMore: typeof nextLink === 'string' && nextLink.length > 0,
+            NextCursor: typeof nextLink === 'string' ? nextLink : undefined,
+        };
+    }
+    /**
+     * Per-connection base the engine joins the IO `APIPath` onto. The frozen Dataverse IO APIPaths are
+     * ABSOLUTE-from-root (they already include `/api/data/v9.2/...`), so this returns the org ROOT
+     * (`<EnvironmentUrl>`) and the resolved request URL is `<EnvironmentUrl>/api/data/v9.2/<entityset>`.
+     * The versioned Web API base (`<EnvironmentUrl>/api/data/v9.2`) is `ApiBaseUrl`, used by the
+     * connector's OWN calls (WhoAmI / EntityDefinitions / delta). Never a hardcoded org URL.
+     */
+    GetBaseURL(_companyIntegration, auth) {
+        return auth.BaseUrl;
+    }
+    /**
+     * Honors the OData `@odata.nextLink` cursor (used verbatim) and otherwise injects the page-size
+     * request as a `$top`-free first page — Dataverse caps page size via the `Prefer: odata.maxpagesize`
+     * header (added in {@link MakeFirstPageHeaders}), NOT a query param, and does NOT support `$skip`.
+     */
+    BuildPaginatedURL(basePath, _obj, _page, _offset, cursor, _effectivePageSize) {
+        // A cursor is the full nextLink continuation URL — issue it exactly as Dataverse returned it.
+        if (cursor && cursor.length > 0)
+            return cursor;
+        return basePath;
+    }
+    // ─── Create-response ID extraction (OData-EntityId header) ───────
+    /**
+     * Dataverse returns the created record's URI in the `OData-EntityId` response header
+     * (e.g. `https://org.crm.dynamics.com/api/data/v9.2/accounts(00000000-...)`); the GUID is the
+     * trailing `(...)` segment. Falls back to the `Location` header, then the body PK, so a tenant
+     * configured to return-representation still resolves. An empty ID makes the create FAIL LOUDLY
+     * via the base's BuildCreatedResult (never a silent duplicate-create).
+     */
+    ExtractIDFromResponse(response, idLocation) {
+        if (!idLocation || idLocation === 'header') {
+            const headers = response.Headers ?? {};
+            const entityId = headers['odata-entityid'] ?? headers['OData-EntityId'] ?? headers['location'] ?? headers['Location'];
+            if (typeof entityId === 'string' && entityId.length > 0) {
+                const m = entityId.match(/\(([^)]+)\)\s*$/); // GUID inside the trailing (...)
+                if (m)
+                    return m[1];
+                const seg = entityId.match(/[/=]([^/?&#]+)$/);
+                return seg ? seg[1] : entityId;
+            }
+        }
+        // Body fallback — return=representation echoes the record; the PK is `<set-singular>id` but the
+        // generic id-field scan also covers `id`.
+        if (response.Body && typeof response.Body === 'object') {
+            const b = response.Body;
+            for (const k of Object.keys(b)) {
+                if (/id$/i.test(k) && (typeof b[k] === 'string' || typeof b[k] === 'number')) {
+                    const v = String(b[k]);
+                    if (v.length > 0)
+                        return v;
+                }
+            }
+        }
+        return super.ExtractIDFromResponse(response, idLocation);
+    }
+    /**
+     * Substitutes the target ID into a Dataverse single-record path. Supports the standard GUID form
+     * `/<entityset>(id)` AND the alternate-key upsert form `/<entityset>(<altkey>='<value>')` — when
+     * the ExternalID already contains an `=` it is an alternate-key expression and is inserted as-is
+     * (only the value is escaped); otherwise it is treated as a GUID. Handles both `({id})` template
+     * placeholders and a bare `(id)` suffix.
+     */
+    SubstituteIDInPath(path, externalID, idLocation) {
+        if (idLocation && idLocation !== 'path')
+            return path;
+        const keyExpr = this.BuildKeyExpression(externalID);
+        // Replace an explicit {id}/{ID}/{ExternalID} placeholder if present...
+        if (/\{(?:id|ID|ExternalID)\}/.test(path)) {
+            return path
+                .replace(/\{ID\}/g, keyExpr)
+                .replace(/\{id\}/g, keyExpr)
+                .replace(/\{ExternalID\}/g, keyExpr);
+        }
+        // ...otherwise inject into the `(...)` segment the metadata path declares (`/accounts({id})`
+        // came pre-substituted above; a literal `/accounts()` or `/accounts` gets the key appended).
+        if (/\(\s*\)\s*$/.test(path)) {
+            return path.replace(/\(\s*\)\s*$/, `(${keyExpr})`);
+        }
+        return `${path.replace(/\/+$/, '')}(${keyExpr})`;
+    }
+    /**
+     * Builds the OData key expression for a single-record path. A plain GUID → `00000000-...`. An
+     * alternate-key expression (`key='value'` or `k1='v1',k2='v2'`) is passed through with each value
+     * single-quote-escaped. This realizes the alternate-key upsert path form the metadata may declare.
+     */
+    BuildKeyExpression(externalID) {
+        if (externalID.includes('=')) {
+            // Alternate-key form: keep `key='...'` pairs, escape embedded single quotes in values.
+            return externalID.replace(/'([^']*)'/g, (_full, v) => `'${v.replace(/'/g, "''")}'`);
+        }
+        return externalID; // GUID — Dataverse accepts the bare GUID inside the parentheses.
+    }
+    // ─── Change-tracking delta sync ──────────────────────────────────
+    /** Whether a table is configured for change tracking (Configuration.changeTrackingHeader present). */
+    ObjectUsesChangeTracking(obj) {
+        const header = this.readObjectConfigString(obj, 'changeTrackingHeader');
+        return header != null && /track-changes/i.test(header);
+    }
+    /**
+     * Fetches changed records via Dataverse change tracking. The watermark holds the previous poll's
+     * `@odata.deltaLink` (a full URL carrying `$deltatoken`) — followed VERBATIM. Deleted records
+     * arrive as `$deletedEntity` references; they are surfaced with `IsDeleted=true`. The last page's
+     * `@odata.deltaLink` becomes the new watermark for the next poll.
+     */
+    async FetchChangesViaDelta(ctx, obj) {
+        const auth = await this.Authenticate(ctx.CompanyIntegration, ctx.ContextUser);
+        const fields = this.GetCachedFields(obj.ID);
+        const pkFieldNames = fields.filter(f => f.IsPrimaryKey).map(f => f.Name);
+        // The watermark is the prior deltaLink (a full URL); if it's not a URL, build the initial
+        // delta request off the object's read path with the track-changes Prefer header.
+        const deltaUrl = ctx.WatermarkValue && /^https?:\/\//.test(ctx.WatermarkValue)
+            ? ctx.WatermarkValue
+            : this.buildDataverseURL(auth.BaseUrl, obj.APIPath);
+        const headers = { ...this.BuildHeaders(auth), Prefer: 'odata.track-changes,return=representation' };
+        const response = await this.MakeHTTPRequest(auth, deltaUrl, 'GET', headers);
+        if (response.Status < 200 || response.Status >= 300) {
+            throw new Error(`Dataverse delta fetch failed for "${obj.Name}": HTTP ${response.Status} — ${this.previewBody(response.Body)}`);
+        }
+        const body = response.Body;
+        const rows = body.value ?? [];
+        const nextLink = body['@odata.nextLink'];
+        const deltaLink = body['@odata.deltaLink'];
+        const records = rows.map(r => this.DeltaRowToExternalRecord(r, obj, fields, pkFieldNames));
+        return {
+            Records: records,
+            HasMore: typeof nextLink === 'string' && nextLink.length > 0,
+            NextCursor: typeof nextLink === 'string' ? nextLink : undefined,
+            // Only persist the new high-water deltaLink once the full delta set has drained (last page).
+            NewWatermarkValue: typeof deltaLink === 'string' ? deltaLink : undefined,
+        };
+    }
+    /** Maps one change-tracking row (live record OR `$deletedEntity` tombstone) to an ExternalRecord. */
+    DeltaRowToExternalRecord(raw, obj, fields, pkFieldNames) {
+        const isDeleted = typeof raw['@odata.context'] === 'string' && /\$deletedEntity/i.test(raw['@odata.context']);
+        const transformed = this.applyTransformPreservingKeys(raw, obj, fields);
+        const idFieldName = pkFieldNames[0];
+        const externalID = idFieldName && transformed[idFieldName] != null
+            ? String(transformed[idFieldName])
+            : (typeof raw['id'] === 'string' ? raw['id'] : '');
+        return {
+            ExternalID: externalID,
+            ObjectType: obj.Name,
+            Fields: transformed, // full source record (minus annotations) — custom-column pass-through
+            IsDeleted: isDeleted,
+        };
+    }
+    // ─── EntityDefinitions describe helpers ──────────────────────────
+    /** Fetches the full table list via `EntityDefinitions` (paged, following @odata.nextLink). */
+    async FetchEntityDefinitions(companyIntegration, contextUser) {
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const select = '$select=LogicalName,EntitySetName,DisplayName,Description,PrimaryIdAttribute,PrimaryNameAttribute,ChangeTrackingEnabled,IsCustomEntity';
+        let url = `${auth.ApiBaseUrl}/EntityDefinitions?${select}`;
+        const out = [];
+        while (url) {
+            const response = await this.MakeHTTPRequest(auth, url, 'GET', this.BuildHeaders(auth));
+            if (response.Status < 200 || response.Status >= 300) {
+                throw new Error(`EntityDefinitions describe failed: HTTP ${response.Status} — ${this.previewBody(response.Body)}`);
+            }
+            const body = response.Body;
+            for (const e of body.value ?? [])
+                out.push(e);
+            url = typeof body['@odata.nextLink'] === 'string' ? body['@odata.nextLink'] : undefined;
+        }
+        return out;
+    }
+    /** Describes one table + its Attributes by logical name. Returns null if not visible to the credential. */
+    async FetchEntityDefinition(companyIntegration, objectName, contextUser) {
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const logicalName = this.ResolveLogicalName(companyIntegration, objectName);
+        const expand = '$expand=Attributes($select=LogicalName,SchemaName,DisplayName,Description,AttributeType,MaxLength,Precision,IsValidForCreate,IsValidForUpdate,IsPrimaryId,RequiredLevel,Targets)';
+        const select = '$select=LogicalName,EntitySetName,DisplayName,Description,PrimaryIdAttribute,PrimaryNameAttribute,ChangeTrackingEnabled,IsCustomEntity';
+        const url = `${auth.ApiBaseUrl}/EntityDefinitions(LogicalName='${encodeURIComponent(logicalName)}')?${select}&${expand}`;
+        const response = await this.MakeHTTPRequest(auth, url, 'GET', this.BuildHeaders(auth));
+        if (response.Status === 404)
+            return null;
+        if (response.Status < 200 || response.Status >= 300) {
+            throw new Error(`EntityDefinition describe failed for "${objectName}": HTTP ${response.Status} — ${this.previewBody(response.Body)}`);
+        }
+        return response.Body;
+    }
+    /** Resolves the Dataverse logical name for an IO (Configuration.logicalName, else the IO name). */
+    ResolveLogicalName(companyIntegration, objectName) {
+        const obj = this.tryGetCachedObjectFor(companyIntegration.IntegrationID, objectName);
+        if (obj) {
+            const logical = this.readObjectConfigString(obj, 'logicalName');
+            if (logical)
+                return logical;
+        }
+        return objectName;
+    }
+    /** Maps a Dataverse table describe entry → ExternalObjectSchema. */
+    EntityMetadataToObjectSchema(e) {
+        const name = e.LogicalName;
+        return {
+            Name: name,
+            Label: this.LocalizedLabel(e.DisplayName) ?? name,
+            Description: this.LocalizedLabel(e.Description) ?? undefined,
+            SupportsIncrementalSync: e.ChangeTrackingEnabled === true || true, // modifiedon fallback always available
+            SupportsWrite: true, // Dataverse tables are generally CRUD-capable; per-table messages refine downstream
+        };
+    }
+    /** Maps a Dataverse attribute describe entry → ExternalFieldSchema. */
+    AttributeMetadataToFieldSchema(a, primaryId) {
+        const name = a.LogicalName;
+        const isPk = a.IsPrimaryId === true || name === primaryId;
+        const requiredLevel = a.RequiredLevel?.Value;
+        const isRequired = requiredLevel === 'SystemRequired' || requiredLevel === 'ApplicationRequired';
+        // A scalar Lookup attribute that names a single target table is a FK. A polymorphic lookup
+        // (multiple Targets) or non-Lookup attribute is NOT emitted as an FK (provable-only).
+        const isLookup = a.AttributeType === 'Lookup' || a.AttributeType === 'Customer' || a.AttributeType === 'Owner';
+        const singleTarget = isLookup && Array.isArray(a.Targets) && a.Targets.length === 1 ? a.Targets[0] : null;
+        return {
+            Name: name,
+            Label: this.LocalizedLabel(a.DisplayName) ?? name,
+            Description: this.LocalizedLabel(a.Description) ?? undefined,
+            DataType: a.AttributeType ?? 'String',
+            IsRequired: isRequired,
+            IsUniqueKey: isPk,
+            IsPrimaryKey: isPk,
+            IsReadOnly: a.IsValidForCreate === false && a.IsValidForUpdate === false,
+            IsForeignKey: singleTarget != null,
+            ForeignKeyTarget: singleTarget,
+            MaxLength: typeof a.MaxLength === 'number' ? a.MaxLength : null,
+            Precision: typeof a.Precision === 'number' ? a.Precision : null,
+        };
+    }
+    /** Reads a Dataverse localized label, falling back to undefined. */
+    LocalizedLabel(label) {
+        const text = label?.UserLocalizedLabel?.Label;
+        return typeof text === 'string' && text.length > 0 ? text : undefined;
+    }
+    // ─── Config parsing ──────────────────────────────────────────────
+    /** Parses the connection config, preferring the attached MJ Credential over Configuration JSON. */
+    async ParseConfig(companyIntegration, contextUser) {
+        if (companyIntegration.CredentialID) {
+            return this.ParseConfigFromCredential(companyIntegration.CredentialID, contextUser);
+        }
+        if (companyIntegration.Configuration) {
+            return this.ValidateConfig(JSON.parse(companyIntegration.Configuration));
+        }
+        throw new Error('DynamicsDataverseConnector requires either CredentialID or Configuration JSON on the CompanyIntegration');
+    }
+    /** Loads the OAuth2 config from the MJ: Credentials entity Values JSON. */
+    async ParseConfigFromCredential(credentialID, contextUser, provider) {
+        const md = provider ?? new Metadata();
+        const cred = await md.GetEntityObject('MJ: Credentials', contextUser);
+        const loaded = await cred.Load(credentialID);
+        if (!loaded || !cred.Values) {
+            throw new Error('Dynamics credential could not be loaded or has no Values JSON');
+        }
+        return this.ValidateConfig(JSON.parse(cred.Values));
+    }
+    /** Validates the parsed config + applies defaults. Field names are read case-insensitively. */
+    ValidateConfig(raw) {
+        if (!raw || typeof raw !== 'object') {
+            throw new Error('Dynamics configuration is not a valid object');
+        }
+        const obj = raw;
+        const getStr = (...keys) => {
+            for (const key of keys) {
+                const lower = key.toLowerCase();
+                for (const [k, v] of Object.entries(obj)) {
+                    if (k.toLowerCase() === lower && typeof v === 'string' && v.length > 0)
+                        return v;
+                }
+            }
+            return undefined;
+        };
+        const getNum = (...keys) => {
+            for (const key of keys) {
+                const lower = key.toLowerCase();
+                for (const [k, v] of Object.entries(obj)) {
+                    if (k.toLowerCase() === lower && typeof v === 'number')
+                        return v;
+                }
+            }
+            return undefined;
+        };
+        const tenantId = getStr('tenantid', 'tenant_id', 'tenant');
+        const clientId = getStr('clientid', 'client_id', 'applicationid', 'appid');
+        const clientSecret = getStr('clientsecret', 'client_secret', 'secret');
+        const environmentUrl = getStr('environmenturl', 'environment_url', 'resource', 'orgurl', 'org_url', 'baseurl', 'base_url');
+        if (!tenantId)
+            throw new Error('Dynamics configuration missing required field: TenantId');
+        if (!clientId)
+            throw new Error('Dynamics configuration missing required field: ClientId');
+        if (!clientSecret)
+            throw new Error('Dynamics configuration missing required field: ClientSecret');
+        if (!environmentUrl)
+            throw new Error('Dynamics configuration missing required field: EnvironmentUrl');
+        return {
+            TenantId: tenantId,
+            ClientId: clientId,
+            ClientSecret: clientSecret,
+            EnvironmentUrl: environmentUrl.replace(/\/+$/, ''),
+            ApiVersion: getStr('apiversion', 'api_version') ?? DEFAULT_API_VERSION,
+            AuthorityHost: getStr('authorityhost', 'authority_host', 'authority'),
+            Scope: getStr('scope', 'scopes'),
+            MaxRetries: getNum('maxretries') ?? DEFAULT_MAX_RETRIES,
+            RequestTimeoutMs: getNum('requesttimeoutms') ?? DEFAULT_REQUEST_TIMEOUT_MS,
+            MinRequestIntervalMs: getNum('minrequestintervalms') ?? 0,
+            MaxPageSize: Math.min(getNum('maxpagesize') ?? MAX_ODATA_PAGE_SIZE, MAX_ODATA_PAGE_SIZE),
+        };
+    }
+    /** Resolves the Web API base URL: `<EnvironmentUrl>/api/data/v9.2`. */
+    ResolveBaseUrl(config) {
+        const version = config.ApiVersion ?? DEFAULT_API_VERSION;
+        return `${config.EnvironmentUrl.replace(/\/+$/, '')}/api/data/${version}`;
+    }
+    // ─── HTTP helpers ────────────────────────────────────────────────
+    async ExecuteOneRequest(url, method, headers, body, timeoutMs) {
+        const controller = new AbortController();
+        const timeoutHandle = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body !== undefined && method !== 'GET' && method !== 'DELETE'
+                    ? JSON.stringify(body)
+                    : undefined,
+                signal: controller.signal,
+            });
+            const responseHeaders = this.ExtractHeaders(response.headers);
+            const parsedBody = await this.ParseResponseBody(response);
+            return { Status: response.status, Body: parsedBody, Headers: responseHeaders };
+        }
+        finally {
+            clearTimeout(timeoutHandle);
+        }
+    }
+    async ParseResponseBody(response) {
+        const text = await response.text();
+        if (!text)
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    ExtractHeaders(headers) {
+        const map = {};
+        headers.forEach((value, key) => {
+            map[key.toLowerCase()] = value;
+        });
+        return map;
+    }
+    IsRetryable(response) {
+        return response.Status === 429 || response.Status === 503 || response.Status === 504;
+    }
+    ComputeBackoffDelay(attempt, retryAfterHeader) {
+        if (retryAfterHeader) {
+            const parsed = parseInt(retryAfterHeader, 10);
+            if (!Number.isNaN(parsed) && parsed > 0) {
+                return Math.min(parsed * 1000, 120_000);
+            }
+        }
+        return Math.min(Math.pow(2, attempt) * 1000, 30_000);
+    }
+    Sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    // ─── Small utilities ─────────────────────────────────────────────
+    /**
+     * True for any OData/Dataverse annotation key. Genuine columns never contain `@`; every annotation
+     * does — the response-level controls (`@odata.etag`, `@odata.context`, …) and the per-column
+     * suffixes (`<col>@odata.bind`, `<col>@OData.Community.Display.V1.FormattedValue`,
+     * `<col>@Microsoft.Dynamics.CRM.lookuplogicalname`). So an `@`-containing key is an annotation.
+     */
+    IsODataAnnotationKey(key) {
+        return key.includes('@');
+    }
+    buildDataverseURL(baseURL, apiPath) {
+        const base = baseURL.replace(/\/+$/, '');
+        const path = apiPath.startsWith('/') ? apiPath : `/${apiPath}`;
+        return `${base}${path}`;
+    }
+    previewBody(body) {
+        const s = typeof body === 'string' ? body : JSON.stringify(body);
+        return (s ?? '').slice(0, 500);
+    }
+    /**
+     * Best-effort cached-object lookup by NAME using the last-seen integration ID. Used by
+     * {@link StableOrderingKey}, which the engine calls without a CompanyIntegration; returns null
+     * (keyset resume simply unavailable) before any fetch has run.
+     */
+    tryGetCachedObject(objectName) {
+        if (!this.lastIntegrationID)
+            return null;
+        return this.tryGetCachedObjectFor(this.lastIntegrationID, objectName);
+    }
+    tryGetCachedObjectFor(integrationID, objectName) {
+        if (!integrationID)
+            return null;
+        try {
+            return this.GetCachedObject(integrationID, objectName);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Reads a trimmed string from an IO's Configuration JSON, tolerant of absent/invalid. */
+    readObjectConfigString(obj, key) {
+        const raw = obj.Configuration;
+        if (!raw || typeof raw !== 'string')
+            return null;
+        try {
+            const cfg = JSON.parse(raw);
+            const v = cfg[key];
+            return typeof v === 'string' && v.trim().length > 0 ? v.trim() : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Extracts response headers from a thrown error, when the connector throws an error carrying them. */
+    extractHeadersFromError(error) {
+        if (error && typeof error === 'object') {
+            const e = error;
+            return e.Headers ?? e.headers;
+        }
+        return undefined;
+    }
+};
+DynamicsDataverseConnector = __decorate([
+    RegisterClass(BaseIntegrationConnector, '@memberjunction/connector-microsoft-dynamics-365-dataverse')
+], DynamicsDataverseConnector);
+export { DynamicsDataverseConnector };
+/** Tree-shaking prevention function — import and call from the package entry point. */
+export function LoadDynamicsDataverseConnector() { }
+//# sourceMappingURL=DynamicsDataverseConnector.js.map

package/dist/DynamicsDataverseConnector.js.map

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

package/dist/index.d.ts

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@memberjunction/connector-microsoft-dynamics-365-dataverse",
+  "version": "1.0.0",
+  "description": "MemberJunction DynamicsDataverse 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": {},
+  "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"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/Integrations"
+  }
+}