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

package/dist/RasaConnector.js

@@ -1,929 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { RegisterClass } from '@memberjunction/global';
-import { Metadata } from '@memberjunction/core';
-import { BaseIntegrationConnector, BaseRESTIntegrationConnector, } from '@memberjunction/integration-engine';
-// ─── Constants ───────────────────────────────────────────────────────
-/** Rasa.io API base URL */
-const RASA_API_BASE = 'https://api.rasa.io/v1';
-/** JWT tokens are refreshed every 50 minutes (tokens last ~60 min) */
-const TOKEN_TTL_MS = 50 * 60 * 1000;
-/** Maximum retries for rate-limited or failed requests */
-const MAX_RETRIES = 3;
-/** HTTP request timeout in milliseconds */
-const REQUEST_TIMEOUT_MS = 60000;
-/** Minimum milliseconds between API requests */
-const MIN_REQUEST_INTERVAL_MS = 200;
-/** Default page size for Rasa.io API calls */
-const DEFAULT_PAGE_SIZE = 50;
-// ─── Connector Implementation ────────────────────────────────────────
-/**
- * Connector for the Rasa.io newsletter platform REST API.
- *
- * Extends BaseRESTIntegrationConnector to leverage metadata-driven object/field
- * discovery from IntegrationEngineBase cache and generic pagination handling.
- *
- * Auth flow:
- *   1. POST /v1/tokens with Basic auth header + { "key": "<API-key>" } body
- *   2. Receive JWT token in response
- *   3. Pass JWT as rasa-token header on all data requests
- *
- * Pagination:
- *   - persons/posts: offset-based (skip/limit), supports updated_since watermark
- *   - insights/actions: cursor-based (base64 skip token from next_link), supports created_since watermark
- *   - insights/topics: no pagination, full replace on each sync
- *
- * Response envelope: { code, metadata: { next_link, record_count }, results: [...] }
- */
-// ─── Action Metadata Objects ──────────────────────────────────────────
-const RASA_ACTION_OBJECTS = [
-    {
-        Name: 'persons', DisplayName: 'Person',
-        Description: 'A newsletter subscriber/contact in Rasa.io', SupportsWrite: false,
-        Fields: [
-            { Name: 'email', DisplayName: 'Email', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Subscriber email address' },
-            { Name: 'first_name', DisplayName: 'First Name', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Subscriber first name' },
-            { Name: 'last_name', DisplayName: 'Last Name', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Subscriber last name' },
-            { Name: 'external_id', DisplayName: 'Source External ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'External ID from source system' },
-            { Name: 'is_active', DisplayName: 'Is Active', Type: 'boolean', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Whether the subscriber is active' },
-            { Name: 'is_subscribed', DisplayName: 'Is Subscribed', Type: 'boolean', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Whether the subscriber is subscribed' },
-            { Name: 'id', DisplayName: 'ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'Rasa.io internal person ID' },
-            { Name: 'created', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the person was created' },
-            { Name: 'updated', DisplayName: 'Updated Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last updated' },
-        ],
-    },
-    {
-        Name: 'posts', DisplayName: 'Post',
-        Description: 'A newsletter content article/post in Rasa.io', SupportsWrite: false,
-        Fields: [
-            { Name: 'title', DisplayName: 'Title', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Post title' },
-            { Name: 'description', DisplayName: 'Description', Type: 'text', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Post description/summary' },
-            { Name: 'url', DisplayName: 'URL', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Post URL' },
-            { Name: 'source_url', DisplayName: 'Source URL', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Original source URL' },
-            { Name: 'image_url', DisplayName: 'Image URL', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Post image URL' },
-            { Name: 'quality_score', DisplayName: 'Quality Score', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Content quality score' },
-            { Name: 'is_active', DisplayName: 'Is Active', Type: 'boolean', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Whether the post is active' },
-            { Name: 'id', DisplayName: 'ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'Rasa.io internal post ID' },
-            { Name: 'created', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the post was created' },
-            { Name: 'updated', DisplayName: 'Updated Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last updated' },
-        ],
-    },
-    {
-        Name: 'insights-actions', DisplayName: 'Insight Action',
-        Description: 'User action/engagement events from Rasa.io analytics', SupportsWrite: false,
-        Fields: [
-            { Name: 'person_id', DisplayName: 'Person ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Associated person ID' },
-            { Name: 'email', DisplayName: 'Email', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Person email' },
-            { Name: 'action_type', DisplayName: 'Action Type', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Type of action (click, open, etc.)' },
-            { Name: 'created', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the action occurred' },
-            { Name: 'id', DisplayName: 'ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'Action event ID' },
-        ],
-    },
-    {
-        Name: 'insights-topics', DisplayName: 'Insight Topic',
-        Description: 'User topic interest data from Rasa.io analytics', SupportsWrite: false,
-        Fields: [
-            { Name: 'person_id', DisplayName: 'Person ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Associated person ID' },
-            { Name: 'email', DisplayName: 'Email', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Person email' },
-            { Name: 'topic', DisplayName: 'Topic', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Topic name' },
-            { Name: 'weight', DisplayName: 'Weight', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Interest weight/score' },
-            { Name: 'first_click', DisplayName: 'First Click', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'First interaction with this topic' },
-            { Name: 'last_click', DisplayName: 'Last Click', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Most recent interaction' },
-            { Name: 'id', DisplayName: 'ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'Topic interest ID' },
-        ],
-    },
-    {
-        Name: 'person-attributes', DisplayName: 'Person Attribute',
-        Description: 'Flattened custom attribute key-value pairs per person from GET /v1/persons/{id}/attributes. Custom attributes are free-form — any key the client has populated.',
-        SupportsWrite: false,
-        Fields: [
-            { Name: 'person_id', DisplayName: 'Person ID', Type: 'string', IsRequired: true, IsReadOnly: true, IsPrimaryKey: true, Description: 'Rasa.io person identifier (composite key)' },
-            { Name: 'external_id', DisplayName: 'External ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'External system identifier' },
-            { Name: 'email', DisplayName: 'Email', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Subscriber email' },
-            { Name: 'attribute_name', DisplayName: 'Attribute Name', Type: 'string', IsRequired: true, IsReadOnly: true, IsPrimaryKey: true, Description: 'Custom attribute key (composite key)' },
-            { Name: 'attribute_value', DisplayName: 'Attribute Value', Type: 'text', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Stringified attribute value' },
-        ],
-    },
-    {
-        Name: 'analytics-activities', DisplayName: 'Activities Analytics',
-        Description: 'Email activity metrics (opens, clicks, deliveries, bounces) bucketed by date from POST /v1/analytics/activities. Supports date_range / interval / segment filters.',
-        SupportsWrite: false,
-        Fields: [
-            { Name: 'bucket_start', DisplayName: 'Bucket Start', Type: 'string', IsRequired: true, IsReadOnly: true, IsPrimaryKey: true, Description: 'Bucket start timestamp (composite key)' },
-            { Name: 'metric_name', DisplayName: 'Metric Name', Type: 'string', IsRequired: true, IsReadOnly: true, IsPrimaryKey: true, Description: 'Metric name (opens, clicks, ...) — composite key' },
-            { Name: 'metric_value', DisplayName: 'Metric Value', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Aggregated metric count' },
-            { Name: 'segment_code', DisplayName: 'Segment Code', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Segment filter' },
-            { Name: 'interval', DisplayName: 'Interval', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Bucket interval (day/hour/week)' },
-            { Name: 'timezone', DisplayName: 'Timezone', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Aggregation timezone' },
-        ],
-    },
-    {
-        Name: 'analytics-articles', DisplayName: 'Articles Analytics',
-        Description: 'Article click analytics ranked by popularity from POST /v1/analytics/articles.',
-        SupportsWrite: false,
-        Fields: [
-            { Name: 'article_id', DisplayName: 'Article ID', Type: 'string', IsRequired: true, IsReadOnly: true, IsPrimaryKey: true, Description: 'Article identifier' },
-            { Name: 'title', DisplayName: 'Title', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Article title' },
-            { Name: 'url', DisplayName: 'URL', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Article URL' },
-            { Name: 'click_count', DisplayName: 'Click Count', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Total clicks' },
-            { Name: 'unique_click_count', DisplayName: 'Unique Click Count', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Unique click count' },
-            { Name: 'date_range', DisplayName: 'Date Range', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Date range filter used' },
-            { Name: 'segment_code', DisplayName: 'Segment Code', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Segment filter' },
-        ],
-    },
-    {
-        Name: 'analytics-topics', DisplayName: 'Topics Analytics',
-        Description: 'Topic engagement ranking with unique user counts from POST /v1/analytics/topics.',
-        SupportsWrite: false,
-        Fields: [
-            { Name: 'topic', DisplayName: 'Topic', Type: 'string', IsRequired: true, IsReadOnly: true, IsPrimaryKey: true, Description: 'Topic name' },
-            { Name: 'total_interactions', DisplayName: 'Total Interactions', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Total engagement count' },
-            { Name: 'unique_users', DisplayName: 'Unique Users', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Unique engaged users' },
-            { Name: 'date_range', DisplayName: 'Date Range', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Date range filter used' },
-            { Name: 'segment_code', DisplayName: 'Segment Code', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Segment filter' },
-            { Name: 'timezone', DisplayName: 'Timezone', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Aggregation timezone' },
-        ],
-    },
-];
-// ─── Analytics query defaults ─────────────────────────────────────────
-/** Default date range label when no watermark is present (covers recent history). */
-const ANALYTICS_DEFAULT_DATE_RANGE = 'past_month';
-/** Default bucket interval for activities analytics. */
-const ANALYTICS_DEFAULT_INTERVAL = 'day';
-/** Default suspect-click filter. */
-const ANALYTICS_DEFAULT_SUSPECT_CLICK = 'real_clicks';
-/** Default analytics timezone. */
-const ANALYTICS_DEFAULT_TIMEZONE = 'UTC';
-/** Default segment code for analytics. */
-const ANALYTICS_DEFAULT_SEGMENT = 'All';
-/** Object names that require a POST body for analytics endpoints. */
-const ANALYTICS_POST_OBJECTS = new Set([
-    'analytics-activities',
-    'analytics-articles',
-    'analytics-topics',
-]);
-let RasaConnector = class RasaConnector extends BaseRESTIntegrationConnector {
-    constructor() {
-        super(...arguments);
-        /** Cached JWT token */
-        this.cachedToken = null;
-        /** When the cached token was obtained */
-        this.tokenObtainedAt = 0;
-        /** Timestamp of the last API request, used for throttling */
-        this.lastRequestTime = 0;
-        /** Running count of records fetched for the current object in this sync run */
-        this._runningFetchTotal = 0;
-        /** Tracks all ExternalIDs seen per object in this sync run to detect API wrap-around */
-        this._seenIDs = new Map();
-        /** Last fetched URL path, used for per-page logging */
-        this._lastFetchedPath = '';
-        /** Watermark value for the current FetchChanges call — used in BuildPaginatedURL */
-        this._currentWatermark = undefined;
-        /** Object name for the current FetchChanges call — used in NormalizeResponse and BuildPaginatedURL */
-        this._currentObjectName = '';
-        /**
-         * Buffer for non-paginated objects that return more records than BatchSize in one shot.
-         * Keyed by object name. Records are spliced out as they're served to the engine.
-         */
-        this._batchBuffer = new Map();
-        /**
-         * Watermark values pre-computed from the full result set when buffering.
-         * Stored so the final buffer batch can still advance the watermark correctly.
-         */
-        this._batchBufferWatermarks = new Map();
-    }
-    get IntegrationName() { return 'Rasa.io'; }
-    GetIntegrationObjects() {
-        return RASA_ACTION_OBJECTS;
-    }
-    GetActionGeneratorConfig() {
-        const config = super.GetActionGeneratorConfig();
-        if (!config)
-            return null;
-        config.IconClass = 'fa-solid fa-envelope-open-text';
-        config.CategoryDescription = 'Rasa.io email newsletter integration for managing subscribers, newsletters, and engagement data';
-        config.ParentCategoryName = 'Communication';
-        // Rasa.io is read-only but we still want Search/List actions for querying
-        config.IncludeSearch = true;
-        config.IncludeList = true;
-        return config;
-    }
-    // ─── Abstract method implementations ─────────────────────────────
-    async Authenticate(companyIntegration, contextUser) {
-        console.log(`[Rasa.io] Authenticating...`);
-        const config = await this.ParseConfig(companyIntegration, contextUser);
-        const token = await this.GetToken(config);
-        // Do NOT log credential-derived info (token length, prefix, etc.) — would leak secret-shape data into MJAPI logs.
-        console.log(`[Rasa.io] Authenticated successfully`);
-        const auth = { Token: token, Config: config };
-        return auth;
-    }
-    BuildHeaders(auth) {
-        return {
-            'rasa-token': auth.Token,
-            'Accept': 'application/json',
-            'Content-Type': 'application/json',
-        };
-    }
-    async MakeHTTPRequest(auth, url, method, headers, body) {
-        const rasaAuth = auth;
-        // Throttle requests
-        const elapsed = Date.now() - this.lastRequestTime;
-        if (elapsed < MIN_REQUEST_INTERVAL_MS) {
-            await this.Sleep(MIN_REQUEST_INTERVAL_MS - elapsed);
-        }
-        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-            const fetchOptions = {
-                method,
-                headers,
-                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-            };
-            if (body && method !== 'GET') {
-                fetchOptions.body = JSON.stringify(body);
-            }
-            let response;
-            try {
-                response = await fetch(url, fetchOptions);
-            }
-            catch (err) {
-                if (attempt < MAX_RETRIES && this.IsTimeoutOrNetworkError(err)) {
-                    console.warn(`Rasa.io timeout on ${url}, retrying (attempt ${attempt + 1}/${MAX_RETRIES})`);
-                    await this.Sleep(1000 * (attempt + 1));
-                    continue;
-                }
-                throw err;
-            }
-            if (response.status === 401 && attempt < MAX_RETRIES) {
-                // Token expired, refresh and retry
-                console.warn('Rasa.io 401, refreshing token');
-                this.cachedToken = null;
-                const newToken = await this.GetToken(rasaAuth.Config);
-                rasaAuth.Token = newToken;
-                headers['rasa-token'] = newToken;
-                continue;
-            }
-            if (response.status === 429 && attempt < MAX_RETRIES) {
-                const delayMs = 2000 * Math.pow(2, attempt);
-                console.warn(`Rasa.io rate limited (429), retrying in ${delayMs}ms`);
-                await this.Sleep(delayMs);
-                continue;
-            }
-            this.lastRequestTime = Date.now();
-            const responseBody = await response.json();
-            const responseHeaders = {};
-            response.headers.forEach((value, key) => {
-                responseHeaders[key.toLowerCase()] = value;
-            });
-            return {
-                Status: response.status,
-                Body: responseBody,
-                Headers: responseHeaders,
-            };
-        }
-        throw new Error(`Rasa.io request failed after ${MAX_RETRIES} retries: ${url}`);
-    }
-    NormalizeResponse(rawBody, responseDataKey) {
-        const body = rawBody;
-        if (body.results && Array.isArray(body.results)) {
-            const rawResults = body.results;
-            // insights/topics: flatten nested topics[] per person into individual rows
-            if (this._currentObjectName.toLowerCase() === 'insights-topics') {
-                return this.FlattenInsightsTopics(rawResults);
-            }
-            // person-attributes: flatten the attributes object per person into one row per (person, attribute)
-            if (this._currentObjectName.toLowerCase() === 'person-attributes') {
-                return this.FlattenPersonAttributes(rawResults);
-            }
-            // analytics-activities: flatten date-bucketed metric dictionary into rows
-            if (this._currentObjectName.toLowerCase() === 'analytics-activities') {
-                return this.FlattenActivitiesAnalytics(rawResults);
-            }
-            // analytics-articles / analytics-topics: plain rows — just unwrap data envelopes
-            // Standard envelope: each item may wrap actual record under 'data' key — unwrap it
-            const records = rawResults.map(item => {
-                const inner = item['data'];
-                return (inner && typeof inner === 'object' && !Array.isArray(inner))
-                    ? inner
-                    : item;
-            });
-            this._runningFetchTotal += records.length;
-            const pathLabel = this._lastFetchedPath || 'unknown';
-            console.log(`[Rasa.io] Fetched ${records.length} records (running total: ${this._runningFetchTotal}) from ${pathLabel}`);
-            return records;
-        }
-        // If responseDataKey is specified, use it
-        if (responseDataKey && body[responseDataKey]) {
-            const data = body[responseDataKey];
-            return Array.isArray(data) ? data : [data];
-        }
-        // Fallback: if body itself is an array
-        if (Array.isArray(body)) {
-            return body;
-        }
-        return [];
-    }
-    ExtractPaginationInfo(rawBody, _paginationType, _currentPage, currentOffset, pageSize) {
-        const body = rawBody;
-        const metadata = body.metadata;
-        if (!metadata) {
-            return { HasMore: false };
-        }
-        const totalRecords = metadata.record_count;
-        const nextLink = metadata.next_link;
-        // Count actual records returned in this page
-        const results = body.results;
-        const returnedCount = Array.isArray(results) ? results.length : 0;
-        // If the API returned fewer records than the page size, this is the last page.
-        // The Rasa API returns next_link even past the end of the dataset, so we cannot
-        // rely on next_link alone. Fewer records than requested = no more data.
-        if (returnedCount < pageSize) {
-            return { HasMore: false, TotalRecords: totalRecords };
-        }
-        const hasMore = !!nextLink && nextLink.length > 0;
-        if (!hasMore) {
-            return { HasMore: false, TotalRecords: totalRecords };
-        }
-        // Determine cursor vs offset by inspecting the skip param in next_link
-        let nextCursor;
-        let nextOffset;
-        try {
-            const url = new URL(nextLink);
-            const skipParam = url.searchParams.get('skip');
-            if (skipParam && isNaN(Number(skipParam))) {
-                // Non-numeric skip param = base64 cursor token (insights/actions)
-                nextCursor = skipParam;
-            }
-            else {
-                nextOffset = currentOffset + returnedCount;
-            }
-        }
-        catch {
-            nextOffset = currentOffset + pageSize;
-        }
-        return {
-            HasMore: true,
-            NextOffset: nextOffset,
-            NextCursor: nextCursor,
-            TotalRecords: totalRecords,
-        };
-    }
-    GetBaseURL(_companyIntegration) {
-        return RASA_API_BASE;
-    }
-    /**
-     * Builds paginated URL with:
-     *  - Watermark filter params (updated_since / created_since) sent server-side
-     *  - Offset-based skip/limit for persons and posts
-     *  - Cursor-based skip token for insights/actions
-     *  - No pagination params for insights/topics
-     */
-    BuildPaginatedURL(basePath, obj, _page, offset, cursor, effectivePageSize) {
-        try {
-            this._lastFetchedPath = new URL(basePath).pathname;
-        }
-        catch {
-            this._lastFetchedPath = basePath;
-        }
-        const objectName = (obj.Name ?? '').toLowerCase();
-        const limit = effectivePageSize ?? obj.DefaultPageSize ?? DEFAULT_PAGE_SIZE;
-        const params = new URLSearchParams();
-        // Pass watermark filter to API so it only returns changed records
-        if (this._currentWatermark) {
-            if (objectName === 'persons' || objectName === 'posts') {
-                params.set('updated_since', this._currentWatermark);
-            }
-            else if (objectName === 'insights-actions') {
-                params.set('created_since', this._currentWatermark);
-            }
-        }
-        // Pagination params — insights/topics has no pagination
-        if (objectName !== 'insights-topics') {
-            if (objectName === 'insights-actions' && cursor) {
-                // Cursor-based: cursor is the base64 skip token extracted from previous next_link
-                params.set('skip', cursor);
-            }
-            else if (offset > 0) {
-                // Offset-based
-                params.set('skip', String(offset));
-            }
-            params.set('limit', String(limit));
-        }
-        const queryString = params.toString();
-        return queryString ? `${basePath}?${queryString}` : basePath;
-    }
-    // ─── DiscoverObjects ──────────────────────────────────────────────
-    /**
-     * Canonical Rasa.io v1 API top-level objects.  Rasa.io's schema is
-     * fixed — there are no per-tenant "custom tables".  Custom subscriber
-     * attributes ARE per-tenant and surface as additional columns on
-     * `persons` via the existing DiscoverFields path (live-queries
-     * `/v1/persons/{id}/attributes` and merges into the persons field set).
-     */
-    async DiscoverObjects(companyIntegration, contextUser) {
-        const persisted = await super.DiscoverObjects(companyIntegration, contextUser);
-        const canonical = [
-            { Name: 'persons', Label: 'Persons (Subscribers)', Description: 'Subscriber records. v1 API /v1/persons. Per-account custom attributes surface here via DiscoverFields.', SupportsIncrementalSync: true, SupportsWrite: true },
-            { Name: 'posts', Label: 'Posts (Articles)', Description: 'Newsletter content items / articles. v1 API /v1/posts.', SupportsIncrementalSync: true, SupportsWrite: false },
-            { Name: 'communities', Label: 'Communities', Description: 'Tenant communities the API key has access to. v1 API /v1/communities.', SupportsIncrementalSync: false, SupportsWrite: false },
-            { Name: 'analytics.activities', Label: 'Email Activity Analytics', Description: 'Open/click/delivery/bounce metrics bucketed by date. v1 API POST /v1/analytics/activities.', SupportsIncrementalSync: true, SupportsWrite: false },
-            { Name: 'analytics.articles', Label: 'Article Analytics', Description: 'Article click analytics ranked by popularity. v1 API POST /v1/analytics/articles.', SupportsIncrementalSync: true, SupportsWrite: false },
-            { Name: 'analytics.topics', Label: 'Topic Engagement Analytics', Description: 'Topic engagement ranking with unique user counts. v1 API POST /v1/analytics/topics.', SupportsIncrementalSync: true, SupportsWrite: false },
-        ];
-        const byName = new Map();
-        for (const o of persisted)
-            byName.set(o.Name.toLowerCase(), o);
-        for (const c of canonical) {
-            if (!byName.has(c.Name.toLowerCase()))
-                byName.set(c.Name.toLowerCase(), c);
-        }
-        return [...byName.values()];
-    }
-    // ─── TestConnection ──────────────────────────────────────────────
-    async TestConnection(companyIntegration, contextUser) {
-        try {
-            const config = await this.ParseConfig(companyIntegration, contextUser);
-            const token = await this.GetToken(config);
-            // Verify token works by listing communities
-            const response = await fetch(`${RASA_API_BASE}/communities`, {
-                method: 'GET',
-                headers: { 'rasa-token': token, 'Accept': 'application/json' },
-                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-            });
-            if (!response.ok) {
-                return {
-                    Success: false,
-                    Message: `Connection failed: HTTP ${response.status} from communities endpoint`,
-                };
-            }
-            const body = await response.json();
-            const results = body.results;
-            const communityCount = results?.length ?? 0;
-            return {
-                Success: true,
-                Message: `Connected to Rasa.io — ${communityCount} community(ies) accessible`,
-                ServerVersion: 'Rasa.io API v1',
-            };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return { Success: false, Message: `Connection failed: ${message}` };
-        }
-    }
-    // ─── Default Configuration ───────────────────────────────────────
-    GetDefaultConfiguration() {
-        return {
-            DefaultSchemaName: 'RasaIO',
-            DefaultObjects: [],
-        };
-    }
-    GetDefaultFieldMappings(objectName, _entityName) {
-        const lowerName = objectName.toLowerCase();
-        if (lowerName === 'persons' || lowerName === 'contacts') {
-            return [
-                { SourceFieldName: 'id', DestinationFieldName: 'ExternalID', IsKeyField: true },
-                { SourceFieldName: 'email', DestinationFieldName: 'Email' },
-                { SourceFieldName: 'first_name', DestinationFieldName: 'FirstName' },
-                { SourceFieldName: 'last_name', DestinationFieldName: 'LastName' },
-                { SourceFieldName: 'external_id', DestinationFieldName: 'SourceExternalID' },
-                { SourceFieldName: 'is_active', DestinationFieldName: 'IsActive' },
-                { SourceFieldName: 'is_subscribed', DestinationFieldName: 'IsSubscribed' },
-                { SourceFieldName: 'created', DestinationFieldName: 'CreatedAt' },
-                { SourceFieldName: 'updated', DestinationFieldName: 'UpdatedAt' },
-            ];
-        }
-        if (lowerName === 'posts' || lowerName === 'content') {
-            return [
-                { SourceFieldName: 'id', DestinationFieldName: 'ExternalID', IsKeyField: true },
-                { SourceFieldName: 'url', DestinationFieldName: 'URL' },
-                { SourceFieldName: 'title', DestinationFieldName: 'Title' },
-                { SourceFieldName: 'description', DestinationFieldName: 'Description' },
-                { SourceFieldName: 'source_url', DestinationFieldName: 'SourceURL' },
-                { SourceFieldName: 'image_url', DestinationFieldName: 'ImageURL' },
-                { SourceFieldName: 'quality_score', DestinationFieldName: 'QualityScore' },
-                { SourceFieldName: 'is_active', DestinationFieldName: 'IsActive' },
-                { SourceFieldName: 'created', DestinationFieldName: 'CreatedAt' },
-                { SourceFieldName: 'updated', DestinationFieldName: 'UpdatedAt' },
-            ];
-        }
-        return [];
-    }
-    // ─── FetchChanges Override ────────────────────────────────────────
-    /**
-     * Override FetchChanges to:
-     *  1. Store watermark and object name for use in BuildPaginatedURL/NormalizeResponse
-     *  2. Advance watermark on final batch using latest record timestamp
-     *
-     * Watermark filtering is done server-side via updated_since/created_since params
-     * (set in BuildPaginatedURL), so no client-side filtering is needed here.
-     */
-    async FetchChanges(ctx) {
-        console.log(`[Rasa.io] FetchChanges called for '${ctx.ObjectName}' (batchSize=${ctx.BatchSize}, watermark=${ctx.WatermarkValue ?? 'none'}, offset=${ctx.CurrentOffset ?? 'none'}, cursor=${ctx.CurrentCursor ?? 'none'})`);
-        // Reset counter and seen-IDs on the first page. Don't reset when serving from buffer
-        // (buffer calls also have no offset/cursor but the buffer key will be present).
-        const isFirstCall = !ctx.CurrentOffset && !ctx.CurrentPage && !ctx.CurrentCursor;
-        if (isFirstCall && !this._batchBuffer.has(ctx.ObjectName)) {
-            this._runningFetchTotal = 0;
-            this._seenIDs.set(ctx.ObjectName, new Set());
-        }
-        // Store for use in BuildPaginatedURL and NormalizeResponse
-        this._currentWatermark = ctx.WatermarkValue ?? undefined;
-        this._currentObjectName = ctx.ObjectName ?? '';
-        // Serve from buffer if a previous call left unconsumed records
-        const buffered = this._batchBuffer.get(ctx.ObjectName);
-        if (buffered && buffered.length > 0) {
-            return this.ServeBufferedRecords(ctx.ObjectName, buffered, ctx.BatchSize);
-        }
-        // Analytics endpoints use POST with a JSON body — the generic GET-only
-        // paginated loop in BaseRESTIntegrationConnector does not fit, so we
-        // short-circuit here.
-        if (ANALYTICS_POST_OBJECTS.has(ctx.ObjectName.toLowerCase())) {
-            return this.FetchAnalyticsBatch(ctx);
-        }
-        const result = await super.FetchChanges(ctx);
-        // Detect API wrap-around: track all seen IDs, stop when entire batch is duplicates
-        const seen = this._seenIDs.get(ctx.ObjectName);
-        if (seen && result.Records.length > 0) {
-            const dupeCount = result.Records.filter(r => seen.has(r.ExternalID)).length;
-            for (const r of result.Records)
-                seen.add(r.ExternalID);
-            if (dupeCount === result.Records.length) {
-                return {
-                    Records: [],
-                    HasMore: false,
-                    NewWatermarkValue: this.FindLatestTimestamp(result.Records) ?? ctx.WatermarkValue ?? undefined,
-                };
-            }
-        }
-        // When a non-paginated endpoint returns more than BatchSize in one shot,
-        // buffer the full set and serve it in chunks so no records are silently dropped.
-        if (!result.HasMore && result.Records.length > ctx.BatchSize) {
-            const watermark = this.FindLatestTimestamp(result.Records);
-            this._batchBuffer.set(ctx.ObjectName, result.Records);
-            this._batchBufferWatermarks.set(ctx.ObjectName, watermark);
-            return this.ServeBufferedRecords(ctx.ObjectName, result.Records, ctx.BatchSize);
-        }
-        const isFinalBatch = !result.HasMore;
-        const latestTimestamp = isFinalBatch ? this.FindLatestTimestamp(result.Records) : null;
-        return {
-            ...result,
-            NewWatermarkValue: isFinalBatch ? (latestTimestamp ?? ctx.WatermarkValue ?? undefined) : undefined,
-        };
-    }
-    /**
-     * Serves records from the internal buffer in BatchSize-sized chunks.
-     * Splices consumed records from the buffer array so subsequent calls advance correctly.
-     * Emits NewWatermarkValue only on the final chunk.
-     */
-    ServeBufferedRecords(objectName, buffer, batchSize) {
-        const batch = buffer.splice(0, batchSize);
-        const hasMore = buffer.length > 0;
-        let newWatermarkValue;
-        if (!hasMore) {
-            const stored = this._batchBufferWatermarks.get(objectName);
-            newWatermarkValue = stored ?? undefined;
-            this._batchBuffer.delete(objectName);
-            this._batchBufferWatermarks.delete(objectName);
-        }
-        return {
-            Records: batch,
-            HasMore: hasMore,
-            NewWatermarkValue: newWatermarkValue,
-        };
-    }
-    // ─── Private Helpers ─────────────────────────────────────────────
-    /**
-     * Flattens the nested insights/topics response structure.
-     * API returns one item per person with a topics[] array; we emit one row per (person, topic).
-     */
-    FlattenInsightsTopics(rawResults) {
-        const rows = [];
-        for (const item of rawResults) {
-            // Unwrap 'data' envelope if present
-            const record = (item['data'] && typeof item['data'] === 'object' && !Array.isArray(item['data']))
-                ? item['data']
-                : item;
-            const personId = record['id'] ?? record['person_id'];
-            const externalId = record['external_id'];
-            const email = record['email'];
-            const topics = record['topics'];
-            if (!Array.isArray(topics))
-                continue;
-            for (const topicEntry of topics) {
-                rows.push({
-                    person_id: personId,
-                    external_id: externalId,
-                    email,
-                    topic: topicEntry['topic'],
-                    first_click: topicEntry['first_click'],
-                    last_click: topicEntry['last_click'],
-                    weight: topicEntry['weight'],
-                });
-            }
-        }
-        this._runningFetchTotal += rows.length;
-        console.log(`[Rasa.io] Flattened ${rows.length} insights/topics rows from ${rawResults.length} persons`);
-        return rows;
-    }
-    /**
-     * Flattens the /persons/{id}/attributes response into one row per (person, attribute).
-     * Rasa.io does NOT expose a schema discovery endpoint for attributes — custom attributes
-     * are free-form key-value pairs, so we emit each non-null key as a separate row.
-     */
-    FlattenPersonAttributes(rawResults) {
-        const rows = [];
-        for (const item of rawResults) {
-            const record = (item['data'] && typeof item['data'] === 'object' && !Array.isArray(item['data']))
-                ? item['data']
-                : item;
-            const personId = record['id'] ?? record['person_id'];
-            const externalId = record['external_id'];
-            const email = record['email'];
-            const attributes = record['attributes'] ?? record['custom_attributes'];
-            if (!attributes || typeof attributes !== 'object' || Array.isArray(attributes))
-                continue;
-            for (const [attrName, attrValue] of Object.entries(attributes)) {
-                if (attrValue === undefined)
-                    continue;
-                rows.push({
-                    person_id: personId,
-                    external_id: externalId,
-                    email,
-                    attribute_name: attrName,
-                    attribute_value: this.StringifyAttributeValue(attrValue),
-                });
-            }
-        }
-        this._runningFetchTotal += rows.length;
-        console.log(`[Rasa.io] Flattened ${rows.length} person-attribute rows from ${rawResults.length} persons`);
-        return rows;
-    }
-    /**
-     * Flattens /analytics/activities date-histogram responses. Each result is a bucket
-     * containing { bucket_start, <metric>: value, ... }. We emit one row per
-     * (bucket_start, metric_name).
-     */
-    FlattenActivitiesAnalytics(rawResults) {
-        const rows = [];
-        for (const item of rawResults) {
-            const record = (item['data'] && typeof item['data'] === 'object' && !Array.isArray(item['data']))
-                ? item['data']
-                : item;
-            const bucketStart = (record['bucket_start'] ?? record['date'] ?? record['timestamp']);
-            if (bucketStart == null)
-                continue;
-            // The body carries metric values keyed by name (opens, clicks, deliveries, bounces, ...)
-            for (const [key, value] of Object.entries(record)) {
-                if (key === 'bucket_start' || key === 'date' || key === 'timestamp')
-                    continue;
-                if (key === 'segment_code' || key === 'interval' || key === 'timezone')
-                    continue;
-                if (value == null || typeof value === 'object')
-                    continue;
-                rows.push({
-                    bucket_start: String(bucketStart),
-                    metric_name: key,
-                    metric_value: typeof value === 'number' ? value : Number(value),
-                    segment_code: record['segment_code'] ?? null,
-                    interval: record['interval'] ?? null,
-                    timezone: record['timezone'] ?? null,
-                });
-            }
-        }
-        this._runningFetchTotal += rows.length;
-        console.log(`[Rasa.io] Flattened ${rows.length} analytics-activities rows from ${rawResults.length} buckets`);
-        return rows;
-    }
-    /** Stringifies a custom attribute value for nvarchar storage. */
-    StringifyAttributeValue(value) {
-        if (value == null)
-            return null;
-        if (typeof value === 'string')
-            return value;
-        if (typeof value === 'number' || typeof value === 'boolean')
-            return String(value);
-        try {
-            return JSON.stringify(value);
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Fetches a batch from a Rasa analytics endpoint. These endpoints require POST
-     * with a JSON body and are NOT paginated — the whole response is returned in
-     * one call. We build a body that respects the caller's watermark (if any) and
-     * delegate to the base pipeline for flattening/pagination-state resolution.
-     */
-    async FetchAnalyticsBatch(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 baseURL = this.GetBaseURL(ctx.CompanyIntegration);
-        const url = `${baseURL.replace(/\/+$/, '')}${obj.APIPath.startsWith('/') ? obj.APIPath : `/${obj.APIPath}`}`;
-        this._lastFetchedPath = obj.APIPath;
-        const body = this.BuildAnalyticsBody(ctx.ObjectName, ctx.WatermarkValue, ctx.BatchSize ?? DEFAULT_PAGE_SIZE);
-        const headers = this.BuildHeaders(auth);
-        const response = await this.MakeHTTPRequest(auth, url, 'POST', headers, body);
-        if (response.Status < 200 || response.Status >= 300) {
-            console.warn(`[Rasa.io] Analytics POST ${url} returned HTTP ${response.Status}`);
-            return { Records: [], HasMore: false };
-        }
-        const records = this.NormalizeResponse(response.Body, obj.ResponseDataKey);
-        const pkFieldNames = fields.filter(f => f.IsPrimaryKey).map(f => f.Name);
-        const pkNames = pkFieldNames.length > 0 ? pkFieldNames : ['id'];
-        const externalRecords = records.map(r => ({
-            ExternalID: pkNames.map(n => r[n] != null ? String(r[n]) : '').join('|'),
-            ObjectType: ctx.ObjectName,
-            Fields: r,
-        }));
-        // Advance watermark to 'now' — analytics endpoints don't return per-record timestamps.
-        const nowIso = new Date().toISOString();
-        return {
-            Records: externalRecords,
-            HasMore: false,
-            NewWatermarkValue: nowIso,
-        };
-    }
-    /**
-     * Builds the POST body for an analytics endpoint. Watermark is translated into
-     * an explicit `date_range.start_date` so that subsequent runs only pull new data.
-     */
-    BuildAnalyticsBody(objectName, watermark, limit) {
-        const now = new Date();
-        // If we have a watermark, use explicit date range from watermark to now;
-        // otherwise fall back to the preset label.
-        const useExplicitRange = typeof watermark === 'string' && watermark.length > 0;
-        const dateRange = useExplicitRange
-            ? {
-                start_date: watermark,
-                end_date: now.toISOString(),
-            }
-            : ANALYTICS_DEFAULT_DATE_RANGE;
-        const commonBody = {
-            date_range: dateRange,
-            suspect_click: ANALYTICS_DEFAULT_SUSPECT_CLICK,
-            segment_code: ANALYTICS_DEFAULT_SEGMENT,
-            timezone: ANALYTICS_DEFAULT_TIMEZONE,
-            limit,
-        };
-        if (objectName.toLowerCase() === 'analytics-activities') {
-            commonBody['interval'] = ANALYTICS_DEFAULT_INTERVAL;
-        }
-        return commonBody;
-    }
-    /**
-     * Parses connection config from CompanyIntegration credentials.
-     * Tries CredentialID first (MJ: Credentials entity), then Configuration JSON.
-     */
-    async ParseConfig(companyIntegration, contextUser) {
-        // Try CredentialID first
-        if (companyIntegration.CredentialID) {
-            return this.ParseConfigFromCredential(companyIntegration.CredentialID, contextUser);
-        }
-        // Fallback to Configuration JSON
-        if (companyIntegration.Configuration) {
-            return this.ParseConfigFromJSON(companyIntegration.Configuration);
-        }
-        throw new Error('Rasa.io connector requires either CredentialID or Configuration JSON');
-    }
-    /**
-     * Loads credentials from the MJ: Credentials entity.
-     */
-    async ParseConfigFromCredential(credentialID, contextUser, provider) {
-        const md = provider ?? new Metadata();
-        const credEntity = await md.GetEntityObject('MJ: Credentials', contextUser);
-        await credEntity.Load(credentialID);
-        const valuesJSON = credEntity.Values;
-        if (!valuesJSON) {
-            throw new Error('Credential record has no Values JSON');
-        }
-        const values = JSON.parse(valuesJSON);
-        return this.ExtractConfigFields(values);
-    }
-    /**
-     * Parses config from the CompanyIntegration.Configuration JSON string.
-     */
-    ParseConfigFromJSON(configJSON) {
-        const parsed = JSON.parse(configJSON);
-        return this.ExtractConfigFields(parsed);
-    }
-    /**
-     * Extracts config fields with case-insensitive key matching.
-     */
-    ExtractConfigFields(values) {
-        const get = (key) => {
-            const lower = key.toLowerCase();
-            for (const [k, v] of Object.entries(values)) {
-                if (k.toLowerCase() === lower)
-                    return v;
-            }
-            return undefined;
-        };
-        const apiKey = get('apikey') ?? get('api_key') ?? get('key');
-        const username = get('username') ?? get('email') ?? get('user');
-        const password = get('password') ?? get('pass');
-        const communityIdentifier = get('communityidentifier') ?? get('community_identifier') ?? get('community');
-        if (!apiKey) {
-            throw new Error('Rasa.io configuration missing required field: APIKey');
-        }
-        if (!username || !password) {
-            throw new Error('Rasa.io configuration missing required fields: Username and Password (for Basic auth)');
-        }
-        return {
-            APIKey: apiKey,
-            Username: username,
-            Password: password,
-            CommunityIdentifier: communityIdentifier,
-        };
-    }
-    /**
-     * Obtains a JWT token from Rasa.io, using cache if still valid.
-     */
-    async GetToken(config) {
-        // Return cached token if still fresh
-        if (this.cachedToken && (Date.now() - this.tokenObtainedAt) < TOKEN_TTL_MS) {
-            return this.cachedToken;
-        }
-        const basicAuth = Buffer.from(`${config.Username}:${config.Password}`).toString('base64');
-        const response = await fetch(`${RASA_API_BASE}/tokens`, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Basic ${basicAuth}`,
-                'Content-Type': 'application/json',
-                'Accept': 'application/json',
-            },
-            body: JSON.stringify({ key: config.APIKey }),
-            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-        });
-        if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Rasa.io token request failed (HTTP ${response.status}): ${body.slice(0, 500)}`);
-        }
-        const body = await response.json();
-        // Token could be in results array or directly in response
-        let token;
-        if (body.results && Array.isArray(body.results) && body.results.length > 0) {
-            const firstResult = body.results[0];
-            token = (firstResult.token ?? firstResult['rasa-token'] ?? firstResult.jwt);
-        }
-        if (!token && typeof body.token === 'string') {
-            token = body.token;
-        }
-        if (!token && typeof body['rasa-token'] === 'string') {
-            token = body['rasa-token'];
-        }
-        if (!token) {
-            throw new Error('Rasa.io token response did not contain a token');
-        }
-        this.cachedToken = token;
-        this.tokenObtainedAt = Date.now();
-        return token;
-    }
-    /**
-     * Finds the latest timestamp from records for watermark advancement.
-     * Uses 'created' for insights/actions (its only timestamp field); 'updated' for everything else.
-     */
-    FindLatestTimestamp(records) {
-        const objectName = this._currentObjectName.toLowerCase();
-        const primaryField = objectName.includes('action') ? 'created' : 'updated';
-        const fallbackField = primaryField === 'updated' ? 'created' : 'updated';
-        let latest = null;
-        for (const record of records) {
-            const dateStr = (record.Fields[primaryField] ?? record.Fields[fallbackField]);
-            if (!dateStr)
-                continue;
-            const date = new Date(dateStr);
-            if (!isNaN(date.getTime()) && (latest === null || date > latest)) {
-                latest = date;
-            }
-        }
-        return latest ? latest.toISOString() : null;
-    }
-    /**
-     * Checks if an error is a timeout or network error.
-     */
-    IsTimeoutOrNetworkError(err) {
-        if (err instanceof Error) {
-            const msg = err.message.toLowerCase();
-            return msg.includes('timeout') || msg.includes('abort') ||
-                msg.includes('econnreset') || msg.includes('econnrefused') ||
-                msg.includes('fetch failed');
-        }
-        return false;
-    }
-    /**
-     * Sleeps for the specified number of milliseconds.
-     */
-    Sleep(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-};
-RasaConnector = __decorate([
-    RegisterClass(BaseIntegrationConnector, 'RasaConnector')
-], RasaConnector);
-export { RasaConnector };
-//# sourceMappingURL=RasaConnector.js.map